DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
Developing SMUX peers for SNMP agents

An example SMUX session

Let's examine a typical scenario by walking through an example SMUX session. There are three major participants in this SMUX session: a network management station, an SNMP agent, and an SMUX peer used to manage the multiport serial board (see ``Example SMUX session'')

In this example, the SMUX peer is used to manage the multiport serial board installed in a host running the SCO UNIX system. The system administrator wants to use the network management station to get the baud rate for serial line 2 of the multiport serial board installed in the host.

The session has the following phases:

  1. ``Initialization''

  2. ``Exchange of MIB information''

  3. ``Asynchronous events''

  4. ``Termination''

Example SMUX session

Initialization

  1. The host computer boots, which starts the SNMP agent.

  2. The SMUX peer starts running.

  3. The peer establishes a TCP connection to the agent. The subsequent interaction between the SMUX peer and the SNMP agent is called an ``SMUX association.''

  4. The peer registers itself with the agent. During registration, the peer specifies which part of the MIB it wishes to maintain (this specified part of the MIB is called a ``MIB module''). In this example, the peer wishes to manage the MIB module that contains the variables pertaining to the multiport serial board.

Exchange of MIB information

  1. The process of information exchange between the management station and the SMUX peer begins when the system administrator uses the network management station to ask for the baud rate for serial line 2 on the multiport serial board.

  2. The SNMP client, running on the management station, sends a GetRequest message over the network to the agent.

  3. The agent sees that the MIB module containing the baud rate of serial line 2 has been registered by the peer, so the agent sends an SMUX GetRequest message to the peer, requesting the baud rate for serial line 2.

  4. Upon receiving the SMUX GetRequest message, the peer decodes it and finds a request for the baud rate of serial line 2 of the serial board.

  5. The peer gets the baud rate from the serial board device driver.

  6. The peer encodes the baud rate in an SMUX response message and sends the message to the SNMP agent.

  7. The agent receives the SMUX message from the peer, translates it into an SNMP GetResponse message, and sends it on to the management station.

  8. The management station receives the response message from the agent and displays the baud rate for serial line 2.

Asynchronous events

Not all messages in this system originate with the management station. If the peer detects a noteworthy condition from the serial board, the peer sends an unsolicited message called an ``SMUX trap'' to the agent. The agent translates it into an SNMP trap, which is then sent to the network management station.

Termination

  1. Ultimately, the peer will receive a signal to terminate itself.

  2. The peer removes its registration with the agent and closes the SMUX association.

  3. Any subsequent requests by the SNMP client for information contained in the unregistered module will be handled by the SNMP agent (see ``Terminating an SMUX association'' for further information).

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 27 April 2004