cloudstack/docs/en-US/migrate-datadisk-volume-new-storage-pool.xml

79 lines
4.3 KiB
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>