Installing the License Server on Linux

Download the appropriate installer based upon your system's current gcc/glibc configuration.

To install the license server to the default location, in a root shell, navigate (cd) to the directory where the rpm file was downloaded to and type, for example:

> rpm -i PixarLicense-LA-11.0-linuxRHEL5_gcc41icc111.x86_64.rpm

Note that there are different rpm packages for each flavor of Linux that is supported.

To install the packages to a different location, the /opt prefix of the default path can be replaced. For example, to install to /usr/local/pixar/PixarLicense-LA-11.0, from a root shell type:

> rpm -i --prefix /usr/local PixarLicense-LA-11.0-linuxRHEL5_gcc41icc111.x86_64.rpm

The installation includes the following components and scripts:

• PixarLicenseServer
• LicenseApp/
• pxmlshared.tcl
• queryAvailablePRMan.tcl
• queryPRMan.py
• queryUsersPRMan.tcl
• startPixarLicenseServer.sh
• stopPixarLicenseServer.tcl
• visualizeLicenseSharing.py

Near the end of the installation the licensing application, LicenseApp, will be invoked. It will ask you for an "Entitlement Serial Number" and your Support Forum login and password. Enter the information in the appropriate fields (if you use a proxy server, your proxy information should be added as host:port, e.g. foo.mydomain.com:8080 in the Advanced section) and click on the Get License button.

The application will contact Pixar's servers and download your license to the License Server directory. Once that is finished, quit LicenseApp and the license server installer will run to completion.

After installing your license, you will need to start a license server daemon on the license server host. The license server daemon can be manually started on a host by using the shell script /opt/pixarPixarLicense-LA-11.0/startPixarLicenseServer.sh and stopped with /opt/pixar/PixarLicense-LA-11.0/stopPixarLicenseServer.tcl. The script may be invoked interactively by any user or from the system startup. The license manager needs no special privileges to run.

In order to have the license server be started automatically, you may want to install an rc.d script. For example:

#!/bin/sh
#
#
# description: start/stop control for Pixar License Server
# processname: PixarLicenseServer
# source function library.
. /etc/rc.d/init.d/functions

LICENSE_DIR=/opt/pixar/PixarLicense-LA-11.0
LICENSE_FILE="$LICENSE_DIR/pixar.license"
SU="/bin/su nobody -c"

case "$1" in
  start)
    echo "Starting Pixar License Server Daemon for RenderMan software"
      if [ -x "$LICENSE_DIR/PixarLicenseServer" ]; then
        if [ -f "$LICENSE_FILE" ] ; then
          cd "$LICENSE_DIR"
          $SU startPixarLicenseServer.sh
          echo
        else
          echo "ERROR Cannot run Pixar Licensing daemon: PixarLicenseServer"
          echo "$LICENSE_FILE does not exist."
        fi
      else
        echo "ERROR Cannot run Pixar Licensing daemon: PixarLicenseServer"
        echo "$LICENSE_DIR/PixarLicenseServer does not exist or is not executable"
      fi
      ;;
    stop)
      echo "Shutting Down Pixar License Server Daemon for RenderMan software"
      cd "$LICENSE_DIR" /usr/bin/tclsh stopPixarLicenseServer.tcl
      echo
      ;;
    *)
      echo "Usage: pixarlicenseserver {start|stop}"
      exit 1
    esac

    exit 0

Installing the License Server on Windows

Double-click on the appropriate .msi file to invoke the installer, e.g. Pixar_License-LA_[version]_Win32.vc8-SSE2.msi. This must be done on the machine that you intend to use as your license server. The installer will take you through the installation process, step-by-step.

By default, the license server is installed in C:\Program Files\Pixar\PixarLicense-LA-[version] and contains the following components and scripts:

* PixarLicenseServer.exe
* LicenseApp/
* pxmlshared.tcl
* queryAvailablePRMan.tcl
* queryPRMan.py
* queryUsersPRMan.tcl
* startPixarLicenseServer.sh
* stopPixarLicenseServer.tcl
* visualizeLicenseSharing.py

Near the end of the installation the licensing application, LicenseApp.exe, will be invoked. It will ask you for an "Entitlement Serial Number" and your Support Forum login and password. Enter the information in the appropriate fields (if you use a proxy server, your proxy information should be added as host:port, e.g. foo.mydomain.com:8080 in the Advanced sction) and click on the Get License button.

The application will contact Pixar's servers and download your license to the License Server directory. Once that is finished, quit LicenseApp and the license server installer will run to completion.

Eventually, you will need to start the license server. This can be done via the Windows Services panel (Start-> Control Panel-> Administrative Tools->Services), or you can run the executable via the Command Prompt (the -help option will give you a rundown of the optional flags for running the license server, including -v:X for debug output and -log filename for logging).

Installing the License Server on Macintosh OS X

1. Download and unzip the appropriate .tgz file.
2. Double-click on the .pkg to start the installer. The installer will take you through the installation process step by step.

3. The license server is installed, by default, in /Applications/Pixar/PixarLicense-LA-<version> and contains the following components and scripts:
   • PixarLicenseServer
   • LicenseApp/
   • pxmlshared.tcl
   • queryAvailablePRMan.tcl
   • queryPRMan.py
   • queryUsersPRMan.tcl
   • startPixarLicenseServer.sh
   • stopPixarLicenseServer.tcl
   • visualizeLicenseSharing.py
   • legal.txt

4. Near the end of the installation the licensing application, LicenseApp, will be invoked. It will ask you for an "Entitlement Serial Number" and your Support Forum login and password. Enter the information in the appropriate fields (if you use a proxy server, your proxy information should be added as host:port, e.g. foo.mydomain.com:8080 in the Advanced section) and click on the Get License button.

   The application will contact Pixar's servers and download your license to the License Server directory. Once that is finished, quit LicenseApp and the license server installer will run to completion.

5. To start the license server, run the following command from a Terminal window:

   ./startPixarLicenseServer.sh

   To stop the license server, run the following command from a Terminal window:

   ./stopPixarLicenseServer.tcl

   Please note that each of these scripts can be edited to accommodate your site's configuration. Also, the Start/Stop button in the License Server window of the installers for the software packages is not, currently, functional.

Important Licensing Information

The release of RenderMan Pro Server 17 and RenderMan Studio 4 introduces important changes to the licensing behavior of the software that users need to be aware of. The license location is no longer hard-coded in the shipped .ini files. Instead, the software looks for the PIXAR_LICENSE_FILE environment variable; this can point to an arbitrary location wherein resides the pixar.license. If it is not found, the software checks the new default location: $RMANTREE/../pixar.license (e.g. C:\Program Files\Pixar\pixar.license), where the license is deposited by LicenseApp. If that is also not found, it will look for any override .ini files (e.g. a rendermn.ini file in a directory pointed to by RMS_SCRIPT_PATHS) that can contain a /licenseserver preference that points to a license server.