To troubleshoot devices or to create DDFs, an output of a device's addresses and the values within them is necessary. This page describes how to generate that output for SNMP, Modbus, and NetBotz devices.
For SNMP with DCE versions prior to 7.6 or Modbus on any version
- Download the walk utility from here.
- Unzip the file.
- Open a command prompt and navigate to the folder you just unzipped.
- Open and read the README.txt file for detailed instructions on how to use the command line utility.
SNMP for DCE version 7.6 and later
- Open the web client by entering the IP address of the DCE server into your web browser.
- Enter your username and password.
- Click the "Status" link near the top right of the page.
- In the dropdown list, select "SNMP Device Walk" and click "Submit"
- In the "Target Host" field enter the IP address of the device you wish to walk.
- Select SNMPv1 or v3 and enter the credentials. Hint: If using SNMPv1, the default "Read Community" on most devices is "public".
- Click "Submit"
- The results will be printed on the page. Copy and paste the text to a text file and save.
Windows 64-bit only
- Unzip the file to the folder of your choice.
- Open a command prompt and navigate to the folder.
- Run the walk.bat command.
walk.bat <protocol> -ip <ip> <options>
Generates a walk file named using the IP address and a .walk, .json, or .xml extension.
- port: 161
- readCommunity: public
walk.bat snmp -ip 18.104.22.168
walk.bat snmp -ip 22.214.171.124 -port 8161
walk.bat snmp -ip 126.96.36.199 -read pass
- port: 161
- securityLevel: 3
- retries 2
- timeout 5
- AuthType: MD5, SHA
- EncType: DES, DES3, AES128, AES192, AES256
walk.bat snmpV3 -ip 188.8.131.52 -port 8161 -username XXXX -authType MD5 -authPasswd XXXX -encType DES -encPassword XXXX
walk.bat snmpV3 -ip 184.108.40.206 -port 8161 -username XXXX -authType SHA -authPasswd XXXX -encType AES128 -encPassword XXXX -securityLevel 3
Requires a separate text file specifying which registers to read. See input.txt for formatting and examples.
Modbus addresses are 0 based. If your documentation lists Modbus addresses that are not indexed from 0, you must adjust the addresses manually for the input.txt file.
WARNING: Excessive Modbus requests can overwhelm the device. Keep the number of selected registers as small as possible.
- port: 502
- slave address: 1
- input file: input.txt
walk.bat modbus -ip 220.127.116.11
walk.bat modbus -ip 18.104.22.168 -port 5020 -slave 2 -input registers.txt
Modbus Register text file
Contains a list of the registers to read as part of the walk. Each line is a different range of registers.
COIL or 1
DISCRETE_INPUT or 2
INPUT_REGISTER or 3
HOLDING_REGISTER or 4
Single or range of values: "1" for register 1 or "1-10" for every register from 1 to 10.
COIL:1-10 Read coil starting at 1 reading through 10.
DISCRETE_INPUT:1-10 Read Discrete Input register starting at 1 reading through 10.
INPUT_REGISTER:1-10 Read Input register starting at 1 reading through 10.
HOLDING_REGISTER:1-10 Read Holding register starting at 1 reading through 10.
1:1-10 Read Coil starting at 1 reading through 10.
2:1-10 Read Discrete Input register starting at 1 reading through 10.
3:1-10 Read Holding register starting at 1 reading through 10.
4:1-10 Read Input register starting at 1 reading through 10.
NOTE: Single registers can be specified, for example, HOLDING_REGISTER:1 to Read Holding register 1.
Modbus Register Text File examples:
walk.bat netbotz -ip 192.168.0.10 -username user1 -password pass
walk.bat netbotz -ip 192.168.0.10 -username user1 -password pass -useSSL