6
Setting Up SNMP
SNMP is a protocol used by many network tools to manage devices that are networked together with TCP/IP. If your site runs an SNMP agent manager, you can set SNMP traps and community strings in the remote configuration file, and take advantage of the remote reboot variable in the mib.txt file.
Note: |
The SNMP daemon (snmpd) is inactive while flashing the
network computer (with the do_flash command).
|
Supported Traps
The supported traps are:
- coldStart (1) the network computer issues this trap whenever the SNMP agent is started and the current time is sufficiently close to zero.
- warmStart (2) the network computer issues this trap whenever the SNMP agent is started and the current time is sufficiently greater than zero.
- authenticationFailure (16) signifies that the sending protocol entity is the addressee of a protocol message that is not properly authenticated.
Configuration File Entry Examples
In the following xp.cnf example, the first line directs that the warmStart and authenticationFailure traps (2+16=18) are sent to the host oregon, using the community string public. The second line allows any host to use the community string public to browse (do GETs on) the network computer's management information base (MIB). The third line allows the host oregon to use the community string TekX to both GET and SET MIB variables.
snmp_trap_list oregon public 18
snmp_comm_list 0.0.0.0 public R
snmp_comm_list oregon TekX RW
Note: |
The available SNMP commands depend on the host client(s) used.
|
mib.txt File
The mib.txt file (found in /tekxp/mgmt/mib.txt) contains MIB II and NCD MIB definitions. The NCD MIB portion of the mib.txt file includes network computer settings specified in Setup or in the xp.cnf file. These settings are not available in the MIB II portion of the file. The mib.txt file specifies system-level objects used by the network manager to identify the node being managed. The object system.sysDescr is a text string intended to be human-readable. When asked for the object, network computers respond with a string identifying the manufacturer, product nomenclature, and system version level. Here is an example:
XP400 version 2 level 0
System Object Identifier
The system object identifier (sysObjectID) uniquely identifies the type of device being managed. Objects are named in the iso(1) org(3) dod(6) internet(1) private(4) enterprises(1) subtree. There is an object identifier for each network computer model. For a complete list of object identifiers, refer to the mib.txt file.
An XP356 network computer would have a sysObjectID of:
- 1.3.6.1.4.1.128.1.2.3.356
(iso.org.dod.internet.private.enterprises.tek.nwd.nwdproducts.xp.xp356)
You can reboot any NCD network computer by using the reboot variable (1) and specifying the MIB file:
- 1.3.6.1.4.1.128.1.1.3.1.1.0 i 1
(iso.org.dod.internet.private.enterprises.tek.nwd.nwdmibs.xpmib.xpsys.xpreboot)
mib.txt Network Computer-Specific Objects
Table 6-1 lists network computer-specific objects that are included in the mib.txt file (located in /tekxp/mgmt/mib.txt). These can be set using SNMP. Many of these objects are also set through the remote configuration file (xp.cnf) or in Setup. Where applicable, the equivalent remote configuration command is given. Refer to Chapter 2, Remote Configuration for details about the remote configuration file and commands.
Table 6-1 Network Computer Objects in the mib.txt File
mib.txt file object |
xp.cnf Command Equivalent |
Description |
xpreboot |
|
Reboots the network computer. |
xpSysServerReset |
|
Resets the server. |
xpSysNvSave |
|
Invokes NVSAVE. |
xpSysKeyboardNationality |
keyboard_language |
These objects specify keyboard settings. |
xpSysKeyboardLayout |
keyboard_type |
xpSysLanguage |
language |
xpSysScreenSaver |
screen_saver |
Invokes the screen saver. |
xpSysAuthorizationKeySet |
|
Specifies the authorization key. |
xpSysDefaultTelnetHost |
default_telnet_host |
Specifies the default Telnet host. |
xpSysOptionsMask |
|
Specifies options mask. |
xpSysSoftReboot |
|
Specifies a network computer reboot after the user logs out. This allows access to a new configuration after rebooting. |
xpSysLogHost |
loghost |
These objects specify the console log messages. |
xpSysLogFacility |
logfacility |
xpSysLogPriority |
logpriority |
xpSysEnableLogging |
enable_remote_logging |
xpSysConfigurationStatus |
|
Specifies whether the SNMP trap is read on subsequent network computer reboots. |
xpSysBootRomVersion |
|
Displays the boot ROM version in use. |
xpMemStdRam |
|
These objects specify memory statistics. Partitions cannot be altered by the software. In Setup, the Memory option on the Statistics menu displays memory information as well. |
xpMemOptRam |
|
xpMemStdGraphicsRam |
|
xpMemOptGraphicsRam |
|
xpMemVideoRam |
|
xpMemAvailable |
|
xpMemLBlock |
|
|
xpDisVerticalResolution |
|
These objects specify the network computer type and configuration. |
xpDisHorizontalResolution |
|
xpDisVerticalSize |
|
xpDisHorizontalSize |
|
xpDisBitPlanes |
|
xpDisColor |
|
xpDisTypeCode |
|
xpMbufsTotalMbufs |
|
These objects specify amounts and usage of the system network buffers. In Setup, the Network option on the Statistics menu displays network information as well. |
xpMbufsFreeMbufs |
|
xpMbufsTotalClusters |
|
xpMbufsFreeClusters |
|
xpMbufsData |
|
xpMbufsHeader |
|
xpMbufsSocket |
|
xpMbufsPcb |
|
xpMbufsRtable |
|
xpMbufsSoname |
|
xpMbufsSoopts |
|
xpMbufsFtable |
|
xpMbufsRights |
|
xpMbufsIfaddr |
|
xpMbufsOther |
|
xpTftpReadRequests |
|
These objects specify tftp statistics. |
xpTftpWriteRequests |
|
xpTftpInDataPkts |
|
xpTftpOutDataPkts |
|
xpTftpInAckPkts |
|
xpTftpOutAckPkts |
|
xpTftpNoFileErrors |
|
These objects specify error message handling. |
xpTftpTimeout |
|
xpTftpRetries |
|
xpPrimaryBootMethod |
boot_method |
These objects specify boot parameters. |
xpPrimaryBootHostAddr |
boot_host_name |
xpPrimaryBootPath |
boot_path |
xpSecondaryBootMethod |
boot_method_2 |
xpSecondaryBootHostAddr |
boot_host_name_2 |
These objects specify the Domain Name System for the network computer. |
xpSecondaryBootPath |
boot_path_2 |
xpBootAddrFrom |
determine_address_from |
xpBootDelay |
boot_delay |
xpBootVerbose |
verbose_boot_msg |
xpBootInterrupt |
enable_boot_interrupt |
xpBootConfig |
boot_config_type |
xpDnsEnable |
enable_name_service |
xpDnsDefaultDomain |
default_domain_suffix |
xpDnsTimeout |
dns_timeout |
xpDnsRetries |
dns_retries |
xpDnsNameServer1 |
name_server_1 |
xpDnsNameServer2 |
name_server_2 |
xpDnsNameServer3 |
name_server_3 |
xpXAccessControl |
enable_access_control |
These objects specify X parameters. |
xpXAccessTable |
display_access_table |
xpXAccessEntry |
display_access_table |
xpXAccessEntryHost |
display_access_table |
xpXAccessEntryEnable |
|
xpXRetainSettings |
retain_x_settings |
xpXBackingStore |
backing_store |
xpXDefaultVisual |
default_visual |
xpXHostConnect |
host_connect_method |
xpXXdmcpConnect |
xdmcp_connect |
xpXXdmcpTable |
|
xpXXdmcpEntry |
xdmcp_menu_entry |
xpXXdmcpEntryIndex |
|
xpXXdmcpServer |
xdmcp_server |
xpXOldDecWindows |
old_decwin_compatible |
xpXWinddServer |
default_windd_host |
|
xpSerialTable |
|
These objects specify serial port control. |
xpSerialEntry |
|
XpSerialEntryIndex |
|
xpSerialEntryBaud |
baud_rate_0 |
xpSerialEntryStopBits |
stop_bits_0 |
xpSerialEntryDataBits |
data_bits_0 |
xpSerialEntryParity |
parity_0 |
xpSerialEntryFlowControl |
flow_control_0 |
xpSerialNetToSerial |
|
Serial port control (continued) |
xpSysEnableDisableNtoPort |
enable_net_to_port disable_net_to_port |
xpSerialNetToSerialPriority |
enable_net_to_port |
xpSerialNetToSerialProtocol |
net_to_port_protocol |
xpSerialNetToSerial- Connections |
net_to_port_connections |
xpSlipPort |
|
|
xpSlipComd |
|
|
xpSlipDestIP |
|
|
xpPrintTable |
|
These objects specify printer attributes. |
xpPrintEntry |
|
|
xpPrintEntryIndex |
|
|
xpPrintEntryStatus |
enable_print_spooler |
|
xpPrintEntryAttribute |
spooler_local_queue spooler_remote_queue |
Local/remote print spooler queue |
xpPrintEntryValue |
spooler_local_queue spooler_remote_queue |
Queue name |
xpFilePrimaryAccess |
file_access_1 |
These objects specify host file access control. |
xpFilePrimaryHost |
file_host_name_1 |
xpFilePrimaryPathOrRoot |
file_path_1 |
xpFileSecondaryAccess |
file_access_2 |
xpFileSecondaryHost |
file_host_name_2 |
xpFileSecondaryPathOrRoot |
file_path_2 |
xpFontsTable |
|
These objects specify font accessibility. |
xpFontsEntry |
|
xpFontsEntryIndex |
|
xpFontsEntryPath |
|
xpNfsTable |
nfs_table |
These objects specify NFS statistics and NFS mount table settings. |
xpNfsEntry |
nfs_entry |
xpNfsEntryIndex |
|
|
xpNfsEntryLocalDir |
nfs_entry |
xpNfsEntryServerAddr |
nfs_entry |
xpNfsEntryServerDir |
nfs_entry |
xpNfsEntryReadSize |
nfs_entry |
xpNfsEntryWriteSize |
nfs_entry |
xpNfsEntryRetrans |
|
xpNfsEntryTimeout |
|
xpNfsNulls |
|
xpNfsGetAttributes |
|
xpNfsSetAttributes |
|
xpNfsGetRoots |
|
xpNfsLookups |
|
xpNfsReadLinks |
|
xpNfsReads |
|
xpNfsWriteCaches |
|
xpNfsWrites |
|
xpNfsCreates |
|
xpNfsRemoves |
|
xpNfsRenames |
|
xpNfsCreateLinks |
|
xpNfsCreateSymlinks |
|
xpNfsMakeDirs |
|
xpNfsRemoveDirs |
|
NFS statistics and NFS mount table settings (continued) |
xpNfsReadDirs |
|
xpNfsStatFileSys |
|