设置环境变量(modules方式)
HPCKit支持通过setvars.sh和modules两种方式加载环境变量。modules方式支持选择加载环境变量管理模块,高阶用户可以通过modules方式加载需要的组件。
前提条件
- 已配置yum源。执行以下命令检查节点YUM源是否已配置,确保回显中有OS对应的YUM源。
yum list | grep kernel
- 已安装tcl工具。
回显有如下信息说明已安装tcl工具。
1tcl.aarch64 1:8.6.12-4.oe2203sp1 @anaconda
如果未安装tcl工具,执行以下命令安装。yum install -y tcl*
- 已安装module工具。
回显有如下信息说明已安装module工具。
1environment-modules.aarch64 5.0.1-3.oe2203sp1 @OS
如果未安装module工具,执行以下命令安装,并加载环境变量。yum install -y environment-modules source /etc/profile.d/modules.sh
注意事项
建议同一环境中使用一种编译器进行编译,如果同时使用两种编译器进行编译,则需要注意环境变量信息是否正确。具体原因及配置方法如下:
由于环境变量信息中,参数“CC”、“CXX”、“FC”、“F77”、“F90”和“OPAL_PREFIX”的值只针对当前使用的编译器生效,如果要使用另一种编译器,需要先卸载当前已有环境变量模块,然后加载需要另一种编译器进行编译的组件环境变量模块。不同编译器编译对应组件的环境变量管理模块时,其环境变量参数值请参见表1。
示例:
当前使用毕昇编译器,已加载环境变量模块“bisheng/hmpi25.2.0/release”,此时,“OPAL_PREFIX”的值为“/opt/HPCKit/25.2.0/hmpi/bisheng/release/hmpi”,如果需要切换为GCC编译器,则需要先卸载环境变量模块“bisheng/hmpi/hmpi”,然后加载环境变量模块“gcc/hmpi25.2.0/release”,加载完成后,“OPAL_PREFIX”的值为“/opt/HPCKit/25.2.0/hmpi/gcc/release/hmpi”。
操作步骤
- 使用PuTTY工具,登录HPCKit的安装节点。
- 执行以下命令,进入HPCKit安装目录。
cd /opt/HPCKit/latest
/opt:HPCKit的默认安装目录,请替换为实际路径。
- 执行以下命令,添加modulefiles。
module use modulefiles
使用sh modulefiles-setup.sh可以恢复误删的modulefiles文件夹。
- 执行以下命令,查询可用环境变量模块。
module avail
回显如下类似信息:
1 2 3 4 5 6 7 8
---------------------------------- /opt/HPCKit/25.2.0/modulefiles ------------------------------------------- bisheng/compiler5.0.0.2/bishengmodule bisheng/kml25.2.0/kspblas/omp bisheng/kuqcd25.2.0/kuqcd gcc/kml25.2.0/kblas/serial-locking gcc/kudnn25.2.0/kudnn bisheng/hmpi25.2.0/debug bisheng/kml25.2.0/kspblas/serial bisheng/kurtm25.2.0/kurtm gcc/kml25.2.0/kblas/serial-nolocking gcc/kupl25.2.0/prof bisheng/hmpi25.2.0/release bisheng/kml25.2.0/kvml/omp bisheng/kutacc25.2.0/kutacc gcc/kml25.2.0/kml gcc/kupl25.2.0/release bisheng/kml25.2.0/kblas/multi bisheng/kml25.2.0/kvml/serial gcc/compiler12.3.1/gccmodule gcc/kml25.2.0/kspblas/omp gcc/kuqcd25.2.0/kuqcd bisheng/kml25.2.0/kblas/serial-locking bisheng/kudnn25.2.0/kudnn gcc/hmpi25.2.0/debug gcc/kml25.2.0/kspblas/serial gcc/kurtm25.2.0/kurtm bisheng/kml25.2.0/kblas/serial-nolocking bisheng/kupl25.2.0/prof gcc/hmpi25.2.0/release gcc/kml25.2.0/kvml/omp hio25.0.0/hio bisheng/kml25.2.0/kml bisheng/kupl25.2.0/release gcc/kml25.2.0/kblas/multi gcc/kml25.2.0/kvml/serial
如果回显信息中包含不需要加载的模块信息,您可以执行以下命令删除。
module unuse /opt/HPCKit/25.2.0/modulefiles
其中,“/opt/HPCKit/25.2.0/modulefiles”为模块名称,请根据实际情况替换。
- 加载环境变量模块。
- 查询对应组件的环境变量信息。
在回显信息中,查看已加载模块的环境信息变量是否均存在。