Macrovision Corporation PC Betriebsanweisung Seite 1

FLEXNET LICENSING END USER GUIDEVersion 10.0

Typographic Conventionsx FLEXnet Licensing End User GuideTypographic ConventionsThe following typographic conventions are used in this manual:• The fi

Chapter 8 - Mobile LicensingFulfilled from a Prepaid License Pool100 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 101Hostids for FLEXnet Licensing-Supported PlatformsAFLEXnet Licensing uses different machine identifications for dif

Appendix A - Hostids for FLEXnet Licensing-Supported PlatformsExpected FLEXnet Licensing Hostids102 FLEXnet Licensing End User GuideDEC Alpha ethernet

Appendix A - Hostids for FLEXnet Licensing-Supported PlatformsSpecial FLEXnet Licensing HostidsFLEXnet Licensing End User Guide 103Special FLEXnet Lic

Appendix A - Hostids for FLEXnet Licensing-Supported PlatformsSpecial FLEXnet Licensing Hostids104 FLEXnet Licensing End User GuideExamplesFEATURE f1

FLEXnet Licensing End User Guide 105License File Format BLicense files usually begin with a SERVER line (or three lines for three-server redundant ser

Appendix B - License File FormatLicense File Syntax106 FLEXnet Licensing End User GuideLicense File SyntaxSample License FileThis is an example of a l

Appendix B - License File FormatLicense File SyntaxFLEXnet Licensing End User Guide 107See Also• “FEATURE/INCREMENT Lines” for more information about

Appendix B - License File FormatLicense File Syntax108 FLEXnet Licensing End User GuideSee Also• Chapter 5, “The Options File,” for further informati

Appendix B - License File FormatLicense File SyntaxFLEXnet Licensing End User Guide 109FEATURE/INCREMENT LinesA FEATURE line describes the license req

FLEXnet Licensing End User Guide 11Introduction and Overview 1This chapter explains the basics of floating (network) licensing and gives a quick overv

Appendix B - License File FormatLicense File Syntax110 FLEXnet Licensing End User GuideTable B-2 lists attributes that may appear in a FEATURE or INC

Appendix B - License File FormatLicense File SyntaxFLEXnet Licensing End User Guide 111DUP_GROUP=... The syntax is:DUP_GROUP=NONE|SITE|[UHDV]U = DUP_U

Appendix B - License File FormatLicense File Syntax112 FLEXnet Licensing End User GuideLINGER=nThe vendor-defined lingering interval for this license.

Appendix B - License File FormatLicense File SyntaxFLEXnet Licensing End User Guide 113The following attributes listed in Table B-3 are optional and

Appendix B - License File FormatLicense File Syntax114 FLEXnet Licensing End User GuideTo turn off automatic ordering add sort=nnn to the FEATURE/INCR

Appendix B - License File FormatLicense File SyntaxFLEXnet Licensing End User Guide 115Example:PACKAGE package vendor [pkg_version] COMPONENTS=pkg_lis

Appendix B - License File FormatLicense File Syntax116 FLEXnet Licensing End User GuideExamples:PACKAGE suite sampled 1.0 SIGN=3B24B2F508CB \COMPONENT

Appendix B - License File FormatDecimal FormatFLEXnet Licensing End User Guide 117UPGRADE LinesUPGRADE feature vendor from_feat_version to_feat_versio

Appendix B - License File FormatLicense File Order118 FLEXnet Licensing End User GuideLicense File OrderThe order of the lines in a license file is no

FLEXnet Licensing End User Guide 119Troubleshooting Guide CThis appendix documents areas of FLEXnet Licensing that have given customers difficulty in

Chapter 1 - Introduction and OverviewHow to Use This Manual12 FLEXnet Licensing End User GuideIn addition, refer to: • Appendix B, “License File Forma

Appendix C - Troubleshooting GuideFLEXLM_DIAGNOSTICS120 FLEXnet Licensing End User Guide- Did the server start correctly? Look for a message such as:

Appendix C - Troubleshooting GuideFLEXLM_DIAGNOSTICSFLEXnet Licensing End User Guide 121• It was unable to find the other license file, which is what

Appendix C - Troubleshooting GuideFLEXLM_DIAGNOSTICS122 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 123FLEXnet Licensing Environment Variables DEnvironment variables are not required in order to use FLEXenabled applic

Appendix D - FLEXnet Licensing Environment VariablesEnvironment Variables124 FLEXnet Licensing End User GuideFLEXLM_DIAGNOSTICSUsed for debugging wher

FLEXnet Licensing End User Guide 125FLEXnet Licensing Error Codes EError Message FormatFLEXnet Licensing error messages presented by applications have

Appendix E - FLEXnet Licensing Error CodesError Code Descriptions126 FLEXnet Licensing End User GuideFormat 2 (long—version 6.0+):FLEXlm error textFLE

Appendix E - FLEXnet Licensing Error CodesError Code DescriptionsFLEXnet Licensing End User Guide 127-11 Invalid date format in license file.-12 Inval

Appendix E - FLEXnet Licensing Error CodesError Code Descriptions128 FLEXnet Licensing End User Guide-34 Clock difference too large between client and

Appendix E - FLEXnet Licensing Error CodesError Code DescriptionsFLEXnet Licensing End User Guide 129-68 License BORROW support not enabled.-69 FLOAT_

Chapter 1 - Introduction and OverviewFLEXnet Licensing ComponentsFLEXnet Licensing End User Guide 13FLEXnet Licensing ComponentsFLEXnet Licensing comp

Appendix E - FLEXnet Licensing Error CodesError Code Descriptions130 FLEXnet Licensing End User Guide-95 Network connect to this_host failed.Change th

Appendix E - FLEXnet Licensing Error CodesError Code DescriptionsFLEXnet Licensing End User Guide 131-115 Error in Public Key package.-116 TRL not sup

Appendix E - FLEXnet Licensing Error CodesError Code Descriptions132 FLEXnet Licensing End User Guide-506 Internal FLEXnet Licensing error.-507 Bad da

FLEXnet Licensing End User Guide 133The Report Log File FThe license server produces both report log files and debug log files. The focus of this appe

Appendix F - The Report Log FileRedirecting Report Log Output for a Vendor Daemon134 FLEXnet Licensing End User GuideRedirecting Report Log Output for

FLEXnet Licensing End User Guide 135The Debug Log File GThe license server produces both debug log files and report log files. The focus of this appen

Appendix G - The Debug Log FileDebug Log Messages136 FLEXnet Licensing End User GuideRedirecting Debug Log Output for a Running Vendor DaemonIt is pos

Appendix G - The Debug Log FileDebug Log MessagesFLEXnet Licensing End User Guide 137Informational MessagesMessage DescriptionConnected to host This d

Appendix G - The Debug Log FileDebug Log Messages138 FLEXnet Licensing End User GuideRetrying socket bind (address in use) The license servers try to

Appendix G - The Debug Log FileDebug Log MessagesFLEXnet Licensing End User Guide 139Configuration Problem MessagesMessage Descriptionhost: Not a vali

Chapter 1 - Introduction and OverviewFLEXnet Licensing Components14 FLEXnet Licensing End User GuideFigure 1-1 shows the relationship these FLEXnet L

Appendix G - The Debug Log FileDebug Log Messages140 FLEXnet Licensing End User GuideDaemon Software Error MessagesUnknown host: host The host name sp

FLEXnet Licensing End User Guide 141FLEXnet Licensing Versions HVersion Compatibility with FLEXnet Licensing ComponentsIn general, always use the late

Appendix H - FLEXnet Licensing VersionsVersion Summary142 FLEXnet Licensing End User GuideVersion Summaryv1.0—1988First FLEXlm Release, containing all

Appendix H - FLEXnet Licensing VersionsVersion SummaryFLEXnet Licensing End User Guide 143• Added multiple jobs for enhanced support of LM_LICENSE_FIL

Appendix H - FLEXnet Licensing VersionsVersion Summary144 FLEXnet Licensing End User Guide• FLEXlm license directory support: *.lic automatically used

Appendix H - FLEXnet Licensing VersionsVersion SummaryFLEXnet Licensing End User Guide 145• SIGN= keyword in license •lmnewlog utility (v7.1+ vendor d

Appendix H - FLEXnet Licensing VersionsVersion Summary146 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 147IndexAabout this manual ixANY hostid 103asset_info 113BBORROW_LOWWATER 50borrowing 96Ccommands xCOMPOSITEhostid 10

148 FLEXnet Licensing End User GuideFEATURE line 109asset_info 113dist_info 113DUP_GROUP 111expiration date 110feature version 109FLOAT_OK 111HOST_BAS

FLEXnet Licensing End User Guide149ISSUED 111ISSUER 111Llicenseborrowing 96concurrent 26floating 26mixed 27mobile 93network license 26node-locked 26li

Chapter 1 - Introduction and OverviewFLEXnet Licensing ComponentsFLEXnet Licensing End User Guide 15Figure 1-2 shows this model. See “Component Overv

150 FLEXnet Licensing End User Guidelmrereadrestricting access 66syntax 85lmstatoutput for lmreread 86syntax 86lmswitch, syntax 88lmswitchr, syntax 89

FLEXnet Licensing End User Guide151PPACKAGE line 114OPTIONS=SUITE 115OPTIONS=SUITE_RESERVED 115syntax 115package suite 115PLATFORMS 112port numberserv

152 FLEXnet Licensing End User GuideVvendor daemonand redundant servers 67debug log file 136lmnewlog 82lmreread 85lmswitchr 89memory usage 40options f

Chapter 1 - Introduction and OverviewFLEXnet Licensing Components16 FLEXnet Licensing End User GuideIf the vendor daemon terminates for any reason, al

Chapter 1 - Introduction and OverviewFLEXnet Licensing ComponentsFLEXnet Licensing End User Guide 17End-User Administration Options FileThe end-user a

Chapter 1 - Introduction and OverviewThe License Request Process18 FLEXnet Licensing End User GuideThe License Request ProcessWhen you run a counted F

Chapter 1 - Introduction and OverviewConfiguring FLEXnet LicensingFLEXnet Licensing End User Guide 19Configuring FLEXnet LicensingMost of the paramete

Legal NoticesCopyright NoticeCopyright © 1996-2004 Macrovision Corporation. All Rights Reserved. The information contained herein contains confidentia

Chapter 1 - Introduction and OverviewGetting Started Checklist20 FLEXnet Licensing End User Guide6. Start lmgrd (the license manager daemon) manually;

Chapter 1 - Introduction and OverviewGetting Started ChecklistFLEXnet Licensing End User Guide 21How to Specify a License File LocationThe license fil

Chapter 1 - Introduction and OverviewGetting Started Checklist22 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 23License File Basics 2The license file contains information required by FLEXnet Licensing to manage licenses for a F

Chapter 2 - License File BasicsSpecifying Location of the License File24 FLEXnet Licensing End User Guide@host. Table 2-1 shows some examples of LM_L

Chapter 2 - License File BasicsLicense File Format OverviewFLEXnet Licensing End User Guide 25•a port@host setting, where port and host are the TCP/IP

Chapter 2 - License File BasicsTypes of License Files26 FLEXnet Licensing End User Guide• Values in keyword=value pairs on FEATURE lines, if keyword i

Chapter 2 - License File BasicsTypes of License FilesFLEXnet Licensing End User Guide 27If the number of licenses is set to 0 (or uncounted), then the

Chapter 2 - License File BasicsTypes of License Files28 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 29Managing Licenses from Multiple Vendors 3Since more than 2500 vendors have chosen FLEXnet Licensing as their licens

FLEXnet Licensing End User Guide iiiContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 3 - Managing Licenses from Multiple VendorsMultiple Machines30 FLEXnet Licensing End User GuideMultiple MachinesIn this scenario, each distinc

Chapter 3 - Managing Licenses from Multiple VendorsOne Machine with Multiple License ServersFLEXnet Licensing End User Guide 31One Machine with Multip

Chapter 3 - Managing Licenses from Multiple VendorsOne Machine with One License Server and Multiple License Files32 FLEXnet Licensing End User Guide•

Chapter 3 - Managing Licenses from Multiple VendorsManaging Multiple License FilesFLEXnet Licensing End User Guide 33• Output from all vendor daemons

Chapter 3 - Managing Licenses from Multiple VendorsAdditional Considerations34 FLEXnet Licensing End User Guidelmgrd builds up an internal license-fil

Chapter 3 - Managing Licenses from Multiple VendorsAdditional ConsiderationsFLEXnet Licensing End User Guide 35Disadvantage• Careful planning must be

Chapter 3 - Managing Licenses from Multiple VendorsAdditional Considerations36 FLEXnet Licensing End User GuideHow to Combine License FilesIf your lic

Chapter 3 - Managing Licenses from Multiple VendorsAdditional ConsiderationsFLEXnet Licensing End User Guide 37Version Component CompatibilityWhen one

Chapter 3 - Managing Licenses from Multiple VendorsAdditional Considerations38 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 39Selecting Server Machines 4This chapter helps you decide which machines to use as license server machines. Resource

iv FLEXnet Licensing End User GuideOne Machine with Multiple License Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 4 - Selecting Server MachinesRemote Mounted Disks40 FLEXnet Licensing End User GuideDisk SpaceThe only output files created by the license ser

Chapter 4 - Selecting Server MachinesRedundant License ServersFLEXnet Licensing End User Guide 41mounted disk, you double the points of failure which

Chapter 4 - Selecting Server MachinesRedundant License Servers42 FLEXnet Licensing End User GuideThe user in Chicago could set LM_LICENSE_FILE to: 170

Chapter 4 - Selecting Server MachinesCounted vs. Uncounted LicensesFLEXnet Licensing End User Guide 43• License-file list is not limited to three serv

Chapter 4 - Selecting Server MachinesCounted vs. Uncounted Licenses44 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 45The Options File 5The options file allows the license administrator to control various operating parameters of FLEX

Chapter 5 - The Options FileOptions File Syntax46 FLEXnet Licensing End User Guide3. Add the path to the options file in the license file as the fourt

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 47FLEXNET LICENSING VERSION NOTES• BORROW_LOWWATER options keyword int

Chapter 5 - The Options FileOptions File Syntax48 FLEXnet Licensing End User GuideCommentsInclude comments in your options file by starting each comme

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 49Type SpecificationThe following option keywords restrict who may use

FLEXnet Licensing End User Guide vTIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 5 - The Options FileOptions File Syntax50 FLEXnet Licensing End User GuideBORROW_LOWWATERBORROW_LOWWATER feature[:keyword=value] nSets the num

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 51EXCLUDEEXCLUDE feature[:keyword=value] type {name | group_name}Exclu

Chapter 5 - The Options FileOptions File Syntax52 FLEXnet Licensing End User GuideTo exclude the user “fred” from the list of users able to borrow fea

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 53Only the last FQDN_MATCHING keyword in the the options file has effe

Chapter 5 - The Options FileOptions File Syntax54 FLEXnet Licensing End User GuideThe example below is even more lenient:INCLUDE f2 HOST myhostFQDN_MA

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 55HOST_GROUPHOST_GROUP group_name host_listDefines a group of hosts fo

Chapter 5 - The Options FileOptions File Syntax56 FLEXnet Licensing End User GuideNote INCLUDE is required for USER_BASED or HOST_BASED features. The

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 57To allow the user “jane” to use all features served by this vendor d

Chapter 5 - The Options FileOptions File Syntax58 FLEXnet Licensing End User GuideFor example, to limit the user jan to 5 licenses for feature “f1,” i

Chapter 5 - The Options FileOptions File SyntaxFLEXnet Licensing End User Guide 59NOLOGNOLOG { IN | OUT | DENIED | QUEUED }Suppresses logging the sele

vi FLEXnet Licensing End User GuideChapter 8 Mobile Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 5 - The Options FileOptions File Syntax60 FLEXnet Licensing End User GuideSee Also • “Configuring the License Manager as a Windows Service” •

Chapter 5 - The Options FileHow the Vendor Daemon Uses the Options FileFLEXnet Licensing End User Guide 61TIMEOUTTIMEOUT feature[:keyword=value] secon

Chapter 5 - The Options FileRules of Precedence in Options Files62 FLEXnet Licensing End User GuideFLEXNET LICENSING VERSION NOTES•The lmreread utilit

Chapter 5 - The Options FileOptions File ExamplesFLEXnet Licensing End User Guide 63• Prevents the user “lori” from using the “compile” feature on any

Chapter 5 - The Options FileOptions File Examples64 FLEXnet Licensing End User GuideEXCLUDE Example#First Define the group "painters"GROUP p

FLEXnet Licensing End User Guide 65The License Manager Daemon 6The license manager daemon, lmgrd, is one of two FLEXnet Licensing components which com

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on UNIX Platforms66 FLEXnet Licensing End User GuideStarting the License Man

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on UNIX PlatformsFLEXnet Licensing End User Guide 67license file (as well as

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on Windows68 FLEXnet Licensing End User Guide/bin/su daniel -c '/home/f

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on WindowsFLEXnet Licensing End User Guide 69Configuring the License Manager

FLEXnet Licensing End User Guide viiAppendix E FLEXnet Licensing Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125Erro

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on Windows70 FLEXnet Licensing End User GuideIn order to control the operati

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on WindowsFLEXnet Licensing End User Guide 714. Click the Start/Stop/Reread

Chapter 6 - The License Manager DaemonStarting the License Manager Daemon on Windows72 FLEXnet Licensing End User Guide1. With LMTOOLS started and the

FLEXnet Licensing End User Guide 73License Administration Tools 7FLEXnet Licensing provides utilities for the license administrator to help manage the

Chapter 7 - License Administration ToolsRunning Administration Tools74 FLEXnet Licensing End User GuideFLEXNET LICENSING VERSION NOTES•The lmpath util

Chapter 7 - License Administration ToolslmborrowFLEXnet Licensing End User Guide 75FLEXNET LICENSING VERSION NOTES• VENDOR_LICENSE_FILE environment va

Chapter 7 - License Administration Toolslmborrow76 FLEXnet Licensing End User GuideFor example:lmborrow sampled 20-aug-2001 13:00This has the effect o

Chapter 7 - License Administration ToolslmborrowFLEXnet Licensing End User Guide 77where:Returning the license early has the effect of clearing the LM

Chapter 7 - License Administration Toolslmdiag78 FLEXnet Licensing End User Guidelmdiaglmdiag allows you to diagnose problems when you cannot check ou

Chapter 7 - License Administration ToolslmdownFLEXnet Licensing End User Guide 79lmdownThe lmdown utility allows for the graceful shutdown of selected

viii FLEXnet Licensing End User Guide

Chapter 7 - License Administration Toolslmhostid80 FLEXnet Licensing End User GuideSee Also• “lmgrd Command-Line Syntax” for details about securing a

Chapter 7 - License Administration ToolslminstallFLEXnet Licensing End User Guide 81The output of this command looks as follows:lmhostid - Copyright (

Chapter 7 - License Administration Toolslmnewlog82 FLEXnet Licensing End User GuideWhen an input file is specified with no output file specified, outp

Chapter 7 - License Administration ToolslmpathFLEXnet Licensing End User Guide 83lmpathThe lmpath utility allows direct control over FLEXnet license p

Chapter 7 - License Administration Toolslmremove84 FLEXnet Licensing End User GuideOther Vendors:______________/usr/local/flexlm/licenses/license.licN

Chapter 7 - License Administration ToolslmrereadFLEXnet Licensing End User Guide 85The -h variation uses the server_host, port, and license handle, as

Chapter 7 - License Administration Toolslmstat86 FLEXnet Licensing End User GuideNote If you use the -c license_file_list option, the license file(s)

Chapter 7 - License Administration ToolslmstatFLEXnet Licensing End User Guide 87The output of lmstat -a looks similar to:License server status: 27000

Chapter 7 - License Administration Toolslmswitch88 FLEXnet Licensing End User GuideThe user, user_host, display, server_host, port, and handle informa

Chapter 7 - License Administration ToolslmswitchrFLEXnet Licensing End User Guide 89If debug log output is not already directed to a separate file for

FLEXnet Licensing End User Guide ixPrefaceWelcome to FLEXnet Licensing, the de facto standard network license manager used by over 2000 leading softwa

Chapter 7 - License Administration Toolslmver90 FLEXnet Licensing End User GuideNote The effect of lmswitchr continues only until the vendor daemon i

Chapter 7 - License Administration ToolsLicense Administration Tools—LMTOOLS for WindowsFLEXnet Licensing End User Guide 91Configuration Using License

Chapter 7 - License Administration ToolsLicense Administration Tools—LMTOOLS for Windows92 FLEXnet Licensing End User Guide

FLEXnet Licensing End User Guide 93Mobile Licensing 8End users often want to use applications on computers that do not have a continuous connection to

Chapter 8 - Mobile LicensingNode-Locked to a FLEXid with FLOAT_OK (Windows Only)94 FLEXnet Licensing End User GuideNode-Locked to a FLEXid with FLOAT_

Chapter 8 - Mobile LicensingNode-Locked to a FLEXid with FLOAT_OK (Windows Only)FLEXnet Licensing End User Guide 95Returning a FLEXid with FLOAT_OK Li

Chapter 8 - Mobile LicensingLicense Borrowing with BORROW96 FLEXnet Licensing End User GuideLicense Borrowing with BORROWIf a license is to be used on

Chapter 8 - Mobile LicensingLicense Borrowing with BORROWFLEXnet Licensing End User Guide 97Setting the LM_BORROW Environment Variable DirectlyThe lmb

Chapter 8 - Mobile LicensingLicense Borrowing with BORROW98 FLEXnet Licensing End User Guideout stays checked out from the license server until the bo

Chapter 8 - Mobile LicensingNode-locked to a User NameFLEXnet Licensing End User Guide 99FLEXNET LICENSING VERSION NOTES• BORROW keyword introduced in