Topics covered:

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

1) Getting started with the Maxon App on Linux

a) Downloading the Maxon App

Go to https://www.maxon.net/try and download the Linux version of the Maxon App. That will download a file called Maxon_App_2023.1.1_Linux.sh. 

b) Installing the Maxon App

Open a terminal window, and cd to the directory where you downloaded the Maxon app Maxon_App_2023.1.1_Linux.sh.

Alternatively, you can go to that location, right-click, and select 'Open in Terminal'. 

For example:

Then in the terminal run

sudo sh Maxon_App_2023.1.1_linux.sh --target /opt/maxon

Example:

c) Uninstalling the Maxon App

In order to uninstall the Maxon app, you can run the following command:

First, go to the following path:

/opt/maxon/maxon_app/bin/

In there you will find a uninstall_maxon_app.sh file.

sudo sh uninstall_maxon_app.sh

Example:

d) Logging in and out of your account

To log in, you'll need your email and password used for your Maxon account.
First, go to the following path where you can find the mx1 file:

/opt/maxon/maxon_app/bin/

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

To log out, you can use the following command:

./mx1 user logout

e) 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:

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:

Trial licenses

Trial licenses are started with the following command

./mx1 license trial start

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"

a) Requesting technical support via a ticket

If your license not working as expected and you require technical support. You can create a support ticket here:

https://support.maxon.net/hc/en-us/requests/new

If you decide to ask for help by submitting a support ticket for an issue related to your license on Linux. Please make sure to also provide the following:

Please provide the following two files:

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

As well as the database file located at:

/var/opt/maxon/.service/products.db

b) A Redshift license issue

If your error is related to any license issue with Redshift, in that case, please also provide the latest Redshift log file. (ideally right after getting an error) On Linux, you will be able to locate the Redshift log file here:

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
(aimed at technical directors or system administrators)

a) 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

b) Verifying that the service is running

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

c) Licensing Workflows

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

/opt/maxon/maxon_app/bin

d) Listing your products

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

 ./mx1 product list 

For example:

e) 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

** use mx1 license list to get the license name

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