Search
SupportConsoleDevelopersStart a trialContact

Chapter 2. Updating Satellite Server

download PDF

Update your connected Satellite Server to the next minor version. 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: 

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

  2. Check the available versions to confirm the next minor version is listed: 

    # satellite-maintain upgrade list-versions

  3. Use the health check option to determine if the system is ready for upgrade. 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 upgrade check --target-version 6.15.z

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

  4. Because of the lengthy update time, use a utility such as tmux to suspend and reattach a communication session. You can then check the upgrade progress without staying connected to the command shell continuously.

    If you lose connection to the command shell where the upgrade 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.

  5. Perform the upgrade: 

    # satellite-maintain upgrade run --target-version 6.15.z

  6. Determine if the system needs a reboot: 

    # dnf needs-restarting --reboothint

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