适用系统

Ubuntu 22.04；Ubuntu 24.04 可参考，命令和依赖版本需按实际环境调整

编译体系

AMD AOCC 3.2.0 + AOCL 3.2.0 + AOCC 编译的 OpenMPI 4.1.4

编译目标

vasp_std / vasp_gam / vasp_ncl，以及独立的 vasp_VTST

环境管理

Environment Modules 分层管理 compiler / math / mpi / env / vasp

文章定位

可操作安装教程 + 原理解释 + 高频故障排查 + 交付验收标准

本文的核心目标

不仅让命令能够执行，还要让读者学会确认：clang/flang 来自哪里、mpif90 背后调用谁、AOCL 库到底安装在哪个目录、最终可执行文件运行时是否仍有缺失动态库。

组件

作用

本流程中的要求

AOCC

提供 clang、clang++、flang

三个编译器必须来自同一 AOCC 安装目录

AOCL

提供 BLIS、libFLAME、ScaLAPACK、FFTW

链接路径以实际 find 结果为准，不照抄不存在的统一 lib 目录

OpenMPI

提供 mpicc、mpif90、mpirun

必须使用 AOCC 编译，mpif90 后端必须是 flang

VASP

生成 std、gam、ncl 三种主程序

makefile.include 只链接本套 AOCL 与 OpenMPI

VTST

为 NEB、Dimer 等过渡态功能提供源码补丁和脚本

复制原版源码后单独打补丁、单独编译

判断环境是否干净的关键命令

不要只看 which mpif90。还要执行 mpif90 --showme:command，确认 MPI wrapper 最终调用的是 AOCC flang，而不是 gfortran。

aocc-compiler-3.2.0.taraocl-linux-aocc-3.2.0.tar.gzopenmpi-4.1.4.tar.gzvasp.5.4.4.tar.gzvtstcode-179.tgzvtstscripts.tgz # 可选，VTST 辅助脚本potpaw_PBE*.tar.gz # 可选，合法赝势库

授权说明

VASP 源码与赝势库属于授权内容，必须由用户或机构从合法渠道取得。安装服务可以完成本地编译、环境配置和测试，但不应代替用户提供未授权源码或赝势。

/opt/software # 安装包与临时源码/opt/AMD # AOCL 等 AMD 软件/opt/openmpi/4.1.4-aocc # AOCC 编译的 OpenMPI/opt/vasp/vasp.5.4.4 # VASP 原版源码/opt/vasp/vasp.5.4.4-vtst # VASP + VTST 源码/opt/vasp/potpaw_PBE # PBE 赝势库示例/opt/vtst/vtstcode-179 # VTST 编译补丁/opt/vtst/vtstscripts # VTST 辅助脚本/opt/modulefiles # modulefile 根目录

sudo apt updatesudo apt install -y \build-essential make perl python3 python3-pip \m4 autoconf automake libtool wget curl tar gzip bzip2 xz-utils \pkg-config libnuma-dev zlib1g-dev ca-certificates \environment-modulessource /etc/profile.d/modules.sh 2>/dev/null || \source /usr/share/modules/init/bashmodule --versionsudo mkdir -p /opt/software /opt/AMD /opt/openmpi /opt/vasp /opt/vtst /opt/modulefiles

cd /opt/softwaretar -xvf aocc-compiler-3.2.0.tarcd aocc-compiler-3.2.0./install.sh# 安装器通常会生成环境初始化脚本，路径以实际结果为准source /opt/software/setenv_AOCC.shwhich clangwhich clang++which flangclang --versionflang --versionreadlink -f "$(which clang)"readlink -f "$(which flang)"

不要跳过 flang 独立测试

OpenMPI configure 失败时，先用 flang 编译一个最小 Fortran 程序。如果编译器本身无法生成并运行程序，继续排查 OpenMPI 没有意义。

cat > /tmp/test_aocc.f90 <<'EOF'program mainprint *, "AOCC Fortran works"end program mainEOFflang /tmp/test_aocc.f90 -o /tmp/test_aocc/tmp/test_aocc

cd /opt/softwaretar -zxvf aocl-linux-aocc-3.2.0.tar.gzcd aocl-linux-aocc-3.2.0./install.sh -t /opt/AMD# 某些版本提供统一环境脚本source /opt/AMD/3.2.0/amd-libs.cfg 2>/dev/null || truefind /opt/AMD -name "libblis.so*" -o -name "libblis.a"find /opt/AMD -name "libflame.so*" -o -name "libflame.a"find /opt/AMD -name "libscalapack.so*" -o -name "libscalapack.a"find /opt/AMD -name "libfftw3.so*" -o -name "libfftw3.a"find /opt/AMD -name "fftw3.f" -o -name "fftw3.h"

变量

常见路径

对应库

AMDBLIS_LIB

/opt/AMD/3.2.0/amd-blis/lib

libblis

AMDLIBFLAME_LIB

/opt/AMD/3.2.0/amd-libflame/lib

libflame

AMDSCALAPACK_LIB

/opt/AMD/3.2.0/amd-scalapack/lib

libscalapack

AMDFFTW_LIB

/opt/AMD/3.2.0/amd-fftw/lib

libfftw3

AMDFFTW_INC

/opt/AMD/3.2.0/amd-fftw/include

fftw3.h / fftw3.f

sudo mkdir -p /opt/modulefiles/compiler/aoccsudo tee /opt/modulefiles/compiler/aocc/3.2.0 >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "AMD AOCC 3.2.0 compiler"}module-whatis "AMD AOCC 3.2.0 compiler"# 按 readlink -f $(which clang) 的结果修改set root /opt/software/aocc-compiler-3.2.0setenv AOCC_ROOT $rootprepend-path PATH $root/binprepend-path LD_LIBRARY_PATH $root/libprepend-path LIBRARY_PATH $root/libsetenv CC clangsetenv CXX clang++setenv FC flangsetenv F77 flangEOF

sudo mkdir -p /opt/modulefiles/math/aoclsudo tee /opt/modulefiles/math/aocl/3.2.0-aocc >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "AMD AOCL 3.2.0 libraries for AOCC"}module-whatis "AMD AOCL 3.2.0 for AOCC"set root /opt/AMD/3.2.0setenv AOCL_ROOT $rootprepend-path LD_LIBRARY_PATH $root/amd-blis/libprepend-path LD_LIBRARY_PATH $root/amd-libflame/libprepend-path LD_LIBRARY_PATH $root/amd-scalapack/libprepend-path LD_LIBRARY_PATH $root/amd-fftw/libprepend-path LIBRARY_PATH $root/amd-blis/libprepend-path LIBRARY_PATH $root/amd-libflame/libprepend-path LIBRARY_PATH $root/amd-scalapack/libprepend-path LIBRARY_PATH $root/amd-fftw/libprepend-path CPATH $root/amd-fftw/includeEOFmodule use /opt/modulefilesmodule purgemodule load compiler/aocc/3.2.0 math/aocl/3.2.0-aoccwhich clangwhich flangecho "$AOCL_ROOT"

路径必须以当前服务器为准

如果 find 命令得到的 AOCL 目录不同，应同步修改 modulefile。module load 成功不等于路径正确，最终还要用 ls、ldd 和链接测试确认库文件确实存在。

cd /opt/softwaretar -zxvf openmpi-4.1.4.tar.gzcd openmpi-4.1.4module purgemodule use /opt/modulefilesmodule load compiler/aocc/3.2.0unset CFLAGS CXXFLAGS FFLAGS FCFLAGS LDFLAGS LIBShash -rAOCC_CC=$(readlink -f "$(which clang)")AOCC_CXX=$(readlink -f "$(which clang++)")AOCC_FC=$(readlink -f "$(which flang)")./configure \--prefix=/opt/openmpi/4.1.4-aocc \CC="$AOCC_CC" CXX="$AOCC_CXX" FC="$AOCC_FC" F77="$AOCC_FC" \--enable-mpi-fortran=allmake -j"$(nproc)"sudo mkdir -p /opt/openmpi/4.1.4-aoccsudo chown -R "$USER":"$USER" /opt/openmpi/4.1.4-aoccmake install

为什么不建议 sudo make install

sudo 可能清除当前 AOCC 的 PATH 和 LD_LIBRARY_PATH，导致安装阶段突然出现 clang: command not found。更稳妥的方式是预先创建目标目录并授予安装用户写权限。

sudo mkdir -p /opt/modulefiles/mpi/openmpisudo tee /opt/modulefiles/mpi/openmpi/4.1.4-aocc >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "OpenMPI 4.1.4 built with AOCC 3.2.0"}module-whatis "OpenMPI 4.1.4 AOCC build"prereq compiler/aocc/3.2.0set root /opt/openmpi/4.1.4-aoccsetenv MPI_HOME $rootprepend-path PATH $root/binprepend-path LD_LIBRARY_PATH $root/libprepend-path LIBRARY_PATH $root/libprepend-path CPATH $root/includeprepend-path MANPATH $root/share/manEOFmodule purgemodule use /opt/modulefilesmodule load compiler/aocc/3.2.0 mpi/openmpi/4.1.4-aoccwhich mpiccwhich mpif90which mpirunmpif90 --showme:commandmpirun --version

合格标准

mpicc、mpif90、mpirun 应位于 /opt/openmpi/4.1.4-aocc/bin；mpif90 --showme:command 应显示 flang 或 AOCC flang 的完整路径。若显示 gfortran，必须停止并清理环境。

sudo mkdir -p /opt/modulefiles/env/aoccsudo tee /opt/modulefiles/env/aocc/3.2.0 >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "AOCC 3.2.0 + AOCL 3.2.0 + OpenMPI 4.1.4"}module-whatis "Unified AMD HPC build environment"module load compiler/aocc/3.2.0module load math/aocl/3.2.0-aoccmodule load mpi/openmpi/4.1.4-aoccsetenv OMP_NUM_THREADS 1EOFmodule purgemodule use /opt/modulefilesmodule load env/aocc/3.2.0module listwhich clangwhich flangwhich mpif90mpif90 --showme:command

cd /opt/vasptar -zxvf /opt/software/vasp.5.4.4.tar.gzfind /opt/vasp -maxdepth 4 -type f -name makefile# 进入同时包含 arch、src、makefile 的真实目录cd /opt/vasp/vasp.5.4.4ls arch src makefile

# ============================================================# VASP 5.4.4 - Ubuntu 22.04# AOCC 3.2.0 + AOCL 3.2.0 + OpenMPI 4.1.4# ============================================================CPP_OPTIONS = -DHOST=\"LinuxAOCC\" \-DMPI -DMPI_BLOCK=8000 -Duse_collective \-DscaLAPACK -DCACHE_SIZE=4000 \-Davoidalloc -Dtbdyn -Dfock_dblbuf -DLAPACK36CPP = clang -E -C -w $*$(FUFFIX) >$*$(SUFFIX) $(CPP_OPTIONS)FC = mpif90FCL = mpif90FREE = -MfreeFFLAGS = -w -Mfree -MbackslashOFLAG = -O2OFLAG_IN = $(OFLAG)DEBUG = -O0# 仅在同型号或兼容 AMD CPU 节点运行时保留VASP_TARGET_CPU ?= -march=nativeFFLAGS += $(VASP_TARGET_CPU)CPP_LIB = $(CPP)FC_LIB = $(FC)CC_LIB = clangCFLAGS_LIB = -O2FFLAGS_LIB = -O1FREE_LIB = $(FREE)OBJECTS_LIB = linpack_double.o getshmem.oCXX_PARS = clang++LIBS += parserLLIBS += -Lparser -lparser -lstdc++AMDBLIS_LIB = /opt/AMD/3.2.0/amd-blis/libAMDLIBFLAME_LIB = /opt/AMD/3.2.0/amd-libflame/libAMDSCALAPACK_LIB = /opt/AMD/3.2.0/amd-scalapack/libAMDFFTW_LIB = /opt/AMD/3.2.0/amd-fftw/libAMDFFTW_INC = /opt/AMD/3.2.0/amd-fftw/includeINCS += -I$(AMDFFTW_INC)BLAS = -L$(AMDBLIS_LIB) -lblisLAPACK = -L$(AMDLIBFLAME_LIB) -lflameSCALAPACK = -L$(AMDSCALAPACK_LIB) -lscalapackLLIBS += $(SCALAPACK) $(LAPACK) $(BLAS)LLIBS += -L$(AMDFFTW_LIB) -lfftw3LLIBS += -lm -ldl -lpthreadOBJECTS = fftmpiw.o fftmpi_map.o fftw3d.o fft3dlib.oOBJECTS_O1 += fftw3d.o fftmpiw.o fftmpi.oOBJECTS_O2 += fft3dlib.o

两点必须根据实际环境调整

第一，AOCL 的五个路径以 find 结果为准；第二，-march=native 只适合编译节点与计算节点 CPU 指令集兼容的场景。异构集群应删除该选项或改用更保守的目标架构。

module purgemodule use /opt/modulefilesmodule load env/aocc/3.2.0cd /opt/vasp/vasp.5.4.4unset MAKEFLAGSmake veryclean 2>/dev/null || truerm -rf build/std build/gam build/ncl build/lib build/parserrm -f bin/vasp_std bin/vasp_gam bin/vasp_nclmake std -j1 2>&1 | tee build_std_aocc.logmake gam -j1 2>&1 | tee build_gam_aocc.logmake ncl -j1 2>&1 | tee build_ncl_aocc.logls -lh bin/vasp_std bin/vasp_gam bin/vasp_ncl

可执行文件

主要用途

典型调用

vasp_std

常规结构优化、自洽、能带、DOS、分子动力学等

mpirun -np 16 vasp_std

vasp_gam

大超胞且仅使用 Gamma 点

mpirun -np 16 vasp_gam

vasp_ncl

SOC、非共线磁性等

mpirun -np 16 vasp_ncl

sudo mkdir -p /opt/modulefiles/vaspsudo tee /opt/modulefiles/vasp/5.4.4-aocc >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "VASP 5.4.4 built with AOCC/AOCL/OpenMPI"}module-whatis "VASP 5.4.4 AOCC build"conflict vaspif { [module-info mode load] } {module load env/aocc/3.2.0}set root /opt/vasp/vasp.5.4.4setenv VASP_HOME $rootsetenv VASP_PP_PATH /opt/vaspsetenv PMG_VASP_PSP_DIR /opt/vaspsetenv OMP_NUM_THREADS 1setenv OMP_STACKSIZE 512mprepend-path PATH $root/binEOFmodule purgemodule use /opt/modulefilesmodule load vasp/5.4.4-aoccwhich vasp_stdwhich vasp_gamwhich vasp_nclwhich mpirunmpif90 --showme:commandldd "$(which vasp_std)" | grep "not found" || echo "runtime libraries OK"

# 单元素 Sicat /opt/vasp/potpaw_PBE/Si/POTCAR > POTCAR# 例如 SrTiO3，POSCAR 元素顺序为 Sr Ti Ocat /opt/vasp/potpaw_PBE/Sr_sv/POTCAR \/opt/vasp/potpaw_PBE/Ti_pv/POTCAR \/opt/vasp/potpaw_PBE/O/POTCAR > POTCARgrep TITEL POTCAR

mkdir -p ~/vasp_test/Si-aocccd ~/vasp_test/Si-aocccat > INCAR <<'EOF'SYSTEM = Si testENCUT = 300EDIFF = 1E-5ISMEAR = 0SIGMA = 0.05IBRION = -1NSW = 0EOFcat > POSCAR <<'EOF'Si5.430.0 0.5 0.50.5 0.0 0.50.5 0.5 0.0Si2Direct0.00 0.00 0.000.25 0.25 0.25EOFcat > KPOINTS <<'EOF'Automatic mesh0Gamma4 4 40 0 0EOFcat /opt/vasp/potpaw_PBE/Si/POTCAR > POTCARmodule purgemodule use /opt/modulefilesmodule load vasp/5.4.4-aocculimit -s unlimitedmpirun -np 4 vasp_std > vasp.outtail -n 40 vasp.outgrep "Voluntary context switches" OUTCAR

为什么不能只检查 which vasp_std

可执行文件存在只能证明编译产物被复制到了 PATH。完整验收至少还应包括 ldd 无 not found、MPI 多进程启动、读取完整输入文件、生成 OUTCAR/OSZICAR，并正常结束。

sudo mkdir -p /opt/vtstsudo tar -xzf /opt/software/vtstcode-179.tgz -C /opt/vtstsudo tar -xzf /opt/software/vtstscripts.tgz -C /opt/vtst 2>/dev/null || truesudo chmod +x /opt/vtst/vtstscripts/* 2>/dev/null || truecd /opt/vaspcp -a vasp.5.4.4 vasp.5.4.4-vtstcd vasp.5.4.4-vtstmake veryclean 2>/dev/null || truerm -rf build/std build/gam build/ncl build/lib build/parserrm -f bin/vasp_std bin/vasp_gam bin/vasp_ncl bin/vasp_VTSTcp -n src/main.F src/main.F.originalcp -n src/.objects src/.objects.originalcp /opt/vtst/vtstcode-179/* src/

# src/main.F 中将CALL CHAIN_FORCE(T_INFO%NIONS,DYN%POSION,TOTEN,TIFOR, &LATT_CUR%A,LATT_CUR%B,IO%IU6)# 改为CALL CHAIN_FORCE(T_INFO%NIONS,DYN%POSION,TOTEN,TIFOR, &TSIF,LATT_CUR%A,LATT_CUR%B,IO%IU6)# src/.objects 中，在 chain.o 之前加入bfgs.o dynmat.o instanton.o lbfgs.o sd.o cg.o dimer.o bbm.o \fire.o lanczos.o neb.o qm.o opt.o \

module purgemodule use /opt/modulefilesmodule load env/aocc/3.2.0cd /opt/vasp/vasp.5.4.4-vtst# 继续使用已经验证成功的 AMD makefile.includemake std -j1 2>&1 | tee build_vtst_std_aocc.logcp bin/vasp_std bin/vasp_VTSTchmod 755 bin/vasp_VTSTwhich nebmake.pl 2>/dev/null || trueldd bin/vasp_VTST | grep "not found" || echo "VTST runtime libraries OK"

不要把 VTST 当成独立软件

vasp_VTST 只是对完成 VTST patch 的 vasp_std 进行明确命名，便于与原版区分。没有复制源码、修改 main.F/.objects 并重新编译，仅复制可执行文件名称不会增加任何 VTST 功能。

sudo tee /opt/modulefiles/vasp/5.4.4-vtst-aocc >/dev/null <<'EOF'#%Module1.0proc ModulesHelp { } {puts stderr "VASP 5.4.4 + VTST built with AOCC/AOCL/OpenMPI"}module-whatis "VASP 5.4.4 + VTST AOCC build"conflict vaspif { [module-info mode load] } {module load env/aocc/3.2.0}set root /opt/vasp/vasp.5.4.4-vtstset scripts /opt/vtst/vtstscriptssetenv VASP_HOME $rootsetenv VTST_SCRIPTS $scriptssetenv VASP_PP_PATH /opt/vaspsetenv OMP_NUM_THREADS 1prepend-path PATH $root/binprepend-path PATH $scriptsEOFmodule purgemodule use /opt/modulefilesmodule load vasp/5.4.4-vtst-aoccwhich vasp_VTSTwhich nebmake.plmpif90 --showme:command

#!/bin/bash#SBATCH -J vasp-aocc-test#SBATCH -N 1#SBATCH --ntasks-per-node=32#SBATCH -p compute#SBATCH -o vasp.out#SBATCH -e vasp.errsource /etc/profile.d/modules.sh 2>/dev/null || truemodule purgemodule use /opt/modulefilesmodule load vasp/5.4.4-aoccexport OMP_NUM_THREADS=1ulimit -s unlimitedsrun vasp_std

报错或现象

常见原因

优先检查

checking if Fortran compiler works... no

flang 本身不可用，或环境变量混入旧参数

先独立编译 test.f90，再查 config.log

gfortran: unrecognized option '-Mfree'

实际使用 GNU Fortran，却加载了 AOCC 参数

清理环境，确认 mpif90 后端为 flang

C and C++ are link compatible... no

clang 与系统 g++ 混用

同时使用 clang/clang++，清理 PATH

make install: clang not found

sudo 清理了 AOCC 环境

避免 sudo make install，或显式传递环境

mpif90 后端显示 gfortran

加载了错误的 OpenMPI

module purge 后只加载 AOCC MPI

cannot find -lblis/-lflame/-lscalapack

AOCL 路径照抄错误

使用 find 查询真实库目录

getshmem_C 等未定义

内部库缺少 getshmem.o

检查 OBJECTS_LIB 并清理重编

parse_file_C 等未定义

parser 未编译或未链接

检查 CXX_PARS、LIBS、LLIBS

undefined reference to dgegv_

LAPACK 接口兼容问题

启用 -DLAPACK36，必要时修改 symbol.inc

Cannot open module file *.mod

并行 make 破坏 Fortran 编译顺序

删除 build 后 make std -j1

module purgemodule use /opt/modulefilesmodule load compiler/aocc/3.2.0unset FC F77 FFLAGS FCFLAGS CFLAGS CXXFLAGS LDFLAGS LIBShash -rwhich clangwhich clang++which flangflang /tmp/test_aocc.f90 -o /tmp/test_aocc && /tmp/test_aoccgrep -n -B 50 -A 80 "checking if Fortran compiler works" config.log

module purgemodule use /opt/modulefilesmodule load env/aocc/3.2.0which mpif90mpif90 --showme:commandmpif90 --showme# 结果必须指向 AOCC flang，而不是 gfortran

能力

应完成的工作

专业价值

安装包预检

检查 AOCC、AOCL、OpenMPI、VASP、VTST 文件是否存在

避免运行到中途才发现缺包

编译器探测

记录 clang、clang++、flang 的真实路径与版本

防止系统 LLVM 或 GNU 工具链混入

AOCL 路径识别

自动定位 BLIS、libFLAME、ScaLAPACK、FFTW

适配不同 AOCL 安装目录

MPI 后端验证

检查 mpif90 --showme:command 是否为 flang

阻止错误 MPI 继续编译 VASP

配置生成

基于真实路径生成 makefile.include 与 modulefile

避免手工照抄路径

日志与失败退出

保存 configure/make 日志，任一步失败立即停止

便于定位和复现

分版本隔离

原版与 VTST 版使用独立源码、bin 和 modulefile

防止补丁覆盖原版

三级验收

检查 which、ldd、MPI 启动和最小算例

证明程序不仅“编译出来”，而且可以运行

我们的一键安装与远程服务

云算科技可根据服务器 CPU、操作系统、现有 MPI/编译器环境和集群调度方式，使用脚本完成自动化部署，并保留关键配置、编译日志、modulefile 与验收结果。服务不包含未授权 VASP 源码或赝势的提供。

检查对象

验收命令或要求

合格结果

AOCC

which clang; which flang

均来自 AOCC 安装目录

OpenMPI

which mpif90; mpif90 --showme:command

位于 4.1.4-aocc，后端为 flang

AOCL

find/ls 检查四类数学库

BLIS、libFLAME、ScaLAPACK、FFTW 均存在

原版 VASP

which vasp_std/gam/ncl

三者来自原版 VASP bin

运行库

ldd $(which vasp_std)

没有 not found

MPI 运行

mpirun -np 4 vasp_std

能够启动多进程并读取输入

测试算例

OUTCAR/OSZICAR/vasprun.xml

正常生成并结束

VTST 可选

which vasp_VTST; which nebmake.pl

可执行文件与脚本来自独立 VTST 环境

环境切换

module purge 后重新加载

不依赖杂乱的永久 PATH

交付时建议保留

成功使用的 makefile.include、modulefile、编译日志、版本信息、最小测试输入与输出摘要。它们既是验收依据，也是后续升级、迁移和故障恢复的重要资料。