Chapter 4. Updating Capsule Server

Procedure

1. Synchronize the satellite-capsule-6.14-for-rhel-8-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.14-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

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

   # satellite-maintain upgrade list-versions

   Copy to Clipboard Toggle word wrap

5. Use the health check option to determine if the system is ready for upgrade:

   # satellite-maintain upgrade check --target-version 6.14.z

   Copy to Clipboard Toggle word wrap

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

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

7. Perform the update:

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

   Copy to Clipboard Toggle word wrap

8. Determine if the system needs a reboot:

   # dnf needs-restarting --reboothint

   Copy to Clipboard Toggle word wrap

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

   # reboot

   Copy to Clipboard Toggle word wrap