Running the probe

The way in which you run the probe depends on whether you are running UNIX or Windows.

To start the probe, use the following command:

$NCHOME/omnibus/probes/nco_p_opc_ua

%NCHOME%\omnibus\probes\win32\nco_p_opc_ua.bat

Running multiple probes

You can run multiple, concurrent instances on a single host machine.

Preparation

For each instance of the probe that you want to run, do the following:

  1. Create a uniquely-named copy of the probe's properties file, for example:

    $NCHOME/omnibus/probes/arch/opc_ua_n.props

    For each copy of the properties file, replace n with a unique number.

  2. Optionally, create a uniquely-named copy of the probe's rules file. Customize the copy as required.
  3. In the properties file for each instance, define a unique value for the following properties:
    • Name
    • MessageLog
    • PidFile
  4. In the properties file for each instance, set the values of the PropsFile and RulesFile properties to the names of the files you created in steps 1 and 2.

Running the probes

To run each instance of the probe, specify the -propsfile command line option to refer to the appropriate properties file, for example on UNIX:

Note: Use the full file path (and not the $NCHOME environment variable) after the -propsfile option on the command line to specify the location of the properties files. Typically, the $NCHOME environment variable is defined as /opt/IBM/tivoli/netcool.
$NCHOME/omnibus/probes/nco_p_opc_ua 
-propsfile /opt/IBM/tivoli/netcool/omnibus/probes/aix5/opc_ua_1.props

$NCHOME/omnibus/probes/nco_p_opc_ua 
-propsfile /opt/IBM/tivoli/netcool/omnibus/probes/aix5/opc_ua_2.props

Running the probe as a Windows service

The Windows version of the probe can run as a Windows service.

Registering and running the Windows service

To run a single instance of the probe as a Windows service:

  1. Open a Command Prompt.
  2. Register the probe as a Windows service:
    %OMNIHOME%\probes\win32\nco_p_opc_ua.bat /INSTALL /INSTANCE instance-name
/CMDLINE "command-line-options"

    Replace instance-name with a unique name for the service and command-line-options with any command line options that you want to use when running the probe. Always enclose the command line options in quotes. If you do not want to use any command line options, exclude the /CMDLINE switch.

    Note: If you exclude the /INSTANCE switch, the name of the service is NCONcoPOpcUaProbe.

    Example:

    %OMNIHOME%\probes\win32\nco_p_opc_ua.bat /INSTALL /INSTANCE OpcUaProbe1 
/CMDLINE "-utf8enabled"
    Note: Ensure that the %OMNIHOME% environment variable is defined as a system variable.
    Note: If you define the %OMNIBUS_JVM_DLL% environment variable, the probe uses that dynamic link library (DLL) for the windows service. Otherwise, by default, the probe uses the j9vm\jvm.dll that comes with Tivoli Netcool/OMNIbus.
  3. Run the service:
    1. Open the Windows Control Panel and double click Administrative Tools.
    2. Double click Services.
    3. Click on the entry for the probe service and click Start.

Removing the service

To remove the service, if required:

  1. Stop the service, if it is running:
    1. Open the Windows Control Panel and double click Administrative Tools.
    2. Double click Services.
    3. Click on the entry for the probe service and click Stop.
  2. Open a Command Prompt and enter the following command to remove the probe service from the system:
    %OMNIHOME%\probes\win32\nco_p_opc_ua.bat /REMOVE /INSTANCE instance-name

    Replace instance-name with the instance name you supplied when registering the probe as a service.