Contents

## FLEXlm
End Users Guide

### Version 9.2
July 2003

> > Copyright

> > Copyright 2003 Macrovision Corporation. All rights reserved.

> > Macrovision products contain certain confidential information of Macrovision Corporation. Use of this copyright notice is precautionary and does not imply publication or disclosure. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form by any means without the written permission of Macrovision Corporation.

> > Trademarks

> > Globetrotter, Macrovision, FLEXbill, Flexible License Manager, FLEXlm, FLEXlock, and GTlicensing are registered trademarks or trademarks of Macrovision Corporation. All other brand and product names mentioned herein are the trademarks and registered trademarks of their respective owners.

> > Restricted Rights Legend

> > Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights of Technical Data and Computer Software clause of DFARS 252.227-0713 and FAR52.227-19 and/or applicable Federal Acquisition Regulation protecting the commercial ownership rights of independently developed commercial software.

> > Printed in the USA.

> > July 2003

> > ## Table of
> > Contents

> > ## Preface

> > ## Chapter 1 Introduction and Overview

> > 1.1 Introduction to FLEXlm

> > 1.2 How to Use This Manual

> > 1.2.1 License Administrator

> > 1.2.2 End User

> > 1.3 FLEXlm Components

> > 1.3.1 Served Licenses

> > 1.3.2 Unserved Licenses

> > 1.3.3 Component Overview

> > 1.3.4 FLEXlm Components Shipped by Your Vendor

> > 1.4 The License Request Process

> > 1.5 Configuring FLEXlm

> > 1.6 Getting Started Checklist

> > 1.6.1 Installing Licensed Software

> > 1.6.2 Notes for End Users

> > ## Chapter 2 License File Basics

> > 2.1 Specifying Location of the License File

> > 2.1.1 Setting the Path with an Environment Variable

> > 2.2 License File Format Overview

> > 2.3 Types of License Files

> > 2.3.1 Floating (Concurrent) Licenses

> > 2.3.2 Node-Locked Licenses

> > 2.3.3 Mixed Node-Locked and Floating Licenses

> > ## Chapter 3 Managing Licenses from Multiple Vendors

> > 3.1 Overview of Multiple License Management Strategies

> > 3.2 Multiple Machines

> > 3.3 One Machine with Multiple License Servers

> > 3.4 One Machine with One License Server and Multiple License Files

> > 3.5 Managing Multiple License Files

> > 3.6 Additional Considerations

> > 3.6.1 Combining license files

> > 3.6.2 Version Component Compatibility

> > ## Chapter 4 Selecting Server Machines

> > 4.1 Resources Used by the Server

> > 4.1.1 Sockets

> > 4.1.2 CPU Time

> > 4.1.3 Disk Space

> > 4.1.4 Memory

> > 4.1.5 Network Bandwidth

> > 4.2 Remote Mounted Disks

> > 4.3 Redundant License Servers

> > 4.3.1 Redundancy via License-File List

> > 4.3.2 Three-Server Redundancy

> > 4.3.3 Comparing Three-Server to License-File List

> > 4.4 Counted vs. Uncounted Licenses

> > ## Chapter 5 The Options File

> > 5.1 Creating an Options File

> > 5.2 Options File Syntax

> > 5.2.1 BORROW_LOWWATER

> > 5.2.2 DEBUGLOG

> > 5.2.3 EXCLUDE

> > 5.2.4 EXCLUDE_BORROW

> > 5.2.5 EXCLUDEALL

> > 5.2.6 GROUP

> > 5.2.7 GROUPCASEINSENSITIVE

> > 5.2.8 HOST_GROUP

> > 5.2.9 INCLUDE

> > 5.2.10 INCLUDE_BORROW

> > 5.2.11 INCLUDEALL

> > 5.2.12 LINGER

> > 5.2.13 MAX

> > 5.2.14 MAX_BORROW_HOURS

> > 5.2.15 MAX_OVERDRAFT

> > 5.2.16 NOLOG

> > 5.2.17 REPORTLOG

> > 5.2.18 RESERVE

> > 5.2.19 TIMEOUT

> > 5.2.20 TIMEOUTALL

> > 5.3 How the Vendor Daemon Uses the Options File

> > 5.4 Rules of Precedence in Options Files

> > 5.5 Options File Examples

> > 5.5.1 Simple Options File Example

> > 5.5.2 Limiting Access for Multiple Users

> > 5.5.3 EXCLUDE Example

> > 5.5.4 INCLUDE Example

> > ## Chapter 6 The License Manager Daemon

> > 6.1 lmgrd Command-Line Syntax

> > 6.2 Starting the License Manager Daemon on UNIX Platforms

> > 6.2.1 Manually

> > 6.2.2 Automatically

> > 6.3 Starting the License Manager Daemon on Windows

> > 6.3.1 Manually from the Command Line

> > 6.3.2 Configuring the License Manager as a Windows Service

> > 6.3.3 Manually from LMTOOLS

> > 6.3.4 Automatically at System Start Up

> > ## Chapter 7 License Administration Tools

> > 7.1 Running Administration Tools

> > 7.2 Universal lmutil Arguments

> > 7.3 lmborrow

> > 7.4 lmdiag

> > 7.5 lmdown

> > 7.6 lmhostid

> > 7.7 lminstall

> > 7.8 lmnewlog

> > 7.9 lmpath

> > 7.10 lmremove

> > 7.11 lmreread

> > 7.12 lmstat

> > 7.13 lmswitch

> > 7.14 lmswitchr

> > 7.15 lmver

> > 7.16 License Administration Tools—LMTOOLS for Windows

> > 7.16.1 Configuration Using License File

> > 7.16.2 Configuration Using Services

> > ## Chapter 8 Mobile Licensing

> > 8.1 Node-Locked to a Laptop Computer

> > 8.2 Node-locked to a FLEXid (Windows Only)

> > 8.3 Node-Locked to a FLEXid with FLOAT_OK (Windows Only)

> > 8.3.1 Initiating FLEXid with FLOAT_OK

> > 8.3.2 Returning a FLEXid with FLOAT_OK License

> > 8.3.3 FLEXid with FLOAT_OK Example

> > 8.4 License Borrowing with BORROW

> > 8.4.1 Initiating License Borrowing

> > 8.4.2 Borrowing a License

> > 8.4.3 Support for License Borrowing

> > 8.5 Node-locked to a User Name

> > 8.6 Fulfilled from a Prepaid License Pool

> > ## Appendix A Hostids for FLEXlm-Supported Machines

> > A.1 Hostid Formats

> > A.2 Expected FLEXlm Hostids

> > A.3 Special FLEXlm Hostids

> > ## Appendix B License File Format

> > B.1 License File Syntax

> > B.1.1 Sample License File

> > B.1.2 SERVER Lines

> > B.1.3 VENDOR Lines

> > B.1.4 USE_SERVER Line

> > B.1.5 FEATURE/INCREMENT Lines

> > B.1.6 PACKAGE Lines

> > B.1.7 UPGRADE Lines

> > B.2 Decimal Format

> > B.3 License File Order

> > ## Appendix C Troubleshooting Guide

> > C.1 General Troubleshooting Hints

> > C.2 FLEXLM_DIAGNOSTICS

> > C.2.1 Level 1 Content

> > C.2.2 Level 2 Content

> > C.2.3 Level 3 Content (FLEXlm v6.0+ only)

> > ## Appendix D FLEXlm Environment Variables

> > D.1 How to Set Environment Variables

> > D.1.1 Registry

> > D.1.2 Precedence

> > D.2 Environment Variables

> > ## Appendix E FLEXlm Error Codes

> > E.1 Error Message Format

> > E.1.1 Format 1 (short):

> > E.1.2 Format 2 (long—version 6.0+):

> > E.2 Error Code Descriptions

> > ## Appendix F The Report Log File

> > F.1 Managing Report Log Output

> > F.2 Enabling Report Log Output for a Vendor Daemon

> > F.3 Redirecting Report Log Output for a Vendor Daemon

> > ## Appendix G The Debug Log File

> > G.1 Managing Debug Log Output

> > G.1.1 Capturing Debug Log Output for a License Server

> > G.1.2 Capturing Debug Log Output for a Particular Vendor Daemon

> > G.1.3 Redirecting Debug Log Output for a Running Vendor Daemon

> > G.1.4 Limiting Debug Log Output for a Vendor Daemon

> > G.2 Debug Log Messages

> > G.2.1 Informational Messages

> > G.2.2 Configuration Problem Messages

> > G.2.3 Daemon Software Error Messages

> > ## Appendix H FLEXlm Versions

> > H.1 Version Compatibility and Components

> > H.2 How to Tell the License File Version

> > H.3 Version Summary

> > ## Index

> FLEXlm End Users Guide
> July 2003