How to create a device walk file for EcoStruxure IT Gateway and Data Center Expert

This tool can walk SNMP, Modbus, Redfish, and NetBotz devices, gathering current values to facilitate DDF development or debugging for Data Center Expert or EcoStruxure IT Gateway.

Specific information about how to create a walk file for different DCE versions is here.

Modbus.org announced it is expunging all occurrences of inappropriate language of the query and response paradigm of Modbus communications. This tool was updated to comply as of version 1.9.1. More...

Requirements

• Windows 10+ or Windows Server 2012+
• Admin access to Command Line or Windows PowerShell

General usage

1. Unzip the file.
2. Open a Command Prompt (Admin) or Windows PowerShell (Admin)
3. Navigate to the folder you just unzipped.
4. Run:
   walk.bat <protocol> -ip <ip> <options>
   

   This will generate a walk file named using the IP Address and a ".walk", ".json", or ".xml" extension.

SNMP V1

Defaults

- port: 161
- read: public
- write: private
- retries: 2
- timeout: 5

Examples

walk.bat snmp -ip 192.169.0.10

walk.bat snmp -ip 192.169.0.10 -port 8161

walk.bat snmp -ip 192.169.0.10 -read pass

SNMP V3

Argument valid values

- authType: MD5, SHA
- encType: DES, DES3, AES128, AES192, AES256

Defaults

- port: 161
- retries: 2
- timeout: 5

Examples

walk.bat snmpV3 -ip 192.169.0.10 -port 161 -username XXXX -authType MD5 -authPassword XXXX -encType DES -encPassword XXXX

walk.bat snmpV3 -ip 192.169.0.10 -port 161 -username XXXX -authType SHA -authPassword XXXX -encType AES128 -encPassword XXXX 

walk.bat snmpV3 -ip 192.169.0.10 -port 161 -username XXXX 

walk.bat snmpV3 -ip 192.169.0.10 -port 161 -username XXXX -authType SHA -authPassword XXXX 

Modbus

This requires a separate text file specifying which registers to read. See "input.txt" for formatting and examples.

WARNING: Excessive Modbus requests can overwhelm the device. Keep the number of selected registers as small as possible.

Defaults

- port: 502
- server: 1
- input: input.txt

Examples

walk.bat modbus -ip 192.169.0.10

walk.bat modbus -ip 192.169.0.10 -port 5020 -server 2 -input registers.txt

Redfish

Redfish server monitoring protocol was recently added to EcoStruxure IT Gateway.

Example

walk.bat redfish -ip 192.168.0.10 -username user1 -password pass

NetBotz

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