How to apply Unified Infrastructure Management (UIM) License keys
Article ID: 71940
Updated On:
Products
Issue/Introduction
Step by step guide on how to apply Unified Infrastructure Management (UIM) license keys using Infrastructure Manager (IM) or using Admin Console (AC2)
Environment
Release: UIM 9.x or earlier
UIM 20.x or later does not require this steps or license
Cause
Resolution
1. Apply UIM licenses Using Infrastructure Manager (IM):
1.1 Apply hub license key (IM):
a) Open the license file with a notepad and copy the hub license string (only the highlighted part)
------ NMS Hub License
license = nimbus-v1.0/Example Company Name/*/9999/Unlimited/XXX XXX XXX XXX XXXX XXX
------
b) Open the Infrastructure Manager (from any workstation that has access to the UIM instance)
c) Click on a hub robot (a Hub robot has a light green icon as the one highlighter below. A normal robot has a dark green icon)
d) On the probe list select the “hub” probe. Open the hub GUI (graphic user interface) by double click on the hub probe or right click > Configure
e) At the hub GUI, > go to the General Tab > and click on Modify
f) At the box, Paste the license:
g) Then click ok >and then ok again. (At this point the GUI will close the hub may restart. During restart the robot may disappear from the IM or become red. This could take up to a couple of minutes and it is expected to happen)
1.2 Apply Probe License keys (IM): This step should be done on each hub that has distsrv installed. Log into each hub that has a distsrv probe to access the license section.
a) In the IM click on the license node (under archive)
b) Then go to the right part of the IM and right click anywhere > and click Add license
c) In the box, paste the probe license(s) and click OK:
2. Apply UIM licenses Using Admin Console (AC2)
2.1. Apply a HUB License key (AC2)
a) Open the license file with a notepad and copy the hub license string (only the highlighted part)
------ NMS Hub License
license = nimbus-v1.0/Example Company Name/*/9999/Unlimited/XXX XXX XXX XXX XXXX XXX
------
b) Open admin console: go to http://<uimserver>/adminconsoleapp
c) Log in as an Administrator (or a user with Administrator privileges)
d) Click on Licenses and then go to “Actions” > Configure hub license
e) Paste the hub license and save
2.2 Apply Probe license keys (AC2)
a) Open admin console: go to http://<uimserver>/adminconsoleapp
b) Log in as an Administrator (or a user with Administrator privileges)
c) Click on Licenses and then go to Actions > Add Licenses
d) Paste the licenses in the Add License box and click Add.
Additional Information
Additional information and answers around Licensing are covered on the Knowledge Document below:
71939 : CA Unified Infrastructure Management (UIM) Licensing Issues and Answers
If the hub license expired and the robot is restarted, it will not be possible to update any licenses from IM or AC2. In that case, follow these steps to get IM up and running first:
1. Stop the Nimbus Robot Watcher service if it is running on the primary hub:
For Windows:
Stop the service through the Windows service.msc
For Linux:
Execute the following command from a robot login shell:
service nimbus stop
2. Using a text editor on the primary hub, modify the hub.cfg file. Locate the license key in the <hub> section and replace the temporary license string with the entire nimbus license string from the email that should have been sent with the valid UIM licenses. For example, if the nimbus license issued is as follows:
nimbus-v1.0/Example Company Name/*/2000/Unlimited/XXXX XXXX XXXX XXXX XXXX XXXX
enter the following for the license key in the <hub> section of the hub.cfg file:
license = nimbus-v1.0/Example Company Name/*/2000/Unlimited/XXXX XXXX XXXX XXXX XXXX XXXX
Save the change.
3. Activate the Nimsoft Robot watcher service:
From Windows:
Start the service through the Windows service.msc
For Linux:
Execute the following command from a root login shell:
service nimbus start
Any other probe with an invalid license will fail, but it should be possible to start IM and add the new probe license keys. Once these license keys have been added, restart the robot on the primary hub.
Feedback
