Welcome to the Red Giant Volume Program!

Welcome to the Red Giant Volume Program!
Red Giant Volume Subscription Guide
Welcome to the Red Giant Volume Program!
In the past, Red Giant has relied on an in-house, serial number based licensing scheme. It’s
simple and easy to use, which works well for our non-enterprise customers who only need to
manage a few licenses. It can however be cumbersome in enterprise settings for all sorts of
reasons including reliable license compliance as well as providing good data on the number of
licenses used by an organization.
For those reasons, Red Giant offers a Volume Licensing Program that will allow you to manage
your licenses more easily through the use of a floating license server model called Reprise
License Manager (RLM).
Red Giant volume products make use of the Reprise License Manager (RLM) version 11.2 b2
licensing software so there are a few steps to take in order to configure both the server where
you will be hosting the RLM software, as well as the client machines that will be checking out
from the license manager.
The Reprise website contains full instructions for installing and configuring your license server if
you need extra help as well.
Pre Installation
 Overview
 What to send to Red Giant
o Finding your IP and Mac Address
 Windows
 Mac
 Port usage
 Render policy
 Failover server
Server Installation
 Overview
 Primary server installation
 Failover server installation
 Manual server installation
 Existing RLM server
Client Installation
 Overview
 License install
 Regular install
 Scripted install
 Render node install
 Server
 Client
Pre installation
The Red Giant volume program relies on a central server running a license file with available
seats to be checked out by client machines on request. In order to generate a license for you
Red Giant will need some information.
What to send to Red Giant
Do you need render only nodes?
o If you have render only machines or a render farm, let our volume team know
how many render nodes you have when you purchase and they can add render
only seats to your license when it’s created.
Do you need a backup/failover server license?
o Should anything happen to your primary server, client machines can check out
licenses from a backup server and prevent interruption for people working at
your client machines.
Do you have specific ports that you need to use?
o There are three main ports of communication
 Client communication
 Web server GUI
 ISV server
For more information on the ports used click here.
Server IP and MAC address
o The license is specific to your server. The next section has more information on
finding your IP and MAC address.
Finding your IP and Mac Address
In order to set up a license server, and create a license file for use with your purchase, we
need to know the IP address and the MAC address of the server you will use to distribute licenses.
A local hostname that resolves to the IP address for the server is also valid. However we typically
generate licenses based off the IP address as this is a more direct method for connecting to a
server. Some Linux\Macintosh based servers may see a hostname warning when launching a
license generated using the IP address. This warning can be ignored as the server will still start
correctly based on the IP address.
Go to the machine you will be using as your license server and use the commands below. If you
have multiple network devices or network connections on your server you’ll want to send in the
MAC and IP address of the connection to the local network that your client machines also use.
Using the “ipconfig’ command from the Command prompt will show the IP information
for all network devices.
Using the “getmac ” command from the Command prompt will show the MAC addresses
for the installed network devices.
You can also use the “ipconfig /all” command from the Command prompt and it will
show all information for all devices.
To find the server IP address navigate to: System Preference -> Network
Select the appropriate network connection from the left column (typically Ethernet)
To find the server MAC address, from the same window: Click the Advanced button
then Select the Hardware tab
If you need to use the server hostname instead of the IP address you can find it by
navigating to: System Preference -> Sharing
Port Usage
The RLM server software will use three ports.
Client Communication
o By default client machines connect to the RLM server software over port 5053
If you need a different port set in your license file let our team know when
sending in your server information.
Web Server GUI
o The administration of the RLM server software is done through a web browser
GUI that runs on port 5054 by default.
ISV server
o ISV servers from different vendors can run under the same instance of the RLM
server executable. Because of this, the default setting for the ISV server port is
dynamic. If you require a static port let our team know when sending in your
server information.
Note: If your server and client machines are separated on your network by a
firewall or any kind of port blocking you will need a static ISV server port
Render Policy
We do offer render node only licenses. These are license that can be created in addition to
standard licenses. The render only licenses are for systems that do nothing but render and are
not editing or working with projects. When sending in your server information let our team
know if you have render only machines and how many render node licenses you will need.
Failover server
We do have a failover server option available. A failover server will be on separate server
hardware from your primary RLM licensing server. In the event that the primary server is
unavailable the failover server can take over the licensing of your client machines while the
primary server is brought back online. Let our team know if you need licenses for a fail over
server when you send in your server information.
Server Installation
Once you have sent in your server information and received your zip file containing your license
files you are now ready to begin setting up your server.
Primary server installation
The primary server is the server that will be handling the bulk of your licensing.
1. Download and run the server installer
Windows Volume Server Installer
Mac Volume Server Installer
This will copy the necessary server executable to the correct location on your server as
well as install the service for RLM to run automatically on reboot.
Note: Mac Users. The server installer app requires OS X 10.9.5 or newer. If your server is
running an older version of OS X you will need to go through the manual installation
2. Copy the license file to the same location as the RLM executable.
Extract the zip file you received from our volume team. In the extracted folder you will
find a server folder. Copy the .lic file beginning with “RedGiant-RLM….” from the server
folder to the same location as the RLM executable. That is the license file for the
primary server.
Server install locations:
Windows: C:\Program Files\Red Giant\License Server
Mac: Macintosh HD/Library/Application Support/Red Giant/License Server
3. Reboot the server
Once the server has restarted the service should be running in the background. You can
confirm this by opening a web browser and going the server RLM admin GUI at
Click on the Status button on the left hand side and you should see an ISV server named
“redgiant” running.
Failover server installation
If you need an optional failover server let our volume team know when they are creating your
license. A failover server will only distribute licenses if the primary server is unavailable. The
failover server needs to be run on a separate system from the primary server.
The installation of the failover server is the same as the primary server with one exception.
In step 2 copy both of the .lic files in the extracted server folder to the location of the RLM
Manual server installation
If you need to install the RLM server to a different location, or don’t wish to have the service
installed you can manually install the server. This is the method for installation you would have
used if you originally set up your server prior to the release of Red Giant failover server option.
1. Download the server zip package
Windows 64-bit Windows 7, 8, Vista, XP,
2003, 2008, 2012 (64-bit)
Windows 64bit download
Windows 32-bit Windows 7, 8, Vista, XP,
2003, 2008, 2012 (32-bit)
Windows 32bit download
OSX 64-bit OS X 10.7.5 and later
OS X 64bit download
Linux 64-bit
Linux 64bit download
2. Extract the contents of the zip to the desired location on your server.
3. Copy the license from the server folder in the zip file you received from our volume
team to the same folder you extracted to in the previous step.
4. Open up terminal/command prompt.
5. In terminal/command prompt, change directories to the location you extracted to.
6. Run the rlm executable
Note: On OS X and Linux you will want to run using the command ./rlm
7. The terminal window will need to remain open while the server is running. If you restart
the server machine itself, you will need to re-launch terminal and go through steps 4 – 6
Existing RLM server
It’s possible to run ISV servers from multiple vendors in a single instance of the RLM executable.
If you have an existing install of an RLM server distributing licenses for other software, you can
add the Red Giant server to that installation.
Note: If you already have an RLM server running, the client communication ports for the license
files must match the licenses from other vendors. Let our volume team know if you have a
different client port setup other than the default 5053
1. Extract the zip file set to you by our volume team
2. Copy the contents of the server folder to the location of your current RLM executable
3. In the RLM admin GUI click the Reread/Restart Servers button from the menu on the left
hand side.
4. Click on the Status button of the left side menu and confirm that the ‘redgiant’ server
shows up in the list of ISV servers.
Client Installation
There are two main tasks when installing Red Giant plugins on client machines.
1. Copy the client .lic file pointing to the license server and optional failover server into
the appropriate folder
2. Install the plugins (using the regular or scripted installer)
License install
Extract the zip file you received from our volume team. In the extracted folder you will find a
clients folder. Copy the contents of the clients folder to the following location:
Client license locations:
Windows: C:\ProgramData\Red Giant\licenses
Mac: Macintosh HD/Users/Shared/Red Giant/licenses
Note: Prior to April 2016 client licensing was handled via the legacy .config file.
Regular Install
Go to our main downloads page and download the suites you have purchased.
Run the suite installer for your operating system. On the “Registration” page of the installer,
select all products you want to install. They will show up as “Trial” which is normal. You can
continue through the installer and select the software and relevant host apps and then
complete the installation.
For Red Giant Universe download and install Red Giant Link and sign in using any Red Giant ID.
Install the trial of Universe from within the Red Giant Link app.
Scripted Install
The Red Giant Scripted installers allow for installation of our volume program supported suites
via the command-line rather than running through our regular installer GUI. These new
installers can be downloaded via the links below.
Trapcode Suite Scripted Mac
Trapcode Suite Scripted Win
Magic Bullet Suite Scripted Mac
Magic Bullet Suite Scripted Win
Shooter Suite Scripted Mac
Shooter Suite Scripted Win
Effects Suite Scripted Mac
Effects Suite Scripted Win
Keying Suite Scripted Mac
Keying Suite Scripted Win
Universe Scripted Mac
Universe Scripted Win
Each suite follows a similar folder structure.
 Install script:
o install.sh for Mac
o install.bat for Windows
 Packages folder: Containing various plugins and dependencies
 Bin folder: Containing the rgdeploy tools
These three items must remain together for the script to function.
To install on client machines:
1. Unzip the downloaded suite to a location accessible by the client machines you wish to
install to.
2. Create a folder named licenses in the packages folder of the extracted zip.
3. Copy the contents of the clients folder from the zip you received from our volume team
into the licenses folder you created in step 2.
4. Execute the install script on the client machines via your preferred method of scripted
deployment. (Login script, ssh connection, or running locally)
The install script calls into the tools in the bin folder to accomplish the install the contents of
the packages folder, dynamically detecting what host applications are present.
Note: Host applications not installed to their default locations may not be detected.
Example scripted install
Running the install locally on client machine.
1. Open a terminal window/command prompt
Note: on Windows, you must right-click on the program and choose "Run As
2. Change directories (cd) to the top level directory of the extracted scripted install zip
3. Run ./install.sh (Mac) or install.bat (Windows)
4. Enter the admin password when prompted
You will see output letting you know what host applications were detected and what was
Note: The scripted installers will not install Red Giant Link
Render node Install
When using the administration page of the RLM server, you can tell the difference between
license checkouts for products based on the name of the license being used. A full license will
use the product name to represent the license (such as trapcodeparticular) and a render-only
version of that license will have “-ro” appended to it (so, trapcodeparticular-ro for render-only
To install on render only machines you can use whatever client method you prefer.
To enable a client machine to check out render only seats:
1. Create a plain text file named “rlm-options.txt” in:
Windows: C:\ProgramData\Red Giant\licenses
Mac: Macintosh HD/Users/Shared/Red Giant/licenses
2. Edit the text file in step 1 and add the contents:
3. Once saved the options file will have the render node check out render only licenses
from the license server.
Note: Prior to April 2016 enabling render only was done through the legacy .config file.
Server Administration
Server administration is handled from the RLM web interface. On the server running your RLM
license sever open a web browser and go to: http://localhost:5054/home.asp
The main page of the RLM server
Navigation is handled through the menu on the left side of the interface. Red Giant volume
licensing does not make use all the features of the RLM software, but here are a few useful
The status button at the top of the left side menu takes us to the main status page for all
servers and licenses running in this instance of the RLM server.
On this page we can see:
 Client communication port
 What licenses are being read
 Running ISV servers and what port they are using
In the example screenshot below we can see that my client communication port is running on
5056 instead of the default 5053, my server is reading two license files, and my ISV server is
running on the dynamic port 62218.
Server Status
From the main status page, if we click on the “redgiant” button in the Server Status column of
the ISV section we can view the status of the redgiant ISV server and details of the licenses
being read by that server.
License Usage
From the main status page, if we click on the “redgiant” button in the License Usage column of
the ISV section we can view what licenses are currently in use on which machines.
Client Administration
All administration on the client side of things is done through the “rlm-options.txt” file. The
two options that can be added to that text file are:
Render only
This option tells the client machine to check out render only licenses from the license
server and is intended for render node machines.
Client logging
This option will have the client create a log file that can help with troubleshooting issues
that may arise.
The locations of the created log files are:
Mac: /Users/Shared/Red Giant/logs
Windows: C:\ProgramData\Red Giant\logs
Note: Prior to April 2016 client administration was done through the legacy .config file.
With the implementation of the failover server we needed to change some of the process by
which client files license. For existing Red Giant volume installations, you do not need to
change your client configuration unless you are renewing your subscription or you wish to take
advantage of failover servers.
If you had volume server client setup prior to April 2016 your client workstations will have their
client configuration files located in:
Mac: /Users/Shared/Red Giant/
Windows: C:\Red Giant\
The client license file will be a file named “redgiant.enterprise-client.config” This file serves the
same purpose as the current .lic file however render only and logging are turned on by editing
the .config file itself.
Below is an example config file edited to have client logging and render only enabled.
To ensure that your client machine is still able to connect to the server, do not edit the line of
the config file containing the IP address and port number of your license server.
That should do it! At this point, you should be up and running with your Red Giant software
If you experience any problems or have any questions, please contact support at:
Thank you for your business!
Red Giant
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF