设置环境变量(setvars.sh方式)
操作步骤
- 使用PuTTY工具,登录HPCKit的安装节点。
- 执行以下命令,进入HPCKit安装目录。
cd /opt/HPCKit/latest
/opt:HPCKit的默认安装目录,请替换为实际路径。
- 执行以下命令,配置环境变量信息。
source setvars.sh 参数名称
表1 参数介绍 参数名称
参数值
说明
--use-bisheng
不涉及
- 配置添加该参数,添加已安装组件bisheng版本的相关信息到环境变量中。
--force
不涉及
配置该参数,可以强制执行setvars.sh。
说明:如果之前已经执行过setvars.sh,再次执行会提示setvars.sh已经执行过。
--kml_kblas
locking
添加组件KML子库kblas单线程加锁动态库路径到环境变量LD_LIBRARY_PATH中。
单独配置该参数,需要同时配置--kml_kspblas和--kml_kvml。
nolocking
添加组件KML子库kblas单线程不加锁动态库路径到环境变量LD_LIBRARY_PATH中。
单独配置该参数,需要同时配置--kml_kspblas和--kml_kvml。
omp
添加组件KML子库kblas OpenMP实现多线程动态库路径到环境变量LD_LIBRARY_PATH中。
单独配置该参数,需要同时配置--kml_kspblas和--kml_kvml。
pthread(默认值)
默认值。
添加组件KML子库kblas pthread实现多线程动态库路径到环境变量LD_LIBRARY_PATH中。
--kml_kspblas
multi(默认值)
默认值。
添加组件KML子库kspblas多线程动态库路径到环境变量LD_LIBRARY_PATH中。
single
添加组件KML子库kspblas单线程动态库路径到环境变量LD_LIBRARY_PATH中。
单独配置该参数,需要同时配置--kml_kblas和--kml_kvml。
--kml_kvml
multi
添加组件KML子库kvml多线程动态库路径到环境变量LD_LIBRARY_PATH中。
单独配置该参数,需要同时配置--kml_kblas和--kml_kspblas。
single(默认值)
添加组件KML子库kvml单线程动态库路径到环境变量LD_LIBRARY_PATH中。
--help
不涉及
查看“source setvars.sh 参数名称”命令的使用说明。
每次执行source setvars.sh命令时,kml_kblas、kml_kspblas和kml_kvml值都会被重置为该参数的默认值(见表1),如果该参数需要保持原来的非默认值,需同时修改参数值。举例如下。
- 执行以下命令,查询环境变量信息。
- 使用毕昇编译器编译组件时
echo $LD_LIBRARY_PATH; echo $PATH; echo $CPATH; echo $INCLUDE; echo $OPAL_PREFIX; echo $CC; echo $CXX; echo $FC; echo $F77; echo $F90
环境变量参数含义具体如下:
- LD_LIBRARY_PATH:动态链接库的搜索路径。
- PATH:可执行程序的搜索路径。
- CPATH:KML组件的头文件路径。
- INCLUDE:Hyper MPI中ompi、ucx和ucg组件的头文件路径,以及KML组件的头文件路径。
- OPAL_PREFIX:Hyper MPI中ompi组件的安装目录。
- CC:编译C语言程序的编译器名称,值为clang。
- CXX:编译C++程序的编译器名称,值为clang++。
- FC:编译Fortran程序的编译器名称,值为flang。
- F77:编译Fortran77程序的编译器名称,值为flang。
- F90:编译Fortran90程序的编译器名称,值为flang。
回显信息示例:
/opt/HPCKit/24.3.30/kml/bisheng/lib/kvml/single:/opt/HPCKit/24.3.30/kml/bisheng/lib/kspblas/multi:/opt/HPCKit/24.3.30/kml/bisheng/lib/kblas/pthread:/opt/HPCKit/24.3.30/kml/bisheng/lib:/opt/HPCKit/24.3.30/hmpi/bisheng/ompi/lib:/opt/HPCKit/24.3.30/hmpi/bisheng/ucx/lib:/opt/HPCKit/24.3.30/hmpi/bisheng/ucg/lib:/opt/HPCKit/24.3.30/compiler/bisheng/lib:/usr/local/lib /opt/HPCKit/24.3.30/hmpi/bisheng/ompi/bin:/opt/HPCKit/24.3.30/hmpi/bisheng/ucx/bin:/opt/HPCKit/24.3.30/hmpi/bisheng/ucg/bin:/opt/HPCKit/24.3.30/compiler/bisheng/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin /opt/HPCKit/24.3.30/kml/bisheng/include: /opt/HPCKit/24.3.30/kml/bisheng/include:/opt/HPCKit/24.3.30/hmpi/bisheng/ompi/include:/opt/HPCKit/24.3.30/hmpi/bisheng/ucx/include:/opt/HPCKit/24.3.30/hmpi/bisheng/ucg/include: /opt/HPCKit/24.3.30/hmpi/bisheng/ompi clang clang++ flang flang flang
- 使用GCC编译器编译组件时
echo $LD_LIBRARY_PATH; echo $PATH; echo $CPATH; echo $INCLUDE; echo $OPAL_PREFIX; echo $CC; echo $CXX; echo $FC; echo $F77; echo $F90
环境变量参数含义具体如下:
- LD_LIBRARY_PATH:动态链接库的搜索路径。
- PATH:可执行程序的搜索路径。
- CPATH:KML组件的头文件路径。
- INCLUDE:Hyper MPI中ompi、ucx和ucg组件的头文件路径,以及KML组件的头文件路径。
- OPAL_PREFIX:Hyper MPI中ompi组件的安装目录。
- CC:编译C语言程序的编译器名称,值为gcc。
- CXX:编译C++程序的编译器名称,值为g++。
- FC:编译Fortran程序的编译器名称,值为gfortran。
- F77:编译Fortran77程序的编译器名称,值为gfortran。
- F90:编译Fortran90程序的编译器名称,值为gfortran。
回显信息示例:
/opt/HPCKit/24.3.30/kml/gcc/lib/kvml/single:/opt/HPCKit/24.3.30/kml/gcc/lib/kspblas/multi:/opt/HPCKit/24.3.30/kml/gcc/lib/kblas/pthread:/opt/HPCKit/24.3.30/kml/gcc/lib:/opt/HPCKit/24.3.30/hmpi/gcc/ompi/lib:/opt/HPCKit/24.3.30/hmpi/gcc/ucx/lib:/opt/HPCKit/24.3.30/hmpi/gcc/ucg/lib:/opt/HPCKit/24.3.30/compiler/gcc/lib64:/usr/local/lib /opt/HPCKit/24.3.30/hmpi/gcc/ompi/bin:/opt/HPCKit/24.3.30/hmpi/gcc/ucx/bin:/opt/HPCKit/24.3.30/hmpi/gcc/ucg/bin:/opt/HPCKit/24.3.30/compiler/gcc/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin /opt/HPCKit/24.3.30/kml/gcc/include: /opt/HPCKit/24.3.30/kml/gcc/include:/opt/HPCKit/24.3.30/hmpi/gcc/ompi/include:/opt/HPCKit/24.3.30/hmpi/gcc/ucx/include:/opt/HPCKit/24.3.30/hmpi/gcc/ucg/include: /opt/HPCKit/24.3.30/hmpi/gcc/ompi gcc g++ gfortran gfortran gfortran
- 使用毕昇编译器编译组件时