User Guide
User Guide
VERSION 7.0v2
©2012 The Foundry Visionmongers Ltd. All rights reserved.
FLT 7.0v2 User Guide
This manual, as well as the software described in it, is furnished under license and may only be used or copied in accordance with
the terms of such license. This manual is provided for informational use only and is subject to change without notice. The Foundry
assumes no responsibility or liability for any errors of inaccuracies that may appear in this book.
No part of this manual may be reproduced, stored in a retrieval system, or transmitted in any form without the prior written
permission of The Foundry.
The Foundry logo is a trademark of The Foundry Visionmongers Ltd. Nuke is a registered trademark of The Foundry Visionmongers
Ltd. All other products or brands are trademarks or registered trademarks of their respective companies or organizations.
Product testing: Jacob Chivers, Joel Braham, Robert Elphick, Mark Titchener, Phil Mullan, Dan Allum, and Michael Zannetou.
Writing: Jonathan Barson, Andy Whitmore, Joel Byrne, and Eija Närvänen.
Replace Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Which RLM Port?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Managing the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Starting the License Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Stopping the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Viewing the License Server Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
RLM Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Useful Commands for System Administrators . . . . . . . . . . . . . . . . . . 59
Removing FLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
On Mac OS X. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
On Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Troubleshooting Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Licenses Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Windows 7 Hidden Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
FLU Reporting More Than One System ID . . . . . . . . . . . . . . . . . . . . . . . . . 72
Node Locked and Client Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Accessing the RLM Web Server on Mac OS X. . . . . . . . . . . . . . . . . . . . . . . 73
Contacting Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Using the Diagnostics Tool in GUI Mode . . . . . . . . . . . . . . . . . . . . . . 74
Using the Diagnostics Tool in Command Line Mode. . . . . . . . . . . . . . 74
In a hurry? No time to read the whole user guide? We understand. Read this
section—it'll tell you how to use your activation key or install your license.
Note The Foundry Licensing Tools’ default settings do not support RLM licensing on
virtual machines (VMs). If you have any questions regarding licensing on VMs,
please contact support@thefoundry.co.uk for more information.
About Licenses All The Foundry products built between October 2005 and October 2010
were licensed using FLEXlm. The Foundry is currently migrating its products
to activation-key-based licensing and has chosen to use RLM for the back
end licensing.
To find out whether your product uses FLEXlm or RLM licensing, please
refer to the product’s documentation.
If you want to know what a license looks like, have a look at Appendix B:
License Syntax on page 82 for a description of the file syntax.
QUICK START 7
Free Trial Licenses
Free Trial Licenses If you simply want to obtain a free trial license for 15 days, you can:
• launch your product and, if a Licensing dialog appears, click Obtain Trial
License, or
You can only install a trial license once for each product on a single
machine.
Activation Keys This section tells you how to use an activation key with your product.
Purchasing an If you've been supplied with something that looks similar to this:
Activation Key mari-0101-3733-eeda-8376-df83-7235
you have an activation key and you can activate your product.
If your product uses activation key based licensing but you don’t yet have
an activation key, you can purchase one by:
• using the Purchase License button on the Licensing dialog when you first
launch your product,
Once you have an activation key, proceed to How to Use Your Activation
Key below.
How to Use Your If you are using a product that has a Licensing dialog (such as Mari or Hiero)
Activation Key and currently have no license, or are running a temporary license, your
product prompts you at startup to enter your activation key into the
Licensing dialog. This step is skipped if:
• you’ve already activated a permanent license, or
• you’re trying to activate a product that doesn’t have a Licensing dialog
(for example a set of plug-ins). If this is the case, go to
http://www.thefoundry.co.uk/support/licensing/activate-product/, enter
your activation key into the field provided, and follow the instructions on
screen.
If you’re trying to activate a product using the Licensing dialog, do the
following:
1. Launch your product.
Node Locked and This section tells you how to obtain and install node locked and floating
Floating Licenses licenses for your product.
The instructions for installing node locked and floating licenses depend on
your operating system, so before you do anything else choose one of the
following:
• To install a license on Windows, go to page 9.
• To install a license on Mac OS X, go to page 11.
• To install a license on Linux, go to page 13.
Windows This section tells you how to get your license working on Windows.
Purchasing a license
You can purchase license keys by:
• going to our web site at www.thefoundry.co.uk,
• e-mailing us at sales@thefoundry.co.uk,
• phoning our London office at +44 20 7968 6828 or our Los Angeles
office at +1 (310) 399 4555.
To generate a license key, we need to know your System ID. The System ID
returns a unique number for your computer. We lock our license keys to the
System ID.
For floating licenses, we need to know the System ID of the machine that
serves the licenses across the network.
To display your System ID, download the Foundry License Utility (FLU) from
www.thefoundry.co.uk/support/licensing/ and run it. The System ID is
displayed at the bottom of the window, as highlighted.
Figure 2. Drag the license file onto the Foundry License Utility.
When you install a floating license key, the license server address is
displayed on screen:
<number>@<license server name>
You should make a note of the address, as you’ll need it to activate the
client machines. Then, proceed to Installing the Foundry Licensing Tools
(FLT) on the License Server below.
Repeat this process for each machine you wish to have access to licenses
on the server.
Mac OS X This section tells you how to get your license working on Mac OS X.
Purchasing a license
You can purchase license keys by:
• going to our web site at www.thefoundry.co.uk,
• e-mailing us at sales@thefoundry.co.uk,
• phoning our London office at +44 20 7968 6828 or our Los Angeles
office at +1 (310) 399 4555.
To generate a license key, we need to know your System ID. The System ID
returns a unique number for your computer. We lock our license keys to the
System ID.
For floating licenses, we need to know the System ID of the machine that
will serve the licenses across the network.
To display your System ID, download the Foundry License Utility (FLU) from
www.thefoundry.co.uk/support/licensing/ and run it. The System ID is
displayed at the bottom of the window, as highlighted.
Figure 4. Drag the license file onto the Foundry License Utility.
When you install a floating license key, the license server address is
displayed on screen:
<number>@<license server name>
You should make a note of the address, as you’ll need it to activate the
client machines. Then, proceed to Installing the Foundry Licensing Tools
(FLT) on the License Server below.
Repeat this process for each machine you wish to have access to licenses
on the server.
Linux This section tells you how to get your license working on Linux.
Purchasing a license
You can purchase license keys by:
• going to our web site at www.thefoundry.co.uk,
• e-mailing us at sales@thefoundry.co.uk,
• phoning our London office at +44 20 7968 6828 or our Los Angeles
office at +1 (310) 399 4555.
To generate a license key, we need to know your System ID. The System ID
returns a unique number for your computer. We lock our license keys to the
System ID.
For floating licenses, we need to know the System ID of the machine that
will serve the licenses across the network.
To display your System ID, download the Foundry License Utility (FLU) from
www.thefoundry.co.uk/support/licensing/ and run it from the command line:
<download location>/FoundryLicenseUtility -i
Note The <download location> refers to the location where you saved the Foundry
Licensing Utility.
Repeat this process for each machine you wish to have access to licenses
on the server.
More Information For a complete explanation of licenses, license syntax, alternative license
directories, useful server commands, and much more, please read Licensing
a Product on a Single Machine on page 17 or Licensing a Product over a
Network on page 29.
This chapter tells you how to license your product on a single machine.
Note The Foundry Licensing Tools’ default settings do not support RLM licensing on
virtual machines (VMs). If you have any questions regarding licensing on VMs,
please contact support@thefoundry.co.uk for more information.
If you want to license one of our products over a network instead, please
read Licensing a Product over a Network on page 29.
About Licenses All The Foundry products built between October 2005 and October 2010
were licensed using FLEXlm. The Foundry is currently migrating its products
to activation-key-based licensing and has chosen to use RLM for the back
end licensing.
To find out whether your product uses FLEXlm or RLM licensing, please
refer to the product’s documentation.
Note We also provide free 15-day trial licenses. See Free Trial Licenses on page 7.
Activation Keys This section tells you how to use an activation key with your product.
Purchasing an If you've been supplied with something that looks similar to this:
Activation Key mari-0101-3733-eeda-8376-df83-7235
you have an activation key and you can activate your product.
If your product uses activation key based licensing but you don’t yet have
an activation key, you can purchase one by:
• using the Purchase License button on the Licensing dialog when you first
launch your product,
Once you have an activation key, proceed to How to Use Your Activation
Key below.
How to Use Your If you currently have no license, or are running a temporary license, your
Activation Key product prompts you at startup to enter your activation key into a Licensing
dialog. This step is skipped if:
• you’ve already activated a permanent license, or
• you’re trying to activate a product that doesn’t have a Licensing dialog
(for example a set of plug-ins). If this is the case, go to
http://www.thefoundry.co.uk/support/licensing/activate-product/, enter
your activation key into the field provided, and follow the instructions on
screen.
If you’re trying to activate a product that does have a Licensing dialog, such
as Mari or Hiero, do the following:
1. Launch your product.
The Licensing dialog displays.
Node Locked This section tells you how to obtain and install node locked licenses for your
Licenses product.
Purchasing a Node You can purchase node locked license keys by:
Locked License • going to our web site at www.thefoundry.co.uk,
• e-mailing us at sales@thefoundry.co.uk,
• phoning our London office at +44 20 7968 6828 or our Los Angeles
office at +1 (310) 399 4555.
To generate a license key, we need to know your System ID. The System ID
(sometimes called Host ID, lmhostid, or rlmhostid) returns a unique number
for your computer. We lock our license keys to the System ID. Just so you
know what a System ID number looks like, here’s an example:
000ea641d7a1
There are a number of ways to display your System ID, depending on your
operating system.
Note In most cases, our licensing tools find the RLM System ID, check that FLEXlm
accepts the same ID, and then display that ID. However, on rare occasions, you can
have two System IDs reported. If this is the case, both System IDs are displayed,
like this:
R00ffb79aefc9:X00ffb79aefa9
When purchasing a license, you should send us the entire string with both IDs.
On Windows
• Download the Foundry License Utility (FLU) from our website
(www.thefoundry.co.uk/support/licensing/) and run it.
The System ID is displayed at the bottom of the window, as highlighted.
Note The <download location> refers to the location where you saved the Foundry
Licensing Utility.
Note If you use the FLU from a DOS shell and don’t pass it any arguments (such as -i in
the above example), it launches in GUI mode.
On Mac
• Download the Foundry License Utility (FLU) from our website
(www.thefoundry.co.uk/support/licensing/) and run it.
The System ID is displayed at the bottom of the window, as highlighted.
On Linux
Download the Foundry License Utility (FLU) from our website
(www.thefoundry.co.uk/support/licensing/) and run it from the command
line:
<download location>/FoundryLicenseUtility -i
Note The <download location> refers to the location where you saved the Foundry
Licensing Utility.
Installing a Node Once you have a node locked license, you can install it using two methods:
Locked License • The automated method (recommended). The easiest way to install a node
locked license is to use The Foundry License Utility (FLU).
On Windows and Mac OS X, the FLU can be used both in graphical user
interface (GUI) mode and from the command line.
On Linux, the FLU is a command line tool only.
For more information, see one of the following:
Figure 7. Drag the license file onto the Foundry License Utility.
• Or cut and paste the license key text directly into the License Install tab
in the FLU application;
• Or if you double-click on the FLU application, it installs any file with a .lic
file extension that it finds in the same directory as the application.
Note If there is an error with any part of the license installation, this is reported in the
FLU. You should also see a Generate Report button, which you can click to write the
errors out to a file that you can send to support@thefoundry.co.uk for assistance.
If you are installing several licenses at the same time and only some of them fail
validation, you can also click Continue to complete the installation of the valid
licenses.
The above methods are the easiest way to install a license. However, if you
prefer, you can also install a license from a DOS shell. To do so:
1. Save the FLU and your license key to a folder of your choice. Note that
the license file can be the original .lic file or the license in a plain text file
(as long as the file has a .lic extension).
2. On Windows XP, click Start > Run. Type cmd and press Return.
On Windows 7, click Start. Type cmd and press Return.
This launches a DOS shell.
3. Navigate to the location of the FLU_7.0v2_win-x86-release-32.exe file.
4. Type the following command to install the FLU and the license. Note that
you need to replace [my license] with the location of your license key.
FLU_7.0v2_win-x86-release-32.exe -l[my license]
For example, if you saved your license key to D:\Temp\foundry.lic, the
command should be:
FLU_7.0v2_win-x86-release-32.exe -l D:\Temp\foundry.lic
This checks the license key and copies it to the correct directory. You’re
done.
Note If you use the FLU from a DOS shell and don’t pass it any arguments (such as -l in
the above example), it launches in GUI mode.
Figure 8. Drag the license file onto the Foundry License Utility.
• Or cut and paste the license key text directly into the License Install tab
in the FLU application;
• Or if you double click on the FLU application, it installs any file with a .lic
file extension that it finds in the same directory as the application.
Note If there is an error with any part of the license installation, this is reported in the
FLU. You should also see a Generate Report button, which you can click to write the
errors out to a file that you can send to support@thefoundry.co.uk for assistance.
If you are installing several licenses at the same time and only some of them fail
validation, you can also click Continue to complete the installation of the valid
licenses.
The above methods are the easiest way to install a license. However, if you
prefer, you can also install a license from the command line. To do so:
1. Save the FLU and your license key to a folder of your choice. Note that
the license file can be the original .lic file or the license in a plain text
file.
2. Launch a terminal and navigate to the location of the FLU_7.0v2_mac-
x86-release-64.zip file.
3. Type the following commands to extract and install the FLU and the
license. Note that you need to replace [my license] with the location of
your license key.
unzip FLU_7.0v2_mac-x86-release-64.zip
cd FoundryLicenseUtility.app/Contents/MacOS
./FoundryLicenseUtility -l [my license]
For example, if you saved your license key to /tmp/foundry.lic, the last
line should be:
./FoundryLicenseUtility -l /tmp/foundry.lic
This checks the license key and copies it to the correct directory. You’re
done.
If you are installing several licenses at the same time and only some of them fail
validation, you can continue to complete the installation of the valid licenses.
Make sure you don’t save the key in a rich text (RTF) file as it won’t work.
You should also avoid using Word or other word processing programs to
create license files, as these add invisible control characters that trip up the
licensing and make it hard for us to diagnose the fault.
The recommended location for the license file varies depending on the
operating system you are using, and is as follows:
Note There are other directories that can be searched for license files. See Moving the
License Keys and Log Files on page 27.
On Windows XP (32-bit):
• If your product uses FLEXlm licensing:
C:\Program Files\The Foundry\FLEXlm\
• If your product uses RLM licensing:
C:\Program Files\The Foundry\RLM\
On Windows XP (64-bit):
• If your product uses FLEXlm licensing:
C:\Program Files\The Foundry\FLEXlm\ or
C:\Program Files (x86)\The Foundry\FLEXlm\
• If your product uses RLM licensing:
C:\Program Files\The Foundry\RLM\ or
C:\Program Files (x86)\The Foundry\RLM\
Note 32-bit applications running on a 64-bit machine are installed to, and look for
licenses in, the (x86) directory. 64-bit apps (like Nuke) running on a 64-bit
computer look for their license keys in C:\Program Files\The Foundry\FLEXlm\. So
depending on the software you are using, you may want to copy your Foundry
license key to one or more of these directories.
On Windows 7
• If your product uses FLEXlm licensing:
C:\Program Files\The Foundry\FLEXlm\
C:\Program Files (x86)\The Foundry\FLEXlm\
C:\ProgramData\The Foundry\FLEXlm\
On Mac OS X:
• If your product uses FLEXlm licensing:
/Library/Application Support/TheFoundry/FLEXlm/
• If your product uses RLM licensing:
/Library/Application Support/TheFoundry/RLM/
On Linux:
• If your product uses FLEXlm licensing:
/usr/local/foundry/FLEXlm/
• If your product uses RLM licensing:
/usr/local/foundry/RLM/
Where are the License You can move the FLEXlm and RLM license keys and log files anywhere, but
Keys and Log Files? by default they are installed to the following directories. We’ll refer to these
locations as the <data path>.
C:\ProgramData\The Foundry\FLEXlm\
C:\ProgramData\The Foundry\RLM\
Note The ProgramData folder is hidden on Windows 7. If you want to see it then you
have to make it visible using the Folder Options in the Control Panel. See Windows
7 Hidden Files on page 72.
Tip A good command to use on very large log files to display the last 30 entries is:
tail -n 30 foundry.log
Note, however, that if you want to send the log file to support@thefoundry.co.uk,
it should be the complete log file created using the diagnostics tool in the Foundry
License Utility (FLU). See Contacting Support on page 73.
Appending to an You can add a new license to an existing key using two methods:
Existing License • Drop the license file onto the Foundry License Utility (FLU). This is the
recommended method.
• Use the command line. This is not recommended for most users.
However, you can add a new license key by editing the foundry.lic text
file. Simply copy and paste the license to the end of your existing license
file.
More Information This user guide should cover all the information you need to use FLEXlm or
RLM licenses for The Foundry products. However, it is not meant to be an
exhaustive exploration of all the features available with FLEXlm or RLM
licensing. For that, you should:
• see the FLEXnet Licensing End User Guide included in the Foundry
Licensing Tools download or go to www.flexerasoftware.com.
• see the RLM Licensing End User Guide included in the Foundry Licensing
Tools download or go to www.reprisesoftware.com.
Please be aware that advanced RLM features not discussed in this user
guide are not supported with RLM licenses from The Foundry.
This chapter tells you how to license your product over a network.
Note The Foundry Licensing Tools’ default settings do not support RLM licensing on
virtual machines (VMs). If you have any questions regarding licensing on VMs,
please contact support@thefoundry.co.uk for more information.
About Floating A floating license running on a server enables one of our products to work
Licenses on any networked client machine. Floating licenses are sometimes called
counted licenses.
The floating license should be put on the server and is locked to a unique
number on that server (see Displaying Your System ID on page 30). Floating
licenses on a server require additional software to be installed. This
software manages those licenses on the server, giving licenses out to client
stations that want them. The software you need to manage these licenses is
called the Foundry Licensing Tools (FLT), which can be freely downloaded
from our web site.
Floating licenses often declare a port number. This is required if you have
an internet firewall on your license server so that you can permit license
communication while blocking others. See Firewalls on page 62.
sig="60P0453JHKQBGTB1HH7E3HNW843UJ627TSF4CXR22H7KNMYHG1B99WBSNHS1
UE7FCN2W3AY8KV"
For further information about the structure of the license key, see Floating
License Syntax on page 84.
To display your server machine’s System ID, see Displaying Your System ID
below.
Once you have provided us with your server machine’s System ID number
and a license key has been generated for you, you receive the license key in
an e-mail or internet download. The license key is contained in a text file
called foundry.lic. For information on what to do with the foundry.lic file,
see Installing a Floating License on page 32.
Displaying Your There are a number of ways to display your server machine’s System ID,
System ID depending on your operating system.
Note In most cases, our licensing tools find the RLM System ID, check that FLEXlm
accepts the same ID, and then display that ID. However, on rare occasions, you can
have two System IDs reported. If this is the case, both System IDs are displayed,
like this:
R00ffb79aefc9:X00ffb79aefa9
When purchasing a license, you should send us the entire string with both IDs.
On Windows
• Download the Foundry License Utility (FLU) from our website
(www.thefoundry.co.uk/support/licensing/) and run it on the machine
that acts as the server.
The System ID is displayed at the bottom of the window, as highlighted.
On Mac
• Download the Foundry License Utility (FLU) from our website
(www.thefoundry.co.uk/support/licensing/) and run it on the machine
that acts as the server.
The System ID is displayed at the bottom of the window, as highlighted.
Note The <download location> refers to the location where you saved the Foundry
Licensing Utility.
On Linux
On the machine that acts as the server, download the Foundry License
Utility (FLU) from our website (www.thefoundry.co.uk/support/licensing/)
and run it from the command line:
<download location>/FoundryLicenseUtility -i
Note The <download location> refers to the location where you saved the Foundry
Licensing Utility.
Installing a The Foundry Licensing Tools are supplied for Windows, Mac OS X, and
Floating License Linux. To manage floating licenses across a network, you have to install the
Foundry Licensing Tools on a license server together with your floating
license key(s). Then you have to tell your client machines where to look for
their license. How to do all this depends on your operating system:
• If you’re on Windows, see Windows on page 32.
• If you’re on Mac OS X, see Mac OS X on page 37.
• If you’re on Linux, see Linux on page 42.
Windows This section tells you how to get your floating license working on Windows.
Figure 11. Drag the license file onto the Foundry License Utility.
• Or cut and paste the license key text directly into the License Install
tab in the FLU application;
• Or if you double-click on the FLU application, it installs any file with a
.lic file extension that it finds in the same directory as the application.
2. The license server address is displayed on screen:
4. Type the following command to install the FLU and the license. Note that
you need to replace [my license] with the location of your license key.
FLU_7.0v2_win-x86-release-32.exe -l[my license]
For example, if you saved your license key to D:\Temp\foundry.lic, the
command should be:
FLU_7.0v2_win-x86-release-32.exe -l D:\Temp\foundry.lic
This checks the license key and copies it to the correct directory.
5. The license server address is displayed on screen:
<number>@<license server name>
You should make a note of the address as you’ll need it to activate the
client machines.
6. Proceed to Installing Foundry Licensing Tools (FLT) on the license server
on page 35.
Note If you use the FLU from a DOS shell and don’t pass it any arguments (such as -l in
the above example), it launches in GUI mode.
Alternatively, if you wish, you can install the license key by hand, though
this is not recommended for most users. To do so:
1. Launch a text editor and create a plain text file. Avoid using Word or
other word processing programs to create the file, as these add invisible
control characters that trip up the licensing and make it hard for us to
diagnose the fault.
2. Copy the license key and paste it into the plain text file.
3. Save the file with a .lic extension (not .txt or .rtf) in the following
directory. The name of the file can be anything, but we recommend
calling it foundry.lic.
• On Windows XP (32-bit)
FLEXlm licenses: C:\Program Files\The Foundry\FLEXlm\
RLM licenses: C:\Program Files\The Foundry\RLM\
• On Windows XP (64-bit)
FLEXlm licenses:
C:\Program Files\The Foundry\FLEXlm\ or
C:\Program Files (x86)\The Foundry\FLEXlm\
RLM licenses:
C:\Program Files\The Foundry\RLM\ or
C:\Program Files (x86)\The Foundry\RLM\
Note 32-bit applications running on a 64-bit machine are installed to, and look for
licenses in, the (x86) directory. 64-bit apps (like Nuke) running on a 64-bit
computer look for their license keys in C:\Program Files\The Foundry\FLEXlm\. So
depending on the software you are using, you may want to copy your Foundry
license key to one or more of these directories.
• On Windows 7
FLEXlm licenses: C:\ProgramData\The Foundry\FLEXlm\
RLM licenses: C:\ProgramData\The Foundry\RLM\
Note The ProgramData folder is hidden on Windows 7. If you want to see it, then you
have to make it visible using the Folder Options in the Control Panel. See “Windows
7 Hidden Files on page 72.
Note There are other directories that can be searched for license files. See Moving the
FLEXlm and RLM Files on page 47.
4. If you installed an RLM license, create an options file and set a TIMEOUT
or TIMEOUTALL period. This ensures that licenses are returned to the
server if the server and client machines lose contact with each other (due
to a network error, a crash, or some other failure). For more information,
see page 51.
If you installed a FLEXlm license, you can skip this step. FLEXlm licenses
have a default timeout period of 7200 seconds (two hours).
5. Proceed to Installing Foundry Licensing Tools (FLT) on the license server
on page 35.
Note If you have a firewall on your license server, this blocks all requests for licenses
from your clients. So all that good work you’ve done in setting up your Foundry
License Server will be for nothing unless you fix this. See Firewalls on page 62.
4. Proceed to Telling the client machines where to find the licenses below.
There are several ways to license clients. Choose one of the following and
repeat it for each machine you wish to have access to licenses on the
server:
• If your product displays a Licensing dialog when you launch it, click
Activate License or Use Server. Type <number>@<server name> (for
example, 4101@red) into your The Foundry product and click OK. Your
client retrieves a license from the License Server and launches.
• Click Start > All Programs > The Foundry > FLT 7.0v2 > Foundry License
Utility to launch the FLU. Make sure you are viewing the License Install
tab and copy and paste in an RLM server line:
HOST <server name> any <port>
For example: HOST red any 4101
This creates and installs both a FLEXlm and RLM client license.
• Launch a DOS shell. Navigate to the location of the
FoundryLicenseUtility.exe file:
• C:\Program Files\The Foundry\LicensingTools7.0
• C:\Program Files (x86)\The Foundry\LicensingTools7.0
• C:\ProgramData\The Foundry\LicensingTools7.0
Then, type the following command:
FoundryLicenseUtility.exe -c <port>@<server name>
For example:
FoundryLicenseUtility.exe -c 4101@red
This creates and installs both a FLEXlm and RLM client license.
• Set an environment variable on your client as follows:
• If your product uses FLEXlm licensing, set the FOUNDRY_LICENSE_FILE
environment variable on your client to point to the license server (for
example, @red). If you have more than one server, you could use
@red:@green.
If you have specified a particular server port number (30001) in the
foundry.lic file on the server, you should set the environment variable to
30001@red.
Mac OS X This section tells you how to get your floating license working on Mac OS X.
sion of the Foundry License Utility (FLU). To check and install the license
key, install the Mac OS X version of the FLU and do one of the following:
• Drag the license file onto the FLU application;
Figure 13. Drag the license file onto the Foundry License Utility.
• Or cut and paste the license key text directly into the License Install
tab in the FLU application;
• Or if you double-click on the FLU application, it installs any file with a
.lic file extension that it finds in the same directory as the application.
2. The license server address is displayed on screen:
<number>@<license server name>
You should make a note of the address as you’ll need it to activate the
client machines.
3. Proceed to Installing Foundry Licensing Tools (FLT) on the license server
on page 40.
Note If there is an error with any part of the license installation, this is reported in the
FLU. You should also see a Generate Report button, which you can click to write the
errors out to a file that you can send to support@thefoundry.co.uk for assistance.
If you are installing several licenses at the same time and only some of them fail
validation, you can also click Continue to complete the installation of the valid
licenses.
You may also get a message saying that the license is not yet valid but may be valid
in the future. This means the license has been installed successfully and will
automatically become live on the license start date. You do not need to do anything
further, but if you like, you can check that the server is up and the server log
reports the same message (see Viewing the License Server Log on page 57).
Alternatively, if you wish, you can install the license key by hand, though
this is not recommended for most users. To do so:
1. Launch a text editor and create a plain text file. Avoid using Word or
other word processing programs to create the file, as these add invisible
control characters that trip up the licensing and make it hard for us to
diagnose the fault.
2. Copy the license key and paste it into the plain text file.
3. Save the file with a .lic extension (not .txt or .rtf) in the following
directory. The name of the file can be anything, but we recommend
calling it foundry.lic.
FLEXlm licenses: /Library/Application Support/TheFoundry/FLEXlm/
RLM licenses: /Library/Application Support/TheFoundry/RLM/
Note There are other directories that can be searched for license files. See Moving the
FLEXlm and RLM Files on page 47.
4. If you installed an RLM license, create an options file and set a TIMEOUT
or TIMEOUTALL period. This ensures that licenses are returned to the
server if the server and client machines lose contact with each other (due
to a network error, a crash, or some other failure). For more information,
see page 51.
If you installed a FLEXlm license, you can skip this step. FLEXlm licenses
have a default timeout period of 7200 seconds (two hours).
There are several ways to license clients. Choose one of the following and
repeat it for each machine you wish to have access to licenses on the
server:
• If your product displays a Licensing dialog when you launch it, click
Activate License or Use Server. Type <number>@<server name> (for
example, 4101@red) into your The Foundry product and click OK. Your
client retrieves a license from the License Server and launches.
Linux This section tells you how to get your floating license working on Linux.
Note If there is an error with any part of the license installation, this is reported on the
command line. You are also asked if you would like to generate an error log file,
which you can send to support@thefoundry.co.uk for assistance.
If you are installing several licenses at the same time and only some of them fail
validation, you can continue to complete the installation of the valid licenses.
You may also get a message saying that the license is not yet valid but may be valid
in the future. This means the license has been installed successfully and will
automatically become live on the license start date. You do not need to do anything
further, but if you like, you can check that the server is up and the server log
reports the same message (see Viewing the License Server Log on page 57).
Alternatively, if you wish, you can install the license key by hand, though
this is not recommended for most users. To do so:
1. Launch a text editor and create a plain text file. Avoid using Word or
other word processing programs to create the file, as these add invisible
control characters that trip up the licensing and make it hard for us to
diagnose the fault.
2. Copy the license key and paste it into the plain text file.
3. Save the file with a .lic extension (not .txt or .rtf) in the following
directory. The name of the file can be anything, but we recommend
calling it foundry.lic.
FLEXlm licenses: /usr/local/foundry/FLEXlm/
RLM licenses: /usr/local/foundry/RLM/
Note There are other directories that can be searched for license files. See Moving the
FLEXlm and RLM Files on page 47.
4. If you installed an RLM license, create an options file and set a TIMEOUT
or TIMEOUTALL period. This ensures that licenses are returned to the
server if the server and client machines lose contact with each other (due
to a network error, a crash, or some other failure). For more information,
see page 51.
If you installed a FLEXlm license, you can skip this step. FLEXlm licenses
have a default timeout period of 7200 seconds (two hours).
5. Proceed to Installing Foundry Licensing Tools (FLT) on the license server
below.
cd /tmp
tar xvzf FLT_7.0v2_linux-x86-release-64.tgz
cd FLT_7.0v2_linux-x86-release-64
./install.sh
The license server starts automatically after installation (and whenever
you restart the machine).
3. To check the server status, navigate to /usr/local/foundry/
LicensingTools7.0 and enter:
./FoundryLicenseUtility -s status
This reports the status of both FLEXlm and RLM servers. If you only want
to view one or the other, use one of the following commands instead:
./FoundryLicenseUtility -s status -t FLEXlm
./FoundryLicenseUtility -s status -t RLM
To check RLM server status, you can also direct a web browser to the
http://<server_name>:4102 server page and click Status on the right.
There are several ways to license clients. Choose one of the following and
repeat it for each machine you wish to have access to licenses on the
server:
• If your product displays a Licensing dialog when you launch it, click
Activate License or Use Server. Type <number>@<server name> (for
example, 4101@red) into your The Foundry product and click OK. Your
client retrieves a license from the License Server and launches.
• Launch a shell and navigate to:
/usr/local/foundry/LicensingTools7.0/
Where are the FLEXlm You can move the FLEXlm and RLM files anywhere, but by default they are
and RLM Files? installed to the following directories. We refer to this directory throughout
this guide and assume all the FLEXlm and RLM components we ship are here.
Application files
These are files included in the Foundry License Installer. We’ll refer to this
location as the <app path>.
Data files
These include the license keys and log files. We’ll refer to these locations as
the <data path>.
Moving the FLEXlm and If you want to move a floating license key to another directory then, if you
RLM Files have a license server already running, you need to shut it down. You’ll need
to edit the startup scripts to look in the new location. Then restart the
license server.
On Windows
If your product uses FLEXlm licensing:
1. First, stop the license server if it’s running. Navigate to Start > Control
Panel > Administrative Tools > Services. Select Foundry FLEXlm Server
and click Stop.
2. From the Start menu, select Run... type regedit and press Return on your
keyboard.
3. Open the hierarchical structure:
+ HKEY_LOCAL_MACHINE
+ SOFTWARE
+ FLEXlm License Manager
+ Foundry FLEXlm Server
4. Select License and append the new license location to the current one
using a semicolon between them:
C:\Program Files\The Foundry\FLEXlm;C:\tmp
5. Quit regedit.
6. Restart the license server. Navigate to Start > Control Panel >
Administrative Tools > Services. Select Foundry FLEXlm Server and click
Start.
Tip You can also stop and start the license server using the Foundry License Utility
(FLU). See Managing the License Server on page 56.
• Navigate to Start > Control Panel > Administrative Tools > Services.
Select Foundry License Server and click Stop.
• Navigate to Start > Control Panel > Administrative Tools > Services.
Select Foundry License Server and click Start.
• Use a web browser to go to the http://<server_name>:4102 server
page. Click Status > Start.
Tip You can also stop and start the license server using the Foundry License Utility
(FLU). See Managing the License Server on page 56.
On Mac OS X
• If your product uses FLEXlm licensing, edit:
/Library/LaunchDaemons/uk.co.thefoundry.lmgrd
changing this line:
<string>/Library/Application Support/TheFoundry/FLEXlm/:/usr/
local/foundry/FLEXlm/</string>
to this, assuming your license is in /home/licenses
<string>/Library/Application Support/TheFoundry/FLEXlm/:/usr/
local/foundry/FLEXlm/:/home/licenses</string>
• If your product uses RLM licensing, edit:
/Library/LaunchDaemons/uk.co.thefoundry.rlm.plist
On Linux
• If your product uses FLEXlm licensing, edit:
/etc/init.d/foundryflexlmserver
changing this line:
FnLicDir=/usr/local/foundry/FLEXlm
to this, assuming your license is in /home/licenses
FnLicDir=/usr/local/foundry/FLEXlm:/home/licenses
• If your product uses RLM licensing, edit:
/etc/init.d/foundryrlmserver
changing this line:
FnLicDir=/usr/local/foundry/RLM
to this, assuming your license is in /home/licenses
FnLicDir=/usr/local/foundry/RLM:/home/licenses
When is a License Product licenses are checked out from the server when the product is first
Taken or Dropped? used on the client. Plug-in products generally take a license when the first
plug-in of the set is used.
Plug-in products generally return the license when the last plug-in of the
set is removed from the effects tree or layer stack. The exact point at which
a license is returned by a plug-in product is host-specific, and can be
unpredictable.
If you want your license to go back to the server if you don’t use it for a
while, you need to change the default behavior by disabling the heartbeat.
Note The heartbeat ensures the communication between the server and client persists in
a stable fashion and therefore should be disabled with caution, otherwise users
may find their licenses being withdrawn unexpectedly.
The server and client machine lose contact with each other
Should the server and client machines lose contact with each other (due to a
network error, a crash, or some other failure), licenses are returned to the
server according to the TIMEOUT or TIMEOUTALL flag set in the options file
(foundry.opt):
• FLEXlm licenses
By default, the TIMEOUT value is set to 7200, which means the server
waits for 7200 seconds (two hours) before deciding that the client has
crashed or failed in some other way, then deems the license released,
and makes it available on the network again. If you want to change the
default timeout period, you need to edit the options file. For instructions
on how to do this, see below.
• RLM licenses
• If you installed an RLM license using The Foundry License Utility (FLU),
the options file was created automatically, with the TIMEOUTALL flag
set to 3600 seconds (in other words, one hour). This means the server
waits for one hour before deciding that the client has crashed or failed
in some other way, then deems the license released, and makes it avail-
able on the network again. If you want to change the default timeout
period, you need to edit the options file. For instructions on how to do
this, see below.
• If you installed an RLM license manually, you must create the options
file and set a TIMEOUTALL or TIMEOUT period yourself. If you don’t,
the server does not have a default timeout period and may never
release the license in some circumstances. For more instructions, see
below.
Capping licenses Have you ever needed a license only to find they have all been checked out
by your colleagues? Just needed a command to stop someone’s license so
you can grab it? Then these are the commands for you!
The lmremove (for FLEXlm) and rlmremove (for RLM) utilities allow you to
remove a single user’s license for a specified feature. As ever, let’s consider
some examples.
Note See Data files on page 46 and Application files on page 46 for the correct <data
path> and <app path>.
where the user is jack, the user’s computer is red, and the license handle is
8a.
Since it’s a bit rude to cap someone’s license, systems administrators can
disable this functionality by:
• starting the lmgrd with a flag, -x lmremove.
• starting the rlm.foundry with a flag, -x rlmremove.
Appending to an You can add a new license to an existing key using two methods:
Existing License • On Windows and Mac OS X, drop the license file onto the Foundry
License Utility. On Linux, run the FLU from the command line using
./FoundryLicenseUtility -l [license path]. This is the recommended
method.
• Edit the license file manually from the command line. This is not
recommended for most users.
If your product uses FLEXlm licensing, see Manual method (FLEXlm).
If your product uses RLM licensing, see Manual method (RLM).
Here is an example floating license key for a machine called red with System
ID 000EA641D7A1 that serves 2 floating Nuke licenses onto the network.
SERVER red 000EA641D7A1
VENDOR foundry
INCREMENT nuke_i foundry 2012.0930 permanent 2 \
ISSUED=8-feb-2012 SIGN="00FF 6A1B 735B 0A10 6894 4903 E2CF \
A238 7A01 1A15 1808 7BCF 346C F59E 8899 F53C 2B13 E204"
If you are then sent a Furnace for Nuke license key for the same machine,
just add the INCREMENT lines to your existing file, ignoring any SERVER
lines, so that it would look like this:
SERVER red 000EA641D7A1
VENDOR foundry
Here is an example floating license key for a machine called red with System
ID 000EA641D7A1 that serves 2 floating Mari licenses onto the network:
HOST red 000EA641D7A1 4101
ISV foundry
LICENSE foundry mari_i 2010.1231 permanent 2 share=h start=6-oct-
2010 issued=6-oct-2010 _ck=fad7306732
sig="60Q04580SBD4AEEY4C93A1K0H718JRY9DWGP1HWR08AG1CY16HPHCKKQ44FD
KGYQKE0BXKGRJ3WBT"
If you are then sent an Ocula license key for the same machine, just add the
LICENSE lines to your existing file, ignoring any HOST or ISV lines, so that it
would look like this:
HOST red 000EA641D7A1 4101
ISV foundry
LICENSE foundry mari_i 2010.1231 permanent 2 share=h start=6-oct-
2010 issued=6-oct-2010 _ck=fad7306732
sig="60Q04580SBD4AEEY4C93A1K0H718JRY9DWGP1HWR08AG1CY16HPHCKKQ44FD
KGYQKE0BXKGRJ3WBT"
LICENSE foundry ocula_nuke_i 3.0 permanent 2 share=h start=6-oct-
2010 issued=6-oct-2010 _ck=72d73079d7
sig="60PG4512DMXC338XEG3F0XBNPFREB6SHHD0QXA822M09MNJUB3E9VQUXKJP6
9DJ5CYR27AUYFRS0"
OR,
The <server_name> If you requested a floating license key but didn’t tell us the hostname of
Variable your license server, then we will have given you a license key with
<server_name> in the first line. You need to replace the text
<server_name> with the name of your license server (if you use the Foundry
License Utility, it does this for you).
Replace Licenses You may see the word SUPERSEDE in your FLEXlm license file or replace in
your RLM license file. These flags are used in conjunction with the ISSUED
(FLEXlm) and issued (RLM) flags to roll together multiple licenses.
Similarly, in the following RLM license for Mari, the replace flag forces RLM
to ignore any mari_i licenses with an issued date older than 1st December
2013.
HOST red 2c4138a7d9ba 4101
ISV foundry
Which RLM Port? Although the default port used by RLM is 5053, The Foundry has opted to
use port 4101 for all its licenses to ensure there are no conflicts with any
other RLM license servers that may be running on the server.
Managing the
License Server
Starting the License The License Server starts automatically when you reboot your machine, but
Server you can start it manually:
• On Windows and Mac OS X, launch the Foundry License Utility (FLU), go
to the FLEXlm Server or RLM Server tab, and click Start Server.
Tip You can also use the FLU from a DOS shell on Windows or a Terminal on Mac OS X.
• On Linux, launch a shell, navigate to where you saved the Foundry
License Utility (FLU), and enter one of the following commands:
./FoundryLicenseUtility -s start -t FLEXlm
./FoundryLicenseUtility -s start -t RLM
• On all platforms, if your product uses RLM licensing, you can also use a
web browser to navigate to the http://<server_name>:4102 server page.
For example, http://red:4102. Click the Status button, and click Start on
the Foundry License Server.
Note On Mac OS X, if you’re browsing from the License Server itself, you must add .local
in the browser address: http://<server_name>.local:4102.
Viewing the License You can view the license server log even if you don’t have administrator
Server Log privileges. To do so:
• On Windows and Mac OS X, launch the Foundry License Utility (FLU), go
to the FLEXlm Server or RLM Server tab, and click Refresh Log.
Tip You can also use the FLU from a DOS shell on Windows or a Terminal on Mac OS X.
• On Linux, launch a shell, navigate to where you saved the Foundry
License Utility (FLU), and enter:
./FoundryLicenseUtility -s status
This reports the status of both FLEXlm and RLM servers. If you only want
to view one or the other, use one of the following commands instead:
./FoundryLicenseUtility -s status -t FLEXlm
./FoundryLicenseUtility -s status -t RLM
• On all platforms, if your product uses RLM licensing, you can also use a
web browser to navigate to the http://<server_name>:4102 server page
and click the Status button.
Note On Mac OS X, if you’re browsing from the License Server itself, you must add .local
in the browser address: http://<server_name>.local:4102.
RLM Web Server The RLM web server also allows you to:
• retrieve server and license status (similar to rlmstat)
• cause the servers to re-read the license files (rlmreread)
• switch debug (rlmswitch) or report log (rlmswitchr) files
Using this web-based interface, you can administer the license server from
any platform, and you do not need to install the RLM utilities - you only
need a web browser.
• Main Status—if you select Status from the menu on the left, the main
status screen is displayed in the view area as shown below.
• License Status—if you click on the usage... button in the Show License
Usage column above, you see the license status screen, as shown below.
Useful Commands for Type all these commands from the The Foundry FLEXlm or RLM applications
System directory on the server.
Administrators
See Application files on page 46 for a description of the <app path>
variable, and Data files on page 46 for a description of <data path>.
I’m using The Foundry software on machine "blue". Which licenses is the
license server "red" offering?
<app path>/lmutil lmstat -c <port>@red -a
<app path>/rlmutil rlmstat -c <port>@red -a
What’s my <server_name>?
<app path>/lmutil lmhostid -hostname
<app path>/rlmutil rlmhostid host
I’ve been given a new floating license key which I’ve edited into my license
file, but it has not been picked up by the server. What do I do?
• On Windows and Mac OS X, launch the Foundry License Utility, go to one
of the Server tabs, and use the Reread Server button.
• Alternatively, use one of the following commands:
<app path>/lmutil lmreread -c <data path>
<app path>/lmutil rlmreread -c <data path>
• If your product uses RLM licensing, you can also use a web browser to go
to http://<server name>:4102 and click Reread/Restart Servers. Enter
the server name you want to reread and click Reread/Restart.
Mac OS X Only If you’re browsing from the License Server itself, you must add .local in the browser
address: http://<server_name>.local:4102.
My default debug log file (foundry.log) is too big. How do I start a new one
called october.log without interrupting the lmgrd or rlm.foundry daemon?
<app path>/lmutil lmswitch -c <data path> foundry october.log
<app path>/rlmutil rlmswitch foundry october.log
Removing FLT
On Windows To stop the Foundry License Server and remove FLT from your machine,
from the Start menu go to All Programs > The Foundry > FLT 7.0v2 >
Uninstall FLT 7.0v2.
On Mac OS X To stop the Foundry License Server and remove FLT from your machine, run
the FLT Uninstaller script from a terminal with root or sudo permissions:
/Applications/TheFoundry/LicensingTools7.0/uninstall.sh
On Linux To stop the Foundry License Server and remove FLT from your machine, run
the script:
/usr/local/foundry/LicensingTools7.0/uninstall.sh
More Information This user guide should cover all the information you need to use FLEXlm or
RLM licenses for The Foundry products. However, it is not meant to be an
exhaustive exploration of all the features available with FLEXlm or RLM
licensing. For that, you should:
• see the FLEXnet Licensing End User Guide included in the Foundry
Licensing Tools download or go to www.flexerasoftware.com.
• see the RLM Licensing End User Guide included in the Foundry Licensing
Tools download or go to www.reprisesoftware.com.
Please be aware that advanced RLM features not discussed in this user
guide are not supported with RLM licenses from The Foundry.
There are many reasons why your license key may fail to work. This section
is here to guide you through some common problems and how to fix them.
Note The Foundry Licensing Tools’ default settings do not support RLM licensing on
virtual machines (VMs). If you have any questions regarding licensing on VMs,
please contact support@thefoundry.co.uk for more information.
The Solution
This could be any number of things, but if everything is set up correctly, it
could be the firewall on the server blocking perfectly legitimate requests
from the client. In order to fix this, you need to specify ports for your
servers and allow these to be open.
• If you’re on Windows, see Windows on page 62.
• If you’re on Mac OS X, see Mac OS X on page 71.
• If you’re on Linux, consult your system administrator.
Windows Two methods are discussed, though the method differs between Windows
XP and Windows 7. The first method uses programs and the second uses
port numbers to enable client machines to checkout licenses and connect to
the web service in the RLM License Server.
Next, go to your firewall settings and add an exception for TCP ports with
the port number in the VENDOR or ISV line and for the port number in the
SERVER or HOST line:
1. Navigate to Control Panel > Windows Firewall.
3. In the Name field, type Foundry FLEXlm Server or Foundry License Server
(this can be any name you like) and enter the port number specified in the
VENDOR or ISV line of the license file.
2. Select Inbound Rules in the left-hand panel and click New Rule as shown
below.
7. Click Next.
8. Enter a meaningful name for the rule, such as FLEX_SERVER or
RLM_HOST.
9. Click Finish to complete the process.
10. Stop and Start the license server as described in Managing the License
Server.
USE_SERVER
Note You may want to check with your system administrator that the port number you
choose is not already in use by another program.
Next, on the license server, go to your firewall settings and add Inbound
Rules for TCP ports with the port numbers in the SERVER and VENDOR
lines.
1. From the Windows Start menu, click Control Panel > All Control Panel
Items > Windows Firewall and then click on the Advanced settings link.
2. Select Inbound Rules in the left-hand panel and click New Rule as shown
below.
4. Select TCP and Specific local ports and enter the port number in the field
provided, 30001 in the example.
5. Click Next.
6. Select Allow the connection and click Next.
7. Select when the new rule should be applied using the checkboxes. In the
example, the rule is applied at all times, but you can modify this as
required.
8. Click Next.
9. Enter a meaningful name for the new rule, for example FLEXlm_SERVER,
and write a description, if required.
10. Click Finish.
11. Select the new rule from the Inbound Rules list and click Properties.
12. Click the Programs and Services tab, select This program, and browse to
<app path>/lmgrd.foundry.exe as shown.
15. Repeat steps 2 through 14 for the VENDOR port, replacing the port
number, and the program in step 12 with <app path>/foundry.exe.
16. Stop and Start the license server as described in Managing the License
Server.
If you installed an RLM license using the FLU, the options file was created
automatically in the same directory as your license. If, however, you
installed your license manually, create a plain text file called foundry.opt in
the same directory as the license. See Where are the FLEXlm and RLM Files?
for the license file location.
A typical RLM licence including port numbers and an options file might look
like this:
HOST red 000ea641d7a1 4101
ISV foundry OPTIONS=foundry.opt PORT=12345
Note You may want to check with your system administrator that the port number you
choose is not already in use by another program.
After editing the license and options file, stop and start the license server
as described in Managing the License Server. In the license server interface,
click Status and check that the ports specified are listed and that the server
is running, as shown below:
Next, go to your firewall settings and add Inbound Rules for TCP ports with
the port numbers in the HOST and ISV lines.
1. From the Windows Start menu, click Control Panel > All Control Panel
Items > Windows Firewall and then click on the Advanced settings link.
2. Select Inbound Rules in the left-hand panel and click New Rule as shown
below.
8. Click Next.
9. Enter a meaningful name for the new rule, for example RLM_HOST, and
write a description, if required.
10. Click Finish.
11. Select the new rule from the Inbound Rules list and click Properties.
12. Click the Programs and Services tab, select This program, and browse to
<app path>/rlm.foundry.exe as shown.
15. Repeat steps 2 through 11 for the ISV port, replacing the port number
and rule name.
16. Click the Programs and Services tab, select All programs that meet the
specified conditions.
17. Click OK to close the dialog.
Mac OS X You need to adjust your firewall settings. How to do this depends on your
firewall and the version of Mac OS X you are running, but here’s how to do
it on Mac OS X 10.6 (Snow Leopard):
1. Launch System Preferences.
Windows 7 Hidden By default, on Windows 7, the C:/ProgramData directory is hidden. You can
Files make it visible by double clicking on Control Panel > Folder Options and
then selecting Show hidden files and folders.
Figure 23. Control Panel - Folder Figure 24. Switch on Show hidden
Options. files and folders.
FLU Reporting For most machines the FLEXlm System ID and RLM System ID are the same,
More Than One so the FLU displays a single System ID. However, on rare occasions, two
System IDs are reported (one for FLEXlm and one for RLM). If this is the
System ID case, both System IDs are displayed, like this:
Raaaaaaaaaaaa:Xbbbbbbbbbbbb
If the FLU returns two System IDs for your machine, the one that you need
to use depends on which software you are running:
• For FLEXlm licensed software you need to use the second System ID
minus the X, bbbbbbbbbbbb in the example.
• For RLM licensed software you need to use the first System ID minus the
R, aaaaaaaaaaaa in the example.
For a full list of The Foundry products and which licensing software they
use, click here.
Node Locked and If you have a node locked license in a client license file that is pointing to
Client Licenses the server for its licenses, the node locked license won’t work. Use separate
files for the node locked license (foundry.lic) and client license
(foundry_client.lic). For example, this Mari RLM license won’t work in this file
that is looking on “red” for its licenses.
HOST red 000EA641D7A1 4101
ISV foundry
LICENSE foundry mari_i 2011.1006 permanent uncounted
hostid=000ea641d7a1 share=h start=6-oct-2010 issued=6-oct-
2010 _ck=fbf430af8c
sig="60PG4515BFTJCYAXSYJ6GTUJ3B9NRRGF3VUUKD022M0BXU48SSESUG
SAFJ8BAD5BN883526ETKQ0"
The Solution
Due to Mac OS X system architecture, you must add .local to the URL
address when you’re browsing from the License Server itself:
http://<server_name>.local:4102
Note You can use this address on other platforms, but it’s not necessary.
Contacting Support If you have flicked through this user guide and haven’t found the answer to
your question, then please:
1. See the frequently asked questions at www.thefoundry.co.uk/support/
faqs/.
2. Run the Foundry License Utility’s diagnostics tool in GUI mode (Windows
and Mac) or from the command line (Windows, Mac, and Linux). This gives
you a text file that you can send to support for assistance. See Using the
Diagnostics Tool in GUI Mode or Using the Diagnostics Tool in Command
Line Mode below.
3. Contact our support team on support@thefoundry.co.uk.
Using the Diagnostics 1. Launch a DOS shell (Windows), a Terminal (Mac), or a shell (Linux).
Tool in Command Line 2. Navigate to the directory where you have saved the Foundry License
Mode Utility (FLU).
3. Enter one of the following commands.
Windows
FLU_7.0v2_win-x86-release-32.exe -d
Mac OS X
./FoundryLicenseUtility.app/Contents/MacOS/
FoundryLicenseUtility -d
Linux
./FoundryLicenseUtility -d
This gathers lots of information on your machine that helps us diagnose
the problem. No personal information is gathered.
4. The tool prompts you to save a out a text file that you can e-mail to
support@thefoundry.co.uk. To do so, enter Y.
Tip By default, the file is saved to your home directory and given an automated file
name. If you’d like to specify a different directory and name, use -f <path> instead,
for example on Windows:
FLU_7.0v2_win-x86-release-32.exe -f C:\Temp\log.txt
FLT 7.0v2 This is a maintenance release of FLT, with feature enhancements and
several bug fixes.
Release Date
October 2012
System Requirements
• Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion), 64-bit only
• Linux RHEL 5.4, 32-bit or 64-bit
• Windows XP or Windows 7, 32-bit or 64-bit
Note Other operating systems are likely to work.
New Features
There are no new features in this release.
Feature Enhancements
• Linux 64-bit only: The RLM server limit on client connections has been
increased to 32,000.
• BUG ID 26534 - Generated log output from failed license installs has
been improved to help diagnose issues.
• BUG ID 26911 - The FLT installer now lists any files that exist on a
target machine that are blocking installation, such as previous FLT
versions.
• BUG ID 30524 - If a license with an invalid ID is supplied, the FLU now
reports the expected ID in the error report.
• BUG ID 30527 - The FLU now displays details of how to proceed if more
than one System ID is found.
Fixed Bugs
• BUG ID 26331/26920 - It was not possible to copy, cut, or paste from
the FLU installation window using keyboard shortcuts or the right-click
menu.
APPENDIX A: RELEASE NOTES 76
FLT 7.0v2
FLT 7.0v1 This is a major new release of FLT, with several new features and feature
enhancements.
Release Date
May 2012
System Requirements
• Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion), 64-bit only
• Linux RHEL 5.4, 32-bit or 64-bit
• Windows XP or Windows 7, 32-bit or 64-bit
Note Other operating systems are likely to work.
New Features
• All functionality previously split between FLT 6.0 and FFT 5.0 is now
included in FLT 7.0.
• The Foundry License Utility (FLU) merges all previous utility applications
into one. The FLU is fully backwards compatible, and you can use it to
manage existing license servers.
• Both FLEXlm and RLM servers are now installed as one.
Feature Enhancements
• Enhanced license installation reporting.
• Improved diagnostics reporting.
• There is now a command line interface for all operating systems.
• The server log is displayed in the FLU interface and on the command line.
Fixed Bugs
There are no fixed bugs in this release.
FLT 6.0v4 This is the fourth release of the Foundry Licensing Tools (FLT) addressing
issues that arose during previous builds.
Release Date
October 2011
System Requirements
• Mac OS X (10.5 (Leopard) and 10.6 (Snow Leopard))
• Linux Centos 4.5 (32-bit or 64-bit)
• Windows XP or Windows 7
Note Other operating systems are likely to work.
New Features
There are no new features in this release.
Feature Enhancements
There are no feature enhancements in this release.
Fixed Bugs
• The installer failed to install the RLM License Server on Mac OS 10.7
(Lion). While this bug has been resolved, Mac OS 10.7 (Lion) is not yet
fully supported.
• Linux 64-bit: The license server was unable to cope with more than 1000
simultaneous license checkouts.
• Linux: The default file descriptor limit has been increased to 10240 in
the foundryrlmserver start up script.
FLT 6.0v3 This is the third release of the Foundry Licensing Tools (FLT) addressing
issues that arose during previous builds.
Release Date
November 2010
System Requirements
• Mac OS X (10.5 (Leopard) and 10.6 (Snow Leopard))
• Linux Centos 4.5 (32-bit or 64-bit)
• Windows XP or Windows 7.
Note Other operating systems are likely to work.
New Features
There are no new features in this release.
Feature Enhancements
There are no feature enhancements in this release.
Fixed Bugs
• The default RLM Web Server (5054) and Foundry License Server (5053)
ports could cause issues at startup with other servers present on the
network.
To avoid conflicts with other servers that may be present:
• The default RLM Web Server port has changed to 4102.
• The default Foundry License Server port has changed to 4101.
• Setting the foundry_LICENSE_LOG environment variable was being
ignored.
• The Foundry License Diagnostic Tool was not correctly determining the
status of the server on Linux.
• The Foundry License Diagnostic Tool was not correctly diagnosing client
license file issues.
FLT 6.0v2 This was an internal build of the Foundry Licensing Tools (FLT).
Release Date
November 2010
System Requirements
• Mac OS X (10.5 (Leopard) and 10.6 (Snow Leopard))
• Linux Centos 4.5 (32-bit or 64-bit)
• Windows XP or Windows 7.
Note Other operating systems are likely to work.
New Features
There are no new features in this release.
Feature Enhancements
There are no feature enhancements in this release.
Fixed Bugs
This section will contain descriptions of fixed bugs in future releases.
FLT 6.0v1 This is the first release of the Foundry Licensing Tools (FLT).
Release Date
November 2010
System Requirements
• Mac OS X (10.5 (Leopard) and 10.6 (Snow Leopard))
• Linux Centos 4.5 (32-bit or 64-bit)
• Windows XP or Windows 7.
Note Other operating systems are likely to work.
New Features
This section will contain descriptions of new features in future releases.
Feature Enhancements
This section will contain descriptions of feature enhancements in future
releases.
Fixed Bugs
This section will contain descriptions of fixed bugs in future releases.
Node Locked
License Syntax
foundry—the vendor name. All licenses from The Foundry must contain the
vendor name foundry.
5-jul-2012—the date when the license expires. If this says permanent, the
license never expires.
HOSTID—also known as the System ID, this is the ethernet (mac) address of
the machine to be licensed.
ISSUED=5-jun-2012—the day the license was made, which may differ from
the license start date.
foundry—the vendor name. All licenses from The Foundry must contain the
vendor name foundry.
For non-maintenance products, this is often just the version of the product,
for example 3.0.
hostid—also known as the System ID, this is the ethernet (mac) address of
the machine to be licensed.
share—this indicates how multiple checkouts from the same client machine
are treated. share=h indicates licenses are shared by the same host.
issued—the day the license was made, which may differ from the license
start date.
Floating License
Syntax
Floating licenses are broken down into a SERVER line, a VENDOR line and
one or more INCREMENT lines:
SERVER. The server line indicates which server may serve the floating
licenses in this license file:
• <server name>, also known as the hostname, is the name of the license
server, for example red.
• <FLEXlm system ID>, also known as lmhostid or the System ID, is a
unique number for that machine.
• <server port> is the user-defined server port number over which
requests from the client are made to the lmgrd daemon.
VENDOR. The vendor line indicates which vendor made the license. The
vendor line helps decode the license line for The Foundry's specific licensing
keys and identify the vendor licensing daemon.
• OPTIONS=<file> is the plain text file that controls the behavior of the
server. Specifying an options file in the license is optional.
• PORT=<vendor port> is the user-defined port over which the vendor
daemon communicates to the client. If left blank, a port number is picked
for you.
Note The server port number and the vendor port number MUST be different.
INCREMENT - license feature line. The only difference from a node locked
license is that uncounted is replaced with the number of available floating
licenses.
Floating licenses are broken down into a HOST line, an ISV line, and one or
more LICENSE lines:
HOST—The host line indicates which server may provide the floating
licenses in the license file.
• <server_name>, also known as the hostname, is the name of the license
server, for example red.
• <server host id>, also known as the rlmhostid or System ID, is a unique
number for that machine.
• <port> is the user-defined server port number over which requests from
the client are made to the RLM daemon.
ISV—The ISV line indicates which vendor made the license. The vendor line
helps decode the license line for The Foundry's specific licensing keys and
identify the vendor licensing daemon.
• <options file> is the plain text file that controls the behavior of the
server. Specifying an options file in the license is optional.
• <port> is the user-defined port over which the vendor daemon
communicates to the client. If left blank the port number is picked for
you.
Note The host port number and the ISV port number MUST be different, and remember to
avoid port 4102 which is reserved for the web server.
The above license works on any 10 hosts simultaneously. It licenses all Mari
releases built before 6 October 2012 and it begins 6 October 2012.
Client License
Syntax
FLEXlm Client FLEXlm licenses typically have just three lines, which may be:
SERVER <server name> <server host id> <port number>
VENDOR foundry
USE_SERVER
or
SERVER <server_name> any <port number>
VENDOR foundry
USE_SERVER
RLM Client RLM licenses typically have just one line, which may be:
HOST <server name> <server host id> <port number>
or
HOST <server name> any <port number>
Environment There are many occasions when you might need to set an environment
Variables FLT variable to tailor the functionality of FLT. The following table lists the
environment variables FLT recognizes.
Recognizes
FLEXlm Environment Variable RLM Environment Variable Description
FOUNDRY_LICENSE_FILE foundry_LICENSE Sets the location of the license
file.
If you move your license file,
you can set this to point to
the new location.
You can also use this to point
client machines to a floating
license on a license server
machine.
FOUNDRY_LICENSE_LOG foundry_LICENSE_LOG Sets the location of the log file
that gets generated if there
are problems with licenses.
FOUNDRY_HEARTBEAT_DISAB foundry_HEARTBEAT By default, floating licenses
LE _DISABLE are given back to the server
only if the product exits or is
deleted/unloaded from the cli-
ent. If you want your license
to go back to the server if you
don’t use it for a while, you
can set this environment vari-
able to true.
If you disable the heartbeat,
you must also set a TIMEOUT
value in the options file, so
that licenses are returned to
the server correctly. See
page 51.
Note: The heartbeat ensures
the communication between
the server and client persists
in a stable fashion and there-
fore should be disabled with
caution, otherwise users may
find their licenses being with-
drawn unexpectedly.
APPENDIX C: ENVIRONMENT VARIABLES 88
Setting Environment Variables
Setting Of course, how you set environment variables differs for each operating
Environment system. Here’s a brief guide if you can’t find your systems administrator.
Variables
Important In the following examples, we describe setting an environment variable for an RLM-
based license. This is done using the environment variable foundry_LICENSE;
however, if your product uses FLEXlm licensing, the environment variable you need
to set is FOUNDRY_LICENSE_FILE. All other steps are exactly the same.
Windows XP 1. Launch the Control Panel from the Start menu and double-click on the
System icon (Figure 25).
Windows 7 Environment variables are set in the same way as Windows XP but, of
course, Microsoft have moved things about and it’s prettier. Here are some
snapshots though.
Mac OS X You can easily set an environment variable that is active in one terminal
only:
1. The procedure for setting an environment variable depends on what your
default shell is. To get the name of the shell you are using, launch a ter-
minal (Applications > Utilities > Terminal) and enter:
echo $SHELL.
2. Depending on the output of the previous step, do one of the following:
• If your shell is a csh or tcsh shell, enter:
setenv foundry_LICENSE /tmp/foundry.lic
• If your shell is a bash or ksh shell, enter:
export foundry_LICENSE=/tmp/foundry.lic
You then need to run the product from the same terminal that you used to
set the environment variable. If you open another terminal, this environment
variable is not set in that terminal unless you type it in there too.
For a more permanent solution, you can set an environment variable for all
processes launched by a specific user by creating an environment file in the
user’s home directory:
~/.MacOSX/environment.plist
Note The tilde ( ~ ) represents the home directory of the target user, and the command is
case sensitive, so take care to copy the string exactly.
You have to create the .MacOSX directory yourself using a terminal (by
typing mkdir .MacOSX in your home directory). You also have to create the
Linux 1. The procedure for setting an environment variable depends on what your
default shell is. To get the name of the shell you are using, launch a shell
and enter:
echo $SHELL.
2. Depending on the output of the previous step, do one of the following:
• If your shell is a csh or tcsh shell, enter:
setenv foundry_LICENSE /tmp/foundry.lic
• If your shell is a bash or ksh shell, enter:
export foundry_LICENSE=/tmp/foundry.lic
3. You then need to run the product from the same terminal that you used
to set the environment variable. If you open another terminal, this
environment variable is not set in that terminal unless you type it in
there too.
4. To make this permanent for any shell launched, you can edit your
.cshrc, .tcshrc, .bashrc, or .kshrc file in your home directory.
5. If you want it to be system wide, then /etc/profile can be used
(or /etc/environment on some flavors of Linux).
This END USER LICENSE AGREEMENT (this "Agreement") is made by and between The Foundry
Visionmongers Ltd., a company registered in England and Wales, ("The Foundry"), and you, as either an
individual or a single entity ("Licensee").
In consideration of the mutual covenants contained herein and for other good and valuable consideration
(the receipt and sufficiency of which is acknowledged by each party hereto) the parties agree as follows:
Licensee shall install and use only a single copy of the Software on one computer, unless the Software is
installed in a "floating license" environment, in which case Licensee may install the Software on more than
APPENDIX D: END USER LICENSE AGREEMENT 92
End User License Agreement (EULA)
one computer; provided, however, Licensee shall not at any one time use more copies of the Software than
the total number of valid Software licenses purchased by Licensee.
Please note that in order to guard against unlicensed use of the Software a licence key is required to
access and enable the Software. The issuing of replacement or substituted licence keys if the Software is
moved from one computer to another is subject to and strictly in accordance with The Foundry’s Licence
Transfer Policy, which is available on The Foundry’s website and which requires a fee to be paid in certain
circumstances. The Foundry may from time to time and at its sole discretion vary the terms and conditions
of the Licence Transfer Policy.
Furthermore, if the Software can be licensed on an "interactive" or "non-interactive" basis, licensee shall be
authorized to use a non-interactive version of the Software for rendering purposes only (i.e., on a CPU,
without a user, in a non-interactive capacity) and shall not use such Software on workstations or
otherwise in a user-interactive capacity. Licensee shall be authorized to use an interactive version of the
Software for both interactive and non-interactive rendering purposes, if available.
If Licensee has purchased the Software on the discount terms offered by The Foundry’s Educational Policy
published on its website (“the Educational Policy”), Licensee warrants and represents to The Foundry as a
condition of this Agreement that: (a) (if Licensee is an individual) he or she is a part-time or full-time
student at the time of purchase and will not use the Software for commercial, professional or for-profit
purposes; (b) (if the Licensee is not an individual) it is an organisation that will use it only for the purpose
of training and instruction, and for no other purpose (c) Licensee will at all times comply with the
Educational Policy (as such policy may be amended from time to time).
Finally, if the Software is a "Personal Learning Edition," (“PLE”) Licensee may use it only for the purpose of
personal or internal training and instruction, and for no other purpose. PLE versions of the Software may
not be used for commercial, professional or for-profit purposes including, for the avoidance of doubt, the
purpose of providing training or instruction to third parties.
notwithstanding any other term of this Agreement The Foundry shall have no obligation to provide
support, maintenance, upgrades or updates of or in respect of the Source Code or of any Modification; and
(e) Licensee shall indemnify The Foundry against all liabilities and expenses (including reasonable legal
costs) incurred by The Foundry in relation to any claim asserting that any Modification infringes the
intellectual property rights of any third party.
SECTION 5. OWNERSHIP.
Licensee acknowledges that the Software (including, for the avoidance of doubt, any Source Code that is
licensed to Licensee) and Documentation and all intellectual property rights and other proprietary rights
relating thereto are and shall remain the sole property of The Foundry and the Third Party Licensors.
Licensee shall not remove, or allow the removal of, any copyright or other proprietary rights notice
included in and on the Software or Documentation or take any other action that could adversely affect the
property rights of The Foundry or any Third Party Licensor. To the extent that Licensee is authorized to
make copies of the Software or Documentation under this Agreement, Licensee shall reproduce in and on
all such copies any copyright and/or other proprietary rights notices provided in and on the materials
supplied by The Foundry hereunder. Nothing in this Agreement shall be deemed to give Licensee any rights
in the trademarks, service marks, patents, trade secrets, confidential information, copyrights or other
intellectual property rights of The Foundry or any Third Party Licensor, and Licensee shall be strictly
prohibited from using the name, trademarks or service marks of The Foundry or any Third Party Licensor in
Licensee's promotion or publicity without The Foundry's express written approval.
SECTION 7. UPGRADES/ENHANCEMENTS.
The Licensee's access to support, upgrades and updates is subject to the terms and conditions of the
"Annual Upgrade and Support Programme” available on The Foundry's website. The Foundry may from time
to time and at its sole discretion vary the terms and conditions of the Annual Upgrade and Support
Programme.
PURPOSE. No action arising out of or related to this Agreement, regardless of form, may be brought by
Licensee more than one (1) year after Licensee's initial receipt of the Software; provided, however, to the
extent such one (1) year limit may not be valid under applicable law, then such period shall be limited to
the shortest period allowed by law.
The Foundry and Licensee intend that each Third Party Licensor may enforce against Licensee under the
Contracts (Rights of Third Parties) Act 1999 ("the Act") any obligation owed by Licensee to The Foundry
under this Agreement that is capable of application to any proprietary or other right of that Third Party
Licensor in or in relation to the Software. The Foundry and Licensee reserve the right under section 2(3)(a)
of the Act to rescind, terminate or vary this Agreement without the consent of any Third Party Licensor.
Copyright © 2012 The Foundry Visionmongers Ltd. All Rights Reserved. Do not duplicate.