Return to beta_source.html CVS log

Up to [Development] / xfs-website.orig

Beta announce and doc pages.

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

<!-- Start Project Content -->

<h2>
<b><font face="ARIAL NARROW,HELVETICA">XFS Beta Release</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-test5 tree including the
XFS filesystem, or you can obtain an XFS beta patch onto an
existing linux-2.4.0-test5 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-test5 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>.

<h3>Creating an XFS tree via a patchfile</h3>
With this method, you will start with a "vanilla" linux-2.4.0-test5 tree
and apply a patch to obtain an XFS-capable kernel, as well as the necessary
tools to create and maintain your XFS partitions.
<p>
Two patch files are
available - 
<a href="ftp://oss.sgi.com/projects/xfs/download/09202000XFSBETA-canidate-2-cvs.patch.gz">
one which contains CVS information</a>, and
<a href="ftp://oss.sgi.com/projects/xfs/download/09202000XFSBETA-canidate-2.patch.gz">
one which does not</a>.
The patch which contains CVS information will make it easy to get an XFS
CVS tree started without checking the entire tree out of CVS.  If you're not
interested in syncing with CVS, you can get the non-CVS patch.
</p>
<ul>
<li>Obtain a vanilla linux-2.4.0-test5 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>
<p>
<li>Download the appropriate patch file and place it in the directory above
    the <tt>linux/</tt> directory you created when you unpacked the test5 kernel.</li>
</p>
<p>
<li>Run <tt>patch -p1 &#060  <i>patchfile_name</i></tt></li> in this same directory.</li>
    This will patch the <tt>linux/</tt> directory, and make 4 new directories:
    <tt>SCRIPTS, SOURCES, SPECS</tt> and <tt>cmd</tt>
</li>
</p>
</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>Development code (CONFIG_EXPERIMENTAL)</li>
        <li>XFS filesystem support (CONFIG_XFS_FS)</li>
        <li>Page Buffer support (CONFIG_PAGE_BUF)</li>
        </ul>
</p>
<p>
You may also wish to enable:
</p>
<p>
        <ul>
        <li>XFS Debug Mode (CONFIG_XFS_DEBUG)</li>
        <li>XFS Vnode Tracing (CONFIG_XFS_VNODE_TRACING)</li>
        </ul>
</p>
<p>
At this time, do not enable:
</p>
<p>
        <ul>
        <li>XFS DMAPI (CONFIG_XFS_DMAPI)</li>
        </ul>
</p>
<p>
You will also need to upgrade the following system utilities:
</p>
<p>
<ul>
        <li>modutils-2.3.16</li>
        <li>autoconf-2.13</li>
        <li>e2fsprogs-devel-1.18</li>
</ul>
</p>
<p>
These utilities can be found through <a href="http://rpmfind.net/linux/RPM/">
the RPM repository</a> or other places on the web.
</p>
<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>
<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>
<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 &>