Bug 1306495

Assigning to Tahlia for review.

Tahlia, most of the information required is already in the Administration Guide, but is somewhat scattered. The procedure (or set of procedures) should follow the workflow included in the bug description, and include the following:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Administration_Guide/index.html#Detaching_storage_domains_from_a_data_center

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Administration_Guide/index.html#Attaching_a_data_domain

This bug seems like it's confusing two different processes. Attaching a storage domain is just taking a domain that exists in the environment and plunking it in a data centre. I could do a "Moving a storage domain from one data centre to another" section, but it would basically be "follow the procedure for detaching" and then "follow the procedure for attaching". 

On the other hand, importing a storage domain involves bringing in storage that is not currently in the environment anywhere. For example, if my RHEV env suddenly borked itself and I had to nuke it and set up a new one, I could just import the existing /storage/trichard/data directory into it, since it's no longer part of the old nuked env, and it would work without having to manually delete its contents first (if I understand correctly).

After some clarification, what I'm seeing here is two scenarios and three procedures:

1. Migrate storage domain to a different data center
 a. In the same environment (detach from one and attach to another)
 b. In a different environment (remove from one and import to another)
2. Disaster recovery (import an existing data domain to a new environment after the death of the old one)

Various procedures for parts of this exist, as noted in comment 1, throughout the book, in the Data Centers chapter and the Storage chapter (because you can do almost all the same things through either, i.e Data Centers tab > Storage subtab vs Storage tab > Data Centers subtab).

Data Centers:
3.6. Data Centers and Storage Domains
 3.6.1. Attaching an Existing Data Domain to a Data Center
 [...]
 3.6.4. Detaching a Storage Domain from a Data Center
 3.6.5. Activating a Storage Domain from Maintenance Mode

Storage:
7.6. Importing Existing Storage Domains
7.7. Storage Tasks
 [...]
 7.7.2. Moving Storage Domains to Maintenance Mode
 [...]
 7.7.4. Activating Storage Domains
 7.7.5. Removing a Storage Domain

So far my plan is to add the three new procedures, which includes content from those listed above, to 3.6 Data Centers and Storage Domains (maybe Backups and Migration, too?). I also want to consolidate (there's some unnecessary duplication) and move the individual procedures to the Storage chapter.

Merge request accepted and revision history entry added.

Content now published in https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Importing_Existing_Storage_Domains.html