Sapwalk2 instructions for UIM

Document ID : KB000125575
Last Modified Date : 31/01/2019
Show Technical Document Details
Introduction:
At times when troubleshooting an issue with the discovery or monitoring of an SNMP device you may be requested to provide an SAPWALK2 output.
This is also required when you are submitting a new device for vendor certification.

This document will discuss where to obtain the tool and how to run it.
Background:
sapwalk2 performs mibwalks from a specified starting oid and produces output in the format
that can be directly utilized by our Simulator SimpleAgentPro.  It can capture in SNMP v1,
v2c and v3.
Environment:
UIM any version
Instructions:
The Sapwalk2 tool is available for windows, Linux (32 and 64bit) and Solaris and can be downloaded from the "MIB Walk Utilities" section of https://devicesupport.ca.com/

The usage for the command is as follows:
#sapwalk2: ver 2.14
#Copyright (c) 1994-2013 SIMPLESOFT Inc.
Usage: sapwalk2
         -i  ip_address
         -v  snmp_version(v1/v2c/v3)
         -s  startoid
         <-c  community for v1/v2c           >
         <-u  username  for v3               >
         <-l  seclevel  (nAnP/AnP/AP) for v3 >
         [-xt auth type (MD5/SHA) for v3     ]
         [-xa auth password for v3           ]
         [-xp priv password for v3           ]
         [-xn ctxtname  for v3               ]
         [-xe priv type (DES/3DES/AES128/AES192/AES256)for v3  ]
         [-xi ctxtid    for v3 (will discover if not specified)]
         [-e  engineid  for v3 (will discover if not specified)]
         [-t  timeout(msec)                  ]
         [-r  retries                        ]
         [-f  compare (0/1)                  ]
         [-p  snmpport                       ]
         [-d  sleep_bet_req(msec)            ]
         [-m  maxlexerrors                   ]
         [-z  samples:delay_in_msec:<oidfile> for ratecomputation of counter/gauge variables]
         [-o  walkoutput filename            ]
         [-n  max num of variables to learn  ]
         [-xf filename containing oids to be excluded(one per line) ]
         [-xr guestimate max rows            ]
         [-xs source ip                      ]
         [-xy source endpoint (port)         ]
         [-xv bridge / or vlanstartoid for auto vlan learn]
         [-xl save timestamps (0/1)          ]
         [-xz timestamp threshold (def=10sec)]
         [-b  getbulk flag (0/1)             ]
The value for the -s (startoid) is always 1.3.6.1
An Example comand is:
sapwalk2.exe -i 10.253.190.15 -v v1 -s 1.3.6.1 -c public -xv 1.3.6.1.2.1.17 -o 10.253.190.15.walk

You would then provide the 10.253.190.15.walk file to UIM Support