10 tips for autodesk maya efficiency

Installation and Licensing

Legal Notice

Autodesk® Maya® 2008

© 2007 Autodesk, Inc. All rights reserved. Except as otherwise permitted by Autodesk, Inc., this publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose.

Certain materials included in this publication are reprinted with the permission of the copyright holder.

Graph Layout Toolkit © Copyright 1992-2003 Tom Sawyer Software, Berkeley, California. All rights reserved.

Mozilla Open Source Project © Copyright 1998-2004 by Contributors to the Mozilla codebase under the Mozilla Public License. Source code may be found at http://www.mozilla.org/source.html. The Mozilla software is distributed under the Mozilla Public License on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND. The Mozilla Public License may be found at www.mozilla.org/MPL/. All rights reserved.

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.

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.

TrademarksThe 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, Freewheel, GDX Driver, Gmax, Heads-up Design, Heidi, HOOPS, HumanIK, i-drop, iMOUT, Incinerator, IntroDV, Inventor, Inventor LT, 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.

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.

Disclaimer THIS PUBLICATION AND THE INFORMATION CONTAINED HEREIN IS MADE AVAILABLE BY AUTODESK, INC. "AS IS." AUTODESK, INC., DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE REGARDING THESE MATERIALS.

Published by: Autodesk, Inc. 111 Mclnnis Parkway San Rafael, CA 94903, USA

All use of this Software is subject to the terms and conditions of the Autodesk End User License Agreement accepted upon installation of this Software and/or packaged with the Software.

PatentsProtected by one or more of U.S. Patent Nos. 6,384,835, 6,356,271, 6,204,860, 6,549,212, 6,414,700, 6,915,492, 6,348,924, 6,462,740, 5,889,528, 6,025,852, 5,999,195, 6,130,673, 6,389,154, 6,553,337, 6,850,638, 6,525,735, 7,034,824, 6,232,980, 5,852,450, 5,990,908, 6,363,503, 7,168,012, 6,888,542, 5,287,408, 6,317,128, 5,764,233, 6,037,948, 6,246,416, 6,266,071, 5,847,716, 7,139,444, 6,859,202, 6,798,416, 6,118,427, 5,809,219, 6,211,882, 5,808,625, 5,929,864, 5,818,452, 5,689,667, 5,926,178, 6,618,063; and patents pending.

Third-Party Software Credits and AttributionsGraph Layout Toolkit © Copyright 1992-2003 Tom Sawyer Software, Berkeley, California. All rights reserved.

Mozilla Open Source Project © Copyright 1998-2004 by Contributors to the Mozilla codebase under the Mozilla Public License. Source code may be found at http://www.mozilla.org/source.html. The Mozilla software is distributed under the Mozilla Public License on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND. The Mozilla Public License may be found at www.mozilla.org/MPL/. All rights reserved.

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.

Portions relating to TIFF © Copyright 1988-1997 Sam Leffler. © Copyright 1991-1997 Silicon Graphics, Inc. All rights reserved. Permissions to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon Graphic.THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABIBITLY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

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.

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.

Portions relating to OpenEXR Copyright © 2002, Industrial Light & Magic, a division of Lucas Digital Ltd. LLC All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 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 Industrial Light & Magic 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 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.

Table of Contents

Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

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 . . . . . . . . . . . . . . . . . . . . . . . . . . 19Supported features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Microsoft Runtime Libraries . . . . . . . . . . . . . . . . . . . . . . . 20Maya API and Developer Kit . . . . . . . . . . . . . . . . . . . . . . . 21

Installing Maya (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Maya Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Bonus Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Uninstalling Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Installing Maya 2008 alongside previous versions . . . . . . . . . 29

Graphics requirements for Maya . . . . . . . . . . . . . . . . . . . . . . 29

4 Installing Maya for Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . .31

Installation and Licensing Guide3

Table of Contents

Overview of installing Maya for Mac OS X . . . . . . . . . . . . . . . 31



Maya on Intel Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

General notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Supported features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Installing Maya (Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . 36


Software that can be installed separately . . . . . . . . . . . . . . . 40

Installing Maya 2008 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



Installation directory (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . 45

Maya on 64-bit systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Benefits of 64-bit Maya . . . . . . . . . . . . . . . . . . . . . . . . . . 45Supported features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Maya API and Developer Kit . . . . . . . . . . . . . . . . . . . . . . . 46

Installing Maya (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Installing Maya using the rpm utility . . . . . . . . . . . . . . . . . 47Installing Maya on file systems other than /usr . . . . . . . . . 50


Additional Linux notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Compiling plug-ins and standalone programs . . . . . . . . . . 51Differences in operation . . . . . . . . . . . . . . . . . . . . . . . . . 51

Installation and Licensing Guide

4

Table of Contents

Linux desktop configuration . . . . . . . . . . . . . . . . . . . . . . . 52KDE and Gnome desktop configuration . . . . . . . . . . . . . . . 52

6 Installing the Shader Library . . . . . . . . . . . . . . . . . . . . . . . . . . .57

Installing the Maya Shader Library . . . . . . . . . . . . . . . . . . . . 57

7 Installing mental ray for Maya satellite . . . . . . . . . . . . . . . . . . .59

Overview of mental ray (satellite) . . . . . . . . . . . . . . . . . . . . . 59

Slave machine installation . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Slave machine additional setup . . . . . . . . . . . . . . . . . . . . . . 61

Slave machine port setup. . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Licensing of satellite rendering . . . . . . . . . . . . . . . . . . . . . . . 63

8 Installing license server software and updates . . . . . . . . . . . . .65

Installing license server software . . . . . . . . . . . . . . . . . . . . . 65

Upgrading the license for license server software . . . . . . . 65

9 Licensing Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

Who should use this chapter . . . . . . . . . . . . . . . . . . . . . . . . 67

Overview of licensing: some definitions . . . . . . . . . . . . . . 68License file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Installing your hardware lock . . . . . . . . . . . . . . . . . . . . . . 71Where is your serial number? . . . . . . . . . . . . . . . . . . . . . 71

Prekey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Webkey. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Getting the Webkey using the Autodesk Product Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Activating the software from a serial number . . . . . . . . . . . . . 74

Installing a license. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Licensing notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84


Table of Contents

If the licensing is not successful . . . . . . . . . . . . . . . . . . . . . . 85

To request a license if you don’t have a serial number . . . . . . 85

Additional setup for networked licenses . . . . . . . . . . . . . . . . 86

(Windows) License server management options and license server confirmation . . . . . . . . . . . . . . 86(Linux) License server management options and

license server confirmation . . . . . . . . . . . . . . . . . . . . . . . 88(Mac OS X) License server management options and

license server confirmation . . . . . . . . . . . . . . . . . . . . . . . 89

Setting up each client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Limiting the use of Maya Unlimited product licenses . . . . . . . 92

Confirming Maya startup . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Verifying license server installation . . . . . . . . . . . . . . . . . . . . 94

10 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97

Troubleshooting licensing: introduction . . . . . . . . . . . . . . . . . 97

Contacting Support Services. . . . . . . . . . . . . . . . . . . . . . . . . 97

NORTH AMERICAN SUPPORT CENTER . . . . . . . . . . . . . . . . 98ASIA PACIFIC SUPPORT CENTER . . . . . . . . . . . . . . . . . . . . 99Autodesk Insider Case Management (Platinum membership only) . . . . . . . . . . . . . . . . . . . . . . 99

Issues at startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Preference corruption . . . . . . . . . . . . . . . . . . . . . . . . . . . 99The Product Configuration Wizard does not appear . . . . . 100The main Maya scene view doesn’t open, but the Script Editor does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Confirming hardware lock driver activation . . . . . . . . . . . 101

When you start Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Troubleshooting licensing problems (Linux, Mac OS X) . . . 102Troubleshooting licensing problems (Windows) . . . . . . . . 105


6

Table of Contents

Examining a licensing log file . . . . . . . . . . . . . . . . . . . . . . . 107

Understanding log file error messages . . . . . . . . . . . . . . 109

Finding licensing problems with diagnostic tools . . . . . . . . . 113

Checking your hardware ID with lmhostid (Linux, Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Diagnosing your licensing problems with lmdiag (Linux, Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Checking networked licensing with lmstat (Linux, Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Checking for licensing errors with FLEXlm licensing utilities (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Running previous versions of Maya: USB hardware lock issues . . . . . . . . . . . . . . . . . . . . . . . . . 118

Checking that a license file is the correct file type (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Understanding licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Standalone licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Networked licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123


Table of Contents


8

1 Introduction

Overview of installation and licensingWelcome to Autodesk® Maya® 2008! This guide describes the process of installation and licensing Maya 2008 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 Maya Shader Library” on page 57

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 59

If you only want to install the license server tools, see:

• “Installing license server software” on page 65

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 67

If you have problems starting or licensing Maya, please review our troubleshooting guide:

• “Troubleshooting” on page 97

The Maya 2008 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.


1 | Introduction

> Overview of installation and licensing


10

2 Quick Start Licensing

Quick Start: How to activate your copy of MayaThis 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 67.)

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 activationIf 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.


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.


12



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 67.

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 67.

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 67.




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 67.)

(If you’re setting up a networked license server, see “Additional setup for networked licenses” on page 86.)


14

3 Installing Maya for Windows

Overview of installing Maya for WindowsThis 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: checklistYou must run the installer on each computer where you want to run the software.

If you’re going to use a computer to serve Maya licenses, you must run the Licensing Tools installer and/or License Updater on that computer. For more information, see “Installing license server software” on page 65.

Issue Required action

Your computer system must meet specific hardware and software requirements for you to successfully install and run Maya.

Autodesk does not support hardware and software configurations that do not meet these requirements.

Review the requirements section in this chapter (“System requirements” on page 16).

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.


3 | Installing Maya for Windows

> System requirements

System requirementsAutodesk 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:


You can examine your system capabilities using system diagnostic tools. Select Start > Programs > Accessories > System Tools > System Information.

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 28.

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:

• Close all programs.

• Disable any virus detection software.

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.



16



Category Values

Hardware • (32-bit) Intel® Pentium® 4 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 on certain platforms, which can be purchased through Autodesk.)

• three-button mouse with mouse driver software

Graphics requirements

• 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 29.

Operating system

• (32-bit) Windows XP Professional (SP2)

• (64-bit) Windows XP Professional x64 Edition (SP1 or higher)

• Microsoft Windows Vista™, Business or Ultimate edition (32-bit and 64-bit).

• 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




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.

• 515MB (including 160MB for Maya documentation)

Other software • 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

Optional hardware

• 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.

Category Values


18


> Installation directory (Windows)

Installation directory (Windows)The following table shows where Maya is installed by default on different Windows operating systems.

Maya on 64-bit systemsThe 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 2008 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 featuresThe following table lists features that are not supported in 64-bit Maya.

32-bit Maya 64-bit Maya

Windows Vista 64-bit, Windows XP x64

C:\Program Files (x86)\Autodesk\Maya2008

C:\Program Files\Autodesk\Maya2008

Windows Vista 32-bit, Windows XP, or Windows 2000 (32-bit)

C:\Program Files\Autodesk\Maya2008

n/a



> Maya on 64-bit systems

Microsoft Runtime LibrariesThe Maya 64-bit installer puts the Microsoft runtime libraries into the System directory C:\Windows\WinSxS using the Microsoft redistributable Merge Modules.

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 64-bit Maya

Maya Motion Capture feature Not supported in 64-bit Maya. We recommend using Autodesk MotionBuilder for motion capture.


20


> Maya on 64-bit systems

Maya API and Developer KitFor details on API and Developer support for 64-bit Maya, see the API guide under Developer Resources in the Maya Help.

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.



> Installing Maya (Windows)

Installing Maya (Windows)For information on the other installation options, see the following:

• “Uninstalling Maya” on page 28

• “Maya Plug-ins” on page 27

• “Bonus Tools” on page 28

• “Installing the Maya Shader Library” on page 57

To install Maya for Windows

1 Insert the Maya DVD into your drive.

The Maya installer window appears.

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 2008 on your computer before reinstalling Maya 2008. For more information, see “Uninstalling Maya” on page 28.

Installer window on 64-bit machines


22



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.

4 Scroll to the end, click “I Agree”, and click Next to continue with the Maya software installation.

The Autodesk Product Configuration window appears.

5 Select whether you want to install Autodesk Maya 2008, the Autodesk Maya 2008 Documentation, or both (the default), and click Next.




The installation proceeds, and the Maya Product Configuration window appears.

6 On the Maya Product Configuration screen, you can set two options:

• 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 Japanese User Interface Resources), or modify the default file associations, 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:

• Select Full to select a Full setup Maya installation (recommended), click Next, and proceed to step 9.

• Select Custom, click Next, and proceed to the next step.

7 (Custom installation only) The Feature Selection window appears.


24



By default, Japanese User Interface Resources are turned off. If you want to turn on or off an item so it installs or does not install, click the down arrow icon in the list and change the selection from the submenu.

At a minimum, you must install the following to run Maya:

• Maya Program Files—contains the core Maya software

• Licensing—includes files essential to licensing.

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.

8 (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.

9 (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.

• Add a Shortcut to the Desktop—Adds the Maya shortcut icon to your desktop during the installation.


26


> Maya Plug-ins

Make your selections and click Next.

10 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.

11 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 71 and “Webkey” on page 72.

• 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 “Installing license server software” on page 65 and “Licensing Maya” on page 67 for details of how to set up both servers and clients.

For more information, see “Licensing Maya” on page 67.

Maya Plug-insThe 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.

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 “Licensing Maya” on page 67.



> Bonus Tools

Bonus ToolsBonus 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 MayaYou can uninstall Maya in three different ways.

To uninstall Maya for Windows using the Maya DVD


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 > Autodesk Maya 2008 > Uninstall Maya.


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 2008 and then click Remove.


Note You must uninstall the documentation separately.


28


> Installing Maya 2008 alongside previous versions

Installing Maya 2008 alongside previous versionsMaya 2008 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 MayaTo make full use of Maya’s capabilities, you must have a graphics card qualified to run Maya. Please refer to:


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.



> 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.


30

4 Installing Maya for Mac OS X

Overview of installing Maya for Mac OS XThis 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 2008 supports both PowerPC and Intel processors on Mac OS X through a Universal Binary.

Before you begin: checklistYou 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 and “Installing license server software” on page 65.







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.


4 | Installing Maya for Mac OS X


System requirementsAutodesk 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:


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:

• Close all programs.

• Disable any virus detection software.

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.

Under most circumstances Maya performs correctly if the path is not set.



32



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.





• 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, hardware-accelerated 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.

Operating system

• Mac OS X version 10.4 or later

• Mac OS X Server is not supported

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.



• A minimum of 750MB of available disk space for Maya and 255MB for Maya documentation.

Category Values


34


> Maya on Intel Mac OS X

Maya on Intel Mac OS XThe 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 featuresThe following table lists features that are not supported in Maya for Mac OS X on Intel processors.

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.

• Safari™ and Mozilla Firefox web browsers have been qualified to view the Maya Help.

Optional hardware

• Wacom™ tablet. Make sure you install the latest Wacom driver software (www.wacom.com).

Category Values



> Installing Maya (Mac OS X)

Installing Maya (Mac OS X)If you have a hardware lock (dongle), you must plug it in after installation. If it is 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.

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 2008 Finder window does not open automatically, double-click the Maya 2008 disk icon on your Desktop.

2 Double-click the Maya 2008 package icon within the Maya/MacOSX folder 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.

Feature Comments

Vector Renderer plugin Not supported (3rd party library).

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 57.

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.


36



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:




• 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).

• 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 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 71 and “Webkey” on page 72.

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).

• 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”.


38


> Uninstalling Maya

Additionally, if you’re setting up a license server, see “Installing license server software” on page 65 and “Licensing Maya” on page 67 for details on how to set up both servers and clients.

For more information, see “Licensing Maya” on page 67.

When the installer finishes, it displays a message indicating that the software install is complete.

Uninstalling MayaTo ensure a clean installation, uninstall any existing copy of Maya 2008 on your computer before reinstalling Maya 2008.

To uninstall Maya for Mac OS X

1 Navigate to the Maya directory (by default, this is Applications/Autodesk/maya2008/).

2 Double-click the Uninstaller icon.

The uninstaller program appears.

3 Select the components you want to uninstall and click Uninstall.



> Software that can be installed separately

Software that can be installed separatelyThe following additional software is provided on the Maya DVD to be installed separately, if necessary.

• Autodesk DirectConnect components

• 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 “Installing license server software” on page 65 and “Licensing Maya” on page 67.

Installing Maya 2008 alongside previous versions of MayaMaya 2008 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 MayaThe Maya Terminal.term file provided in your Maya directory launches a Terminal window that has all the proper path information to run Maya command-line 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/maya2008/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.


40

5 Installing Maya for Linux

Overview of installing Maya for LinuxThis 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







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.


5 | Installing Maya for Linux


The default software installation performs the following tasks:

• Creates and installs software in the following directories:/usr/autodesk

/usr/autodesk/maya2008

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

System requirementsAutodesk 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.

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.

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.



42



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® 4 or higher (EM64T-capable for 64-bit), AMD® Athlon 64™ 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

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.




Operating system

32-bit and 64-bit operating systems:

• Red Hat® Enterprise Linux WS 4.0 update 4

• Fedora Core 5

• SUSE™ 10.2

Please check at www.autodesk.com/qual-charts for important updates.


• 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 2008 the required library libXm.so.3 is automatically installed in /usr/autodesk/maya2008/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.

Category Values


44


> Installation directory (Linux)

Installation directory (Linux)The following table shows where Maya is installed by default on Linux 64-bit and 32-bit operating systems.

Maya on 64-bit systemsThe 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 2008 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

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).

32-bit Maya 64-bit Maya

64-bit Linux OS

/usr/autodesk/maya2008 /usr/autodesk/maya2008-x64

32-bit Linux OS

/usr/autodesk/maya2008 n/a

Category Values



> Installing Maya (Linux)

• Additional general registers in 64bit mode allow the compiler to generate better code which spills to memory less often.

Supported featuresThe following table lists features that are not supported in 64-bit Maya.

Maya API and Developer KitFor 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

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 64-bit Maya

Maya Motion Capture feature Not supported in 64-bit Maya. We recommend using Autodesk MotionBuilder for motion capture.


46



• 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.”

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.

To install using rpm

1 Log in as root.


3 Mount the DVD drive. For example, type:mount -r /dev/dvd /mnt/dvd

4 Change to the directory where the Maya for Linux is installed. For example, type:cd /mnt/dvd/Linux

5 Use the ls command to list the packages on the DVD.

Note If you have previously installed a version of Maya 2008 for Linux, uninstall that version before installing this newest version. See “Uninstalling Maya” on page 50.




6 To install the required base software, enter the following command:

(32-bit)

Package Name (# is the package number)

Description When required

(32-bit) AWCommon-10.80-#.i686.rpm

(64-bit) AWCommon-10.80-#.x86_64.rpmLicensing software

Always

(32-bit) AWCommon-server-10.80-#.i686.rpm

(64-bit) AWCommon-server-10.80-#.x86_64.rpm

Licensing Server software

For serving networked licenses

(32-bit) Maya2008_0-2008.0-#.i686.rpm

(64-bit) Maya2008_0_64-2008.0-#.x86_64.rpm

Maya for Linux Always

(32-bit) Maya2008_0-docs_en_US-2008.0-#.i686.rpm

(64-bit) Maya2008_0_64-docs_en_US-2008.0-#.x86_64.rpm

Maya 2008 documentation

Optional

(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

Hardware lock drivers for Red Hat and SUSE

Only if you have a hardware lock (dongle)


48



rpm -ivh AWCommon-10.80-#.i686.rpm Maya2008_0-2008.0-#.i686.rpm

(64-bit)

rpm -ivh AWCommon-10.80-#.x86_64.rpm Maya2008_0_64-2008.0-#.x86_64.rpm

where # refers to the specific package numbers.

Maya 2008 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:

(32-bit) rpm -ivh Maya2008_0-docs_en_US-2008.0-#.i686.rpm(64-bit)rpm -ivh Maya2008_0_64-docs_en_US-2008.0-#.x86_64.rpm

9 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/autodesk/maya2008

(64-bit) /usr/autodesk/maya2008-x64

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.



> Uninstalling Maya

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.

Installing Maya on file systems other than /usrBy 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/autodesk/maya2008 or /usr/autodesk/maya2008-x64 to that file system.

For example, if you are installing 32-bit Maya 2008 on a file system called /freespace, type the following commands:

su root

ln -s /freespace/autodesk/maya2008 /usr/autodesk

Uninstalling MayaTo 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:

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.


50


> Additional Linux notes

AWCommon-10.80-#

AWCommon-server-10.80-#

4 Uninstall each listed package using the following command:

rpm -e Package

where Package is the name obtained in the previous step.

Additional Linux notesThese 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 2008 Release Notes.

Compiling plug-ins and standalone programsTo compile plug-ins and standalone applications for Maya 2008 on Linux, use the released gcc 4.1.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 249, “Linux environments ( 32-bit and 64-bit )” on page 249, and “Linux compiler requirement” on page 251 in the API Guide.

Differences in operationWhen installed on a Linux system, Maya works in much the same way as when installed on Windows.

Note Uninstalling the AWCommon software does not affect any license files in the license directory (/var/flexlm).




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/autodesk/maya2008/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 2008 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 2008 Release Notes for more information.

Linux desktop configurationTo 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 configurationFor 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.


52



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:

• (Red Hat Enterprise Linux WS 4.0) Open the Actions tab.

• (Fedora Core 5) Open the Window Actions tab.

4 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

For modifier key Meta, set all mouse action combinations to Nothing.




5 Click Apply and close the Control Center.

Gnome under Red Hat

1 Open the Gnome Panel.


• (Red Hat Enterprise Linux WS 4.0) Select Applications, then Preferences and then select Windows.

Meta

Meta


54



• (Fedora Core 5.0) Select System, then Preferences and then select Windows.

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.





56

6 Installing the Shader Library

Installing the Maya Shader LibraryAfter 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.Copy the shaderLibrary folder from the 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/autodesk

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.


6 | Installing the Shader Library

> Installing the Maya Shader Library

(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/autodesk/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.


58

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 to Using 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.


7 | Installing mental ray for Maya satellite

> Slave machine installation

Slave machine installationThe 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.

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\mentalraysatellite2008\

(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.

2 Follow the installation steps.

During the installation, you can change the installation directory. The default installation directory is:

/Applications/Autodesk/mentalray Satellite 2008

(Linux) To install mental ray standalone with satellite licensing using rpm

1 Log in as root.

2 On each slave machine, begin the installation process by inserting the Maya DVD.

3 Mount the DVD drive. For example, type:

mount -r /dev/dvd /mnt/dvd


60


> Slave machine additional setup

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):

(32-bit) rpm -ivh mental_ray_satellite2008_0-2008.0-#.i686.rpm

(64-bit) rpm -ivh mental_ray_satellite2008_0_64-2008.0-#.x86_64.rpm

Slave machine additional setupOnce 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\mentalraysatellite2008\bin\.

3 Type the following:

raysat2008server /query

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 port setup

A message should be returned that the RaySat2008 Server service is running.

If you do not get this message, make sure that RaySat2008 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:

raysat2008server /start

Slave machine port setupOn the slave machine, port number 7107 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 7107, 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

2 Change the number in the following line (here, 7107) to the desired port number:

mi-raysat2008 7107/tcp

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


62


> 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-raysat2008.

3 Click on the lock icon to authenticate and change settings, including the port number (by default, this is 7107).

Licensing of satellite renderingFor more details about licensing of Maya, see the Licensing chapter of this guide.

Your version of Maya determines how many networked CPUs running satellite-enabled 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.

Tip You can also use the nitutil command-line utility to change the configuration of mental ray 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.

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.

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.


64

8 Installing license server software & updates

Installing license server softwareFor more details on licensing, see Chapter 9, “Licensing Maya”.

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 folder 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

Upgrading the license for license server softwareFor Platinum membership customers: If you already have a license server set up, and you need to update the license to Maya 2008, you may be able to do so by running the License Updater on the Maya DVD. (This is equivalent to the Prekey running during the Maya installation process.)

To do so, navigate to the LicenseUpdater folder on the Maya DVD and run the platform-appropriate version of the License Updater.

Note For Linux, you may have to copy the License Updater executable to a local drive to run it.


8 | Installing license server software & updates

> Installing license server software

If your server is not updated with a new license from the License Updater, you can download the Webkey and attempt to update your license. For more information, see “Webkey” on page 72.


66

9 Licensing Maya

Who should use this chapterIf you are a new customer, you can follow the instructions in the Quick Start Licensing chapter. For more information, see Chapter 2, “Quick Start Licensing”.

If you are an existing Autodesk customer:

• your license may be available for you when you install Maya

The Prekey file is run after installation. If your licenses are still not installed, follow the instructions in this chapter to obtain and install your licenses using the Webkey.

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 68.

• your license was not found in the Webkey file

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 86).


9 | Licensing Maya

> Who should use this chapter

Overview of licensing: some definitionsAll 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.


68

9 | Licensing Maya


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 9.000 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 9.000 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


9 | Licensing Maya


Server

In network license configurations, the machine that provides licenses as requested by users on client machines.

License fileThe 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 2008 license lets you run previous versions of Maya.

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 71.

If you have problems configuring your hardware lock, see “Confirming hardware lock driver activation” on page 101 or go to:

www.autodesk.com/maya-support

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.


70

9 | Licensing Maya

> Prekey

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 101.

• 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 87, “(Linux) To start the license server” on page 88, and “(Mac OS X) To start the license server” on page 89.

Where is your serial number?New customers who purchase Maya receive a serial number in one of the following ways:



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 74.

Your license upgrade may be installed for you

PrekeyIf you are an existing Autodesk customer, your licenses may already be installed for you when you install Maya, using the Prekey file.

Note Email filters may prevent you from seeing your license email, Look in your spam folder for email from <[email protected]> with a subject line of ‘Software Product Activation Serial Numbers’.


9 | Licensing Maya

> Webkey

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 72 and “Activating the software from a serial number” on page 74.

WebkeyIf 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 > Programs > Autodesk > Autodesk Maya 2008 > Licensing.

• (Mac OS X) In /Applications/Autodesk/PCW/, double-click the Autodesk Product Configuration Wizard icon.

• (Linux) Enter the following command in a shell:

/usr/autodesk/maya2008/bin/opa

2 Expand all icons and select Download license upgrades for Maya 2008.


72

9 | Licensing Maya

> Webkey

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

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.


9 | Licensing Maya

> Activating the software from a serial number

Activating the software from a serial number

Note: You can follow the instructions in the Quick Start Licensing chapter. For more information, see Chapter 2, “Quick Start Licensing”.

The following procedures explain how to license Autodesk Maya.

New customers who purchase Maya receive a serial number in one of the following ways:



33-character Maya serial numbers always begin with the letters ‘MC’ or ‘MU’. 11-character 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.

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.


74

9 | Licensing Maya


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).

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 81) to license the computer you want to use.


9 | Licensing Maya


2 Click I have a serial number that I need to activate and click Next.

The following dialog box appears.


76

9 | Licensing Maya


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.



9 | Licensing Maya


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.


78

9 | Licensing Maya


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 71.

5 Click Next.


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.


9 | Licensing Maya


When you submit the form, your license is displayed in your web browser and sent to the email address you specified.

7 Click Next.


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 84.


80

9 | Licensing Maya

> Installing a license

Installing a licenseUse 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 74 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 74.)

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:


• (Mac OS X) In the Maya directory (by default, this is /Applications/Autodesk/Maya2008/), double-click the Autodesk Product Configuration Wizard icon.



2 Go to the Autodesk Product Configuration dialog box.

Note Email filters may prevent you from seeing your license email, Look in your spam folder for email from Autodesk Online Activation <[email protected]> with a subject line that starts with ‘license’.


9 | Licensing Maya


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.


82

9 | Licensing Maya


One of the following dialog box appears.


• 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.


9 | Licensing Maya


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.


84

9 | Licensing Maya

> If the licensing is not successful

If the licensing is not successfulIf 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 Chapter 10, “Troubleshooting” for more details on what to look for.

To request a license if you don’t have a serial numberOn 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.

Tip If you need to use the Product Configuration Wizard again, you can launch it by doing one of the following:


• (Mac OS X) Double-click the Maya Product Activation icon in the Applications/Autodesk/maya2008/ folder.

• (Linux) Run /usr/autodesk/maya2008/bin/opa


9 | Licensing Maya

> Additional setup for networked licenses

Server setup

Additional setup for networked licensesTo 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 74 and “Installing a license” on page 81), then set up each client computer that obtains a license from the server. (Servers can serve a license to themselves.)

(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.

Notes • If you are serving Maya 2008 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.


86

9 | Licensing Maya


6 Check that the values shown are correct:

• Path to the lmgrd.exe file is C:\Program Files\Common Files\

Alias Shared\Licensing\etc\lmgrd.exe

• Path to the license file is: C:\FLEXLM\aw_servername.dat, where servername is the name of the license server machine.

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.

Note The path to the debug log file is optional and can be left blank.


9 | Licensing Maya


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


88

9 | Licensing Maya


4 Log out of root.

(Linux) Additional troubleshooting stepsIf 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.

killall lmgrd

2 Type the following, and then press Return.

/usr/aw/COM/etc/lmgrd -c <path to license file>

3 View the log file at the following location:

/usr/tmp/aw_flexlm.log

4 Type the following, and then press Return to see if the license manager is running in the process list. For example:

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 102.

(Mac OS X) License server management options and license server confirmation

(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

Note Mac OS X Server is not supported by the FLEXlm licensing software.


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:

sudo /usr/aw/COM/bin/lmstat -c /var/flexlm/aw_server.dat

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.

Client setup

Setting up each clientTo set up each client, you must add information to each client computer’s aw_servername.dat file (on Mac OS X, aw_client.dat).

To set up a client

1 Make sure the license server and client can access each other through your TCP/IP network.




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.


90

9 | Licensing Maya

> Setting up each client



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.


9 | Licensing Maya

> Limiting the use of Maya Unlimited product licenses

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 licensesSome 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.

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


92

9 | Licensing Maya

> Confirming Maya startup

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 startupStart Maya to confirm installation.

The main Maya window opens. The display of the main Maya window confirms you’ve installed and licensed Maya.

MAYA_LICENSE setting Effect on Maya

complete Runs Maya Complete only

unlimited Runs Maya Unlimited only

Note 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.


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 Chapter 10, “Troubleshooting”.

If the Product Configuration Wizard appears, Maya was unable to find a suitable license. See “Installing a license” on page 81.

Additional licensing information

Verifying license server installationIf 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 2008. 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) Select Start > Programs > Autodesk > Common Utilities > FlexLM License Utilities, and in the LMTOOLS window, select Help > About.

• (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.


94

9 | Licensing Maya


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.


9 | Licensing Maya



96

10 Troubleshooting

Troubleshooting licensing: introductionThis 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 99

• “Licensing troubleshooting” on page 102

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 99

• “Troubleshooting licensing problems (Linux, Mac OS X)” on page 102

• “Troubleshooting licensing problems (Windows)” on page 105

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 CENTERThe North American Support Center provides support for different geographic areas.


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: [email protected]

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: [email protected]

ASIA PACIFIC SUPPORT CENTERPlease contact your local reseller for support.

www.autodesk.com/contactsupport

Autodesk Insider Case Management (Platinum membership only)The most efficient way to handle your technical support issue.


98


> Issues at startup

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

Maya Support Centerwww.autodesk.com/mayaplatinum

Issues at startup The following section deals with problems occurring at startup that are not license related.

Preference corruptionSymptom: 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.)

The default prefs directory path is:

Windows

• (Windows XP)\Documents and Settings\<username>\My Documents\maya\

2008\en_US\prefs

• (Windows XP 64bit)\Documents and Settings\<username>\My Documents\maya\

2008-x64\en_US\prefs

• (Windows Vista)\Users\<username>\Documents\maya\2008\en_US\prefs



> Issues at startup

• (Windows Vista 64bit)\Users\<username>\Documents\maya\2008-x64\en_US\prefs

Mac OS X• /Users/<username>/Library/Preferences/Autodesk/maya/en_US/

2008/prefs

Linux

• (32-bit)~<username>/maya/2008/en_US/prefs

• (64-bit)~<username>/maya/2008-x64/en_US/prefs

The Product Configuration Wizard does not appearIf 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:





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 doesThis 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:



100


> Issues at startup

Confirming hardware lock driver activationHardware lock drivers enable communication between a computer and its hardware lock.

(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:

www.aladdin.com/support/hasp/enduser.aspx

• Uncompress and install the downloaded file.

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.1-3.i386.rpm. For more information, see “Installing Maya (Linux)” on page 46 for Linux.

Licensing troubleshootingThe following section deals with problems starting up Maya due to a licensing problem.



> When you start Maya

When you start MayaIf 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 67. 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 67.

• 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


102



license default1 If you are using a hardware lock, make sure you attached the hardware lock

correctly. See “Installing your hardware lock” on page 71 for installation details.

2 Confirm that the driver for the Hardware lock device is correctly activated. See “Confirming hardware lock driver activation” on page 101.

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 107.

Cannot find any aw*.dat files in /var/flexlm1 Verify that the /var/flexlm directory contains the file aw*.dat.

2 If this file doesn’t exist, you may have not done the steps required in “Licensing Maya” on page 67. You’ll need to reinstall 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 90.

Note 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.

Note This message occurs only with networked licenses.




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 94.

2 Stop and start the license server software as described in “Additional setup for networked licenses” on page 86.

3 If that does not solve the problem, do the steps in “Examining a licensing log file” on page 107.

(Linux) Account is not availableWhen 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:/:

Alternatively, you may change the nobody account to an account that exists:

To change the nobody account to an existing account

1 Create a regular user account (for example, flexlm).

2 Log in as root.

3 Open the /etc/rc.d/init.d/aw_flexlm file


104



4 In SU="/bin/su nobody –c" line, change nobody to the user name (flexlm).

5 Start the flexlm license service with the /etc/rc.d/init.d/aw_flexlm start command.

Troubleshooting licensing problems (Windows)One of the following error messages may appear if the Maya main window doesn’t appear:


Error setting license default.

Unable to locate a license server for 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 default1 If you are using a hardware lock, make sure you attached the hardware lock

correctly. See “Installing your hardware lock” on page 71 for installation details.

2 Confirm that the driver for the Hardware lock device is correctly activated. See “Confirming hardware lock driver activation” on page 101.

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 107.

7 Do the steps in “Checking for licensing errors with FLEXlm licensing utilities (Windows)” on page 116.


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 90.

• 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 86.

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 67.

2 Do the steps in “Checking that a license file is the correct file type (Windows)” on page 119.

No licenses found for your FLEXid flexid• You don’t have any licensing information in the license file.

Note This message only occurs with networked licenses.


106


> Examining a licensing log 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 fileIf 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:


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:set FLEXLM_DIAGNOSTICS=2

3 To repeat the failed attempt to start Maya, use the full path:<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\Maya2008\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 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.

5 Find the message in “Understanding log file error messages” on page 109 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):FLEXLM_DIAGNOSTICS=2

2 Do one of the following, depending on your platform:

• (Linux) Type /usr/autodesk/maya2008/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/maya2008/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:

• FLEXlm checkout error.

• License file being used.

• FLEXlm error code and FEATURE line in question.


108



3 Find the message in the following topic, “Understanding log file error messages” on page 109 and follow the instructions.

Ignore other information in the file. If the message isn’t listed, call Autodesk Support.

Understanding log file error messagesError 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.

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.

FLEXLM checkout error: Future license file format or misspelling in license file.

• Make sure you have the newest version of FLEXlm license server (Maya 2008 requires version 10.8). See “Verifying license server installation” on page 94.

• 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.


110



FLEXLM checkout error: No SERVER lines in license file.

• 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.

or

The hostid of this system

does not match the hostid

specified in the license

file.

• 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 77.

• Check that the hardware lock (dongle) is plugged into the parallel port or USB port correctly. See “Installing your hardware lock” on page 71.

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.

FLEXLM checkout error: Cannot connect to license server.

• FLEXlm networked license software has not been installed (see “Verifying license server installation” on page 94) or an older version of FLEXlm networked license software is installed. Maya 2008 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

• Check the network connection on your client machine.

• As a last resort, reboot your license server.

FLEXLM checkout error: Clock difference too large between client and 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.


112


> Finding licensing problems with diagnostic tools

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.

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 77.

(Linux, Mac OS X) To verify hostid information

1 In Terminal or in a shell, type the following:/usr/aw/COM/bin/lmhostid

2 Press Return.

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.

To use lmstat

1 In Terminal or in a shell, type the following:/usr/aw/COM/bin/lmstat -a -c /var/flexlm/LicenseFile

2 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

-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.


114



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


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 86. 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.

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 109.

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 On the machine you want to license, go to Start > Programs> Autodesk > Common Utilities > FlexLM License Utilities.

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.

Tip The FLEXlm Licensing Utilities are located at <drive>:\Program Files\Common Files\

Alias Shared\Licensing\bin\lmtools.exe


116



(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.

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) \


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...



> Running previous versions of Maya: USB hardware lock issues

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 86. If the problem persists, restart the license server computer.

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 issuesIf 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.


118


> Running previous versions of Maya: USB hardware lock issues

The following table shows USB hardware lock version support:

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.

Platform Maya version

Windows 6.5+

Linux 7+

Mac OS X 7+



> Understanding licenses

Understanding licensesThis 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.

Standalone licensesThe following figure shows the structure of a standalone license:

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.

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.

Feature Name License Version Password

FEATURE MayaUnltd sgiawd 9.000 permanent uncounted 1234567890ab\

VENDOR_STRING=xxx HOSTID=00c0f1234abc

Expiration License Count

Host ID/hardware identifier

Vendor String


120


> 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 licensesThe following figure shows the structure of a networked license:

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.

Server

Password

LicenseVersion

Host IDYour servername here

License

ExpirationCount

Port Number

SERVER server FLEXID=9-b2854a12 7111VENDOR sgiawd /usr/aw/COM/etc/sgiawdFEATURE MayaUnltdf sgiawd 9.000 permanent 5 432B9293FFAD3F3726A6 \

SUPERSEDE="MayaUnltdf" \ISSUED=6-jun-2006VENDOR_STRING=xxx

Vendor String

Feature Name



> 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/support/1480.htm provides information on licensing.


122

Index

Numerics32-bit Maya

installation directory 19, 45

64-bit Mayabenefits 19, 45installation directory 19, 45

Linux 45non-supported features 19

supported features 46Windows 19

Aactivation key

installing 81API Toolkit

Mac OS X 38

Cclient

setup for Windows 90clients

setting up 90configuration

desktop 52

confirminginstallation 93Maya installation 93

custom installationLinux 47

Ddesktop configuration 52disk space

file system and 50display performance 29Documentation

installing Linux 49

Eerror messages

log file 109upon starting Maya 102, 105

Ffile system other than usr 50File Type Handling setting 25FLEXlm

description 68FLEXLM_DIAGNOSTICS 107floating licenses

installing 86

Ggraphics cards

driver software 17Mac OS X 34setting options 29Windows 29

Hhardware ID 78hardware locks

ID 78

IIFF files

Mac OS X support 40installation

confirming 93file system other than usr 50

license server 65Quick Start 11rpm utility 47Shader Library 57

Installation directoryLinux 45

installation directory 19


Index

installing MayaLinux 41–55Mac OS X 31–40Windows 15–30

KKDE 52key bindings

configuring 52

Llicense management options

86, 88, 89license server

checking status 87installation 65startup 88, 89stopping, starting, and checking 86, 87, 88, 89

licenseschecking for errors with lmtools 116

error log file 107installing floating 86single machine 11

licensingsatellite rendering 63

licensing Maya 67–95Linux

compiling plug-ins and applications 51

lmtools 116

log filelicensing errors 107

Mmaster machine 59Maya

new users 11Maya Plug-ins 27MAYA_SHADER_LIBRARY_PA

TH 58mental ray

satellite rendering 59Microsoft Runtime Libraries

20motion capture 18

Nnew users of Maya 11

OOPA (Online Product

Activation)website 79

Pport number

changing 62Prekey

descriiption 71

Qqualified hardware

Linux 42Mac OS X 32Windows 16

Quick Start 11QuickTime Components 40

Rray sat server 61rpm utility 47

Ssatellite rendering

changing port number 62licensing 63master 59mental ray 59ray sat server 61slave 59slave machine installation 60

serial numberactivation key 11

Shader Libraryinstallation 57

single machine licenses 11slave machine 59starting

Maya 93


124

Index

startuplicense server 88, 89Maya error messages 102

Status buttonlmtools 117

stencil planes 30stopping and starting

license server 87system requirements


Ttechnical support, contacting

97third party plug-ins 27troubleshooting 97–122

licensing 102–122starting Maya 99–102

True Color 29

Uuninstalling Maya


unsupported Maya features 51

usr file system 50

VVendor String 121versions

previous 70previous kept 42

VRAM 29

WWacom tablet 18, 35, 45Webkey

description 72


Index


126