Name:	Medialon SNMP
Version:	6.7.2
Available for:	Manager V7 and Manager V6 (Lite & Pro), Showmaster (Mini, ST, Pro, LE, XS & iPro)
Limitation In:
Device Brand:	Medialon
Positrack Compatible:	No
Resources type:	TCP/IP Network

Overview

Medialon SNMP Simple Network Management Protocol (SNMP) is an “Internet-standard protocol for managing devices on IP networks.” Devices that typically support SNMP include routers, switches, servers, workstations, printers, modem racks, and more." It is used mostly in network management systems to monitor network-attached devices for conditions that warrant administrative attention. SNMP consists of a set of standards for network management, including an application layer protocol, a database schema, and a set of data objects. It exposes management data in the form of variables on the managed systems, which describe the system configuration. These variables can then be queried (and sometimes set).

The Medialon SNMP MxM is based on the Net-SNMP library which implements SNMP v1, SNMP v2c and SNMP v3.

MIB files can be found on internet but some manufacturers do not publish them. In this case, you will need to contact them directly.

SNMP itself does not define which information (which variables) a managed system should offer. Rather, SNMP uses an extensible design, where the available information is defined by Management Information Bases (MIBs). MIBs describe the structure of the management data of a device subsystem; they use a hierarchical namespace containing object identifiers (OID). Each OID identifies a variable that can be read or set via SNMP.

The Medialon SNMP MXM provides simple SNMP polling and writing capabilities to Medialon Manager. This MXM is able to load a MIB file in order to generate dynamically the device variables to poll (or to set).

Because SNMP supports dynamic OIDs which can be added or removed during the device runtime, a command of this MXM allows to list the OIDs which are a child of the specified parent OID. Note that the dynamic OIDs finish by a number different of 0.

MxM Installation

Run the installer to correctly install all of the dependancies.

Device Setup

Medialon SNMP Setup:

The setup dialog has three main areas:

Host:

• Address: The IP address of the SNMP device you would like to communicate with.
• Community: The community string of the SNMP device. Usually ‘public’ in most instances.
• Polling Time: Time in ms (1000 = 1 second) to wait between polling all of the active objects.
• Scan OIDs: Complete the Monitor variable list with each available OIDs in the Host.

Load MIB:

• MIB: The filepath of the selected MIB.
• Select: This will open an open dialog to select the MIB and parse it. Once parsed, the MIB is no longer needed with the project.

Note: Sometime the loading fails because the MIB file tries to import another or many other MIB files. Please copy these MIB files in the same folder. In order to know the name of these MIB files, you can open the MIB (to load) in a text editor and search the IMPORTS flag.

Monitoring:

The table shows all of the following:

• Variable Name: The name of the variable that appears within Manager associated with that OID
• Type: The type of variable that the MIB defines it to be. For informational purposes only
• OID Value: The OID value used in polling.
• Used Type: The value defining if Manager polls for the OID.

There are also three buttons in the Monitoring area:

• Add: Brings up the Edit dialog box, allowing you to add a custom OID
• Edit: Brings up the Edit dialog box on the currently selected OID, allowing you to edit it’s parameters
• Remove: Removes the currently selected OID from the list

Edit Dialog Box:

• Variable Name: The name that will appear in Manager with this OID
• Assign As: Define as a pollable device. Set as Variable to make the object pollable. Or set it as Unset if the object don’t need to be polled.
• OID Value: The OID.
• Defined type: The read/write type of the OID as defined by the MIB. For informational purposes only.

After the execution of a Polling command, Dynamic variables can take an “error” value when something is wrong with it. List of values detected:

• “Invalid Host/OID”: the host doesn’t answer.
• “Invalid OID”: the OID is invalid or not managed by the host.
• “Invalid Return Datatype”: the type of the returned data is not correct and cannot be read.

Device Commands

Poll All Objects

Manually poll all of the active OIDs.

Poll Object

Manually poll an individual object.

• OID: [String] The OID to poll
  • Note: a wizard allows selecting an OID.
• Value: [String] The variable to store the resultant data

Update Object

Updates a specific OID with the specified value.

• OID: [String] The OID of the object to be updated
  • Note: a wizard allows selecting an OID.
• Value: [String] The new value
• SNMP Object Type: [Enum] Allow to define the object type (String or Integer)

Get OID List

List all the OIDs which are a child of the parent OID.

• Parent OID: [String] The OID of the parent OID
  • Note: a wizard allows selecting an OID.
• OID List: [Enum] OID list of the each OID which are a child of the parent OID. (The variable must be an Enum)

Reset Object State

Reset the state of a specific OID or all OIDs which has(have) been detected as invalid

• OID: [String] The OID of the object to be reseted. IF this value is empty, all OID state will be reseted
  • Note: a wizard allows selecting an OID.

Device Variables

Status

[Enum] Current status of the device connection.

• “Not Connected”: Not connected
• “Ready”: Connected to the Remote Device
• “Busy”: Device is communicating

Error

[Enum] Current error status of the device.

• “No Error”: Device is Ok
• “Connection Error”: A network or transmission error occurred
• “Timeout”: A timeout has occurred

Revisions

V 6.0.5

• Added: In the Setup, when the MIB file selected cannot be loaded, a Message box is displayed to inform the user.
• Fixed: The cues which use the dynamic variables created by this MXM are disabled each time the Setup is modified.

V 6.0.6

• Modified: The brand name has been changed to Medialon.
• Fixed: There is a memory leak.

V 6.0.7

• Fixed: A call to ‘Update object’ command generates a crash and doesn’t update the object.
• Fixed: The community is always ‘Public’ for an ‘Update object’ command.
• Fixed: Status and Error variables are re-created each time the Setup is validated.
• Fixed: There is a memory leak when ‘Poll All Objects’ command is used.
• Fixed: ‘Poll Object’ command generates a crash of Manager.
• Fixed: ‘Update Object’ command cannot update a SNMP Object as an Integer.
• Fixed: Manager crash or freeze can happen when multiple SNMP devices are used in the project.
• Fixed: In some case, Polling Time value changes to 0 when the Setup dialog is validated.
• Fixed: Edit a variable can generate an error message saying ‘The selected name is already used’ even if it’s not true.
• Fixed: If a timeout happens once during a OID polling, this OID will not be polled again and the ‘Invalid Host/OID’ error will be displayed.

V 6.0.8

• Fixed: Memory leak happens when objects are polled and when ‘Update object’ command is called.
• Fixed: MXM Commands may sometimes hang Manager/Showmaster while the command being executed.

V 6.0.9

• Fixed: Polling an object with a datatype of OID, Counter32 or IpAddress does not work.
• Added: The ‘Get OID List’ command allows to retrieve the children OID list which match with the specified parent OID.
• Added: A Wizard is available in ‘Poll Object’, ‘Update Object’ and ‘Get OID List’ commands in order to display an OID Selector.
• Added: In the Setup, the ‘Scan OIDs’ button allows to complete the Monitor variable list with each available OIDs in the Host.
• Added: Multiple selection in the Monitor list of the Setup dialog is usefull to easily remove or edit several variables.
• Fixed: It is not possible to associate a variable to the ‘SNMP Object Type’ parameter from the ‘Update Object’ command.

V 6.0.10

• Fixed: Internal changes.

V 6.1.0

• Added: Compatibility for Overture CS.

V 6.1.1

• Fixed: ‘Poll Object’ and ‘Get OID List’ commands were not blocking although they return both a value.
• Fixed: Automatic OID poll is not working anymore after variable deletion/creation.
• Added: ‘Reset Object State’ command to re-enable automatic polling of object detected as invalid OID

V 6.1.2

• Fixed: Internal changes.

V 6.7.0

• Improved: Support for High DPI displays (require Manager 6.7.0+ or Showmaster Editor 2.7.0+)
• Changed: Compatibility for Manager 6.7.0 and Showmaster Editor 2.7.0