Running the probe

The way in which you run the probe depends on whether the operating system of the host machine is UNIX or Windows.

To start the probe on UNIX, use the following command:
$NCHOME/omnibus/probes/nco_p_iec_cim_ami
To start the probe from a Microsoft Windows command prompt, use the following command:
%NCHOME%\omnibus\probes\nco_p_iec_cim_ami.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/nco_p_iec_cim_ami_n.props

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

  2. 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 each of the following properties:
    • LocalHttpPort
    • Name
  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: 

$NCHOME/omnibus/probes/nco_p_iec_cim_ami 
-propsfile $NCHOME/omnibus/props/aix5/nco_p_iec_cim_ami_1.props

$NCHOME/omnibus/probes/nco_p_iec_cim_ami 
-propsfile $NCHOME/omnibus/props/aix5/nco_p_iec_cim_ami_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_iec_cim_ami.bat /INSTALL /INSTANCE instanceName 
/CMDLINE "command-line-options"

    Replace instanceName 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 omit the /INSTANCE switch, the name of the service is NCONcoPIecCimAmiProbe.

    Example:

    %OMNIHOME%\probes\win32\nco_p_iec_cim_ami.bat /INSTALL /INSTANCE IecCimAmiProbe 
/CMDLINE "-utf8enabled"
    Note: Ensure that the environment variables that the probe uses are defined as system variables. Typically, the relevant variables are %OMNIHOME% and %IEC_CIM_EP_RLS_JAR_PATH%. Refer to the file nco_p_iec_cim_ami.bat for the value of the %IEC_CIM_EP_RLS_JAR_PATH% variable.
  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_iec_cim_ami.bat /REMOVE /INSTANCE instanceName

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