# Troubleshooting FlexNet Embedded licensing

<section class="section" id="bkmrk-supported-web-browse">### Supported web browsers

The Licensing Portal is supported on the following web browsers:

- Google Chrome
- Mozilla Firefox

<p class="callout info"><span class="title">Note: Microsoft Internet Explorer is not supported.</span></p>

</section><section class="section" id="bkmrk-flexnet-log-files-fn">### **FlexNet log files**

FNE license server **log file directory**:

<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">/var/opt/flexnetls/socbu/logs</kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span>

**Installation** log file:

<span class="filepath"><span id="bkmrk-%2Ftmp%2Finstall-fne-dat"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/tmp/install-fne-<var class="varname">date and version information</var>.sh.root.log</kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span>

</section><section class="section" id="bkmrk-fne-server-does-not-">### **FNE server does not start**

<span style="text-decoration: underline;">**The FNE server is installed but cannot be started.**</span>

The following error is displayed in the log file:

<span class="filepath"><span id="bkmrk-%2Fvar%2Fopt%2Fflexnetls%2Fs"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">/var/opt/flexnetls/socbu/logs/flexnetls.log</kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span>

```
00:02:49,408 advantest-fne-server start
...
00:03:02,575 ERROR main Native code loading error
java.lang.UnsatisfiedLinkError: /tmp/llsnc-2019.07.1.0-256892-amd64-libconnector.so3
(/tmp/llsnc-2019.07.1.0-256892-amd64-libconnector.so4:
failed to map segment from shared object: Operation not permitted)
...
```

The server attempts to use or execute a shared library located in the **<span class="filepath">/tmp</span>** directory, but execute permissions for executables located in <span class="filepath">/**tmp**</span> is has not been granted by the noexec option in the mount flags.

Check the **<span class="filepath">/etc/fstab</span>** entry and it should include the <span class="keyword">noexec</span> option:

```
/dev/mapper/vg00-tmp tmp ext4
defaults,nodev,nosuid,noexec 1 2
```

<div class="p"><div><span style="text-decoration: underline;">**To correct this situation**</span>, ask your IT department to remount the **<span class="filepath">/tmp</span>** directory without the **<span class="keyword">noexec</span>** option on all affected FNE license servers.</div></div></section><section class="section" id="bkmrk-check-license-on-lic">### **Check license on license server**

For checking licenses on a license server, us the FNE Server Viewer. For 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.").

To verify the installation and license server configuration enter the command:

<kbd class="userinput"><span class="filepath"><span id="bkmrk-fne-list-licenses"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><kbd class="userinput">fne-list-licenses</kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span></kbd>

The tool iterates through the FlexNet Embedded servers defined in **<span class="filepath">/etc/fne/client.conf</span>** and lists all licenses (used and available).

It also provides detailed information about the available licenses including:

- Content of the AssetScale tokens
- Locking of licenses
- Expiry information

</section><p class="callout info"><span class="title">Note: The **<span class="keyword">fne-list-licenses</span>** tool does not show details from cloud license servers.</span></p>

<section class="section" id="bkmrk-check-for-installed-">### **Check for installed version of the FNE software**

To check the version of the installed FNE software:

<kbd class="userinput"><kbd class="userinput"><span class="filepath"><span id="bkmrk-yum-info-advantest-f"><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">yum info advantest-fne-server</kbd></kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span></kbd></kbd>

Output example:

```
Loaded plugins: langpacks, search-disabled-repos
Installed Packages
Name : advantest-fne-server
Arch : x86_64
Version : 2024.02.0.0
Release : 17055.el9
Size : 75 M
Repo : installed
From repo : /advantest-fne-server-2024.02.0.0-17055.el9.x86_64
Summary : FlexNet Embedded Server 2024.02.0.0 for socbu
License : Advantest Corporation, 2024
Description : This rpm package provides complete installation of the FlexNet
Embedded server version 2024.02.0.0 and startup/shutdown scripts.
:
: Original packages: flexnetls-x64_linux-2024.02.0.tar.gz
Golden_socbu_IdentityClientServerMVEL_ENUM.bin
```

### **Command line tool for server administrators**

</section><section class="section" id="bkmrk-command-line-tool-fo">The following commands are available for FNE license server administrators, located in the directory:

<kbd class="userinput"><kbd class="userinput"><kbd class="userinput"><span class="filepath"><span id="bkmrk-%2Fopt%2Fflexnetls%2Fsocbu"><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">/opt/flexnetls/socbu</kbd></kbd></kbd></kbd></kbd></kbd>`</span></kbd></kbd></kbd></span></span></kbd></kbd></kbd>

<div class="p"><dl><dt class="dlterm"><span style="background-color: rgb(206, 212, 217);">**showconfig-fne-server \[options\]**</span></dt><dd> Displays the configuration of the server.  -v option provides more details.

</dd><dt class="dlterm">**<span style="background-color: rgb(206, 212, 217);">reset-fne-server \[options\]</span>**</dt><dd> Removes the FNE license database from your system.</dd></dl></div></section><div class="warning" id="bkmrk-"></div><p class="callout warning"><span class="title">Warning: There is no local backup from which to recover deleted data.</span></p>

<div class="warning" id="bkmrk--1"></div><section class="section" id="bkmrk-warning%C2%A0there-is-no-"><div class="p"><dl><dd><div class="warning">To repopulate the FNE license server database with licenses, resynchronize with the Advantest back office.</div><dl><dd>Options:

<kbd class="userinput">-force</kbd> - Forces a full reset.

<kbd class="userinput">-help</kbd> - Displays the help information.

</dd></dl><p class="callout info"> <span class="title">Note:</span> After running the **<span class="keyword">reset-fne-server</span>** tool, the server is **shut down. It must be restarted.**</p>

</dd></dl></div></section><section class="section" id="bkmrk-the-reset-fne-server">The **<kbd class="userinput">reset-fne-server</kbd>** command can be used to recover from the following type of errors:

```
ERROR: FNE code 7000001c - Server was not able to process request correctly.
ERROR: FNE servercode 33 - Trusted Storage broken, backup/restore exploit detected
```

If the server is not online, after performing the reset, you must download the license container file from the license portal and install it on the server. For details, see [Downloading licenses](https://lhc.advantest.com/books/licensing-reference/page/downloading-licenses "If the FNE license server is not connected to the internet you must manually download the license container from the Advantest License Portal and upload it to the FNE license server.").  
</section><section class="section" id="bkmrk-accessing-the-advant">### **Accessing the Advantest License Back Office from online license servers**

To validate that the **online FNE license server** can reach the Advantest License Portal, from the FNE license server host system, enter the following URL in a web browser:

[https://license.advantest.com/](https://license.advantest.com/)

<p class="callout info"><span class="title">Note: Check the <kbd class="userinput">https</kbd> connection using port 443.</span></p>

</section><section class="section" id="bkmrk-accessing-the-advant-2">### **Accessing the Advantest License Back Office using a proxy**

The FNE server supports communication between the server and the Advantest License Back Office using an http-proxy if required.

If you need to access the Advantest License Back Office using a proxy:

1. Open the <span class="filepath">`/etc/systemd/system/advantest-fne-server.service.d/flexnetls-socbu.conf`</span> file for editing.
2. Add a line using the following syntax, substituting the hostname/IP address and port of the proxy server:  
      
    **<kbd class="userinput">Environment=HTTPS\_PROXY=http://&lt;host&gt;:&lt;port&gt;  
    </kbd>**
    
    For example:
    
    `Environment=HTTPS_PROXY=http://myproxyserver.mycom.com:1234`
3. Save and close the file.
4. <span style="text-decoration: underline;">Restart the FNE server:</span><kbd class="userinput">`<kbd class="userinput">sudo systemctl restart advantest-fne-server </kbd>`</kbd>

</section><section class="section" id="bkmrk-firewall-open-for-ad">### **Firewall open for Advantest FNE Cloud License Server**

To validate if the firewall and the connection to the Advantest FNE Cloud License Server, from the FNE license server host system, enter the following URL in a web browser::

<kbd class="userinput"><kbd class="userinput">`<kbd class="userinput"><kbd class="userinput">http://<ACLS-servername>:7070/api/1.0/health</kbd></kbd>`</kbd></kbd>

The output would look like this:

```
{
"LLS" : {
"version" : "2018.02",
"buildDate" : "2018-01-30T18:39:07Z",
"buildVersion" : "222955",
"branch" : "FlexnetLS-2018.02",
"patch" : "0",
"fneBuildVersion" : "220112",
"serverInstanceID" : "05RBLMU6XLGW",
"database" : {
"connectionCheck" : "success"
},
"security" : "enabled",
"httpAuth" : "enabled",
"licensingSecurityJSON" : "enabled"
}
}
```

</section><section class="section" id="bkmrk-uninstall-the-licens">### **Uninstall the License Server and Server Viewer**

To **uninstall** the FNE License Server and FNE Server Viewer:

<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">`<kbd class="userinput"><kbd class="userinput"><kbd class="userinput">sudo yum remove advantest-fne-server advantest-fne-server-viewer</kbd></kbd></kbd>`</kbd></kbd></kbd>

</section>