Bug 782872

Summary: please document disaster recovery procedures for iwhd
Product: [Retired] CloudForms Cloud Engine Reporter: wes hayutin <whayutin>
Component: Community WebsiteAssignee: Justin Clift <jclift>
Status: CLOSED CURRENTRELEASE QA Contact: wes hayutin <whayutin>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 1.0.0CC: akarol, cpelland, deltacloud-maint, dgao, dmacpher, hbrock, jclift, kwade, meyering, morazi, rlandy, ssachdev, zaitcev
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
See comment #6
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-12-13 19:49:52 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
Draft 1
none
Draft 2 none

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. :)