PLM Technical Support Series

CATIA V5 Licensing Cookbook

By:

Rick Jones

http://www.ibm.com/software/applications/plm/support

IBM Product Lifecycle Management Worldwide Technical Support

This series of technical papers focuses on topics of current interest within PLM
Solutions. Your contributions and comments are welcome.
Volume 1 Number 1.3

 Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

CATIA V5 Licensing Cookbook

Rick Jones
IBM Corporation – Product Lifecycle Management Solutions

This technical document is intended to provide the reader with

tips and tools for the use of CATIA V5 and LUM, to aid in the
setup of nodelocked, concurrent, and concurrent-offline licensing
for CATIA V5. This document will aid both the systems
administrator and the CATIA V5 user in understanding the
implementation of CATIA V5 licensing. This information is
valid for all Version 5 CATIA levels, unless otherwise specified,
along with LUM Versions 4.6.7 or 4.6.8.

Introduction
Welcome to the CATIA V5 Licensing Cookbook. Setting up nodelocked licensing and/or
concurrent licensing for CATIA V5 can be a difficult task. The trouble often starts with an
attempt to obtain a valid target ID, and continues through to the starting of the CATIA V5
application using a properly-enrolled license. This document has been created to help eliminate
many of the possible problems that can be encountered along the way. The CATIA V5
Licensing Cookbook contains the essential information needed when implementing licensing
for IBM’s PLM software products, tailored for use in a typical environment. Details are
provided for various LUM and CATIA tools that are often used, as well as information on file
locations, license enrollment, static and dynamic license allocation, plus concurrent-offline
licensing. The concepts presented in this document have been used by many CATIA system
administrators, and have proven to be useful techniques that should be periodically reviewed.

Page i  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Table of Contents

GETTING STARTED WITH CATIA V5 LICENSING.........................................................................................1

THE TARGET ID.....................................................................................................................................................1

OBTAINING THE TARGET ID VIA CATIA V5...................................................................................................1

OBTAINING THE TARGET ID VIA LUM ............................................................................................................2

LOCATING LUM CODE ON A SYSTEM............................................................................................................2

USE OF THE I4TARGET COMMAND ................................................................................................................3

TARGET ID PROBLEMS ON WINDOWS ..........................................................................................................3

NODELOCKED VS. CONCURRENT LICENSES .............................................................................................4

NODELOCKED LICENSE PRINCIPLES............................................................................................................4

CONCURRENT LICENSE PRINCIPLES............................................................................................................5

ORDERING LICENSE KEYS................................................................................................................................5

VERIFY LICENSE KEYS RECEIVED .................................................................................................................6

LICENSE CERTIFICATE FILES ..........................................................................................................................6

CREATING A LICENSE CERTIFICATE FILE ...................................................................................................7

SAMPLE LICENSE CERTIFICATE FILE ...........................................................................................................8

IMPORTING LICENSE CERTIFICATES ............................................................................................................9

STARTING THE CATIA V5 NODELOCK KEY MANAGEMENT TOOL........................................................9

IMPORTING A NODELOCKED LICENSE CERTIFICATE USING CATIA V5 ...........................................10

CONTENT OF THE NODELOCK FILE .............................................................................................................11

LOCATION OF THE NODELOCK FILE ...........................................................................................................12

INSTALLING A CONCURRENT LICENSE BY IMPORTING A LICENSE CERTIFICATE FILE ............12

IMPORTING A CONCURRENT LICENSE CERTIFICATE USING THE GUI .............................................13

IMPORTING A CONCURRENT LICENSE CERTIFICATE USING I4BLT ..................................................14

INSTALLING CONCURRENT LICENSES DIRECTLY USING I4BLT ........................................................15

COMMAND FOR INSTALLING CONCURRENT LICENSES .......................................................................15

Page ii  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

SELECTING LICENSES TO BE USED FOR RUNNING CATIA V5 ............................................................16

STATIC LICENSE ALLOCATION......................................................................................................................18

SHAREABLE (DYNAMIC) LICENSE ALLOCATION.....................................................................................18

CONCURRENT OFFLINE LICENSING ............................................................................................................20

CONCURRENT OFFLINE LICENSING REQUIREMENTS ...........................................................................21

ADDING AUTHORIZATIONS FOR OFFLINE LICENSES.............................................................................23

SETTING THE DEFAULT OFFLINE PERIOD .................................................................................................24

EXTRACTING THE LICENSE TO THE CLIENT WORKSTATION ..............................................................25

CONCLUSION.......................................................................................................................................................27

AUTHOR ................................................................................................................................................................27

Page iii  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Getting Started with CATIA V5 Licensing

The following basic items are needed when licensing CATIA V5:
• A valid IBM Customer Number under which IBM PLM software products (such as
CATIA V5) have been purchased.
• A computer that has a Network Interface Card (NIC) installed, on which the
license(s) will be installed.

The Target ID
• The target ID is the unique hardware identifier of each workstation or server on which
CATIA V5 license(s) will be installed.
• For nodelocked (standalone) licenses, this is the hardware identifier for the
workstation on which the CATIA V5 application is to be run.
• For concurrent (network) licenses, this is the hardware identifier for the network
license server on which a pool of shared CATIA V5 licenses will be enrolled.
• The target ID must be supplied at the time when CATIA V5 license keys are ordered.

Obtaining the Target ID via CATIA V5

• If CATIA V5 is already installed on the workstation or on the license server, run the
CATIA V5 Nodelock Key Management tool. On a Windows workstation, this can be
done from the Start Programs CATIA Tools menu,

Figure 1 – Nodelock License Manager

• The target ID information is also displayed at the beginning of the CATIA V5

installation process on the workstation.
• There is no requirement to have a license in place when installing CATIA V5 code, but
a license will be required in order to run the CATIA V5 application.

Page 1 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Obtaining the Target ID via LUM

• If CATIA V5 is not installed, the target ID can be obtained via the LUM i4target tool.
• The i4target tool will be installed when LUM code is installed.
• The latest LUM code for all platforms can be downloaded from URL
http://www.ibm.com/software/lum
• Note: For Windows, the i4target executable can be downloaded by itself, separately
from the full LUM code for Windows, at the above web site.
• LUM code, including the target ID tool, is also provided for all CATIA V5 platforms
on a separate LUM CD, packaged inside the shrink-wrapped box containing the CATIA
V5 code.

Locating LUM Code on a System

• The i4target tool is located in the directory where LUM executables have been
installed.
• The default LUM install directories for the various platforms are:

Windows NT/2000/XP
• C:\ifor\win\bin

AIX
• /var/ifor or /usr/opt/ifor/ls/os/aix/bin

HP, IRIX, SOLARIS

• /var/lum
or
• /opt/lum/ls/os/hpux/bin (HP-UX)
• /opt/lum/ls/os/svr4.sgi/bin (IRIX)
• /opt/lum/ls/os/solaris/bin (SOLARIS)

Page 2 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Use of the i4target command

• Run the following command to display the target ID:

i4target -O
• On AIX, run the following command, and use the preferred target ID value:
i4target -Ol
• On Windows, it is possible to double-click on i4target.exe from within Windows
Explorer, which will cause a message box to be displayed, showing the win32mac
target ID of the machine on which the i4target.exe is run.
• The target ID is a number represented in hexadecimal notation.
• The following is an example of output from an i4target –O command on Windows,
showing a valid win32mac target ID:

LUM Target ID
-----------------
745315e5 win32mac MAC-HW Address

Target ID Problems on Windows

• For Windows, the hardware-based win32mac target ID is retrieved from the device
driver that controls the network adapter, not from the operating system itself.
• The entry I4DRIVER is stored in the Windows Registry, in the path
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\License Use Runtime, to record
the name of the network device driver used for retrieving the target ID.
• For this mechanism to work, a device driver that complies with Network Driver
Interface Specification (NDIS) 4 must be installed on the workstation where licenses
will be installed. If there is a question as to whether a device driver complies with
NDIS 4, contact the supplier of the device driver to confirm NDIS 4 compliance.
• A win32 target ID cannot be used for enrolling CATIA V5 licenses on Windows, as it
is not a unique hardware-based target ID. A win32mac target ID must be used.
• A target ID value of 000000 or 000001 usually indicates invalid content within the
I4DRIVER Registry entry, often due to the removal of a network card. Clearing
(erasing) the I4DRIVER Registry entry, and then re-running the i4target tool, will
often resolve this problem.

Page 3 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Nodelocked vs. Concurrent Licenses

• CATIA V5 licenses can be ordered in two different types:
nodelocked (standalone) or concurrent (network)
• A nodelocked license is stored on a specific workstation, for use of CATIA V5 on that
workstation only.
• A concurrent license is stored on a License Use Management (LUM) license server,
and can be used by client workstations having network connectivity to that license
server.
• A third type of license, High-Availability Licensing (HAL) using Clusters, is beyond
the scope of this CATIA V5 Licensing Cookbook, and will not be covered here.

Nodelocked License Principles

• A nodelocked license restricts the use of a CATIA V5 configuration and/or product to

the workstation whose target ID is specified in the license file.
• Enrolled nodelocked license keys for CATIA V5 products are stored in a nodelock file
on the workstation.
• CATIA V5, rather than License Use Management (LUM), manages the use of
nodelocked licenses.
• When CATIA V5 is started on the workstation, the CATIA V5 code checks the
nodelock file to ensure that it contains a valid license.
• Installation of License Use Management (LUM) code on the workstation is not required
when only nodelocked licenses are used for running CATIA V5.

Page 4 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Concurrent License Principles

• Multiple CATIA V5 client workstations can share the pool of concurrent licenses for
CATIA V5.
• LUM code must be installed and configured on each license server, as well as on each
client workstation, and each client workstation must be network-connected to one or
more license servers.
• The LUM license server should be configured as a network license server. IBM PLM
software products do not make use of LUM’s nodelocked license server capability,
nor of its central registry license server capability, so these other LUM services
should not be configured, for reasons of performance, unless other non-PLM licenses
are known to require these LUM services.
• CATIA V5 client workstations should be configured to use LUM’s direct binding
method, rather than its namespace binding method, for reasons of network efficiency
and Windows support.
• When a user at a client workstation starts CATIA V5, LUM code on the license
server(s) determines whether a concurrent license is available.
• While CATIA V5 is running on a client workstation, the concurrent licenses that have
been reserved at the start of this session of CATIA V5 remain unavailable to other
users.
• When CATIA V5 stops running on that client workstation, these concurrent licenses
are returned to the license server(s), where they become available to other CATIA V5
users.
• Concurrent licenses allow as many users to run CATIA V5 simultaneously as there are
valid license quantities for CATIA V5 configurations and products available from the
network license server(s).

Ordering License Keys

• Call the IBM PLM Key Center to order licenses:

o 1-800-446-8989 (for USA only)
• A complete list of IBM PLM Key Center phone numbers worldwide can be found at
http://www-1.ibm.com/support/docview.wss?rs=886&context=SW860&uid=swg27005921
• The following information will be needed:
o IBM Customer Number used to purchase CATIA V5
o Target ID for the machine on which the license(s) will be enrolled
o CATIA Product Number(s), and quantity of each license requested
o Software Serial Number(s) (for configurations)
o Platform (operating system) on which the license(s) will be enrolled
o License Type – nodelocked or concurrent

Page 5 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Verify License Keys Received

• Check the e-mail received from the IBM PLM Key Center, to verify that the following
information for the requested licenses is correct:
o Target type (Platform)
o Target ID
o License type (Nodelocked or Concurrent)

----------------------------------------------------------------------------------------
Product name . . . . . . . . . : MD2-Catia Mechanical Design C2
Product number . . . . . . . . : 5691MD2
Target type. . . . . . . . . . . . : win32mac Target id. . . . . . . : 745315e5
Password type. . . . . . . . . : LICENSE
No. of connections . . . . . : 1 License type . . . . : NODELOCKED
Passwords are valid From : 2002-03-04 To . . . . . . . . . . . . : 2003-03-04

Generated by userid. . . . . : KEYREGS1 Generated by sys : BLD-MENU

Generation reference No. : 2002-03-05-11.46.57.624231

Vendor name. . . . . . . . . . : Dassault Systemes

Vendor id. . . . . . . . . . . . . : 5242378dbf8d.02.c0.09.c8.93.00.00.00
Vendor Password. . . . . . . : dgq5mxkpvqhbi
Product Password . . . . . . : kukeitb8ipbgnvnnwc32g9apdhu7s5hauzackdimangaa
Product Version . . . . . . . : 5.1

License Certificate Files

• Check the attachments to the e-mail received from the IBM PLM Key Center, as
individual License Certificate files are usually supplied as attached files.
• Alternatively, a License Certificate file can be created by copying and pasting the
license certificate lines from the e-mail that was received from the IBM PLM Key
Center into a text file, creating a separate License Certificate file for each separate
license.

Page 6 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Creating a License Certificate File

• Copy and paste the following lines into a text file:

[LicenseCertificate] First line

.
VendorName=Dassault Systemes
VendorPassword=dgq5mxkpvqhbi
VendorID=5242378dbf8d.02.c0.09.c8.93.00.00.00
ProductName=MD2-Catia Mechanical Design C2
ProductVersion=TMPMCFA
ProductPassword=kukeitb8ipbgnvnnwc32g9apdhu7s5hauzackdimangaa
ProductAnnotation=TMPMCFAAAAA-
.
TargetTypeName=MS Win-32 MAC
TargetID=745315e5
.
SerialNumber=TMPMCFAAAAA
.
MaxOfflinePeriod= Last line

• Each License Certificate file can be given a meaningful file name of choice (e.g.,
MD2.lic).
• The normal naming convention for License Certificate files is to use a .lic extension.
• License Certificate files can be stored in any directory of choice, from where they will
eventually be imported.
• The example above shows only the partial contents of a License Certificate file, in
order to highlight the first and last lines of the License Certificate file.
• The first line of the License Certificate file should contain the word LicenseCertificate
within square brackets. If characters other than square brackets are shown, there has
been a problem during file transfer/upload/download of the License Certificate file, and
the License Certificate will not successfully import.
• The specific line content of a License Certificate files can, and does, change
periodically, with new lines typically being added at the end. If a License Certificate
file contains somewhat different lines from the examples shown in this document, do
not alter that License Certificate to match these examples.

Page 7 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Sample License Certificate file

• This page shows a sample of a complete License Certificate file.

[LicenseCertificate]
CheckSum=2CA72409B863E93B74449C72A0AD6F19
TimeStamp=1015354197
PasswordVersion=7
VendorName=Dassault Systemes
VendorPassword=dgq5mxkpvqhbi
VendorID=5242378dbf8d.02.c0.09.c8.93.00.00.00
ProductName=MD2-Catia Mechanical Design C2
ProductID=2119
ProductVersion=TMPMCFA
ProductPassword=kukeitb8ipbgnvnnwc32g9apdhu7s5hauzackdimangaa
ProductAnnotation=TMPMCFAAAAA-
LicenseStyle=nodelocked
LicenseStartDate=03/04/2002
LicenseDuration=366
LicenseEndDate=03/04/2003
LicenseCount=1
MultiUseRules=
RegistrationLevel=3
TryAndBuy=No
SoftStop=No
TargetType=26
TargetTypeName=MS Win-32 MAC
TargetID=745315e5
ExtendedTargetType=
ExtendedTargetID=
DerivedLicenseStyle=
DerivedLicenseStartDate=
DerivedLicenseEndDate=
DerivedLicenseAggregateDuration=
SerialNumber=TMPMCFAAAAA
Upgrade=No
CapacityType=
Bundle=No
InstallProgram=
AdditionalLicenseData=
CustomAttribute1=No
CustomAttribute2=No
CustomAttribute3=No
SubCapacityEligibleProduct=No
MaxOfflinePeriod=

Page 8 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Importing License Certificates

• Nodelocked licenses can be installed by importing License Certificate files via the
CATIA V5 Nodelock Key Management tool.

• Concurrent licenses can be installed by either:

o Importing License Certificate files via the LUM Basic License Tool Graphical
User Interface (GUI)
or
o Using the i4blt command from the command line interface to import License
Certificates.

Starting the CATIA V5 Nodelock Key Management Tool

• To start the CATIA V5 Nodelock Key Management tool:

• On Windows, click:
Start Programs CATIA Tools Nodelock Key Management

• On UNIX, enter the following command:

./catstart -run CATNodeLockMgt
This command is located in directory
/usr/DassaultSystemes/Bxx/OS_a/code/command
where Bxx represents the CATIA release (e.g., “B16” for CATIA V5R16)
and where OS_a represents the operating system:
aix_a
hpux_a
irix_a
solaris_a

Page 9 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Importing a Nodelocked License Certificate using CATIA V5

• If there are no nodelocked licenses currently installed, the following warning message
will appear when the CATIA V5 Nodelock Key Management tool is first started:

Figure 2 – Nodelock License Manager Warning.

• The actual pathname in the warning message may be different from the pathname
shown above. Select OK to close the Warning window.
• Select Import from the File menu in the Nodelock License Manager window.

Figure 3 – Nodelock License Manager – Import

Page 10 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

• Select the location of the License Certificate file that was created, or that was supplied
by the IBM PLM Key Center, then press Open, and click OK.

Figure 4 – File Selection Box

• The License Certificate file will be imported into the nodelock file on the workstation.
• Repeat the above steps for each remaining License Certificate file.

Content of the Nodelock File

• A nodelock file looks like this after a License Certificate file has been imported:

Figure 5 – Nodelock Key File Contents

Page 11 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Location of the Nodelock File

• The location of the nodelock file varies by platform:

Figure 6 –Location of the Nodelock File

• *Note: If LUM is installed on Windows 2000, the location of the nodelock file may be
C:\IFOR\LS\CONF

Installing a Concurrent License by Importing a License Certificate File

• To install a concurrent license on a LUM License Server, use the Basic License Tool
provided with LUM. LUM must already be installed, and must be configured as a
Network License Server.
• A License Certificate can be imported by using either the Basic License Tool Graphical
User Interface (GUI) or by using an i4blt command issued from the command line.

Page 12 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Importing a Concurrent License Certificate using the GUI

• Using the Basic License Tool GUI, start i4blt and select Enroll Single product
from the Products menu:

Figure 7 – Enrolling with the Basic License Tool

• Select the Import button at the bottom of the Enroll Product window.

Figure 8 – Enroll Product window

Page 13 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

• Select the location of the License Certificate file that was created, or that was supplied
by the IBM PLM Key Center, and press Open.

Figure 9 – Import Panel

• Press OK in the Enroll Product window.

• This will cause the selected license to be enrolled on the license server.
• Repeat these steps for the remaining License Certificate files.

Importing a Concurrent License Certificate using i4blt

• If the LUM GUI is not installed, the LUM command line interface can be used to
import a License Certificate file.
• To import a License Certificate using LUM’s i4blt command , enter
i4blt -a -f filename
at the command line, where filename is the name (including the path) of the License
Certificate file that was created, or that was supplied by the IBM PLM Key Center.

Page 14 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Installing Concurrent Licenses directly using i4blt

• To install licenses without creating or using License Certificate files, use the i4blt
commands provided in the e-mail that was received from the IBM PLM Key Center.
• From the command line, on any platform, copy and paste the i4blt commands found in
the e-mail from the IBM PLM Key Center, following the line of e-mail text that reads

Install commands for server xxxxxxxx

------------------------------------

where xxxxxxxx is the target ID associated with the license server.

• Place these copied i4blt commands into a .cmd file (Windows) or .sh file (UNIX) for
execution as a series of one or more i4blt commands. Alternatively, one can copy/paste
the i4blt commands, one at a time, directly onto the command line, for processing.
• Note that these copied i4blt commands will need to be edited before they can be used,
to remove the “+” (plus sign) characters that are used as “continuation characters” in
the e-mail text, and to combine multiple text lines from the e-mail into single-line i4blt
commands, one i4blt command per line. Examples of this editing task are provided
below.

Command for Installing Concurrent Licenses

• Following is an example of an i4blt command as provided in an e-mail from the IBM
PLM Key Center:

i4blt -a -v "'Dassault Systemes' 5242378dbf8d.02.c0.09.c8.93.00.00.00 +

dgq5mxkpvqhbi" -p "'MD2-Catia Mechanical Design C2' TMPKCFA +
zvexusn7favx3gumftmccdk7i3gzrg29krttcaadg6fsgcsa TMPKCFAAAAA-" –S +
TMPKCFAAAAA

• Note the “+” (plus sign) characters at the ends of the first 3 lines in the above example.
• The syntax for this form of the i4blt command is:

i4blt -a -v "'VendorName' VendorID VendorPassword" -p "'ProductName'

ProductVersion ProductPassword ProductAnnotation" –S SerialNumber

• Each i4blt command should be entered all on one long line. The “+” (plus sign)
characters shown in the lines above must be removed, using a text editor, and all lines
must be combined into a single command line, beginning with i4blt, and ending with
the SerialNumber parameter.
• Once the i4blt commands have been appropriately edited, they can be run on the
license server, either from the command line, or from a shell script (UNIX), or from a
command file (Windows), which will cause the licenses to be enrolled on the license
server.

Page 15 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Selecting Licenses to be used for running CATIA V5

• The license(s) with which CATIA V5 will be run must be selected before CATIA V5 is
actually started.
• To accomplish this on Windows, click Start Programs CATIA Tools
Settings Management

Figure 10 - Settings Management

• Select the Licensing tab in the General section on the Options window.
• Select the license(s) for starting CATIA from the available (intensified) choices, and
then select OK.

Figure 11 – Licensing Tab

Page 16 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

• At least one CATIA V5 Configuration must be selected. Additional configurations

and/or products can also be selected.
• The license selection will be saved in CATIA V5’s Licensing.CATSettings file.
• Once the license(s) have been selected, CATIA V5 can be started.
• If an attempt is made to start CATIA V5 without first selecting a license, a license
selection panel will appear, and CATIA V5 must then be restarted, in order to have the
license selection take effect.

•
Figure 12 – CATIA Starting

Page 17 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Static License Allocation

• There are many CATIA V5 products that can be used in conjunction with CATIA V5
configurations.
• These products can be selected in the Tools/Options/General/Licensing tab and then
CATIA V5 should be restarted. The user will hold these license(s) until CATIA V5 is
ended.
• This is referred to as “static license allocation”, because these licenses are allocated for
the duration of the CATIA V5 session, and cannot be released without ending the
CATIA V5 session.
• Licenses that are not available are under-intensified, and cannot be selected. This
situation typically occurs when there is a “mismatch” between the available CATIA V5
licenses and the installed CATIA V5 configurations/products.
• The license server name of the active license server is shown in the
Tools/Options/General/Licensing panel. If there is more than one available license
server, all will be listed.
• Static license selections are saved in CATIA V5’s Licensing.CATSettings file.
• Note: At least one CATIA V5 configuration license must be selected statically in order
for CATIA V5 to start successfully.

Shareable (Dynamic) License Allocation

• For licenses that are available only in limited quantities, or that are only used
occasionally for short periods of time, there exists a capability to share such licenses
dynamically among several users.
• A shareable CATIA V5 product such as IG1 – CATIA – IGES INTERFACE 1 Product
can be dynamically allocated by a user as needed during a CATIA V5 session, and then
dynamically released, without the need to end and restart the CATIA V5 session.
• This is done by selecting the product in the Shareable Products tab within
Tools/Options/General while CATIA V5 is running.
• The selected square first appears orange in color, then selecting OK pulls the license
dynamically from the license server.
• If the license is not available (already in use), a message is provided indicating this
condition.

Page 18 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Shareable
Products
tab

Figure 13 – Shareable Products Tab

• When the user has finished using the dynamic license, it should be returned back to the
license pool, for availability to other users.
• Select Tools/Options/General/Shareable Products tab, select the dynamically
allocated product to be released, and click OK. The license will be released from this
user, and made available to other users.
• There is no need to stop or restart CATIA V5 when allocating or releasing licenses for
shareable CATIA V5 products.
• Dynamic (shareable) license allocation requests are not stored in CATIA V5’s
Licensing.CATSettings file.
• Note that AddOn CATIA V5 products cannot be dynamically allocated and released, as
they are, by definition, permanently tied to a specific CATIA V5 configuration.

Page 19 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Concurrent Offline Licensing

• Concurrent Offline Licensing (COL) is currently available only for CATIA V5 clients
running on Windows 32-bit platforms.
• Concurrent offline licensing allows a license to be extracted (taken offline) temporarily
from a license server, allowing the license to be used on a workstation, usually a laptop,
which will run CATIA when disconnected from the network. The license is useable for
a specified period, which cannot exceed 30 days. Once extracted from the license
server, the offline license works similarly to a nodelocked license. The license is taken
offline via the Extract option of the CATIA V5 Nodelock Key Management tool, and
can be returned to the license server via the Restitute option.

Figure 14 – Nodelock License Manager showing Extract and Restitute

• Offline licenses that have not been explicitly restituted will be automatically returned to
the license server at the expiration of the offline checkout period.
• Offline licenses cannot be extracted from a High Availability Licensing (HAL) Cluster.

Page 20 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Concurrent Offline Licensing Requirements

• A license server running LUM 4.6.7 or higher, plus a client workstation running
CATIA V5R13 or higher, are required in order to be able to make use of Concurrent
Offline Licensing.
• Application of current patch levels to LUM is strongly advised, as there are several
important corrections available for Concurrent Offline Licensing (COL).
• Stop the license server and run the i4_offline_mig executable, in order to convert the
enrolled licenses from concurrent to concurrent-offline status, then restart the license
server.
• The i4_offline_mig executables for various platforms are available in a .zip file that can
be downloaded from the IBM PLM website at URL
http://www-306.ibm.com/software/applications/plm/support/prodannounce.html
• After restarting the license server and running i4blt, then selecting a CATIA V5
product and performing Open as details, the tab for Concurrent will have changed to
Concurrent-Offline.
• At this point, these licenses are not yet available for offline use.

Figure 15 – Concurrent-Offline Tab

• Authorizations will need to be set in order to make Concurrent-Offline licenses

available for offline use. Run i4blt, select (highlight) a CATIA V5 license, then click
Selected on the toolbar, and click Authorizations from the pull-down menu.

Page 21 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Figure 16 – Authorizations

Page 22 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Adding Authorizations for Offline Licenses

• Authorizations for offline license usage can optionally be made by user, by group, or by
target ID.
• Passwords can also be specified.
• The default authorization mode is All concurrent allowed, where concurrent usage is
allowed, but offline usage is not allowed.
• If unrestricted use of offline licenses is desired, the default authorization mode can be
changed from All concurrent allowed to All allowed, which will allow both
concurrent and offline usage of the licenses.

Figures 17 and 18 – Add Authorizations

Page 23 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Setting the Default Offline Period

• The default maximum offline period for a CATIA V5 license is 30 days. This
maximum cannot be changed to a higher value.
• A value lower than 30 days can be specified.
• Different licenses can be assigned different default values.
• If problems occur with an offline license, the offline license can become “hung”
(unusable either offline or on the license server) until the expiration date of the offline
license occurs. For licenses in short supply, this can become a significant problem.

Figures 19 and 20 – Setting Offline Period

• See LUM’s Using License Use Management Runtime – Version 4.6.8 documentation,
available at URL http://www.ibm.com/software/lum/library.html, for additional details
on license server setup for Concurrent Offline Licensing.

Page 24 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Extracting the License to the Client Workstation

• To make the license available for offline use on the client workstation, run CATIA
V5’s Nodelock Key Management tool on the client workstation that is to use the
license on offline mode.
• The client workstation must be networked connected to the license server at this time,
in order to extract the license from the license server.
• After starting the CATIA V5 Nodelock Key Management tool on the client
workstation, click File and select Extract. A list of licenses available for extraction
will be displayed, with the associated maximum offline periods.
• Select (highlight) the desired license(s) and click the Extract button.
• Prompting for a password will occur if a password had been set during the
Authorization process.
• A shorter expiration period than the default expiration period can be requested.
• It is recommended that the shortest practical expiration period be set wherever possible,
in order to minimize the effect of “hung licenses.” For example, if a laptop is to be
used at an offsite 3-day event, consider assigning a 7-day offline period rather than a
30-day offline period when extracting the license for that event.

Figure 21 - Extract

Figure 22 –List of Available Licenses

Page 25 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Figure 22 – License Selection and Password Entry Window

• After successfully extracting the license from the server, the client workstation can be
disconnected from the network.
• The offline license will be found in the nodelock file on the client workstation, usable
for the specified amount of days.
• On the Tools/Options/General/Licensing tab, the offline license(s) will be shown in
blue, and will be identified as local license(s) instead of server license(s).
• The license(s) can be returned to the license server before the expiration date occurs, by
connecting the client workstation to the network, and using the File/Restitute
commands in the CATIA V5 Nodelock Key Management tool.
• Offline licenses that are not explicitly restituted will expire at the end of the checkout
period, and will then automatically become available for use on the license server.

Page 26 of 27  Copyright 2006 by IBM Corporation

PLM Technical Support Series CATIA V5 Licensing Cookbook

Conclusion

The ability to set up a stable licensing environment is necessary, but the process is sometimes
very confusing. This Cookbook document was written as a desktop reference assistant. It has
been proven to be a useful tool with the implementation of CATIA V5 licenses, including
nodelocked, concurrent, and concurrent-offline.

Author
Rick Jones… a member of the PLM Technical Support Team with over thirty years of experience in mechanical
design and manufacturing. He is the Americas licensing team lead for PLM Products and member of the World
Wide Installation team. He is the past team lead of and current representative for the Americas on the Worldwide
Common Process Project. Jones is the PLM technical support representative on the LUM PDT and primary
contact for the IBM/DS HEAT program. Jones is a frequent author and presenter at CATIA Operators Exchange.
He was previously employed at Schrade Cutlery as a Tool and Die Maker. Jones attended Ulster Community
College and served in the USAF in the communications field. Rick can be reached at mrrrj@us.ibm.com.

® CATIA is a registered trademark of Dassault Systemes.

® Windows XP and Windows 2000 are registered trademarks of the Microsoft Corporation.
® AIX is a registered trademark of the IBM Corporation.
® HP-UX is a registered trademark of the Hewlett Packard Corporation.
® Solaris is a registered trademark of Sun Microsystems.
® IRIX is a registered trademark of Silicon Graphics, Inc.

Page 27 of 27  Copyright 2006 by IBM Corporation