Command-Line Switches¶

You can launch NEXUS IC with various command-line switches. The NEXUS IC executable is named ‘IntegrityCentre.exe’. This can be useful when launching NEXUS IC from a Windows Explorer shortcut, or when configuring a RemoteApp icon.

Below is an example of how to run NEXUS IC with debugging information enabled. These steps can also be used for IC-Inspection, by using the ‘Inspection.exe’ instead of ‘IntegrityCentre.exe’.

Method 1: Launch NEXUS via Desktop Shortcut

Create a desktop shortcut to Integrity Centre

Right click on the shortcut and select ‘Properties’.

On the ‘Shortcut’ tab page add -debug after the location in the Target field - See image on right

Click Ok to save the changes.

Run the shortcut to launch Integrity Centre with debugging enabled.

Method 2: Launch via Command Prompt

Click Start - type ‘cmd’ and press enter to open Command Prompt.
Paste the following and press enter:
start "" "C:\Program Files (x86)\NEXUS\IntegrityCentre.exe" -debug
You must include the “” (empty double quotes) before the exe location in your command. The file path must point to your local installation path for NEXUS.

Log File:

The log file is located at:
C:\Users\[username]\AppData\Roaming\NEXUS
For Integrity Centre, the log file is named ‘IntegrityCentre_Trace.log’, for IC-Inspection the log file is ‘Inspection_Trace.log’

A shortcut to this location is:
%AppData%\NEXUS

General Options¶

Name	Command	Example Usage	Description
Dock	`-dock`	`IntegrityCentre -dock=Anomalies`	If you use a command-line switch beginning with ‘-dock=’ and ending with a dock name, NEXUS IC will launch with that dock open. Valid dock names are ‘Dashboards’, ‘Assets’, ‘Library’, ‘Planning’, ‘Workpacks’, ‘Inspection’, and ‘Anomalies’. They are case-insensitive.
Disable Single Sign-On	`-DisableSSO`	`IntegrityCentre -DisableSSO`	If you have previously logged in to a NEXUS database using domain credentials, then on subsequent runs you will be automatically logged in again with those credentials. You can either select Database ‣ Close, or you can run NEXUS IC with the command-line switch ‘-DisableSSO’.
Offline Mode	`-offline`	`IntegrityCentre -offline`	When limited/no internet connection is available, startup times can be reduced by running NEXUS IC in ‘offline’ mode. This will prevent NEXUS from re-validating the license. The licenses check will still fail if the grace period has been exceeded.
Prevent display of Library dock or Export Repository	`/iad`	`IntegrityCentre /iad`	You can use command-line switch /iad to prevent NEXUS IC displaying the Library dock or Database ‣ Export Repository.

Backup and Restore¶

Name	Command	Example Usage	Description
Backup	`/backup`	`IntegrityCentre /backup /sql=MySQLServer /db=MyDatabase /username=admin /password=admin /path="C:\Database Backups"`	You can use command-line switches to tell NEXUS IC to backup a database. Eg. for automated backups of a live database.
Restore	`/restore`	`IntegrityCentre /restore /sql=MySQLServer /db=NewDatabase /path="C:\Database Backups\MyDatabase.nexus-backup"`	You can use command-line switches to tell NEXUS IC to restore a database. Eg. for automated refreshing of a sandpit database.
Restore (with credentials)	`/restore`	`IntegrityCentre /restore /sql=MySQLServer /db=NewDatabase /path="C:\Database Backups\MyDatabase.nexus-backup" /username=admin /password=admin`	If you are overwriting an existing database, you must additionally supply credentials, to demonstrate that you have the appropriate authority to overwrite.

Debugging and Tracing¶

NEXUS IC and IC-Inspection log information to the folder C:Users[username]AppDataRoamingNEXUS. Note that you should only use debug switches if instructed to do so by Wood technical support, as they can significantly impact performance. If you start NEXUS IC with a debug switch, you will see a dialog reminding you of this.

Name	Command	Example Usage	Description
Informational	`-informational`	`IntegrityCentre -informational`	Log informational messages.
Error	`-error`	`IntegrityCentre -error`	Log error messages and everything less verbose
Debug	`-debug`	`IntegrityCentre -debug`	Log debug, informational and warning messages.
Debug (1-4)	`-debug1` `-debug2` `-debug3` `-debug4`	`IntegrityCentre -debug#`	Log debug information. These are ordered here from least verbose to most verbose.
Launch with credentials	`/dbuser= /dbpass=`	`IntegrityCentre /dbuser=username /dbpass=pA55w0rd`	Log in with predefined username and password. If, in the Connect to Database wizard you have selected “Specific Windows / Domain User”, the dbuser and dbpass you specify will be passed to SQL Server as domain credentials.
Launch with credentials (SQL Server Authentication)	`/dbuser= /dbpass= /sqlauth`	`IntegrityCentre /dbuser=username /dbpass=pA55wOrd /sqlauth`	If you would like to connect to the database using SQL Server Authentication, then use the /sqlauth switch along with the username and password. The user will still be given a login prompt allowing them to provide NEXUS credentials, which will determine which NEXUS user account will be used to identify any changes they make to the database.