| Summary: | Changes to sync screen | |||
|---|---|---|---|---|
| Product: | Red Hat Update Infrastructure for Cloud Providers | Reporter: | Jay Dobies <jason.dobies> | |
| Component: | Documentation | Assignee: | Lana Brindley <lbrindle> | |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | wes hayutin <whayutin> | |
| Severity: | unspecified | Docs Contact: | ||
| Priority: | unspecified | |||
| Version: | 2.0 | CC: | kbidarka, mhideo, sghai, tsanders | |
| Target Milestone: | --- | |||
| Target Release: | --- | |||
| Hardware: | Unspecified | |||
| OS: | Unspecified | |||
| Whiteboard: | ||||
| Fixed In Version: | Doc Type: | Bug Fix | ||
| Doc Text: | Story Points: | --- | ||
| Clone Of: | ||||
| : | 716332 (view as bug list) | Environment: | ||
| Last Closed: | 2011-07-29 04:51:29 UTC | Type: | --- | |
| Regression: | --- | Mount Type: | --- | |
| Documentation: | --- | CRM: | ||
| Verified Versions: | Category: | --- | ||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | ||
| Cloudforms Team: | --- | Target Upstream Version: | ||
| Bug Depends On: | ||||
| Bug Blocks: | 716332 | |||
|
Description
Jay Dobies
2011-06-21 21:02:16 UTC
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) => 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)
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) =>
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. (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) => 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 (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) => 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 (In reply to comment #3) > 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) => <procedure id="proc-Installation_Guide-Status_and_Scheduling-View_Last_Synchronization_Details"> <title>View Last Synchronization Details</title> <indexterm> <primary>RHUI Manager</primary> <secondary>view last synchronization details</secondary> </indexterm> <step> <para> From the Synchronization Status and Scheduling screen, type <userinput>vr</userinput> at the prompt to see details about the last repository synchronization: </para> <screen> rhui (sync) => hr </screen> </step> <step> <para> A list of all repositories currently being managed by the RHUI will be displayed. Select which repositories to view sychronization information for by typing the number of the repository at the prompt: </para> <screen> 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 </screen> </step> <step> <para> The synchronization information for the selected repository will be displayed: </para> <screen> Start Time: 06-20-2011 13:52 Finish Time: 06-20-2011 14:33 Elapsed Time: 0:41:08 Result: Success </screen> <para> The <guilabel>Elapsed Time</guilabel> displays the amount of time the synchronization took to run, in the format <guilabel>hours:minutes:seconds</guilabel>. The <guilabel>Result</guilabel> field shows the result of the synchronization, and will display either <guilabel>Success</guilabel> if the last synchronization completed successfully, or <guilabel>Error</guilabel> if the last synchronization failed. If the last synchronization failed, RHUI Manager will also display <guilabel>Exception</guilabel> a one line desciption of the error, and <guilabel>Traceback</guilabel>, a full traceback to be used when reporting the error. </para> </step> </procedure> Revision 1-14 LKB Verified under install guide at http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/chap-Installation_Guide-Status_and_Scheduling.html under chapter8 Status and Scheduling, new design changes are mentioned under following two procedures. Procedure 8.1. List Repository Synchronization Status Procedure 8.2. View Last Synchronization Details This book is now available at http://docs.redhat.com/docs/en-US/Red_Hat_Update_Infrastructure/2.0/html/Installation_Guide/index.html Please raise a new bug for any further changes. LKB |