# getOrderNumbers tool

<nav id="bkmrk-subtopics-running-th" role="navigation">#### Subtopics

<div id="bkmrk-running-the-getorder">1. [Running the getOrderNumbers tool](https://lhc.advantest.com/link/106#bkmrk-running-the-getorder-1 "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.")

</div></nav>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.

<p class="callout warning"><span class="title">CAUTION: Do not run the `<span class="keyword">getOrderNumbers</span>` tool under user `<span class="keyword">root</span>`. This can lead to longer execution times.</span></p>

<p class="callout info"><span class="title">Note: Prerequisite: FLEXlm license server software version: ≥ 11.9.1.1.</span></p>

<p class="callout info"><span class="title">Note: The `<span class="keyword">getOrderNumbers</span>` tool is available for Red Hat Enterprise Linux 5 and 7. Use the version applicable to your operating system version.</span></p>

<div id="bkmrk-you-can-run-the%C2%A0geto"><div class="p">You can run the `<span class="keyword">getOrderNumbers</span>` tool either on one of your license server hosts or on any of the SmarTest clients. <dl><dt class="dlterm">##### **Download the getOrderNumbers tool**

</dt><dd>Sign on to the Advantest Software Center and go to: **<span class="menucascade"><span class="uicontrol">Other Software</span><abbr title="and then"> &gt; </abbr><span class="uicontrol">Active Tools and Files</span><abbr title="and then"> &gt; </abbr><span class="uicontrol">Licensing</span><abbr title="and then"> &gt; </abbr><span class="uicontrol">LicensingTools</span><abbr title="and then"> &gt; </abbr><span class="uicontrol">getOrderNumbers</span></span>**

</dd><dt class="dlterm">##### Installation

</dt><dd>To install the tool, extract it and copy it to a host in your network, for example at `<span class="filepath">/home/my_name/license-renewal-tools/getOrderNumbers</span>.`

Once you copied the file, make sure it is executable.

</dd><dt class="dlterm">##### Execution

</dt><dd>For the recommended three-license-server redundancy configuration or for multiple license servers within a network, you need to run the `<span class="keyword">getOrderNumbers</span>` 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 `<span class="keyword">getOrderNumbers</span>` tool in each network.

</dd></dl></div><section class="section">### 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: <div class="p"><figure class="fignone">[![15.gif](https://lhc.advantest.com/uploads/images/gallery/2025-10/15-gif.gif)](https://lhc.advantest.com/uploads/images/gallery/2025-10/15-gif.gif)</figure></div></section></div><nav id="bkmrk-related-information-" role="navigation">### Related information

<div class="ri"><div>[License Renewal Comparison Tool](https://lhc.advantest.com/books/fnp-license-renewal/chapter/license-renewal-comparison-tool "The License Renewal Comparison Tool supports you in the annual license renewal process.")</div>---

</div># 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.

<div class="ri"><section class="section">### 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.

</section><section>### Before you begin

Make sure your license configuration either uses the default path <kbd class="userinput">`/opt/flexlm/license`,</kbd> 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.

</section><section>### Procedure

1. Open a terminal window and change to the directory where you installed the `getOrderNumbers` tool.
2. Type, for example `$ > ./getOrderNumbers >`<kbd class="userinput">license-inventory-server01.txt.</kbd>
    
    This saves the output to the <kbd class="userinput">license-inventory-server01.txt</kbd> file. The Comparison Tool expects a file with a .txt file name extension.
3. Copy the license inventory file to the directory where you collect the files for the comparison process, for example**` <kbd class="userinput">verigy-license-renewal-2009</kbd>`**. (See also [Managing files to compare](https://lhc.advantest.com/books/fnp-license-renewal/page/managing-files-to-compare "The License Renewal Comparison Tool requires the following input files:")).

</section><section class="section">### 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.

</section><section>### Example

<div class="p"><figure class="fignone">[![16.png](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/16-png.png)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/16-png.png)</figure></div></section><section class="section">### 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](https://lhc.advantest.com/books/fnp-license-renewal/page/executing-a-comparison "The License Renewal Comparison Tool helps you to make any licensing discrepancies visible by comparing the license status of your license servers against the status of the Advantest License Renewal Portal.").

</section></div></nav>