Return to pr_source.html CVS log

Up to [Development] / xfs-website.orig

 Added Files:
 	pr_source.html

Patch installation instructions for pre-release

<& xfsTemplate,top=>1,side=>1 &>

<!-- Start Project Content -->
<h2>
<b><font face="ARIAL NARROW,HELVETICA">XFS Pre-Release 0.9</font></b></h2>

<h2>
<b><font face="ARIAL NARROW,HELVETICA">Installing from the Source</font></b></h2>

You can obtain the complete linux-2.4.0 (released) tree including the
XFS filesystem, or you can obtain an XFS beta patch onto an
existing linux-2.4.0 tree.  You will then need to configure
and install the kernel. 

<h3>Downloading the complete Linux tree including XFS</h3>
A complete linux 2.4.0 tree including the XFS filesystem
is available for CVS checkout.  For instructions on checking
the tree out of CVS, see the 
<a href="http://oss.sgi.com/projects/xfs/cvs_download.html">
CVS download instructions</a>.  The Beta tree is named
"linux-2.4-xfs-beta"

<h3>Creating an XFS tree via a patchfile</h3>
With this method, you will start with a "vanilla" linux-2.4.0 tarball
(linux-2.4.0.tar.gz, or linux-2.4.0.tar.bz2) 
and apply a patch to obtain an XFS-capable kernel, as well as the necessary
tools to create and maintain your XFS partitions.

<ul>
<li>Obtain a vanilla linux-2.4.0 tree from a <a href="http://www.kernel.org/mirrors/">
kernel.org mirror</a> and unpack it into wherever you'd like to perform the build.</li>
<li>Download the appropriate 
<a href="ftp://oss.sgi.com/projects/xfs/download/PreRelease-0.9/patches/">
patch file</a> and place it in the directory above
the <tt>linux/</tt> directory you created when you unpacked the 2.4.0 kernel.</li>
<li>Run <tt>patch -p1 &#060  <i>patchfile_name</i></tt> in this same directory.
This will patch the <tt>linux/</tt> directory, and make 4 new directories:
<tt>SCRIPTS, SOURCES, SPECS</tt> and <tt>cmd</tt>.</li>
</ul>

<h3>Configuring and installing the kernel</h3>
Configure and install your kernel as usual.  See
<a href="http://oss.sgi.com/LDP/HOWTO/Kernel-HOWTO.html">The Linux Kernel HOWTO</a>
for detailed instructions, if necessary.
<p>
In your kernel configuration, you will need to enable:
</p>
<p>
        <ul>
        <li>XFS filesystem support (CONFIG_XFS_FS)</li>
        <li>Page Buffer support (CONFIG_PAGE_BUF)</li>
        <li>Development code (CONFIG_EXPERIMENTAL)</li>
        </ul>
</p>
<p>
Should you experience problems with XFS, you may wish to enable:
</p>
        <ul>
        <li>XFS Debug Mode (CONFIG_XFS_DEBUG)</li>
        <li>XFS Vnode Tracing (CONFIG_XFS_VNODE_TRACING)</li>
        </ul>
<p>
You will also need to upgrade the following system utilities to at least
these versions: 
</p>
<ul>
        <li><a href="http://www.kernel.org/pub/linux/utils/kernel/modutils/v2.4/">modutils-2.4.0</A></li>
        <li><a href="http://www.gnu.org/software/autoconf/autoconf.html">autoconf-2.13</a></li>
        <li><a href="http://e2fsprogs.sourceforge.net/">e2fsprogs-devel-1.18</a></li>
</ul>
<p>
When your new kernel is built and installed, you should update LILO,
create a new ramdisk image if necessary, and you're ready to boot
an XFS-capable kernel.
</p>
<h3>Creating the XFS tools</h3>

<p>
You will also need to compile and install the XFS tools and man pages.
These are available in the <tt>cmd/xfs</tt> directory.  You can make
and install these files with:
</p>
    <ul>
    <li><tt>make configure</tt></li>
    <li><tt>make</tt></li>
    <li><tt>su root</tt></li>
    <li><tt>make install</tt></li>
    </ul>
<p>
    See the <tt>INSTALL</tt> file in <tt>cmd/xfs</tt> for more information
    about this process.
</p>

If all this goes well, it's time to <a href="beta_filesystem_install.html">
make a new XFS filesystem!</a>
<br>

<& xfsTemplate,bottom=>1 &>