mirror of https://github.com/tLDP/LDP
185 lines
6.6 KiB
XML
185 lines
6.6 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 will 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 comptibility volume from that region. </para>
|
|
</sect1>
|
|
|
|
<sect1 id="crregex"><title>Working through an Example</title>
|
|
<para>This section provides a detailed explanation of 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 the steps below:
|
|
<orderedlist><listitem><para>Select
|
|
<menuchoice>
|
|
<guimenu>Actions</guimenu>
|
|
<guimenuitem>Create</guimenuitem>
|
|
<guimenuitem>Region</guimenuitem></menuchoice>
|
|
to see a list of region
|
|
manager plug-ins. </para></listitem>
|
|
|
|
<listitem><para>Select
|
|
the <guisubmenu>LVM Region
|
|
Manager</guisubmenu>. Click <guibutton>Next</guibutton>.</para>
|
|
|
|
<note><title>NOTE</title>
|
|
<para>You may
|
|
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"/>.
|
|
The region should be 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 that displays the
|
|
outcome appears. </para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</para>
|
|
</sect2>
|
|
|
|
<!--ncurses-->
|
|
|
|
|
|
<sect2 id="ncurreg"><title>Using Ncurses</title>
|
|
<para>To create a region, follow the steps below:
|
|
<orderedlist>
|
|
<listitem><para>Press the
|
|
<keycap>4</keycap> key to switch
|
|
views.</para> </listitem>
|
|
|
|
<listitem><para>Scroll down the
|
|
list using the <keycap>down</keycap> arrow key until
|
|
<guimenuitem>Storage
|
|
Regions</guimenuitem> is
|
|
highlighted. Press the
|
|
<keycap>Enter</keycap> key.</para> </listitem>
|
|
|
|
<listitem><para>Press the
|
|
<keycap>Enter</keycap> key again to
|
|
display a submenu. </para></listitem>
|
|
|
|
<listitem><para>Press the
|
|
<keycap>Enter</keycap> key when
|
|
<guimenuitem>Create a New
|
|
Region</guimenuitem> is
|
|
highlighted. You will be presented
|
|
with a list of region manager
|
|
plug-ins.</para></listitem>
|
|
|
|
<listitem><para>Select the
|
|
<guimenuitem>LVM Region
|
|
Manager</guimenuitem>. Press the <keycap>Enter</keycap> key.</para>
|
|
|
|
<note><title>NOTE</title>
|
|
<para>You might see additional region
|
|
managers that were not in the
|
|
selection list when you created
|
|
the storage container. This absence of
|
|
region managers occurs
|
|
because not all region managers are
|
|
required to support
|
|
containers.</para></note></listitem>
|
|
|
|
<listitem><para>Select the freespace
|
|
region from the container you created
|
|
earlier in <xref linkend="evmscreatecont"/>. The region should be
|
|
named
|
|
<filename>lvm/Sample Container/Freespace</filename>.</para></listitem>
|
|
|
|
<listitem><para>Use the <keycap>spacebar</keycap>
|
|
key to select it. Press the
|
|
<keycap>Enter</keycap> key to
|
|
continue. The configuration options
|
|
submenu should
|
|
appear. </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
|
|
the <keycap>spacebar</keycap></para></listitem>
|
|
|
|
<listitem><para>Type <userinput>1000</userinput> at the "::" prompt.
|
|
Press <keycap>Enter</keycap>.</para></listitem>
|
|
|
|
<listitem><para>Check all fields to make sure they were entered appropriately.
|
|
If the units are displayed as KB and you desired MB, return to the previous step,
|
|
and enter the value of KB that is equal to the MB value you desired.</para></listitem>
|
|
|
|
</orderedlist>
|
|
</para>
|
|
</sect2>
|
|
<!--CLI-->
|
|
|
|
<sect2 id="clireg"><title>Using the CLI</title>
|
|
|
|
<para>Regions are created using 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 <command>Query</command> command as follows: </para>
|
|
<programlisting>query:plugins,plugin=LvmRegMgr,list options</programlisting>
|
|
|
|
</sect2>
|
|
<sect2 id="lvmreg"><title>Using Linux LVM Emulation Tools </title>
|
|
<para>The command that creates a region in LVM also creates an EVMS compatibility volume. Details on creating regions with the Linux LVM emulation tools can be found in the <xref linkend="lvmcomp"/>.</para></sect2>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|