Remove robot from hub list using UIMAPI removerobot callback - DX UIM

Products

• DX Unified Infrastructure Management (Nimsoft / UIM)

Issue/Introduction

A robot has been uninstalled but still appears in the list of robots reporting to a hub.

A UIMAPI call is needed to remove the robot from the hub list.

Environment

• DX UIM - Any Version
• UIMAPI - Any Version

Resolution

To remove a robot from the hub's list of active robots, the "removerobot" callback is used.  There is a UIMAPI function that can be made to use the "probes/callback" API.

Note: this does not uninstall the robot. It only removes it from the hub list.  If the robot is still active, it will eventually return to the hub list unless it is uninstalled.

Example Usage

1. 1. In this example, we want to remove the entry for "a-robot-1" which is a robot reporting to SecondaryHub-1.  We will need to make note of both the robotname, and the hubrobot name (the robot name where the 'hub' probe is running) as we will provide both of these values to the callback function.
      
      
      
   2. The "callback" API function can be found in UIMAPI under "probes":
      
      
      
   3. This function requires the following parameters:
      • Domain: the UIM Domain
      • hub: the hub name which manages the robot to be removed
      • robot: the name of the hubrobot (the robot where 'hub' is installed) -- not the name of the robot to remove
      • probe: the probe to execute the callback against -- in this case "hub" is the probe which contains the "removerobot" callback.
      • callback: the name of the callback to execute, in this case "removerobot"
        
        
   4. The request body should contain:
      

      {
        "parameters": [
          {
            "name": "name",
            "type": "string",
            "value": "(robotname)"
          }
        ],
        "pds": "string",
        "timeout": 0
      }

      Where "robotname" is the name of the robot to be removed from the list.
      
      
   5. Screenshot example from UIMAPI:
      
      This example will remove the entry for "a-robot-1" from the list of robots on the secondary hub.
      
      
   6. Result after refreshing the IM view:
      

Additional Information

To uninstall the robot, you can use the _uninstall_robot callback (DX UIM 23.4.3 or later.) 

 

For future updates on this process, please subscribe to this article