RHEL 7.5

xCAT provides a sample package list (pkglist) files for CUDA. You can find them:

Diskful: /opt/xcat/share/xcat/install/rh/cuda*

Diskless: /opt/xcat/share/xcat/netboot/rh/cuda*

Diskful images

The following examples will create diskful images for cudafull and cudaruntime. The osimage definitions will be created from the base rhels7.5-ppc64le-install-compute osimage.

[Note]: There is a requirement to reboot the machine after the CUDA drivers are installed. To satisfy this requirement, the CUDA software is installed in the pkglist attribute of the osimage definition where a reboot will happen after the Operating System is installed.

cudafull

Create a copy of the install-compute image and label it cudafull:

lsdef -t osimage -z rhels7.5-ppc64le-install-compute \
  | sed 's/install-compute:/install-cudafull:/' \
  | mkdef -z

Add the CUDA repo created in the previous step to the pkgdir attribute:

chdef -t osimage -o rhels7.5-ppc64le-install-cudafull -p \
  pkgdir=/install/cuda-9.2/ppc64le/cuda-core,/install/cuda-9.2/ppc64le/cuda-deps

Use the provided cudafull pkglist to install the CUDA packages:

chdef -t osimage -o rhels7.5-ppc64le-install-cudafull \
  pkglist=/opt/xcat/share/xcat/install/rh/cudafull.rhels7.ppc64le.pkglist

cudaruntime

Create a copy of the install-compute image and label it cudaruntime:

lsdef -t osimage -z rhels7.5-ppc64le-install-compute \
  | sed 's/install-compute:/install-cudaruntime:/' \
  | mkdef -z

Add the CUDA repo created in the previous step to the pkgdir attribute:

chdef -t osimage -o rhels7.5-ppc64le-install-cudaruntime -p \
  pkgdir=/install/cuda-9.2/ppc64le/cuda-core,/install/cuda-9.2/ppc64le/cuda-deps

Use the provided cudaruntime pkglist to install the CUDA packages:

chdef -t osimage -o rhels7.5-ppc64le-install-cudaruntime \
  pkglist=/opt/xcat/share/xcat/instal/rh/cudaruntime.rhels7.ppc64le.pkglist

Diskless images

The following examples will create diskless images for cudafull and cudaruntime. The osimage definitions will be created from the base rhels7.5-ppc64le-netboot-compute osimage.

[Note]: For diskless, the install of the CUDA packages MUST be done in the otherpkglist and NOT the pkglist as with diskful. The requirement for rebooting the machine is not applicable in diskless nodes because the image is loaded on each reboot.

cudafull

Create a copy of the netboot-compute image and label it cudafull:

lsdef -t osimage -z rhels7.5-ppc64le-netboot-compute \
  | sed 's/netboot-compute:/netboot-cudafull:/' \
  | mkdef -z

Verify that the CUDA repo created in the previous step is available in the directory specified by the otherpkgdir attribute.

The otherpkgdir directory can be obtained by running lsdef on the osimage:
```
# lsdef -t osimage rhels7.5-ppc64le-netboot-cudafull -i otherpkgdir
Object name: rhels7.5-ppc64le-netboot-cudafull
    otherpkgdir=/install/post/otherpkgs/rhels7.5/ppc64le
```
Create a symbolic link of the CUDA repository in the directory specified by otherpkgdir
```
ln -s /install/cuda-9.2 /install/post/otherpkgs/rhels7.5/ppc64le/cuda-9.2
```

Change the rootimgdir for the cudafull osimage:

chdef -t osimage -o rhels7.5-ppc64le-netboot-cudafull \
   rootimgdir=/install/netboot/rhels7.5/ppc64le/cudafull

Create a custom pkglist file to install additional operating system packages for your CUDA node.

Copy the default compute pkglist file as a starting point:
mkdir -p /install/custom/netboot/rh/

cp /opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.pkglist \
  /install/custom/netboot/rh/cudafull.rhels7.ppc64le.pkglist
Edit the pkglist file and append any packages you desire to be installed. For example:
vi /install/custom/netboot/rh/cudafull.rhels7.ppc64le.pkglist
...
# Additional packages for CUDA
pciutils
Set the new file as the pkglist attribute for the cudafull osimage:
chdef -t osimage -o rhels7.5-ppc64le-netboot-cudafull \
  pkglist=/install/custom/netboot/rh/cudafull.rhels7.ppc64le.pkglist

Create the otherpkg.pkglist file to do the install of the CUDA full packages:

Create the otherpkg.pkglist file for cudafull:

vi /install/custom/netboot/rh/cudafull.rhels7.ppc64le.otherpkgs.pkglist
# add the following packages
cuda-9.2/ppc64le/cuda-deps/dkms
cuda-9.2/ppc64le/cuda-core/cuda

Set the otherpkg.pkglist attribute for the cudafull osimage:

chdef -t osimage -o rhels7.5-ppc64le-netboot-cudafull \
  otherpkglist=/install/custom/netboot/rh/cudafull.rhels7.ppc64le.otherpkgs.pkglist

Generate the image:

genimage rhels7.5-ppc64le-netboot-cudafull

Package the image:

packimage rhels7.5-ppc64le-netboot-cudafull

cudaruntime

Create a copy of the netboot-compute image and label it cudaruntime:

lsdef -t osimage -z rhels7.5-ppc64le-netboot-compute \
  | sed 's/netboot-compute:/netboot-cudaruntime:/' \
  | mkdef -z

Verify that the CUDA repo created previously is available in the directory specified by the otherpkgdir attribute.

Obtain the otherpkgdir directory using the lsdef command:
# lsdef -t osimage rhels7.5-ppc64le-netboot-cudaruntime -i otherpkgdir
  Object name: rhels7.5-ppc64le-netboot-cudaruntime
     otherpkgdir=/install/post/otherpkgs/rhels7.5/ppc64le
Create a symbolic link to the CUDA repository in the directory specified by otherpkgdir
ln -s /install/cuda-9.2 /install/post/otherpkgs/rhels7.5/ppc64le/cuda-9.2

Change the rootimgdir for the cudaruntime osimage:

chdef -t osimage -o rhels7.5-ppc64le-netboot-cudaruntime \
   rootimgdir=/install/netboot/rhels7.5/ppc64le/cudaruntime

Create the otherpkg.pkglist file to do the install of the CUDA runtime packages:

Create the otherpkg.pkglist file for cudaruntime:

vi /install/custom/netboot/rh/cudaruntime.rhels7.ppc64le.otherpkgs.pkglist

# Add the following packages:
cuda-9.2/ppc64le/cuda-deps/dkms
cuda-9.2/ppc64le/cuda-core/cuda-runtime-9-2

Set the otherpkg.pkglist attribute for the cudaruntime osimage:

chdef -t osimage -o rhels7.5-ppc64le-netboot-cudaruntime \
  otherpkglist=/install/custom/netboot/rh/cudaruntime.rhels7.ppc64le.otherpkgs.pkglist

Generate the image:

genimage rhels7.5-ppc64le-netboot-cudaruntime

Package the image:

packimage rhels7.5-ppc64le-netboot-cudaruntime

POWER9 Setup

NVIDIA POWER9 CUDA driver need some additional setup. Refer the URL below for details.

http://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#power9-setup

xCAT includes a script, cuda_power9_setup as example, to help user handle this situation.

Diskful osimage

For diskful deployment, there is no need to change the osimage definition. Instead, add this postscript to your compute node postscripts list.

chdef p9compute -p postscripts=cuda_power9_setup

Diskless osimage

For diskless deployment, the script need to add to the postinstall script of the osimage. And it should be run in the chroot environment. Please refer the following commands as an example.

mkdir -p /install/custom/netboot/rh
cp /opt/xcat/share/xcat/netboot/rh/compute.rhels7.ppc64le.postinstall /install/custom/netboot/rh/cudafull.rhels7.ppc64le.postinstall

cat >>/install/custom/netboot/rh/cudafull.rhels7.ppc64le.postinstall <<-EOF

/install/postscripts/cuda_power9_setup
EOF

chdef -t osimage rhels7.5-ppc64le-netboot-cudafull postinstall=/install/custom/netboot/rh/cudafull.rhels7.ppc64le.postinstall