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

339 lines
12 KiB
XML

<chapter id="evmsfsimops"><title>FSIMs and file system operations</title>
<para>This chapter discusses the six 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>
<sect1 id="FSIMsuppevms"><title>The FSIMs supported by EVMS</title>
<para>EVMS currently ships with six FSIMs. These file system modules allow EVMS to interact with file system utilities such as <command>mkfs</command> and <command>fsck</command>. Additionally, the FSIMs ensure that EVMS safely performs operations, such as expanding and shrinking file systems, by coordinating these actions with the file system. </para>
<para>You can invoke operations such as <command>mkfs</command> and <command>fsck</command> through the various EVMS user interfaces. Any actions you initiate through an FSIM are not committed to disk until the changes are saved in the user interface. Later in this chapter we provide examples of creating a new file system and coordinating file system checks through the EVMS GUI, Ncurses, and command-line interfaces.</para>
<para>The FSIMs supported by EVMS are:</para>
<itemizedlist>
<listitem><para>JFS</para></listitem>
<listitem><para>XFS</para></listitem>
<listitem><para>ReiserFS</para></listitem>
<listitem><para>Ext2/3</para></listitem>
<listitem><para>SWAPFS</para></listitem>
<listitem><para>OpenGFS</para></listitem>
</itemizedlist>
<sect2 id="fsimjfs"><title>JFS</title>
<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.
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
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"></xref>.
</para>
</sect2>
<sect2 id="fsimxfs"><title>XFS</title>
<para>
The XFS FSIM supports the XFS file system from SGI.
Command support includes <command>mkfs</command>, <command>unmkfs</command>,
<command>fsck</command>, and online expansion. Use version 1.2 or higher, which you can download from <ulink url="ftp://oss.sgi.com/projects/xfs/download">the SGI open source FTP directory.</ulink>
</para>
<para>
For more information on the XFS FSIM, refer to <xref linkend="xfsfsim"></xref>.
</para>
</sect2>
<sect2 id="fsimreiserfs"><title>ReiserFS</title>
<para>
The ReiserFS module supports the ReiserFS journaling file system.
This module supports <command>mkfs</command>, <command>unmkfs</command>, <command>fsck</command>, online and offline
expansion and offline shrinkage. You need version 3.x.1a or higher
of the ReiserFS utilities for use with the EVMS FSIM modules. You can download
the ReiserFS utilities from <ulink url="http://www.namesys.com">The Naming
System Venture (Namesys) </ulink> Web site.
</para>
<para>
For more information on the ReiserFS FSIM, refer to <xref linkend="reiserfsim"></xref>.
</para>
</sect2>
<sect2 id="fsimext23"><title>Ext2/3</title>
<para>
The EXT2/EXT3 FSIM supports both the ext2 and ext3 file system formats.
The FSIM supports <command>mkfs</command>, <command>unmkfs</command>,
<command>fsck</command>, and offline shrinkage and expansion.
</para>
<para>
For more information on the Ext2/3 FSIM, refer to <xref linkend="ext23fsim"></xref>.
</para>
</sect2>
<sect2 id="fsimswapfs"><title>SWAPFS</title>
<para>
The SWAPFS FSIM supports Linux swap devices. The FSIM lets you create
and delete swap devices, and supports <command>mkfs</command>,
<command>unmkfs</command>, shrinkage and expansion.
Currently, you are responsible for issuing the
<command>swapon</command> and <command>swapoff</command> commands either in
the startup scripts or manually.
You can resize swap device with the SWAPFS FSIM as long as the device is
not in use.
</para>
</sect2>
<sect2 id="fsimopengfs"><title>OpenGFS</title>
<para>
The OpenGFS module supports the OpenGFS clustered journaling file system.
This module supports <command>mkfs</command>, <command>unmkfs</command>,
<command>fsck</command>, and online expansion.
You need the OpenGFS utilities for use with the EVMS FSIM module.
You can download the OpenGFS utilities from the
<ulink url="http://sourceforge.net/projects/opengfs">OpenGFS project on SourceForge</ulink>.
</para>
<para>
For more information on the OpenGFS FSIM, refer to <xref linkend="gfsfsim"></xref>.
</para>
</sect2>
</sect1>
<sect1 id="fsimmkfs"><title>Example: add a file system to a volume</title>
<para>After you have made an EVMS or compatibility volume, add a file system to the volume before mounting it. You can add a file system to a volume through the EVMS interface of your choice.</para>
<blockquote><example><title>Add a JFS File System to a Volume</title>
<para>This example creates a new JFS file system, named <filename>jfs_vol</filename>, on volume <filename>/dev/evms/my_vol</filename>.
</para></example></blockquote>
<sect2 id="fsimmkfsgui"><title>Using the EVMS GUI</title>
<para>Follow these steps to create a JFS file system with the EVMS GUI:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>File Systems</guimenuitem>
<guimenuitem>Make</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para>Select <menuchoice><guimenu>JFS File System Interface Module</guimenu></menuchoice>.
</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Select <menuchoice><guimenu>/dev/evms/my_vol</guimenu></menuchoice>.
</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Type <userinput>jfs_vol</userinput> in the "Volume Label"
field. Customize any other options you are interested in.
</para></listitem>
<listitem><para>Click <guibutton>Make</guibutton>.
</para></listitem>
<listitem><para>The operation is completed when you save.</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to create a file system with the GUI
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click
<filename>/dev/evms/my_vol</filename>.</para></listitem>
<listitem><para>Click <guimenuitem>Make Filesystem...</guimenuitem></para></listitem>
<listitem><para>Continue creating the file system beginning with step 2 of the
GUI instructions. You can skip steps 4 and 5 of the GUI instructions.</para></listitem>
</orderedlist>
</sect2>
<!-- Ncurses-->
<sect2 id="fsimmkfsncurses"><title>Using Ncurses</title>
<para>Follow these steps to create a JFS file system with Ncurses:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu><guimenuitem>File Systems</guimenuitem><guimenuitem>Make</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para>Select JFS File System Interface Module.</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Select <filename>/dev/evms/my_vol</filename>.</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.</para></listitem>
<listitem><para>Scroll down using the <keycap>down</keycap> arrow until
<guimenuitem>Volume Label</guimenuitem> is highlighted.
</para></listitem>
<listitem><para>Press <keycap>Spacebar</keycap>.
</para></listitem>
<listitem><para>At the &quot;::&quot; prompt enter <userinput>jfs_vol</userinput>.
</para></listitem>
<listitem><para>Press <keycap>Enter</keycap>.
</para></listitem>
<listitem><para>Activate <guibutton>Make</guibutton>.</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to create a file system with the
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Volumes view, press <keycap>Enter</keycap> on
<filename>/dev/evms/my_vol</filename>.</para>
</listitem>
<listitem><para>Activate the <guimenuitem>Make Filesystem</guimenuitem> menu item.</para>
</listitem>
<listitem><para>Continue creating the file system beginning with step 2 of the
Ncurses instructions.</para>
</listitem>
</orderedlist>
</sect2>
<!-- CLI-->
<sect2 id="fsimmkfscli"><title>Using the CLI</title>
<para>Use the
<command>mkfs</command> command to create the new file system.
The arguments to <command>mkfs</command> include the FSIM type (in our example, JFS), followed
by any option pairs, and then the volume name. The command to accomplish
this is:</para>
<programlisting>mkfs: JFS={vollabel=jfs_vol}, /dev/evms/my_vol</programlisting>
<para>The command is completed upon saving.</para>
<para>If you are interested in other options that <command>mkfs</command> can
use, look at the results of the following query:</para>
<programlisting>query: plugins, plugin=JFS, list options</programlisting>
</sect2>
</sect1>
<sect1 id="fsimmkfsaex"><title>Example: check a file system</title>
<para>You can also coordinate file system checks from the EVMS user interfaces.</para>
<blockquote><example><title>Check a JFS File System</title>
<para>This example shows how to perform a file system check on a JFS file system, named <filename>jfs_vol</filename>, on volume <filename>/dev/evms/my_vol</filename>, with verbose output.
</para></example></blockquote>
<sect2 id="FSIMmkfsgui"><title>Using the EVMS GUI</title>
<para>Follow these steps to check a JFS file system with the EVMS GUI:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>File Systems</guimenuitem>
<guimenuitem>Check/Repair</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para>Select <menuchoice><guimenu>/dev/evms/my_vol</guimenu></menuchoice>.
</para></listitem>
<listitem><para>Click <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Click the <keycap>Yes</keycap> button by <guimenu>Verbose Output</guimenu>.
Customize any other options you are interested in.
</para></listitem>
<listitem><para>Click <guibutton>Check</guibutton>.
</para></listitem>
<listitem><para>The operation is completed when you save.</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to check a file system with the GUI context sensitive menu:</para>
<orderedlist>
<listitem><para>From the <guimenuitem>Volumes</guimenuitem> tab, right click
<filename>/dev/evms/my_vol</filename>.</para></listitem>
<listitem><para>Click <filename>Check/Repair File System...</filename>
</para></listitem>
<listitem><para>Continue checking the file system beginning with step 3 of the
GUI instructions.</para></listitem>
</orderedlist>
</sect2>
<!-- Ncurses-->
<sect2 id="fsimfsckncurses"><title>Using Ncurses</title>
<para>Follow these steps to check a JFS file system with Ncurses:
<orderedlist>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
<guimenuitem>File System</guimenuitem><guimenuitem>Check/Repair</guimenuitem></menuchoice>
</para></listitem>
<listitem><para>Select
<filename> /dev/evms/my_vol</filename>.
</para></listitem>
<listitem><para>Activate <guibutton>Next</guibutton>.
</para></listitem>
<listitem><para>Scroll down using the <keycap>down</keycap> arrow until
<guimenuitem>Verbose Output</guimenuitem> is highlighted.
</para></listitem>
<listitem><para>Press <keycap>Spacebar</keycap> to change <guimenuitem>Verbose Output</guimenuitem> to <keycap>Yes</keycap>.
</para></listitem>
<listitem><para>Activate <guibutton>Check</guibutton>.
</para></listitem>
</orderedlist>
</para>
<para>Alternatively, you can perform some of the steps to check a file system with the
context sensitive menu:</para>
<orderedlist>
<listitem><para>From the Volumes view, press <keycap>Enter</keycap> on <filename>/dev/evms/my_vol</filename>.</para>
</listitem>
<listitem><para>Activate the <guimenuitem>Check/Repair File System</guimenuitem> menu item.</para>
</listitem>
<listitem><para>Continue checking the file system beginning with step 3 of the Ncurses
instructions.</para>
</listitem>
</orderedlist>
</sect2>
<!-- CLI-->
<sect2 id="FSIMmkfscli"><title>Using the CLI</title>
<para>The CLI <command>check</command> command takes a volume name and options as
input. The command to check the file system on <filename>/dev/evms/my_vol</filename> is the following:
</para>
<programlisting>check: /dev/evms/my_vol, verbose=TRUE</programlisting>
<para>Currently, a query command for viewing additional options is not available.</para>
</sect2>
</sect1>
</chapter>