Finding licensing problems with diagnostic tools

For 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. The FLEXlm Licensing Utilities and lmstat format is also described in this section.

Checking your hardware ID with lmhostid
(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 you’re running Maya with a hardware lock, you’ll need to use the Product Configuration Wizard to verify your hardware lock FLEXid. For more information, see Identifying your hardware ID..

(Linux, Mac OS X) To verify hostid information

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

/usr/aw/COM/bin/lmhostid

  1. Press Return.

The result is displayed on the screen.

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

The lmdiag tool diagnoses problems when a license checkout fails. You can use it for standalone or networked 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.

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

Checking networked licensing with lmstat (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 networked license errors. You must run lmstat on the license server machine.

To use lmstat

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

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

-a

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

-c LicenseFile

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

  1. Press Return. The data is displayed on the screen.

When running lmstat, a lengthy list of status information appears. The status information shows whether the license server is up and running, and whether each feature line in the license file has no errors and the license count is correct. Examine the following entries in the status information for troubleshooting in the following steps:

lmstat - Copyright (C) 1989-2004 Macrovision Corporation. All rights reserved.
Flexible License Manager status on Sun 5/15/2005 10:51
License server status (License file: /var/flexlm/aw_servername.dat):
servername: license server UP (MASTER)
Vendor daemon status (on servername):
sgiawd: UP

  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:

License server status (License file: /var/flexlm/aw_servername.dat):
servername: Cannot connect to license server (-15,12:146) Connection refused
Vendor daemon status (on servername):
sgiawd: Cannot connect to license server (-15,12:146) Connection refused

If this is the message you receive, follow these steps:

  1. Confirm that the license server is up.

For more information, see Additional setup for networked licenses. Follow the platform-specific instructions for the license server you are working with.

  1. Below the status information is a list of features in the license file and information explaining whether the clients can use the features. An example follows:

Feature usage info:
Users of MayaUnltdf: (Total of 3 licenses available)

This example indicates that three networked Maya Unlimited licenses are available.

If the license file has a typing error, you’ll see something similar to this example:

Users of MayaUnltdf: (Error: 3 licenses, unsupported by licensed server)

Check the license file for a typing error.

  1. If following the above procedures does not solve the problem, gather all of the diagnostic output messages, the license 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 standalone or license server computer. The Host ID/Server Host ID for a hardware lock is printed on the lock.

For standalone or networked licenses, you can use the FLEXlm licensing utilities to check that your licensing software is using the correct hardware ID. For networked 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 standalone license.

To check for license errors (Windows)

  1. On the machine you want to license, go to Start > Program Files > Autodesk > 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.

The value you record is your hardware ID.

  1. Open your license file (C:\FlexLM\aw.dat or aw_servername.dat) in a text editor.
  2. Depending on your license type, check the following:

(Standalone License) Find "HOSTID=" in your license file and compare it to your recorded system ID.

(Networked License) Find "SERVER servername hostID 7111" in your server license file and compare it to the recorded system ID. (Where HOSTID may either be a FLEXID or ethernet HOSTID.)

If these numbers do not match, make sure that you installed the correct license. Otherwise, you need to obtain a new license for your recorded System ID.

If you are checking for networked licensing errors, do the following:

  1. Click the Server Status tab.
  2. Select Display Everything.
  3. Click Perform Status Enquiry.
  4. Examine the status information that appears. For example:

License server status: 7111@servername
  License file(s) on servername: C:\FLEXLM\aw_servername.dat:
  servername: license server UP (MASTER) \
Vendor daemon status (on servername):
sgiawd: UP

where servername is the name of the license server computer.

The status information shows whether the license server is up and running, and whether each feature line in aw_servername.dat has no errors and the license count is correct.

The types of status information are as follows:

License server status—The number 7111 is a fixed number that represents the TCP/IP port used internally by the licensing software. If you see a number other than 7111, make sure that you intend for that port number to be used. Otherwise, open the file aw_servername.dat and change the number to 7111.

License file(s) on servername—Check that the path to the license file is correct.

servername—The next line of the status information shows the license server is up. If the license server isn’t up, you’ll see an error message that begins like this:

lmgrd not running: Cannot connect to license server.
The server (lmgrd) has not been started yet, or the wrong port@host or license file is being used, or the port or hostname in the license file has been changed...

If you see this message, start the license server and ensure the pathname to the server’s license file is correct.

Vendor daemon status (on servername)—The final two lines show whether the vendor daemon is up. The vendor daemon connects the license server to an application, in this case Maya. You can’t directly start the vendor daemon when it’s down. When you stop and start the license server software, the daemon starts also. If the license server is down, stop and start the license server software as described in Additional setup for networked licenses. If the problem persists, restart the license server computer.

Other information—Below the status information is a list of features in the aw_servername.dat file and whether the clients can use the features. An example follows:

Feature usage info:
Users of MayaUnltdf: (Total of 3 licenses available)

This example indicates that three networked Maya Unlimited licenses are available.

If the aw_servername.dat file has a typing error, you’ll see something similar to this example:

Users of MayaUnltdf: (Error: 3 licenses unsupported by license server)

Check aw_servername.dat for a typing error.

  1. If this procedure doesn’t fix the problem, call Autodesk Support and keep the information from the preceding steps handy.

 

Return to Autodesk Index