Cinema 4D / BodyPaint 3D Program Documentation Reference
Function available in CINEMA 4D Prime, Visualize, Broadcast, Studio & BodyPaint 3D

RLM (Reprise License Manager)

What is RLM?
What does a RLM license look like?
How do I get a license?
How do I install the RML License Server?
How can I use an existing RLM License Server?
The "maxon.opt" options file
How do I find out my Ehternet address and machine name?
How do I connect a client with the RLM server?
Handling errors

Tip:
The integrated RLM licensing in Cinema 4D is primarily meant for studios that already operate an RLM server. Therefore, these instructions cover special Cinema 4D properties accordingly. How to work with the RLM License Server is described in the manufacturer’s own documentation (please refer to the .pdf file RLM License Administration, which can be downloaded here: http://www.reprisesoftware.com/RLM_License_Administration.pdf).

What is RLM?

RLM (Reprise License Manager) is a license management system from Reprise Software.

In principle, a computer (server) distributes licenses to other computers (clients) across a network. The clients must, of course, be connected with the server via the network. The RLM server offers a browser-based interfaces where parts of the control and management jobs with regard to the licenses can be managed. Cinema 4D supports RLM licensing with the introduction of Release 18.

Of course you can also use the MAXON License Server, which is somewhat easier to work with.

What does a RLM license look like?

RLM server licenses

RLM licensee are delivered as *.lic files (they can be opened with any text editor). First, we will take a look at the RLM Server License itself. It will look like this:

Much of the license information can be obtained here.

The RLM Server License should be installed on the machine that will subsequently distribute the licenses to the clients. This machine must run continuously and should do nothing else outside of distributing licenses.

RLM client licenses

Next we will take a look at the client licenses:

You will see that the information here is very similar to that in the first line of the RLM server license. In fact, this information tells the client machine that it should keep an eye out for the ,host’ with the name mxdewin312 and should connect with it via port 6112; ,any’ means that the client does not have to worry about Ethernet addresses (this is what the server does).

How do I get a license?

MAXON requires the following information to issue a license:

How do I install the RML License Server?

If you are already running an RLM License Server from a provider other than MAXON, it can be used in conjunction with the MAXON licenses (see How can I use an existing RLM license server? below).

Otherwise, install the license available at the MAXON website (note that it should only be installed on the server machine and not on the client machines). First, unpack the downloaded MAXON RLM Server Installation Package, then install as follows:

Tip:
In addition to the executable RLM server file, an uninstall script (uninstall.sh/bat) will also be created during installation. To uninstall simply click on this file and follow the prompts.

You have now installed the server and set it up for use. Copy the license file you receive from MAXON into the following system folder:

If the installation was successful, enter localhost:6113 into your web browser’s url field. The administrator start page for the RLM server should then be displayed.

Tip:
After new licenses have been added, you have to click on the Reread/Restart Servers button in the web interface.

How can I use an existing RLM License Server?

If you are already running an RLM server from a provider other than MAXON you don’t have to install a new server. instead, copy the file maxon.set (MAXON RLM server installation directory/data/Common) into the folder in which the existing RLM executable file lies.

Place the license files that you receive from MAXON into the same folder in which the other active licenses lie. Do not combine license files from different providers. Each license file should clearly pertain to the respective provider.

If you want to update existing MAXON licenses, copy the license file text from the web interface (Edit License Files button) into the existing license.

The "maxon.opt" options file

The maxon.opt options file can be used to restrict license use to specific groups:

For example, if you have 1 Studio and 2 Broadcast versions and 3 clients (Jim, Jane and Joe) to which these licenses have to be distributed.

For cases such as this there is the ISV option file (in the .pdf file RLM_License_Administration you will find a description of all options with this name) in the maxon.opt file (you will receive this together with the license files; copy these into the same directory into which you copied the license files). This file can be called up via the RLM web interface (Status, ,maxon’ button in the ,OPTIONS’ field) and modified.

If you want to make the Studio version available only to Jim and Jane you first have to define a group (e.g. Studio group) using the ,GROUP’ option:

GROUP Studio group Jim Jane

Next, you have to define which license these users should receive. Take a look at the RLM server license file (or open the corresponding via the Edit License Files button in the web interface and click on the buttom of the same name in the window that opens). Find ,_line_item=studio’; locate the corresponding identifier ,id=x’ (e.g., ,_id=1’) in the license and assign the ID to the group using the ,INCLUDE’ option (the licensed product name (see above) must also be included):

INCLUDE cinema4d_r18_i group studio group id=1

Now only members of the group Studio group will have access to the Studio license. Joe can now only use the Broadcast license.

The same effect can be achieved using the following command:

EXCLUDE cinema4d_r18_i Joe id=1

This excludes Joe explicitly from using the Studio license.

Don’t forget to do a Reread in the web interface if you make changes to the file.

If you do not use the INCLUDE or EXCLUDE options, the RLM server will assign the first available license (in the order in which the license files are listed) to the client making the query.

The names are the same as those used in the personalization (Main menu: Help in a Cinema 4D version using RLM). Of course host names, IPs, etc. can also be used.

How do I find out my Ehternet address and machine name?

To request a RLM server license you will need an Ethernet address (also referred to as physical address or MAC address) for the server - not the client. Make sure you send the correct Ethernet address to MAXON. In addition to the Ethernet address, MAXON needs the machine name (also referred to as host name, which can be seen in the image below, to the right of RLM Info for System.

Start the RLM server (it will also run without a license) and then enter localhost:6113 into your web browser’s url field. This will open the RLM server’s web interface. Click on the System Info button in the left column:

You will find the Ethernet address and the machine name at the marked locations.

Tip:
Make sure you get this information from the RLM server. It is essential to know which Ethernet address RLM sees as its primary address (even if other applications work differently).

If multiple Ethernet addresses are listed, use the first one on the list.

How do I connect a client with the RLM server?

Cinema 4D requires the host address of the RLM server (it can be found in the RLM client license maxon_xxxx_client.lic that you received from MAXON).

Cinema 4D will search at different locations on the client machine to find this file:

During the Cinema 4D installation, RLM client licenses can be generated while the RLM server (and installed Cinema 4D licenses) is running. Enable the Use License Server option during installation. In the dialog window that opens, enable the Use RLM License Server option and enter the server name and port. The RLM client license file will be generated.

Handling errors

If the RLM connection fails, you can do the following:

Here you can see which licenses are made available by the RLM License Server. You can see which Cinema 4D versions are available, when a license expires and much more. To get even more information you can click on the Diagnostics button, which will save all available information for a given file.