Installing and using the Maxon App on Linux

Topics covered:

1. Getting started with the Maxon App
   
   • 1a) Downloading and Installing the Maxon App
   • 1b) Uninstalling the Maxon App
   • 1c) Logging in and out of your account
   • 1d) Listing your licenses
   • 1e) Activating and deactivating your licenses
   • 1f) Trial licenses
2. Technical support
   • 2a) Submitting a support ticket
   • 2b) Redshift-related license errors
3. Advanced use cases (aimed at technical directors or system administrators)
   • 3a) Verifying that the service is available
   • 3b) Verifying that the service is running
   • 3c) Licensing Workflows
   • 3d) Listing your products
   • 3e) An overview of all available commands

1. Getting Started with the Maxon App

1a. Downloading and Installing the Maxon App

1. Download the latest version of the Maxon App here for Linux.
2. Install the Maxon App using a Terminal window, and cd to the directory where you downloaded the Maxon App installer in the previous step.
   • Alternatively you can go to that location, right-click, and select 'Open in Terminal'. 
     
3. In the terminal run
   sudo sh Maxon_App_2023.1.1_linux.sh --target /opt/maxon
   
   
   

1b. Uninstalling the Maxon App

1. Go to this file path:

   /opt/maxon/maxon_app/bin/

   In there you will find the uninstall_maxon_app.sh file.
2. Run the uninstall command with:

   sudo sh uninstall_maxon_app.sh

   Example:

   

1c. Logging in and Out of Your Account

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

1. First, go to the following path where you can find the mx1 file:

   /opt/maxon/maxon_app/bin

2. In there you will be able to use mx1. You can use mx1 in order to log in.
   
   ./mx1 user login -u myemail@domain.com Enter password: mypassword
3. To log out, you can use the following command:
   ./mx1 user logout

1d. Listing your licenses

You are able to use mx1 to activate your license. This step is not required if you only have one license. Logging in to your Maxon account would be sufficient in that case.

However if you want to choose between different licenses, or if you want to deactivate your license on machine A, in order to activate it on machine B. In cases like that this step is required.

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 the validity period. For example:

1e. Activating and Deactivating specific licenses

To activate a license run 

./mx1 license assign <license_identifier>

For example:

./mx1 license assign net.maxon.license.app.bundle_maxonone~trial

This will result in: Successfully assigned a license for whatever identifier you selected.

Assign example:

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

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

Release example:

1f. Trial licenses

1. Trial licenses are started with the following command
   ./mx1 license trial start
2. Once it's been started, you'll need to use another command to refresh the account:
   ./mx1 user refresh

2) Technical support

If you are experiencing issues with the Maxon app, please first 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 the method shown above)
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"

• 2a) Requesting technical support via a ticket
  You can create a support ticket here.
  • Please make sure to also provide the following two files:
    var/opt/maxon/log/application_support/maxon_one_service/maxon-service.log
    and
    /var/opt/maxon/.service/products.db
• 2b) Redshift license issues
  • If your error is related to any license issue with Redshift, please also provide the latest Redshift log file-- ideally right after getting an error: home/dacosta/redshift/log/log.latest.0/
    
    In there you will find a file called log.html.
    Please make sure to attach that file if your error is related to an issue with Redshift.
    

3) Advanced use cases

This information is mostly for technical directors or system administrators.

3a. Verifying that the service is available

Run:

./mx1 service info

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

However, the service isn't available you'll see this error 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

3b. Verifying that the service is running

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

3c. Licensing Workflows

Licenses are managed with the mx1 command-line tool. By default, the tool is available in:

/opt/maxon/maxon_app/bin

3d. Listing your products

To see the products available for activation in your account, use the following command:

 ./mx1 product list 

For example:

3e. An overview of all 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. 3, If your password has special character on Mac (such as spaces or $), you will need to enclose it in quotes. 4, mx1 cannot log into MyMaxon accounts with SSO or MFA enabled

** use mx1 license list to get the license name

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