search cancel

How to run a probe manually to debug it from the command line (non-java)

book

Article ID: 198863

calendar_today

Updated On:

Products

DX Unified Infrastructure Management (Nimsoft / UIM) CA Unified Infrastructure Management On-Premise (Nimsoft / UIM) Unified Infrastructure Management for Mainframe CA Unified Infrastructure Management SaaS (Nimsoft / UIM)

Issue/Introduction

When a probe does not start or yields unexpected results, it is sometimes useful to run the probe manually so you can examine verbose debug output.

This KB Article shows how to debug a probe using Windows command line or Linux/UNIX shell.

Environment

  • UIM probes any version

Cause

  • troubleshooting and debug for all DX UIM / Nimsoft probes (non-Java)

Resolution

To run a probe manually, please do the following:

1. Deactivate the probe

2. cd to the probe directory, e.g.,

    ...\Program Files (x86)\Nimsoft\probes\application\<probe_name>

3. Run the command using debug mode loglevel 4

    <probe_name> -d 4 -l stdout

    Let it run for a minute.

    For example:

    ...\Program Files (x86)\Nimsoft\probes\application\ad_server

    Run the command using debug mode loglevel 4

   ad_server -d 4 -l stdout

     or

   ad_server -d 4 -l stdout >> ad_debug_logfile

4. Ctrl->C a few times to stop the probe process.

5. Examine the output and/or attach the probe debug output/file showing any/all errors into a support case/

Additional Information

Here are some examples for Windows and Linux/UNIX.

1. Deactivate the probe.

2. Run the probe manually on the command line, copy/collect the output and attach it to the case.

Windows
-------------
example:
C:\Program Files (x86)\Nimsoft\robot>controller -d 6 -l stdout

C:\Program Files (x86)\Nimsoft\robot>controller -d 6 -l stdout
Nov  8 15:37:09:395 [24832] 0 Controller: WARNING: changing workdir to C:\Program Files (x86)\Nimsoft\robot, debug=6
Nov  8 15:37:09:400 [24832] 3 Controller: Controller - set controller id
Nov  8 15:37:09:405 [24832] 1 Controller: UTF-8 charset mode is not enabled
Nov  8 15:37:09:409 [24832] 2 Controller: nimCharsetSet() - charset=
Nov  8 15:37:09:424 [24832] 3 Controller: Controller - set trap handling routines
Nov  8 15:37:09:430 [24832] 3 Controller: Controller - parse robot.cfg
Nov  8 15:37:09:433 [24832] 4 Controller: cfgReader file open: C:\Program Files (x86)\Nimsoft\robot\robot.cfg
Nov  8 15:37:09:441 [24832] 4 Controller: cfgReader file close: C:\Program Files (x86)\Nimsoft\robot\robot.cfg
Nov  8 15:37:09:446 [24832] 2 Controller: MyPutEnv NIM_STRICT_BINDING=0
Nov  8 15:37:09:450 [24832] 2 Controller:    NIM_STRICT_BINDING=0
Nov  8 15:37:09:989 [24832] 5 Controller: get Windows OS information - Using newer method of finding OS version info
Nov  8 15:37:09:996 [24832] 4 Controller: cfgReader file open: C:\Program Files (x86)\Nimsoft\robot\robot.cfg
Nov  8 15:37:10:001 [24832] 4 Controller: cfgReader file close: C:\Program Files (x86)\Nimsoft\robot\robot.cfg
Nov  8 15:37:10:007 [24832] 3 Controller: Controller - set logging options
Nov  8 15:37:10:011 [24832] 3 Controller: Controller - logging options set
Nov  8 15:37:10:015 [24832] 5 Controller: Controller - restore state from robot_env sds file (origin)
Nov  8 15:37:10:020 [24832] 6 Controller: MUTEX_LOCK robot_env sds(robot_env read)
Nov  8 15:37:10:024 [24832] 6 Controller: robot_env read - could not read 'probelist_tbl' from pds, skipping
Nov  8 15:37:10:030 [24832] 6 Controller: MUTEX_UNLOCK robot_env sds(robot_env read)
Nov  8 15:37:10:034 [24832] 6 Controller: robot_env read - success
Nov  8 15:37:10:040 [24832] 6 Controller: robot_env log - logging current values
Nov  8 15:37:10:044 [24832] 6 Controller: robot_env log - origin_mode = '1'
Nov  8 15:37:10:048 [24832] 6 Controller: robot_env log - origin = 'lvntest000523_hub'
Nov  8 15:37:10:053 [24832] 6 Controller: robot_env log - origin_pending = ''
Nov  8 15:37:10:057 [24832] 6 Controller: robot_env log - probelist is currently empty, skipping
Nov  8 15:37:10:062 [24832] 0 Controller: Selecting robotip from configuration. config_robotip = 10.46.13.158, cglob robotip = 10.46.13.158, local_ip_validation = 1, validate_ip_suggestion = 0, strict_ip_binding = 0
Nov  8 15:37:10:073 [24832] 4 Controller: nimGetIpList called with buffer size 40960
Nov  8 15:37:10:077 [24832] 4 Controller: nimGetIpList - found |10.46.13.158|
Nov  8 15:37:10:082 [24832] 2 Controller: check_configured_ip - local ip list = |10.46.13.158|
Nov  8 15:37:10:086 [24832] 3 Controller: IsIPInList ip=10.46.13.158, list=|10.46.13.158|, found=1
Nov  8 15:37:10:090 [24832] 1 Controller: Explicit controller to hub login enabled
Nov  8 15:37:10:094 [24832] 2 Controller: MyPutEnv NIM_JRE_HOME=jre/jre8u312b07
Nov  8 15:37:10:099 [24832] 2 Controller:    NIM_JRE_HOME=jre/jre8u312b07
Nov  8 15:37:10:102 [24832] 2 Controller: MyPutEnv NIM_JRE_HOME_1_8=jre/jre8u312b07
Nov  8 15:37:10:105 [24832] 2 Controller:    NIM_JRE_HOME_1_8=jre/jre8u312b07
Nov  8 15:37:10:109 [24832] 1 Controller: (parserobotcfg) calling LoadControllerPlugins refresh. Default path is (null)\plugins
Nov  8 15:37:10:116 [24832] 4 Controller: (load_plugins_from_cfg) Plugin loading started...
Nov  8 15:37:10:120 [24832] 4 Controller: (load_plugins_from_cfg) Did not find section (/controller/plugins). No plugins loaded.
Nov  8 15:37:10:126 [24832] 3 Controller: validating character encoding of config file: C:\Program Files (x86)\Nimsoft\robot\robot.cfg
Nov  8 15:37:10:132 [24832] 4 Controller: nimCharsetValidateFile: C:\Program Files (x86)\Nimsoft\robot\robot.cfg: no target charset
Nov  8 15:37:10:138 [24832] 3 Controller: validating character encoding of config file: C:\Program Files (x86)\Nimsoft/robot/spooler.cfg
Nov  8 15:37:10:144 [24832] 4 Controller: nimCharsetValidateFile: C:\Program Files (x86)\Nimsoft/robot/spooler.cfg: no target charset
...
...

Linux/UNIX
-----------------
example:
./opt/nimsoft/robot/controller -d 6 -l stdout

or from within the directory run:

./controller -d 6 -l stdout

example output:

Nov  8 20:43:25:775 [140524139231040] 0 Controller: --------------------------------------------------------------------------------------------------------
Nov  8 20:43:25:775 [140524139231040] 0 Controller: ----- Robot controller 9.34 [Build 9.34.2004, Dec  7 2021] started -----
Nov  8 20:43:25:775 [140524139231040] 0 Controller:  Name   = sdans-centosrobot, IP = 10.253.129.247, Port = 48000
Nov  8 20:43:25:775 [140524139231040] 0 Controller:  OS     = UNIX / Linux / Linux 3.10.0-1160.76.1.el7.x86_64 #1 SMP Wed Aug 10 16:21:17 UTC 2022 x86_64
Nov  8 20:43:25:775 [140524139231040] 0 Controller:  Domain = none
Nov  8 20:43:25:775 [140524139231040] 0 Controller:  Loglevel = 6, Logfile = stdout
Nov  8 20:43:25:775 [140524139231040] 1 Controller:  System Uptime QoS = no
Nov  8 20:43:25:775 [140524139231040] 3 Controller:  Cluster_support = 0
Nov  8 20:43:25:775 [140524139231040] 1 Controller:  major=LINUX minor=LINUX_217_64
Nov  8 20:43:25:775 [140524139231040] 0 Controller: ciGetCachePath - NIM_ROOT not set!
Nov  8 20:43:25:775 [140524139231040] 0 Controller: ciInitLocalDeviceId - could not find NIS cache path: not found
Nov  8 20:43:25:775 [140524139231040] 0 Controller: nisInitialize - failed: not found
Nov  8 20:43:25:775 [140524139231040] 1 Controller: File validation information cache not loaded
Nov  8 20:43:25:775 [140524139231040] 4 Controller: cfgReader file open: /root/robot.cfg
Nov  8 20:43:25:775 [140524139231040] 5 Controller: writing reuse_async_session [1] in robot.cfg
Nov  8 20:43:25:775 [140524139231040] 4 Controller: cfgWriter file open: /root/robot.cfg
Nov  8 20:43:25:775 [140524139231040] 4 Controller: cfgWriter file close: /root/robot.cfg
Nov  8 20:43:25:776 [140524139231040] 0 Controller:  Running as user root (0)
Nov  8 20:43:25:776 [140524139231040] 0 Controller: -----
Nov  8 20:43:25:776 [140524139231040] 3 Controller: Controller - fetch expire information
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/fetch_expire - find full path to expire.cfg
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/fetch_expire - allocate space for /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/fetch_expire - check access to /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/fetch_expire - create initial
Nov  8 20:43:25:776 [140524139231040] 4 Controller: cfgReader file open: /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 4 Controller: cfgWriter file open: /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 4 Controller: cfgWriter file close: /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/gen_key /root/expire.cfg
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/gen_key gjq9UbOLaMzVfVsPv8nIWQ==
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/gen_key sdans-centosrobot
Nov  8 20:43:25:776 [140524139231040] 2 Controller: expire/gen_key sxuYdk61V+uhtUuZp3wrr/6IjKlGNaQUjMn463DKkYQoMbqwh9isQAk6reCWyM6S
...
...