# How to use test_license_checkout tool

##### **Prerequisite to run the tool on an FNE server:**

FNE client SW (`v93000-fne-client-<version>` must be installed. You can run the tool without providing the path to the tool (available in the PATH variable and can be found for RHEL7 in `/usr/bin `as link and existing in `/usr/local/bin` and for RHEL9 in `/usr/bin`).

### Which test\_license\_checkout parameters exist?

There are more parameters available. Please check with option -h the available parameters. Here only some parameters are listed.

`-h` : help

`-f <featureName>` : You have to provide the feature name of the license which shall be checked out. You have to take the feature name exactly as provided in the license file.

`-t <time>` : This is the time given in seconds how long the license shall be checked out. This is useful, if you can check in parallel on the license server, if the license is checked out on the correct license server.

`-v` : for the system serial number

`-u `: device / upstream owner

`-d `: for getting debug information

#### How to checkout floating license with specified number via `test_license_checkout`?

Example for checking out a specified number of floating licenses like Digital\_E8012\_TIA:

`<strong>/opt/hp93000/soc/.service/bin/test_license_checkout -f 3 Digital_E8012_TIA -t 10</strong>`

Here 3 floating licenses of Digital\_E8012\_TIA will be tried to checkout for the duration of 10 seconds.

#### How to checkout S&amp;S licenses via `test_license_checkout`?

You need to use quotes because of the special sign &amp;:

`<strong>/opt/hp93000/soc/.service/bin/test_license_checkout -f "S&S_Tools_Package" -t 0</strong>`

#### How to checkout a license with device owner via `test_license_checkout` (only available for FNE client or on the FNE license server)?

With `fne-list-licenses` and option `--assetScale` you can check the device owner and the licenses of the asset scale bundle.

Example output:

`$ fne-list-licenses --assetScale`

**Server**: FNX-redundant dedcbfnefelic1new/dedcbfnefelic2new

\\-URL: [http://dedcbfnefelic1new.adv.advantest.com:7070/fne/bin/capability](http://dedcbfnefelic1new.adv.advantest.com:7070/fne/bin/capability)

```
 100000 x Token_ADVANTEST_RD_WaferSort/1.0 starts 2019-05-02

           Locked to DeviceOwner=ADVANTEST_RD

           Content of AssetScale bundle:

              1 x ANALOG_E9723B_MEAS_4_8/1.0

            960 x Digital_E8012_1_50Mbps/1.0

            960 x Digital_E8012_100_200Mbps/1.0

            ... 
```

Device owner in the `fne-list-licenses` is **ADVANTEST\_RD**, which means that you need to run a test program which is locked to company ADVANTEST\_RD. The token is **Token\_ADVANTEST\_RD\_WaferSort.**

For `test_license_checkout` use option `-u`:

**`-u <name>`** : Set name of upstream / device owner

Example:

`<strong>/opt/hp93000/soc/.service/bin/test_license_checkout -u ADVANTEST_RD -f Token_ADVANTEST_RD_WaferSort -t 0</strong>`

The feature with option` -f` is used with the token name.

#### How to use debug option or SOCBU\_DIAGNOSTICS with `test_license_checkout`?

If the checkout fails, please rerun the command with diagnostics enabled:

`<strong>$ SOCBU_DIAGNOSTICS=7 /opt/hp93000/soc/.service/bin/test_license_checkout -f "S&S_Tools_Package" -t 0 > /tmp/lic-error.txt</strong>`

#### How does a successful output with `test_license_checkout` look like?

`<strong>/opt/hp93000/soc/.service/bin/test_license_checkout -f "S&S_Tools_Package" -t 0</strong>`

**Output**:

```
Using FlexNetEmbedded 2021.05.0.279614 / subsystem 1.3 / built Nov  8 2021 15:34:51 (RPM)

Check out finished in 25ms for category tplf

OK    1 x S&S_Tools_Package/1.0

Sleep for 0 seconds...
```

#### How to easily check the FNE server registration with `test_license_checkout`?

With a standard installation the `test_license_checkout` tool is available on the FNE license server (primary and if existing, failover). With `fne-status`, you can check if it is installed:

`Under installed components `

<div class="imagePlugin hasCaption" data-alignment="Center" data-captiontext="fne-status showing installed components" data-contentprovider="undefined" data-encodedimage="undefined" data-height="224" data-imagenaturalheight="224" data-imagenaturalwidth="795" data-imageurl="/sites/GlobalLicensingPlatform/SiteAssets/SitePages/Tool-questions/2283351768-fne-status_installed_components.png" data-insertionisotimestamp="undefined" data-listid="e3b33fd5-515c-4c78-be61-74e77067428e" data-siteid="6c3cb63a-b6cf-434c-9a74-8949665ffc3c" data-stockmediaid="undefined" data-uniqueid="a6c83c57-20bd-4119-96d7-06ad206f8d1d" data-uploading="0" data-webid="474b6808-b6f8-4dec-8b7f-2813d573b255" data-width="795" id="bkmrk-fne-status-showing-i"><div class="i_EO-yY_y298L" id="bkmrk-fne-status-showing-i-1"><div class="i_Z9-3g_bAiCW css-152" data-automation-id="imageRead"><figure aria-label="fne-status showing installed components" class="f_Xfb4y_bAiCW p_RdMq6_bAiCW" tabindex="0"><div class="i_-JvIL_bAiCW"><div class="r_L1sJw_fgh7s c_Y4uF4_fgh7s">[![9.png](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/9-png.png)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/9-png.png)</div></div><figcaption class="c_HXzQD_bAiCW" data-automation-id="captionElement-imageRead" title="fne-status showing installed components"><span id="bkmrk-fne-status-showing-i-2">  
`fne-status` showing installed components</span></figcaption></figure></div></div></div>After registration of a new FNE license server you can easily check the license checkout of the dummy license which is available after a successful registration.

Just enter:

`<strong>test_license_checkout</strong>`

on the command line. Default feature is the dummy feature, so you do not need to enter anything.

***Example with output:***

<div class="imagePlugin hasCaption" data-alignment="Center" data-captiontext="test_license_checkout checking out the dummy license" data-contentprovider="undefined" data-encodedimage="undefined" data-height="139" data-imagenaturalheight="139" data-imagenaturalwidth="960" data-imageurl="/sites/GlobalLicensingPlatform/SiteAssets/SitePages/Tool-questions/1122402253-test_license_checkout_for_dummy_license.png" data-insertionisotimestamp="undefined" data-listid="e3b33fd5-515c-4c78-be61-74e77067428e" data-siteid="6c3cb63a-b6cf-434c-9a74-8949665ffc3c" data-stockmediaid="undefined" data-uniqueid="b57a60ec-0b4f-4492-8e98-176b171a56dd" data-uploading="0" data-webid="474b6808-b6f8-4dec-8b7f-2813d573b255" data-width="960" id="bkmrk-test_license_checkou-1"><div class="i_EO-yY_y298L" id="bkmrk-test_license_checkou-2"><div class="i_Z9-3g_bAiCW css-152" data-automation-id="imageRead"><figure aria-label="test_license_checkout checking out the dummy license" class="f_Xfb4y_bAiCW p_RdMq6_bAiCW" tabindex="0"><div class="i_-JvIL_bAiCW"><div class="r_L1sJw_fgh7s c_Y4uF4_fgh7s">[![10.webp](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/10-webp.webp)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/10-webp.webp)</div></div><figcaption class="c_HXzQD_bAiCW" data-automation-id="captionElement-imageRead" title="test_license_checkout checking out the dummy license"><span id="bkmrk-test_license_checkou-3">**`test_license_checkout`** checking out the dummy license</span></figcaption></figure></div></div></div>The dummy feature has been successfully checked out for 10 seconds (last two lines in the screenshot above).