<!-- $Id: Upgrade.html,v 1.2 2010/01/21 17:37:16 castaglia Exp $ -->
<!-- $Source: /cvsroot/proftp/proftpd/doc/howto/Upgrade.html,v $ -->
<html>
<head>
<title>ProFTPD mini-HOWTO - Upgrading ProFTPD</title>
</head>
<body bgcolor=white>
<hr>
<center><h2><b>Upgrading ProFTPD</b></h2></center>
<hr>
<p>
Upgrading <code>proftpd</code> is usually a straightforward process, but
as with any upgrade, double-checking that the upgrade will not break anything
is a Good Idea.
<p>
Recent ProFTPD releases have a <code>RELEASE_NOTES</code> file in the
source distribution that documents the changes in that release, including
new configuration directives, new contrib modules, deprecated directives,
special instructions, <i>etc</i>. In addition, the <code>NEWS</code> file
contains a list of the bugs that have fixed, and comments about any changes
the bugfix required. <b>Please</b> read these files carefully before
starting your upgrade.
<p>
One safe way to test the upgrade is to compile the new <code>proftpd</code>,
and test it out on your existing configuration file before actually installing
the new version into the "live" location:
<pre>
tar zxvf proftpd-<i>version</i>.tar.gz
cd proftpd-<i>version</i>/
./configure ..
make
./proftpd -t -d10 -c /path/to/proftpd.conf
</pre>
The "<code>./proftpd</code>" means to use the new
<code>proftpd</code> binary compiled by <code>make</code>, but not yet
installed. If the new binary reports errors, make a copy of your existing
<code>proftpd.conf</code> file, keeping the old one as a backup:
<pre>
cp /path/to/proftpd.conf /path/to/proftpd.conf.new
</pre>
Make any needed changes to the <code>proftpd.conf.new</code> file, until
the new <code>proftpd</code> binary reports a successful syntax check:
<pre>
./proftpd -t -d10 -c /path/to/proftpd.conf.new
</pre>
<p>
Once everything is configured the way you like, install the new binary and
configuration file:
<pre>
make install
cp /path/to/proftpd.conf /path/to/proftpd.conf.old
mv /path/to/proftpd.conf.new /path/to/proftpd.conf
</pre>
Now do a stop/start on <code>proftpd</code>, and the new version of ProFTPD
will be running.
<p>
<hr>
<i>$Date: 2010/01/21 17:37:16 $</i><br>
</body>
</html>
y~or5J ={Eeu磝Qk ᯘG{?+]ן?wM3X^歌>{7پK>on\jy R g/=fOroNVv~Y+ NGuÝHWyw[eQʨSb> >}Gmx[o[<{Ϯ_qF vM IENDB`
