Table of
...
Contents
| Table of Contents |
|---|
Figure 1: FlexNet administration page
Figure 2: Vendor Daemon Configuration page
Figure 3: State of the license daemon
...
This document is intended to help user to configure and install the NanoXplore License Manager Daemon (NXLMD) needed required to use NanoXplore tools.
Although it should work correctly as expected on any recent 64 bits bit Linux and or Windows operating system, the NanoXplore License Manager Daemon has been successfully tested on the following systems:
...
For any other distribution or platform, please contact the NanoXplore Support team at support@nanoxplore.com.
| Info |
|---|
Please note that you should launch some of the described Linux commands as root, adding “sudo” in front of each command. |
Package
...
Description
The provided package NXLMD-2.2-linux.tar.gz package contains the following directories:
NXLMD |
|---|
...
-2.2 |
|---|
...
bin contains binary files
...
(Root Directory + Current Version) | Contents |
|---|---|
bin | Binary Files |
etc | Contains one service file to automate daemon execution (only on Linux) |
The provided package NXLMD-2.2-windows.zip package contains the following directories:
NXLMD |
|---|
...
-2.2 |
|---|
...
(Root Directory + Current Version) | Contents |
|---|---|
bin | Binary Files |
Installation
Linux
In this document we refer to the directory where the NXLMD files are installed as the installation directory.
| Info |
|---|
The default “/” recommended directory is /opt/NanoXplore. |
Archive
If the installation directory does not exist, create it using the command below:
Code Block $> mkdir /opt/NanoXplore
To install the NanoXplore License Manager Daemon, unpack :
Unpack NXLMD-2.2-linux.tar.gz file into the installation directory using the following command:
Code Block $> tar xzvf NXLMD-2.2-linux.tar.gz -C /opt/NanoXplore
Linux
...
Distribution Adaptation
The NanoXplore License Manager Daemon supports several Linux distributions. You have to , you must point to the correct right one in when updating the symbolic links in the directory
| Anchor | ||||
|---|---|---|---|---|
|
Please go to the bin directory and update all the existing links with the following commands (e.g. for RHEL 7):
Code Block $> 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 needs requires the library ld-lsb-x86-64.so.3 which might not be installed on Linux distribs. The distributions.
To do so, use the following command
...
:
Code Block $> ln -s /lib64/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3
Retrieve
...
Licensing Information
To get retrieve the needed required license file from NanoXplore, the customer provides two pieces of you must provide the following information:the name
The Name of the
...
Host where the License Manager Daemon is installed
...
.
Use the following command to retrieve this information:
Code Block $> hostname
...
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:
Code Block $> /opt/NanoXplore/NXLMD/2.2/bin/lmhostid
License
...
File
Once you
...
retrieve the license file, copy it
...
to
...
the installation directory:
Code Block $> 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:
Code Block $> 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
...
$> DAEMON NXLMD ${MY_BIN_DIRECTORY}/NXLMD
...
to
${MY_BIN_DIRECTORY} = ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin
...
/
Code Block $> 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.
| Info |
|---|
The default “/” recommended directory is C:\NanoXplore |
...
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
| Info |
|---|
Note: Running the NanoXplore License Manager Daemon as a service requires the installation of the provided lmadmin service |
...
To do this, run the following command:
Copy the lmadmin.service file to the /etc/systemd/system directory:
Code Block $> cp /opt/NanoXplore/NXLMD/2.2/etc/lmadmin.service /etc/systemd/system/
| Info |
|---|
Please make sure |
...
the |
...
User and |
...
Group specified in the lmadmin.service file |
...
exist |
| Info |
|---|
The User must have Read and Write access to the /opt/NanoXplore/NXLMD |
...
directory |
...
| Note |
|---|
The |
...
User and |
...
Group cannot be |
...
‘root’, use a specific user |
...
nstead, e.g. ‘lmadmin’ |
If you choose to use the default user specified in the lmadmin.service file, you
...
must execute the following commands:
Code Block $> useradd lmadmin
...
$> chown -R lmadmin:lmadmin /opt/NanoXplore
Manual
...
Execution
To manage the NanoXplore License Manager Daemon manually, you can use the following commands:start
Start
Code Block $> systemctl start lmadmin
Stop
...
Code Block $> systemctl stop lmadmin
Restart
...
Code Block $> systemctl restart lmadmin
Automatic
...
Execution
Use systemctl to add the new service:
Code Block $> systemctl enable lmadmin
...
Start the NanoXplore License Manager Daemon with the following command:
Code Block $> systemctl start lmadmin
To print status information about the NanoXplore License Manager Daemon, use the command:
Code Block $> systemctl status lmadmin
| Info |
|---|
Execution log files are available in the /opt/NanoXplore/NXLMD/ directory |
...
Terminate Process
To stop the NanoXplore License Manager Daemon, use the command:
Code Block $> systemctl stop lmadmin
Windows
Manual
...
Execution
Launch a Windows PowerShell and go to the installation directory of NXLMD:
Code Block $> cd C:\NanoXplore\NXLMD\2.2\bin\lmadmin
To launch the lmadmin service, use the following command:
Code Block $> .\lmadmin.exe
Automatic
...
Execution
Launch a Windows PowerShell as
...
Administrator
Go to the NXLMD installation directory
...
:
Code Block $> cd C:\NanoXplore\NXLMD\2.2\bin\lmadmin
To add the lmadmin service to Windows run :
Run the following command:
Code Block $> .\lmadmin.exe –installService lmadmin
Configuration of lmadmin
Once the lmadmin service is launched, you have to must configure it.:
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
...
:
...
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
...
...
Click on the “Vendor Daemon Configuration” tab
...
...
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, go back :
Navigate to the
...
Dashboard tab
...
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_LICENSE_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:
Code Block <port_number>@<machine_name>For instance:
Code Block export LM_LICENSE_FILE=27000@localhost
Troubleshooting
LogFile Error
Linux
...
If you use the nxlmd service, check the execution log file in the following directory
...
:
Code Block $> /var/log/NXLMD.log
If you use the lmadmin service
...
,
...
check the execution log file in the following directory:
Code Block $> /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/logs/NXLMD.log
Windows
...
Check the execution log files in:
Code Block $> C:\NanoXplore\NXLMD\2.2\bin\lmadmin\logs
lmadmin Error (Linux)
...
Problem
The following message appears in the /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/logs/web.log:
| Code Block |
|---|
[alert] getpwuid: couldn't determine user name from uid 4294967295 |
Possible Cause
You probably may have launched lmadmin as root.
Workaround/Fix
Try to launch it lmadmin as another user (dedicated lmadmin for example).
| Info |
|---|
...
Make sure that this user is the owner of the /opt/NanoXplore/NXLMD directory |
...
lmhostid Error (Linux)
...
Problem
The following message appears in the execution log file (for example):
| Code Block |
|---|
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
Possible Cause
You probably have probably the wrong network interface . To change it, (see previous sections .If you want to for more information on how to change this)
Workaround/Fix
To check the hostid found by NXLMD without running the server, you can use the following command:
| Code Block |
|---|
$> ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/lmhostid |
You
...
must get a full hostid with ${HOSTID} not empty:
Code Block The FlexNet host ID of this machine is "${HOSTID}"
lmstat Error (Linux)
You can check that Check the NanoXplore License Manager Daemon runs is running correctly using the following command:
| Code Block |
|---|
$> ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/lmstat -a |
GLIBC
...
Problem (Linux)
Problem
If you have the following error message appears:
NXLMD: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by NXLMD)
...
Fix
Change the links in directory the ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin directory to your OS version.
For example:
| Code Block |
|---|
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
...
Error(Linux)
You can check that you have Check your hostname is written in the file:
/etc/hosts.
Firewall
...
Problem
Linux
Resolution
If you have a firewall set, you must add a specific rule for the lmgrd port Port (27000 by default is 27000) and for the NXLMD port. Port
You can manually specify the NXLMD
...
Port in the License File, for example, to set the port to 27010:
Code Block $> DAEMON NXLMD ${MY_BIN_DIRECTORY}/NXLMD PORT=27010
with ${MY_BIN_DIRECTORY} = ${MY_INSTALLATION_DIRECTORY}/NXLMD/2.2/bin/
...
| Info |
|---|
Note: remember to also add a rule for this |
...
Port |
Windows
If the Windows firewall is enabled, you have to authorize must authorise lmadmin and lmgrd. On
At the first launch of the server, Windows will ask you if you
...
wish to
...
authorise the services, otherwise, you
...
must add them manually in the
...
Firewall parameters.
...
“No such file or
...
directory” Error (Linux)
Problem
If you have the following message appears when launching ‘journalctl –xe’ command:
| Code Block | ||
|---|---|---|
| ||
$> lmadmin.service: Failed at step EXEC spawning /opt/NanoXplore/NXLMD/2.2/bin/lmadmin/lmadmin: No such file or directory |
Reason
The ld-lsb-x86-64.so.3 file is probably may be missing.
Workaround/Fix
Run the following command
...
:
Code Block $> ls -l /lib64/ld-lsb-x86-64*
If there is no result, run the following command:
Code Block $> sudo ln -s /lib64/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3