Chapter 10. Status and Scheduling

Synchronization is used to keep data on CDS instances and repositories current. By default, a synchronization will occur every six hours, but this schedule can be adjusted. It is also possible to manually run a synchronization when required. Manual synchronizations are additional to the schedule, and do not change the scheduled synchronization times.
The Synchronization Status and Scheduling screen is used to display the synchronization schedules for CDS instances and repositories, and view past synchronizations. You can also trigger individual synchronizations from this screen.
Within the Synchronization Status and Scheduling screen, the following terms are used to describe the final status of the most recent synchronization:

Table 10.1. Synchronization Status Descriptions

Status Description
In Progress A synchronization is in progress. You will not be able to trigger another synchronization until after the running one has completed.
Awaiting Execution A synchronization is ready to run, but is waiting for other tasks to complete.
Success The last synchronization finished successfully.
Error The last synchronization failed.
To access the Synchronization Status and Scheduling screen, go to the Home screen and type s at the prompt: 
rhui (home) => s

------------------------------------------------------------------------------
             -= Red Hat Update Infrastructure Management Tool =-


-= Synchronization Status =-

   dr  display repo sync summary
   vr  view the details of the last repository sync
   sr  sync an individual repository immediately
   dc  display CDS sync summary
   vc  view the details of the last CDS sync
   sc  sync an individual CDS immediately

                                                           Connected: rhua.example.com
------------------------------------------------------------------------------
rhui (sync) =>

Procedure 10.1. List Repository Synchronization Status

  1. From the Synchronization Status and Scheduling screen, type dr at the prompt to see the synchronization status of all available repositories: 
    rhui (sync) => dr

------------------------------------------------------------------------------
             -= Red Hat Update Infrastructure Management Tool =-


-= Repository Synchronization Status =-

Last Refreshed: 13:53:52
(updated every 5 seconds, ctrl+c to exit)

Next Sync                    Last Sync                    Last Result         
----------------------------------------------------------------
Red Hat Enterprise Linux Server 6 Releases (RPMs) (6Server-i386)
In Progress                  06-20-2011 14:33             Success    

Red Hat Enterprise Linux Server 6 Releases (RPMs) (6Server-x86_64)
In Progress                  Never                        Error      

Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)
In Progress                  06-20-2011 13:52             Success    

Red Hat Update Infrastructure 1.2 (RPMs) (5Server-x86_64)
In Progress                  06-20-2011 13:52             Success    

Red Hat Update Infrastructure 1.2 (SRPMS) (5Server-i386)
Awaiting Execution           06-20-2011 13:53             Success    

Red Hat Update Infrastructure 1.2 (SRPMS) (5Server-x86_64)
Awaiting Execution           06-20-2011 13:53             Success    


                                                Connected: rhua.example.com
----------------------------------------------------------------
    Last Result
    Shows the result of the last synchronization. Possible values are Never if the repository has not been synchronized before, Success if the last synchronization completed successfully, or Error if the last synchronization did not complete successfully.
    Last Sync
    Shows the time the last synchronization occurred. Possible values are Never if the repository has not been synchronized before, or the date and time of the last synchronization.

    Note

    Regular scheduled synchronizations will occur even if a manual synchronization as been triggered.
    Next Sync
    Shows when the next synchronization will occur. If a synchronization is currently running, this column will display either In Progress if the synchronization is running, or Awaiting Execution if a synchronization is ready to run, but is waiting on other tasks to complete.
  2. The display will continue to update every five seconds. Press Ctrl+C to return to the prompt.

Procedure 10.2. View Last Synchronization Details

  1. From the Synchronization Status and Scheduling screen, type vr at the prompt to see details about the last repository synchronization: 
    rhui (sync) => vr
  2. A list of all repositories currently being managed by the RHUI will be displayed. Select which repository to view synchronization information for by typing the number of the repository at the prompt: 
        Select a repository:
    1 - Red Hat Enterprise Linux Server 6 Releases (RPMs) (6Server-i386)
    2 - Red Hat Enterprise Linux Server 6 Releases (RPMs) (6Server-x86_64)
    3 - Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)
    4 - Red Hat Update Infrastructure 1.2 (RPMs) (5Server-x86_64)
    5 - Red Hat Update Infrastructure 1.2 (SRPMS) (5Server-i386)
    6 - Red Hat Update Infrastructure 1.2 (SRPMS) (5Server-x86_64)
    Enter value (1-6) or 'b' to abort: 1
  3. The synchronization information for the selected repository will be displayed: 
        Start Time: 06-20-2011 13:52
    Finish Time: 06-20-2011 14:33
    Elapsed Time: 0:41:08
    Result: Success
    The Elapsed Time displays the amount of time the synchronization took to run, in the format hours:minutes:seconds. The Result field shows the result of the synchronization, and will display either Success if the last synchronization completed successfully, or Error if the last synchronization failed. If the last synchronization failed, RHUI Manager will also display Exception a one line description of the error, and Traceback, a full traceback to be used when reporting the error.

Procedure 10.3. List CDS Synchronization Status

  1. From the Synchronization Status and Scheduling screen, type dc at the prompt to see the synchronization status of all available repositories: 
    rhui (sync) => dc

--------------------------------------------------------
             -= Red Hat Update Infrastructure Management Tool =-


-= CDS Synchronization Status =-

Last Refreshed: 16:08:54
(updated every 5 seconds, ctrl+c to exit)


cds00133 .................................................... [  UP  ]
cds00175 .................................................... [  UP  ]


Next Sync                    Last Sync                    Last Result         
--------------------------------------------------------
cds00133
07-04-2011 16:23             07-04-2011 16:07             Success      

cds00175
07-04-2011 16:24             07-04-2011 16:07             Success   

                                                           Connected: rhua.example.com
--------------------------------------------------------
  2. The display will continue to update every five seconds. Press Ctrl+C to return to the prompt.

Procedure 10.4. Trigger a Repository Synchronization

  1. From the Synchronization Status and Scheduling screen, type sr at the prompt to trigger a manual repository synchronization. This will trigger another synchronization in addition to the ordinary scheduled synchronizations: 
    rhui (sync) => sr
  2. A list of available repositories will be displayed. Select which repositories to synchronize by typing the number of each repository at the prompt. Typing the number of a repository will place a checkmark next to the name of that repository. Continue until all repositories you want to synchronize have been checked, and then type c at the prompt to confirm: 
    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. Only repositories that are not currently synchronizing are displayed.

         Last Result         Next Sync         Repository
         ------------------------------------------
  -  1 : Success    07-04-2011 19:26  Red Hat Enterprise Linux Server 6 Updates (RPMs) (6Server-x86_64)
  -  2 : Success    07-04-2011 21:12  Red Hat Update Infrastructure 1.1 (RPMs) (5Server-i386)
  -  3 : Success    07-04-2011 21:12  Red Hat Update Infrastructure 1.1 (RPMs) (5Server-x86_64)
  -  4 : Success    07-04-2011 19:26  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)
  -  5 : Success    07-04-2011 19:26  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-x86_64)
Enter value (1-5) to toggle selection, 'c' to confirm selections, or '?' for more commands: 4-5

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. Only repositories that are not currently synchronizing are displayed.

         Last Result         Next Sync         Repository
         ------------------------------------------
  -  1 : Success    07-04-2011 19:26  Red Hat Enterprise Linux Server 6 Updates (RPMs) (6Server-x86_64)
  -  2 : Success    07-04-2011 21:12  Red Hat Update Infrastructure 1.1 (RPMs) (5Server-i386)
  -  3 : Success    07-04-2011 21:12  Red Hat Update Infrastructure 1.1 (RPMs) (5Server-x86_64)
  x  4 : Success    07-04-2011 19:26  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)
  x  5 : Success    07-04-2011 19:26  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-x86_64)
Enter value (1-5) to toggle selection, 'c' to confirm selections, or '?' for more commands: c
  3. A list of the repositories to be synchronized will be displayed. Type y at the prompt to confirm the selection and trigger the synchronizations: 
    The following repositories will be scheduled for synchronization:
  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)
  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-x86_64)
Proceed? (y/n) y


Scheduling sync for Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)...
... successfully scheduled for the next available timeslot.
Scheduling sync for Red Hat Update Infrastructure 1.2 (RPMs)
(5Server-x86_64)...
... successfully scheduled for the next available timeslot.

--------------------------------------------------------------------
rhui (sync) =>

    Note

    Manual synchronizations will not always occur immediately, depending on other tasks the RHUI is currently performing. The synchronization will occur as soon as the RHUI has an available timeslot.

Procedure 10.5. Trigger a CDS Synchronization

  1. From the Synchronization Status and Scheduling screen, type sc at the prompt to trigger a manual CDS synchronization. This will trigger another synchronization in addition to the ordinary scheduled synchronizations: 
    rhui (sync) => sc

Select one or more CDS instances 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. Only CDS instances that are not currently synchronizing are displayed.

         Last Result   Next Sync         CDS
         ------------------------------------------
  -  1 : Error  07-04-2011 16:23  cds00133
  -  2 : Error  07-04-2011 16:24  cds00175
Enter value (1-2) to toggle selection, 'c' to confirm selections, or '?' for more commands: 1-2
  2. A list of available CDS instances will be displayed. Select which CDS instances to synchronize by typing the number of each CDS instance at the prompt. Typing the number of a CDS instance will place a checkmark next to the name of that CDS. Continue until all CDS instances you want to synchronize have been checked, and then type c at the prompt to confirm: 
    Select one or more CDS instances 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. Only CDS instances that are not currently synchronizing are displayed.

         Last Result   Next Sync         CDS
         ------------------------------------------
  x  1 : Error  07-04-2011 16:23  cds00133
  x  2 : Error  07-04-2011 16:24  cds00175
Enter value (1-2) to toggle selection, 'c' to confirm selections, or '?' for more commands: c
  3. A list of the CDS instances to be synchronized will be displayed. Type y at the prompt to confirm the selection and trigger the synchronizations: 
    The following CDS instances will be scheduled for synchronization:
  cds00133
  cds00175
Proceed? (y/n) y


Scheduling sync for cds00133...
... successfully scheduled for the next available timeslot.
Scheduling sync for cds00175...
... successfully scheduled for the next available timeslot.

---------------------------------------------------------
rhui (sync) =>

    Note

    Manual synchronizations will not always occur immediately, depending on other tasks the RHUI is currently performing. The synchronization will occur as soon as the RHUI has an available timeslot.