SupportConsoleDevelopersStart a trialContact

Chapter 2. Updating Satellite Server

Update your connected Satellite Server to the next patch version. You can follow this process to update the underlying operating system between minor release versions. For information to update a disconnected Satellite setup, see Chapter 3, Updating a disconnected Satellite Server.

Prerequisites

Warning

If you customize configuration files, manually or using a tool such as Hiera, these changes are overwritten when the maintenance script runs during upgrading or updating. You can use the --noop option with the satellite-installer to test for changes. For more information, see the Red Hat Knowledgebase solution How to use the noop option to check for changes in Satellite config files during an upgrade.

Procedure

  1. Ensure the Satellite Maintenance repository is enabled:

    • On Red Hat Enterprise Linux 9: 

      # subscription-manager repos --enable \
satellite-maintenance-6.16-for-rhel-9-x86_64-rpms

    • On Red Hat Enterprise Linux 8: 

      # subscription-manager repos --enable \
satellite-maintenance-6.16-for-rhel-8-x86_64-rpms

  2. Use the health check option to determine if the system is ready for update. On first use of this command, satellite-maintain prompts you to enter the hammer admin user credentials and saves them in the /etc/foreman-maintain/foreman-maintain-hammer.yml file. 

    # satellite-maintain update check

    Review the results and address any highlighted error conditions before performing the update.

  3. Because of the lengthy update time, 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 command is running, you can see the logged messages in the /var/log/foreman-installer/satellite.log file to check if the process completed successfully.

  4. Perform the update: 

    # satellite-maintain update run

  5. Determine if the system needs a reboot: 

    # dnf needs-restarting --reboothint

  6. If the previous command told you to reboot, then reboot the system: 

    # reboot

Additional resources

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.