How to move hubs/robots to a new CA UIM (Nimsoft) domain

Document ID : KB000034311
Last Modified Date : 17/10/2018
Show Technical Document Details
Introduction:
Reasons for moving a robot to a new domain may include:
Standing up a new UIM environment in contrast to an upgrade.
Moving UIM servers to new hardware while leaving the existing environment intact.
This document assumes all pieces of the environment are on the same network and is not appropriate for other scenarios like tunnel connections.
Question:

How to move hubs/robots to a new CA UIM (Nimsoft) domain?
 

Answer:

Robot

The Nimsoft security mechanism will allow you to MOVE a robot to a different domain, but not 'pull' a robot from another domain.
Therefore, you must be logged in to the old domain to be able to MOVE robots FROM the old domain to the new domain.

If you are trying to move the Robot from one Nimsoft domain to another you have to first login to the hub in domain 'A' when you want to move a robot to domain 'B'

Via the Infrastructure Manager:
  1. Log into the hub (via Rt-Click->Login...) where you want to Move the robot FROM.
  2. Select View -> Show All Domains.
  3. Right-click the Robot and select Move to move it to the NEW domain.

If you still don't see the Hub you're moving it to, Press F5 to refresh the view and wait about 30 secs and see if the new domain is now listed.

Hub

  • You cannot move hubs using the Infrastructure Manager (IM)
  • To move a hub to a new domain you have to edit the "domain=" parameter in hub.cfg and cold-start it.
  • When you move a hub to a new Domain all the robots will also move with no additional configuration required
  • If you have configured a static route to the hub on the old domain then this must be removed before starting the hub
  1. Stop the hub that you wish to move to new Domain.
  2. Remove any static routes to this hub in old Domain.
  3. Change the "domain=" parameter in hub.cfg to point to the new domain.
  4. Start the Hub
  5. If required create new static route to new Domain.
Additional Information:
If you have a Secure UIM Tunnel between hubs, setting up Static hubs does NOT apply.