In order for your version of Turtle to work you will have to install a license file. This license file is sent to you by an e-mail from Illuminate Labs.

If you do not have recieved a license, please contact Illuminate Labs.

Save this e-mail attachment to your computer. Depending on your platform, continue with one of the following installation walk-throughs

Windows

1. Start the Turtle License Installer, located in the Start menu under the Turtle group.

Depending on your license type, choose one of "Node-locked" and "Floating License".

A "Node-locked" version of Turtle is licensed to one specific computer.

A "Floating License" version of Turtle is licensed to a specific number of computers, and every license is issued from a license server on your network.

2a. If you have a node-locked version, choose this alternative. On the next screen, specify where you saved the license file you got by mail, and then where you which to have this installed. The default location is "C:\illm".

2b. If you have a floating license, choose this alternative. On the next screen specify the ip-number or URL of the license server and which port the license server is configured on. If you do not know these values, contact the systems administrator that installed the license server.

3. Click install.

4. If you had Maya running, restart it in order for Turtle to find the license file.

When you load Turtle in Maya, look in the Maya "Output Window" to see information regarding the license and licensee.

Linux

1. Node-locked license installation:

The default path for the license file is /var/illm/il.dat. If the license is found there no environment variables are needed. If another location is preferred the environment variable IL_LICENSE_FILE tells the License manager where the license is found.

2. License server installation:

If a license server is used it can be specified by the environment variable IL_LICENSE_SERVER. The format of the variable is host:port, so if the license server is running on 192.168.0.1 and the port is 5555 then the environment variable IL_LICENSE_SERVER should be set to '192.168.0.1:5555'.

MacOS X

In order to install Turtle on MacOSX, you need administrator access.

1. Node-locked license installation:

The default location for the license file on OSX is: /var/illm/il.dat if you know how to copy it to this location and name, it's the easiest solution, however it requires administrator access and knowledge about hidden directories.

The other way is to set an environment variable to point to your license file. Let's say you put it in illm in your home folder. Now open the Terminal (available in Applications/Utilities).

In the terminal type:

open .MacOSX/environment.plist

It will pop up the property list editor add (or edit if it's available from a previous version) the value IL_LICENSE_FILE and set it to point to where you put it.

Save the file and log in/out for the changes to take effect.

2. Server installation:

a. Open the file ~/.MacOSX/environment.plist

b. Add a new key pair to the dictionary, with name IL_LICENSE_SERVER and the value set to the IP of the server, followed by a ":" and the port of the server.

Example:

<dict>
<key>someKey</key>
<string>someValue</string>
...
...
<key>IL_LICENSE_SERVER</key>
<string>192.168.0.161:5555</string>
</dict>

c. Save the file and log in/out for the changes to take effect.

d. To verify that your changes has taken effect, type:

(bash) : set | grep IL_LICENSE_SERVER

or

(tcsh) : setenv | grep IL_LICENSE_SERVER 

These command should return the name and port of the server, like

> 192.168.0.161:5555