LDP/LDP/guide/docbook/EVMSUG/convertto-ug.xml

195 lines
8.4 KiB
XML

<chapter id="evmsconvert"><title>Converting volumes</title>
<para> This chapter discusses converting compatibility volumes to EVMS
volumes and converting EVMS volumes to compatibility volumes. For a discussion
of the differences between compatibility and EVMS volumes, see <xref linkend="evmscreatevol"></xref>.</para>
<sect1><title>When to convert volumes</title>
<para>There are several different scenarios that might help you determine
what type of volumes you need.
For example, if you wanted persistent names or to make full use of
EVMS features, such as Drive Linking or Snapshotting, you would convert
your compatibility volumes to EVMS volumes.
In another situation, you might decide that a volume needs to be
read by a system that understands the underlying volume management scheme.
In this case, you would convert your EVMS volume to a
compatibility volume.</para>
<para>A volume can only be converted when it is offline.
This means the volume must be unmounted and otherwise not in use.
The volume must be unmounted because the conversion operation changes both
the name and the device number of the volume.
Once the volume is converted, you can remount it using its new name.</para>
</sect1>
<sect1 id="comptoevms"><title>Example: convert compatibility volumes to EVMS volumes</title>
<para>A compatibility volume
can be converted to an EVMS volume in the following situations:
<itemizedlist><listitem><para>The compatibility volume has no file system (FSIM) on it.</para></listitem>
<listitem><para>The compatibility volume has a file system, but the file system can be shrunk (if necessary) to make
room for the EVMS metadata.</para></listitem></itemizedlist></para>
<para>This section provides a detailed explanation of how to convert compatibility
volumes to EVMS volumes and provides instructions to help you complete the following task. </para>
<blockquote><example><title>Convert a compatibility volume</title>
<para>You have a compatibility volume <filename>/dev/evms/hda3</filename>
that you want to make into an EVMS volume named <filename>my_vol</filename>.</para></example></blockquote>
<sect2 id="c2egui"><title>Using the EVMS GUI</title>
<para>Follow these steps to convert a compatibility volume with the EVMS GUI:</para>
<orderedlist>
<listitem><para>Choose <menuchoice><guimenu>Action</guimenu>
<guimenuitem>Convert </guimenuitem>
<guimenuitem>Compatibility Volume to EVMS</guimenuitem>
</menuchoice>. </para></listitem>
<listitem><para>Select <filename>/dev/evms/hda3</filename>
from the list of available volumes.</para></listitem>
<listitem><para>Type <filename>my_vol</filename> in the name field.</para></listitem>
<listitem><para>Click the <guibutton>Convert</guibutton> button
to convert the volume.</para></listitem>
</orderedlist>
<para>Alternatively, you can perform some of the steps to convert the volume from the GUI
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click
on <filename>/dev/evms/hda3</filename>.</para></listitem>
<listitem><para>Click <guimenuitem>Convert to EVMS Volume...</guimenuitem></para></listitem>
<listitem><para>Continue to convert the volume beginning with step 3 of the GUI
instructions.</para></listitem></orderedlist>
</sect2>
<sect2 id="c2encur"><title>Using Ncurses</title>
<para>Follow these instructions to convert a compatibility volume to an EVMS volume
with the Ncurses
interface:</para>
<orderedlist>
<listitem><para>Choose <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>Convert</guimenuitem><guimenuitem>Compatibility Volume to EVMS Volume</guimenuitem></menuchoice></para></listitem>
<listitem><para>Select <filename>/dev/evms/hda3</filename> from the list
of available volumes.</para></listitem>
<listitem><para>Type <userinput>my_vol</userinput> when prompted for the name.
Press <keycap>Enter</keycap>.</para></listitem>
<listitem><para>Activate <guibutton>Convert</guibutton>.</para></listitem>
</orderedlist>
<para>Alternatively, you can perform some of the steps to convert the volume from the
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Volumes view, press <keycap>Enter</keycap> on <filename>/dev/evms/hda3</filename>.</para>
</listitem>
<listitem><para>Activate the <guimenuitem>Convert to EVMS Volume</guimenuitem> menu item.</para>
</listitem>
<listitem><para>Continue to convert the volume beginning with step 3 of the Ncurses
instructions.</para>
</listitem>
</orderedlist>
</sect2>
<sect2><title>Using the CLI</title>
<para>To convert a volume, use the <command>Convert</command> command.
The <command>Convert</command> command takes the name of a volume as its first argument, and
then <option>name=</option> for what you want to name the new volume
as the second argument. To complete the example and convert a volume, type the
following command at the <prompt>EVMS:</prompt> prompt:</para>
<programlisting>convert: /dev/evms/hda3, Name=my_vol</programlisting>
</sect2>
</sect1>
<sect1 id="evmstocomp"><title>Example: convert EVMS volumes to compatibility volumes</title>
<para>An EVMS volume can be converted to a compatibility volume only if the volume does not have EVMS
features on it. This section provides a detailed explanation of how to convert EVMS volumes to compatibility volumes
by providing instructions to help you complete the following task. </para>
<blockquote><example><title>Convert an EVMS volume</title>
<para>You have an EVMS volume, <filename>/dev/evms/my_vol</filename>,
that you want to make a compatibility volume.</para></example></blockquote>
<sect2 id="e2cgui"><title>Using the EVMS GUI</title>
<para>Follow these instructions to convert an EVMS volume to a compatibility
volume with the EVMS GUI:</para>
<orderedlist>
<listitem><para>Choose <menuchoice><guimenu>Action</guimenu>
<guimenuitem>Convert </guimenuitem>
<guimenuitem>EVMS Volume to Compatibility Volume</guimenuitem>
</menuchoice>. </para></listitem>
<listitem><para>Select <filename>/dev/evms/my_vol</filename>
from the list of available volumes.</para></listitem>
<listitem><para>Click the <guibutton>Convert</guibutton> button
to convert the volume.</para></listitem>
</orderedlist>
<para>Alternatively, you can perform some of the steps to convert the volume through
the GUI context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click
<filename>/dev/evms/my_vol</filename>.</para></listitem>
<listitem><para>Click <guimenuitem>Convert to Compatibility Volume...</guimenuitem></para></listitem>
<listitem><para>Continue converting the volume beginning with step 3 of the
GUI instructions.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="e2cncur"><title>Using Ncurses</title>
<para>Follow these instructions to convert an EVMS volume to a compatibility volume
with the Ncurses interface:</para>
<orderedlist>
<listitem><para>Choose <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>Convert</guimenuitem><guimenuitem>EVMS Volume to
Compatibility Volume</guimenuitem></menuchoice></para></listitem>
<listitem><para>Select <filename>/dev/evms/my_vol</filename> from the
list of available volumes.</para></listitem>
<listitem><para>Activate <guibutton>Convert</guibutton>.
</para></listitem>
</orderedlist>
<para>Alternatively, you can perform some of the steps to convert the volume through
the context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Volumes view, press <keycap>Enter</keycap> on <filename>/dev/evms/my_vol</filename>.</para>
</listitem>
<listitem><para>Activate the <guimenuitem>Convert to Compatibility Volume</guimenuitem> menu item.</para>
</listitem>
<listitem><para>Continue to convert the volume beginning with step 3 of the Ncurses
instructions.</para>
</listitem>
</orderedlist>
</sect2>
<sect2 id="e2ccli"><title>Using the CLI</title>
<para>To convert a volume use the <command>Convert</command> command.
The <command>Convert</command> command takes the name of a volume as its first argument, and
the keyword <option>compatibility</option> to indicate a change to a compatibility volume
as the second argument. To complete the example and convert a volume, type the
following command at the <prompt>EVMS:</prompt> prompt:</para>
<programlisting>convert: /dev/evms/my_vol, compatibility</programlisting></sect2>
</sect1>
</chapter>