Task #157
closedUpdate the failure and recovery scenarios in our user docs.
100%
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 =============
Updated by cduryee about 9 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.
Updated by bmbouter about 9 years ago
- Category deleted (
1) - Tags Documentation added
Documentation is now a Tag not a Category.
Updated by ipanova@redhat.com about 9 years ago
- Status changed from NEW to ASSIGNED
- Assignee set to ipanova@redhat.com
Updated by ipanova@redhat.com about 9 years ago
- Status changed from ASSIGNED to POST
Updated by ipanova@redhat.com about 9 years ago
- Status changed from POST to MODIFIED
Updated by ipanova@redhat.com about 9 years ago
- Status changed from MODIFIED to CLOSED - CURRENTRELEASE
- Sprint/Milestone set to 14
Updated by bmbouter almost 9 years ago
- Groomed set to Yes
- Sprint Candidate set to No
- Tags deleted (
Groomed)
Updated by bmbouter almost 9 years ago
- Sprint Candidate changed from No to Yes
- Tags deleted (
Sprint Candidate)