Table of Contents

FlexNet administration page

Vendor Daemon Configuration page

State of the license daemon

Copyright

All the contents of this document are protected by the copyright law. They may not be disclosed to third parties or copied or duplicated in any form without the written consent of NanoXplore.

Introduction

This document is intended to help configure and install the NanoXplore License Manager Daemon (NXLMD) required to use NanoXplore tools.

Although it should work as expected on any recent 64 bit Linux or Windows operating system, the NanoXplore License Manager Daemon has been successfully tested on the following systems:

• RedHat Enterprise Linux 7 and 8

• Ubuntu 18.04 LTS and 20.04 LTS

• Windows Server

For any other distribution or platform, please contact the NanoXplore Support team at support@nanoxplore.com.

Package Description

The NXLMD-2.2-linux.tar.gz package contains the following directories:

The NXLMD-2.2-windows.zip package contains the following directories:

Installation

Linux

In this document we refer to the directory where the NXLMD files are installed as the installation directory.

Archive

• If the installation directory does not exist, create it using the command below:

  $> mkdir /opt/NanoXplore

To install the NanoXplore License Manager Daemon:

• Unpack NXLMD-2.2-linux.tar.gz file into the installation directory using the following command:

  $> tar xzvf NXLMD-2.2-linux.tar.gz -C /opt/NanoXplore

Linux Distribution Adaptation

The NanoXplore License Manager Daemon supports several Linux distributions, you must point to the right one when updating the symbolic links in the directory /opt/NanoXplore/NXLMD/2.2/bin.

• Please go to the bin directory and update all the existing links with the following commands (e.g. for RHEL 7):

  $> ln -sfn x86_64_RHEL_7/lmgrd lmgrd
  $> ln -sfn x86_64_RHEL_7/lmhostid lmhostid
  $> ln -sfn x86_64_RHEL_7/lmstat lmstat
  $> ln -sfn x86_64_RHEL_7/lmutil lmutil
  $> ln -sfn x86_64_RHEL_7/NXLMD NXLMD
  $> ln -sfn x86_64_RHEL_7/lmadmin lmadmin

Linking Libraries

The NanoXplore License Manager Daemon requires the library ld-lsb-x86-64.so.3 which might not be installed on Linux distributions.

• To do so, use the following command:

  $> ln -s /lib64/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3

Retrieve Licensing Information

To retrieve the required license file from NanoXplore, you must provide the following information:

1. The Name of the Host where the License Manager Daemon is installed.

   • Use the following command to retrieve this information:

     $> hostname

2. The License Manager Host ID provided by the binary is located in /opt/NanoXplore/NXLMD/2.2/bin.

   • Use the following command to retrieve this:

     $> /opt/NanoXplore/NXLMD/2.2/bin/lmhostid

License File

• Once you retrieve the license file, copy it to the installation directory:

  $> cp license.lic /opt/NanoXplore/NXLMD/2.2/license.lic

Installation to Non-Default Directories

• You can install NXLMD in a non-default directory ${MY_INSTALLATION_DIRECTORY} using the following command:

  $> tar xzvf NXLMD-2.2-linux.tar.gz -C ${MY_INSTALLATION_DIRECTORY}

• Use the command below to change the path in the License File from
  ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/license.lic
  to
  ${MY_BIN_DIRECTORY} = ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/

  $> DAEMON NXLMD ${MY_BIN_DIRECTORY}/NXLMD

Windows

In this document we refer to the directory where the NXLMD files are installed as the installation directory.

Archive

• Unzip the archive to the C:\NanoXplore directory

License File

• Copy the license file to the installation directory C:\NanoXplore\NXLMD\2.2\

Execution

Linux

Service Script

To do this, run the following command:

• Copy the lmadmin.service file to the /etc/systemd/system directory:

  $> cp /opt/NanoXplore/NXLMD/2.2/etc/lmadmin.service /etc/systemd/system/

• If you choose to use the default user specified in the lmadmin.service file, you must execute the following commands:

  $> useradd lmadmin
  $> chown -R lmadmin:lmadmin /opt/NanoXplore

Manual Execution

To manage the NanoXplore License Manager Daemon manually, use the following commands:

• Start

  $> systemctl start lmadmin

• Stop

  $> systemctl stop lmadmin

• Restart

  $> systemctl restart lmadmin

Automatic Execution

1. Use systemctl to add the new service:

   $> systemctl enable lmadmin

2. Start the NanoXplore License Manager Daemon with the following command:

   $> systemctl start lmadmin

• To print status information about the NanoXplore License Manager Daemon, use the command:

  $> systemctl status lmadmin

Terminate Process

• To stop the NanoXplore License Manager Daemon, use the command:

  $> systemctl stop lmadmin

Windows

Manual Execution

• Launch a Windows PowerShell and go to the installation directory of NXLMD:

  $> cd C:\NanoXplore\NXLMD\2.2\bin\lmadmin

• To launch the lmadmin service, use the following command:

  $> .\lmadmin.exe

Automatic Execution

1. Launch a Windows PowerShell as Administrator

2. Go to the NXLMD installation directory:

   $> cd C:\NanoXplore\NXLMD\2.2\bin\lmadmin

To add the lmadmin service to Windows:

• Run the following command:

  $> .\lmadmin.exe –installService lmadmin

Configuration of lmadmin

Once the lmadmin service is launched, you must configure it:

1. Open a navigator and access the following URL: http://127.0.0.1:8090 (if you launched the navigator on your server)
   You should obtain the following page:
   

   

2. Click on the “Administration” tab
   Note: You will be asked to sign in: the default Username and Password are “admin”/”admin”. Once logged in, you will be prompted to change the admin password

3. Click on the “Vendor Daemon Configuration” tab
   

   

4. You can now import your license file by clicking the “Import License” button.

Once imported, the license daemon should be automatically launched.

To check the status:

1. Navigate to the Dashboard tab

2. Click on the “Concurrent” button
   If the license daemon is well configured, you should obtain a page similar to this:

If you encounter any issues, please contact NaxoXplore Support

Configuration of Variables

• When launching NanoXplore tools, the LM_LICENCE_FILE variable must be exported

• To avoid having to repeat this for every execution, you can to add it in the ~/.bashrc file with the following command:

  <port_number>@<machine_name>

  For instance:

  export LM_LICENCE_FILE=2700@localhost

Troubleshooting

LogFile

Linux

• You can check the execution log file in the following directory if you use the service nxlmd:

  $> /var/log/NXLMD.log

• If you use the lmadmin service, you can check the execution log file in the following directory:

  $> /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/logs/NXLMD.log

Windows

• You can check the execution log files in:

  $> C:\NanoXplore\NXLMD\2.2\bin\lmadmin\logs

lmadmin (Linux)

• If you have the following message in the /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/logs/web.log:

  [alert] getpwuid: couldn't determine user name from uid 4294967295

You probably have launched lmadmin as root.

• Try to launch it as another user (dedicated lmadmin for example)

• Be sure that this user is the owner of the /opt/NanoXplore/NXLMD directory

lmhostid (Linux)

• If you have the following message in the execution log file (for example):

  Wrong hostid on SERVER line for license file:
  
                ${MY_LICENSE_FILE}
  
  SERVER lines says 08002780463d, hostid is (Can't get hostid of type 2 [])
  
  Invalid hostid on SERVER line

With:

${MY_LICENSE_FILE} = ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/license.lic

• You probably have the wrong network interface (see previous sections for more information on how to change this)

• If you want to check the hostid found by NXLMD without running the server, you can use the following command:

  $> ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/lmhostid

• You must get a full hostid with ${HOSTID} not empty:

  The FlexNet host ID of this machine is "${HOSTID}"

lmstat (Linux)

• You can check that NanoXplore License Manager Daemon runs correctly using the following command:

  $> ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/lmstat -a

GLIBC Problem (Linux)

• If you have the following error message:
  NXLMD: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by NXLMD)

• You have to change the links in the ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin directory to your OS version, for example:

  lmgrd -> x86_64_UBUNTU_18/lmgrd
  lmhostid -> x86_64_UBUNTU_18/lmhostid
  
  lmstat -> x86_64_UBUNTU_18/lmstat
  
  lmutil -> x86_64_UBUNTU_18/lmutil
  
  NXLMD -> x86_64_UBUNTU_18/NXLMD

hostname problem (Linux)

• You can check that you have your hostname written in the file:
  /etc/hosts.

Firewall Problem

Linux

• If you have a firewall set, you must add a specific rule for the lmgrd Port (27000 by default) and for the NXLMD Port

• You can manually specify the NXLMD Port in the License File, for example, to set the port to 27010:

  $> DAEMON NXLMD ${MY_BIN_DIRECTORY}/NXLMD PORT=27010

with ${MY_BIN_DIRECTORY} = ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/

Windows

• If the Windows firewall is enabled, you must authorise lmadmin and lmgrd

• At the first launch of the server, Windows will ask you if you wish to authorise the service

• Otherwise, you can manually add them in the firewall parameters.

“No such file or directory” Error (Linux)

If you have the following message when launching ‘journalctl –xe’ command:

$> lmadmin.service: Failed at step EXEC spawning /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/lmadmin: No such file or directory

The ld-lsb-x86-64.so.3 file is probably missing.

• Run the following command to check it:

  $> ls -l /lib64/ld-lsb-x86-64*

• If there is no result, run the following command:

  $> sudo ln -s /lib64/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3