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

MAXON License Server

Installing & launching the License Server
Installing on Clients
Launching the License Server with a different port number
Serial number "leasing"
License Server Interface
Saving License Server Settings
Menu Commands

Tip:
The MAXON License Server must be purchased separately.

With the MAXON License Server (hereinafter referred to as License Server) serial numbers (also referred to as registration codes) can be allocated, managed and monitored from a main computer within a local network (or from wherever you have a functioning TCP/IP v4 for port 5235 (or another available port)). This is especially useful for environments in which several Cinema 4D versions are running simultaneously, such as educational institutions.

The advantages of using the License Server at a glance:

Tip:
Multi-license serial numbers are always final, registered serial numbers. These are not temporary serial numbers limited in their validity to three months, as is the case with normal Cinema 4D serial numbers.

Installing & launching the License Server

Tip:
If possible, the License Server should not be installed onto a computer that is being used as a normal workstation but on a separate computer.


  1. Call up the installer and install the License Server. After successful installation, start the License Server. The License Server’s GUI will open.
  2. Copy the block of multi license numbers from either the PDF of email that you received from MAXON to the clipboard.

    Tip:
    Note that the serial number can only be copied and pasted from the e-mail or .pdf file you received into the appropriate fields. Serial numbers cannot be entered manually!

  3. Click on the Add Serials button:

  4. Paste the multi-license Packages you just copied and click on OK.
  5. The Serial Package list should now be displayed at the left of the window, as the next image shows

    A multi-license Package named Cinema 4D R R18.

The License Server is now ready to be launched. All that needs to be done now is to let the Cinema 4D versions installed across the network (hereinafter referred to as Clients) know that they must obtain a serial number from the License Server (see following section) and where to find it.

Installing on Clients

Each Cinema 4D installation that is to obtain its serial number from the License Server must have a text file named license.ini in its installation directory (i.e. at the location of that version’s executable file). The license.ini file must contain the following information:

[settings]

server=192.xxx.xxx.xxx

port = 5235

Server: Enter the License Server’s IP address (or name, if applicable)

Port: This is the port number at which the network server will recognize the Clients.

Launching the License Server with a different port number

The License Server can be launched using a single parameter. For example, under Windows, create a link and add license_server 2345 to the Target field (whereby 2345 in our example can be replaced by any port number).

Under Mac OS, open the terminal window and search for the "License Server.app" file in the License Server’s program directory. Right-click on the file and select the "Show Packet" command. Navigate to Contents / MacOS / Cinema 4D Demo and drag this file into the terminal window. The correct program path will then be displayed. Enter -license_server 2345 here also.

Serial number "leasing"

In our example we will use a 3-seat multi-license Package. With this group of serial numbers, 3 Cinema 4D licenses can be allocated, i.e., a maximum of 3 Cinema 4D versions can be run simultaneously.

Let’s say a total pool of 10 workstations (Clients) is available for use with these three licenses.

Workstations number 1 and 5 have already been allocated a license from the License Server. Now workstation number 2 also starts Cinema 4D - and can do so with no problem because it is allocated the last of the three available serial numbers from the License Server. If, for example, workstation number 7 attempts to start Cinema 4D it will receive an error message because all available serial numbers have already been allocated and are in use.

Workstation number 7 can only start Cinema 4D after one of the other workstations already running Cinema 4D has quit Cinema 4D, thereby freeing up one of the three available serial numbers.

How can a Client free a license? This can happen in one of the following ways:

License Server Interface

The License Server’s interface itself consists of four windows:

The Serial Number window

This is where all of the License Server’s multi-license Packages are displayed:

Right-clicking on a serial number will make the following commands available:

At the top of the Serial Number window are two buttons:

Add Serials

Click on this button if you want to enter multi-license serial packages purchased from MAXON Computer that should be passed on to Clients.

The serial numbers MUST be entered in a specific order. To do so, copy all of the serial numbers from the email you received into the dialog window.

Example:

Cinema 4D Studio R18 [18-0-1000] <<17200012345-XXXX-XXXX-XXXX-XXXX>>

Multi-License (005) [18-0-200000174] <<20201012345-XXXX-XXXX-XXXX-XXXX>>

Show / Set Server Info

When the License Server is started for the first time you will be prompted to enter information such as your name, or company name and address under which the group of serial numbers was purchased. Clicking on this button will display this information. This information can also be modified, if needed. This information will be displayed on each Client when the user selects the Personalize option from the Help menu.

Multi-license number settings

For the most part, multi-license serial packages have properties that are of an informal nature:

Name

The serial number name. This name can be changed, which will not affect the serial number itself.

Block/Serial Number

The serial numbers and Cinema 4D multi-license.

Version

Displays the Cinema 4D version for which these serial numbers are valid. A Cinema 4D R 17 version will not function with any R16 numbers!

Licenses

Displays how many licenses of a Serial Package are still available. 2/3 means that two of the three available serial numbers are still available for allocation.

OS

Displays the operating system for which a Serial Package is valid. All means that the Serial Package can be used on all operating systems.

Blocked

This option is made available if you click on a Serial Package (the top-most entry of the hierarchy shown above). The entire Serial Package can be blocked to prevent allocation. However, Clients will only then be made aware of this upon requesting a new license. If, for example, a Client has received an offline lease period of 12 days it will be made aware of this lock after this 12-day period has expired.

Groups

Environments with numerous computers and users that can request a serial number from the License Server can be split into user groups to which common properties can be assigned. Certain serial numbers can be blocked, various leasing periods can be assigned to specific groups, and groups can be given preference for the allocation serial number groups.

The Default user group is always present. This is the group that will be referenced automatically by Clients if theAuto Assign Group option is not enabled.

The Default group can be blocked if you want to prevent Clients being automatically allocated to a user group (i.e. automatically be allocated a license). Administrator rights will be required to free a Client, which is done by manually allocating the Client to a group.

A user group can be created by clicking on the Add Group button. Each Client will automatically be allocated to the Default group. Several user groups can be created (Add Group button) to which Clients can subsequently be allocated. Clients can be allocated to user groups in two ways:


  1. Drag & drop the Client onto a user group


  2. New Clients can be allocated automatically (see below)

If a User Group is enclosed by two number signs (#) it is blocked, meaning it cannot allocate serial numbers.

The User Groups can be re-arranged via drag & drop.

Right-clicking on a user group will make the Delete Group command available. If a group is deleted to which Clients were allocated, these Clients will automatically be re-allocated to the Default group.

User Group Settings

Groups can be assigned the following properties:

Name

Assign a name to the user group.

Blocked

Using this option, user groups can be excluded from the allocation of serial numbers. A description of what happens when the Clients allocated to a blocked group request a serial number after their lease period has expired can be found in the following parameter description.

Default Lease Time (Days)

Defines the maximum period for which a Client can be disconnected from the License Server (exception: A Client has requested offline lease time - see next parameter). Normally, the License Server and Client(s) communicate with each other once per minute to make sure each is still connected. As soon as this communication takes place the lease time will be applied. If the connection between License Server and Client is interrupted the Client will display a warning message every minute. The scene can be saved. After Cinema 4D quit it cannot be re-launched on this Client. Avoid setting very short Lease Times - this will put an unnecessary burden on the network. Furthermore, brief interruptions to the network connection will result in Client licenses being withdrawn.

Max Lease Time (Days)

Defines the maximum offline lease time a Client can request.

The Personalize command can be called up in the Client’s Help menu. A dialog window will open in which all serial numbers are displayed:

Clicking on the Valid Until button will open the Lease License dialog window (alternatively this window can be opened by selecting the Lease License command from the Help menu).

In this dialog window the user can request offline leasing by adjusting the slider to the desired time, ranging from the default to the maximum leasing time. During the offline lease period the Client does not require a network connection to the License Server. After the lease period has expired a warning message will appear, as described previously. Of course this Client can be re-connected to the License Server if it needs to request more offline lease time. Avoid setting very short Lease Times - this will put an unnecessary burden on the network. Furthermore, brief interruptions in the network connection will result in Client licenses being withdrawn.

Tip:
For laptop users it is recommended that the Default Lease Time and Max Lease Time values be set higher, e.g., to 2 and 20 days, respectively, because their communication with the License Server is generally more sporadic.

Color

Use this option to assign a color to a given user group (e.g., for easier identification).

Preferred Serials

If you own multiple multi-license serial number groups, one of these groups can be dragged & dropped into this field. This group’s clients (in as far as they are available) will then be given preferential treatment. Right-clicking on this group will open a context menu in which the group can again be removed.

Automatic Group Joining

If enabled, Clients registering for the first time (those contacting the License Server for the first time and are NOT included in the Client list) will automatically be assigned to user groups.

Two modes are available:


  1. Option(s) enabled, no Expression(s) defined.
    Depending on the option(s) enabled, the License Server will check with all Clients in the Client list if the computer IP, the IP, the computer or the user have already been used and will automatically allocate the new Client to the corresponding group.
    Example: A new Client with the computer ID, 0815ACDC, contacts the License Server (the Client list already contains a user group entry, Room 40, (example) for this computer ID because a user had previously requested a license for the same computer). If the Join Computer ID option is enabled in the Room 40 settings the new Client will also be assigned to this group automatically.
  2. Option(s) enabled, Expression(s) defined
    In this case existing Clients and their user group affiliations are irrelevant. Only the Expression(s) defined will be applied. The following special characters for Expressions are available:

    • * - wildcard character for any number of characters
    • ? - wildcard character for any single character
    • # - wildcard character for numeric characters
    • | - a logical "or", i.e., each computer that meets a condition separated by | will be added to the group.
    • () - defines the Expression grouping - see image above
    • \ - if you want to search for special characters like the ones above you have to place a backslach in front of the special character (e.g., \# if you want to locate the pound sign). A special case is the comma ,, which cannot be located directly but has to be searched for using ? (for "any" character).

Examples

Tip:
Make sure you only activate the option(s) you really need. If, for example, you create an Expression for a computer name search but still have the computer ID search enabled, the latter would have to have the Expression, *. It would, of course, be much easier to just disable the computer ID search.

Client List

The Client list is located at the top right. This list contains all Clients that have contacted the License Server (except for those that have been deleted from the list). Each entry in the list represents a single computer ID, IP address, computer and user combination. If only one of these properties is modified a new Client list entry will be created.

Clients can be dragged & dropped onto a user group to allocate them to that group.

Selecting and right-clicking on a client will open a context menu from which you can delete the selected Client.

Tip
Only Clients that do not currently have a serial number allocated to them from the License Server can be deleted. These Clients will be placed within square brackets in the Serial Package column.

At the far right of the Client List window is the Group By button. Here you can define how the Clients will be displayed in the list, e.g., according to user groups, computer IDs, etc. This can improve the general overview

Above this button is a text field that can be used to filter the list that is displayed in the computer ID, IP address and computer/user columns.

Client Properties

Clients have the following properties. All except one of these properties can be modified.

Machine ID

A specific value that unequivocally identifies a Client computer.

IP Addresse

The Client computer’s IP address.

Computer

The name of the computer on which the Client is running.

User

The user who launched the Client.

Serial Package

The name of the multi-license Package.

Version

The Client’s Cinema 4D version number. This number must correspond to the multi-license Package. If, for example, the Client is running version number 17 the version will not be compatible with version 16.

Last Login

This field shows when the Client last logged in to the License Server to begin a session. If the Client is turned off or if the connection between Server and Client is interrupted the session will be terminated and restarted once the connection has been re-established.

Last Seen

Shows when the last connection to between the License Server and the Client took place. If no connection between the two currently exists, Not connected will be displayed in this field.

Valid Until

Shows how long the Client’s license is valid. During this period, this license cannot be allocated to another Client. If, for example, 9 min remaining is shown it means that the license is valid for the Client for a total of 9 minutes.

Logins

Shows the total number of logins for that Client.

Client Time Diff

If differences should arise between the system times of the License Server and Client(s), this difference will be displayed here.

Group

If a Client has been allocated to a User Group, this information will be displayed here. Otherwise Clients will be allocated to the Default group by default.

Blocked

Use this option to block Clients from being allocated a serial number.

Notes

Here you can make notes regarding each Client.

Saving License Server Settings

All License Server settings (e.g., serial numbers, Client Lists, etc.) will be saved to an encrypted file named licensedata.dat in your user directory. If you copy the License Server to a different directory on your computer or copy or install it to a different computer altogether, the licensedata.dat file must be copied accordingly.

Tip:
License Server settings can only be saved for a specific user. If another user starts the License Server, this user will not have access to other users’ serial numbers, client lists, etc., if he/she does not have a copy of the aforementioned file in his/her user folder. However, using the g_prefspath command cell parameter, this file can be accessed by all users at a single directory.

Menu Commands

The License Server menu contains the following commands:

File

Preferences

Although this menu contains numerous commands the only ones relevant to the License Server are the Language (defines the language in which the GUI should be displayed) and Open Directory (opens the Explorer/Finder window to your user directory, where relevant files such as the previously mentioned licensedata.dat file are located).

Save Layout As …

Saves the current License Server layout. To load the saved layout after the License Server has been restarted, drag the layout file from the Finder/Explorer window to the License Server window. Alternatively you can save the layout in the License Server’s sub-directory ./library/layout - you can then select the layout at the top-right of the GUI when the application is started again.

Console

Opens the console window.

Close

Closes the License Server.

Help

MAXON Support

Calls up the MAXON online support page.

Check for Updates…

Select this option to update the License Server online.

Manual Installation…

If the License Server does not detect an internet connection, this command can be used to perform a manual update. The update file must, however, already be saved to your hard drive. This file must then be loaded when the command is executed.

About

A splash screen will be displayed containing, for example, the License Server version number and other information that should be included in any support request you may make.