이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 13. Restoring Satellite Server or Capsule Server from a backup


You can restore Satellite Server or Capsule Server from the backup data that you create as part of Chapter 12, Backing up Satellite Server and Capsule Server. This process outlines how to restore the backup on the same server that generated the backup, and all data covered by the backup is deleted on the target system. If the original system is unavailable, provision a system with the same configuration settings and host name.

Note

You cannot restore backups of a system without FIPS enabled on a FIPS enabled system.

13.1. Restoring from a full backup

Use this procedure to restore Red Hat Satellite or Capsule Server from a full backup. When the restore process completes, all processes are online, and all databases and system configuration revert to the state at the time of the backup.

Prerequisites

  • Ensure that you are restoring to the correct instance. The Red Hat Satellite instance must have the same host name, configuration, and be the same minor version (X.Y) as the original system.
  • Ensure that you have an existing target directory. The target directory is read from the configuration files contained within the archive.
  • Ensure that you have enough space to store this data on the base system of Satellite Server or Capsule Server as well as enough space after the restoration to contain all the data in the /etc/ and /var/ directories contained within the backup.

    To check the space used by a directory, enter the following command:

    # du -sh /var/backup_directory

    To check for free space, enter the following command:

    # df -h /var/backup_directory

    Add the --total option to get a total of the results from more than one directory.

  • Ensure that all SELinux contexts are correct. Enter the following command to restore the correct SELinux contexts:

    # restorecon -Rv /

Procedure

  1. Choose the appropriate method to install Satellite or Capsule:

  2. Copy the backup data to the local file system on Satellite Server. Use /var/ or /var/tmp/.
  3. Run the restoration script.

    # satellite-maintain restore /var/backup_directory

    Where backup_directory is the time-stamped directory or subdirectory containing the backed-up data.

    The restore process can take a long time to complete, because of the amount of data to copy.

Troubleshooting

  • Review the /var/log/foreman/production.log and /var/log/messages log files.

13.2. Restoring from incremental backups

Use this procedure to restore Satellite or Capsule Server from incremental backups. If you have multiple branches of incremental backups, select your full backup and each incremental backup for the branch you want to restore, in chronological order.

When the restore process completes, all processes are online, and all databases and system configuration revert to the state at the time of the backup.

Procedure

  1. Restore the last full backup using the instructions in Section 13.1, “Restoring from a full backup”.
  2. Remove the full backup data from the local file system on Satellite Server, for example, /var/ or /var/tmp/.
  3. Copy the incremental backup data to the local file system on Satellite Server, for example, /var/ or /var/tmp/.
  4. Restore the incremental backups in the same sequence that they are made:

    # satellite-maintain restore /var/backup_directory/FIRST_INCREMENTAL
    # satellite-maintain restore /var/backup_directory/SECOND_INCREMENTAL

Troubleshooting

  • Review the /var/log/foreman/production.log and /var/log/messages log files.

13.3. Backup and restore Capsule Server by using a virtual machine snapshot

You can use virtual machine snapshots to back up and restore your Capsule Server. This is useful for quick recovery in case of server failure or configuration issues.

If your Capsule Server is a virtual machine, you can restore it from a snapshot. Creating weekly snapshots to restore from is recommended. In the event of failure, you can install, or configure a new Capsule Server, and then synchronize the database content from Satellite Server.

If required, deploy a new Capsule Server, ensuring the host name is the same as before, and then install the Capsule certificates. You may still have them on Satellite Server, the package name ends in -certs.tar, alternately create new ones. Follow the procedures in Installing Capsule Server until you can confirm, in the Satellite web UI, that Capsule Server is connected to Satellite Server. Then use the procedure Section 13.3.1, “Synchronizing content from Satellite Server to Capsule Servers” to synchronize from Satellite.

13.3.1. Synchronizing content from Satellite Server to Capsule Servers

Use this procedure to synchronize content from your Satellite Server to your Capsule Server.

Prerequisites

  • Ensure that you either select the relevant organization and location context of your Capsule Server or choose Any Organization and Any Location.

Procedure

  1. In the Satellite web UI, navigate to Infrastructure > Capsules.
  2. Select your Capsule Server.
  3. On the Overview tab, click Synchronize.

    • Select Optimized Sync to synchronize content from your Satellite Server to your Capsule Server that bypasses unnecessary steps to speed up performance.
    • Select Complete Sync to perform a complete sync from your Satellite Server to your Capsule Server that synchronizes content even if the metadata has not changed.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동