Bug 782872 - please document disaster recovery procedures for iwhd
Summary: please document disaster recovery procedures for iwhd
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: CloudForms Cloud Engine
Classification: Retired
Component: Community Website
Version: 1.0.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: rc
Assignee: Justin Clift
QA Contact: wes hayutin
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-01-18 18:44 UTC by wes hayutin
Modified: 2015-07-13 04:35 UTC (History)
13 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
See comment #6
Clone Of:
Environment:
Last Closed: 2012-12-13 19:49:52 UTC


Attachments (Terms of Use)
Draft 1 (3.60 KB, patch)
2012-01-23 05:25 UTC, Pete Zaitcev
no flags Details | Diff
Draft 2 (3.59 KB, patch)
2012-02-08 18:41 UTC, Pete Zaitcev
no flags Details | Diff

Description wes hayutin 2012-01-18 18:44:08 UTC
Description of problem:

We would like to document the steps a user can take to recover from certain problems.. like the following

1. running out of disk space on the iwhd server
2. corrupted images
3. other??  changing ip?? changing creds??

Sounds like dev had a handle on the potential problems.

Comment 1 Dan Macpherson 2012-01-19 14:59:51 UTC
Adding myself as CC for enterprise docs.

Comment 2 Pete Zaitcev 2012-01-23 05:25:26 UTC
Created attachment 556850 [details]
Draft 1

If someone had a quick look and told me if this goes in the right
direction, it would be helpful.

Comment 3 Jim Meyering 2012-02-08 17:18:43 UTC
Pete, that looks great.  One nit: s/that plain/that are plain/.
And and one more:

  -Their the file names start with "iwhd.*".
  +Their file names start with "iwhd.".

or maybe you meant this?

  -Their the file names start with "iwhd.*".
  +There, the file names start with "iwhd.".

Comment 4 Pete Zaitcev 2012-02-08 18:41:00 UTC
Created attachment 560340 [details]
Draft 2

Comment 5 Dan Macpherson 2012-03-26 23:38:27 UTC
Changing component to Community Website because this bug is targeting upstream documentation. Am still watching this bug for updates for the enterprise docs.

Comment 6 Jim Meyering 2012-04-17 14:29:39 UTC
Pete added the "Recovery from lack of space" section to the upstream
admin guide,
  http://git.fedorahosted.org/git/?p=iwhd.git;a=commitdiff;h=0d49c58923e987
  http://git.fedorahosted.org/git/?p=iwhd.git;a=blob;f=doc/admin_guide.md
which went in prior to iwhd-1.3.

With that, is a separate "enterprise docs" change required?
If so, feel free to extract text from that section
or just to reference that admin_guid.md URL.

Comment 7 Hugh Brock 2012-05-02 19:28:19 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
See comment #6

Comment 11 Dan Macpherson 2012-05-15 03:22:21 UTC
Updated Release Notes as per comment #9 and comment #10:
http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/Release_Notes/ch04s02.html

> "animage" seems like a typo, should be "An image".

Fixed.

> "it is unsafe to remove everything temporary" - my phrasing is a little
> off-target. I meant something like "a blanket removal of everything temporary
> is unsafe", or "it is unsafe to wipe every temporary object without
> consideration". It usually is a bulk removal in the end, just not of
> everything.

Changed the line to: "Remove only temporary files and templates that are excessively old. Exercise caution when removing all temporary files in a busy cloud environment."

> Obvious typo fix: s/animage/An image/

Fixed.

> The original text mentions that the name of the NFS-mounted directory
> in which temporary files may accumulate (upon error) is usually set
> by the Aeolus Conductor.  The above omits that detail.
> Also, the temporary file names start with "iwhd" -- they do not
> match the "iwhd.*" glob.

Revised text to match closer to the proposed replacement. Removed .* glob

Comment 12 Jim Meyering 2012-05-15 20:04:47 UTC
Thanks, Dan.  That looks great.

Comment 13 Justin Clift 2012-09-24 16:25:59 UTC
Just for overkill, added several more links to the ImageFactory Admin Guide from the Aeolus Website, in possibly more obvious places:

  Aeolus Wiki - under Further Usage Guides
  https://www.aeolusproject.org/redmine/projects/aeolus/wiki/Wiki

  ImageFactory high level page - and the end
  http://aeolusproject.org/imagefactory.html

  Use It page - in "Other documentation"
  http://aeolusproject.org/use_it.html

This BZ is done. :)


Note You need to log in before you can comment on or make changes to this bug.