mirror of
				https://github.com/apache/cloudstack.git
				synced 2025-11-04 00:02:37 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			64 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			64 lines
		
	
	
		
			4.0 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="creating-new-volumes">
 | 
						||
	<title>Creating a New Volume</title>
 | 
						||
	<para>You can add more data disk volumes to a guest VM at any time, up to the limits of your storage capacity. Both &PRODUCT; administrators and users can add volumes to VM instances. When you create a new volume, it is stored as an entity in &PRODUCT;, but the actual storage resources are not allocated on the physical storage device until you attach the volume. This optimization allows the &PRODUCT; to provision the volume nearest to the guest that will use it when the first attachment is made.</para>
 | 
						||
	<section id="local-storage-data-volumes">
 | 
						||
		<title>Using Local Storage for Data Volumes</title>
 | 
						||
	    <para>You can  create data volumes on local storage (supported with XenServer, KVM, and VMware).
 | 
						||
		    The data volume is placed on the same
 | 
						||
			host as the VM instance that is attached to the data volume. These
 | 
						||
			local data volumes can be attached to virtual machines, detached, re-attached,
 | 
						||
			and deleted just as with the other types of data volume.</para>
 | 
						||
		<para>Local storage is ideal for scenarios where persistence of data volumes and HA
 | 
						||
			is not required. Some of the benefits include reduced disk I/O latency and cost
 | 
						||
			reduction from using inexpensive local disks.</para>
 | 
						||
		<para>In order for local volumes to be used, the feature must be enabled for the
 | 
						||
			zone.</para>
 | 
						||
		<para>You can create a data disk offering for local storage. When a user creates a
 | 
						||
			new VM, they can select this disk offering in order to cause the data disk
 | 
						||
			volume to be placed in local storage.</para>
 | 
						||
		<para>You can not migrate a VM that has a volume in local storage to a different
 | 
						||
			host, nor migrate the volume itself away to a different host. If you want to put
 | 
						||
			a host into maintenance mode, you must first stop any VMs with local data
 | 
						||
			volumes on that host.</para>
 | 
						||
	</section>
 | 
						||
	<section id="creating-new-volume-steps">
 | 
						||
		<title>To Create a New Volume</title>
 | 
						||
				<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.</para></listitem>
 | 
						||
				<listitem><para>In Select View, choose Volumes.</para></listitem>
 | 
						||
				<listitem><para>To create a new volume, click Add Volume, provide the following details, and click OK.</para>
 | 
						||
				<itemizedlist>
 | 
						||
					<listitem><para>Name. Give the volume a unique name so you can find it later.</para></listitem>
 | 
						||
					<listitem><para>Availability Zone. Where do you want the storage to reside? This should be close to the VM that will use the volume.</para></listitem>
 | 
						||
					<listitem><para>Disk Offering. Choose the characteristics of the storage.</para></listitem>
 | 
						||
				</itemizedlist>
 | 
						||
				<para>The new volume appears in the list of volumes with the state “Allocated.” The volume data is stored in &PRODUCT;, but the volume is not yet ready for use</para></listitem>
 | 
						||
				<listitem><para>To start using the volume, continue to Attaching a Volume </para></listitem>
 | 
						||
			</orderedlist>
 | 
						||
	</section>
 | 
						||
</section>
 |