docs/en-US/attaching-volume.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="attaching-volume">
  <title>Attaching a Volume</title>
  <para>You can attach a volume to a guest VM to provide extra disk storage. Attach a volume when
    you first create a new volume, when you are moving an existing volume from one VM to another, or
    after you have migrated a volume from one storage pool to another.</para>
  <orderedlist>
    <listitem>
      <para>Log in to the &PRODUCT; UI as a user or admin.</para>
    </listitem>
    <listitem>
      <para>In the left navigation, click Storage.</para>
    </listitem>
    <listitem>
      <para>In Select View, choose Volumes.</para>
    </listitem>
    <listitem>
      <para>4. Click the volume name in the Volumes list, then click the Attach Disk button<inlinemediaobject>
          <imageobject>
            <imagedata fileref="./images/attach-disk-icon.png"/>
          </imageobject>
          <textobject>
            <phrase>AttachDiskButton.png: button to attach a volume</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
    </listitem>
    <listitem>
      <para>In the Instance popup, choose the VM to which you want to attach the volume. You will
        only see instances to which you are allowed to attach volumes; for example, a user will see
        only instances created by that user, but the administrator will have more choices.</para>
      <!-- <para>If the VM is running in the OVM hypervisor, the VM must be stopped before a new volume can be attached to it.</para> -->
    </listitem>
    <listitem>
      <para>When the volume has been attached, you should be able to see it by clicking Instances,
        the instance name, and View Volumes.</para>
    </listitem>
  </orderedlist>
</section>