求解器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-x86linux64-x86osx64-x86,便于查验是否安装了正确的系统版本。

  • examples文件夹,推荐关注,里面是多种编程语言、建模工具和示例输入数据data,帮助您快速掌握。

  • 最后的fl_client.ini是用户要创建的鉴权文件,后文会讲述它。

0.15.1

3. 检查环境变量和试运行

安装过程中会配置环境变量,请查看检查。如果安装多个版本时,可根据自己的情况来修改生效的版本号。

Windows系统:

安装步骤添加环境变量MINDOPT_HOMEPath,无需手动添加。如果安装多个版本时,可修改MINDOPT_HOME来更改生效版本。如下图所示:

Windows系统环境变量

Linux、macOS系统:

安装时在~/.bashrc和~/.zshrc文件中添加了指令source ~/.mdo_profile,安装完成后重启终端命令行会生效。安装多版本时,可执行nano ~/.mdo_profile来修改。

现在您可执行如下指令查看和立即生效环境变量:

source ~/.mdo_profile
cat ~/.mdo_profile

在docker中安装时,可以用export方式查看检查。

检查完环境变量后,可在命令行中输入mindopt来验证是否安装成功。截图示意如下:

0.15.1mindopt

运行失败的常见异常处理方式:

如果执行失败,很可能是权限问题,可通过以下方式更改可执行文件的权限:

Linux:

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

macOS:

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

有些系统可能会由于开发者安全校验不能同意运行mindopt,如macOS可在安全性与隐私可点击仍然允许。如下图所示。更多异常可查询常见问题FAQ安装问题

mac系统的

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_HOMEPath。如果您以管理员身份安装,直接卸载会无权限修改环境变量,可手动去移除环境变量,或者以管理员身份运行安装包来进行卸载。

  • Linux和macOS系统:

求解器的SDK卸载只需要删除相关的文件即可:

  1. 软件包安装时候的地址,如:安装时候指定的位置 $HOME/mindopt

  2. 修改软件环境变量的设置,如 ~/.bashrc~/.zshrc,删除文件~/.mdo_profile

  • 关于Python的卸载:请参考安装时的setup.py文件卸载不需要的组件,如pip3 uninstall mindoptpy

说明

关于软件包授权文件的地址,如:$HOME/mindoptProgram Files /mindopt,如果您后续还需要安装,可不删除或者注意备份文件。

求解指令的部分示例运行后会生成.bas、.sol的结果文件,可去安装目录删除。

重装

求解器的SDK可以同时安装多个版本,放在不同的文件夹、环境变量设置成需要用的版本即可。授权文件可不需要修改。

  • Windows系统:

双击.exe文件即可重装,新的环境变量设置会覆盖旧的。因为版本号不同会出现多个文件夹,环境变量MINDOPT_HOME里可修改生效版本的目录。

  • Linux和macOS系统:

可根据前面的描述的安装步骤重装,并修改环境变量的设置即可,如 ~/.bashrc~/.zshrc中设置,或引用的~/.mdo_profile文件。

重要

重装完成后,cmd的窗口需要关闭后重新打开使用,这样环境变量才会生效。

8. 求解器使用

新手建议根据快速入门文档的一个快速求解的例子来快速上手,更多的使用说明见求解器用户手册

阿里云首页 优化求解器 相关技术圈