This appendix covers all of the installation and licensing instructions.

System Requirements

A Silicon Graphics workstation.

IRIX OS version 5.3 or later.

35 Mb of disk space.

SoftImage Extreme 3.5 or later.

A CD-ROM drive for installation.

Notes on Licensing

LumeTools uses a floating license policy for its licenses. This means that licenses are able to "float" around your network, to be used where they are needed, when they are needed. Once you stop using a license on one computer, it is free to move on to another computer.

For example, if your site consists of twenty computers and you only want to use LumeTools on two of them at a time, then you only need to have two licenses.

LumeTools has two types of licenses: "Main" and "Thread." For a computer to render with LumeTools, it requires a Main license. Furthermore, if that computer has more than one CPU, it requires one Thread license for each additional CPU.

For example, suppose your site consists of three workstations and a 12-CPU server. If you wanted to render on all the computers at the same time, you'd need four Main licenses (one for each workstation and one for the server) and eleven Thread licenses, for the remaining CPU's on the server.

LumeTools uses FlexLM for its license control, just like SoftImage and mental ray. If you've successfully installed FlexLM licenses before, you should have no trouble now.

Installing the Software

1. Log on as the super-user (root).

2. Place the LumeTools CD into your CD-ROM drive, and wait for it to mount.

3. Type:

cd /usr


Link the Shader Database

1. Still as the super-user, type:

jot /usr/softimage/3D/rsrc/DatabaseSys.rsrc

2. Scroll down, and at the very bottom of the file add these three lines:


PATH /usr/lume/tools/LumeTools


3. Save the file.

Acquiring License Codes

1. Locate your Existing SoftImage license file. Unless you've moved your license file, it should be stored at:


2. Notice that at the beginning of this file, one or more lines begin with the word "SERVER". These lines contain the names and system-IDs for all of your license servers. Make a note of them.

3. Fill out the following form and deliver it to 4DVision, via email at or fax at 303-843-9885

LumeTools License Request

Name of license server one: _________________

System-ID of license server one: _________________

Name of license server two: _________________ (optional)

System-ID of license server two: _________________ (optional)

Name of license server three: _________________ (optional)

System-ID of license server three: _________________ (optional)

Name of primary contact _________________

Email address: _________________

Fax number: _________________

Number of LumeTools Main

Licenses Requested: _________________

Number of LumeTools Thread

Licenses Requested: _________________

4. You should receive a reply containing your license codes shortly.

Install the License Codes

1. Have your newly received license codes on hand.

2. Log on to your site's license server as the super-user (root).

3. Locate your existing SoftImage license file.

4. Edit the license file:

jot /usr/local/flexlm/licenses/softimage.dat

4. Scroll to the bottom of the file and insert all of the lines that came with your license codes. For example, the lines may look like:

DAEMON LUME /usr/lume/flexlm/lmlume

FEATURE LUMETOOLS LUME 1.0 1-jan-00 1 12345678901234567890 ""

5. Tell FlexLM to read the changes we've just made:


6. You're done.


Once the installation is complete, you should find the following files installed on your disk:

LumeTools: a SoftImage database containing the LumeTools shader collection.

LumeTutorials: a SoftImage database containing example scenes for use with the LumeTools tutorials.

Examples: a SoftImage database of simple example scenes used in the creation of this manual.

flexlm: programs and files used in the licensing of LumeTools.

Manual: an online version of this manual, viewable with your favorite web browser.