The following table shows repository correspondences between Oracle Linux 8 and Oracle Linux 9. The table helps you to identify the corresponding repositories that the Leapp utility makes available after the host has completed upgrading to Oracle Linux 8.

This table shows the repository mappings for the Oracle Linux KVM Stack.

As more products are upgradeable with future versions of the Leapp utility, the number of repositories that need to be enabled after the upgrade might also increase. The Leapp upgrade commands would become complicatedly long as you manually list the repositories to be enabled in the command syntax.

Oracle has provided the following convenience switches or arguments that can be used with the Leapp preupgrade or upgrade commands. When used, these arguments automatically apply the --enablerepo subcommand to repositories that are appropriate to the host that you're upgrading.

--enablerepo

Use the option to enable required repositories. You must use the option for every repository you want to enable, for example:

sudo leapp preupgrade --enablerepo 'ol9_addons' --enablerepo 'ol9_codeready_builder' ...

--oraclelinux

This argument is used on system upgrades that you perform either locally or remotely. The argument detects the system's architecture and automatically uses the repositories that are applicable to the architecture.

When you use this argument, the following repositories are automatically enabled:

• ol9_baseos_latest
• ol9_appstream
• ol9_UEKR7

Using this option is equal to using --enablerepo individually for each repository listed.

You can use --enablerepo to add any other required repositories not already included in --oraclelinux. For example:

sudo leapp preupgrade --oraclelinux --enablerepo 'ol9_addons' --enablerepo 'ol9_codeready_builder' ...

This command is equal to :

sudo leapp preupgrade --enablerepo 'ol9_baseos_latest' --enablerepo 'ol9_appstream' --enablerepo 'ol9_UEKR7' --enablerepo 'ol9_addons' --enablerepo 'ol9_codeready_builder'

--oci

This argument is used on Oracle Cloud Infrastructure instance upgrades. The repositories covered by this argument are a superset of the --oraclelinux argument.

When you use this argument, the following repositories are automatically enabled:

• ol9_baseos_latest
• ol9_appstream
• ol9_addons
• ol9_ksplice
• ol9_oci_included
• ol9_UEKR7

Using this option is equal to using --enablerepo individually for each repository listed.

You can use --enablerepo to add any other required repositories not already included in --oci. For example:

sudo leapp preupgrade --oci --enablerepo 'ol9_codeready_builder' ...

This command is equal to:

sudo leapp preupgrade --enablerepo 'ol9_baseos_latest' --enablerepo 'ol9_appstream' --enablerepo 'ol9_ksplice' --enablerepo 'ol9_oci_included' --enablerepo 'ol9_UEKR7' --enablerepo 'ol9_addons' --enablerepo 'ol9_codeready_builder'

--iso

Specify an Oracle Linux installation image to use to perform an in place upgrade. You must specify the full path to the ISO image:

sudo leapp upgrade --iso <path-to-ISO>

The ISO image must be stored on the local partition, not on removable media or the local network.

Note:

Depending on the package composition on some custom Oracle Linux deployments, in-place Leapp upgrades using the --iso option might not include some packages. This is an expected and known limitation of --iso option. Use the --iso option only for isolated environments, where access to local repository mirrors or public Oracle repositories is impossible. Analyze the following files before proceeding with the upgrade to confirm what packages are to be installed, removed, or updated:

• /var/log/leapp/leapp-preupgrade.log

• /var/log/leapp/leapp-upgrade.log

• /var/log/leapp/leapp-report.txt