Chapter 5. Checking synchronization status and scheduling

A repository is a storage location for software packages (RPMs). RHEL uses yum commands to search a repository, download, install, and configure the RPMs. The RPMs contain all the dependencies needed to run an application. RPMs also download updates for software in your repositories.

The length of the initial synchronization of Red Hat content can vary. If you choose to synchronize repositories as soon as possible, you can synchronize all repositories in Red Hat Update Infrastructure 4 by running rhui-manager repo sync_all in the CLI.

5.1. Displaying repository synchronization summary

You can use the Synchronization Status screen to display information about a particular repository.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.

  3. From the Synchronization Status screen, press dr: 

    -= Repository Summary Synchronization Status =-

Last Refreshed: 02:01:22
(updated every 5 seconds, ctrl+c to exit)

Last Sync                    Last Result
-------------------------------------------------
Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8)
  Never                        None
....
....
Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
  2021-07-29 17:45:41          Running
Associating Content: 11001 (97%)
Downloading Artifacts: 7376

5.2. Displaying running synchronizations

You can use the Synchronization Status screen to check the status on running synchronization tasks.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.

  3. From the Synchronization Status screen, press rr: 

    Last Refreshed: 02:06:46
(updated every 5 seconds, ctrl+c to exit)

Current Sync                 Result
-------------------------------------------------
Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
  2021-07-29 17:45:41          Running
Associating Content: 11001 (97%)
Downloading Artifacts: 7376

5.3. Viewing the details of the last repository synchronization

You can use the Synchronization Status screen to view the details of the last repository synchronization.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.
  3. From the Synchronization Status screen, press vr.

  4. Enter the number for the repository that you want to see details for: 

    Enter value (1-66) or 'b' to abort:

Verification

  1. A similar message displays if the selected repository has not been synchronized: 

    Repo: Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
No syncs have been completed for this repository.

5.4. Synchronizing an individual repository immediately

The initial synchronization of content can take a while, typically 10 to 20 minutes. If you choose to synchronize repositories as soon as possible, you can synchronize all repositories in Red Hat Update Infrastructure 4 by running rhui-manager repo sync_all in the CLI.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.

  3. From the Synchronization Status screen, press sr: 

    Select one or more repositories to schedule to be synchronized before its scheduled time.
The sync will happen as soon as possible depending on other tasks that may be executing
in the RHUI.  Sync requests for repositories with tasks in running
or pending state will be ignored.

         Last Result  Next Sync              Repository
         -------------------------------------------------

  4. Select the repository by entering the value beside the repository name. Enter one repository selection at a time before confirming your product selection: 

    x  714: Error        2021-11-17 20:30:00    Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)

  5. Press c to confirm: 

    The following repositories will be scheduled for synchronization:
  Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
Proceed? (y/n) y

  6. Press y to proceed: 

    Scheduling sync for Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)...
... successfully scheduled for the next available timeslot.
    Note

    This message displays if a task for the selected repository is running. Ignoring sync request for Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2) as the repo is currently reserved by a running task.

5.5. Canceling active synchronization tasks

Most environments synchronize repositories on a scheduled basis. You may encounter a situation where you need to cancel active synchronization tasks.

Prerequisites

  • There are existing repositories.
  • There are active synchronization tasks.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.
  3. From the Synchronization Status screen, press ca to select cancel active sync tasks.

  4. Enter the value for the task or tasks that you want to cancel: 

    Select one or more repositories for which you want to cancel their active tasks.
  -    1: Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands:
  5. Press c to confirm your selection.

  6. Press y to cancel the synchronization task or tasks: 

    The active tasks will be canceled for the following repositories:
  Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
Proceed? (y/n)

Verification

  1. A similar message displays if you cancel an active synchronization task: 

    Canceling active task for repo Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2) ...
... done

5.6. Canceling waiting synchronization tasks

Most environments synchronize repositories on a scheduled basis. You may encounter a situation where you need to cancel pending synchronization tasks.

Prerequisites

  • There are existing repositories.
  • There are scheduled synchronization tasks.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.
  3. From the Synchronization Status screen, press cw to select cancel waiting sync tasks.

  4. Enter the value for the task or tasks that you want to cancel: 

    Select one or more repositories for which you want to cancel their pending tasks.
  -    1: Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands: 1

  5. Press c to confirm your selection: 

    Select one or more repositories for which you want to cancel their pending tasks.
  x    1: Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands: c

  6. Press y to proceed: 

    The pending tasks will be canceled for the following repositories:
  Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
Proceed? (y/n) y

Verification

  1. A similar message displays if the cancellation is successful: 

    Canceling pending task for repo Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI ...
... done

  2. The following message displays if there are no pending synchronization tasks: 

    There are no repositories with pending sync related tasks.

5.7. Viewing and changing a repository auto-publish status

You can use the Synchronization Status screen to look at and modify a repository’s auto-publish status.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.

  3. From the Synchronization Status screen, press ap: 

    rhui (sync) => ap

Select one or more repositories to toggle the auto-publish status.
The operation will be executed as soon as possible depending on other tasks
that may be executing in the RHUI.

                Status | Repository
           --------------------------------------------------------------------------
Select one or more repositories:

  Custom Repositories

  Red Hat Repositories: yum

     -  713:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.3)
     -  714:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
     -  719:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.3)
     -  720:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.4)

  4. Enter a value (1-1631) to toggle the selection, c to confirm selections, or ? for more commands: 

    The following repositories will have their auto-publish status changed:
  Red Hat Repositories
    yum
       Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8)
  5. Press c to confirm your selection.
  6. Press y to proceed.

Verification

  1. A similar message displays when you make and confirm a selection: 

    Scheduling a task to turn off auto-publish status of repository Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8)

Additional resources

5.8. Viewing and advancing repository workflow

You can use the Synchronization Status screen to look at and change a repository’s workflow.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.
  3. From the Synchronization Status screen, press wf.

  4. Enter a value (1-1631) to toggle the selection, c to confirm selections, or ? for more commands: 

    The following repositories will be scheduled for workflow push:
  Red Hat Repositories
    yum
       Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
  5. Press y to proceed:

Verification

  1. A similar message displays if the scheduling was successful: 

    Scheduling a task for generating metadata version 0 for repo Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4) ...
  ... task scheduled.

5.9. Exporting a repository to the file system

You can use the Synchronization Status screen to export a repository to a file system.

Procedure

  1. Navigate to the Red Hat Update Infrastructure Management Tool home screen: 

    [root@rhua ~]# rhui-manager
  2. Press s to select synchronization status and scheduling.
  3. From the Synchronization Status screen, press ex.
  4. Enter a value to toggle the selection.

  5. Press c to confirm the selection: 

    The following repositories will be exported:
  Red Hat Repositories
    yum
       Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8)
  6. Press y to proceed.

Verification

  1. A similar message displays if the repository is exported to a file system: 

    [1/1] Exporting version 1 of the repo Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8).