How to use SAPWALK2 for SNMPv3 configured devices
search cancel

How to use SAPWALK2 for SNMPv3 configured devices

book

Article ID: 140102

calendar_today

Updated On:

Products

CA Performance Management - Usage and Administration DX NetOps

Issue/Introduction

What is the syntax for the SAPWALK2 command when run against devices configured for SNMPv3?

Environment

All supported DX NetOps Performance Management releases

Cause

Performance Management Certification Requests require MIB dumps of target devices using the SAPWALK2 tool. 

Resolution

To create the requested MIB dump, please complete the following:

  1. Open a command prompt on the Data Collector (DC) host managing the target device.
  2. The sapwalk2 command should be found in the (default path) /opt/IMDataCollector/scripts. Go to and run it from that directory for best results.
  3. Execute the command as follows dependent on the security_level configured.  For example using the IP 198.51.100.1 and the password 12345678.walk
  • If using No Authorization and No Privacy (-l nAnP) run it as follows:
    • sapwalk2.exe -i <IP Address> -v v3 -s 1.3.6.1 -u <username> -l nAnP -o 12345678.walk
  • If using Authorization and No Privacy (-l AnP) run it as follows:
    • sapwalk2.exe -i <IP Address> -v v3 -s 1.3.6.1 -u <username> -l AnP -xt <auth_type> -xa <auth_password> -o 12345678.walk
  • If using Authorization and Privacy (-l AP) run it as follows:
    • sapwalk2.exe -i <IP Address> -v v3 -s 1.3.6.1 -u <username> -l AP -xt <auth_type> -xa <auth_password> -xe <priv_type> -xp <priv_password> -o 12345678.walk

Where:

  • <ip_address> is the IP address of the device at issue
  • <username> is the username configured for SNMPv3 access on the device
  • <auth_type> is the authorization protocol type in use for SNMPv3 access on the device. 
  • <auth_password> is the authorization password in use for SNMPv3 access on the device
  • <priv_password> is the privacy password in use for SNMPv3 access on the device
  • 12345678.walk is the file name. Replace with Support Case number or device name/IP.

In order to see more options, simply execute the command with no options or arguments.  Any valid community string with Read permissions can be used.

Once the command has completed, please forward the resulting <ticket_#>.walk file for use in simulating the device.

Sample usage output for the SAPWALK2 command showing possible values:

[root@hostName]# ./sapwalk2
#sapwalk2: ver 2.12
#Copyright (c) 1994-2010 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)             ]

Additional Information

The SAPWALK2 tool is available for download via the Requirements for Performance Management Certification Request Knowledge Base article.

 

These are the expected entries at the end of the sapwalk2 output. Do not interrupt while it is running.

the e