Floating License Instructions
Overview: Basically, you need to install the License Server, and send the almhostid of the machine to keys@scitools.com. We will send you back a license.dat file to install, and then you start the license server service/daemon.
Download Floating License Manager
Download the License Manager Build 528
www.scitools.com/download/licensemanager.php
The license server can be any Linux, Solaris, Mac OSX, or Windows 2000/XP/2003/2008/Vista/Windows7 system which is accessible from the client that will be running Understand software. You can mix and match operating systems, for example you can run a client on Windows and use a Linux system as the license server.
Each Understand installation kit contains the needed license manager software. So if you intend to also run Understand on the server (or if you don't mind a little extra stuff on the server) install the full kit.
If you don't want Understand on the server, then install the "License Manager" kit appropriate for the architecture of your server. This is convenient for instance if you want to run Understand on Windows machines, but host the license server on Solaris.
Remove previous version
All commands must be ran as an administrator.
If the license server still has the 'sti' directory (default for the old License Manager):
Linux Server
From a command line window on the server system
ps aux | grep almd
Find the process id (PID) number and kill the process:
kill -9 <pid>
Delete the 'sti' directory
Windows Server
The service needs to be stopped and removed. From a command line window on the server system run
"c:\Program Files\sti\bin\pc-win32\almdNTconfig.exe" -t to stop the service
"c:\Program Files\sti\bin\pc-win32\almdNTconfig.exe" -r to remove the service.
Delete the 'sti' directory
Install license server
Linux Server
To install, extract the kit in the location that you want it. The SciTools directory will be created automatically.
tar -xvzf LicenseManager-2.5.512-Linux-x86.tgz
NOTE: It is CRITICAL that the license kit be extracted in a manner that retains its original directory structure.
Once extracted the directory containing the tools can be moved around, but the entire structure must be moved.
Windows Server
Run the installer. Easy right?
Determine the almhost of the server and obtain license file
Find and run licenseserver. It is located in c:\Program Files\SciTools\bin\pc-win32\
Choose which option under AlmHostId works best for you:
- View Server AlmHostId(s) shows the results in the Server Status window in the left pane.
- Send AlmHostId to SciTools opens the mail client and populates it with the necessary information.
- Copy AlmHostId to Clipboard does just that-copies it to clipboard so you can paste it where you want.
However you choose to do it is fine, as long as the AlmHostId of the machine is emailed to keys@scitools.com.
Once we have this information we will send you a license.dat file for your system.
If the request is made during our working hours (8 - 5 MST), you should get the file back within one hour (usually much quicker).
Install the license file
On your server, place the license.dat file that we send back into the conf/license/ subdirectory.
In the License Server dialog, Browse to the location of the license.dat file. The file MUST be in the same location as the Licensing window shows.
Start the license server
Verify that UDP Port 9000 is open and Select "Start" in the upper right.
The Server Status should show that it is running.
This is your license server for Understand and must stay running.
If you have any problems or if you still receive the evaluation mode notice, contact support.
Linux and Mac Users
Linux
In order for the License Server to start after a reboot of the machine, you will need to add licenseserver to your Start Up. The instructions for this may vary for each Linux distribution.
Mac
A script can be used to start the License Server after a reboot of the machine.
Create a file called: com.scitools.almd.plist in /Library/LaunchDaemons with these contents:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.scitools.almd</string>
<key>ProgramArguments</key>
<array>
<string>/path/to/SciTools/bin/macosx/almd</string>
<string>-l</string>
<string>/path/to/license.dat</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
Replace /path/to/SciTools/bin/macosx/almd and /path/to/license.dat with the actual paths to where the daemon and license.dat are installed. Now the daemon should start at boot.
Test with a client app (optional)
As long as the license server is running, you will be able to run Understand from another client. When Understand prompts for a server name, either the IP address, or the name of the server that the License Manager is running on will work.
If you want to check on the license server status from a client machine, run almstatus from the command line. It will show how many licenses are available and who has licenses checked out.
Command Line Instructions (optional)
If you prefer to use the command line rather than the GUI, these commands are for you.
Linux
Run almhostid to determine the almhost of the server and email it to keys@scitools.com.
Make sure UDP Port 9000 is open and run almd to start the license server daemon, and specify the location of the license file with the -l option.
almd -l /sti/conf/license/license.dat
To see other options use almd -h
Windows
Run almhostid.exe to determine the almhost of the server and email it to keys@scitools.com
Make sure UDP Port 9000 is open and run almdNTconfig with the -c option to install and start the license manager as a Windows service. Use
the -l option to specify the location of the license file.
almdNTconfig -c -l "c:\program files\SciTools\conf\license\license.dat"
To see other options use almdNTconfig -h
