3.5. License Setup

To run the standalone version of MindOpt, users must first obtain a valid license.

3.5.1. License Acquisition

MindOpt supports both Commercial License and Community License:

Commercial License

  • Single License: Designed for high-performance servers, this local license has no restrictions on CPU cores or computational resources, and it supports unlimited concurrent usage on a single machine.

  • Floating License: Ideal for complex environments, this license is tied to a server’s MAC address and CPU ID, offering a pool of tokens that can be shared across multiple machines within a local network. Tokens are dynamically allocated to client machines as needed, supporting multi-application and multi-machine deployments.

Community License

  • The first choice for community users, academic users and commercial prototype users, no problem-size limits, no trial period.The community edition license can be applied in the Download Solver.

For single license or private deployment floating licenses, please Contact Us.

3.5.2. License Configuration

MindOpt Licenses can be checked from three different locations, in order:

  • The directory specified by the environment variable MINDOPT_LICENSE_PATH.

  • The path to the mindopt folder in the user’s home directory.

  • The installation directory of MindOpt.

After obtaining the license, please follow the steps below to set the license path, choose any one. It is recommended to place it directly in the installation directory.

Note

  • MINDOPT_LICENSE_PATH specifies a path to a directory name that does not contain a license file name. For example, if the license path is /Users/damo/Downloads/ce_license.ini, MINDOPT_LICENSE_PATH should be configured as /Users/damo/Downloads.

  • Either the single license mindopt.lic or the floating license fl_client.ini or the community license ce_license.ini can activate MindOpt.

  • When over 2 kinds of licenses are available. The priority is mindopt.lic as the highest, fl_client.ini as the second, and ce_license.ini as the lowest.

3.5.3. Windows Platform

Home Directory Path

  • Open the explorer, in order to click System Disk, click Users-> <your_name> to enter the user’s home directory.

  • Create a folder called mindopt in this directory, such as C:UsersAdministratormindopt, and save your license file there.

  • You can also open the command line and execute the following command to create the mindopt folder and copy the license file to your home directory:

    • Community License file ce_license.ini

      mkdir %USERPROFILE%\mindopt
copy <PATH\TO\LICENSE>\ce_license.ini %USERPROFILE%\mindopt\

    • Single License File mindopt.lic

      mkdir %USERPROFILE%\mindopt
copy <PATH\TO\LICENSE>\mindopt.lic %USERPROFILE%\mindopt\

    • Floating License File fl_client.ini

      mkdir %USERPROFILE%\mindopt
copy <PATH\TO\LICENSE>\fl_client.ini %USERPROFILE%\mindopt\

Where <PATH/TO/MY/LICENSE> represents the directory where your license is located.

Environment Variable Path

  • Place the license file in any customized location. Please modify the environment variables according to the following guidelines:

  • Right-click This PC, click Properties -> Advanced System Settings -> Advanced -> Environment Variables.

  • Click New to add an environment variable. Among them, variable name is MINDOPT_LICENSE_PATH, and variable value is the directory where you save the license file.

Installation Path

  • The license file can be placed directly in the installation path of MindOpt, which is at the same level as the 2.1.1 directory.

3.5.4. Linux & macOS Platforms

Home Directory Path

  • Create a folder named mindopt in the $HOME directory and save your license file there.

    • Community License File ce_license.ini

    mkdir ~/mindopt
cp <PATH/TO/LICENSE>/ce_license.ini ~/mindopt/

    • Single License File mindopt.lic

    mkdir ~/mindopt
cp <PATH/TO/LICENSE>/mindopt.lic ~/mindopt/

    • Floating License File fl_client.ini

    mkdir ~/mindopt
cp <PATH/TO/LICENSE>/fl_client.ini ~/mindopt/

Environment Variable Path

  • To place the license file in any customized location, please specify the following environment variables:

export MINDOPT_LICENSE_PATH=<PATH/TO/MY/LICENSE>

Where <PATH/TO/MY/LICENSE> represents the directory where your license is located.

Installation Path

  • The license file can be placed directly in the installation path of MindOpt, which is at the same level as the 2.1.1 directory.

3.5.5. Common Error Codes

Please refer to Common Error Codes to check the error codes that may be returned by the optimization solver.

3.5.6. Frequently Asked Questions

1. What causes a 409 error when using a floating license for authorization, and how can it be resolved?

Normally, the concurrency is automatically released after the program exits normally. However, if the program exits abnormally (e.g., due to a crash), the concurrency will not be automatically released. If a user has purchased one concurrency unit and restarts the solver shortly after an abnormal exit, a 409 error may occur. This is because the number of currently used concurrent licenses has reached the maximum allowed limit, and the current authorization request is rejected due to exceeding the concurrency limit. In such cases, users have the following options:

  • Wait for the un-released concurrency to time out and be automatically released;

  • Log in to the Solver Console, and click the Force Release Authorization Link under the corresponding license entry to manually release the concurrency.