通过命令行安装

操作步骤

1. 以root用户登录安装环境。
2. 将获取软件包章节获取到的软件包上传到安装环境的某一目录下。
3. 创建AtlasEdge软件的安装路径和日志路径（可选）。
   • 如果用户想指定安装路径和日志路径，则需要先创建安装路径和日志路径。以安装路径“/home/work”为例，用户先执行mkdir -p /home/work命令创建安装路径，再选择该路径进行软件安装。
   • 如果用户不想指定安装路径和日志路径，则软件会安装到默认路径“/usr/local”下，日志会记录到默认路径“/var/alog”下。
     

     • 建议安装路径和日志路径均使用默认路径，否则可能会出现如其他日志收集工具收集日志失败等问题。安装路径和日志路径的每一级路径都必须为root属组用户目录，且其他用户不可写，否则将安装失败。
     • 凝思Linux和UOS系统的“/usr/local”目录默认是staff属主，版本加强校验必须为root属主，否则会导致安装失败。用户可选择修改该目录为root属主，或者安装至其他目录。
     • 日志转储目录为“/home/log”，请确保该目录以及所有的父目录为root属主，且不能挂载在内存文件系统上，避免重启丢失。
4. 在软件包所在目录下执行以下命令解压软件包。

   unzip Ascend-mindxedge-atlasedge_{version}_linux-{arch}.zip

   Ascend-mindxedge-atlasedge_{version}_linux-{arch}.zip以获取的实际包名为准。

   解压后包含如下文件：

   • 安装包：Ascend-mindxedge-atlasedge_{version}_linux-{arch}.tar.gz
   • CMS签名文件：Ascend-mindxedge-atlasedge_{version}_linux-{arch}.tar.gz.cms
   • 证书吊销列表：Ascend-mindxedge-atlasedge_{version}_linux-{arch}.tar.gz.crl

   其中CMS文件和证书吊销列表用于软件包的内层签名校验。

5. 执行以下命令对步骤4中解压出来的安装包再次进行解压。

   tar -mxvf Ascend-mindxedge-atlasedge_{version}_linux-{arch}.tar.gz --no-same-owner

6. 安装AtlasEdge软件。安装时可选择使用默认安装或自定义安装。
   • 默认安装

     直接执行命令./install.sh即默认安装，安装时会在系统中创建MindXEdge用户。此用户的用户名和用户组名为MindXEdge，uid和gid为1024，且是nologin类型。

     

     默认安装时若系统已存在MindXEdge用户，则此用户的用户名和用户组名必须为MindXEdge，uid和gid为1024，且是nologin类型，否则会安装失败。

   • 自定义安装
     • 指定安装路径

       执行命令./install.sh --install_dir=安装路径

     • 指定日志路径

       执行命令./install.sh --log_dir=日志路径

     • 指定用户安装（建议使用默认用户安装，指定用户安装操作繁琐，且不利于后期维护，如非必要，不建议指定用户安装。）

       执行命令./install.sh --user=用户名 --group=用户组名 --user_id=用户ID --group_id=用户组ID。

       注意事项：

       • 参数--user，--group，--user_id，--group_id必须同时指定。
       • 用户名和用户组名必须相同，且不能是HwHiAiUser或MindXEdge。
       • uid和gid必须为相同整数数字，同时uid和gid必须大于1001，小于或等于65535，且不能是1024。
       • 若系统已存在指定的帐户，则已有帐户信息必须和参数指定的一致，且是nologin类型，否则会安装失败。
       • 若系统不存在指定的帐户，则系统上home目录下不能存在与指定帐户名相同的文件或目录，否则会安装失败。
     

     • 支持同时指定安装路径、日志路径、用户进行安装。

       如：同时指定安装路径和日志路径，执行命令./install.sh --install_dir=安装路径 --log_dir=日志路径。

     • 安装时其余可选参数。
       • --install_type：值为“install”或者“effect”，分别表示“安装”，“生效”，默认为“install”，effect模式不支持用户后台调用。
       • --ignore_docker_status_check：如果带了该参数表示不检查Docker的运行状态。为了更好的管理容器应用，安装过程中，建议用户检查Docker的运行状态，即不带该参数。
       • --allow_log_tmpfs：值为“true”或者“false”，表示是否允许日志路径为内存文件系统，默认为“false”表示不允许日志路径为内存文件系统。

   安装成功后，AtlasEdge软件部署在“安装路径/AtlasEdge”目录下，日志记录在“日志路径/AtlasEdge_log”目录下。

   另外，安装2.0.3及之后的版本，安装前已部署的容器应用继续以HwHiAiUser用户运行，业务不受影响。但若需要部署新容器应用，则需要确保系统中已有MindXEdge用户，没有则需要创建。

   

   风险提示：日志路径若指定为内存文件系统中目录，如果设备重启，则该目录下的日志会被系统清理，请谨慎操作。