1. Preparing for Foreman update

Review the following considerations before updating a Foreman server or Smart Proxy server.

1.1. Planning Foreman update

Updating Foreman applies a patch release to your Foreman server and Smart Proxy servers. Regular updates help keep your Foreman environment up-to-date and typically present minimal disruption to your operations.

Updating a Foreman server or Smart Proxy server performs a patch release. A patch release updates your Foreman server and Smart Proxy server to a new patch release version, such as from nightly.0 to nightly.1.

Important

Perform updates regularly to resolve security vulnerabilities and other issues. Updating a Foreman server or Smart Proxy server is often fast and non-disruptive to your operating environment.

Always update Foreman server, Smart Proxy server, or the operating system by using foreman-maintain update. If there are pending Foreman server updates, updating the operating system will update both.

1.2. Progress output in tmux

Using a utility such as tmux helps follow the progress of the update without the need to maintain a continuous shell session.

You can use a utility such as tmux to suspend and reattach a communication session. You can then check the update progress without staying connected to the command shell continuously.

If you lose connection to the command shell where the update is running, you can see the logs in /var/log/foreman-installer/katello.log to check if the process completed successfully.

For more information about using tmux, see the tmux(1) man page on your system.

2. Updating Foreman server

You can update your Foreman server to the latest packages published by Foreman community.

Prerequisites

  • Back up your Foreman server. For more information, see Backing up Foreman in Administering Foreman.

Procedure

  1. On your Foreman server, start Foreman maintenance mode:

    # foreman-maintain maintenance-mode start

  2. Upgrade all packages:

    # dnf upgrade

  3. Reconfigure Foreman server:

    # foreman-installer

  4. Stop Foreman maintenance mode:

    # foreman-maintain maintenance-mode stop
Verification

  • On your Foreman server, verify that all Foreman services are running:

    # foreman-maintain service status -b
Next steps

3. Updating Smart Proxy server

You can update your Smart Proxy server to the latest packages published by Foreman community.

Procedure

  1. On your Smart Proxy server, upgrade all packages:

    # dnf upgrade

  2. Reconfigure Smart Proxy server:

    # foreman-installer
Pre-release version Report issue