Chapter 2. Updating Satellite Server

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

     Copy to Clipboard

   • On Red Hat Enterprise Linux 8:

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

     Copy to Clipboard

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

   Copy to Clipboard

   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

   Copy to Clipboard

5. If the satellite-maintain command told you to reboot, then reboot the system:

   # reboot

   Copy to Clipboard