FLOATING LICENSE

version 17.0.1
user guide

No Magic, Inc.
2011
All material contained herein is considered proprietary information owned by No Magic, Inc. and is not to be
shared, copied, or reproduced by any means. All information copyright 2000-2011 by No Magic, Inc. All Rights
Reserved
CONTENTS 1
Concepts 4
What is Floating License? 4
How does license server works? 4
How does a client application obtain the floating license? 4
What if the connection with the license server is lost? 5
Floating licenses on a Laptop 5
Borrowing - offline license mode 5
Floating Licenses and Teamwork Server 5
Updating license 5
License Server Manager 5
Structure of FlexNet license server 6
License usage analysis 6
Server configuration capabilities 7
Server alerts 7
Installing and unlocking FlexNet License Server 7
Installing FlexNet license server on Windows 7
Installing FlexNet license server on Mac OS 9
Installing FlexNet license server on Linux 11
Unlocking FlexNet license server 13
Requesting a license 14
Determining a hostid 15
Toubleshooting for starting FlexNet license server 15
Starting MagicDraw and Connecting to the FlexNet License Server 15
The commercial FlexNet license activation 18
Connecting offline to FlexNet license server 18

3 Copyright © 2000-2011 No Magic, Inc.

 FLOATING LICENSE

Floating license is now supported by the FlexNet license server. MagicDraw Floating License Server is not
used any more starting with MagicDraw version 16.8.

All detailed instructions about managing and configuring the FlexNet license server you may find in License
Administration Guide that is available at http://www.globes.com/support/fnp_utilities_download.htm. You can
find more information for FlexNet license server managers (lmadmin and lmgrd) as well as information about
utilities, and documentation for administrators and end users on that page.
NOTE The FlexNet license server is compatible with v16.8 (and later) client applications. In
order to use v16.6 and v16.8 floating licenses simultaneously, both No Magic
Floating Server and the FlexNet license server installations are needed.

Concepts

What is Floating License?

FL (Floating License) allows you to install and use the same license (i.e. MagicDraw Standard, Professional.
Enterprise Edition, or Plugins) on multiple machines. Suppose you have 10 workstations where MagicDraw is
used. In most cases there are less than 10 users concurrently using MagicDraw. Instead of purchasing 10
Professional (or Standard) seat licenses, only purchase the number of Floating Licenses to support the number
of concurrent users. Floating License(s) are usually more economical in development centers than purchasing
individual seat licenses.

How does license server works?

Whenever you obtain Floating License you may install MagicDraw client application (Standard - Enterprise) on
as many workstations as you need. The license server software (which is free and is provided together with FL
clients) needs to be installed on some computer (which is referred to as a license server). Normally, only one
license server is required in your network.

The license server is provided with the key, which specifies how many and what types of Floating Licenses this
server may serve. The same server may serve different numbers of different Editions and plugins licenses, e.g.
2 Standard and 3 Professional FL licenses. In this case, during the connection, you will be asked to select the
edition you want to run - Standard, Enterprise, or Professional.

Note: To serve No Magic products licenses, the license server requires the cameo vendor daemon provided by
No Magic Inc. The vendor daemon is responsible for communicating with the No Magic products and issuing
licenses.

How does a client application obtain the floating license?

In order to work with the FL client, you will need to specify the address of the license server and port (1101 by
default) and connect to it. Every time FL client connects to the license server it checked out a license from that
server and the number of available licenses on this server is decreased. If all available licenses from the server
are leased, the next client who wants to obtain a license must wait until one of the other client's finishes its work
and the license is returned back to the license server.

4 Copyright © 2000-2011 No Magic, Inc.

FLOATING LICENSE
Concepts

What if the connection with the license server is lost?

Whenever FL client leases the license from the license server, it constantly updates the server with the
message that it is still alive. The license server in turn acknowledges that the license is still valid. If the
connection with the server is lost, the client application will not receive acknowledgements from the server and
the client application will be gracefully terminated (MagicDraw forces you to save your work and close the
application or try to reconnect again). In the case of no update from the client, the license server considers the
license to be returned and it is available to other clients.

Floating licenses on a Laptop

Floating Licenses are primarily intended for workstations directly connected to a network. However, a portable
computer that is connected to the Internet and can contact the license server, may use a Floating License as
well.

Borrowing - offline license mode

If a license will to be used on a computer that is intermittently connected to the license server, that license can
be borrowed from server and used as an offline floating license. A license can be borrowed from a license
server for the selected period of time (default 24 hours) via Select Edition/Plugin in application. The borrowed
license is used as an application on a computer that is no longer connected to the license server.

The maximum license borrowing period is one year. If you would like to limit the maximum borrowing period,
please contact your account executive.

Floating Licenses and Teamwork Server

Floating Licenses are treated the same way as seat licenses, i.e. MagicDraw FL client applications work with
the Teamwork Server. The Teamwork Server software does not serve Floating Licenses. A license server works
in conjunction with the Teamwork Server.

Updating license
Upon updating license in the license server, all products licenses in the server are updated with the ones in the
profile on www.magicdraw.com from which license key is used.

License Server Manager

FlexNet license server is used to manage floating licenses. The license server manager is one of the
components that makes up a license server (the other being the vendor daemon). There is available a Web-
based license server manager with the graphical user interface (GUI) - lmadmin.

A brief FlexNet license server advantages and capabilities:

• Intuitive license management with rich graphical user interface provided by lmadmin.
• Easy to perform general license management tasks, such as configuring license and stopping
servers.
• Easy accessible picture of license status - how many licenses are available and who is using
them.
• Ability to report on the duration a product is in use.
• Alerts if licenses are running low, unavailable, etc.

5 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Concepts

• Allow/deny/reserve products to be used by specific users, hosts, and groups.

• Log file is generated, containing products usage information.

Structure of FlexNet license server

Figure 1 -- The structure of FlexNet license server

Vendor daemon - one of the files that is a part of the license server. This executable is customized and built by
No Magic Inc. To serve No Magic Inc. products licenses, license server requires cameo vendor daemon.

License file - a text file, usually with the .lic or .txt extension, which contains license certificates.

Options file - a configuration file available on the license server, which license administrators can use to allow
/ deny / reserve products to be used by specific users, hosts, and groups.

Report log file - a file that runs on a license server, which contains data about the features used by a single
vendor daemon. Report logs are encrypted and cannot be read by a person, but are used by FlexNet Manager
to produce reports.

Debug log file - a file used by the license server to record status and error messages that are useful for
debugging the license server. Each license server can have one or more of these files.

lmadmin - the new license server manager, which includes a Web-based GUI.

lmgrd - a command-line-based license server manager.

License usage analysis

FlexNet Manager is the only solution with the direct access to the Flex license usage information - enabling
enterprises to track and manage their FlexEnabled software with the most comprehensive and accurate usage
reports.

Use Flexera Software license administration solution, FlexNet Manager, to gain exceptional visibility into
license usage data and to create insightful reports on critical information like license availability and usage.
FlexNet Manager can be fully automated to run these reports on schedule and can be used to track license

6 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

servers and usage across a heterogeneous network of server including Windows NT, Linux and UNIX. Contact
Flexera Software at www.flexerasoftware.com for more details on how to obtain an evaluation copy of FlexNet
Manager for your enterprise.

Server configuration capabilities

The License Server options file allows the license administrator to control various operating parameters within
the constraints of the license model. The user is identified by his/her user name, host name, display, IP
address, and other.

For the concurrent (floating) licenses, the license administrator can perform the following actions:
• Allow / deny / reserve products to be used by specific users, hosts, and groups.
• Restrict the number of licenses available.

For more information, see "Managing the Options File" section in the License Administration Guide.

Server alerts
The license server alerts when there are no available licenses or the server is down.

Alerts can be configured. You may set up lmadmin to issue alerts and warn you of potential problems. For
example, you may set up to get alerts on license expiry or vendor daemon status.

Optionally you may use an lmadmin email alerter service. This service will poll for alerts and then send a user
an email when an alert has been triggered.

For more information, see “Creating an lmadmin Alerter Service section” in the License Administration Guide.

Installing and unlocking FlexNet License Server

FlexNet License Server runs on the following operating systems:
• AIX® 32bit / 64bit
• HP-UX® 32bit / 64bit
• Linux 32bit / 64bit (Linux Standard Base (LSB) 3.0)
• Mac®OS 32-bit / 64-bit (Mac OS X 10.4, 10.5 and 10.6)
• Red Hat® Linux 64-bit
• SGI 64-bit
• Windows Server 2003, 2008 32bit and 64bit
• Windows Vista (Ultimate), Windows 7 (Ultimate) 32bit and 64bit

IMPORTANT! Sun OS/Solaris is not supported by No Magic Cameo vendor daemon.

For the FlexNet publisher requirements, see http://www.flexerasoftware.com/products/flexnet-publisher/

requirements.htm.

Installing FlexNet license server on Windows

1. Download the Vendor daemon – cameo (from our site).

7 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

2. If you have no FlexNet server installed, download and install it. We recommend using web-
based server – lmadmin (download it from Flexera Software site).
3. Add the Vendor daemon into the installed server. If you are using lmadmin, create licenses/
cameo directories under <installation directory for lmadmin> and place the Vendor daemon file
cameo under .../<installation directory for lmadmin>/licenses/cameo.

Figure 2 -- Vendor daemon should be added into the <installation directory for lmadmin>/licenses/cameo

4. To start the server, run the lmadmin file from the user installation directory.
5. Read the hostid provided by your license server. To determine a hostid, refer to Determining a
Host ID instructions.

8 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

6. Go to the license owner account at www.magicdraw.com/LicenseActivationManagement. Click

the Create New License Activation Record button and enter user details and the Host ID of
the machine.

Figure 3 -- Hostid is requested in the License List on www.magicdraw.com

7. Request for the license key file. For the exact steps, refer to the License request instructions.
Note: Do not save a license file in the same directory with the Vendor daemon.
8. Unlock the server with the obtained “FlexNet license server key.*” file. For the exact steps, refer
to the license server unlock instructions. If you do not have a license file, refer to the License
request instructions.

Related topics
Requesting a license
Unlocking FlexNet license server
Determining a hostid

Installing FlexNet license server on Mac OS

1. Download the Vendor daemon – cameo (from our site).

2. If you have no FlexNet server installed, download and install it. We recommend to use web-
based server – lmadmin (download it from Flexera Software site).

9 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

3. Add the Vendor daemon into the installed server. If you are using lmadmin, create licenses/
cameo directories under <installation directory for lmadmin> and place the Vendor daemon file
cameo under .../<installation directory for lmadmin>/licenses/cameo.

Figure 4 -- Vendor daemon should be added into the <installation directory for lmadmin>/licenses/cameo

NOTE When opening the FlexNet directory, the following message appears:
The folder “FNPLicenseServerManager” can't be opened because you
don't have permissions to see its content.

You can change permissions for the directory by executing the

following commands from the root:
chmod g+x FNPLicenseServerManager/
chmod –R g+w ./*

4. To start the server, run the lmadmin file from the user installation directory.
5. Read the hostid provided by your license server. To determine a hostid, refer to Determining a
Host ID instructions.

10 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

6. Go to the license owner account at www.magicdraw.com/LicenseActivationManagement. Click

the Create New License Activation Record button and enter user details and the Host ID of
the machine.

Figure 5 -- Hostid is requested in License List on www.magicdraw.com

7. Request for the license key file. For the exact steps, refer to the License request instructions.
Note: Do not save a license file in the same directory with the Vendor daemon.
8. Unlock the server with the obtained “FlexNet license server key.*” file. For the exact steps, refer
to the license server unlock instructions. If you do not have a license file, refer to the License
request instructions.

Related topics
Requesting a license
Unlocking FlexNet license server
Determining a hostid

Installing FlexNet license server on Linux

1. Download the Vendor daemon – cameo (from our site).
2. If you have no FlexNet server installed, download and install it as a root. We recommend to use
web-based server – lmadmin (download it from Flexera Software site).

11 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

3. Add the Vendor daemon into the installed server. If you are using lmadmin, create licenses/
cameo directories under <installation directory for lmadmin> and place the Vendor daemon file
cameo under .../<installation directory for lmadmin>/licenses/cameo.

Figure 6 -- Vendor daemon should be added into the <installation directory for lmadmin>/licenses/cameo

Note When opening the FlexNet directory, you are informed that you don’t
have permissions to open it.
You can change permissions for the directory by executing the
following command from the root:
chmod g+x FNPLicenseServerManager/

4. To start the server, run the lmadmin file from the user installation directory.

Important! Linux Standard Base (LSB) library should be installed.

5. Read the hostid provided by your license server. To determine a hostid, refer to Determining a
Host ID instructions.

12 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

6. Go to the license owner account at www.magicdraw.com/LicenseActivationManagement. Click

the Create New License Activation Record button and enter user details and the Host ID of
the machine..

Figure 7 -- Hostid is requested in License List on www.magicdraw.com

7. Request for the license key file. For the exact steps, refer to the License request instructions.
Note: Do not save a license file in the same directory with the Vendor daemon.
8. Unlock the server with the obtained “FlexNet license server key.*” file. For the exact steps, refer
to the license server unlock instructions. If you do not have a license file, refer to the License
request instructions.

Related topics
Requesting a license
Unlocking FlexNet license server
Determining a hostid

Unlocking FlexNet license server

1. Open the Web browser and browse to the license server management interface: http://
<server>:8080.

13 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Installing and unlocking FlexNet License Server

2. Login with the administrator’s rights. The default login and password is admin (please change
it!).

Figure 8 -- Login as administrator. Default login and password is admin

3. Go to the Vendor Daemon Configuration (left side menu).

4. Click Import License and browse to the License file.

NOTE If the Ethernet address of the machine under which lmadmin is running
has been changed, please reinstall lmadmin before applying the key
locked to the new host.

Requesting a license
1. Login with the user name and password into your or your company profile on
www.magicdraw.com.
2. Go to the License List (right side menu) and enter hostid, where hostid is requested. Click the
Send All Keys button.

14 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Starting MagicDraw and Connecting to the FlexNet License Server

3. All unlock keys will be sent to the e-mail provided in your account. From this page, you may
also send or download each unlock key separately.

NOTE FlexNet license server is compatible with v16.8 (and later) client applications. In
order to use v16.6 and v16.8 floating licenses simultaneously, both No Magic
Floating Server and FlexNet License Server installations are needed.

Determining a hostid

To determine a hostid using lmadmin (recommended)

1. Open the Web browser and browse to the license server management interface: http://
<server>:8080.
2. Go to System Information (left side menu) and copy the Ethernet Address.

To determine a hostid using lmhostid

• The lmhostid is a command line utility, which prints the hostid that a FlexNet license server
requires on any supported system. The Lmhostid utility is available as an executable called
lmutil. Download it for a particular OS from: http://www.globes.com/support/
fnp_utilities_download.htm. Run lmutil with lmhostid parameter from the command line.
Lmhostid displays the default hostid for the current platform.

For exact commands for specific operating system refer to: License Administration Guide (Obtaining System
Hostids)

NOTE If two or more Ethernet addresses are available on the particular

machine, the first one printed by the hostid command should be used.

Toubleshooting for starting FlexNet license server

If you cannot start the FlexNet license server, make sure that the demo vendor daemon is not expired.

Information about demo vendor daemon expiration is displayed in the Imadmin.log file lines:
041 root.Vendor (demo) stopped.
042 root.LicenseEngine (demo) exited with status 47. (demo version has expired).

Imadmin.log file can be found in the FlexNet installation directory.

In order to start lmadmin without the demo vendor daemon, you need from the server.xml file remove the
following line:
<daemon dateBasedVersion=“false” dlog=“false” executable=“demo/demo”
license=“demo/demo.lic” logFile=“logs/demo.log” logOverwrite=“false” name=“demo”
port=“0” restartRetries=“3” />

The server.xml file can be found in the <FlexNet installation directory>/Conf directory.

Starting MagicDraw and Connecting to the FlexNet

License Server
After the FlexNet license server is started, you can connect to the server with MagicDraw.

15 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Starting MagicDraw and Connecting to the FlexNet License Server

1. Run a copy of the client version of MagicDraw. To obtain Floating License, click the Use
Floating License button on the first MagicDraw startup.

Figure 9 -- The MagicDraw License Manager dialog

NOTE If MagicDraw is started as Standalone, by changing the unlock key, you can change
the license to the Floating license. To change the license, from the MagicDraw Help
menu select the MagicDraw License Manager. In the opened MagicDraw
<version number> License Manager dialog, click Use Floating License.

16 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Starting MagicDraw and Connecting to the FlexNet License Server

2. The FlexNet License Server Connection dialog appears. Enter the server host name or IP
and port number (1101 by default). Click OK.

Figure 10 -- The FlexNet License Server Connection dialog

NOTE • Host name/IP, where you have started the floating license server
• Default port number is 1101.

3. The Select Edition/Plugin dialog appears. Select an available edition and click OK.

Figure 11 -- The Select Edition/Plugin dialog

17 Copyright © 2000-2011 No Magic, Inc..

FLOATING LICENSE
Starting MagicDraw and Connecting to the FlexNet License Server

4. MagicDraw is started. You can start working with MagicDraw. For more information about
working with MagicDraw, see MagicDraw UserManual.pdf..

NOTE If you would like to work on the computer that is not connected to the FlexNet license
server, you may choose to work offline, although you must first connect to the
FlexNet server online.

The commercial FlexNet license activation

The commercial license activation is required after the purchase transaction has been completed. The
activation process allows receiving the commercial license dedicated for the particular machine.

The full and updated information about commercial license activation you may find at http://
www.magicdraw.com/CommercialLicenseActivation.
NOTE Only commercial activated licenses are locked to the particular
machine.

: Activating the commercial FlexNet license

1. Login to the license owner account at www.magicdraw.com.

2. Click the License Activation Management item in the Members menu (right hand selection).
3. Click the Create New License Activation Record button and enter user details and Host ID of
the machine.
4. Download the license key file or send the key file in the email.
5. Go to FlexNet license server and browse for the saved license key file.

NOTE FlexNet license server is compatible with v16.8 (and later) client
applications. In order to use v16.6 and v16.8 floating licenses
simultaneously, both NoMagic Floating Server and FlexNet License
Server installations are needed.

Connecting offline to FlexNet license server

If you like to work on the computer that is not connected to the FlexNet license server, you may choose to work
offline, although you must first connect to the FlexNet license server online.

To connect offline to the FlexNet license server

• Select the Offline radio button in the Select Edition and Version dialog.

Default offline connection time is 24 hours.

If offline session ends at weekend, the session time is prolonged respectively uncounted weekend hours.

When you are working with FlexNet license server and Offline connection session time ends, the message
about finished session is displayed.

To finish Offline Floating license session

• From the Help menu choose the Finish Offline License Session command and then click
Yes, to close MagicDraw.
NOTE This command is enabled only then Offline connection is selected.

18 Copyright © 2000-2011 No Magic, Inc..