Installing a FlexNet Embedded (FNE) Node-Locked License
Single-system, node-locked licenses do not need a License Server.
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.
To view license details, see Help > About TotalView.
NOTE: Both node-locked and served FNE licenses are distributed with the .bin extension, since they are binary files.
For a TotalView Developer license, follow the instructions here to install your node-locked license.
For TotalView Team and Team Plus, follow the served license instructions in Installing a FlexNet Embedded (FNE) License Server.
For a demo TotalView install, see Installing a Demo License.
For a TotalView Developer license, follow the instructions here to install your node-locked license.
For TotalView Team and Team Plus, follow the served license instructions in Installing a FlexNet Embedded (FNE) License Server.
For a demo TotalView install, see Installing a Demo License.
License Location
TotalView looks for the license in the default directory <installdir>/toolworks/flexnetls-<version> of your TotalView installation.
To install the license file in a non-default directory, either:
Set your TV_LICENSE_FILE environment variable to the file's full pathname. For example:export TV_LICENSE_FILE=nonstandard-dir/license.bin
Or, create a hidden file to avoid having to set up the TV_LICENSE_FILE environment variable for each user. Name this file .tvlicensefile and place it in the platform-specific lib directory for the current TotalView version. This file should contain the full path to the node-locked license, which will be used if TV_LICENSE_FILE is not set. For example, this file:path-to-toolworks/totalview.<version>/<platform>/lib/.tvlicensefile
would contain:
/usr/local/licenses/totalview/license.bin.
License Installation
The license file is attached to the email message confirming your download request or is sent to you from Support. It should be named either license.bin or license_demo.bin. If your email system didn't retain this name, rename it after you save it to disk.
1. Install the license file
Use the same privileges as your TotalView installation. If you used either sudo or the root user, use sudo or the root user, respectively.
Copy the license file to the flexnetls-version directory (or to a custom location as discussed in License Location):cp license.bin <installdir>/toolworks/flexnetls-<version>
or
cp license_demo.bin <installdir>/toolworks/flexnetls-<version>2. Test that the license file is working
Launch TotalView:
<installdir>/toolworks/totalview.<version>/bin/totalview
Test a program, for example:
<installdir>/toolworks/totalview.<version>/<platform>/examples/wave
TotalView should come up with no licensing dialogs.
