Optimization Solver:Optimization Solver SDK のダウンロードとインストール

1. 最新バージョンのダウンロード

V0.x と V2.x のアプリケーションプログラミングインターフェース (API) は、ほとんどが異なります。SDK を使用する際は、対応するバージョンの API ドキュメントをご参照ください。

最新バージョン： V2.2.0。リリース日： 2025-08-07。

変更履歴と以前のバージョンのダウンロードについては、「ダウンロード履歴」をご参照ください。

上記のパッケージの環境要件は次のとおりです。

以降のセクションでは、SDK のインストール方法について説明します。「ビデオ概要」のビデオもご覧いただけます。

2. SDK のインストール (C、C++、C#、MATLAB API)

Windows システム：

インストールファイルをダブルクリックし、指示に従います。

すべてのユーザーにインストールするには、インストールパッケージを管理者として実行します。これを行うには、コマンドプロンプトを管理者として実行し、インストールパッケージが含まれるフォルダに切り替えてから、パッケージファイルを実行します。

Linux システム：

コマンドラインで、次のコマンドを実行し、指示に従います。

bash mindopt-install-linux64x86-2.2.0.sh

または、ARM チップバージョンの場合：

bash mindopt-install-linux64aarch-2.2.0.sh

Docker コンテナにインストールする場合は、Dockerfile に次の構成を追加します。

# The admin user is used as an example.
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-2.2.0.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-2.2.0.sh

# Set the mindopt environment variables.
ENV MINDOPT_HOME /home/admin/mindopt/2.2.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH

V0.x.x の Docker インストールの場合、以下も追加します。

# The MDO_NATIVE_LIBRARY environment variable is required when you use the Java SDK. This is not needed for version 1.0.0 or later.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS システム：

プロセスは Linux と同じです。コマンドラインで、次のコマンドを実行し、指示に従います。

bash mindopt-install-osx64x86-2.2.0.sh

または、Apple Silicon チップバージョンの場合：

bash mindopt-install-osx64aarch-2.2.0.sh

ソルバーのインストール後、ディレクトリ構造は次のようになります。

• 2.2.0 ルートフォルダ。名前はインストールしたソフトウェアのバージョンを示します。mindopt ディレクトリには複数のバージョンをインストールできます。たとえば、図の 0.25.1 はレガシーバージョンです。

• osx64-x86 サブフォルダ。このフォルダには、実行可能ファイル、ダイナミックリンクライブラリ、およびその他の関連ファイルが含まれています。フォルダ名はオペレーティングシステムとアーキテクチャによって異なります： win64-x86、linux64-x86、osx64-x86、linux64-aarch、または osx64-aarch。これにより、正しいバージョンをインストールしたかどうかを確認できます。

• examples フォルダ。このフォルダをご確認ください。複数のプログラミング言語、モデリングツール、および data フォルダ内のサンプル入力データが含まれており、すぐに使い始めるのに役立ちます。

• docs フォルダには、Readme.txt ファイル、エンドユーザーライセンス契約 (EULA)、およびその他のドキュメントが含まれています。

• fl_client.ini ファイルは、作成する必要がある認証ファイルです。これについては後で説明します。

  

3. 環境変数の確認とテストの実行

インストールプロセスにより、必要な環境変数が設定されます。正しく設定されていることを確認してください。複数のバージョンをインストールしている場合は、環境変数のバージョン番号を変更することで、バージョンを切り替えることができます。

Windows システム：

MINDOPT_HOME および Path 環境変数は、インストール時に自動的に追加されます。手動で追加する必要はありません。複数のバージョンをインストールした場合、MINDOPT_HOME 変数を変更することでアクティブなバージョンを変更できます。次の図に例を示します。

Linux および macOS システム：

インストールにより、コマンド `source ~/.mdo_profile` が ~/.bashrc および ~/.zshrc ファイルに追加されます。変更は、ターミナルを再起動した後に有効になります。複数のバージョンをインストールした場合は、nano ~/.mdo_profile を実行して変更を加えます。

次のコマンドを実行して、環境変数を表示し、すぐに適用します。

cat ~/.mdo_profile
source ~/.mdo_profile

Docker コンテナにインストールした場合は、export コマンドを使用して変数を確認できます。

環境変数を確認した後、コマンドラインで `mindopt` を実行してインストールを検証します。次の図に例を示します。

実行時の一般的な失敗の解決策：

コマンドが失敗した場合、原因は権限の問題である可能性が高いです。次のように実行可能ファイルの権限を変更できます。

Linux：

chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt

macOS：

chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt

一部のシステムでは、開発者のセキュリティチェックにより `mindopt` の実行が妨げられる場合があります。たとえば macOS では、[セキュリティとプライバシー] で [このまま許可] をクリックできます。その他の問題の詳細については、「よくある質問」の「インストールの問題」セクションをご参照ください。

4. 認証ファイルの設定

ソルバーを使用するには、ライセンスファイルを設定する必要があります。MindOpt は 2 つの認証方式をサポートしています。

• 1. クラウド認証： Alibaba Cloud ユーザーの場合は、「3. 認証のための Alibaba Cloud アカウントの設定」の指示に従ってライセンスキーを取得し、fl_client.ini ライセンスファイルを設定します。その後、このファイルを後述の推奨される場所のいずれかに配置します。

  • このライセンスは、ご利用の Alibaba Cloud アカウントにアタッチされます。ソルバーはご利用のマシン上でローカルに実行されます。インターネット接続は認証にのみ必要です。その他の情報がアップロードされることはありません。

  • このメソッドの利点：

    • ライセンスキーはご自身でリクエストでき、即座に発行されます。

    • 1 つのライセンスキーを複数のコンピュータで使用できます。

    • ライセンスの有効期限が切れる前に、ショートメッセージでリマインダーが届きます。その後、ライセンスファイルを変更することなく、コンソールのウェブページで更新できます。

• 2. オフライン認証： オフラインでの使用のために、MindOpt はローカル認証に mindopt.lic ファイルを使用します。このファイルはマシン ID にアタッチされます。

  • 2024年以降、オフライン、単一マシン、無制限の同時使用を許可するローカル認証ライセンスをコンソールから購入できます。詳細については、「オフライン固定マシンライセンスのマシンの指紋を取得する方法」をご参照ください。

注：

• 認証中、ソフトウェアはまず mindopt.lic ファイルを検索し、次に環境変数の設定に基づいて fl_client.ini ファイルを検索します。その後、最初に見つかったファイルを検証します。

• ライセンスファイルの名前は固定されており、変更できません。

認証ファイルの場所：

• (推奨) MINDOPT_LICENSE_PATH 環境変数を設定して、ライセンスファイルの場所を定義します。

次の例は、Linux および macOS システムに環境変数を追加する方法を示しています。環境変数ファイルの変更方法は前述のとおりです。

export MINDOPT_LICENSE_PATH=$HOME/mindopt

次の図は Windows の例です。詳細については、「ライセンス設定」をご参照ください。

• この環境変数が設定されていない場合、MindOpt はデフォルトで {user_root_directory}\mindopt フォルダ内のファイルを検索します。

  • たとえば、Windows の現在のユーザーが Administrator の場合、パスは C:\Users\Administrator\mindopt\fl_client.ini です。

  • たとえば、Linux の場合、パスは ~/mindopt/fl_client.ini です。

5. (オプション) Java サポートのインストール

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.1.0-SNAPSHOT</version>
  <classifier>osx-x64</classifier>
  <!-- macOS arm64  : osx-aarch -->
  <!-- linux arm64  : linux-aarch -->
  <!-- linux x86    : linux-x64 -->
  <!-- windows      : win-x64 -->
  <!-- all platforms: portable -->
  <type>jar</type>
</dependency>

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.0.0</version>
  <scope>system</scope>
  <systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>[0.24.0, 1.0.0)</version>
</dependency>

6. (オプション) Python サポートのインストール

Basic Edition パッケージをインストールした後、次のパスに移動し、コマンドを実行して Python SDK をインストールします。

cd <MDOHOME>/<VERSION>/<PLATFORM>/lib/python
pip install .

7. アンインストールと再インストール

8. ソルバーの使用

新規ユーザーの場合は、クイックスタートドキュメントの「問題解決のクイックサンプル」に従って開始できます。詳細については、「ソルバーユーザーマニュアル」をご参照ください。