PRA FLEXlm Novell Netware Installation

This page will guide you through setting up the PRA license manager on a central Novell server. Once you have successfully set up the license manager, you will be able to run PRA products from clients or workstations that have access to the server on the local LAN.

Installation License Generation Communication Protocol Details Auto-Loading PRA FLEXlm
FLEXlm Server Details FLEXlm Client Details

Installing the Novell FLEXlm Files

The Novell network license management files are included with the Petroleum Systems Suite. To install them, run the Petroleum Systems Suite setup on a Windows client, and specify a shared directory on the Novell server for installation.

note: If you are installing the PRA products on the server as well, in the same location, you can install the products and the licensing simultaneously.
You will be presented with a list of components to install. Select "Novell Network License Manager" to install the license management files. If you are also installing PRA products at this time, select the products you wish to install.
You will be asked to specify the directory where you wish to install the Petroleum Systems Suite. Once again, this should be a directory on a shared drive on the server. The license management files will be installed in a praflex subdirectory under the directory you choose. So if you use F:\PRA, your license management files will be installed under F:\PRA\praflex.
You will also be asked to select a program folder under Start | Programs, in which to store shortcuts for the Petroleum Systems Suite. The default folder name is "Platte River Associates, Inc."

note: We will refer to the "Platte River Associates, Inc." folder throughout this document. If you change this default folder name, please note what you have changed it to.

Note: You may not need a new license file for this release

If you have an existing PRA license file issued after January 1, 2002, you may not need a new license file for this release. Before continuing with the Novell Network License Generation, read License File Eligibility Dates to see if your existing license file is sufficient.

Novell Network License Generation

Once you have completed the Petroleum Systems Suite setup, you should have a shortcut called "Novell Ntwk License Generation Utility" in the Start | Programs | Platte River Associates, Inc. menu. Run this utility to begin the license generation process.
The Novell Ntwk License Generation Utility will ask which communication protocol you are using. Choose the appropriate one.
Before continuing with license generation, PRA requires information from your server to provide you with a password report file necessary for licensing.
The Novell Ntwk License Generation Utility will explain what information is needed, and how to find it. Once you have found the information, you may exit the license generation utility until you have received the password report file from PRA.

If you are using TCP/IP as your communication protocol, PRA requires:
- the lmhostid of the server
- the name of the server
See Finding the lmhostid and server name below.

If you are using IPX/SPX, in addition to the lmhostid and name, PRA requires:
- the server node address
- the server network number
See Finding the server node and network number below.

You may contact PRA with the appropriate server information via
email: keys@platte.com
or you may phone or fax us:
Phone: (303)-448-0480 USA
Fax: (303)-448-0434 USA

Finding the lmhostid and server name
- The lmhostid:
  The lmhostid is based on the Ethernet address of the first network interface card on the server machine.
  The Ethernet address will be reported as the 'Node Address' when CONFIG is typed on the console of the Netware server.
- The server hostname: Look for 'File Server Name' in the output of the CONFIG command.
Finding the server node and network number
You will need to know the server node and network number in addition to the lmhostid and server name if you are running an IPX/SPX network.
- The node address is NOT the same Node Address that appears in the output of the server's CONFIG. This value, along with the network number, can be found by running the dserver.nlm utility found in the \PRA\praflex\utility directory.
  Alternately, this value may be determined by running \system\netadmin.exe from a Netware client.
  Please note that the Node Address is 000000000001 in many cases.
- The network number can also be determined by running the dserver.nlm utility or by running \system\netadmin.exe from a Netware client.
  Alternately, this value may be seen as 'IPX internal network number' in the CONFIG output on the server console.

Once you have submitted your server information and received your password report file from PRA, you may continue with license generation.

Restart the Novell Ntwk License Generation Utility found in Start | Programs | Platte River Associates, Inc.

The Novell Ntwk License Generation Utility will again ask which communication protocol you are using. Choose the appropriate one.

Press "Continue" to start generating a valid license file.

Contact Information
If you already have your password report file, press "Continue".

PRA products path
The license manager must know where the PRA products (license manager) are installed.
If you have chosen the default directory in installation step 4, it will report it as:
F:\PRA
Press "Continue".

License file generation method
In the License file generation method dialog, make sure "Use password report file" is selected, and press "Continue".

Password report file selection
In the Password report file selection dialog, specify the location of the password report file provided to you by PRA and press "Continue".

License File Template
This dialog will display the information in your password report file.
You should not have to modify any information in this dialog.
If the information looks correct, press "continue".

License file created
The following license files will have been created:
F:\PRA\praflex\licenses\license.dat - server license
F:\PRA\praflex\licenses\client.lic - client license

note: Installations of the Petroleum Systems Suite on other clients or servers must have a copy of the client.lic. Under the Petroleum Systems Suite \PRA\praflex directory, there will need to be a \licenses subdirectory created. The client.lic should be copied to the \PRA\praflex\licenses directory.

Also, if the Petroleum Systems Suite is installed in a different location than the license management files on a server, the client.lic must be copied to the \PRA\praflex\licenses directory where the Petroleum Systems Suite is installed.

Press "Exit" to finish the license generation process.
Once the Novell Ntwk License Generation Utility has created your license.dat file, you will need to start the licensing "daemon" that will monitor the PRA product licenses.

At the server console, type the following line:

LOAD SYS:\PRA\PRAFLEX\BIN\praflmd.nlm -c SYS:\PRA\PRAFLEX\LICENSES\license.dat

If you encounter problems loading the module, load the tcpip.nlm module.
- With Novell Server licensing, you are required to load the license manager on the server before execution of PRA products will be allowed on any client. See the section below on automatically loading the praflmd.nlm module.
- If you have not started the license manager on the server, you will get an error message like the following:

PRA FLEXlm Communication Protocol Details

Communication protocol may be either IPX/SPX or TCP/IP.

To use TCP/IP, the server name, the lmhostid (Ethernet address), and a TCP port address are required in the SERVER line of the license file.

See Finding the lmhostid and server name above.

A typical TCP/IP SERVER line is:
SERVER truk 00a0240369d7 7507
- 7507 is the TCP/IP port address to be used
To use IPX/SPX, in addition to the server name and lmhostid, an IPX socket number, the node address, and the network number are required in the SERVER line of the license file. If you have not reported the node address and network number to PRA, you will need to edit this information during license generation.

See Finding the server node and network number above.

The IPX socket number is an unused decimal socket number on the server; 7507 should work (7507 is the PRA default TCP port address for TCP/IP communication). If there is a conflict, a different number must be selected. 7507 can be replaced in the license.dat and client.lic with a different number.
A typical IPX/SPX SERVER line is:
SERVER truk 00a0240369d7 SPX:7507@000000000001#00000001

SERVER is the keyword for the license file
truk is the hostname for the server
00a0240369d7 is the lmhostid (Ethernet address) of the server
SPX:IPX socket number@node address#network number

Auto-Loading the PRA FLEXlm module

The license manager NLM may be entered in the AUTOEXEC.NCF file to auto-load during the Netware server boot-time. Be sure the TCPIP module is also loaded at boot-time.

To edit the AUTOEXEC.NCF, type 'load install' on the command line of the server.
Select 'System Options'.
Then select 'Edit Autoexec.ncf file'.

Assuming the license manager files were installed in SYS:\PRA, these load lines should be added to the AUTOEXEC.NCF:

LOAD TCPIP LOAD SYS:\PRA\PRAFLEX\BIN\praflmd.nlm -c SYS:\PRA\PRAFLEX\LICENSES\license.dat

praflmd.nlm is the license manager loadable module.
-c SYS:\PRA\PRAFLEX\LICENSES\license.dat indicates a specific path to the correct license file

The license manager log information is sent to the system console.

PRA FLEXlm Details for the Server

Whenever possible, PRA recommends that the PRA license management files be installed in the same base directory as other PRA products. If the PRA products are installed on the server in SYS:\PRA, the license management files should be installed in SYS:\PRA\praflex.

Assuming this setup, the following subdirectories and files will be associated with the license management files:

SYS:\PRA\bin
The directory where PRA product executables are installed.

SYS:\PRA\praflex
The base directory for PRA license management files.

SYS:\PRA\praflex\bin
The directory for license management utilities and the vendor daemon.
Includes some or all of the following files:

lmgrnnna.dll -- The current standard version or the FLEXlm license manager DLL
netwutil.exe -- The license file generation utility for Novell Netware networks
praflexdate.exe -- PRA utility to detect the eligibility and expiration date(s) in a license file, to determine whether it is valid for a new release
praflmd.nlm -- Platte River Associates, Inc. Novell Netware loadable module is not run with lmgrd.

SYS:\PRA\praflex\licenses The standard location for license files. PRA products and the PRA licensing daemon will look in this location for license files.

license.dat -- The licensing daemon will look for this file by default.
client.lic -- An alternative to license.dat that PRA products may use to connect to the licensing daemon. The name has been changed to allow us to differentiate between a license file that is on the server, and one that exists on a client installation. In reality, PRA products look for either of these files when they are run, client.lic first followed by license.dat.

If license management files are NOT installed in the same base directory as other PRA products, or if they are installed on a separate server, the directory where the PRA products are installed will need a praflex\licenses subdirectory as well. This subdirectory will need a full copy of the license file, named client.lic, in order for the products to run.

PRA FLEXlm Details for the Client

If PRA products are installed on client machines, each Netware client with a PRA product installation must have a copy of client.lic.

This file can be found on the server in which FLEXlm was installed under:
\PRA\praflex\licenses

On the client, the client.lic should be copied to: C:\Program Files\PRA\praflex\licenses
If a \licenses directory does not exist, it will need to be created.

If PRA products are installed on a client machine, and that machine does not have a copy of the full license file, Windows will attempt to create a client.lic file when a PRA product is launched. This is a Windows network-only feature, and will not work with Novell networks. Although you will be prompted for a server name and port, the Novell communication protocol does not allow the use of port@host syntax.

If PRA products are installed on the server, client machines should not need any additional files in order to access and run the PRA products.