Installation parameters

To pass installation parameters to the installer from the command line, use the /z switch.

The format for parameters passed with this switch is as follows:

/z"--param[=value] ..."

For example, the following command shows how to specify the username and password for registering Netcool/SSM during installation:

netcool_ssm-4.0.1-xxxx-win32.exe /z"--SvcUser=agentUser --SvcUserPassword=password"

The following rules apply to parameters specified with the /z switch:

The list of parameters must be enclosed in one set of double quote characters ("). For example:
```
/z"--SvcUser=agentUser --SvcUsePassword=password"
```
Parameter values may contain spaces but may not contain double quote characters (").
If you specify a value for a parameter that does not require one, such as OverrideSNMP, the installer ignores the value but the parameter itself still has effect.
Command line options are not case-sensitive.

Note: You can also use these parameters when running the installer in the interactive installation mode. Any parameters supplied in this way appear as the default values in the corresponding installer dialogs.

Table 1 lists the installation parameters available for use with the /z switch. You can change some of these parameters again after Netcool/SSM is installed: where appropriate, the table indicates the command or variable for changing a setting after installation.

Table 1. Installation parameters
Parameter	Type	Description	`Variable`/ `Command`
`SvcUser`	string	Sets the username used to register the Netcool/SSM service. If you specify this switch, you must also specify the `SvcUserPassword` parameter. On host machines with Active Directory installed (Windows domain controllers) this parameter is ignored and the local system account is used instead. Default: local system account.	n/a
`SvcUserPassword`	string	Sets the password used to register the Netcool/SSM service. If you specify this parameter, you must also specify the `SvcUser` switch. On host machines with Active Directory installed (Windows domain controllers) this parameter is ignored and the local system account is used instead.	n/a
`UDPPort`	integer	Sets the UDP port number on which Netcool/SSM listens for incoming SNMP requests. The port number must be a number in the range 1-65535 inclusive. The port specified must not be in use by any other application. If the Microsoft SNMP service is installed on the host machine and you set this parameter to 161 then the actions taken by the installer depend on the `OverrideSNMP` parameter. If `OverrideSNMP` is specified, the installer stops the Microsoft SNMP service, sets its startup mode to manual, installs the Netcool/SSM service and registers the Netcool/SSM service in automatic startup mode. If `OverrideSNMP` is not specified, the installer leaves the Microsoft SNMP service running and registers the Netcool/SSM service in manual startup mode. Default: `161`	`UdpPort`
`Community`	string	Sets the default community string for Netcool/SSM. The community string is only used if the agent has either SNMP v1 or SNMP v2c enabled. Default: `private`	`community`
`TargetDir`	string	Sets the directory in which Netcool/SSM will be installed. Default: On Windows 32-bit systems, `drive:`\Program Files\Netcool\SSM On Windows 64-bit systems, \Program Files(x86)\Netcool\SSM	n/a
`Force`	n/a	Forces the installation process. In a forced installation, the installer does not migrate the configuration of any Netcool/SSM currently installed on the host machine to the new version, destroying any existing configuration files. The agent's unique ID is always preserved, regardless of the state of the Force parameter. Default: Not forced. The installer preserves the configuration of any Netcool/SSM already installed on the host machine.	n/a
`Version`	n/a	Displays the product name and version of the installer. When you specify this parameter, the installer does not perform any other installation tasks.	n/a
`OverrideSNMP`	n/a	Disables the Microsoft SNMP service if it is currently installed on the host machine and will conflict with Netcool/SSM.This parameter only has effect if either of the following criteria are met: Netcool/SSM is configured to use UDP port 161. In this case, the installer stops the Microsoft SNMP service, installs Netcool/SSM and starts the Netcool/SSM service. The host machine is running HP Systems Insight Manager services and Netcool/SSM is configured to use UDP port 161. In this case, the installer modifies the Microsoft SNMP service to use Netcool/SSM instead of the Microsoft service. If the parameter is not specified and the host machine is currently running the Microsoft SNMP service, the installer does not modify it in any way. If Netcool/SSM is configured to use UDP port 161, the installer sets the startup mode of the Netcool/SSM service to manual. Otherwise it sets the startup mode to automatic and both Netcool/SSM and the Microsoft SNMP service will run simultaneously. Default: The Microsoft SNMP service is not modified in any way.	n/a
`DisableV1`	n/a	Configures Netcool/SSM not to respond to SNMP v1 requests. This parameter and the `EnableV1` parameter are mutually exclusive. You may specify only one of these two parameters. Default: The agent responds to SNMP v1 requests.	`DisableV1`
`EnableV1`	n/a	Configures Netcool/SSM to respond to SNMP v1 requests. This parameter and the `DisableV1` parameter are mutually exclusive. You may specify only one of these two parameters. Default: The agent responds to SNMP v1 requests.	`DisableV1`
`EnableV2`	n/a	Configures Netcool/SSM to respond to SNMP v2c requests. This parameter and the `DisableV2` parameter are mutually exclusive. You may specify only one of these two parameters. Default: The agent responds to SNMP v2c requests.	`DisableV2`
`DisableV2`	n/a	Configures Netcool/SSM not to respond to SNMP v2c requests. This parameter and the `EnableV2` parameter are mutually exclusive. You may specify only one of these two parameters. Default: The agent responds to SNMP v2c requests.	`DisableV2`
`EnableV3`	n/a	Configures Netcool/SSM to respond to SNMP v3 requests. This parameter and the `DisableV3` parameter are mutually exclusive. You may specify only one of these two parameters. If you specify this parameter, you must also specify the `SecName` parameter. Default: The agent does not respond to SNMP v3 requests.	`DisableV3`
`DisableV3`	n/a	Configures Netcool/SSM not to respond to SNMP v3 requests. This parameter and the `EnableV3` parameter are mutually exclusive. You may specify only one of these two parameters. Default: The agent does not respond to SNMP v3 requests.	`DisableV3`
`SecName`	string	Sets the username used by Netcool/SSM in SNMPv3 communication. This parameter is only valid when the `EnableV3` parameter is specified.	`user`
`AuthProto`	`NONE` \| `SHA` \| `MD5`	Sets the method of authentication used for the SNMP v3 protocol. Valid values are: `NONE` - no authentication `SHA` - Secure Hash algorithm `MD5` - MD5 message digest algorithm If you set this parameter to a value other than `NONE`, you must also specify the `AuthPass` parameter. Default: `NONE`
`AuthPass`	string	Specifies the password used in SNMPv3 authentication. This password must be at least 8 characters in length and may contain spaces; however, it must not contain the double quote character (`"`) or two consecutive dashes `(--`).
`PrivProto`	`NONE`\|`DES`	Sets the method used for encrypting SNMP v3 protocol messages. Valid values are: `NONE` - no encryption used `DES` - Data Encryption Standard algorithm If you set this parameter to a value other than `NONE`, you must also specify the `PrivPass` parameter. Default: `NONE`
`PrivPass`	string	Specifies the password used in SNMPv3 message encryption. This password must be at least 8 characters in length and may contain spaces; however, it must not contain the double quote character (") or two consecutive dashes (--).
`Minimal`	n/a	Sets the selection of components installed to core agent files only.	n/a
`SvcManual`	n/a	Registers Netcool/SSM service in `manual` mode and does not start it after installation.	n/a
`ClusterInstall`	n/a	Selects the cluster-aware installation mode for installing Netcool/SSM on a Windows server cluster node.	n/a
`ClusterGroup`	string	Name of the cluster group on which to install Netcool/SSM.	n/a
`ClusterStorage Resource`	string	Name of the physical disk resource on which to install Netcool/SSM core configuration files	n/a
`NoReconfig`	n/a	Bypasses the installer configuration dialogs during an upgrade.	n/a