最新の最適化ソルバー SDK のダウンロードとインストール - Optimization Solver

オペレーティングシステム	仕様
Windows	Windows >= 10
Linux	x86_64 用 Glibc >= 2.14、aarch64 用 >= 2.17
OSX	x86_64 用 OSX >= 11.0、arm64 用 >= 12.0

言語	推奨コンパイラ
C	Visual Studio >= 2019、GCC >= 4.9、Clang++
C++	Visual Studio >= 2019、GCC >= 4.9、Clang++
C#	.NET SDK 8.0 以降
Java	jdk >= 1.8
Python	Anaconda Python 3.6、3.7、3.8、3.9、3.10 (注: linux aarch64 では py3.6 はなく、osx arm64 では py3.6 と py3.7 はありません。)
MATLAB	MATLAB 2021b 以降

変更ログまたは過去のバージョンの SDK パッケージの詳細については、「ソルバー SDK の過去のバージョン」をご参照ください。

次のセクションでは、最新の最適化ソルバー SDK をインストールする方法について説明します。ビデオの手順に従ってインストールすることもできます。

ステップ 2: 最適化ソルバー SDK をインストールする (C、C++、C#、および MATLAB API がサポートされています)

重要

最適化ソルバー SDK をインストールする前に、以前の最適化ソルバー SDK をクリアまたはバックアップしてください。詳細については、このトピックの「1 つ以上の最適化ソルバー SDK バージョンのアンインストールと再インストール」セクションをご参照ください。
Java API と Python API をインストールする前に、このステップ 2 を完了する必要があります。詳細については、このトピックのステップ 5 とステップ 6 をご参照ください。

Windows オペレーティングシステム:

SDK インストールパッケージをダブルクリックし、プロンプトに従って SDK をインストールします。

すべてのユーザーに対して SDK をインストールする場合は、管理者としてインストールパッケージを実行します。インストール方法: 管理者としてコマンドプロンプトを実行し、インストールパッケージが存在するフォルダに切り替えてから、インストールパッケージファイルを実行します。

Linux オペレーティングシステム:

システムコマンドラインで次のコマンドを実行し、プロンプトに従って SDK をインストールします。

bash mindopt-install-linux64x86-2.0.0.sh

または ARM バージョン:

bash mindopt-install-linux64aarch-2.0.0.sh

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

# この例では、管理者ユーザーが使用されています。
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-2.0.0.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-2.0.0.sh

# 最適化ソルバーの環境変数を設定します。
ENV MINDOPT_HOME /home/admin/mindopt/2.0.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:${PATH}
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH

macOS オペレーティングシステム:

macOS オペレーティングシステム用 SDK のインストール方法は、Linux オペレーティングシステム用 SDK のインストール方法と同じです。システムコマンドラインで次のコマンドを実行し、プロンプトに従って SDK をインストールします。

bash mindopt-install-osx64x86-2.0.0.sh

または Apple Silicon の場合:

bash mindopt-install-osx64aarch-2.0.0.sh

次の図は、最適化ソルバー SDK がインストールされた後のファイルディレクトリ構造を示しています。ファイルディレクトリ構造には以下が含まれます。

1.1.0 ルートフォルダ。「1.1.0」は最適化ソルバー SDK のバージョンを示します。mindopt ディレクトリには、複数の最適化ソルバー SDK バージョンを同時にインストールできます。
osx64-x86 フォルダ。実行可能ファイル、ダイナミックライブラリ、その他のデータはこのフォルダに保存されます。このフォルダには、異なるオペレーティングシステムに対応する次の名前が付いています: win64-x86、linux64-x86、osx64-x86、linux64-aarch、osx64-aarch。フォルダの名前を使用して、目的の最適化ソルバー SDK バージョンがインストールされているかどうかを確認できます。
examples フォルダ。このフォルダに注意してください。プログラミング言語とモデリングツールのさまざまなサンプルコードまたはデータがこのフォルダに保存されています。これは、最適化ソルバーをすぐに理解するのに役立ちます。
docs フォルダ。ユーザーに最適化ソルバーの使用を指示するための Readme.txt ファイルとエンドユーザーライセンス契約 (EULA) がこのフォルダに保存されています。
fl_client.ini ファイル: 作成する必要があるライセンスファイル。次のセクションでは、ライセンスファイルについて説明します。

image..png

ステップ 3: 環境変数を確認し、最適化ソルバーの実行をテストする

最適化ソルバー SDK をインストールするときに構成された環境変数を確認します。複数の最適化ソルバー SDK バージョンがインストールされている場合は、ビジネス要件に基づいて有効な SDK バージョンを変更する必要があります。

Windows オペレーティングシステム:

MINDOPT_HOME および Path という名前の環境変数は、最適化ソルバー SDK をインストールすると自動的に追加されます。手動で追加する必要はありません。複数の最適化ソルバー SDK バージョンがインストールされている場合は、次の図に示すように、MINDOPT_HOME 環境変数の設定を変更することで、有効な SDK バージョンを変更する必要があります。

箭头去除1.png

Linux および macOS オペレーティングシステム:

source ~/.mdo_profile コマンドは、最適化ソルバー SDK をインストールするときに ~/.bashrc ファイルと ~/.zshrc ファイルに追加されます。最適化ソルバー SDK をインストールした後、端末コマンドラインを再起動して、環境変数を有効にします。複数の最適化ソルバー SDK バージョンがインストールされている場合は、nano ~/.mdo_profile コマンドを実行して環境変数の設定を変更します。

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

source ~/.mdo_profile
cat ~/.mdo_profile

Docker コンテナに SDK をインストールする場合は、export コマンドを実行して環境変数を表示します。

環境変数を確認した後、コマンドラインに mindopt と入力して、最適化ソルバー SDK がインストールされているかどうかを確認します。次の図は例を示しています。

最適化ソルバーの実行エラーとトラブルシューティング:

最適化ソルバーを実行できない場合、考えられる原因は、オペレーティングシステムで実行可能ファイルの実行がサポートされていないことです。次のコマンドのいずれかを実行して、実行可能ファイルの権限を変更できます。

Linux オペレーティングシステム:

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

macOS オペレーティングシステム:

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

開発者のソフトウェアがセキュリティ検証に合格しないため、一部のオペレーティングシステムでは Optimization Solver の実行が拒否される場合があります。たとえば、この問題が macOS オペレーティングシステムで発生した場合、[セキュリティとプライバシー] ダイアログボックスで [許可] をクリックすると、この問題を解決できます。詳細については、「インストール」セクションの FAQ トピックをご参照ください。

ステップ 4: ライセンスファイルを設定する

解決機能を使用する場合は、ライセンスファイルを設定する必要があります。最適化ソルバーは、次の認証方式をサポートしています。

1. クラウドベース認証: Alibaba Cloud ユーザーは、「サービスのアクティブ化と使用」トピックの「3. Alibaba Cloud のライセンスキーを使用して認証する」セクションの手順に従ってライセンスキーを取得し、fl_client.ini ライセンスファイルを設定できます。次に、ライセンスファイルを次の推奨ディレクトリに配置します。
このライセンスは Alibaba Cloud アカウントにバインドされています。最適化ソルバーを使用して、コンピュータの問題を解決できます。インターネットへの接続は認証のためだけであり、他の情報や問題データをアップロードする必要はありません。
この認証方式のメリット:
- ユーザーは自分でライセンスキーを申請できます。ライセンスキーを申請すると、ライセンスキーはすぐに発行されます。
- 1 つのライセンスキーを複数のコンピュータで同時に使用できます。
- このライセンスの有効期限が切れそうになると、Alibaba Cloud からショートメッセージ通知が届きます。その後、最適化ソルバーコンソール Web ページでライセンスを更新できます。ライセンスファイルを変更する必要はありません。

2. ローカル認証: インターネットに接続していない場合は、mindopt.lic ファイルを使用してローカル認証を行うことができます。mindopt.lic ファイルは、指定されたマシン ID にバインドされています。mindopt.lic ファイルは、マシン ID を使用して生成されます。インターネットに接続しておらず、ローカル認証が必要な場合は、お問い合わせいただいて mindopt.lic ファイルを申請してください。

注:

認証中に、最適化ソルバーは環境変数の設定に基づいてライセンスファイルを自動的に検索します。最初は mindopt.lic ファイル、次に fl_client.ini ファイルです。ライセンスファイルが見つかると、最適化ソルバーはファイルの有効性を検証します。

最適化ソルバー SDK V0.20.x 以降では、300 変数と 300 制約未満を含む最適化問題を解決するためにライセンスファイルは必要ありません。mindopt.lic または fl_client.ini ライセンスファイルの検証に失敗した場合、認証不要ロジックが使用されます。
ライセンスファイルの名前は固定されており、変更できません。

ライセンスファイルのパス:

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

次のサンプルコードは、Linux および macOS オペレーティングシステムで環境変数を設定する方法を示しています。環境変数ファイルの変更方法の詳細については、このトピックのステップ 3 をご参照ください。

export MINDOPT_LICENSE_PATH=$HOME/mindopt

次の図は、Windows オペレーティングシステムで環境変数を設定する方法を示しています。詳細については、ライセンス設定をご参照ください。

Set environment variables

環境変数が設定されていない場合、最適化ソルバーはデフォルトで {ユーザーのルートディレクトリ}\mindopt ディレクトリにある fl_client.ini または mindopt.lic ライセンスファイルを検索します。
- たとえば、Windows オペレーティングシステムで管理者として最適化ソルバーにログインした場合、fl_client.ini ライセンスファイルは C:\Users\Administrator\mindopt\fl_client.ini ディレクトリに保存されます。
- たとえば、fl_client.ini ライセンスファイルは、Linux オペレーティングシステムの ~/mindopt/fl_client.ini ディレクトリに保存されます。

(オプション) ステップ 5: Java API をインストールする

フォルダ <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar に .jar ファイルがあります。

ユーザーは pom.xml ファイルを編集することで使用できます。たとえば、osx64-x86 では次のようになります。

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

(オプション) ステップ 6: Python API をインストールする

重要

バージョン V0.24.1 以降、Python ユーザーは pip install mindoptpy で MindOpt Python パッケージをインストールできます。特定のライセンスが含まれており、2023/01/01 から 2024/12/31 まで有効です。

このインストール方法は「mindoptpy」ライブラリのみをサポートし、コマンドラインなどの他の機能はサポートしていません。他の機能が必要な場合は、ステップ 1 とステップ 2 を参照して完全なインストールを行ってください。

ステップ 2 でパッケージをインストールした後、次のコマンドを実行して Python API をインストールできます。

python <MDOHOME>/<VERSION>/<PLATFORM>/lib/python/setup.py install
# 次に、他の依存関係である numpy と scipy をインストールします
pip install numpy scipy

Windows オペレーティングシステムのコマンド:

python %MINDOPT_HOME%\win64-x86\lib\python\setup.py install

Linux オペレーティングシステムのコマンド:

python $MINDOPT_HOME/linux64-x86/lib/python/setup.py install

macOS オペレーティングシステムのコマンド:

python $MINDOPT_HOME/osx64-x86/lib/python/setup.py install

説明

最適化ソルバーは Python 3.6 以降をサポートしています。提供されているサンプルコードを Python 3.8 以降で実行すると、mindoptpy ファイルが見つからないというプロンプトが表示される場合があります。解決策とインストール手順の詳細については、MindOpt ユーザーマニュアルをご参照ください。

最適化ソルバーを使用する

初心者の方は、「サービスのアクティブ化と使用」トピックの「4. 問題解決のクイックサンプル」セクションの手順に従って最適化ソルバーを使い始めることをお勧めします。詳細については、「最適化ソルバーのユーザーマニュアル」をご参照ください。

1 つ以上の最適化ソルバー SDK バージョンのアンインストールと再インストール

1 つ以上の最適化ソルバー SDK バージョンのアンインストール

Windows オペレーティングシステム:

[コントロールパネル] を開き、[プログラム] > [プログラムと機能] を選択します。MindOpt Optimization Solver SDK を見つけて右クリックし、[アンインストール] をクリックします。複数の最適化ソルバー SDK バージョンを同時にインストールし、異なるフォルダに配置できます。複数の最適化ソルバー SDK バージョンがインストールされている場合は、1 つずつアンインストールしてください。最適化ソルバー SDK をインストールすると自動的に追加される MINDOPT_HOME および Path という名前の環境変数は、アンインストールすると削除されます。

管理者として最適化ソルバー SDK をインストールし、上記の手順を実行して最適化ソルバー SDK をアンインストールした場合、ソルバーには環境変数の設定を変更する権限がありません。この場合、環境変数を手動で削除するか、管理者としてインストールパッケージを実行して最適化ソルバー SDK をアンインストールできます。

Linux および macOS オペレーティングシステム:

1 つ以上の最適化ソルバー SDK バージョンをアンインストールするには、関連ファイルを削除するだけです。

インストールディレクトリを見つけます。例: インストール中に指定した $HOME/mindopt。
環境変数の設定を変更します。たとえば、~/.bashrc ファイルまたは ~/.zshrc ファイルに含まれる設定を変更するか、~/.mdo_profile ファイルを削除します。

Python API のアンインストール: SDK インストールパッケージに含まれる setup.py ファイルの手順に従って、pip3 uninstall mindoptpy などの不要なコンポーネントをアンインストールします。

説明

後で 1 つ以上の最適化ソルバー SDK バージョンをインストールする必要がある場合は、最適化ソルバーライセンスファイルをバックアップするか、最適化ソルバーライセンスファイルを削除しないでください。ライセンスファイルのパスは $HOME/mindopt および C:\Users\Administrator\mindopt です。

いくつかのサンプル解決コマンドを実行した後、.bas ファイルと .sol 結果ファイルが生成されます。インストールディレクトリに移動して、結果ファイルを削除できます。

1 つ以上の最適化ソルバー SDK バージョンの再インストール

複数の最適化ソルバー SDK バージョンを同時にインストールし、異なるフォルダに配置できます。使用する最適化ソルバー SDK に基づいて環境変数を設定する必要があります。ライセンスファイルを変更する必要はありません。

Windows オペレーティングシステム:

.exe ファイルをダブルクリックして、最適化ソルバー SDK を再インストールします。新しい環境変数の設定は、既存の環境変数の設定を上書きします。複数の最適化ソルバー SDK バージョンが再インストールされると、複数のバージョンフォルダが表示されます。この場合、MINDOPT_HOME 環境変数の設定を変更することで、有効な SDK バージョンを変更する必要があります。

Linux および macOS オペレーティングシステム:

上記の手順を実行して、1 つ以上の最適化ソルバー SDK バージョンを再インストールします。次に、最適化ソルバーの環境変数の設定を変更します。たとえば、~/.bashrc ファイル、~/.zshrc ファイル、または参照されている ~/.mdo_profile ファイルに含まれる設定を変更します。

重要

1 つ以上の最適化ソルバー SDK バージョンを再インストールした後、CLI を再起動して環境変数を有効にする必要があります。