Chapter 1. Updating Red Hat Enterprise Linux AI

Procedure

1. Log into your Red Hat registry account with the podman command:

   $ sudo podman login registry.redhat.io --username <user-name> --password <user-password> --authfile /etc/ostree/auth.json

   Or you can log in with the skopeo command:

   $ sudo skopeo login registry.redhat.io --username <user-name> --password <user-password> --authfile /etc/ostree/auth.json

2. Upgrading to a minor version of Red Hat Enterprise Linux AI

   1. You can upgrade your instance to use the latest version of Red Hat Enterprise Linux AI by using the bootc image for your machines hardware. 

      $ sudo bootc switch registry.redhat.io/rhelai1/bootc-<hardware-vendor>-rhel9:<rhel-ai-version>

      where

      <hardware-vendor>

      Specify the hardare vendor for your accelerators. Valid values include: nvidia, amd, and intel.

      <rhel-ai-version>

      Specify the RHEL AI version you want to upgrade to.

      Example command for machines with NVIDIA accelerators

      $ sudo bootc switch registry.redhat.io/rhelai1/bootc-nvidia-rhel9:1.5

   2. Restart your system by running the following command:

      $ sudo reboot -n

      Important

      When upgrading to RHEL AI version 1.5, the /etc/skel/.config/containers/storage.conf storage configuration needs to be copied to your <user-home>/.config/containers/storage.conf home directory before re-initializing.

      For example:

      $ cp /etc/skel/.config/containers/storage.conf <user-home>/.config/containers/storage.con

3. Upgrading to a z-stream version of Red Hat Enterprise Linux AI

   1. If a z-stream exists, you can upgrade your system to a z-stream version of RHEL AI by running the folllowing command:

      $ sudo bootc upgrade --apply

4. It is recommended to re-initialize your environment and configurations after you upgrade to the latest RHEL AI version.

   Warning

   The ilab config init command overrides your existing config.yaml file and sets it to the default configurations per your system hardware. If you customized the config.yaml file, ensure you are familiar with your custom configurations before re-initializing.

   $ ilab config init