Installing an 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/support/updates.
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 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
(Note 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.)
Send the host ID to the TotalView license team, license@perforce.com, who will then send you a permanent/subscription license.
3. Verify Your 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 License Server
1. Create a file named license.src in your <installdir>/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>/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 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>/license.log <installdir>/toolworks/flexlm‑<version>/bin/toolworks_init 5. Point TotalView Client Installations to the FNP 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
