How to move a license between servers
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 support@deltaxml.com to request a temporary increase when needed.
Return license
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.

Activate system
Simply activate the available system with your the details of the new server and your license will be ready to download.

You can read more about our license models and the information you need to generate you license in the Licensing models section and the necessary procedures elsewhere in the Procedures section.
Download license
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:
$ java -jar licensing-cli-1.0.1.jar info
Purchase: DelCo Software 10002 Customer: DelCo Software Support Expiry: 2023-12-31 lines: 2
-------|----------------------|-----------------|-----------------|-----|-------------|------------
Line # | Product | License Type | License Use | Qty | license exp | support exp
-------|----------------------|-----------------|-----------------|-----|-------------|------------
1 | XML Compare Java | Server 2 Cores | PRODUCTION | 3 | 2023-12-31 | 2023-12-31
-------------------------------------+------+------------------------------------------+------------
System Id | Size | Current HostId | Last Modify
-------------------------------------+------+------------------------------------------+------------
339425de-b20a-4c48-8ff7-9a69a6d12b89 | 1 | Hostname=prod2.eu.newco.com | 2022-06-12T17:10:04.826159Z
b72e8709-16ee-4301-be00-e782363e5af6 | 1 | Hostname=uat1.us.newco.com | 2022-06-12T17:10:41.817731Z
c3759499-51fc-49f3-8ee5-0b41a6f5f6fc | 1 | Hostname=prod1.us.newco.com | 2022-06-12T17:11:15.878546Z
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:
$ java -jar licensing-cli-1.0.1.jar deactivate b72e8709-16ee-4301-be00-e782363e5af6
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
The 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.
java -jar licensing.jar activate system-id 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.
$ java -jar licensing-cli-1.0.1.jar activate b72e8709-16ee-4301-be00-e782363e5af6 HOSTNAME=uat2.us.newco.com
Associated hostid HOSTNAME=uat2.us.newco.com with system b72e8709-16ee-4301-be00-e782363e5af6
Download License
After activation the new license file can be downloaded and installed on the target system:
$ java -jar licensing-cli-1.0.1.jar download b72e8709-16ee-4301-be00-e782363e5af6
New license being stored at: /Users/nigelw/deltaxml-xml-compare.lic
View System History
The 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.
$ java -jar licensing-cli-1.0.1.jar history b72e8709-16ee-4301-be00-e782363e5af6
-------------+------------------------------------------+---------------------+-----------------+-----------
Operation | HostId | Audit User | Audit IP | Audit Time
-------------+------------------------------------------+---------------------+-----------------+-----------
REGENERATE | | nigelw@deltaxml.com | 185.62.156.212 | 2021-04-30T08:14:31.783535Z
ACTIVATE | HOSTNAME=uat2.us.newco.com | nigelw@deltaxml.com | 185.62.156.212 | 2021-04-30T08:12:32.831924Z
DEACTIVATE | | nigelw@deltaxml.com | 185.62.156.212 | 2021-04-30T08:03:47.791392Z
REGENERATE | | nigelw@deltaxml.com | 81.2.109.32 | 2021-04-29T17:10:42.104175Z
ACTIVATE | HOSTNAME=uat1.us.newco.com | nigelw@deltaxml.com | 81.2.109.32 | 2021-04-29T13:44:16.439197Z