Installing and using the Maxon App on Linux

Netinho Da Costa
Netinho Da Costa
  • Updated

Topics covered:

  1. Getting started with the Maxon App
  2. Technical support
  3. Advanced use cases (aimed at technical directors or system administrators)

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:

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

 

Was this article helpful?

/

Comments

0 comments

Article is closed for comments.