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.snmptrap.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 host-name, 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.snmptrap.default-trapfile'' keywords in snm.conf(5) ), uses
``public'' for read-community 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.