Configuring a UNIX or Windows Network License Server

Note: STK utilizes FLEXlm licensing. For more information on license management strategies, refer to the FLEXlm End Users Guide.

A network license server is an area on a network where you can house and manage STK licenses for multiple users. You can configure any machine on your network to act as the network license server, provided the directory path to licenses on the server machine is shared, and that all of the clients that will be accessing licenses from the server can see it.

It is recommended that you have just one network license server, and that each instance of STK be configured to request all licenses from that server. You may not be able to access some licenses if one client is attempting to get licenses from multiple network license servers. For example, if you are pointing to one server for your STK license, and you try to point to a different server for your STK Astrogator license, one of the licenses may not be fully functional.

Note: A network fileserver is a good choice for a network license server installation, although any machine usually available on the network is acceptable.

If you purchased a UNIX or Windows network license server for STK, your system administrator needs to perform the following tasks:

  1. Install the network license server software on the server.
  2. Obtain and install server licenses and client licenses.
  3. Start the License Daemon.

Procedures for performing these tasks for Windows and UNIX license servers follow.

Installing a Windows Network License Server

To install the network license server software:

  1. Insert the DVD into the DVD drive.
  2. Browse to <DVD drive>:\STK_License_Server\<version>\Windows\ and click setup.exe.
  3. Continue to the License Agreement window, where you will need to read the Software Licensing Agreement. Accept the license agreement and click Next.
  4. At the Destination Folder window, specify the location where your license server files will be stored on the server. Click Next.
  5. Note: The installation process results in creation of a license folder to store your network license files. By default, the license folder is created in C:\Program Files (x86)\AGI\STK License Server\.

  6. At the Ready to Install the Program window, select Install.
  7. After the installation has finished, identify the STK License Server Host ID and IP address for the machine. Do this by running LMTools.exe in the STK License Server folder, selecting the System Settings tab. The value for Ethernet Address is the Host ID.
  8. When you finish, e-mail or telephone AGI with the Host ID and IP address of network license server machine to request server licenses. A Technical Support Engineer will provide you with license files generated for your License Server.

When you request server licenses, you will receive two license files—a server license and a client license. Save the server licenses in the licenses directory created during the network license server installation (in step 4). The client license will be used to direct individual workstations to the network license server to get their licenses.

After you have installed licenses on the network license server machine, you will need to start the License Daemon to enable the licenses.

Starting the License Daemon

You can configure the license server machine so that the license daemon starts automatically at boot by changing the services settings for the STK License Server on the machine that is acting as the network license server.

  1. Log on to the network license server machine.
  2. Run LMTools.exe located in the STK License Server folder and select the Config Services tab. You can change the default settings for the License file and\or the debug log file from the Config Services tab.
  3. To turn on the License Server service, select Use Service. If you want the service to always start when the computer is turned on, click Start Server at Power Up and press the Save Service button.

    Warnings:

    If you are using network licenses and you are prompted to register when you run STK after a client workstation install, either all of your network licenses are in use, or your workstation does not have access to licenses on the network license server.

    If STK starts up and cannot find the network license server, it will attempt to connect to the network license server multiple times. This process will be repeated for each STK license. This process may take a significant amount of time, and STK may appear to stop responding when actually it is searching for licenses.

  4. Open the Services window.
  5. Notes: Windows XP users will find Services inside of their Administrative Tools in the Control Panel.

    If you are running Windows XP, and working in Category View, Administrative Tools will be in the Performance & Maintenance category of your Control Panel.

  6. When the Services window appears, double-click STK License Server in the services list. This will open the Properties page for the STK License Server Service.
  7. On the General tab, change the Startup Type to Automatic, if it is not already.
  8. Click the Start button in the Services Status area.
  9. Click OK to dismiss the Properties page.
  10. Warnings: If you are using network licenses and you are prompted to register when you run STK after a client workstation install, either all of your network licenses are in use, or your workstation does not have access to licenses on the network license server.

    If STK starts up and cannot find the network license server it will attempt to connect to the network license server multiple times. This process will be repeated for each STK license. This process may take a significant amount of time, and STK may appear to stop responding when actually it is searching for licenses.

Installing a UNIX Network License Server

Note: This might require redhat-lsb or alternatively a symlink /ld-lsb.so3 through /lib/ld-linux.so.2.

To install a Network License Server on UNIX:

  1. Log in as root.
  2. Insert the DVD into your DVD drive.
  3. Mount the DVD drive.
  4. Change directories so that you are in the STK_License_Server/unix directory on the DVD (e.g., cd /cdrom/STK_License_Server/unix).
  5. At the user prompt, type ./install.Flexlm and press RETURN.
  6. Choose whether to also view these installation instructions on the UNIX machine by pressing Y or N.
  7. Note: The install instructions are in HTML format, and can be displayed on any platform on which an STK application runs. To properly view them you'll need a Browser that is Java-capable and can support frames. Although this requires a HTML Browser such as Firefox 4.x or Internet Explorer 4.x, it does not require that the computer have access to the Internet. The Browser is used in this case to display HTML files and not to connect to the internet.

  8. At the prompt, enter the directory path of the machine that will act as the License Server.
  9. Warning: If you are installing the License Server on a machine other than the one that will actually act as the server, you will need to copy the License Server files from the <InstallDir>/NetworkDaemon directory onto the hard drive of the machine that will act as the License Server.

  10. At the prompt, choose the operating system for the machine on which you are performing the installation.
  11. Note: This is not necessarily the same operating system on which your STK Application will be running.

  12. Allow the installation to continue. The on-screen instructions will guide you through the rest of the installation process.

Obtaining and Installing Licenses

  1. After the installation has finished, identify the Host ID and IP address for the machine that will act as the Network License Server. From the UNIX directory on the DVD, enter hostid.sh to return the host ID of the machine from which this command was entered.
  2. E-mail, FAX or telephone AGI support with the Host ID and IP address of the machine that will act as the Network License Server to request server licenses.
  3. When you request server licenses, you will receive two license files--a server license and a client license.

    Save the server license in the STK License Server directory created during the Network License Server installation: <install directory>/NetworkDaemon/Flexllm/V9.2/<operating system>/licenses. The client license will be used to direct individual workstations (clients) to the Network License Server to get their licenses.
  4. Start the License Daemon to enable the new licenses.

Starting the License Daemon Manually

If you do not want the license daemon to run automatically, use the following steps to start it manually.

  1. Log onto the License Server machine.
  2. Change directories to the directory where you installed the Network Daemon files and type: ./lmgrd -c <LicenseDir>

For more information about License Daemon options for various UNIX platforms, consult the FLEXlm End Users Manual.

Starting the License Daemon Automatically

To configure the system so that the license daemon starts automatically at boot, place the following command in the appropriate file:

<PathToDaemon>/lmgrd -c <LicenseDirectory>

Check the table following for instructions on automating this process on various platforms.

Platform Instructions
SGI IRIX/
Sun Solaris
CD to the init.d directory and type ls to list the files contained in this directory. Create a file beginning with Sxxx (scripts are run in numerical order, so xxx should be one of the last files run). Place the command in that file. You may need to enter additional commands or structure the file accordingly (check other S files to see the format used on your system). Now create a symbolic link to the newly created file in the /sbin/rc2.d directory.
Linux Create a file called /etc/rc.d/init.d/lmgrd. The contents of the file should read:

#!/bin/sh
./etc/rc.d/init.d/functions

case "$1" in

start)

echo -n "Starting lmgrd license daemon: "
<PathToDaemon> /lmgrd -c <PathToLicenseFile>

stop)

echo -n "Stopping lmgrd license daemon"
<PathToExecutable>/lmdown -c
<PathToLicenseFile>

*)

echo "Usage: lmgrd {start|stop}"
exit 1

esac
exit 0


Be sure lmgrd, lmdown and the full path of your license file is in this script. Make this script world executable using the following command:

chmod 0755 /etc/rc.d/init.d/lmgrd

CD to the /etc/rc.d/rc3.d directory and type ls -al to see the files in that directory.

Create a link to ../init.d/lmgrd by typing the following:

ln -s ../init.d/lmgrd Sxxxlmgrd

where xxx is the number you have chosen. You may need to enter additional commands or structure the file accordingly (check other S files to see the format used on your system).

If you use your RHLinux workstation in X mode all of the time (i.e., your login screen is graphical) be sure to make the previous symlink in /etc/rc.d/rc5.d as well. Change runlevels, or reboot to have the license daemon start at boot.

STK Engine for UNIX 11.2