Name

Network management (SNMP) for sipd Internet telephony server

It contains two parts on the server side:

1. The SNMP Master agent. Click here to see how to start the SNMP master agent. The master agent needs "snmpd.conf" and "snmp.conf" in correct place to function properly.
2. The sipd server. Click here to see how to start the sipd server.

Please note: The proper order of starting the server is to start the SNMP master agent first. After the master agent is up, then start the sipd server. If you made any code changes to the sipd server, quit the master agent if it is running. Compile the sipd. Restart the master agent and then restart the sipd server. It will cause "Segmentation Fault" to both the SNMP master agent and the sipd server if this order is not followed.

On the SNMP client side, you are free to use any commercial MIB browser. I chose to use the MIB Browser by MG-SOFT .

Availability

• The UCD SNMP package is available at UCD-SNMP Project page
• The binary distribution of sipd server with SNMP SIP-MIB support is available here. Please Note: you just need to use "$tar xvf sipwsnmp.tar" to untar the file. Do not rebuild the sipd as described by "./README.build" because the mechanism to configure the system has not been modified to accommodate the new code.

Configuration

• See here for the description of sipd.conf
• See here for snmpd.conf and here for snmp.conf.

Description

The program added SNMP SIP-MIB support to the existing sipd server. This enhancement enables the network managers to use NMS (Network Management Station or MIB Browser) to monitor the sipd server from any remote location.

Features

The following SIP-MIB variables can be queried. They are:

• sipCommonCfgTable
• sipServiceOperStatus
• sipServiceStartTime
• sipPortTable
• sipTransport
• sipMethodStatsTable
• sipStatsInviteIns
• sipStatsAckIns
• sipStatsByeIns
• sipStatsCancelIns
• sipStatsOptionsIns
• sipStatsRegisterIns
• sipCurrentTransTable
• sipCurrentTransactions
• sipTransactionTable
• sipTransTo
• sipTransFrom
• sipTransCallId
• sipTransCSeq
• sipTransNumOutstandingBranches
• sipTransExpiry
• sipTransCallingPartyContentType
• sipTransCalledPartyContentType

The graphical representation of the SIP-COMMON-MIB tree can been seen here.

Options

• SNMP Master Agent Option, see here.
• sipd server option, see here,

System Requirement

• The NMS - MG-SOFT 's MIB Browser requires Windows 95/98 or Windows NT
• The UCD-SNMP package runs on Solaris OS
• The sipd server runs on Solaris OS

Notes: Files has been created and modified

• New files created:
• ./libsip/sipsnmp.c, sipsnmp.h -- subagent function
• ./libsip/sipCommon.c, ./libsip/sipCommon.h -- agent extension for SIP-COMMON-MIB
• Files in sipd have been modified :
• ./sipd/sipd.c - created the third thread beyond tcp thread and udp thread.
• ./libsip/request.c - created and programmed the SNMP variables
• ./Makefile, ./libsip/module.mk, ./sipd/module.mk

Authors

Yanchen Qi at Department of Computer Science, Columbia University, New York, NY 10027. yqi@cs.columbia.edu

Acknowledgements

• The sipd server code is developed by Internet Real-Time Lab, Columbia University
• The SNMP Master Agent and other supporting functions are developed by UC Davis NET-SNMP Project Group

Copyright

Copyright 2000 by Columbia University; all rights reserved

Permission to use, copy, modify, and distribute this software and its documentation for not-for-profit research and educational purposes and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that the copyright notice and warranty disclaimer appear in supporting documentation, and that the names of the copyright holders or any of their entities not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.

The copyright holders disclaim all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall the copyright holders be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortuous action, arising out of or in connection with the use or performance of this software.