MagicDraw FloatingLicense UserGuide
MagicDraw FloatingLicense UserGuide
User Guide
1 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
2 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
3 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
4 https://www.flexera.com/
5 https://docs.nomagic.com/display/NMDOC/Basic+concepts#Basicconcepts-vendordaemon
Related pages
On this page
Prerequisites
• You have downloaded7 the installation files of:
• the FlexNet license server manager.
• the vendor daemon - Cameo.
6 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
7 https://docs.nomagic.com/display/NMDOC/Downloading+installation+files
Windows
To use lmadmin on Windows platforms, the Microsoft Visual C++ 2013 Redistributable Package
must be installed. You have an option to install this package during the FlexNet Publisher
License Server Installer process.
• Windows 10
• Windows Server 2008, including SP1, SP2, and R2
• Windows 8
• Windows 8.1
• Windows 7, including SP1
• Windows Server 2012 R2
• Windows Server 2012
2021x We recommend using 32-bit lmadmin or We recommend using 64-bit lmadmin or 64-
32-bit lmgrd with a 32-bit Cameo daemon bit lmgrd with a 64-bit Cameo daemon vendor
vendor file. file.
19.0 and earlier We recommend using 32-bit lmadmin or We recommend using 64-bit lmadmin or 64-
32-bit lmgrd with a 32-bit Cameo daemon bit lmgrd with a 64-bit Cameo daemon vendor
vendor file. file.
Linux
• You need to have the glibc libraries installed corresponding to your operating system
architecture.
• You need to create a non-root system user with root privileges and install/run the server
tools(lmadmin/lmgrd) using it:
Method 1 (Redhat/Fedora/CentOS)
For Ubuntu
For Redhat/CentOS/Fedora
2021x • We recommend We recommend using 64-bit lmadmin or 64-bit lmgrd with a 64-bit
using 32-bit Cameo daemon vendor file.
lmadmin installer or
32-bit lmgrd.
19.0 and • We recommend • Please use 32-bit lmadmin installer. Additional 32-bit
earlier using 32-bit libraries need to be installed in the 64-bit multi-arch
lmadmin installer or system to execute them.
32-bit lmgrd. • Alternatively, you can use 64-bit lmgrd version 11.12.1.
Learn more about 11.12.1 installation >>(see page 11)
lsb_release -a
In order to query which lsb library is required for a particular Centos version, the following
command can be executed:
Installation procedure
1. Install the FlexNet license server manager.
For the instructions on how to create a daemon, refer to Automatic Start in:
• License Administration Guide. FlexNet Publisher 2020 R2 (11.17.0)8
2. Place the vendor daemon - Cameo into the FlexNet server install folder. If you use lmadmin, do
the following:
a. Open the FlexNet server install folder.
• On Linux
chmod g+x FNPLicenseServerManager/
8 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
3. Start the server (as a service), or using the command line manually by running the lmadmin file
from the FlexNet server installation directory.
If you come across any issues while installing/running the software, please refer to Troubleshooting(see
page 25).
On this page
Prerequisites
• You have downloaded11 the installation files of:
• the FlexNet license server manager.
• the vendor daemon - Cameo.
The license server manager (e.g., lmadmin) should be of the same or later version as a vendor
daemon - Cameo you use.
To use lmadmin on Windows platforms, the Microsoft Visual C++ 2013 Redistributable Package
must be installed. You have an option to install this package during the FlexNet Publisher
License Server Installer process.
9 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
10 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
11 https://docs.nomagic.com/display/NMDOC/Downloading+installation+files
• You can run lmadmin (11.12.1) We recommend using 32-bit We recommend using 32-bit
on these officially supported lmadmin or 32-bit lmgrd with a lmadmin. Additional 32-bit
platforms: 32-bit Cameo daemon vendor libraries need to be installed in the
• Windows 8 file. 64-bit multi-arch system to
execute them.
• Windows
Server
2012
• Windows
Server
2008
• Windows 7
(Ultimate)
• Windows
Vista
(Ultimate)
• You can run lmadmin (11.14)
on these officially supported
platforms:
• Windows
10
• Windows
Server
2008,
including
SP1, SP2,
and R2
• Windows 8
• Windows
8.1
• Windows 7,
including
SP1
• Windows
Server
2012 R2
• Windows
Server
2012
• You need to have the • We recommend using the • We recommended using 32-bit
glibc libraries installed 32-bit lmadmin installer or lmadmin and 64-bit lmgrd for 64-
corresponding to your 32-bit lmgrd. bit multi-arch systems.
operating system • You need to install the • For version 11.12.1 we
architecture. Linux Standard Base (LSB) recommend either using the 32-
• You need to create a library. bit lmadmin installer (for multi-
non-root system user arch systems), or the 64-bit
with root privileges and lmgrd:
install/run the server For Ubuntu
tools using it:
Installing 32-bit lmadmin on a
sudo apt-get multi-arch machine will require
install lsb-
This can be achieved 32-bit libraries.
either by: core
For recent Ubuntu
1. Adding the user to For Redhat/CentOS/
the 'sudo' group Fedora
sudo apt-get install
2. Editing the file /etc/ libc6-i386
sudoers using visudo. apt-get update
sudo yum
Method 1 (Ubuntu install sudo apt-get install
based) redhat-lsb- lsb-core
core
For older Ubuntu use
sudo adduser
newuser
sudo usermod sudo dpkg --add-
-aG sudo architecture i386
newuser apt-get update
sudo apt-get install
Method 2 (Ubuntu libc6:i386
based) libncurses5:i386
libstdc++6:i386
sudo apt-get install
Modify '/etc/ lsb-core
sudoers' with
the editor For Redhat/CentOS/Fedora
"visudo".
#Edit the
file with sudo apt-get install
visudo: lsb-core
[root@mylinux
~]# visudo For Redhat/CentOS/Fedora
#Find a line
sudo yum install
'User
redhat-lsb-core
privilege
specification
' and add the • For version 11.14 we recommend
following. either using the 32-bit lmadmin in
newuser staller, or the 32-bit lmgrd for
ALL=(ALL) ALL multi-arch systems. 64-bit 11.14
lmadmin/lmgrd binaries are
Method 1 (Redhat/
not available.
Fedora/CentOS)
For Redhat/CentOS/Fedora
export
LD_LIBRARY_PATH=$LD_
LIBRARY_PATH:/opt/
FNPLicenseServerMana
ger
lsb_release -a
In order to query which lsb library is required for a particular Centos version, the following
command can be executed:
Installation procedure
1. Install the FlexNet license server manager.
For the instructions on how to create a daemon, refer to Automatic Start in:
• License Administration Guide. FlexNet Publisher 2014 R1 (11.12.1)13
• License Administration Guide. FlexNet Publisher 2019 R2 (11.16.4)14
2. Place the vendor daemon - Cameo into the FlexNet server install folder. If you use lmadmin, do
the following:
a. Open the FlexNet server installation folder.
13 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
14 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
3. Start the server by running the lmadmin file from the FlexNet server installation directory.
If you come across any issues while installing/running the software, please refer to Troubleshooting(see
page 25).
1. Log on to the FlexNet License Server management Web interface. The default address is http://
localhost:809015 or use your server name (http://<server name>:8090). If connection is
established, the FlexNet server is running.
2. Check the lmadmin task status in:
• Task Manager on Windows
• Activity Monitor on OS X
• System Monitor on Linux
If the status is Running, the FlexNet server is running.
3. Open the lmadmin.log file which can be found in <lmadmin installation directory>\logs. Lines in the
following example identify that lmadmin is successfully started and the FlexNet server is running:
2015-12-09 20:28:31,781 root.LicenseEngine started without redundancy.
2015-12-09 20:28:31,958 root.Vendor (cameo) started.
2015-12-09 20:28:31,778 root Version: 11.13.1.0 build 166859
(2015.06.16-10.40.53)
15 http://localhost:8090/
Prerequisites
• The FlexNet license server is installed.
• You have the license key.
Procedure
1. Start the FlexNet license server.
2. Import the license key to the FlexNet license server.
1. Connect to the FlexNet License Server management Web interface. Use the default address (http:
//localhost:809020) or your server name (http://<server name>:8090).
2. Click Administration at the top-right corner of the webpage. When prompted to sign in, enter
the default administrator's credentials (admin/admin).
3. In the FlexNet License Administrator's webpage, click Vendor Daemon Configuration on the
left.
4. Click Import License and select the received license key file.
5. Click the Import License button.
If you want to re-import the license key file, select the Overwrite License File on
License Server check box.
16 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
17 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
18 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
19 https://docs.nomagic.com/display/NMDOC/Support
20 http://localhost:8090/
• Determine the Host ID or Target ID of the machine on which the FlexNet license server is
installed(see page 20)
• using lmadmin.
• using lmhostid.
To determine the Host ID/Target ID of the machine on which the FlexNet license server is installed
(using lmadmin)
2. Click Administration at the top-right corner of the webpage. When prompted to sign in, enter
the default administrator's credentials (admin/admin).
3. Copy the Host ID/Target ID displayed as Ethernet Address (as in the following figure).
The lmhostid is a command line utility, which prints the Host ID/Target ID that a FlexNet license server
requires on any supported system. The Lmhostid utility is available as an executable called lmutil.
To determine the Host ID/Target ID of the machine on which the FlexNet license server is installed
(using lmhostid)
21 http://localhost:8090/
22 https://docs.nomagic.com/display/NMDOC/Downloading+installation+files
If two or more Ethernet addresses are available on the particular machine, the first one printed
by the Host ID command should be used.
• You upgrade products to the new version that uses the floating license.
• The Ethernet Address (Host ID/Target ID(see page 20)) of the machine on which the FlexNet license
server is installed changes.
To replace a license key
1. Add the license key to the FlexNet license server(see page 19) (or use the alternative*).
2. Restart the Vendor Daemon - Cameo:
a. Connect to the FlexNet License Server management Web interface.
* You can copy the new license key directly to a specific location in the floating license server
installation folder rather than importing the file by using lmadmin. Use this method as an alternative if
you cannot import the license key.
To add a new license file to the floating license server by copying it directly to a specific location
1. Go to the folder the new license file is stored in and copy the file.
2. Go to <floating license server installation directory>\licenses\cameo and paste the file.
3. Connect to the FlexNet License Server management Web interface. Use the default address (http:
//localhost:809026) or your server name (http://<server name>:8090).
4. Sign in as the administrator.
5. On the left side menu, click Vendor Daemon Configuration.
6. In the appropriate cameo vendor daemon row, click the Administer button.
7. Click the Reread License Files button. If the license file is successfully imported, you will see an
appropriate message on the webpage.
23 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
24 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
25 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
26 http://localhost:8090/
1. Connect to the FlexNet License Server management Web interface. The default address is http://
localhost:8090/ or use your server name (http://<server name>:8090).
2. Open the Dashboard.
3. Click Concurrent. All active licenses are listed in a table.
Request a new license key for a new machine from your sales representative. Determine the
Host ID/Target ID(see page 20) of the new machine and provide it to sales representative.
27 http://localhost:8090/
28 http://docs.nomagic.com/
29 https://docs.nomagic.com/download/attachments/70388394/fnp_LicAdmin_11_17_0.pdf?
api=v2&modificationDate=1611149745747&version=1
30 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11.16.4.pdf?
api=v2&modificationDate=1611149745448&version=1
31 https://docs.nomagic.com/download/attachments/70388387/fnp_LicAdmin_11_12_1.pdf?
api=v2&modificationDate=1611149745409&version=1
Useful commands
• Find out the shared object dependencies in Linux. The result can show what files are missing
libraries to run that file.
ldd <file_name>
file <file_name>
• Launching lmgrd manually via command line. lmgrd, cameo, and license file must be in the same
directory:
license_file_name - the path to the license file. Can use only the license file name if all files are in the
same directory.
logfile_name - the path to the log file. Can use only the license file name if all files are in the same
directory. Make sure the files have read/write privileges.
server_port - the port the server is operating on (Not the cameo daemon port)
Troubleshooting
On this page
The error message is misleading, the solution to fix it, is to install the 32-bit libraries.
In Redhat/CentOS/Fedora:
32 https://docs.nomagic.com/display/NMDOC/Downloading+installation+files
Also, it may mean that you are using a 64-bit executable in a 32-bit system and vice versa.
e.g. if your lmadmin installation is at /opt/FNPLicenseServerManager then adding it to the path would
look like this:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/FNPLicenseServerManager
• When you try to launch the Web server (http://localhost:port35) on the license server, you
encounter an "Unable to connect" error.
• When you attempt to run the license server, you may encounter the following errors:
10:43:19 (cameo) Vendor daemon can't talk to lmgrd (Cannot read data from
license server system. (-16,287))
10:43:20 (cameo) EXITING DUE TO SIGNAL 37 Exit reason 5
In Web.log:
33 http://libssl.so
34 http://libssl.so
35 http://localhostport
• A process listing for lmadmin ('ps aux | grep lmadmin') returns no results.
• A process listing for cameo ('ps aux|grep cameo') returns results if run right after lmadmin is
started but then fails after a few seconds. If you view the cameo.log file in the logs directory (the
default location is /opt/FNPLicenseServerManager/logs), you see that the process failed with the
following error messages:
Therefore, when you are installing lmadmin on a Linux-based system, it is recommended that you avoid
installing as root. If you have already installed lmadmin when logged on as root and you do not want to
reinstall lmadmin, change the ownership of all of the files in the installed folder from root to another
user
This means that directory /usr/tmp used by lmgrd is missing on your system (usually on Ubuntu
systems). This error does not impact license checkout.
ln -s /tmp /usr/tmp
or
sudo ./<lmadmin_installer>
#!/bin/bash
echo "==============="
echo "Installing wget"
echo "==============="
sudo yum install -y wget
echo "=================="
echo "Installing lmadmin"
echo "=================="
sudo getent group lmadmin >/dev/null || groupadd -r lmadmin
sudo getent passwd lmadmin >/dev/null || useradd -d /home/lmadmin -g lmadmin -m -r
lmadmin
sudo yum install -y ld-linux.so.2
LSB=$(yum provides /lib/ld-lsb.so.3 | grep lsb-core | tail -1 | cut -f 1 -d ' ')
sudo yum install -y $LSB
sudo echo "lmadmin ALL=(ALL) NOPASSWD:ALL " >> /etc/sudoers
# If Web GUI to Flex licensing is not a must - lmgrd can be used, can be placed in
rc.local to startup on boot
# usage - ./lmgrd -c PATH_TO_KEY_FILE -l PATH_TO_LOG_FILE
# RW rights needed to both files
echo "==========================================================="
echo "Getting Linux 32-bit IPv6 version 11.14 from AWS FrontCloud"
echo "==========================================================="
wget http://d1g91r27pzl568.cloudfront.net/Cameo_daemon/FlexNet_11_14/ipv6/linux/
lnx_32/cameo
chmod +x cameo
echo "========================================"
echo "Getting Linux 32-bit lmgrd version 11.14"
echo "========================================"
wget https://d1oqhepk9od1tu.cloudfront.net/Flex_License_Server_Utilities/v11.14/
linux32/lmgrd
chmod +x lmgrd
echo "======================================"
echo "Making flex log file named FlexLog.log"
echo "======================================"
touch FlexLog.log
chmod 664 FlexLog.log
echo "=========================================="
echo "Getting Linux 32-bit lmadmin version 11.14"
echo "=========================================="
wget https://d1oqhepk9od1tu.cloudfront.net/Flex_License_Server_Utilities/v11.14/
linux32/lmadmin-i86_lsb-11_14_0_0.bin
chmod +x lmadmin-i86_lsb-11_14_0_0.bin
echo "========================================="
36 http://nomagic.com
If you run into any further problems with installation, please try:
37 http://www.nomagic.com/support/faq.html
38 https://community.nomagic.com/
39 https://docs.nomagic.com/display/NMDOC/Support
Lmadmin 6
L Lmadmin_run_as_service 6