Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


6.3.6 SNMP definition file (ssosnmp.conf)

In the SNMP definition file, specify definitions of SNMP requests to be issued by SSO. If you have changed this file, perform one of the following operations:

Organization of this subsection

(1) Format

In the SNMP definition file, specify each SNMP agent definition on one line. Write the definition items in the order in which they are listed in the table in (2) Description, and delimit the items with a colon (:).

(2) Description

The next table lists the items that must be or can be defined in an SNMP definition file.

Entry name

Value

category-name

  • For resource collection

    Specify a category name. To collect the resources provided by SSO, specify sso or sso-ex. To collect user resources, specify the category name. If you do not specify a category name, the sso definition becomes valid.

  • For process or service monitoring

    process definition becomes valid. If the process definition is not found, the definition specifying sso becomes valid. If neither process nor sso is defined, the default is set.

The specified category name is not case sensitive.

IP-address

Specify the IP address of the target agent. The specification format varies between IPv4 and IPv6.

For IPv4, specify the IP address in the n.n.n.n format. For n, specify a value from 0 to 255 or an asterisk (*) as a wild card.

For IPv6, specify the IP address in the [x:x:x:x:x:x:x:x] format. For x, specify a value from 0 to FFFF or an asterisk (*) as a wild card.

The default value of each item is set in undefined agents.

get-community-name

<<public>>

((character string of up to 255 bytes))

Set the community name to be used when an SNMP Get/Get-Next request is issued to the target agent. You cannot specify a colon (:).

For the resource monitoring function, if 3 is specified for the SNMP version and the specification of the corresponding unique name is enabled, the specification of get-community-name will be ignored.

set-community-name

<<get-community-name>>

((character string of up to 255 bytes))

Set the community name to be used when an SNMP Set request is issued to the target agent. You cannot specify a colon (:).

For the resource monitoring function, if 3 is specified for the SNMP version and the specification of the corresponding unique name is enabled, the specification of set-community-name will be ignored.

response-monitoring-time

<<20>> ((1 to 990))

Specify, in units of 1/10 seconds, the response monitoring time to be used when an SNMP request is issued to the target agent.

retry-count

<<3>> ((0 to 99))

Specify the number of retries to be attempted when an SNMP request is issued to the target agent.

port-number

<<161>> ((1 to 65535))

Specify the port number to be used when an SNMP request is issued to the target agent.

SNMP-proxy-IP-address#1

The proxy IP address for issuing an SNMP request to the target agent is specified in the format of n.n.n.n. For n, specify a value from 0 to 255.

SNMP-version#2, #3

<<User resource: 1, SSO-Ex category resource: 2, SSO category resource: 1 or 2#4>>

Specify the version of SNMP to be used to browse or collect resources.

The specifiable values are 1, 2 or 3.

1: Use SNMP Version 1 (SNMPv1) to issue requests.

2: Use SNMP Version 2 (SNMPv2c) to issue requests.

3: Use SNMP Version 3 (SNMPv3) to issue requests.

If 1 or 2 is specified:

SNMP is enabled for only user resources.

If 3 is specified:

SNMP is enabled for all resources (both resources provided by SSO and user resources).

unique-name#5

Specify the unique name of the SNMPv3 definition to be registered by using the ssosnmpv3setup command.

Note that the specification of this item is valid only if 3 is specified as the SNMP version.

#1

If you omit the IP address of the SNMP proxy, the SNMP version, and other subsequent items, you do not need to specify delimiters (:).

#2

If you omit the SNMP version and the unique name that follows, you can also omit the delimiter (:) that is to be specified at the end of the value.

#3

The SNMP version is fixed to 1 for the process categories. If you want to acquire Counter64-type MIB values during user resource collection, specify 2 or 3 for the IP address and port number of the collection-target agent.

If a collection-target agent does not support SNMPv1, you can collect user resources by specifying 2 or 3. Note, however, that if you specify 3, you can also browse resources and collect resources of the sso category.

#4

Set the SNMP version to 2 only when MIBs of the Counter64 or CounterBasedGauge64 type will be collected.

#5

If you omit the unique name, you can also omit the delimiter (:) that is to be specified at the end of the value.

When coding definitions in an SNMP definition file, note the following:

(3) Example

The following is an example of an SNMP definition file.

[Figure]

In this example, when you collect SSO-Ex resources for target 100.100.100.2, the definition of sso-ex:*.*.*.*:public:public:20:3:::: becomes valid. When you collect user resources for the same target, the definition of sso:*.*.*.*:public:public:8:2:161:: becomes valid.

If resources are to be collected from target 172.16.45.42, communication will be performed by using SNMPv3. If processes and services are to be monitored, the specification of get-community-name and set-community-name will be valid, and communication will be performed by using SNMPv1.