Chapter 2: Installation

This chapter describes the hardware and operating systems on which the RAYZ software operates and provides instructions for installing and keying RAYZ on your system. To install RAYZ, you will need to

You can install a copy of the RAYZ application on as many machines as you like, but you should only install the license manager once, on one machine, which will serve licenses for all machines running RAYZ.

Note:

 

Be sure to read INSTALL.doc and any other readme documents included with the installation files for the most current information.

For network installations --to use tar to install RAYZ on a remote application server or perform other custom installations--refer to the document CUSTOM_INSTALL.doc, which is distributed with the software.

In This Chapter

System Requirements

IRIX Installation

Linux Installation (Intel and Alpha)

Windows Installation (NT/2000)

Other Setup Options

System Requirements

The following requirements and recommendations apply to all systems:

Memory: RAYZ 2.0 requires a minimum of 64MB of RAM, although 128MB or more is recommended.

Disk Space: The RAYZ application files take up approximately 40MB of hard disk space. In addition, hundreds of additional megabytes of temporary disk space could be required while the application is running. See RAYZ_TMPDIR for information about specifying the directory RAYZ should use for caching temporary files.

Graphics: A 24-bit or 32-bit color graphics accelerator is required, with a recommended resolution of 1280 x 1024 or higher. (See also See Recommended Graphics Cards below.)

Display: A large (19- or 21-inch) monitor is recommended. To take advantage of dual monitors, see RAYZ_SPLIT_SCREEN.

Recommended Graphics Cards

Some recommended cards for Linux or Windows systems include nVidia GeForce-based cards (with nVidia hardware-accelerated drivers if you are running Linux) and Matrox G400 or G450 cards.

RAYZ does not require OpenGL-capable graphics cards.

Operating Systems

RAYZ will run on IRIX, Intel and Alpha Linux, and Intel Windows configurations that meet the criteria described in the following paragraphs for each system. RAYZ runs on single or multiple processors.

IRIX

RAYZ will run on any Silicon Graphics workstation with at least an R4000 CPU running the IRIX 6.X operating system.

In addition, a 64-bit version of RAYZ can be installed to take advantage of the increased memory addressing available on machines with an R8000 or faster processor that are running the 64-bit version of IRIX 6.5 (or higher).

Linux

RAYZ will run on Red Hat 6.2 (or higher) or Debian 2.2 (or higher) distributions of the Linux operating system on workstations with Intel Pentium Pro (or faster) or Alpha processors.

Other distributions of Linux with a glibc version 2.1 or later should work also, but they have not been tested by Silicon Grail and we cannot vouch for them.

Windows

RAYZ will run on Microsoft Windows NT, Windows 2000, and Windows 98 operating systems on workstations with an Intel Pentium Pro (or faster) processor.

IRIX Installation

There are two versions of RAYZ available for IRIX: 32-bit and 64-bit. The 64-bit version of RAYZ is designed to take advantage of the increased memory that can be addressed on 64-bit IRIX systems. (A 32-bit processor can only address about 2GB, which means that you can run out of memory--even virtual memory--when doing large comps.)

An IRIX system is not considered 64-bit unless it has the 64-bit version of the IRIX 6.5 (or newer) operating system and an R8000 or faster processor.

The "regular" 32-bit version of RAYZ must be installed on all SGIs that are not 64-bit; the 32-bit or 64-bit version of RAYZ can be installed on 64-bit machines.

Check 64-Bit Status

The following instructions should be used to determine whether your machine is 64-bit. If you already know which version of RAYZ you are going to install, however, you can skip to the installation instructions.

  1. Log in to your machine and type uname at the prompt. The system will return either "IRIX" or "IRIX64."
  2. If the system returns "IRIX," skip steps 3 and 4 and install the 32-bit version. If the system returns "IRIX64," follow step 3.
  3. Type hinv at the prompt to get a hardware inventory for the machine.
  4. If the machine has an R8000 or faster processor, you can install either the 64-bit or 32-bit version; if not, you must install the 32-bit version.

Install the Application

If installing the software from the RAYZ distribution CD, insert the CD into your local CD-ROM drive. If you have downloaded the software from the Silicon Grail website, copy the tar file to /tmp.

  1. Log in as root.
  2. Type the following commands:
  3. mkdir /usr/grail
    cd /usr/grail
    gzcat /tmp/rayz.irix.tar.gz | tar xvf -
    cd rayz2.0
    ./Install

Install the License Manager

Be sure to install the license manager only once, on the machine that will serve licenses for all computers running RAYZ.

  1. Log in as root to the machine that will be used as the license server.
  2. If the directory /usr/lib/grail exists, remove it and its contents.
  3. If the file /etc/init.d/grail exists, remove it.
  4. Type the following commands:
  5. cd /usr/lib
    tar xvf license_manager.irix.tar
    cd grail
    ./Install

Key the Software

Follow these steps to get a key from Silicon Grail.

  1. Type the following command to generate a host (license server) code:
  2. /usr/lib/grail/hostinfo

  3. Contact Silicon Grail support and give us the resulting host code string, along with name of the license server machine. The string will take this form: AA-BB-CC-DD-EE-FF-2.0. You can reach us via
  4. phone: (323) 871-9100
    fax: (323) 871-9199
    email: key@sgrail.com

    We will email a file to you called "license.lic."

  5. Place the license.lic file in the following directory:
  6. /usr/lib/grail

    You can name the file anything you like, as long as it ends in the ".lic" extension. Multiple .lic files can be placed in this directory; all of them will be searched for a valid license.

  7. Type the following command to force the license server to check for license files:
  8. /usr/lib/grail/grailadmin -r localhost

RAYZ should now be ready to run. To verify the procedure, log in as a user and type rayz from your home directory to launch the application.

Linux Installation (Intel and Alpha)

If installing the software from the RAYZ distribution CD, insert the CD into your local CD-ROM drive. If you have downloaded the software from the Silicon Grail website, copy the file to /tmp.

Install the Application

  1. Log in as root.
  2. Type the following command, for either Intel or Alpha, to unpack and install the RAYZ application.
  3. INTEL:

    rpm -U rayz.linux.intel.rpm

    ALPHA:

    rpm.-U rayz.linux.alpha.rpm

Install the License Manager

Be sure to install the license manager only once, on the machine that will serve licenses for all computers running RAYZ.

  1. Log in as root to the machine that will be used as the license server.
  2. If the directory /usr/lib/grail exists, remove it and its contents.
  3. If the file /etc/init.d/grail exists, remove it.
  4. Type the following commands, for either Intel or Alpha.
  5. INTEL:

    cd /usr/lib
    tar xvf license_manager.linux.intel.tar
    cd grail
    ./Install

    ALPHA:

    cd /usr/lib
    tar xvf license_manager.linux.alpha.tar
    cd grail
    ./Install

Key the Software

Follow these steps to get a key from Silicon Grail.

  1. Type the following command to generate a host (license server) code:
  2. /usr/lib/grail/hostinfo

  3. Contact Silicon Grail support and give us the resulting host code string, along with name of the license server machine. The string will take this form: AA-BB-CC-DD-EE-FF-2.0. You can reach us via
  4. phone: (323) 871-9100
    fax: (323) 871-9199
    email: key@sgrail.com

    We will email a file to you called "license.lic."

  5. Place the license.lic file in the following directory:
  6. /usr/lib/grail

    You can name the file anything you like, as long as it ends in the ".lic" extension. Multiple .lic files can be placed in this directory; all of them will be searched for a valid license.

  7. Type the following command to force the license server to check for license files:
  8. /usr/lib/grail/grailadmin -r localhost

RAYZ should now be ready to run. To verify the procedure, log in as a user and type rayz from your home directory to launch the application.

Windows Installation (NT/2000)

Locate the executable files for the application (rayz.nt.exe) and the license manager (license_manager.windows.exe), either on the RAYZ distribution CD or in the folder to which you downloaded them from the Silicon Grail website. Then follow these instructions to install and key RAYZ.

Install the Software

  1. Log in as Administrator or a user with administrator privileges.
  2. Double-click on "rayz.nt.exe" to launch the installation program.

Key the Software

Follow these steps to get a key from Silicon Grail.

  1. Double-click on the file "license_manager.windows.exe" to launch the license manager.
  2. Answer "Yes" to the question about obtaining the host code. The host code will be displayed as a string with the form AA-BB-CC-DD-EE-FF-2.0.
  3. Write down the host code string, being sure to double-check it for accuracy.
  4. Contact Silicon Grail support and give us the host code string you recorded in the previous step, along with name of the license server machine. You can reach us via
  5. phone: (323) 871-9100
    fax: (323) 871-9199
    email: key@sgrail.com

    We will email a file to you called "license.lic."

  6. Place the license.lic file in the following folder:
  7. C:\Program Files\Silicon Grail\Grail LM\Keys

    You can name the file anything you like, as long as it ends in the ".lic" extension. Multiple .lic files can be placed in this folder; all of them will be searched for a valid license.

  8. In the Start menu, run the program Silicon Grail > License Manager > Refresh License Server.

RAYZ should now be ready to run. To verify the procedure, log in as a user and double-click the RAYZ application icon to launch the program.

Other Setup Options

This section covers two RAYZ environment variables. Be sure to review Chapter 13: Setting Preferences, however, for more information about setting up your work environment. In particular, a number of environment variables are described in the section on File Paths in chapter 13, including paths to RAYZ layout, preset, plugin, and custom node files, as well as the paths to search for the help browser used by the online manual and fonts used by the Text node.

The first environment variable described here, RAYZ_SPLIT_SCREEN, lets you set up RAYZ to take advantage of dual monitors. It can only be set from the command line (or Properties panel, in the case of Windows).

The other environment variable, RAYZ_TMPDIR, can also be set in the RAYZ Preferences panel, but it is included here because it you will probably want to set as soon as you install RAYZ, if at all.

Setting Environment Variables

To set an environment variable from the command line on IRIX and Linux systems, type setenv followed by the variable name and argument.

On Windows NT , right-click on the My Computer icon and select Properties from the menu. In the Properties panel, select the Environment tab and type the name of the variable in the variable field and the argument in the value field.

RAYZ_SPLIT_SCREEN

To take advantage of a workstation that incorporates two (or more) display devices, set the RAYZ_SPLIT_SCREEN environment variable to the number of monitors in your system.

For example, on a Linux box with two display devices, type "2" as the argument:

setenv RAYZ_SPLIT_SCREEN 2

RAYZ_TMPDIR

RAYZ may require a substantial amount of temporary disk space while running in order to cache image data in temporary files and directories. Each frame of film at 2K resolution, for example, may require 2 to 8 MB, depending on the file format.

RAYZ_TMPDIR tells Rayz where to store temporary files and directories. By default, RAYZ will put temp files in /usr/tmp.

We suggest you set RAYZ_TMPDIR to a file system path that has a substantial amount of disk space available. (You may want to consult with your system administrator for the best way of handling this issue.)

To set this variable on an IRIX machine, for example, type the following, replacing "[pathname]" with the actual file path to use:

setenv RAYZ_TMPDIR /[pathname]