Chapter 5. Updating Satellite Server, Capsule Server, and Content Hosts

To Update Satellite Server:

1. Ensure the Satellite Maintenance repository is enabled:

   # subscription-manager repos --enable \
   rhel-7-server-satellite-maintenance-6-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.9.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 screen to suspend and reattach a communication session. You can then check the upgrade progress without staying connected to the command shell continuously. For more information about using the screen command, see How do I use the screen command? article in the Red Hat Knowledge Base.

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

6. Check when the kernel packages were last updated:

   # rpm -qa --last | grep kernel

7. Optional: If a kernel update occurred since the last reboot, stop the satellite-maintain services and reboot the system:

   # satellite-maintain service stop
   # reboot

Updating Disconnected Satellite Server to the Next Minor Version

1. Create a new configuration file as follows:

   # vi /etc/yum.repos.d/redhat-local.repo
   
   [rhel-7-server-ansible-2.9-rpms]
   name=Ansible 2.9 RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/ansible/2.9/os/
   enabled=1
   
   [rhel-7-server-rpms]
   name=Red Hat Enterprise Linux 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/os/
   enabled=1
   
   [rhel-7-server-satellite-6.9-rpms]
   name=Red Hat Satellite 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/satellite/6.9/os/
   enabled=1
   
   [rhel-7-server-satellite-maintenance-6-rpms]
   name=Red Hat Satellite Maintenance 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/sat-maintenance/6/os/
   enabled=1
   
   [rhel-server-rhscl-7-rpms]
   name=Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/rhscl/1/os/
   enabled=1

2. In the configuration file, replace Default_Organization in the baseurl with the correct organization label. To obtain the organization label, enter the commmand:

   # ls /var/lib/pulp/published/yum/https/repos/

3. Ensure that the rubygem-foreman_maintain package that provides satellite-maintain is installed and up to date:

   # yum install rubygem-foreman_maintain

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

   # satellite-maintain upgrade list-versions

5. Use the health check option to determine if the system is ready for the upgrade. On the 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.9.z

   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 screen to suspend and reattach a communication session. You can then check the upgrade progress without staying connected to the command shell continuously. For more information about using the screen command, see How do I use the screen command? article in the Red Hat Knowledge Base.

   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.

7. Perform the upgrade:

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

8. Check when the kernel packages were last updated:

   # rpm -qa --last | grep kernel

9. Optional: If a kernel update occurred since the last reboot, stop the satellite-maintain services and reboot the system:

   # satellite-maintain service stop
   # reboot

Procedure

1. Update the gofer package:

   # satellite-maintain packages install gofer

2. Restart the goferd service:

   # systemctl restart goferd

3. Ensure that the Satellite Maintenance repository is enabled:

   # subscription-manager repos --enable \
   rhel-7-server-satellite-maintenance-6-rpms

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

   # satellite-maintain upgrade list-versions

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

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

   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 screen to suspend and reattach a communication session. You can then check the upgrade progress without staying connected to the command shell continuously. For more information about using the screen command, see How do I use the screen command? article in the Red Hat Knowledge Base.

   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.

7. Perform the upgrade:

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

8. Check when the kernel packages were last updated:

   # rpm -qa --last | grep kernel

9. Optional: If a kernel update occurred since the last reboot, stop the satellite-maintain services and reboot the system:

   # satellite-maintain service stop
   # reboot

To Update a Content Host, enter the following commands:

1. Update the gofer package:

   # yum update gofer

2. Restart goferd:

   # systemctl restart goferd

3. Update all packages:

   # yum update

4. Optional: If a kernel update occurred since the last reboot, reboot the system:

   # reboot