FNE and FNX

SmarTest Client Information

SmarTest Client Information

What is multi-dimensional locking, which FNE supports

With FNP licenses can only be locked to a HOSTID or a system serial number. The locking to the HOSTID is not used anymore.

With FNE it is also possible to lock the licenses e.g. to the upstream of a device, to device categories, the downstream company, … This is meant with multi-dimensional locking.

So it is possible to limit a license to a specific device with FNE.

SmarTest Client Information

What are the connection times between client and license server for FNE and FNP?

An FNE client connects to the FNE license server every 20 minutes. And if the connection fails another FNE license server can be connected (if defined in /etc/fne/client.conf) to get the same license.

An FNP client tries to connect to the FNP license server every 2 minutes. When this connection fails SmarTest starts the grace period and shuts down at the end of the grace period, if a reconnection to the same FNP license server is not possible.

SmarTest Client Information

How does SmarTest read the client.conf configuration file?

Explanation on FNE license check-out behavior / order for FNE servers defined in the client.conf file

Q1:  If two servers are defined in the client.conf file, is there any order where the licenses got checked out?

The sequence is down top down, so first entry gets queried first and if the license is not available, the next entry in line will be queried.

Q2: Or are both servers always queried?

If the response from the first entry is positive and the license is checked out, there is no additional query to other servers.

Q3: Is there any technical reason why ELF lics seems to be checked out preferentially?

They are preferred due to the FULL_CAPABILITY license. If any FULL_CAPABILITY licenses is found, this lic will get checked out with priority, even if it's from the second server


Installation and Administration FNE/FNX server

How to check if the FNE server is running

FNX proxy setup questions

Terminal commands questions

Installation and Administration FNE/FNX server

How to check if the FNE server is running

You can check the following:

  1. Is the FNE server running?

    Note: if you have an FNE failover setup, you need to check this both for the FNE primary and the FNE failover servers.

  2. Are licenses provided?

    Note: Using both tools provided in the sections "1. Is the FNE server running" and "2. Are licenses provided?" below, your customer can use a monitoring tool to check, if the FNE license server(s) are okay and providing licenses.

  3. For failover setup: when is the maintenance end reached?
    This is an optional check, for the case you want to know when the maintenance end is reached by the failover, when the primary server is down.

1. Is the FNE server running?

If you want to check, if the FNE server is running, you can use the :7070/ping REST API. In a browser enter

http://<FNE_hostname>:7070/ping

 For a failover setup you have to do this for the primary and the failover FNE server! 

Output in the browser, if the server is running:

new1.png

If it is not working, then you get an error page.

2. Are licenses provided?

Note: the tool test_license_checkout can be used after FNE server registration.

In order to check, if the license checkout is working, you should use the tool test_license_checkout, which is also available on the FNE license server. Just checkout the dummy license with

test_license_checkout -f dummy -t 0

Example for a successful checkout:

new2.png

Check for the "OK    1 x dummy" line. If it is available, the checkout was successful.

3. For failover setup: when is the maintenance end reached

With the following command executed on the failover server you can get the date/time when the maintenance of the failover ends.

/opt/flexnetls/socbu/fne-get-config -1 maintenanceEndTime 

If you get as output

1970-01-01T00:00:00.000Z

then the failover is not (yet) active.

Example output for an active failover executed on August 7th, showing that the maintenance will end on August 17th:

2023-08-17T13:02:28.000Z

Installation and Administration FNE/FNX server

FNX proxy setup questions

Installation questions

If option fnx is used, why is also v93000-fne-client installed?

The fne-client is part of the license software (The client needs to correctly configure the configuration file /etc/fne/client.conf before establishing the connection to the server.).

How to check if proxy related packages are installed or not?

The fne-status command gives you a list of installed packages (requires advantest-fne-server package to be installed).


Are the hostnames for command fne-proxy-setup case-sensitive?

Yes. For example if the hostnames of the second license server is HostX2 and for the third license server is HostY3 then you need to enter the following command for setting up the proxy connection on the primary server.

/opt/flexlm/bin/fne-proxy-setup HostX2 HostY3

The hostnames are case-sensitive here. So you need to take care to use the correct upper and lower letters.


Option file usage information with FNX

With FNX environemnt, FNP clients can use an option file as for FNP. There are two important differences:

  1. The option file is only valid for FNP-clients.
  2. Please put the option file to folder /opt/flexlm/bin. Ideally you use the default option file name socbu.opt. If you do not use the default name, you need to define the name in license file proxy.lic in folder /opt/flexlm/bin as known for FNP.

If the FNE proxy already runs and you installed a new option file or changed an option file you need to restart the proxy with 

sudo systemctl restart advantest-fne-proxy 

to make the new / changed option file effective.


Problem with using MAX 0 in option file - Message "FATAL ... internal error" in the license server log file

Do not use MAX 0 in the option file but use the EXCLUDE keyword.

Reason: if you use MAX 0 in the option file you will get a "FATAL ... internal error" error message in the log file with trying to checkout this license with the user / host which shall not be able to do it. In this case the search algorithm tries to check out -1 licenses and fails and therefore the "FATAL ... internal error" is written to the log file. 

Positive is that the license cannot be checked out as defined with the option file. Therefore, the functionality is working, but there are unnecessary and incomprehensible error messages in the log file.

The use of EXCLUDE instead prevents these error messages.

Installation and Administration FNE/FNX server

Terminal commands questions

Subtopics

What FNE commands are available?

FlexNet Embedded license administration

How do I get a list of FNE licenses available on my FNE license server?

You can use the FNE server viewer > Features.

Alternatively you can use the command fne-list-licenses

There are a bunch of options like providing the output with a separator like comma possible, please check with man fne-list-licenses the manual page.

Examples:

Without any options you get all licenses:

3.png

With option --feature you can look up a special license:

4.png

 Features are case-sensitive. If you enter fne-list-licenses --feature=smartest you will not get an output.

See the manual page for more examples.

How to set up a simple hostname - fne-failover-setup ERROR: The simple hostname (<hostname>) may not contain dots

if you enter the command hostnamectl status

you should get for the simple/static hostname only the simple hostname like licfne01 on the appropriate server. (warning) The simple/static hostname must not contain a dot when setting up an FNE failover setup. Example for a good output:

5.png

In the screenshot above the simple/static hostname is socbu216 only.

If there is a dot in the simple hostname, then you can change it with hostnamectl set-hostname <name>

 Check with command hostnamectl status

afterwards, if the name changed. Please also check, that the fully qualified hostname is still available with hostname -f

Example for good hostname -f output:

6.png

Note: Do not use localhost or localhost.localdomain as hostname for an FNE license server!

Installation and Administration FNE/FNX server

What is the IP address of the Advantest Licensing Back-Office (license.advantest.com/FNO)

Do not use the IP address to allow the access to the Advantest Licensing Back-Office at license.advantest.com. Instead of that please use DNS to allow the access to license.advantest.com.

Reason is that in January 2026 the IP address will not be fix anymore because of various reasons like using Akamai WAF for license.advantest.com (Akamai WAF is a security solution that protects web applications from online threats).

The formerly used fix IP address 8.31.43.39 for license.advantest.com shall not be used for example at the customer firewall or in file /etc/hosts anymore starting with January 2026.

Installation and Administration FNE/FNX server

Can I run FNP and FNE license server on one server

This is not possible. You need to de-install the FNP license server in order to run an FNE license server and vice-versa.

Installation and Administration FNE/FNX server

Can I use a VM for FNE or FNX license server setup

Yes, this is possible. The hardware / software prerequisites and the installation setup is the same for VM as for bare metal servers. 
(see LHC chapter of FlexNet Embedded license server setup - Prerequisites for the prerequisites and subchapters / links for the installation set up).

Only if you have a local license server serving only the local SmarTest client, then the hard disk space can be less.

Z4G5 is only allow one instance for local FNE/FNX license server: either on the HV instance or on the bare metal instance; parallel installation will corrupt database.

Note: if you have a failover FNE setup or a triad FNX server setup it is risky to use the VMs available on the same server. If this server goes down, all VMs go down.

Installation and Administration FNE/FNX server

Can I use another port than 7070 for the FNE server

Yes, this is possible since FNE software 2022.04.0.0/2019.07.1.0-22144. You can change the port in file

/etc/systemd/system/advantest-fne-server.service.d/flexnetls-socbu.conf,

edit

Environment=PORT=7070.

Note: However, initial installation must ensure port 7070 is open. The port number can be modified after initial installation is complete.

Note: you need to take care that the new port is also opened in the firewall of the server.

Installation and Administration FNE/FNX server

Can I use another port than 7077 for the FNE server viewer

No. This port is fixed.

Installation and Administration FNE/FNX server

Can I use another port for the proxy server

Note: The license files for the proxy are in folder /opt/flexlm/bin. There are two license files: atflexd-proxy.lic and proxy.lic. Via these license files the license server process lmgrd starts two vendor daemons:

  1. atflexd for the T2K licenses
  2. socbu for the 93k licenses

If the customer wants to use another port for the lmgrd process of the proxy server or another port for the socbu / atflexd vendor daemon, then the files in folder /opt/flexlm/bin

need to be adapted with the appropriate port number on the SERVER line(s) for the lmgrd process and on the VENDOR line for the appropriate vendor daemon process on all used proxy license servers. So if the setup is an FNX triad, the port numbers need to be adapted on all three license servers.

Please always adapt both license files. The license server will run into errors, if you use for example different port numbers for the lmgrd process in file proxy.lic than in atflexd-proxy.lic.

Installation and Administration FNE/FNX server

How to make an online FNE server offline

Add the following line to /etc/hosts on the FNE license server at the end of the file:

0.0.0.0 license.advantest.com

Note: the line 0.0.0.0 license.advantest.com is sometimes not working because of individual customer IT setup. Then you need to talk to customer ID.

Installation and Administration FNE/FNX server

No active time synchronization daemon found on this system (ntpd/chrony)

NTPD:

Make sure the service is running.

Chrony:

Un-comment the line "local stratum 10" in the /etc/chrony.conf and restart chrony service

Reference:

Configuration about ntpd/chronyd

Installation and Administration FNE/FNX server

RHEL9 upgrade and the licensing software - recommendation for existing setups

In any case using a emergency standby license server is advised to ease the process of upgrading the setup.
Please be reminded, that an emergency server is mandatory for any FNE/X related setup.

For upgrading from RHEL7 to RHEL9 and how to handle the licensing software on single/standalone FNE server: 

1. uninstall licensing software while OS is still RHEL7
    1.1 With release 2023.11.0.0-23324 and newer use:

sudo sh install-fne-<year> uninstall 

    1.2 For older releases find the installed packages (rpms) with fne-status command under Installed components
    1.3 Use the list entries with: (example)

sudo yum remove advantest-fne-server advantest-fne-server-viewer 

2. update OS to RHEL9
3. download and install latest FNE software

sudo sh install-fne-2024.01.0.0-24043-rhel9.sh server

for a proxy setup use fnx instead of server

This would obviously mean some downtime if there is no failover/backup or emergency standby server in place.
An emergency server is mandatory and set up will prevent any downtime.

 For upgrading from RHEL 7 to RHEL 9 and how to handle the licensing software with a failover setup and triad setup:

Failover setup must be in place beforehand! It cannot be added afterwards without a completely new setup including the registration for the back office. 

On Primary server:
1. uninstall licensing software while OS is still RHEL7
    1.1 With release 2023.11.0.0-23324 and newer use:

sudo sh install-fne-<year> uninstall 

    1.2 For older releases find the installed packages (rpms) with fne-status command under Installed components
    1.3 Use the list entries with: (example)

sudo yum remove advantest-fne-server advantest-fne-server-viewer

2. update OS to RHEL9
3. download and install latest FNE software

sudo sh install-fne-2024.01.0.0-24043-rhel9.sh server

for a proxy setup use fnx instead of server
4. run as normal user

fne-failover-setup repair primary <failover host>

During primary downtime the clients will switch to the failover.
Once the primary is finished upgrading and has a running licensing software, clients will automatically reconnect to primary within 2-20mins.

On Failover server:
1. uninstall licensing software while OS is still RHEL7
    1.1 With release 2023.11.0.0-23324 and newer use:

sudo sh install-fne-<year> uninstall 

    1.2 For older releases find the installed packages (rpm's) with fne-status command under Installed components
    1.3 Use the list entries with: (example)

sudo yum remove advantest-fne-server advantest-fne-server-viewer

2. update OS to RHEL9
3. download and install latest FNE software

sudo sh install-fne-2024.01.0.0-24043-rhel9.sh server

for a proxy setup use fnx instead of server
4. run on primary as normal user!

fne-failover-setup repair failover <failover host>

HostIDs of primary and failover servers must not be changed!

On Tertiary server:

1. uninstall licensing software while OS is still RHEL7
    1.1 With release 2023.11.0.0-23324 and newer use:

sudo sh install-fne-<year> uninstall 

    1.2 For older releases find the installed packages (rpms)

rpm -qa | grep fne-proxy

    1.3 Use the list entries with this command: (example)

sudo yum remove advantest-fne-proxy advantest-fne-proxy-base advantest-fne-proxy-features

2. update OS to RHEL9
3. download and install latest FNE software

sudo sh install-fne-2024.01.0.0-24043-rhel9.sh tertiary

Afterwards the proxy setup can be run on primary:

/opt/flexlm/bin/fne-proxy-setup <secondary> <tertiary>

Important links:
Softwarecenter Download FNE licensing software
https://softwarecenter.advantest.com/download/93ksw/builds/smartestaddons/smartestaddons:fne

Installation and Administration FNE/FNX server

Can I install FNE or FNX on a dual boot workstation

A dual boot workstation is currently the set up of two boot instances on the workstation with

This setup is available for the following workstations:

Question: Can I install FNE / FNX on a dual boot workstation?
Short answer: No

Recommendation: Please use a central license server with FNE / FNX setup to provide the appropriate licenses.

Reason for the short answer and the recommendation: The host ID of the hypervisor and the bare metal system is the same. From FNE point of view it would be the same database on both instances, but the access to the database is different and therefore the databases will differ and corrupted in the end. So it is not possible to run FNE / FNX on both instances.

What is possible: If you use only one instance of the workstation, then you can install there a license server. So it is possible to install the FNE/FNX server either on the hypervisor OR on the bare metal system, but it is not possible to install it on both!

Special for Z4G5: The hypervisor with PDB 702.0 or older for Z4G5 does not have the necessary software to run an FNE / FNX license server. Therefore it is allowed to install the FNE / FNX license server on the VM as workaround. If the VM needs to be re-installed a rehosting to the new VM host ID of the licenses is needed. Please open then a LIST ticket in WeTrack to be supported with the rehosting (you will not be able to return the licenses anymore, if the old VM is dead). With PDB 703.0 officially the installation on the VM is allowed. PDB 703.0 the hypervisor will provide a static MAC address for the VM, so if it needs to be re-installed, the same static MAC address will be used for the newly installed VM. A rehosting of the licenses is then not necessary.

For FNP installation on a dual boot workstation: see Can I install FNP on a dual boot workstation?

Installation and Administration FNE/FNX server

How to find available registration keys for a parent organization?

Please go to License Portal → License management → Overview → Select master organization → Input keyword "LIC-SRV-Registration" in Entitlement filter → Find the lines in the "remaining" column that are not blank.

Example: Under master organization Advantest_Training sub-organizations Advantest Training 2 and Advantest Training have available keys for registration.

7.png

Installation and Administration FNE/FNX server

How to find which sub-organization a license server is registered under?

Please go to License Portal → License management → Overview → Select master organization → Input keyword "LIC-SRV-Registration" in Entitlement filter → Input server name or server host id as the keyword in Host filter

Example: Server ADV_Training_Test_Server(EXAMPLEID) is registered under organization Advantest Training

8.png

Installation and Administration FNE/FNX server

What is the process for customers after replacing the motherboard?

  1. Reset the database with following command

    cd /opt/flexnetls/socbu
    sudo ./reset-fne-server -a
    sudo systemctl start advantest-fne-server
  2. Download the overview Excel via License Portal

  3. Create a ticket and request the removal of the previous server's registration.
    • The customer cannot perform self-rehosting after the motherboard is damaged and requires GLPT support to remove the registration and return the licenses to entitlement.

  4. Proceed server registration after receiving removal confirmation from GLPT, then activate licenses according to overview.
Installation and Administration FNE/FNX server

Can Advantest's license software be installed together with other companies' license software?

Advantest's license software can theoretically be installed on the same OS as other companies' license software.

However, we will not support any issues arising from these installations.

Installation and Administration FNE/FNX server

Does FNE for Windows support FNP proxy?

No.

FNE on Windows only support FNE, FNP proxy is not supported. Please do not use FNE for Windows if you have any FNP clients.

Installation and Administration FNE/FNX server

Is the FNX Server Installation possible with other FlexNet software running in parallel?

Parallel installation with other companies' license software would be possible. However, we won't support any issues under this situation.

FNE / FNX troubleshooting

FNE / FNX troubleshooting

Where are the log files?

You can find the log files in the following folders for

FNE / FNX troubleshooting

How to update FNX/FNE license servers' software?

See also - Failover license server installation, upgrades and updates.

It is the advantage of the FNE/FNX server, that an update works without downtime. Do the following steps:

Note: If there is not a failover or tertiary server existing, you can skip the steps accordingly.

  1. Test the integrity of the downloaded SW on the primary license server:

    sh install-fne-<date>-<version>.sh test
    If you get the message "Package integrity verified" you can proceed with the other steps.

  2. Get emergency license for standby emergency license server and install it - just to be prepared

  3. Primary server: Do a dry-run installation on the primary server and look for messages. Example for the dry-run command:
    sudo sh install-fne-<date>-<version>.sh dry-run

  4. Primary server: If there are not any problems reported with the dry-run, do the update on the primary server. Example for the update command (no option used):
    sudo sh install-fne-<date>-<version>.sh

  5. Check e.g. with fne-status, that the primary server is running.

  6. Wait 2 minutes.

  7. Failover server: Do the update also on the failover server. See command above.

  8. Check e.g. with fne-status, that the failover server is running.

  9. Wait 2 minutes.

  10. Check with fne-status, if the FNE failover and (if installed) FNP triad is up again.

  11. Tertiary server: Do the update also on the tertiary server.

  12. Check e.g. with fne-status, that all servers are running. 

If there are any problems, please check, if a switch to the standby emergency license server is reasonable and open a LIST ticket to report the problem.

FNE / FNX troubleshooting

FNE registration problems

Error "Connection to https://license.advantest.com/flexnet/deviceservices failed with exception"
Issue description:

The user tried command

register-fne-server <id>

with the appropriate <id> and got the following error message:


Failed to activate your server
\{
"key" : "glsErr.connectionFailed",
"message": "Connection to https://license.advantest.com/flexnet/deviceservices failed with exception: exception: error on POST request for \ \"https://license.advantest.com/fL
exnet/deviceservices\": Connection reset; nested exception is javax.net.ssl.SSLException: Connection reset,*
: [ "https://license.advantest.com/flexnet/deviceservices, I/0 error on POST request for \"https://license.advantest.com/flexnet/deviceservices\": Connec
tion reset; nested exception is javax.net.ssl.SSLException: Connection reset ]*

Background information:

The connection to license.advantest.com with port 443 was not really available, but for the FNE server software it looked like that a connection is possible, therefor it tried and failed.

Solution: Enter the line

0.0.0.0   license.advantest.com

to file /etc/hosts.

FNE / FNX troubleshooting

FNE log file: errors and messages

Installation problems - error "/tmp/: failed to map segment from shared object: Operation not permitted"

Creation date: 08-Jan-2020
Author: Heike Klein

Issue description: The FNE server has been installed but cannot be started.
Log file error in /var/opt/flexnetls/socbu/logs/flexnetls.log.<date> - highlighted in red:

00:02:49,408 advantest-fne-server start
00:02:55,431 Used Options: /usr/lib/jvm/java-1.8.0-ibm-1.8.0.5.40-1jpp.1.el7.x86_64/jre/bin/java -Dbase.dir=/var/opt/flexnetls/socbu -Djsse.enableSNIExtension=false -server -Xms2g -Xmx2g -XX:CompressedClassSpaceSize=64m -XX:MetaspaceSize=256m -XX:+UseG1GC -XX:NewRatio=3 -XX:MaxGCPauseMillis=75 -XX:G1HeapWastePercent=10 -XX:InitiatingHeapOccupancyPercent=75 -XX:+CMSScavengeBeforeRemark -XX:+IgnoreUnrecognizedVMOptions --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.lang.invoke=ALL-UNNAMED -XX:+ScavengeBeforeFullGC -Djava.security.egd=file:/dev/./urandom -jar /opt/flexnetls/socbu/flexnetls.jar -server-alias thbnk01fnxspl1v.th-bnk01.nxp.com -producer-settings /opt/flexnetls/socbu/producer-settings.xml -port 7070 -https-client-configuration /var/opt/flexnetls/socbu/outgoing-certs.conf
00:02:55,438 Environment: Version 2019.07.1.0-19315 / 7.6GB mem / 3.1GB disk free / 4x Intel(R) Xeon(R) CPU E5-2667 v3 @ 3.20GHz / Red Hat Enterprise Linux Server release 7.6 (Maipo)
00:02:58,835 INFO main Starting FlexNet License Server 2019.07 (build 256892)
00:02:58,836 INFO main Copyright (C) 2013-2019 Flexera Software LLC.
00:02:58,836 INFO main All Rights Reserved.
00:02:58,836 INFO main Running as a service
00:03:02,575 ERROR main Native code loading error java.lang.UnsatisfiedLinkError: /tmp/llsnc-2019.07.1.0-256892-amd64-libconnector.so(/tmp/llsnc-2019.07.1.0-256892-amd64-libconnector.so: failed to map segment from shared object: Operation not permitted)
at java.lang.ClassLoader.loadLibraryWithPath(ClassLoader.java:1453)
at java.lang.System.load(System.java:570)

Reason for error:
the servers tries to use/exceute a shared library located in the /tmp directory. This is not allowed on the appropriate system. Running executables from /tmp is forbidden by the noexec option in the mount flags: check the /etc/fstab entry which looks like

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

Solution:
Ask IT to remove the noexec option to /tmp in /etc/fstab and remount it with
mount -o remount,exec /tmp
on all affected FNE license servers.

server filter checkout rejection

In the FNE log file flexnetls.log you maybe find the following message:
server filter checkout rejection
This message is basically saying the license requested is not available, f.e. for a specific serial number.
This is not an error of the server, its just the way the server returns a request for a license that is not present.

TS storage corrupted - FNE server cannot be started - FNE log error "FATAL main IO Exception: null"

In the FNE log file flexnetls.log you find the following entries:

03:36:16,826 INFO main Starting FlexNet License Server 2019.07 (build 256892)

03:36:16,827 INFO main Copyright (C) 2013-2019 Flexera Software LLC.

03:36:16,827 INFO main All Rights Reserved.

03:36:16,827 INFO main Running as a service

03:36:21,736 FATAL main IO Exception: null [90028-196]

 Note: you can extract the log file errors with command: showlog-fne-server -2

The error indicates a corrupted TS storage. In order to repair it, do the following:

  1. cd /opt/flexnetls/socbu

  2. sudo ./reset-fne-server -force

  3. If there is a failover license server configured you need to run the following command (not as root!) on the primary license server ./fne-failover-setup repair primary <failover_host.domain>
    This will repair the primary license server without touching the secondary license server.

    Note: the repair option is available since June 2020. It is not available if an older FNE/FNX installation script has been used and the SW has not been updated since then. Please check with fne-failover-setup -help if the option is available.

  4. If the failover server is corrupt, then you need to run the following command (not as root!) on the primary license server (this is not a typo - you need to run it on the primary license server!): fne-failover-setup repair failover <failover_host.domain> 

    Note: The command fne-failover-setup uses ssh/scp and sudo. You may be asked for your password several times.

Note: you can check the help page of fne-failover-setup with: fne-failover-setup -help

FNE / FNX troubleshooting

What is /var/opt/flexnetls/socbu/flexnetls_licenses.mv.db and can it be deleted?

/var/opt/flexnetls/socbu/flexnetls_licenses.mv.db is the database of the FNE server and should not be deleted at all.

FNE / FNX troubleshooting

What is directory /var/opt/flexnetls/socbu/logs/ used for and can it be deleted?

/var/opt/flexnetls/socbu/logs/ contain the log files of the FNE server and is needed for analysis if something is going wrong. The logs directory is always around 12GB big: it is cleaned up to 10GB each day and on head is the up-to-date log file. 

License Portal Information

Subtopics:

General Licensing Portal Process Information

License Portal Information

License Portal Information

Subtopics:

How to change the FNE server hostname in the license portal?

When you register, the registration process will also transfer the hostname of the FNE (primary) license server to the Advantest Licensing Back-office (FNO). If you change the hostname on the FNE server after the registration, for example from localhost.localdomain to a real hostname, then the license portal will still show the localhost.localdomain entry. In order to get the hostname updated, please

Do FNE need renewal in March?

With FNP you have to renew the perpetual licenses each year with the renewal portal. 

Is the rehosting of FNE licenses from one FNE license server to another FNE license server free of charge?

Customers have a service level agreement with Advantest can do the rehosting of FNE licenses from one FNE license server to another FNE license server in the license portal. This is not charged and you do not have to fill out the rehosting form.

This self-service is one of the great benefits (heart) of FNE.

If you need to migrate FNP licenses to an FNE license server, you should contact with your Advantest representatives for the migration request, with starting a discussion about timeframe, licenses to be migrated (you need to fill out a migration form), prerequisites and other open questions.

We do not provide a rehosting of migrated FNE licenses back to an FNP license server.

Tools Information

Subtopics:

Tools Information

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:

/opt/hp93000/soc/.service/bin/test_license_checkout -f 3 Digital_E8012_TIA -t 10

Here 3 floating licenses of Digital_E8012_TIA will be tried to checkout for the duration of 10 seconds.

How to checkout S&S licenses via test_license_checkout?

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

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

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

 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:

/opt/hp93000/soc/.service/bin/test_license_checkout -u ADVANTEST_RD -f Token_ADVANTEST_RD_WaferSort -t 0

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:

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

How does a successful output with test_license_checkout look like?

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

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

9.png

fne-status showing installed components

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:

test_license_checkout

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

Example with output:

10.webp
test_license_checkout checking out the dummy license

The dummy feature has been successfully checked out for 10 seconds (last two lines in the screenshot above).

Tools Information

FNE Server Viewer Information: difference between connected client and connected tester client?

What is the difference between # connected clients and # connected tester clients in the FNE server viewer?

If you have  a look at the left bar of the FNE server viewer then you have a small graph showing the # of connected clients and # of connected tester clients:

11.png

If you click on menu "Clients" you are getting a bigger presentation for this graph:

12.png

Meaning of

Tools Information

How to receive license expiration notification via email?

fne-list-licenses --expires <expiration_date> | grep -q " x " && fne-list-licenses --expires <expiration_date> | mailx -s "Expiring licenses" <email_address>

Example: fne-list-licenses --expires 100 | grep -q " x " && fne-list-licenses --expires 100 | mailx -s "Expiring licenses" abc@advantest.com

 

This is a feature-based expiration tracking script have to run in the server side. Unfortunately, we do not have a product-based expiration tracking script.