Command Line Utilities › SNMP Command Line Utilities › walktree Utility--Retrieve Values of OID Tree

walktree Utility--Retrieve Values of OID Tree

The walktree utility retrieves the value of every instance of every attribute that is defined in the MIB, from the specified OID through the last OID in the tree.

This utility has the following format:

walktree
    [-h hostname | ip_addr]
    [-p port]
    [-c community]
    [-v 1 | 2c | 3]
    [-u secName]
    [-s secLevel]
    [-n contextName]
    [-a authPassword] [-A MD5 | SHA]
    [ -x privPassword] [-X DES | AES | 3DES]
    [-m FIPS_mode]
    [-r retries]
    [-t timeout]
    [-d logLevel]
    [-f logFile]
    [-b]
    [-o OID]

-h hostname | ipaddr

Specifies the host name or IP address of the system on which the agent is running. Accepts IPv4 and IPv6 addresses.

Default: localhost

-p port

Specifies the UDP port that the agent is running on (for example, 1691).

Default: 161

-c community

Specifies a community string that the agent uses. Valid for SNMPv1 and SNMPv2c only.

Note: Specify a read/write community string for snmpset.

Default: public

-v {1 | 2c | 3}

Indicates the version of SNMP that the agent is running. Specify 1 for SNMPv1, 2c for SNMPv2c, or 3 for SNMPv3.

Default: 1

-u secName

Specifies the User-based Security Model (USM) user name used for SNMPv3 security.

Default: none

-n contextName

Specifies the instance name for MIBMuxed agent.

Default: none

-a authPassword

Specifies the authentication password if the agent is configured for SNMPv3 with secLevel 2 (AuthNoPriv) or 3 (AuthPriv).

Note: This option is not required for SNMPv3 communication.

Default: none

-A {MD5 | SHA}

Specifies the authentication protocol to use if the agent is configured for SNMPv3 with secLevel 2 (AuthNoPriv) or 3 (AuthPriv). Currently only MD5 (Message Digest Algorithm) and SHA (Secure Hash Algorithm) are used.

Default: MD5

-x privPassword

Specifies the privacy (encryption) password if the agent is configured for SNMPv3 with secLevel 3 (AuthPriv).

Default: none

-X {DES | AES | 3DES}

Specifies the privacy protocol if the SNMPv3 user is configured with secLevel 3 (AuthPriv). Specify DES for Data Encryption Standard, AES for Advanced Encryption Standard using cryptographic keys of 128 bits (AES128), and 3DES for Triple Data Encryption Standard.

Default: none

-m FIPS_mode

Controls the FIPS mode of operation. Accepted values are 0, 1, and 2.

0

Indicates Non-FIPS mode.

1

Indicates FIPS co-existence mode.

2

Indicates FIPS only mode.

Default: 1

-r retries

Specifies the number of retries.

Default: 10

-t timeout

Specifies the duration before the SNMP receiver considers the request as timed out.

Default: 10 seconds

-d logLevel

Specifies the log level of the SNMP messages. Accepted values are 0 to 5.

0

Logs fatal messages.

1

Logs critical messages.

2

Logs warning messages.

3

Logs informational messages.

4

Logs all of the messages.

5

Logs all of the messages including debugging messages.

Default: 0

-f logfile

Specifies the name of the log file that contains error and debug information.

Default: sysedge_utility.log

-b

Displays the value in hexadecimal format. Applies to snmpget, snmpset, and walktree utilities only.

-o OID

Specifies the object identifier (OID) to be set or queried for the snmpget, snmpset, and walktree utilities.

Default: none

Notes: OID must be the last argument for snmpget. You cannot query multiple OIDs in a single walktree call. If OID includes '.*' towards the end of OID, walktree will walk through all instances. Ensure to include the OID .* within quotation marks to avoid interpretation by Shell. Symbolic names are supported by the Shell.

Examples

walktree -o 1.3.6.1.2.1.1

walktree -o “userName.*”

walktree -h box1.domain.com -p 2009 -c admin -v 1 -o 1.3.6.1.2.1.1.4

walktree -h Ea2f:fe90:abcd:0000:230:a2f:200:ad01 -c admin -v 2c -b -o 1.3.6.1.2.1.1

walktree -p 2009 -u user3v3 -v 3 -s 1 -h 130.10.100.101 -o 1.3.6.1.2.1.1

walktree -p 2009 -u user2v3 -A SHA -a osa -v 3 -s 2 -m 2 -o 1.3.6.1.2.1.1.4

walktree -p 2009 -u user1v3 -A SHA -a osa -X AES -x osp -v 3 -s 3 -t 30 -o 1.3.6.1.2.1.1