<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
-<meta name="description" content="AWStats Documentation - Upgrade setup">
+ <meta name="description"\r
+ content="AWStats Documentation - Upgrade setup">\r
<meta name="keywords" content="awstats, awstat, udpate, upgrade">
<meta name="robots" content="index,follow">
<meta name="title" content="AWStats Documentation - Upgrade setup">
<link rel="stylesheet" href="styles.css" type="text/css">
<!-- $Revision$ - $Author$ - $Date$ -->
</head>
-
-<body topmargin=10 leftmargin=5>
-
-
-<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
-
-<!-- Large -->
-<tr style="font: 10pt arial,helvetica,verdana">
-<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
-<td bgcolor=#9999cc align=center>
+<body topmargin="10" leftmargin="5">\r
+<table\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ bgcolor="#ffffff" border="0" cellpadding="0" cellspacing="0"\r
+ width="100%">\r
+<!-- Large --> <tbody>\r
+ <tr\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;">\r
+ <td align="center" bgcolor="#9999cc"><a href="/"><img\r
+ src="images/awstats_logo4.png" border="0"></a></td>\r
+ <td align="center" bgcolor="#9999cc"> <br>\r
+ <font\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 16pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ color="#eeeeff"><b>AWStats logfile analyzer 6.5 Documentation</b></font><br>\r
<br>
-<font style="font: 16pt arial,helvetica,sans-serif" color=#EEEEFF><b>AWStats logfile analyzer 6.4 Documentation</b></font><br>
-<br>
-</td>
-<td bgcolor=#9999cc align=center>
-
</td>
+ <td align="center" bgcolor="#9999cc"> </td>\r
</tr>
-
+ </tbody>\r
</table>
-
-<br><br><H1 style="font: 26px arial,helvetica,sans-serif">Upgrading AWStats to a new version</H1>
-
-To upgrade AWStats from an old version to a new one, all you have to do is:<br>
-<br>
-* <b>Check your Perl version is at least 5.005_03 (or higher)</b>. For this you can run <i>perl -v</i> command.<br>
-<br>
-* <b>Replace AWStats runtime files</b> by new ones. For this you can:<br>
- - decompress new AWStats zip or tgz package to old install directory (AWStats
-old runtime files are replaced by new ones. This works whatever is the old and new version, 3.x, 4.x, 5.x, 6.x).<br>
- - or just run your OS package tool (rpm, apt, or just .exe for windows).<br>
-<br>
-* <b>Your setup files should not be lost</b> as AWStats default distribution should not overwite
-config file (it provides only one config file example called <i>awstats.model.conf</i>). However
-some packages are not official, so you can save and restore AWStats config files (awstats*.conf)
-if you prefer.<br>
-Sometimes, there is new parameter supported by the new version. Since those parameters are not
-present in old config files, AWStats will use default values for them, to work as it did when
-those parameters did not exist, so there is no need to add them, except if you want to use
-differently the new feature.<br>
-<br>
-
-<u>Note 0:</u> Perl 5.005_03 or higher is a requirement to use AWStats 6.0 or higher.
<br>\r
-<u>Note 1:</u> When migrating to 6.x series, if you use the ExtraSections feature,\r
- you must check that the parameter(s) ExtraSectionConditionX use a full\r
- REGEX syntax (with 5.x series, this parameter could contain simple string\r
- values). If not, feature will be broken.\r
<br>\r
-<u>Note 2:</u> When migrating to 6.x series, if you use the Misc feature, you must\r
- check that your ShowMiscStats parameter is set to "ajdfrqwp", if you want\r
- to have all miscellanous info reported (you must also have added the\r
- awstats_misc_tracker.js script in your home page as described in\r
- MiscTrackerUrl parameter description). Otherwise the new default value "a"\r
- will be used (only the "Add to favourites" will be reported).\r
+<h1\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 26px; line-height: normal; font-size-adjust: none; font-stretch: normal;">Upgrading\r
+AWStats from a previous version</h1>\r
+To upgrade AWStats, all you have\r
+to do is:<br>\r
<br>\r
-<u>Note 3:</u> In 6.x series, MaxLengthOfURL parameter has been renamed into MaxLengthOfShownURL\r
+1. Read this page completely before beginning the upgrade.<br>\r
<br>\r
-<u>Note 4:</u> When migrating to 6.x series, to enable the new worm detection, you must add parameter\r
- LevelForWormsDetection=2 in your config file.\r
+2. <b>Optionally backup your AWStats configuration and history\r
+data files</b>.<br>
+Standard AWStats distributions do not change these, but\r
+backing them up allows you to recover them if something does go\r
+amiss. The AWStats default distribution will only overwrite the\r
+configuration file example called <i>awstats.model.conf</i>. \r
+Your\r
+history data files are saved in the\r
+directory defined with the DirData parameter in your AWStats\r
+configuration file (awstats.<span style="font-style: italic;">mysite</span>.conf).<br>\r
<br>\r
-<u>Note 5:</u> When migrating to 6.x series, if you used the urlalias or userinfo plugin, you must move the urlalias.*.txt
-or userinfo.*.txt file from Plugins directory to DirData directory.
+3. <b>Replace AWStats runtime files</b> with the new ones.<br>
+To do this you can:<br>\r
+- decompress the new AWStats zip or tgz\r
+package over the old installation directory (old AWStats runtime files\r
+are replaced by new ones. This works for AWStats versions 3.x and\r
+higher).<br>\r
+- or just run your OS package tool (i.e.\r
+rpm, apt for Linux, .exe for MS Windows).<br>
<br>\r
-
-<br>
-* <b>Your old analyzed data should not be lost</b> since your 'history files' are saved in the
-directory defined in DirData parameter in your AWStats config file and 'history files' format is
-compatible with each new version of AWStats since 5.x series. If you upgrade from 3.x or 4.x
-series to 5.x, 6.x or higher, AWStats will still be able to 'read' your old history files but
-a warning will appear to ask you to run the 'migrate' process on your old data files.
+Migrating to 6.x versions from earlier versions, observe the following additional notes:<br>\r
+<u>i.</u> As of AWStats 6.0+, Perl version is 5.005_03 or\r
+higher is required. To see the version number, run the command <i>perl\r
+-v</i> \r
+from your operating system's command line.<br>\r
+<span style="text-decoration: underline;">ii</span>. If you use the <a href="awstats_extra.html#Extra">ExtraSections</a> feature, you\r
+must check that the parameter(s) ExtraSectionConditionX uses a full\r
+REGEX syntax (with the 5.x series, this parameter could contain simple\r
+string values). If you don't update your configuration, the feature\r
+will be broken.\r
+<br>\r
+<u>iii</u>. If you use the <a href="awstats_config.html#MiscTrackerUrl">MiscTrackerUrl</a>\r
+feature, you must check\r
+that your <a href="awstats_config.html#ShowMiscStats">ShowMiscStats</a> parameter is set to "ajdfrqwp" in addition to\r
+setting up <a href="awstats_config.html#MiscTrackerUrl">MiscTrackerUrl</a> tags and a JavaScript include for your web\r
+site. Otherwise the new default value "a" will be used (only the "Add\r
+to favorites" will be reported).\r
+<br>\r
+<u>iv</u>. The MaxLengthOfURL parameter has been renamed\r
+<a href="awstats_config.html#MiscTrackerUrl">MaxLengthOfShownURL</a>;\r
+update your configuration file accordingly.\r
+<br>\r
+<u>v</u>. To enable the worm\r
+detection feature (not enabled by default), you must add\r
+the parameter <a href="awstats_config.html#MiscTrackerUrl">LevelForWormsDetection</a>=2\r
+in your configuration file.\r
+<br>\r
+<u>vi</u>. If you use the <span style="font-weight: italic;">urlalias</span>\r
+or <span style="font-weight: italic;">userinfo</span> plugins, you must\r
+move the urlalias.*.txt\r
+or userinfo.*.txt file from the Plugins directory to the DirData\r
+directory.\r
+<br>\r
+<br>\r
+4. <b>Convert your AWStats history files when migrating from 3.x or\r
+4.x\r
+versions to 5.x or higher</b>.<br>
+If you upgrade from the 3.x or 4.x\r
+series to 5.x or higher, AWStats will still be able to 'read' your\r
+old history files but\r
+a warning may appear to ask you to run the 'migrate' process on your\r
+old data files.\r
Just run the command that will appear in warning message.
-This warning will appear only after upgrade from 3.x or 4.x series to a 5.x, 6.x or higher
-version and only if 'migrate' is necessary.<br>
+This warning will only appear if data migration is necessary after an\r
+upgrade from the 3.x or 4.x series to a\r
+5.x or higher\r
+version.<br>\r
+<br>\r
+5. <b>Review new feature </b><b> default </b><b>settings</b>.<br>\r
+Sometimes new feature parameters are introduced in a new AWStats\r
+version. AWStats will\r
+use default values for them, maintaining backward compatibility with\r
+your existing AWStats configuration. However, you can review the\r
+"New Features / Change Log" to see how you might change the new\r
+feature's\r
+behavior.<br>\r
+<br>\r
<br>
<hr>
-
-<script language=javascript>
+<script language="javascript">\r
var date='$Date$';
document.writeln("Last revision: "+date);
</script>
projects / thirdparty / AWStats.git / commitdiff
