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:
# Feature name : 3Delight # Host ID : e08122074c # Licenses : 2 (Unlimited threads per machine) # Expiration : none # Service Exp. : Wed Aug 30 00:00:00 2014
|
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:
3Delight | |
---|---|
Windows | C:\Program Files\3Delight\ |
Mac OS X | /Applications/3Delight |
Linux | /usr/local/3Delight-11.0.0 |
3Delight for Maya | |
---|---|
Windows | C:\Program Files\3DelightForMaya\ |
Mac OS X | /Applications/3DelightForMaya |
Linux | /usr/local/3DelightForMaya-11.0.0
|
If you have licenses for more than one product, you can simply concatenate the license keys into the same file.
Starting the License Server - licserver
One license server can serve licenses for all platforms, there is no distinction between a license for Windows and a license for Linux. Important: only one license server can be started on a given network; starting multiple license servers will not work.
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 "
← for 3Delight for Maya installation%ProgramFiles%
\3Delight For Maya\
license.dat"
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
-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 "
← for 3Delight for Maya installation%ProgramFiles%
\3Delight For Maya\
license.dat"
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