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

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

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 running the following command:
```
$ sudo bootc switch <latest-rhelai-image>
```
  where
  <path-to-latest-image>
  Specify the latest version of the RHEL AI image.
  Example command
  
  $ 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
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
```
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
```