安装步骤(CentOS)

检查源

安装过程需要下载相关依赖,请确保服务器能够连接网络。

请在root用户下执行如下命令检查源是否可用。
yum repolist

如果命令执行报错或者后续安装依赖时等待时间过长甚至报错,则检查网络是否连接或者把"/etc/yum.repos.d/xxxx.repo"文件中的源更换为可用的源或使用镜像源(以配置华为镜像源为例,可参考华为开源镜像站)。

检查root用户的umask

  1. 以root用户登录安装环境。

  2. 检查root用户的umask值。

    umask
  3. 如果umask不等于0022,请执行如下操作配置,在该文件的最后一行添加umask 0022后保存。

    1. 在任意目录下执行如下命令,打开.bashrc文件:
      vi ~/.bashrc 

      在文件最后一行后面添加umask 0022内容。

    2. 执行:wq!命令保存文件并退出。
    3. 执行source ~/.bashrc命令使其立即生效。

依赖安装完成后,请用户恢复为原umask值(删除.bashrc文件中umask 0022一行)。基于安全考虑,建议用户将umask值改为0027。

配置安装用户权限

当用户使用非root用户安装时,安装MindStudio前需要下载相关依赖软件,可能需要用到提权命令,请用户自行获取所需的sudo权限,使用完成后请取消涉及高危命令的权限,否则有sudo提权风险。

安装依赖

  1. 检查系统是否安装Python依赖以及gcc等软件。

    分别使用如下命令检查是否安装gcc,make以及Python依赖软件等。
    gcc --version
    g++ --version
    make --version
    cmake --version
    rpm -qa |grep unzip
    rpm -qa |grep zlib-devel
    rpm -qa |grep bzip2-devel
    rpm -qa |grep sqlite-devel
    rpm -qa |grep libffi-devel
    rpm -qa |grep openssl-devel
    rpm -qa |grep xz-devel
    rpm -qa |grep pciutils
    rpm -qa |grep net-tools
    rpm -qa |grep sqlite-devel
    rpm -qa |grep lapack-devel
    rpm -qa |grep gcc-gfortran
    rpm -qa |grep xterm
    rpm -qa |grep firefox
    rpm -qa |grep openssh
    rpm -qa | grep xdg-utils
    rpm -qa | grep dbus-glib-devel
    rpm -qa | grep gdb

    若分别返回如下信息则说明已经安装,进入下一步(以下回显仅为示例,请以实际情况为准)。

    gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39)
    g++ (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39)
    GNU Make 3.82
    cmake version 2.8.12.2
    unzip-6.0-21.el7.aarch64
    zlib-devel-1.2.7-18.el7.aarch64
    bzip2-devel-1.0.6-13.el7.aarch64
    sqlite-devel-3.7.17-8.el7_7.1.aarch64
    libffi-devel-3.0.13-18.el7.aarch64
    openssl-devel-1.0.2k-19.el7.aarch64
    xz-devel-5.2.5-1.oe1.aarch64
    pciutils-3.5.1-3.el7.aarch64
    net-tools-2.0-0.25.20131004git.el7.aarch64
    sqlite-devel-3.7.17-8.el7_7.1.aarch64
    lapack-devel-3.4.2-8.el7.aarch64
    gcc-gfortran-4.8.5-39.el7.aarch64
    xterm-295-3.el7.aarch64
    firefox-60.2.2-1.el7.centos.aarch64
    openssh-server-7.4p1-16.el7.aarch64  openssh-clients-7.4p1-16.el7.aarch64  openssh-7.4p1-16.el7.aarch64
    xdg-utils-1.1.0-0.17.20120809git.el7.noarch
    dbus-glib-devel-0.100-7.el7.aarch64
    gdb-7.6.1-114.el7.aarch64
    否则请执行如下安装命令(如果只有部分软件未安装,则如下命令修改为只安装还未安装的软件即可):
    • 如果使用root用户安装依赖,请将步骤1至步骤2命令中的sudo删除。
    • 如果Python及其依赖是使用非root用户安装,则需要执行su - username命令切换到非root用户继续执行步骤1至步骤3
    • sqlite-devel需要在Python安装之前安装,如果用户操作系统已经安装满足版本要求的Python环境,在此之后再安装sqlite-devel,则需要重新编译Python环境。
    sudo yum install -y gcc gcc-c++ make cmake unzip zlib-devel bzip2-devel sqlite-devel libffi-devel openssl-devel pciutils net-tools lapack-devel gcc-gfortran xterm firefox openssh xdg-utils dbus-glib-devel gdb

  2. 检查系统是否安装满足版本要求的Python开发环境(具体要求请参见依赖列表,若需运行MindSDK,版本要求为3.9.x。此步骤以环境上需要使用Python 3.7.x为例进行说明)。

    执行命令python3 --version,如果返回信息满足Python版本要求(3.7.0~ 3.7.11),则直接进入下一步。如果环境上已安装过满足要求的Python,则可以直接从2.e开始执行。

    否则可参考如下方式安装Python3.7.5。

    1. 使用wget下载Python3.7.5源码包,可以下载到安装环境的任意目录,命令为:
      wget https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tgz
    2. 进入下载后的目录,解压源码包,命令为:
      tar -zxvf Python-3.7.5.tgz
    3. 进入解压后的文件夹,创建安装目录,执行配置、编译和安装命令:
      cd Python-3.7.5
      ./configure --prefix=/usr/local/python3.7.5 --enable-loadable-sqlite-extensions --enable-shared
      make
      sudo make install

      其中“--prefix”参数用于指定Python安装路径,用户根据实际情况进行修改,“--enable-shared”参数用于编译出libpython3.7m.so.1.0动态库,“--enable-loadable-sqlite-extensions”参数用于加载sqlite-devel依赖。

      本手册以--prefix=/usr/local/python3.7.5路径为例进行说明。执行配置、编译和安装命令后,安装包在/usr/local/python3.7.5路径,libpython3.7m.so.1.0动态库在/usr/local/python3.7.5/lib/libpython3.7m.so.1.0路径。

    4. 设置Python3.7.5环境变量。
      #用于设置python3.7.5库文件路径
      export LD_LIBRARY_PATH=/usr/local/python3.7.5/lib:$LD_LIBRARY_PATH
      #如果用户环境存在多个python3版本,则指定使用python3.7.5版本
      export PATH=/usr/local/python3.7.5/bin:$PATH

      通过以上export方式设置环境变量,该种方式设置的环境变量只在当前窗口有效。您也可以通过将以上命令写入~/.bashrc文件中,然后执行source ~/.bashrc命令,使上述环境变量永久生效。注意如果后续您有使用环境上其他Python版本的需求,则不建议将以上命令写入到~/.bashrc文件中。

    5. 安装完成之后,执行如下命令查看安装版本,如果返回相关版本信息,则说明安装成功。
      python3 --version
      pip3 --version

  3. 安装前请先使用pip3 list命令检查是否安装相关依赖,若已经安装,则请跳过该步骤;若未安装,则安装命令如下(如果只有部分软件未安装,则如下命令修改为只安装还未安装的软件即可)。以下依赖为必要安装依赖,其他依赖用户可根据实际需要自行安装。

    • 请在安装前配置好pip源,具体可参考配置pip源
    • 安装前,建议执行命令pip3 install --upgrade pip进行升级,避免因pip版本过低导致安装失败。
    • 如下命令如果使用非root用户安装,需要在安装命令后加上--user,例如:pip3 install numpy --user,安装命令可在任意路径下执行。
    pip3 install numpy
    pip3 install decorator
    pip3 install sympy
    pip3 install cffi
    pip3 install pyyaml
    pip3 install pathlib2
    pip3 install psutil
    pip3 install protobuf
    pip3 install scipy
    pip3 install requests
    pip3 install grpcio
    pip3 install pylint
    pip3 install absl-py

    如果执行上述命令时提示例如“Could not find <Python.h>”或者“fatal error:Python.h:No such file or directory”等信息,请参见安装依赖时提示未安装或找不到Python.h解决。

依赖安装完成后,请用户恢复为原umask值(参考检查root用户的umask,删除.bashrc文件中umask 0022一行)。基于安全考虑,建议用户将umask值改为0027。