Finding a License Server Host ID
When you install TotalView, the installer placed the files for the FlexNet license manager in installdir/toolworks/flexlm-version.
To obtain host information, run the toolworks_hostid script, as follows:
installdir/flexlm-version/bin/toolworks_hostid
Do not use the UNIX hostid command.
This script writes the host name and one or more FlexNet host ID values to standard output; for example:
The host name for this machine is: fast-server
The host ID for this machine is: 08122b2cf32d
After sending us this information and completing your order we’ll send you a permanent license key.
Creating a FlexNet User Account
While you can run the FlexNet license manager as root, you should run it as a unique non-privileged (that is, non-root) user. Do this by creating a user account reserved for FlexNet’s use. You many need to refer to your operating system’s documentation or your site’s operating procedures for information on creating this account. The user name does not have to be flexnet. Any unique name will do.
The account from which the license manager is run must have the following properties:
• The password is set to ‘*’ because interactive access is not required.
• There is a unique user ID.
• There is a unique group ID.
• The login shell is /bin/sh.
Installing your Permanent License
This procedure is described in Chapter 3, “Installing License Keys,” on page 15.
Accessing a License Server
When you start TotalView, it must be able to find the license.dat file in the flexlm‑version directory. If TotalView and the active license manager are installed on the same host and you place the license.dat file in its default location, you can skip to the next section, Starting the License Manager Manually.
If you are installing TotalView and the license server on different machines, you will must place a license.dat file within each installation. Do this by copying the license.client file from the license server to flexlm-version/license.dat in each installation. If you are using an existing license server, this is all that you have to do.
The format for the license.client file is:
SERVER host-name host-id port-number
USE_SERVER
For example:
SERVER fast-server 08122b2cf32d 7127
USE_SERVER
FlexNet ignores all lines after USE_SERVER.
Starting the License Manager Manually
You can start or stop the license manager by using the toolworks_init script. (This script is created by the Configure_License script when you install the license.) If, for example, the license manager software is installed in /usr/local/toolworks, the following commands start the license manager. Before entering these commands, use the su shell command to become the root user.
NOTE >> In some environments, you’ll need to use the sudo command. If you use this command, you’ll type something like sudo ./toolworks_init start. Also, before you run this program, make sure that you have write permission to this directory.
cd /usr/local/toolworks/flexlm-version/bin
./toolworks_init start
Although the start-up script should be run as super-user (root), the license manager is started using the FlexNet user ID.
Check that the license manager started. Do this by examining the following file:
/usr/local/toolworks/flexlm-version/license.log