Autodesk Network Licensing Guide January 2008
© 2008 Autodesk, Inc. All Rights Reserved. Except as otherwise permitted by Autodesk, Inc., this publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose. Certain materials included in this publication are reprinted with the permission of the copyright holder. Trademarks The following are registered trademarks or trademarks of Autodesk, Inc., in the USA and other countries: 3DEC (design/logo), 3December, 3December.
Contents Chapter 1 Quick Start to Autodesk Network Licensing . . . . . . . . . . . . 1 How to Install the Network License Manager . . . . . . . . . . How to Install and Use the Network License Activation Utility . How to Configure a License Server . . . . . . . . . . . . . . . . How to Install and Use SAMreport-Lite (Optional) . . . . . . . Chapter 2 . . . . . . . . . . . . .1 .2 .7 .9 Introduction to Autodesk Network Licensing Tools . . . . . . . 11 Network License Manager . . . . . . . . . . . . .
License File Examples . . . . . . . . . . . . . . . . . . . . . . Example of a License File Not Specific to a Product . . . Example of a License File for a Single or Distributed Server . . . . . . . . . . . . . . . . . . . . . . . . . . Example of a License File for a Redundant Server . . . . Example of a License File for Combined Autodesk Product Versions . . . . . . . . . . . . . . . . . . . . . . . . . Example of Additional Parameters in a License File . . . Package License File Examples . . . . . . . .
Quick Start to Autodesk Network Licensing 1 Setting up network licenses for an Autodesk product requires careful planning and execution. This section gives you quick, step-by-step instructions about how to set up a network licensed environment, and assumes that you are familiar with the terminology and processes required to successfully set up an Autodesk product to run on a network.
Install. If you want to change the install type or installation path, click Configure. 5 On the Select the Installation Type page, select Typical or Custom and accept the default installation path (C:\Program Files\Autodesk Network License Manager\) or Browse to specify a different path. If you enter a path that does not exist, a new folder is created using the name and location you provide. Click Next. WARNING Do not install the Network License Manager on a remote drive.
NOTE If you do not agree to the terms of the license and want to terminate the installation, click Cancel. 4 On the Review - Configure - Install page, review your product selection and the current settings. If you don’t want to make any changes, click Install. If you want to change the install type or installation path, click Configure.
If you don’t know the host name, click the [...] button to locate the name of each server you plan to use. NOTE In a Distributed server model, you are limited to a maximum of 20 servers. Once the 20 server limit has been reached, the Add button disappears. ■ The host ID, for each server host name you entered If you cannot find the host ID, click Lookup to have the utility automatically locate the host ID for the server(s).
The content of this page differs depending on which server model you selected. Click Next. 8 On the License Activation Successful page, click Print to save a printed copy of the license information, or click Done to complete the transaction and exit the Network Activation utility. After you receive your license file and save it locally, refer to How to Configure a License Server on page 7 to configure your license manager.
If you cannot find the host ID, click Lookup to have the utility automatically locate the host ID for the server(s). NOTE If your server has more than one network adapter, select the one that corresponds to a physical network adapter. To determine which adapters are physical, enter ipconfig /all at a Windows command prompt and view the Description field above each physical address.
8 If you would like print a copy of your registration information, select the Select Open Activation Request Form. When you are finished, click Close. After you receive your license file and save it locally, refer to How to Configure a License Server on page 7 to configure your license manager. NOTE It is recommended that you save your license file to the location where you installed the Network License Manager.
NOTE If you have more than one software vendor using FLEXlm® for license management, the Service Name list contains more than one option. Make sure that only one Autodesk service is listed. 5 In the Path to Lmgrd.exe File field, enter the path to the Network License Manager daemon (lmgrd.exe), or click Browse to locate the file. By default, this daemon is installed in the C:\Program Files\Autodesk Network License Manager folder.
How to Install and Use SAMreport-Lite (Optional) SAMreport-Lite is a reporting tool that helps you track network license usage. With SAMreport-Lite technology from Macrovision Corporation, you can monitor client usage for Autodesk network licensed products. To learn more about installing and using SAMreport-Lite, see the SAMreport-Lite User's Guide; click the Documentation link at the lower left corner of the Installation wizard or see the Autodesk product’s Help system.
10
Introduction to Autodesk Network Licensing Tools 2 Autodesk Network licensing tools include the Network License Manager, the Network License Activation utility, the FLEXlm configuration tools, and SAMreport-Lite. Each tool is described in the sections that follow. Network License Manager The Network License Manager is used to configure and manage the license servers.
System Requirements for the Network License Manager Make sure that your network license server meets the minimum recommended requirements. See the following table for hardware and software requirements.
FLEXlm Configuration Tools The Network License Manager uses FLEXlm® license management technology from Macrovision Corporation. FLEXlm provides administrative tools that help to simplify management of network licenses. You can use FLEXlm tools to monitor network license status, reset licenses lost to a system failure, troubleshoot license servers, and update existing license files on the fly. Utilities for License Server Management FLEXlm provides two utilities for managing the license server.
License borrowing If your Autodesk product supports the license borrowing feature, you can allow users to borrow an Autodesk product license from a network license server so that they can use the product without being connected to the license server. A license can be borrowed for a limited period of time. License timeout With license timeout, you can set a timeout period on your license server.
Plan Your Network Licensing 3 This section contains information that you need to know before you set up a network license server. The section includes information about supported license server models, license operation and availability, network license file definitions and parameters, license file examples, license types and behaviors, and the license server heartbeat signal.
Advantages of the Single License Server Model ■ Because all license management takes place on a single server, you have just one point of administration and one point of failure. ■ Of the three license server models, this configuration requires the least amount of maintenance. Disadvantage of the Single License Server Model ■ If the single license server fails, the Autodesk product cannot run until the server is back online.
Redundant License Server Model In the redundant license server model, you use three servers to authenticate a single license file. One server acts as the master, while the other two provide backup if the master server fails. With this configuration, licenses continue to be monitored and issued as long as at least two servers are still functional. The license file on all three servers is the same.You must install the Network License Manager on each server.
License Operation and Availability When a user starts an Autodesk product, the product determines the server from which it should try to obtain a license. The product then requests a license through the TCP/IP network protocol to the license server. If the number of available licenses has not been exceeded on the license server, the Network License Manager assigns a license to the workstation.
License Files The network license file you receive from Autodesk contains licensing information required for a network installation. You obtain license file data when you register your Autodesk product. The license file contains information about network server nodes and vendor daemons. It also contains an encrypted digital signature that is created when Autodesk generates the file. The license file is located in a network location that you specify in the Deployment wizard.
Definitions of license file parameters Line Parameter Definition Example COMPONENTS List of feature codes supported in the package COMPONENTS= "526000REVIT_9_OF\ 51200ACD_2007_OF\ 513001INVBUN_11_OF" OPTIONS INCREMENT OPTIONS=SUITE SUPERSEDE Replacement for any existing Increment line of the same feature code from any license files on the same license server that have a date earlier than the defined Issue Date SUPERSEDE SIGN Encrypted signature used to authenticate the attributes of the licens
Definitions of license file parameters Line Parameter Definition Example server in the distributed server environment, the older PLIST data from the first server is recognized instead of the newer PLIST data. To make sure the updated PLIST file is read obtain a new license file from Autodesk that contains the latest PLIST information. Alternatively, you could add the updated PLIST to the first server in the distributed license server environment to make sure that it is always read.
Definitions of license file parameters Line Parameter Definition Example In this example, the maximum period that licenses can be borrowed is 4320 hours (180 days), unless otherwise noted (for example, BORROW=2880 means that licenses can be borrowed for a maximum of 2880 hours, or 120 days) License borrowing is disabled when this parameter is absent in the license file DUP_GROUP Definition of multiple license requests when the same user and same host share the same license DUP_GROUP=UH ISSUED Date t
■ Standard License File with Additional Parameters. If you purchase Autodesk products that are included in a product set and are also sold as an individual product, you receive a standard license file with additional parameters included in the license file. The additional parameters define the sequence for license usage so that the individual product license is used before the license for the product set.
SERVER XXHP0528 0019bbd68993 USE_SERVER VENDOR adskflex port=2080 INCREMENT 57600ACD_2009_0F adskflex 1.
Example of a License File for Combined Autodesk Product Versions You can combine a license file for different releases of the same Autodesk product or for different Autodesk products, and run all products from one license server. For example, you can combine a license file for AutoCAD 2009 with license files for AutoCAD and AutoCAD Map.
SERVER Server1 1a34567c90d2 USE_SERVER VENDOR adskflex port=2080 INCREMENT 54600ACD_2008_0F adskflex 1.
Example of a Package License File for a Single Server Here is an example of a completed license file for a single license server model: SERVER Server1 1a34567c90d2 USE_SERVER VENDOR adskflex port=2080 PACKAGE SERIES_1 adskflex 1.
SERVER Server1 1a34567c90d2 USE_SERVER VENDOR adskflex port=2080 PACKAGE SERIES_1 adskflex 1.
SERVER Server1 1a34567c90d2 27005 SERVER Server2 2a34567f90d3 27005 SERVER Server3 3a34567b90d4 27005 USE_SERVER VENDOR adskflex port=2080 PACKAGE SERIES_1 adskflex 1.
SERVER Server1 1a34567c90d2 27005 USE_SERVER VENDOR adskflex port=2080 INCREMENT 54600ACD_2008_0F adskflex 1.000 permanent 50 \ VENDOR_STRING=commercial:permanent BORROW=4320 SUPERSEDE \ DUP_GROUP=UH ISSUED=09-Jan-2007 SN=123-12345678 SIGN=6E88EFA8D44C \ PACKAGE SERIES_1 adskflex 1.
SERVER Server1 1a34567c90d2 27005 USE_SERVER VENDOR adskflex port=2080 PACKAGE SERIES_1 adskflex 1.
License behaviors are as follows: ■ Permanent. Enables permanent use of an Autodesk product. ■ Term Extendable. Enables access to an Autodesk product for a limited period of time. The term can be extended at any time. ■ Term Non-Extendable. Enables an Autodesk product for a limited period of time. The term cannot be extended. Heartbeat Signal When an Autodesk product is running, it communicates with the license server at regular intervals using a communication method known as the “heartbeat” signal.
Network Licensing Tools 4 This section includes information for updating FlEXlm, installing and configuring the Autodesk Network License Manager on a network, and installing and using the Network License Activation utility. Update FLEXlm from a Previous Version AutoCAD 2009-based products require FLEXlm version 11.4.1 or later. If you are currently using a version of FLEXlm that is earlier than 11.4.1, you need to upgrade to version 11.4.1 or later.
To verify the version of lmutil.exe, lmtools.exe, or adskflex.exe You should be logged in with Administrator rights when working with the LMTOOLS utility. 1 Do one of the following: ■ Click Start menu (Windows XP & 2000) ➤ All Programs (or Programs) ➤ Autodesk ➤ Network License Manager ➤ LMTOOLS. ■ Right-click the LMTOOLS icon (Windows Vista) on the desktop and click Run As Administrator. 2 In lmtools.exe, click the Utility tab.
6 Uninstall the Network License Manager. For details about uninstalling the Network License Manager, see Uninstall the Network License Manager on page 49. 7 Install the Network License Manager. For details about installing the Network License Manager, see Install the Autodesk Network License Manager on page 35. NOTE Version 11.4.
6 On the Select the Installation Location page, either accept the default installation path (C:\Program Files\Autodesk Network License Manager\) or click [...] to specify a different path. If you enter a path that does not exist, a new folder is created using the name and location you provide. Click Configuration Complete. WARNING Do not install the Network License Manager on a remote drive. When you install the Network License Manager files, you must provide a path to a local drive.
Manager\Network License Activation Utility\enu\) or click [...] to specify a different path. If you enter a path that does not exist, a new folder is created using the name and location you provide. Click Configuration Complete. 7 Once returned to the Review - Configure - Install page, click Install to begin installing the Network License Activation Utility and any other selected tools and utilities. 8 When the Installation Complete page displays, click Finish.
NOTE If you are modifying an existing license file or obtaining a new license for an existing product, your previously entered information might be displayed. Make sure that the serial number that is displayed is the one you want to license. If it is not, enter the correct product serial number. ■ The license server model For more information about each license server model, click the ? button. ■ The server host name If you don’t know the host name, click the [...
If you don’t have a user account, click the Create a User ID Now link and follow the instructions to create a new user account. 6 On the Confirm Your Information page, select a profile and click Next. 7 On the License(s) Received page, in the Save License File for [computer name] field, enter the location where you want to save your license file, or click Browse to navigate to the location.
■ The server host name If you don’t know the host name, click the [...] button to locate the name of each server you plan to use. NOTE In a Distributed server model, you are limited to a maximum of 20 servers. Once the 20 server limit has been reached, the Add button disappears. ■ The host ID, for each server host name you entered If you cannot find the host ID, click Lookup to have the utility automatically locate the host ID for the server(s).
7 Review your personalization data on the Confirm Information page and choose the method you’ll use to submit your request. Click Close. ■ If you submit your request by email, you will be sent your activation code by the method you specified on the Customer Information page. ■ If you submit your request by fax, phone, or postal mail, the Contact Autodesk page is displayed containing the Autodesk fax number, phone number, and mailing address. You can also print your activation request form.
NOTE If your server has more than one network adapter, select the one that corresponds to a physical network adapter. To determine which adapters are physical: in the Windows command prompt, enter ipconfig /all, and then view the Description field above each physical address. If there is more than one physical network adapter, it does not matter which one you use. You just need to make sure that it is properly installed and is functional. Devices such as VPN adapters, PPP adapters, and modems are not valid.
To configure the license server You should be logged in with Administrator rights when working with the LMTOOLS utility. 1 Do one of the following: ■ Click Start menu (Windows XP & 2000) ➤ All Programs (or Programs) ➤ Autodesk ➤ Network License Manager ➤ LMTOOLS. ■ Right-click the LMTOOLS icon (Windows Vista) on the desktop and click Run As Administrator. 2 In the Lmtools program, on the Service/License File tab, select the Configure Using Services option. 3 Click the Config Services tab.
11 Click the Start/Stop/Reread tab. 12 On the Start/Stop/Reread tab, do one of the following: ■ If a service has not yet been defined for Autodesk, click Start Server to start the license server. ■ If a service for Autodesk is already defined and running, click ReRead License File to refresh the Network License Manager with any changes made to the license file or Options file. The license server starts running and is ready to respond to client requests. 13 Close lmtools.exe.
To restart the license server You should be logged in with Administrator rights when working with the LMTOOLS utility. 1 Do one of the following: ■ Click Start menu (Windows XP & 2000) ➤ All Programs (or Programs) ➤ Autodesk ➤ Network License Manager ➤ LMTOOLS. ■ Right-click the LMTOOLS icon (Windows Vista) on the desktop and click Run As Administrator. 2 In the Lmtools program, on the Service/License File tab, select the Configure Using Services option.
REPORTLOG=c:\test\report.rl BORROW_LOWWATER Autodesk_f1 3 TIMEOUT Autodesk_f1 7200 You can also set up advanced license parameters, such as reserving a license, restricting license usage, or defining groups of users. To learn more about setting advanced Options file parameters, see the FLEXlm documentation in the Program Files\Autodesk Network License Manager\docs\FlexUser folder. To create an Options file You should be logged in with Administrator rights when working with the LMTOOLS utility.
2 In the Options file, enter the following syntax on its own line (with REPORTLOG entered in uppercase, as shown): REPORTLOG [+]report_log_path For example, the syntax REPORTLOG +"c:\My Documents\report.rl" means that a report log named report.rl is located in the folder c:\My Documents. NOTE Path names that contain spaces must be enclosed in quotation marks.
2 Enter the following syntax on the next line (with MAX_BORROW_HOURS entered in uppercase, as shown): MAX_BORROW_HOURS feature_code n In this syntax, “n” is the number of hours that a license can be borrowed. For example, the syntax MAX_BORROW_HOURS Autodesk_f1 360 means that for product Autodesk_f1, licenses can be borrowed for 360 hours, or 15 days. NOTE Licenses are borrowed in increments of 24 hours only. Any number that is more than a 24-hour increment is not used.
In the TIMEOUT syntax, “feature_code” is the name of the product (referred to in the INCREMENT line in the license file), and “n” is the number of seconds before an inactive license is reclaimed by the license server. For example, the syntax TIMEOUT Autodesk_f1 7200 means that for the product Autodesk_f1, the license timeout period is set for 7200 seconds, or two hours.
50
Glossary adskflex.exe The Autodesk vendor daemon used with the FLEXlm license technology. This daemon keeps track of the Autodesk licenses that are checked out and the workstations that are using the licenses. ADSKFLEX_LICENSE_FILE In a distributed license server configuration, the environment variable used to point a workstation to the distributed license servers.
heartbeat signal The communication signal between the Network License Manager and the workstation to verify that the workstation is accessible and has an active Autodesk product session running. host ID The unique hardware address of a network adapter. Also known as ethernet address or physical address. host name The TCP/IP name associated with a computer. FLEXlm technology uses the host name as a parameter; the host name must be distinguished from the NetBIOS (server) name.
Network License Activation utility A utility that allows network administrators to license and authorize network versions of an Autodesk product over the Internet. network license installation A type of installation that requires you to install and run the Network License Manager from a network server. You must install and configure the Network License Manager before clients can run the Autodesk product. Network License Manager The technology used by Autodesk for network license management.
54
Index A activating programs 37 AdLM (Network License Manager) 11 ADSKFLEX_LICENSE_FILE environment variable 51 adskflex.
license servers 7, 13, 15, 32, 41–42, 44– 45 configuring 7, 42, 45 heartbeat signals 32 host IDs and host names 41 management utilities 13 models 15 stopping and restarting 44 types of 15 license timeout 48 licenses 7, 11–13, 17–19, 31–32, 45, 48 about 17 assigning 18 behaviors (term limits) 32, 45 FLEXlm tools 13 license files 19 license servers 7 license timeout 48 Network License Authorization utility 12 Network License Manager 11 types of 31 lmgrd.exe (license manager daemon) 18, 33 lmtools.
U V updating 33 FLEXlm tools 33 upgrading 35 Network License Manager vendor daemons 18, 33 35 Index | 57
58
