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