Installation and Licensing
Installation and Licensing
Installation and Licensing
Licensing:
For licensing information, please contact Reaction Design at (858) 550-1920 (USA) or [email protected].
Technical Support:
Reaction Design provides an allotment of technical support to its Licensees free of charge. To request technical support,
please include your license number along with any problem-specific information, including project input or output files,
and any error messages pertaining to your question or problem. Requests may be directed in the following manner: E-mail:
[email protected], Fax: (858) 550-1925, Phone: (858) 550-1920.
Additional technical support hours may also be purchased. Please contact Reaction Design for the hourly rates.
Copyright:
Copyright 2014 Reaction Design. All rights reserved. No part of this book may be reproduced in any form or by any
means without express written permission from Reaction Design.
Trademark:
CHEMKIN and REACTION DESIGN are registered trademarks of Reaction Design in the United States and other countries.
Aurora, Chemkin, The CHEMKIN Collection, CHEMKIN-CFD, CHEMKIN-MFC, CHEMKIN-PRO, Conp, Creslaf,
ENERGICO, Equil, Equilib, Fort, KINetics, Model Fuels Consortium, Oppdif, Ovend, Parameter Study Facility, Particle
Tracking Feature, Pasr, Plug, Premix, CHEMKIN-PRO Reaction Workbench, Senkin, Shock, Spin, Surface Chemkin,
Surftherm, Time-to-Solution,Transport, Twafer, Twopnt are all trademarks of Reaction Design or Sandia National
Laboratories. These trademarks apply in the United States and other countries.
Limitation of Warranty:
The software is provided as is by Reaction Design, without warranty of any kind including, without limitation, any
warranty against infringement of third party property rights, fitness or merchantability, or fitness for a particular purpose,
even if Reaction Design has been informed of such purpose. Furthermore, Reaction Design does not warrant, guarantee, or
make any representations regarding the use or the results of the use, of the software or documentation in terms of
correctness, accuracy, reliability or otherwise. No agent of Reaction Design is authorized to alter or exceed the warranty
obligations of Reaction Design as set forth herein. Any liability of Reaction Design, its officers, agents or employees with
respect to the software or the performance thereof under any warranty, contract, negligence, strict liability, vicarious
liability or other theory will be limited exclusively to product replacement or, if replacement is inadequate as a remedy or
in Reaction Designs opinion impractical, to a credit of amounts paid to Reaction Design for the license of the software.
2014.04.1
Contents
Table of Contents
1
Introduction..................................................................................................................................................................9
1.1
1.2
1.3
2.3
2.4
2.5
2.6
2.7
3.2
3.3
RD-INST-1404-UG-1
2014.04.1
Table of Contents
3.4
3.5
3.3.2
Required Tasks...........................................................................................................................39
Requesting a License from Reaction Design ..........................................................................................39
3.4.1
Obtaining lmhostid......................................................................................................................39
3.4.2
Special Cases for lmhostid on Linux .......................................................................................40
3.4.3
Requesting Your License File...................................................................................................41
Installing a UNIX License ...........................................................................................................................41
3.5.1
UNIX Node-locked or Network License Server .....................................................................42
3.5.2
Network Clients...........................................................................................................................44
3.5.3
UNIX Licensing Utilities .............................................................................................................44
Server Line....................................................................................................................................................59
Daemon Line ................................................................................................................................................60
Feature Lines / Increment Lines................................................................................................................60
Comment Lines ............................................................................................................................................61
Index ............................................................................................................................................................................79
RD-INST-1404-UG-1
2014.04.1
Contents
List of Tables
1-1
3-1
3-2
RD-INST-1404-UG-1
2014.04.1
List of Tables
RD-INST-1404-UG-1
2014.04.1
Contents
List of Figures
2-1
Request License Utility dialog, which is used to request license keys from Reaction Design ......................................17
2-2
Web form opened by Request License Utility when Web Form button is selected .......................................................18
2-3
Text box opened by Request License Utility when Email button is selected. ...............................................................18
2-4
2-5
Example of log file created by the Reaction Design License Tool ................................................................................21
2-6
2-7
2-8
2-9
3-1
3-2
3-3
3-4
3-5
3-6
RD-INST-1404-UG-1
2014.04.1
List of Figures
RD-INST-1404-UG-1
2014.04.1
Introduction
The information provided in this manual describes the Licensing and Installation procedures
for Reaction Design products, including both CHEMKIN and CHEMKIN-PRO. Examples that
apply to CHEMKIN-PRO but not to CHEMKIN are highlighted with a CHEMKIN-PRO Only
tag plus a
The CHEMKIN Installation and Licensing Manual is designed to help users and
system administrators install Reaction Designs license-utility software and to activate
licenses associated with Reaction Design software. Although this manual is available
on the Reaction Design website, the version provided in the download files with a
specific product has the most up-to-date information at the time of release.
Further information concerning the use and operation of any specific Reaction Design
product can be found in the user manuals available with the product installation.
1.1
RD-INST-1404-UG-1
2014.04.1
Chapter 1: Introduction
Table 1-1
Manufacturer
Operating System(s)
Notes
Linux
(x86)
Linux
(x86_64)
PC-compatible
(Win32)
Windows 64-bit
(Win64)
Windows XP64
Windows Vista 64-bit
Windows 7 or 8
Windows Server 2003,
2003R2, 2008, 2008R2, or
2012
If you have a specific question about a platform that is not listed, please contact Reaction
Design Support for further clarification (see Chapter 5 for contact information).
1.2
System Requirements
Before you start, take a minute to verify that you have the following requirements
needed to install and run Reaction Designs products:
1. A suitable computer and operating system, as listed in Table 1-1.
2. 350 Megabytes of hard disk space.
3. 1 GB of RAM (2 GB or more is recommended for 64-bit installations or Vista
systems).
1.3
10
RD-INST-1404-UG-1
Chapter 1: Introduction
1. Obtain and install a license file from Reaction Design for the product(s) that
you have purchased.
2. Install the software after downloading from the web (or from a CD-ROM).
3. Test the license installation to make sure a license can be checked out.
Each of these steps is described in more detail in the following chapters. The
instructions are divided according to platform. Section 2.2 describes installation
procedures for all Windows-based PCs, while Section 2.3 describes installation
procedures for all UNIX platforms (including Linux).
In general, the license manager and license daemons (lmgrd and reaction)
corresponding to the most recent Reaction Design product installed should be used on the
License Server. Such utilities are backwards compatible with older license files. In addition,
the latest license files typically enable older versions of the software as well as the version
purchased.
RD-INST-1404-UG-1
11
2014.04.1
Chapter 1: Introduction
12
RD-INST-1404-UG-1
2014.04.1
2.1
5. Choose the Destination Location. This is the location on your hard disk where
you would like to install the RD product. The default is
C:\Program Files\Reaction, but you may select any drive or folder name
using the Browse button. Once you have chosen the default folder, click Next
to continue.
A subfolder will be created below the default Destination Location to contain the latest
installation of <product>. A licenses folder will also be created or updated.
RD-INST-1404-UG-1
13
2014.04.1
Note: The installation location must not have Unicode (such as Kanji) characters in the path
because computational jobs run in the DOS shell environment do not fully support Unicode.
6. Choose the folder for your Start > All Programs menu. Modifying the settings
here changes the way the short-cuts are organized in your Programs menu.
Click Next to continue.
7. Some installations include an optional product named GraphViz. You may see
an option for a graphing product named GraphViz1. If you select Yes in this
panel, the GraphViz installation will be run prior to the Reaction Design
selected product installation. If GraphViz is already installed, you do not need
to install it again.
8. At this point the Setup program will begin installing files on your computers
hard disk. After the files have been installed successfully, the setup dialog will
ask you to reboot your computer. Choose Yes to allow the program to reboot,
or No to reboot manually later.
The reboot step is necessary to set environment variables and a default license-file location in
your system registry. The installed product and licensing may not operate correctly until your
system is rebooted.
CHEMKIN-CFD for FLUENT users must specifically set the environment variable for the
Reaction Design license server, $REACTION_LICENSE_FILE. See Section 3.2.
2.1.1
1.http://www.graphviz.org
14
RD-INST-1404-UG-1
In short, you record your installation responses as follows into a ".iss" file. You can
also record an uninstall response file. Then, you perform other installs using that ".iss"
file to provide the responses. The install runs very quickly using this approach. The
below example writes these ".iss" files to the C:\ location; you should select an
appropriate location -- this can be a network drive.
Record files:
$ chemkin15131_win64_setup.exe /r /f1"C:\iss\chemkin_win64_setup.iss"
$ chemkin15131_win64_setup.exe /r /uninstall /
f1"C:\\chemkin_win64_uninstall.iss"
Perform silent installation using recorded response files.
$ chemkin15131_win64_setup.exe /s /f1"C:\iss\chemkion_win64_setup.iss" /
f2"C:\iss\chemkin_win64_setup.log"
$ chemkin15131_win64_setup.exe /s /uninstall /f1"C:\iss\chemkin_win64_uninstall.iss" /
f2"C:\iss\chemkin_win64_uninstall.log"
2.2
You must have a valid license key to access the software downloads on the Reaction Design
website. The license will also be required to run the installed product.
2.2.1
Assumptions
We assume the following, for purposes of providing instructions on obtaining and
installing a license on a Windows operating system:
You have already installed the product on your computer.
The default installation directory for Windows is C:\Program Files\Reaction.
If you have installed in a different location, please make the necessary
replacements in the instructions that follow.
RD-INST-1404-UG-1
15
2014.04.1
2.2.2
Required Tasks
To activate your Reaction Design products.
1. Request a license from Reaction Design, providing information about your
computer.
2. Install the license received from Reaction Design.
2.3
16
RD-INST-1404-UG-1
Request License Utility dialog, which is used to request license keys from Reaction Design
RD-INST-1404-UG-1
17
2014.04.1
Web form opened by Request License Utility when Web Form button is selected
Email. This option will create text that can be embedded into an email to
Reaction Design. The Email button will open a text box as shown in
Figure 2-3. Copy and paste the contents of the text box into an email or
use the Save button to save the text to a text file to send later.
Figure 2-3
Text box opened by Request License Utility when Email button is selected.
Upon receipt of your computer information, Reaction Design will generate a set of
license keys that are specific to your computer and to the selection of product
modules that you have purchased. These license keys will be sent to you by email.
The next two sections describe how to install the license keys on your PC.
18
RD-INST-1404-UG-1
2.4
2.4.1
When saving your license file as chemkin.lic or reaction.lic, be sure that your text editor
does not inadvertently add an extra .txt extension onto the end of the file name. To view the
file extension, you can open a command prompt, change folders to the
c:\Program Files\Reaction\licenses folder and type DIR; the full file name of the license file
should be listed. Alternatively, you can right-click on the file, select the Properties command.
Then, click the Detail tab and look at the File Name entry. It will show the file extension even if
your Windows folder options setting is to hide file extensions.
If this change is not made, then the Manage License Utility will attempt to change the license
file to the name of the computer where it is running. In many cases, Reaction Design will make
this change before sending the license file.
RD-INST-1404-UG-1
19
2014.04.1
b. On the DAEMON line, verify that the PATH to reaction.exe is correct; the
default location is
C:\Program Files\Reaction\licenses\license_utilities\reaction.exe.
c. Save the license file. If no SERVER or DAEMON lines are included in the
original file, then no changes are required.
You now need to start the license server to activate the product. To activate a license
on a Windows Node-Locked License or Windows Network License Server (Network
Clients can skip this step), complete the following steps.
3. Navigate to Start > All Programs > Reaction Design > License Tools >
Manage Reaction Design Licenses. In Windows 7 and Windows Vista, rightclick on this item and select Run as Administrator. With Windows XP, simply
click on it. This should open the License Tool dialog, as shown in Figure 2-4.
See the page at the Reaction Design website on Installing as Administrator on
Windows Systems for more details on the additional security requirements
and the Run as Administrator option.
Figure 2-4
20
RD-INST-1404-UG-1
4. Click the Start Service button to begin the license daemon service. With the
Start Service at Boot Time box checked (default), the Start Service action will
not need to be repeated, unless there is a change to the license file or to the
license daemon.
5. After waiting a few seconds, the Service Log (debug.log file) is displayed and
you can verify that the service was successfully started. An example of text
that would be displayed after the license daemon is initialized is shown in
Figure 2-5.
Windows 7 and Vista will not allow the Start Service command to succeed unless the lmgrd
executable is version 11.4 or higher. This version is distributed with CHEMKIN 4.1.1,
CHEMKIN-PRO, ENERGICO, and FORT and should be used with Windows-7- and Vistabased license servers. Even so, you may encounter problems due to operating-system
security and need to manually start the license daemons after rebooting.
Figure 2-5
RD-INST-1404-UG-1
21
2014.04.1
Occasionally the port@host or license file location set in the Manage Reaction Design
License tool does not get updated into the computer's environment until the computer is
rebooted and the FLEXlm License Finder dialog will appear the first time you start a Reaction
Design application. Simply provide the same license file path to this utility that you provided to
the Manage Reaction Design License utility.
2.4.2
Network Clients
Network or floating licenses allow more than one machine to run a product by
accessing a centrally located license file that resides on a Network License Server.
Depending upon the number of seats purchased a license allows one or more
simultaneous active users to run the product. Clients of the Network License Server
should have their own local installation of the product. The client does not need to be
running on the same platform as the License Server.
Start the Manage Reaction Design License Tool as described in Section 2.4.1. You
are not required to have systems admin privileges to specify the license server
location. So, respond Yes or No to the Admin Privileges (Figure 2-6) prompt as
appropriate.
Figure 2-6
You are not required to have a copy of the Servers license file on the client machine,
and we recommend that you do not copy it, as this may cause confusion. In this case,
you will likely see the warning in Figure 2-7. Simply click OK.
Figure 2-7
22
RD-INST-1404-UG-1
Finally, in the Path to License field (Figure 2-8), enter the port@host location of the
license server. By default, the Reaction Design license server uses 28850 as the port.
So, enter 28850@<servername>, where <servername> is the name of the license
server machine, and click OK.
Figure 2-8
Now the client will be able to check out a license through the Server daemon.
Occasionally the port@host or license file location set in the Manage Reaction
Design License tool does not get updated into the computer's environment until after
one of these situations:
The My Computer > Properties > Advanced > Environment Variables tab
is opened and closed. (This triggers a refresh of the environment variable
settings.)
The computer is rebooted (and all environment settings are refreshed).
In these cases, the FLEXlm License Finder dialog message will appear (but is
minimized) and you will need to specify the same port@host or license file path that
you just specified in the Manage Reaction Design License tool. We have made every
attempt to prevent this problem, but you may still encounter it. You will only need to
provide this information to the FLEXlm License Finder once.
RD-INST-1404-UG-1
23
2014.04.1
You may see a message warning about the port@host listing in the license file as
shown in Figure 2-9. You can safely ignore the warning and click OK.
Figure 2-9
After specifying your license server location, verify that you can access the license
server. From the Start menu, use the All Programs > Reaction Design > License
Tools > Test Reaction Design License Server Status command to confirm the
license service is up and that you can connect to it. The output of this command is
described in Section 2.5.3; confirm that you are seeing a successful connection as
described in that section. If the license service is not accessible, no amount of work
on your license client will be sufficient. You must first coordinate with the people who
administer the license server system to unblock the firewall at their end, to start the
license service on the license server, and to otherwise create the conditions that allow
your license client to connect to the license service.
2.5
2.5.1
24
RD-INST-1404-UG-1
2.5.2
2.5.3
2.5.4
set_license_path.bat
This script prompts you for the port@host location of your license server and also
updates the registry and environment-variable settings used by FlexLM to keep track
of locations where it has successfully obtained a license checkout. This utility is useful
to clear/purge this information and store only the current location
RD-INST-1404-UG-1
25
2014.04.1
Having a history of obsolete license server locations can slow down the license
checkout process because the program tries each location and must wait for a lackof-reply timeout before trying the next location.
Figure 2-10
26
RD-INST-1404-UG-1
Figure 2-11
2.5.5
2.5.6
RD-INST-1404-UG-1
27
2014.04.1
2.5.7
2.5.8
lmtools.exe
There is a FLEXnet-provided graphical interface to the lmutil.exe utility, which can be
accessed from the Start > Reaction Design > License Tools > Supplemental
FLEXnet Tools > LMTools menu option. It can provide an alternative way to start/
stop your license file if the Manage Reaction Design License tool encounters a
problem. Please refer to the FLEXnet online documentation we provide for more
information.
2.5.9
installs.exe
This is a FLEXnet-provided utility program that updates the Windows Registry with
the information needed to enable the license server to be a Windows Service. The
Manage Reaction Design License tool invokes this utility, as does lmtools.exe.
Please refer to the FLEXnet online documentation we provide for more information.
2.5.10
vista__START_license_server.bat
This is a command file to start the license daemons. Double-click on it to run.
2.5.11
vista__STOP_license_server.bat
This is a command file to stop the license daemons. Double-click on it to run.
2.6
28
RD-INST-1404-UG-1
The executables in this folder work with FLEXnet version 11.4 and higher. Since
subsequent Reaction Design product releases may be built using newer versions of
FLEXnet, this folder contains subfolders with FLEXnet-version-specific files. The
installation process copies the latest executables and dll's up to the license_utilities
folder. If the installation is performed while the license daemons are running, those
running daemons are renamed to PREVIOUS_lmgrd.exe and
PREVIOUS_reaction.exe. Once you have stopped and restarted the licensing
service, these renamed PREVIOUS_* files can be deleted.
2.7
If you have added files to or modified files in the products installation, the Uninstall process
will not automatically remove these files.
RD-INST-1404-UG-1
29
2014.04.1
30
RD-INST-1404-UG-1
2014.04.1
3.1
In the above command, replace ppp with one of the following strings, selecting
the one that best describes your UNIX platform, for example: linux9, or
linuxx8664.
Replace <product> with your products product name and version number,
NNNNN:
forteNNNNN or energicoNNNNN or chemkinNNNNN or
chemkinproNNNNN or chemkincfdapiNNNNN or
chemkincfdfluent_NNNNN or rdlictoolsNNN or the product string and
version number you are installing.
Table 3-1
RD-INST-1404-UG-1
Operating System(s)
linux9
Linux 32 bit:
Red Hat Enterprise 5, 6
SuSE 10.2, 11, 12
linuxx8664
Linux 64-bit:
Red Hat Enterprise 5, 6
SuSE 10.2, 11, 12
31
2014.04.1
2. The Reaction Design License Agreement screen (Figure 3-1) will appear.
Accept the license agreement by clicking the I Accept button.
Figure 3-1
3. If you are installing CHEMKIN-CFD for FLUENT, you must select the location
of an existing FLUENT installation. The CHEMKIN-CFD for FLUENT binary
files will be installed into this location.
4. The product Installation screen will appear. Verify that the correct installation
directory is selected and displayed. If the installation directory is acceptable,
click Next to continue.
If the installation directory is not what you want, please browse to the correct
location and then click the Open button to select it.
Once you have identified the installation directory, the default installation setup
will create a new Reaction/<product>_ppp directory within your home
directory.
32
RD-INST-1404-UG-1
RD-INST-1404-UG-1
33
2014.04.1
Figure 3-3
After the
installation is
complete the
message
Installation
Succeeded
will appear.
6. Next, instructions for verifying the installation and operating the Reaction
Design product are presented, as illustrated in Figure 3-4. Follow the
instructions that apply to your installation.
Figure 3-4
The installation of the product is now complete. Please proceed to Section 3.2 to
configure your environment.
34
RD-INST-1404-UG-1
3.1.1
3.1.2
Because there are required spaces in this string, be sure to use single or double
quotes around the entire string value as shown. The automated install will only run if
all required responses are provided; otherwise it will run interactively and present all
the usual interactive prompts. In addition to the above response items, other items
that might be used with some installers are listed below.
CHEMKIN/CHEMKIN-PRO combined installer additional, optional arguments:
-DCK
-DNOCKPRO
-DWB
RD-INST-1404-UG-1
35
2014.04.1
3.2
36
RD-INST-1404-UG-1
The shell scripts used to run the user interfaces are Bourne shell scripts and use the
*_setup.ksh file to source the environment. Therefore, even if all users work in the C shell
environment, the *_setup.ksh file is used also.
The PATH and shared object library path variables must be exported prior to sourcing the
*_setup.ksh file. LD_LIBRARY_PATH is the shared object library path variable. For more
information on the shared object library path variable, see Table 3-2.
RD-INST-1404-UG-1
Table 3-2
Variable
Description
$REACTION_DIR
This is a required variable. It points to the root directory chosen for the product installation
and is set by the installer. An example would be:
$HOME/reaction
$REACTION_LICENSE_FILE
This is a required variable. It points to the location of a valid license port@host of a valid
Reaction Design license server. By default this is set by the installer to be:
28850@server-host
The value is stored in a file named .reaction_license_server_path found in:
$REACTION_DIR/licenses/license_utilities directory
$<PRODUCT>_VERS
$CHEMKIN_BIN,
<PRODUCT>_BIN
Required by CHEMKIN and other products. It points to the location of the bin directory for
the CHEMKIN installation. It is derived from the variables above during installation as the
following:
${REACTION_DIR}/chemkin${CHEMKIN_VERS}_ppp/bin
where ppp is a platform-specific tag. This variable cannot be changed.
37
2014.04.1
Table 3-2
3.2.1
Variable
Description
$KINETICS_API_BIN
Required by CHEMKIN-CFD/API. It points to the location of the bin directory for the
CHEMKIN-CFD/API installation.
$PATH
$CHEMKIN_HOME
$CHEMKIN_USER
This is an optional CHEMKIN variable. It is not automatically defined. The variable is used
in naming the preferences file.
$CKJAVAMEMORY
Optional variable defining how much memory to allocate to the Java Virtual Machine
running the CHEMKIN Interface.
$ENERGICO_MEMORY
$FORTE_MEMORY
Optional variable defining how much memory to allocate to the Java Virtual Machine
running the ENERGICO or FORT Interface. If not defined, you will be prompted for this
value.
38
RD-INST-1404-UG-1
3.3
You must have a valid license key to access the software downloads on the Reaction Design
website. The license will also be required to run the installed product.
3.3.1
Assumptions
We assume the following for purposes of providing instructions on obtaining and
installing a license on a UNIX workstation:
You have already installed the product on your computer.
The default installation directory for your UNIX workstation is
$HOME/reaction. If you have installed in a different location, please make the
necessary replacements in the instructions that follow.
3.3.2
Required Tasks
1. Request a license from Reaction Design, providing information about your
computer.
2. Install the license received from Reaction Design.
3.4
3.4.1
RD-INST-1404-UG-1
39
2014.04.1
Please cut and paste all of the information below into an email to [email protected]. This
provides us with the information we need to generate the unlock keys contained in your
license file. Since we also list your license number, your company/university/organization
name, and your name in the license file, please be sure to include that information as well.
If you have not purchased a license to use Reaction Design products, you will not yet have a
license number. In this case, please send all this information to
[email protected] and our sales team will contact you to explore which of our
products best meets your needs.
Hostname: linux64
Reaction Design Platform Type: linuxx8664
uname -a : Linux linux64 2.4.21-27.ELsmp #1 SMP Wed Dec 1 21:53:57 EST 2004 x86_64 x86_64
x86_64 GNU/Linux
Now obtaining FLEXnet Hostid:
lmutil - Copyright (c) 1989-2004 by Macrovision Corporation. All rights reserved.
The FLEXlm host ID of this machine is "001185ae5aaa"
This machine can be the machine you have installed the Reaction Design product on,
or can be another UNIX or Windows machine.
3.4.2
40
RD-INST-1404-UG-1
Dual-boot machines that run both Windows and Linux, especially with docking
stations, can pose additional problems due to multiple MAC addresses depending on
hardware profile and operating system selection. In these cases, we may need to
provide a license based on DISK_SERIAL_NUMBER; please use the Windows
version of Request License to obtain this information. These machines do not make
good choices for serving a floating license. Please be sure to inform us when
requesting a license for this configuration.
3.4.3
3.5
RD-INST-1404-UG-1
41
2014.04.1
3.5.1
Note: If you are using a license server installed elsewhere, you are a network client and can
skip this section.
After requesting a license, you should receive by email a specific license to run a
Reaction Design product on your system. The file may have either UNIX or PC lineendings, depending on where and how you receive your email; if you need to transfer
the license file from one machine to another, be sure to use ftp in ascii mode to
guarantee the line endings get converted correctly
1. Edit the license file using a text editor of your choice. Name the file either
reaction.lic or chemkin.lic and place it in the licenses directory.
2. Change the text line, SERVER <servername>, so that <servername> is the
name (e.g., MYWORKSTATION) of the Network License Server (or the local
machine for a Node-locked License).
3. On the DAEMON line, verify that the PATH to reaction is correct; the default
location is $REACTION_DIR/licenses/license_utilities/114/ppp/reaction,
where ppp is your platform type.
4. Complete the following steps:
If you have not named the license reaction.lic and placed it in the licenses
directory, then please make the appropriate changes to these instructions when
reading.
a. Go to the license_utilities directory:
cd $REACTION_DIR/licenses/license_utilities
This will start the license server, placing the lmgrd log file in the
../reaction_debug.log location (in the licenses directory). This is now our
recommended location.
42
RD-INST-1404-UG-1
The manage_license.sh script may alert you to the DAEMON path being incorrect or
the SERVER name not being updated. In this case, please correct the license file
accordingly. Once any problems are corrected and you have successfully started the
license, you will see diagnostic information scroll down your window informing you of
the license daemon status (UP) and the number of copies and expiration date of each
license. Figure 3-5 provides an example. However, a message such as that shown in
Figure 3-6 indicates that there was a problem starting the license.
Figure 3-5
If you have problems starting the license, please examine the lmgrd log file
../reaction_debug.log for specific messages about starting your license
service. If you need help troubleshooting your license installation, please see our Help
page:
http://www.reactiondesign.com/support/help/
RD-INST-1404-UG-1
43
2014.04.1
If you need further assistance, contact Reaction Design Support (see Chapter 5 for
contact information) and provide your license file, log file, and the specific messages
you are obtaining.
3.5.2
Network Clients
1. The location defined for the REACTION_LICENSE_FILE environment variable
in chemkin_setup.csh|ksh is now defined as:
`cat
$REACTION_DIR/licenses/license_utilities/.reaction_license_ser
ver_path`
which results in a file being read and the contents of that file becomes the
license location. This file is updated by the manage_license.sh shell script with
the setpath option, as described in Section 3.5.3.1.2.
2. If you need to specify a different license location, please see the next section
on setting your license path.
3. Before attempting to use your license client connection, verify that you can
access the license server. Use the manage_license.sh status [license
server location] command described in Section 3.5.3.1.1 to confirm the
license service is up and that you can connect to it. Confirm that you are
seeing a successful connection as described in that section. If the license
service is not accessible, no amount of work on your license client will be
sufficient. You must first coordinate with the people who administer the license
server system to unblock the firewall at their end, to start the license service
on the license server, and to otherwise create the conditions that allow your
license client to connect to the license service.
4. You are now ready to verify your installation of the product.
3.5.3
44
RD-INST-1404-UG-1
3.5.3.1
manage_license.sh
This shell script performs four distinct actions: check status, set the license server
path, start the license server, and stop the license server. Each of these operations
can take additional arguments beyond the action argument. For example, the check
status action is invoked as follows:
3.5.3.1.1
Check Status
The syntax for this command is:
manage_license.sh status [license server location]
This command checks the status of the license server. It performs this check by
determining the license server location and calling the check_license.sh script. If you
do not specify the location of the license server, it uses whatever location was
specified previously. If you have never specified a location, the location provided at
the time of installation is used. By default, this is 28850@<your hostname>.
When the license server is up, you will get a lot of output listing the license daemons
and license features that are available for use. Getting a lot of output is usually
sufficient to confirm that the license server is up. The specific item to look for is
reaction: UP v, which indicates that the reaction daemon is up and
communicating.
The output begins similarly to Figure 3-5. The reaction UP line is the 5th line in that
output.
If you do not get a lot of output, and instead get a brief output that looks something
like Figure 3-6, then the license server is either not up or you have not specified the
correct location of the license server. In either case, you will need to work with the
license administrator to learn more. If you are the license administrator, then you
should log in to the license server machine and rerun this check.
The specification of the license server location is an optional parameter. If you are not
on the license server, we strongly encourage specifying the license server location via
the port@host syntax, such as 28850@<lic-server> where <lic-server> is the
hostname of the license server. If you are on the license server, you can alternatively
provide the location as an absolute or relative path. For instance, the default license
location is ../reaction.lic or ../chemkin.lic depending on what you named
the license file. The ../ syntax means to look in the parent directory.
If you have named your license file ../reaction.lic and you run this status check
as:
RD-INST-1404-UG-1
45
2014.04.1
12ab34cd4934
28850
If no port is specified, please add 28850 (or any other port above 1700) to the
SERVER line. When no port is specified, FLEXnet selects a port.The port selected is
not entirely random, but it can vary and therefore is not useful in telling others how to
locate the license server. For this reason, we strongly recommend always specifying a
port on the SERVER line. We suggest 28850 because we believe this port is not used
for any other purpose and we use this as our default value in our tools and
documentation. Any new user of our tools will get 28850 by default.
3.5.3.1.2
46
RD-INST-1404-UG-1
Note: You only need to run this command if the location you provided during installation needs
to be updated. If it does, the location should be updated on each machine containing an
installation of the Reaction Design product(s) released in 2006 and later that reference this
location file.
3.5.3.1.3
The daemon log file (../reaction_debug.log) contains diagnostic information listing the success
or failure of starting the license server. If you are reporting license server problems, please be
sure to provide this file and the license file itself along with any other diagnostic messages.
Please look in this file for error messages; you can resolve a lot of license problems by reading
this file carefully.
The manage_license.sh utility checks your license file for the SERVER line containing
a match to the hostname that you are on. It also checks that the DAEMON reaction
line points to an existing file. Other typical problems with starting UNIX/Linux license
servers include:
RD-INST-1404-UG-1
47
2014.04.1
1. Port in use because you very recently shut down the license server (or killed
it from the command line). This is usually reported in the daemon log file. The
solution is usually to just wait 5-15 minutes for the port to clear itself.
2. Lockfile cannot be created. In this case, the license server may already be
running or it may have been killed. If you use the kill -9 command, the
license server may not have time to clean up and delete its lockfile. Typically,
the lockfile is found as /var/tmp/lockreaction. The exact path will be listed in
the daemon log file. This file must be deleted before you can start the license
server; but you may not have the UNIX file permissions needed to do this. In
this case, ask whomever created the file or someone with root permissions to
delete it. Caution: Deleting the lockfile while the license server is running will
stop that instance of the license server and any jobs currently using licenses it
provides.
For more troubleshooting information, please see the FLEXnet manuals provided with
these license_utilties:
file://$REACTION_DIR/licenses/license_utilities/114/machind/LicensingEndUser
Guide.pdf
Also, it is possible to configure most UNIX/Linux machines to restart the license
server automatically as part of the boot-up operations. We provide a script that can be
used for this purpose; see Appendix C for more information.
3.5.3.1.4
3.5.3.1.5
48
RD-INST-1404-UG-1
Requesting a License
The syntax for this command is:
request_license.sh
This script obtains the computer-specific information needed to create a license file
for use on the host where the script is run. This is described more fully in
Section 3.4.3.
RD-INST-1404-UG-1
49
2014.04.1
50
RD-INST-1404-UG-1
2014.04.1
4.1
4.2
RD-INST-1404-UG-1
51
2014.04.1
4.2.1
52
RD-INST-1404-UG-1
Note: This may be a big file; but if it is less than 5 MB please send the whole file. If it
is too big to email, please stop and restart the license server, confirm your problem
still exists, and send us the new debug.log file which will now be quite small.
d.
RD-INST-1404-UG-1
53
2014.04.1
54
RD-INST-1404-UG-1
2014.04.1
RD-INST-1404-UG-1
55
2014.04.1
56
RD-INST-1404-UG-1
RD-INST-1404-UG-1
57
2014.04.1
58
RD-INST-1404-UG-1
2014.04.1
A.1
Server Line
SERVER myserver 123bc3434fda2 28850
The SERVER line specifies the hostname (or TCP/IP address) of the computer that is
serving the license. In most cases, using the hostname is preferred, e.g., myserver.
In obscure cases where the domain name service is not reliably available, you can
use the TCP/IP address (e.g., 192.168.244.23) instead. The fields following the
SERVER keyword are
Hostname or TCP/IP Address
Lmhostid (the unique hosted value reported by the Request_License tool)
(The license encryption strings use this value; it cannot be modified without
invalidating the license.)
PORT number, e.g., 28850
RD-INST-1404-UG-1
59
2014.04.1
A.2
Daemon Line
A.3
60
RD-INST-1404-UG-1
The word INCREMENT may be used instead of FEATURE. In this case, the number
of copies specified is added to the number previously listed in a FEATURE line for the
same feature name.
A.4
Comment Lines
# Reaction Design FLEXlm License file
Any line in the license file that is not one of the earlier 3 lines is a comment line. Our
license files start comment lines with a # character; although a completely blank line is
also acceptable.
RD-INST-1404-UG-1
61
2014.04.1
62
RD-INST-1404-UG-1
2014.04.1
B.1
RD-INST-1404-UG-1
63
2014.04.1
If you are using a different firewall, such as Norton Internet Security, please refer to
the firewall vendor's manual/help for instructions on how to unblock ports 28850 and
28851 for both incoming and outgoing TCP communication.
64
RD-INST-1404-UG-1
2014.04.1
Licensing as a Service
Installing licensing as a system service allows the license manager to be
automatically restarted when the computer is restarted. This is the default approach
we recommend for Windows-based license servers. Our Manage Reaction Design
License tool provides this ability as a checkbox that is enabled by default. For Linux
and UNIX installations, enabling this capability requires root access and making
additions to system configuration files. We do NOT do this as part of our installation.
Most Linux/UNIX system administrators prefer to make these kinds of changes
themselves, rather than having software installers automate these changes.
C.1
C.1.1
[HKEY_LOCAL_MACHINE\SOFTWARE\Flexlm License
Manager\REACTION_DESIGN_FLEXLM_SERVICE]
"Lmgrd"="C:\\Program
Files\\Reaction\\licenses\\license_utilities\\lmgrd.exe"
"LMGRD_LOG_FILE"="C:\\Program Files\\Reaction\\licenses\\debug.log"
"License"="C:\\Program Files\\Reaction\\licenses\\chemkin.lic"
RD-INST-1404-UG-1
65
2014.04.1
"cmdlineparams"=""
"Service"="REACTION_DESIGN_FLEXLM_SERVICE"
C.1.2
66
RD-INST-1404-UG-1
2014.04.1
D.1
RD-INST-1404-UG-1
67
2014.04.1
Although client installations can use this approach, it requires that either (a) the
license server's copy of the license is network-accessible or (b) the client has an
identical copy of the license file. These requirements create points of failure that lead
to more frequent problems in obtaining a license by a client computer.
D.2
68
RD-INST-1404-UG-1
2014.04.1
RD-INST-1404-UG-1
69
2014.04.1
3. Always use the most recent version of lmgrd daemon. Reaction Design is
currently distributing lmgrd v 11.4. You can read the lmgrd version in the
daemon log file. The lmgrd version used must be the same or higher than the
version of any vendor daemon.
4. You can start the lmgrd license server using Reaction Design's Manage
License or manage_license.sh utility or using the instructions provided by the
other vendor, but be sure that you are the latest version of lmgrd.
a. On Windows, you can specify the location of lmgrd.exe when starting the
license.
b. On Linux/UNIX, manage_license.sh start does not provide a way to
specify an alternate location of lmgrd. If the version we provide is not the
highest version in use, you can copy the more recent version to:
$REACTION_DIR/licenses/license_utilities/114/
<platform>/lmgrd
or you can start lmgrd by hand (./lmgrd -c <lic file> -l <log
file>) or by using the instructions provided by the other license provider.
5. Specify the location of the license server to Reaction Design's products using
manage_license.sh setpath port@host on Linux/UNIX or the Manage
Reaction Design License utility on Windows.
6. Confirm the license is running using the check_license utility we provide in the
license_utilities directory.
Note: Once you have confirmed that the license server is operational and that the license
server location that you have specified is working, then test running the CHEMKIN-CFD
application or other Reaction Design product. Trying to run CHEMKIN-CFD before completing
these steps just complicates the troubleshooting; so please be patient and verify that the
license is operational first.
E.1
70
RD-INST-1404-UG-1
Another License:
SERVER HQW011 00065b848c62 8241
VENDOR other "C:\Program Files\other-vendor\bin\other.exe"
FEATURE Other_Feature other 1.000 28-feb-2007 1 A0A02020DE044AC8E264 \
VENDOR_STRING="Other Inc" ISSUED=08-sep-2005 NOTICE="License \
issued to Reaction Design" START=08-sep-2005
SIGN="0080 DF7F 1A5A 22C7 FA53 7E42 \
E7D2 0700 BF01 FE75 AE1E 5D9F 901B 9246 AA9A"
Merged License:
SERVER HQW011 00065b848c62 8241
USE_SERVER
VENDOR other "C:\Program Files\other-vendor\bin\other.exe"
DAEMON reaction "C:\Program
Files\reaction\licenses\license_utilities\reaction.exe" \
PORT=28851
FEATURE Other_Feature other 1.000 28-feb-2007 1 A0A02020DE044AC8E264 \
VENDOR_STRING="Other Inc" ISSUED=08-sep-2005 NOTICE="License \
issued to Organization-Name" START=08-sep-2005 \
SIGN="0080 DF7F 1A5A 22C7 FA53 7E42 \
E7D2 0700 BF01 FE75 AE1E 5D9F 901B 9246 AA9A"
FEATURE KINETICS_API reaction 2007.02 02-feb-2007 2 9826ED8FA44A \
VENDOR_STRING="LicNum: 9969; Licensed to Reaction Design; \
Contact: Luthor Redbone" SIGN="0080 DF7F 1A5A 22C7 FA53 7E42 \
E7D2 0700 BF01 FE75 AE1E 5D9F 901B 9246 AA9A"
In the merged license, we have kept the port used by the other vendor, 8241. The
other vendor does not specify a port for his VENDOR daemon. This is OK if the
license is working prior to being merged.
You would then specify the license server location as 8241@HQW011. You should use
our tools to specify the location to our applications and also use the other vendor's
tools (however they suggest) to specify the location to their applications. Ultimately,
our applications will rely on REACTION_LICENSE_FILE environment variable to
obtain this location. Our tools update the resources used to set this environment
variable.
RD-INST-1404-UG-1
71
2014.04.1
72
RD-INST-1404-UG-1
2014.04.1
F.1
nslookup <server-name>
where <server-name> is whatever the name of the license server is. When it
succeeds, it will tell you the IP address of the <server-name> machine. If it fails, then
your client will not be able to communicate with the license server. At that point, you
can either put the <server-name> to IP mapping into your hosts file (on the local client
machine, typically in C:\Windows\System32\Drivers\Etc\hosts or
C:\WINNT\System32\Drivers\Etc\hosts) or you can edit the license file and
specify the IP address of the license server instead of the server name.
RD-INST-1404-UG-1
73
2014.04.1
Here's an example on our network of looking for a computer named HQTS02 (which
exists) and a computer named NOGOOD (which is not on our network). The machine
hqdc01 is our DNS server which provides the name-to-IP-address conversion
service.
F.2
74
RD-INST-1404-UG-1
F.3
F.4
If you are still having problems connecting the client to the license server after
working through items 1-3 above, please try using method 2 above to specify the
location of the license service. We have found this to be the most direct and troublefree way to connect client with license service.
Effective with the CHEMKIN 4.0.2 release (April 2005), the Manage CHEMKIN
License tool accepts the port@host format for specifying the license file location. Note
that this form is not allowed on the license server itself, only with client machines.
RD-INST-1404-UG-1
75
2014.04.1
76
RD-INST-1404-UG-1
2014.04.1
replacing <CD-ROM-device> with the actual name of the CD-ROM drive on your
system. A typical name is /dev/cdrom.
G.1
RD-INST-1404-UG-1
77
2014.04.1
78
RD-INST-1404-UG-1
2014.04.1
Index
Index
Symbols
A
automated installation 14
B
bashrc file 36
bin directory
CHEMKIN 37
CHEMKIN-CFD/API 38
C
CD-ROM
mounting (UNIX) 77
UNIX, mounting 77
unmounting (UNIX) 77
check status 49
check_license.bat (Windows) 25, 28
check_license.sh script (UNIX) 45, 48, 70
CHEMKIN
home directory (UNIX) 38
multi-user environments 38
Chemkin
multi-user environments 38
CHEMKIN
home directory (UNIX) 38
preferences environment variable 38
version (UNIX) 37
CHEMKIN_BIN 37
CHEMKIN_HOME 38
chemkin_setup.csh 36
chemkin_setup.ksh 36
CHEMKIN_USER 38
CHEMKIN_VERS 37
RD-INST-1404-UG-1
D
DAEMON
keyword 59
license file 60
reaction 11
daemon
lmgrd 65, 69, 70
lmgrd (Windows) 27, 28
reaction 19, 28
DAEMON keyword 60
daemon name 60
79
2014.04.1
Index
forte_setup.ksh 36
frequently asked questions 51
G
GraphViz 14
E
email address
Japan distributor 56
Korea distributor 56
licensing 40
Sales 55
sales 40
Support 55
support 2
ENERGICO_MEMORY environment variable 38
energico_setup.csh 36
energico_setup.ksh 36
environment
multi-user 38
settings 36
environment variables 36
CHEMKIN_BIN 37
CHEMKIN_HOME 38
CHEMKIN_USER 38
CHEMKIN_VERS 37
CHEMKIN-CFD requires 36
KINETICS_API_BIN 38
LM_LICENSE_FILE 68
PATH 38
REACTION_DIR 37
REACTION_LICENSE_FILE 37, 68
shared object library path 38
executing UNIX installation script 31
expiration date 60
H
history mechanism, Chemkin 38
home
CHEMKIN (UNIX) 38
hostname 59
license file 59
license server 45
I
INCREMENT keyword 59
Increment line
license file 60
installation
UNIX 31
Windows 13, 31
installation location
UNIX 37
Windows 19
installing
UNIX license 41
Windows license 19
installs.exe 28
J
Java memory 38
K
Kanji characters 14
KINETICS_API_BIN 38
F
FAQ 51
feature
counting 60
FEATURE keyword 59
Feature line
license file 60
feature name 60
firewall issues 63, 73
FLEXlm 27
FLEXnet 27
documentation 69
FLUENT 13, 32
Fluent 32
FORTE_MEMORY environment variable 38
forte_setup.csh 36
L
LD_LIBRARY_PATH 38
license
check status (UNIX) 45
client connections 73
documentation 28
file 11, 15, 19, 22, 42
for UNIX node-locked 42
install (UNIX) 41
install, (Windows) 19
manager daemon. See lmgrd.
set the license server path (UNIX) 45
start/stop server (UNIX) 45
80
RD-INST-1404-UG-1
Index
starting automatically 65
tool 20, 29
utility to manage 25
utility to request new 24
license daemon
lmgrd 48
location 60
log file (UNIX) 47
path 60
reaction 11, 19, 28
license file 11, 15, 19, 22, 42, 60
comments 59, 61
contents description 59
create (UNIX) 49
location 68
location (UNIX) 37
location (Windows) 15, 19
multiple vendors 69, 70
license file location 68
license keys
UNIX 39
Windows 15
license manager daemon. See lmgrd.
license number 60
license request 16, 39
email 18
web form 18
license server 49
hostname 45
location, designating 33
program. See lmgrd.
specify location (UNIX) 46
specifying location 67
start (UNIX) 47
startup problems (UNIX) 4748
stopping (UNIX) 48
license service 65
installing (UNIX) 66
installing (Windows) 65
starting and stopping (Windows) 25, 28
license_utilities folder 28
Linux
cluster configurations 40
lmhostid special cases 40
troubleshooting installation 35
LM_LICENSE_FILE 68
lmgrd 27, 28, 65, 69, 70
root warning (UNIX) 42
lmhostid 59
for license server (UNIX) 39
Linux special cases 40
using RD Request License Utility 17
lmtools
Windows 28
RD-INST-1404-UG-1
lmutil
UNIX 39
UNIX. See manage_license.sh
Windows 28
log file 21, 25
debug 53
license daemon (UNIX) 47
long encryption key 60
M
MAC addresses, multiple 40
Manage Reaction Design License tool 22, 65
manage_license.sh 45, 46
mounting CD-ROM 77
multi-user environments, CHEMKIN 38
N
name of license daemon 60
Network License Server 22
node-locked license (UNIX) 42
nodelocked license (Windows) 19
number of copies 60
O
operating systems, supported 9
options file 60
P
PATH 38
Unicode prohibition (Windows) 10, 14
port number 27, 59, 60
port@host license server specification 23, 33, 45, 67
preferences
CHEMKIN (UNIX) 38
product
specified during installation 31
product setup 13
profile file 36
program setup 13
Q
questions, frequently asked 51
R
reaction daemon 11, 19, 28
Reaction Design 16
contact details 55
REACTION_DIR 37
REACTION_LICENSE_FILE 37, 68
81
2014.04.1
Index
V
variables, environment 36
VENDOR keyword 60
vendor string 60
version
number licensed 60
vista__START_license_server.bat 28
vista__STOP_license_server.bat 28
S
script
install product (UNIX) 31
request license (UNIX) 40
SERVER keyword 59
SERVER line
license file 59
server location 73
set environment variables 36
setup program 13
shared object library path 38
short encryption key 60
starting license service
UNIX 47
Windows 25, 28
stopping license service
UNIX 48
Windows 25, 28
support
technical 51
supported
operating systems 9
system requirements 10
W
web site 51, 55
Japan distributor 56
Korea distributor 56
Windows
licensing overview 15
Windows operating system
rebooting 21
Windows XP
firewall 63
T
TCP/IP address 59
license file 59
TCP/IP connection 73
Technical Support 51
technical support 51
troubleshooting
helpful diagnostic files 51
license server startup 4748
U
Unicode characters 10, 14
uninstalling 29, 31
UNIX
activating license 42
installation and licensing 31
82
RD-INST-1404-UG-1