Using a Floating License

A floating license allows any machine on the LAN to use the library, but only a limited number at the same time. A license manager daemon must be started before a JMSL Numerical Library application can be run.

The following platforms are supported as servers.

key Description

i386nt Windows (x86,x64)

linux Linux (x86)

hps700 HP-UX 11.0 PA-RISC 1.1

rs6000 RS/6000 AIX p-Series

solaris Sun Solaris Sparc

axposf HP Alpha UNIX

IRIX64 SGI IRIX64 (mips)

linx64 Linux Itanium

lopt64 Linux Opteron

The license daemon server does not have to run on the same system, or even the same type of system, as the JMSL Numerical Library application.

1. Send the ID of the License Server System

Execute the commands:

cd install/jmsl4.0 (Unix)
java -jar setup.jar -hostid > hostid.txt

cd install\jmsl4.0 (Windows)
java -jar setup.jar -hostid > hostid.txt

where install is the directory in which the JMSL Numerical Library has been installed.

The output of these commands is a file hostid.txt. Please return this form to the Visual Numerics office nearest you, Attn: License Manager Administrator

Completed forms can also be mailed to:

Visual Numerics, Inc.
Attn: License Manager Administrator
2500 Wilcrest Drive, Suite 200
Houston, Texas, 77042
U.S.A.

2. Create the License File

Cut and paste the contents of the e-mail from the Visual Numerics License Administrator to the file

install/license/license.dat (Unix)

install\license\license.dat (Windows)

where install is the directory in which the JMSL Numerical Library has been installed.

The license file will be similar to:

SERVER myserver 00b14842a2fe VENDOR VNI FEATURE JMSL VNI 4.0 30-apr-2006 2 ABCDEF012345

3. Configure the License Daemon

On Windows, the license daemon can be run as either a Windows service or at the command line. If it is run as a service, it automatically starts when the system is booted. Configuring a service requires Administrator privileges.
Configure the license manager as a Windows Service.
On both Unix and Windows, the license manager can be administered using setup.jar.
- Windows
  cd install\jmsl4.0 java -jar setup.jar
On both Unix and Windows, lmgrd can also be started from the command line.
- Unix - Start lmgrd by a user other than root, since processes started by root can introduce security risks.
  cd install/license bin/lmgrd -c license.dat -L VNI.LOG
- Windows
  cd install\license bin\lmgrd -c license.dat -L VNI.LOG
Prepending VNI.LOG with the + character appends logging entries.

Advanced Usage

For more complicated situations, such as mixing FLEXlm licenses from several vendors, see the FLEXlm End Users Guide. The platform-dependent programs used by license manager are in install/license/bin/bin.key, where key is defined in the table at the top of this page.

4. Run the licensed client

If the license server is running on the local machine, then JMSL will find it.

If the license server is running a a different machine then is is necessary to set a system property as an argument to the Java program so that JMSL can find it. This is done as follows:

java -Dcom.imsl.license.path=@server MyMainClass

Here server is the name of the machine on which the license server is running. For example, if the license server is running on foo.nowhere.com then the argument to java command would be

java -Dcom.imsl.license.path=@foo.nowhere.com MyMainClass

The special license name @localhost can be used to refer to a license server on the same machine as the client, regardless of its actual name.

Alternatively, the value of the com.imsl.license.path system property can be set to the location of the license file. JMSL can then find the license server by using the information in the license file.

If the com.imsl.license.path system property is not specified then the client first looks for a license file called license.dat in its current directory and then tries to contact a license server running on the local machine. If no license can be found, the application throws an exception and terminates.

Advanced System Properties

The license manager in JMSL Numerical Library applications is controlled by the system properties.

Java system properties can be set on the command line using the -D option, as follows:

java -Dcom.imsl.license.path=mylicense.dat MyMainClass

System properties can be set within an application by using the System.setProperty method.

Property Value Meaning

com.imsl.license.path License file path A location in your installation hierarchy which indicates the expected license file location. This is a combination of one or more license file paths and [port]@host specifications. Multiple components of the list are separated by a semicolon (;) on Windows or colon (:) on UNIX. Redundant servers are not supported in Java. Default is license.dat:@localhost (Windows) or license.dat:@localhost (Unix).

com.imsl.license.queue true or false If true, automatically wait in the queue for a license without asking. Default is to ask the user.

com.imsl.license.popup true or false If true, use a dialog box to show any license manager errors or to ask the user about waiting for a license. If false, errors only result in this exception being thrown. The user is asked on the console about waiting for a license. Default is to use a popup dialog box.

Back

key	Description
i386nt	Windows (x86,x64)
linux	Linux (x86)
hps700	HP-UX 11.0 PA-RISC 1.1
rs6000	RS/6000 AIX p-Series
solaris	Sun Solaris Sparc
axposf	HP Alpha UNIX
IRIX64	SGI IRIX64 (mips)
linx64	Linux Itanium
lopt64	Linux Opteron

Property	Value	Meaning
`com.imsl.license.path`	License file path	A location in your installation hierarchy which indicates the expected license file location. This is a combination of one or more license file paths and `[port]@host` specifications. Multiple components of the list are separated by a semicolon (`;`) on Windows or colon (`:`) on UNIX. Redundant servers are not supported in Java. Default is `license.dat:@localhost` (Windows) or `license.dat:@localhost` (Unix).
`com.imsl.license.queue`	`true` or `false`	If `true`, automatically wait in the queue for a license without asking. Default is to ask the user.
`com.imsl.license.popup`	`true` or `false`	If `true`, use a dialog box to show any license manager errors or to ask the user about waiting for a license. If `false`, errors only result in this exception being thrown. The user is asked on the console about waiting for a license. Default is to use a popup dialog box.