<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Language" content="en-us" />
<meta name="ROBOTS" content="ALL" />
<meta http-equiv="imagetoolbar" content="no" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="Keywords" content="cherokee web server httpd http" />
<meta name="Description" content="Cherokee is a flexible, very fast, lightweight Web server. It is implemented entirely in C, and has no dependencies beyond a standard C library. It is embeddable and extensible with plug-ins. It supports on-the-fly configuration by reading files or strings, TLS/SSL (via GNUTLS or OpenSSL), virtual hosts, authentication, cache friendly features, PHP, custom error management, and much more." />
<link href="media/css/cherokee_doc.css" rel="stylesheet" type="text/css" media="all" />
</head>
<body>
<h2 id="_a_href_index_html_index_a_8594_a_href_basics_html_getting_started_a"><a href="index.html">Index</a> → <a href="basics.html">Getting started</a></h2>
<div class="sectionbody">
</div>
<h2 id="_upgrading_cherokee">Upgrading Cherokee</h2>
<div class="sectionbody">
<div class="paragraph"><p>If there is a prepackaged version of Cherokee for you platform of
choice, we strongly encourage you to use it. Although upgrading
Cherokee is not complicated, the prepackaged versions should make your
upgrades much easier.</p></div>
<div class="paragraph"><p>Refer to the <a href="basics_installation_unix.html#APT">APT</a> section of the
Unix installation instructions if you are using Debian or Ubuntu for
some additional information.</p></div>
<div class="paragraph"><p>The current mechanism of choice to configure Cherokee did not exist
prior to release 0.6. A lot has happened since then, and Cherokee has
been constantly improving in terms of stability, efficiency and
features.</p></div>
<div class="paragraph"><p>If you happen to be running an old version of Cherokee and would like
to keep your current configuration settings, you can upgrade your
cherokee.conf file.</p></div>
<div class="paragraph"><p>Cherokee now supports configuration versioning, so
from now on, whenever a change is made to the configuration file
format, Cherokee-Admin will be able to automatically convert yours to
the new release. You simply have to load Cherokee-Admin and it will be
converted once you proceed to saving it.</p></div>
<div class="paragraph"><p>There is also a command line utility that you can use to do the exact
same thing. It is provided under
<tt>$prefix/share/cherokee/admin/upgrade_config.py.</tt></p></div>
<div class="paragraph"><p>In case you need to do this manually, the usage is as follows:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> /usr/share/cherokee/admin/upgrade_config.py /etc/cherokee/cherokee.conf</tt></pre>
</div></div>
<div class="paragraph"><p>If Cherokee-Admin can not make the conversion automatically (because
it is older than the configuration versioning feature), you still have
options.</p></div>
<div class="paragraph"><p>You can attempt to upgrade you configuration file by manually running
the Python scripts provided under <tt>contrib</tt>.</p></div>
<div class="paragraph"><p>The usage is quite simple, and works the same way for all the
scripts:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> cp /etc/cherokee/cherokee.conf /etc/cherokee/cherokee.conf-0.99.9
contrib/0999to09910.py /etc/cherokee/cherokee.conf-0.99.9 /etc/cherokee/cherokee.conf</tt></pre>
</div></div>
<div class="paragraph"><p>If you need to upgrade from a really old release, simply apply the
whole chain of conversions.</p></div>
<div class="paragraph"><p>Note that some of the available prepackaged versions of Cherokee
are set to offer the possibility of automatically running these scripts
to upgrade the configuration if files from a prior release are detected
in the system.</p></div>
<div class="paragraph"><p>Every effort is made to bulletproof the upgrade scripts. If any of
them does not work for you, please send a bug report.
However, Cherokee is a very active project and has been steadily
advancing and incorporating technical improvements. You should really be
using <a href="other_bundle_cherokee-admin.html">cherokee-admin</a> to configure your
system if you want to take full advantage of the new features. Even if
the upgrade process is successful, you should use the new configuration
file as a start point and go through the normal configuration process
using <a href="other_bundle_cherokee-admin.html">cherokee-admin</a>.</p></div>
<div class="paragraph"><p>Also, as long as you are not using an ancient configuration file,
every new cherokee-admin release will be able to upgrade the
configuration automatically from previous versions whenever a format
change has been required.</p></div>
</div>
<div id="footer">
<div id="footer-text">
</div>
</div>
</body>
</html>
distrib
>
Mandriva
>
2010.1
>
i586
>
media
>
contrib-updates
>
by-pkgid
>
02e45b2cd6a4a47c88f15dd2f64cf46c
>
files
>
677
