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

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

言語とコンパイラのバージョン

Windows

.msi インストールファイルをダブルクリックし、画面の指示に従ってください。

すべてのユーザー向けにインストールするには、コマンドプロンプトを管理者として実行し、インストーラーを含むフォルダに移動して、そこからファイルを起動します。

Linux

お使いのアーキテクチャが不明な場合は、uname -m を実行してください。x86_64 と出力された場合は x86 インストーラーを、aarch64 と出力された場合は ARM インストーラーを使用します。

次のコマンドを実行し、プロンプトに従ってください。

mindopt

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

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

# MDO_NATIVE_LIBRARY is required for the Java SDK in V0.x.x. Not needed for V1.0.0 or later.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS

次のコマンドを実行し、プロンプトに従ってください。

# Intel (x86_64) systems
bash mindopt-install-osx64x86-2.3.0.sh

# Apple Silicon (arm64) systems
bash mindopt-install-osx64aarch-2.3.0.sh

インストール後のディレクトリ構造

インストーラーが完了すると、インストールディレクトリには以下が含まれます。

環境変数の確認

Windows: インストーラーは MINDOPT_HOME と Path を自動的に追加します。インストールされているバージョンを切り替えるには、MINDOPT_HOME の値を更新します。

Linux および macOS: インストーラーは source ~/.mdo_profile を ~/.bashrc と ~/.zshrc に追加します。変更はターミナルを再起動すると有効になります。

再起動せずにすぐに適用するには:

cat ~/.mdo_profile   # view the current settings
source ~/.mdo_profile

インストールされているバージョンを切り替えるには、~/.mdo_profile を直接編集します。

nano ~/.mdo_profile

Docker コンテナでは、export を使用して変数をチェックします。

クイックテストの実行

環境変数をロードした後、コマンドラインで mindopt を実行します。

mindopt

インストールが成功すると、ここに表示されている出力と同様に、バージョンと使用状況の情報がターミナルに出力されます。

トラブルシューティング

権限エラー： mindopt の実行に失敗した場合、実行権限を修正してください。

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

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

macOS のセキュリティブロック： macOS では、開発者のセキュリティチェックにより、バイナリの実行が妨げられる場合があります。 [セキュリティとプライバシー] で [このまま許可] をクリックします。

その他の問題については、「よくある質問」の「インストールに関する問題」セクションをご参照ください。

オプション 1: クラウド認証 (推奨)

認証用の Alibaba Cloud アカウントを構成 の手順に従って、ライセンスキーを取得し、fl_client.ini ライセンスファイルを作成します。ソルバーはご利用のマシンでローカルに実行されます。インターネット接続は認証時にのみ必要であり、他の情報はアップロードされません。

オプション 2: オフライン認証

2024 年より、コンソール からローカル認証ライセンスを購入してください。ライセンスはマシンフィンガープリント (マシン ID) に紐付けられ、オフライン、シングルマシン、無制限の同時使用をサポートします。マシンフィンガープリントの取得手順については、コンソールオフライン固定マシンライセンスのマシンフィンガープリントを取得する方法 をご参照ください。

ライセンスファイルの場所を設定

推奨: MINDOPT_LICENSE_PATH 環境変数を、ライセンスファイルを含むフォルダに設定します。

Linux および macOS:

export MINDOPT_LICENSE_PATH=$HOME/mindopt

Windows — システムプロパティで環境変数を設定:

詳細については、「ライセンス構成」をご参照ください。

デフォルトの場所 (MINDOPT_LICENSE_PATH が設定されていない場合):

V2.1 以降 — Maven 依存関係 (推奨)

次の依存関係を pom.xml に追加します。classifier をご利用のプラットフォームに合わせて設定します。

<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 -->
  <!-- すべてのプラットフォーム: portable -->
  <type>jar</type>
</dependency>

V1.0 以降 — 組み込み JAR

インストールパッケージには、mindoptj.jar が <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar に含まれています。pom.xml で直接参照します。

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

V0.x.x — Maven 依存関係

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

アンインストール

Windows: [コントロールパネル] > [プログラムと機能] に移動し、MindOpt バージョンを見つけて右クリックし、アンインストールします。インストール済みバージョンはそれぞれ個別のエントリとして表示されます。管理者としてインストールした場合、アンインストーラーには MINDOPT_HOME および Path 環境変数を削除する権限がない場合があります。その場合は、手動で削除するか、管理者としてアンインストーラーを実行してください。

Linux および macOS:

1. インストールディレクトリ (例: $HOME/mindopt) を削除します。

2. ~/.bashrc および ~/.zshrc から source ~/.mdo_profile の行を削除し、その後 ~/.mdo_profile を削除します。

Python API:

pip3 uninstall mindoptpy

後で再インストールする予定がある場合は、インストールディレクトリを削除する前にライセンスファイルをバックアップしてください。デフォルトのライセンス場所: $HOME/mindopt (Linux/macOS) および C:\Users\<username>\mindopt (Windows)。サンプルコマンドを実行すると、インストールディレクトリに .bas および .sol の結果ファイルが生成される場合があります。これらは必要に応じて削除してください。

再インストール

複数の SDK バージョンは個別のフォルダに共存できます。使用したいバージョンの環境変数を設定してください。ライセンスファイルの変更は不要です。

Windows: インストーラーをダブルクリックします。新しい環境変数設定は以前の設定を上書きします。バージョンを切り替えるには、MINDOPT_HOME 環境変数のディレクトリを更新してください。

Linux および macOS: 上記のインストール手順に従ってください。その後、~/.mdo_profile または ~/.bashrc/~/.zshrc でバージョンパスを更新してください。