License Management Guide

October 10, 2008
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-2009 Lattice Technology Co.,Ltd. All rights reserved.
1
XVL Products License Management Guide
Table of contents
1 Introduction................................................................................................................................................................6
2 Outline of License Management..............................................................................................................................6
2.1 License model of XVL products.......................................................................................................................6
2.2 Names of license files........................................................................................................................................8
3 Installation of License Files....................................................................................................................................10
3.1 Node-locked license.........................................................................................................................................10
3.1.1 Installing license files ...............................................................................................................................10
3.1.2 Setting up license files..............................................................................................................................12
3.1.3 Replacing license files..............................................................................................................................12
3.2 Floating license ................................................................................................................................................12
3.2.1 Installing license files ...............................................................................................................................13
3.2.2 Setting up license files..............................................................................................................................14
3.2.3 Replacing license files..............................................................................................................................14
4 License Server Setup...............................................................................................................................................15
4.1 System requirements........................................................................................................................................15
4.2 Installing license server....................................................................................................................................16
4.3 Setting up license server ..................................................................................................................................17
4.4 Starting up license server.................................................................................................................................21
4.5 Checking license server...................................................................................................................................21
4.6 Shutting down license server...........................................................................................................................22
4.7 Replacing license server..................................................................................................................................22
5 Command Line Operation of License Server .......................................................................................................23
5.1 Starting up license server.................................................................................................................................23
5.2 Checking license server...................................................................................................................................24
5.3 Shutting down license server...........................................................................................................................25
5.4 Rereading license files.....................................................................................................................................26
5.5 Registering license file as environment variable............................................................................................27
6 Uninstallation of License Server ............................................................................................................................27
7 Setup by Option File ...............................................................................................................................................28
8 License Files of XVL Products ..............................................................................................................................30
8.1 Files for node-locked license...........................................................................................................................30
8.2 Files for floating license...................................................................................................................................30
8.3 Creating the license server configuration file.................................................................................................32
8.4 List of features..................................................................................................................................................33
9 Collecting Up License Files of XVL Products......................................................................................................36
10 Troubleshooting.....................................................................................................................................................37
10.1 Error messages and countermeasures...........................................................................................................38
10.2 If troubles are not solved ...............................................................................................................................40
2
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.
3
XVL Products License Management Guide
Release Notes
• 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
- 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
4
XVL Products License Management Guide
- 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.
• 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.
5
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
8.1 Files for node-locked license
When you get floating license, read the following chapters.
•
•
•
2 Outline of License Management
3.2 Floating license
8.2 Files for floating license
If you are a system administrator, read the following chapters.
•
•
•
2 Outline of License Management
4 License Server Setup
8.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 FLEXlm (manufactured by Acresso Software,
http://www.acresso.com/). This is a software-based license management system providing flexible mechanism
to manage license.
6
XVL Products License Management Guide
When you use an XVL product, FLEXlm 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 8.1 Files for node-locked
license and 8.2 Files for floating license.
-
Ex.) XVL Studio Pro
If the license file contains the following line, the version 7 is licensed. In this event, XVL
Studio Pro up to Ver. 8 is available.
FEATURE XVLStudioPro2 xvllm 7 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.
♦ 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.
7
XVL Products License Management Guide
♦ 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.
2.
3.
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.
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.
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 8.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 5.2 Checking license server. If you shut down the license server while
borrowing a license, refer to –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 10.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.
• Node-locked license or floating license
Table 1
XVL products
XVL Studio Pro *
License file name
xvlstudiopro.ltl
8
XVL Products License Management Guide
XVL Studio Standard *
XVL Studio Basic *
XVL Player Pro *
XVL Notebook Standard*
XVL Notebook Basic*
XVL Converter Plug-in
for Mechanical DeskTop
for Inventor
for CATIA5
for I-DEAS
for Pro/ENGINEER
for CoCreate
(for SolidDesigner
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks
for NX
(for Unigraphics in previous versions)
for SolidEdge
XVL-3ds max Converter
Lattice3D Reporter *
xvlstudioopt.ltl
xvlstudiostd.ltl
xvlstudioopt.ltl
xvlstudiobsc.ltl
xvlstudioopt.ltl
xvlplaypro.ltl
xvlnotestd.ltl
xvlnote.ltl
xvltransmdt.ltl
xvltransinventor.ltl
xvltranscatia5.ltl
xvltransideas.ltl
xvltransproe.ltl
xvltranssd.ltl
xvltranssw.ltl
xvltransug.ltl
xvltransse.ltl
xvltransmax.ltl
l3dreporter.ltl
A product with an asterisk (*) is available for the function to borrow license.
• Node-locked license
Table 2
XVL products
XVL Signer
XVL Web Master
XVL Converter Server
(XVL Converter Light in previous versions)
for IGES
for Parasolid
for Polygon
for Mechanical Desktop
for Inventor
for CATIA V4
for CATIA V5
for I-DEAS
for Pro/ENGINEER
for CoCreate
(for SolidDesigner
in previous versions)
(for OneSpace Designer
9
License file name
xvlsign.ltl
xvlwm.ltl
xvlconviges.ltl
xvlconvpara.ltl
xvlconvpoly.ltl
xvlconvmdt.ltl
xvlconvinventor.ltl
xvlconvcatia4.ltl
xvlconvcatia5.ltl
xvlconvideas.ltl
xvlconvproe.ltl
xvlconvsd.ltl
XVL Products License Management Guide
in previous versions)
for SolidWorks
for NX
(for Unigraphics in previous versions)
for SolidEdge
XVL Converter Server x64
(XVL Converter Light x64 in previous versions)
for CATIA V5
for Pro/ENGINEER
for SolidWorks
for NX
XVL-STEP Converter
Importer
Exporter
XVL System Toolkit
XVL Plug-in for Adobe(R) Acrobat(R)
XVL Player SDK
xvlconvsw.ltl
xvlconvug.ltl
xvlconvse.ltl
xvlconvcatia5x64.ltl
xvlconvproex64.ltl
xvlconvswx64.ltl
xvlconvnxx64.ltl
xvlconvstep.ltl
xvlconvstepexp.ltl
xvlsystool.ltl
xvlplugina3d.ltl
xvlplaysdk.ltl
• Floating license
Table 3
XVL products
XVL Converter Enterprise
License file name
xvlrconv.ltl
You may read the contents in a license file with an arbitrary text editor. For details, refer to 8 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
10
XVL Products License Management Guide
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 Pro/Srandard/Basic
Figure 1
-
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.
2.
Start XVL Player Pro.
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.
11
XVL Products License Management Guide
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.
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.
12
XVL Products License Management Guide
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.
2.
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.
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
file is installed in the directory of Figure 4 with the default settings.
-
Ex.) XVL Studio Pro/Standard/Basic
Figure 4
The following describes the procedure to install the license file of XVL Player Pro (Ver. 8 or earlier)
1.
2.
Start XVL Player Pro.
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.
13
XVL Products License Management Guide
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 8.2 Files for floating license.
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 8.3 Creating the license server configuration file.
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
14
XVL Products License Management Guide
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
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
Machine
OS
CPU
RAM
HDD
Communication protocol
Authority
Requirements
IBM PC or its compatibles
Microsoft Windows NT 4.0 (SP3 or higher)
Microsoft Windows 2000
Microsoft Windows XP
Microsoft Windows Server 2003
Pentium 133 MHz or higher
64 MB or more
5 MB or more
TCP/IP
Administrative authority
Although FLEXlm 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
15
XVL Products License Management Guide
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
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 8.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.
16
XVL Products License Management Guide
4.3 Setting up license server
This section describes how to set up the license server with using FLEXlm License Manager, 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
FLEXlm. 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.
• FLEXlm License Manager
FLEXlm License Manager 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 8.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 8.2 Files for floating license.
Set up the license server in the following procedure.
1.
2.
From the Windows’ Start menu, select Programs→XVL License Manager→License Folder. Then
the License folder opens.
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.
17
XVL Products License Management Guide
Figure 7
3.
From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The FLEXlm License Manager (Figure 8) dialog box opens.
Figure 8
4.
Select the Setup tab. Specify lmgrd.exe, which starts the license server, the license file, and the log file
(Figure 9).
Figure 9
From the drop-down list of Service Name, select XVL License Manager.
Click Browse of lmgrd.exe and specify lmgrd.exe, which is installed in the folder of Figure 10 in default.
18
XVL Products License Management Guide
Figure 10
Click Browse of 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 9 Collecting Up
License Files of XVL Products.
To 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 NT 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.
19
XVL Products License Management Guide
Figure 12 shows the Setup tab when the collected license file is set up.
Figure 12
5.
Clicking OK 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 NT’s services, it will be added to the list of the Service
dialog box (Figure 13), opened from Start→Settings→Control Panel→Administrative Tools→Services.
20
XVL Products License Management Guide
Figure 13
4.4 Starting up license server
This section describes how to start up the license server by using FLEXlm License Manager.
1.
2.
3.
4.
From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The FLEXlm License Manager dialog box opens.
On the Control tab, confirm that, in the Service Name area, XVL License Manager is selected.
Click Start. If the license file is correctly set up, Server Started is reported.
Click Status. 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 NT Service checkbox on the Setup tab in 4.3 Setting up license server and the license
server is already active, clicking Start reports Server Start Failed.
♦ If you do not check the Use NT Service checkbox on the Setup tab in 4.3 Setting up license server, clicking
Start twice or more starts multiple lmgrd.exe, which may cause unstable behavior of the system. If you
click Start twice or more, click Stop 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 FLEXlm License Manager.
1.
2.
3.
From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The FLEXlm License Manager dialog box opens.
On the Control tab, confirm that, in the Service Name area, XVL License Manager is selected.
Clicking Status reports hostname: license server UP (MASTER), where hostname represents the host
name of the system where the license server is installed.
21
XVL Products License Management Guide
♦ If clicking Status reports an error message, such as Can’t get server: Cannot find license file –1,123 (No
Such file or directory), where –1 of ... file –1,123 ... represents the error code of FLEXlm, check that the
settings on the Setup tab are correct with referring to 10 Troubleshooting. After the check, restart the
license server.
To check the status of the license server in detail, use command lines. For details, refer to 5.2 Checking
license server.
4.6 Shutting down license server
This section describes how to shut down the license server by using FLEXlm License Manager.
1.
From the Windows’ Start menu, select Programs→XVL License Manager→License Management
Tool. The FLEXlm License Manager dialog box opens.
2. On the Control tab, confirm that, in the Service Name area, XVL License Manager is selected.
3. Click Stop. If the license server is shut down normally, Server Stopped is reported.
If you do not check the Use NT Service checkbox on the Setup tab, the Choose Server to Shutdown
dialog box (Figure 14) opens. Select xvllm, the license server of XVL products, and click OK. If
the license server is shut down normally, Server Stopped is reported.
Figure 14
♦ If clicking Stop reports Server Stop Failed, check that the settings on the Setup tab are correct. The current
settings may differ from those at the moment of the license server activation.
♦ As long as the license is borrowed, the license server cannot be shut down. Check the status of the license
server with referring to 5.2 Checking license server. If there is a license in use, do not click Stop. You
may stop the license server by executing the corresponding commands. For more details of the command
line operations to stop the license server, refer to 5.3 Shutting down license server.
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
22
XVL Products License Management Guide
license file with a new one.
Replace the license file in the following procedure.
1.
2.
3.
4.
5.
Shut down the license server (4.6 Shutting down license server).
Overwrite and install the license file (4.3 Setting up license server).
Start up the license server (4.4 Starting up license server).
Confirm that the license server starts normally (4.5 Checking license server).
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.
2.
3.
4.
Overwrite and install the license file (4.3 Setting up license server).
Reread the license file (5.4 Rereading license files).
Check that the license server starts normally (4.5 Checking license server).
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.
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
23
XVL Products License Management Guide
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license file as environment variable.
-
-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.
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 file as environment variable.
-
-f feature
Show the list of the users who use feature (feature name). For details of feature, refer to 8
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 8 License Files of XVL Products.
-
-S xvllm
24
XVL Products License Management Guide
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 a Generating illustration option.
-
Users of bXVLStudioPro2: (Total of 10 licenses issued; Total of 1 license in use)
"bXVLStudioPro2" v7, vendor: xvllm
floating license
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
25
XVL Products License Management Guide
-c %XVLLM_LICENSE_FILE%. For details of how to register the license file for
environment variable, refer to 5.5 Registering license file as environment variable.
-
-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.
The system asks you to shut down the license server. Enter y.
-
3.
Port@Host
1) 1200@demo
Vendors
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 file as environment variable.
-
-vendor xvllm
Specify xvllm, the license sever of XVL products.
26
XVL Products License Management Guide
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 file as environment variable
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.
1.
2.
3.
4.
From the Windows’ Start menu, select Settings→Control Panel→System. The System Properties
dialog box opens.
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.
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.
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 9 Collecting Up
License Files of XVL Products.
Figure 15
5.
Click OK to complete the registration.
6 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 NT 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.
27
XVL Products License Management Guide
7 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.
2.
From the Windows’ Start menu, select Programs→XVL License Manager→License Folder, to open
the License folder.
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 user2
EXCLUDE feature2 HOST host1 host2
EXCLUDE feature3 GROUP group1 group2
EXCLUDE feature4 HOST_GROUP host_group1 host_group2
EXCLUDE_BORROW feature5 GROUP group3 group4
EXCLUDE_BORROW feature6 HOST_GROUP host_group3 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 8.4 List of features.
EXCLUDE feature1 USER abc
28
XVL Products License Management Guide
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,
write the following line. For feature names of each XVL product, refer to 8.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 8.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).
29
XVL Products License Management Guide
8 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.
8.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.
8.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]
30
XVL Products License Management Guide
• 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.
• 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.
31
XVL Products License Management Guide
• 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
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 FLEXlm 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.
8.3 Creating the license server configuration file
The information of the license server can be shared among XVL Studio Pro/Standard/Basic, 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.
2.
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.
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.
32
XVL Products License Management Guide
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.)
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.
8.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
XVL Studio Pro
Features
XVLStudioPro2
bXVLStudioPro2
XVLStudioPro2_Parasolid
XVLStudioPro2_CATIA
XVL Studio Standard
XVLStudioPro2_Office
XVLStudioPro2_Illust
XVLStudioStd
bXVLStudioStd
XVLStudioStd_Parasolid
XVLStudioStd_CATIA
XVL Studio Basic
XVLStudioStd_Office
XVLStudioStd_Illust
XVLStudioBsc
bXVLStudioBsc
XVLStudioBsc_Parasolid
33
Options
(Borrow license)
Parasolid Direct
Import
CATIA V4 Direct
Import
Office Plug-in
Illustration
(Borrow license)
Parasolid Direct
Import
CATIA V4 Direct
Import
Office Plug-in
Illustration
(Borrow license)
Parasolid Direct
Import
XVL Products License Management Guide
XVLStudioBsc_CATIA
XVLStudioBsc_Office
XVLStudioBsc_Illust
XVL Studio Pro/Standard/Basic
XVLStudio_Parasolid
XVLStudio_CATIA
XVLStudio_Office
XVLStudio_Illust
XVLStudio_CAT
XVL Player Pro
XVL Notebook Standard
XVL Notebook Basic
XVL Converter Plug-in
for Mechanical DeskTop
for Inventor
for CATIA5
for I-DEAS
for Pro/ENGINEER
for CoCreate
(for SolidDesigner
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks
for NX
(for Unigraphics
in previous versions)
for SolidEdge
XVL-3ds max Converter
Lattice3D Reporter
XVLStudio_U3D
XVLStudio_List
XVLStudio_STEP
XVLStudio_Mechanism
XVLPlayerPro
bXVLPlayerPro
XVLPlayerProSDK
XVLNotebookStd
bXVLNotebookStd
XVLNotebook
bXVLNotebook
CATIA V4 Direct
Import
Office Plug-in
Illustration
Parasolid Direct
Import
CATIA V4 Direct
Import
Office Plug-in
Illustration
Point Cloud
Evaluation
U3D
Edit Panel
STEP
Mechanism
(Borrow license)
(XVL PlayerPro SDK)
(Borrow license)
(Borrow license)
XVLTranslatorMechanicalDeskTop
XVLTranslatorInventor
XVLTranslatorCATIA5
XVLTranslatorI-DEAS
XVLTranslatorProEngineer
XVLTranslatorSolidDesigner
XVLTranslatorSolidWorks
XVLTranslatorUnigraphics
XVLTranslatorSolidEdge
XVLTranslatorMax
L3DReporter
bL3DReporter
L3DReporter_CrossLinkPerm
(Borrow license)
Cross-Linking
• Node-locked license
Table 5
XVL products
XVL Signer
Features
XVLSigner
34
Options
XVL Products License Management Guide
XVL Web Master
XVLSignerUserGroup
XVLWebMaster
XVLWebMaster2DIllustration
XVLWebMaster3DParts
XVLWebMasterAnimation
XVLWebMasterProcess
XVLWebMasterCustomize
XVLWebMaster2DImage
XVL Converter Server
(XVL Converter Light
in previous versions)
for IGES
for Parasolid
for Polygon
for Mechanical Desktop
for Inventor
for CATIA V4
for CATIA V5
for I-DEAS
for Pro/ENGINEER
for CoCreate
(for SolidDesigner
in previous versions)
(for OneSpace Designer
in previous versions)
for SolidWorks
for NX
(for Unigraphics
in previous versions)
for SolidEdge
XVL Converter Server x64
(XVL Converter Light x64
in previous versions)
for CATIA V5
for Pro/ENGINEER
for SolidWorks
for NX
XVL-STEP Converter
Importer
Exporter
XVL System Toolkit
XVL Plug-in for Adobe Acrobat
XVL Player SDK
Access Level Setting
Illustration
3D Parts
Automatic
Disassembly
Process Planning
Template Customize
2D image
XVLConverterIGES
XVLConverterParasolid
XVLConverterPoly
XVLConverterMechanicalDeskTop
XVLConverterInventor
XVLConverterCATIA4
XVLConverterCATIA5
XVLConverterI-DEAS
XVLConverterProEngineer
XVLConverterSolidDesigner
XVLConverterSolidWorks
XVLConverterUnigraphics
XVLConverterSolidEdge
XVLConverterCATIA5x64
XVLConverterProEngineerx64
XVLConverterSolidWorksx64
XVLConverterNXx64
XVLConverterSTEP
XVLConverterSTEPExport
XVLFilter
XVLReducer
XVLProcessor
XVLProcessor_Intf
XVLPluginA3D
XVLPlayerProSDK2
• Floating license
35
(xvlfilter.exe)
(xvlprocessor.exe)
(xvlreducer.exe)
Interference Check
XVL Products License Management Guide
Table 6
XVL products
XVL Converter Enterprise
Features
XVLRemoteConverterManager
XVLRemoteConverterSW
XVLRemoteConverterProE
XVLRemoteConverterI-DEAS
XVLRemoteConverterUG
XVLRemoteConverterCATIA4
XVLRemoteConverterParasolid
XVLRemoteConverterIGES
XVLRemoteConverterPoly
XVLRemoteConverterSD
XVLRemoteConverterInventor
XVLRemoteConverterCATIA5
XVLRemoteConverterMDT
XVLRemoteConverterSE
Options
SolidWorks
Pro/ENGINEER
I-DEAS
NX
(Unigraphics
in previous versions)
CATIA V4
Parasolid
IGES
Polygon
CoCreate
(SolidDesigner
in previous versions)
(OneSpace Designer
in previous versions)
Inventor
CATIA V5
MechanicalDesktop
SolidEdge
9 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 FLEXlm.
• 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 8.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.
36
XVL Products License Management Guide
The following describes how to collect up multiple license files to create xvlproducts.ltl.
1.
2.
From the Windows’ Start menu, select Programs→XVL License Manager→License Folder. Then
the License folder opens.
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.
4.
5.
Open a license file in the License folder, which is to be collected up in xvlproducts.ltl, on an arbitrary
text editor.
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.
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
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.
10 Troubleshooting
37
XVL Products License Management Guide
10.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.
Table 7
Error messages
Cannot find license file.
FLEXlm error: -1, -5
This feature cannot be used.
FLEXlm error: -5
Invalid license file.
FLEXlm error: -2, 8
License number of users already
reached.
FLEXlm error: -4
The host ID of this system does
not match the host ID specified
in license file.
FLEXlm error: -9
Feature has expired.
FLEXlm error: -10
Cannot connect to license server.
FLEXlm error: -15
License file does not support this
version.
FLEXlm error: -21
System clock has been set back.
FLEXlm error: -88
The desired vendor daemon is
down.
FLEXlm error: -97
FLEXlm error: -18
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.
If the path to the license folder contains a semicolon, reinstall the XVL
product in other folder, the path to which does not contain any
semicolon.
The current license file cannot enable the feature. Check that the
correct license file and license server are installed in your client
system. If you are using the correct license file, the version of the
license server may be old. Refer to 10.2 If troubles are not solved
and check the version, then contact the distributing representative.
The license file might be modified accidentally. Install the delivered
license file as it is, in the specified folder.
The number of licensed users reaches the maximum. Please wait for
a while until they finish using.
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
for the erroneous system. To check the MAC address, enter the
following command via the command prompt.
C:\> ipconfig –all
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.
The license has already been expired. To renew the license, contact
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.
If the system administrator receives this error report, check the
following: the license server is set up correctly, it is running normally,
and the client system is normally connected to the license server.
The version of the license is too old to use. To update the license file,
refer to 8 License Files of XVL Products to check the version and
contact the distributing representative.
This error may occur if you use the license file with expiration date
and the system clock is set back or changed. The system may not
start running although you correct the system clock.
The license server may be shut down. Report this error to the system
administrator.
If the system administrator receives this error report, check that the
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
38
XVL Products License Management Guide
FLEXlm error: -25
FLEXlm error: -96
FLEXlm error: -103
FLEXlm error: -117
FLEXlm error: Others
set in the corresponding client system. Report this error to the
system administrator.
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 8 License Files of XVL Products.
The version of the corresponding product is not supported. Ask your
system administrator.
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.
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
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.
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
error to the system administrator.
If the system administrator receives this error report, check the
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 FLEXlm License Manager does not set up the license server normally, refer to the following
countermeasures.
Table 8
Problems
Countermeasures
Clicking Start on the Control tab does not Check that the full path for the license file is set correctly to
License File on the Setup tab.
output Server Started.
If you clicked Start twice or more, multiple lmgrd.exe
Clicking Start on the Control tab outputs
process may be running. Click Stop to shut down all the
Server Started, but clicking Status does not
processes. To escape from this problem, check the Use
output license server UP.
NT Services checkbox on the Setup tab.
Clicking Stop on the Control tab does not Check that the full path for the license file is set correctly to
License File on the Setup tab.
output Server Stopped.
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.
39
XVL Products License Management Guide
10.2 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
10:42:47 (xvllm) FLEXlm version 8.3c
-
lmgrd –v
C:\Xvllm\Bin>lmgrd –v
FLEXlm v8.3c (lmgr.lib), Copyright (C) 1988-2002 Macrovision Corporation
• 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.
• Status of use of other products whose license is managed with FLEXlm
Report the status of the license server of the corresponding product and its version, if that product uses
FLEXlm.
40
Download PDF
Similar pages