SNMP Support in Humly

Humly provides support for Simple Network Management Protocol, SNMP.

Please note! Currently, SNMP support is only available in the on-premise installations

  • SNMP in Humly Architecture
  • SNMP Community String
  • SNMP Port
  • Supported SNMP OIDs
    • Standard OIDs
    • Humly Specific OIDs
SNMP in Humly Architecture

SNMP support was added to Humly Control Panel in version 1.2. It can provide following information:  

1. Count of Humly Room Display devices currently:
  • Online - HRD devices currently online.
  • Offline - HRD devices which are offline and not sleeping.
  • Sleeping - HRD devices which are connected to any room

2. List of devices that are:

  • Online
  • Offline
  • Sleeping
  • Unassigned
Devices which are "Online", "Sleeping" or "Offline" are listed as a JSON string in a key value pair of Room and the IP address of device. Where room name is usually the first part of room email, value is either IP address or array of IP address in case there are more than one device assigned to room.
 
For example: the value will be string representation of json object - {“Room 1”: “172.16.1.34”,
“Room 2”: [“172.16.32.54”, 172.16.32.55”]}
 
"Unassigned" device is formatted differently, they are listed as JSON string in an array of devices
with IP address and their active status.
 
For example: [{“ipAaddress”: “172.16.23.32”, active: “Online”}, {“ipAaddress”: “172.16.23.35”, active: “Online”}]
 
SNMP Community String
 “humly” is the community string for connecting to Humly Control Panel SNMP.
 
SNMP Port
By default the SNMP port is 161. This port has high privilege (under 1024) and the service should have permission to bind to this port. If not, you can change the global settings and use ports above
1024. Enabling/Disabling or changing port for SNMP require a restart of the Humly Control Panel, HCP .
 
Supported SNMP Object Identifiers, OIDs: 

Standard OIDs

These standard OIDs are used in SNMP for system related information.

1.3.6.1.2.1.1.1 – “SysDescr” – simple description of the system.

1.3.6.1.2.1.1.2 – “sysObjectId” – identifier for HCP. The value is “1.3.6.1.4.1.1291915.1.1”.
 
1.3.6.1.2.1.1.3 – “sysUpTime” – This can provide how long Humly Control Panel has been running.

1.3.6.1.2.1.25.1.1 – “hrSystemUptime” – same as above (sysUpTime)

1.3.6.1.2.1.1.5 – “sysName” – gets the host name of the server that Humly Control Panel is running on.

 

Humly Specific OIDs

In this list bellow the specific OIDs for Humly are listed and provide the following information:

OID
Description
1.3.6.1.4.1.1291915.1.1
Count of Online Humly Room Display devices.
1.3.6.1.4.1.1291915.1.2
Count of Offline Humly Room Display devices (not sleeping).
1.3.6.1.4.1.1291915.1.3
Count of Humly Room Display Device devices Offline and Sleeping.
1.3.6.1.4.1.1291915.1.4
Count of Humly Room Display devices not assigned to room.
1.3.6.1.4.1.1291915.1.11
Detail of Online Humly Room Display devices.
1.3.6.1.4.1.1291915.1.12
Detail of Offline Humly Room Display devices.
1.3.6.1.4.1.1291915.1.13
Detail of Humly Room Display devices offline and sleeping.
1.3.6.1.4.1.1291915.1.14
Detail of unassigned Humly Room Display devices.