docs/en-US/migrate-datadisk-volume-new-storage-pool.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="migrate-datadisk-volume-new-storage-pool">
    <title>Migrating a Data Volume to a New Storage Pool</title>
    <para>There are two situations when you might want to migrate a disk:</para>
    <itemizedlist>
        <listitem><para>Move the disk to new storage, but leave it attached to the same running VM.</para></listitem>
        <listitem><para>Detach the disk from its current VM, move it to new storage, and attach it to a new VM.</para></listitem>
    </itemizedlist>
    <section id="migrate-storage-same-vm">
        <title>Migrating Storage For a Running VM</title>
        <para>(Supported on XenServer and VMware)</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 Instances, click the VM name, and click View Volumes.</para></listitem>
            <listitem><para>Click the volume you want to migrate.</para></listitem>
            <listitem><para>Detach the disk from the VM.
                See <xref linkend="detach-move-volumes"/> but skip the “reattach” step at the end. You
                will do that after migrating to new storage.</para></listitem>
            <listitem><para>Click the Migrate Volume button<inlinemediaobject>
                <imageobject>
                    <imagedata fileref="./images/migrate-instance.png"/>
                </imageobject>
                <textobject>
                    <phrase>Migrateinstance.png: button to migrate a volume</phrase>
                </textobject>
            </inlinemediaobject>
                and choose the destination from the dropdown list.</para></listitem>
            <listitem><para>Watch for the volume status to change to Migrating, then back to Ready.</para></listitem>
        </orderedlist>
    </section>
    <section id="migrate-storage-change-vm">
        <title>Migrating Storage and Attaching to a Different VM</title>
        <orderedlist>
            <listitem><para>Log in to the &PRODUCT; UI as a user or admin.</para></listitem>
            <listitem><para>Detach the disk from the VM.
                See <xref linkend="detach-move-volumes"/> but skip the “reattach” step at the end. You
                will do that after migrating to new storage.</para></listitem>
            <listitem><para>Click the Migrate Volume button<inlinemediaobject>
                <imageobject>
                    <imagedata fileref="./images/migrate-instance.png"/>
                </imageobject>
                <textobject>
                    <phrase>Migrateinstance.png: button to migrate a volume</phrase>
                </textobject>
            </inlinemediaobject>
                and choose the destination from the dropdown list.</para></listitem>
            <listitem><para>Watch for the volume status to change to Migrating, then back to Ready. You can find the
                volume by clicking Storage in the left navigation bar. Make sure that Volumes is
                displayed at the top of the window, in the Select View dropdown.</para></listitem>
            <listitem><para>Attach the volume to any desired VM running in the same cluster as the new storage server. See
                <xref linkend="attaching-volume"/>
            </para></listitem>
        </orderedlist>
    </section>
</section>