Bug 716332

In the v* screens shown below, the word "ellapsed" should be spelled "elapsed". I've updated the documentation, but it needs to be changed in the interface also.

LKB

+++ This bug was initially created as a clone of Bug #715099 +++

There have been some changes to the Synchronization Status screen to display new data available.

To start with, here's the new menu. The two items that begin with v are new and the wording has changed on the existing items, so make sure to update any samples of this menu in the docs:



-= 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

--- Additional comment from jason.dobies on 2011-06-21 17:07:54 EDT ---

The two 'd' options have new behavior. I'll include a text version of the repo sync sample at the end, or you can look at http://jdob.fedorapeople.org/rhui-sync.png for an example.


Going backwards from right to left:

Last Result - Will now only reflect the result of the last sync. It no longer reflects a currently running sync. So pretty much the only values here are "Never", "Success", or "Error".

Last Sync - Same as before, either "Never" or the time the next sync will occur. If we don't already have it, might want to mention that triggering an immediate sync (from elsewhere in the sync screen) will not affect this time. It will still run at the scheduled time as normal.

Next Sync - Now shows either when the next sync will occur or if a sync is currently executing. If a sync is currently executing, this column will reflect one of two states:

"In Progress" - Means the sync is actively running.
"Awaiting Execution" - The sync will run as soon as possible, but Pulp is currently busy doing other things (most likely, synccing).



Example:

------------------------------------------------------------------------------
             -= 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: atlantis
------------------------------------------------------------------------------
^Crhui (sync) =>

--- Additional comment from jason.dobies on 2011-06-21 17:08:45 EDT ---

The two 's' commands remain unchanged, with the small exception that the last result is now capitalized because I'm compulsive:

------------------------------------------------------------------------------
rhui (sync) => 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. Only repositories that are not currently synchronizing are displayed.

         Last Result         Next Sync         Repository
         ------------------------------------------
  -  1 : Success    06-21-2011 19:51  Red Hat Update Infrastructure 1.2 (RPMs) (5Server-i386)

--- Additional comment from jason.dobies on 2011-06-21 17:19:17 EDT ---

The two 'v' commands are new. they provide more information on the last _completed_ sync. At minimum, it shows:

Start Time, Finish Time - Pretty self-explanatory.
Elapsed Time - In the format: hours:minutes:seconds  (ex: 0:03:18)
Result: Success or Error

In the case of an error, two more fields will be displayed:

Exception: Single line description of the error.
Traceback: Full traceback of what went wrong. This won't necessarily mean much to the user, but can be used when filing a support case.




Example: Successful sync

    ------------------------------------------------------------------------------
    -= Red Hat Update Infrastructure Management Tool =-
     
     
    -= Synchronization Status =-
     
    dr display repo synchronization schedules
    sr trigger an individual repository sync
    hr view the details of the last repository sync
    dc display CDS synchronization schedules
    sc trigger an individual CDS sync
     
    Connected: atlantis
    ------------------------------------------------------------------------------
    rhui (sync) => hr

    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
     
    Start Time: 06-20-2011 13:52
    Finish Time: 06-20-2011 14:33
    Ellapsed Time: 0:41:08
    Result: Success




Example: Failed sync
     
    ------------------------------------------------------------------------------
    rhui (sync) => hr
    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: 2
     
    Start Time: 06-20-2011 13:52
    Finish Time: 06-20-2011 14:32
    Ellapsed Time: 0:40:18
    Result: Error
    Exception: CreateRepoError()
    Traceback:
    Traceback (most recent call last):
     
    File "/home/jdob/code/pulp/src/pulp/server/tasking/task.py", line 330, in run
    result = self.callable(*self.args, **self.kwargs)
     
    File "/home/jdob/code/pulp/src/pulp/server/api/repo_sync.py", line 224, in _sync
    progress_callback, synchronizer, max_speed, threads)
     
    File "/home/jdob/code/pulp/src/pulp/server/api/repo_sync.py", line 302, in fetch_content
    progress_callback, max_speed, threads)
     
    File "/home/jdob/code/pulp/src/pulp/server/api/synchronizers.py", line 448, in sync
    pulp.server.util.create_repo(store_path, groups=groups_xml_path, checksum_type=repo['checksum_type'])
     
    File "/home/jdob/code/pulp/src/pulp/server/util.py", line 383, in create_repo
    _create_repo(dir, groups=groups, checksum_type=checksum_type)
     
    File "/home/jdob/code/pulp/src/pulp/server/util.py", line 367, in _create_repo
    raise CreateRepoError(out)
     
    CreateRepoError: Worker 0: Traceback (most recent call last):
    Worker 0: File "/usr/share/createrepo/worker.py", line 101, in <module>
    Worker 0: main(sys.argv[1:])
    Worker 0: File "/usr/share/createrepo/worker.py", line 84, in main
    Worker 0: pri.write(pkg.xml_dump_primary_metadata())
    Worker 0: File "/usr/lib/python2.7/site-packages/yum/packages.py", line 1208, in xml_dump_primary_metadata
    Worker 0: msg += misc.to_unicode(self._dump_format_items())
    Worker 0: File "/usr/lib/python2.7/site-packages/yum/packages.py", line 1076, in _dump_format_items
    Worker 0: msg += self._dump_requires()
    Worker 0: File "/usr/lib/python2.7/site-packages/yum/packages.py", line 1145, in _dump_requires
    Worker 0: best = rest.pop()
    Worker 0: IndexError: pop from empty list
    Worker exited with non-zero value: 1. Fatal.
    Worker exited with non-zero value: 1. Fatal.
    Spawning worker 0 with 3381 pkgs
     
     
    ------------------------------------------------------------------------------
    rhui (sync) =>

--- Additional comment from jason.dobies on 2011-06-21 17:21:17 EDT ---

In those previous two examples, ignore the menu. Use the one I pasted in the first comment, the one directly above this was while still debugging.

It's also shown in the example, but before the user is shown anything in the 'v' commands, they are asked to choose a repo.

--- Additional comment from lbrindle on 2011-06-23 21:13:20 EDT ---

(In reply to comment #1)
> The two 'd' options have new behavior. I'll include a text version of the repo
> sync sample at the end, or you can look at
> http://jdob.fedorapeople.org/rhui-sync.png for an example.
> 
> 
> Going backwards from right to left:
> 
> Last Result - Will now only reflect the result of the last sync. It no longer
> reflects a currently running sync. So pretty much the only values here are
> "Never", "Success", or "Error".
> 
> Last Sync - Same as before, either "Never" or the time the next sync will
> occur. If we don't already have it, might want to mention that triggering an
> immediate sync (from elsewhere in the sync screen) will not affect this time.
> It will still run at the scheduled time as normal.
> 
> Next Sync - Now shows either when the next sync will occur or if a sync is
> currently executing. If a sync is currently executing, this column will reflect
> one of two states:
> 
> "In Progress" - Means the sync is actively running.
> "Awaiting Execution" - The sync will run as soon as possible, but Pulp is
> currently busy doing other things (most likely, synccing).
> 
> 
> 
> Example:
> 
> ------------------------------------------------------------------------------
>              -= 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: atlantis
> ------------------------------------------------------------------------------
> ^Crhui (sync) =>

<step>
	<para>
		From the Synchronization Status and Scheduling screen, type <userinput>dr</userinput> at the prompt to see the synchronization status of all available repositories:
	</para>
<screen>
rhui (sync) =&gt; 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
------------------------------------------------------------------------------
</screen>
	<variablelist>
		<varlistentry>
			<term><guilabel>Last Result</guilabel></term>
			 <listitem>
				<para>
					Shows the result of the last synchronization. Possible values are <guilabel>Never</guilabel> if the repository has not been synchronized before, <guilabel>Success</guilabel> if the last synchronization completed successfully, or <guilabel>Error</guilabel> if the last synchronization did not complete successfully.
				</para>
			</listitem>
		</varlistentry>
		 <varlistentry>
			<term><guilabel>Last Sync</guilabel></term>
			 <listitem>
				<para>
					Shows the time the last synchronization occured. Possible values are <guilabel>Never</guilabel> if the repository has not been synchronized before, or the date and time of the last synchronization.
				</para>
				 <note>
					<title>Note</title>
					 <para>
						Even if you trigger a manual synchronization elsewhere in the Status and Scheduling screen, this scheduled synchronization will still occur according to this schedule.
					</para>
				</note>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term><guilabel>Next Sync</guilabel></term>
			 <listitem>
				<para>
					Shows when the next synchronization will occur. If a synchronization is currently running, this column will display either <guilabel>In Progress</guilabel> if the synchronization is running, or <guilabel>Awaiting Execution</guilabel> if a synchronization is ready to run, but is waiting on other tasks to complete.
				</para>
			</listitem>
		</varlistentry>
		</variablelist>
</step>

LKB

--- Additional comment from lbrindle on 2011-06-23 21:15:27 EDT ---

(In reply to comment #2)
> The two 's' commands remain unchanged, with the small exception that the last
> result is now capitalized because I'm compulsive:
> 
> ------------------------------------------------------------------------------
> rhui (sync) => 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. Only repositories that are not currently synchronizing are
> displayed.
> 
>          Last Result         Next Sync         Repository
>          ------------------------------------------
>   -  1 : Success    06-21-2011 19:51  Red Hat Update Infrastructure 1.2 (RPMs)
> (5Server-i386)

<screen>
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.

         Last Result   Next Sync         Repository
         ------------------------------------------
  -  1 : Scheduled     04-16-2011 21:42  Red Hat Update Infrastructure 1.2
(RPMs) (5Server-i386)
  -  2 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(RPMs) (5Server-x86_64)
  -  3 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(SRPMS) (5Server-i386)
  -  4 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(SRPMS) (5Server-x86_64)
Enter value from (1-4) to toggle selection, 'c' to confirm selections, or '?'
for more commands: 1-2

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.

         Last Result   Next Sync         Repository
         ------------------------------------------
  x  1 : Scheduled     04-16-2011 21:42  Red Hat Update Infrastructure 1.2
(RPMs) (5Server-i386)
  x  2 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(RPMs) (5Server-x86_64)
  -  3 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(SRPMS) (5Server-i386)
  -  4 : Scheduled     04-16-2011 23:44  Red Hat Update Infrastructure 1.2
(SRPMS) (5Server-x86_64)
Enter value from (1-4) to toggle selection, 'c' to confirm selections, or '?'
for more commands: c
</screen>

<screen>
rhui (sync) =&gt; 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 : Finished  Never             cds.example.com
Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for
more commands: 1
</screen>

LKB