# Installing the FNE license client

<kbd class="userinput"></kbd>Installing a FlexNet Embedded license client used to provide the activated licenses to a SmarTest installation on a system controller workstation requires two steps: the installation of the license client software itself on the SmarTest host system, and configuration of the license server configuration file to prioritized the order of server access.

<main id="bkmrk-about-this-task-inst" role="main"><article aria-labelledby="ariaid-title1" role="article"><div><section class="section">### About this task

Installing the FNE license client (installed as default license client) also installs the FNE Server Viewer. For more details, see [Monitoring license servers using the FNE Server Viewer](https://lhc.advantest.com/books/flexnet-embedded-licensing/page/monitoring-license-servers-using-the-fne-server-viewer "The FNE Server Viewer is a web-based application that can be used to monitor Advantest license servers.").

The following procedure explains how to install the FlexNet client.

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

The license client is the SmarTest software. The FlexNet license server communicates with SmarTest using the FNE client.

The license client install package can be downloaded from the FNE section of the Advantest Software Center:

[https://softwarecenter.advantest.com/download/othersw/builds/licensing](https://softwarecenter.advantest.com/download/othersw/builds/licensing)

The following procedure is applicable to installation, upgrades and updates.

</section></div></article></main><p class="callout info">Note: During upgrading and updating, the installation script can be called without any option. All installed packages are detected automatically and updated if applicable.  
<kbd class="userinput"> <kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">sudo sh install-fne-<var class="varname">date</var>-<var class="varname">version</var>.sh</kbd></kbd>`</span></kbd></kbd></p>

<main id="bkmrk-port-7070-must-be-op" role="main"><article aria-labelledby="ariaid-title1" role="article"><div><section>**Port 7070** must be open to the customer FNE license server and if needed to the cloud license server.

To check connection to your license servers, use the command:

If you are using the Advantest cloud license servers, check the connections by opening the following URLs:

- <kbd class="userinput"><span style="text-decoration: underline;">http://&lt;license-server&gt;:7070/ping</span>  
      
    </kbd>
- <kbd class="userinput"><span style="text-decoration: underline;">https://&lt;Device Owner FNE license server&gt;.advantest.cloud:7070/ping</span>  
      
    </kbd>
- <span style="text-decoration: underline;"><kbd class="userinput">https://&lt;Device Owner FNE license server&gt;-fo.advantest.cloud:7070/ping</kbd></span>

If port 7070 is open, the following type of output is displayed:

[![44.png](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/jtO44-png.png)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/jtO44-png.png)  
</section><section>### **Procedure**

1. Open the Advantest Software Center in a browser: [https://softwarecenter.advantest.com/](https://softwarecenter.advantest.com/)  
      
    Login with your credentials.
2. To get the list of all available Licensing products, from the left menu select: **<span class="menucascade"><span class="uicontrol">Other</span><abbr title="and then"> &gt; </abbr><span class="uicontrol">Licensing  
      
    </span></span>**[![55.png](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/9IE55-png.png)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/9IE55-png.png)
3. Scroll to and select the license type FNE and the version you want to install and expand to display the details.
4. <span id="bkmrk-create-an-empty-inst">Create an empty installation directory. For example:<kbd class="userinput"> <kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/tmp/smartest_pakages</kbd></kbd></kbd>`</span></kbd></kbd>  
      
    </kbd></span>
5. Download the archive package by clicking the [![9.png](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/WoC9-png.png)](https://lhc.advantest.com/uploads/images/gallery/2025-10/scaled-1680-/WoC9-png.png) icon.   
    The selected license (<span class="filepath"><span id="bkmrk-tar.gz"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">tar.gz</kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span>) package is downloaded to your browser's download folder.
    
    Example FNE packages include:
    
    <span class="filepath"><span id="bkmrk-fne_2024.01.0.0-2404"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">fne_2024.01.0.0-24043_rhel9.tar.gz</kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span></span>
6. Move the downloaded archive packages to the installation directory: <span id="bkmrk-%2Ftmp%2Fsmartest_pakage"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/tmp/smartest_pakages</kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span>
7. Unpack the archive with the command:  
    <span id="bkmrk-tar-xvzf-package-nam"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">tar xvzf <var class="varname">package-name</var>.tar.gz</kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span>  
    For example:  
    **<span id="bkmrk-tar-xvzf-fne_2024.01"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">tar xvzf <kbd class="userinput">fne_2024.01.0.0-24043_rhel9.tar.gz</kbd></kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span>**
    
    <div>  
    </div>**The installation script is extracted**, for example:
    
    <span class="filepath">**<span id="bkmrk-install-fne-2024.01."><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">install-fne-2024.01.0.0-24043-rhel9.sh</kbd></kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span>**</span>
8. Check the downloaded archive package for integrity:  
      
    <kbd class="userinput"><span id="bkmrk-bash-install-fne-dat"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">bash install-fne-<var class="varname">date</var>-<var class="varname">version</var>.sh test</kbd></kbd></kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span></kbd>
9. Shut down the **SmarTest Work Center**.  
    For details see [Shutting down SmarTest](https://tdc.advantest.com/help/topic/com.verigy.itee.help.smartest.ui.8.7.6/248729.htm "This task describes the procedure of shutting down SmarTest.").
10. Install the client package: <kbd class="userinput"><kbd class="userinput"><span id="bkmrk-sudo-sh-install-fne-"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">sudo sh install-fne-<var class="varname">date</var>-<var class="varname">version</var>.sh client</kbd></kbd></kbd></kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span></kbd></kbd>
    
    For example:  
    <kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span id="bkmrk-sudo-sh-install-fne--1"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">sudo sh install-fne-2024.01.0.0-24043-rhel9.sh client</kbd></kbd></kbd></kbd></kbd></kbd></kbd>`  
    </span></kbd></kbd></kbd></span></kbd></kbd></kbd>
    
    <p class="callout info"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span id="bkmrk-note%3A-during-upgradi"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">Note: During upgrading and updating, the installation script can be called without any option. All installed packages are detected automatically and updated if applicable.  
    </span></kbd></kbd></kbd></span></kbd></kbd></kbd></p>
    
    <div><div class="note">  
    </div></div>
11. **Optional:**  <span id="bkmrk-remove-the-installat">Remove the installation directory. For example:  
      
    </span><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span id="bkmrk-rm--rf-%2Ftmp%2Fsmartest"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">rm -rf /tmp/smartest_packages</kbd> </kbd></kbd></kbd></kbd></kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span></kbd></kbd></kbd></kbd>
12. After the installation has completed, configure the license server configuration file where the list of FlexNet Embedded license servers are listed in a prioritized order.  
      
    Open the **configuration file** in an editor: **<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span id="bkmrk-%2Fetc%2Ffne%2Fclient.conf"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/etc/fne/client.conf</kbd></kbd></kbd></kbd></kbd></kbd></kbd></kbd></kbd>`  
      
    </span></kbd></kbd></kbd></span></kbd></kbd></kbd></kbd></kbd>**
    
    Syntax of the **<kbd class="userinput">client.conf</kbd>** file:
    
    <div>
    - **Local license server**
        
         ```
        #Configuration of FNE servers to be used
        # primary FNE server
        server
        {
        name = "FNE on localhost"
        url = "localhost"
        }
        ```
    - **Remote license server**
        
        ```
        #Configuration of FNE servers to be used
        # primary FNE server
        server
        {
        name = "FNE central server"
        url = "hostNameLicenseServer.domain"
        }
        #secondary FNE server
        server
        {
        name = "FNE remote server"
        url = "socbu158.advantest.com"
        }
        ```
    
    ---
    
    <div class="p">Keywords for the **<kbd class="userinput">client.conf</kbd>** file:  
      
    <dl><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**include**</span></dt><dd>Used to include another configuration file. <kbd class="userinput">**include**</kbd> can be used multiple times in a file.
    
    </dd><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**server { }**</span></dt><dd>Used to specify a server description with brackets enclosing each description. <kbd class="userinput">**server { }**</kbd> can be used multiple times in a file.
    
    </dd><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**name**</span></dt><dd>Free text used to add a description for a server.  
      
    </dd><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**selector**</span></dt><dd>The client must comply with all listed selector conditions before the client can attempt to contact the server.  
    <kbd class="userinput">**selector**</kbd> can be used multiple times in a file.
    
    </dd><dt class="dlterm">**<span style="color: rgb(126, 140, 141);">url/primaryUrl</span>**</dt><dd>**<kbd class="userinput">url</kbd>** used to address for the server if only one server is configured. Use **<kbd class="userinput">primaryUrl</kbd>** instead for the primary server when more than one server is configured.  
      
    </dd><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**failoverUrl**</span></dt><dd>Used to address the failover servers.  
      
    </dd><dt class="dlterm"><span style="color: rgb(126, 140, 141);">**mute**</span></dt><dd>Used to suppresses connection-related error messages for the corresponding server.
    
    Other error messages are displayed.
    
    Some FNE servers listed in **<span class="filepath">client.conf</span>** files may be unavailable by intent, for example, emergency servers or temporary servers. If these servers are not running or disconnected, associated error messages are normally displayed at each checkout request, which can be unhelpful if it is an expected situation.
    
    </dd></dl></div></div><p class="callout info"><span class="title">Note:</span> The <span class="keyword">mute</span> keyword is not supported by older FNE subsystems and is ignored if specified. For FNE subsystem versions that do not support the <span class="keyword">mute</span> keyword, a syntax warning might be displayed and can be ignored.</p>
    
    <div><div class="p"><dl><dd><div class="note">  
    </div></dd></dl></div></div>
13. Enter the names and URLs for all FlexNet Embedded license servers that you want to use in their order of priority.
14. To verify the installation and license server configuration enter the command:  
    <kbd class="userinput"><span id="bkmrk-%2Fusr%2Flocal%2Fbin%2Ffne-l"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><strong>/usr/local/bin/fne-list-licenses</strong></kbd></kbd></kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></kbd>  
    The tool iterates through the FlexNet Embedded servers defined in <kbd class="userinput"><span id="bkmrk-%2Fetc%2Ffne%2Fclient.conf-1"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">**`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/<span class="filepath">etc/fne/client.conf</span></kbd></kbd></kbd></kbd></kbd></kbd>`** </span></kbd></kbd></kbd></span></kbd>and lists all licenses (used and available).
    
    It also provides detailed information about the available licenses including:
    
    <div>
    - Content of the AssetScale tokens
    - Locking of licenses
    - Expiry information
    
    </div><p class="callout info"><span class="title">Note:</span> The <kbd class="userinput">fne-list-licenses</kbd> tool does not show details from cloud license servers.  
    </p>
    
      
    For details, see [fne-list-licenses](https://lhc.advantest.com/books/flexnet-embedded-licensing/page/advantest-flexnet-embedded-license-client-tools).

</section><section class="section">### **Results**

You have installed the license client software and configured the list of FlexNet Embedded license servers in a prioritized order.

The order in which clients attempt to check out licenses is the same order in which the licenses are referenced in the **<span class="filepath">client.conf</span>** file.

</section></div>### **Example**

<div><section>#### Example of a client.conf file:

<div>  
</div> ```
#Configuration of FNE servers to be used
# Emergency Server
include "/etc/fne/emergency.conf"
server
{
    name = "Local cloud space"
    url = "localcloud.company.com"
}
server
{
   name = "My cloud"
   selector = "DeviceOwner:MyCompany"
   url = "https://MyCompany.advantest.cloud:7070"
}
server
{
    name = "Local license server"
    primaryUrl = "fne1.company.com"
    failoverUrl = "fne2.company.com"
}
```

Minimum client.conf file configuration:

```
server
{
url = "localhost"
}
```

  
</section></div></article></main><footer id="bkmrk-" role="contentinfo"><div class="fo"><div class="-share"><div class="-sharem">  
</div><div class="-shared" style="display: none;">  
</div></div></div></footer>