diff --git a/README.md b/README.md index 52e1eaf7..e2c34c9c 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,28 @@ This repository contains installation scripts for HPC images in Azure Marketplace. +## Preparing HPC Red Hat Enterprise Linux Image + +Red Hat publishes a collection of marketplace images for different +applications and licensing models. To use RHEL and get all the software and drivers +included in the azhpc-images we recommend that you build a custom image using +the scripts in this repository. + +The following usage has been verified using the RHEL 7.9 marketplace image +`RedHat:RHEL:79-gen2:7.9.2021121602` +and a Standard_NC6s_v2 VM. Create a VM with this configuration +and use the script contained in this project. + +```bash +sudo ./rhel-hpc-7_9-install.sh +``` + +Once this command is run successfully, then you can use the documented procedure +for [capturing a linux image](https://docs.microsoft.com/azure/virtual-machines/linux/capture-image). + +>Note: Accelerated Networking with IB networking isn't +supported in the RHEL-HPC prepared image. Use `AcceleratedNetworking = False`. + # Contributing diff --git a/rhel-hpc-7_9-install.sh b/rhel-hpc-7_9-install.sh new file mode 100644 index 00000000..742ed93c --- /dev/null +++ b/rhel-hpc-7_9-install.sh @@ -0,0 +1,25 @@ +#!/bin/bash +set -ex + +lvextend -L +5G /dev/mapper/rootvg-optlv +lvextend -L +5G /dev/mapper/rootvg-usrlv +lvextend -L +8G /dev/mapper/rootvg-tmplv + +xfs_growfs /dev/mapper/rootvg-optlv +xfs_growfs /dev/mapper/rootvg-usrlv +xfs_growfs /dev/mapper/rootvg-tmplv + +cd /mnt/ + +wget https://github.com/Azure/azhpc-images/archive/refs/heads/master.zip +unzip master.zip + +cd azhpc-images-master/centos/centos-7.x/centos-7.9-hpc/ + +# Allows to install to proceed without NVLink. +sed -i 's/systemctl start nvidia-fabricmanager/systemctl start nvidia-fabricmanager || echo "systemctl start nvidia-fabricmanager failed. Does this machine have NVSwitch?"/g' ../common/install_nvidiagpudriver.sh + +# AccelNet with IB is not supported for RedHat +sed -i 's/^$COMMON_DIR\/install_azure_persistent_rdma_naming.sh/#$COMMON_DIR\/install_azure_persistent_rdma_naming.sh/g' install.sh + +bash ./install.sh