License Codes
- SERVER line containing the server name, cpu_id, and TCP/IP port
- DAEMON line containing the path to the ptc_d executable
- Feature information (your licenses)
This section explains the structure and usage of the FLEXlm licensing file (license.dat) in PTC's implementation and the delivery of codes in the new License Pack format.
Your license codes are given to you in a License Pack. The license pack contains a customer information section and a license information section. The license information section contains "feature lines" that define your PTC licenses and floating options.
For floating licenses, the license information section also contains "SERVER" and "DAEMON" lines.
If you obtained your License Pack by e-mail or through the www (for maintenance releases only), you can save the License Pack to a file. The file can be imported directly into Pro/SETUP. This eliminates the task of manually entering your license information. This technique is highly recommended.
If you cannot obtain an on-line copy of your License Pack, your license information will need to be entered into Pro/SETUP manually.
Your license file contains all the license information (multiple feature lines) for all Configuration IDs assigned to a particular CPU. That is, all licenses for all PTC products licensed to a single machine can be defined in a single license file.
Example: A configuration of Pro/ENGINEER, Pro/FLY-THROUGH, and a license of Pro/MECHANICA are all licensed to a single license server. PTC can provide license information for all products on a single License Pack. If an on-line copy of this file is obtained, the single file can be used during the installation of all three products and needs to be imported into Pro/SETUP only once.
For floating licenses, the license information section of your License Pack contains a SERVER line. The SERVER line defines the hostname of the FLEXlm license server, the CPUID of the server, and the TCP/IP port number for communication with PTC clients. Only one server line is needed per license server.
When you get your license pack, a generic string will populate the hostname field. If you import the license pack into Pro/SETUP, this field will be replaced with the actual hostname of the server. If you are entering your license information into Pro/SETUP manually, you will need to replace this hostname when your license information is entered.
On your License Pack, the default server line format is:
SERVER __hostname__ PTC_HOSTID=(Your CPUID) 7788
If your license server�s hostname was "spock", the hostname field will be expanded to read:
SERVER spock PTC_HOSTID=08-00-69-76-0A-2E 7788
Each license server requires a daemon line to define the name of the PTC FLEXlm daemon and the path to the executable in the FLEXlm installation directory. On your License Pack, the path to the executable is replaced with a generic string that is replaced with the appropriate path when the License Pack is imported into Pro/SETUP.
On your License Pack, the default server line format is:
DAEMON ptc_d __PTCDPATH__
If your license server was installed in the /opt/ptc/flexlm directory, the daemon line would read:
DAEMON ptc_d /opt/ptc/flexlm/sun4_solaris/obj/ptc_d
With FLEXlm, serial numbers and security codes have been replaced with "feature lines" to license your software.
Feature lines define all the licensing elements (product, modules, number of licenses, and so on) to use the license on the proper host. Since all elements of a license are defined in a feature line, it can be said that feature lines replace the serial number, and security codes (revision codes, option codes, floating license codes, etc.) of PTC�s proprietary licensing scheme.
Feature lines are stored in a "license file" that is used by FLEXlm and PTC software. A single license file can contain multiple feature lines for a single or multiple products.
Feature line formats vary depending on the type of license and its usage. Refer to Appendix C for examples of feature lines per license type.
The following example shows a feature line for five locked evaluation licenses of Release 20.0 Pro/ENGINEER license for cpu_id 08-00-4E-22-AB-08. Note that the feature line contains all licensing information for the license and replaces the serial number and associated security codes.
INCREMENT PROE_366 ptc_d 20.0 11-Jul-1998 0 \ 85739247224342g47s94 VENDOR_STRING="VSVER=1.0 \
LO=(0 2 4 6 7 9 10 17 19 21 22)"\
HOSTID="PTC_HOSTID=08-00-4E-22-AB-08 \
PTC_HOSTID=08-00-4E-22-AB-09 \
PTC_HOSTID=08-00-4E-22-AB-10 \
PTC_HOSTID=08-00-4E-22-AB-11 \
PTC_HOSTID=08-00-4E-22-AB-12" \
SUPERSEDE ISSUED=01-Feb-1998
Each feature line contains all the components necessary to license the software including Feature name (product prefix_configuration ID), release, expiration date for timed licenses, number of licenses, optional modules, issue date, and the license code. The license code is defined by all the parameters that define the license.
The figure below shows an example of five floating evaluation licenses of Pro/ENGINEER Release 20.0. For licenses that use a FLEXlm server (floating licenses, floating options, and counted locked licenses) the CPUID is specified in the SERVER line, not the feature line.
Refer to Appendix B for a list of feature names by product.
License Files
Pro/SETUP stores your feature lines in a file called the "license file". By default, the file is a text file written to flexlm_installation_directory/licensing/license.dat. This file is read by the PTC/FLEXlm daemon ptc_d to manage the use of the licenses.
For floating installations, the license file contains:
Locked installations with the exception of Pro/MECHANICA licenses will not contain SERVER and DAEMON lines.
For triad installations, an identical license file will be used by each triad partner. The license file will contain three SERVER lines, feature lines for all products licensed to the triad, and any additional products licensed to any single partner.
Combining License Files from Different Vendors
Do not combine your PTC license file with the license files of other software vendors on the same FLEXlm license server. Although FLEXlm can handle combining license files, PTC�s cpu_id routine requires PTC licenses to be located in their own file. In addition, Globetrotter no longer recommends combining license files from different vendors.
Additional License File Information
More details on FLEXlm license files can be found in Chapter 2 of Globetrotter�s FLEXlm end-user documentation.