NEW IN R21

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

Maxon License Server

General – what is a License Server?
  Starting the License Server
  Starting the Clients
The License Server web GUI
  Licenses
  Users
  Manage licenses
  Settings
  Log
  Info

The Maxon License Server was adapted to work with the new Maxon license system (see License Manager...) and works differently from how it did in previous Cinema 4D versions.

The Maxon License Server now runs as a service (or daemon under macOSX / Linux), i.e., it always runs in the background as long as the computer is running.

General – what is a License Server?

The Maxon License Server (in the following referred to as License Server) makes it possible to distribute, manage and control licenses from a main computer within a local network. This is especially useful in networks in which numerous Cinema 4D versions are used such as at schools, government offices, companies, etc.

Licensing is then no longer done for an individual work place - referred to as Clients in the following - but is done from a central location. Individual Clients then do not require a Maxon user account (with internet access) but must only login to the License Server running on the local network, which will assign the license.

For example, if the user is finished with their work, the license can be freed up again and used by someone else.

TIP:
Note that the License Server does not assign offline licenses (with which you can, for example, work offline for 3 weeks without contacting the License Server). You need to be in constant contact with the Clients. If the License Server is not running, the Clients will also not run.

Generally speaking, the following applies:

  • The License Server must always be running so the Clients have access to it
  • The License Server needs to access the internet from time to time (max every 90 days)
  • The Clients do not need to access the internet.

Starting the License Server

After the License Server has been installed - make sure you select the correct port because it cannot be changed that easily - you first have to purchase one (or more) License Server licenses under Buy License in your Maxon user account. These will then appear immediately in your user account - if the License Server is connected to the Maxon user account (Maxon Account Sign-In in the Settings menu) - and will also be avialble to the License Server (these Lizenzen are available).

The Maxon License Server can also be installed under Linux. The installation instructions can be found here.

Tip:
Normal licenses (=licenses that can be assigned without the Maxon License Server) do not work in conjunction with the License Server but License Server licenses can in turn be used as normal licenses.

In a second step, License Server licenses must be assigned for distribution in the License Server’s Manage Licenses menu (see Manage Licenses).

Tip:
Call up the GUI in your browser via the License Server computer’s IP Port (i.e., 192.168.139:5264 or localhost:5264, for example, if the License Server is running on the same computer as the browser). The port is identical to the one you used when installing the Licnese Server.

Note that you can only change this port by uninstalling the License Server and re-installing it again (any licenses assigned in the meantime will be linked to this port; when in use, these will first be freed up once the Client lease has expired).

The sign-in information is initially always:

  • user name: admin
  • Password: admin
  • This should be changed in the Users tab as quickly as possible.

Starting the Clients

As soon as you have completed the Starting the License Server steps above, Clients will be able to access the licenses.

If the Client does not have any licenses, the license dialog window will open when Cinema 4D is started. Click on the License Server tab:

This is what the dialog window looks like after clicking on License Server.

This dialog window contains the following settings:

If these fields have been filled out correctly, click on OK. If you see a green bar under Validate License Status, a license was assigned. If you are using multiple License Server license types, you might have to find the fitting ones. Otherwise the License Server will not know which one to use.

Now click on OK in the license dialog window and Cinema 4D will start.

The License Server web GUI

The License Server web GUI looks like this once started:

Licenses

The license page will look similar to this (any last-minute changes are not reflected in the screenshots). On this page you will find an overview of the licenses used by Clients as well as those not in use.

Occasionally, messages will appear at the top right. These can be hidden by clicking on them.

Graphic Display

In the graphic display you will find the number of License Server licenses that can be used for this particular License Server displayed as a timeline. The timeline can be scaled using the buttons at the top left from 1 to 90 days. The utilization rate of your License Server licenses is displayed.

The following colors are used:

Table

At the bottom, the current distribution of License Server licenses is displayed as a table. If you activate Show Unused Licenses, the License Server licenses currently not assigned will be displayed. The informaton is self-explanatory except for the following:

Users

On this page, users and groups can be created. Users can be assigned to groups. What can this be used for? Imagine you have 3 License Server licenses. Your company has a marketing and a sales department, each with 5 employees who all use Cinema 4D from time to time. You might have an issue if the marketing department uses all 3 licenses simultaneously and the sales department is stuck with nothing. To get around this issue, you can create 2 groups: marketing and sales. Each group can be allotted a maximum of 2 licenses. Problem solved.

As soon as you have created a new user or have clicked on an existing user, the dialog window at the left on the image above will open. Here you can define details for the user. The same applies to new or existing groups.

User dialog window

If you click on Create User, a dialog window will open in which you can define the new user’s user name. Click on OK to confirm.

The following settings can be defined, which will be shown when you click on the user:

User

This is the user name with which the user registered with the License Server (for both the Client as well as the License Server GUI). Note that this user name and the password have nothing to do with the Maxon user account! Each has its own user name and password.

Name

Enter the user’s real name here.

Email

Here you can enter the user’s email address. This is only for quick reference and serves no other purpose than being able to contact the user for whatever reason.

Password
Repeat Password

When a new user is added, a password can be assigned here. This will not be displayed later when the user’s details are called up.

Administrator

Here you can define if the user should have admin rights. An admin can do the following:

Users who do not have admin rights will only see the menu items Licenses, Users and Info, and can only change their own real name, email and password.

Member(s)

Here, the group (or groups) will be shown in which the current user is a member. Each newly-created user is initially a member of the ,Default’ group and will be returned to this group if removed from other groups.

Click on the group to display its settings.

Cancel/Okay

All changes made will be saved when you click on Okay. Click on Cancel if you don’t want the changes made to be saved.

Delete User

Click here to delete the current user, including all related information.

Group dialog window

A group consists of one or more users to which a maximum number of License Server licenses can be assigned.

Clicking on Create Group will open a dialog window in which you can define the name of the group. Click on OK to confirm. Here you will find the following settings, which will be shown when you click on the group’s name:

Gruppen ID

This is a unique group ID made up of a unique series of characters generated by the system.

Name

This is the name you can define freely, which will appear in the group list.

Members

Here you can enter the names of the group’s members (as defined in Users), separated by a comma. If you later see ,=true’ after each name, this can be ignored. If you want to remove a user from the group, simply delete the name (or change ,=true’ to ,=false’).

Tip
A user can be a member of multiple groups. However, this bears the following disadvantage: assuming A is a member of group A and group B, and currently uses a license from group A. Group B only has 1 license assigned to it and C wants to have a license from group B. The License Server will register that A is already using a license (from group A) and will categorize group B as being at full capacity. C will therefore not be given a license.

Group limit

Here you will find settings for the group itself: If you check the box next to the left Limit column you can define the maximum number of License Server licenses for this group on the right Limit column.

In the Product column you will find a list of the product licenses that are assigned to the License Server. These can be defined separately with the Limit column.

The Available Licenses column you will find a list of the total number of licenses assigned to the current License Server (regardless if these were already distributed to Clients).

Cancel/Okay

All changes made will be saved when you click on Okay. Click on Cancel if you don’t want the changes made to be saved.

Delete Group

Delets the selected group. All members will be returned to the ,Default’ group.

Manage licenses

The Assigned and Unassigned columns refer only to the licenses assigned from the Maxon user account to the License Server and not to the Client licenses assigned from the License Server (this information can be found in the Licenses menu). "Assigned" means that the License Server can distribute this license.

On this page, all purchased License Server licenses - displayed as Online License - are listed. You will find two tables:

The most important element on this page is the Assign button. As soon as a License Server license has been purchased (see Starting the License Server above), it must be assigned to the current License Server using this button.

Assigned Online Licenses

Unassigned Online Licenses

Refresh Licenses

Clicking on this button will connect the License Server with the Maxon user account and will refresh the lease duration (of the License Server from the Maxon user account). The same happens periodically via the Server License - refresh all in the Settings menu.

Settings

In addition to several detail settings, you can also link the Maxon user account with the License Server on this page.

Settings

Client connection requires no user name/ password

When a Client registers with the License Server you can define here if a user name and password must be entered.

The unsername and password are defined in the Users menu (this has nothing to do with the Maxon user account login!). If this option is disabled, any user can sign in to the License Server if they have the correct IP and port.

Client license release on quit

If its option is enabled, the license will be returned from the Client to the License Server when Cinema 4D is quit and the license can be assigned to another Client. This is the normal behavior since this ensures a continuous distribution of licenses.

If this option is disabled, the license will remain with the Client when Cinema 4D is quit and will NOT be available for other users. Only when the Client Lease Time (without contact with the License Server, which would extend this periodically) has expired will the License Server be able to access this license.

Note that the Client can free up its license at any time independently of this setting via the Quit and Free License command - assuming the Client can contact the License Server.

Server license lease duration (Maximum)

Tip:
For this and the following numeric field, enter min for minutes, h for hours and d for days.

This is the length of time that the License Server can use the license from the Maxon user account. During this time, no other License Server can assign this license to other Clients. If this time expires without the License Server synchronizing with the Maxon user account (either via clicking on Refresh License (Manage Licenses tab) or periodic actualization (Server License - refresh all), this license will be returned to the Maxon user account and will no longer be available for the License Server. You can, of course assign the free license to the License Server again (Manage License menu).

Server license - renew every

You can use this setting to control how often the License Server should attempt to renew the license from the Maxon user account. The default setting of 1 day ensures that the License Server will contact the Maxon user account on a daily basis to extend the duration of the lease for the period defined.

Make sure that this timespan is shorter than the Server License Lease Duration (Maximum) span because the lease duration can otherwise expire for the Client without the License Server having automatically extended this license.

Revert Changes
Apply Changes

Use these buttons to undo or apply changes, respectively. Changes will first apply when the Apply Changes button is pressed.

Restart Server

If, as an administrator, you want to quit and restart the License Server you can click on this button. This should, however, never be necessary.

Account

Here the account that is linked to the License Server is displayed.

The Remove button can be used to remove the link. Licenses leased by the Maxon user account will remain for the defined Server License Leas Duration (Maximum) timespan and will first be returned to the Maxon user account when this timespan expires.

Maxon Account Sign-In

Here you can link your Maxon user account with the License Server. Multiple accounts can be linked with the License server and all corresponding licenses can be made available for distribution by the current License Server.

Enter your user name and password and click on Sign-In to access your Maxon user account. If successful, your account will be added to the list. Corresponding licenses will be displayed on the Manage Licenses page.

Log

The Log page displays a wide range of information about the License Server such as if licenses have been assigned, if new users or groups have been added or removed, if something is not working correctly, etc.

Filter
Filte Text

In the Filter text field you can enter a series of characters to list all items that contain this series of characters. After entering the characters you can either press the Return key on your keyboard or click on the Filter button to activate the filter. If this field is empty you can click on the Filter button to refresh the list.

Info
Warnings
Errors

These buttons can be enabled or disabled accordingly to display the desired filter(s). Orange = enabled. In the image above, the Info (i) and Warnings (warning icon) are shown. Errors can, for example, be file errors or sign-in errors, etc.

Download

Clicking on this button will download the log list as a text file. It will be saved to the browser’s download directory as a log.txt file. Successively downloaded files will be numbered in corresponding order.

Note that the log file will contain time coordinates in global time (UTC), i.e., it will differ from the time that is displayed in the GUI (here: local License Server time).

Clear

Clears the entire log list, including the server statistic (the graphic on the Licenses page).

Info

On the Info page you cannot add or remove any elements. It only displays information from the License Server. All very self-explanatory.