2003-11-27 16:29:09 +00:00
|
|
|
<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 "Replace Source Object" panel select
|
|
|
|
<guimenuitem>sdb1</guimenuitem>.
|
|
|
|
</para></listitem>
|
|
|
|
<listitem><para>Activate <guibutton>Next</guibutton>.</para></listitem>
|
|
|
|
|
|
|
|
<listitem><para>In the "Select Replace Target Object" 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 "Disk Segments" 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 "Select Replace Target Object" 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 "Available Objects" panel.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="clireplace"><title>Using the CLI</title>
|
|
|
|
|
2004-09-20 13:00:51 +00:00
|
|
|
<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>
|
2003-11-27 16:29:09 +00:00
|
|
|
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
</chapter>
|
|
|
|
|