Using iWay Service Manager Startup Command Line Switches

You can use various command line switches to start iWay Service Manager (iSM) for special processing control. To view a list of all available switches use the -> or -help command line options.

If you are using the standard provided startup scripts, you must specify an iSM configuration to add the switches. For example:

iway7 base -help

Note: To reduce the probability of switch clashing on the iSM startup command line (since iwsrv and iSM use the same code), any switch can also be started with capital I. For example, using -Ib as a command line switch to start iSM in hot backup mode is identical to -b. Specifying the initial letter is optional.

When entering a switch with a value (such as -srvr.lpath), you can separate the value by a space or an equals sign (“=”). When an equals sign is used, spaces are not accepted.

Switches should be entered on the Java Settings page of the command console.

Key startup command line switches are listed and described in the following table.

Startup Command Line Switch

Description

-config <name>

Name of a specific iSM configuration or iWay Integration Application (iIA) to start, which is required to start iSM.

-b[ackup]

Starts iSM in hot backup mode. If your iSM instance shadows another iSM instance for backup purposes (as configured in the Backup Settings section of the iSM Administration Console), using the -b startup command line switch starts iSM as the shadowing (backup) server. This switch does not apply to backup situations where a backup listener controls the backup process.

-n[ame] <name>

Sets the name that is assigned to iSM. Usually this is the host or configuration name, but can be modified by this switch. The use of this startup command line switch is reserved for future use.

-v[ersion]

Displays current version information for your iSM instance.

-r[aw]

Bypasses the use of a startup process flow. iSM will start without attempting to run the configured startup process flow.

-u[sersecurity]

Ignores the iSM Authentication Realm settings and uses the iSM Administration Console realm instead. You can use this startup command line switch in a scenario where you are required to adjust the realm information and cannot access the iSM Administration Console to do so because a realm (such as LDAP) is unreachable.

-srvr.quiesced

Quiesced mode, all channels except the console channel are inactive on startup.

-srvr.ifile <path>

Path to install a file (usually install.xml). Defaults to:

[iwayhome]/bin
-srvr.lpath <path>

Path to the directory where license file(s) are located. Defaults to:

[iwayhome]

The path setting can be used to modify the Java classpath and native path libraries that are used. These settings apply to Windows and Unix startup commands. For more information on iSM path settings, see Path Settings.

Additional startup command line switches are used internally by iSM, and are not recommended for use in production environments.