<!-- $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>