Installing a FlexNet Embedded (FNE) License Server
For served licenses, you must install a License Server on a Linux-x86-64 system. In addition, the license file must reside on the same system.
NOTE: This chapter provides FlexNet Embedded (FNE) license installation instructions. You can validate the license type by running the utility toolworks_licensetype, providing as input the license file, e.g.,
toolworks_licensetype <licensefile>
If your license has a .dat extension or toolworks_licensetype reports it is a FlexNet Publisher (FNP) license, see Installing a FlexNet Publisher (FNP) License.
toolworks_licensetype <licensefile>
If your license has a .dat extension or toolworks_licensetype reports it is a FlexNet Publisher (FNP) license, see Installing a FlexNet Publisher (FNP) License.
NOTE: Both node-locked and served FNE licenses are distributed with the .bin extension, since they are binary files.
For TotalView Team and Team Plus, follow the served license instructions here.
For a TotalView Developer license, see Installing a FlexNet Embedded (FNE) Node-Locked License to install your node-locked license.
For TotalView Team and Team Plus, follow the served license instructions here.
For a TotalView Developer license, see Installing a FlexNet Embedded (FNE) Node-Locked License to install your node-locked license.
The FlexNet Embedded license server requires Java and the following Java prerequisites:
Java Prerequisites
Oracle JRE 1.8 or OpenJDK 1.8 The JAVA_HOME (or JRE_HOME) environment variable on your system set to the path for your default JDK (or JRE) installation. Ensure that this path does not include a trailing character, such as a slash or space.The script Configure_License included in the TotalView distribution configures, installs, and starts the FNE license server.
NOTE: For served license renewal, skip this section and see Renewing a Served License.
1. Unpack your TotalView distribution on the Linux license server system
To install the FNE license server software, unpack the Linux PowerLE / ARM64 tar bundle onto the Linux x86 64-bit machine that will host the license server in order to run the Install script from the resulting directory:
tar xvf totalview_<version>_<platform>.tar -C ~
cd ~/totalview.<version>
2. Run the Install script using sudo (required)
sudo ./Install
Accept the license terms, then choose an installation directory, e.g. /opt.At the prompt, select the components to install: just the FNE common files (flexnetls-common.tar.Z).Once the Install script completes, you should have a flexnetls-<version> directory under /<installdir>/toolworks.
3. Install the License File on the License Server system
Place your Perforce provided FNE license file, license.dat into the flexnetls-<version> directory.
4. 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.
The Linux-x86-64 system must have a dedicated, unprivileged user account to run the License Server. Note that:
The default user account name is “flexnetls” but you can rename it if you wish.The account must be a dedicated account in order to run the FNE License Server.The account must be unprivileged.The login shell should be /bin/sh.5. Run the Configure_License script using sudo
cd /opt/toolworks/flexnetls-<version>
sudo bin/Configure_License
Configure_License is an interactive script that prompts you while it runs. For example, you need to specify a listening port to use (e.g., 7137) and the username for running the FNE license server (created as a prerequisite or in Step 4).
6. Set up TV_LICENSE_FILE
On the host where TotalView will run, either:
Set the environment variable TV_LICENSE_FILE to point to the FNE license server using the format port@host.For example:
TV_LICENSE_FILE=7137@licserver
export TV_LICENSE_FILE
Alternatively, to avoid having to set up the TV_LICENSE_FILE environment variable for each user, place the port@host string in a hidden file in the platform-specific lib directory. To do this, create a file .tvlicensefile that contains just the port@host string, such as 7137@licserver . Place this file in /install/path/toolworks/totalview.<version>/<platform>/.tvlicensefile.
7. Test that TotalView can use the license file
Start TotalView on the host Linux system and load a debug target.
For example:
<installdir>/toolworks/totalview.<version>/bin/totalview
<installdir>/toolworks/totalview.<version>/<platform>/examples/wave
TotalView should come up without any licensing dialogs.
To view license details, see Help > About TotalView.
