VMware recommends installing the VoIP Notification Trap Adapter as a service so that the host system automatically starts it as a process running in the background each time that the system boots. If you did not install the VoIP Notification Trap Adapter as a service, you can manually create the service and start it.

This section describes how to manually create a service for the VoIP Notification Trap Adapter, if necessary, and the acceptable sm_service values for this adapter.

To manually create a service for the VoIP Notification Trap Adapter, use the sm_service install command. A typical service command on a UNIX host looks like this:

/opt/InCharge/VoIP/smarts/bin/sm_service install
 --force
 --startmode=runonce
 --name=ic-voip-notification-trapd-receiver
 --description=”VMware Smart Assurance VoIP Notification Trap Adapter”
 /opt/InCharge/VoIP/smarts/bin/sm_trapd
 --name=TRAP-INCHARGE-VOIP
 --server=INCHARGE-OI
 --config=voip
 --port=9002
 --model=sm_actions
 --rules=voip/trap_mgr_parse.asl
 --output=TRAP-INCHARGE-VOIP

where:

  • --name=<name>

    (Second --name option in service command): Specifies the VoIP Notification Trap Adapter name to be registered with the Broker for the deployment. Also -n <name>.

  • --server=<name>

    Specifies the name of the Adapter Platform that is to receive the processed traps from the VoIP Notification Trap Adapter. The Adapter Platform uses the processed traps to create VMware Smart Assurance notification objects.

  • --config=<cfg>

    Specifies the configuration directory in which the icoi/avaya_trap_mgr.conf, icoi/cisco_trap_mgr.conf, icoi/nortel_trap_mgr.conf, and trapd.conf configuration files for the VoIP Notification Trap Adapter are located. A configuration file is loaded from the BASEDIR/smarts/local/conf/<cfg> directory, or from the BASEDIR/smarts/conf/<cfg> directory if the configuration file is not present in the local directory. The default configuration (<cfg>) directory for the VoIP Notification Trap Adapter is voip.

    Note:

    Ensure that --config is set to voip in the VoIP Notification Trap Adapter service command.

  • --port=<trap listening port>

    Specifies the port number to which the managed network devices send traps and on which the VoIP Notification Trap Adapter listens for traps. Also -p <trap listening port>.

    The default trap listening port is the PORT parameter value in the <cfg>/trapd.conf file (port 9002 by default), or port 162 if no PORT value is specified in the <cfg>/trapd.conf file.

  • --sport=<Remote API listening port>

    Specifies the port number on which the VoIP Notification Trap Adapter listens for Remote API connections from other VMware Smart Assurance programs—the Global Console, servers, and utilities such as dmctl. This option is meaningful only if the --name option is specified. Also -P <Remote API listening port>.

    The --sport option for the sm_trapd program plays the same role as the --port option plays for any other VMware Smart Assurance program. The --sport option is unique to the sm_trapd program and defaults to 0.

    Note:

    --sport=0 is interpreted by the host operating system as meaning “assign this program a unique, unused port number.” Typically, the operating system responds by assigning a unique, unused port number in the range 40000–65535.

  • --model=sm_actions

    Specifies the name of the model library to be loaded by the VoIP Notification Trap Adapter.

  • --rules=voip/trap_mgr_parse.asl

    Specifies the rule set to be used by the VoIP Notification Trap Adapter. The rule set used is defined in the BASEDIR/smarts/rules/voip/trap_mgr_parse.asl file.

  • --output=TRAP-INCHARGE-VOIP

    Specifies that the stdout and stderr output for the VoIP Notification Trap Adapter should be redirected to the TRAP-INCHARGE-VOIP_en_US_UTF-8.log file in the BASEDIR/smarts/local/logs directory. If you specify a different filename, the log file is named <file>_en_US_UTF-8.log.

    For example, here is the UNIX command for restarting the VoIP Notification Trap Adapter installed as ic-voip-notification-trapd-receiver:

    /opt/InCharge/VoIP/smarts/bin/sm_service start 
       ic-voip-notification-trapd-receiver
    

    At startup, the VoIP Notification Trap Adapter reads its configuration files and saves the configuration information in its repository.