Restart a robot remotely with probe utility / pu.exe in DX UIM

Products

• DX Unified Infrastructure Management (Nimsoft / UIM)

Issue/Introduction

In some cases, it may be necessary to force a robot to restart when you cannot access the robot from Infrastructure Manager (IM). 

Restarting the robot manually fixes the issue but is not practical if a large number of robots need to be restarted.

How can I restart a robot, or large number of robots, remotely without logging into the systems hosting those robots?

Environment

DX UIM 23.4.*

Cause

Guidance

Resolution

The DX UIM Probe Utility can issue a callback called "_stop" which will ordinarily deactivate any probe; however, this callback, when issued against the controller probe, will force the controller to restart entirely.

It is possible to use the command-line probe utility to issue commands based on IP and Port combinations.

The probe utility is called "pu.exe" on Windows and just "pu" on Linux, and resides in C:\Program Files (x86)\Nimsoft\bin\ on Windows or /opt/nimsoft/bin on Linux.

The command line switch -H can specify a host (IP address) to receive the command, and -P to specify the port.

For example, if the robot at 192.168.0.1 needs to be restarted, and the controller is configured to listen on port 48000 (the default), you could use the following syntax:

pu.exe -u administrator -p (your UIM password) -H 192.168.0.1 -P 48000 _stop


This would force the robot at 192.168.0.1 to restart.

You could also script this as needed to run the command against robots en masse using your favorite scripting language.