LDP/LDP/guide/docbook/EVMSUG/addfeatures.xml

156 lines
4.9 KiB
XML

<chapter id="addfeatures"><title>Adding features to an existing volume</title>
<para>This chapter tells how to add additional EVMS features to an
already existing EVMS volume.
</para>
<sect1 id="whyadd"><title>Why add features to a volume?</title>
<para>EVMS lets you add features such as drive linking to
a volume that already exists. By adding features, you avoid having to potentially
destroy the volume and recreate it from scratch. For example, take the
scenario of a volume that contains important data but is almost full.
If you wanted to add more data to that volume but no free space existed on the
disk immediately after the segment, you could add a drive link to the volume.
The drive link concatenates another object to the end of the volume and
continues seamlessly.
</para>
</sect1>
<sect1 id="exaddfeature"><title>Example: add drive linking to an existing volume</title>
<para> The following example shows how to add drive linking to a volume with
the EVMS GUI, Ncurses, and CLI interfaces.
</para>
<blockquote><example><title>Add drive linking to an existing volume</title>
<para>The following sections show how to add a drive link to volume
<filename>/dev/evms/vol</filename> and call the drive link "DL."
</para>
</example>
<para><note><title>NOTE</title><para>Drive linking can be done only on
EVMS volumes; therefore, <filename>/dev/evms/vol</filename> must be converted to an EVMS volume if it is not
already. </para></note></para>
</blockquote>
<sect2 id="addfeaturegui"><title>Using the EVMS GUI</title>
<para>Follow these steps to add a drive link to the volume with the EVMS GUI:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>Add</guimenuitem><guimenuitem>Feature to Volume</guimenuitem></menuchoice>.
</para>
</listitem>
<listitem><para>Select <guimenuitem>/dev/evms/vol</guimenuitem>
</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Select <guimenuitem>Drive Linking Feature</guimenuitem>.
</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Type <userinput>DL</userinput> in the Name Field.</para>
</listitem>
<listitem><para>Click <guibutton>Add</guibutton>.</para>
</listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to add a drive link with the GUI
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click
<filename>/dev/evms/vol</filename>.</para></listitem>
<listitem><para>Click <guimenuitem>Add feature...</guimenuitem></para></listitem>
<listitem><para>Continue adding the drive link beginning with step 3 of the
GUI instructions.</para></listitem>
</orderedlist>
</sect2>
<!-- Ncurses-->
<sect2 id="addfeaturesncurses"><title>Using Ncurses</title>
<para>Follow these steps to add a drive link to a volume with Ncurses:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Add</guimenuitem>
<guimenuitem>Feature to Volume</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para>Select
<guimenuitem>/dev/evms/vol</guimenuitem>.
</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Select
<guimenuitem>Drive Linking Feature</guimenuitem>.
</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Press <keycap>Spacebar</keycap> to edit the Name field.
</para></listitem>
<listitem><para>At the &quot;::&quot; prompt enter <userinput>DL</userinput>.
</para></listitem>
<listitem><para>Press <keycap>Enter</keycap>.
</para></listitem>
<listitem><para>Activate <guibutton>Add</guibutton>.</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to add a drive link with the
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Volumes view, press <keycap>Enter</keycap> on <guimenuitem>/dev/evms/vol</guimenuitem>.</para>
</listitem>
<listitem><para>Activate the <guimenuitem>Add feature</guimenuitem> menu item.</para>
</listitem>
<listitem><para>Continue adding the drive link beginning with step 3 of the Ncurses instructions.</para>
</listitem>
</orderedlist>
</sect2>
<!-- CLI-->
<sect2 id="addfeaturescli"><title>Using the CLI</title>
<para>Use the
<command>add feature</command> to add a feature to an existing volume.
Specify the command name followed by a colon, followed by any options
and the volume to operate on. To determine the options for a given
feature, use the following query:
</para>
<programlisting>query: plugins, plugin=DriveLink, list options</programlisting>
<para>
The option names and descriptions are listed to help you construct
your command. For our example, the command would look like the following:
</para>
<programlisting>add feature: DriveLink={ Name=&quot;DL }, /dev/evms/vol</programlisting>
</sect2>
</sect1>
</chapter>