Installation and Licensing

Finding licensing problems with diagnostic tools

For IRIX, Linux, and Mac OS X, you can use the lmhostid, lmdiag, and lmstat utilities to help find and fix licensing problems. For Windows, you can use the FLEXlm Licensing Utilities (lmtools) to help find and fix licensing problems.

Checking your hardware ID with lmhostid
(IRIX, Linux, Mac OS X)

The lmhostid tool provides the hardware ID for the current machine. This should correspond with the Host ID in the aw.dat, aw_servername.dat, or aw_server.dat file. If they do not match, make sure that a typing mistake was not made.

(IRIX, Linux, Mac OS X) To verify hostid information

  1. In Terminal or in a shell, type the following:
  1. Press Return.

Diagnosing your licensing problems with lmdiag (IRIX, Linux, Mac OS X)

The lmdiag tool diagnoses problems when a license checkout fails. You can use it for node-locked or floating licenses. lmdiag first prints information about the license. It then attempts to check out each license. If the checkout is successful, lmdiag notifies the user; if not, lmdiag gives the reasons why the checkout failed.

lmdiag -c /var/flexlm/LicenseFile
  
/usr/aw/COM/bin/lmdiag -a -c /var/flexlm/LicenseFile
  
/usr/aw/COM/bin/lmdiag -c /var/flexlm/LicenseFile

-c LicenseFile

Specifies the license file to diagnose.

The format of lmdiag is:

Checking floating licensing with lmstat (IRIX, Linux, Mac OS X)

The lmstat tool reports the status of the license manager daemons and feature usage. It provides information about the status of the server nodes, vendor daemons, vendor features and users of each feature. lmstat is only useful for checking floating license errors. You must run lmstat on the license server machine.

To use lmstat

  1. Do one of the following:

-a

Displays all. A lot of information appears if there are a lot of active users.

-c license file

This ensures that you are checking the diagnostics for the correct license file.

  1. Press Return. The data is displayed on the screen.
  1. For the line that starts with License server status, make sure that the correct path to the license file is listed. If it is not the correct path, make sure that the license file exists in the /var/flexlm/ directory, and make sure that the name of the server machine is correct.
  2. The next line of status information shows if the license server is UP. If it is not UP, the error message printed is:
  1. Confirm that the license server is up.
  1. Below the status information is a list of features in the aw_servername.dat or aw_server.dat file and information explaining whether the clients can use the features. An example follows:
  1. If following the above procedures does not solve the problem and successfully license Maya, gather all of the diagnostic output messages, the aw_servername.dat or aw_server.dat file, and the aw_flexlm.log file (located in /usr/tmp). Contact our Support Services department and provide them with this information.

Checking for licensing errors with FLEXlm licensing utilities (Windows)

Licensing sometimes fails because your licensing software is using the wrong hardware ID (also known as Host ID or Server Host ID) for the hardware lock plugged into your node-locked or license server computer. The Host ID/Server Host ID for a hardware lock is printed on a sticker on the lock.

For node-locked or floating licenses, you can use the FLEXlm licensing utilities to check that your licensing software is using the correct hardware ID. For floating licenses only, you can additionally use the FLEXlm licensing utilities program to check for errors not listed in Understanding log file error messages.

Do the following steps on the license server computer or on a computer that has a node-locked license.

To check for license errors (Windows)

  1. On the machine you want to license, go to Start > Program Files > Alias > Common Utilities > FlexLM License Utilities.

Tip

The FLEXlm Licensing Utilities are located at <drive>:\Program Files\Common Files\
Alias Shared\Licensing\bin\lmtools.exe

  1. In the LMTOOLS window, click the System Settings tab.
  2. Record the FLEXID value, if shown. Otherwise, record the Ethernet Address value.
  1. In Notepad, open your license file (C:\FlexLM\aw.dat or aw_servername.dat).
  2. Depending on your license type, check the following:

Note

A Host ID that contains FLEXID=7-0 or FLEXID=6-0 means the hardware lock is not plugged into the parallel connector correctly.

  1. Click the Server Status tab.
  2. Select Display Everything.
  3. Click Perform Status Enquiry.
  4. Examine the status information that appears. For example:
  1. If doing the following procedure doesn't fix the problem, call Alias Support and keep the information from the preceding steps handy.

Checking that a license file is the correct file type (Windows)

The aw.dat or aw_servername.dat file must be a .dat or FLEXlm license file. The following procedure shows how to check and correct the file type.

To check and correct the file type

  1. From My Computer or Windows Explorer, right-click aw.dat or aw_servername.dat and select Properties from the pop-up menu.
  2. In the Properties window, check that the file type is either .dat or FLEXlm License file.
  3. If not, select Tools > Folder Options.
  4. Select the View tab.
  5. Turn off Hide file extensions for known file types and click OK. You'll likely see that aw.dat or aw_servername.dat file has an extension other than .dat, for example, .txt.
  6. Right-click the filename and select Rename from the pop-up menu.
  7. Change the file extension to .dat.
  1. Click Yes. (The file won't become unusable.)