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

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

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

Windows

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

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

Linux

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

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

# x86_64 システム
bash mindopt-install-linux64x86-2.3.0.sh

# ARM (aarch64) システム
bash mindopt-install-linux64aarch-2.3.0.sh

# admin ユーザーを例として使用します。
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

# MindOpt の環境変数を設定します。
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 は V0.x.x の Java SDK に必要です。V1.0.0 以降では不要です。
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS

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

# Intel (x86_64) システム
bash mindopt-install-osx64x86-2.3.0.sh

# Apple シリコン (arm64) システム
bash mindopt-install-osx64aarch-2.3.0.sh

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

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

環境変数の確認

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

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

再起動せずにすぐに適用するには、次のようにします。

cat ~/.mdo_profile   # 現在の設定を表示
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 は、開発元のセキュリティチェックにより、バイナリの実行をブロックすることがあります。[セキュリティとプライバシー] で [このまま許可] をクリックします。

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

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

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

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

2024年より、コンソールで、オフラインのスタンドアロンモード用のローカル認証ライセンス (同時実行数無制限) を取得できるようになる予定です。詳細については、「ネットワークに接続されていない単一マシン向けの無制限同時実行ライセンス用のマシンフィンガープリントの取得」をご参照ください。

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

推奨： 環境変数 MINDOPT_LICENSE_PATH を、ライセンスファイルが含まれるフォルダーに設定してください。

Linux および macOS：

export MINDOPT_LICENSE_PATH=$HOME/mindopt

Windows — システムのプロパティで環境変数を設定してください。

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

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

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

次の Maven 依存関係を pom.xml に追加してください。classifier をお使いのプラットフォームに合わせて設定してください。

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.3.0</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

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

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.3.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 のバージョンパスを更新してください。