[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 4

ntx_snmp Command

Purpose

Sets and displays the state of the Network Terminal Accelerator (NTX) Simple Network Management Protocol (SNMP) agent.

Syntax

ntx_snmp [ -d Device ] [ on | off ]

Description

The ntx_snmp command sets and displays the state of the adapter's SNMP agent. You use this command to turn the SNMP agent on or off.

Before turning the SNMP agent on, consider issuing the ntx_comun and ntx_nms commands. The ntx_comun command configures network management station (NMS) community profiles. A community profile is a set of permissions for access to the SNMP agent's Management Information Base (MIB). The ntx_nms command determines which NMSs are authorized to interact with the SNMP agent.

If the cold start trap is enabled, the agent sends the trap protocol data unit (PDU) when the first ntx_snmp on command is issued. For information about enabling the cold start trap and other traps, see the ntx_traps command.

To stop an SNMP agent, issue the ntx_snmp off command. Stopping the agent may be necessary if a configuration error occurs, if an NMS malfunctions, or if a security breach is detected. After the network administrator has remedied the problem, the host can restart the SNMP agent by issuing the ntx_snmp on command.

SNMP Agent

The SNMP implementation consists of an SNMP agent that executes on intelligent communications adapters. The SNMP agent manages the adapter and its associated software. The SNMP agent does not manage the host computer.

Once configured, the SNMP agent responds to PDUs received from the network. The host utilities provide a means for a network administrator to configure the SNMP agent with site-specific information. For detailed information on the individual host utilities, see RFC 1157, Simple Network Management Protocol and RFC 1213, Management Information Base for Network Management of TCP/IP-Based Internets: MIB-II.

Note: The SNMP agent complies with both MIB-II (RFC 1213) and the SNMP protocol (RFC 1157).

The host must explicitly start the on-board agent with the ntx_snmp on command. Before the host issues the ntx_snmp on command, the SNMP agent does not respond to any SNMP PDUs. This allows the host to configure community profiles and to configure which NMSs have access to the agent.

SNMP Profiles

The ntx_nms and ntx_comun commands configure the NMSs and community profiles, respectively. If the network administrator does not require this security, the SNMP agent uses a default read-only community profile. In order to use the public default community profile, the host may issue the ntx_snmp on command without issuing the other commands. This profile allows the public community read-only access to the entire MIB.

Along with starting and stopping the SNMP agent and configuring community profiles, the host can configure some site-specific information which the agent holds in its MIB. See the ntx_descr command for more information about configuring site-specific information.

Flags

-d Device Sets the adapter raw device file name. The default is the /dev/rhp0 file.

Exit Status

This command returns the following exit values:

0 Indicates the agent is on if neither the on nor off option was specified with the command. If either the on or off keyword was specified, a 0 indicates success.
1 Indicates the agent is off.
2 Indicates a failure.

Security

Access Control: You must have root authority to run this command.

Auditing Events: N/A

Examples

  1. To turn on the SNMP agent, enter:
    ntx_snmp on
  2. To get the current state of the agent, enter:
    ntx_snmp
    SNMP is on

Files

/usr/bin/ntx_snmp Contains the ntx_snmp command.
/dev/rhp0 Default NTX raw device file name.

Related Information

Commands: ntx_comun, ntx_descr, ntx_nms, ntx_traps.

Files: /dev/rhp.

"Configuring the Network Terminal Accelerator" in AIX Versions 3.2 and 4 Asynchronous Communications Guide

RFC 1157, Simple Network Management Protocol.

RFC 1213, Management Information Base for Network Management of TCP/IP-Based Internets: MIB-II.


[ Previous | Next | Contents | Glossary | Home | Search ]