Borrowing licenses
This section describes how to borrow a license from the License Server for offline use.
The ability to borrow licenses is available to any of the Users configured in the FlexLM Options file. Licenses can be checked out for offline use for a specified number of days using the LMBORROW command. This will allow Users to "check-out" the license from the license server, then disconnect the machine from the network, for up to six days - without the need to connect back to the license server.
To borrow a license:
- Run lmborrow.exe (the FlexLM lmborrow utility (lmborrow.zip) - see the BMC Communities site for further details) from the machine where AppSight System or AppSight Code are installed to specify the duration of time for which the license should be borrowed.
lmborrow IDENTIFY dd-Mmm-yyyy
The parameters in the following example will configure the borrow duration for October 29, 2009:
lmborrow IDENTIFY 29-Oct-2009
Note that the duration can be set for up to 6 days and will automatically expire at the end of the sixth day (29-Oct-2009 23:59). The duration can actually be set to exactly 7 days, but this requires the precision of hour and minute (instead of the default which is "23:59"):
lmborrow IDENTIFY 29-Oct-2009 18:20 Start the AppSight components for which the license is needed.
The lmborrow command only configures the borrow duration; the licensed FEATURES are not borrowed until the next time the FEATURES are accessed.
Note that the AppSight System (ApsSysApp, ApsSysApp_2) and AppSight Code (ApsCodeApp, ApsCodeApp_2) Consoles must be opened separately. An active Black Box should be connected, or a Black Box log file should be opened, in order to analyze log files (ApsSupport).
AppSight Component: Required FEATURES
AppSight System Console: ApsSysApp, ApsSysApp_2, ApsSupport
AppSight Code Console: ApsCodeApp, ApsCodeApp_2, ApsSupport
The lmborrow command can also be used to verify which FEATURES are borrowed, as shown below.
C:\>lmborrow -status
lmborrow - Copyright (c) 1989-2003 by Macrovision Corporation. All rights reserved.
Vendor Feature Expiration
identify ApsSite 29-Oct-2009 23:59
identify ApsSysApp 29-Oct-2009 23:59
identify ApsSysApp_2 29-Oct-2009 23:59
identify ApsSupport 29-Oct-2009 23:59
Borrowed licenses can also be returned early using the lmborrow command:
lmborrow -return -c FLEXLM_PORT@FLEXLM_SERVER FEATURE
The FLEXLM_PORT is the HTTP port of the FlexLM License Server; the default is "27000". The FLEXLM_SERVER is the Hostname or IP Address of the FlexLM License Server. The FEATURE is the currently borrowed FEATURE to be returned early. For example:
lmborrow -return -c 27000@ApsLicenseXP ApsSite
lmborrow -return -c 27000@ApsLicenseXP ApsSysApp
lmborrow -return -c 27000@ApsLicenseXP ApsSysApp_2
lmborrow -return -c 27000@ApsLicenseXP ApsSupport