Appendix E: System settings and licenses
1. Licensing
1.1. Getting the FLEXlm HOSTID of a PC
The RIFLEX
FLEXlm license file is generated for a specific computer,
which is identified by its HOSTID. The HOSTID is the MAC address of the
primary network card of the PC where the software will be run.
The easiest way to get the MAC address is to run the command
ipconfig/all >out.txt
from the DOS command prompt. The out.txt
file may be opened with a text editor, e.g. Notepad. The MAC address is
given by the variable Physical Address
(12 alphanumeric characters).
Mobile PCs will normally have several network cards and thus several MAC
addresses - chose the MAC address under Local Area Connection
, not the
one under Wireless
.
On Windows 7 the DOS command prompt may be started by choosing Start,
Search programs and files and then typing cmd
.
On Windows XP the DOS command prompt may be started by choosing Start,
Run and then typing cmd
. Alternatively, chose Start, All Programs,
Accessories and finally Command Prompt.
Send the out.txt
file or the MAC address to your license provider so
that they can generate a license file.
1.2. Specifying the FLEXlm license server or file on Windows
The first time RIFLEX
is run on a PC a dialog will appear and the user
may specify a license server or a file location.
Choose and specify either a license server, e.g.
2002@riflex.marin.ntnu.no
(for non-commercial student use at NTNU)
or chose license file and browse to select the license file on your
computer, e.g. C:\SINTEF\ntnu_larsen.lic
The specified license server or file will then be stored with other
registry information. To change the specified FLEXlm server or file,
choose START
, Run
, regedit
, HKEY_LOCAL_MACHINE
, SOFTWARE
and
then FLEXlm license manager
. Click with the right mouse button on
MARINTEK_LICENSE_FILE
and choose modify
or delete
.
Several license files or a combination of license files and license
servers may be specified by giving a list with semicolons (;) between
the entries, e.g. C:\SINTEF\ntnu_larsen.lic;@gimli
1.3. FLEXlm error: Terminal Server remote client not allowed
Standalone uncounted licenses are intended for single user use on the PC with the specified HOSTID. They can therefore not be used via remote desktop. The solution is to acquire a server license.
1.4. Troubleshooting FLEXlm license server problems
The first step is to check with the IT staff that the license server is
running and that the RIFLEX
/ VIVANA
license has been installed.
The second step is to check the specification of the license server on
the computer attempting to run RIFLEX
/ VIVANA
. See
Section 1.2 (or Section 3.1). The entry
should be set to @
and the name of the license server machine,
e.g. @moses
or @moses.marintek.sintef.no
. It is normally not
necessary to specify the port, so don’t give a number before the @
.
Remove any old references to other license servers and/or license files.
The third step is to run the diagnostic utility lmdiag. On Windows start
a Command Prompt by choosing START
, All Programs
, Accessories
and
finally Command Prompt
. Run
lmutil lmdiag -c @SERVER -n RIFLEX_INPMOD
replacing SERVER
with the name of your license
server. This will allow you to check your connection with the license
server and whether the RIFLEX
/ VIVANA
license has been successfully
installed. You may alternatively run
lmutil lmdiag -c @SERVER -n
to obtain a list of licenses that are available from the server.
When the specified license is available, a This license can be checked
out
message will appear. Note that a number of No licenses for …
messages may also appear in the list, e.g.
lmutil - Copyright (c) 1989-2003 by Macrovision Corporation. All rights reserved. FLEXlm diagnostics on Tue 11/11/2008 11:26 ----------------------------------------------------- License file: 27000@moses ----------------------------------------------------- No licenses for RIFLEX_INPMOD in this license file ----------------------------------------------------- License file: 27001@moses ----------------------------------------------------- "RIFLEX_INPMOD" v1.0, vendor: MARINTEK License server: moses floating license expires: 15-jan-2009 This license can be checked out ----------------------------------------------------- ----------------------------------------------------- License file: 27002@moses ----------------------------------------------------- No licenses for RIFLEX_INPMOD in this license file
Trying to obtain a license that is not available results in only No
licenses for…
messages for all ports.
Specifying an unreachable server name will result in only the first two lines of text; the line with the lmutul copyright information and the current date and time.
2. RIFLEX for Windows Utility
2.1. Specifying program modules in RIFLEX for Windows
The location of the RIFLEX
program modules is stored on the
RIFLEX4Win.INI
file which is located on the same directory as
RIFLEX4Win.exe
. If the location is not specified on the
RIFLEX4Win.INI
file, e.g., when RIFLEX
for Windows is started for
the first time, the location is set to RIFLEX_HOME\bin
using the
environmental variable RIFLEX_HOME
. The INI
file RIFLEX4Win.INI
is
updated when RIFLEX
for Windows is closed.
The location may thus be reset by replacing the RIFLEX4Win.INI
file,
resetting the RIFLEX_HOME
environmental variable and then restarting
RIFLEX
for Windows. The RIFLEX4Win.INI
file may be re-downloaded or
edited by the user.
Overwriting the INI
file may also be necessary if the directory where
RIFLEX
was last run is no longer available.
Alternatively, the path to the executables may be specified in RIFLEX
for Windows. Select Options
and then Programs
and set the correct
folder name for HOME
and the individual program modules INPMOD
,
STAMOD
, … .
The same procedure is applicable for VIVANA
for Windows. This allows
the user to have separate RIFLEX
and VIVANA
installations, using the
correct INPMOD
and STAMOD
modules in each.
2.2. Run-time error 9: subscript out of range
This error message indicates that RIFLEX
for Windows cannot find the
expected key data for plotting. It is usually caused by empty or
incomplete .mpf
files and may occur after running an analysis or when
starting RIFLEX
for Windows or selecting a new directory.
The immediate remedy is usually to delete the offending files with the
mpf
suffix on the directory.
Check the RIFLEX
/ VIVANA
.res
files to see if the problem is
caused by an error in the analysis; e.g. the analysis has been
interrupted or failed. It may also occur after a successful analysis if
no plots were stored on the .mpf
file; e.g. pure Catenary STAMOD
analyses, static analyses with the parameter IFILFM = 0
, dynamic
simulations that are shorter than the specified start time for response
envelope calculation or where envelopes are not calculated or stored.
Please check the STAMOD
data group STAMOD CONTROL INFORMATION
and
the DYNMOD
data groups ENVELOPE CURVE SPECIFICATION
and
REGWAVE PRINT OPTIONS
.
3. Linux
3.1. Specifying the FLEXlm license server or file on Linux
Before running RIFLEX
for the first time the environment variable
MARINTEK_LICENSE_FILE
must be set to the license server or file
location, e.g.
MARINTEK_LICENSE_FILE="@flexlm"
MARINTEK_LICENSE_FILE="/home/ep/riflex_test.lic"
or (for non-commercial student use at NTNU)
MARINTEK_LICENSE_FILE="2002@riflex.marin.ntnu.no"
This value will be stored on the file .flexlmrc
in the user’s home
directory the first time one runs RIFLEX
. This file may later be
edited if necessary.
Several license files or a combination of license files and license servers may be specified by giving a list with semicolons (;) between the entries, e.g.,
MARINTEK_LICENSE_FILE="/home/ep/riflex_test.lic;@flexlm"
3.2. Setting Environment variables on Linux
Environmental variables be used to specify work array size or the
maximum number of arrays on files, see Work array size and
Maximum number of arrays. If not set, default values will be used by
RIFLEX
. For example to increase the DYNMOD
work array to twice the
default size.
To set in a Bourne / Korn / Bash shell
export RIFLEX_DYNMOD_MEM="500"