# Advantest FlexNet Embedded license client tools Advantest FlexNet Embedded (FNE) license client tools are used to manage license clients, including testing license checkouts from a license server and listing all checked out licenses.
### **Advantest FlexNet Embedded license client tools usage** The following table lists the available Advantest FlexNet Embedded (FNE) license client tools and their usage:
**Advantest FlexNet Embedded license client tools**
**Option****Description**
**test\_license\_checkout**Tests the license checkout from a license server.
Location:/opt/hp93000/soc64\_<version>/.service/bin/
Examples:**test\_license\_checkout -t 60 -f SmarTest\_SOC**
Syntax:test\_license\_checkout -t <time in sec.> -f <feature name>
**fne-show-license-usage**Iterates through the FlexNet Embedded servers defined in /etc/fne/client.conf and lists all checked out licenses.
Location:/usr/local/bin (If the FNE client package is installed)
Options:-a\[ll\], -h\[elp\] and -v\[ersion\]
Usage:-a - Shows all clients managed by the servers (default: Only clients on the local machine). -h - Shows the help information. -v - Displays the version of the fne-show-license-usage tool.
**fne-list-licenses**Iterates through the FlexNet Embedded servers defined in /etc/fne/client.conf and lists all licenses (used and available). Provides detailed information about the available licenses including:
- Content of the AssetScale tokens - Locking of licenses - Expiry information
Location:/usr/local/bin (If the FNE client package is installed)
Options:<no option>, --feature, --expires, --assetScale, and -h\[elp\]
Usage for general options:No option: Lists licenses provided by all servers. --feature=<xyz> - Lists only licenses of the specified feature. --expires\[=<n>\] - Lists only licenses expiring in the next n days. Default for n: 30. --assetScale - Lists the AssetScale tokens and shows their content. --v\[ersion\] - Displays the tool version information.
Usage for tabular output options:

Note: **Options are processed in the order that they are stated.** Use --sep and --notitle before --csv.

--sep\[arator\]=<d> - Defines column separator for csv output: Defaults to ",".
--notitle - Omits title line in csv output (for scripting). --listtokens - Shows all currently available tokens for csv output.

Note: At least one license must be borrowed to show complete list.

--match=<list of filters> - Filter shown borrow records. --csv=<list of tokens> - Show licenses borrowed in csv format.

Note: There is always one line per feature.

**fne-clear-SmarTest-licenses.sh** Clears orphaned licenses from crashed SmarTest sessions on FNE servers. (Available from FNE **2024.10**). Installed as part of the FNE client package. Executed on the system controller (FNE license client workstation).
Location: /usr/local/ (If the FNE client package is installed)
Options:<no option>, --v\[ersion\],--h\[elp\]
Usage:No option: Clears licenses. --v\[ersion\] - Displays the tool version information. --h\[elp\] - Prints the help information.
### **Example** #### Usage examples for the fne-list-licenses tool List licenses **provided by all servers:** ``` $ fne-list-licenses Server: Feature Server (redundant) \-URL: http://fne1.domain.com:7070/fne/bin/capability -SEL: DEVICEOWNER:UPSTREAM 100000 x Digital_E803x_E8070_16_32MB/1.0 100000 x Digital_E803x_E8070_32_64MB/1.0 100000 x Digital_E803x_E8070_64_112MB/1.0 ... ```
List all licenses **expiring in the next 28 days** (request date 30.04.2018). ``` $ fne-list-licenses --expires=28 Server: Feature Server (redundant) \-URL: http://fne1.domain.com:7070/fne/bin/capability -SEL: DEVICEOWNER:UPSTREAM 100000 x Digital_E803x_E8070_16_32MB/1.0 expires 2018-05-28 ... ``` List licenses of **all features including the string** **Company**: ``` $ fne-list-licenses --feature=Company_ Server: Feature Server (redundant) \-URL: http://fneserver.domain.com:7070/fne/bin/capability 1000 x Company_Details/1.0 Company=COMPANY_NAME ``` List **AssetScale tokens** and show their content: ``` $ fne-list-licenses --assetScale Server: Feature Server (redundant) \-URL: http://fneserver.domain.com:7070/fne/bin/capability 123 x Token_OWNER_BRAND_PremiumTier/1.0 Locked to DeviceOwner=OWNER_BRAND Content of AssetScale bundle: 1 x ANALOG_E9723B_MEAS_4_8/1.0 ... ``` **Show usage** of a specific **feature**: ``` $ fne-list-licenses ---notitle -m featureName=Digital_E803x_E8070_16_32MB -csv featureCount,used,featureName 100000,10,Digital_E803x_E8070_16_32MB ``` Show **all licenses** locked to a **DeviceOwner**: ``` $ fne-list-licenses --match selectorsDictionary.DeviceOwner=UPSTREAM -csv server.name,featureName server.name,featureName Feature Server (redundant),Token_UPSTREAM_PremiumTier ``` **Clear the licenses currently in use** on the client: ``` $ fne-clear-SmarTest-licenses.sh Clearing borrowed licenses for device id 6451063D7784.starter_2tplf ``` Returns a **message describing the devices** for which the licenses are being cleared: ``` Clearing borrowed licenses for device id 6451063D7784.starter_2tplf ```