June 1, 2012 Lattice Technology Co.,Ltd.

XVL Products
License Management Guide

THIS IS A CONFIDENTIAL DOCUMENT. IT CONTAINS PROPRIETARY TECHNICAL

INFORMATION OF LATTICE TECHNOLOGY WHO ISSUED THIS DOCUMENT. DO NOT
DISTRIBUTE OR POST THAT INFORMATION WITHOUT PERMISSION FROM LATTICE
TECHNOLOGY.

For any kind of support of this document and the licenses of XVL products, please contact the distributing
representative.

Copyright © 2001-2012 Lattice Technology Co.,Ltd. All rights reserved.

1
 XVL Products License Management Guide

Table of contents

1 Introduction................................................................................................................................................................8
2 Outline of License Management..............................................................................................................................8
2.1 License model of XVL products.......................................................................................................................8
2.2 Names of license files......................................................................................................................................10
3 Installation of License Files....................................................................................................................................13
3.1 Node-locked license.........................................................................................................................................13
3.1.1 Installing license files ...............................................................................................................................13
3.1.2 Setting up license files..............................................................................................................................15
3.1.3 Replacing license files..............................................................................................................................15
3.2 Floating license ................................................................................................................................................15
3.2.1 Installing license files ...............................................................................................................................15
3.2.2 Setting up license files..............................................................................................................................17
3.2.3 Replacing license files..............................................................................................................................17
4 License Server Setup...............................................................................................................................................18
4.1 System requirements........................................................................................................................................18
4.2 Installing license server....................................................................................................................................19
4.3 Setting up license server ..................................................................................................................................19
4.4 Starting up license server.................................................................................................................................23
4.5 Checking license server...................................................................................................................................24
4.6 Shutting down license server...........................................................................................................................24
4.7 Replacing license server..................................................................................................................................25
4.8 Reloading license files.....................................................................................................................................25
5 Command Line Operation of License Server .......................................................................................................26
5.1 Starting up license server.................................................................................................................................26
5.2 Checking license server...................................................................................................................................27
5.3 Shutting down license server...........................................................................................................................28
5.4 Rereading license files.....................................................................................................................................29
5.5 Registering license files as environment variables ........................................................................................29
6 Redundant Server Setup .........................................................................................................................................30
7 Uninstallation of License Server ............................................................................................................................31
8 Setup by Option File ...............................................................................................................................................31
9 License Files of XVL Products ..............................................................................................................................33
9.1 Files for node-locked license...........................................................................................................................34
9.2 Files for floating license...................................................................................................................................34
9.3 Creating the license server configuration file.................................................................................................36
9.4 List of features..................................................................................................................................................37
10 Collecting Up License Files of XVL Products....................................................................................................41
11 Troubleshooting.....................................................................................................................................................42
11.1 Error messages and countermeasures...........................................................................................................42

2
 XVL Products License Management Guide

11.2 Obtaining error numbers by log file..............................................................................................................44

11.3 If troubles are not solved................................................................................................................................45

3
 XVL Products License Management Guide

Trademarks and registered trademarks

XVL is a registered trademark of Lattice Technology, Co.,Ltd.

Microsoft, Windows, and Visual C++ are registered trademarks of Microsoft Corporation in the U.S. and/or
other countries.
The official name for Windows is Microsoft Windows Operating System.
The names of actual companies and products mentioned herein may be the trademarks or the registered
trademarks of their respective owners.

4
 XVL Products License Management Guide

Release Notes

• 2012/6/1
- Applied functions to XVL License Manager Ver. 5.0.
- Added information on the use of 64-bit-edition products in client systems.
- Modified the text to change FLEXlm to FlexNet Publisher.
• 2011/12/5
- Added the description about products.
- Corrected the product names.
• 2011/4/28
- Corrected the description about products.
• 2010/10/29
- Added the description of redundant server application.
- Modified the description of command line operation.
• 2010/9/30
- Modified the description about the option file.
• 2010/3/26
- Corrected the description about products.
- Modified an error message for troubleshooting section.
• 2008/10/10
- Corrected the description about FLEXlm.
• 2008/9/5
- Corrected the description about products.
• 2008/7/31
- Added the description about products.
• 2008/3/14
- Added the description about products.
• 2007/11/16
- Added the description about products.
• 2007/9/28
- Added the description about the license version and products.
- Added error messages.
• 2007/7/27
- Added the description about the license for XVL-STEP Converter.
• 2007/6/15
- Added the description about products and deleted support-expired products.
- Added an error message for troubleshooting section.
- Corrected some mistakes.
• 2006/12/15
- Modified the description about version of products.
- Modified the description about the command line arguments.
• 2006/8/31

5
 XVL Products License Management Guide

- Added the license for XVL Studio Pro/Standard/Basic.

- Added the description about the license for XVL Notebook Standard.
• 2006/7/31
- Added the description about the license for evaluation.
- Added the description about the log file to the option file.
• 2006/1/20
- Added the description about the license server configuration file, which enables to set up the same
license server on the client system side.
- Added the description about the options common to XVL Studio Pro/Standard/Basic.
• 2005/6/15
- Added the precautions for uninstalling license server.
• 2004/11/15
- Added the description about the license of XVL Studio Standard/Basic.
• 2004/10/30
- Added the description about the floating license of XVL-3ds Max Converter.
- Modified the description about the term to borrow license.
• 2003/8/20
- Added the description about the limitation of the number of licenses, set in the option file.
• 2003/3/31
- Updated the version to 3.0.
- Updated the version of xvllm.exe and lmgrd.exe to 8.3c.
- Added the description about the option file enabling license server setup.
- Added the description about the method of not installing the license file for each client in the event of
floating license.
- Added the notice of network environment with firewall.
• 2003/1/31
- Updated the version to 2.4.
- Added the description about the license of XVL Notebook and XVL-3ds Max Converter.
• 2002/11/29
- Updated the version to 2.3.
- Modified only the License Management Guide.
- Added the description about the licenses of XVL Converter Enterprise and XVL Converter Light.
• 2002/7/31
- Updated the version to 2.2.
- Modified only the License Management Guide.
- Added the function to borrow the license of XVL Player Pro.
- Added the description about the methods of how to collect up multiple floating licenses in a particular
file (xvlproducts.ltl) and how to set up the license server by using xvlproducts.ltl.
• 2002/4/30
- Updated the version to 2.1.
- Modified only the License Management Guide.
- Added the description about installation of the license file of XVL Player Pro to the License
Management Guide.

6
 XVL Products License Management Guide

• 2002/3/31
- Updated the version to 2.0.
- The version of xvllm.exe and lmgrd.exe is 8.1a.
- Added the function to borrow the license, so that, in the event of floating license, the user will get the
license for a fixed period of time although you are distant from the network.
• 2001/12/31
- First version.
- The version of xvllm.exe and lmgrd.exe is 7.2i.

7
 XVL Products License Management Guide

1 Introduction

The XVL Products License Management Guide describes the important information for managing the license
of all XVL products and for installing the license file, in the following chapters.
• Outline of license management
• Node-locked license
• Floating license
• License server setup
• License files of XVL products
• Troubleshooting

Expressions used in the Manual

This guide uses simple expressions as far as possible and the description is based on the default settings. For
setup procedures and others, however, you may need the basic knowledge of Microsoft Windows and its usage.

When you get node-locked license, read the following chapters.

• 2 Outline of License Management
• 3.1 Node-locked license
• 9.1 Files for node-locked license

When you get floating license, read the following chapters.

• 2 Outline of License Management
• 3.2 Floating license
• 6 Redundant Server Setup
• 9.2 Files for floating license

If you are a system administrator, read the following chapters.

• 2 Outline of License Management
• 4 License Server Setup
• 9.2 Files for floating license

2 Outline of License Management

This chapter describes the outline of license of XVL products.

2.1 License model of XVL products

To manage the license of XVL products, they use FlexNet Publisher (manufactured by Flexera Software,
http://www.flexerasoftware.jp/). This is a software-based license management system providing flexible

8
 XVL Products License Management Guide

mechanism to manage license.

When you use an XVL product, FlexNet Publisher authenticates your license. As you get the license file from
the distributing representative, you will install it in an appropriate directory. Then your license, node-locked or
floating, will be effective in your client system. The following describes those three types of license.

• License for evaluation

This type of license enables you to use XVL products for the purpose of evaluation.
XVL products run on any system, while the expiration date is set for use. XVL products will not run
after the expiration date.
• Node-locked license
This type of license enables a particular system to run XVL products. In other words, XVL products
will not run on a non-licensed system. To transfer the license to another system, you need to get
another license for the new system. You cannot use XVL products running on a node-locked licensed
system through Terminal Services such as Remote Desktop of Windows operating system.
• Floating license
This type of license manages the number of issued licenses by using the license server. XVL products
will run on any system if the system connects to the license server until the number of licenses reaches
the maximum. If the license server is not active, you cannot get the license.
The function to borrow the license enables you to get the license for a fixed period of time, up to 30 days,
although you are distant from the network of the license server. For the products available for this
function, refer to 2.2 Names of license files. For the way to enable this function, refer to the Reference
Manual of each XVL product.

The following describes license versions.

A license is valid for the specified version of a product. With the license of one version, the target version and
the next one become available, while the license will be invalid if the version after the next will be installed. In
that event, obtain the new license. Note that minor versions are not counted. For example, Ver. 6.3 and Ver.
6.3b are treated as the same Ver. 6. The license version can be checked from 9.1 Files for node-locked
license and 9.2 Files for floating license.

- Ex.) XVL Studio Pro

If the license file contains the following line, the version 10 is licensed. In this event, XVL
Studio Pro up to Ver. 11 is available.

FEATURE XVLStudioPro2 xvllm 10 permanent uncounted ...

♦ When you use an XVL product on a client system, you need to install the license file according to the
description of 3 Installation of License Files. No particular setup is necessary.

♦ When using 64-bit-edition XVL products in a client system, be sure to set the license server with XVL
License Manager Ver. 5.0 or later.

9
 XVL Products License Management Guide

♦ If you use XVL products under the license for evaluation, do not change the system clock. If it is changed,
the system outputs the error message “the system clock is losing” and XVL products may not run any more.

♦ When you use floating license, the system administrator sets up and activates the license server. The
license server must be active when you start an XVL product on a client system.

♦ When you use floating license, the license server and client systems must satisfy the following conditions.
The system administrator must confirm his/her network environment.

1. TCP/IP is installed.
The license server and client systems communicate by TCP packet. Confirm that TCP/IP is
installed in each client system. In it is not installed, set up TCP/IP.
2. The host name of the license server and the IP address are name-resolved.
If the host name is used to specify the license server, the license server must be set up on the
network whose host name is resolved for the IP address to be referenced from client systems. If
the host name is not resolved, the license server cannot be referenced from a client system by
using the host name, so that the license will not be authenticated. In that event, use the IP
address, DNS, WINS, or other appropriate name resolution system for your network environment,
so as to resolve the host name. This document describes specification using the host name. If
the IP address is used, replace the host name in this document with the IP address.
3. Two TCP ports are open.
When network communication is controlled in your environment, you need two ports in order to
authenticate your license: one is used for communication with the license server, and the other is
used upon activation of application. The operating system dynamically allocates the latter port
in default. Because of this condition, you need to set the TCP port explicitly to enable it. For
details of how to set up ports, refer to 9.2 Files for floating license.

♦ When you use the function to borrow license, the license server must be active. Also as long as you are
using that function, it is regarded that one license is used for a product of each client. For details of how to
check the license in use, refer to 4.5 Checking license server and 5.2 Checking license server. If you
shut down the license server while borrowing a license, refer to the Force Server Shutdown checkbox in 4.6
Shutting down license server or – force option in 5.3 Shutting down license server. Once you borrow a
license, you cannot cancel the license during the specified period of time. So, examine carefully the period
to borrow the license. Before using the function, read the description for FLEXlm error dialog opens and
the operation terminates in 11.1 Error messages and countermeasures.

2.2 Names of license files

Every XVL product has its exclusive license file. When you install license files, refer to the following tables
for the correspondence between XVL products and their license files.

10
 XVL Products License Management Guide

• Node-locked license or floating license

Table 1

XVL products License file name

xvlstudiopro.ltl
XVL Studio Pro *
xvlstudioopt.ltl
xvlstudiostd.ltl
XVL Studio Standard *
xvlstudioopt.ltl
xvlstudiobsc.ltl
XVL Studio Basic *
xvlstudioopt.ltl
XVL Player Pro * xvlplaypro.ltl
XVL Player SDK xvlplaysdk.ltl
XVL Notebook Standard* xvlnotestd.ltl
XVL Notebook Basic* xvlnote.ltl
XVL Converter Plug-in
for Mechanical DeskTop xvltransmdt.ltl
for Inventor xvltransinventor.ltl
for CATIA5 xvltranscatia5.ltl
for I-DEAS xvltransideas.ltl
for Creo Parametric
(Pro/ENGINEER xvltransproe.ltl
in previous versions)
for Creo Elements/Direct
(for CoCreate
in previous versions)
(for SolidDesigner xvltranssd.ltl
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks xvltranssw.ltl
for NX
xvltransug.ltl
(for Unigraphics in previous versions)
for SolidEdge xvltransse.ltl
XVL Converter Plug-in x64
for CATIA5 xvltranscatia5x64.ltl
for Creo Parametric
(Pro/ENGINEER xvltransproex64.ltl
in previous versions)
for SolidWorks xvltransswx64.ltl
XVL-3ds Max Converter xvltransmax.ltl
Lattice3D Reporter * l3dreporter.ltl

A product with an asterisk (*) is available for the function to borrow license.

• Node-locked license

Table 2

11
 XVL Products License Management Guide

XVL products License file name

XVL Signer xvlsign.ltl
XVL Web Master xvlwm.ltl
XVL Converter Server
(XVL Converter Light in previous versions)
for IGES xvlconviges.ltl
for Parasolid xvlconvpara.ltl
for Polygon xvlconvpoly.ltl
for Mechanical Desktop xvlconvmdt.ltl
for Inventor xvlconvinventor.ltl
for CATIA V4 xvlconvcatia4.ltl
for CATIA V5 xvlconvcatia5.ltl
for I-DEAS xvlconvideas.ltl
for Creo Parametric
(Pro/ENGINEER xvlconvproe.ltl
in previous versions)
for Creo Elements/Direct
(for CoCreate
in previous versions)
(for SolidDesigner xvlconvsd.ltl
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks xvlconvsw.ltl
for NX
xvlconvug.ltl
(for Unigraphics in previous versions)
for SolidEdge xvlconvse.ltl
for STEP xvlconvstep.ltl
for JT xvlconvjt.ltl
XVL Converter Server x64
(XVL Converter Light x64 in previous versions)
for CATIA V5 xvlconvcatia5x64.ltl
for Creo Parametric
(Pro/ENGINEER xvlconvproex64.ltl
in previous versions)
for SolidWorks xvlconvswx64.ltl
for NX xvlconvnxx64.ltl
XVL-STEP Converter
Importer xvlconvstep.ltl
Exporter xvlconvstepexp.ltl
XVL System Toolkit xvlsystool.ltl
Lattice3D Dataway l3ddataway.ltl
Lattice3D Reporter Publisher l3dreporterpub.ltl
Lattice3D Reporter SDK l3dreportersdk.ltl
iXVL Publisher ixvlpublisher.ltl

• Floating license

Table 3

12
 XVL Products License Management Guide

XVL products License file name

XVL Converter Enterprise xvlrconv.ltl

You may read the contents in a license file with an arbitrary text editor. For details, refer to 9 License Files of
XVL Products.

3 Installation of License Files

This chapter describes how to install the license file of each XVL product in a client system.

3.1 Node-locked license

In the event of node-locked license, as installation and setup of the license file completes, the corresponding
XVL product is ready to be used. Start the product as you reference the corresponding reference manual.

3.1.1 Installing license files

This section describes how to install the license files of XVL products. For XVL Player Pro (Ver. 8 or earlier)
and XVL Converter Light, refer to the subsequent description.

1. From the Windows’ Start menu, select Programs→XVL products→License Folder to open the
License folder, where XVL products is a menu item of the XVL product whose license file is going to
be installed.
2. Copy the license file you got from the distributing representative, to the opened License folder. For
details of the corresponding license file names, refer to 2.2 Names of license files.
From the menu Start→Programs→Accessories→Windows Explorer, you can confirm that the license
files are installed in the directories of Figure 1 and Figure 2 with the default settings.

- Ex.) XVL Studio

Figure 1

13
 XVL Products License Management Guide

- Ex.) XVL Converter Plug-in for SolidWorks

Figure 2

The following describes the procedure to install the license file of XVL Player Pro (Ver. 8 or earlier).

1. Start XVL Player Pro.

2. Right-click the graphic window of XVL Player Pro, so that the pop-up menu appears. From the
menu list, select About, then the About XVL Player dialog box opens.
3. On the dialog box, click the License install button. The Specify license file dialog box opens.
4. On the dialog box, specify the license file xvlplaypro.ltl you got from the distributing representative.
5. As the installation completes, the system gives you the message License file installation has completed.

The following describes the procedure to install the license file of XVL Converter Light.

1. From the Windows’ Start menu, select Programs→Accessories→Windows Explorer to open the
directory where XCServer was installed.
2. In that directory, right-click the window, so that the pop-up menu appears. From the menu list, select
New→Folder to create a new folder. Then, name it License. When you installed XCServer in
C:\Lattice, the directory has the structure shown in Figure 3.

Figure 3

3. Copy the license file you got from the distributing representative, to the created License folder.

14
 XVL Products License Management Guide

3.1.2 Setting up license files

When a node-locked license is given, no particular installation and setup is necessary for the license server and
you will not communicate with the license server. As the license file installation completes, the corresponding
XVL product is ready to be used.

3.1.3 Replacing license files

If you receive a new license file because of its version upgrade or other reasons, you must replace the old
license file with a new one.

When you replace license files, first finish XVL applications, and then overwrite the old file with a new one in
the same manner as described in 3.1.1 Installing license files.

You may change the Media Access Control (MAC) address up to two times per year to another computer in
your internal network as long as your license has active maintenance.

3.2 Floating license

In the event of floating license, to use an XVL product, the license server must be active. Usually the system
administrator starts up the license server. Install and setup the license server property with referring to 4
License Server Setup, and then start up the license server.

In a client system, when the license file installation and setup completes, the corresponding XVL product is
ready to be used. As you read the Reference Manual of each XVL product, start the application. It may take
several minutes to start the application since license authentication takes long due to the network and client
system environment.

To use XVL Converter Enterprise, you do not need to install the license file in a client system. Just set up the
license server.

3.2.1 Installing license files

This section describes how to install the license files of XVL products. For XVL Player Pro (Ver. 8 or earlier),
refer to the subsequent description.

1. From the Windows’ Start menu, select Programs→XVL products→License Folder to open the
License folder, where XVL products is a menu item of the XVL product whose license file is going to
be installed.
2. Copy the license file you got from the distributing representative, to the opened License folder. For

15
 XVL Products License Management Guide

details of the corresponding license file names, refer to 2.2 Names of license files.
From the menu Start→Programs→Accessories→Windows Explorer, you can confirm that the license
file is installed in the directory of Figure 4 with the default settings.

- Ex.) XVL Studio

Figure 4

The following describes the procedure to install the license file of XVL Player Pro (Ver. 8 or earlier)

1. Start XVL Player Pro.

2. Right-click the graphic window of XVL Player Pro, so that the pop-up menu appears. From the
menu list, select About, then the About XVL Player dialog box opens.
3. On the dialog box, click the License install button. The Specify license file dialog box opens.
4. On the dialog box, specify the license file xvlplaypro.ltl you got from the distributing representative.
5. As the installation completes, the system gives you the message License file installation has completed.

For some of XVL products, you may specify the license server with other methods.

• Specifying the license server on applications

Specify the license server on applications, not installing the license file in the license folder. Specifying
the license server removes the burden of license file installation.
In that event, enter the host name of the license server and the port number used to authenticate the
license instead (Figure 5). You can get the host name and the port number in the license file. For
details, refer to 9.2 Files for floating license.

16
 XVL Products License Management Guide

Figure 5

• Preparing the license server configuration file

Create a configuration file that describes the information of the license server and put the file in the
license folder. Preparing the configuration file also removes the burden of license file installation. In
particular, when two or more users share one license server, or when two or more XVL products share
one license server, just prepare the configuration file.
For details of the configuration file creation, refer to 9.3 Creating the license server configuration file.

＊ With redundant server operation, use the license file or the license server configuration file for the three
license servers. The client system and the master server authenticate the license, while one of the three
license servers will act as the master server.

3.2.2 Setting up license files

When the license file is installed in a client system, no particular setup is necessary. Just install the license file
in the specified folder, and then the corresponding XVL product is ready to be used as long as the license server
is active.

3.2.3 Replacing license files

If you receive a new license file because of its version upgrade or other reasons, you must replace the old
license file with a new one.

1. The system administrator must update the setup of the license server as referring to 4.7 Replacing
license server.
2. After the license server setup is updated, every user must install the new license file in the same manner
as described in 3.2.1 Installing license files.

♦ The license file used in the license server and the one used in a client system must be identical. If you
replace the license file with a new one, take care not to mix different license files.

♦ When the license server is specified on application or when the license server configuration file is prepared,
there is no task to do on the client system side as long as the information of the license server is not

17
 XVL Products License Management Guide

changed.

♦ You may change the Media Access Control (MAC) address up to two times per year to another computer in
your internal network as long as your license has active maintenance.

4 License Server Setup

This chapter describes how to set up and operate the license server.

Usually the system administrator sets up and operates the license server. It is not necessary to install the
license server to client systems where you use XVL products.

4.1 System requirements

Confirm that the license server that you are going to set up satisfies the following requirements.

Items Requirements
Machine IBM PC or its compatibles
Windows XP
Windows XP x64
Windows Vista
Windows 7
OS Windows 7 x64
Windows Server 2003
Windows Server 2008
Windows Server 2008 x64
Windows Server 2008 R2
CPU Pentium 133 MHz or higher
RAM 64 MB or more
HDD 5 MB or more
Communication protocol TCP/IP
Authority Administrative authority

Although FlexNet Publisher is used for other applications, there would be no problem to set up the license
server for XVL products.

If an XVL product runs on the system in which the license server is set up, confirm that the system also satisfies
the requirements of the corresponding XVL product.

If the host name is used to specify the license server, the license server must be set up on the network whose
host name is resolved for the IP address to be referenced from client systems. If the host name is not resolved,
use the IP address, DNS, WINS, or other appropriate name resolution system for your network environment.
This document describes specification using the host name. If the IP address is used, replace the host name in

18
 XVL Products License Management Guide

this document with the IP address.

In order to authenticate the license, you need two ports: one is used for communication with the license server,
and the other is used upon activation of application. For details, refer to 9.2 Files for floating license.

4.2 Installing license server

When you install the license server, you must be a system administrator. Before the installation, confirm that
you log in Windows as the system administrator.

1. From CD-ROM disk of XVL products, execute XVL_LicenseManager-*_*.exe (where *_* represents
a version number), which is the installation program.
2. If the license server of an XVL product has already been installed, executing that file starts the
uninstallation first. After the uninstallation completes, execute XVL_LicenseManager-*_*.exe again.
3. Install the license server as you follow the instruction of the Install Shield Wizard of XVL License
Manager.
4. The license server component will be installed in the directory shown in Figure 6 in default.

Figure 6

5. Clicking End completes the setup. Then, to the menu list of Windows’ Start, XVL License Manager
is registered, to which the following submenus are added.
- License Management Tool
Shortcut to the program to set up, to start up, and to shut down the license server.
- License Folder
Shortcut to the License folder in which the license file is installed, used when the license server
is set up.

♦ Usually, the license server is installed in the system drive (C: drive). In some environment, however, the
installation drive may be different. In that event, XVL products may not start correctly. If you come
across such a problem, please check the user settings about the home folder.

4.3 Setting up license server

19
 XVL Products License Management Guide

This section describes how to set up the license server with using LMTOOLS, which is the tool to manage the
license server through GUI.

When you set up the license server, please pay attention to the followings.

• Version of lmgrd.exe
If the license server is installed from XVL_LicenseManager-*_*.exe, the latest version of lmgrd.exe
(license manager daemon) is installed to establish the connection between XVL products and the license
server. This version may be different from the one of a license management product using other
FlexNet Publisher. When you set the license server for XVL products, be sure to use the installed
lmgrd.exe; do not mix it with other lmgrd.exe.
• LMTOOLS
LMTOOLS is the tool to manage the license. This tool is common to other products. If the license
server is set up for XVL products additionally to the existing license server of other products, or on the
contrary if another license server is set up for a product additionally to the license server of XVL products,
do not mix the settings for XVL products and others.
• TCP port number for license authentication of lmgrd.exe
The communication port number for license authentication is 1200 in default. If this number is already
assigned to other process, replace the number with another available one. For details of the replacement,
refer to 9.2 Files for floating license.
• TCP port number for communication of xvllm.exe
The operating system dynamically allocates this port in default. When network communication is
controlled in your environment, you need to set this port explicitly. For details of setting the empty port
number, refer to 9.2 Files for floating license.

Set up the license server in the following procedure.

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Folder. Then
the License folder opens.
2. Copy the license file you got from the distributing representative, to the opened License folder. For
details of the corresponding license file names, refer to 2.2 Names of license files.
From the menu Start→Programs→Accessories→Windows Explorer, you can confirm that the license
files are installed in the directory of Figure 7 with the default settings.

Figure 7

20
 XVL Products License Management Guide

3. From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The LMTOOLS (Figure 8) dialog box opens. If the full path to the license file is not registered
to the corresponding Windows environment variable, check the LMTOOLS ignores license file path
environment variables box. If the path is registered, clear the checkbox.

Figure 8

4. Select the Config Services tab. Specify lmgrd.exe, the license file, and the log file (Figure 9).

Figure 9

21
 XVL Products License Management Guide

From the drop-down list of Service Name, select or enter XVL License Manager.

Click Browse of Path to the lmgrd.exe file and specify lmgrd.exe, which is installed in the folder of
Figure 10 in default.

Figure 10

Click Browse of Path to the license file and specify the license file of the product whose license will be
managed. Clicking Browse opens the Open dialog box. For Type of the file, select All Files (*.*) and
specify the license file of Figure 11 in default, then click Open.

Figure 11

If the floating license is given for two or more XVL products, collect up multiple floating license files in
a single license file (xvlproducts.ltl). For details of how to collect up files, refer to 10 Collecting Up
License Files of XVL Products.

To Path to the debug log file, if the log of the license server is necessary, prepare a log file, whose
extension is .log, such as xvl.log, then click Browse and specify the file.

Check the Use Services checkbox to register XVL License Manager to Windows’ services. To start the
services automatically as you restart Windows, check the Start Server at Power-Up checkbox.

shows the Setup tab when the collected license file is set up.

22
 XVL Products License Management Guide

Figure 12

5. Clicking Save Service shows the message to confirm that the settings for the license server will be
saved. Then, click Yes.

If you register XVL License Manager to Windows’ services, it will be added to the list of the Service dialog box
(Figure 13), opened from Start→Settings→Control Panel→Administrative Tools→Services.

Figure 13

4.4 Starting up license server

This section describes how to start up the license server by using LMTOOLS.

23
 XVL Products License Management Guide

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The LMTOOLS dialog box opens.
2. On the Start/Stop/Reread tab, confirm that, in the Flexnet license services installed on this computer
area, XVL License Manager is selected.
3. Click Start Server. If the license file is correctly set up, Server Started Successful is reported.
4. Click Perform Status Enquiry on the Server Status tab. If the license server starts normally, hostname:
license server UP (MASTER) is reported, where hostname represents the host name of the system
where the license server is installed.

♦ If Server Start Failed is reported, refer to 4.5 Checking license server to check the license server status.

♦ If you check the Use Service checkbox on the Config Services tab in 4.3 Setting up license server and the
license server is already active, clicking Start Server reports Server Start Failed.

♦ If you do not check the Use Service checkbox on the Config Services tab in 4.3 Setting up license server,
clicking Start Server twice or more starts multiple lmgrd.exe, which may cause unstable behavior of the
system. If you click Start Server twice or more, click Stop Server the same times to shut down the license
server. For details, refer to 4.6 Shutting down license server.

4.5 Checking license server

This section describes how to check the status of the license server by using LMTOOLS.

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The LMTOOLS dialog box opens.
2. On the Start/Stop/Reread tab, confirm that, in the Flexnet license services installed on this computer
area, XVL License Manager is selected.
3. Click Perform Status Enquiry on the Server Status tab. The server status is reported.

The description of the license server status can be applied to command line operations. For details, refer to 5.2
Checking license server.

If the environment variable is not registered, check the LMTOOLS ignores license file path environment
variables box on the Service/License File tab. If the variable is registered, clear the checkbox. Otherwise,
the correct status may not be obtained. For details of environment variables, refer to 5.5 Registering license
files as environment variables.

4.6 Shutting down license server

This section describes how to shut down the license server by using LMTOOLS.

24
 XVL Products License Management Guide

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The LMTOOLS dialog box opens.
2. On the Start/Stop/Reread tab, confirm that, in the Flexnet license services installed on this computer
area, XVL License Manager is selected.
3. Click Stop Server. If the license server is shut down normally, Stopping Server is reported.

♦ If clicking Stop Server reports Server Stop Failed, check that the settings on the Config Services tab are
correct. The current settings may differ from those at the moment of the license server activation.

♦ If the license borrowing function is used, be sure to check the Force Server Shutdown box.

4.7 Replacing license server

If you receive a new license file because of its version upgrade or other reasons, you must replace the old
license file with a new one.

Replace the license file in the following procedure.

1. Shut down the license server (4.6 Shutting down license server).
2. Overwrite and install the license file (4.3 Setting up license server).
3. Start up the license server (4.4 Starting up license server).
4. Confirm that the license server starts normally (4.5 Checking license server).
5. As the license server starts normally, install the license file in each client system that uses the floating
license.

If you do not want to stop the license server, execute the command to reread and replace the license file in the
following procedure.

1. Overwrite and install the license file (4.3 Setting up license server).
2. Reread the license file (4.8 Reloading license files, 5.4 Rereading license files).
3. Check that the license server starts normally (4.5 Checking license server).
4. If the license server starts normally, install the license file in each client system to receive floating
license.

♦ If you replace the license file with a new one, take care not to mix different versions of license files.

4.8 Reloading license files

This section describes how to reload license files using LMTOOLS.

25
 XVL Products License Management Guide

1. From the Windows Start menu, select Programs→XVL License Manager→License Management
Tool. The LMTOOLS dialog box opens.
2. On the Start/Stop/Reread tab, confirm that XVL License Manager is selected in the Flexnet license
services installed on this computer area.
3. Click ReRead License File to reload the license file. If the file reloads normally, Reread Server
License File Completed is shown. If file reloading fails, Reread Server Failed is shown. If failure
occurs, change the settings as appropriate.

This operation can be performed only when the license server is already running; otherwise, it is disabled.

5 Command Line Operation of License Server

5.1 Starting up license server

This section describes how to start up the license server via command lines.

1. Via the command prompt, move to the directory where lmutil.exe is installed. The directory is
C:\Xvllm\Bin in default.

C:\> cd C:\Xvllm\Bin

2. Enter the following command line.

C:\Xvllm\Bin> lmgrd –c License_file [–l log_file]

The details of the options are described below.

- -c License_file
Specify the full path for the license file in the License folder of Figure 11. If you collect up
multiple floating license files in a single license file, enter the full path for xvlproducts.ltl. If
the full path is registered for the Windows’ environment variable, enter
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license files as environment variables.
- -l log_file
Specify the full path for the log file (xvl.log).

As the license server starts, two command prompts, lmgrd: FLEXlm License Server and xvllm: FLEXlm
License Daemon, are newly shown to always report the status of the license server. Do not close these two
command prompts. If they are closed, the license server will be shut down. Note that if the –l option is
specified, no new command prompt will be opened but the license server will start.

26
 XVL Products License Management Guide

5.2 Checking license server

This section describes how to check the status of the license server via command lines.

1. Via the command prompt, move to the directory where lmutil.exe is installed. The directory is
C:\Xvllm\Bin in default.

C:\> cd C:\Xvllm\Bin

2. Enter the following command line.

C:\Xvllm\Bin> lmutil lmstat [ -a | -A ] -c License_file [ -f feature] [ -S xvllm]

The details of the options are described below.

- -a
Show all information.
- -A
Show all of the licenses in use.
- -c License_file
Specify the full path for the license file in the License folder of Figure 11. If you collect up
multiple floating license files in a single license file, enter the full path for xvlproducts.ltl. If
the license server is running, you may enter ‘SERVER_PORT_NUM@HOST_NAME’. If
the full path is registered for the Windows’ environment variable, enter
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license files as environment variables.
- -f feature
Show the list of the users who use feature (feature name). For details of feature, refer to 9
License Files of XVL Products.
- -i feature
Show the information of feature (feature name) of the license file. If you do not specify a
particular name to feature, the information of feature will be shown. For details of feature,
refer to 9 License Files of XVL Products.
- -S xvllm
Show the list of all the users who use the features of xvllm, the license server of XVL products.

As long as a client system borrows a license, the license is always used. The keyword linger is shown at the
end of the current license user information.
- Ex.) On XVL Studio Pro, “user” is borrowing an Illustration option.

Users of bXVLStudioPro2: (Total of 10 licenses issued; Total of 1 license in use)

"bXVLStudioPro2" v7, vendor: xvllm

floating license

27
 XVL Products License Management Guide

user host host (v6) (lserver/1200 2825), start Wed 5/1 11:21 (linger: 240)

Users of XVLStudio_Illist: (Total of 10 licenses issued; Total of 1 license in use)

"XVLStudio_Illust" v7, vendor: xvllm

floating license

user host host (v6) (lserver/1200 2825), start Wed 5/1 11:21 (linger: 240)

For details of how to check the term of borrowing on the client system, refer to the Reference Manual of the
corresponding XVL product.

5.3 Shutting down license server

This section describes how to shut down the license server via command lines.

1. Via the command prompt, move to the directory where lmutil.exe is installed. The directory is
C:\Xvllm\Bin in default.

C:\> cd C:\Xvllm\Bin

2. Enter the following command line.

C:\Xvllm\Bin> lmutil lmdown –c License_file [–vendor xvllm] [-force]

The details of the options are described below.

- -c License_file
Specify the full path for the license file in the License folder of Figure 11. If you collect up
multiple floating license files in a single license file, enter the full path for xvlproducts.ltl. If
the license server is running, you may enter ‘SERVER_PORT_NUM@HOST_NAME’. If
the full path is registered for the Windows’ environment variable, enter
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license files as environment variables.
- -vendor xvllm
Specify xvllm, the license sever of XVL products.
- -force
Always specify this option as long as the license is borrowed. Before shutting down the
license server, check whether the license is borrowed by referring to 5.2 Checking license
server.
3. The system asks you to shut down the license server. Enter y.

28
 XVL Products License Management Guide

Port@Host Vendors
1) 1200@demo xvllm

Are you sure (y/n)? y

Shut down FLEXlm server on node demo

1 FLEXlm License Server shut down

5.4 Rereading license files

This section describes how to reread the license file via command lines.

1. Via the command prompt, move to the directory where lmutil.exe is installed. The directory is
C:\Xvllm\Bin in default.

C:\> cd C:\Xvllm\Bin

2. Enter the following command line.

C:\Xvllm\Bin> lmutil lmreread -c License_file [–vendor xvllm]

The details of the options are described below.

- -c License_file
Specify the full path for the license file in the License folder of Figure 11. If you collect up
multiple floating license files in a single license file, enter the full path for xvlproducts.ltl. If
the license server is running, you may enter ‘SERVER_PORT_NUM@HOST_NAME’. If
the full path is registered for the Windows’ environment variable, enter
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license files as environment variables.
- -vendor xvllm
Specify xvllm, the license sever of XVL products.

License files are reread only when the license server is active. If the license server is not active, this operation
is disabled.

5.5 Registering license files as environment variables

This section describes how to register the full path of a license file as an environment variable. If you once
register a path as an environment variable, it will be easier to input the paths for license files to command lines.

Register a path as an environment variable in the following procedure.

29
 XVL Products License Management Guide

1. From the Windows’ Start menu, select Settings→Control Panel→System. The System Properties
dialog box opens.
2. On the Advanced tab, click Environment Variables. Then the Environment Variables dialog box
opens. In the event of Windows NT 4.0, just select the Environment tab.
3. Click New of System variables. Then the New System Variable dialog box opens. In the event of
Windows NT 4.0, you will enter the environment variable to the text box on the Environment tab.
4. Enter XVLLM_LICENSE_FILE to Variable name and the full path for the corresponding license file to
Variable value. If you collect up multiple floating license files in a single license file, enter
xvlproducts.ltl. For details of how to collect up multiple license files, refer to 10 Collecting Up
License Files of XVL Products.

Figure 14

5. Click OK to complete the registration.

6 Redundant Server Setup

This chapter describes the setup of a redundant server composed of three license servers and its operation.

1. Install and set up the license server using three servers.

For details of installation and setup, refer to “4.2 Installing license server” and “4.3 Setting up license
server.”

2. Start up the license servers in turn.

For details of startup, refer to “4.4 Starting up license server.” For details of command line operations,
refer to “5.1 Starting up license server.”

The server activated first will be the master server controlling the number of licenses. The client
system and the master server authenticate the licenses. If the master server stops, the next server will
inherit its duties.

3. Check the status of the license server.

30
 XVL Products License Management Guide

Any of the servers can check the status. For details of how to check the status, refer to “4.5 Checking
license server.” When the status is checked with command line operation, refer to “5.2 Checking
license server.”

4. Shut down the license server or reload the license file.

Shut down all servers and reload the license file. For details, refer to “4.6 Shutting down license
server” and “4.7 Replacing license server.” When the server is controlled with command line
operation, refer to “5.3 Shutting down license server” and “5.4 Rereading license files.”

＊ For setup, the license file for redundant server configuration is necessary. Please ask your distribution
representative for the license file.

＊ Two of the three license servers must be running normally for setup.

＊ For the client system, use the license file or the license server configuration file for the three license servers.
The client system and the master server authenticate the license, while one of the three license servers will
act as the master server. For details of the license server configuration file, refer to “9.3 Creating the
license server configuration file.”

7 Uninstallation of License Server

From the Windows’ Start menu, select Settings→Control Panel→Add/Remove Programs. From the list of
programs, select XVL License Manager and click Add/Remove. Then uninstallation starts.

Note: When XVL License Manager is registered to Windows services (4.3 Setting up license server),
cancel the registration before uninstallation. If you do not cancel the registration, the information of the
registration is left undeleted. In that event, install the license server again, cancel the registration, and uninstall
the license server.

8 Setup by Option File

This chapter describes how to write an option file used to control license use on user and host name, or user
group and host name group.

The option file is written on the license server for floating license. This setup is disabled for node-locked
license.

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Folder, to open
the License folder.

31
 XVL Products License Management Guide

2. From the License folder, open the file xvllm.opt on an arbitrary text editor. In xvllm.opt, the following
lines are described.

GROUP group user_name1 user_name2

GROUP group2 user_name3 user_name4
HOST_GROUP host_group host_name1 host_name2
HOST_GROUP host_group2 host_name3 host_name4

EXCLUDE feature1 USER user1

EXCLUDE feature1 USER user2
EXCLUDE feature2 HOST host1
EXCLUDE feature2 HOST host2
EXCLUDE feature3 GROUP group1
EXCLUDE feature3 GROUP group2
EXCLUDE feature4 HOST_GROUP host_group1
EXCLUDE feature4 HOST_GROUP host_group2
EXCLUDE_BORROW feature5 GROUP group3
EXCLUDE_BORROW feature5 GROUP group4
EXCLUDE_BORROW feature6 HOST_GROUP host_group3
EXCLUDE_BORROW feature6 HOST_GROUP host_group4
MAX 2 feature1 GROUP group2
MAX 3 feature2 HOST_GROUP host_group2

3. The GROUP line groups users and the HOST_GROUP line groups host names. For example, to
group users abc and xyz into GroupA, and to group host names host_abc and host_xyz into
HostGroupA, write those lines as follows.

GROUP GroupA abc xyz

HOST_GROUP HostGroupA host_abc host_xyz

4. The EXCLUDE line disables features defined by feature, to user, host name, user group, and host name
group. The EXCLUDE_BORROW line disables the feature to borrow license in the feature line.
For example, to limit use of feature1 to user abc and host group HostGroupA, and to limit license
borrowing of feature2 to user xyz and user group GroupA, write the following lines. For feature
names of each XVL product, refer to 9.4 List of features.

EXCLUDE feature1 USER abc

EXCLUDE feature1 HOST_GROUP HostGroupA
EXCLUDE_BORROW feature2 USER xyz
EXCLUDE_BORROW feature2 GROUP GroupA

5. The MAX line sets the maximum number of licenses of features defined by feature to user, host name,
user group, and host name group. For example, to set three licenses of feature3 to user group Abc,

32
 XVL Products License Management Guide

write the following line. For feature names of each XVL product, refer to 9.4 List of features.

MAX 3 feature3 GROUP Abc

6. Save the changes in xvllm.opt, and then start the license server.

Note that EXCLUDE cannot place a limit on the feature to borrow the license. To place a limit on the feature
to borrow the license, write the EXCLUDE_BORROW line with the feature name; and to place a limit on the
feature by options, write that line with the corresponding feature names. For details of the feature names on
each of the XVL products, refer to 9.4 List of features.

Additionally, the following table lists the useful syntax for restricting use of license. You may add the
necessary lines in the option file.

The following table shows the syntax effective to restrict use of the license and the behavior setup of the license
server. Add syntaxes to the option file as required.

Syntax Behavior
In contrast to EXCLUDE and EXCLUDE_BORROW,
INCLUDE feature HOST hostname INCLUDE and INCLUDE_BORROW enable the
INCLUDE feature USER user feature defined by “feature” only for specified users,
INCLUDE_BORROW feature HOST hostname host names, user groups, and host name groups.
INCLUDE_BORROW feature USER user Note the specification of EXCLUDE takes precedence
over that of INCLUDE.
TIMEOUT and TIMEOUTALL set the time to release
license count of the license server if communication
TIMEOUT feature second discontinues between the license server and the client.
TIMEOUTALL second Specify “feature” with the name of a feature
and ”second” with the time length by the second
greater than 900 (15 minutes).
DEBUGLOG specifies the folder to which the license
server log is output as “DEBUG_LOG_PATH”. To
avoid replacement of the log file due to license server
restart or some other reasons, specify a file with this
DEBUGLOG +”DEBUG_LOG_PATH”
syntax.
Note that the same file specified for Debug Log File of
Setup of License Manager must not be specified.
(Refer to 4.3 Setting up license server).

9 License Files of XVL Products

This chapter describes the license files of XVL products. You may view the contents of each file with an
arbitrary text editor.

33
 XVL Products License Management Guide

9.1 Files for node-locked license

The node-locked license consists of one or more FEATURE lines, which indicate the information of feature that
is licensed. The following describes the details of FEATURE line.

FEATURE XVL_PRODUCT_FEAT xvllm VERSION LIMIT_DATE NUM_LICENSE /

HOSTID=MAC_ADDRESS SIGN=LICENSE_KEY

• XVL_PRODUCT_FEAT
Name of the feature to be licensed.
• xvllm
Vender daemon name, which is always xvllm for XVL products.
• VERSION
Version of the license file.
• LIMIT_DATE
Expiration date of the license.
• NUM_LICENSE
Number of licenses.
• MAC_ADDRESS
MAC address of Ethernet card.
• LICENSE_KEY
License key, created from each variable.

Italicized parameters are the variables necessary to authenticate licenses. If those variables are replaced or
modified, the license file will be invalid.

9.2 Files for floating license

The floating license consists of SERVER line, VENDOR line, and one or more FEATURE lines and
INCREMENT lines. The SERVER line and the VENDOR line make a pair that indicates the license server
information. The FEATURE line and the INCREMENT line indicate the information of feature that is
licensed. The following describes the details of SERVER, FEATURE, and INCREMENT lines.

SERVER HOST_NAME MAC_ADDRESS SERVER_PORT_NUM

VENDOR xvllm [port=VENDOR_PORT_NUM]

• HOST_NAME
Host name of the license server.
• MAC_ADDRESS
MAC address of Ethernet card of the license server.
• SERVER_PORT_NUM
TCP port number for license authentication.

34
 XVL Products License Management Guide

• xvllm
Vender daemon name, which is always xvllm for XVL products.
• VENDOR_PORT_NUM
TCP port number for communication between an application and the license server. When network
communication is controlled in your environment (e.g., by using firewall), always specify this parameter.
For details of this parameter, refer to the description at the end of this section.

FEATURE XVL_PRODUCT_FEAT xvllm VERSION LIMIT_DATE NUM_LICENSE /

BORROW SIGN=LICENSE_KEY

• XVL_PRODUCT_FEAT
Name of the feature to be licensed.
• xvllm
Vender daemon name, which is always xvllm for XVL products.
• VERSION
Version of the license file.
• LIMIT_DATE
Expiration date of the license.
• NUM_LICENSE
Number of licenses.
• BORROW
Feature to borrow the license. If this keyword is written in the license file, the feature can be enabled so
that you will get the license for a fixed period of time although you are distant from the network.
• LICENSE_KEY
License key, created from each variable.

INCREMENT bXVL_PRODUCT_FEAT xvllm VERSION LIMIT_DATE NUM_LICENSE /

BORROW SIGN=LICENSE_KEY

• bXVL_PRODUCT_FEAT
Name of the feature to be licensed, used to enable the feature to borrow the license.
• xvllm
Vender daemon name, which is always xvllm for XVL products.
• VERSION
Version of the license file.
• LIMIT_DATE
Expiration date of the license.
• NUM_LICENSE
Number of licenses available for the feature to borrow the license.
• BORROW
Feature to borrow the license. If this keyword is written in the license file, the feature can be enabled
so that you will get the license for a fixed period of time although you are distant from the network.
• LICENSE_KEY

35
 XVL Products License Management Guide

License key, created from each variable.

Italicized parameters are the variables necessary to authenticate licenses. If those variables are replaced or
modified, the license file will be invalid. Bold parameters are the keywords in the FlexNet Publisher license
file. Modifying these parameters is not also allowed.

You may modify the variables HOST_NAME and SERVER_PORT_NUM of the SERVER line. In
particular, if the port number 1200, set in default, is already assigned to other process, you may replace the
number with another available one. Note, however, that the port number must be unique among the license
files registered for one lmgrd.exe.

In the VENDOR line, port=VENDOR_PORT_NUM is not written in default. In that event, the operating
system dynamically allocates an empty port. Because of this condition, if available ports are limited by using
firewall or other systems, you must specify the port explicitly. For example, to set the host name of the license
server to foo, MAC address to 123, the port for license authentication to 27001, and the port for communication
to 28000, write as follows.

SERVER foo 123 27001

VENDOR xvllm port=28000

Those settings must be written to every license file registered, with taking extra care. To modify those
variables, use an arbitrary text editor.

9.3 Creating the license server configuration file

The information of the license server can be shared among XVL Studio, XVL PlayerPro, XVL Notebook, and
Lattice3D Reporter by using the configuration file common to those applications. The configuration file
removes the burden of license file installation. In particular, when two or more users share one license server,
or when two or more XVL products share one license server, you need just to prepare the configuration file.

1. On Windows, select Start→All Programs→XVL products’ menu→License Folder to open the

License folder, where XVL products’ menu indicates the name of XVL product for which the license
file is installed.
2. Open the right-click menu and select New→Text Document from the menu list to create a new text
file. Name the file xvllmsvr.ltl.
3. Open xvllmsvr.ltl via a text editor and write the TCP port number and the host name combined by @ so
as to define SERVER_PORT_NUM@HOST_NAME, as shown below.
Ex.)
1200@foo1

If there are two or more license servers, write one server on a line, as follows.
Ex.)

36
 XVL Products License Management Guide

1200@foo1
1200@foo2
1200@foo3
…

The configuration file and the license file of products cannot coexist in an environment. If there is the license
file, remove it because it cannot be enabled.

9.4 List of features

The following tables list the features used in XVL products. When no option is entered, standard functions are
used.

• Node-locked license or floating license

Table 4

XVL products Features Options

XVL Studio Pro XVLStudioPro2
bXVLStudioPro2 (Borrow license)
Parasolid Direct
XVLStudioPro2_Parasolid
Import
CATIA V4 Direct
XVLStudioPro2_CATIA
Import
XVLStudioPro2_Office Office Plug-in
XVLStudioPro2_Illust Illustration
XVL Studio Standard XVLStudioStd
bXVLStudioStd (Borrow license)
Parasolid Direct
XVLStudioStd_Parasolid
Import
CATIA V4 Direct
XVLStudioStd_CATIA
Import
XVLStudioStd_Office Office Plug-in
XVLStudioStd_Illust Illustration
XVL Studio Basic XVLStudioBsc
bXVLStudioBsc (Borrow license)
Parasolid Direct
XVLStudioBsc_Parasolid
Import
CATIA V4 Direct
XVLStudioBsc_CATIA
Import
XVLStudioBsc_Office Office Plug-in
XVLStudioBsc_Illust Illustration
XVL Studio Pro/Standard/Basic Parasolid Direct
XVLStudio_Parasolid
Import
CATIA V4 Direct
XVLStudio_CATIA
Import
XVLStudio_Office Office Plug-in

37
 XVL Products License Management Guide

XVLStudio_Illust Illustration
Point Cloud
XVLStudio_CAT
Evaluation
XVLStudio_U3D U3D Direct I/O
XVLStudio_List Edit Panel
XVLStudio_STEP STEP Direct Import
XVLStudio_Mechanism Kinematics
XVLStudio_Difference Difference Check
XVLStudio_AnnotationView Annotation View
XVLStudio_Human2 Human
XVL Player Pro XVLPlayerPro
bXVLPlayerPro (Borrow license)
XVL Player SDK XVLPlayerProSDK2
XVL Notebook Standard XVLNotebookStd
bXVLNotebookStd (Borrow license)
XVL Notebook Basic XVLNotebook
bXVLNotebook (Borrow license)
XVL Converter Plug-in
for Mechanical DeskTop XVLTranslatorMechanicalDeskTop
for Inventor XVLTranslatorInventor
for CATIA5 XVLTranslatorCATIA5
for I-DEAS XVLTranslatorI-DEAS
for Creo Parametric
(Pro/ENGINEER XVLTranslatorProEngineer
in previous versions)
for Creo Elements/Direct
(for CoCreate
in previous versions)
(for SolidDesigner XVLTranslatorSolidDesigner
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks XVLTranslatorSolidWorks
for NX
(for Unigraphics XVLTranslatorUnigraphics
in previous versions)
for SolidEdge XVLTranslatorSolidEdge
XVL Converter Plug-in x64
for CATIA5 XVLTranslatorCATIA5x64
for Creo Parametric
( for Pro/ENGINEER XVLTranslatorProEngineerx64
in previous versions)
for SolidWorks XVLTranslatorSolidWorksx64
XVL-3ds Max Converter XVLTranslatorMax
Lattice3D Reporter L3DReporter
bL3DReporter (Borrow license)
L3DReporter_Template Template

• Node-locked license

38
 XVL Products License Management Guide

Table 5

XVL products Features Options

XVL Signer XVLSigner
XVLSignerUserGroup Access Level Setting
XVLSignerPKC PKC
XVL Web Master XVLWebMaster
XVLWebMaster2DIllustration Illustration
XVLWebMaster3DParts 3D Parts
Automatic
XVLWebMasterAnimation
Disassembly
XVLWebMasterProcess Process Planning
XVLWebMasterCustomize Template Customize
XVL Converter Server
(XVL Converter Light
in previous versions)
for IGES XVLConverterIGES
for Parasolid XVLConverterParasolid
for Polygon XVLConverterPoly
for Mechanical Desktop XVLConverterMechanicalDeskTop
for Inventor XVLConverterInventor
for CATIA V4 XVLConverterCATIA4
for CATIA V5 XVLConverterCATIA5
for I-DEAS XVLConverterI-DEAS
for Creo Parametric
(Pro/ENGINEER XVLConverterProEngineer
in previous versions)
for Creo Elements/Direct
(for CoCreate
in previous versions)
(for SolidDesigner XVLConverterSolidDesigner
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks XVLConverterSolidWorks
for NX
(for Unigraphics XVLConverterUnigraphics
in previous versions)
for SolidEdge XVLConverterSolidEdge
for STEP XVLConverterSTEP
for JT XVLConverterJT
XVL Converter Server x64
(XVL Converter Light x64
in previous versions)
XVLConverterCATIA5x64
for CATIA V5
XVLConverterCATIA5x64_FTA FTA
for Creo Parametric XVLConverterProEngineerx64
(for Pro/ENGINEER
in previous versions) XVLConverterProEx64_AF PMI
for SolidWorks XVLConverterSolidWorksx64
for NX XVLConverterNXx64

39
 XVL Products License Management Guide

XVLConverterNXx64_PMI PMI
XVL System Toolkit XVLFilter (xvlfilter.exe)
XVLReducer (xvlprocessor.exe)
XVLProcessor (xvlreducer.exe)
XVLProcessor_Intf Interference Check
Lattice3D Dataway L3DDataway
Lattice3D Reporter Publisher L3DReporterPublisher
Lattice3D Reporter SDK L3DReporterSDK
iXVL Publisher iXVLPublisher

• Floating license

Table 6

XVL products Features Options

XVL Converter Enterprise XVLRemoteConverterManager
XVLRemoteConverterSW SolidWorks
Creo Parametric
XVLRemoteConverterProE (Pro/ENGINEER
in previous versions)
Creo Parametric
(Pro/ENGINEER
XVLRemoteConverterProE_AF
in previous versions)
PMI
XVLRemoteConverterI-DEAS I-DEAS
NX
XVLRemoteConverterUG (Unigraphics
in previous versions)
XVLRemoteConverterCATIA4 CATIA V4
XVLRemoteConverterParasolid Parasolid
XVLRemoteConverterIGES IGES
XVLRemoteConverterPoly Polygon
Creo Elements/Direct
(CoCreate
in previous versions)
XVLRemoteConverterSD (SolidDesigner
in previous versions)
(OneSpace Designer
in previous versions)
XVLRemoteConverterInventor Inventor
XVLRemoteConverterCATIA5 CATIA V5
XVLRemoteConverterCATIA5_ CATIA V5
FTA FTA
XVLRemoteConverterCATIA5_ CATIA V5
CGR CGR
XVLRemoteConverterMDT MechanicalDesktop
XVLRemoteConverterSE SolidEdge

40
 XVL Products License Management Guide

10 Collecting Up License Files of XVL Products

This chapter describes how to collect up multiple floating license files of XVL products in a single license file
(xvlproducts.ltl).

♦ Node-locked license files are not collected up in a single file.

♦ The xvlproducts.ltl is used upon license server setup. This file is not used to set up the license file in the
client system where XVL products run.

Upon collecting up license files, pay attention to the following.

• Do not mix XVL license files with different product’s ones.
The license files of only XVL products are collected up. Those files cannot be collected up with
license files of other products although they use FlexNet Publisher.
• The SERVER line of every license file to be collected up must be identical.
Among all the license files to be collected up, the SERVER lines must be identical. Before collecting
up license files, confirm that the host names and the MAC addresses on the SERVER lines and the port
number on the VENDOR line are all identical with referring to 9.2 Files for floating license.
• Do not modify the variables necessary for license authentication.
A license file contains variables and keys necessary for license authentication. Do not modify those
character strings upon collecting up license files.

The following describes how to collect up multiple license files to create xvlproducts.ltl.

1. From the Windows’ Start menu, select Programs→XVL License Manager→License Folder. Then
the License folder opens.
2. In the License folder, open xvlproducts.ltl on an arbitrary text editor. In xvlproducts.ltl, the following
lines are written.

SERVER host_name mac_address 1200

VENDOR xvllm
# XVL Studio
# XVL Player Pro
# XVL Converter Enterprise (XVL Remote Converter)
# XVL Notebook

3. Open a license file in the License folder, which is to be collected up in xvlproducts.ltl, on an arbitrary
text editor.
4. Confirm that the SERVER line in every license file to be collected up is identical. Then copy the host
name and the MAC address to the SERVER line of xvlproducts.ltl.
5. From each license file to be collected up, copy the FEATURE (INCREMENT) line to the end the
corresponding product name written in xvlproducts.ltl.
The following shows an example of collecting up the license files of XVL Studio Pro. From two

41
 XVL Products License Management Guide

license files, C:\Xvllm\License\xvlstudiopro.ltl and C:\Xvllm\License\xvlstudioopt.ltl, xvlproducts.ltl will

be written as follows.

SERVER foo ABCDEFGHIJKL 1200

VENDOR xvllm
# XVL Studio
FEATURE XVLStudioPro2 xvllm 7 permanent 10 SIGN=0
INCREMENT bXVLStudioPro2 xvllm 7 permanent 10 BORROW SIGN=0
FEATURE XVLStudio_Parasolid xvllm 7 permanent 10 BORROW SIGN=0
FEATURE XVLStudio_CATIA xvllm 7 permanent 10 BORROW SIGN=0
FEATURE XVLStudio_Illust xvllm 7 permanent 10 BORROW SIGN=0

6. Save the changes of xvlproducts.ltl and set up the license server with the created xvlproducts.ltl.

♦ If you receive a new floating license file because of its version upgrade or other reasons, you must replace
the FEATURE (INVREMENT) line of the corresponding products written in xvlproducts.ltl, with new
information.

11 Troubleshooting

11.1 Error messages and countermeasures

If you fail in acquiring the license from your client system and you get the error message and FLEXlm error, or
if an error message is output upon the license server setup, refer to the following error messages to solve the
problems.

Note that 64-bit Edition XVL products do not show the error number FLEXlm error in the error messages.
For details of how to obtain the error number, refer to 11.2 Obtaining error numbers by log file.

Table 7

Error messages Countermeasures

Refer to 2.2 Names of license files and check that the license file of
the corresponding XVL product is installed in the specified folder.
Cannot find license file.
If the path to the license folder contains a semicolon or at mark,
FLEXlm error: -1, -5
reinstall the XVL product in other folder, the path to which does not
contain these.
The current license file cannot enable the feature. Check that the
correct license file and license server are installed in your client
This feature cannot be used.
system. If you are using the correct license file, the version of the
FLEXlm error: -5
license server may be old. Refer to 11.3 If troubles are not solved
and check the version, then contact the distributing representative.
Invalid license file. The license file might be modified accidentally. Install the delivered
FLEXlm error: -2, 8 license file as it is, in the specified folder.

42
 XVL Products License Management Guide

License number of users already The number of licensed users reaches the maximum. Please wait for
reached. a while until they finish using.
FLEXlm error: -4 This error occurs in the event of floating license.
The license file for other system may be used. Report this error to
the system administrator.
If the system administrator receives this error report, check that the
host name and the MAC address in the license file coincide with those
The host ID of this system does
for the erroneous system. To check the MAC address, enter the
not match the host ID specified
following command via the command prompt.
in license file.
C:\> ipconfig –all
FLEXlm error: -9
The following output is the MAC address.
Physical Address......: 00-11-22-33-44-**
If multiple addresses are output, refer to the output of the network
adaptor used for network connection.
Feature has expired. The license has already been expired. To renew the license, contact
FLEXlm error: -10 the distributing representative.
Your client system cannot be connected to the license server, and you
have not been licensed. Report this error to the system administrator.
Cannot connect to license server.
If the system administrator receives this error report, check the
FLEXlm error: -15
following: the license server is set up correctly, it is running normally,
and the client system is normally connected to the license server.
License file does not support this The version of the license is too old to use. To update the license file,
version. refer to 9 License Files of XVL Products to check the version and
FLEXlm error: -21 contact the distributing representative.
This error may occur if you use the license file with expiration date
System clock has been set back.
and the system clock is set back or changed. The system may not
FLEXlm error: -88
start running although you correct the system clock.
The license server may be shut down. Report this error to the system
The desired vendor daemon is
administrator.
down.
If the system administrator receives this error report, check that the
FLEXlm error: -97
license server is set up correctly and it has been started normally.
The license file set in the license server may not coincide with the one
set in the corresponding client system. Report this error to the
system administrator.
FLEXlm error: -18
If the system administrator receives this error report, check that the
correct license files are set up for the license server and the client
system with referring to 9 License Files of XVL Products.
The version of the corresponding product is not supported. Ask your
system administrator.
FLEXlm error: -25
The system administrator must confirm the version of the license and
that of the product. If the license has been expired, get a new license.
The license server is not found or there is no response from the server.
Ask your system administrator.
FLEXlm error: -96 The system administrator must confirm that the license server
machine is running and the host name of the license file in the client
system is correct.
The license file cannot be acquired. You cannot use XVL products
FLEXlm error: -103 running on a node-locked licensed system through Terminal Services
such as Remote Desktop of Windows operating system.
The feature to borrow the license has not been enabled.
FLEXlm error: -117
Check that the feature is enabled correctly.
When you receive the license, a serious problem might have occurred.
Confirm that network cables are normally connected and report this
FLEXlm error: Others
error to the system administrator.
If the system administrator receives this error report, check the

43
 XVL Products License Management Guide

following: there is any problem about the network, the license server is
running normally, the license file set in the license server coincides
with the one set in the corresponding client system, and the host name
and the MAC address in the license file coincide with those for the
license server.
If the error is not cleared, report the contents of FLEXlm error to the
distributing representative.

If LMTOOLS does not set up the license server normally, refer to the following countermeasures.

Table 8

Problems Countermeasures
Clicking Start Server on the Config
Check that the full path for the license file is set correctly to
Services tab does not output Server Started
License File on the Config Services tab.
Successful.
If you clicked Start Server twice or more, multiple
Clicking Start Server on the Config
Services tab outputs Server Started lmgrd.exe process may be running. Click Stop Server to
Successful, but clicking Perform Status shut down all the processes. To escape from this problem,
check the Use Services checkbox on the Config Services
Enquiry does not output license server UP.
tab.
Clicking Stop Server on the Config Services Check that the full path for the license file is set correctly to
tab does not output Stopping Server. License File on the Config Services tab.
The license server has started normally but Check that the host name and the MAC address in the
the client system is not licensed. license file coincide with those for the license server.
This problem occurs if the feature to borrow license is set
FLEXlm error dialog opens and the
up and the license is expired. The license is valid until
operation terminates.
24:00 of the specified date.

11.2 Obtaining error numbers by log file

This section describes how to obtain error numbers if you failed in acquiring the license in XVL Studio, XVL
Player Pro, and Lattice 3D Reporter.

To output the log file, set the log file path for the environmental variable XVL_LICENSE_UTILITY_LOG and
start XVL Product.

If you failed in acquiring the license, for example, if the license server is not found, when XVL Studio 64-bit
edition is started, the log file will be written as follows:

12:00:00 (Environment Information)

LM_LICENSE_FILE(env)=(null)
XVLLM_LICENSE_FILE(env)=(null)
12:00:00 (Time Stamp)
LicensePath= SERVER_PORT_NUM@HOST_NAME
12:00:00 (Time Stamp)
Checkout(XVLStudioPro2, 10)...

44
 XVL Products License Management Guide

12:00:00 (FLEXlm Error)

maj_errno=-15
min_errno=10
sys_errno=10061
feature=XVLStudioPro2
lic_files= SERVER_PORT_NUM@HOST_NAME
context=HOST_NAME
12:00:00 (Time Stamp)
...Failed

In the log file shown above, the Checkout line indicates that the license of the function XVLStudioPro2 was
tried to be obtained. This resulted in an error and the error number -15 is shown on the line maj_errno=.
HOST_NAME is the name of the host the client system referenced and SERVER_PORT_NUM is the TCP port
number for license authentication.

With this number, refer to the countermeasures described in 11.1 Error messages and countermeasures.
After troubleshooting, delete the corresponding environmental variable.

11.3 If troubles are not solved

If the described countermeasures do not solve the problems, please contact the distributing representative. In
that event, report the following information.

• Error message and the contents of FLEXlm error

Report the error message and the contents as they are.
• Operating system for the license server
Report the version of the operating system and that of service pack.
• Version of xvllm.exe and lmgrd.exe used in the license server
Enter the following command via command prompt and report the output.
- xvllm –v
C:\Xvllm\Bin>xvllm -v
13:26:41 (xvllm) FLEXnet Licensing version v11.10.0.0 build 95001 i86_n3
- lmgrd –v
C:\Xvllm\Bin>lmgrd –v
lmgrd v11.10.0.0 build 95001 i86_n3 Copyright (c) 1988-2011 Flexera Software, Inc. All
Rights Reserved.
• Operating system of client system
Report the operating system of the erroneous system, its version, and the service pack.
• License file
Send a copy of the license file of the erroneous XVL product.
• Name of the XVL product and its version
Report the name of the erroneous XVL product and its version.

45
 XVL Products License Management Guide

• Status of use of other products whose license is managed with FlexNet Publisher
Report the status of the license server of the corresponding product and its version, if that product uses
FlexNet Publisher.

46