Chapter 1. Updating Red Hat Enterprise Linux AI


Red Hat Enterprise Linux AI allows you to update your instance so you can use the latest version of RHEL AI and InstructLab.

1.1. Updating your RHEL AI instance

You can update your instance to use the latest version of RHEL AI and InstructLab

Prerequisites

  • You installed and deployed a Red Hat Enterprise Linux AI instance on one of the supported platforms.
  • You created a Red Hat registry account.
  • You have root user access on your machine.

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.4

    2. Restart your system by running the following command:

      $ sudo reboot -n
      Important

      When upgrading to RHEL AI version 1.4, 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
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.