Ubuntu 22.04 下 VASP 5.4.4 保姆级编译指南：从依赖库到并行测试

Ubuntu 22.04 下 VASP 5.4.4 完整编译实战：从零构建量子化学计算环境

量子化学计算软件VASP（Vienna Ab initio Simulation Package）是材料科学和凝聚态物理研究的重要工具。对于刚接触Linux环境的研究人员来说，从源码编译VASP往往是一场充满挑战的旅程。本文将带你完整走过这段旅程，不仅解决编译过程中的各种"坑"，还会深入解析每个关键步骤背后的原理。

1. 环境准备与系统配置

在开始编译VASP之前，我们需要确保系统环境满足所有基础要求。Ubuntu 22.04 LTS是一个稳定的起点，但默认安装的软件包可能不完全符合科学计算的需求。

首先更新系统并安装基础开发工具：

sudo apt update && sudo apt upgrade -y sudo apt install -y build-essential cmake git wget

VASP编译需要特定版本的Fortran编译器。虽然Ubuntu 22.04默认提供gfortran-11，但为了更好的兼容性，我们建议安装gfortran-9：

sudo apt install -y gfortran-9 gcc-9 g++-9

设置默认编译器版本：

sudo update-alternatives --install /usr/bin/gfortran gfortran /usr/bin/gfortran-9 100 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 100 sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 100

验证编译器版本：

gfortran --version gcc --version g++ --version

输出应显示版本号为9.x系列。如果显示其他版本，可以手动切换：

sudo update-alternatives --config gfortran sudo update-alternatives --config gcc sudo update-alternatives --config g++

2. 依赖库的编译与安装

VASP依赖于多个数学计算库，这些库的编译顺序和配置方式直接影响最终VASP的编译结果。我们将逐个解决这些依赖关系。

2.1 BLAS库编译

BLAS(Basic Linear Algebra Subprograms)是线性代数计算的基础库。从源码编译可以获得最佳性能：

wget http://www.netlib.org/blas/blas-3.10.0.tgz tar -zxvf blas-3.10.0.tgz cd BLAS-3.10.0

编译BLAS库：

gfortran -c -O3 -fPIC *.f ar rv libblas.a *.o sudo cp libblas.a /usr/local/lib/

注意：-fPIC选项生成位置无关代码，这对后续库的链接很重要。

2.2 CBLAS库的特殊处理

CBLAS是BLAS的C语言接口，编译时经常遇到类型不匹配的警告。我们需要修改Makefile来解决这个问题：

wget http://www.netlib.org/blas/blast-forum/cblas.tgz tar -zxvf cblas.tgz cd CBLAS

复制并修改Makefile：

cp Makefile.LINUX Makefile.in sed -i 's/F77 = g77/F77 = gfortran/' Makefile.in sed -i 's/F77FLAGS = -O2/F77FLAGS = -O2 -fallow-argument-mismatch/' Makefile.in

关键修改是添加-fallow-argument-mismatch选项，这可以避免新版gfortran的严格类型检查导致的编译错误。

继续完成编译：

cp ../BLAS-3.10.0/libblas.a testing/ make sudo cp lib/cblas_LINUX.a /usr/local/lib/libcblas.a

2.3 LAPACK库的完整编译

LAPACK(Linear Algebra Package)构建在BLAS之上，提供更高级的线性代数运算。编译时需要特别注意配置文件：

wget http://www.netlib.org/lapack/lapack-3.10.1.tgz tar -zxvf lapack-3.10.1.tgz cd lapack-3.10.1

准备编译配置：

cp make.inc.example make.inc

修改make.inc文件中的以下关键参数：

BLASLIB = /usr/local/lib/libblas.a CBLASLIB = /usr/local/lib/libcblas.a LAPACKLIB = liblapack.a TMGLIB = libtmglib.a LAPACKELIB = liblapacke.a

开始编译：

make -j$(nproc)

编译完成后安装库文件和头文件：

sudo cp *.a /usr/local/lib/ cd LAPACKE && sudo cp include/*.h /usr/local/include/

2.4 ScaLAPACK的MPI支持

ScaLAPACK(Scalable LAPACK)是LAPACK的并行版本，需要MPI支持。首先安装MPI开发包：

sudo apt install -y libopenmpi-dev openmpi-bin

然后编译ScaLAPACK：

wget https://github.com/Reference-ScaLAPACK/scalapack/archive/refs/tags/v2.2.0.tar.gz tar -zxvf v2.2.0.tar.gz cd scalapack-2.2.0

准备编译配置：

cp SLmake.inc.example SLmake.inc

修改SLmake.inc中的以下参数：

BLASLIB = -L/usr/local/lib -lblas LAPACKLIB = -L/usr/local/lib -llapack

开始编译：

make -j$(nproc) sudo cp libscalapack.a /usr/local/lib/

3. FFTW3的安装与配置

VASP需要FFTW3库进行快速傅里叶变换计算。虽然可以通过apt安装，但从源码编译可以获得更好的性能：

wget http://www.fftw.org/fftw-3.3.10.tar.gz tar -zxvf fftw-3.3.10.tar.gz cd fftw-3.3.10

配置和编译：

./configure --enable-float --enable-sse2 --enable-avx --enable-avx2 --enable-shared make -j$(nproc) sudo make install

提示：--enable-float选项生成单精度版本，这对VASP的性能很重要。

4. VASP源码编译实战

准备好所有依赖后，我们可以开始编译VASP本身。这个过程需要特别注意makefile的配置。

4.1 源码准备与补丁应用

假设已经获得VASP 5.4.4源码包，解压并应用补丁：

unzip vasp.5.4.4.zip tar -xzvf vasp.5.4.4.tar.gz cd vasp.5.4.4 gunzip patch.5.4.4.16052018.gz patch -p0 < ../patch.5.4.4.16052018

4.2 makefile.include的关键配置

复制并修改适合Linux的makefile模板：

cp arch/makefile.include.linux_gnu makefile.include

需要修改的关键参数包括：

# 编译器设置 FC = mpif90 FCL = mpif90 # 数学库设置 BLAS = -L/usr/local/lib -lblas LAPACK = -L/usr/local/lib -llapack SCALAPACK = -L/usr/local/lib -lscalapack # FFTW设置 FFTW_ROOT ?= /usr/local INCS += -I$(FFTW_ROOT)/include LIBS += -L$(FFTW_ROOT)/lib -lfftw3f

4.3 解决常见编译错误

在编译过程中可能会遇到以下典型问题及解决方案：

1. 未定义的引用错误：

   undefined reference to `dgelsy_'

   解决方法：确保LAPACK库路径正确，并在makefile.include中添加-llapack

2. MPI相关错误：

   mpif90: command not found

   解决方法：安装openmpi包并确保在PATH中

3. FFTW找不到错误：

   Cannot find fftw3.h

   解决方法：明确指定FFTW_ROOT路径或安装fftw开发包

4.4 完整编译过程

开始完整编译：

make all -j$(nproc)

编译成功后，bin目录下应生成三个可执行文件：

• vasp_gam：Gamma点版本
• vasp_std：标准版本
• vasp_ncl：非共线版本

5. 系统集成与性能测试

为了便于使用，我们可以将VASP集成到系统路径中：

sudo mkdir -p /opt/vasp/5.4.4 sudo cp bin/* /opt/vasp/5.4.4/

设置环境变量：

echo 'export PATH=/opt/vasp/5.4.4:$PATH' >> ~/.bashrc source ~/.bashrc

5.1 并行计算测试

准备一个简单的测试案例，例如Si晶体结构计算。创建包含以下内容的INCAR文件：

System = Si ISTART = 0 ICHARG = 2 ENCUT = 240 EDIFF = 1E-05 ISMEAR = 0 SIGMA = 0.1

使用4个MPI进程运行测试：

mpirun -np 4 vasp_std

5.2 性能优化建议

根据系统配置，可以尝试以下优化方法：

1. 编译器优化：

   • 在makefile.include中添加-O3 -march=native优化选项
   • 考虑使用Intel编译器(ifort)可能获得更好性能

2. 数学库优化：

   • 使用OpenBLAS代替BLAS
   • 尝试MKL(Math Kernel Library)作为统一数学库

3. 并行配置：

   • 调整OMP_NUM_THREADS环境变量控制线程数
   • 在大型系统上混合使用MPI和OpenMP

6. 维护与更新

保持VASP环境的稳定性很重要，以下是一些维护建议：

1. 版本控制：

   cd /opt/vasp sudo tar -czvf vasp-5.4.4-$(date +%Y%m%d).tar.gz 5.4.4

2. 依赖库更新：

   • 定期检查数学库是否有安全更新
   • 重新编译依赖库时保持ABI兼容性

3. 环境隔离： 考虑使用容器技术(Docker/Singularity)封装VASP环境，便于迁移和复现

# 示例Dockerfile片段 FROM ubuntu:22.04 RUN apt-get update && apt-get install -y gfortran-9 openmpi-bin libopenmpi-dev COPY vasp_std /usr/local/bin

在实际科研工作中，一个稳定可靠的VASP环境能大幅提高工作效率。虽然初始设置过程复杂，但一次正确的配置可以长期使用。建议将整个配置过程文档化，便于日后维护或在其他机器上复现。