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.

Screen

If you use a command-line switch beginning with ‘-dock=’ and ending with a screen name, NEXUS IC will launch with that screen open. Valid screen names are ‘Welcome’, ‘Assets’, ‘Library’, ‘Planning’, ‘Workpacks’, ‘Inspection’, and ‘Anomalies’. They are case-insensitive.

Example usage to launch the Anomalies dock:

IntegrityCentre -dock=Anomalies

Disable Single Sign-On

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’.

Usage:

IntegrityCentre -DisableSSO

Backup and Restore

You can use command-line switches to tell NEXUS IC to backup or restore a database. This may be useful, for example, for automated backups of a live database, or automated refreshing of a sandpit database.

Example usage for a backup:

IntegrityCentre /backup /sql=MySQLServer /db=MyDatabase /username=admin /password=admin /path="C:\Database Backups"

Example usage for a restore:

IntegrityCentre /restore /sql=MySQLServer /db=NewDatabase /path="C:\Database Backups\MyDatabase.nexus-backup"

If you are overwriting an existing database, you must additionally supply credentials, to demonstrate that you have the appropriate authority to overwrite:

IntegrityCentre /restore /sql=MySQLServer /db=NewDatabase /path="C:\Database Backups\MyDatabase.nexus-backup" /username=admin /password=admin

Debugging and Tracing

NEXUS IC logs information to a file called IntegrityCentre_Trace.log located in:

C:\Users\[USER_NAME]\AppData\Roaming\NEXUS

You can control how verbose that logging is with any of the following switches: ‘-error’, ‘-warning’, ‘-informational’, ‘-debug’, ‘-debug1’, ‘-debug2’, ‘-debug3’, or ‘-debug4’. These are ordered here from least verbose to most verbose. The default is ‘-informational’.

Example usage to log informational messages:

IntegrityCentre -informational

Example usage to log debug, informational and warning messages:

IntegrityCentre -debug

Example usage to log error messages and everything less verbose:

IntegrityCentre -error

Launching with credentials

Logging in with predefined username and password.

Example usage for login:

IntegrityCentre /dbuser=username /dbpass=pA55w0rd

If, in the Database > Connect wizard you have selected “Specific Windows / Domain User”, the dbuser and dbpass you specify will be passed to SQL Server as domain credentials.

If you would like to connect to the database using SQL Server Authentication, then use the /sqlauth switch along with the username and password. Example usage for login:

IntegrityCentre /dbuser=username /dbpass=pA55wOrd /sqlauth

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.