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.
- from my.maxon.net, release the license
- uninstall Maxon App by running sudo ./uninstall_maxon_app.sh
- install the latest Maxon App version
- log into your account using mx1
- 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:
- Launch Terminal
- cd to the Maxon App Tools folder
cd /Library/Application\ Support/Maxon/Tools
- Type ./mx1 then the command, e.g., ./mx1 user login -u test@mail.com -p 12345
Windows:
- Open Command Prompt
- cd to the Maxon App Tools folder
cd C:\Program Files\Maxon\Tools - type mx1 then the command, e.g., mx1 license activate net.maxon.license.app.bundle_maxonone-release~commercial
Linux
- Open Terminal
- cd to the Tools folder
cd /opt/maxon/maxon_app/bin - type ./mx1 then the command, e.g., ./mx1 user logout
List of the commands:
command
|
what it does
|
---|---|
user login -u user_email -p user_password | Log into an account by entering the email and the account password * |
user logout | Log out of an account |
user info | Show the account user info. |
service info | Show the Maxon service info. |
service stop | Stop the service |
service start | Start the service |
service restart | Restart the service |
license list | Show the list of the licenses a user has |
license activate license_name | Activate a license by using the license name ** |
license deactivate license_name | Deactivate a license |
license trial query | Show the Maxon One trial status |
license trial start | Start a Maxon One trial |
product list | Show the list of the installed products |
product info product_name | Show the detailed info on a installed product *** |
product activate product_name | Activate a product's license |
product deactivate product_name | Deactivate a product's license |
--help | How to use the mx1 tool |
* 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
Comments
0 comments
Article is closed for comments.