Smoke ADLM License Server Troubleshooting

Summary

This article provides information for troubleshooting ADLM license problems in conjunction with Smoke for Mac OS X.

The following topics are covered in this article:

• ADLM License File Information.
• Verifying ADLM License Files.
• Restarting Local and/or Remote ADLM License Servers.
• Troubleshooting Hostname Changes.

ADLM License File Information

Whether running a local or remote ADLM license server, there are two files associated with your license:

1. /var/flexlm/autodesk.lic
    
   • This is the descriptor file on the local Smoke workstation that points to the license server.
   • The license server that this file points to can either be running on the local Smoke workstation, or on a remote system.
   • This is the file that is edited when making changes in the '/Applications/Autodesk/Smoke Common Utilities/ License Server Selector' utility.
   • The following output shows an example of the contents of this file:
     SERVER sardine 0
     USE_SERVER
     VENDOR adskflexport=2080
      
2. /usr/local/flexnetserver/adsk_server.lic *
    
• This is the license server’s license file, containing all of the licenses to be served by the license server
• The following output shows the content of this file (truncated)
  SERVER sardine 00101804d4e8 27100
  USE_SERVER
  VENDOR adskflex port=2080
  INCREMENT 85693SMKMAC_2011_0F adskflex 1.000 31-may-2011 20 \
     VENDOR_STRING=nfr:extendable SUPERSEDE DUP_GROUP=UH \
      ISSUED=07-Oct-2010 BORROW=4320 SN=399-99999966 SIGN="1315 9F33 \
     ...
  
  * Note: Depending on the version of the adlmflexnetserver running on the license server, this file can either be found here:
  /usr/local/flexnetserver/adsk_server.lic or here: /opt/flexnetserver/licenses/license.dat
   

Verifying ADLM License Files

You can check the status of the licenses within your license file by running the following command on either Mac OS X or Linux license servers:
/usr/local/flexnetserver/lmutil lmstat -a -c adsk_server.lic

You will get output similar to the following for a correctly configured, current license:
lmutil-Copyright (c) 1989-2009 AcressoSoftware Inc. All Rights Reserved.
Flexible License Manager status on Thu 11/11/2010 11:47
License server status: 27001@mullet.local
License file(s) on mullet.local: /usr/local/flexnetserver/adsk_server.lic:
mullet.local: license server UP (MASTER) v11.7
Vendor daemon status (on mullet.local):
adskflex: UP v11.7
Feature usage info:
Users of 85693SMKMAC_2011_0F:(Total of 1 license issued;Total of 0 licenses in use)
Users of 85693SMKMACWG1_2011_0F:(Total of 1 license issued;Total of 0 licenses in use)
Users of 85693SMKMACWG2_2011_0F:(Total of 1 license issued;Total of 0 licenses in use)

Users of 85693SMKMACBRN_2011_0F:(Total of 1 license issued;Totalof 0 licenses in use)

In the output above we can see that in this license file there is 1 x Smoke for Mac OS X license available (SMKMAC), 2 x Wiretap Gateway licenses available (SMKMACWG1, SMKMACWG2), and 1 x Burn license available (SMKMACBRN). 

Restarting Local and/or Remote ADLM License Servers

If any changes are made to your license file you will need to restart the license server for those changes to take effect. The following steps explain how to do this on Mac OS X and Linux license servers.

Restarting a local Mac OS X License Server

1. Open the /Applications/Autodesk/Smoke Common Utilities/Service Monitor utility, then click the ‘Restart’ button in the ‘License Server (ADLM)’ section:
    
   
2. If you’re sure the application isn’t running and there are no network connections to the local media storage, click the ‘Confirm’ button:
    
   
3. When the license server has restarted you will see the message ‘Restarted Successfully’ and you should see the green status icon:
    
    
   Note: The License Server functionality of the Service Monitor utility ONLY works with local license servers.
    

Restarting a remote Mac OS X License Server

1. To restart a remote Mac OS X license server from the command line when connected via ssh, or to restart a local Mac OS X license server from the command line, run the following command:
   /usr/local/flexnetserver/lmutil lmdown -q -force
    
   You should see some output similar to the following in the shell:
   lmutil-Copyright (c) 1989-2009 AcressoSoftware Inc. All Rights Reserved.
   Port@HostVendors
   1) 27000@mullet.local adskflex
   1 FLEXnetLicense Server shut down
    
2. Then run the following command to start the license server again:
   /usr/local/flexnetserver/lmgrdLauncher

Restarting a remote Linux License Server

1. To restart a remote Linux license server from the command line when connected via ssh, or to restart a local Linux license server from the command line, run the following command:
   /opt/flexnetserver/lmgrd-c adsk_server.lic -l adskflex.log
2. This command will create a log file called ‘adskflex.log’ in the /opt/flexnetserver/ directory which can be checked for status or errors.

Troubleshooting Hostname Changes

• The hostname of the license server is listed in the license files.
   
• If the hostname of your local license server changes, either manually or through DHCP, it is possible that the license will become unavailable and applications will not be able to run.
   
• To resolve license issues caused by a hostname change follow these steps:
   
  1. edit the files /usr/local/flexnetserver/ads_server.lic and the file /var/flexlm/autodesk.lic so that the second item on the SERVER line (highlighted below) matches the current workstation hostname:
     SERVER <current_hostname> 00101804d4e8 27100
     USE_SERVER
     VENDOR adskflexport=2080
     
     Note: Do not change the Mac ID serial number (third item on the SERVER line). This will disable the license.
  2. Restart the local license server using /Applications/Autodesk/Smoke Common Utilities/Service Monitor
      
• To prevent further issues with hostname changes on a local license server, you can edit the above files and replace the hostname with “127.0.0.1”. This will make the license insensitive to hostname changes.
  
  Note: Do not use “localhost” for a hostname.