Viz Engine

Version 3.11 | Published August 27, 2018 ©

SNMP support

Introduction

SNMP (Simple Network Management Protocol) is a standard, usually UDP based protocol used for collecting information about managed services over IP networks. The device can send notifications (traps) on important state changes.

All values are adressed using a dotted notation string which is represented by a tree structure. Vizrt's registered subtree is 1.3.6.1.4.1.27566. followed by an unique identifier for differend products like Viz Engine (1) or Viz Graphic Hub (2). The subtree for instance one of a Viz Engine would be 1.3.6.1.4.1.27566.1.1. It then splits up into a data part (1) and SNMP compliance mandatory structures (2).

The SNMP Extension is a DLL, an extension for the built-in Windows SNMP service. The agent (one per DLL) provides data to the service which can be retrieved by the SNMP protocol. The agent can also trigger sending SNMP traps (notifications).The service runs as LocalSystem user. The current SNMP version supported is 2c. Version 2c is the most common standard. Version 1 is obsolete, version 3 is not yet, if ever, supported by Microsoft.

Installation

Prerequisites

Before installing the SNMP Extension, the Windows SNMP service has to be installed and configured. This is usually a part of the workstation or server operating system. It has been tested using Windows 7 and Windows 10.

To install the services

  • Open the Control Panel.

  • Select Programs and Features , then "Turn Windows Features On or OFF" list in Control Panel> Programs and Features.

  • Select the "Simple Network Managment Protocol" (SNMP), the subfeature "WMI SNMP Provider" is not being used.

You'll find it afterwards in "Computer management"/"Services"

On Tab "Security"

  • Click "add" to "Accepted community names".

  • Enter "public" to the "Community name".

  • Set the Community right to "READ ONLY".

On tab "Traps" enter

  • Community name "public".

  • possible trap destinations "127.0.0.1".

images/download/attachments/41789400/image2017-12-11_15-42-32.png

If you want to have active trap notifications, you have to enter the IP destination of your host monitoring system into the trap destinations as the SNMP service will forward the notifications to the monitoring host.

Without the configuration above, the SNMP service appears to be running but does not send anything and the queries will time out.

Installation

Currently there are two DLLs, one for Viz Engine (VizEngineSnmpExt.dll) and one for Viz Graphic Hub (VizGraphicHubSnmpExt.dll). These files can be copied anywhere to your hard drive, but they need to be registered to the SNMP service.

Once the SNMP service recognizes the agents, the DLLs have to be registered in the registry in:

The following registry entries need to be set:

Path

Setting

[HKLM\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents]
 "9"="SOFTWARE\\vizrt\\VizEngineSnmpExt\\CurrentVersion"
[HKLM \SOFTWARE\vizrt\VizEngineSnmpExt\CurrentVersion]
"Pathname"="c:\Program Files\vizrt\SnmpExtAgents\VizEngineSnmpExt.dll"


If there are already other services registered, simply increase the index of the new one and add the following to its data value. See above example = "9"

Please remember to restart the SNMP service after applying the settings in the registry.

Configuration

The extension agents were designed to have as few configuration options as possible. The parameters are located in registry and are read when the agent is initialized. The registry location for Viz Engine is HKLM\SOFTWARE\vizrt\VizEngineSnmpExt\. All parameters are optional. By fulfilling some setup conditions it is possible to install the agents without needing to use the parameters at all.

Registry Key

Default Value

Info

DebugLog

0

Enables debug log level. The log is located at C:\ProgramData\Vizrt\SNMPExtAgents. It should be disabled in production environment.

SampleTime

5000

Sample time in miliseconds for fetching the latest data, from Graphic Hub over REST, for example

TrapRepeat

36

The agents repeat traps for values in „failed“ condition. The repeat time is SampleTime * TrapRepeat. Set to 0 to turn off trap repeating.

TrapHandling

1

Set to 0 to disable sending traps entirely. It is suggested to rather ignore the traps in the monitoring system than disabling them entirely.

Viz Engine specifc settings:

Registry Key

Default Value

Info

ChannelCount

(automatic)

By default, the agent determines the maximum viz engine channel count by examining registry at HKLM\SOFTWARE\vizrt\Viz3\PlatformType.

You can override this by using 1-4 here.