LDP/LDP/guide/docbook/EVMSUG/replace-objects.xml

97 lines
3.7 KiB
XML

<chapter id="evmsreplaceobjects"><title>Replacing objects</title>
<para>This chapter discusses how to replace objects.</para>
<sect1 id="whatisobjectreplace"><title>What is object-replace?</title>
<para>Occasionally, you might wish to change the configuration of a volume or
storage object. For instance, you might wish to replace one of the disks in a
drive-link or RAID-0 object with a newer, faster disk. As another example, you
might have an EVMS volume created from a simple disk segment, and want to
switch that segment for a RAID-1 region to provide extra data redundancy.
Object-replace accomplishes such tasks.</para>
<para>
Object-replace gives you the ability to swap one object for another object.
The new object is added while the original object is still in place. The data is
then copied from the original object to the new object. When this is complete,
the original object is removed. This process can be performed while the volume is
mounted and in use.
</para>
</sect1>
<sect1 id="replacedlchildobj"><title>Replacing a drive-link child object</title>
<para>For this example, we will start with a drive-link object named <filename>link1</filename>,
which is composed of two disk segments named sda1 and sdb1. The goal is to replace
sdb1 with another segment named sdc1.</para>
<note><title>Note</title>
<para>The drive-linking plug-in allows the target object (sdc1 in this
example) to be the same size or larger than the source object.
If the target is larger, the extra space will be unused. Other plug-ins
have different restrictions and might require that both objects be the
same size.
</para>
</note>
<sect2 id="guiobjectreplace"><title>Using the EVMS GUI or Ncurses</title>
<para>Follow these steps to replace sdb1 with sdc1:
<orderedlist>
<listitem><para>Select
<menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Replace.</guimenuitem>
</menuchoice>
</para></listitem>
<listitem><para>In the &quot;Replace Source Object&quot; panel select
<guimenuitem>sdb1</guimenuitem>.
</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>In the &quot;Select Replace Target Object&quot; panel, select
<guimenuitem>sdc1</guimenuitem>. </para></listitem>
<listitem><para>Activate <guibutton>Replace</guibutton>.</para></listitem>
</orderedlist></para>
<para>Alternatively, you can perform these same steps with the
context sensitive menus:</para>
<orderedlist>
<listitem><para>From the &quot;Disk Segments&quot; panel, right click (or Press
<keycap>Enter</keycap> on) the object
<guimenuitem>sdb1</guimenuitem>.</para></listitem>
<listitem><para>Choose <guimenuitem>Replace</guimenuitem> on the popup menu.</para></listitem>
<listitem><para>In the &quot;Select Replace Target Object&quot; panel, select
<guimenuitem>sdc1.</guimenuitem></para></listitem>
<listitem><para>Activate <guibutton>Replace</guibutton>.</para></listitem>
</orderedlist>
<para>When you save changes, EVMS begins to copy the data from sdb1 to sdc1.
The status bar at the bottom of the UI will reflect the percent-complete of the
copy operation. The UI must remain open until the copy is finished. At that time,
the object sdb1 will be moved to the &quot;Available Objects&quot; panel.</para>
</sect2>
<sect2 id="clireplace"><title>Using the CLI</title>
<para>Use the <command>Replace</command> to replace objects with
the CLI:</para>
<programlisting>
Replace:source_object_name, target_object_name
</programlisting>
<para>
"source_object_name" is the name of the object you wish to replace with
"target_object_name." In the following example, sdb1 is replaced with
sdc1.
</para>
<programlisting>
Replace:sdb1,sdc1
</programlisting>
</sect2>
</sect1>
</chapter>