Installing the FNP License Server
1. Install the FNP Software
The FlexNet Publisher license server tar bundle flexlm-<version>.tar is available for download on the TotalView website at https://totalview.io/success/downloads.
NOTE: For served license renewal, skip this section and see FNP License Renewal.
1. Unpack your TotalView FlexNet Publisher distribution on the license server system
To install the FNP license server software, unpack the FlexNet Publisher tar bundle onto the machine that will host the license server, then run the Install script from the resulting directory:
tar xvf flexlm-<version>.tar -C ~
cd ~/flexlm-<version>
2. Run the Install script using sudo (optional but recommended)
sudo ./Install
This runs Install in interactive mode in which you are prompted with options or to provide information.
Choose an installation directory, e.g., /opt.At the prompt, select the components to install. Choose to install the license common files and the relevant license platform files for your license server. (The tar ball includes license server software for multiple platforms.)
Once the Install script completes, you should have a flexlm-<version> directory under <installdir>/toolworks.
2. Generate a Host ID for the FNP License Server
To obtain host information, run the toolworks_hostid script, as follows:
<installdir>/toolworks/flexlm-<version>/bin/toolworks_hostid
NOTE: Do not use the UNIX hostid command, as it will not return the proper host ID for FNP.
This script writes the host name and one or more FlexNet Publisher host ID values to standard output, for example:
The host name for this machine is: fast-server
The FlexNet Publisher host ID for this machine is: 08122b2cf32d
Be aware that a host ID is returned for just FNP when invoking toolworks_hostid from the flexlm-<version> directory. Running toolworks_hostid under the <installdir>/toolworks/totalview.<version> directory generates a host ID for both FNP and FNE on platforms running FNP.
If toolworks_hostid returns multiple FlexNet host IDs, select a persistent host ID, i.e., one for a device that is always part of the system when the license server software is running. The license server host ID is derived from the physical MAC address of a network interface card, and the host ID chosen must be a persistent address.
Send the host ID to the TotalView license team, license@perforce.com, who will then send you a permanent/subscription license.
3. Verify Your FNP License Type and Product
After receiving your license, you can verify your license type and product by running the utility toolworks_licensetype and provide as input the license file:
<installdir>/toolworks/totalview.<version>/bin/toolworks_licensetype <licensefile>
The script returns the license type (either FNP or FNE), the product, and whether a license server is required. For example:
FlexNet Publisher (FNP) TotalView for HPC license(s) detected
These licenses are counted. A license server is required.
For license setup help refer to TotalView for HPC > FlexNet Publisher (FNP)
in the TotalView Installation Guide.
4. Configure the FNP License Server
1. Create a file named license.src in your <installdir>/toolworks/flexlm‑<version> directory
Change to the flexlm-<version> directory on the license servercd <installdir>/toolworks/flexlm-<version>
Copy and paste the new license keys — this is the information that you received through email — into a file named license.src in the <installdir>/toolworks/flexlm‑<version> directory.The text in your license.src file is derived from your host information, number of license keys, and license configurations.
2. Create a dedicated unprivileged user account
NOTE: Skip this step if you already created the user as a prerequisite to installing and running the license server as discussed in FNP License Server Prerequisites.
While not required, it’s recommended to have a dedicated, unprivileged user account to run the license server. Note that the login shell should be /bin/sh.
3. Run the <installdir>/toolworks/flexlm‑<version>/bin/Configure_License script on the license server, to create the following files:
<installdir>/toolworks/flexlm‑<version>/license.dat <installdir>/toolworks/flexlm‑<version>/license.optNOTE: If you already have a license.opt file, the script prompts whether you want to overwrite it. Answer “n” to preserve your existing file. If you answer “y”, a new file is created, but your existing file is saved as license.opt.old.
<installdir>/toolworks/flexlm‑<version>/license.client <installdir>/toolworks/flexlm‑<version>/bin/toolworks_init 5. Point TotalView Client Installations to the FNP License Server
Each client machine that will run TotalView needs access to a license. If you are running TotalView and the license server in the installation directory on the same machine, you can skip this step.
If TotalView and the license server are not running on the same machine, you will need to place a license.dat file on each additional installation. Copy the <installdir>/toolworks/flexlm-<version>/license.client file from the license server into the <installdir>/toolworks/FNP_license directory on each client machine and rename that file license.dat.
As an alternative, you can specify the full path to the license.dat file in your LM_LICENSE_FILE environment variable, using the format <port>@<host>.
For example (bash):
LM_LICENSE_FILE=7137@licserver
export LM_LICENSE_FILE
Starting and Stopping an FNP License Server
Starting the FNP License Server
Run the following command to start the license server.
<installdir>/toolworks/flexlm‑<version>/bin/toolworks_init start
NOTE: Note that toolworks_init was generated by the Configure_License script in 4. Configure the FNP License Server.
You can check that the license server started by viewing its log, created after running toolworks_init start at:
<installdir>/toolworks/flexlm‑<version>/license.log
As an alternative, you can run the commands within this section as an argument to the sudo command.
If you configured your license server to run as a non-privileged user, the initialization script ensures that the license management daemons are started and run under the non-privileged user even if you run the script as root.
Stopping the FNP License Server
To stop the license server:
<installdir>/toolworks/flexlm‑<version>/bin/toolworks_init stop
Autostarting the License Server
If you would like the license server to automatically start when the system is booted, run the following script as root:
<installdir>/toolworks/flexlm‑<version>/bin/Configure_Autostart
Configure_Autostart prompts you for some configuration questions and then makes changes to the specified startup files.
