en-US/detach-move-volumes.xml

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
%BOOK_ENTITIES;
]>

<!-- Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements.  See the NOTICE file
	distributed with this work for additional information
	regarding copyright ownership.  The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License.  You may obtain a copy of the License at
	
	http://www.apache.org/licenses/LICENSE-2.0
	
	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied.  See the License for the
	specific language governing permissions and limitations
	under the License.
-->
<section id="detach-move-volumes">
  <title>Detaching and Moving Volumes</title>
  <note>
    <para>This procedure is different from moving volumes from one storage pool to another as described in <xref linkend="vm-storage-migration"/>.</para></note>
  <para/>
  <para>A volume can be detached from a guest VM and attached to another guest. Both &PRODUCT;
    administrators and users can detach volumes from VMs and move them to other VMs.</para>
  <para>If the two VMs are in different clusters, and the volume is large, it may take several
    minutes for the volume to be moved to the new VM.</para>
  <!-- <para>If the destination VM is running in the OVM hypervisor, the VM must be stopped before a new volume can be attached to it.</para> -->
  <orderedlist>
    <listitem>
      <para>Log in to the &PRODUCT; UI as a user or admin.</para>
    </listitem>
    <listitem>
      <para>In the left navigation bar, click Storage, and choose Volumes in Select View.
        Alternatively, if you know which VM the volume is attached to, you can click Instances,
        click the VM name, and click View Volumes.</para>
    </listitem>
    <listitem>
      <para>Click the name of the volume you want to detach, then click the Detach Disk button. <inlinemediaobject>
          <imageobject>
            <imagedata fileref="./images/detach-disk-icon.png"/>
          </imageobject>
          <textobject>
            <phrase>DetachDiskButton.png: button to detach a volume</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
    </listitem>
    <listitem>
      <para>To move the volume to another VM, follow the steps in <xref linkend="attaching-volume"
        />.</para>
    </listitem>
  </orderedlist>
</section>