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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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>

      Copy to Clipboard Toggle word wrap

      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

      Copy to Clipboard Toggle word wrap

   2. Restart your system by running the following command:

      $ sudo reboot -n

      Copy to Clipboard Toggle word wrap
      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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap