Installing and using the Maxon App on Linux

Getting started with the Maxon App on Linux

First Steps

Downloading the application

Go to https://www.maxon.net/try and download the Linux version of the Maxon App

Installing the application

Open a terminal window, and cd to the directory where you downloaded the application. Then run

sudo sh install_maxon_app_3.0.sh --target /opt/maxon

The application will be installed like so:

Creating directory /opt/maxon
Verifying archive integrity...  100%   MD5 checksums are OK. All good.
Uncompressing 0.0.1  100%
Executing postinstallation script
create user for maxon app service if non-existent
service user found
setup directories
setting file & directory permissions
install and start the maxon app as a service

Verifying the Maxon Service

To verify that the service is running, run:

systemctl status maxon_app.service

If the service is available you will see something like this:

● maxon_app.service - Maxon App Service
   Loaded: loaded (/etc/systemd/system/maxon_app.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-09-01 15:05:20 CEST; 11min ago
 Main PID: 992 (start_srv.sh)
    Tasks: 16 (limit: 48088)
   Memory: 15.9M
   CGroup: /system.slice/maxon_app.service
           ├─992 /bin/bash /opt/maxon/maxon_app/bin/start_srv.sh
           └─993 /opt/maxon/maxon_app/bin/maxon_appd

Licensing Workflows

Licenses are managed with the mx1 command-line tool. By default, the tool is available in /opt/maxon/maxon_app/bin

Verifying that the service is available

Run ./mx1 service info

If the service is running you should see something like this:

Maxon Service
-----------------------------
Version:     3.0.0
API:         2.0
Buildstamp:  0x44847b86
Schema:      2022.3.15
Class:       production

If however, the service isn't available you'll see this instead:

Error: Request failed. Service might be unavailable.

In that case, ensure that the service has started by running systemctl start maxon_app.service, and verifying the status with systemctl status maxon_app.service

Logging in and out of your account

To log in, you'll need your email and password used for your Maxon account

./mx1 user login -u myemail@domain.com
Enter password: mypassword

To log out, run ./mx1 user logout

Listing your licenses

To list your licenses, run: ./mx1 license list

The tool will output the list of licenses available in the user account, their activation status, and validity period. For example:

License Name                                                          Description                     Activated  Expired   Validity Period
---------------------------------------------------------------------------------------------------------------------------------------------------------
net.maxon.license.app.redshift~commercial                             Redshift                        yes        no        2021-08-10 - 2022-01-01
net.maxon.license.service.cineversity                                 Cineversity                     yes        no        2021-08-10 - 2022-01-01
net.maxon.license.app.bundle_maxonone~trial                           Maxon One Trial                 yes        no        2021-08-20 - 2021-09-02
net.maxon.license.app.bundle_c4d_rs-release~commercial                Cinema 4D (Redshift Bundle)     no         no        2021-08-10 - 2022-01-01
net.maxon.license.app.teamrender-release~commercial                   TeamRender Commercial           no         no        2021-08-10 - 2022-01-01
net.maxon.license.app.cinema4d-release~commandline                    C4D Commandline                 no         no        2020-04-03 - 2099-12-31

Activating and Deactivating specific licenses

To active a license run mx1 license activate <license_identifier>. For example:

./mx1 license activate net.maxon.license.app.bundle_maxonone~trial
Successfully activated a license for 'net.maxon.license.app.bundle_maxonone~trial

Similarly to deactivate a license use the deactivate command. For example:

./mx1 license deactivate net.maxon.license.app.bundle_maxonone~trial
Successfully deactivated 'net.maxon.license.app.bundle_maxonone~trial'.

Trial Licenses

Trial licenses are started with the following command

mx1 license trial start

Listing your products

To see the products available for activation in your account, use the mx1 product list command. For example:

Product                       Version   Installed Owned   Licensing      Identifier
-------------------------------------------------------------------------------------------------------
Cinema 4D                     23.000    no        yes     deactivated    net.maxon.cinema4d
Magic Bullet Suite            14.0.0    no        no      trial          com.redgiant.magicbullet
Redshift                      3.0.0     no        no      trial          com.redshift3d.redshift

Activating and Deactivating specific products

To activate a product use mx1 product activate <product_identifier>
For example:

./mx1 product activate com.redshift3d.redshift
Successfully activated a license for 'com.redshift3d.redshift`

Similarly, to deactivate a license use the deactivate command. For example:

./mx1 product deactivate com.redshift3d.redshift
Succesfully deactivated a license for 'com.redshift3d.redshift'

Getting the Maxon app log & debugging 

To get the Maxon app log file on Linux you will find it at the following location. (This file is important to share with support when you create a ticket at our support center.)
https://support.maxon.net/hc/en-us/requests/new

var/opt/maxon/log/application_support/maxon_one_service/maxon-service.log

If you are experiencing issues with the Maxon app, please follow these steps in order to force a reset on your license.

1. from my.maxon.net, release the license
2. uninstall Maxon App by running sudo ./uninstall_maxon_app.sh
3. install the latest Maxon App version
4. log into your account using mx1
5. use ./mx1 license list to check the licensing status - the license should show "activated"

Uninstalling

In order to uninstall the Maxon app you can run:

sudo ./uninstall_maxon_app.sh

Available commands:

The MX1 tool is shipped with the Maxon App installer on Mac and Windows. It's also included on Linux with our newest Maxon App releases. The MX1 tool offers abilities to log in/out of an account, activate/deactivate a license using the command line. 

The install location:

Mac: Library/Application Support/Maxon/Tools

Windows: C:\Program Files\Maxon\Tools

Linux: opt/maxon/maxon_app/bin

How to use it:

Mac:

1. Launch Terminal
2. cd to the Maxon App Tools folder 

   cd /Library/Application\ Support/Maxon/Tools 

3. Type ./mx1 then the command, e.g., ./mx1 user login -u test@mail.com -p 12345

Windows:

1. Open Command Prompt
2. cd to the Maxon App Tools folder
   cd C:\Program Files\Maxon\Tools
3. type mx1 then the command, e.g., mx1 license activate net.maxon.license.app.bundle_maxonone-release~commercial  

Linux

1. Open Terminal
2. cd to the Tools folder
   cd /opt/maxon/maxon_app/bin
3. type ./mx1 then the command, e.g., ./mx1 user logout

List of the commands:

* 1, to hide the password, press Enter after entering the username. 2, mx1 login does not work for LDAP users

** use mx1 license list to get the license name

*** use mx1 product list to get the product name

Uninstalling the application

You can uninstall the Maxon App on Linux using sudo ./uninstall_maxon_app.sh