Running the gateway

This topic describes how to run the gateway on UNIX and Windows operating systems. On Windows operating systems, you can run Process Control as a service and configure it to run the gateway.

Before running the gateway on UNIX and Windows operating systems, do the following:

Edit the omnibus.def file (which contains the schema) as follows:
1. Change the references of '__USER__' to the actual user required by your BMC Remedy ARS configuration.
2. Change the references of '__VERSION__' to the version of Tivoli Netcool/OMNIbus you are running.
  Note: Ensure to coordinate the previous edits with these gateway properties: Gate.Remedy.Username and Gate.Remedy.Form.
Import the omnibus.def file to the BMC Remedy ARS server.
Create the conversions.remedy table in the ObjectServer by running the createConversionsTable.sql file.
The following example shows how to run the createConversionsTable.sqlfile on UNIX:
```
$OMNIHOME/omnibus/bin/nco_sql -user username -password password 
-server servername < directory_path createConversions.sql
```
The following example shows how to run the createConversionsTable.sqlfile on WINDOWS:
```
"%OMNIHOME%\omnibus\bin\isql" -U username -P password 
-S servername -i directory_path createConversions.sql
```
Edit the G_BMC_REMEDY.props property file and then copy it under the $OMNIHOME/etc directory. The following properties must be updated:
- Gate.Remedy.Server - Specify the IP address or hostname of the BMC Remedy ARS server.
- Gate.Remedy.Username - Specify the username of the gateway user on the BMC Remedy ARS server.
- Gate.Remedy.Password - Specify the password of the gateway user on the BMC Remedy ARS server.
- Gate.RdrWtr.Server - Specify the name of the ObjectServer the gateway is running against.
- Gate.Remedy.Form - Specify the name of the BMC Remedy ARS form used to create requests from ObjectServer alerts. Set this property to the name that you defined for the BMC Remedy ARS form in the omnibus.def file.

To run the gateway on UNIX operating systems, use the following command:

$OMNIHOME/bin/nco_g_bmc_remedy

To run the gateway on Windows operating systems, use the following commands:

%NCHOME%\platform\win32\jre_1.x.y\jre\bin\java.exe 
-Dlog4j.configuration=file:\\\%OMNIHOME%\gates\bmc_remedy\log4j.properties 
-jar %OMNIHOME%\java\jars\nco_g_java.jar -type bmc_remedy

Note: With no command line arguments, the gateway expects to find its properties file G_BMC_REMEDY.props located in the $OMNIHOME/etc directory.

Note: For additional information on running gateways and for running a second instance of a gateway on the same host, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide.