Optimization Solver：求解器SDK下載和安裝

1. 下載最新版

V0.x版本和V1.x版本的API大部分都不一樣，使用時請注意查看對應版本的API文檔。

當前最新版本：V2.0.0 發布時間：2024.11.04

修改記錄詳情、歷史版本下載，請查看歷史版本下載。

使用上面軟體包的環境依賴是：

下文將描述安裝方式，也可查閱視頻總覽的視頻來學習。

2. 安裝：基礎安裝，能支援C、C++、C#、MATLAB介面APIs

Windows系統：

雙擊安裝檔案，根據指引安裝。

安裝時，如果需要為所有使用者安裝，需要以管理員身份運行安裝包。方式為：先以管理員身份運行“命令提示字元”，然後目錄切換到安裝包所在檔案夾，執行安裝包檔案。

Linux系統：

系統命令列中輸入如下指令，根據指引進行安裝：

bash mindopt-install-linux64x86-2.0.0.sh

或者ARM晶片版本：

bash mindopt-install-linux64aarch-2.0.0.sh

如果是在docker中安裝，dockerfile增加配置如下：

# 以 admin 使用者為例
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

# 設定 mindopt 環境變數
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

V0.x.x版本的Docker安裝最後還需要加：

# 使用 JAVA SDK 時需要增設 MDO_NATIVE_LIBRARY 環境變數, 1.0.0 及後續版本不再需要
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS系統：

同Linux系統，系統命令列中輸入如下指令，根據指引進行安裝：

bash mindopt-install-osx64x86-2.0.0.sh

或者Apple Silicon晶片版本：

bash mindopt-install-osx64aarch-2.0.0.sh

求解器安裝完成後，安裝檔案目錄結構如下圖示意，會包含：

• 2.0.0總檔案夾，代表不同的軟體版本號碼，請以自己實際安裝版本為準。可以支援多版本同時存在，都安裝在mindopt目錄，比如下圖的0.25.1是舊版本。

• osx64-x86子檔案夾，裡面是可執行檔、動態庫等。這個檔案夾名稱有5種，對應不同系統版本：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系統：

安裝時在~/.bashrc和~/.zshrc檔案中添加了指令source ~/.mdo_profile，安裝完成後重啟終端命令列會生效。安裝多版本時，可執行nano ~/.mdo_profile來修改。

現在您可執行如下指令查看和立即生效環境變數：

source ~/.mdo_profile
cat ~/.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可在安全性與隱私可點擊仍然允許。如下圖所示。更多異常可查詢常見問題FAQ中安裝問題。

4. 配置鑒權檔案

使用求解功能的時候，需要配置授權檔案。MindOpt支援兩種鑒權方式：

• 1. 雲鑒權：阿里雲使用者請根據3. 配置阿里雲鑒權帳號來擷取授權LicenseKey和配置授權檔案fl_client.ini，然後把此檔案放置在下文建議的位置。

  • 此License與阿里雲帳號綁定，求解時使用者本地求解，連網僅鑒權，不上傳其他資訊。

  • 此鑒權方式的好處：

    • 使用者可自助申請，立即發放LicenseKey；

    • 一次申請多個電腦可以使用；

    • 快到期的時候會收到簡訊提醒，屆時在控制台網頁上點續期就行，無需更換License檔案。

• 2. 不連網：線下不連網版本採用的是mindopt.lic檔案，是本地鑒權作用，與機器ID綁定。

  • 2024年起，支援在控制台採購“不連網單機不限並發”的本地鑒權License，參考不連網固定機器授權版的“機器指紋”擷取方式。

說明：

• 鑒權時，軟體會根據環境變數設定，自動先找檔案mindopt.lic再找檔案fl_client.ini，然後驗證該檔案有效性。V0.20.x版本後，鑒權檔案驗證失敗後，會再調用不需要License的不超過300大小的問題求解許可權。

• 授權檔案的名稱是固定的，不能改變。

鑒權檔案置放位置：

• （推薦）可以設定環境變數MINDOPT_LICENSE_PATH 來定義鑒權檔案放置的位置。

Linux和macOS系統的環境變數新增內容樣本如下（環境變數檔案修改方式同上文）：

export MINDOPT_LICENSE_PATH=$HOME/mindopt

下圖是Windows添加的樣本，更多可參考配置環境變數。

• 在不設定環境變數時，MindOpt預設在 {使用者根目錄}\mindopt 下尋找該檔案。

  • 例如Windows當前登入使用者為Administrator ，則設定檔路徑應為C:\Users\Administrator\mindopt\fl_client.ini。

  • 例如Linux，設定檔路徑應為~/mindopt/fl_client.ini。

5.（可選）安裝Java支援

V1.x.x

相比V0版本，V1版本直接在安裝包中放置 .jar 包：<MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar，不需要引入Maven依賴 。

使用時候，在 pom.xml 直接引入此檔案，以 macOS Intel 版本為例：

<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

Java支援無需安裝，可以直接引入Maven依賴。注意：前序安裝動作依然需要，java需要依賴已經安裝的求解器動態連結程式庫檔案。Maven Dependency：

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

6.（可選）安裝Python支援

安裝了單機版安裝包後，Python庫安裝的主要指令是：

python <MDOHOME>/<VERSION>/<PLATFORM>/lib/python/setup.py install

# 1.0.0 及後續版本需要額外安裝 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

ARM的版本安裝包注意修改地址。

7. 卸載和重裝

8. 求解器使用

新手建議根據快速入門文檔的一個快速求解的例子來快速上手，更多的使用說明見求解器使用者手冊。