Enabling SNMP

Symphony SNMP support is built upon Microsoft's Extendible SNMP Agent. During Symphony installation, the Symphony SNMP Extension-Agent is registered with Microsoft's SNMP Agent by modifying the Windows registry.

 

The Symphony Get Info feature provides more information than “Walking” through mib files using a SNMP query tool. See Receiving Full Diagnostic Information .

 

To enable SNMP in Symphony:

Ensure that Microsoft's SNMP Windows Component is installed and set to start automatically with Windows.

Task 1:  Enable SNMP in Symphony

1.      From the Server menu, select Configuration.

2.      In the left pane, click General Settings. The General Settings dialog box opens.

3.      In the SNMP group area, select the Enabled check box and click OK.

4.      Restart Symphony services: From the Server menu, select Services, and then Start Symphony Services.

Task 2:  Configure SNMP Service Security

Microsoft’s SNMP Agent supports SNMP v2c; therefore, the SNMP Agent must be configured with the accepted community names and hosts.

1.      Ensure that SNMP service is installed on your machine: Control Panel>Programs and Features>Windows Features>Simple Network Management Protocol(SNMP) check box.

  

 

2.      Ensure that you are logged on as local administrator; otherwise, depending on your Windows operating system, the Security tab in the SNMP Service Properties dialog box will not be accessible or visible.

3.      Via the Windows Services management console, open the properties of the SNMP Service.

  

 

4.      Click the Security tab.

  

 

5.      Create the desired communities (for example “public=” community with “READ ONLY” rights)

6.      (Optional) Restrict which hosts may issue SNMP requests.

7.      Click OK.

Task 3:  Test SNMP

1.      Start the Symphony services: From the Server menu, select Services, and then Start Symphony Services.
At this time, SNMP data is provided by the AI InfoService and AI Watchdog services.

        The AI Watchdog service is responsible for providing the service status SNMP values, and AI InfoService all other values.

        The AI SNMP Registry serves as a registration of all the sub-agents (and is used by our SNMP Extension Agent).

        The Symphony management values are rooted at object-identifier 1.3.6.1.4.1.34101.1.

2.      Use an SNMP software package to query the SNMP Agent. For example, you can use a GUI tool such as the iReasoning MIB Browser: http://ireasoning.com/mibbrowser.shtml.

3.      Start the MIB Browser and open the Server mib files. The mib files are typically located in the program files: C:\Program Files\Aimetis\Symphony\mib files.

        If you are using the iReasoning MIB Browser, for example, you must load the Server mib files into the browser: File>Load MIBs. In the file manager that opens, navigate to and select the mib files (Vendor.mib, Server.mib).

        Additionally, for SNMP using UDP, set SNMP Retries to 2.
(Tools>Options>General tab, SNMP Retries=2 field.)

4.      Enter 127.0.0.1 as the address and edit advanced options to point the program to your read community (for example “public=” community with “READ ONLY” rights).

  

 

5.      Walk all the management values currently available within the Symphony sub-tree.

6.      For individual object-identifier descriptions see:

 

Category

Details

Description

Trap Yes/No

serverInfo

serverId

 

 

 

serverName

Server Computer Name

 

versionInfo

serverVersion

Assembly version of the Symphony server

 

 

webserviceVersion

Version for Symphony web-service protocol

 

 

cameraMessageVersion

Version for Symphony camera message protocol

 

 

streamingVersion

Version for Symphony streaming protocol

 

clientBandwidth

connectedClientNumber

Number of connected clients to this Symphony server

 

 

connectedClientIndex

Unique value for each connected client

 

 

connectedClientIpAddress

IP address the client is connected from

 

 

connectedClientUsername

Username that the client is connected with

 

 

connectedClientDuration

Duration that the client has been connect to this server

 

 

connectedClientDataReceived

Data received, in Kbytes, by the client via this connection

 

 

connectedClientCurrentBandwidth

Current bandwidth, in Kbytes per second, between client and this server

 

cameraInfo

cameraNumber

Number of cameras managed by this server

 

 

cameraId

Unique identifier for the camera

 

 

cameraName

Name of camera

 

 

footagePath

Path to camera’s footage

 

 

footageSize

Size of camera’s footage in bytes

 

storageInfo

storagePoolNumber

Number of storage pools managed by this server

 

 

storagePath

Path to the storage pool

 

 

storageCapacity

Capacity of storage pools in Mbytes

 

 

storagePercentAvailable

Available capacity in the storage pool, as a percentage of storageCapacity

 

 

storageFootageSize

Size of footage within the storage pool in Mbytes

 

 

storageFootageFiles

Number of footage files in the storage pool.

 

serviceInfo

infoServiceStatus

Status of AI InfoService service

 

 

netSendHistStatus

Status of AI NetSendHist service

 

 

schedulerStatus

Status of AI Scheduler service

 

 

trackerNumber

Number of tracker services

 

 

trackerId

The ID of the tracker

 

 

trackerStatus

Status of the AI Tracker service for the trackerID

 

loginMonitor

authorizedLoginNotif

Notification sent when a login is successful

Yes

 

unauthorizedLoginNotif

Notification sent when an unauthorized login is attempted

Yes

 

loginNotifyIpAddress

IP address that the client is connected from

 

 

loginNotifyUsername

Username that the client is attempting to login with

 

 

loginNotificationMessage

Message with additional details about the login attempt

 

alarmMonitor

alarmNotif

Notification sent when an alarm occurs or is marked

Yes

 

alarmNotifyCameraId

Camera ID of the camera that recorded the alarm

 

 

alarmNotifyCameraName

Camera name of the camera that recorded the alarm

 

 

alarmNotifyUserId

User ID of the user that marked the alarm

 

 

alarmNotifyUserName

User name of the user that marked the alarm

 

 

alarmNotifyMarkedDelay

Time alarm was marked

 

 

alarmNotifyFalseAlarm

Is this a false alarm

 

 

alarmNotifyRuleId

Rule ID of the rule causing the alarm

 

 

alarmNotifyRuleName

Rule name of the rule causing the alarm

 

 

alarmNotifyDBId

ID of the alarm

 

 

alarmNotifyComment

Comments associated with the alarm

 

 

alarmNotifyMSSinceChange

Number of milliseconds between when the alarm occurred and when it was detected

 

deviceMovementMonitor

devicesMovedNotif​

Notification sent when a device is moved from one server to another (manual device move or failover swap)

Yes

 

sourceServerId​

ID of the server that devices moved from​

 

 

destinationServerId​

ID of the server that devices moved to​

 

 

numberDevicesMoved​

Number of devices moved from source to destination server​

 

healthMonitor

healthMonitorFaultNotification​

Notification sent when the health monitor detects a fault​

Yes

 

healthMonitorActionNotification​

Notification sent when the health monitor takes an action in response to a fault​

Yes

 

healthMonitorName​

Name of the associated health monitor​

 

 

​healthMonitorAction

Name of the action taken​

 

 

Symphony traps for unauthorized logins and all alarms when they occur or when the user marks them.

 

Additional Tools and Information

If you prefer a command line tool instead of a GUI MIB Browser, you can use a free command line tool (Net-SNMP) to walk the mib files. (The snmpwalk command will perform a sequence of chained GETNEXT requests automatically.)

       For instructions, see Net-SNMP: http://net-snmp.sourceforge.net/

The following sites also provide information on SNMP:

       How SNMP Works: http://technet.microsoft.com/en-us/library/cc783142.aspx

       How to effectively use a MIB Browser: http://www.unleashnetworks.com/resources/articles/88-how-to-effectively-use-a-mib-browser.html