Moving hubs or robots to a different UIM domain


Article ID: 34311


Updated On:


DX Infrastructure Management NIMSOFT PROBES


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.

How to move hubs or robots to a new CA UIM domain?


- administration


Release: UIM 8.x, 9.x, 20.x
Component: robot, hub


Moving Robots

The Nimsoft security mechanism will allow you to MOVE a robot to a different domain, but not 'pull' a robot from within 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.

Moving Hubs

  • 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 the  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.
  • Nte that 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.

Related KB:

Moving UIM robots or probes from one hub (or robot) to another