MIMIC® Online Documentation

<< Previous Section    Next Section >>

MIMIC SNMP over TCP Protocol Module Guide

  1. Table of Contents

  2. Overview

    The MIMIC SNMPTCP Protocol Module is an optional facility that enables SNMP over TCP (RFC 3430).

    Back to Top

  3. Installation

    SNMP over TCP support is made available in MIMIC as an optional dynamically loadable module. Starting with MIMIC 10.00, you can use the Protocol Wizard to install the SNMPTCP module. If you prefer to enable SNMPTCP by hand, you need to do the following:

    • Use File->Terminate to stop the any running MIMIC daemon.

    • Copy the SNMPTCP shared library (snmptcp.dll on Windows, snmptcp.so on Unix) from "bin/dynamic/optional" to "bin/dynamic" in the install directory. Currently it is available only for Linux and Solaris.

    • Install the license keys as detailed in the instructions e-mailed to you.

    • Restart MIMIC. You should see the following type of message in the MIMICLog that confirms that the SNMPTCP module was properly loaded : 
      INFO  - SNMPTCP : Loaded protocol from < path-to-DLL >
INFO  - SNMPTCP v7.00 : Individual license #2345

    Once SNMPTCP is loaded, any agent instance configured to support the SNMPTCP protocol will be able to run the SNMP over TCP transport mapping.

    Back to Top

  4. Using SNMPTCP from MIMICView

    If the SNMPTCP module is enabled, then Agent->Add, Agent->Configure and Agent->Paste dialogs will display SNMPTCP as an additional checkbox in the Advanced pane along with the SNMP protocols. On selecting the checkbox a new SNMPTCP pane will appear.

    This SNMPTCP configuration pane lets the user configure the parameters for a SNMPTCP session:

    • Connection

      This optional parameter specifies the number of simultaneous connections for an agent. The default is 10 connection, which be configured through snmptcp.cfg file.

    Back to Top

  5. Using SNMPTCP from MIMICShell

    A few new commands and some enhanced old commands can be used from the MIMICShell to control the SNMPTCP functionality. Here is a synopsis:

    • mimic protocol msg SNMPTCP get args

      This command lets the user gather the self-defining list of arguments required and their particulars. The parameters are detailed above. A sample exchange for this command would be: 

      mimicsh> mimic protocol msg SNMPTCP get args
{{connections} {Connections} {integer} {} {optional} {10}}

    • mimic agent get protocol

      This command lets the user look at the protocols currently configured on the agent. A sample exchange for this command would be: 

        mimicsh> mimic agent get protocol
  snmpv1,snmpv2c,SNMPTCP

    • mimic agent set protocol

      This command lets the user change the protocol setting for an agent. A sample exchange for this command would be: 

        mimicsh> mimic agent get protocol
  snmpv1
  mimicsh> mimic agent set protocol snmpv1,SNMPTCP
  mimicsh> mimic agent get protocol
  snmpv1,SNMPTCP

    • mimic agent protocol msg SNMPTCP get config

      This command lets the user get the current argument settings. A sample exchange for this command would be: 

        mimicsh> mimic agent protocol msg SNMPTCP get config
  {connections=10}

    • mimic agent protocol msg SNMPTCP set config [config]

      This command lets the user change the current argument settings of all SNMPTCP sessions for an agent. A sample exchange for this command would be: 

        mimicsh> mimic agent protocol msg SNMPTCP get config
  {connections=10} 

  mimicsh> mimic agent protocol msg SNMPTCP set config {connections=20}

  mimicsh>  mimic agent protocol msg SNMPTCP get config
  {connections=20}

    • mimic agent protocol msg SNMPTCP ipalias enable ipaddress[,port]

      This command can be used to enable TCP transport access for an existing UDP transport access point (also known as ipalias). If the port number is unspecified the first UDP access port number for the specified IP address will be used.

    • mimic agent protocol msg SNMPTCP ipalias disable ipaddress[,port]

      This command can be used to disable TCP transport access point. If the port number is unspecified it will disable the first enabled TCP access port for the specified IP address.

    • mimic agent protocol msg SNMPTCP ipalias isenabled ipaddress,port

      isenabled predicate returns 1 if the TCP access point is configure otherwise it returns 0.

    • mimic agent protocol msg SNMPTCP ipalias list

      This command list all the configured TCP transport access points .

    • mimic protocol msg SNMPTCP get stats_hdr
      mimic agent protocol msg SNMPTCP get statistics

      Returns SNMPTCP statistics information:

      • a list of statistic headers, and
      • current statistics values for the specified server.

      In order, the statistic values are:

      • Total number of SNMPTCP connections.
      • Total number of SNMPTCP disconnects.

      A sample exchange for these commands would be: 

        mimicsh> mimic protocol msg SNMPTCP get stats_hdr
  {{connect} {Connect}} {{disconnect} {Disconnect}}

  mimicsh> mimic agent protocol msg SNMPTCP get statistics
  2 2
    Back to Top
    << Previous Section    Next Section >>