鲲鹏社区首页
中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助

设置环境变量(setvars.sh方式)

操作步骤

  1. 使用PuTTY工具,登录HPCKit的安装节点。
  2. 执行以下命令,进入HPCKit安装目录。

    cd /opt/HPCKit/latest

    /opt:HPCKit的默认安装目录,请替换为实际路径。

  3. 执行以下命令,配置环境变量信息。

    source setvars.sh 参数名称

    该命令默认配置gcc版本组件的环境变量信息。

    参数名称为可选,具体请参见具体请参见表1

    表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),如果该参数需要保持原来的非默认值,需同时修改参数值。举例如下。

    • 由gcc切换为毕昇编译器时,如果需要使kml_kblas的非默认值保持不变,例如仍为locking,执行以下命令。

      source setvars.sh --use-bisheng --kml_kblas =locking --force

    • 仅修改kml_kblas、kml_kspblas和kml_kvml中的一个参数时,另外两个参数如需保持原来的非默认值,需要同时修改,执行以下命令。

      source setvars.sh --kml_kvml =multi --kml_kspblas =single

  4. 执行以下命令,查询环境变量信息。
    • 使用毕昇编译器编译组件时

      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