Chapter 4. Updating Capsule Server


Update Capsule Servers to the next patch version.

Procedure

  1. Synchronize the satellite-capsule-6.17-for-rhel-9-x86_64-rpms repository in the Satellite Server.
  2. Publish and promote a new version of the content view with which the Capsule is registered.
  3. Ensure that the Satellite Maintenance repository is enabled:

    # subscription-manager repos --enable \
    satellite-maintenance-6.17-for-rhel-9-x86_64-rpms
    Copy to Clipboard Toggle word wrap
  4. Use the health check option to determine if the system is ready for update:

    # satellite-maintain update check
    Copy to Clipboard Toggle word wrap

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

  5. 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/capsule.log file to check if the process completed successfully.

  6. Perform the update:

    # satellite-maintain update run
    Copy to Clipboard Toggle word wrap
  7. If the satellite-maintain command told you to reboot, then reboot the system:

    # reboot
    Copy to Clipboard Toggle word wrap
Back to top
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. Explore our recent updates.

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.

Theme

© 2025 Red Hat