求解器SDK下载和安装

1. 下载最新版

V0.x版本和V1.x版本的API大部分都不一样，使用时请注意查看对应版本的API文档。

当前最新版本：V1.0.1 发布时间：2023.11.14

修改记录详情、历史版本下载，请查看历史版本下载。

使用上面软件包的环境依赖是：

下文将描述安装方式，也可查阅视频总览的视频来学习。

2. 安装：基础安装，能支持C、C++接口APIs

Windows系统：

双击安装文件，根据指引安装。

安装时，如果需要为所有用户安装，需要以管理员身份运行安装包。方式为：先以管理员身份运行“命令提示符”，然后目录切换到安装包所在文件夹，执行安装包文件。

Linux系统：

系统命令行中输入如下指令，根据指引进行安装：

bash mindopt-install-linux64x86-1.0.1.sh

或者ARM芯片版本：

bash mindopt-install-linux64aarch-1.0.1.sh

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

# 以 admin 用户为例
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-1.0.1.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-1.0.1.sh

# 设置 mindopt 环境变量
ENV MINDOPT_HOME /home/admin/mindopt/1.0.1
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-1.0.1.sh

或者Apple Silicon芯片版本：

bash mindopt-install-osx64aarch-1.0.1.sh

求解器安装完成后，安装文件目录结构如下图示意，会包含：

• 1.0.1总文件夹，代表不同的软件版本号，请以自己实际安装版本为准。可以支持多版本同时存在，都安装在mindopt目录，比如下图的0.25.1是旧版本。

• osx64-x86子文件夹，里面是可执行文件、动态库等。这个文件夹名称有5种，对应不同系统版本：win64-x86、linux64-x86、osx64-x86、linux64-aarch、osx64-aarch，便于查验是否安装了正确的系统版本。

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

• doc目录中存储了引导使用的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绑定。如有不联网需求可联系我们申请。

说明：

• 鉴权时，软件会根据环境变量设置，自动先找文件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>1.0.1</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. 求解器使用

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