LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

updated

This commit is contained in:
gferg 2003-11-27 16:28:34 +00:00
parent 4e6e6e7da4
commit 69bae4d6d2
24 changed files with 698 additions and 265 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
LDP/guide/docbook/EVMSUG/EVMSUG.xml
View File

@ -1,10 +1,9 @@
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://docbook.org/xml/4.2/docbookx.dtd"
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://docbook.org/xml/4.2/docbookx.dtd"
[
<!ENTITY evers "2.0.0">
<!ENTITY evers "2.2.0">
<!ENTITY evmsugchap1 SYSTEM "over-ug.xml">
<!ENTITY evmsugpref SYSTEM "pref-ug.xml">
<!ENTITY evmsuginstall SYSTEM "install-ug.xml">
<!ENTITY evmscmuse SYSTEM "cmuse-ug.xml">
<!ENTITY evmsdebuglog SYSTEM "debuglog-ug.xml">
<!ENTITY evmsmigrate SYSTEM "migrateto-ug.xml">
@ -23,7 +22,8 @@
<!ENTITY addfeatures SYSTEM "addfeatures-ug.xml">
<!ENTITY evmsplugintasks SYSTEM "plugintasks.xml">
<!ENTITY evmsdeleterecursive SYSTEM "deleterecurs-ug.xml">
<!ENTITY evmsinitram SYSTEM "appx-initram.xml">
<!ENTITY evmsreplaceobjects SYSTEM "replace-objects.xml">
<!ENTITY evmsmovesegs SYSTEM "move-segmentstorageobjs.xml">
<!ENTITY evmsdos SYSTEM "appx-dos.xml">
<!ENTITY evmsmd SYSTEM "appx-md.xml">
<!ENTITY evmslvm SYSTEM "appx-lvm.xml">
@ -38,18 +38,20 @@
<book id="evmsug">
<bookinfo><title>EVMS User Guide</title>
<authorgroup><author><firstname>Joy</firstname>
<authorgroup>
<author><firstname>Christine</firstname>
<surname>Lorenz</surname>
<affiliation><orgname>IBM</orgname></affiliation>
</author>
<author><firstname>Joy</firstname>
<surname>Goodreau</surname>
<affiliation><orgname>IBM</orgname></affiliation></author>
<author><firstname>Kylie</firstname>
<surname>Smith</surname>
<affiliation><orgname>IBM</orgname></affiliation></author>
<author><firstname>Christine</firstname>
<surname>Lorenz</surname>
<affiliation><orgname>IBM</orgname></affiliation></author></authorgroup>
</authorgroup>
<pubdate>March 31, 2003</pubdate>
<pubdate>November 25, 2003</pubdate>
<copyright><year>2003</year>
@ -62,8 +64,9 @@
<para>Windows is a trademark of Microsoft Corporation in the United States, other countries, or both. </para>
<para> Linux is a trademark of Linus Torvalds. </para>
<para>Other company, product, and service names may be trademarks or service marks of others.</para>
<para>UNIX is a registered trademark of The Open Group in the United States and other countries.</para>
<para>Other company, product, and service names may be trademarks or service marks of others.</para>
<para>This document is provided &quot;AS IS,&quot; with no express or implied warranties. Use the information in this document at your own risk. </para>
</legalnotice>
@ -74,7 +77,6 @@
&evmsugpref;
&evmsugchap1;
&evmsuginstall;
&evmscmuse;
&evmsdebuglog;
&evmsmigrate;
@ -93,7 +95,8 @@
&addfeatures;
&evmsplugintasks;
&evmsdeleterecursive;
&evmsinitram;
&evmsreplaceobjects;
&evmsmovesegs;
&evmsdos;
&evmsmd;
&evmslvm;

4
LDP/guide/docbook/EVMSUG/appx-csm.xml
View File

@ -1,4 +1,3 @@
<appendix id="appxcsm"><title>The CSM plug-in</title>
<para>The Cluster Segment Manager (CSM) is the EVMS plug-in that identifies and
@ -108,7 +107,7 @@ have a choice of using either:
<menuchoice><guimenu>Actions</guimenu><guimenuitem>Add</guimenuitem><guimenuitem>Segment Manager</guimenuitem></menuchoice>.
</para>
<para>If the container doesn't exist, it will be created for it. If the container already
<para>If the container doesn't exist, it will be created for the disk. If the container already
exists, the disk will be added to it.</para>
</sect1>
@ -130,3 +129,4 @@ disk is removed, the container is also removed.</para>
</sect1>
</appendix>

4
LDP/guide/docbook/EVMSUG/appx-dos.xml
View File

@ -1,6 +1,6 @@
<appendix id="appxdos"><title>The DOS link plug-in</title>
<appendix id="appxdos"><title>The DOS plug-in</title>
<para>The DOS plug-in is the most commonly used EVMS segment manager
plug-in. The DOS plug-in supports DOS disk partitioning as well as:</para>
@ -322,4 +322,4 @@ EVMS plug-in.
No options are available for deleting partitions.
</para>
</sect1>
</appendix>
</appendix>

10
LDP/guide/docbook/EVMSUG/appx-drivelink.xml
View File

@ -1,6 +1,3 @@
<appendix id="appxdrivelink"><title>The drive link plug-in</title>
<para>The EVMS drive link plug-in is an aggregating plug-in that
@ -51,7 +48,7 @@ read-only mode, which allows for recovery action.
The missing object might reside on removable storage that has been removed or
perhaps a lower layer plug-in failed to produce the missing object.
Whatever the reason, a read-only drive link storage object, together
logging errors, help you takea the appropriate actions to recover the drive link.
logging errors, help you take the appropriate actions to recover the drive link.
</para>
</sect1>
@ -82,7 +79,7 @@ By adding an additional storage object to the end of the drive link.
</listitem>
<listitem>
<para>
Bexpanding the last storage object in the drive link.
By expanding the last storage object in the drive link.
</para>
</listitem>
</itemizedlist>
@ -140,4 +137,5 @@ No options are available for deleting a drive link storage object.
</para>
</sect1>
</appendix>
</appendix>

101
LDP/guide/docbook/EVMSUG/appx-lvm.xml
View File

@ -1,6 +1,3 @@
<appendix id="appxsnap"><title>The LVM plug-in</title>
<para>The LVM plug-in combines storage objects into groups called containers.
@ -194,6 +191,102 @@ compatibility volume, an EVMS volume, or consumed by another EVMS plug-in.
No options are available for deleting LVM regions.</para>
</sect2>
<sect2><title>Moving LVM regions</title>
<para>The LVM plug-in lets you change the logical-to-physical mapping
for an LVM region and move the necessary data in the process.
This capability is most useful if a PV needs to be removed from a container.
There are currently two LVM plug-in functions for moving regions:
<command>move_pv</command> and <command>move_extent</command>.</para>
<sect3><title>move_pv</title>
<para>When a PV needs to be removed from a container, all PEs on that PV that are
allocated to regions must be moved to other PVs. The <command>move_pv</command> command lets you move PEs to other PVs.
<command>move_pv</command> is targeted at the LVM container and the desired PV is used as
the selected object. The following options are available:</para>
<variablelist>
<varlistentry><term>target_pvs</term>
<listitem><para>By default, all remaining PVs in the container are used to find
available extents to move the PEs. You can specify a subset of the PVs with this option.</para>
</listitem>
</varlistentry>
<varlistentry><term>maintain_stripes</term>
<listitem><para>When the target PV contains striped regions, there are three choices
for handling moving extents that belong to those regions:</para>
<variablelist>
<varlistentry><term>no</term>
<listitem><para>Don't bother to maintain true striping. This choice allows
extents to be moved to PVs that the region already uses for other stripes.
This means that the performance will not be as optimal as it is with true
striping, but allows the most flexibility in performing the move operation.
This choice is the default for the <command>maintain_stripes</command> option.</para>
</listitem>
</varlistentry>
<varlistentry><term>loose</term>
<listitem><para>Ensure that moved extents do not end up on any PVs that the
striped region already uses. However, this does not ensure that all moved
extents end up on the same PV. For example, a region with three stripes may
end up mapping to four or more PVs.</para>
</listitem>
</varlistentry>
<varlistentry><term>strict</term>
<listitem><para>Ensure that all moved extents end up on the same PV, thus ensuring
true striping with the same number of PVs that the striped region originally used.
This is the most restricted choice, and may prevent the <command>move_pv</command> operation from
proceeding (depending on the particular configuration of the container).</para>
</listitem>
</varlistentry>
</variablelist>
<para>If the target PV has no striped regions, the <command>maintain_stripes</command> option is ignored.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3><title>move_extent</title>
<para>In addition to moving all the extents from one PV, the LVM plug-in provides
the ability to move single extents.
This allows a fine-grain tuning of the allocation of extents.
This command is targeted at the region owning the extent to move. There are
three required options for the <command>move_extent</command> command:</para>
<variablelist>
<varlistentry><term>le</term>
<listitem><para>The number of the logical extent to move. LE numbers start at 0.</para></listitem>
</varlistentry>
<varlistentry><term>pv</term>
<listitem><para>The target object to move the extent to.</para></listitem>
</varlistentry>
<varlistentry><term>pe</term>
<listitem><para>The target physical extent on the target object. PE numbers
also start at 0.</para></listitem>
</varlistentry>
</variablelist>
<para>To determine the source LE and target PE, it is often helpful to view the
extended information about the region and container in question.
The following are command-line options that can be used to gather this
information:</para>
<para>To view the map of LEs in the region, enter this command:</para>
<programlisting>query:ei,&lt;region_name&gt;,Extents</programlisting>
<para>To view the list of PVs in the container, enter this command:</para>
<programlisting>query:ei,&lt;container_name&gt;,Current_PVs</programlisting>
<para>To view the current PE map for the desired target PV, enter this command:</para>
<programlisting>query:ei,&lt;container_name&gt;,PEMapPV#</programlisting>
<para># is the number of the target PV in the container.</para>
<para>This information is also easily obtainable in the GUI and Text-Mode UIs by
using the &quot;Display Details&quot; item in the context-popup menus for the desired
region and container.</para>
</sect3>
</sect2>
</sect1>
</appendix>
</appendix>

89
LDP/guide/docbook/EVMSUG/appx-md.xml
View File

@ -1,4 +1,3 @@
<appendix id="appxmdreg"><title>The MD region manager</title>
<para>
@ -19,8 +18,8 @@ member of another Linux RAID device.
<para>
Whereas there are six standard types of RAID arrays (RAID-0 through RAID-5) in the hardware implementation, the Linux implementation of software
RAID has RAID-0, RAID-1, RAID-4, and RAID-5 levels. In addition to these
four levels, Linux also has support for another non-redundant array called
"Linear Mode."
four levels, Linux also has support for other non-redundant arrays called
"Linear Mode" and &quot;MULTIPATH.&quot;
</para>
<para>
@ -46,7 +45,7 @@ chunk size is a power of 2 of the previous value. Consider the intended use of
MD region when selecting chunk size. For example,
if the MD region contains mostly large files, you might see better performance
by having a larger chunk size. The block size of the file system being used is
also an importnat factor when selecting chunk size.</para>
also an important factor when selecting chunk size.</para>
<para>This option is available for use with RAID-0 and RAID-4/5.</para></listitem>
</varlistentry>
@ -58,8 +57,8 @@ Otherwise, the MD array operates in a degraded mode.</para>
</varlistentry>
<varlistentry><term>RAID-5 algorithms</term>
<listitem><para>There are four RAID-5 parity algorithms: left assymetric, right
assymetric, left symmetric, and right symmetric. The <ulink url="http://www.accs.com/p_and_p/RAID/LinuxRAID.html">ACCS</ulink> web
<listitem><para>There are four RAID-5 parity algorithms: left asymmetric, right
asymmetric, left symmetric, and right symmetric. The <ulink url="http://www.accs.com/p_and_p/RAID/LinuxRAID.html">ACCS</ulink> web
page provides examples of what the different parity algorithms do.</para>
<para>This option is available for use with the RAID-5 algorithm.</para></listitem>
</varlistentry>
@ -81,30 +80,68 @@ spare disk from the MD region. This is a safe operation because the spare disk
not contain any data.</para>
</sect1>
<sect1 id="rmactiveraid"><title>Removing an active object (RAID-1 only)</title>
<sect1 id="rmactiveraid"><title>Reconfiguring MD arrays</title>
<para>Only the MD RAID-1 region plug-in lets you remove an active disk of the
MD region. This option is available for those MD RAID-1 regions that have at least
two active members.</para>
<sect2><title>Expanding and shrinking MD arrays (linear and RAID-1)</title>
<para>If the MD region is part of a compatibility volume and the MD region is
the topmost object of the volume, it's possible to expand and shrink the MD region.</para>
<sect3><title>Expanding a linear MD region</title>
<para>A linear MD region can be expanded either by expanding the last member
or by adding a new member.</para>
</sect3>
<sect3><title>Shrinking a linear MD region</title>
<para>A linear MD region can be shrunk either by shrinking the last member
or by removing disks from the array (last member first).</para>
</sect3>
<sect3><title>Expanding a RAID-1 MD region</title>
<para>A RAID-1 MD region can only be expanded if all members can be expanded.</para>
</sect3>
<sect3><title>Shrinking a RAID-1 MD region</title>
<para>A RAID-1 MD region can only be shrunk if all members can be shrunk.</para>
</sect3>
</sect2>
<sect2><title>Adding an active object (RAID-1 only)</title>
<para>Use this option to increase the number of mirrors of the RAID-1 region, from
n-way mirrors to (n+1)-way mirrors. When the operation is committed, the
kernel MD driver performs a resync of the MD array.</para>
</sect2>
<sect2><title>Removing an active object (RAID-1 only)</title>
<para>Use this option to decrease the number of mirrors of the RAID-1 region, from
n-way mirrors to (n-1)-way mirrors. </para>
</sect2>
</sect1>
<sect1 id="rmfaultyobj"><title>Removing a faulty object (RAID-1 and RAID-4/5)</title>
<para>When an I/O error occurs on a disk, the disk is marked faulty by the kernel
MD code. Use this function to permanently remove the faulty disk from the MD region.</para>
MD driver. Use this function to permanently remove the faulty disk from the MD region.</para>
</sect1>
<sect1 id="markobjfaulty"><title>Marking an object faulty (RAID-4/5 only)</title>
<sect1 id="markobjfaulty"><title>Marking an object faulty (RAID-1 and RAID-4/5)</title>
<para>This option is available when the RAID-4/5 array has at least one spare disk.
Use this option to swap an active disk with a spare disk. The active disk is marked
faulty and can be later removed, as described in <xref linkend="rmfaultyobj"/>.</para>
<para>There are two scenarios for marking an active disk faulty:</para>
<itemizedlist>
<listitem><para>When the MD region has at least one spare disk, the active disk will
be swapped with a spare disk.</para></listitem>
</itemizedlist>
<itemizedlist>
<listitem><para>When the MD region has no spare disks, the active disk will be marked
faulty and the MD array will operate in degraded mode.</para></listitem>
</itemizedlist>
<para>When the active disk is successfully marked
faulty, it can be immediately removed from the MD region. Alternatively, the
faulty disk can be later removed, as described in <xref linkend="rmfaultyobj"></xref>.</para>
</sect1>
@ -423,8 +460,30 @@ Cannot sustain a two-disk simultaneous failure.
</listitem>
</itemizedlist>
</sect2>
<sect2><title>MULTIPATH</title>
<para>Characteristics:</para>
<itemizedlist>
<listitem><para>Consists of 1 or more disks.</para></listitem>
<listitem><para>Disks are actually I/O paths to the same physical disk.</para></listitem>
<listitem><para>Spreads I/O across active disks for simple load balancing.</para></listitem>
<listitem><para>Like other RAID levels, I/O failures will mark a disk faulty.</para></listitem>
<listitem><para>Failed I/O will be automatically retried on remaining active disks.</para></listitem>
</itemizedlist>
<para>Advantages:</para>
<itemizedlist>
<listitem><para>Achieves fault-tolerance through redundant I/O paths.</para></listitem>
<listitem><para>Possible performance improvements through load balancing.</para></listitem>
</itemizedlist>
<para>Disadvantages:</para>
<itemizedlist><listitem><para>Cannot survive a single disk crash.</para></listitem></itemizedlist>
</sect2>
</sect1>
</appendix>

14
LDP/guide/docbook/EVMSUG/appx-snap.xml
View File

@ -1,6 +1,3 @@
<appendix id="appxsnapplug"><title>The snapshot plug-in</title>
<para>A snapshot represents a frozen image of a volume. The source of a snapshot is
@ -20,7 +17,7 @@ This data portion is called a &quot;chunk.&quot;</para>
<para>When data is written to a chunk on the original volume, the snapshot intercepts
the I/O request and determines if that chunk has already been saved.
If the chunk has not been saved, the chunk is copied from the original to the
snapshot, and then the write request is allowed to proceed ot the original volume.
snapshot, and then the write request is allowed to proceed to the original volume.
If additional data is written to that same chunk on the original, the chunk does not
need to be copied again.</para>
<para>When data is read from the snapshot, it is the same as when data is read from the original.
@ -41,18 +38,18 @@ object, which is to make an EVMS volume from the object.</para>
(disks, segments, regions, or feature objects). The size of this consumed object is
the size available to the snapshot object. The snapshot object can be smaller
or larger than the original volume. If the object is smaller, the original volume could fill up
as data is copied from the oriignal to the snapshot, given sufficient activity on the original.
as data is copied from the original to the snapshot, given sufficient activity on the original.
In this situation, the snapshot is deactivated and additional I/O to the snapshot fails.
</para>
<para>Base the size of the snapshot object on the amount of activity that is likely to take place
on the original during the lifetime of the snapshot. The more changes that occur on the
original and the longer the snapshot is expected to remain active, the larger the snapshot
should be. Clearly, determining this calculation is not simple and requires trial and error to determine the correct snapshot object size to use for a particular situation. The goal is
to create a snapshot object large enough to prevent the shapshot from being
to create a snapshot object large enough to prevent the snapshot from being
deactivated if it fills up, yet small enough to not waste disk space. If the snapshot
object is the same size as the original volume (actually, a little larger, to account for
the snapshot mapping tables), the snapshot is never deactivated.</para>
<para><xref linkend="evmscreatesnap"/> tells how to create snapshots. The following options are available for
<para><xref linkend="evmscreatesnap"></xref> tells how to create snapshots. The following options are available for
creating snapshot objects through the CLI:</para>
<variablelist>
@ -136,4 +133,5 @@ all but the desired snapshot must be deleted before rollback can take place.</pa
</sect1>
</appendix>
</appendix>

2
LDP/guide/docbook/EVMSUG/appx-xfs.xml
View File

@ -1,4 +1,3 @@
<appendix id="xfsfsim"><title>XFS file system interface module</title>
<para>
@ -105,3 +104,4 @@ Hence, volumes with XFS file systems cannot be shrunk.
</sect1>
</appendix>

162
LDP/guide/docbook/EVMSUG/assignseg-ug.xml
View File

@ -1,18 +1,13 @@
<chapter id="evmsassignseg"><title>Assigning a segment manager</title>
<para> This chapter discusses when to use a segment manager, what the different types of segment managers are, and how to assign a segment manager to a disk. </para>
<sect1 id="whenassign"><title>When to assign a segment manager</title>
<para>Assigning a segment manager to a disk allows the disk to be subdivided into
<chapter id="evmsassignseg"><title>Adding and removing a segment manager</title>
<para> This chapter discusses when to use a segment manager, what the different types of segment managers are, how to add a segment manager to a disk, and how to remove a
segment manager. </para>
<sect1 id="whenassign"><title>When to add a segment manager</title>
<para>Adding a segment manager to a disk allows the disk to be subdivided into
smaller storage objects called disk segments. The
<command>assign</command> command causes a
<command>add</command> command causes a
segment manager to create appropriate metadata and expose freespace
that the segment manager
finds on the disk. You need to assign segment managers when you
finds on the disk. You need to add segment managers when you
have a new disk or
when you are switching from one partitioning scheme to another. </para>
<para>EVMS displays disk segments as the following types: </para>
@ -27,7 +22,7 @@
</itemizedlist>
</sect1>
<sect1 id="smtypes"><title>Types of segment managers</title>
<para>There are five types of segment managers in EVMS: DOS, GPT, S/390, Cluster, and BSD. </para>
<para>There are seven types of segment managers in EVMS: DOS, GPT, S/390, Cluster, BSD, MAC, and BBR. </para>
<sect2 id="defaultseg"><title>DOS Segment Manager</title>
<para>The most
commonly used segment manager is the DOS Segment Manager. This plug-in
@ -87,11 +82,11 @@
<para>The S/390 Segment Manager is the only segment manager plug-in
capable of understanding the unique S/390 disk layouts. The S/390 Segment Manager
cannot be assigned or unassigned from a disk. </para></sect2>
cannot be added or removed from a disk. </para></sect2>
<sect2><title>Cluster segment manager</title>
<para>The cluster segment manager (CSM) supports high availability clusters. When the
CSM is assigned to a shared storage disk, it writes metadata on the disk that:</para>
CSM is added to a shared storage disk, it writes metadata on the disk that:</para>
<itemizedlist>
<listitem><para>provides a unique disk ID (guid)</para></listitem>
@ -123,40 +118,69 @@ The BSD segment manager recognizes such &quot;fully dedicated disks&quot; and pr
the BSD partitions.</para>
</sect2>
<sect2><title>MAC segment manager</title>
<para>Apple-partitioned disks use a disk label that is recognized by the MAC segment
manager. The MAC segment manager recognizes the disk label during discovery and
creates EVMS
segments to map the MacOS disk partitions.</para>
</sect2>
<sect2><title>BBR segment manager</title>
<para>The bad block replacement (BBR) segment manager enhances the reliability of
a disk by remapping bad storage blocks. When BBR is added to a disk, it writes
metadata on the disk that:</para>
<itemizedlist>
<listitem><para>reserves replacement blocks</para></listitem>
<listitem><para>maps bad blocks to reserved blocks</para></listitem>
</itemizedlist>
<para>Bad blocks occur when an I/O error is detected for a write operation.
When this happens, I/O normally fails and the failure code is returned to the
calling program code. BBR detects failed write operations and remaps the I/O to a
reserved block on the disk. Afterward, BBR restarts the I/O using the reserve block.</para>
<para>Every block of storage has an address, called a logical block address, or LBA.
When BBR is added to a disk, it provides two critical functions: remap and recovery.
When an I/O operation is sent to disk, BBR inspects the LBA in the I/O command to see
if the LBA has been remapped to a reserve block due to some earlier I/O error.
If BBR finds a mapping between the LBA and a reserve block, it updates the I/O
command with the LBA of the reserve block before sending it on to the disk.
Recovery occurs when BBR detects an I/O error and remaps the bad block to a
reserve block. The new LBA mapping is saved in BBR metadata so that subsequent
I/O to the LBA can be remapped.</para>
</sect2>
</sect1>
<sect1 id="assignsegex"><title>Assigning a segment manager to an existing disk</title>
<para>When you assign a segment manager to a disk, the segment manager
<sect1 id="assignsegex"><title>Adding a segment manager to an existing disk</title>
<para>When you add a segment manager to a disk, the segment manager
needs to change the basic
layout of the disk. This change means that some sectors are
reserved for metadata and the remaining sectors are
made available for creating data disk segments. Metadata sectors
are written to disk to save information
needed by the segment manager; previous information found on the
disk is lost. Before assigning a
disk is lost. Before adding a
segment manager to an existing disk, you must remove any existing
volume management structures, including any previous segment manager.</para>
</sect1>
<sect1 id="assignsegnew"><title>Assigning a segment manager to a new disk</title>
<sect1 id="assignsegnew"><title>Adding a segment manager to a new disk</title>
<para>When a new disk is added to a system,
the disk usually contains no data and has not
been partitioned. If this is the case, the disk shows up in EVMS as a compatibility volume because
EVMS cannot tell if the disk is being used as a volume. To assign a segment manager to the disk so that it
EVMS cannot tell if the disk is being used as a volume. To add a segment manager to the disk so that it
can be subdivided into smaller disk segment objects, tell EVMS that the disk is not a
compatibility volume by deleting the volume information.</para>
<para>If the new disk was moved from another system, chances are good that the disk already contains
metadata. If the disk does contain metadata, the disk shows up in EVMS with storage objects that
were produced from the existing metadata. Deleting these objects will allow you to assign a different
were produced from the existing metadata. Deleting these objects will allow you to add a different
segment manager to the disk, and you lose any old data. </para>
</sect1>
<sect1 id="assignex"><title>Example: assign a segment manager</title>
<para>This section shows how to assign
<sect1 id="assignex"><title>Example: add a segment manager</title>
<para>This section shows how to add
a segment manager with EVMS.</para>
<para>EVMS initially displays the
@ -169,8 +193,8 @@ a segment manager with EVMS.</para>
<blockquote><example><title>Assign the DOS Segment Manager</title>
<para>Assign the DOS Segment Manager to disk <filename>sde</filename>.</para></example></blockquote>
<blockquote><example><title>Add the DOS Segment Manager</title>
<para>Add the DOS Segment Manager to disk <filename>sde</filename>.</para></example></blockquote>
<note><title>NOTE</title>
<para>In the following example, the DOS Segment
@ -186,7 +210,7 @@ a segment manager with EVMS.</para>
<sect2 id="assignseggui"><title>Using the EVMS GUI</title>
<para>To assign the DOS Segment Manager to <filename>sde</filename>, first
<para>To add the DOS Segment Manager to <filename>sde</filename>, first
remove the volume, <filename>/dev/evms/sde</filename>:</para>
<orderedlist>
@ -204,7 +228,7 @@ remove the volume, <filename>/dev/evms/sde</filename>:</para>
<listitem><para>Click <guibutton>Delete</guibutton>.</para></listitem>
</orderedlist>
<para>After the volume is removed, assign the DOS Segment Manager:</para>
<para>After the volume is removed, add the DOS Segment Manager:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
@ -219,7 +243,7 @@ remove the volume, <filename>/dev/evms/sde</filename>:</para>
</sect2>
<sect2 id="assignsegncur"><title>Using Ncurses</title>
<para>To assign the DOS Segment Manager to <filename>sde</filename>, first remove the
<para>To add the DOS Segment Manager to <filename>sde</filename>, first remove the
volume <filename>/dev/evms/sde</filename>:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Delete</guimenuitem>
@ -239,7 +263,7 @@ volume <filename>/dev/evms/sde</filename>:</para>
</orderedlist>
<para>After the volume is removed, assign the DOS Segment Manager:</para>
<para>After the volume is removed, add the DOS Segment Manager:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Add</guimenuitem>
<guimenuitem>Segment Manager to Storage Object</guimenuitem></menuchoice></para></listitem>
@ -254,19 +278,91 @@ volume <filename>/dev/evms/sde</filename>:</para>
<sect2 id="assignsegcli"><title>Using the CLI</title>
<para>To assign the DOS Segment Manager to sde, first tell EVMS that this disk is not a
<para>To add the DOS Segment Manager to sde, first tell EVMS that this disk is not a
volume and is available for use:</para>
<programlisting>Delete:/dev/evms/sde</programlisting>
<para>Next, assign the DOS Segment Manager to sde by typing the following:</para>
<para>Next, add the DOS Segment Manager to sde by typing the following:</para>
<programlisting>Assign:DosSegMgr={},sde</programlisting>
<programlisting>Add:DosSegMgr={},sde</programlisting>
</sect2>
</sect1>
<sect1 id="removeseg"><title>Removing a segment manager</title>
<para>When a segment manager is removed from a disk, the disk can be reused by
other plug-ins. The <command>remove</command> command causes the segment manager to remove its
partition or slice table from the disk, leaving the raw disk storage object that then
becomes an available EVMS storage object. As an available storage object,
the disk is free to be used by any plug-in when storage objects are created or expanded.
You can also add any of the segment managers to the available disk storage object
to subdivide the disk into segments.</para>
<para>Most segment manager plug-ins check to determine if any of the segments are still in
use by other plug-ins or are still part of volumes. If a segment manager determines
that there are no disks from which it can safely remove itself, it will not be listed
when you use the <command>remove</command> command. In this case, you should delete the
volume or storage object that is consuming segments from the disk you want to reuse.</para>
</sect1>
<sect1 id="rmvex"><title>Example: remove a segment manager</title>
<para>This section shows how to remove
a segment manager with EVMS.</para>
<blockquote><example><title>Remove the DOS Segment Manager</title>
<para>Remove the DOS Segment Manager from disk <filename>sda</filename>.</para></example></blockquote>
<note><title>NOTE</title>
<para>In the following example, the DOS Segment
Manager has one primary partition on disk <filename>sda</filename>.
The segment is a compatibility volume known as
<filename>/dev/evms/sda1</filename>.</para></note>
<sect2 id="removeseggui"><title>Using the EVMS GUI context sensitive menu</title>
<para>Follow these steps to remove a segment manager with the GUI context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click <filename>/dev/evms/sda1</filename>..</para></listitem>
<listitem><para>Click <guibutton>Delete</guibutton>.</para></listitem>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>Remove</guimenuitem>
<guimenuitem>Segment Manager from Storage Object</guimenuitem></menuchoice>.</para></listitem>
<listitem><para>Select <guimenuitem>DOS Segment Manager, sda</guimenuitem>.</para></listitem>
<listitem><para>Click <guibutton>Remove</guibutton>.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="removesegcur"><title>Using Ncurses</title>
<para>Follow these steps to remove a segment manager with the Ncurses interface:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Delete</guimenuitem>
<guimenuitem>Volume</guimenuitem></menuchoice>.</para></listitem>
<listitem><para>Select <filename>/dev/evms/sda1</filename>.</para></listitem>
<listitem><para>Click <guibutton>Delete</guibutton>.</para></listitem>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Remove</guimenuitem>
<guimenuitem>Segment Manager from Storage Object</guimenuitem></menuchoice>.</para></listitem>
<listitem><para>Click <guibutton>Remove</guibutton>.</para></listitem>
</orderedlist>
</sect2>
<sect2 id="removesegcli"><title>Using the CLI</title>
<para>Follow these steps to remove a segment manager with the CLI:</para>
<programlisting>Delete:/dev/evms/sda1</programlisting>
<programlisting>Remove: sda</programlisting>
</sect2>
</sect1>
</chapter>
</chapter>

24
LDP/guide/docbook/EVMSUG/clusterops-ug.xml
View File

@ -1,12 +1,3 @@
<chapter id="clusterops"><title>Clustering operations</title>
<para>This chapter discusses how to configure cluster storage containers (referred to throughout
this chapter as &quot;cluster containers&quot;), a feature provided by the EVMS Cluster Segment
@ -431,7 +422,7 @@ Configuration Options dialog. Press <keycap>Enter</keycap>. </para>
<para>The outcome of the command is displayed at the bottom of the screen.</para>
</listitem>
<listitem><para>Save the changes by clickting <keycap>Save</keycap> in the <guimenuitem>Actions</guimenuitem> pulldown.</para></listitem>
<listitem><para>Save the changes by clicking <keycap>Save</keycap> in the <guimenuitem>Actions</guimenuitem> pulldown.</para></listitem>
<listitem><para>Quit Ncurses and run <command>evms_activate</command> on all the cluster nodes to deactivate the volumes of the shared container on all the other nodes. This process will be
automated in a future release of EVMS.</para></listitem>
@ -520,7 +511,7 @@ To deport a container with Ncurses, follow these steps:
<guimenuitem>Modify</guimenuitem>. Press <keycap>Enter</keycap>.
</para>
<para>
A submeny is displayed.
A submenu is displayed.
</para>
</listitem>
<listitem>
@ -609,7 +600,7 @@ will be automated in a future release of EVMS.
<sect1><title>Deleting a cluster container</title>
<para>
The procedure for deleting a cluster container is the same for deleting
any container. See <xref linkend="examdelrecur"/>
any container. See <xref linkend="examdelrecur"></xref>
@ -619,9 +610,9 @@ any container. See <xref linkend="examdelrecur"/>
<sect1><title>Failover and Failback of a private container on Linux-HA</title>
<para>EVMS supports the Linux-HA cluster manager in EVMS V2.0 and later; support for
<para>EVMS supports the Linux-HA cluster manager in EVMS V2.0 and later. Support for
the RSCT cluster
manager will be made available in a future release of EVMS.</para>
manager is also available as of EVMS V2.1, but is not as widely tested.</para>
<para><note><title>NOTE</title>
<para>Ensure that <command>evms_activate</command> is called in one of the startup scripts
before the <command>heartbeat</command> startup script is called. If <command>evms_activate</command> is not called, failover
@ -682,7 +673,7 @@ through the various EVMS user interfaces.</para>
<para>
The discovery of the remote configuration is initiated and the status
bar displays the message "Now administering node node2," which indicates
that the GUI is switched over and node node.
that the GUI is switched over to node node2.
</para>
</sect2>
@ -784,4 +775,5 @@ Running <command>evms_activate</command> on the node.
</sect1>
</chapter>
</chapter>

24
LDP/guide/docbook/EVMSUG/cmuse-ug.xml
View File

@ -1,10 +1,3 @@
<chapter id="evmscmuse"><title>Using the EVMS interfaces</title>
<para>This chapter explains how to use the EVMS GUI, Ncurses, and CLI interfaces.
This chapter also
@ -97,7 +90,7 @@ Options Window.</para>
<para>In the Main Window view, use the following keys to navigate:
<table><title>Accelerator keys in the Main Window</title>
<tgroup cols="2"><colspec colname="C1" colnum="1"/><colspec colname="C2" colnum="2"/>
<tgroup cols="2"><colspec colname="C1" colnum="1"></colspec><colspec colname="C2" colnum="2"></colspec>
<tbody>
<row><entry>Left and right arrow keys</entry>
<entry>Navigate between the notebook tabs of the different views.</entry></row>
@ -109,7 +102,7 @@ Options Window.</para>
While in a view, use the following keys to navigate:
<table><title>Accelerator keys in the views</title>
<tgroup cols="2"><colspec colname="C1" colnum="1"/><colspec colname="C2" colnum="2"/>
<tgroup cols="2"><colspec colname="C1" colnum="1"></colspec><colspec colname="C2" colnum="2"></colspec>
<tbody>
<row><entry>up and down arrows</entry><entry>Allow movement around the window.</entry></row>
<row><entry>&quot;+&quot;</entry><entry>Opens an object tree.</entry></row>
@ -152,7 +145,7 @@ A selection window typically contains a selection list, plus four to five
buttons below it. Use the following keys to navigate in the selection window:
<table><title>Accelerator keys in the selection window</title>
<tgroup cols="2"><colspec colname="C1" colnum="1"/><colspec colname="C2" colnum="2"/>
<tgroup cols="2"><colspec colname="C1" colnum="1"></colspec><colspec colname="C2" colnum="2"></colspec>
<tbody>
<row><entry><keycap>Tab</keycap></entry><entry>Navigates (changes keyboard focus) between the list and the buttons.</entry></row>
<row><entry>Up and down arrows</entry><entry>Navigates within the selection list.</entry></row>
@ -171,7 +164,7 @@ buttons below it. Use the following keys to navigate in the selection window:
Use the following keys to navigate in the configuration options window:
<table><title>Accelerator keys in the configuration options window</title>
<tgroup cols="2"><colspec colname="C1" colnum="1"/><colspec colname="C2" colnum="2"/>
<tgroup cols="2"><colspec colname="C1" colnum="1"></colspec><colspec colname="C2" colnum="2"></colspec>
<tbody>
<row><entry><keycap>Tab</keycap></entry><entry>Cycles focus between fields and buttons</entry></row>
<row><entry>Left and right arrows</entry><entry>Navigate the folder tabs if the window has a widget notebook.</entry></row>
@ -185,7 +178,7 @@ Use the following keys to navigate in the configuration options window:
<para>For widgets, use the following keys to navigate:
<table><title>Widget navigation keys in the configuration options window </title>
<tgroup cols="2"><colspec colname="C1" colnum="1"/><colspec colname="C2" colnum="2"/>
<tgroup cols="2"><colspec colname="C1" colnum="1"></colspec><colspec colname="C2" colnum="2"></colspec>
<tbody>
<row><entry><keycap>Tab</keycap></entry><entry>Cycles forward through a set of widgets</entry></row>
<row><entry><keycap>Shift-Tab</keycap></entry><entry>Cycles backward through a set of widgets.</entry></row>
@ -260,7 +253,7 @@ windows.
</itemizedlist>
<para>Dialog windows are similar in design to the EVMS GUI
dialogs, which allow a user to navigate forwards and backwards through a series
dialogs, which allow a user to navigate forward and backward through a series
of dialogs using <guibutton>Next</guibutton> and <guibutton>Previous</guibutton>. A general
guide to dialog windows is listed below:</para>
<itemizedlist>
@ -325,7 +318,7 @@ a list of commands available for a certain object.</para>
When invoked, the EVMS CLI prompts for commands. </para>
<para>The volume management commands the EVMS CLI understands
are specified in the <filename>/usr/src/evms-1.9.0/engine2/ui/cli/grammar.ps</filename>
are specified in the <filename>/usr/src/evms-2.2.0/engine2/ui/cli/grammar.ps</filename>
file that accompanies the EVMS
package. These commands are described in detail in the EVMS
man page, and help on these commands is available from within the EVMS
@ -439,4 +432,5 @@ Volume",compatibility</programlisting>
</chapter>
</chapter>

12
LDP/guide/docbook/EVMSUG/containerops-ug.xml
View File

@ -1,6 +1,6 @@
<chapter id="containerops"><title>Clustering operations</title>
<para>This chapter discusses how to configure cluster storage containers (referred to throughout
this chapter as &quot;cluster containers&quot;), a feature provided by the eVMS Cluster Segment
this chapter as &quot;cluster containers&quot;), a feature provided by the EVMS Cluster Segment
Manager (CSM).</para>
<para>Disks that are physically accessible from all of the nodes of the cluster can be
grouped together as a single manageable entity. EVMS storage objects can then be
@ -274,7 +274,7 @@ by <filename>evms1</filename>, convert
<sect2><title>Using the EVMS GUI</title>
<para>Follow these steps to convert a private cluster container to a shared cluster
container with the EVMU GUI:</para>
container with the EVMS GUI:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Modify</guimenuitem><guimenuitem>Container</guimenuitem></menuchoice> to see a list of containers.</para>
</listitem>
@ -370,7 +370,7 @@ is using the volumes on the container on any node of the cluster.</para></note>
<sect2><title>Using the EVMS GUI</title>
<para>Follow these steps to convert a shared cluster container to a private cluster
container with the EVMU GUI:</para>
container with the EVMS GUI:</para>
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>Modify</guimenuitem><guimenuitem>Container</guimenuitem></menuchoice> to see a list of containers.</para>
</listitem>
@ -429,7 +429,7 @@ Configuration Options dialog. Press <keycap>Enter</keycap>. </para>
<para>The outcome of the command is displayed at the bottom of the screen.</para>
</listitem>
<listitem><para>Save the changes by clickting <keycap>Save</keycap> in the <menuchoice>Actions</menuchoice> pulldown.</para></listitem>
<listitem><para>Save the changes by clicking <keycap>Save</keycap> in the <menuchoice>Actions</menuchoice> pulldown.</para></listitem>
<listitem><para>Run <command>evms_activate</command> on all the cluster nodes to deactivate the volumes of the shared container on all the other nodes. This process will be
automated in a future release of EVMS.</para></listitem>
@ -451,9 +451,9 @@ automated in a future release of EVMS.</para>
<sect1><title>Failover and Failback of a private container on Linux-HA</title>
<para>EVMS supports the Linux-HA cluster manager in EVMS V2.0 and later; support for
<para>EVMS supports the Linux-HA cluster manager in EVMS V2.0 and later. Support for
the RSCT cluster
manager will be made available in a future release of EVMS.</para>
manager is also available as of EVMS V2.1, but is not as widely tested.</para>
<para><note><title>NOTE</title>
<para>Ensure that <command>evms_activate</command> is called in one of the startup scripts
before the heartbeat daemon starts (for example, <filename>/etc/kinit.d/heartbeat</filename>). If <command>evms_activate</command> is not called, failover

14
LDP/guide/docbook/EVMSUG/convertto-ug.xml
View File

@ -1,16 +1,13 @@
<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"/>.</para>
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 BBR, 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 umounted 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
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>
@ -22,14 +19,14 @@ is converted, you can remount it using its new name.</para>
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 EMVS metadata.</para></listitem></itemizedlist></para>
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 compatability volume <filename>/dev/evms/hda3</filename>
<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>
@ -182,4 +179,5 @@ instructions.</para>
</sect1>
</chapter>
</chapter>

10
LDP/guide/docbook/EVMSUG/create-drivelinking.xml
View File

@ -7,14 +7,14 @@ and delete a drive link.</para>
<sect1 id="whatisdrivelinking"><title>What is drive linking?</title>
<para>Drive linking linearly concatenates objects, allowing you to
create large storage objects and volumes from smaller individual pieces.
create larger storage objects and volumes from smaller individual pieces.
For example, say you need a 1 GB volume but do
not have contiguous space available of that length. Drive linking lets you
link two or more objects together to form the 1 GB volume.</para>
<para>
The types of objects that can be drive linked include disks, segments,
regions, compatibility volumes, and other feature objects.
regions, and other feature objects.
</para>
<para>
@ -84,7 +84,7 @@ The ordering of the drive link is implied by the order in which you pick
objects from the provided list.
After you provide a name for the new drive-link object, the identified
link objects are consumed and the new drive-link object is produced.
There are no create objects.
The name for the new object is the only option when creating a drive-link.
</para>
<para>Only the last object in a drive link
@ -257,7 +257,7 @@ can be selected and added to the drive link.
If the expansion point is the last storage object in the drive link, then you expand the
drive link by interacting with the plug-in that produced the object. For example, if
the link was a segment, then the segment manager plug-in that produced the storage
object expands the link object. Afterwards, the drive link plug-in notices the size
object expands the link object. Afterwords, the drive link plug-in notices the size
difference and updates the drive link metadata to reflect the resize of the child object.</para>
<para>
There are no expand options.
@ -285,7 +285,7 @@ If you select this object, the drive link plug-in then lists the next-to-last
link object, and so forth, moving backward through the link
objects to satisfy the shrink command.
</para>
<para>If the shrink point is the last storage object in th drive link, then you shrink the
<para>If the shrink point is the last storage object in the drive link, then you shrink the
drive link by interacting with the plug-in that produced the object.</para>
<para>

12
LDP/guide/docbook/EVMSUG/create-reg-ug.xml
View File

@ -1,6 +1,3 @@
<chapter id="evmscreatereg"><title>Creating regions</title>
<para>Regions can be created from containers, but they can also be created from other
@ -17,7 +14,7 @@ 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>
you would create a region out of a Linux LVM container and then a compatibility volume from that region. </para>
</sect1>
<sect1 id="crregex"><title>Example: create a region</title>
@ -52,7 +49,7 @@ providing instructions to help you complete the following task.</para>
<listitem><para>Select the freespace region from
the container you created in
<xref linkend="evmscreatecont"/>.
<xref linkend="evmscreatecont"></xref>.
Verify that the region is named
<filename>lvm&sol;Sample Container&sol;Freespace</filename>.
Click <guibutton>Next</guibutton>.</para>
@ -100,7 +97,7 @@ providing instructions to help you complete the following task.</para>
<listitem><para>Select the freespace
region from the container you created
earlier in <xref linkend="evmscreatecont"/>. Verify that
earlier in <xref linkend="evmscreatecont"></xref>. Verify that
the region is named
<filename>lvm&sol;Sample Container&sol;Freespace</filename>.</para></listitem>
@ -156,4 +153,5 @@ context sensitive menu:</para>
</sect2>
</sect1>
</chapter>
</chapter>

10
LDP/guide/docbook/EVMSUG/create-seg.xml
View File

@ -1,6 +1,3 @@
<chapter id="evmscreateseg"><title>Creating segments</title>
<para>This chapter discusses when to use segments and how to create them using
@ -9,7 +6,7 @@ different EVMS interfaces.</para>
<sect1 id="whyseg"><title>When to create a segment</title>
<para>A disk can be subdivided into smaller storage objects called disk segments. A segment manager plug-in provides this capability. Another reason for creating disk segments is to maintain compatibility on a dual boot system where the other operating system requires disk partitions. Before creating a disk segment, you must choose a segment manager plug-in to manage the disk and assign
the segment manager to the disk. An explanation of when and how to assign segment managers can be found in <xref linkend="evmsassignseg"/>.</para>
the segment manager to the disk. An explanation of when and how to assign segment managers can be found in <xref linkend="evmsassignseg"></xref>.</para>
</sect1>
@ -112,7 +109,7 @@ on <filename>sde_freespace1</filename>.</para></listitem>
<para>Alternatively, you can perform some of the steps to create a segment from the
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Segments view, press <keycap>Enter</keycap> on <filename>sde_frespace1</filename>.</para>
<listitem><para>From the Segments view, press <keycap>Enter</keycap> on <filename>sde_freespace1</filename>.</para>
</listitem>
<listitem><para>Activate <guimenuitem>Create Segment</guimenuitem>.</para>
</listitem>
@ -150,4 +147,5 @@ context sensitive menu:</para>
</sect1>
</chapter>
</chapter>

284
LDP/guide/docbook/EVMSUG/create-snapshot.xml
View File

@ -1,7 +1,3 @@
<chapter id="evmscreatesnap"><title>Creating snapshots</title>
<para>This chapter discusses snapshotting and tells how to create
@ -20,15 +16,12 @@ same and looks exactly like the original at the time the snapshot was
created.
</para>
<para>The snapshot feature is very useful for performing data backups.
In order to perform a consistent backup, the volume that is being backed up
should not change while the
backup is running.
This often means the volume must be taken offline during the
backup, which can be a significant inconvenience to users.
With snapshots, the volume can be kept online.
A snapshot of the volume is created and the backup is taken
from the snapshot, while the original remains in active use.
<para>
Snapshotting allows you to keep a volume online while a backup is created.
This method is much more convenient than a data backup where a volume
must be taken offline to perform a consistent backup.
When snapshotting, a snapshot of the volume is created and the backup
is taken from the snapshot, while the original remains in active use.
</para>
</sect1>
@ -47,9 +40,8 @@ object, which is to make an EVMS volume from the object.</para>
The size of this consumed object is
the size available to the snapshot object. The snapshot object can be smaller
or larger than the original volume.
If the object is smaller, the original volume could fill up
as data is copied from the original to the snapshot, given sufficient
activity on the original.
If the object is smaller, the snapshot volume could fill up as data is copied
from the original to the snapshot, given sufficient activity on the original.
In this situation, the snapshot is deactivated and additional
I/O to the snapshot fails.
</para>
@ -58,7 +50,7 @@ I/O to the snapshot fails.
is likely to take place on the original during the lifetime of the snapshot.
The more changes that occur on the
original and the longer the snapshot is expected to remain active,
the larger the snapshot should be.
the larger the snapshot object should be.
Clearly, determining this calculation is not simple and requires trial and
error to determine the correct snapshot object size to use for a
particular situation.
@ -66,8 +58,8 @@ The goal is to create a snapshot object large enough to prevent the
shapshot from being
deactivated if it fills up, yet small enough to not waste disk space.
If the snapshot
object is the same size as the original volume (actually, a little larger,
to account for the snapshot mapping tables), the snapshot is
object is the same size as the original volume, or a little larger,
to account for the snapshot mapping tables, the snapshot is
never deactivated.
</para>
@ -76,8 +68,10 @@ never deactivated.
<sect2><title>Activating a snapshot</title>
<para>After you create a snapshot, activate it by making an EVMS volume from the object.
After you create the volume and save the changes, the snapshot is active. The only
option for activating snapshots is the name to give the EVMS volume. This name can be
After you create the volume and save the changes, the snapshot is active.
The only option you have to specify for activating snapshots is
the name to give the EVMS volume.
This name can be
the same as or different than the name of the snapshot object.</para>
</sect2>
@ -126,7 +120,7 @@ it &quot;snap.&quot;</para></example></blockquote>
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Available Objects</guimenuitem> tab, right click
<filename>lvm/Sample Container/Sample Region</filename>.</para></listitem>
<guimenuitem>lvm/Sample Container/Sample Region</guimenuitem>.</para></listitem>
<listitem><para>Click <guimenuitem>Create Feature Object...</guimenuitem></para></listitem>
<listitem><para>Continue creating the snapshot beginning with step 2 of the
GUI instructions. You can skip steps 4 and 5 of the GUI instructions.</para></listitem>
@ -203,17 +197,182 @@ instructions.</para>
</sect1>
<sect1><title>Reinitializing a snapshot</title>
<para>Snapshots can be reinitialized, which causes all of the
<para>Snapshots can be reinitialized. Reinitializing causes all of the
saved data to be erased and
starts the snapshot from the current point in time.
A reinitialized snapshot has the same
original, chunk size, and writeable flags as the original
snapshot.</para>
<para>To reinitialize a snapshot, delete the EVMS volume from the
snapshot without deleting the snapshot object.
Then create a new EVMS volume from the snapshot object.
<para>To reinitialize a snapshot, use the <command>Reset</command>
command on the snapshot object
(not the snapshot volume).
This command reinitializes the snapshot without requiring you to
manually delete and recreate the volume.
The snapshot volume must be unmounted for it to be reinitialized.
</para>
<para>This section continues the example from the previous section,
where a snapshot object and volume were created.
The snapshot object is called &quot;snap&quot; and the volume
is called &quot;/dev/evms/snap.&quot;</para>
<sect2><title>Using the EVMS GUI or Ncurses</title>
<para>To reinitialize a snapshot, follow these steps:
<orderedlist>
<listitem><para>Select
<menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Other</guimenuitem>
<guimenuitem>Storage Object Tasks</guimenuitem>
</menuchoice>
</para></listitem>
<listitem><para>Select the volume "snap."</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select <guibutton>Reset</guibutton>.</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Click <guibutton>Reset</guibutton> on the action panel.
</para></listitem>
<listitem><para>Click <guibutton>Reset</guibutton> on the warning panel.</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform these same steps with the context sensitive menus:</para>
<orderedlist>
<listitem><para>From the Feature Objects panel, right click (or press <keycap>Enter</keycap> on)
the object <guimenuitem>snap</guimenuitem>.
</para>
</listitem>
<listitem><para>Click <guibutton>Reset</guibutton> on the popup menu.</para></listitem>
<listitem><para>Click <guibutton>Reset</guibutton> on the action panel.</para></listitem>
<listitem><para>Click <guibutton>Reset</guibutton> on the warning panel.</para></listitem>
</orderedlist>
</sect2>
<sect2><title>Using the CLI</title>
<para>Follow these steps to reinitialize a snapshot with the CLI:</para>
<orderedlist>
<listitem><para>Issue the following command to the CLI:</para>
<programlisting>task:reset,snap</programlisting>
</listitem>
<listitem><para>Press <keycap>Enter</keycap> to select &quot;Reset&quot; (the default choice) at the warning message.</para>
</listitem>
</orderedlist>
</sect2>
</sect1>
<sect1><title>Expanding a snapshot</title>
<para>
As mentioned in the <xref linkend="createactivsnap"></xref>, as data is
copied from the original volume to the snapshot, the space available
for the snapshot might fill up, causing the snapshot to be invalidated.
This situation might cause your data backup to end prematurely, as the
snapshot volume begins returning I/O errors after it is invalidated.
</para>
<para>
To solve this problem, EVMS now has the ability to expand the storage
space for a snapshot object while the snapshot volume is active and mounted.
This feature allows you to initially create a small snapshot object and expand
the object as necessary as the space begins to fill up.
</para>
<para>
In order to expand the snapshot object, the underlying object must
be expandable.
Continuing the example from the previous sections, the object "snap" is
built on the LVM region <filename>lvm/Sample Container/Sample Region</filename>.
When we refer to expanding the "snap" object, the region
<filename>lvm/Sample Container/Sample Region</filename> is the
object that actually gets
expanded, and the object "snap" simply makes use of the new space on
that region.
Thus, to have expandable snapshots, you will usually want to build
your snapshot objects on top of LVM regions that have extra freespace
available in their LVM container. DriveLink objects and some disk
segments also work in certain situations.
</para>
<para>
One notable quirk about expanding snapshots is that the snapshot
object and volume do not actually appear to expand after the operation
is complete.
Because the snapshot volume is supposed to be a frozen image of the original
volume, the snapshot volume always has the same size as the original,
even if the snapshot has been expanded.
However, you can verify that the snapshot object is using the
additional space by displaying the details for the snapshot object
and comparing the percent-full field before and after the expand operation.
</para>
<sect2><title>Using the EVMS GUI or Ncurses</title>
<para>To create the snapshot using the GUI or Ncurses, follow these steps:
<orderedlist>
<listitem><para>Select
<menuchoice>
<guimenu>Actions</guimenu>
<guimenuitem>Expand</guimenuitem>
<guimenuitem>Volume</guimenuitem>
</menuchoice>
to see a list of EVMS feature objects.
</para></listitem>
<listitem><para>Select the volume <guimenuitem>/dev/evms/snap</guimenuitem>.</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select <guimenuitem>lvm/Sample Container/Sample Region</guimenuitem>.
This object is the object that will actually be expanded. </para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select the options for expanding the LVM region,
including the amount of extra space to add to the region.
</para></listitem>
<listitem><para>Click <guibutton>Expand</guibutton>.
</para></listitem>
</orderedlist></para>
<para>Alternatively, you can perform the same steps using the context sensitive menus.</para>
<orderedlist>
<listitem><para>From the <guilabel>Volumes</guilabel> panel, right click (or press <keycap>Enter</keycap> on)
<guimenuitem>/dev/evms/snap</guimenuitem>.
</para>
</listitem>
<listitem><para>Select <guibutton>Expand</guibutton> from the popup menu.</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select the region <guimenuitem>lvm/Sample Container/Sample Region</guimenuitem>. This is the object that will
actually be expanded.</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select the options for expanding the LVM region, including the
amount of extra space to add to the region.</para></listitem>
<listitem><para>Click <guibutton>Expand</guibutton>.</para>
</listitem>
</orderedlist>
</sect2>
<sect2><title>Using the CLI</title>
<para>The CLI expands volumes by targeting the object to be
expanded.
The CLI automatically handles expanding the volume and other objects above the volume
in the volume stock. As with a regular expand operation, the options are determined
by the plug-in that owns the object being expanded.</para>
<para>Issue the following command to determine the expand options for the
region <filename>lvm/Sample Container/Sample Region</filename>:</para>
<programlisting>query:region,region=&quot;lvm/Sample Container/Sample Region&quot;,lo</programlisting>
<para>The option to use for expanding this region is called &quot;add_size.&quot;
Issue the following command to expand the snapshot by 100 MB:</para>
<programlisting>expand:&quot;lvm/Sample Container/Sample Region&quot;, add_size=100MB</programlisting>
</sect2>
</sect1>
<sect1><title>Deleting a snapshot</title>
@ -239,12 +398,75 @@ snapshot. If the testing is successful, you can then roll back the snapshot to
original and effectively install the software on the regular system. If there is a problem
during the testing, you can simply delete the snapshot without harming the original
volume.</para>
<para>Rollback can only be performed when both the snapshot and the original volumes
are unmounted and otherwise not in use. Rollback can also be performed only when
there is only a single snapshot of an original. If an original has multiple snapshots,
all but the desired snapshot must be deleted before rollback can take place.</para>
<para>You can perform a rollback when the following conditions are met:
</para>
<itemizedlist>
<listitem>
<para>
Both the snapshot and the original volumes
are unmounted and otherwise not in use.
</para>
</listitem>
<listitem>
<para>
There is only a single snapshot of an original.</para>
<para>
If an original has multiple snapshots,
all but the desired snapshot must be deleted before rollback can take place.
</para>
</listitem>
</itemizedlist>
<para>No options are available for rolling back snapshots.</para>
<sect2><title>Using the EVMS GUI or Ncurses</title>
<para>Follow these steps to roll back a snapshot with the EVMS GUI or Ncurses:</para>
<orderedlist>
<listitem><para>Select
<menuchoice><guimenu>Actions</guimenu>
<guimenuitem>Other</guimenuitem>
<guimenuitem>Storage Object Tasks</guimenuitem>.
</menuchoice> </para></listitem>
<listitem><para>Select the object "snap."</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select <guibutton>Rollback</guibutton></para>.</listitem>
<listitem><para>Click <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Click <guibutton>Rollback</guibutton> on the action panel.
</para></listitem>
<listitem><para>Click <guibutton>Rollback</guibutton> on the warning panel.
</para></listitem>
</orderedlist>
<para>Alternatively, you can perform these same steps with the context sensitive menus:</para>
<orderedlist>
<listitem><para>From the Feature Objects panel, right click (or press
<keycap>Enter</keycap> on) the object &quot;snap.&quot;</para>
</listitem>
<listitem><para>Click <guibutton>Rollback</guibutton> on the popup menu.</para>
</listitem>
<listitem><para>Click <guibutton>Rollback</guibutton> on the action panel.</para>
</listitem>
<listitem><para>Click <guibutton>Rollback</guibutton> on the warning panel.</para>
</listitem>
</orderedlist>
</sect2>
<sect2><title>Using the CLI</title>
<para>Follow these steps to roll back a snapshot with the CLI:</para>
<orderedlist>
<listitem><para>Issue the following command to the CLI:</para>
<programlisting>task:rollback,snap</programlisting>
</listitem>
<listitem><para>Press <keycap>Enter</keycap> to select &quot;Rollback&quot; (the default choice) at the warning message.</para>
</listitem>
</orderedlist>
</sect2>
</sect1>
</chapter>
</chapter>

17
LDP/guide/docbook/EVMSUG/createvol-ug.xml
View File

@ -1,7 +1,3 @@
<chapter id="evmscreatevol"><title>Creating volumes</title>
<para>This chapter discusses when and how to create volumes.</para>
@ -21,13 +17,13 @@ become a volume; it must be made into a volume.</para>
<para>EVMS native volumes contain EVMS-specific information
to identify the name and minor number. After this volume information is
applied, the volume is no longer fully backwards compatible
applied, the volume is no longer fully backward compatible
with existing volume types.</para>
<para>Instead of
adding EVMS metadata to an existing object, you can tell EVMS to make an object directly available as a volume. This type of
volume is known as a compatibility volume. Using this method, the final product is fully
backwards-compatible with the desired system. </para>
backward-compatible with the desired system. </para>
</sect1>
<sect1 id="crvolexcomp"><title>Example: create an EVMS native volume</title>
@ -37,7 +33,7 @@ become a volume; it must be made into a volume.</para>
<blockquote><example><title>Create an EVMS native volume </title>
<para>Create an EVMS native volume called &quot;Sample Volume&quot; from the region, <filename>/lvm/Sample Container/Region</filename>, you created in <xref linkend="evmscreatereg"/>.</para></example></blockquote>
<para>Create an EVMS native volume called &quot;Sample Volume&quot; from the region, <filename>/lvm/Sample Container/Region</filename>, you created in <xref linkend="evmscreatereg"></xref>.</para></example></blockquote>
<sect2 id="evmsguivol"><title>Using the EVMS GUI</title>
@ -116,7 +112,7 @@ from the context sensitive menu:</para>
<blockquote><example><title>Create a compatibility volume</title>
<para>Create a compatibility volume called &quot;Sample Volume&quot; from
the region, <filename>/lvm/Sample Container/Region</filename>, you created in <xref linkend="evmscreatereg"/>.</para></example></blockquote>
the region, <filename>/lvm/Sample Container/Region</filename>, you created in <xref linkend="evmscreatereg"></xref>.</para></example></blockquote>
<sect2 id="guicompvol"><title>Using the GUI</title>
<para>To create a compatibility volume, follow these steps:</para>
@ -179,7 +175,7 @@ the context sensitive menu:</para>
<sect2><title>Using the CLI</title>
<para>To create a volume, use the <command>Create</command> command. The arguments
the <command>Create</command> cocmmand accepts vary depending on what is being created. In
the <command>Create</command> command accepts vary depending on what is being created. In
the case of the example, the first argument is the key word <option>volume</option> that
specifies what is being created. The second argument is the object being made into a volume,
in this case <option>lvm/Sample Container/Sample Region</option>.
@ -192,4 +188,5 @@ the context sensitive menu:</para>
</chapter>
</chapter>

6
LDP/guide/docbook/EVMSUG/deleterecurs-ug.xml
View File

@ -1,9 +1,9 @@
<chapter id="deleterecurs"><title>Destroying EVMS objects</title>
<chapter id="deleterecurs"><title>Deleting objects</title>
<para>This chapter tells how to destroy EVMS objects through the delete and
<para>This chapter tells how to delete EVMS objects through the delete and
delete recursive operations.</para>
@ -162,4 +162,4 @@ continuing with these steps) enter the following to destroy the container and ev
</sect2>
</sect1>
</chapter>
</chapter>

8
LDP/guide/docbook/EVMSUG/displaydetails-ug.xml
View File

@ -1,6 +1,3 @@
<chapter id="displaydetails"><title>Obtaining interface display details</title>
<para>The EVMS interfaces let you view more detailed information about an EVMS object than
@ -22,7 +19,7 @@ to volume <filename>/dev/evms/Sample Volume</filename>. Alternatively, look at
<listitem><para>Right click <filename>lvm/Sample Container/Sample Region</filename>.</para></listitem>
<listitem><para>Point at <guibutton>Display Details...</guibutton> and left click. A new window opens
<listitem><para>Point at <guibutton>Display Details...</guibutton> and click. A new window opens
with additional information about the selected region.</para></listitem>
<listitem><para>Click <guimenu>More</guimenu> by the <guibutton>Logical Extents box</guibutton>. Another window opens that displays the mappings of logical extents to physical extents.</para>
@ -84,4 +81,5 @@ by commas. For example, if you wanted additional information about logical exte
<programlisting>query: extended info, &quot;lvm/Sample Container/Sample Region&quot;, Extents</programlisting>
</sect1>
</chapter>
</chapter>

17
LDP/guide/docbook/EVMSUG/fsimops-ug.xml
View File

@ -1,6 +1,3 @@
<chapter id="evmsfsimops"><title>FSIMs and file system operations</title>
<para>This chapter discusses the five File System Interface Modules (FSIMs) shipped with EVMS, and then provides examples of adding file systems and coordinating file system checks with the FSIMs.</para>
@ -23,8 +20,7 @@
<para>
The JFS module supports the IBM journaling file system (JFS).
Current support includes <command>mkfs</command>, <command>unmkfs</command>,
<command>fsck</command>, and online file system expansion.
Support for external logging will be added in a future release of EVMS.
<command>fsck</command>, and online file system expansion.
You must
have at least version 1.0.9 of the JFS utilities for your system
to work with this EVMS FSIM. You can download the latest utilities
@ -32,7 +28,7 @@ from the <ulink url="http://oss.software.ibm.com/jfs">JFS for Linux</ulink>
site.
</para>
<para>
For more information on the JFS FSIM, refer to <xref linkend="jfsfsim"/>.
For more information on the JFS FSIM, refer to <xref linkend="jfsfsim"></xref>.
</para>
</sect2>
@ -45,7 +41,7 @@ Command support includes <command>mkfs</command>, <command>unmkfs</command>,
</para>
<para>
For more information on the XFS FSIM, refer to <xref linkend="xfsfsim"/>.
For more information on the XFS FSIM, refer to <xref linkend="xfsfsim"></xref>.
</para>
</sect2>
@ -61,7 +57,7 @@ System Venture (Namesys) </ulink> web site.
</para>
<para>
For more information on the ReiserFS FSIM, refer to <xref linkend="reiserfsim"/>.
For more information on the ReiserFS FSIM, refer to <xref linkend="reiserfsim"></xref>.
</para>
</sect2>
@ -73,7 +69,7 @@ The FSIM supports <command>mkfs</command>, <command>unmkfs</command>,
</para>
<para>
For more information on the Ext2/3 FSIM, refer to <xref linkend="ext23fsim"/>.
For more information on the Ext2/3 FSIM, refer to <xref linkend="ext23fsim"></xref>.
</para>
</sect2>
@ -282,7 +278,7 @@ use, look at the results of the following query:</para>
</para></listitem>
<listitem><para>Scroll down using the <keycap>down</keycap> arrow until
<guimenuitem>Vebose Output</guimenuitem> is highlighted.
<guimenuitem>Verbose Output</guimenuitem> is highlighted.
</para></listitem>
<listitem><para>Press <keycap>Spacebar</keycap> to change <guimenuitem>Verbose Output</guimenuitem> to <keycap>Yes</keycap>.
@ -324,3 +320,4 @@ instructions.</para>
</sect1>
</chapter>

22
LDP/guide/docbook/EVMSUG/install-ug.xml
View File

@ -1,7 +1,3 @@
<chapter id="evmsuginstall"><title>Downloading and installing EVMS </title>
<para>This chapter tells how to obtain and install EVMS, and offers guidelines to help you make decisions about your EVMS installation. If you are setting up EVMS to work in a cluster,
execute the steps described in this chapter on each of the nodes in the cluster.</para>
@ -91,14 +87,14 @@ patch -p1 &lt; /src/src/evms-2.0.0/kernel/2.4.20/7-vfs-lock.patch</programlistin
<para>If you are using an Xwindow system, the following window opens. </para>
<figure><title>xconfig Window</title>
<mediaobject><imageobject><imagedata fileref="xconf.png" format="PNG"/></imageobject>
<mediaobject><imageobject><imagedata format="PNG" fileref="xconf.png"></imagedata></imageobject>
<textobject><phrase>xconfig Window</phrase></textobject></mediaobject></figure>
</listitem>
<listitem><para>To enable the kernel components that EVMS needs, select
<guimenuitem>Multi-device support (RAID and LVM)</guimenuitem>. The following window opens.</para>
<figure><title>Multi-device Support (RAID and LVM) Window</title>
<mediaobject><imageobject><imagedata fileref="mdconf.png" format="PNG"/></imageobject>
<mediaobject><imageobject><imagedata format="PNG" fileref="mdconf.png"></imagedata></imageobject>
<textobject><phrase>MD Support (RAID and LVM) Window</phrase>
</textobject></mediaobject></figure>
<note><title>NOTE</title>
@ -115,7 +111,8 @@ patch -p1 &lt; /src/src/evms-2.0.0/kernel/2.4.20/7-vfs-lock.patch</programlistin
The remaining options add additional capabilities to EVMS.</para>
<note><title>NOTE</title>
<para>The options you select in this step are the ones you selected in <xref linkend="selectcapabilities"/>.</para></note>
<para>The options you select in this step are the ones you selected in
<xref linkend="selectcapabilities"></xref>.</para></note>
</listitem>
@ -175,7 +172,7 @@ patch -p1 &lt; /src/src/evms-2.0.0/kernel/2.4.20/7-vfs-lock.patch</programlistin
<note><title>NOTE</title>
<para>If you installed your kernel as modules, skip to
<xref linkend="INSTALLENGINE"/>. </para></note></listitem>
<xref linkend="INSTALLENGINE"></xref>. </para></note></listitem>
<listitem><para>Reboot your machine and choose the new
kernel image to run with EVMS support.</para></listitem>
@ -445,7 +442,7 @@ An initial ramdisk
is a ram-based device that acts as a temporary root file system at boot time. The
initial ramdisk lets EVMS run programs and load modules that are necessary to
activate the true root file system.</para>
<para>For instructions on building an init-ramdisk for use with EVMS, see <xref linkend="appxinitram"/>.</para></sect1>
<para>For instructions on building an init-ramdisk for use with EVMS, see <xref linkend="appxinitram"></xref>.</para></sect1>
<sect1 id="setupclus"><title>Setting up clustered EVMS</title>
<para>The following steps show how to set up EVMS clustering. Perform these steps on
@ -461,7 +458,7 @@ line to configure CCM:</para>
channel, create the following fifo with administrative privileges:</para>
<programlisting>mkfifo /var/lib/heartbeat/api/evms.req
mkfifo /var/lib/heartbeat/api/evms.rsp
chgrp haclient /var/lib/heartbeate/api/evms.req
chgrp haclient /var/lib/heartbeat/api/evms.req
chgrp haclient /var/lib/heartbeat/api/evms.rsp
chmod 200 /var/lib/heartbeat/api/evms.req
chmod 600 /var/lib/heartbeat/api/evms.rsp</programlisting>
@ -477,7 +474,7 @@ the command.</para>
</listitem>
</orderedlist>
<para>See <xref linkend="clusterops"/> for information about clustering
<para>See <xref linkend="clusterops"></xref> for information about clustering
operations.</para>
</sect1>
@ -486,4 +483,5 @@ operations.</para>
</chapter>
</chapter>

16
LDP/guide/docbook/EVMSUG/over-ug.xml
View File

@ -1,8 +1,3 @@
<chapter id="intro"><title>What is EVMS?</title>
<para>EVMS brings a new model of volume management to Linux&reg;.
@ -42,11 +37,11 @@ be highly available from different nodes in the cluster.</para>
<para>There are currently three user interfaces available for EVMS: graphical (GUI), text mode (Ncurses), and the Command Line Interpreter (CLI).
Additionally, you can use the EVMS Application Programming Interface to implement your own customized user interface. </para>
<para><xref linkend="userinterf"/> tells more about each of the EVMS user interfaces.
<para><xref linkend="userinterf"></xref> tells more about each of the EVMS user interfaces.
</para>
<table id="userinterf" frame="all"><title>EVMS user interfaces</title>
<tgroup cols="4"><colspec colwidth="1in" colnum="1"/><colspec colwidth="1.5in" colnum="2"/><colspec colwidth="1in" colnum="3"/><colspec colwidth="2.5in" colnum="4"/>
<tgroup cols="4"><colspec colnum="1" colwidth="1in"></colspec><colspec colnum="2" colwidth="1.5in"></colspec><colspec colnum="3" colwidth="1in"></colspec><colspec colnum="4" colwidth="2.5in"></colspec>
<thead><row><entry>User interface</entry>
<entry>Typical user</entry>
<entry>Types of use</entry>
@ -131,7 +126,7 @@ Additionally, you can use the EVMS Application Programming Interface to implemen
<varlistentry><term>Shared storage container</term>
<listitem><para>A collection of disks that are physically accessible from all
nodes of a cluster, managed as a single pool of storage, and owned and accessed
by all noDes of the cluster simultaneously.</para>
by all nodes of the cluster simultaneously.</para>
</listitem>
</varlistentry>
@ -148,7 +143,7 @@ Additionally, you can use the EVMS Application Programming Interface to implemen
bad block relocation. </para>
<para>An <glossterm>EVMS Native Feature</glossterm> is a function of volume management designed
and implemented by
EVMS. These features are not intended to be backwards compatible with other
EVMS. These features are not intended to be backward compatible with other
volume management technologies. </para></listitem>
</varlistentry>
@ -336,4 +331,5 @@ other volume management systems.</para>
</variablelist>
</sect1>
</chapter>
</chapter>

72
LDP/guide/docbook/EVMSUG/pref-ug.xml
View File

@ -1,8 +1,5 @@
<preface id="userguidepref"><title>Preface</title>
<para>This guide tells how to install, configure, and manage Enterprise
<para>This guide tells how to configure and manage Enterprise
Volume Management System (EVMS). EVMS is a storage management program
that provides a single framework for managing and administering your system's storage.</para>
@ -19,63 +16,64 @@ web site</ulink>.</para>
<table frame="all" id="bookorg"><title>Organization of the EVMS User Guide</title>
<tgroup cols="2"><colspec colwidth="1.5in" colnum="1"/><colspec colwidth="3.5in" colnum="2"/>
<tgroup cols="2"><colspec colwidth="1.5in" colnum="1"></colspec><colspec colwidth="3.5in" colnum="2"></colspec>
<thead><row><entry>Chapter or appendix title</entry>
<entry>Contents</entry></row></thead>
<tbody><row><entry>1. What is EVMS?</entry>
<entry>Discusses general EVMS concepts and terms.</entry></row>
<row><entry>2. Downloading and installing EVMS</entry>
<entry>Tells how to access and install EVMS and configure it for use on your system.</entry></row>
<row><entry>3. Using the EVMS interfaces</entry>
<row><entry>2. Using the EVMS interfaces</entry>
<entry>Describes the three EVMS user interfaces and how to use them.</entry></row>
<row><entry>4. The EVMS log file and error data collection</entry>
<row><entry>3. The EVMS log file and error data collection</entry>
<entry>Discusses the EVMS information and error log file and explains how to change the logging level.</entry></row>
<row><entry>5. Viewing compatibility volumes after migrating</entry>
<row><entry>4. Viewing compatibility volumes after migrating</entry>
<entry>Tells how to view existing files that have been migrated to EVMS.</entry></row>
<row><entry>6. Obtaining interface display details</entry>
<row><entry>5. Obtaining interface display details</entry>
<entry>Tells how to view detailed information about EVMS objects.</entry></row>
<row><entry>7. Assigning a segment manager</entry>
<entry>Discusses segments and explains how to assign a segment manager.</entry></row>
<row><entry>8. Creating segments</entry>
<row><entry>6. Adding and removing a segment manager</entry>
<entry>Discusses segments and explains how to add and remove a segment manager.</entry></row>
<row><entry>7. Creating segments</entry>
<entry>Explains when and how to create segments.</entry></row>
<row><entry>9. Creating containers</entry>
<row><entry>8. Creating containers</entry>
<entry>Discusses containers and explains when and how to create them.</entry></row>
<row><entry>10. Creating regions</entry>
<row><entry>9. Creating regions</entry>
<entry>Discusses regions and explains when and how to create them.</entry></row>
<row><entry>11. Creating drive links</entry>
<row><entry>10. Creating drive links</entry>
<entry>Discusses the drive linking feature and tells how to create a drive link.</entry></row>
<row><entry>12. Creating snapshots</entry>
<row><entry>11. Creating snapshots</entry>
<entry>Discusses snapshotting and tells how to create a snapshot.</entry></row>
<row><entry>13. Creating volumes</entry><entry>Explains when and how to create volumes.</entry></row>
<row><entry>14. FSIMS and file system operations</entry>
<row><entry>12. Creating volumes</entry><entry>Explains when and how to create volumes.</entry></row>
<row><entry>13. FSIMs and file system operations</entry>
<entry>Discusses the standard FSIMs shipped with EVMS and provides examples of adding file systems and coordinating file checks with the FSIMs.</entry></row>
<row><entry>15. Clustering operations</entry><entry>Describes EVMS clustering and how to create private and shared containers.</entry></row>
<row><entry>16. Converting volumes</entry>
<row><entry>14. Clustering operations</entry><entry>Describes EVMS clustering and how to create private and shared containers.</entry></row>
<row><entry>15. Converting volumes</entry>
<entry>Explains how to convert EVMS native volumes to compatibility volumes and compatibility volumes to EVMS native volumes.</entry></row>
<row><entry>17. Expanding and shrinking volumes</entry><entry>Tells how to expand and shrink EVMS volumes with the various EVMS user interfaces.</entry></row>
<row><entry>18. Adding features to an existing volume</entry>
<row><entry>16. Expanding and shrinking volumes</entry><entry>Tells how to expand and shrink EVMS volumes with the various EVMS user interfaces.</entry></row>
<row><entry>17. Adding features to an existing volume</entry>
<entry>Tells how to add additional features, such as drive linking and bad block relocation, to an existing volume.</entry></row>
<row><entry>19. Plug-in operations tasks</entry>
<row><entry>18. Plug-in operations tasks</entry>
<entry>Discusses the plug-in tasks that are available within the context of a particular plug-in.</entry></row>
<row><entry>20. Destroying EVMS objects</entry><entry>Tells how to safely destroy EVMS objects.</entry></row>
<row><entry>A. Building an init-ramdisk to use with EVMS</entry>
<entry>Explains the steps necessary to build a ram-based device that acts a temporary root file system at boot time.</entry></row>
<row><entry>B. The DOS link plug-in</entry>
<row><entry>19. Deleting objects</entry><entry>Tells how to safely delete EVMS objects.</entry></row>
<row><entry>20. Replacing objects</entry><entry>Tells how to change the
configuration of a volume or storage object.</entry></row>
<row><entry>21. Moving segment storage objects</entry><entry>Discusses how to use
the move function for moving segments.</entry></row>
<row><entry>A. The DOS link plug-in</entry>
<entry>Provides details about the DOS link plug-in, which is a segment manager plug-in.</entry></row>
<row><entry>C. The MD region manager</entry>
<row><entry>B. The MD region manager</entry>
<entry>Explains the Multiple Disks (MD) support in Linux that is a software implementation of RAID.</entry></row>
<row><entry>D. The LVM plug-in</entry>
<row><entry>C. The LVM plug-in</entry>
<entry>Tells how the LVM plug-in is implemented and how to perform container operations.</entry></row>
<row><entry>E. The CSM plug-in</entry>
<row><entry>D. The CSM plug-in</entry>
<entry>Explains how the Cluster Segment Manager (CSM) plug-in is implemented and how to perform CSM operations.</entry></row>
<row><entry>F. JFS file system interface module</entry>
<row><entry>E. JFS file system interface module</entry>
<entry>Provides information about the JFS FSIM.</entry></row>
<row><entry>G. XFS file system interface module</entry>
<row><entry>F. XFS file system interface module</entry>
<entry>Provides information about the XFS FSIM.</entry></row>
<row><entry>H. ReiserFS file system interface module</entry>
<row><entry>G. ReiserFS file system interface module</entry>
<entry>Provides information about the ReiserFS FSIM.</entry></row>
<row><entry>I. Ext-2/3 file system interface module</entry>
<row><entry>H. Ext-2/3 file system interface module</entry>
<entry>Provides information about the Ext-2/3 FSIM.</entry></row>
</tbody></tgroup>
</table>
</preface>
</preface>