通过命令行安装
操作步骤
- 以root用户登录安装环境。
- 将获取软件包章节获取到的软件包上传到安装环境的某一目录下。
- (可选)创建AtlasEdge软件的安装路径和日志路径。
- 如果用户想指定安装路径和日志路径,则需要先创建安装路径和日志路径。以安装路径“/home/work”为例, 用户先执行mkdir -p /home/work命令创建安装路径,再选择该路径进行软件安装。
- 如果用户不想指定安装路径和日志路径,则软件会安装到默认路径“/usr/local”下,日志会记录到默认路径“/var/alog”下。
- 建议安装路径和日志路径均使用默认路径,否则可能会出现如其他日志收集工具收集日志失败等问题。安装路径和日志路径的每一级路径都必须为root属组用户目录,且权限不能大于755,否则将安装失败。
- 凝思Linux和UOS系统的“/usr/local”目录默认是staff属主,版本加强校验必须为root属主,否则会导致安装失败。用户可选择修改该目录为root属主,或者安装至其他目录。
- 日志转储目录为“/home/log”,请确保该目录以及所有的父目录为root属主,且不能挂载在内存文件系统上,避免重启丢失。
- 在软件包所在目录下执行以下命令解压软件包。
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文件和证书吊销列表用于软件包的内层签名校验。
- 执行以下命令对步骤4中解压出来的安装包再次进行解压。
tar -mxvf Ascend-mindxedge-atlasedge_{version}_linux-{arch}.tar.gz
- 安装。
安装时可选择使用默认安装或自定义安装。
- 默认安装
直接执行命令./install.sh即默认安装,安装时会在系统中创建MindXEdge用户。此用户的用户名和用户组名为MindXEdge,uid和gid为1024,且是nologin类型。
默认安装时若系统已存在MindXEdge用户,则此用户的用户名和用户组名必须为MindXEdge,uid和gid为1024,且是nologin类型,否则会安装失败。
- 自定义安装
- 指定安装路径
- 指定日志路径
- 指定用户安装(建议使用默认用户安装,指定用户安装操作繁琐,且不利于后期维护,如非必要,不建议指定用户安装。)
执行命令./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”。
- --ignore_docker_status_check:如果带了该参数表示不检查docker的运行状态。为了更好的管理容器,安装过程中,建议用户检查docker的运行状态,即不带该参数。
- --allow_log_tmpfs:值为“true”或者“false”,表示是否允许日志路径为内存文件系统,默认为“false”表示不允许日志路径为内存文件系统。
安装成功后,AtlasEdge软件部署在“安装路径/AtlasEdge”目录下,日志记录在“日志路径/AtlasEdge_log”目录下。
另外,安装2.0.3及之后的版本,安装前已部署的容器业务继续以HwHiAiUser用户运行,业务不受影响。但若需要部署新容器,则需要确保系统中已有MindXEdge用户,没有则需要创建。
风险提示:日志路径若指定为内存文件系统中目录,如果设备重启,则该目录下的日志会被系统清理,请谨慎操作。
- 默认安装