getOrderNumbers tool

Subtopics
Running the getOrderNumbers tool
The getOrderNumbers tool provides you with a complete list of the licenses installed on your license servers. This output is one of the files required by the License Renewal Comparison Tool and helps you with the annual license renewal process.
CAUTION: Do not run the 
getOrderNumbers tool under user 
root. This can lead to longer execution times.
Note: Prerequisite: FLEXlm license server software version: ≥ 11.9.1.1.
Note: The 
getOrderNumbers tool is available for Red Hat Enterprise Linux 5 and 7. Use the version applicable to your operating system version.
You can run the 
getOrderNumbers tool either on one of your license server hosts or on any of the SmarTest clients.
Sign on to the Advantest Software Center and go to: Other Software
 > Active Tools and Files
 > Licensing
 > LicensingTools
 > getOrderNumbers
To install the tool, extract it and copy it to a host in your network, for example at 
/home/my_name/license-renewal-tools/getOrderNumbers.
Once you copied the file, make sure it is executable.
For the recommended three-license-server redundancy configuration or for multiple license servers within a network, you need to run the 
getOrderNumbers tool only once, either on one of the license server hosts or on a SmarTest client host.
If you have license servers in multiple independent networks, you must run the 
getOrderNumbers tool in each network.
Example
For example, for a three-license-server redundancy configuration, the output is one license server inventory file showing the installed licenses for all three servers:
Related information
License Renewal Comparison Tool
Running the getOrderNumbers tool
You need to run the 
getOrderNumbers tool as preparation for the annual license renewal. The tool creates a complete list of the FlexLM licenses installed on your license servers. The output is one of the files required by the License Renewal Comparison Tool.
About this task
You will run the getOrderNumbers tool either on of the FlexLM license server hosts or on a SmarTest client. The tool is supported on Red Hat Enterprise Linux 5 and 7 (RHEL 5 and RHEL 7). Use the version applicable to your operating system version..
To run the tool type:
./getOrderNumbers [-q<uiet>] [-s<ummary>]
The command options are:
-q<uiet>: Hide detailed license information and display only the detected order numbers.
-s<ummary>: Display only the summary of all license quantities and Do not split the counts per order number.
Before you begin
Make sure your license configuration either uses the default path 
/opt/flexlm/license, or you have set the LM_LICENSE_FILE environment variable. Otherwise licenses cannot be found. See chapter 3 of the Macrovision FLEXlm End Users Guide for a complete explanation of how to use this environment variable to establish a multiple server network.
Procedure
Open a terminal window and change to the directory where you installed the 
getOrderNumbers tool.
Type, for example
$ > ./getOrderNumbers >
license-inventory-server01.txt.
This saves the output to the 
license-inventory-server01.txt file. The Comparison Tool expects a file with a .txt file name extension.
Copy the license inventory file to the directory where you collect the files for the comparison process, for example
 
verigy-license-renewal-2009. (See also Managing files to compare).
Results
The created output file is the license inventory file required for the license renewal comparison process. The file lists all license servers that were checked, provides a table with all FlexLM licenses installed in your license environment, plus a summary of the detected renewable order numbers at the bottom.
Example
What to do next
The created license inventory file is required for the license renewal comparison process. For details see How to execute a comparison.