安装HPCKit（交互式）

交互式安装支持用户根据实际情况选择需要安装的HPCKit组件。

操作步骤

使用PuTTY工具，登录HPCKit的安装节点。
（可选）如果需要安装KuLitho组件，执行以下命令，进入KuLitho软件包所在目录并进行解压。
```
cd KuLitho软件包所在目录
```
```
tar xvf HPCKit_KuLitho_26.0.RC1_Linux-aarch64.tar.gz
```
（可选）如果需要安装KuRTM组件，执行以下命令，进入KuRTM软件包所在目录并进行解压。
```
cd KuRTM软件包所在目录
```
```
tar xvf HPCKit_KuRTM_26.0.RC1_Linux-aarch64.tar.gz
```
执行以下命令，进入HPCKit软件包所在目录。
cd HPCKit软件包所在目录

共享存储方式安装HPCKit时，安装目录请参见《Kunpeng HPC Solution 26.0.RC1 LLD模板》中“项目基本信息 > 共享存储目录规划 > HPCKit安装目录”。
执行以下命令，解压HPCKit软件包。
```
tar xvf HPCKit_26.0.RC1_Linux-aarch64.tar.gz
```

安装HPCKit。

执行以下命令，进入安装流程。

sh HPCKit_26.0.RC1_Linux-aarch64/install.sh

在回显信息后，输入HPCKit的安装目录。

Enter the installation path (default: /opt):HPCKit的安装目录

回显信息中包含如下提示信息，表示已完成安装目录配置，请执行6.c；否则，请先根据报错信息完成异常处理，然后完成安装目录配置，再执行6.c。

You have selected: /opt

如果用户对6.b中输入的HPCKit的安装目录有写权限，则HPCKit可以安装在该目录下。
如果用户对6.b中输入的HPCKit的安装目录无写权限，界面出现如下回显，并再次提示用户输入安装目录，如果用户不输入安装目录并直接按回车，则会默认安装在~目录下，~目录是用户的$HOME目录。
1
Error: You do not have permission to write to HPCKit的安装目录. Please choose another path.

如果配置的安装目录空间小于10GB，则会回显以下提示信息，建议重新规划安装目录，或清理该目录空间。

The space of the HPCKit installation directory is insufficient.
About 10 GB space is required for installing HPCKit.
Run the 'df -h /opt' command to check the space of the installation directory.

在回显信息后，选择需要安装的编译器。

如果全部安装（系统默认），直接按“Enter”；
如果需要分别指定是否安装每个组件，通过按下对应组件前的序号来切换安装/不安装。例如1代表毕昇编译器（默认安装），按下1表示切换为不安装毕昇编译器，然后按“Enter”确认修改。再次按下1表示切换为安装毕昇编译器，然后按“Enter”确认修改。再按“Enter”确认安装。

KuTACC组件仅支持毕昇编译器。

Start installing Compiler...
Please Enter (1-2) to switch compiler selection, only checked compiler(s) will be installed.
Enter 'q' to quit, 'y' or enter to confirm compiler installation.
Number     Option                    Choice     Descriptions
1          Bisheng-Compiler          [v]          Bisheng Compiler
2          GCC-Compiler              [v]          GCC Compiler   

[v]表示当前已选择安装该组件，[x]表示当前已选择不安装该组件，下同。回显如下信息（以全部安装为例），表示安装成功，请继续执行4；否则，请先根据报错信息完成异常处理，然后完成编译器安装，再执行4。

Confirm Installation.
Start Installing Bisheng Compiler
Bisheng Compiler Installation Finished.
Start Installing Gcc For openEuler
Gcc For openEuler Installation Finished.

选择安装组件KML、KUPL、HMPI、KuLitho、KuTACC、KuRTM、KuDNN和KuQCD。

如果同时使用毕昇和GCC两种编译器，则根据界面信息先完成毕昇编译器编译的组件安装，然后完成GCC编译器编译的组件安装。
如果仅使用毕昇或GCC编译器中的一种，则根据界面信息完成对应的组件安装即可。

使用毕昇编译器时，将出现如下回显信息：

Start Installing Bisheng Compiled Component...
Please Enter (1-3) to switch component selection, only checked component(s) will be installed.
Enter 'q' to quit, 'y' or enter to confirm component installation.
Number     Option                    Choice     Descriptions
1          KML                       [v]          Kunpeng Math Library (Bisheng compiled)
2          KUPL                     [v]          Kunpeng Unified Parallel Library (Bisheng compiled)
3          HMPI                      [v]          Hyper Message Passing Interface (Bisheng compiled)
4          KuLitho                   [x]          Kunpeng Lithography Library (Bisheng compiled)
5          KuTACC                  [v]          Kunpeng Unified Transformer Accelerator (Bisheng compiled)
6          KuRTM                    [x]          Kunpeng Unified Reverse Time Migration (Bisheng compiled)
7          KuDNN                    [v]          Kunpeng Unified Deep Neural Networks (Bisheng compiled)
8          KuQCD                    [v]          Kunpeng Unified Quantum Chromodynamics Library (Bisheng compiled)

如果除KuLitho和KuRTM组件外全部安装（系统默认），直接按“Enter”。
如果需要分别指定是否每个组件，通过按下对应组件前的序号来切换安装/不安装。例如1代表KML（默认安装）。按1表示切换为不安装KML，然后按“Enter”确认修改。再次按下1表示切换为安装KML，然后按“Enter”确认修改。再按“Enter”确认安装。
如果不安装任何组件，先输入“q”，然后按“Enter”。
然后需要选择HMPI版本，输入'hns'或'mlx'选择对应的HMPI版本，默认为hns版本，回显如下则安装成功，操作结束；如果输入其他非法值，则需要重新输入HMPI版本。
1 2 3 4 5
Start Installing gcc compiled Hyper MPI Please enter the type of HMPI: 'hns'(default) or 'mlx'. hns HMPI Release Version Installation Finished. HMPI Debug Version Installation Finished.
- Kylin Linux Advanced Server V10 SP2 AArch64系统以及openEuler 20.03 LTS SP3 AArch64仅支持安装mlx版本的HMPI。
- 如果使用华为自研网卡驱动，应选择hns；如果使用Mellanox网卡驱动，应选择mlx。可通过以下命令查询网卡驱动类型：
```
rpm -qa | grep rdma-core
```
  如果回显内容中包含“mlnx”，选择--hmpi_type=mlx，回显示例如下：
  rdma-core-58mlnx43-1.58112.aarch64 rdma-core-devel-58mlnx43-1.58112.aarch64
  否则使用默认值--hmpi_type=hns，回显示例如下：
  rdma-core-41.0-36.oe2203sp4.aarch64 rdma-core-devel-41.0-36.oe2203sp4.aarch64
KuRTM的安装需要指定安装包解压后的路径，默认为HPCKit安装包解压后的package文件夹，回显如下则安装成功，操作结束；如果输入路径中找不到需要的安装包，则会提示是否继续安装，是则需要重新输入KuRTM安装包解压后的路径，否则KuRTM组件安装失败。
1 2
Enter the KuRTM install package path (default: /home/xxx/HPCKit_xxx_Linux-aarch64/package): /home/xxx/KuRTM KuRTM Installation Finished.
KuLitho的安装需要指定安装包解压后的路径，默认为HPCKit安装包解压后的package文件夹，回显如下则安装成功，操作结束；如果输入路径中找不到需要的安装包，则会提示是否继续安装，是则需要重新输入KuLitho安装包解压后的路径，否则KuLitho组件安装失败。
1 2
Enter the KuLitho install package path (default: /home/xxx/HPCKit_xxx_Linux-aarch64/package): /home/xxx/KuLitho KuLitho Installation Finished.

回显如下信息（以全部安装为例），表示KML、KUPL、HMPI、KuLitho、KuTACC、KuRTM、KuDNN和KuQCD安装成功；否则，请先根据报错信息完成异常处理，然后完成组件安装。

Confirm Installation.
Start Installing bisheng compiled KML
KML Installation Finished
Start Installing bisheng compiled KUPL
KUPL Installation Finished.
Start Installing bisheng compiled Hyper MPI
Please enter the type of HMPI: 'hns'(default) or 'mlx'.
hns
HMPI Release Version Installation Finished.
HMPI Debug Version Installation Finished.
Start Installing bisheng compiled KuLitho
Enter the KuLitho install package path (default: /home/xxx/HPCKit_26.0.RC1_Linux-aarch64/package): 
KuLitho Installation Finished.
Start Installing bisheng compiled KuTACC
KuTACC Installation Finished.
Start Installing bisheng compiled KuRTM
KuRTM Installation Finished.
Start Installing bisheng compiled KuDNN
KuDNN Installation Finished.
Start Installing bisheng compiled KuQCD
KuQCD Installation Finished.

使用GCC编译器时，将出现如下回显信息：

Start installing GCC Compiled Component...
Please Enter (1-3) to switch component selection, only checked component(s) will be installed.
Enter 'q' to quit, 'y' or enter to confirm component installation.
Number     Option                    Choice     Descriptions
1          KML                       [v]          Kunpeng Math Library (GCC compiled)
2          KUPL                      [v]          Kunpeng Unified Parallel Library (GCC compiled)
3         HMPI                      [v]          Hyper Message Passing Interface (GCC compiled)
4          KuLitho                   [x]          Kunpeng Lithography Library (GCC compiled)
5          KuRTM                     [x]          Kunpeng Unified Reverse Time Migration (GCC compiled)
6          KuDNN                     [v]          Kunpeng Unified Deep Neural Networks (GCC compiled)
7          KuQCD                     [v]          Kunpeng Unified Quantum Chromodynamics Library (GCC compiled)

如果除KuLitho，KuRTM组件外全部安装（系统默认），直接按“Enter”；
如果需要分别指定安装或不安装每个组件，方法同上。
如果不安装任何组件，先输入“q”，然后按“Enter”。
然后需要选择HMPI版本，输入’hns’或’mlx’选择对应的HMPI版本，默认为hns版本，回显如下则安装成功，操作结束；如果输入其他非法值，则需要重新输入HMPI版本。
1 2 3 4 5
Start Installing gcc compiled Hyper MPI Please enter the type of HMPI: 'hns'(default) or 'mlx'. hns HMPI Release Version Installation Finished. HMPI Debug Version Installation Finished.
- Kylin Linux Advanced Server V10 SP2 AArch64系统以及openEuler 20.03 LTS SP3 AArch64仅支持安装mlx版本的HMPI。
- 如果使用华为自研网卡驱动，应选择hns；如果使用Mellanox网卡驱动，应选择mlx。可通过以下命令查询网卡驱动类型：
```
rpm -qa | grep rdma-core
```
  如果回显内容中包含“mlnx”，选择--hmpi_type=mlx，回显示例如下：
  rdma-core-58mlnx43-1.58112.aarch64 rdma-core-devel-58mlnx43-1.58112.aarch64
  否则使用默认值--hmpi_type=hns，回显示例如下：
  rdma-core-41.0-36.oe2203sp4.aarch64 rdma-core-devel-41.0-36.oe2203sp4.aarch64
KuRTM的安装需要指定安装包解压后的路径，默认为HPCKit安装包解压后的package文件夹，回显如下则安装成功，操作结束；如果输入路径中找不到需要的安装包，则会提示是否继续安装，是则需要重新输入KuRTM安装包解压后的路径，否则KuRTM组件安装失败。
1 2
Enter the KuRTM install package path (default: /home/xxx/HPCKit_xxx_Linux-aarch64/package): /home/xxx/KuRTM KuRTM Installation Finished.
KuLitho的安装需要指定安装包解压后的路径，默认为HPCKit安装包解压后的package文件夹，回显如下则安装成功，操作结束；如果输入路径中找不到需要的安装包，则会提示是否继续安装，是则需要重新输入KuLitho安装包解压后的路径，否则KuLitho组件安装失败。
1 2
Enter the KuLitho install package path (default: /home/xxx/HPCKit_xxx_Linux-aarch64/package): /home/xxx/KuLitho KuLitho Installation Finished.

Confirm Installation.
Start Installing gcc compiled KML
KML Installation Finished
Start Installing gcc compiled KUPL
KUPL Installation Finished.
Start Installing gcc compiled Hyper MPI
Please enter the type of HMPI: 'hns'(default) or 'mlx'.
hns
HMPI Release Version Installation Finished.
HMPI Debug Version Installation Finished.
Start Installing gcc compiled KuLitho
Enter the KuLitho install package path (default: /home/xxx/HPCKit_26.0.RC1_Linux-aarch64/package): 
KuLitho Installation Finished.
Start Installing gcc compiled KuRTM
KuRTM Installation Finished.
Start Installing gcc compiled KuDNN
KuDNN Installation Finished.
Start Installing gcc compiled KuQCD
KuQCD Installation Finished.

安装HIO组件。

场景一：已安装以下HIO桥接目标库libhdf5.so >= 1.12.0、libnetcdf.so >= 4.7.4和libpnetcdf.so >= 1.12.1且配置了环境变量。会出现以下回显信息。

Start installing HIO Component...
Please Enter (1-1) to switch component selection, only checked component(s) will be installed.
Enter 'q' to quit, 'y' or enter to confirm component installation.
Number     Option                    Choice     Descriptions
1          HIO                       [v]          Kunpeng Hyper IO Middleware

如果安装HIO组件（系统默认），直接按“Enter”。
回显如下信息，表示安装成功，操作结束；否则，请先根据报错信息完成异常处理，然后完成组件安装。
1 2 3
Confirm Installation. Start Installing HIO HIO Installation Finished
如果不安装HIO组件，方法同上。

场景二：未安装以下HIO桥接目标库libhdf5.so >= 1.12.0、libnetcdf.so >= 4.7.4和libpnetcdf.so >= 1.12.1，或者已安装但未配置环境变量。会出现以下回显信息。

选择y，继续安装HIO组件。HIO组件安装完成后，请参见安装HIO桥接目标库完成HIO桥接目标库安装。
- 如果环境中不存在HIO桥接目标库，请参见安装HIO桥接目标库完成HIO桥接目标库安装并配置环境变量。
- 如果环境中已存在HIO桥接目标库但未配置环境变量，请参见配置HIO桥接目标库的环境变量配置环境变量。
选择n，退出安装HIO组件。

Start Installing HIO
libhdf5.so >= 1.12.0 required, Please update the library to the required version.
Continue Installation? [y/n]
y
Confirm Installation.
libnetcdf.so >= 4.7.4 required, Please update the library to the required version.
Continue Installation? [y/n]
y
Confirm Installation.
libpnetcdf.so >= 1.12.1 required, Please update the library to the required version.
Continue Installation? [y/n]
y
Confirm Installation.
HIO Installation Finished

父主题： 安装卸载HPCKit