Project

Profile

Help

Task #157

Update the failure and recovery scenarios in our user docs.

Added by bmbouter over 5 years ago. Updated over 1 year ago.

Status:
CLOSED - CURRENTRELEASE
Priority:
Normal
Category:
-
Sprint/Milestone:
-
Start date:
Due date:
% Done:

100%

Estimated time:
Platform Release:
Groomed:
Yes
Sprint Candidate:
Yes
Tags:
Documentation, Pulp 2
Sprint:
March 2015
Quarter:

Description

The user docs have a section on failure and recovery that is somewhat vague. Recently some new notes were written (below). These new notes should be added into this section or incorporated somehow.

======== NOTES ==========

For a recap of the Pulp components read here [0].

If a pulp_worker dies, the task currently being worked on, and possibly a small number of related tasks, will not be processed. They will be marked cancelled after 5 minutes, or whenever the worker re-starts, whichever comes first. Until the tasks are marked as cancelled, they will show the task state when the failure occurred. Cancellation after 5 minutes is dependent on pulp_celerybeat running.

If pulp_celerybeat dies, if new workers then start, they won't be given work. If existing workers stop, Pulp will continue assigning them work. Once restarted, pulp_celerybeat will synchronize with the current state of all workers. Scheduled tasks will not run while pulp_celerybeat is down, but they will instead run when celerybeat is restarted.

If pulp_resource_manager dies, the Pulp tasking system will halt. Once restarted it will resume.

If the webserver dies the API will become unavailable until it is restored.

==Important new Related Features==

  • In Pulp 2.6.0, the /status/ url will show the health of all Pulp components. Read more about it here [1], which includes sample response output.

[0]: http://pulp.readthedocs.org/en/latest/user-guide/server.html#components
[1]: http://pulp.readthedocs.org/en/latest/dev-guide/integration/rest-api/status.html

=========== END NOTES =============

History

#1 Updated by bmbouter over 5 years ago

  • Tags Sprint Candidate added

#2 Updated by cduryee over 5 years ago

Can a section also be added for how to recover from running out of disk space? This comes up from time to time.

#3 Updated by bmbouter over 5 years ago

  • Tags Groomed added

#4 Updated by bmbouter over 5 years ago

  • Category deleted (1)
  • Tags Documentation added

Documentation is now a Tag not a Category.

#5 Updated by ipanova@redhat.com over 5 years ago

  • Status changed from NEW to ASSIGNED
  • Assignee set to ipanova@redhat.com

#6 Updated by ipanova@redhat.com over 5 years ago

  • Status changed from ASSIGNED to POST

#7 Updated by ipanova@redhat.com over 5 years ago

  • Status changed from POST to MODIFIED

#8 Updated by ipanova@redhat.com over 5 years ago

  • % Done changed from 0 to 100

#9 Updated by ipanova@redhat.com over 5 years ago

  • Status changed from MODIFIED to CLOSED - CURRENTRELEASE
  • Sprint/Milestone set to 14

#10 Updated by bmbouter over 5 years ago

  • Groomed set to Yes
  • Sprint Candidate set to No
  • Tags deleted (Groomed)

#11 Updated by bmbouter over 5 years ago

  • Sprint Candidate changed from No to Yes
  • Tags deleted (Sprint Candidate)

#13 Updated by bmbouter over 2 years ago

  • Sprint set to March 2015

#14 Updated by bmbouter over 2 years ago

  • Sprint/Milestone deleted (14)

#15 Updated by bmbouter over 1 year ago

  • Tags Pulp 2 added

Please register to edit this issue

Also available in: Atom PDF