mirror of https://github.com/tLDP/LDP
158 lines
6.0 KiB
XML
158 lines
6.0 KiB
XML
<chapter id="evmscreatereg"><title>Creating regions</title>
|
|
|
|
<para>Regions can be created from containers, but they can also be created from other
|
|
regions, segments, or disks. Most region managers that support containers create one or more
|
|
freespace regions to represent the freespace within the container. This function is
|
|
analogous to the way a segment manager creates a freespace segment to represent unused disk
|
|
space. </para>
|
|
|
|
|
|
<sect1><title>When to create regions</title>
|
|
|
|
<para>You can create regions because you want the features provided by
|
|
a certain region manager or because you want the features provided by
|
|
that region manager. You can also create regions to be compatible with
|
|
other volume management technologies, such as MD or LVM.
|
|
For example, if you wanted to make a volume that is compatible with Linux LVM,
|
|
you would create a region out of a Linux LVM container and then a compatibility volume from that region. </para>
|
|
</sect1>
|
|
|
|
<sect1 id="crregex"><title>Example: create a region</title>
|
|
<para>This section tells how to create a region with EVMS by
|
|
providing instructions to help you complete the following task.</para>
|
|
|
|
|
|
|
|
<blockquote><example><title>Create "Sample Region"</title>
|
|
<para>Given the container "Sample Container," which has a freespace region of
|
|
8799 MB, create a data region 1000 MB in size named "Sample Region."</para></example></blockquote>
|
|
|
|
|
|
<sect2 id="guireg"><title>Using the EVMS GUI</title>
|
|
<para>To create a region, follow these steps:
|
|
<orderedlist><listitem><para>Select
|
|
<menuchoice>
|
|
<guimenu>Actions</guimenu>
|
|
<guimenuitem>Create</guimenuitem><guimenuitem>Region</guimenuitem></menuchoice>
|
|
</para></listitem>
|
|
|
|
<listitem><para>Select
|
|
the <guisubmenu>LVM Region
|
|
Manager</guisubmenu>. Click <guibutton>Next</guibutton>.</para>
|
|
|
|
<note><title>NOTE</title>
|
|
<para>You might
|
|
see additional region managers that were
|
|
not in the selection list when you were creating the storage container
|
|
because not all region
|
|
managers are required to support containers.</para></note></listitem>
|
|
|
|
<listitem><para>Select the freespace region from
|
|
the container you created in
|
|
<xref linkend="evmscreatecont"></xref>.
|
|
Verify that the region is named
|
|
<filename>lvm/Sample Container/Freespace</filename>.
|
|
Click <guibutton>Next</guibutton>.</para>
|
|
|
|
<para>The fields in the next window are the options for the
|
|
LVM Region Manager plug-in, the options marked with an "*" are required. </para></listitem>
|
|
|
|
<listitem><para>Fill in the name, <userinput>Sample Region</userinput>.</para></listitem>
|
|
|
|
<listitem><para>Enter <userinput>1000MB</userinput> in the <guilabel>size</guilabel> field.</para></listitem>
|
|
|
|
<listitem><para>Click the
|
|
<guibutton>Create</guibutton> button to complete the
|
|
operation. A window opens to display the outcome.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</para>
|
|
|
|
<para>Alternatively, you can perform some of the steps for creating a region with the GUI context sensitive menu:</para>
|
|
|
|
<orderedlist><listitem><para>From the <guimenuitem>Regions</guimenuitem> tab, right click
|
|
<filename>lvm/Sample Container/Freespace</filename>.</para></listitem>
|
|
|
|
<listitem><para>Click <guibutton>Create Region</guibutton>.</para></listitem>
|
|
|
|
<listitem><para>Continue beginning with step 4 of the GUI instructions.</para></listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
|
|
<!--ncurses-->
|
|
|
|
|
|
<sect2 id="ncurreg"><title>Using Ncurses</title>
|
|
<para>To create a region, follow these steps:
|
|
<orderedlist>
|
|
<listitem><para>Select
|
|
<menuchoice><guimenu>Actions</guimenu>
|
|
<guimenuitem>Create</guimenuitem>
|
|
<guimenuitem>Region</guimenuitem></menuchoice>.</para> </listitem>
|
|
|
|
<listitem><para>Select the
|
|
<guimenuitem>LVM Region
|
|
Manager</guimenuitem>. Activate <keycap>Next</keycap>.</para>
|
|
</listitem>
|
|
|
|
<listitem><para>Select the freespace
|
|
region from the container you created
|
|
earlier in <xref linkend="evmscreatecont"></xref>. Verify that
|
|
the region is named
|
|
<filename>lvm/Sample Container/Freespace</filename>.</para></listitem>
|
|
|
|
|
|
<listitem><para>Scroll to the <guilabel>Name</guilabel> field, and press
|
|
<keycap>spacebar</keycap>.</para></listitem>
|
|
|
|
<listitem><para>Type <userinput>Sample Region</userinput> at the "::" prompt.
|
|
Press <keycap>Enter</keycap>.</para></listitem>
|
|
|
|
<listitem><para>Scroll to the <guilabel>size</guilabel> field,
|
|
and press <keycap>spacebar</keycap>.</para></listitem>
|
|
|
|
<listitem><para>Type <userinput>1000MB</userinput> at the "::" prompt.
|
|
Press <keycap>Enter</keycap>.</para></listitem>
|
|
|
|
<listitem><para>Activate <guibutton>Create</guibutton>.</para></listitem>
|
|
|
|
</orderedlist>
|
|
</para>
|
|
|
|
<para>Alternatively, you can perform some of the steps for creating a region with the
|
|
context sensitive menu:</para>
|
|
|
|
<orderedlist>
|
|
<listitem><para>From the Storage Regions view, press <keycap>Enter</keycap> on
|
|
<filename>lvm/Sample Container/Freespace</filename>.</para>
|
|
</listitem>
|
|
<listitem><para>Activate the <guimenuitem>Create Region</guimenuitem> menu item.</para>
|
|
</listitem>
|
|
<listitem><para>Continue beginning with step 4 of the Ncurses instructions.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<!--CLI-->
|
|
|
|
<sect2 id="clireg"><title>Using the CLI</title>
|
|
|
|
<para>Create regions with the <command>Create</command>
|
|
command. Arguments to the <command>Create </command>command are
|
|
the following: keyword Region, the name of the
|
|
region manager to use, the region managers
|
|
options, and the objects to consume. The form of this command is:</para>
|
|
|
|
<programlisting>Create:region, LvmRegMgr={name="Sample Region", size=1000MB},
|
|
"lvm/Sample Container/Freespace"</programlisting>
|
|
|
|
<para>The LVM Region Manager supports many
|
|
options for creating regions. To see the
|
|
available options for creating regions and
|
|
containers, use the following <command>Query</command>:</para>
|
|
<programlisting>query:plugins,plugin=LvmRegMgr,list options</programlisting>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|
|
|