Skip to main content

Terminal commands questions

Subtopics

What FNE commands are available?

FlexNet Embedded license administration

Use on an FNE server the command

apropos-fnx

or for older FNE versions

apropos-fne

to get a list of commands.

With man <command> you can view the man page.

Here is a list of commands - status 14-March-2023 - alphanumerically sorted

Command
Short description
Root user needed
Execution (with or without full path)
Option
Comment
advantest-fne-proxy FNP2FNE proxy for Advantest test systems

Yes, for starting and stopping the service.

No, if you systemctl with command status or help.

without path

sudo systemctl \[command\] advantest-fne-proxy 
with command:

    start: to start the proxy stop: to stop the proxy restart: to stop and start the proxy status: to view the status of the proxy help: to view the man page of advantest-fne-proxy

    This is the service for the FNX server (proxy). The proxy needs a running FNE license server. In order to access the FNE license server the proxy reads the file

    /etc/fne/client.conf

    and connects to the FNE license server in order to checkout there the customer licenses (if enough licenses are available).

    advantest-fne-server FlexNet Embedded license server adapted for Advantest

    Yes, for starting and stopping the service.

    No, if you systemctl with command status or help.

    without path

    sudo systemctl \[ command \] advantest-fne-server 
    with command:

      start: to start the proxy stop: to stop the proxy restart: to stop and start the proxy status: to view the status of the proxy help: to view the man page of advantest-fne-server

      This is the service for the FNE server, providing the licenses to the SmarTest clients either

        directly to FNE SmarTest clients via the proxy to FNP SmarTest clients advantest-fne-server-viewer FlexNet Embedded License Server Viewer by Advantest

        Yes, for starting and stopping the service.

        No, if you systemctl with command status or help.

        without path

        sudo systemctl \[ command \] advantest-fne-server-viewer
        with command:

          start: to start the proxy stop: to stop the proxy restart: to stop and start the proxy status: to view the status of the proxy help: to view the man page of advantest-fne-server-viewer

          This is the service for the FNE server viewer.

          This service is optional. It is a viewer to check what is available on the FNE license server and allows the synchronization with the Advantest back-office manually (via online connection or with uploading bin files). For check in and out of licenses this service is not needed. 

          fne-failover-setup Installation command for setting up the failover server.  no
          (not allowed to execute as root) with path: /opt/flexnetls/socbu/fne-failover-setup
            <hostname.domainname_of_failover_server>

            Only for a failover setup.

            Execution on the primary license server! Executed on the primary license server to pair the primary license server with the failover license server (both needs to be get acquainted).

            The user which executes this command on the primary license server, needs to have access to the failover server: you need to enter the password of this user several times for the failover and primary license server.

            Needs to be executed before the registration!

            fne-failover-status Provides the status of the main and failover FNE license server. no with path: /opt/flexnetls/socbu/fne-failover-status n/a

            Only for a failover setup.

            Output is reasonable after registration of the FNE server: Before registering the FNE server you will see the error message "ERROR: Role of <failover-server> is not BACKUP".


            Example for a good status:

            1.8.jpg




            Example for a bad status:

            1.9.jpg



            There are other possibilities for a bad status.

            fne-get-config Reads the configuration items from the FNE server
            with path: /opt/flexnetls/socbu/fne-get-config

            fne-get-config \[option\] <key>

            with option:

            --i[nstance]: Read value from instance level

            --p[arent]: Read parent(/original) value

            --s[howconfig]: Show complete configuration

            --h[ostid]: Show hostid of server

            --t[rusted-storage]: Show the status of the trusted storage the FNE server is using

            --d[etails]: Show company details (i.e. company name)

            --m[achine]=host: Direct requests to this machine

            --1: Show information for instance 1

            --b[uild]: Show detailed information om server build versions

            --help: Show this text

            --v[ersion]: Print tool version

            with key:


            Examples:

            /opt/flexnetls/socbu/fne-get-config --h 

            Outputs the host ID of the license server.


            /opt/flexnetls/socbu/fne-get-config --t

            Output is true, if the trusted storage is okay.


            /opt/flexnetls/socbu/fne-get-config --d

            Output is the company name the serve is registered to (also visible via the FNE server viewer: the Company name in the Vendor String of the Company_Details license)


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

            Example for an output (explanation is provided in green color and does not belong to the output):

            id 219
            serverInstanceId R1MNQVVF8UEN
            requestId 1
            enterpriseId 15209089
            pendingDeletion false
            maintenanceEndTime 1970-01-01T00:00:00.000Z
            suspended false
            ready true
            hostUUID c2ea23f8-d367-43b5-8034-8a1a35425a27 => This is a unique identifier which is also held in the Advantest back-office for identification
            publisherName socbu
            lastUpdateTime 2023-04-18T20:27:47.000Z
            failOverRole MAIN => The failover shows here the value "BACKUP"
            lastClientDropTime 1970-01-01T00:00:00.000Z
            lastSyncTime 1970-01-01T00:00:00.000Z
            lastServerToServerSyncTime 1970-01-01T00:00:00.000Z
            identityName socbu



            /opt/flexnetls/socbu/fne-get-config --b

            Example for output:

            2023.03.0.0 build/fne 266719/54


            /opt/flexnetls/socbu/fne-get-config --b

            Provides the version of the tool fne-get-config. Example for such an output:

            fne-get-config version 2022.09.0.0.23067

            fne-handle-response For uploading a bin file via command line tool (instead of FNE server viewer) or looking at the content of a bin file. no without path

            --upload: Upload response file to local FNE license server

            --show: Show content of response file

            --notitle: Omit title line in listing (for scripting)

            --help: Show the options

            --version: Print tool version

            Load the bin file to the FNE server (instead of using FNE server viewer):

            fne-handle-response --upload xyz.bin


            Show the content of the bin file

            fne-handle-response --show xyz.bin

            fne-list-licenses
            without path


            fne-log-collect 




            fne-proxy-setup




            fne-rules




            fne-server-viewer 




            fne-show-license-usage Lists the licenses which are in usage (borrowed) no  without path

            no option: shows licenses borrowed by the local machine

            --a[ll]: show licenses borrowed from all clients

            --feature=<xyz>: shows usage of a specific feature

            --v[ersion]: prints the version of the tool fne-show-license-usage

            (and more: usage -help on the command to get all options)

            -bash-4.2$ fne-show-license-usage -a
            Server: FNX-redundant socbl111/socbl112
             \-URL: http://socbl111.bbn.verigy.net:7070/fne/bin/capability
              Client: ST7-SID58tool [SmarTest 7.6.4.1] demo@democlient.adv.advantest.com
                   1 x S&S_Tools_Package/1.0
              Client: ST7-SID58 [SmarTest 7.6.4.1] demo@democlient.adv.advantest.com
                   1 x SmarTestOffline_SOC/1.0 fne-status Provides the status of the FNE server setup and optionally the FNX server (if installed) no without path: fne-status n/a

            Example for triad FNX server:

            2.jpg


            There is an area for


            Environment
            :
            provides some information about the server like operating system installed, RAM size...


            Installed components
            :
            shows the rpm installed for the FNE / FNX setup


            Service status
            :
            shows the status of the FNE/FNX and FNE server viewer services.


            FNE server status
            :
            shows some useful information like the number of features installed on the FNE license server, the load on the FNE license server (max requests/s (peak per hour) and the status of the FNE server / failover server.

             

            Backoffice:
            shows here if a connection to the Advantest licensing back-office (FNO) is established. 
            Even if here "NO connection to license.advantest.com:443" is listed, the connection to the Advantest licensing back-office could be available.


            FNP server status
            :
            if an FNX server is installed you can view here, if the processes are up.


            Configured server
            :
            provides the information from /etc/fne/client.conf file, which server is configured (if it is a failover the primary license server is listed)

            register-fne-server

            Registers the FNE server in the Advantest Licensing Back-Office (FNO). 

            Needed after installation.

            no without path: register-fne-server
              <registration key> <bin file> Registers the FNE server to the Advantest
              Licensing Back Office.

              Online case: if the connection to the Advantest Licensing Back Office is enabled, then the registration is done directly.

              Offline case
              : 4 steps approach after:
              1) you need to upload the file created with the command via the license portal to the Advantest Licensing Back Office
              2) you need to download the response file from the license portal (currently via "License Management" > link "Download (offline server only)"
              3) extract the response file from the zip file you downloaded:
              unzip licenses.zip
              4) execute register-fne-server with the response file (if it is for a failover setup, you need to do this on both FNE license servers) reset-fne-server
              yes

              with path:

              /opt/flexnetls/socbu/



              showconfig-fne-server
              no

              with path:

              /opt/flexnetls/socbu/



              showlog-fne-server
              no without

              sync-fne-server
              no without

              merge_fnp_logs

              Helper script to add complete timestamps and merge FNP logfiles
              # This tool merges multiple logfiles by time and date
              # Please take care with huge logs


              no

              with path:

              /opt/flexlm/bin/



               fnx-check

              This tool checks for features available with FNE, but not supported by the advantest-fne-proxy


              no

              with path:

              /opt/flexlm/bin/





              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!