Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

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

Chapter 13. Maintaining Satellite Server

This chapter provides information on how to maintain a Satellite Server, including information on how to work with audit records, how to clean unused tasks, and how to recover Pulp from a full disk.

13.1. Deleting Audit Records Manually
링크 복사

You can use the foreman-rake audits:expire command to remove audit records at any time.

Procedure

  • Delete the audit records using the foreman-rake audits:expire command: 

    # foreman-rake audits:expire days=Number_Of_Days
    Copy to Clipboard Toggle word wrap

    This command deletes all audit records older than Number_Of_Days.

13.2. Deleting Audit Records Automatically
링크 복사

You can automatically delete audit records using the Saved audits interval setting. This setting is empty by default, meaning Satellite does not automatically delete the audit records.

Procedure

  1. In the Satellite web UI, navigate to Administer > Settings.
  2. On the General tab, find the Saved audits interval setting.
  3. Set the value of the setting to the number of days after which you want Satellite to delete the audit records.

13.3. Anonymizing Audit Records
링크 복사

You can use the foreman-rake audits:anonymize command to remove any user account or IP information while maintaining the audit records in the database. You can also use a cron job to schedule anonymizing the audit records at the set interval that you want.

By default, using the foreman-rake audits:anonymize command anonymizes audit records that are older than 90 days. You can specify the number of days to keep the audit records by adding the days option and add the number of days.

For example, if you want to anonymize audit records that are older than seven days, enter the following command: 

# foreman-rake audits:anonymize days=7
Copy to Clipboard Toggle word wrap

13.4. Deleting Report Records
링크 복사

Report records are created automatically in Satellite. You can use the foreman-rake reports:expire command to remove reports at any time. You can also use a cron job to schedule report record deletions at the set interval that you want.

By default, using the foreman-rake reports:expire command removes report records that are older than 90 days. You can specify the number of days to keep the report records by adding the days option and add the number of days.

For example, if you want to delete report records that are older than seven days, enter the following command: 

# foreman-rake reports:expire days=7
Copy to Clipboard Toggle word wrap

13.5. Configuring the Cleaning Unused Tasks Feature
링크 복사

Satellite performs regular cleaning to reduce disc space in the database and limit the rate of disk growth. As a result, Satellite backup completes faster and overall performance is higher.

By default, Satellite executes a cron job that cleans tasks every day at 19:45. Satellite removes the following tasks during the cleaning:

  • Tasks that have run successfully and are older than thirty days
  • All tasks that are older than a year

You can configure the cleaning unused tasks feature using these options:

  • To configure the time at which Satellite runs the cron job, set the --foreman-plugin-tasks-cron-line parameter to the time you want in cron format. For example, to schedule the cron job to run every day at 15:00, enter the following command: 

    # satellite-installer --foreman-plugin-tasks-cron-line "00 15 * * *"
    Copy to Clipboard Toggle word wrap
  • To configure the period after which Satellite deletes the tasks, edit the :rules: section in the /etc/foreman/plugins/foreman-tasks.yaml file.

  • To disable regular task cleanup on Satellite, enter the following command: 

    # satellite-installer --foreman-plugin-tasks-automatic-cleanup false
    Copy to Clipboard Toggle word wrap

  • To reenable regular task cleanup on Satellite, enter the following command: 

    # satellite-installer --foreman-plugin-tasks-automatic-cleanup true
    Copy to Clipboard Toggle word wrap

13.6. Deleting Task Records
링크 복사

Task records are created automatically in Satellite. You can use the foreman-rake foreman_tasks:cleanup command to remove tasks at any time. You can also use a cron job to schedule Task record deletions at the set interval that you want.

For example, if you want to delete task records from successful repository synchronizations, enter the following command: 

# foreman-rake foreman_tasks:cleanup TASK_SEARCH='label = Actions::Katello::Repository::Sync' STATES='stopped'
Copy to Clipboard Toggle word wrap

13.7. Deleting a Task by ID
링크 복사

You can delete tasks by ID, for example if you have submitted confidential data by mistake.

Procedure

  1. Connect to your Satellite Server using SSH: 

    # ssh root@satellite.example.com
    Copy to Clipboard Toggle word wrap

  2. Optional: View the task: 

    # hammer task info --id My_Task_ID
    Copy to Clipboard Toggle word wrap

  3. Delete the task: 

    # foreman-rake foreman_tasks:cleanup TASK_SEARCH="id=My_Task_ID"
    Copy to Clipboard Toggle word wrap

  4. Optional: Ensure the task has been removed from Satellite Server: 

    # hammer task info --id My_Task_ID
    Copy to Clipboard Toggle word wrap

    Note that because the task is deleted, this command returns a non-zero exit code.

13.8. Recovering from a Full Disk
링크 복사

The following procedure describes how to resolve the situation when a logical volume (LV) with the Pulp database on it has no free space.

Procedure

  1. Let running Pulp tasks finish but do not trigger any new ones as they can fail due to the full disk.

  2. Ensure that the LV with the /var/lib/pulp directory on it has sufficient free space. Here are some ways to achieve that:

    1. Remove orphaned content: 

      # foreman-rake katello:delete_orphaned_content RAILS_ENV=production
      Copy to Clipboard Toggle word wrap

      This is run weekly so it will not free much space.

    2. Change the download policy from Immediate to On Demand for as many repositories as possible and remove already downloaded packages. See the Red Hat Knowledgebase solution How to change syncing policy for Repositories on Satellite from "Immediate" to "On-Demand" on the Red Hat Customer Portal for instructions.

    3. Grow the file system on the LV with the /var/lib/pulp directory on it. For more information, see Growing a logical volume and file system in Red Hat Enterprise Linux 8 Configuring and managing logical volumes.

      Note

      If you use an untypical file system (other than for example ext3, ext4, or xfs), you might need to unmount the file system so that it is not in use. In that case, complete the following steps:

      1. Stop Satellite services: 

        # satellite-maintain service stop
        Copy to Clipboard Toggle word wrap
      2. Grow the file system on the LV.

      3. Start Satellite services: 

        # satellite-maintain service start
        Copy to Clipboard Toggle word wrap
  3. If some Pulp tasks failed due to the full disk, run them again.

To install and update packages on the Satellite Server or Capsule Server base operating system, you must enter the satellite-maintain packages command. Satellite prevents users from installing and updating packages with yum because yum might also update the packages related to Satellite Server or Capsule Server and result in system inconsistency.

Important

The satellite-maintain packages command restarts some services on the operating system where you run it because it runs the satellite-installer command after installing packages.

You can manage packages using the satellite-maintain packages command as follows:

  • To install packages on Satellite Server or Capsule Server: 

    # satellite-maintain packages install package_1 package_2
    Copy to Clipboard Toggle word wrap

  • To check for available package updates on Satellite Server or Capsule Server: 

    # satellite-maintain packages check-update
    Copy to Clipboard Toggle word wrap

  • To update all packages on Satellite Server or Capsule Server: 

    # satellite-maintain packages update
    Copy to Clipboard Toggle word wrap

  • To update specific packages on Satellite Server or Capsule Server: 

    # satellite-maintain packages update package_1 package_2
    Copy to Clipboard Toggle word wrap

Updating packages individually can lead to package inconsistencies on Satellite Server or Capsule Server. For more information about updating packages on Satellite Server, see Updating Satellite Server to the Next Minor Version in Upgrading and Updating Red Hat Satellite.

13.10. Reclaiming PostgreSQL Space
링크 복사

The PostgreSQL database can use a large amount of disk space especially in heavily loaded deployments. Use this procedure to reclaim some of this disk space on Satellite.

Procedure

  1. Stop all services, except for the postgresql service: 

    # satellite-maintain service stop --exclude postgresql
    Copy to Clipboard Toggle word wrap

  2. Switch to the postgres user and reclaim space on the database: 

    # su - postgres -c 'vacuumdb --full --all'
    Copy to Clipboard Toggle word wrap

  3. Start the other services when the vacuum completes: 

    # satellite-maintain service start
    Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat