mirror of https://github.com/node-red/node-red-nodes.git synced 2023-10-10 13:36:58 +02:00

History

Stephen McLaughlin 041342d511 better inplace upgrade of pre v1 (#908 ) fixes #907		2022-05-07 16:40:57 +01:00
..
LICENSE	Update licenses and packages for all nodes	2016-11-06 20:26:19 +00:00
package.json	better inplace upgrade of pre v1 (#908 )	2022-05-07 16:40:57 +01:00
README.md	Update readme & bump to v1.0.0	2022-04-28 20:36:53 +01:00
snmp.html	better inplace upgrade of pre v1 (#908 )	2022-05-07 16:40:57 +01:00
snmp.js	better inplace upgrade of pre v1 (#908 )	2022-05-07 16:40:57 +01:00

README.md

node-red-node-snmp

A set of Node-RED nodes that fetch values from SNMP enabled hosts. Supports v1, v2c and v3.

SNMP get - Simple SNMP oid or oid list fetcher
SNMP set - Simple snmp Set node.
SNMP subtree - Simple sub tree fetcher
SNMP table - Simple SNMP oid table fetcher
SNMP walker - Simple SNMP oid walker fetcher

Install

Run the following command in your Node-RED user directory - typically ~/.node-red

npm install node-red-node-snmp

Usage

snmp

SNMP oids fetcher. Can fetch a single or comma separated list of oids. Triggered by any input.

msg.host may contain the host including the port.

msg.community may contain the community. (v1 and v2c only)

msg.username may contain the username. (v3 only)

msg.authkey may contain the digest security key. (v3 only)

msg.privkey may contain the encryption security key. (v3 only)

msg.oid may contain a comma separated list of oids to search for. (no spaces)

The host configured in the edit config will override msg.host. Leave blank if you want to use msg.host to provide input.

The community configured in the edit config will override msg.community. Leave blank if you want to use msg.community to provide input.

The username configured in the edit config will override msg.username. Leave blank if you want to use msg.username to provide input.

The digest security key configured in the edit config will override msg.authkey. Leave blank if you want to use msg.authkey to provide input.

The encryption security key configured in the edit config will override msg.privkey. Leave blank if you want to use msg.privkey to provide input.

The oids configured in the edit config will override msg.oid. Leave blank if you want to use msg.oid to provide input.

Outputs msg.payload containing a table of objects, and the requested msg.oid. Values depends on the oids being requested.

snmp-set

SNMP sets the value of one or more OIDs.

msg.host may contain the host including the port.

msg.community may contain the community. (v1 and v2c only)

msg.username may contain the username. (v3 only)

msg.authkey may contain the digest security key. (v3 only)

msg.privkey may contain the encryption security key. (v3 only)

msg.varbinds may contain an array of varbind JSON objects e.g.:

    msg.varbinds = [
        {
            "oid": "1.3.6.1.2.1.1.5.0",
            "type": "OctetString",
            "value": "host1"
        }, {
            "oid": "1.3.6.1.2.1.1.6.0",
            "type": "OctetString",
            "value": "somewhere"
        }
    ];

Types can be:

Boolean
Integer
OctetString
Null
OID
IpAddress
Counter
Gauge
TimeTicks
Opaque
Integer32
Counter32
Gauge32
Unsigned32
Counter64
NoSuchObject
NoSuchInstance
EndOfMibView

The host configured in the edit config will override msg.host. Leave blank if you want to use msg.host to provide input.

The community configured in the edit config will override msg.community. Leave blank if you want to use msg.community to provide input.

The username configured in the edit config will override msg.username. Leave blank if you want to use msg.username to provide input.

The digest security key configured in the edit config will override msg.authkey. Leave blank if you want to use msg.authkey to provide input.

The encryption security key configured in the edit config will override msg.privkey. Leave blank if you want to use msg.privkey to provide input.

The varbinds configured in the edit config will override msg.varbinds. Leave blank if you want to use msg.varbinds to provide input.

snmp-table

Simple SNMP table oid fetcher. Triggered by any input.