Updating or Renewing a TotalView for HPC FNP License

TotalView for HPC FNP License Renewal

For served licenses used by TotalView for HPC, license renewal includes running the script toolworks_lmreread to reload the license.dat file.

If you are currently using TotalView, you need to update your existing <installdir>/toolworks/flexlm-<version>/license.dat file after you receive a new one. You do not need to create a new <installdir>/toolworks/flexlm‑<version>/license.src file, nor do you need to rerun the Configure_License script (used by TotalView for HPC only) unless you have deleted or changed the location of the flexlm-<version> directory.

To update your license.dat file:

  1. Back up your existing <installdir>/toolworks/flexlm‑<version>/license.dat file. For example,

    cp <installdir>/toolworks/flexlm-<version>/license.dat <installdir>/toolworks/flexlm-<version>/license.dat.bak

  2. Using a text editor, edit the license.dat file and append the new TotalView license keys you have received to the end of the license.dat file.

  3. Direct the license server to reread your license.dat file:

    <installdir>/toolworks/flexlm-<version>/bin/toolworks_lmreread

Deleting Older FNP License Keys

If you received new license keys because you moved your server or traded in existing license keys, the older license keys are no longer valid and must be removed in order for you to be in compliance with the Perforce Permanent License Agreement.

The host and license information that you need to remove are included in the email we sent you. For each of these license keys, that email listed:

  • The hostname of the license server.

  • The host ID of the license server.

  • The FlexNet INCREMENT lines that contain the now invalid license.

Here is how to remove an invalid license:

  1. Locate the machine that corresponds with the host ID for the invalid license. Since hostnames are dynamic, you can use the <installdir>/toolworks/flexlm-<version>/bin/toolworks_hostid script to validate the host ID of the license server.

    The FlexNet host ID is unique for each license server regardless of hostname and IP address changes.

  2. Locate the <installdir>/toolworks/flexlm-<version> directory on the license server.

  3. If necessary, become the root user.

  4. Make a temporary backup of the existing license.dat file. For example:

    cp <installdir>/toolworks/flexlm-<version>/license.dat <installdir>/toolworks/flexlm-<version>/license.dat.bak

  5. Using a text editor, edit the <installdir>/toolworks/flexlm-<version>/license.dat file to delete the - INCREMENT line. Save this file.

  6. If other license keys still exist in the license.dat file, run toolworks_lmreread so the license server can evaluate the license.dat and verify that these licenses still work. If they do, you can delete the license.dat.bak temporary backup file.

    To reread your license.dat file:

    <installdir>/toolworks/flexlm-<version>/bin/toolworks_lmreread

If no license keys remain in the license.dat file, use the following command to stop the license server:

<installdir>/toolworks/flexlm-<version>/bin/toolworks_init stop