How to effectively decommission UIM Robots

book

Article ID: 136703

calendar_today

Updated On:

Products

DX Infrastructure Management NIMSOFT PROBES

Issue/Introduction

UIM Administrators need to know how to effectively decommission UIM robots in bulk and ensure that alarms, e.g., Robot Inactive alarms for those same robots do not persist. In some cases when the customer uses the pu command to remove a robot, within 2-3 days the Robot Inactive alarm returns and the robot can be seen under the hub in the Navigation window in IM as well as under the hub->Robots Tab.

Cause

- leftover references to the robot

- niscache entries

- robot stays cached in its hub's robot.sds file

Environment

Release : 9.1.0 or higher

Component : UIM - ROBOT

Resolution

Aside from this recommended process outlined in the KB Article below:

How to delete robots in UIM when a VM with a robot has been powered off/decommissioned

https://knowledge.broadcom.com/external/article/117796/

And considering the fact that you could already be currently running a probe utility command to remove master devices by the cs keys,

You should also remove the robot from the hub, and you can do this via command(s). Unfortunately you cannot list more than one robot at a time to be removed from a hub but you can duplicate the command for each machine, or script it and read in a file with a list of decommissioned robots and use variable replacement of some kind for the robot hostnames to be decommissioned.

Here is an example command:

C:\Program Files (x86)\Nimsoft\bin>pu.exe -u administrator -p xxxxxxxx /abctest000523_domain/abctest000523_hub/abctest000523/hub removerobot daabc04-xxx

Sep 6 10:43:58:447 pu: SSL - init: mode=0, cipher=DEFAULT, context=OK

Sep 6 10:43:58:448 pu: nimCharsetSet() - charset=

======================================================

Address: /abctest000523_domain/abctest000523_hub/abctest000523/hub Request: removerobot

======================================================

In the hub GUI you can then Refresh the view to confirm the robot disappears. It should also be gone from the IM Navigation window in IM on the left-side.

 

If for some reason the above process doesn't stop the robot inactive alarms from showing up, despite the robot being decommissioned, and the robot has already been removed from the hub, and the callback executed, also make sure the niscache and robot.sds file has been deleted from the robot.

1. For the given hub that the robot(s) reports to, navigate via rdp to that hub and in the hub dir., delete the robot.sds file.

2. Then in the IM, open the hub probe GUI, then choose the Robots Tab and delete those robots via Rt-Click ->Remove.

3. Then acknowledge any related robot inactive alarms in the alarm subconsole in IM.

4. Then restart the hub-robot service via services.msc.

Additional Information

Here is a link to the community that provides and describes the use of a command line tool.

Delete server/device in UIM via command line tool (v3.3)

https://community.broadcom.com/enterprisesoftware/communities/community-home/librarydocuments/viewdocument?DocumentKey=2493b880-a61a-4212-b03d-7b8df0329008&CommunityKey=170eb4e5-a593-4af2-ad1d-f7655e31513b&tab=librarydocuments

 

There are 2 aspects to the UIM inventory.  What you see in Operator Console/UMP and what you see in IM/Admin Console (AC).

Remove the robot.sds and any robot that checks in will be managed again by those hubs.  Those that are 'down' but might come up later, will be managed once again.

Robots that are 'up' will check back in with the hub. Robots that are legitimately down AND being worked on will show back up when they are brought back online.