an205.fm Page 1 Friday, November 22, 2002 12:45 PM
Understanding Altera
Software Licensing
December 2002, ver. 1.1
Introduction
Application Note 205
Altera provides synthesis, place-and-route, and simulation design
environments for today’s complex designs. To use software provided by
Altera, you need to obtain and set up an AlteraR software license.
This document outlines options for licensing Altera software and
describes how to obtain and set up the necessary license(s) for Altera
design software by following these basic steps:
1.
Obtain an Altera license file at http://www.altera.com.
2.
Set up the license on a stand-alone PC or a network license server
(PC or UNIX).
3.
Specify the license file location.
1
Licensing
Options
For an explanation of the text in the license file, troubleshooting
tips, and common software licensing questions and answers, see
AN 229: Advanced Troubleshooting for Altera Software Licensing.
Altera provides a number of licensing options for its customers. The type
of license determines which Altera software is enabled.
An Altera software subscription enables the following software:
■
■
■
■
■
■
Altera QuartusR II software
Altera SOPC Builder software
Altera MAX+PLUSR II software
LeonardoSpectrumTM-Altera software
ModelSimR-Altera software
ARMR Development Suite (ADS) software
Altera offers the following types of software subscriptions:
■
■
■
Altera Corporation
AN 205-1.1
FIXEDPC, a stand-alone PC license tied to a software guard (T-guard
or “dongle”)
FLOATPC, a floating network license for PC users with either a PC or
UNIX license server
FLOATNET, a floating network license for PC and/or UNIX users
using either a PC or UNIX license server
1
an205.fm Page 2 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
■
FLOATLNX, a floating network license for PC and Red Hat Linux
users using either a PC, UNIX, or Linux license server
1
Altera UNIX appliations are supported for the Sun
Microsystems Solaris and Hewlett-Packard HP-UX UNIX
operating systems.
Customers who purchase selected development kits receive a free version
of the Quartus II software for the PC and are given instructions on how to
obtain a license for the software.
For PCs, Altera also offers free entry-level software available at
http://www.altera.com. After downloading and licensing one of the
following entry-level versions of the Quartus II or MAX+PLUS II
software, you can also choose to download and license the
LeonardoSpectrum-Altera software for either VHDL or Verilog HDL
synthesis support:
■
■
Quartus II Web Edition software: a downloadable version of the
Quartus II design software that supports selected devices
MAX+PLUS II BASELINE software: Altera design software that
supports certain low-density devices
The Altera University Program offers participating schools access to
Altera software, licensed in one of the following ways:
■
■
f
2
Fixed (software guard) or floating (network) licenses for universities
and colleges that have applied to become members of the Altera
University Program. The licensing process for these University
Program licenses is the same as for regular Altera software
subscriptions.
MAX+PLUS II Student Edition: free PC software for students.
For more information on the University Program see the Altera web site
(http://www.altera.com).
Altera Corporation
an205.fm Page 3 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
Table 1 summarizes which software is enabled by each of the license types
described in this section.
Table 1. Supported Software for Each License Type
Quartus II
SOPC
Builder
Leonardo
SpectrumAltera (2)
ModelSimAltera (2)
MAX+PLUS II
FIXEDPC
License
v
v
v
v
v
FLOATPC
License
v
v
v
v
v
FLOATNET
License
v
v
v
v
v
FLOATLNX
v
v(5)
v(5)
v(5)
v(5)
v(5)
Quartus II
(1-year license)
(1)
v
—
—
—
—
—-
v
v
—
—
—
License Type
Quartus II
Web Edition
v
Web Edition
MAX+PLUS II
BASELINE
—
v(3)
—
MAX+PLUS II
Student Edition
—
—
—
v
BASELINE
ARM
Development
Suite (4)
v
v
v
(UNIX can be
purchased)
—
v
Student
Edition
—
Notes to Table 1:
(1)
(2)
(3)
(4)
(5)
Some Altera development kits include a license to use the Quartus II software. Development kit users are given
instructions on how to obtain a license for the software. After you obtain the license, the rest of the licensing process
is the same as the process for PC evaluation software outlined in “Licenses for Free Evaluation PC Software” on
page 7.
The LeonardoSpectrum-Altera and ModelSim-Altera tools are available for either VHDL or Verilog HDL synthesis
or simulation. Floating licenses may have their licenses split between VHDL and Verilog HDL in any ratio.
The LeonardoSpectrum-Altera software for PC is available to MAX+PLUS II BASELINE and E+MAX customers
who have their license tied to their network interface card, not their hard-disk serial number.
A 45-day evaluation of ADS software is included with Altera software subscriptions. Full licenses for ADS software
can be purchased seperately.
These licenses are available only for PC installations of these tools.
Altera Corporation
3
an205.fm Page 4 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
Obtain an
Altera License
File
To obtain an ASCII text license file, license.dat, use the following
procedure:
1.
Go to http://www.altera.com and click the Licensing icon.
2.
Choose the link for the appropriate license type. Table 1 describes
the software enabled by each license type.
3.
Follow the instructions to enter the required licensing information.
The requirements for an Altera license vary depending on the license
type. Table 2 describes the information needed to obtain each type of
license.
Table 2. Licensing Information Required for Each License Type
License Type
Note (1)
Licensing Method & Requirements
FIXEDPC License
Altera ID, software guard ID
FLOATPC, FLOATNET, or FLOATLNX
License
Altera ID, NIC ID for Windows NT, Windows 2000, or Red Hat Linux
7.1 license servers (2)
Altera ID, host ID for UNIX license server (2)
Quartus II Web Edition
MAX+PLUS II BASELINE
NIC ID
NIC ID
Hard-disk serial number (3), (4)
MAX+PLUS II Student Edition
Hard-disk serial number (4)
Notes to Table 2:
(1)
(2)
(3)
(4)
4
The licensing web pages on http://www.altera.com include definitions and instructions on how to obtain the Altera
ID, software guard ID, host ID, network interface card (NIC) ID, or hard-disk serial number. See AN 229: Advanced
Troubleshooting for Altera Software Licensing for detailed information.
The FLEXlm License Manager allows up to three redundant license servers to serve a network license. The first
server specified is the master; use the master’s NIC ID or Host ID when obtaining a license.
If the PC does not have a NIC ID, you can request a license for the MAX+PLUS II BASELINE and E+MAX software
that is tied to its hard-disk serial number. However, support for this type of license is being discontinued, and the
LeonardoSpectrum-Altera software cannot be licensed using a hard-disk serial number. Therefore, if the
MAX+PLUS II software is licensed using this serial number, Verilog HDL and VHDL code cannot be synthesized
with any Altera software.
If the PC has more than one hard disk, select the hard disk where the Windows operating system is installed. See
AN 229: Advanced Troubleshooting for Altera Software Licensing for more details.
Altera Corporation
an205.fm Page 5 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
A message indicates the license request has been processed and that
the license will be sent via e-mail.
An e-mail is sent to the address that you specified in the on-line
form. Network congestion can cause delays in e-mail delivery. If an
e-mail is not received from Altera within 12 hours of your license
request, or if you don’t know all the required information to
complete the process, contact Altera Applications.
4.
The e-mail from Altera has a license.dat file attached. Altera
recommends saving and using this attached license file. If you
cannot receive e-mail attachments, the e-mail includes instructions
on how to create a license.dat text file.
5.
Go to “Set Up the License” for instructions on how to set up the
Altera license.
ARM Development Suite (ADS) Licenses
The 45-day free and purchased ARM Development Suite licenses must be
requested separately from the FIXEDPC, FLOATPC, or FLOATNET
license file. However, the above license procedure applies to these licenses
as well. Choose the ADS licensing link from the licensing web page, and
specify the required information relating to your Altera software
subscription. You will receive an e-mail with a new license.dat file with
the ADS license features added.
1
Subscription customers that plan to use the LeonardoSpectrumAltera or ModelSim-Altera software should first request a
license using the FIXEDPC, FLOATPC, or FLOATNET
selections, and then request the ADS license. Use the new license
file that includes the ADS software features in place of your
original non-ADS software license file.
Intellectual Property (IP) and Development Kit Licenses
You can obtain or purchase licenses for IP megafunctions and
development kits from the Altera IP MegaStoreTM web site at the
following URL: http://www.altera.com/ipmegastore, or through your
local Altera sales office or distributor.
f
Altera Corporation
For more details on the OpenCoreR and OpenCore Plus IP evaluation
programs, including licensing information, see AN 125: Evaluating AMPP
& MegaCore Functions and AN 176: OpenCore Plus Hardware Evaluation of
MegaCore Functions.
5
an205.fm Page 6 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
When you request or purchase an Altera IP core or development kit that
requires a license, licensing information will be provided. Use the
following procedure to add a new license feature to an existing Altera
license file.
1.
Close any software programs provided by Altera.
2.
Open the new IP or development kit license file in a text editor. The
file should contain one or more lines starting with the keyword
FEATURE.
3.
Open the existing Altera license.dat file in a text editor.
4.
Copy the FEATURE line(s) from the IP or development kit license file
and paste the text into the existing Altera license.dat file. Do not
delete any FEATURE lines from the existing Altera license file.
5.
Save the Altera license.dat file.
1
6.
Set Up the
License
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 file name at a command prompt.
Go to “Set Up the License” for instructions on how to set up the
Altera license.
After obtaining an Altera license.dat file, follow the instructions in the
section corresponding to your license type.
FIXEDPC (Software Guard) Licenses
1.
Make a backup copy of any existing license.dat file, in case it is
needed later for reference.
2.
Save the new license.dat file on the PC’s hard drive. The e-mail from
Altera includes the recommended default directory location.
3.
Attach the software guard to a parallel port (LPT port) on the PC.
4.
Proceed to the “Specify the License File Location” section on
page 14.
The Sentinel driver for software guard-based licensing is installed
automatically with the Quartus II and MAX+PLUS II software. Windows
NT or Windows 2000 PCs that use a software guard require the Sentinel
driver. Windows 98 systems require the driver if the software guard is on
a parallel port other than LPT1.
6
Altera Corporation
an205.fm Page 7 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
1
Installing the Sentinel driver requires administrator privileges. If
you are not logged in as an administrator when the Quartus II or
MAX+PLUS II software is installed, you must manually install
the Sentinel drivers once you are logged into the PC as an
administrator. At the command prompt type
<Quartus II installation path>\drivers\setupx86.exe r or
<MAX+PLUS II installation path>\drivers\setupx86.exe r
to run the install program. You may also refer to the Quartus II
Installation & Licensing for PCs manual available on the Altera
web site.
1
Do not connect disk drives or any devices that use the parallel
port, other than a printer or the ByteBlasterMVTM 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.
1
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.
Licenses for Free Evaluation PC Software
1.
Make a backup copy of any existing license.dat file, in case it is
needed later for reference.
2.
Save the new license.dat file obtained from Altera on the hard drive.
The e-mail from Altera includes the recommended default directory
location.
3.
Proceed to the “Specify the License File Location” section on
page 14.
Floating Network Licenses
This section is intended for the network or system administrator who
installs the license file on the network license server. Before the license is
available to individual users, the administrator must set up a PC or UNIX
workstation as the license server.
For a floating network license, individual users should follow the
instructions in the “Specify the License File Location” section. If the
network license server has already been set up, proceed to that section.
Altera Corporation
7
an205.fm Page 8 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
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.
Modifying the Network License File
The license.dat file must be modified before it can be used by the license
server. See AN 229: Advanced Troubleshooting for Altera Software Licensing
for a detailed description of the license file. The first few lines of the license
file are shown in the following example (your license file may not contain
all the VENDOR entries, depending on which software you have 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>"
Use the following procedure to modify and save the license file:
1.
8
Modify the entries in the license.dat file by typing in the variables as
described in Table 3 (variables are enclosed in angle brackets). The
host or NIC ID will already be entered in the license file.
Altera Corporation
an205.fm Page 9 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
Table 3. Network license.dat File
Variable Name
Description
<hostname>
The hostname of the server, e.g., my_server.
<port >
The port number for the license manager service on the server, e.g., 1800. The port
number is optional and should be different from the port number for any other service on
the machine.
alterad “<path to
daemon
executable>”
(1), (2)
Path to the Altera
vendor daemon
executable alterad.
mgcld “<path to
daemon
executable>”
(1), (2), (4)
armlmd “<path to
daemon
executable>”
(1), (2), (5)
Path to the Mentor
GraphicsR vendor
daemon executable
mgcld.
PC
<MAX+PLUS II install>\alterad.exe
<Quartus II install>\bin\alterad.exe
Solaris
<MAX+PLUS II install>/adm/alterad (3)
<Quartus II install>/solaris/alterad
or
HP-UX
10.2
<MAX+PLUS II install>/adm/alterad (3)
<Quartus II install>/hp/alterad
or
HP-UX
11.0
<MAX+PLUS II install>/adm/alterad (3) or
<Quartus II install>/hp11/alterad
PC
<LeonardoSpectrum-Altera install>\
license\win32\mgcld.exe
or
<ModelSim-Altera install>\
win32aolem\mgcld.exe
Solaris
<LeonardoSpectrum-Altera install>/
license/SunOS5/mgcld or
<ModelSim-Altera Install>/
sunos5aloem/mgls/lib/mgcld
HP-UX
<LeonardoSpectrum-Altera install>/
license/HP-UX10/mgcld
or
<ModelSim-Altera Install>/
hp700aloem/mgls/lib/mgcld
Path to the ARM vendor PC
daemon executable
Solaris
armlmd.
HP-UX
or
<ADS install>\bin\armlmd.exe
<ADS install>/solaris/bin/armlmd
<ADS install>/hpux/bin/armlmd
Notes to Table 3:
(1)
(2)
(3)
(4)
(5)
In some network system environments, the license server does not have an installation of the software tool(s) that
provides the necessary vendor daemon (alterad, mgcld, or armlmd). In this case, copy the required daemon from
another machine that does have an installation of the software. Find the file in the directory location specified. Save
the file in a similarly named directory or any other location on the license server. Specify the daemon location on
the license server in the license file.
If the path name has spaces in it, enclose the full path in quotation marks.
The MAX+PLUS II software installs FLEXlm in the /adm directory for either Solaris or HP-UX, depending on what
the user specified during installation.
If you are not using a license for the LeonardoSpectrum-Altera or ModelSim-Altera software, you may delete this
line.
If you are not using a license for the ADS software, you may delete this line.
Altera Corporation
9
an205.fm Page 10 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
2.
Once the modifications are complete, save the license file with a .dat
extension (e.g., license.dat) and check 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.
Setting up Network Licenses on a PC License Server Using the FLEXlm
License Manager
This section details the steps required to set up an Altera floating network
license on a Windows NT or Windows 2000 license server using the
FLEXlm License Manager provided by Altera.
10
1.
Make a backup copy of any existing license.dat file, in case it is
needed later for reference.
2.
Modify the license.dat file obtained from Altera as described in the
“Modifying the Network License File” section and save it to the hard
drive. The license e-mail from Altera includes the recommended
default directory location.
3.
Install the FLEXlm Server Control Panel from the MAX+PLUS II or
Quartus II software CD. For more details on installation, refer to the
Quartus II Software Installation & Licensing for PCs manual, available
on the Altera web site.
4.
Double-click the FLEXlm License Manager icon in the Windows NT
or Windows 2000 Control Panel (Start > Settings > Control Panel).
5.
Click the Setup tab, shown in Figure 1.
Altera Corporation
an205.fm Page 11 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
Figure 1. FLEXlm License Manager Setup
6.
Specify the Service Name. The default is “FLEXlm License
Manager,” but Altera recommends changing this name to “Altera
License Server” to avoid conflicts with other software that may use
the FLEXlm license manager. Type the new name in the box to
replace the existing name.
7.
Type or browse to the location of lmgrd.exe in the <MAX+PLUS II
installation path> directory or <Quartus II installation path>\bin
directory.
8.
In the License File box, type or browse to the location of the license
file.
9.
In the Debug Log box, type or browse to a name and location for the
file that will contain the debug log. Specifying a debug log is
optional but recommended.
10. Turn on the Use NT Services option to allow licenses to be issued to
user accounts.
11. To start the Altera License Manager automatically when the PC
starts, turn on the Start Server at Power-Up option.
12. Click Apply.
13. Click Yes when asked “Would you like to save the settings for the
service?”.
14. Click the Licenses tab and then click Show License File. Verify that
the correct license.dat file opens and then close it.
Altera Corporation
11
an205.fm Page 12 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
15. Click the Control tab and then click Start to start the license server,
as shown in Figure 2.
Figure 2. FLEXlm License Manager Control Tab
16. Click Status. The message “License server UP (MASTER)” should
appear to indicate the license server is running. If an error message
appears, review the previous steps to ensure that everything is
correct.
17. After the license manager server has been set up on Windows NT or
Windows 2000, the license must be specified for each client or user.
See the “Specify the License File Location” section.
f
For complete information about using the FLEXlm utilities to administer
the FLEXlm License Manager software, refer to the FLEXlm End Users
Guide available at http://www.globetrotter.com/support/index.htm.
Setting Up Network Licenses on a UNIX License Server Using the FLEXlm
License Manager
This section details the steps required to set up an Altera floating network
license on a Solaris or HP-UX license server using the FLEXlm License
Manager provided by Altera.
12
1.
Make a backup copy of any existing license.dat file, in case it is
needed later for reference.
2.
Modify the license.dat file obtained from Altera as described in the
section “Modifying the Network License File” and save the file in a
directory accessible by the license server.
Altera Corporation
an205.fm Page 13 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
3.
The files required for the FLEXlm license manager are installed with
the Quartus II and MAX+PLUS II software; the FLEXlm location is
the <Quartus II installation path>/<solaris | hp | hp11> or
<MAX+PLUS II installation path>/adm directory. If the Quartus II or
MAX+PLUS II software is already installed on the license server
machine, go to step number 6. To install the FLEXlm software
separately on the license server machine, proceed with the following
steps.
4.
Create a directory on the license server to contain the FLEXlm files.
5.
Copy the following files from the <Quartus II installation path>/
<solaris | hp | hp11> or <MAX+PLUS II installation path>/adm
directory of the Altera software installation into the new directory:
■
■
■
6.
lmgrd
lmutil
alterad
Type the following at a command prompt to start the license server:
<FLEXlm location>/lmgrd -c <license location>/license.dat r
7.
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” section.
f
8.
If you receive an error message, review the previous steps to ensure
that everything is correct.
9.
After you have set up the license manager server on the UNIX
machine, the license must be specified for each client or user. See the
“Specify the License File Location” section.
For complete information about using the FLEXlm utilities to administer
and troubleshoot the FLEXlm License Manager software, refer to the
FLEXlm End Users Guide, available at
http://www.globetrotter.com/manual.htm.
1
Altera Corporation
Type lmgrd -help r at a command prompt to see a list and
description of the available FLEXlm options.
13
an205.fm Page 14 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
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
Workstations manual available on the Altera web site.
Specify the
License File
Location
The following steps are required for every user of the software provided
by Altera. The software does not work until the license file location is
determined and specified as outlined in this section.
Determine the License Location
How to determine the license file location depends on the type of license
file.
FIXEDPC and NIC/Hard-Disk PC Licenses
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.
FLOATNET and FLOATPC Network Licenses
Obtain the port number and host name from the network or system
administrator. This information can also be found in the license file line
beginning with the word SERVER.
An example SERVER line follows:
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 there is no port listed in the license.dat file, specify
@<hostname>.
Specify the License Location Using the LM_LICENSE_FILE
System Environment Variable
Third-party tools provided by Altera require that you specify the license
location in the LM_LICENSE_FILE environment variable. This variable
will also set Quartus II and MAX+PLUS II software licenses. This is the
recommended method for specifying the license location.
14
Altera Corporation
an205.fm Page 15 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
1
The license file specification in the Quartus II or MAX+PLUS II
License Setup dialog box (as described in the “Specify the
License for the Quartus II Software Only” and “Specify the
License for the MAX+PLUS II Software Only” sections) takes
precedence over the LM_LICENSE_FILE environment variable
setting for that particular software.
Windows NT
Set the LM_LICENSE_FILE environment variable in the Windows system
control panel.
1.
Choose Settings > Control Panel from the Windows Start menu.
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.
7.
Click Set, and then OK.
If more than one application uses this environment variable, modify the
existing LM_LICENSE_FILE variable and separate the different paths
with a semicolon (;), as shown in the following example:
c:\flexlm\license.dat;1800@myserver
Windows 2000
Set the LM_LICENSE_FILE environment variable through the Windows
system control panel.
Altera Corporation
1.
Choose Settings > Control Panel from the Windows Start menu.
2.
Double-click the System icon in the Control Panel window.
3.
Click the Advanced tab in the System Properties dialog box.
4.
Click Environment Variables.
15
an205.fm Page 16 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
5.
Click the System Variable list to highlight it, and then click FLEXlm.
6.
Type LM_LICENSE_FILE in the FLEXlm box.
7.
Type <path to license file>\license.dat or <port>@<hostname> in
the Value box.
8.
Click OK.
If more than one application uses this environment variable, modify the
existing LM_LICENSE_FILE variable and separate the different paths
with a semicolon (;), for example:
c:\flexlm\license.dat;1800@myserver
Windows 98
Set the LM_LICENSE_FILE environment variable in the autoexec.bat file.
1.
Open the autoexec.bat file with a text editor such as Windows
Notepad. The autoexec.bat file is found in the c:\ directory. If this
file does not exist, create the file and save it in the c:\ directory.
2.
Type the following environment variable on its own line in the
autoexec.bat file, in one of the following formats, to specify the
license location:
set LM_LICENSE_FILE=<path to license file>\license.dat
or
set LM_LICENSE_FILE=<port>@<hostname>
3.
Save the autoexec.bat file.
4.
Ensure that the text editor does not append .txt or other extension to
the filename, such as autoexec.bat.txt. If in doubt, verify the filename
at a command prompt.
5.
Restart the PC.
If more than one application uses this environment variable, modify the
existing LM_LICENSE_FILE variable and separate the different paths
with a semi-colon (;), for example:
set LM_LICENSE_FILE=c:\flexlm\license.dat;1800@myserver
16
Altera Corporation
an205.fm Page 17 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
UNIX Workstation
Set the LM_LICENSE_FILE environment variable in the login
initialization file, such as .cshrc, located in the home directory. Edit this
file for each user.
The following is an example of the steps required for a C shell dot file
(.cshrc).
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 at the command prompt:
cd r
source .cshrc r
If more than one application uses this environment variable, modify the
existing LM_LICENSE_FILE variable and separate the different paths
with a colon (:), as shown in the following example:
setenv LM_LICENSE_FILE 1800@myserver:1800@yourserver
Specify the License for the Quartus II Software Only
You can specify the Quartus II license file from within the Quartus II
software. This method does not set the license for any other Altera
software. Specifying the license using this method takes precedence over
settings made in the LM_LICENSE_FILE environment variable as
described above. However, the LM_LICENSE_FILE setting is sufficient to
license the Quartus II software.
1.
In the Quartus II software, choose License Setup (Tools menu).
2.
In the License file box, as shown in Figure 3, type the following
information as obtained from “Determine the License Location” on
page 14.
<path to license file>\license.dat
or
<port>@<hostname>
Altera Corporation
17
an205.fm Page 18 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
The Licensed AMPP/MegaCore functions box contains any
purchased Intellectual Property (IP) licenses added to the license file.
Figure 3. Quartus II License Setup
Specify the License for the MAX+PLUS II Software Only
You can specify the MAX+PLUS II license file within the MAX+PLUS II
software. This method will not set the license for any other Altera
software. Specifying the license using this method takes precedence over
settings made using the LM_LICENSE_FILE environment variable as
described above. However, the LM_LICENSE_FILE setting is sufficient to
license the MAX+PLUS II software.
1.
18
In the MAX+PLUS II software, choose License Setup (Options
menu).
Altera Corporation
an205.fm Page 19 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
2.
In the License file or Server Name field, type the following
information as obtained from “Determine the License Location” on
page 14.
<path to license file>\license.dat
or
<port>@<hostname>
The Licensed Features box contains a list of enabled items,
depending on the system configuration and license, as shown in
Figure 4.
Figure 4. MAX+PLUS II License Setup Window
Conclusion
Altera Corporation
Now that you have successfully obtained and set up licenses for Alteraprovided software, you are ready to start an Altera design. If you are
unable to access the software after following the procedures in this
document, see AN 229: Advanced Troubleshooting for Altera Software
Licensing.
19
an205.fm Page 20 Friday, November 22, 2002 12:45 PM
AN 205: Understanding Altera Software Licensing
Revision
History
The information contained in AN 205: Understanding Altera Software
Licensing version 1.1 supersedes information published in previous
versions.
Version 1.1
AN 205: Understanding Altera Software Licensing version 1.1 contains the
following changes:
■
101 Innovation Drive
San Jose, CA 95134
(408) 544-7000
http://www.altera.com
Applications Hotline:
(800) 800-EPLD
Literature Services:
lit_req@altera.com
20
Updated text on pages 1 through 9.
Copyright © 2002 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. ARM is a registered trademark of ARM Limited. ModelSim and Mentor Graphics are
registered trademark and LeonardoSpectrum and Model Technology are trademarks of Mentor Graphics
Corporation. Altera products are protected under numerous U.S. and foreign patents and pending
applications, maskwork rights, and copyrights. Altera warrants performance of its
semiconductor products to current specifications in accordance with Altera's standard
warranty, but reserves the right to make changes to any products and services at any time
without notice. Altera assumes no responsibility or liability arising out of the application
or use of any information, product, or service 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
Altera Corporation