Installation and Licensing

Transcription

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