Setting Up the Services File

When setting up the services file on the Operations Sentinel server, you must include in this file the following information for each unique MCP host port number used at your site:

Format of the Services File

The format for each line in the services file is

service–name  port–number/service–protocol  [#comment]

where:

servicename

can be any arbitrary name. The name you specify must be the same as the service name for the MCP host you specify in the Operations Sentinel configuration. The default name is spo_mcp. However, you must specify a different service name for each port number that is assigned on the host side.

portnumber

is defined for each site and MCP host system. It must match the port number you specify for the DEFAULT_SOCKET parameter in the interface software configuration file. See Section 3 for additional information about the configuration file.

serviceprotocol

is a fixed name (spo_msg).

comment

is any optional descriptive information about this entity. A # must precede the comment.

For example, if an MCP host system with a service name of Mpls_003 has designated 5114 as its port number for the spo_msg service, the entry in the services file on the Operations Sentinel server is

Mpls_003  5114/spo_msg

After you have installed the interface software on MCP host system Mpls_003, you must enter the same port number for the DEFAULT_SOCKET parameter in the configuration file on this host system as follows:

DEFAULT_SOCKET  5114

Port numbers you assign for spo_msg services must be unique only within a single MCP host system. On multiple MCP host systems, you can use the same number for one port on each host system. You would specify this number only once in the services file on the Operations Sentinel server and specify it for the DEFAULT_SOCKET parameter for each managed MCP host system.

For example, the default MCP services added when Operations Sentinel level 7.3 or later is installed are

spo_mcp 10301/spo_msg
spo_mcp2  10302/spo_msg

The default port number 10301 is specified as the value for DEFAULT_SOCKET in the configuration file supplied as part of the interface software. If you specify a different port number in the services file, you must change the value for DEFAULT_SOCKET in the configuration file on each managed MCP host system.

Alternatively, you may assign different spo_msg port numbers for each MCP host system. Now you must make a separate entry in the services file on the Operations Sentinel server for each MCP host system. For example

Mpls_001	5116/spo_msg
Mpls_002	5115/spo_msg
Mpls_003	5114/spo_msg
StP_001		5555/spo_msg

In this case, you must enter the corresponding port number as the value for DEFAULT_SOCKET in the interface software configuration file on each MCP host system connected to the Operations Sentinel server.

You must update the services file before the interface to the system that is to be managed can be initialized.