Moving hubs or robots to a different UIM domain

Products

DX Unified Infrastructure Management (Nimsoft / UIM) CA Unified Infrastructure Management SaaS (Nimsoft / UIM) DX Unified Infrastructure Management (Nimsoft / UIM) Unified Infrastructure Management for Mainframe

Issue/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 components of the environment are on the same network and is not appropriate for other scenarios like tunnel connections.

Environment

DX UIM 23.4.*
robot / hub any version

Cause

Guidance

Resolution

Moving Robots

The UIM 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 UIM domain to another you must first login to the hub in domain 'A' when you want to move a robot to domain 'B'

Via the Infrastructure Manager (IM):

Log into the hub (via Rt-Click->Login...) where you want to Move the robot FROM.
Select View -> 'Show All Domains.'
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

Notes:

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.
Note that if you have configured a static route to the hub on the old domain then this must be removed before starting the hub

Steps to move hubs:

1. Stop the hub that you wish to move to the new Domain.
2. Remove any static routes to this hub in the 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 the new Domain.

Additional Information

IMPORTANT NOTE: This process applies when you want to move individual secondary hubs or robots to another (pre-existing) domain.

The Primary Hub can not be moved to a new domain, and the domain name configured at the primary hub can not be changed.

If you have a Secure UIM Tunnel between hubs, setting up Static hubs does NOT apply.

Related KB:

Ensure data consistency when Moving UIM robots or probes from one hub or robot to another

Move robots to another hub via Infrastructure Manager (IM) in DX UIM

Moving hubs or robots to a different UIM domain