Using the License Manager to move between servers
To move a license between two servers using the License Manager, please follow these steps.
This process may also been needed when IP addresses or hostnames are changed on a system and these are being used as the Host Id.
There is a limit on the number of times that a system may be deactivated in order to prevent abuse and denial of service issues with the licensing system. This is usually configured to be two deactivations per year. When the limit is reached an error will be reported. Please contact firstname.lastname@example.org to request a temporary increase when needed.
Expand the list of systems for the appropriate purchased product, and select the required system to return the licence by clicking the Return link. Confirm your selection and this will remove the Host Id ready for the new host to be activated.
Simply activate the available system with your the details of the new server and your license will be ready to download.
How you license is ready to download, so simply click on the ‘Download’ link and the file will start downloading.
View System History
You can check the history to see the original activation, return of that activation, activation for the new server and finally the license download.
Using the License CLI to move between servers
To move a license between two servers using the License CLI, please follow these steps.
Deactivating and returning System IDs
You first need to deactivate an existing system. Use the info command to view the systems and their HostId assignments:
Once the system has been identified in terms of its System Id or current assigned HostId, use the
deactivate command with the systemId as a parameter.
For example, the following command will clear the Host ID value of the referenced system:
This will not “switch off” any existing license files. It is only used to clear out associations with Host IDs so that they can be reassigned. However, to be in compliance with our licensing terms you must stop using the software on the system being deactivated and remove previous license file.
Activate/Associate System ID with Host ID
info command will show that the HostId has been cleared and you can use the
activate command to associate the system with a system. You can provide two parameters to the activate command, the first is the System Id and then the HostId.
Details of HostIds for different license types are discussed in How to determine a license server hostid. In the following example we will use a hostname and in this case the HostId uses a 'HOSTNAME=' prefix.
After activation the new license file can be downloaded and installed on the target system:
View System History
history command displays an audit trail of the operations on a system. REGENERATE is associated with the license download operations. The Audit columns in this report describe the user who performs the licensing operation and shouldn’t be confused with any IP addresses or user names used in HostIds.