Altera Software Licensing: Section
Altera Software Licensing: Section
Altera Software Licensing: Section
Introduction
This document describes options for licensing Altera® software and the steps required for
licensing: obtain a license file, set it up, and specify the license location. This document also
includes tips to troubleshoot licensing problems, provides answers to common questions
about licensing, and includes detailed information about Altera license file formats.
Section Page
Licensing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Information Required to Get a License File. . . . . . . . . . . . . . . 4
Get an Altera License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Set Up the License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Set Up the Network Licenses . . . . . . . . . . . . . . . . . . . . . . . . . 20
Set Up a License Manager Server for Windows . . . . . . . . . . 23
Set Up a License Manager Server for UNIX . . . . . . . . . . . . . 26
Quartus II Software Evaluation Period . . . . . . . . . . . . . . . . . 27
Tips for Resolving Licensing Problems . . . . . . . . . . . . . . . . . 27
Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
License File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
How to Change Your License Information . . . . . . . . . . . . . . 42
Licensing Options
Altera provides a number of licensing options to customers. A specific license is required for
each Altera software product.
1 Prior to the Quartus II software version 8.0, a FIXEDPC license tied to a software
guard (T-guard or dongle) was required.
Beginning with Quartus II software version 8.0, Altera issues a FIXEDPC license
that is tied to the NIC ID. Additionally, if you use the Quartus II software on more
than one computer, you can request one companion license for each FIXEDPC
license. To request a companion license, contact Altera Customer Service at
www.altera.com/corporate/contact/con-index.html.
1 If you are using a node-locked (FIXEDPC) version of the Quartus II software for the
first time, you must use your Quartus II software serial number to obtain a license file.
■ FLOATALL—a floating network license for users running the Quartus II software
on Microsoft Windows, Solaris, RedHat Linux, or SUSE Linux Enterprise
■ FLOATPC, a floating network license for users running the Quartus II software
on Microsoft Windows
■ FLOATNET, a floating network license for users running the Quartus II
software on Windows or Solaris
■ FLOATLNX, a floating network license for running the Quartus II software on
Windows or RedHat Linux
A new FLOATALL license is issued when you increase the number of seats for your
existing FLOATPC, FLOATNET, or FLOATLNX license.
Altera UNIX applications are supported for the Sun Microsystems Solaris operating
system for Quartus II software versions 8.0 and earlier. Altera Linux applications are
supported for the RedHat and SUSE Linux operating system.
When the Quartus II software is used, the license server for the FLOATALL,
FLOATNET, and FLOATLNX software subscription products does not have to be
running the same operating system as client computers.
1 Quartus II Web Edition and ModelSim-Altera Web Edition version 8.0 and earlier
require a license file.
The SOPC Builder software is automatically installed with the Quartus II software
and does not require a separate license. To access other components that are not
available in the default installation of the SOPC Builder software, install the
MegaCore® IP Library included with the Quartus II software installation.
Table 1 summarizes the software enabled by each of the license types described in this
section.
You can obtain or purchase Intellectual Property (IP) and Development Kit licenses
from the Altera IP MegaStore at www.altera.com/ipmegastore, or through your local
Altera sales office or distributor.
f For more information about the OpenCore and OpenCore Plus IP evaluation
programs, including licensing information, refer to AN 320: OpenCore Plus Evaluation
of Megafunctions and AN 343: OpenCore Evaluation of AMPP Megafunctions.
When you order a development kit, make sure that the network card ID provided
with the order is for the computer on which the development kit software is to be
installed. If you do not provide the correct network card ID, you cannot automatically
download your development kit software license from Altera’s website because your
network card ID is not in the licensing database. For instructions about how to
provide an updated network card ID for your license file, refer to “How to Change
Your License Information” on page 42.
Altera ID
Your Altera ID number is assigned by Altera when you purchase the software. This
six-digit number allows Altera to identify customers when they purchase an Altera
product or request technical support. For new Quartus II or MAX+PLUS II software
users, the Altera ID number is printed on the software’s shipping label, packing slip,
or can be downloaded from the Altera website at www.altera.com/mysupport. The
Altera ID number is also on some correspondence received from Altera.
If you are not the original purchaser of the license, register as a secondary user of the
software on the mySupport section of the Altera website at
www.altera.com/mysupport. If the Altera ID used for the license is unknown, use six
zeros (000000) to request a license file.
Software Guard ID
The software guard ID is a ten-character identification. Guards that connect to the
parallel port or USB port have an ID that begins with a “T” followed by nine numbers,
which are displayed when you install the software. You can obtain the software guard
ID using one of the following methods:
■ Read it from the printed label on the guard.
■ If the Quartus II software has been installed and the guard is attached, on the Tools
menu, click License Setup. Your Software Guard ID appears under Local System
info in the Software Guard ID field.
■ If the MAX+PLUS II software has been installed and the guard is attached, on the
Options menu, click License Setup (shown in Figure 1) and click System Info
(shown in Figure 2).
1 USB software guards are supported only for the Quartus II software versions prior to
version 8.0 on Windows Vista, Windows XP, and Windows 2000.
Host ID
The server host ID is an eight-character hexadecimal string that identifies the UNIX
workstation that serves Altera licenses.
Contact the server system or network administrator to obtain this ID, or use one of the
following methods to determine the server host ID:
■ Sun Solaris: Type hostid at the command prompt.
■ If the FLEXlm software has been installed, type lmutil lmhostid at the
command prompt to determine the ID.
1 You can use the FLEXlm licensing scheme to configure as many as three redundant
license servers. The first server specified is the master; use the master server’s NIC ID
or host ID when obtaining a license.
1 Quartus II software versions 5.0 and later do not support the HP-UX OS platform.
Quartus II software versions 8.0 and later do not support the Sun Solaris platform.
Refer to www.altera.com/support/software/os_support/oss-index.html for updated
operating system support.
NIC ID
The NIC ID is a 12-character hexadecimal string embedded in the network interface
card that Altera uses to uniquely identify the PC where the software is installed.
The NIC ID is required for network licenses when the license server machine is a PC.
It is also required for licenses issued for stand-alone PC software. Refer to Table 2 on
page 4 for more information.
Find the NIC ID using one of the following methods:
■ Windows: Type ipconfig /all r at a command prompt. The NIC ID is the
physical address without the dashes. If your PC has more than one network card,
you can use any of the cards’ NIC IDs as long as the selected network card is
always connected to the computer. Refer to Figure 3.
■ If the Quartus II software is installed, on the Tools menu, click License Setup. Your
Network Interface Card (NIC) ID appears under Local System info in the
Network Interface Card (NIC) ID field.
■ If the MAX+PLUS II software is installed, on the Options menu, click License
Setup, then click System Info. Refer to Figure 5.
1 Use the FLEXlm licensing scheme to configure as many as three redundant license
servers. The first server specified is the master; use the master server ’s NIC ID or host
ID when obtaining a license.
■ If the Quartus II software is installed, on the Tools menu, click License Setup. This
method ensures the correct hard-disk serial number is used if multiple hard drives
are in use. Your hard-disk serial number appears under Local Systems info in the
C: drive serial number field.
■ If the MAX+PLUS II software has been installed, on the Options menu, click
License Setup, then click System Info (Figure 8). This method ensures use of the
correct hard-disk serial number if multiple hard drives are in use.
1 If you have a floating license, you must manually request a license file from the
License Center on Altera’s website. Follow the instructions in “Manual License File
Request” on page 10.
1 For redundant license servers, you must manually request a license file. You can
contact Altera Customer Service at www.altera.com/corporate/contact/con-
index.html or you can file a service request using mySupport at
www.altera.com/mysupport.
1. When you start the Quartus II software, the License Setup Required dialog box
appears. Select Perform automatic web license retrieval. Refer to Figure 9.
3. Follow the instructions on the screen and enter the required information to receive
your license file by email. The required information varies for each license.
f Table 2 on page 4 describes the required information for various licenses. For more
information about gathering any required information, refer to “Information
Required to Get a License File” on page 4.
4. An email is sent to the address that you specified in the on-line form. Network
congestion can cause delays in email delivery. If you do not receive an email from
Altera within 12 hours of your license request, or if you do not know all the
required information to complete the process, file a service request using
mySupport at www.altera.com/mysupport.
5. When you receive the license, follow the steps described in “Set Up the License”.
c Do not delete any FEATURE or INCREMENT lines from the existing Altera license
file. Doing so results in a non-usable license file.
1 Ensure that the text editor does not append .txt (or any other extension) to the
filename, such as license.dat.txt.
6. Go to “Set Up the License” on page 11 for instructions about how to set up the
Altera license.
FIXEDPC License
To set up a FIXEDPC license, perform the following steps:
1. Make a backup copy of any existing license.dat file for reference.
2. Save the new license.dat file on your computer’s hard drive. Altera recommends
saving and using the license.dat file attached to the email. If you cannot receive
email attachments, the email includes instructions about how to create a
license.dat file.
3. If you are using the Quartus II software version 8.0 or later, skip this step. If you
are using the Quartus II software version 7.2 or earlier, attach the software guard
to a parallel or USB port on the PC.
The Sentinel driver for software guard-based licensing is installed automatically
with the Quartus II and MAX+PLUS II software. PCs running Windows Vista,
Windows XP, Windows NT, or Windows 2000 require that you install the Sentinel
driver.
1 Quartus II software versions 6.0 and later do not support the Windows NT
operating system. The Quartus II software versions 9.0 and later do not
support Windows 2000. Refer to the Operating System Support page on the
Altera website for updated operating system support.
Installing the Sentinel driver requires administrator privileges. If you are not
logged on as an administrator, or if you do not have administrator privileges when
the Quartus II or MAX+PLUS II software is installed, you must manually install
the Sentinel drivers after you are logged into the PC as an administrator or granted
similar permissions. At the command prompt, type the appropriate command:
■ For Quartus II software:
<Quartus II installation path>\drivers\sentinel\setup r
■ For MAX PLUS II software:
<MAX+PLUS II installation path>\drivers\setupx86 r
f For additional information about installing the Sentinel driver, refer to the
“Installing a Sentinel Software Guard” section in the Quartus II Installation
& Licensing for Windows and Linux Workstations manual.
Do not connect disk drives or any devices that use the parallel port, other than a
printer or Altera parallel port download cable, to either end of the software guard.
Disk drives can destroy a software guard by drawing more power than the guard
is capable of handling.
Disconnect the software guard before using the parallel port to transfer data
between computers using a data-transfer program. Failure to do so can cause
damage to the software guard.
4. Specify the license location. The license location is <path to license file>\license.dat,
where <path to license file> is the full directory path to the license file, starting with
the drive letter. For example, D:\flexlm\license.dat.
The license is now set up and you can begin using the software.
2. Save the new license.dat file on your computer’s hard drive. Altera recommends
saving and using the license.dat file attached to the email. If you cannot receive
email attachments, the email includes instructions about how to create a
license.dat file.
3. Specify the license location. The license location is <path to license file>\license.dat,
where <path to license file> is the full directory path to the license file, starting with
the drive letter. Figure 10 shows an example of specifying
C:\licenses\altera_license.dat as the license path and filename.
The license is now set up and you can begin using the software.
1 The license file specification in the Quartus II or MAX+PLUS II License Setup dialog
box takes precedence over the LM_LICENSE_FILE environment variable setting for
that particular software.
Windows NT
Quartus II software version 6.0 and later does not support the Windows NT operating
system. Refer to www.altera.com/support/software/os_support/oss-index.html for
updated operating system support.
To set the LM_LICENSE_FILE environment variable in the Windows NT system
control panel, perform the following steps:
1. On the Windows Start menu, click Settings, then click Control Panel.
2. Double-click the System icon in the Control Panel window.
3. Click the Environment tab in the System Properties dialog box.
4. Click the System Variable list to highlight it.
5. Type LM_LICENSE_FILE in the Variable box.
6. Type <path to license file>\license.dat or <port>@<hostname> in the Value box.
To specify more than one license location with the LM_LICENSE_FILE
environment variable, modify the existing LM_LICENSE_FILE environment
variable and separate the different paths with semicolons (;), as shown in the
following example:
c:\flexlm\license.dat;1800@myserver
7. Click Set, then click OK.
The license is now set up and you can begin using the software.
Windows 2000, Windows XP, or Windows Vista Classic Control Panel View
Quartus II software version 9.0 and later does not support Windows 2000. Refer to the
Operating System Support page on the Altera website for updated operating system
support. To set the LM_LICENSE_FILE environment variable through the
Windows 2000 system control panel, perform the following steps:
1. On the Windows Start menu, click Settings, then click Control Panel.
2. Double-click the System icon in the Control Panel window.
Windows Vista Only: If your computer is running Windows Vista, a dialog box
appears with a message prompting you to continue. Click OK.
3. Click the Advanced tab in the System Properties dialog box.
4. Click Environment Variables.
5. Click the System Variable list to highlight it.
6. If the license file LM_LICENSE_FILE exists, select it, then select Edit. If it does not
exist, select New and type the filename LM_LICENSE_FILE.
UNIX Workstation
The following is an example of the steps required for a C shell resource file (.cshrc).
Edit this file for each user. To set the LM_LICENSE_FILE environment variable in the
login initialization file, such as .cshrc, located in the home directory, perform the
following steps:
1. Type the following environment variable on a separate line in the login
initialization file to specify the license location:
setenv LM_LICENSE_FILE <port>@<hostname>
2. Save the .cshrc file.
3. Type the following commands at the command prompt:
cd r
source .cshrc r
To specify more than one license location with the LM_LICENSE_FILE
environment variable, modify the existing LM_LICENSE_FILE environment
variable and separate the different paths with colons (:), as shown in the following
example:
/usr/licenses/license.dat:1800@myserver
The license is now set up and you can begin using the software.
c Do not delete any FEATURE lines from the Quartus II license file. Doing so will result
in a non-usable license file.
4. Save the license file and check to ensure the following items are correct:
■ The text editor does not append .txt or other file extension to the filename, such
as license.dat.txt. If in doubt, verify the filename at a command prompt.
■ A carriage return (new line) is present 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 of each line to indicate that it continues.
■ Ensure that there is no backslash (\) at the end of the lines if the
VENDOR_STRING line wraps to multiple lines. This is different from the
FEATURE line. The backslash (\) should only be added outside of the line
where the double quotation marks (") are located. Refer to Example 1.
■ If you are using a 64-bit version of the Quartus II software, ensure that you
manually add a space between the closing double quote (") and backslash (\) at
the end of the VENDOR_STRING field.
5. Start the Quartus II software and on the Tools menu, click License Setup.
6. Confirm that the path to your Quartus II license file appears in the License file
box, as shown in Figure 11.
IP Core Functions
(FEATURE lines)
The license is now set up and you can begin using the software.
f If you have not installed and set up your license for the Quartus II software, follow
the instructions in the section “Set Up the License” on page 11, then return to this
section to add DSP Builder to your license file.
Perform the following steps to add a new DSP Builder license feature to an existing
Altera license file:
1. Open the license email you received from Altera.
The license email contains the FEATURE line required to license the DSP Builder.
For DSP Builder, the required FEATURE line begins with C4D5_512A.
c Do not delete any FEATURE lines from the Quartus II license file. Doing so
results in a non-usable license file.
4. When the modifications are complete, save the license file and check to ensure the
following are correct:
■ 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.
■ A carriage return (new line) is present 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 of each line to indicate that it continues.
The license is now set up and you can begin using the software.
Specify the License for Intellectual Property (IP) and Development Kits
If you have installed and set up your license for the Quartus II software, modify the
license.dat file to include licensing information for Intellectual Property and
Development Kits.
f If you have not installed and set up your license for the Quartus II software, follow
the instructions in “Set Up the License” on page 11, then return to this section to add
Intellectual Property and Development Kits to your license file.
Perform the following steps to add a new Intellectual Property and Development Kits
license feature to an existing Altera license file:
1. Open the license email you received from Altera. The license email contains the
FEATURE line required to license the Intellectual Property and Development Kit.
2. Open your Quartus II license.dat file in a text editor.
3. Copy the FEATURE line from the email content and paste the text into the existing
Altera license.dat file.
c Do not delete any FEATURE lines from the Quartus II license file. Doing so results in a
non-usable license file.
4. When the modifications are complete, save the license file and check to ensure the
following items are correct:
■ 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.
■ There is a carriage return (new line) at the end of the last FEATURE line.
■ Any FEATURE line that wraps to a second or third line contains a backslash (\)
at the end of each line to indicate that it continues.
■ Ensure that there is no backslash (\) at the end of the lines if the
VENDOR_STRING line wraps to multiple lines. This is different from the
FEATURE line. The backslash (\) should only be added outside of the line
where the double quotation marks (") are located. Refer to Example 1 on
page 17.
■ If you are using a 64-bit version of the Quartus II software, ensure that you
manually add a space between the closing double quote (") and backslash (\) at
the end of the VENDOR_STRING field.
The license is now set up and you can begin using the software.
1 Quartus II software version 5.0 and later does not support the HP-UX operating
system. For version 6.0 and later, the Quartus II software does not support the
Windows NT operating system. Quartus II software versions 8.0 and later do not
support Sun Solaris operating system. However, Altera supports Sun Solaris license
servers. Quartus II software version 9.0 and later does not support Windows 2000.
Refer to the Operating System Support page on the Altera website for updated
operating system support.
1 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.
6. Type the following at a command prompt to verify the license server is running:
lmutil lmstat -a -c <port>@<hostname> r
Where <port> is the license port number and <hostname> is the server ’s host name
as defined in the “Modifying the Network License File” on page 22. If you receive
an error message, review the previous steps to ensure that everything is correct.
7. After you have set up the license manager server, you must specify the license for
each client or user. Proceed to “Floating Network Licenses (FLOATALL,
FLOATPC, FLOATNET, FLOATLNX)” on page 13.
1 Type lmgrd -help at a command prompt to see a list and description of the
available FLEXlm options.
f To copy the new Altera license to an existing FLEXlm license server, refer to the
Quartus II Installation & Licensing for Windows and Linux Workstations manual available
at www.altera.com.
The FLEXlm software can work 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. Additionally, 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 in “Modifying the Network
License File” on page 22 to modify the license file and then set up and start the
FLEXlm License Manager.
2. When the modifications are complete, save the license file with a .dat extension
(for example, license.dat) and check to ensure the following items are correct:
■ 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.
■ You have obtained a valid license file as described in “Get an Altera License File”
on page 10.
■ If necessary, your license file has been modified according to the guidelines
described in “Modifying the Network License File” on page 22.
The following instructions assume that you have installed the license.dat file in the
<drive>:\flexlm directory. If you have installed the license file in a different directory,
substitute the appropriate path name for that directory.
To launch a new license server, type the following command at a command prompt:
<Quartus II installation path>\bin\lmgrd –c <license file path>\license.dat r
To configure a new license server as a Windows service, perform the following steps:
1. Type the following command at a command prompt:
lmtools r
2. In the LMTOOLS dialog box, click Configuration using Services.
3. Click the Config Services tab.
4. In the Service Name box, type Flexlm License Server.
5. In the path to the lmgrd.exe file box, type the location of the lmgrd file, typically:
<Quartus II installation path>\bin directory.
6. In the path to the license file box, type the location of the license.dat file, typically:
<drive>:\flexlm directory.
7. In the path to the debug log file box, type the location of your log file, typically:
<drive>:\flexlm\debug.log directory.
8. Click Save Service.
1 To see a list and description of the available FLEXlm options, type lmgrd -help r at
a command prompt.
1 To see a list and description of the available FLEXlm options, type lmgrd -help r at
a command prompt.
Automatically at Startup
When configuring the license server, you can set up the license server to start
automatically at startup with the LMTOOLS dialog box. Before you set up the license
server to start automatically at startup, you must configure a new license server as a
Windows service. Refer to “Configuring a New License Server” on page 23 for more
information.
To start the license server automatically at startup with the LMTOOLS dialog box,
perform the following steps:
1. Type the following command at a command prompt:
<Quartus II installation path>\bin\lmtools r
2. In the LMTOOLS dialog box, click Configuration using Services.
3. Select the name of the license server, typically Flexlm License Server.
4. Click the Config Services tab.
5. Turn on Use Services.
1 Quartus II software versions 8.0 and later do not support the Sun Solaris operating
system. However, Altera does support Sun Solaris license servers.
1 Quartus II software versions 8.0 and later do not support the Sun Solaris operating
system. However, Altera does support Sun Solaris license servers.
license.dat File
Refer to “License File Format” on page 37 for details about each entry in the
license.dat file. If you are experiencing problems with the license, verify that the
following conditions are true:
■ No features are expired.
■ Any FEATURE line that wraps over to a second or third line contains a backslash
(\) at the end of each line to indicate that the line continues.
■ The text editor has not appended .txt or other extension to the filename, such as
license.dat.txt. If in doubt, verify the filename at a command prompt.
Quartus II Software
■ If the license.dat file contains an error in the license server name, or if the path to
the license.dat file is incorrect, the Quartus II user interface might run more slowly
while the computer searches the network for the non-existent license. If this
problem occurs, edit the license file to correct the error or specify the correct
pathname for the license.dat file.
■ To instruct the Quartus II software check the Altera website for an updated license
file, on the Tools menu, click Options. In the License Setup page, click Web
License Update. If an updated license file exists, the Quartus II software
automatically downloads and installs the correct license.
1 The automatic update feature is only supported for FIXEDPC licenses and the
Quartus II Web Edition software.
f For further information about setting up Quartus II software licenses, refer to the
Quartus II Installation & Licensing for Windows and Linux Workstations manual.
MAX+PLUS II Software
■ If the license.dat file contains an error in the license server name, or if the path to
the license.dat file is incorrect, the computer might appear to freeze while it
searches the network for the non-existent license. If this problem occurs, use End
Task in the Windows Task Manager or the kill command in UNIX to close the
MAX+PLUS II software. Or, you can wait until the software opens, then edit the
license file to correct the error or specify the correct pathname for the license.dat
file.
■ You can also edit the LM_LICENSE_FILE variable for MAX+PLUS II software in
the maxplus2.ini file located in the MAX+PLUS II installation directory. This
variable is the same as that shown in the software’s GUI, but editing the
maxplus2.ini text file does not require that the MAX+PLUS II software be open.
This entry takes precedence over the LM_LICENSE_FILE environment variable.
With the MAX+PLUS II application closed, open the maxplus2.ini file in a text
editor and type or edit the following line:
LM_LICENSE_FILE=<path to file>\license.dat r
ModelSim-Altera Software
■ Specifying ModelSim-Altera Edition License Files and Servers
If you license the ModelSim-Altera Edition software with a floating license
running on a Windows license server, you might receive an error message that the
server cannot start mgcld because there might be another copy of mgcld running.
To resolve this problem, create a directory called c:\flexlm on the license server,
and place the license file in this directory.
The ModelSim-Altera Edition software requires that the LM_LICENSE_FILE
variable is set to the location of the license file. This software tool from Mentor
Graphics can also be affected by the MGLS_LICENSE_FILE environment variable.
For Mentor Graphics applications, including ModelSim-Altera Edition, the
locations of license files and servers can be specified in five places. If multiple
values are set, only the first one found is used. The following search order is used:
a. MGLS_LICENSE_FILE set in the environment
b. MGLS_LICENSE_FILE set in the registry
c. LM_LICENSE_FILE set in the environment
d. LM_LICENSE_FILE set in the registry
e. C:\flexlm\license.dat (FLEXlm default license file location)
If the Mentor Graphics license is installed on a PC, the MGLS_LICENSE_FILE
takes precedence over LM_LICENSE_FILE settings. If both are specified, you
should use LM_LICENSE_FILE to point to the ModelSim license server and only
use MGLS_LICENSE_FILE to point to the license server for other Mentor
Graphics applications. Also, if you use the MGLS_LICENSE_FILE variable, the
ModelSim license server and other Mentor Graphics applications license servers
should be on the same machine.
■ Specifying Licensed HDL
If you can open the ModelSim-Altera Edition software, but a licensing error occurs
when trying to load or compile a design, the OEM software tool (versions 6.1g and
earlier) can be licensed for either VHDL or Verilog HDL, but not both. The
Quartus II software issues an error message when trying to compile a Verilog
HDL design if the license file is enabled for VHDL support only or vice versa.
5. In one of the following forms, type in the location of the license file in the window
that appears (refer to “Quartus II Software Evaluation Period” on page 27):
<path to license file>\license.dat
or
<port>@<hostname>
6. Click Next, then click Finish.
7. Restart the PC.
1 The port that you specify for the license server must not be used by another
application. Otherwise, it will cause a contention for the same port on the
license server machine and you will receive a network license error.
f Refer to “Set Up the Network Licenses” on page 20 for information about enabling the
debug log.
1 Be careful when transferring these files between computers. If you are using FTP to
transfer the daemons from one computer to another, be sure to specify the “binary”
transfer mode.
The 2000.12 in the license file in Example 2 is the version information for the
MAX+PLUS II software. In this license file example, any version of the software
released up to and including December 2000 is enabled.
You can check the version of the Quartus II software by clicking About Quartus II on
the Help menu. In the bottom portion of the About Quartus II dialog box, you can
find the software version enclosed within parentheses.
You can check the version of the MAX+PLUS II software by clicking About
MAX+PLUS II on the Help menu. The top portion of the About MAX+PLUS II
dialog box contains the software version enclosed within parentheses.
Q: Can I enter a comment in an Altera license file (FLEXlm)?
A: Yes. Comments can be specified in Altera license.dat files using the # symbol
(Example 3).
Q: Why do I receive the message “The Serial Number you entered does not exist in
our databases” when I request a new license on the Altera website?
A: If you are using a new software guard ID (T-Guard) to request a new license, go to
the mySupport section of the Altera website, www.altera.com/mysupport, and
request a license as described in “Information Required to Get a License File” on
page 4.
Q: Why do I receive an email with the content message “The information you entered
is not in Altera’s database”?
A: If you recently purchased the Quartus II software and you are using an NIC ID to
request a license, go to the mySupport section of the Altera website,
www.altera.com/mysupport, and request a license as described in “Information
Required to Get a License File” on page 4.
Alternatively, you can use the Quartus II software serial number that you received to
request a license at the Altera website.
Q: I just upgraded to the latest version of the Quartus II software. Now my Altera
software says the license is not valid, but I know I have purchased an Altera software
subscription. What should I do?
A: If you want the Quartus II software to check the Altera website for license file
updates, on the Tools menu, click License Setup. In the License Setup page, click
Web License Update. If an updated license file exists, the Quartus II software
automatically downloads and installs the correct license.
1 The automatic update feature is supported only for FIXEDPC licenses and the
Quartus II Web Edition software.
Alternatively, go to the Altera website and request a new license file as described in
the instructions in “Information Required to Get a License File” on page 4. If your
license file expires and you renew your subscription, you must get a new license file
with the new expiration date.
Q: Can I use a Novell Netware server as the license server for the floating-node
version of the Quartus II or MAX+PLUS II software with Windows 98 or Windows
NT clients?
A: No. To run the floating-node license version of the Quartus II or MAX+PLUS II
software, the license server must reside on either a Windows Vista, Windows XP,
Windows NT, Windows 2000, UNIX, or Linux server using the TCP/IP protocol.
1 Quartus II software versions 3.0 and later do not support the Windows 98 operating
system. Quartus II software versions 6.0 and later do not support the Windows NT
operating system. The Quartus II software versions 9.0 and later do not support the
Windows 2000 operating system. Refer to the Operating System Support page on the
Altera website.
Q: Can I combine my Altera network license with other software tool licenses so that I
only require one license file?
A: Altera recommends using a separate license file for Altera software to avoid
possible problems and confusion. In a UNIX environment, you can start multiple
services for lmgrd using different port numbers. For PCs, use the FLEXlm control
panel and change the Service Name under the Setup tab to a different name for each
copy of lmgrd.exe.
You can combine the Altera license with other licenses if the other software tools are
using the same version of lmgrd. Always use the latest version of lmgrd, which is
typically the version shipped with the latest version of the Quartus II or
MAX+PLUS II software.
If the license server is on a UNIX system, use the lmver <filename> utility to check the
versions of lmgrd and alterad. The default file names are lmgrd.exe and alterad.exe.
If the license server is on a PC, the version of lmgrd is the same as the FLEXlm License
Manager version installed with the Quartus II or MAX+PLUS II software. To verify
the version of lmgrd, open the FLEXlm License Manager through the PC server
Control Panel window on the Start. The version information is under the About tab.
If you have an lmgrd version conflict between Altera software and another software
tool, you must use a separate Altera license.dat file.
Q: Why is my NIC ID reported as all zeros (000000000000) when using the Netbios
NET CONFIG command?
A: If the Quartus II software is not installed, you can use the ipconfig /all
command to obtain the physical address of the NIC. If you have installed the
Quartus II software, use the lmutil lmhostid command as described in “Information
Required to Get a License File” on page 4. If you are currently using the Netbios
protocol for a LAN rather than TCP/IP, this command returns 000000000000 as the
physical address of all NICs.
1 You must be running the TCP/IP protocol to use Altera floating licenses. This license
does not work with any other protocols, such as IPX or Netbios.
c Using the Registry Editor incorrectly can cause serious problems that might require
you to reinstall your operating system. Use the Registry Editor at your own risk.
1. Back up the registry before editing it. If the system is running Windows NT or
Windows 2000, also update the emergency repair disk (ERD).
1 The Quartus II software versions 6.0 and later do not support the Windows
NT operating system. The Quartus II software versions 3.0 and later do not
support the Windows 98 operating system. Quartus II software versions 9.0
and later do not support the Windows 2000 operating system. Refer to the
Operating System Support page on the Altera website.
2. Go to the command prompt or select Run from the Windows Start menu and then
type regedit r to open the Registry Editor.
3. Browse to HKEY_LOCAL_MACHINE\SYSTEM\
CurrentControlSet\Services\Tcpip\Parameters\.
4. Right-click the Parameters folder, select New, and then select the DWORD Value.
5. Set the Name field to DisableDHCPMediaSense.
6. Double-click the DisableDHCPMediaSense field (created in step 5) and set the
Value Data field to 1.
7. Close the Registry Editor.
Q: Why do I get an NIC or host id of FFFFFFFFFFFF when I use the FLEXlm utilities?
A: You might see a NIC or host id of FFFFFFFFFFFF when running the FLEXlm
utilities if the IPX/SPX driver is not loaded on your machine.
To install the IPX/SPX driver in systems running the Windows NT operating system,
perform the following steps:
1 The Quartus II software versions 6.0 and later do not support the Windows NT
operating system.
5. After the driver is installed, close all open dialog boxes and restart the computer.
Q: How can I check if the Quartus II software recognizes my software guard (T-
guard), NIC ID, or hard disk serial number?
A: On the Tools menu, click License Setup and look under System info for the
Network Interface Card (NIC) ID, C: drive serial number, and Software Guard ID.
The Quartus II software versions 8.0 and later do not support the software guard.
Q: Why does the Quartus II System info section indicate “Not found” for the
software guard ID?
A: The Quartus II software versions 8.0 and later do not support a software guard. If
you are using the Quartus II software version 7.2 and earlier, the Quartus II software
indicates “Not found” if there are communication problems with the parallel port.
Try rebooting your machine with the software guard attached to make sure that your
PC recognizes the software guard.
Q: What is the difference between FLOATALL, FLOATPC, FLOATNET and
FLOATLNX?
A: Currently, Altera offers only the FLOATALL floating network license, which
provides the license to all operating systems supported by Altera software.
Messages
This section describes actions to take when you receive errors that might be related to
licensing.
■ Error: “System clock has been set back” in the MAX+PLUS II
software.
You receive this error message if the vendor daemon has detected one or more
system files dated in the future compared to the system clock.
One possible solution is to locate the files that have an invalid date stamp and to
open each file and then save it so that it has the correct date/time stamp. The
vendor daemon primarily looks at system files in the following directories:
■ C:\ (The root directory)
■ The directory where your Microsoft Windows files are installed (for example,
C:\WINNT)
■ Your MAX+PLUS II software directory (for example, C:\MAXPLUS2)
One way to find the affected files is to use the Windows Find utility. Search by
date and specify files with a date later than today’s date. Some files might be
hidden, so make sure that the Find utility is configured to display all files.
If your MAX+PLUS II software was installed with an incorrect system clock, you
might have to perform the following steps:
a. Uninstall the MAX+PLUS II software.
b. Set the system clock to the current time and date.
c. Restart the PC.
d. Reinstall the MAX+PLUS II software in a different directory.
■ Message “Current license file support does not include
‘Graphic Editor’ application or feature in the MAX+PLUS II
Software”.
Because all Altera licenses include support of the graphic editor, this error means
that the MAX+PLUS II software cannot find your license file. Follow the directions
in “Licensing Options” on page 1 to obtain, set up, and specify your license.
1 Certain features use the term INCREMENT; these lines are structured in the same way
as FEATURE lines.
The backslash (\) character indicates that the FEATURE or INCREMENT line
continues on the next line in the text file. All lines that wrap to the next line should
end with the \ character. The last line of each FEATURE does not require the
backslash. The elements in brackets [] are present only in some license features or
increments. Example 4 shows a FEATURE line, followed by an INCREMENT line
Table 5 explains the different elements of the FEATURE and INCREMENT lines.
1 These examples should be used only for reference. They can be used only on the
specified system.
Conclusion
This document describes the techniques and procedures for obtaining and setting up
licenses for Altera-provided software. If you are unable to access the software after
reading this document, refer to the License Troubleshooter or visit the Altera
Licensing page for more information.
Referenced Documents
This application note references the following documents:
■ AN 320: OpenCore Plus Evaluation of Megafunctions
■ AN 343: OpenCore Evaluation of AMPP Megafunctions
■ MAX+PLUS II Getting Started manual
■ Quartus II Installation & Licensing for Windows and Linux Workstations manual
Copyright © 2008 Altera Corporation. All rights reserved. Altera, The Programmable Solutions Company, the stylized
Altera logo, specific device designations, and all other words and logos that are identified as trademarks and/or service
marks are, unless noted otherwise, the trademarks and service marks of Altera Corporation in the U.S. and other
countries. All other product or service names are the property of their respective holders. Altera products are protected
101 Innovation Drive under numerous U.S. and foreign patents and pending applications, maskwork rights, and copyrights. Altera warrants
San Jose, CA 95134 performance of its semiconductor products to current specifications in accordance with Altera's standard warranty,
www.altera.com but reserves the right to make changes to any products and services at any time without notice. Altera assumes no
Technical Support responsibility or liability arising out of the application or use of any information, product, or service
www.altera.com/support described herein except as expressly agreed to in writing by Altera Corporation. Altera customers are
advised to obtain the latest version of device specifications before relying on any published
information and before placing orders for products or services .