installing maya 4.5 for irix - unicampmartino/maya/pdf/reference... · 2004. 4. 20. · installing...

INSTALLING MAYA 4.5 FOR IRIX

INSTALLING MAYA 4.5 FOR IRIX 2002, Alias|Wavefront, a division of Silicon Graphics Limited. Printed in U S A. All rights reserved.

Alias and the Alias|Wavefront logo are registered trademarks and Alias|Wavefront, Conductors, Dispatcher, Trax, IPR,Export Express, Maya Artisan, Maya Cloth, Maya Complete, Maya Fluid Effects, Maya Fur, Maya Live, Maya Paint Effects,Maya Real-Time Author, Maya Shockwave 3D Exporter, and Maya Unlimited are trademarks of Alias|Wavefront, a divisionof Silicon Graphics Limited.

Maya is a registered trademark of Silicon Graphics, Inc., used exclusively by Alias|Wavefront, a division of Silicon GraphicsLimited.

IRIX and Silicon Graphics are registered trademarks and SGI is a trademark of Silicon Graphics, Inc. Lingo is a trademarkand Macromedia, Director and Shockwave are registered trademarks of Macromedia, Inc.

OpenFlight is a registered trademark of Multi-Gen Paradigm Inc.

Wacom is a trademark of Wacom Co., Ltd.

NVidia is a registered trademark and Gforce is a trademark of NVidia Corporation. Inferno and Flame are registeredtrademarks of Discreet Logic Inc. Linux is a registered trademark of William R. Della Croce.

Red Hat is a registered trademark of Red Hat, Inc.

Microsoft, Windows XP, and Windows are trademarks of Microsoft Corporation in the United States and/or other countries.

Mac and Macintosh are trademarks of Apple Computer, Inc., registered in the United States and other countries.

Adobe and Acrobat are trademarks of Adobe Corporation.

UNIX is a registered trademark, licensed exclusively through X/Open Company, Ltd.

All other trade names, trademarks and/or service marks are trademarks or registered trademarks of their respectiveowners.

This document contains proprietary and confidential information of Alias|Wavefront, a division of Silicon Graphics Limited,and is protected by Federal copyright law and international intellectual property agreements and treaties. The contents ofthis document may not be disclosed to third parties, translated, copied, or duplicated in any form, in whole or in part, or byany means, electronic, mechanical, photocopying, recording or otherwise, without the express prior written consent ofAlias|Wavefront, a division of Silicon Graphics Limited. The information contained in this document is subject to changewithout notice. Neither Alias|Wavefront, a division of Silicon Graphics Limited, nor its affiliates, nor their respectivedirectors, officers, employees, or agents are responsible for punitive or multiple damages or lost profits or any other direct,indirect, special, indirect, incidental, or consequential damages including any damages resulting from loss of businessarising out of or resulting from the use of this material, or for technical or editorial omissions made in this document.

ALIAS|WAVEFRONT � 210 KING STREET EAST � TORONTO, CANADA M5A 1J7

CONTENTS
1 INTRODUCTION
About the CDs shipped with Maya 5

About this book 5

Important notes for customers who upgrade 6

2 INSTALLING MAYA

Setting up IRIX and your hardware 8

Installation requirements 8

Installing with Software Manager 9

Installing with inst 13

Using inst without prompts 15

Advanced installation procedures 15

Installing on file systems other than /usr 15

Performing a client/server installation 16

Installing Maya on many machines at once 17

Mounting a CD-ROM drive 18

Accessing a remote CD-ROM 20

Installing the Maya Shader Library 20

3 LICENSING MAYA

Licensing workflow 23

License overview 24

Changes made by licensing 24

Obtaining a license 24

Installing licenses 25

Installing licenses from e-mail, fax, or mail 26

Installing IRIX 6.5 floating license software 27

Additional setup for floating licenses 28

Setting up each client 29

Starting Maya 31

INSTALLING MAYA FOR IRIX

3

CONTENTS

Limiting use of Maya product licenses 31

4 TROUBLESHOOTING

Contacting Support Services 33

Installation troubleshooting & FAQ 34

Questions and answers 34

Troubleshooting licensing problems 35

Examining a licensing log file 37

Understanding log file error messages for IRIX 37

Other licensing diagnostic tools 40

Stopping and starting the license server 44

Understanding licenses 45

Node-locked licenses 45

Floating licenses 46

Additional resources 47

INDEX 49


4

1 INTRODUCTION

This book describes how to install and license Maya on IRIX. Theinstructions apply to Maya Complete and Unlimited.

ABOUT THE CDS SHIPPED WITH MAYA

The Maya shipment includes CDs for all products and operating systems.You must select the appropriate CDs for your purchase and operatingsystem.

CDs included for IRIX:

• Maya Complete 4.5/Maya Unlimited 4.5/Maya Batch Renderer 4.5 for IRIX

This CD contains the main Maya software for all Maya packages—MayaComplete and Maya Unlimited. By default, the installation program installsall of the products. Your Maya license specifies which features you can use.This CD also contains the html files for Maya documentation and the ShaderLibrary files, which are Maya scene files consisting of over 60 shadingnetworks, including materials and file textures.

• Maya 4.5 Documentation and Lessons CD

This CD contains the Maya documentation files in PDF format for printingand data files for the Instant Maya lessons.

ABOUT THIS BOOK

This book is broken into the following chapters:

• Chapter 2, Installing Maya, describes how to install Maya.


5

INTRODUCTION | 1Important notes for customers who upgrade

• Chapter 3, Licensing Maya, describes how to license Maya and confirm thatMaya starts.

• Chapter 4, Troubleshooting, describes how to troubleshoot installation andlicensing problems. If you see error messages during installation or you can’trun Maya after installation, see this chapter.

IMPORTANT NOTES FOR CUSTOMERS WHO UPGRADE

Note these important system changes:

• Maya 4.5 uses FLEXlm version 7.2 floating license software. Make sure youupgrade license servers as the licensing software installed with previousversions of Maya will not work with Maya 4.5.

• Having multiple versions of Maya installed on a machine and adding eachversion’s path to the user’s environment PATH variable may cause versionconflicts when using standalone programs. In particular rendering fur mayuse the wrong version of the fur renderer and so cause incomplete rendersor not run.

Add only the path that is currently needed for the version of Maya that isbeing run. You may not have to include the path to Maya at all. On IRIX theMaya wrapper script sets the path to the proper path automatically.

• Since Maya 3, Maya stores hotkey preferences in a new file and a differentformat. The first time you start Maya, it will find and convert saved hotkeypreferences to the new Maya 4.5 structure. Do not copy hotkey preferencefiles from a prior Maya version to the Maya 4.5 directory.

• Now after you install Maya, you are prompted to install the encryptedlicenses from the CD. A message tells you if the licenses were installed. Ifthey weren’t, but you have Internet access you can check the README_licfile found in the LicenseMaya directory in the top level of the Maya 4.5Software CD. This readme file contains instructions for downloading andaccessing the most up-to-date encrypted license file from our Web site. Fordetails, see Chapter 3, “Licensing Maya.”


6

2 INSTALLING MAYA

This chapter describes how to install Maya, as well as the Shader Library.You can choose from the following methods of installation:

• “Installing with Software Manager” on page 9

• “Installing with inst” on page 13

Other methods, such as batch installation, are covered in “Advancedinstallation procedures” on page 15.

What the installation doesThe default installation performs the following tasks:

• Creates /usr/aw (the base location for all Alias|Wavefront software) if itdoes not already exist.

• Creates /usr/aw/maya4.5. Any previous versions of Maya are leftuntouched.

• Creates or updates the symbolic link from /usr/aw/maya to the actualinstallation location.

• Updates A|W common software (/usr/aw/COM) to work with Maya. Thissoftware contains the shared libraries and license-related programs used byall Alias|Wavefront software.

• Creates symbolic links from some of the files in /usr/sbin to the new Mayasoftware.

• Creates an Alias|Wavefront software page in the Icon catalog if it does notalready exist.

• Adds Alias|Wavefront file types to the file database (/etc/magic).


7

INSTALLING MAYA | 2Setting up IRIX and your hardware

SETTING UP IRIX AND YOUR HARDWARE

The following pages describe system requirements and how to set up IRIXand your hardware for Maya.

Installation requirementsThe minimum hardware requirements for running Maya follow. For moredetails, see the Maya Qualification Chart on our Web site:

http://www.aliaswavefront.com/qual_charts

Hardware requirementsTo install and run Maya, your workstation must have:

• 24-bit graphics

• a hardware Z-buffer (unless the workstation is an Indy or Indigo2 XL)

• 128 Mbytes or more available memory

• access to a CD-ROM drive

Disk space requirementsThe following are approximate sizes for the various Maya CDs. These aredefault, minimal sizes; you’ll need more space to install optional selections.

• Maya Complete: 352 Mbytes (including 166 Mbytes for Maya onlinedocumentation)

• Maya Unlimited: additional 45 Mbytes (400 Mbytes total)

• Maya Shader Library: additional 110 Mbytes

Operating systems requirementsMaya 4.5 requires IRIX 6.5.12 or higher. For the qualified version of IRIX 6.5,see the Maya 4.5 Qualification Chart at the following Web site:

Notes

To find out the disk space for custom installations, view the informationlisted by Software Manager when you click Customize Installation.


8

INSTALLING MAYA | 2Installing with Software Manager


If you have a version of IRIX newer than the qualified version, contactAlias|Wavefront Support Services if you find any issues related to runningthe newer, untested version.

Other requirementsNetscape 4.7 or higher is required to view the online documentation.

INSTALLING WITH SOFTWARE MANAGER

Follow these instructions or “Installing with inst” on page 13. (Werecommend using the IRIX Software Manager if this is your first time.)

Prerequisite steps• Stop Maya and any license server processes, if running.

• Make sure you meet the “Installation requirements” on page 8.

To install using Software Manager:

1 Log in the target machine as root. If you don’t have root user privileges, seeyour system administrator.

2 Insert the main Maya software CD into the target machine or a remotemachine with a CD-ROM drive.

3 Check for the following CD-ROM icon on your desktop, indicating that yourCD-ROM is mounted.

Note

Remember to log out of root when you want to run Maya. We don’trecommend running Maya as a root user.


9


If you do not have this icon, check that the CD-ROM drive is mounted bytyping ls /CDROM. This should list its contents.

If the CD-ROM is not mounted, see “Mounting a CD-ROM drive” on page18.

4 On the target machine, start Software Manager by typing the following in ashell: swmgr.

or

Shortcut: Double-click the CD-ROM icon on your desktop. In this case, skipto step 7.

5 Enter the path to the CDROM at the top of the Software Manager window,such as /CDROM/dist.

If you are using a remote CD-ROM drive and your network is set up to useNFS with auto-mount, enter the path to the remote CD-ROM. For example:

/remote/host/CDROM/dist

where remote is the auto-mount point and host is the remote machine name.

For other methods of accessing a remote CD-ROM drive, see “Accessing aremote CD-ROM” on page 20.

6 Click the Lookup button.

7 Click Execute (or OK) after reading the installation instructions.

Important

dist must be added to the path or this step won’t work.


10


8 When the Software Manager window reappears, click the Start button.

Note

If an Alias|Wavefront Installation Error window displays, you must installsome software from your IRIX CD. Follow the instructions in the windowbefore proceeding with the installation.


11


or

Click Customize Installation to turn off or on the items you want to install.At a minimum, you must install Alias|Wavefront Common Utilities andMaya 4.5, Base Software. These apply even if you are only batch renderingon this machine. However, if this machine is only serving licenses and notrunning Maya itself, you can install just the Common Utilities.

Note that the Maya Unlimited 4.5 software is selected by default. Turn it offif you are installing Maya Complete and you want to save space.


12

INSTALLING MAYA | 2Installing with inst

9 Look for the following dialog to indicate the software installed successfully.

10 Select Exit and click OK.

INSTALLING WITH INST

As an alternative to Software Manager, you can install Maya using the instutility in a UNIX shell.

Prerequisite steps• Stop Maya and any license server processes, if running.

• Make sure you meet the “Installation requirements” on page 8.

To install using inst interactively:

1 Log in the target machine as root.

2 Insert the Maya 4.5 Software CD into the target machine or a remotemachine with a CD-ROM drive.

Note

On some machines, the Start button is disabled when you choose DefaultInstallation. In this case, you must click Customize Installation and thenclick Start.


13

INSTALLING MAYA | 2Installing with inst

3 Check for the following CD-ROM icon on your desktop, indicating that yourCD-ROM is mounted.

If you do not have this icon, check that the CD-ROM drive is mounted bytyping ls /CDROM. This should list its contents.

If the CD-ROM is not mounted, see “Mounting a CD-ROM drive” on page18.

4 On the target machine, enter the following command in a UNIX shell:

/usr/sbin/inst

5 At the inst> prompt, use the from command to specify the distribution area(for example: from /CDROM/dist).

If you are using a remote CD-ROM drive and your network is set up to useNFS with auto-mount, enter the path to the remote CD-ROM. For example:

/remote/host/CDROM/dist

where remote is the auto-mount point and host is the remote machine name.

For other methods of accessing a remote CD-ROM drive, see “Accessing aremote CD-ROM” on page 20.

6 After the README information appears, select option 1, Run the installationstartup script now, to continue with the Maya installation.

7 To install Maya default subsystems, enter go.

or

To choose non-default selections, enter step, enter i on each line of thesubsystems you want to install, then enter go.

At a minimum, you must install A|W Common Software, Common Desktopenvironment, and Maya Base Software. These apply even if you are onlybatch rendering on this machine. However, if this machine is only servinglicenses and not running Maya itself, you can install just the CommonSoftware and Common Desktop environment.


14

INSTALLING MAYA | 2Advanced installation procedures

Note that the Maya Unlimited 4.5 software is selected by default. Turn it offif you are installing Maya Complete and you want to save space.

Using inst without promptsIf you are familiar with inst, you can run it without prompts, especially ifyou want to run it as part of a batch script. However, it requires that allprerequisites have been installed and that there is sufficient disk space.

See “Installing Maya on many machines at once” on page 17 for informationon using inst in a batch script.

To install using inst without prompts:

1 Log into the target machine as root.

2 Load the CD on the target machine or a remote machine with a CD-ROMdrive.

3 From a UNIX shell, enter:

/usr/sbin/inst -a -f dist -V startup_script:execute

where dist is the location of the images, such as /CDROM/dist or a remotemachine path.

4 Once the Maya software is successfully installed, you can proceed toChapter 3, “Licensing Maya.”

ADVANCED INSTALLATION PROCEDURES

Complete the following procedures if you want to install Maya on a differentfile system, in a client/server configuration, or on many systems at one time.

Installing on file systems other than /usrBy default, Maya is installed in the /usr partition. If you want to installMaya on a different file system (due to lack of space), create a symbolic linkfrom /usr/aw/maya4.5 to that file system. For example, if your file systemwas called /freespace, you would enter the following commands beforeinstalling Maya:

su rootmkdir -p /freespace/aw/maya4.5


15


mkdir -p /usr/aw ln -s /freespace/aw/maya4.5 /usr/aw

When you install using this method, Software Manager may report there isinsufficient disk space even though you know there is sufficient space on/freespace. If this happens, enter the following command in the SoftwareManager’s Command Window:

set override_space_check true

This lets you install Maya on the other file system even though /usr is full.

Performing a client/server installationYou can install Maya in a client/server configuration. In this configuration,the full Maya software is installed on a server whose file system is NFS-mounted on each of the clients. The clients then have a minimal set ofsoftware installed locally for desktop and security purposes.

To install Maya in a client/server installation:

1 Install all Maya software on the server machine.

2 Install the Maya client software on each of the clients.

The selection file, maya4_x_client.sel, specifies what software should beinstalled on each client. This file is on the Maya CD under the dist directory.

3 Mount the Maya software directory /usr/aw/maya4.5 from the server toeach client /usr/aw/maya4.5 directory.

4 If you have SuperConductors installed (either from the Conductors CD ordownloaded from the Alias|Wavefront Web site), also mount the/usr/aw/userconfig directory on each client.

Note

We do not recommend a client/server configuration, because it has anegative impact on Maya’s performance. This is particularly a problem onslow networks. If you do choose to install in a client/server configuration,be sure to install the IRIX prerequisite software and patch sets on eachclient.


16


Installing Maya on many machines at onceIn order to install several machines simultaneously, you must create a batchscript that executes the inst utility without prompts. Before this type ofinstallation, make sure all prerequisite software and patches are installed,that there is enough disk space for the installation, and that there are noinstallation conflicts.

The key command that runs inst without prompts is:

/usr/sbin/inst -a -f dist -V startup_script:execute

where dist is the location of the dist directory (for example: /CDROM/dist).

To create and run a batch installation script:

1 Generate a file that contains a list of host names you want to install Maya on,one host name per line.

2 Ensure that the Maya distribution CD is accessible from each of the clients.NFS is the preferred method for doing this, but is not absolutely necessary.

3 Make sure that all the machines have the necessary IRIX prerequisites andpatches installed.

If inst detects any missing prerequisites, the program will stop and yourscript will break.

4 Create a script that logs into each host and executes this command:

/usr/sbin/inst -a -f dist -F dist/maya4_x.sel -V startup_script:execute

For example, if the file from step 1 was named hostlist and the distributionCD was located at master:/CDROM/dist, you could use this sh script:

for i in `cat hostlist`do

echo "Installing on host $i"rsh $i "/usr/sbin/inst -a -f master:/CDROM/dist \-F master:/CDROM/dist/maya4_x.sel -V

startup_script:executedone

(This script uses Bourne/Korn shell syntax. Make the appropriate changes ifyou use the C-shell).


17

INSTALLING MAYA | 2Mounting a CD-ROM drive

To install Maya client software on multiple machines in batch mode:

1 Substitute the following selection file name in the -F argument of the batchscript:

maya4_x_client.sel

2 You must also do the following:

• Use -Vstartup_script:ignore instead of -Vstartup_script:execute

• Specify an exact /CDROM/awdist6.X directory instead of /CDROM/dist

The following script shows an example for installing client-only software:

for i in `cat hostlist`do

echo "Installing on host $i"rsh $i "/usr/sbin/inst -a -f master:/CDROM/awdist6.5

\-F master:/CDROM/awdist6.5/maya4_x_client.sel \ -V startup_script:ignore

done

MOUNTING A CD-ROM DRIVE

If you experience problems because your CD-ROM drive is not mounted,follow these steps, for either a local or remote drive.

To mount a local CD-ROM drive:

1 Find the controller number and unit number for the drive by typing:

hinv | grep CD

The output of this command will be similar to:

CDROM: unit 4 on SCSI controller 0

In this example, the controller number is 0 and the unit number is 4.

Note

This example script installs the maya4_x.sel (normal or server) selectionfile. You can substitute maya4_x_client.sel to install client-only software.


18

INSTALLING MAYA | 2Mounting a CD-ROM drive

2 Use the controller number and unit number to form the device name for theCD-ROM drive. The device name is in the format:

/dev/scsi/sc#d#l0

where the number following sc is the controller number, the number thatfollows the next d is the unit number, and l0 is spelled with lowercase l andzero. For the previous example, the device name would be /dev/dsk/sc0d4l0.

3 If a CDROM directory does not exist, create it by typing:

mkdir /CDROM

4 Mount the CD-ROM drive as a directory. Type:

/etc/mount -t iso9660 /dev/scsi/sc#d#l0 /CDROM

where /dev/scsi/sc#d#l0 is the device name from step 2 and /CDROM is thedirectory you are mounting the CD-ROM drive to.

To mount a remote CD-ROM drive across a network with NFS:

These instructions assume you have NFS on both workstations.

1 On the remote machine, make sure the drive is mounted.

2 On the remote machine, add the file system to the exports list to allow yourtarget machines to use the CD-ROM drive.

Using a text editor, add /CDROM to the /etc/exports file.

3 On the remote machine, type /usr/etc/exportfs -a to allow other machines inthe network to access the file system. This command requires NFS.

4 On the target machine, if a CD-ROM directory does not exist, create it bytyping:

mkdir /cdrom

In this example, we use /cdrom. You can use another name for the directory ifyou prefer.

5 On the target machine, mount the CD-ROM drive as a directory. Type:

/etc/mount hostname:/CDROM /cdrom

where hostname is the name of the machine that has the CD-ROM drive.


19

INSTALLING MAYA | 2Installing the Maya Shader Library

Accessing a remote CD-ROMThere are several ways to access a remote CD-ROM drive. We recommendhaving the CD-ROM drive auto-mounted. If you do not have this capability,here are some other typical methods:

Local mount point using NFS

If you followed the instructions “To mount a remote CD-ROM drive across anetwork with NFS:” on page 19, you simply specify that mount point duringthe installation. We recommend using lowercase /cdrom as the local mountdirectory, because uppercase /CDROM can cause installation problems.

Trusted user account

If you do not have NFS, you can still access a remote drive during theinstallation by specifying a trusted account on the remote machine. Forexample, in the Software Manager or inst from command, type:

root@host:/CDROM/dist

where host is the name of a remote machine with trusted-root access. If theremote computer does not have trusted-root access, you can use an accountthat does not have a password. For example:

guest@host:/CDROM/dist

INSTALLING THE MAYA SHADER LIBRARY

After installing Maya, you can install the Maya Shader Library, which is acollection 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

Important

We use /cdrom (lowercase) as the local mount directory instead of/CDROM (uppercase). Using uppercase /CDROM as the local mountdirectory of a remote CD-ROM drive can cause installation problems.


20


• run it from the CDROM

In order to run it from your local machine, you have to copy the entireshaderLibrary directory and its contents to your computer. For example, youcan copy it to /usr/aw/shaderLibrary. If multiple users will be accessingthis library, put it in a location in which all of the users have read access.

We recommend that you update each user’s Maya environment file or .cshrcfile so that Maya knows where you’ve stored the Shader Library. You shouldalso set up a Shader Library tab in Hypershade.

To install the Maya Shader Library:

1 Insert the Maya 4.5 Installation CD.

2 Start an IRIX shell.

3 Log in as root.

4 Type the following:

cd /CDROMcp -pr shaderLibrary /usr/aw

To update the Maya.env file or the .cshrc file:

In the user’s maya.env file set the following environment variable (forexample):

setenv MAYA_SHADER_LIBRARY_PATH /usr/aw/shaderLibrary

or

In the user’s .cshrc file set the following environment variable (for example):

setenv MAYA_SHADER_LIBRARY_PATH /usr/aw/shaderLibrary

Note

Alternatively, you can access the Shader Library from the CDROM or copythe shaderLibrary directory to another location in your own homedirectory and set the following variables accordingly.


21


To set up a Shader Library tab in Hypershade:

1 Launch Maya.

2 In Hypershade, select Tabs > Create New Tab to open the Create New Tabwindow.

3 Type Shader Library in the New Tab Name text box.

4 Set the Initial Placement to Bottom.

5 Set the Tab Type to Disk.

6 Click the Root Directory folder button to browse to the path to which youcopied the shaderLibrary directory and click OK.

7 Click Create to see the new tab in the Hypershade panel.

Note

This must be done for each user.


22

3 LICENSING MAYA

This chapter describes how to license Maya. You must install Maya licensesif you are:

• installing Maya for the first time

• upgrading to a higher version of Maya

• adding additional licenses to a floating-type license

• changing the machine on which Maya is installed

LICENSING WORKFLOW

At the end of the software installation, the installKey Licensing Tool windowshould appear displaying the location of the encrypted license in the Inputfile text box. Click Install.

If you’re an existing Alias|Wavefront customer, the required licenses shouldhave been installed for you. A message tells you if the licenses wereinstalled. If they weren’t, but you have Internet access, you can check theREADME_lic file found in the LicenseMaya directory in the top level of theMaya 4.5 Software CD. This readme file contains instructions fordownloading and accessing the most up-to-date encrypted license file fromour Web site.

If you are a new Alias|Wavefront customer, or if you need to obtain newlicenses, you must first send Alias|Wavefront a completed SPAR form. See“Obtaining a license” on page 24. In response to your SPAR form, we sendyou an e-mail, fax, or mail containing the license information. Once youreceive the license, you save the license in a temporary file, then run theAlias|Wavefront license install program to insert the license into thepermanent license file. See “Installing licenses” on page 25.


23

LICENSING MAYA | 3License overview

LICENSE OVERVIEW

You can purchase and install node-locked or floating licenses.

• A node-locked license lets users run the software only on the machine whereyou install the license.

• A floating license lets users run the software on any machine on the samenetwork. For example, if you install five licenses on your network, up to fivemachines or users on the network can run the licensed software at one time.Floating licenses involve a license server machine that serves licenses toclient machines.

Your license is basically a string of text that Alias|Wavefront provides thatresides within a license file. Whenever a Maya session is launched, thelicense management software, FLEXlm, searches the license file to check outa license for that session.

Changes made by licensingThe licensing process adds your new Maya 4.5 license text to the bottom ofthe license file (either /var/flexlm/aw.dat or /var/flexlm/aw_servername.dat, where servername is the name of your machine server).The process leaves all other licenses intact, including licenses for previousversions of Maya.

OBTAINING A LICENSE

To obtain your license, you must send a request to Alias|Wavefront withyour machine information and the products you wish to license. Followthese instructions for each node-locked or license server machine.

To obtain a license:

1 Type the following command to find your computer’s unique identifier:

/usr/aw/COM/bin/getid

The getid command is a utility installed with Maya that returns machineinformation. For example:

Getid number: 87978513790030


24

LICENSING MAYA | 3Installing licenses

2 On any browser (it does not need to be the same machine), access andcomplete the online SPAR (Software Product Authorization Request) format:

www.aliaswavefront.com/spar/

or

Complete the printed SPAR form that comes with your software shipmentand fax it to one of the offices listed on the form.

Alias|Wavefront will process your request and provide you with the licenseby fax, e-mail, or mail as specified.

INSTALLING LICENSES

At the end of the Maya 4.5 software installation, the installKey Licensingwindow appears displaying the location of the encrypted license filedisplayed in the Input file text box. Click Install.

If you’re an existing customer with valid maintenance, the Maya 4.5 licenseshould be installed. A message tells you if the license was installed. If yourlicense was not installed and you have Internet access, you can downloadthe most up-to-date encrypted license file in order to obtain your requiredMaya 4.5 license. Follow the instructions in the README_lic file located inthe LicenseMaya directory at the top level of the Maya 4.5 Software CD.

If your license was not installed and you have obtained your valid Maya 4.5license from Alias|Wavefront, follow these instructions for either node-locked or floating licenses.

For floating licenses, you must complete additional instructions: “InstallingIRIX 6.5 floating license software” on page 27 and “Additional setup forfloating licenses” on page 28.

PrerequisitesBefore you install licenses, make sure you have done the following:

• installed Maya 4.5 software

• obtained your license from an e-mail or fax from Alias|Wavefront


25

LICENSING MAYA | 3Installing licenses

Installing licenses from e-mail, fax, or mailIf you are a new customer, follow these instructions.

For node-locked, perform these steps on each machine running Maya. Forfloating licenses, do these steps on a machine that runs the license serverprocess.

To install the licenses:

1 You should have already obtained a license from Alias|Wavefront. If not,refer to “Obtaining a license” on page 24.

You don’t need to understand the contents of the license to do thisprocedure. For details, see “Understanding licenses” on page 45.

2 Log in as root.

3 Change to the following directory:

cd /usr/aw/COM/bin

4 Type the following command (note the capital K):

./installKey

5 Cut and paste the license you received from Alias|Wavefront into theinstallKey window. If you received the license via fax, carefully type thelicense in; the license won’t work if you have made a typing error.

6 If your organization uses a non-default filename for the license file, click theAdvanced button to specify the path and filename. (Most customers use thedefault filename.)

7 Click Install.

Note

If you store your license file somewhere other than the default location,then you need to point Maya to this in the maya.env file by updating theMAYA_ALT_EN variable. For details, see Using Maya: Essentials.


26

LICENSING MAYA | 3Installing IRIX 6.5 floating license software

The installKey program installs licenses into the default Alias|Wavefrontlicense file. For node-locked licenses, the default file is: /var/flexlm/aw.dat.For floating licenses, the default file is: /var/flexlm/aw_servername.dat,where servername is the machine name of the license server.

The installKey program doesn’t remove prior licenses, but it might commentout license information that is superseded by the new license.

8 Keep a copy of the license information file provided by Alias|Wavefront incase you need to install the licenses again.

9 Either complete the floating license setup instructions or, for node-locked,continue with “Starting Maya” on page 31.

INSTALLING IRIX 6.5 FLOATING LICENSE SOFTWARE

If you are installing floating licenses and the license server machine runsIRIX 6.5.12 or higher, you must first install the software to run the FLEXlmfloating license server. Follow these steps.

To check for FLEXlm license server software:

First check to see if you already have the needed software installed.

1 Type the following at the command line:

versions | grep flexlm_server

2 Look for a return message similar to the following:

I license_eoe.sw.flexlm_server 09/20/2002 FLEXlm 8.1a Server Software

If you see this message, you already have the FLEXlm software and do notneed to install it.

3 If you do not see any message, continue with the following steps.

Note

If you receive an error message, examine the log file /usr/tmp/InstallKey.log.Also see “Troubleshooting licensing problems” on page 35.


27

LICENSING MAYA | 3Additional setup for floating licenses

To install FLEXlm server software:

1 Log into the license server machine as root.

2 Insert the Maya 4.5 Software CD into the drive.

3 At the command line, type swmgr.

4 Enter the path to the CDROM at the top of the Software Manager window,such as /CDROM/dist.

If you have a remote CD-ROM drive, specify its path. For more information,see “Accessing a remote CD-ROM” on page 20.

5 Click the Lookup button.

6 Click Execute (or OK) after reading the installation instructions.

7 When the Software Manager window reappears, click the CustomizeInstallation button.

8 Select Alias|Wavefront Common Utilities, 5.3 and then click the button toexpand the product’s sub-products.

9 Turn on the install check box for A|W Common Base Software, A|WCommon Desktop Software and A|W License Server Software.

10 Ensure the install check box is turned on for License Tools, 3.4.6.

11 Click Start.

12 When the installation is completed, select Exit and click OK.

ADDITIONAL SETUP FOR FLOATING LICENSES

To install floating licenses, you must also start the license server process,then set up each client computer that obtains a floating license from theserver.

To start the license server:

1 Log in as root if you have not done so.

2 Enter this command:

/etc/chkconfig -f aw_flexlm on


28


This ensures that the aw_flexlm script is installed in /etc/init.d. It alsoensures the aw_flexlm script is turned on.

3 Stop then start the lmgrd daemon by entering these commands:

/etc/init.d/aw_flexlm stop

/etc/init.d/aw_flexlm start

4 Log out of root.

Setting up each clientTo set up each client, you must add information to each client computer’saw.dat file. Note that you can run Maya locally on the license servercomputer using its existing aw_servername.dat file, so you don’t need to dothe following steps on the license server machine.

Instructions are provided for both Windows clients and IRIX clients.

To set up an IRIX client:

1 On each client machine, create the following text file with a text editor suchas vi, jot, or nedit:

/var/flexlm/aw.dat

2 Type or copy this line from the license text provided by Alias|Wavefront.For example:

SERVER server 0690c5c73 7111

3 Change the word server to match the name of your server. For example, if theserver name was myserver, it would appear like this:

SERVER myserver 0690c5c73 7111

4 On the second line, type the following:

USE_SERVER

Your file should now look like the following example:

SERVER myserver 0690c5c73 7111USE_SERVER

5 Press Enter to leave a blank line at the end.

6 Save the file and exit the text editor.


29


You’ve now completed the licensing procedure for floating licenses.

To set up a Windows 2000 Professional, or Windows XP Professionalclient:

1 On each client machine, create the following text file with a text editor suchas notepad:

C:FLEXlm\aw_servername.dat

where servername is your server machine name.

2 Type or copy this line from the license text provided by Alias|Wavefront.For example:

SERVER server 690c5c73 7111

3 Change the word server to match the name of your server. For example, if theserver name was myserver, it would appear like this:

SERVER myserver 690c5c73 7111

4 On the second line, type the following:

USE_SERVER

Your file should now look like the following example:

SERVER myserver 690c5c73 7111USE_SERVER

5 Press Enter to leave a blank line at the end.

6 Save the file and exit the text editor.

You’ve now completed the licensing procedure for floating licenses.

Note

You can just copy this aw.dat file to the /var/flexlm directory on the otherclients.

Note

You can just copy this aw_servername.dat file to the C:\FLEXlm directoryon the other clients.


30

LICENSING MAYA | 3Starting Maya

STARTING MAYA

After you install Maya, log out, then log back in. Launch Maya to confirminstallation.

To start Maya:

• In an IRIX shell, type maya

or

• Double-click the Maya icon on the desktop. The Maya icon is in theAlias|Wavefront section of the Icon Catalog. You access it from the Findmenu of the desktop Toolchest.

If Maya does not start, check the Console window for error messages. SeeChapter 4, “Troubleshooting” for possible solutions.

LIMITING USE OF MAYA PRODUCT LICENSES

Some users on your network might not need to use all Maya featuresavailable to them. You can control access to licenses for specific users toensure that those who need them have them on demand. (Maya Cloth has asimilar feature called simulation licenses; see Appendix B, “Cloth Licenses”in Using Maya: Cloth.)

Use a combination of the following MAYA_LICENSE environment variablesettings and user-specified Maya command line options.

Note

You can use an IP Address instead of the name of the server if you plan torun your license across different platforms. For example, a license filenamed aw_myserver.dat on a client machine that’s referencing the IPaddress would look like this:

SERVER 10.0.0.10 690c5c73 7111USE_SERVER


31

LICENSING MAYA | 3Limiting use of Maya product licenses

Example

Suppose your network has several Maya Complete licenses, but only oneMaya Unlimited license. To prevent unwanted users from using the oneMaya Unlimited license, add the following line to the startup file (.cshrc,.profile, or .login) of each unwanted user:

setenv MAYA_LICENSE complete

Sometimes, a user may need to use Maya Unlimited temporarily. Instead ofediting the startup file, you can inform the user to start Maya with thefollowing command, which overrides the startup setting:

maya -lic=unlimited

Other considerations

• If you repeat a command option or MAYA_LICENSE setting, Maya uses thesetting last made.

• A command line option takes precedence over a conflicting environmentvariable setting.

• To see which licenses are checked out, enter the following command from anIRIX shell:

lmstat -a -c /var/flexlm/aw_servername.dat

where servername is the name of the license server.

MAYA_LICENSEsetting

Maya commandoption

Effect on Maya

complete -lic=complete Runs Maya Complete

unlimited -lic=unlimited Runs Maya Unlimited

Note

If Maya license is set to Complete and there are no Complete licensesavailable, even if there are Unlimited licenses, the software will not run,but will display a “No Licenses Available” message.


32

4 TROUBLESHOOTING

This chapter describes troubleshooting for Maya installation and licensing.During installation, the installation program displays error messages inresponse to problems. After installation, if you start Maya and errormessages appear rather than the Maya main window, you probably have alicensing problem.

If you feel you’re not making progress while troubleshooting, contact ourSupport Services department for help.

CONTACTING SUPPORT SERVICES

North America Hours: Monday to Friday, 9:00 am to 8:00 pm ESTSingle Incident Support Service:Toll-free from U.S. and Canada: 800-747-9208Elsewhere in the Americas: 416-874-8881Maintenance Customers:Toll-free from U.S. and Canada: 877-927-7478Elsewhere in the Americas: 416-362-8670Fax: 416-369-6138E-mail: [email protected]

Europe Hours: Monday to Friday, 9:00 CET to 18:30 CET

Single Incident Support Service & Maintenance Customers:Toll-free from Germany: 0800-1827660Toll-free from UK: 0800-7318923Toll-free from France: 0800-902295Toll-free from Italy: 800-780809All others (toll call): +32 9 266 12 34Fax: +32 9 266 12 30E-mail: [email protected]

Asia-Pacific Please contact your local reseller for support service.


33

TROUBLESHOOTING | 4Installation troubleshooting & FAQ

INSTALLATION TROUBLESHOOTING & FAQ

Questions and answersQ Software Manager is not behaving as described in the installation

instructions.

A Software Manager might be customized, as specified by the/var/inst/.swmgrrc file. Try renaming this file (for example, to oldswmgrrc)and restarting Software Manager to be sure it is in default mode.

Q Somehow I messed up the installation. What should I do?

A In Software Manager, enter the /CDROM/dist location in the text field, thenclick the Lookup button. This takes you back to the beginning of theinstallation process.

Q An “Alias|Wavefront Installation Error” window appears. What do I do?

A You may be missing prerequisite IRIX software or patches. Follow thedisplayed instructions before continuing with the installation. The missingcomponents may be SGI software patches. Some patches may be on the IRIXCD-ROM, but the best place to get patches is on the SGI Web site. For a listof qualified patches, refer to our Web site:


Q Software Manager reports a conflict.

A Software conflicts are caused by several different reasons. Click the Conflictbutton and choose from the list of possible solutions.

To help prevent software conflicts:

• Do not click Cancel in the Installation Software Script window.

• Do not click the Default Installation button in the Software Managerwindow.


34

TROUBLESHOOTING | 4Troubleshooting licensing problems

Q Software Manager says I don’t have enough space on /usr even though I’minstalling to a different file system.

A This is a limitation in some versions of the Software Manager. Make surethere is enough room in the file system, then type the following in thecommand line to disable space-checking:

set override_space_check true

Q I get errors when I try to license or use Maya.

A This may be because:

• Common software is not installed.

• license_eoe is not installed.

• Your license file is incorrect or corrupt.

See “Troubleshooting licensing problems” on page 35 for help.

Q How do I remove Maya?

A Always use Software Manager or inst to remove Maya files.

If you are using Software Manager, click Manage Installed Software, selectAlias|Wavefront Maya, then click Start.

If you also installed the Developer’s Tool Kit or other optional software, youmust remove it as well.

Q Can I choose not to install certain components of the Maya Complete orUnlimited package?

A Yes, but you must always install Maya base software. For example, if youhave Maya Unlimited, you can wait to install Maya Cloth, Live, or Fur untilyou need those features.

TROUBLESHOOTING LICENSING PROBLEMS

If the Maya main window doesn’t appear at startup and the following errormessage appears, do the steps under the appropriate headings that follow.

No license suitable to run this version of MayaError setting license default


35


Cannot find any aw.dat (or aw_servername.dat) files in /var/flexlmUnable to locate a license server for Maya

Do the steps in sequence until the problem is solved. If you’ve tried all stepsor you see an error message not listed, write down the exact error messageand call our Support Services department.

No license suitable to run this version of Maya

1 Make sure you restarted the appropriate computer (or computers) after youinstalled Maya.

2 If you tried to run Maya on a client or server, make sure the time and dateon the client and server are correct and synchronized. If the time and date ofthe client differs from the server by more than a half hour, the client mightnot be able to get a license.

3 Review the licensing procedure to make sure you completed all the steps.

4 Do the steps in “Examining a licensing log file” on page 37.

Error setting license default

Do the steps under the heading No license suitable to run this version of Maya.

Cannot find any aw.dat (or aw_servername.dat) files in /var/flexlm

1 Verify that the /var/flexlm directory contains the file aw.dat oraw_servername.dat.

2 If this file doesn’t exist, you probably did not do the steps required in“License overview” on page 24. You’ll need to reinstall licenses.

Unable to locate a license server for Maya

Verify that the USE_SERVER line is below the SERVER line in the clientlicense file. For an example, see “To set up an IRIX client:” on page 29.

or

1 Stop and start the license server software as described in “Stopping andstarting the license server” on page 44.

2 Do the steps in “Checking for floating licensing errors” on page 41.

3 Restart the license server computer.


36


Examining a licensing log fileIf you start Maya and either of the following error messages appears insteadof the main Maya window, you can create and examine a licensing log file tolearn the nature of the error:

No license suitable to run this version of Maya

or

Error setting license default.

For a node-locked license, do the steps on the computer where the messageappears. For a floating license, do the following steps on the license servercomputer.

To examine the license error log file:

1 In a UNIX shell, enter:

setenv FLEXLM_DIAGNOSTICS 2

2 Type maya to repeat the failed attempt to start Maya. The diagnosticinformation will be printed on the screen.

3 The FLEXlm checkout error message always refers to the FEATURE below it.So the format is:

1. FLEXlm checkout error.

2. License file being used.

3. FEATURE line under the question.

4 Find the message in the following topic, “Understanding log file errormessages for IRIX” on page 37 and follow the instructions.

Ignore other information in the file. If the message isn’t listed, call ourSupport Services department.

Understanding log file error messages for IRIXError messages within the file help you identify the problem. The mostcommon error messages are explained below. If multiple errors exist, lookfor the feature name that matches the feature in your license file. Use thehelp in step 3 above to focus on the error. In the following explanations,license file refers to the aw.dat file for node-locked licenses, andaw_servername.dat (on the server) for floating licenses.


37


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 for aspelling error in the password,expiration, or license version.

• If it is a floating license, checkto see if the HOSTID is spelledcorrectly.

• Check the spelling andpunctuation in the ISSUERfield.

• If you obtained an evaluationlicense for Maya, also check thespelling of eval or edu in theVENDOR_STRING.

FLEXLM checkout error: Feature has expired... • Either the current machine dateis later than the expiration dateor there’s a typing mistake inthe expiration date.

FLEXLM checkout error: Invalid date format in license file

• Check the license file’sexpiration date for an incorrectformat, for example, may-4-2001. The correct format is 4-may-2001.

• The password may haveinvalid characters—not allhexadecimal.

• The license count digit may beabsent: uncounted for node-locked, a number greater than0 for floating.

FLEXLM checkout error: Invalid License File syntax.

• Check the entire license file fora typing mistake.


38


FLEXLM checkout error: No such feature exists. • Check the license file’s spellingof components, package, andfeature lines.

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

• Check the license file’s spellingof VENDOR or any part of thestring HOSTID number.

• Check that you typed / insteadof \ at the end of a line.

• Check that the ISSUER isspelled correctly.

FLEXLM checkout error: No SERVER lines in license file.

• For a node-locked license,check that the license file’sLicense Count is uncounted.

FLEXLM checkout error: Maya license in file appears to be corrupted.

• Check the entire license file fora typing mistake.

FLEXLM checkout error: Invalid host. • Check that the machinepossesses the right HOSTIDnumber.Type the following atthe prompt: lmhostid

• Check that the HOSTID iscorrect and make sure it is notmisspelled.

FLEXLM checkout error: No server for this feature.

• sgiawd in DAEMON line maybe incorrectly spelled.

FLEXLM checkout error: License server does not support this feature.

• Check the license file to see ifthe feature has expired, thelicense server has not yetstarted, or the version is higherthan the highest supportedversion.


39


Other licensing diagnostic tools

lmhostidThe lmhostid tool provides the Host ID for the current machine. This shouldcorrespond with the Host ID in the aw.dat or aw_servername.dat file. If theydo not match, make sure that a typing mistake was not made.

To verify hostid information:

1 At any UNIX prompt, type:

FLEXLM checkout error: Cannot connect to license server.

• FLEXlm floating licensesoftware has not been installed(see “Installing IRIX 6.5floating license software” onpage 27).

• An older version of FLEXlmfloating license software isinstalled. Maya 4.5 usesFLEXlm version 7.2.

• Server has not been started.

• SERVER servername has notbeen changed to reflect thename of the server.

• DAEMON is not spelledcorrectly.

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

• Make sure the time and date onthe client and server are correctand synchronized. If the timeand date of the client differsfrom the server by more than ahalf hour, the client might notbe able to get a license.


40


lmhostid

2 Press Return.

The result will be printed to the screen.

lmdiagThe lmdiag tool diagnoses problems when a license checkout fails. You canuse it for node-locked or floating licenses. lmdiag first prints informationabout the license. It then attempts to check out each license. If the checkout issuccessful, lmdiag notifies the user; if not, lmdiag gives the reasons why thecheckout failed.

The format of lmdiag is:

lmdiag -n -c /var/flexlm/LicenseFile FeatureName

lmstat

Checking for floating licensing errors

The lmstat tool reports the status of the license manager daemons andfeature usage. It provides information about the status of the server nodes,vendor daemons, vendor FEATURES and users of each FEATURE. lmstat isonly useful for checking floating license errors. You must run lmstat on thelicense server machine.

To use lmstat:

1 At any UNIX prompt, type the command:

lmstat -a -c /var/flexlm/aw_servername.dat -f FeatureName

-n Runs lmdiag in non-interactive mode.

-c LicenseFile Specifies the license file to diagnose.

FeatureName Specifies which feature to diagnose. If you do notspecify a feature name, lmdiag diagnoses all features inthe file.


41


2 Press Return. The data will be printed to the screen.

When running lmstat, a lengthy list of status information appears. In short,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 thelicense count is correct. Examine the following entries in the statusinformation for troubleshooting in the following steps:

lmstat - Copyright (C) 1989-1997 Globetrotter Software, Inc.

Flexible License Manager status on Thu 5/3/2000 10:51

License server status (License file: /var/flexlm/aw_servername.dat):

servername: license server UP (MASTER)

Vendor daemon status (on servername):

sgiawd: UP

where servername is the name of the server machine.

3 For the line that starts with License server status, make sure that the correctpath to the license file is listed. If it is not the correct path, make sure that thelicense file exists in the /var/flexlm/ directory, and make sure that the name ofthe server machine is correct. If you are unsure of the name, type at theprompt:

/usr/bsd/hostname

and press Return. This should list the name of the machine in use.

4 The next line of status information shows if the license server is UP. If it isnot UP, the error message printed is:

License server status (License file: /var/flexlm/aw_servername.dat):

-a Displays everything. Be prepared for a lot ofinformation if there are a lot of active users.

-c license file This ensures that you are checking the diagnostics forthe correct license file.

-f FeatureName This confines the inquiries to a particular feature orfeatures.


42


servername: Cannot connect to license server (-15,12:146) Connection refused

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

5 Confirm that the license server is up. See “Starting Maya” on page 31 formore information.

6 Make sure that all server starts have a corresponding server stop. Youcannot continually restart the server without stopping any of the previousserver starts. If you have been continually restarting the server, this willcause a problem. If this is the case, do the following:

7 As root, type the following at the UNIX prompt:


Press Return.


Press Return.

killall lmgrd

Press Return.

/usr/etc/lmgrd -c /var/flexlm/aw_servername.dat

Press Return.

/usr/tmp/aw_flexlm.log

Press Return. Then type:

ps -aef | grep lmgrd

to confirm daemon is now running.

Below the status information is a list of features in the aw_servername.datfile and information explaining whether the clients can use the features. Anexample follows:

Feature usage info:

Users of MayaUnltdf: (Total of 3 licenses available)

This example indicates that three floating Maya Unlimited licenses areavailable.


43

TROUBLESHOOTING | 4Stopping and starting the license server

If the aw_servername.dat file has a typing error, you’ll see something similarto this example:

Users of MayaUnltdf: (Error: 3 licenses, unsupported by licensed server)

Check aw_servername.dat for a typing error.

8 If doing the preceding procedure doesn’t fix the problem, call our SupportServices department and keep the information from the preceding stepshandy.

STOPPING AND STARTING THE LICENSE SERVER

To stop and start the license server:

1 Log on as root. First check that you have the aw_flexlm script installed in the/etc/init.d/ directory. It also checks whether the script is turned on:

/etc/chkconfig -f aw_flexlm on

2 Stop the lmgrd daemon by entering the following command:


If the server was ON previously, the command issues some statusinformation. An example of this status information is:

lmdown - Copyright (C) 1989-1997 Globetrotter Software, Inc.Shut down FLEXlm server on node servername 1 FLEXlm License Server shut down

where servername is the name of the server machine.

or

If the server is already OFF, the command will issue an error messagesimilar to:

lmdown - Copyright (C) 1989-1997 Globetrotter Software, Inc.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 thiserror message.


44

TROUBLESHOOTING | 4Understanding licenses

3 Start the server by entering the following command:


If the server starts successfully, the status message should look similar tothis:

License file = /var/flexlm/aw_servername.dat

FLEXlm Licensing daemon for Alias|Wavefront software: /usr/etc/lmgrd

UNDERSTANDING LICENSES

This section explains the contents of the license Alias|Wavefront sends you.

Node-locked licensesIf you order node-locked licenses, you receive one license for every machine.The contents of the e-mail, fax, or mail depends on the Maya package youorder. The following figure shows the main elements of a node-lockedlicense:

Feature Name—is the Maya product package you purchased.

License Version—shows the version number of the Maya package.

Tip

If you see a line near the top of your license that starts with SERVER,you’re installing floating licenses. Otherwise, you’re installing node-lockedlicenses.

FeatureName

LicensePassword

Host IDVendor String

FEATURE MayaUnltd sgiawd 4.500 permanent uncounted 1234567890ab\VENDOR_STRING=xxx HOSTID=690c5c73

ExpirationLicense


45

TROUBLESHOOTING | 4Understanding licenses

Expiration—shows when the license expires. The word “permanent” meansthere is no expiration date. Product evaluation licenses have actualexpiration dates.

License Count—node-locked licenses do not have a license count.

Password—is an encryption string that prevents copyright infringement.

Vendor String—indicates you have a timed-out, evaluation, or educationallicense. If not present, it means that you have a purchased, permanentlicense.

Host ID—is the hostid of the machine to be licensed.

Floating licensesIf you order floating licenses, you receive a single license for the licenseserver computer. The contents of the e-mail, fax, or mail you receivedepends on the Maya features you order.

The following figure lists the main elements of the floating license:

Server—is a placeholder where you must insert your actual server name.

Server Host ID—is the server’s lmhostid. See “lmhostid” on page 40.

Port Number—is a fixed number that represents the TCP port usedinternally by the licensing software.

Feature Name—is the Maya product package you purchased.

License Version—shows the version number of the software.

Server

License CountExpiration PasswordLicenseVersion

Host IDYour servername here

SERVER server 6909ABCD 7111VENDOR sgiawd /usr/aw/COM/etc/sgiawdFEATURE MayaUnltdf sgiawd 4.500 25-oct-2002 1 1234567890ab\

SUPERSEDE="MayaCompletef MayaBldf MayaUnltdf MayaAdvMf" \ISSUED=6-jun-2000

Feature Name

PortNumber


46

TROUBLESHOOTING | 4Additional resources

Expiration—shows when the license expires. The word “permanent” meansthere is no expiration date. Product evaluation licenses have actualexpiration dates.

License Count—is the number of floating licenses you ordered.

Password—is an encryption string that prevents copyright infringement.

ADDITIONAL RESOURCES

• www.aliaswavefront.com provides information on various Alias|Wavefrontand Maya issues.

• www.globetrotter.com provides information on licensing.


47

TROUBLESHOOTING | 4Additional resources


48

AN

IMA

TIO

N

INDEX
Bbatch renderer
minimum to install 12, 14batch script for installation 17

CCD-ROM

mounting 18used to install 5

client machineintroduction 24

client/serverbatch script installation 18installation 16

clientssetting up 29

customize installation 12, 14

Ddisk space

file system and 15requirements 8

Eenvironment variables 6error messages

log file 37upon starting Maya 35

Ffile system other than usr 15

FLEXlmdefined 24

floating licensesadditional setup 28defined 24understanding 46

Hhardware requirements 8Hypershade

Shader Library tab 22

Iinst utility

interactive installation 13without prompts 15

installationclient/server 16file system other than usr 15inst (interactive) 13licenses 25many machines at once 17prerequisite steps 9requirements 8troubleshoot 34

Installation Error window 34installKey 26

Llicense server

introduction 24minimum to install 12, 14startup 28

licenseserror log file 37floating example 46floating setup 28installation changes 24installation workflow 23installing 25limiting product licenses 31node-locked example 45overview 24prerequisites 25troubleshoot 35

log file for licensing errors 37

MMaya startup 31Maya.env file 6mounting the CD-ROM 18

NNetscape requirement 9NFS mount 19node-locked licenses

defined 24understanding 45

Ooperating system

requirements 8

Pprerequisite steps

to installation 9


49

INDEX

Rremove Maya 35requirements 8

SShader Library

installing 20Software Manager

conflict 34trouble with 34

SPAR form 25startup

license server 28Maya 31Maya error messages 35

step option 14Support, contacting 33

Ttroubleshooting

installation 34licensing 35Software Manager 34

Uuninstall 35usr file system 15

Vversions

previous 24previous kept 7


50

installing maya 4.5 for irix - unicampmartino/maya/pdf/reference... · 2004. 4. 20. · installing...

Documents