Installation and Licensing
Transcription
Installation and Licensing
Installation and Licensing Legal Notice Autodesk® Maya® 8.5 © Copyright 1997-2007 Autodesk, Inc. ("Autodesk") and/or its licensors. All rights reserved. All user documentation ("User Documentation") and the software product to which the User Documentation pertains (“Software”) contains proprietary and confidential information of Autodesk, Inc., and/or its licensors. The User Documentation and the Software are protected by national and international intellectual property laws and treaties. All rights reserved. Use of the Documentation and the Software is subject to the terms of the software license agreement. This publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose. Autodesk, Inc., reserves the right to revise and improve its products including without limitation the User Documentation and the Software, as it sees fit. This publication describes the state of the Software at the time of its publication, and may not reflect the Software at all times in the future. AUTODESK, INC., MAKES NO WARRANTY, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE REGARDING THE SOFTWARE OR THESE MATERIALS, AND MAKES SUCH SOFTWARE AND MATERIALS AVAILABLE SOLELY ON AN "ASIS" BASIS. AUTODESK DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE. IN NO EVENT SHALL AUTODESK, INC. BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH OR ARISING OUT OF PURCHASE OR USE OF THE SOFTWARE OR THESE MATERIALS. THE SOLE AND EXCLUSIVE LIABILITY TO AUTODESK, INC., REGARDLESS OF THE FORM OF ACTION, SHALL NOT EXCEED THE PURCHASE PRICE OF THE SOFTWARE OR MATERIALS DESCRIBED HEREIN, AS THE CASE MAY BE. Autodesk Trademarks The following are registered trademarks or trademarks of Autodesk, Inc., in the USA and other countries: 3DEC (design/logo), 3December, 3December.com, 3ds Max, ActiveShapes, Actrix, ADI, Alias, Alias (swirl design/logo), AliasStudio, Alias|Wavefront (design/logo), ATC, AUGI, AutoCAD, AutoCAD Learning Assistance, AutoCAD LT, AutoCAD Simulator, AutoCAD SQL Extension, AutoCAD SQL Interface, Autodesk, Autodesk Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor, Autodesk Map, Autodesk MapGuide, Autodesk Streamline, AutoLISP, AutoSnap, AutoSketch, AutoTrack, Backdraft, Built with ObjectARX (logo), Burn, Buzzsaw, CAiCE, Can You Imagine, Character Studio, Cinestream, Civil 3D, Cleaner, Cleaner Central, ClearScale, Colour Warper, Combustion, Communication Specification, Constructware, Content Explorer, Create>what’s>Next> (design/logo), Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids, DesignProf, DesignServer, DesignStudio, Design|Studio (design/logo), Design Your World, Design Your World (design/logo), DWF, DWG, DWG (logo), DWG TrueConvert, DWG TrueView, DXF, EditDV, Education by Design, Extending the Design Team, FBX, Filmbox, FMDesktop, GDX Driver, Gmax, Heads-up Design, Heidi, HOOPS, HumanIK, i-drop, iMOUT, Incinerator, IntroDV, Kaydara, Kaydara (design/logo), LocationLogic, Lustre, Maya, Mechanical Desktop, MotionBuilder, ObjectARX, ObjectDBX, Open Reality, PolarSnap, PortfolioWall, Powered with Autodesk Technology, Productstream, ProjectPoint, Reactor, RealDWG, Real-time Roto, Render Queue, Revit, Showcase, SketchBook, StudioTools, Topobase, Toxik, Visual, Visual Bridge, Visual Construction, Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual Survey, Visual Syllabus, Visual Toolbox, Visual Tugboat, Visual LISP, Voice Reality, Volo, and Wiretap. The following are registered trademarks or trademarks of Autodesk Canada Co. in the USA and/or Canada and other countries: Backburner, Discreet, Fire, Flame, Flint, Frost, Inferno, Multi-Master Editing, River, Smoke, Sparks, Stone, Wire. Third-Party Trademarks mental ray is a registered trademark of mental images GmbH licensed for use by Autodesk, Inc. Adobe, Illustrator and Photoshop are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. The Ravix logo is a trademark of Electric Rain, Inc. “Python” and the Python logo are trademarks or registered trademarks of the Python Software Foundation. All other brand names, product names, or trademarks belong to their respective holders. Third-Party Copyright Notices I. Graph Layout Toolkit © Copyright 1992-2003 Tom Sawyer Software, Berkeley, California. All rights reserved. II. Portions relating to JPEG © Copyright 1991-1998 Thomas G. Lane. All rights reserved. This software is based in part on the work of the Independent JPEG Group. III. Portions relating to TIFF © Copyright 1997-1998 Sam Leffler. © Copyright 19911997 Silicon Graphics, Inc. All rights reserved. The TIFF portions of this software is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright owner or contributors of the TIFF portions be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of the TIFF portions of this software, even if advised of the possibility of such damage. IV. Portions relating to the implementation of the Edge Detection and Image Segmentation (EDISON) System are provided "AS IS". More information may be found at http://www.caip.rutgers.edu/riul/research/code.html. V. Portions of the subdivision surface implementation technology are protected by U.S. patents 6,037,949, 6,222,553, 6,300,960, and 6,489,960 and used under license from Pixar. VI. Portions relating to OpenEXR Copyright © 2004, Industrial Light & Magic, a division of Lucasfilm Entertainment Company Ltd. Portions contributed and copyright held by others as indicated. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of Industrial Light & Magic nor the names of any other contributors to this software may be used to endorse or promote products derived from this software without specific prior written permission. THE INDUSTRIAL LIGHT & MAGIC, A DIVISION OF LUCASFILM ENTERTAINMENT COMPANY LTD. SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. VII. SWIG: This software includes contributions that are Copyright © 1998-2002 University of Chicago. All rights reserved. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the University of Chicago nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY OF CHICAGO AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNIVERSITY OF CHICAGO OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.” Portions Copyright © 1995-1998 The University of Utah and the Regents of the University of California. All Rights Reserved. IN NO EVENT SHALL THE AUTHOR, THE UNIVERSITY OF CALIFORNIA, THE UNIVERSITY OF UTAH OR DISTRIBUTORS OF THIS SOFTWARE BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE AUTHORS OR ANY OF THE ABOVE PARTIES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE AUTHOR, THE UNIVERSITY OF CALIFORNIA, AND THE UNIVERSITY OF UTAH SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. Government Use Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer Software-Restricted Rights) and DFAR 227.7202 (Rights in Technical Data and Computer Software), as applicable. Manufacturer is Autodesk, Inc. 111 McInnis Parkway, San Rafael, California 94903, USA. Patents Protected by one or more of U.S. Patent Nos. 5,764,233, 5,808,625, 5,809,219, 5,818,452, 5,847,716, 5,852,450, 5,889,528, 5,926,178, 5,929,864, 5,990,908, 5,999,195, 6,025,852, 6,037,948, 6,118,427, 6,130,673, 6,204,860, 6,211,882, 6,232,980, 6,246,416, 6,266,071, 6,317,128, 6,348,924, 6,356,271, 6,363,503, 6,384,835, 6,389,154, 6,414,700, 6,462,740, 6,525,735, 6,549,212, 6,553,337, 6,618,063, 6,798,416, 6,850,638, 6,859,202, 6,888,542, 6,915,492, 7,034,824, 7,139,444; and patents pending. 03 2007 Table of Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Overview of installation and licensing . . . . . . . . . . . . . . . . . . . 9 2 Quick Start Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Quick Start: How to activate your copy of Maya . . . . . . . . . . . 11 Serial numbers and activation . . . . . . . . . . . . . . . . . . . . . 11 3 Installing Maya for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Overview of installing Maya for Windows . . . . . . . . . . . . . . . . 15 Before you begin: checklist. . . . . . . . . . . . . . . . . . . . . . . . . . 15 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Installation directory (Windows). . . . . . . . . . . . . . . . . . . . . . . 19 Maya on 64-bit systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Benefits of 64-bit Maya . . . Supported features . . . . . . Microsoft Runtime Libraries Maya API and Developer Kit .. .. .. .. . . . . . . . . . . . . . . . . . . . . ................ ................ ................ ................ 19 19 20 21 Installing Maya (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Maya Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Bonus Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Uninstalling Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Installing Maya 8.5 alongside previous versions. . . . . . . . . . . 28 Graphics requirements for Maya . . . . . . . . . . . . . . . . . . . . . . 28 4 Installing Maya for Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Overview of installing Maya for Mac OS X . . . . . . . . . . . . . . . 31 Before you begin: checklist. . . . . . . . . . . . . . . . . . . . . . . . . . 31 Installation and Licensing Guide 3 Table of Contents System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Maya on Intel Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 General notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Supported features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Installing Maya (Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Uninstalling Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Software that can be installed separately . . . . . . . . . . . . . . . 40 Installing Maya 8.5 alongside previous versions of Maya . . . . 40 Maya Terminal window provided with Maya . . . . . . . . . . . . . . 40 5 Installing Maya for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41 Overview of installing Maya for Linux . . . . . . . . . . . . . . . . . . . 41 Before you begin: checklist. . . . . . . . . . . . . . . . . . . . . . . . . . 41 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Installation directory (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . 45 Maya on 64-bit systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Benefits of 64-bit Maya . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Supported features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Maya API and Developer Kit . . . . . . . . . . . . . . . . . . . . . . . 46 Installing Maya (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Installing Maya using the rpm utility . . . . . . . . . . . . . . . . . 47 Installing Maya on file systems other than /usr . . . . . . . . . 49 Uninstalling Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Additional Linux notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Compiling plug-ins and standalone programs . . . . . . . . . . Differences in operation . . . . . . . . . . . . . . . . . . . . . . . . . Linux desktop configuration . . . . . . . . . . . . . . . . . . . . . . . KDE and Gnome desktop configuration . . . . . . . . . . . . . . . Installation and Licensing Guide 4 51 51 52 52 Table of Contents 6 Installing the Shader Library . . . . . . . . . . . . . . . . . . . . . . . . . . .55 Installing the Maya Shader Library . . . . . . . . . . . . . . . . . . . . 55 7 Installing mental ray for Maya satellite . . . . . . . . . . . . . . . . . . .57 Overview of mental ray (satellite) . . . . . . . . . . . . . . . . . . . . . 57 Slave machine installation . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Slave machine additional setup . . . . . . . . . . . . . . . . . . . . . . 59 Slave machine port setup. . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Licensing of satellite rendering . . . . . . . . . . . . . . . . . . . . . . . 61 8 Installing license server software . . . . . . . . . . . . . . . . . . . . . . .63 Installing license server software . . . . . . . . . . . . . . . . . . . . . 63 9 Licensing Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65 Who should use this chapter . . . . . . . . . . . . . . . . . . . . . . . . 65 Overview of licensing: some definitions . . . . . . . . . . . . . . License file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing your hardware lock . . . . . . . . . . . . . . . . . . . . . . Where is your serial number? . . . . . . . . . . . . . . . . . . . . . 66 68 69 69 Prekey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Webkey. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Getting the Webkey using the Autodesk Product Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Activating the software from a serial number . . . . . . . . . . . . . 72 Installing a license. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Licensing notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 If the licensing is not successful . . . . . . . . . . . . . . . . . . . . . . 83 To request a license if you don’t have a serial number . . . . . . 83 Additional setup for networked licenses . . . . . . . . . . . . . . . . 84 Installation and Licensing Guide 5 Table of Contents (Windows) License server management options and license server confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 (Linux) License server management options and license server confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 (Mac OS X) License server management options and license server confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Setting up each client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Limiting the use of Maya Unlimited product licenses . . . . . . . 90 Confirming Maya startup . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Verifying license server installation . . . . . . . . . . . . . . . . . . . . 92 10 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95 Troubleshooting licensing: introduction . . . . . . . . . . . . . . . . . 95 Contacting Support Services. . . . . . . . . . . . . . . . . . . . . . . . . 95 NORTH AMERICAN SUPPORT CENTER . . . . . . . . . . . . . . . . ASIA PACIFIC SUPPORT CENTER . . . . . . . . . . . . . . . . . . . . OTHER SERVICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Autodesk Insider Case Management (Platinum membership only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 96 97 97 Issues at startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Preference corruption . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 The Product Configuration Wizard does not appear . . . . . . 98 The main Maya scene view doesn’t open, but the Script Editor does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Confirming hardware lock driver activation . . . . . . . . . . . . 98 When you start Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Troubleshooting licensing problems (Linux, Mac OS X) . . . 100 Troubleshooting licensing problems (Windows) . . . . . . . . 102 Examining a licensing log file . . . . . . . . . . . . . . . . . . . . . . . 104 Understanding log file error messages . . . . . . . . . . . . . . 106 Installation and Licensing Guide 6 Table of Contents Finding licensing problems with diagnostic tools . . . . . . . . . 110 Checking your hardware ID with lmhostid (Linux, Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Diagnosing your licensing problems with lmdiag (Linux, Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Checking networked licensing with lmstat (Linux, Mac OS X) . 111 Checking for licensing errors with FLEXlm licensing utilities (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Running previous versions of Maya: USB hardware lock issues . . . . . . . . . . . . . . . . . . . . . . . . . 116 Checking that a license file is the correct file type (Windows) . . . . . . . . . . . . . . . . . . . . . . 117 Understanding licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Standalone licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Networked licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121 Installation and Licensing Guide 7 Table of Contents Installation and Licensing Guide 8 1 Introduction Overview of installation and licensing Welcome to Autodesk® Maya® 8.5! This guide describes the process of installation and licensing Maya 8.5 for all supported platforms, along with some information about troubleshooting your installation and licensing problems. Please follow your platform-specific installation instructions: • “Installing Maya for Windows” on page 15 • “Installing Maya for Mac OS X” on page 31 • “Installing Maya for Linux” on page 41 Details about installing the Maya Shader library can also be found in this manual: • “Installing the Shader Library” on page 55 You can also install a special version of mental ray (satellite) for network rendering on computers that are accessible to the machine running Maya: • “Installing mental ray for Maya satellite” on page 57 If you only want to install the license server tools, see: • “Installing license server software” on page 63 When you have finished installing Maya, proceed to the licensing Quick Start section (if you are a new user installing Maya to a single machine) or to the licensing chapter: • “Quick Start: How to activate your copy of Maya” on page 11 • “Licensing Maya” on page 65 If you have problems starting or licensing Maya, please review our troubleshooting guide: • “Troubleshooting” on page 95 Installation and Licensing Guide 9 1 | Introduction > Overview of installation and licensing The Maya 8.5 installation and licensing process is available in Japanese for the Microsoft® Windows® and Apple® Mac OS® X operating systems. The installation and licensing process will take place automatically in Japanese on a Japanese-language Windows or Mac OS X system. Installation and Licensing Guide 10 2 Quick Start Licensing Quick Start: How to activate your copy of Maya This quick start provides a guide to activating your copy of Maya. This straightforward set of instructions applies to almost all new customers of Maya, whether you’re activating a single copy of Maya or setting up a license server. (If you’re an existing Maya customer, or if you want detailed instructions of how to license Maya, see “Licensing Maya” on page 65.) Before licensing, install Maya. See the following sections, if necessary: • “Installing Maya for Windows” on page 15 (32-bit and 64-bit) • “Installing Maya for Mac OS X” on page 31 • “Installing Maya for Linux” on page 41 (32-bit and 64-bit) Serial numbers and activation If you don’t already have a license, you must first enter a serial number into the licensing tool in order to activate Maya. • You received your serial number when you bought your copy of Maya. Your serial number may be: • in an email from your reseller or from Autodesk • on a sticker in your Maya package A serial number looks like one of the following: • MUF070-N-0234-6977-3714-3603-8600 (33 characters) • 123-45678901 (11 characters) You can now activate Maya by following the nine steps on the next two pages. 1 Start Maya. When you start Maya without a license, the Product Configuration Wizard appears. Installation and Licensing Guide 11 2 | Quick Start Licensing > Quick Start: How to activate your copy of Maya 2 In the Product Configuration Wizard, select I have a serial number that I need to activate, and click Next. 3 Choose whether your serial number has 33 characters or 11 characters. 4 Paste your serial number into the space provided and click Next. Installation and Licensing Guide 12 2 | Quick Start Licensing > Quick Start: How to activate your copy of Maya 5 If you have a hardware lock (dongle), please make sure it is plugged in now. The Product Configuration Wizard displays your hardware ID. Select the hardware lock (dongle) value if there is one; otherwise, select your Ethernet ID. For more details, see “Licensing Maya” on page 65. Click Next. 6 Register your serial number and hardware ID. We'll start this for you by asking which browser you want to use first, and then taking you to our web site. If you can't register via the web page, see “Licensing Maya” on page 65. 7 There is a web page that you must fill out to complete your licensing process. At the end of the process, your license is displayed in your web browser. In minutes, you should also receive your license via email. If the email doesn't arrive within a short period of time, see “Licensing Maya” on page 65. Installation and Licensing Guide 13 2 | Quick Start Licensing > Quick Start: How to activate your copy of Maya 8 Re-launch Maya, if necessary, to re-open the Product Configuration Wizard and paste your license into the space provided or select your license file. Your license will be validated and installed 9 Click Next. Congratulations! You now have a licensed copy of Maya. (If you’re an existing Maya customer, or if you want detailed instructions of how licensing works, and how to license Maya, see “Licensing Maya” on page 65.) (If you’re setting up a networked license server, see “Additional setup for networked licenses” on page 84.) Installation and Licensing Guide 14 3 Installing Maya for Windows Overview of installing Maya for Windows This chapter describes the prerequisites for installing Maya and how to install Maya for Windows operating systems, as well as tips on uninstalling, associated products, and other issues. Before you begin: checklist You must run the installer on each computer where you want to run the software. If you’re going to use a computer to serve licenses, you must also run the installer on that computer. Issue Required action Your computer system must meet specific hardware and software requirements for you to successfully install and run Maya. Review the requirements section in this chapter (“System requirements” on page 16). Autodesk does not support hardware and software configurations that do not meet these requirements. The most up-to-date information on specific hardware system qualifications for your computer can be found on the Autodesk Web site: www.autodesk.com/qual-charts You must have administrator privileges to install Maya. (You do not need to be an administrator to launch Maya once it is installed.) If you do not have administrator privileges on your computer, you’ll need to contact your system administrator. Installation and Licensing Guide 15 3 | Installing Maya for Windows > System requirements Issue Required action If you have a previous version of Maya on your system, you can choose to keep it or uninstall it. However, you must uninstall before installing the same Maya version as the one installed (for example, to upgrade a pre-release copy). Uninstall Maya before installing the same Maya version as the one installed. See “Uninstalling Maya” on page 27. To avoid any conflicts when installing Maya, we recommend that you close all other programs and disable virus detection software before launching the installer. Before installing: Having multiple versions of Maya installed on a machine and adding each version’s path to the user’s environment PATH variable may cause version conflicts. Only add the path currently needed for the version of Maya that is being run. Under most circumstances Maya performs correctly if the path is not set. • Close all programs. • Disable any virus detection software. System requirements Autodesk certifies certain computer system configurations as meeting the requirements to work with the Maya software. To determine whether your particular system meets these requirements, please check the following table. The latest information on qualifying systems is always available at: www.autodesk.com/qual-charts You can examine your system capabilities using system diagnostic tools. Select Start > Programs > Accessories > System Tools > System Information. Installation and Licensing Guide 16 3 | Installing Maya for Windows > System requirements Category Values Hardware • (32-bit) Intel® Pentium® IV or higher, AMD Athlon® XP processor (must be SSE capable) • (64-bit) Intel® processor with Intel® EM64T-capable or AMD® Athlon 64™, AMD Opteron® processor • 1GB RAM • DVD drive • ethernet card (required for licensing Maya uniquely to your machine) (You can also use a hardware lock (dongle) to license Maya, which can be purchased through Autodesk.) Graphics requirements • three-button mouse with mouse driver software • a qualified hardware-accelerated OpenGL® graphics card (overlay plane capability is recommended) Please refer to www.autodesk.com/qual-charts and the section “Graphics requirements for Maya” on page 28. Operating system • (32-bit) Windows XP Professional (SP2) • (64-bit) Windows XP Professional x64 Edition (SP1 or higher) • TCP/IP network protocol software (for running Maya batch rendering and other features) • a graphics card driver. Driver software is available from the manufacturer’s web site. • appropriate driver software for optional hardware Installation and Licensing Guide 17 3 | Installing Maya for Windows > System requirements Category Values Disk space requirements The following approximate disk space requirements are based on the NTFS disk format. If you have a FAT disk format, expect slightly larger file sizes. These are default, minimal sizes; you’ll need 10-150M more space to install optional selections. Other software Optional hardware • 515MB (including 160MB for Maya documentation) • Adobe® Acrobat® Reader is required to view the PDF documentation provided on the Maya DVD. You can obtain Acrobat Reader from www.adobe.com. • Mozilla Firefox and Internet Explorer 6 web browsers have been qualified to view the Maya Help. • QuickTime® 7.1 or greater is required to view the Essential Skills Movies • Wacom™ tablet. Make sure you install the latest Wacom driver software (www.wacom.com). • Motion capture devices. Maya supports real-time motion capture. Contact your motion capture equipment vendor for details. Installation and Licensing Guide 18 3 | Installing Maya for Windows > Installation directory (Windows) Installation directory (Windows) The following table shows where Maya is installed by default on different Windows operating systems. 32-bit Maya 64-bit Maya Windows XP x64 C:\Program Files (x86)\Autodesk\Maya8.5 C:\Program Files\Autodesk\Maya8.5 Windows XP or Windows 2000 (32-bit) C:\Program Files\Autodesk\Maya8.5 n/a Maya on 64-bit systems The following section discusses differences between Maya for 64-bit operating systems and Maya for 32-bit operating systems. Benefits of 64-bit Maya With Maya 8.5 for 64-bit EM64T/AMD® 64 processors, you can now work with larger and more complex scenes that you ever could before. • Maya on 64-bit can take advantage of greater than 4GB of memory (maximum memory is system-dependent) • Maya on 64-bit uses SSE2 instructions for floating point computations • Additional general registers in 64bit mode allow the compiler to generate better code which spills to memory less often. Supported features The following table lists features that are not supported in 64-bit Maya. Installation and Licensing Guide 19 3 | Installing Maya for Windows > Maya on 64-bit systems Feature Comments Vector Renderer plugin Not supported in 64-bit Maya (3rd party library). QuickTime VR Not supported in 64-bit Maya (3rd party library) RibExport Not supported in 64-bit Maya Alias wirefile export openModel9.7 is not available in 64bit Maya Maya Motion Capture feature Not supported in 64-bit Maya. We recommend using Autodesk MotionBuilder for motion capture. Microsoft Runtime Libraries The Maya 64-bit installer puts the Microsoft runtime libraries into the System directory C:\Windows\WinSxS using the Microsoft redistributable Merge Modules. Installation and Licensing Guide 20 3 | Installing Maya for Windows > Maya on 64-bit systems Note You may not have the specific runtime libraries installed on their machine, so part of the Maya installation is to install the files that Autodesk Maya needs. These are the Microsoft runtime libraries for C library, MFC (Microsoft Foundation Class), the user interface framework, and the OpenMP runtime library. These are required libraries to run Maya as a MFC graphical user interface application. These are system dynamic libraries and are shared with all applications on the machine. As Microsoft updates their 64-bit operating system, they may update these libraries. With the current Microsoft compiler for 64-bit systems (VC8), the system no longer searches the PATH variable for the runtime libraries. For Maya 64-bit, Autodesk is using the system copies. With Microsoft’s versioning of the manifest files, Maya should find the proper DLL files. Maya API and Developer Kit For details on API and Developer support for 64-bit Maya, see the API guide under Developer Resources in the Maya Help. Installation and Licensing Guide 21 3 | Installing Maya for Windows > Installing Maya (Windows) Installing Maya (Windows) For information on the other installation options, see the following: • “Uninstalling Maya” on page 27 • “Maya Plug-ins” on page 26 • “Bonus Tools” on page 27 • “Installing the Maya Shader Library” on page 55 Notes • If you are upgrading from a previous version of Maya and have a hardware lock (dongle), plug it in before installation to make sure that the installer properly detects the dongle and upgrades your license. • To ensure a clean installation, uninstall any existing copy of Maya 8.5 on your computer before reinstalling Maya 8.5. For more information, see “Uninstalling Maya” on page 27. To install Maya for Windows 1 Insert the Maya DVD into your drive. The Maya installer window appears. Installer window on 64-bit machines Installation and Licensing Guide 22 3 | Installing Maya for Windows > Installing Maya (Windows) On 64-bit systems, you are given the choice to install the 32-bit or 64-bit version of Maya. If the Maya installer does not appear, choose Start > Run. Click Browse and choose the Autorun.exe file in the platform-appropriate area of the Maya DVD. Click OK in the Run dialog box to begin the installation. 2 Click Install Maya to begin the software installation, and follow the online instructions. The Maya Installation Wizard appears. The installation wizard directs you through the process of installation. Click Next to proceed through the installation, Back to return to the previous window, or Cancel to stop the installation. 3 Click Next. The Autodesk Software License Agreement appears. This agreement requires your acceptance for the Maya software installation to continue. If you do not agree to the terms and conditions of the agreements, the installation process does not continue. 4 Scroll to the end, click “I Agree”, and click Next to continue with the Maya software installation. The Product Configuration window appears. 5 On the Maya Product Configuration screen, you can set two options: Installation and Licensing Guide 23 3 | Installing Maya for Windows > Installing Maya (Windows) • Full or Custom Install The Full setup installation is the recommended installation for most users. It installs the Maya application, installs all related applications and utilities, and sets the file type associations on your computer for Maya file types. If you want to install specific components of the Maya application (for example, the Maya developer features), modify the default file associations, or want to turn off items in the installation to save disk space, choose Custom setup from the menu. • Where to install Maya. If you want to change the default location for the software installation, click Change. The Windows browser appears. Browse to the install location or enter the path. Do one of the following: 6 • Select Full to select a Full setup Maya installation (recommended), click Next, and proceed to step 8. • Select Custom, click Next, and proceed to the next step. (Custom installation only) The Feature Selection window appears. At a minimum, you must install the following to run Maya: • Maya Program Files—contains the core Maya software, including Japanese User Interface Resources, which you can choose to install or not install. • Licensing—includes files essential to licensing. Note If you are installing on a computer that serves Maya licenses to other computers but won’t be used to run Maya itself, you can install the license software only. For more information, see Chapter 8, “Installing license server software”. From this window, you can also click Help to get custom setup tips or click Space to check available space on connected hard drives. When you are ready to proceed, click Next. Installation and Licensing Guide 24 3 | Installing Maya for Windows > Installing Maya (Windows) 7 (Custom installation only) The File Type Handling window appears. You can set how various file format types are handled on your computer using the options in this window. For example, if you double-click a Maya binary scene file (.mb), the computer automatically launches Maya based on the file type associations that have been set. Depending on the other software you have configured on your computer, you can either leave these options as is, or change them to suit your particular setup. When you are ready to proceed, click Next. 8 (Full or Custom installation) The Add Location To Path window appears. The options in this window are turned on by default. • Add a Shortcut to the Quick Launch Toolbar—Adds a Maya shortcut icon to your Windows Quick Launch Toolbar. • Add to System Path—Adds the Maya executable directory to your Windows system path. This lets you start Maya or any of its related programs from any directory when using the command prompt; for example, at the command prompt, you could simply type maya to launch Maya or fcheck to launch the FCheck image-viewing utility. Setting the system path may also be useful for batch files and other scripts involving Maya or other related programs. Installation and Licensing Guide 25 3 | Installing Maya for Windows > Maya Plug-ins • Add a Shortcut to the Desktop—Adds the Maya shortcut icon to your desktop during the installation. Make your selections and click Next. 9 The Ready to Install the program window appears. If you want to review or change any of your installation settings, click Back; otherwise, click Install. The Maya software and accompanying utilities are installed on your computer. The progress of the installation is indicated by the progress bar in the installer’s window. 10 Continue with the license setup program after the software installation: • If you’re an existing Maya customer, your license may already be installed for you. If Maya starts up, no further licensing is required. For more information, see “Prekey” on page 70 and “Webkey” on page 70. • If you’re a new Maya customer, start the Product Configuration Wizard after installation by choosing Maya from the Windows Start menu. See Chapter 2, “Quick Start Licensing”. • If you’re setting up a license server, see Chapter 9, “Licensing Maya” for details of how to set up both servers and clients. For more information, see Chapter 9, “Licensing Maya”. Note If you are licensing your computer using a parallel port or USB hardware lock, you may need to reboot your computer for the licensing process to detect your hardware lock. For more information, see Chapter 9, “Licensing Maya”. Maya Plug-ins The Maya Plug-ins button provides a link to a variety of third-party Maya Plug-in vendor Web sites. Plug-ins are software products that extend the functionality of your Maya software. For more information on Maya Plug-ins and the Sparks program, see www.autodesk.com/sparks or click Maya Plug-Ins on the Maya Installer Window. Installation and Licensing Guide 26 3 | Installing Maya for Windows > Bonus Tools Bonus Tools Bonus Tools is a collection of unsupported Maya scripts and plug-ins provided to Maya users. The Bonus Tools button in the installer links to the Maya Bonus Tools on the Autodesk Web site. You can also access the Bonus Tools Web site from the Maya Help menu. Follow the directions provided on the Web site for downloading and installing Bonus Tools on your computer. After installing Bonus Tools, there is a drop-down menu for easy access to the tools that cover all aspects of everyday use: general UI, modeling, animation, texturing and rendering. Uninstalling Maya You can uninstall Maya in three different ways. To uninstall Maya for Windows using the Maya DVD 1 Insert the Maya DVD into your drive. 2 Click Uninstall Maya when the Maya Installation window appears. 3 Follow the instructions in the dialog box. To uninstall Maya for Windows using the Uninstall utility 1 From the Windows Start menu, select Programs > Autodesk > Maya 8.5 > Uninstall Maya. 2 Follow the instructions in the dialog box. To uninstall Maya for Windows using Windows Add/Remove programs 1 From the Windows Start menu, select Settings > Control Panels > Add/Remove Programs. 2 In the list of programs that appears, click Maya 8.5 and then click Remove. 3 Follow the instructions in the dialog box. Note You must uninstall the documentation separately. Installation and Licensing Guide 27 3 | Installing Maya for Windows > Installing Maya 8.5 alongside previous versions Installing Maya 8.5 alongside previous versions Maya 8.5 and previous versions of Maya can co-exist on the same machine. However, be aware of which version of Maya you are running and which version of Maya is specified in the PATH environment variable. For example, if you run the Render command in a terminal window, you may need to fully specify the directory path to be sure you are getting the version of the Maya renderer you expect. Graphics requirements for Maya To make full use of Maya’s capabilities, you must have a graphics card qualified to run Maya. Please refer to: www.autodesk.com/qual-charts As well, options in the Display Properties settings of Windows affect the display performance of Maya. To learn the correct option settings for graphics cards qualified for use with Maya, please check the qualification charts for the latest information. Some graphics card manufacturers have created an option to optimize Maya display performance which may be available through the Windows Display Properties settings. See your graphic card’s installation instructions, or contact your graphics card manufacturer to see if their graphics software provides this option. If you’re using a card that’s not qualified, try setting the following options (some steps offer only general guidelines because each manufacturer has a unique set of display options). To set your graphics card options 1 Right-click your desktop, select Properties, then select the Settings tab. 2 From the Color quality menu, select 24 or 32 bits of color for best color quality in displayed images. 3 Drag the Screen resolution slider to the best display resolution supported by your hardware. The higher you set the display resolution, the more graphics card main memory you need. This is called VRAM on some computers. Installation and Licensing Guide 28 3 | Installing Maya for Windows > Graphics requirements for Maya Maya generally works best at 1280 by 1024 resolution. If you’ve selected True Color and your card has limited VRAM, it will work better at a lower resolution. (At the higher resolution, the card may run out of memory, forcing the OpenGL driver to operate in software mode rather than use hardware acceleration.) To set graphics performance options After you install your graphics card driver software, it’s likely that a tab named for the card was created in the Display Properties window. The tab has performance options that vary with each card. On Windows 2000 and Windows XP, click the Advanced button and select the appropriate tab. The following are general suggestions for setting performance options: 1 In the Display Properties window, click the tab named for your graphics card (if available). 2 Turn on the overlay plane feature (if available). Maya takes advantage of the hardware overlay plane feature available with most mid- and high-quality OpenGL graphics cards. In brief, overlay planes enable programs to quickly display certain elements of a user interface that exist on top of other elements, without having to redraw the entire user interface. Overlay planes are called hardware overlays on some products. Maya works with four-bit or greater overlay planes, single- or double-buffered. For some graphics cards, overlay planes are available only if you turn off alpha planes operation. 3 Stencil planes are not required by Maya: you can turn them off. 4 Close the Display Properties window. Installation and Licensing Guide 29 3 | Installing Maya for Windows > Graphics requirements for Maya Installation and Licensing Guide 30 4 Installing Maya for Mac OS X Overview of installing Maya for Mac OS X This chapter describes how to install Maya for Mac OS X as well as the hardware and system requirements for installing and running Maya on the Mac OS X operating system. Maya 8.5 supports both PowerPC and Intel processors on Mac OS X through a Universal Binary. Before you begin: checklist You must run the installer on each computer where you want to run the software. If you’re going to use a computer to only serve licenses, see “Software that can be installed separately” on page 40. Issue Required action Your computer system must meet specific hardware and software requirements for you to successfully install and run Maya. Review the requirements section in this chapter (“System requirements” on page 32). Autodesk does not support hardware and software configurations that do not meet these requirements. The most up-to-date information on specific hardware system qualifications for your computer can be found on the Autodesk Web site: www.autodesk.com/qual-charts You must have administrator privileges to install Maya. This means that you need an administrator password on your computer to install Maya. (You do not need to be an administrator to launch Maya once it is installed.) If you do not have administrator privileges on your computer, you’ll need to contact your system administrator. Installation and Licensing Guide 31 4 | Installing Maya for Mac OS X > System requirements Issue Required action If you have a previous version of Maya on your system, you can choose to keep it or uninstall it. However, you must uninstall before installing the same Maya version as the one installed (for example, a pre-release copy). Uninstall Maya before installing the same Maya version as the one installed. See “Uninstalling Maya” on page 39. To avoid any conflicts when installing Maya, we recommend that you close all other programs and disable virus detection software before launching the installer. Before installing: Having multiple versions of Maya installed on a machine may cause version conflicts. We do not recommend changing a PATH environment variable. You can use the Maya Terminal that comes with your Maya package to set paths correctly. For more information, see “Maya Terminal window provided with Maya” on page 40. • Close all programs. • Disable any virus detection software. Under most circumstances Maya performs correctly if the path is not set. System requirements Autodesk certifies certain computer system configurations as meeting the requirements to work with the Maya software. To determine whether your particular system meets these requirements, please check the following table. The latest information on qualifying systems is always available at: www.autodesk.com/qual-charts Installation and Licensing Guide 32 4 | Installing Maya for Mac OS X > System requirements To examine the system capabilities of your Mac OS X computer Do one of the following: • From the Apple menu, select About this Mac and click the More Info button. • Double-click the Apple System Profiler application (Applications > Utilities). Apple System Profiler provides information about your computer, operating system, disks, and applications. Category Values Hardware • Macintosh computer (G5 processor or Intel processor recommended) • 1 GB memory (minimum) • DVD drive • three-button mouse (recommended). Maya can work with mouse input devices that have fewer buttons. See in the Environment Variables guide in the Maya Help for details of how to set Maya to work with different mouse input devices. If your mouse came with a preference program for customizing mouse buttons, set it to deactivate when Maya is active. Refer to the manual or online help that came with your mouse to find out how to do this. Installation and Licensing Guide 33 4 | Installing Maya for Mac OS X > System requirements Category Values Graphics requirements • A graphics card qualified to run Maya. Check www.autodesk.com/qual-charts to see which operating system and graphics card are qualified for Maya. • Maya works best with a mid- to high-range, hardwareaccelerated OpenGL graphics card. • Set your display to show millions of colors. If possible, set your resolution higher than 1024 by 768. Lower resolutions can make it difficult to see some attributes inside editors. Many graphics card manufacturers document the setup of their graphics card for use with Maya. Refer to the instructions that came with your particular graphics card. • Mac OS X version 10.4 or later • Mac OS X Server is not supported Operating system Not all versions of Mac OS X can be used with Maya. Autodesk recommends that you refer to the Maya qualification charts before upgrading to a newer version of the operating system. www.autodesk.com/qual-charts Disk space requirements • A minimum of 500MB of available disk space Installation and Licensing Guide 34 4 | Installing Maya for Mac OS X > Maya on Intel Mac OS X Category Values Other software • Apple QuickTime® and Preview (which reads PDF files) are provided with the Mac OS X operating system. You can also download Adobe® Acrobat® Reader at www.adobe.com. These applications are required for viewing the multimedia movies provided with the Maya application and viewing the PDF documentation provided on the Maya DVD. Optional hardware • Safari™ and Mozilla Firefox web browsers have been qualified to view the Maya Help. • Wacom™ tablet. Make sure you install the latest Wacom driver software (www.wacom.com). Maya on Intel Mac OS X The following section discusses differences between Maya for Intel processors and Maya for PowerPC processors. General notes • Maya for PowerPC processors is not tested on Rosetta, and will not be qualified. • Plugins built for previous version of Maya on PowerPC will need to be recompiled to run with Maya for Intel processors. Supported features The following table lists features that are not supported in Maya for Mac OS X on Intel processors. Installation and Licensing Guide 35 4 | Installing Maya for Mac OS X > Installing Maya (Mac OS X) Feature Comments Vector Renderer plugin Not supported (3rd party library). Installing Maya (Mac OS X) If you have a hardware lock (dongle), you must plug it in after installation. If it’s plugged in during installation, you may see an error message. Hardware lock driver Installation of the HASP4 drivers from Aladdin requires that you remove the hardware lock (dongle) first. You must close the installer and remove the hardware lock, and then restart the installer. Note You can also install the Shader Library. The Shader Library contains pre-defined materials you can apply to your models. See “Installing the Maya Shader Library” on page 55. To install Maya for Mac OS X 1 Insert the Maya DVD into the drive of your computer. The contents of the DVD appear in a new Finder window. If the Maya 8.5 Finder window does not open automatically, double-click the Maya 8.5 disk icon on your Desktop. 2 Double-click the Maya 8.5 package icon to begin the installation process. The installer window appears. You can cancel the installation at any time by closing the installer window. 3 Click Continue to proceed with the Maya software installation. Note At various points during the installation, the installer may ask you to type in the name and password of an administrator account on the local machine. Installation and Licensing Guide 36 4 | Installing Maya for Mac OS X > Installing Maya (Mac OS X) The Autodesk Software License Agreement appears. You can print or save this License Agreement for future reference. This agreement requires your acceptance for the Maya software installation to continue. If you do not agree to the terms and conditions of the agreement, the installation process does not continue. 4 Click Continue and then Accept to continue with the Maya software installation. 5 In the Select a Destination screen, select the volume where you want Maya to be installed. By default, Maya will be installed into the /Applications/Autodesk folder of this volume, but you can specify another folder by clicking Choose. Click Continue. The Easy Install screen appears. 6 If you want to perform a basic (non-customized) installation, click Install and proceed to step 8. If you want to choose which components of Maya to install, click Customize and proceed to the next step. 7 (Optional) If you click Customize, the following dialog box appears: Select which components you want to install. Your choices include: Installation and Licensing Guide 37 4 | Installing Maya for Mac OS X > Installing Maya (Mac OS X) • Maya_core —You must install this component to use Maya on your computer. • Fcheck_app—A player for Maya movie and image file formats. • Maya_en_US_docs—Maya English Documentation. The Maya online documentation (in English), which contains reference documentation, tutorial files, and multimedia. • Maya_devkit—Maya Developer’s Kit,. Files and documentation for programmers who want to create Maya plug-ins (not included in the Easy install). To use the Developer’s Kit, you must install the Maya_devkit component • The Product Configuration Wizard that licenses your copy of Maya is also installed. For more information, see the Licensing Maya chapter. The Product Configuration Wizard is installed to /Applications/Autodesk/PCW. A link to the Product Configuration Wizard is found in the folder where you install Maya. The Maya Uninstaller and Uninstaller List is also installed when Maya is installed. 8 Click Install. The Maya software and accompanying utilities are installed on your computer. The progress of the installation is indicated by the progress bar at the bottom of the installer’s window. 9 When the installer finishes, it displays a message indicating that the software install is complete. 10 The installer can search the License data file (Prekey file) to see if your license can be installed for you. If you’re an existing Maya customer, choose to search the License data file. • If your license is installed, you’ll get a message on the following screen. If you’re an existing customer of Maya and your license is still not installed through the License data file search, you may want to download the updated License data file (Webkey). For more information, see “Prekey” on page 70 and “Webkey” on page 70. If you’re a new Maya customer, you can skip this step (if you go through the License data file search process, no license will be found). Installation and Licensing Guide 38 4 | Installing Maya for Mac OS X > Uninstalling Maya • To license your copy of Maya, start the Product Configuration Wizard after installation by double-clicking the Maya icon. See Chapter 2, “Quick Start Licensing”. Additionally, if you’re setting up a license server, see Chapter 9, “Licensing Maya” for details on how to set up both servers and clients. For more information, see Chapter 9, “Licensing Maya”. Uninstalling Maya To ensure a clean installation, uninstall any existing copy of Maya 8.5 on your computer before reinstalling Maya 8.5. To uninstall Maya for Mac OS X 1 Navigate to the Maya directory (by default, this is Applications/Autodesk/ maya8.5/). 2 Double-click the Uninstaller icon. The uninstaller program appears. 3 Select the components you want to uninstall and click Uninstall. Installation and Licensing Guide 39 4 | Installing Maya for Mac OS X > Software that can be installed separately Software that can be installed separately The following additional software is provided on the Maya DVD to be installed separately, if necessary. • QuickTime Components—Allows users who do not have Maya to work with IFF files in applications that are QuickTime aware. • Autodesk License Server—Installs the components necessary for a computer running Mac OS X to function as a license server. For more information, see Chapter 9, “Licensing Maya”. • Hardware lock (dongle) driver installers—These should be installed during installation, and are also provided in this directory for you. Installing Maya 8.5 alongside previous versions of Maya Maya 8.5 and previous versions of Maya can co-exist on the same machine. However, be aware of which version of Maya you are running. If you run the Render command in a Terminal window, you must fully specify the directory path to be sure you are getting the version of the Maya renderer you expect. Maya Terminal window provided with Maya The Maya Terminal.term file provided in your Maya directory launches a Terminal window that has all the proper path information to run Maya commandline applications (such as Render) and licensing tools. Using this .term file makes it easier to use command-line Maya applications on Mac OS X. Note Maya Terminal.term sources a simple (Bourne) shell script to set up the environment: /Applications/Autodesk/maya8.5/ Maya.app/Contents/bin/MayaENV.sh This could be used in a custom environment instead of using Maya Terminal.term directly; for example, when accessing the Maya environment remotely or from an alternative term application. Installation and Licensing Guide 40 5 Installing Maya for Linux Overview of installing Maya for Linux This chapter describes how to install Maya for Linux (32-bit and 64-bit) as well as the hardware and system requirements for operating Maya on a Linux operating system. Before you begin: checklist Issue Required action Your computer system must meet specific hardware and software requirements for you to successfully install and run Maya. Review the requirements section in this chapter (“System requirements” on page 42). Autodesk does not support hardware and software configurations that do not meet these requirements. The most up-to-date information on specific hardware system qualifications for your computer can be found on the Autodesk Web site: www.autodesk.com/qual-charts You will need access to the root or superuser account and password on your computer to install Maya. You do not need to be root to launch Maya once it is installed. You should not run Maya while logged in as root. If you do not have root on your computer, you’ll need to contact your system administrator. Installation and Licensing Guide 41 5 | Installing Maya for Linux > System requirements Issue Required action If you have a previous version of Maya on your system, you can choose to keep it or uninstall it. However, you must uninstall before installing the same Maya version as the one installed (for example, a pre-release copy). Uninstall Maya before installing the same Maya version as the one installed. You must also uninstall the AWCommon and AWCommonserver software before installing. See “Uninstalling Maya” on page 50. The default software installation performs the following tasks: • Creates and installs software in the following directories: /usr/autodesk /usr/autodesk/maya8.5 This is the base location for all Autodesk software if it does not already exist. Any previous versions of Maya are left untouched. • Creates or updates the symbolic links for the following: • /usr/autodesk/maya to the actual installation location • some files in /usr/local/bin to the new Maya software Note If you are installing Maya on a remote machine, make sure the DISPLAY environment variable is pointing to your local machine so that the licensing GUI is displayed on your local machine to complete the installation. System requirements Autodesk certifies certain computer system configurations as meeting the requirements to work with the Maya software. To determine whether your particular system meets these requirements, please check the following table. The latest information on qualifying systems is always available at www.autodesk.com/qual-charts. Installation and Licensing Guide 42 5 | Installing Maya for Linux > System requirements You can obtain information about your computer’s processor and memory by accessing the KControl (KDE Control Panel) or typing kcontrol in a shell window. Category Values Hardware • Intel® Pentium® IV or higher (EM64T-capable for 64bit), AMD Athlon®XP or Opteron® • 1 GB or more available memory • keyboard • three-button mouse with mouse driver software • DVD drive • network card • A graphics card qualified to run Maya. Please refer to: www.autodesk.com/qual-charts Graphics requirements Maya expects to obtain specific visuals for use with OpenGL. The preferred visual configuration is: • Both single and double buffered RGBA 8/8/8/8, with 24 bit depth buffers. • To use the Hardware Render Buffer window, adding Alpha and Accumulator buffers are also required. If Maya cannot obtain the visuals it requests, it usually outputs what was not found and continues if possible. Some aspects of Maya may not work correctly if the expected visuals are not available. Use glxinfo to list currently available visuals. Many graphics card manufacturers document the setup of their graphics card for use with Maya. Refer to the instructions that came with your particular graphics card. Installation and Licensing Guide 43 5 | Installing Maya for Linux > System requirements Category Values Operating system 32-bit and 64-bit operating systems: • Red Hat® Enterprise Linux WS 4.0 update 4 • Fedora Core 5 • SUSE™ 10.1 Please check at www.autodesk.com/qual-charts for important updates. Disk space requirements • Minimum: 400MB (without documentation package) • Standard: 450MB (with documentation package) Other software The following software must be installed on your workstation: OpenMotif run-time environment With Maya 8.5 the required library libxm.so.3 is automatically installed in /usr/autodesk/maya8.5/lib. FAM run-time environment The File Access Monitor (FAM) software allows Maya to monitor file changes in the Expression editor. FAM may already be included, so you should check first to see if the files are already installed. Type: rpm -qa | grep fam or rpm -qa | grep gamin The normal directory location for libfam.so.0 is /usr/lib or /usr/lib64 The Mozilla Firefox web browser has been qualified to view the Maya Help. Installation and Licensing Guide 44 5 | Installing Maya for Linux > Installation directory (Linux) Category Values Optional hardware • Wacom tablet—The Wacom tablet works the same as with other programs. Using the pen and tablet overrides mouse operation. When the pen is out of contact with the tablet, the mouse becomes operational. Make sure you install the latest driver software (www.wacom.com). Installation directory (Linux) The following table shows where Maya is installed by default on Linux 64-bit and 32-bit operating systems. 32-bit Maya 64-bit Maya 64-bit Linux OS /usr/autodesk/maya8.5 /usr/autodesk/maya8.5-x64 32-bit Linux OS /usr/autodesk/maya8.5 n/a Maya on 64-bit systems The following section discusses differences between Maya for 64-bit operating systems and Maya for 32-bit operating systems. Benefits of 64-bit Maya With Maya 8.5 for 64-bit EM64T/AMD® 64 processors, you can now work with larger and more complex scenes that you ever could before. • Maya on 64-bit can take advantage of greater than 4GB of memory (maximum memory is system-dependent) • Maya on 64-bit uses SSE2 instructions for floating point computations • Additional general registers in 64bit mode allow the compiler to generate better code which spills to memory less often. Installation and Licensing Guide 45 5 | Installing Maya for Linux > Installing Maya (Linux) Supported features The following table lists features that are not supported in 64-bit Maya. Feature Comments Vector Renderer plugin Not supported in 64-bit Maya (3rd party library). QuickTime VR Not supported in 64-bit Maya (3rd party library) RibExport Not supported in 64-bit Maya Alias wirefile export openModel9.7 is not available in 64bit Maya Maya Motion Capture feature Not supported in 64-bit Maya. We recommend using Autodesk MotionBuilder for motion capture. Maya API and Developer Kit For details on API and Developer support for 64-bit Maya, see the API guide under Developer Resources in the Maya Help. Installing Maya (Linux) This section describes how to install Maya for Linux. When the installation is complete, you must license Maya. You must install Maya licenses if you are: • installing Maya for the first time • adding additional licenses to a networked-type license • changing the machine on which Maya is installed. For information on upgrading Maya, see Chapter 9, “Licensing Maya” for details. If you have problems installing, see Chapter 10, “Troubleshooting.” Installation and Licensing Guide 46 5 | Installing Maya for Linux > Installing Maya (Linux) Installing Maya using the rpm utility This section describes how to install Maya for Linux using the rpm command-line utility. With the rpm command you can use either the -i flag or the -ivh flag to install the programs. The -ivh flag provides you with more information during the installation. Note If you have previously installed a version of Maya 8.5 for Linux, uninstall that version before installing this newest version. See “Uninstalling Maya” on page 50. To install using rpm 1 Log in as root. 2 Insert the Maya DVD into your drive. 3 Mount the DVD drive. For example, type: 4 Change to the directory where the Maya for Linux is installed. For example, type: 5 Use the ls command to list the packages on the DVD. mount -r /dev/dvd /mnt/dvd cd /mnt/dvd/Linux Package Name (# is the package number) Description When required (32-bit) AWCommon-10.80-#.i686.rpm (64-bit) AWCommon-10.80-#.x86_64.rpm Licensing software Always (32-bit) Licensing Server software For serving networked licenses Maya for Linux Always AWCommon-server-10.80-#.i686.rpm (64-bit) AWCommon-server-10.80-#.x86_64.rpm (32-bit) Maya-8.5-#.i686.rpm (64-bit) Maya64-8.5-#.x86_64.rpm Installation and Licensing Guide 47 5 | Installing Maya for Linux > Installing Maya (Linux) Package Name (# is the package number) Description When required (32-bit) Maya 8.5 documentation Optional Hardware lock drivers for Red Hat and SUSE Only if you have a hardware lock (dongle) Maya-docs_en_US-8.5-#.i686.rpm (64-bit) Maya64-docs_en_US-8.5-#.x86_64.rpm (32-bit) aksusbd-redhat-1.8.1-3.i386.rpm aksusbd-suse-1.8.1-3.i386.rpm (64-bit) At time of release, 64-bit dongle drivers were not available. To download them when they become available, go to: www.aladdin.com/support/hasp/ enduser.asp 6 To install the required base software, enter the following command: (32-bit) rpm -ivh AWCommon-10.80-1.i686.rpm Maya-8.5-#.i686.rpm (64-bit) rpm -ivh AWCommon-10.80-#.x86_64.rpm Maya64-8.5-#.x86_64.rpm where # refers to the specific package numbers. Note If you have a previously installed version of AWCommon and Maya for Linux, uninstall that version before installing this newest version. To verify what version you have, type: rpm -qa | egrep 'AWCommon|Maya' For more information, see “Uninstalling Maya” on page 50. Installation and Licensing Guide 48 5 | Installing Maya for Linux > Installing Maya (Linux) Maya 8.5 adds the required libxm.so.3 library to the Maya lib directory as part of its standard install, so installing the openMotif runtime rpm is not required. 7 Verify that OpenGL is installed. Look for a file named libGL.so in the /usr/ lib or /usr/X11R6/lib directory. 8 To install the documentation package, type the following where # is the specific package number: 9 (32-bit) rpm -ivh Maya-docs_en_US-8.5-#.i686.rpm (64-bit)rpm -ivh Maya64-docs_en_US-8.5-#.x86_64.rpm If you have a hardware lock, you’ll need to install the hardware lock drivers. You can install them by typing one of the following, depending on your Linux distribution: rpm -ivh aksusbd-redhat-1.8.1-3.i386.rpm rpm -ivh aksusbd-suse-1.8.1-3.i386.rpm You may receive an error message during installation about a missing file; this does not affect hardware lock driver operation. 10 You should see the software files installed in the following directory: (32-bit) /usr/aw/maya8.5 (64-bit) /usr/aw/maya8.5-x64 Once the Maya software is successfully installed, unmount and eject the DVD and store it in a safe place. Proceed to the Licensing Maya chapter or, if you’re a new user licensing a single copy of Maya, see the Quick Start Licensing chapter. Note In order to use Maya, you may need to perform additional setup procedures. See the “Additional Linux notes” on page 51 for additional information. Installing Maya on file systems other than /usr By default, Maya is installed in the /usr partition. If you want to install Maya on a different file system (due to lack of space), create a symbolic link from /usr/aw/maya8.5 or /usr/aw/maya8.5-x64 to that file system. Installation and Licensing Guide 49 5 | Installing Maya for Linux > Uninstalling Maya For example, if you are installing 32-bit Maya 8.5 on a file system called /freespace, type the following commands: su root ln -s /freespace/aw/maya8.5 /usr/aw Uninstalling Maya To uninstall Maya for Linux you can use the rpm utility. To uninstall Maya using rpm 1 Log in as root. 2 List the installed package names by entering: rpm -qa | egrep 'AWCommon|Maya' 3 Identify each package name you want to uninstall. For example, you may see the following package: Maya-8_5-# You may also see the AWCommon packages, which are used for licensing: AWCommon-10.80-# AWCommon-server-10.80-# Note 4 Uninstalling the AWCommon software does not affect any license files in the license directory (/var/flexlm). Uninstall each listed package using the following command: rpm -e Package where Package is the name obtained in the previous step. Installation and Licensing Guide 50 5 | Installing Maya for Linux > Additional Linux notes Additional Linux notes These additional Linux user notes provide special information for configuring Maya to run on Linux, describe differences between Maya for Linux and other versions of Maya, and provides other information specific to using Maya on the Linux operating system. For complete information on limitations and possible workarounds, also refer to the Maya 8.5 Release Notes. Compiling plug-ins and standalone programs To compile plug-ins and standalone applications for Maya 8.5 on Linux, use the released gcc 4.0.2 compiler. Maya has been compiled with this compiler under RHEL 4 WS. As well, some libraries and symbolic links are installed in the /lib directory under your Maya directory, and should not interfere with the normal operation of your Linux system. For more information, see “Compiler Requirements” on page 247, “Linux environments ( 32-bit and 64-bit )” on page 247, and “Linux compiler requirement” on page 249 in the API Guide. Differences in operation When installed on a Linux system, Maya works in much the same way as when installed on Windows. Using the MayaScheme file to set fonts, font sizes, and colors Fonts, font sizes, and colors can be configured using the MayaScheme file. This file lets you specify X Resources that Maya uses for configurable text. The default file is found in /usr/aw/maya8.5/app-defaults/MayaScheme. Copy this file to your home directory’s $HOME/app-defaults directory so that it can be edited. Refer to the Maya 8.5 Release Notes for any known limitations. Unsupported Maya features Some of the features in the Windows versions are not currently supported. These include output to AVI or SGI movie formats. Please refer to the Maya 8.5 Release Notes for more information. Installation and Licensing Guide 51 5 | Installing Maya for Linux > Additional Linux notes Linux desktop configuration To use Maya on Linux, certain default keyboard and mouse bindings must be changed from the factory settings. These default bindings prevent commands from being received by Maya, such as the ones that let you tumble or pan a view in a panel. Different Linux window managers have different key bindings and different procedures for setting them. Linux systems are highly customizable, and many combinations of Linux system components are possible for use with Maya—more than can be described (or tested) by Autodesk. The following instructions give the procedures necessary for changing the most common configurations. KDE and Gnome desktop configuration For Maya to work properly with KDE and Gnome, some modifications should be made to the mouse control. The default bindings of the Alt key and mouse buttons do not work well with Maya. We recommend turning off the Alt+mouse buttons. Since Maya uses the Alt+mouse buttons for scene view tumbling, you need to ensure the bindings don’t conflict. Different versions of KDE and Gnome may have different methods of selecting the key bindings. See the KDE and Gnome documentation for instructions if the following steps don’t work for your particular window manager. KDE under Red Hat 1 Open the KDE Control Center. 2 Select Desktop and then select Window Behavior. 3 Do one of the following: 4 • (Red Hat Enterprise Linux WS 4.0) Open the Actions tab. • (Fedora Core 5) Open the Window Actions tab. In the following section: • (Red Hat Enterprise Linux WS 4.0) Inner Window, Titlebar & Frame • (Fedora Core 5.0) Interactive Inner Window, Inner Window, Titlebar & Frame Installation and Licensing Guide 52 5 | Installing Maya for Linux > Additional Linux notes For modifier key Alt, set all mouse action combinations to Nothing. Alt Set to ‘Nothing’. Alt Set to ‘Nothing’. 5 Click Apply and close the Control Center. Gnome under Red Hat 1 Open the Gnome Panel. 2 Select System, then Preferences and then select Windows. Installation and Licensing Guide 53 5 | Installing Maya for Linux > Additional Linux notes 3 In the Window Preferences dialog box, set the “To move a window...” key to Super. (Setting either Control or Alt here may cause problems when using Maya.) 4 Click Close. Installation and Licensing Guide 54 6 Installing the Shader Library Installing the Maya Shader Library After installing Maya, you can install the Maya Shader Library, which is a collection of Maya scene files consisting of over 60 shading networks, including materials and file textures. To use the Shader Library, you can: • run it from your local machine • run it from the server • run it from the DVD In order to run it from your local machine, you have to copy the entire shader library directory and its contents to your computer. The Shader Library is about 110MB. If multiple users will be accessing this library, put it in a location where all users have read access. We recommend that you update each user’s Maya.env file so that Maya knows where you’ve stored the Shader Library. You can also set up a Shader Library tab in Hypershade. To install the Maya Shader Library 1 Insert the Maya DVD into your computer’s drive. 2 Copy the shaderLibrary folder from the PDFs_and_Extras folder to your computer. For Windows and Linux, copy it into the Autodesk program directory. For Mac OS X, copy it into a special folder in the shared users directory. By default this is: • (Windows) C:\Program Files\Autodesk\ • (Mac OS X) /Users/Shared/Autodesk/maya/ • (Linux) /usr/aw Installation and Licensing Guide 55 6 | Installing the Shader Library > Installing the Maya Shader Library Note Alternatively, you can access the Shader Library from the DVD or copy the shaderLibrary directory to another location in your own home directory and set the following environment variables. (Windows, Linux) To update the Maya.env file with new environment variables In the user’s Maya.env file set the following environment variable (for example): MAYA_SHADER_LIBRARY_PATH = /usr/aw/shaderLibrary MAYA_SHADER_LIBRARY_PATH = C:\Program Files\Autodesk\shaderLibrary\ For Mac OS X, the value is preset for you. Once you install the Shader Library, you’ll see a Shader Library tab in the Hypershade. For more information about setting environment variables, see the Environment Variables section in the Maya Help. Installation and Licensing Guide 56 7 Installing mental ray for Maya satellite Overview of mental ray (satellite) mental ray for Maya supports a different form of network rendering: mental ray satellite rendering. The new network rendering capability, based on mental ray satellite technology, allows you to install a version of mental ray (satellite) on any networked computer. This special version of mental ray resides on that machine and waits for rendering tasks from Maya. It supplements the mental ray rendering capabilities in Maya with the additional rendering power provided by the networked computers’ CPUs. A mental ray distributed rendering can speed up all of the following tasks: • interactive rendering (through the Maya interface) • IPR rendering with mental ray for Maya • interactive batch rendering (a batch render started by Maya) • command-line rendering The rendering process is typically initiated from the master machine (the machine running Maya or where the command-line render starts from). The slave machines (satellite rendering computers) process rendering tasks they receive over the network from the master and send back results. The master machine handles task distribution, load balancing, and the collection of received rendering tasks which make up the rendered image. For more information about mental ray satellite, including how to set up the rayhosts file to get and receive data from Maya, see the Maya Help. In the Maya Help, navigate toUsing Maya > Rendering and Render Setup > Rendering > mental ray for Maya rendering > Network rendering. Setting up the rayhosts file is required for mental ray for Maya satellite rendering to work. Installation and Licensing Guide 57 7 | Installing mental ray for Maya satellite > Slave machine installation Slave machine installation The special version of mental ray standalone with satellite rendering technology must be installed on all slave machines. The satellite-enabled versions of mental ray for Windows, Mac OS X, and Linux are included with this release of Maya on the Maya DVD. (Windows) To install mental ray standalone with satellite licensing 1 On each slave machine, begin the installation process by inserting the Maya DVD, opening the mental ray satellite folder and the platform-specific Windows folder, and double-clicking the mental ray standalone installer. MentalRay-Satellite8.5.exe The installer appears. 2 Follow the installation steps. During the installation, you can click Custom to change the installation directory. The default installation directory is: C:\Program Files\Autodesk\mentalraysatellite8.5\ (Mac OS X) To install mental ray standalone with satellite licensing 1 On each slave machine, begin the installation process by inserting the Maya DVD, opening the mental ray satellite folder and double-clicking the mental ray standalone installer. mrsat8.5.dmg The disk image mounts. 2 Double-click mrsat8.5. 3 Follow the installation steps. During the installation, you can change the installation directory. The default installation directory is: /Applications/Autodesk/mentalray Satellite 8.5 (Linux) To install mental ray standalone with satellite licensing using rpm 1 Log in as root. Installation and Licensing Guide 58 7 | Installing mental ray for Maya satellite > Slave machine additional setup 2 On each slave machine, begin the installation process by inserting the Maya DVD. 3 Mount the DVD drive. For example, type: 4 Open the mental ray satellite directory, go to the platform-specific linux directory, and enter the following command (where # is the specific package number): mount -r /dev/dvd /mnt/dvd (32-bit) rpm -ivh mental_ray_satellite8.5-#.i686.rpm (64-bit) rpm -ivh mental_ray_satellite8.5-#.x86_64.rpm Note 64-bit Windows and 64-bit Linux releases of mental ray for Maya satellite use the same port and service name as the 32-bit versions. You will run into problems if you install both the 32-bit and the 64-bit versions on a 64-bit system. There is only one service entry/xinetd config, so installing a 64-bit package after the 32-bit (or the other way around) leaves only the last installed version working. Slave machine additional setup Once this version of mental ray is installed and running, a service on the machine (the Ray Sat server) waits for rendering tasks from mental ray for Maya on the master machine. The satellite-enabled version of mental ray does not require its own licensing; it is activated through Maya’s licensing. On the slave machine, the Ray Sat server must be running. To verify that it is running on Windows, follow this procedure. To verify that Ray Sat server is running (Windows) 1 Open a Windows command prompt. 2 Navigate to the /bin directory of the mental ray satellite standalone. By default this is C:\Program Files\Autodesk\mentalraysatellite8.5\bin\. 3 Type the following: Installation and Licensing Guide 59 7 | Installing mental ray for Maya satellite > Slave machine port setup raysat85server /query A message should be returned that the RaySat85 Server service is running. If you do not get this message, make sure that RaySat85 Server has been installed as a service, and start it from the Services Control Panel (Settings > Control Panel > Administrative Options > Services) or type the following: raysat85server /start Slave machine port setup On the slave machine, port number 7106 is set by default. This works well in the majority of cases and you won’t need to change the port number. If you want to change the port number that mental ray satellite uses to a value other than 7106, you must edit the services file. The port value would be determined by your network administrator (a free TCP/IP port). To change the port number (Windows, Linux) 1 Edit the services file with a text editor. The services file is located at: • (Windows 2000) C:\WINNT\system32\drivers\etc\services • (Windows XP) C:\Windows\system32\drivers\etc\services • (Linux) /etc/services Note If you are running 32-bit mental ray satellite on a 64-bit system, the services file is found at: C:\Windows\SysWOW64\drivers\etc\services 2 Change the number in the following line (here, 7106) to the desired port number: mi-raysat85 7106/tcp Installation and Licensing Guide 60 7 | Installing mental ray for Maya satellite > Licensing of satellite rendering To change the port number (Mac OS X) 1 Launch the NetInfo manager (/Applications/Utilities/NetInfo Manager) 2 Navigate to /, then services, then mi-raysat85. 3 Click on the lock icon to authenticate and change settings, including the port number (by default, this is 7106). Tip You can also use the nitutil command-line utility to change the configuration of mental ray satellite. Licensing of satellite rendering For more details about licensing of Maya, see the Licensing chapter of this guide. Your version of Maya determines how many networked CPUs running satelliteenabled mental ray standalone can participate in a render: • Maya Complete – 2 additional networked CPUs • Maya Unlimited – 8 additional networked CPUs For standalone licenses, the use of mental ray for Maya with satellite can only be initiated from the specified host for which your received your Maya key. The workstation can distribute mental ray for Maya rendering to either two or eight slave CPUs depending on your license. For networked licenses, use of the functionality is slightly more flexible. Depending on the type of Maya license you purchased, you additionally have either a mental ray for Maya Complete or mental ray for Maya Unlimited line item in your license. (These line items listed in the license file define separately licensed features under a overall Maya license.) For networked license setups, the license running Maya and the license running mental ray for Maya can be logged out separately allowing certain rendering tasks to be initiated remotely. Installation and Licensing Guide 61 7 | Installing mental ray for Maya satellite > Licensing of satellite rendering There are two possible cases when using mental ray for Maya with networked licenses: • (Interactive) With Maya running interactively on a workstation, initiate a mental ray for Maya render (either a single frame in the Render View, Batch render or command line render) on the workstation. The networked mental ray for Maya portion of your license is logged out. This allows the mental ray satellite slaves indicated in your rayhost file to participate in the render. The type of license you purchased controls whether you can use up to 2 or 8 mental ray standalone slave CPUs on other computers. • (Offline) If you launch a command line mental ray for Maya render from any computer that is not a Maya workstation (and the interactive version of Maya is not running), the mental ray for Maya license which allows the largest number of slaves (that is, Maya Unlimited) in your license server will be checked out first. The computer you launched the command from then becomes the master machine for mental ray for Maya satellite rendering. Note If you have launched Maya but have not yet rendered with mental ray for Maya since the start of your interactive session, no mental ray for Maya line item from your networked license is checked out. You may therefore start a command line mental ray for Maya render from another host. This checks out the mental ray for Maya portion of the license, making it unavailable for any other workstation, including the workstation of the user who launched Maya. This licensing behavior can be overridden using the -lic mc flag with the Render -r mr command. Render -r mr -lic mc attempts to check the mental ray for Maya Complete line item within the license first, and then the Unlimited line item within the license if a Complete line item is not available. For more details on mental ray rendering, see the Rendering sections of the Maya Help, as well as the mental ray reference included with the Maya Help. Installation and Licensing Guide 62 8 Installing license server software Installing license server software For more details on licensing, see “Licensing Maya” on page 65. If you are setting up a networked license server for Maya licenses, you do not need to install Maya on the license sever machine. You only need to install the licensing software on that machine. • On Windows, you only need to install the Autodesk License Server package, available as a Custom install. For more information, see “Installing Maya (Windows)” on page 22. • On Mac OS X, you only need to install the Autodesk License Server package, available in the Additional Items folder on the Mac OS X partition of the Maya DVD. For more information, see “Software that can be installed separately” on page 40. • On Linux, you only need to install the AWCommon packages. For more information, see “Installing Maya (Linux)” on page 46. For the latest server software as well as server software for other platforms that support license server software for Maya, go to: www.autodesk.com/licensetools Installation and Licensing Guide 63 8 | Installing license server software > Installing license server software Installation and Licensing Guide 64 9 Licensing Maya Who should use this chapter If you are a new customer, you can follow the instructions in the Quick Start Licensing chapter, Chapter 2 of this guide. For more information, see “Quick Start: How to activate your copy of Maya” on page 11. If you are an existing Autodesk customer: • your license may already be installed for you when you install Maya The license installation process uses the Prekey file on the Maya DVD. A message during the software installation tells you if the license wasn’t installed. For more information, see “Prekey” on page 70. If your licenses were not automatically installed during the installation process, you may still be able to obtain and install your licenses. For more information, see “Webkey” on page 70. If your licenses are still not installed, follow the instructions in this chapter to obtain and install your licenses. Even if you are an existing Autodesk Maya customer, you must go through the process of obtaining and installing a license if: • you are changing to a new Maya package (for example, from Complete to Unlimited) • you are relocating Maya to a different computer • you are adding additional licenses to a networked license. For more information about networked licenses, see “Overview of licensing: some definitions” on page 66. • your license was not found in the Prekey or Webkey files Continue in this chapter: • if you want a detailed explanation of how licensing works • if you’re setting up multiple copies of Maya that are getting their license from a license server (see “Additional setup for networked licenses” on page 84). Installation and Licensing Guide 65 9 | Licensing Maya > Who should use this chapter Overview of licensing: some definitions All customers must have a software license to run Maya. A license is a coded record of your software purchase. The license resides in a license file on your machine or a license server machine. Whenever a Maya session is launched, the license management software, FLEXlm, searches the license file to check out a license for that session. Serial Number A record of what you purchased from Autodesk, required for obtaining a license through Online Product Activation. For example: MCF030-B-3322-0933-7182-1111-0000 or 123-45678901 If you did not receive a serial number when you purchased your Autodesk product, contact your local Autodesk sales office or your reseller. Hardware ID (Host ID) An alphanumeric code that identifies the machine that is authorized to run the software, required for Online Product Activation. This number can be an ethernet ID (also known as a MAC Address) or a hardware key (dongle). Online Product Activation (OPA) An automated activation process where you submit an online form with your serial number and hardware ID, and a license is automatically generated and sent back. Product Configuration Wizard An Autodesk tool that uses Online Product Activation to allow you to request and install your license. Prekey An encrypted file containing license data for existing Autodesk Maya customers who are entitled to get the latest software version. Installation and Licensing Guide 66 9 | Licensing Maya > Who should use this chapter Standalone license (Node-locked license.) A license for a single computer. It lets you run Autodesk Maya only on the computer where the license is installed. (Or, in the case of hardware locks, on the computer where the hardware lock is attached.) Standalone licenses look similar to the following sample: FEATURE Maya sgiawd 8.500 09-jan-2006 \ uncounted 7CD390F11000 HOSTID=000000000000 Network license (Floating license.) A license to be shared by various computers on a network. The Autodesk Maya software is installed on many computers, each with a license file that accesses the network license server. Network licenses require client and server setup. Network licenses look similar to the following sample: SERVER pc-server 000000000000 7111 VENDOR sgiawd FEATURE Maya sgiawd 8.500 10-nov-2005 1 \ FC29A6FBF000 License file A file with encrypted data that enables Autodesk Maya to run on your machine. Hardware lock A hardware lock (dongle) allows you to run Maya on different computers (one computer at a time) without having to obtain a unique license for each computer. To run Maya on different machines, you move the hardware lock. You must have a duplicate of the license file on each computer. The software is licensed to the hardware lock rather than the computer’s hardware ID. A hardware lock attaches to the USB port of your computer. Client In network license configurations, the machine that requests a license from the license server Installation and Licensing Guide 67 9 | Licensing Maya > Who should use this chapter Server In network license configurations, the machine that provides licenses as requested by users on client machines. Note If you purchased a USB hardware lock (dongle) from Autodesk for your Maya license, or own a parallel port dongle for Windows, see “Installing your hardware lock” on page 69. If you have problems configuring your hardware lock, see “Confirming hardware lock driver activation” on page 98 or go to: www.autodesk.com/maya-support License file The location and name of the license file is: • (Windows) C:\FLEXLM\aw_servername.dat or aw.dat, where servername is the name of your license server. • (Mac OS X) /var/flexlm/aw_server.dat, aw_client.dat, or aw.dat. • (Linux) /var/flexlm/aw.dat or /var/flexlm/aw_servername.dat, where servername is the name of your license server. The licensing process comments out licenses for previous versions of Maya, but leaves them otherwise intact. Licenses are backwards compatible; that is, a Maya 8.5 license lets you run previous versions of Maya. Note If you’re an existing customer on Windows, plug the hardware lock into the computer before running the installer so that the install process can detect that ID. If you’re on Mac OS X, plug your hardware lock in after installation. Installation and Licensing Guide 68 9 | Licensing Maya > Who should use this chapter Installing your hardware lock • Be careful not to force the lock into the parallel port or USB port incorrectly. Secure the parallel connector with the thumb screws so it won’t fall off and interrupt a Maya session. • If you go through the licensing process and it fails to detect the hardware lock, you may need to reboot. As well, see “Confirming hardware lock driver activation” on page 98. • To avoid damaging a lock, exit Maya or stop Maya license server operation before removing the lock. For details, see “(Windows) To stop and start the license server” on page 85, “(Linux) To start the license server” on page 86, and “(Mac OS X) To start the license server” on page 87. Where is your serial number? New customers who purchase Maya receive a serial number in one of the following ways: • in an email from your reseller or from Autodesk • on a sticker in your Maya package Note Email filters may prevent you from seeing your license email, Look in your spam folder for email from <opauser@alias.com> with a subject line of ‘Software Product Activation Serial Numbers’. After installing Maya and entering the serial number, new customers obtain a Maya license to activate their software. For more information, see “Activating the software from a serial number” on page 72. Installation and Licensing Guide 69 9 | Licensing Maya > Prekey Your software may already be licensed Prekey If you are an existing Autodesk customer, your licenses may already be installed for you when you install Maya, using the Prekey file on the Maya DVD. There may be a brief delay while the installation software searches the Prekey file. To see if you’ve been licensed by the Prekey licensing process, try to run Maya. If your license was found in the Prekey file, Maya starts up properly and no further action is required. However, even if you are an existing customer of Autodesk, your license may not be included in the Prekey file. In this case, Maya will not start and the Product Configuration Wizard will appear instead. Autodesk provides several different ways for you to obtain and install your license. For more information, see “Webkey” on page 70 and “Activating the software from a serial number” on page 72. Webkey If you are an existing Autodesk customer and your licenses were not installed during installation, you can obtain and install your licenses from the Webkey file on the Autodesk Web site. Getting the Webkey using the Autodesk Product Configuration Wizard 1 Start Maya. If you have not licensed Maya, the Product Configuration Wizard appears. If the Product Configuration Wizard does not appear, you can launch it by doing one of the following: • (Windows) Go to Start > Program Files > Autodesk > Maya 8.5 > Licensing. • (Mac OS X) In /Applications/Autodesk/PCW/, double-click the Autodesk Product Configuration Wizard icon. Installation and Licensing Guide 70 9 | Licensing Maya > Webkey • (Linux) Enter the following command in a shell: /usr/aw/maya8.5/bin/opa 2 Expand all icons and select Download license upgrades for Maya 8.5. 3 Click Next. 4 You may be asked to identify a Web browser. Once you have chosen a Web browser, click Next. A Web browser window opens, displaying the Maya Webkey web page. Instructions on this Web page describe how to download and install the Webkey file. You can also browse to the following URL in your Web browser to obtain the Maya Webkey file: www.autodesk.com/maya-webkey Installation and Licensing Guide 71 9 | Licensing Maya > Activating the software from a serial number Note If you run Maya on several different operating systems, you need to download and install the Webkey file for all operating systems that currently have Maya licenses, including license servers and any computers running Maya with a standalone license. You do not need to download or install the Webkey file for any client machines that obtain their licenses from a license server. Activating the software from a serial number Note: You can follow the instructions in the Quick Start Licensing chapter, Chapter 2 of this guide. For more information, see “Quick Start: How to activate your copy of Maya” on page 11. The following procedures explain how to license Autodesk Maya. New customers who purchase Maya receive a serial number in one of the following ways: • in an email from your reseller or from Autodesk • on a sticker in your Maya package 33-character Maya serial numbers always begin with the letters ‘MC’ or ‘MU’. 11character Maya serial numbers are three numbers, followed by a dash, followed by eight numbers. For example: MCF030-B-3322-0933-7182-1111-0000 or 123-45678901 If you did not receive a serial number, contact your local Autodesk sales office or your reseller. You need a serial number to begin the activation process. After installing Maya and entering the serial number, you will receive a license for your copy of Maya via email. Installation and Licensing Guide 72 9 | Licensing Maya > Activating the software from a serial number The following instructions apply to all supported platforms. The easiest and fastest way to get a license is to license the machine running Maya via an Internet connection. Note What if the computer running Maya is not connected to the Internet? You can obtain a license for your computer running Maya even if your computer is not connected to the Internet. To do so, use another computer that is connected to the Internet. 1 Record the hardware ID of the computer that is not connected to the Internet from the Product Configuration Wizard. Also, have your serial number ready. 2 On the computer that is connected to the Internet, go to the following URL: www.autodesk.com/opa Enter the serial number, hardware ID, and other information from the computer you want to obtain a license for in the form provided. When you receive the license, follow the instructions in the next section (“Installing a license” on page 79) to license the computer you want to use. To obtain a license by online product activation 1 When you complete the install, start Maya. The Autodesk Product Configuration dialog box appears (the appearance of this dialog box varies depending on which platform you’re running Maya). Installation and Licensing Guide 73 9 | Licensing Maya > Activating the software from a serial number 2 Click I have a serial number that I need to activate and click Next. The following dialog box appears. Installation and Licensing Guide 74 9 | Licensing Maya > Activating the software from a serial number 3 Choose whether your serial number has 33 characters, or whether it’s an 11 character (3-8) serial number and click Next. One of the following dialog boxes appears. You are prompted to enter your serial number. Enter it and click Next. 4 Identifying your hardware ID. A dialog box appears prompting you to make sure your USB or parallel port hardware lock (dongle) is connected. If you have a hardware lock (dongle), please make sure it is plugged in now. The following dialog box appears. Installation and Licensing Guide 75 9 | Licensing Maya > Activating the software from a serial number Your hardware ID (also known as the hardware identifier or Host ID) is listed in this dialog box. The hardware ID is a way of uniquely identifying your computer by using an encrypted form of your ethernet address (or the FLEXID of your parallel port/USB hardware lock). Notes • If there are multiple hardware IDs, choose the appropriate one. For example, if you are installing Maya to a laptop that has a dock, you may see two Ethernet addresses, or a different ethernet address than the one that appears when the laptop is not docked. Make sure you choose the Ethernet address that is always with your computer (active whether or not your computer is connected to the network). • If you are using a hardware lock (dongle) to license Maya, you must choose the appropriate hardware ID (from the list that appears) that contains the FLEXID number for your hardware lock and not the Ethernet ID for your computer. The hardware lock ID begins with the letter F, whereas the Ethernet address begins with the letter E. Installation and Licensing Guide 76 9 | Licensing Maya > Activating the software from a serial number If you are licensing via hardware lock and the hardware lock ID does not appear in the following hardware identifiers screen, we suggest you reboot your machine. If the hardware lock ID still does not appear in the list of hardware identifiers the hardware lock may not be properly attached or the hardware lock driver may not be activated. For further information, see “Installing your hardware lock” on page 69. 5 Click Next. The following dialog box appears. You must request a license to use Maya. The fastest and easiest method is to use a Web browser to request your license. After you fill out an online form, the license will be displayed on the screen and sent to you promptly by email. This method is selected by default; click Next to proceed. (You can request a license by email. Click Show All Ways of Making an Activation Request to select this alternative method, which will take longer to process—typically, several days.) 6 If you are obtaining your license via the web site, select your browser in the next screen. Your browser launches and takes you to the Autodesk web site. On the Autodesk Product Activation web site, fill out the web pages. Follow the online instructions to obtain your license. Installation and Licensing Guide 77 9 | Licensing Maya > Activating the software from a serial number When you submit the form, your license is displayed in your web browser and sent to the email address you specified. 7 Click Next. The following dialog box appears. 8 Open the email you received, copy the license data, and paste it in this dialog box. A message will let you know if the data is valid or not. When you are finished entering the license data and it is verified by the program, click Next. (If the license data is not valid, the Next button is greyed out and you cannot proceed to the next step.) When you click Next with a valid license, this automatically installs your license and you are prompted to start Maya. For more information about messages that may appear during or just after this process, see “Licensing notes” on page 82. Installation and Licensing Guide 78 9 | Licensing Maya > Installing a license Installing a license Use these instructions if: • You have already obtained a standalone license from Autodesk and need to install it to activate your software. (See “Activating the software from a serial number” on page 72 if you have not obtained your license.) • You are setting up a networked license server on Windows and already have a license for it. Do not use these instructions if: • You have a serial number but have not yet received a license. See “Activating the software from a serial number” on page 72.) Note Email filters may prevent you from seeing your license email, Look in your spam folder for email from Autodesk Online Activation <opa@alias.com> with a subject line that starts with ‘license’ . To install your license 1 Once you’ve received your license via email, launch the Product Configuration Wizard if necessary by doing one of the following: • (Windows) Go to Start > Program Files > Autodesk > Maya 8.5 > Licensing. • (Mac OS X) In the Maya directory (by default, this is /Applications/ Autodesk/Maya8.5/), double-click the Autodesk Product Configuration Wizard icon. • (Linux) Enter the following command in a shell: /usr/aw/maya8.5/bin/opa 2 Go to the Autodesk Product Configuration dialog box. Installation and Licensing Guide 79 9 | Licensing Maya > Installing a license 3 Select I have a license that I need to install and click Next. The following dialog box appears: 4 Choose whether to install your license from a file, to or copy and paste it from the email you receive, and click Next. Installation and Licensing Guide 80 9 | Licensing Maya > Installing a license One of the following dialog box appears. 5 Do one of the following: • If you are pasting or typing the license... The Enter License Data window provides a text input field where you can either type the license feature information or paste the data from an email or other text file. A message will let you know if the data is valid or not. When you are finished entering the license data and it is verified by the program, click Next. (If the license data is not valid, the Next button is greyed out and you cannot proceed to the next step.) • If you are installing from a file... Click Browse. A file browser appears. Browse to the location where you stored the license file. By default, you can only select files with the .dat suffix. When you click on a file, it is automatically checked for a valid license. Installation and Licensing Guide 81 9 | Licensing Maya > Installing a license A check mark appears if the selected file contains a valid license. Click Next to continue. An “X” symbol indicates the selected file does not contain a valid license. The file may not have a valid format, it may not contain a valid license, or it may contain a license for a hardware ID other than your own. Select another file, or edit the file so that it uses the right format or contains a valid license. The Next button is greyed out and you cannot proceed to the next step until you select a valid file. When you click Next with a valid license, this automatically installs your license and you are prompted to start Maya. Licensing notes Note On Windows, the Product Configuration Wizard may display a message indicating that you do not have permission to save the license file to the directory C:\FLEXLM. A file browser appears where you can save the license to a different location. You need to have permissions set correctly on C:\FLEXLM to move the license file there. Talk to a system administrator to get permissions set for this directory. On Mac OS X, you may be prompted for your administrative password if your current user account lacks permission to write a file to /var/flexlm. Installation and Licensing Guide 82 9 | Licensing Maya > If the licensing is not successful Tip If you need to use the Product Configuration Wizard again, you can launch it by doing one of the following: • (Windows) From the Start menu, go to Program Files > Autodesk > Maya 8.5 > Licensing. • (Mac OS X) Double-click the Maya Product Activation icon in the Applications/Autodesk/maya8.5/ folder. • (Linux) Run /usr/aw/maya8.5/bin/opa If the licensing is not successful If the license installation is not successful, an “Installation Incomplete” window appears. • Click the Show Installation Log button to read a log to find out what went wrong. • Go to “Troubleshooting licensing: introduction” on page 95 for more details on what to look for. To request a license if you don’t have a serial number On any browser (it does not need to be the same machine as the one currently being licensed), access and complete the online SPAR (Software Product Authorization Request) form at: www.autodesk.com/spar Autodesk processes your request and provides you with the license via e-mail. Installation and Licensing Guide 83 9 | Licensing Maya > Additional setup for networked licenses Server setup Additional setup for networked licenses To configure your machines to serve and receive licenses across the network, you must set up the license server machine (“Activating the software from a serial number” on page 72 and “Installing a license” on page 79), then set up each client computer that obtains a license from the server. (Servers can serve a license to themselves.) Notes • If you are serving Maya 8.5 licenses, you must install the current version of the server software on the license server and restart the license service. • (Windows) If a server or client does not have a C: drive, you can set the environment variable SGIAWD_LICENSE_FILE. Please see the Environment Variables section of the Maya Help. • Your license server can serve licenses to workstations on all supported platforms (Windows, Linux, Mac OS X). This requires that the computers can access each other via TCP/IP. (Windows) License server management options and license server confirmation To set options and start the license server 1 Select Start > Programs > Autodesk > Common Utilities > FlexLM License Utilities. 2 In the LMTOOLS window, click the Service/License File tab and select the Configuration using Services option. 3 Click the Config Services tab. 4 Turn on Use Services. 5 Turn on Start Server at Power Up. Installation and Licensing Guide 84 9 | Licensing Maya > Additional setup for networked licenses 6 Check that the values shown are correct: • Path to the lmgrd.exe file is C:\Program Files\Common Files\ • Path to the license file is: C:\FLEXLM\aw_servername.dat, where servername is the name of the license server machine. Note The path to the debug log file is optional and can be left blank. Alias Shared\Licensing\etc\lmgrd.exe 7 Click Save Service. 8 Click the Start/Stop/Reread tab and click Start Server. (Windows) To confirm the license server operation 1 Click the Server Status tab. 2 Click Perform Status Enquiry. If the license server is up, the window displays: <servername>:license server UP(MASTER) where servername is the license server computer name. The text area should also list the products/features and the number of logins you have. 3 Close LMTOOLS. (Windows) To stop and start the license server 1 In the LMTOOLS window, Service/License File tab, make sure Configuration using Services is turned on. 2 Click the Start/Stop/Reread tab, click Stop Server, and then Start Server. (Windows) Checking whether the license server is running You can use the Windows Task Manager to tell whether the license server is running. Do the following steps on the license server computer. To check license server status 1 Press Ctrl+Alt+Delete on your keyboard. The Task Manager appears. Installation and Licensing Guide 85 9 | Licensing Maya > Additional setup for networked licenses 2 Click Task Manager. 3 Click the Processes tab. If lmgrd.exe and sgiawd.exe are in the list of processes, the license server is up. If neither are in the list, the license server is down. If only one is in the list, the license server is partially up. In this case, restart the computer. (Linux) License server management options and license server confirmation (Linux) To start the license server 1 Log in as root if you have not done so. 2 Check to see that the aw_flexlm script is installed in the following directory: /etc/rc.d/init.d/ 3 Stop then start the lmgrd daemon by entering the following commands: /etc/rc.d/init.d/aw_flexlm stop /etc/rc.d/init.d/aw_flexlm start • If the server was on previously, the command issues some status information. An example of this status information is: lmdown - Copyright (C) 1989-2004 Macrovision Corporation. All rights reserved. Shut down FLEXlm server on node servername 1 FLEXlm License Server shut down • If the server is already off, the command issues an error message similar to: lmdown - Copyright (C)2004 Macrovision Corporation. All rights reserved. Connection to "servername" failed: Cannot connect to license server(-15,12:146) Connection refused where servername is the name of the server machine. You can ignore this error message. • If the server starts successfully, the status message should look similar to this: License file = /var/flexlm/aw_servername.dat FLEXlm Licensing daemon for Alias software: /usr/etc/lmgrd Installation and Licensing Guide 86 9 | Licensing Maya > Additional setup for networked licenses 4 Log out of root. (Linux) Additional troubleshooting steps If you are having problems starting your licensing server, and stopping and then restarting your service as in the above instructions does not solve your problem, do the following: 1 Type the following, and then press Return. 2 Type the following, and then press Return. killall lmgrd /usr/aw/COM/etc/lmgrd -c <path to license file> 3 View the log file at the following location: 4 Type the following, and then press Return to see if the license manager is running in the process list. For example: /usr/tmp/aw_flexlm.log ps -aef | grep lmgrd (The ps command may have different options in your shell.) This confirms that the daemon is now running. For further information on troubleshooting networked license issues see “Troubleshooting licensing problems (Linux, Mac OS X)” on page 100. (Mac OS X) License server management options and license server confirmation Note Mac OS X Server is not supported by the FLEXlm licensing software. (Mac OS X) To start the license server 1 In the following section, you’re going to use sudo—the special Mac OS X command that executes other commands with the highest level of user permissions—to start the license server. You must authenticate sudo each Installation and Licensing Guide 87 9 | Licensing Maya > Setting up each client time you use it. The following commands must be run by someone who has administrator privileges on the machine.Start the license server by typing the following in Terminal. (You may be prompted for your password.) sudo /usr/aw/COM/bin/aw_flexlm start If you’re using the Maya Terminal, you do not need to type the path. 2 To confirm the server has started, type the following in Terminal: 3 If the server has started successfully, you should see output that contains the line License server UP (MASTER) v10.8. 4 Launch Maya to see if the licensing setup has worked. sudo /usr/aw/COM/bin/lmstat -c /var/flexlm/aw_server.dat Client setup Setting up each client To set up each client, you must add information to each client computer’s aw_servername.dat file (on Mac OS X, aw_client.dat). Note You can run Maya locally on the license server computer using its existing aw_servername.dat or aw_server.dat file, so you don’t need to do the following steps on the server. To set up a client 1 Make sure the license server and client can access each other through your TCP/IP network. 2 Do one of the following: • (Windows) Go to Start > Program Files > Autodesk > Maya 8.5 > Licensing. • (Mac OS X) In the Maya directory (by default, this is /Applications/ Autodesk/Maya8.5/), double-click the Autodesk Product Configuration Wizard icon. Installation and Licensing Guide 88 9 | Licensing Maya > Setting up each client • (Linux) Enter the following command in a shell: /usr/aw/maya8.5/bin/opa 3 In the Product Configuration Wizard, expand the icons, then click I have a license that I need to install. The Install License screen of the Product Configuration Wizard appears. 4 Select I would like to type or paste in my license file and click Next. 5 In the text area provided, type: SERVER server 0 7111 USE_SERVER Change the word server in the first line to match your machine name. For example, if the machine is myserver, it would appear like this: SERVER myserver 0 7111 USE_SERVER The SERVER and USE_SERVER lines tell the client which computer serves the licenses. 6 Press Enter to leave a blank line at the end. Errors in the license are highlighted in red; the text turns black when the license is valid. 7 Click Next to save the file to the default location: • Windows: C:\FLEXLM • Mac OS X, Linux: /var/flexlm/ The License Installation Results screen appears. You can click Show Details if you want more information on the license that was installed. While you can go through this series of steps on each machine, once you have created the first aw_servername.dat file, you can copy it to the C:\FLEXLM or /var/flexlm/ directory on the other clients. This completes the licensing procedure for networked licenses. Installation and Licensing Guide 89 9 | Licensing Maya > Limiting the use of Maya Unlimited product licenses Note You can use an IP Address instead of the name of the server. For example, a license file named aw_myserver.dat on a client machine that is referencing the IP address would look like this: SERVER 10.0.0.10 0 7111 USE_SERVER Copying license files to other clients While you can go through this series of steps on each machine, once you have created the first aw_servername.dat file, copy it to the /var/flexlm or C:\FLEXLM\ directory on the other clients. When copying a file from a Windows machine to a Mac OS X or Linux machine, there may be DOS control characters in the license file. You can remove them by using the tounix utility or a similar utility or text editor that ensures your license file is in the proper format. Limiting the use of Maya Unlimited product licenses Some users on your network may not need to use all the Maya features available to them. You can disable availability of optional licenses for specific users to ensure that those who need them have them on demand. For example, suppose your network has several Maya Complete licenses, but only one Unlimited license. To prevent some users from using the Unlimited license, you can control which users will not receive the Unlimited license. You can include a line in each user’s Maya.env file, for example: MAYA_LICENSE = complete For details on how to set up the Maya.env file, see the Environment Variables guide in the Maya Help. Alternatively, you can set an environment setting. Installation and Licensing Guide 90 9 | Licensing Maya > Confirming Maya startup Note MAYA_LICENSE setting Effect on Maya complete Runs Maya Complete only unlimited Runs Maya Unlimited only If the MAYA_LICENSE is set to Complete and there are no Complete licenses available, even if there are Unlimited licenses, the software will not run and will display a “No Licenses Available” message. Sometimes, a user may need to use Maya Unlimited temporarily. Instead of editing the startup file, you can inform the user to start Maya with the following command, which overrides the startup setting: maya -lic=unlimited Other considerations • If you repeat a command option or MAYA_LICENSE setting, Maya uses the last setting. • A command line option takes precedence over a conflicting environment variable setting. Finishing installation Confirming Maya startup Start Maya to confirm installation. The main Maya window opens. The display of the main Maya window confirms you’ve installed and licensed Maya. Installation and Licensing Guide 91 9 | Licensing Maya > Verifying license server installation If an error message appears instead of the Maya window, it’s possible you have a licensing problem. See “Troubleshooting” on page 95. If the Product Configuration Wizard appears, Maya was unable to find a suitable license. See “Installing a license” on page 79. Additional licensing information Verifying license server installation If you are installing networked licenses, you must check to see that you have the correct version of the license server software. Ensure that you installed the Licensing component when you installed Maya 8.5. This component is installed by default on Windows and Mac OS X. You need to explicitly install this component on Linux. To verify license server version Do one of the following, depending on your platform: • (Windows) At the Command Prompt, type: "C:\Program Files\Common Files\Alias Shared\Licensing\etc\lmgrd" -v and then "C:\Program Files\Common Files\Alias Shared\Licensing\bin\lmutil.exe" -v • (Mac OS X, Linux) Open a Terminal window or shell and type: /usr/aw/COM/etc/lmgrd -v You should have version 10.8 of the FlexLM software installed. If not, you must update the license software on the license server from the Maya installation distribution. Installation and Licensing Guide 92 9 | Licensing Maya > Verifying license server installation Note On Linux, you can also check which package is installed with rpm. In a shell window, type: rpm -qa | grep AW If the response is the following, you have the correct versions installed: AWCommon-10.8 AWCommon-server-10.8 If not, you must uninstall the older packages and install the current ones. Please see “Uninstalling Maya” on page 50 and “Installing Maya using the rpm utility” on page 47 for details. Installation and Licensing Guide 93 9 | Licensing Maya > Verifying license server installation Installation and Licensing Guide 94 10 Troubleshooting Troubleshooting licensing: introduction This chapter describes troubleshooting for Maya licensing and startup. You do not need to read this chapter unless you encounter problems during the licensing and start up process. After installation and licensing, if you start Maya and the Product Configuration Wizard and/or error messages appear rather than the Maya main window, you may have a specific startup problem or a licensing problem. • “Issues at startup” on page 97 • “Licensing troubleshooting” on page 99 If you feel you’re not making progress while troubleshooting, please go to our support Web site, where you’ll find information that may help solve your problem. www.autodesk.com/maya-support For details on error messages that may occur when you start or run Maya, see: • “Issues at startup” on page 97 • “Troubleshooting licensing problems (Linux, Mac OS X)” on page 100 • “Troubleshooting licensing problems (Windows)” on page 102 As well, you can contact our Support Services department for assistance. Contacting Support Services For more information, see www.autodesk.com/contactsupport. North America NORTH AMERICAN SUPPORT CENTER The North American Support Center provides support for different geographic areas. Installation and Licensing Guide 95 10 | Troubleshooting > Contacting Support Services Americas United States, Canada, Central and South America. Weekdays: 3 AM - 10 PM EST Weekends: 6 AM - 6 PM EST U.S.A. and Canada, Toll-free: 1-877-927-7478 Central and South America: 1-416-362-8670 email: hotline@alias.com Europe, The Middle East, Africa, Australia and New Zealand. The North American Support Center also supports Europe, The Middle East, Africa, Australia and New Zealand. Weekdays: 9 AM - 4 AM CET Weekends: 12 PM - 12 AM CET France, Toll-free: 00 800 8708 7087 Italy, Toll-free: 00 800 8708 7087 United Kingdom, Toll-free: 00 800 8708 7087 Germany, Toll-free: 00 800 8708 7087 For all other European countries, see www.autodesk.com/contactsupport for contact numbers. Australia, Toll-free: 00 11 800 8708 7087 New Zealand, Toll-free: 00 800 8708 7087 email: hotline@alias.com ASIA PACIFIC SUPPORT CENTER Please contact your local reseller for support. Installation and Licensing Guide 96 10 | Troubleshooting > Issues at startup OTHER SERVICES Incident Support service Toll-free in the U.S.A. and Canada: 1-800-747-9208 Elsewhere in the Americas: 1-416-362-8670 Toll-free in France, Italy, United Kingdom, Germany: 00 800 8708 7087 All other European countries ++/ 32/ 9/ 223 6945 For details on other levels of membership and the support that they get, see www.autodesk.com/maya-support Autodesk Insider Case Management (Platinum membership only) The most efficient way to handle your technical support issue. AICM includes 24/7 access to our robust online case management system which allows you to log, track, amend and close a case without ever having to call the hotline. You can now also track a bug through this same system. To watch online videos on how to take advantage of AICM, see www.autodesk.com/aicm-how-to Issues at startup The following section deals with problems occurring at startup that are not license related. Preference corruption Symptom: Problems starting Maya after installation and proper licensing: splash screen appears or Maya fails to launch with a system error. Your preferences may have become corrupted. You can force Maya to recreate default preferences by renaming your existing preferences directory to prefs.backup. (It may be useful to save your old preferences in order to transfer information to newly-created preferences, or for use by Autodesk Support.) Installation and Licensing Guide 97 10 | Troubleshooting > Issues at startup The default prefs directory path is: • (Windows) drive:\Documents and Settings\<username>\ My Documents\maya\8.5\prefs • (Mac OS X) Users/<username>/Library/Preferences/Autodesk/maya/ 8.5/prefs • (Linux) ~<username>/maya/8.5/prefs The Product Configuration Wizard does not appear If you are attempting to enter your serial number or activation number and the Product Configuration Wizard does not appear when you start Maya (and Maya does not start), open the Product Configuration Wizard manually by doing one of the following: • (Windows) Go to Start > Program Files > Autodesk > Maya 8.5 > Licensing. • (Mac OS X) In the Maya directory (by default, this is /Applications/ Autodesk/Maya8.5/), double-click the Autodesk Product Configuration Wizard • (Linux) Enter the following command in a shell: icon. /usr/aw/maya8.5/bin/opa If the Product Configuration Wizard still doesn’t open you may have a damaged or incomplete install. Try reinstalling Maya. The main Maya scene view doesn’t open, but the Script Editor does This is usually due to graphic card problems on the machine. Check that you are using a qualified graphics card and that the qualified graphic card drivers are installed. The latest information on qualifying systems is always available at: www.autodesk.com/qual-charts Confirming hardware lock driver activation Hardware lock drivers enable communication between a computer and its hardware lock. Installation and Licensing Guide 98 10 | Troubleshooting > Issues at startup (Windows) Driver activation (parallel or USB hardware lock) The installer upgrades the drivers for your hardware lock unless the current version already exists on your computer. There are several steps to make sure that the driver is installed and active: After install: reboot to activate drivers. This should fix most problems. • Symptom: In some circumstances—such as plugging the hardware lock in before an install on a machine that is not connected to the Internet—a generic USB driver may be installed for the hardware lock. • Symptom: If you are running Windows XP Service Pack 2, and after installation, your 9-series hardware lock is not recognized. In these cases, we recommend the following: • Download Win32 device drivers from the following URL: • Uncompress and install the downloaded file. www.ealaddin.com/support/hasp/enduser.asp Once this is installed, the Device Manager should recognize the USB dongle as an Aladdin USB Key. You may need to restart your machine. (Linux) Driver activation (USB hardware lock) • Make sure you install the device driver that are specific to your distribution of Linux (Red Hat and SUSE). The names of the RPM packages are (Red Hat) aksusbd-redhat-1.8.1-3.i386.rpm and (SUSE) aksusbd-suse-1.8.13.i386.rpm. For more information, see “Installing Maya (Linux)” on page 46 for Linux. Licensing troubleshooting The following section deals with problems starting up Maya due to a licensing problem. Installation and Licensing Guide 99 10 | Troubleshooting > When you start Maya When you start Maya If the Product Configuration Wizard appears at startup, make sure you have licensed your copy of Maya correctly by checking the licensing steps starting in “Quick Start: How to activate your copy of Maya” on page 11 or in “Licensing Maya” on page 65. You can also check the following: • You may have one or more environment variables set that affect licensing. Check your environment variables and your Maya.env file for SGIAWD_LICENSE_FILE, MAYA_LICENSE or MAYA_ALT_EN settings. For more information about setting these variables, see Environment Variables chapter and “Licensing Maya” on page 65. • Check for the existence of files in the license directory (Windows: C:\FLEXLM; Mac OS X, Linux: /var/flexlm/) that begin with aw and end with the extension .dat. It is possible that you have a corrupt or expired license file which may be directing Maya to connect to a license server. This may prevent the Product Configuration Wizard from launching. If the Product Configuration Wizard appears or Maya main window doesn’t appear at startup, and you have followed the licensing steps correctly, please review the platform-specific troubleshooting information below. Troubleshooting licensing problems (Linux, Mac OS X) If the following error message appears, do the steps under the appropriate headings that follow. No license suitable to run this version of Maya Error setting license default Cannot find any aw.dat (or aw_servername.dat) files in /var/ flexlm Unable to locate a license server for Maya Account is not available Do the steps in sequence until the problem is solved. If you’ve tried all steps or you see an error message not listed, write down the exact error message and call our Support Services department. No license suitable to run this version of Maya or Error setting Installation and Licensing Guide 100 10 | Troubleshooting > When you start Maya license default 1 If you are using a hardware lock, make sure you attached the hardware lock correctly. See “Installing your hardware lock” on page 69 for installation details. 2 Confirm that the driver for the Hardware lock device is correctly activated. See “Confirming hardware lock driver activation” on page 98. 3 If you tried to run Maya with a networked license, make sure the time and date on the client and server are correct and synchronized. If the time and date of the client differs from the server by more than a half hour, the client may not be able to get a license. 4 Review the licensing procedure to make sure you completed all the steps. 5 Do the steps in “Examining a licensing log file” on page 104. Cannot find any aw*.dat files in /var/flexlm 1 Verify that the /var/flexlm directory contains the file aw*.dat. Note 2 On Mac OS X, you can navigate to the /var/flexlm folder by selecting Go > Go To Folder in the Finder. Type in the name of the folder you want to navigate to (here, /var/flexlm). You may be required to type in your administrative password. If this file doesn’t exist, you may have not done the steps required in “Licensing Maya” on page 65. You’ll need to reinstall licenses. Unable to locate a license server for Maya Note This message occurs only with networked licenses. To check possible client problems Verify that the USE_SERVER line is below the SERVER line in the client license file. For an example, see “Setting up each client” on page 88. Installation and Licensing Guide 101 10 | Troubleshooting > When you start Maya To check possible server problems 1 Verify that you have installed the proper version of the licensing software. For more details, see “Verifying license server installation” on page 92. 2 Stop and start the license server software as described in “Additional setup for networked licenses” on page 84. 3 If that does not solve the problem, do the steps in “Examining a licensing log file” on page 104. (Linux) Account is not available When attempting to set up a Linux networked license server, and after typing the following command to start flexlm: /etc/rc.d/init.d/aw_flexlm start You receive the following error: Account is not available One possible cause of this problem is that the nobody account which serves the licenses on the server has its login shell set to /sbin/nologin within the /etc/ passwd file. To correct the ‘nobody’ account problem 1 In a shell window, edit the /etc/passwd file on the server. 2 Change the entry for the “nobody” account as in the following example: nobody:*:99:99:Nobody:/:/sbin/nologin to: nobody:*:99:99:Nobody:/: Troubleshooting licensing problems (Windows) One of the following error messages may appear if the Maya main window doesn’t appear: No license suitable to run this version of Maya Error setting license default. Unable to locate a license server for Maya. Installation and Licensing Guide 102 10 | Troubleshooting > When you start Maya Cannot find any aw*.dat files in C:\flexlm\. No licenses found for your FLEXid flexid For the message that appears, do the steps under the appropriate heading that follows. In each case, do the steps sequentially until the problem is solved. If you’ve tried all steps or you see an error message not listed, write down the exact error message and call our Support Services department. The last message in the above list may occur as you run the License Installer software, not as you run Maya. No license suitable to run this version of Maya or Error setting license default 1 If you are using a hardware lock, make sure you attached the hardware lock correctly. See “Installing your hardware lock” on page 69 for installation details. 2 Confirm that the driver for the Hardware lock device is correctly activated. See “Confirming hardware lock driver activation” on page 98. 3 If you tried to run Maya on a client or server, make sure the time and date on the client and server are correct and synchronized. If the time and date of the client differs from the server by more than a half hour, the client may not be able to get a license. 4 Review the licensing procedure to make sure you completed all the steps. 5 On the appropriate standalone computer or license server computer, make sure the parallel port or USB port is operational if you are using a hardware lock. There are no easy ways to check that the port is operational other than to plug a printer (or some other device) into the parallel port or USB connector and print something. 6 Do the steps in “Examining a licensing log file” on page 104. 7 Do the steps in “Checking for licensing errors with FLEXlm licensing utilities (Windows)” on page 113. Unable to locate a license server for Maya Note This message only occurs with networked licenses. Installation and Licensing Guide 103 10 | Troubleshooting > Examining a licensing log file To check possible client problems • Verify that the USE_SERVER line is below the SERVER line in the client license file. For an example, see “Setting up each client” on page 88. • Make sure that your client and the license server are connected via a TCP/IP network. To check possible server problems Stop and start the license server software as described in “Additional setup for networked licenses” on page 84. Cannot find any aw*.dat files in C:\flexlm\ 1 From My Computer or Windows Explorer, verify that the C:\FLEXLM\ directory contains the file aw.dat or aw_servername.dat. If this file doesn’t exist, you’ll need to redo the licensing procedure as described in “Licensing Maya” on page 65. 2 Do the steps in “Checking that a license file is the correct file type (Windows)” on page 117. No licenses found for your FLEXid flexid • You don’t have any licensing information in the license file. • If the licensing information originates in an e-mail or other file of a Linux computer and you transfer the file to the Windows computer, you must transfer it in ASCII mode rather than binary. Otherwise the file will contain additional control characters at line endings that the License Installer won’t recognize, and you’ll see the preceding error message. You can use Notepad to examine the contents of the file on the Windows computer to make sure it has no added control characters. Examining a licensing log file If you start Maya and the Product Configuration Wizard or error messages appear instead of the Maya main window, you can create and examine a licensing log file to learn the nature of the error. Error messages may include: Installation and Licensing Guide 104 10 | Troubleshooting > Examining a licensing log file No license suitable to run this version of Maya Error setting license default. For a standalone license, do the following steps on the computer where the message appears. For a networked license, do the following steps on the license server computer. To examine the license error log file (Windows) 1 From the Start menu, select Programs > Accessories > Command Prompt. 2 At the Command Prompt, enter: 3 To repeat the failed attempt to start Maya, use the full path: set FLEXLM_DIAGNOSTICS=2 <install_path>\maya where install_path is the path to which you installed the Maya software. For example, if you installed Maya on drive C:, the path would be: C:\Program Files\Autodesk\Maya8.5\bin\maya. When you set the FLEXlm diagnostics in step 2, the attempt to start Maya creates a licensing log file. An error message flashes onscreen before the Product Configuration Wizard appears. 4 5 Open the log file that was just created: • Using Windows Explorer, navigate to the folder in which you gave the command to start Maya. For example, if you typed <install_path>\maya at the C:\ prompt, the log file is created in the root folder of the C:\ drive. • Open the file using Notepad or another text editor. Find the message in “Understanding log file error messages” on page 106 and follow the instructions. Ignore other information in the file. If the message isn’t listed, call Autodesk Support. To examine the license error log file (Linux, Mac OS X) 1 In a shell (Linux), or in a Terminal window (Mac OS X), enter the following (the following example is for bash and will work on Mac OS X; you may need to modify this line based on which shell you’re running): Installation and Licensing Guide 105 10 | Troubleshooting > Examining a licensing log file FLEXLM_DIAGNOSTICS=2 2 Do one of the following, depending on your platform: • (Linux) Type /usr/aw/maya8.5/bin/maya to repeat the failed attempt to start Maya. The diagnostic information is printed to the screen. As well, the Maya Product Configuration Wizard appears. • (Mac OS X) Type the following to start Maya. /Applications/Autodesk/maya8.5/Maya.app/Contents/MacOS/Maya Only use this command to perform FLEXlm diagnostics. This special command ensures that the startup attempt inherits the FLEXLM_DIAGNOSTICS environment variable from the typed-in command. The diagnostic information is displayed in the Terminal window. As well, the Maya On-line Product Activation window appears. The FLEXlm checkout error message always refers to the FEATURE below it. The format is: 3 • FLEXlm checkout error. • License file being used. • FLEXlm error code and FEATURE line in question. Find the message in the following topic, “Understanding log file error messages” on page 106 and follow the instructions. Ignore other information in the file. If the message isn’t listed, call Autodesk Support. Understanding log file error messages Error messages within the file help you identify the problem. The most common error messages are explained below. If multiple errors exist, look for the feature name that matches the feature in your license file. Use the help in step 3 above to focus on the error. In the following explanations, license file refers to the aw*.dat file which may be called aw_servername.dat, aw_server.dat, and so on, on various systems. Installation and Licensing Guide 106 10 | Troubleshooting > Examining a licensing log file Error Possible solutions FLEXLM checkout error: Invalid (inconsistent) license key. The license key and data for the feature do not match. This usually happens when a license file has been altered. • Check the license file against the license file that you received. There may be a typing mistake in the password, expiration date, or license version. If it is a networked license, check to see if the HOSTID is spelled correctly. As well, check the spelling and punctuation in the ISSUER field. • If you obtained a pre-release license for Maya, also check the spelling of eval in the VENDOR_STRING. FLEXLM checkout error: Feature has expired... • Either the current machine date is later than the expiration date or there’s a typing mistake in the expiration date. FLEXLM checkout error: Invalid date format in license file • Check the license file’s expiration date for an incorrect format, for example, may-4-2006. The correct format is 4-may-2006. • The password may have invalid characters—not all hexadecimal. • The license count digit may be absent: uncounted for standalone, a number greater than 0 for networked. FLEXLM checkout error: Invalid License File syntax. • Check the license file against the license file that you received. There may be a typing mistake. FLEXLM checkout error: No such feature exists. • Check the license file’s spelling of components, package, and feature lines against the license file that you received. Installation and Licensing Guide 107 10 | Troubleshooting > Examining a licensing log file • Make sure you have the newest version of FLEXlm license server (Maya 8.5 requires version 10.8). See “Verifying license server installation” on page 92. • Check the license file’s spelling of VENDOR or any part of the string HOSTID number. • Check that you typed \ instead of / at the end of a line. • Check that the ISSUER is spelled correctly. • For a standalone license, check that the license file’s License Count is uncounted. • For a networked license, make sure the appropriate SERVER and VENDOR/ DAEMON lines appear at the top of the aw_servername.dat file (where servername is the name of the license server machine). On Mac OS X, this file is named aw_server.dat. FLEXLM checkout error: Maya license in file appears to be corrupted. • Check the entire license file for a typing mistake. FLEXLM checkout error: Invalid host. • Check that the machine possesses the right hardware ID/HOSTID number, and that it is correct and not misspelled. To check the hardware ID of the current machine, see “Identifying your hardware ID.” on page 75. • Check that the hardware lock (dongle) is plugged into the parallel port or USB port correctly. See “Installing your hardware lock” on page 69. FLEXLM checkout error: Future license file format or misspelling in license file. FLEXLM checkout error: No SERVER lines in license file. or The hostid of this system does not match the hostid specified in the license file. Installation and Licensing Guide 108 10 | Troubleshooting > Examining a licensing log file FLEXLM checkout error: No server for this feature. • sgiawd in DAEMON (Linux) or VENDOR (Windows, Mac OS X) line may be spelled incorrectly. FLEXLM checkout error: License server does not support this feature. • Check the license file to see if the feature has expired, the license server has not yet started. • Check if there is a mismatch between the version of Maya and the version of Maya identified in the license file. • Try using the computer’s IP address instead of the hostname. Installation and Licensing Guide 109 10 | Troubleshooting > Finding licensing problems with diagnostic tools FLEXLM checkout error: Cannot connect to license server. • FLEXlm networked license software has not been installed (see “Verifying license server installation” on page 92) or an older version of FLEXlm networked license software is installed. Maya 8.5 uses FLEXlm version 10.8. • The license server daemon has not been started. • SERVER servername has not been changed to reflect the name or IP address of the server. • DAEMON or VENDOR is not spelled correctly. • (Linux, Mac OS X) The sgiawd path is not right. The default should be: /usr/aw/COM/etc/sgiawd FLEXLM checkout error: Clock difference too large between client and server. • Check the network connection on your client machine. • As a last resort, reboot your license server. Make sure the time and date on the client and server are correct and synchronized. If the time and date of the client differs from the server by more than a half hour, the client may not be able to get a license. Finding licensing problems with diagnostic tools For Linux and Mac OS X, you can use the lmhostid, lmdiag, and lmstat utilities to help find and fix licensing problems. For Windows, you can use the FLEXlm Licensing Utilities (lmtools) to help find and fix licensing problems. The FLEXlm Licensing Utilities and lmstat format is also described in this section. Installation and Licensing Guide 110 10 | Troubleshooting > Finding licensing problems with diagnostic tools Checking your hardware ID with lmhostid (Linux, Mac OS X) The lmhostid tool provides the hardware ID for the current machine. This should correspond with the Host ID in the aw.dat, aw_servername.dat, or aw_server.dat file. If you’re running Maya with a hardware lock, you’ll need to use the Product Configuration Wizard to verify your hardware lock FLEXid. For more information, see “Identifying your hardware ID.” on page 75. (Linux, Mac OS X) To verify hostid information 1 In Terminal or in a shell, type the following: 2 Press Return. /usr/aw/COM/bin/lmhostid The result is displayed on the screen. Diagnosing your licensing problems with lmdiag (Linux, Mac OS X) The lmdiag tool diagnoses problems when a license checkout fails. You can use it for standalone or networked licenses. lmdiag first prints information about the license. It then attempts to check out each license. If the checkout is successful, lmdiag notifies the user; if not, lmdiag gives the reasons why the checkout failed. • In Terminal or in a shell, type the following: /usr/aw/COM/bin/lmdiag -a -c /var/flexlm/LicenseFile Checking networked licensing with lmstat (Linux, Mac OS X) The lmstat tool reports the status of the license manager daemons and feature usage. It provides information about the status of the server nodes, vendor daemons, vendor features and users of each feature. lmstat is only useful for checking networked license errors. You must run lmstat on the license server machine. Installation and Licensing Guide 111 10 | Troubleshooting > Finding licensing problems with diagnostic tools To use lmstat 1 In Terminal or in a shell, type the following: /usr/aw/COM/bin/lmstat -a -c /var/flexlm/LicenseFile 2 -a Displays all. A lot of information appears if there are many active users. -c LicenseFile This ensures that you are checking the diagnostics for the correct license file. Press Return. The data is displayed on the screen. When running lmstat, a lengthy list of status information appears. The status information shows whether the license server is up and running, and whether each feature line in the license file has no errors and the license count is correct. Examine the following entries in the status information for troubleshooting in the following steps: lmstat - Copyright (C) 1989-2004 Macrovision Corporation. All rights reserved. Flexible License Manager status on Sun 5/15/2005 10:51 License server status (License file: /var/flexlm/ aw_servername.dat): servername: license server UP (MASTER) Vendor daemon status (on servername): sgiawd: UP 3 For the line that starts with License server status, make sure that the correct path to the license file is listed. If it is not the correct path, make sure that the license file exists in the /var/flexlm/ directory, and make sure that the name of the server machine is correct. 4 The next line of status information shows if the license server is UP. If it is not UP, the error message printed is: License server status (License file: /var/flexlm/ aw_servername.dat): servername: Cannot connect to license server (-15,12:146) Connection refused Installation and Licensing Guide 112 10 | Troubleshooting > Finding licensing problems with diagnostic tools Vendor daemon status (on servername): sgiawd: Cannot connect to license server (-15,12:146) Connection refused If this is the message you receive, follow these steps: 5 Confirm that the license server is up. For more information, see “Additional setup for networked licenses” on page 84. Follow the platform-specific instructions for the license server you are working with. 6 Below the status information is a list of features in the license file and information explaining whether the clients can use the features. An example follows: Feature usage info: Users of MayaUnltdf: (Total of 3 licenses available) This example indicates that three networked Maya Unlimited licenses are available. If the license file has a typing error, you’ll see something similar to this example: Users of MayaUnltdf: (Error: 3 licenses, unsupported by licensed server) Check the license file for a typing error. 7 If following the above procedures does not solve the problem, gather all of the diagnostic output messages, the license file, and the aw_flexlm.log file (located in /usr/tmp). Contact our Support Services department and provide them with this information. Checking for licensing errors with FLEXlm licensing utilities (Windows) Licensing sometimes fails because your licensing software is using the wrong hardware ID (also known as Host ID or Server Host ID) for the hardware lock plugged into your standalone or license server computer. The Host ID/Server Host ID for a hardware lock is printed on the lock. Installation and Licensing Guide 113 10 | Troubleshooting > Finding licensing problems with diagnostic tools For standalone or networked licenses, you can use the FLEXlm licensing utilities to check that your licensing software is using the correct hardware ID. For networked licenses only, you can additionally use the FLEXlm licensing utilities program to check for errors not listed in “Understanding log file error messages” on page 106. Do the following steps on the license server computer or on a computer that has a standalone license. To check for license errors (Windows) 1 Tip On the machine you want to license, go to Start > Program Files > Autodesk > Common Utilities > FlexLM License Utilities. The FLEXlm Licensing Utilities are located at <drive>:\Program Files\Common Files\ Alias Shared\Licensing\bin\lmtools.exe 2 In the LMTOOLS window, click the System Settings tab. 3 Record the FLEXID value, if shown. Otherwise, record the Ethernet Address value. The value you record is your hardware ID. 4 Open your license file (C:\FlexLM\aw.dat or aw_servername.dat) in a text editor. 5 Depending on your license type, check the following: (Standalone License) Find "HOSTID=" in your license file and compare it to your recorded system ID. (Networked License) Find "SERVER servername hostID 7111" in your server license file and compare it to the recorded system ID. (Where HOSTID may either be a FLEXID or ethernet HOSTID.) If these numbers do not match, make sure that you installed the correct license. Otherwise, you need to obtain a new license for your recorded System ID. If you are checking for networked licensing errors, do the following: 6 Click the Server Status tab. Installation and Licensing Guide 114 10 | Troubleshooting > Finding licensing problems with diagnostic tools 7 Select Display Everything. 8 Click Perform Status Enquiry. 9 Examine the status information that appears. For example: License server status: 7111@servername License file(s) on servername: C:\FLEXLM\aw_servername.dat: servername: license server UP (MASTER) \ Vendor daemon status (on servername): sgiawd: UP where servername is the name of the license server computer. The status information shows whether the license server is up and running, and whether each feature line in aw_servername.dat has no errors and the license count is correct. The types of status information are as follows: License server status—The number 7111 is a fixed number that represents the TCP/IP port used internally by the licensing software. If you see a number other than 7111, make sure that you intend for that port number to be used. Otherwise, open the file aw_servername.dat and change the number to 7111. License file(s) on servername—Check that the path to the license file is correct. servername—The next line of the status information shows the license server is up. If the license server isn’t up, you’ll see an error message that begins like this: lmgrd not running: Cannot connect to license server. The server (lmgrd) has not been started yet, or the wrong port@host or license file is being used, or the port or hostname in the license file has been changed... If you see this message, start the license server and ensure the pathname to the server’s license file is correct. Vendor daemon status (on servername)—The final two lines show whether the vendor daemon is up. The vendor daemon connects the license server to an application, in this case Maya. You can’t directly start the vendor daemon when it’s down. When you stop and start the license server software, the daemon starts also. If the license server is down, stop and start the license server software as described in “Additional setup for networked licenses” on page 84. If the problem persists, restart the license server computer. Installation and Licensing Guide 115 10 | Troubleshooting > Running previous versions of Maya: USB hardware lock issues Other information—Below the status information is a list of features in the aw_servername.dat file and whether the clients can use the features. An example follows: Feature usage info: Users of MayaUnltdf: (Total of 3 licenses available) This example indicates that three networked Maya Unlimited licenses are available. If the aw_servername.dat file has a typing error, you’ll see something similar to this example: Users of MayaUnltdf: (Error: 3 licenses unsupported by license server) Check aw_servername.dat for a typing error. 10 If this procedure doesn’t fix the problem, call Autodesk Support and keep the information from the preceding steps handy. Miscellaneous troubleshooting Running previous versions of Maya: USB hardware lock issues If you are using a hardware lock for the first time, and you previously had a standalone license, the license you install that is keyed to your hardware lock is not backwards-compatible (that is, you can’t run a previous version of Maya) because your hardware ID has changed and previous versions of the licensing software do not support hardware locks. In this case, you must make sure you keep your previous license in order to run previous versions of Maya. The following table shows USB hardware lock version support: Platform Maya version Windows 6.5+ Linux 7+ Installation and Licensing Guide 116 10 | Troubleshooting > Running previous versions of Maya: USB hardware lock issues Platform Maya version Mac OS X 7+ Checking that a license file is the correct file type (Windows) The aw*.dat file must have a .dat extension (FLEXlm license file). The following procedure shows how to check and correct the file type. To check and correct the file type 1 From My Computer or Windows Explorer, right-click aw.dat or aw_servername.dat and select Properties from the pop-up menu. 2 In the Properties window, check that the file type is .dat (FLEXlm License file). 3 If not, select Tools > Folder Options. 4 Select the View tab. 5 Turn off Hide file extensions for known file types and click OK. You’ll likely see that aw.dat or aw_servername.dat file has an extension other than .dat, for example, .txt. 6 Right-click the filename and select Rename from the pop-up menu. 7 Change the file extension to .dat. You’ll be prompted that if you change a filename extension, the file may become unusable. 8 Click Yes. (The file won’t become unusable.) The file now has the correct .dat extension for licensing operation. Installation and Licensing Guide 117 10 | Troubleshooting > Understanding licenses Understanding licenses This section explains the structure of the license Autodesk sends you. Understanding this structure is helpful if you manually entered the license into a text file from fax or mail and you’re looking for a typing error. In the following section, the term license may refer to an entire license or an individual entry of a license, depending on the context. Tip If you see a line near the top of your license that starts with SERVER, you’re installing networked licenses. Otherwise, you’re installing standalone licenses. Standalone licenses The following figure shows the structure of a standalone license: Feature Name License Version Expiration License Count Password FEATURE MayaUnltd sgiawd 8.500 permanent uncounted 1234567890ab\ VENDOR_STRING=xxx HOSTID=00c0f1234abc Vendor String Host ID/ hardware identifier Feature Name—the Maya product package you purchased. License Version—the version number of the Maya package. Expiration—when the license expires. The word “permanent” means there is no expiration date. Product pre-release licenses have expiration dates. License Count—standalone licenses have “uncounted” here, meaning that they do not have a license count. Password—an encrypted string that authenticates the license. Installation and Licensing Guide 118 10 | Troubleshooting > Understanding licenses Vendor String—indicates you have a timed-out or pre-release. If not present, it means that you have a purchased, permanent license. Host ID—also known as hardware ID. The Host ID of the machine to be licensed, the ethernet address of the machine or your computer’s system ID, obtained either from your ethernet card or from a hardware lock attached to your machine. Networked licenses The following figure shows the structure of a networked license: Your server name here Server Host ID Port Number Password SERVER server FLEXID=9-b2854a12 7111 VENDOR sgiawd /usr/aw/COM/etc/sgiawd FEATURE MayaUnltdf sgiawd 8.500 permanent 5 432B9293FFAD3F3726A6 \ SUPERSEDE="MayaUnltdf" \ ISSUED=6-jun-2006 VENDOR_STRING=xxx License License Version Count Feature Vendor Expiration Name String server—a placeholder where you must insert your actual server name. Server Host ID—Also known as hardware ID. This is one of the server’s host ID, the server’s ethernet address, or the computer’s system ID, obtained either from the MAC Address of your ethernet card or from a hardware lock (dongle) attached to your machine (hardware lock server host IDs begin with FLEXID). Port Number—a fixed number that represents the TCP/IP port used internally by the licensing software. Feature Name—the Maya product package you purchased. There may be several additional feature lines in your license; for example, the Maya Unlimited package includes separate lines for several different Maya Unlimited features. Vendor String—indicates you have a timed-out or pre-release license. If not present, it means that you have a permanent license. Installation and Licensing Guide 119 10 | Troubleshooting > Additional resources License Version—the version number of the software. Expiration—when the license expires. The word “permanent” means there is no expiration date. Product pre-release licenses have expiration dates. License Count—the number of networked licenses you ordered. Password—an encrypted string that authenticates the license. Issue Date—the date the license was generated for the customer. SUPERSEDE—overrides any license whose ISSUED date is less than the new ISSUED date. Additional resources • www.autodesk.com provides information on various Autodesk and Maya issues. • Go to www.autodesk.com/maya-support to get to the Maya support site. You can access FAQs and Tutorials, Solutions, and other resources. • www.macrovision.com/services/support/software_licensing.shtml provides information on licensing. Installation and Licensing Guide 120 Index Numerics 32-bit Maya installation directory 19, 45 64-bit Maya benefits 19, 45 installation directory 19, 45 Linux 45 non-supported features 19 supported features 46 Windows 19 A activation key installing 79 API Toolkit Mac OS X 38 C client setup for Windows 88 clients setting up 88 configuration desktop 52 G confirming installation 91 Maya installation 91 custom installation Linux 47 graphics cards driver software 17 Mac OS X 34 setting options 28 Windows 28 D H desktop configuration 52 disk space file system and 49 display performance 28 Documentation installing Linux 49 hardware ID 76 hardware locks ID 76 I E error messages log file 106 upon starting Maya 100, 102 F file system other than usr 49 File Type Handling setting 25 FLEXlm description 66 FLEXLM_DIAGNOSTICS 105 floating licenses installing 84 IFF files Mac OS X support 40 installation confirming 91 file system other than usr 49 license server 63 Quick Start 11 rpm utility 47 Shader Library 55 Installation directory Linux 45 installation directory 19 Installation and Licensing Guide 121 Index installing Maya Linux 41–54 Mac OS X 31–40 Windows 15–29 log file licensing errors 104 K master machine 57 Maya new users 11 Maya Plug-ins 26 MAYA_SHADER_LIBRARY_PA TH 56 mental ray satellite rendering 57 Microsoft Runtime Libraries 20 motion capture 18 KDE 52 key bindings configuring 52 L license management options 84, 86, 87 license server checking status 85 installation 63 startup 86, 87 stopping, starting, and checking 84, 85, 86, 87 licenses checking for errors with lmtools 113 error log file 104 installing floating 84 single machine 11 licensing satellite rendering 61 licensing Maya 65–93 Linux compiling plug-ins and applications 51 lmtools 113 M N new users of Maya 11 O OPA (Online Product Activation) website 77 P port number changing 60 Prekey 65 descriiption 70 Installation and Licensing Guide 122 Q qualified hardware Linux 42 Mac OS X 32 Windows 16 Quick Start 11 QuickTime Components 40 R ray sat server 59 rpm utility 47 S satellite rendering changing port number 60 licensing 61 master 57 mental ray 57 ray sat server 59 slave 57 slave machine installation 58 serial number activation key 11 Shader Library installation 55 single machine licenses 11 slave machine 57 starting Maya 91 Index startup license server 86, 87 Maya error messages 100 Status button lmtools 114 stencil planes 29 stopping and starting license server 85 system requirements Linux 42 Mac OS X 32 Windows 16 T technical support, contacting 95 third party plug-ins 26 troubleshooting 95–120 licensing 99–120 starting Maya 97–99 True Color 28 U uninstalling Maya Linux 50 Mac OS X 39 Windows 27 unsupported Maya features 51 usr file system 49 V Vendor String 119 versions previous 68 previous kept 42 VRAM 28 W Wacom tablet 18, 35, 45 Webkey description 70 Installation and Licensing Guide 123 Index Installation and Licensing Guide 124