License Server Guide

Overview of How 3Delight Licensing Works

3Delight^NSI licensing is controlled through a separate proprietary program called licserver. It can run on the same machine where 3Delight is to be used, or on another machine on the same network. The license server provides floating licenses: it will allow 3Delight to be used on any machine on a given network.

The licserver is included with 3Delight^NSI — it is not included with the Free 3Delight^NSI since no license key is needed in that case.

Obtaining a Licene Key

To obtain a license key for the license(s) you have purchased, you must first determine on which machine the license server will run and find its "Host ID". The Host ID is a unique identifier to each machine and is used by the licensing software to correctly identify the system on which it runs. We only need to receive the Host ID of a single machine on your network (even if you have purchased multiple licenses).

Once 3Delight^NSI is installed, you can get the Host ID by following these steps:

1. Open a shell (Linux and Mac OS X) or a command prompt (Windows). 

2. Execute the following command:

   licutils hostid 
   
   

This will print a unique hexadecimal identifier of the current machine and this is your Host ID. You will have to email it to sales@3delight.com to receive your license key. You have to execute this command on the computer you intend to use to run the license server. 

Installing the License Key

The license key is sent by e-mail in the form of an hexadecimal string. A license key looks like this:

^{In this example,  lines starting with  #  are not necessary for the license to work, they are in the file only as a 
reminder of the features of the license. You can add your own  #  lines.}

Save these lines into a file named ‘license.dat’. If you are using a text editor such as Word or TextEdit make sure to select ’Plain Text’ when saving the file. Saving the file in 'Rich Text' will not work. Put the license.dat file into the root directory of your 3Delight installation. The default installation root directory for the application is the following:

If you have licenses for more than one product, you can simply concatenate the license keys into the same file.

# Feature name : 3DFM
# Host ID      : e08122074c
# Licenses     : 1 (Unlimited threads per machine)
# Expiration   : none
# Service Exp. : Wed Aug 30 00:00:00 2009

3DFM 32 ba 93 f6 7f 77 e0 bc 1f 15 07 b0 fc 2d 1c dc 0e ec d7 a9 1a 7d b9 3b 
 
# Feature name : 3Delight
# Host ID      : e08122074c
# Licenses     : 2 (Unlimited threads per machine)
# Expiration   : none
# Service Exp. : Wed Aug 30 00:00:00 2009

3Delight 2d 1c dc 0e ec d7 a9 1a 7d b9 3b 32 ba 93 f6 7f 77 e0 bc 1f 15 07 b0 fc

On Windows systems, it is possible to launch the license server through the Start > All Programs > 3Delight menu (provided the license.dat file was installed properly). It is also possible to start it in a command window by typing the following command line (select the one corresponding to which package you are installing):

C:\> licserver "%ProgramFiles%\3Delight\license.dat"           ← for 3Delight Studio Pro installation

C:\> licserver "%ProgramFiles%\3Delight For Maya\license.dat"  ← for 3Delight for Maya installation

On Mac OS X and Linux systems, the license server must be started manually in a terminal/shell (select the command line corresponding to which package you are installing):

% licserver /Applications/3Delight/license.dat             ← for 3Delight Studio Pro installation

% licserver /Applications/3DelightForMaya/license.dat      ← for 3Delight for Maya installation
 
Here the ‘-d’ options can be added to launch the license server in “daemon” mode. It allows closing the terminal but prevents seeing the messages from the server.

The License Server as a System Service 

On Windows, the license server can be installed as a service for automatic startup with the system. With administrative privileges, it’s as simple as:

C:\> licserver -installservice "%ProgramFiles%\3Delight\license.dat"           ← for 3Delight Studio Pro installation

C:\> licserver -installservice "%ProgramFiles%\3Delight For Maya\license.dat"  ← for 3Delight for Maya installation

Removing the service is equally simple:

C:\> licserver -removeservice

It’s a good idea to check that the setup works by running the license server in the foreground before installing it as a service as the service will not give detailed error messages.

The License Server as a OS X Launch Agent 

On OS X, the license server can be started automatically when a specific user logs in, or when the system is started. The later is generally preferable, since the license server will be available regardless of who is logged on the computer (and when no user is logged in too). The procedure to launch the license server upon system startup requires administrative privileges.

• Make sure that the license file name and placement are exactly as described in Activating a License Key#Installing the License Key.
• Download and decompress this file for a 3Delight Studio Pro installation, or this file for a 3Delight for Maya installation. The resulting file is named com.3delight.licserver.plist
• Remove the quarantine attribute for downloaded files with the following terminal command:

% xattr -d com.apple.quarantine ~/Downloads/com.3delight.licserver.plist

• Move the file to the correct destination directory with the following terminal command:

% mv ~/Downloads/com.3delight.licserver.plist ~/Library/LaunchAgents/       ← to launch the licence server when the current user logs in

% sudo mv ~/Downloads/com.3delight.licserver.plist /Library/LaunchDaemons/  ← to launch the license server when the system is started.

• If the license server will be launched upon system startup, adjust the file permissions with the following terminal command:

% sudo chown root:wheel /Library/LaunchDaemons/com.3delight.licserver.plist

Modifying the Configuration File 

If you are running the software in a networked environment, it is necessary to indicate to 3Delight where the license server is running. This is done by modifying the configuration file. The file is named ‘rendermn.ini’ and is located in the root of the installation. Adding the following line is enough to indicate where the license server is located:

/3delight/licserver servername 

Here, 'servername' is the name of the machine for which you provided the hostid. A network name or an IP address is accepted. Note that this is not the “hostid”. If you are unsure about the name of the license server, log on to the machine and issue the following command in a command prompt: 

C:\> licutils hostname

Additional Notes