Floating License Server on Linux/Solaris
These instructions are for network or system administrators who install license files on network license servers. Before the license is available to individual users, the administrator must set up a UNIX workstation as the license server.
Note: For redundant server configuration, all the servers must be running to ensure that they communicate with one another. The majority of servers listed in the license file must be running before you can set up the network license server.
Setting Up the License Server
To set up a network license server on Linux/Solaris, complete the following steps.
- Make a backup copy of any existing license.dat file for future reference.
- Get the port number and host name. This information can also be found in the license file line beginning with the word SERVER. For example,
SERVER <hostname> <8 or 12 character host or NIC ID> <port>. For example,
SERVER myserver 00B0D0ABEAEC 1800
The license location for the user is <port>@<hostname>. For example,
1800@myserver
If a port is not listed in the license.dat file, specify @<hostname>.
- Modify the license.dat file before using it on the license server. The following example shows the first few lines of the license file (your license file may not contain all the VENDOR entries, depending on which software is enabled):
SERVER <hostname> <8 or 12 character host or NIC ID> <port>
VENDOR alterad "<path to daemon executable>"
VENDOR mgcld "<path to daemon executable>"
VENDOR armlmd "<path to daemon executable>"
- Modify the entries in the license.dat file by changing the variables described in Table 1. The host or NIC ID is already entered in the license file.
| Table 1. Modifying the License File |
| Variable Name |
Description |
| <hostname> |
The hostname of the server (for example, my_server). |
| <port> |
The port number for the license manager service on the server, (for example, 1800). The port number is recommended and should be different from the port number for any other service on the machine. |
| alterad “<path to daemon executable>” |
Path to the Altera® vendor daemon executable alterad. |
PC |
<MAX+PLUS II install>\alterad.exe or <Quartus II install>\win\altera.exe for Quartus® II versions 6.0 and earlier.
<Quartus II install>\bin\alterad.exe for Quartus II versions 6.1 and later.
|
| Solaris |
<MAX+PLUS II install>/adm/alterad or <Quartus II install>/solaris/alterad |
| HP-UX 10.2 |
<MAX+PLUS II install>/adm/alterad |
| HP-UX 11.0 |
<MAX+PLUS II install>/adm/alterad |
| Linux |
<Quartus II install>/linux/alterad |
| mgcld “<path to daemon executable>” |
Path to the Mentor Graphics® vendor daemon executable mgcld. |
PC |
<ModelSim-Altera install>\win32aloem\mgcld.exe |
| Solaris |
<ModelSim-Altera install>/sunos5aloem/mgls/lib/mgcld |
| HP-UX |
<ModelSim-Altera install>/hp700aloem/mgls/lib/mgcld |
| Linux |
<ModelSim-Altera install>/linuxaloem/mgls/lib/mgcld |
Note: Quartus II software versions later than 5.0 no longer support the HP-UX operating system. Please refer to Operating System Support for updated operating system support.
Once the modifications are complete, save the license file with a .dat extension (for example, license.dat). The license email from Altera includes the recommended default directory location. Then do the following:
-
Ensure that the text editor does not append .txt or other extension to the filename, such as license.dat.txt. If in doubt, verify the filename at a command prompt.
-
Ensure that there is a carriage return (new line) at the end of the last FEATURE line.
-
Ensure that any FEATURE line that wraps to a second or third line contains a backslash (\) at the end to indicate that it continues.
- Create a directory on the license server to contain the FLEXlm files. If it is a Windows license server, Altera recommends that you create a c:\flexlm directory for the files. Some daemons for floating licenses may not run unless the c:\flexlm directory exists.
Note: The files required for the FLEXlm license manager are installed with the Quartus II and MAX+PLUS® II software. On Windows, the FLEXlm files are in the <Quartus II installation directory>\bin directory or the <MAX+PLUS II installation directory>\adm directory. On UNIX and Linux, the FLEXlm files are in the <Quartus II installation directory>/<solaris | linux> or <MAX+PLUS II installation path>/adm directory.
If the Quartus II or MAX+PLUS II software is already installed on the license server, go to step 9. To install the FLEXlm software separately on the license server machine, continue with step 4.
- Copy the following files from the appropriate directory listed in step 4 into the new directory:
- Type the following at a command prompt to start the license server:
<FLEXlm location>/lmgrd -c <license location>/license.dat [-l <log file name>]
Note: Altera recommends that you specify a log file when you run a floating license server. If you experience errors with the license server, a log file makes it easier to debug the problem.
- Type the following at a command prompt to verify the license server is running:
lmutil lmstat -a -c <port>@<hostname>
Where, <port> is the license port number and <hostname> is the server’s host name as defined in Table 1.
- If you receive an error message, review the previous steps to ensure that everything is correct.
- After you set up the license manager server, specify the license for each client or user.
FLEXlm License Manager Software
For complete information about using the FLEXlm utilities to administer the FLEXlm License Manager software, refer to the FLEXlm End User's Guide.
Type lmgrd -help at a command prompt to see a list and description of the available FLEXlm options.
To copy the new Altera license to an existing FLEXlm license server, refer to the Configuring an Existing UNIX Workstation License Server section of the Quartus II Software Installation & Licensing for UNIX & Linux Workstations Manual (PDF).
The FLEXlm software works with Internet firewalls that require port numbers to be specified. You must specify a port number on the SERVER line in the license file. You must also specify different port numbers on each VENDOR or DAEMON line with the PORT=<number> syntax. Finally, you must allow firewall access to those port numbers. The following example shows how to specify port numbers in a floating license file. To provide access through a firewall for this example, specify ports 1800, 1801, and 1802.
SERVER my_server 00B0D0ABCCBA 1800
VENDOR alterad D:\quartus\bin\alterad.exe PORT=1801
VENDOR mgcld D:\modelsim\win32aloem\mgcld.exe PORT=1802
Altera software uses the FLEXlm software to administer licensing for single or multiple users in a network installation. Follow the directions below to modify the license file and then set up and start the FLEXlm License Manager.
Related Links
|
Literature
> 
