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. 求解器使用

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