求解器SDK下载和安装
最新版求解器SDK和控制台SDK下载和安装方法。
下载表示您确认已阅读并接受优化求解器的《服务试用条款》协议。
1. 下载最新版
当前最新版本:V0.23.0 发布时间:2022.11.29
2022.12.21新增Apple M1的V0.23.1
linux64-x86 | windows64 | osx64-x86 (Intel) | osx64-aarch (Apple M1) |
文件:mindopt-install-linux-0.23.0.sh | 文件:mindopt-0.23.0.msi | 文件:mindopt-install-osx-0.23.0.sh | 文件:mindopt-install-osx64aarch-0.23.1.sh (此包仅支持LP、QP、SDP,不包含MILP) |
注:当前仅主支持64位的系统、x86架构芯片,ARM芯片的支持正在逐步测试上线。
修改记录详情、历史版本下载,请查看历史版本下载。
下文将描述安装方式,也可查阅视频专区的视频来学习。
2. 安装:基础安装,能支持C、C++接口APIs
安装前,推荐参考7. 卸载和重装来清除或备份之前的版本。
Java和Python的安装需要完成此步骤后,再安装后文的对应支持。
Windows系统:
双击安装文件,根据指引安装。
安装时,如果需要为所有用户安装,需要按住 shift 同时右击安装包,选择“以管理员身份运行”,并在后续取消勾选“Install MindOpt for current user only”。或者以管理员身份运行“命令提示符”,然后目录切换到安装包所在文件夹,执行安装包文件。
Linux系统:
系统命令行中输入如下指令,根据指引进行安装:
bash mindopt-install-linux-0.23.0.sh
如果是在docker中安装,dockerfile增加配置如下:
# 以 admin 用户为例
RUN cd /home/admin/mindopt/ && \
bash mindopt-install-linux-0.23.0.sh --target /home/admin/mindopt && \
rm -rf mindopt-install-linux-0.23.0.sh
# 设置 mindopt 环境变量
ENV MINDOPT_HOME /home/admin/mindopt/0.23.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:${PATH}
# 使用 JAVA SDK 时需要增设 MDO_NATIVE_LIBRARY 环境变量
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.23.0
macOS系统:
同Linux系统,系统命令行中输入如下指令,根据指引进行安装:
bash mindopt-install-osx-0.23.0.sh
或者M1芯片版本:
bash mindopt-install-osx64aarch-0.23.1.sh
求解器安装完成后,安装文件目录结构如下图示意,会包含:
0.23.0
根文件夹,代表不同的软件版本号,可以支持多版本同时存在安装。osx64-x86
子文件夹,里面是可执行文件、动态库等。这个文件夹名称有3种,对应不同系统版本:win64-x86
、linux64-x86
、osx64-x86
,便于查验是否安装了正确的系统版本。examples
文件夹,推荐关注,里面是多种编程语言、建模工具和示例输入数据data
,帮助您快速掌握。最后的
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绑定。如有不联网需求可联系我们申请。
说明:
鉴权时,软件会根据环境变量设置,自动先找文件
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支持
Java支持无需安装,可以直接引入Maven依赖。注意:前序安装动作依然需要,java需要依赖已经安装的求解器动态链接库文件。Maven Dependency:
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>[0.20.0,)</version>
</dependency>
6.(可选)安装Python支持
当前支持Python 3.6+版本,3.8+版本在运行给出的示例代码时,可能会提示找不到mindoptpy
的问题,处理方案和更详细的安装说明见用户文档。安装的主要指令是:
python <MDOHOME>/<VERSION>/<PLATFORM>/lib/python/setup.py install
如在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
7. 卸载和重装
卸载
Windows系统:
可在控制面板的程序和功能中,找到已经安装的MindOpt,右键点击卸载。本软件支持多版本不同目录安装,如果安装多次,会出现多个,请逐一卸载。卸载的时候会删除安装时自动添加环境变量MINDOPT_HOME
和Path
。如果您以管理员身份安装,直接卸载会无权限修改环境变量,可手动去移除环境变量,或者以管理员身份运行安装包来进行卸载。
Linux和macOS系统:
求解器的SDK卸载只需要删除相关的文件即可:
软件包安装时候的地址,如:安装时候指定的位置
$HOME/mindopt
。修改软件环境变量的设置,如
~/.bashrc
或~/.zshrc
,删除文件~/.mdo_profile
。
关于Python的卸载:请参考安装时的
setup.py
文件卸载不需要的组件,如pip3 uninstall mindoptpy
。
关于软件包授权文件的地址,如:$HOME/mindopt
、Program Files /mindopt
,如果您后续还需要安装,可不删除或者注意备份文件。
求解指令的部分示例运行后会生成.bas、.sol的结果文件,可去安装目录删除。
重装
求解器的SDK可以同时安装多个版本,放在不同的文件夹、环境变量设置成需要用的版本即可。授权文件可不需要修改。
Windows系统:
双击.exe文件即可重装,新的环境变量设置会覆盖旧的。因为版本号不同会出现多个文件夹,环境变量MINDOPT_HOME
里可修改生效版本的目录。
Linux和macOS系统:
可根据前面的描述的安装步骤重装,并修改环境变量的设置即可,如 ~/.bashrc
或 ~/.zshrc
中设置,或引用的~/.mdo_profile
文件。
重装完成后,cmd的窗口需要关闭后重新打开使用,这样环境变量才会生效。