Red Hat Satellite Upgrade Guide

Upgrade Process Overview

Before upgrading Satellite, ensure you follow these steps:

Backup your Satellite
```
satellite-maintain backup online
```
Check current version
```
satellite-maintain packages list
```
Check system health
```
satellite-maintain health check
```

Upgrade Options

a. Using the playbook:

ansible-playbook -i inventory.ini satellite-upgrade.yml

b. Manual upgrade steps:

satellite-maintain service stop
dnf update satellite
satellite-maintain upgrade
satellite-maintain service start
satellite-maintain health check

Post-Upgrade Tasks

Clear browser cache
Verify all services are running
Test key functionality:
- Repository synchronization
- Host registration
- Content view publishing

Troubleshooting

If issues occur during upgrade:

Check logs:

tail -f /var/log/satellite-installer/satellite-installer.log
tail -f /var/log/foreman/production.log

Verify services:
```
satellite-maintain service status
```
Run health check:
```
satellite-maintain health check
```

Regular Patching

For regular system patching:

Schedule maintenance window
Create backup
Update packages:
```
dnf update
```
Restart services if required:
```
satellite-maintain service restart
```

Best Practices

Always backup before upgrading
Test upgrade procedure in non-production first
Maintain current backups
Monitor system resources during upgrade
Review release notes for breaking changes
Plan for adequate downtime
Verify client functionality post-upgrade

Support

For additional assistance:

Red Hat Satellite documentation
Red Hat Customer Portal
Open support case if needed