How to use Sapwalk2

Document ID : KB000013592
Last Modified Date : 23/07/2018
Show Technical Document Details
Introduction:

Sometimes, when there are problems identified with a particular device's metrics as seen in CA Spectrum, CA eHealth or CA PM, it is necessary for CA support to simulate this device so as to try to replicate the problem. Sapwalk2 is a utility that takes a snapshot of the device by running an SNMP GETNEXT query on it. This will enable CA Support to load the simulation in a lab environment, then discover and model it in Spectrum (or eHealth or CA PM) and view the values that are contained on the device while simulating its response.

Question:

How do we get and use Sapwalk2?

Environment:
CA Spectrum 10.2.x & 10.x
CA eHealth 6.3.x
CA Performance Management (PM) 2.x & 3.x
Answer:

We have a Windows, Solaris, and Linux version of the Sapwalk2 utility.  It ships with Spectrum 10.2 (located in the $SPECROOT/bin directory).
If you are on a version prior to 10.2, please contact CA support. The usage can be found by just running sapwalk2.  However a recommended usage is as follows:

sapwalk2.exe -i <ip address> -v <snmp version> -s <starting oid> -p <port> -c <community name> -t <timeout> -r <retries> -d <throttle_delay> -o <output file>

For example:

sapwalk2.exe -i XXX.XXX.XXX.XXX -v v1 -s 1.3.6 -c public -t 3000 -r 3 -d 50 -o device_mib.walk

Another example, using SNMP v3;

sapwalk2 -i XXX.XXX.XXX.XXX -v v3 -s 1.3.6 -u AuthPrivUser -l AP -xt MD5 -xa authpassword -xp privpassword –xe DES -t 3000 -o device_mib.walk

where

  • -i is the IP address
  • -u is user name                   = <Your_SNMP_v3_user>
  • -l is Authentication Type         = nAnP/AnP/AP (no Authentication No Privacy/ Authentication No Privacy/ Authentication with Privacy)
  • -xt is encryption Type            = MD5/SHA
  • -xa is authentication password    = <Your_SNMP_v3_authen_password>
  • -xp is privacy password           = <Your_SNMP_v3_privacy_Password>
  • -xe is privacy protocol           = DES/3DES/AES128/AES192/AES256
Additional Information:

Note: You need the later versions (2.1x) to enable the -xe (privacy protocol) flag. Spectrum 10.2 ships with this version. It is also located under ftp.ca.com/pub/CA-SPECTRUM/Tools/sapwalk2 and listed as;

  • sapwalk2_aes_32bit_linux.gz
  • sapwalk2_aes_64bit_linux.gz
  • sapwalk2_aes_solaris.gz