The license key is generated from the server ID, and the server ID is generated from a network interface. If there are several network interfaces, the server ID shown on the screen is generated from the first network interface that has a MAC address.
When the license is checked, it is valid as long as the MAC address in the license key belongs to any of the server's network interfaces. So if a virtual adapter (VM, Docker, VPN, and so on) is added or an operating system update changes the order of the network interfaces, the server ID on the screen changes, but you do not need a new license key.
This applies starting with ManualWorks 6.0.26. In earlier versions, the MAC address of the first network interface must match the license key, so the license becomes invalid when the order changes. In that case, fix the network interface used for the license key as follows.
To fix the server ID for a new license key to a specific network interface, follow these steps. When a network interface is fixed, only its MAC address is checked when the license is validated.
1
Check the network interface names and server IDs in the Console.
Enter the following command in the Console.
network-interface
The result shows each network interface, its MAC address, and its server ID, as below.
* marks the network interface currently in use.
2
Set the name of the network interface to fix in the startup script options.
Set the network interface to fix in the startup script options. For how to set the startup script, see this guide.
-D3rabbitz.network_interface=eth3
If no network interface has the specified name, the setting is ignored and all network interfaces are used. Starting with ManualWorks 6.0.26, a warning is written to the log in this case.
3
Restart the server.
Restart ManualWorks as described here.
4
Replace the license key if needed.