Red Hat Bugzilla – Bug 1306495
[Docs] [Admin] A description of how to remove a data storage domain must be added
Last modified: 2016-05-03 22:36:25 EDT
In Red Hat Enterprise Virtualization 3.5, it became possible to import existing data storage domains into a RHEV environment. The workflow for this is outlined here -
This new functionality allows users to import existing data storage domains after an environment goes down, and re-import all the virtual machines. It also allows users to move a data storage domain from one data center to another by removing it from one data center and re-importing it into another.
A procedure outlining how to remove the data storage domain from a data center must be added with this use case in mind, including notes on considerations such as whether all virtual machines must be down at the time, and how to cleanly remove the data storage domain so that it can be re-imported as per the instructions above.
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:
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).
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
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