Automatically Selecting the Built-In Ethernet Address

The producer can configure the local license server to pick the built-in Ethernet address as hostid, using the property licensing.enableBuiltinHostId in producer-settings.xml. For more information about this property, see Reference: License Server Policy Settings, entry licensing.enableBuiltinHostId.

Limitations

In the following scenarios, setting the built-in Ethernet address as hostid using licensing.enableBuiltinHostId is likely to fail:

•

If a user’s machine is set to use a randomized wireless MAC address.

•

If the option to automatically disable the wireless network connection when an Ethernet cable is connected is enabled.

Therefore, if the Ethernet address is to be used as hostid, the relevant configurations must be disabled on the user’s machine.

Deleting the Selected Built-in Hostid

If licensing.enableBuiltinHostId is enabled (true), the first built-in Ethernet address is selected as hostid. However, in the scenarios mentioned under “Limitations”, above, the built-in Ethernet address might change, because the order of hostids is dynamic and changes depending on new built-in hostids becoming available or being removed.

To retain a stable built-in hostid across multiple launches of the license server, the server stores the selected built-in hostid in its database and fetches this hostid for each launch, instead of getting it from the dynamic hostid list.

If, at a later point in time, you no longer want to use the built-in hostid stored in the database, you can call the new REST endpoint /hostids/selectedbuiltin and delete the selected built-in hostid from the database. This forces the license server to fetch the first built-in hostid from the dynamic hostid list, instead of retrieving it from its database.

To delete the selected built-in hostid

Call the JSON REST endpoint http://licenseServerHostName/api/1.0/hostids/selectedbuiltin using DELETE.

For a successful DELETE, the status code 200 is returned, but no response is provided.