Edit Local Settings Post-Installation
As part of the installation process, the license server package generates a local settings file that configures the license server for your local environment, as described in the previous section, Configure, Install, and Start the License Server. The installation process provides a facility that lets you change default settings before settings file is generated.
Once the license server is installed, you can edit the local settings at any time, using the following instructions.
To modify local settings after installing the license server as a service on Linux
| 1. | Using sudo privileges, open the /etc/default/flexnetls-producer_name file in a text editor, and edit the settings as needed. (For example, you can uncomment settings or change existing values.) See the previous section Configure, Install, and Start the License Server for a description of the base settings. |
Note that the following additional settings, which you can also edit, are created in the file at the time it is generated with the configure tool:
|
Setting |
Description |
|
ACTIVE_HOSTID=value/type |
The hostid to use for the license server. The hostid can only be set using a configuration file if no hostid has yet been specified for the license server. Once a hostid has been set, it can only be changed using the FlexNet License Server Administrator or the FlexNet License Server Manager. The syntax is value/type (for example, 7200014f5df0/Ethernet). If no value is specified for this setting and no active hostid has yet been set for the license server, the license server uses, by default, the first available Ethernet address on the machine. If using a dongle ID or a hostid other than the first available Ethernet address, specify it here. For more information about hostids, see Understanding Hostids. Important:It is not recommended to change the hostid of a license server that has licenses mapped in the back office (FlexNet Operations). If the hostid is changed to a value that is different to that specified for the license server in the back office, any existing licenses mapped to the license server that is locked to the old hostid in the back office will be orphaned. To prevent this from happening, it is best practice to return the license server in the back office. During the return operation, the producer can transfer the licenses to a different device; this can be the same machine with the desired hostid. After the transfer, wait for the license server to synchronize with the back office (server synchronization occurs based on synchronization policies or on-demand). |
|
HTTPS_SERVER_FILE=path |
The path to the HTTPS “server” configuration file used to support incoming HTTPS from client devices. For details on how to create this configuration file and set up the license server for HTTPS, see Incoming HTTPS in More About License Server Functionality. |
|
HTTPS_CLIENT_FILE=path |
The path to the HTTPS “client” configuration file used to support outgoing HTTPS communication to FlexNet Operations. Note:The “client” configuration file is being deprecated and will be removed in a future release. Instead of the “client” configuration file, specify parameters to access the truststore file in the https-out setting in local-configuration.yaml. For more information about HTTPS setup on the license server, see Outgoing HTTPS. |
|
SERVER_ALIAS=alias |
A user-defined name (sometimes called host name) for the license server. This name is added to server’s capability requests to the back office, where it is then saved and used to identify the license server in the FlexNet Operations Producer and End User portals. One important use for this setting is that the alias can be included in the initial capability request sent at server registration, providing a helpful name by which users can identify the new server in the portals. If no alias is sent at registration, the server is identified by its hostid. |
|
EXTENDED_SUFFIX=suffix |
The suffix used for the Extended Host ID feature. This value is not set by default. Contact the software producer for details. |
|
EXTRA_SYSPROPERTIES= |
One or more system properties (each in -Dkey=value format) used by the license server to support different types of functionality. If entering multiple properties, enclose the entire set of properties in double quotations. For example, if you plan to have the license server communicate with the back office through an HTTP proxy, use this setting to identify the proxy parameters needed to configure the server. (For details, see Proxy Support for Communication with the Back Office in the More About License Server Functionality EXTRA_SYSPROPERTIES="-Dhttp.proxyHost=10.90.3.133 The entire set of parameters must be enclosed in double quotations, even if you specify only a single parameter, such as EXTRA_SYSPROPERTIES="-Dhttp.proxyHost=10.90.3.133". |
|
BACKUP_SERVER_HOSTID |
The hostid of the back-up license server in a failover configuration with the current license server (as the main server), if the back-up server is “unknown”—that is, not registered—in FlexNet Operations. This setting adds the back-up server’s hostid to the capability request sent by the current license server to the back office. The back office then automatically registers the back-up server in a failover configuration with the main server. This process saves the extra step of having to manually register the failover pair in FlexNet Operations. For more information, see License Server Failover in the More About License Server Functionality Make sure the back-up server’s hostid is the same type (for example, “ethernet”) as the hostid type of the current (main) license server. You might need to include this setting manually if it is not automatically generated in the settings file. |
| 2. | Execute sudo service flexnetls-producer_name restart to restart the license server service. |