NAME

na.snmp.hostfile - Site/SunNet/Domain Manager SNMP target configuration file

DESCRIPTION

na.snmp.hostfile is a keyword in snm.conf(5) that points to the file the SNMP proxy agent and SNMP trap proxy use to obtain target-specific information.

SYNTAX

Entries are listed one line per system. Each field in the entry is separated by white space. The format is:

host-name read-community write-community request-timeout schema-file [trap-file proxy-name]

where

host-name

is the name of the device manageable by the SNMP proxy agent na.snmp. The name is not case-sensitive.

read-community

is the SNMP community name (default is ``public'') the proxy agent uses when reading attribute values from host-name.

write-community

is the SNMP community name (default is ``public'') the proxy agent uses when writing attribute values to host-name.

request-timeout

is the time, in seconds (default is 5) that the proxy agent waits for a response from host-name.

schema-file

is a colon-separated list of the names of the agent schema files that contain the group and attribute definitions for host-name. Note that each name must be an absolute path name that begins with a slash (/). Each schema file must reside in a directory specified by the "na.snmp.schemas" keyword in the /etc/opt/SUNWconn/snm/snm.conf file for Solaris 2.x and in the /etc/snm.conf file for Solaris 1.x.

The schema for host-name is only used on the machine where the agent runs, unlike other agent schema used only by the manager station.

If you add groups (that is, enterprise information) for host-name to be managed by the proxy, put the information in this schema file, and add the groups to the schema used by the manager.

trap-file is the name of the trap file that contains the trap definitions for host-name. Note

that this must be an absolute path name that begins with a slash (/). Default is the file associated with the ``na.snmp-trap.default-trapfile'' keyword in snm.conf(5).

If you wish to use the default trap file, specify "-" as trap-path.

vendor-proxy

is an optional field containing the host to send an SNMP request if the SNMP proxy agent cannot send a request directly to an agent on host-name. It is

assumed the SNMP agent on vendor-proxy can send a request to an agent on hostname, possibly using another protocol than the SNMP.

If an entry is not listed for a given host, the SNMP proxy agent uses the groups from the default schema and trap files (specified by the ``na.snmp.default-schema'' and ``na.snmp-trap.default-trapfile'' keywords in snm.conf(5) ), uses ``public'' for readcommunity and write-community, and a request-timeout of five seconds.

SEE ALSO

snm.conf(5), na.snmp(8), na.snmp-trap(8)

NOTES

na.snmp.hostfile is not a file; it is the name of a keyword in snm.conf(5). Since you can change the name of the file, it is listed by its keyword.