install#
AIP安装命令#
install - AIP软件包的安装脚本
概要#
install [--shared=共享目录] [--localtop=本地安装目录] [--hosts=主机hosts文件路径] [--admin=AIP集群主管理员用户名] [--ncpus=threads|cores] [--crv_port=CRV服务端口] [--eda] [--noint|--silent] [--help]
描述#
AIP软件包首层目录中的install脚本用于把AIP软件安装到共享文件系统中。这个脚本也可用于升级， 包括同版本更新（覆盖原有的可执行文件）或新的版本的安装。
install脚本必须以root身份运行。
第一次安装AIP，脚本会安装缺省配置文件。如果当前目录下没有AIP企业版的key文件，会自动生成 有效期为45天的企业版key，key可以提供hosts文件中配置的主机数乘以10的单元。如 hosts文件中有3台主机，则key里包含30个单元。
企业版每一颗CPU和一颗GPU需要一个key的单元。
若共享文件的目录下已有以前版本的AIP文件，install脚本不会修改任何配置文件。
当同版本的AIP有更新的软件包时，可以用这个脚本更新和覆盖已经安装的二进制文件。
当安装新版的AIP时，脚本会把新的版本安装在一个新的目录中，如/opt/skyformai_shared/10.25.0。 这里/opt/skyformai_shared为共享文件系统中的目录，10.25.0为新安装的目录。
选项#
- --help
显示所有参数项，并退出。
- --admin=AIP集群主管理员用户名
指定集群主管理员用户名。如果过用户名在系统中不存在，脚本会调用 useradd添加本地用户。
缺省：cadmin
- --crv_port=CRV服务端口]
指定SkyForm CRV服务（参考 vncsub）的端口号。这个选项只在第一次安装有效。 因为后继的安装为更新或升级，不会修改已有的配置。
缺省：16000
- --eda
生成适合EDA负载的配置文件，参考 典型的EDA负载集群配置 。这个选项只在第一次安装有效。 因为后继的安装为更新或升级，不会修改已有的配置。
缺省：适合超智算中心的配置。参考 典型的超算中心和智算中心集群配置 。
- --hosts=主机hosts文件路径
提供集群中所有主机的IPv4地址和主机名列表文件路径。文件例子如下。
hosts:
192.168.20.100 mgt01 192.168.20.101 mgt02 192.168.20.102 node0001 192.168.20.103 node0002 192.168.20.103 gpu0001
缺省文件路径：当前目录下./hosts。
缺省：若文件不存在，以本机为目标自动生成单一主机的hosts文件。
- --localtop=本地安装目录
安装在本机的目录。这个目录在同一集群的所有异构主机上都是一致的，里面的bin、 sbin等目录为符号链，链接到共享文件系统中适合本机的二进制文件目录，如在arm 的主机上：bin -> /opt/skyformai_shared/10.25.0aarch。
缺省：/opt/skyformai
- --ncpus=threads|cores
配置cb.yaml中集群级别的参数define_ncpus的值。参考 cb.yaml 。 这个选项只在第一次安装有效。因为后继的安装为更新或升级，不会修改已有的配置。
- --noint|--silent
脚本运行不提问确认。除了用参数修改的安装方法外，所有参数都用缺省值。这个 参数可用于自动化部署中。
缺省：参数需要用户确认。
- --shared=共享目录
所安装的共享文件系统上的路径。所有AIP软件都会被安装在这个目录下。
缺省：/opt/skyformai_shared