Foundry FLEXlm Tools User Guide

40 pages
0 downs
6 views

Extension: PDF

Please download to get full document.

View again

of 40
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Share
Description
The Foundry Tinder Box1 The Foundry Plug-in Visual Effects Foundry FLEXlm Tools User Guide Tinder Box1 The Foundry Plug-in Visual Effects The Foundry ©2006 The…
Transcript
The Foundry Tinder Box1 The Foundry Plug-in Visual Effects Foundry FLEXlm Tools User Guide Tinder Box1 The Foundry Plug-in Visual Effects The Foundry ©2006 The Foundry Visionmongers Ltd. All rights reserved. Foundry FLEXlm Tools 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. After Effects® is a registered trademark of Adobe Systems, Inc. All other products or brands are trademarks or registered trademarks of their respective companies or organisations. Software engineering Andy Whitmore. Product testing Jack Binks, Rob Elphick, Jonathan Barson. Writing and layout design Jonathan Barson using Adobe FrameMaker. The Foundry Tinder Box1 iii The Foundry Foundry FLEXlm Tools Contents Introduction Further Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Watermarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Node Locked Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Floating Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Getting Started Installing Node Locked Licenses . . . . . . . . . . . . . . . . . . . . . . 9 Installing Floating Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Using FLEXlm Where are the FLEXlm files? . . . . . . . . . . . . . . . . . . . . . . . . . 16 Moving the FLEXlm files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Starting the FLEXlm License Server . . . . . . . . . . . . . . . . . . . 17 Stopping the FLEXlm License Server . . . . . . . . . . . . . . . . . . 17 lmhostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Adding a License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Useful Commands for System Admins. . . . . . . . . . . . . . . . . 19 Licensing Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 The Options File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 The Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Upgrade Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Redundant License Servers . . . . . . . . . . . . . . . . . . . . . . . . . 25 Uncounted License Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . 28 Counted License Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 When is a license taken or dropped?. . . . . . . . . . . . . . . . . 30 Appendix A Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Index A-Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Tinder Box1 The Foundry iv Foundry FLEXlm Tools The Foundry Further Information The Foundry Tinder Box1 INTRODUCTION 5 The Foundry Foundry FLEXlm Tools Introduction This user guide is for both end users and system administrators. It is designed to help you license Foundry products built with FLEXlm and manage those licenses. Foundry products built before October 2005 were licensed using our own encryption software. For information on how to license these products please refer to the Foundry License Manager (FLM) User Guide on our web site. More recent products use FLEXlm as the encryption software. This user guide (Foundry FLEXlm Tools) is designed to help you license and manage those products. The release notes for any Foundry product will tell you which license encryption software has been used. Further Information This FFT4.0v8.pdf licensing guide is written to get your Foundry products licensed quickly and answer common licensing questions. It is not meant to be an exhaustive exploration of FLEXnet/FLEXlm. For that you should read the FLEXnet Licensing End User Guide that is included in the Foundry FLEXlm Tools download. For further information see Macrovision’s web site www.macrovision.com INTRODUCTION Tinder Box1 The Foundry 6 Notation Foundry FLEXlm Tools The Foundry Notation Throughout this guide we will refer to machines that serve FLEXlm licenses as servers and machines used for compositing that request licenses as clients. Watermarks All our products (Tinder, Furnace, Keylight, Anvil, etc.) can be installed without a software license key. Without a software license key diagnostic information is displayed either in the rendered image or on a popup window. It is also written out to a log file (see “The Log Files” on page 23) for those of you running background render jobs. Figure 1 shows the Shake user interface with an unlicensed Furnace plug-in. Note the black image and popup dialog. Figure 1. Unlicensed Furnace in Shake. Node Locked Licenses The Foundry Tinder Box1 INTRODUCTION 7 The Foundry Foundry FLEXlm Tools Node Locked Licenses A node locked license will enable one of our products to work on one particular machine. It is locked to a unique number on that machine (See “lmhostid” on page 17.). Node locked licenses do not require additional licensing software to be installed. In particular you do not need a FLEXlm daemon running. You just need the plug-ins and a text file containing the license string. Node locked licenses are the easiest to set up. Node locked licenses are sometimes called uncounted licenses. An uncounted license looks like this: INCREMENT furnace_shake_i foundry 1.1 05-jul-2005 \ uncounted HOSTID=000ea641d7a1 START=8-feb-2006 \ SIGN="03C7 5A34 BDE8\ D421 6C2B 8111 8151 972A 14E2 C143 4C00 741F 730D\ 784A D392 B1D9 9C3F 03FC DB2A E432 5EA7" For information on installing licenses see “Installing Node Locked Licenses” on page 9. For further information about the structure of the license key see “Uncounted License Syntax” on page 28. Floating Licenses A floating license running on a server will enable one of our products to work on any networked client machine. The floating license should be put on the server and is locked to a unique number on that server (See “lmhostid” on page 17.). Floating licenses on a server require additional software to be installed. This software manages those licenses on the server, giving licenses out to client INTRODUCTION Tinder Box1 The Foundry 8 Floating Licenses Foundry FLEXlm Tools The Foundry stations that want them. The software you need to manage these licenses is called the Foundry FLEXlm Tools (FFT) which can be freely downloaded from our web site. Floating licenses often declare a port number on the server line. This is required if you have an internet firewall on your license server so that you can permit license communication while blocking others. Floating licenses are sometimes called counted licenses. A counted license looks like this. SERVER <server_name> 000EA641D7A1 <port> VENDOR foundry options=/usr/local/foundry/FLEXlm/ foundry.opt INCREMENT tinder_shake_i foundry 3.0 05-jul-2005 5 \ START=8-feb-2006 SIGN="00FF 6A1B 735B A476 2069 \ 0A10 6894 4903 E2CF A238 7A01 1A15 1808 7BCF 346C \ F59E 8899 F53C 2B13 E204 C7FD" For information on installing licenses see “Installing Floating Licenses” on page 9. For further information about the structure of the license key see “Counted License Syntax” on page 29. Floating License Behaviour Floating licenses are taken from the server when the plug- in on the client is first used. By default, the license is given back to the server only if the plug-in is deleted/unloaded from the compositing application or when the application is quit, however, this behaviour can be changed. See “Disabling the Heartbeat” on page 31. Installing Node Locked Licenses The Foundry Tinder Box1 GETTING STARTED 9 The Foundry Foundry FLEXlm Tools Getting Started Installing Node Locked Licenses If you are using a node locked license you just need the license key in a text file and the plug-ins. No other software is required. You do not need a FLEXlm daemon running. You do not need to install the Foundry FLEXlm Tools. The license key goes in any text file with a .lic file extension in the Foundry FLEXlm directory. This location varies depending on the operating system you are using, and is as follows: On Mac OS X, Linux and Irix: /usr/local/foundry/FLEXlm/foundry.lic On Windows: C:\Program Files\The Foundry\FLEXlm\foundry.lic Note You will need to create these directories and files if they do not exist on your machine. You may need to be root or have administrator priviledges to do this. Tinderbox Licenses For Tinderbox licenses, if you prefer, you can put your node locked license key in the same directory as your Tinderbox plug-ins. Installing Floating Licenses The Foundry FLEXlm Tools are supplied for Windows, Linux, Mac OS X and Irix. To manage floating licenses GETTING STARTED Tinder Box1 The Foundry 10 Installing Floating Licenses Foundry FLEXlm Tools The Foundry across a network you have to install the Foundry FLEXlm Tools on a license server together with your floating license key(s). FLEXlm Components These are the FLEXlm components that we ship. foundry - vendor daemon lmgrd - FLEXlm license manager lmutil - FLEXlm utilities application foundry.lic - example license file foundry.opt - example options file FoundryFLEXlmServer - shell startup script (Mac OS X) StartupParameters.plist - startup options file (Mac OS X) FFT4.0v8.pdf - this user guide flexnet_licensing_end_user_guide.pdf - Macrovision’s documentation for end users. Windows Follow these instructions to install floating license software for a Windows machine. For node locked licenses see “Node Locked Licenses” on page 7. Download FFT4.0v8_win32-i386.zip from our web site and put it in C:\Program Files\The Foundry on your license server. Unzip the file to give a directory and rename it to FLEXlm. Start the foundry license server manually. Download FLEXlm Download FFT4.0v8_win32-i386.zip from our web site onto the windows machine you wish to use as a license server. Install FLEXlm Use the windows file browser to go to (or create) C:\Program Files\The Foundry Installing Floating Licenses The Foundry Tinder Box1 GETTING STARTED 11 The Foundry Foundry FLEXlm Tools Move the zip file into this directory and unzip. Rename the FFT4.0v8_win32-i386 directory to FLEXlm Install key If you have a license key from The Foundry you should add this now. It should be called foundry.lic and is a text file. Put it in the directory C:\Program Files\The Foundry\FLEXlm. Start FLEXlm At a command prompt type: cd "C:\Program Files\The Foundry\FLEXlm" install.bat Note If the install fails because you already have a Foundry FLEXlm Server installed you should run remove.bat then try install.bat again. Check FLEXlm Check for errors by running the lmtools programs in C:\Program Files\The Foundry\FLEXlm Firewalls When installing a vendor FLEXlm license server on Windows the firewall can sometimes fail to ask whether to permit or block the vendor’s own vendor licensing daemon and licenses will fail to be issued to clients. To fix this, use the Control Panel - Administrative Tools - Services and stop & restart the vendor’s FLEXlm license server to prompt the firewall into asking whether to permit or block the vendor licensing daemon. When asked, selecting "Permit" is recommended. GETTING STARTED Tinder Box1 The Foundry 12 Installing Floating Licenses Foundry FLEXlm Tools The Foundry Irix Follow these instructions to install floating license software for an SGI Irix machine. For node locked licenses see “Node Locked Licenses” on page 7. Download FFT4.0v8_irix6-mips.tgz from our web site and put it in / usr/local/foundry on your license server. Untar the file to give a directory and rename it to FLEXlm. Copy foundrylmgrd and create a link so that the Foundry FLEXlm daemon starts on a reboot. Start the foundry license server manually. Download FLEXlm Download FFT4.0v8_irix6-mips.tgz from our web site onto the machine you wish to use as a license server. Install FLEXlm Put the contents of the tar file into the recommended directory. mkdir -p /usr/local/foundry cd /usr/local/foundry gunzip FFT4.0v8_irix6-mips.tgz tar xvf FFT4.0v8_irix6-mips.tar mv FFT4.0v8_irix6-mips FLEXlm cd FLEXlm Now make the Foundry FLEXlm daemon start automatically on a reboot. You will need to execute these copy, link and chkconfig commands as root. cp foundrylmgrd /etc/init.d ln -s /etc/init.d/foundrylmgrd /etc/rc2.d/ S98foundrylmgrd chkconfig -f foundrylmgrd on Install key If you have a license key from The Foundry you should add this now. It should be called foundry.lic and is a text file. Put it in the directory /usr/local/foundry/FLEXlm. mv foundry.lic /usr/local/foundry/FLEXlm Installing Floating Licenses The Foundry Tinder Box1 GETTING STARTED 13 The Foundry Foundry FLEXlm Tools Start FLEXlm ./lmgrd -c foundry.lic -l foundry.log Check FLEXlm Check for errors starting the license server. cat /usr/local/foundry/FLEXlm/foundry.log Mac OS X Follow these instructions to install floating license software for a Mac OS X machine. For node locked licenses see “Node Locked Licenses” on page 7. Download FFT4.0v8_macos10-powerpc.tgz from our web site and put it in /usr/local/foundry on your license server. Untar the file to give a directory and rename it to FLEXlm. Create a directory called FoundryFLEXlmServer in the /Library/ StartupItems directory. Start the foundry license server. Download FLEXlm Download FFT4.0v8_macos10-powerpc.tgz from our web site onto the machine you wish to use as a license server. Administrator Priviledges You may need root or administrator priviledges to install FLEXlm. Contact your Systems Administrator. Install FLEXlm Put the contents of the tar file into the recommended directory. Start a Terminal from /Applications/Utilities. In this terminal shell, as root, type the following commands. mkdir -p /usr/local/foundry cd /usr/local/foundry tar xvzf FFT4.0v8_macos10-powerpc.tgz mv FFT4.0v8_macos10-powerpc FLEXlm cd FLEXlm Now make the Foundry FLEXlm daemon start automatically on a reboot. You will need to execute these GETTING STARTED Tinder Box1 The Foundry 14 Installing Floating Licenses Foundry FLEXlm Tools The Foundry commands in a terminal shell as root. mkdir -p /Library/StartupItems/FoundryFLEXlmServer mv FoundryFLEXlmServer /Library/StartupItems/ FoundryFLEXlmServer/ mv StartupParameters.plist /Library/StartupItems/ FoundryFLEXlmServer/ Install key If you have a license key from The Foundry you should add this now. It should be called foundry.lic and is a text file. Put it in the directory /usr/local/foundry/FLEXlm. In a terminal shell as root type the following commands. mv foundry.lic /usr/local/foundry/FLEXlm Start FLEXlm /Library/StartupItems/FoundryFLEXlmServer/ FoundryFLEXlmServer start Check FLEXlm Check for errors starting the license server. cat /usr/local/foundry/FLEXlm/boot.log Linux Follow these instructions to install floating license software for a Linux machine. For node locked licenses see “Node Locked Licenses” on page 7. Download FFT4.0v8_rh9-i386.tgz from our web site and put it in /usr/ local/foundry on your license server. Untar the file to give a directory and rename it to FLEXlm. Copy the foundrylmgrd file to /etc/init.d so that the daemon starts on a reboot. Start the foundry license server. Download FLEXlm Download FFT4.0v8_rh9-i386.tgz from our web site onto the machine you wish to use as a license server.
Related Search
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks