Installing, configuring, and uninstalling services for server components

To install, configure, or uninstall the Tivoli Netcool/OMNIbus server components as services, you must run the executable file for the component with one or more additional command-line options.

To install, configure, or uninstall a Tivoli Netcool/OMNIbus service:

1. From a command prompt, enter the following command:

   %NCHOME%\omnibus\bin\nco_name [option [value]...]

   In this command:

   • nco_name represents any of the executable names that are shown in the following table.

     Table 1. Executable names for server components

     Component type	Executable name
     ObjectServer	nco_objserv
     Proxy server	nco_proxyserv
     Process agent	nco_pad
     Gateway	nco_g_gatewayname gatewayname is the abbreviated name of a gateway type.

   • Square brackets represent optional entries for the command-line options that you can use with the nco_name command. The following table lists each option and its value (if required).

     Table 2. Command-line options for installing, configuring, and uninstalling Tivoli Netcool/OMNIbus services

     Command-line option	Function
     /INSTALL	Installs a Tivoli Netcool/OMNIbus server component or probe as a service.
     /REMOVE	Removes an installed service.
     /NOAUTO	Installs the service with manual startup. Omit this option to run the service with automatic startup.
     /DEPEND srv @grp...	Specifies other services or groups on which the service being installed is dependent. If you use this option, this service does not start until the services (srv) and groups (@ grp) that you specify with this option have run. Note: The value of srv must be the Service name, not the Display name. To view the Service name, open the Windows Control Panel, and then double-click Administrative Tools and Services in succession. Double-click the relevant service entry to open the Properties window. The Service name is shown on the General tab of the Properties window.
     /GROUP name	Installs the service as a member of a group, where name represents the group name. This option is used in conjunction with the /DEPEND command-line option. For example, you can group all probes together under the same group name. You can then force that group to be dependent on another service.
     /ACCOUNT [domain\]user	Specifies that the service logs on to a user account. In this command syntax, domain represents the domain name and is optional (as depicted by the square brackets), and user represents the user name. If using the /ACCOUNT command-line option, you must also specify the /PASSWORD option. If you omit the /ACCOUNT command-line option, the service logs on to the local system account. For example, if you want to install a process agent service as a local workstation user (that is, Administrator), domain is not needed. Enter: nco_pad /INSTALL /ACCOUNT Administrator Tip: Be aware that the account requires "logon as service" rights, which is automatically granted when you specify a logon account for the service from the Services window in the Control Panel. This is not the case if you use the /ACCOUNT option with the /INSTALL option when installing the service from the command line.
     /PASSWORD password	Specifies a password string for the user account.
     /INSTANCE ID	Specifies a unique instance identifer for a service, where ID represents the identifer. For example, if installing more than one process agent service, the second and subsequent services each require a unique ID.
     /CMDLINE "option"	Specifies one or more command-line options to be set whenever the service is restarted. Ensure that the command-line options are enclosed within double quotation marks. Use command-line options that are available for the type of component being configured. For example, for the ObjectServer, specify one or more command-line options that can be used with the nco_objserv command, or for the process agent, specify one or more command-line options that can be used with the nco_pad command. Examples: To specify which process agent should run when a service for the NCO_PA process agent starts, set the value of option to "-name NCO_PA". To specify an alternative log file /tmp/my_pafile.log to which messages are written, set the value of option to "-logfile /tmp/my_pafile.log".
     /BACKOFF n	Defines the maximum number of startup or connection attempts of the service, where n is an integer representing this number. For example, to specify the maximum number of times a probe should attempt to connect to the NCOMS ObjectServer, include the following options when installing the probe service: /CMDLINE "-server NCOMS" /BACKOFF 3

     Tip: You can view the command-line options for installing, configuring, and uninstalling these Windows services by using the following command:
     %NCHOME%\omnibus\bin\nco_name.exe /?
2. After installing services, reboot the computer.