To upgrade AWStats from an old version to a new one, all you have to do is:
* Check your Perl version is at least 5.005_03 (or higher). For this you can run perl -v command.
* Replace AWStats runtime files by new ones. For this you can:
- 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).
- or just run your OS package tool (rpm, apt, or just .exe for windows).
* Your setup files should not be lost as AWStats default distribution should not overwite
config file (it provides only one config file example called awstats.model.conf). However
some packages are not official, so you can save and restore AWStats config files (awstats*.conf)
if you prefer.
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.
Note 0: Perl 5.005_03 or higher is a requirement to use AWStats 6.0 or higher.
Note 1: When migrating to 6.x series, if you use the ExtraSections feature,
you must check that the parameter(s) ExtraSectionConditionX use a full
REGEX syntax (with 5.x series, this parameter could contain simple string
values). If not, feature will be broken.
Note 2: When migrating to 6.x series, if you use the Misc feature, you must
check that your ShowMiscStats parameter is set to "ajdfrqwp", if you want
to have all miscellanous info reported (you must also have added the
awstats_misc_tracker.js script in your home page as described in
MiscTrackerUrl parameter description). Otherwise the new default value "a"
will be used (only the "Add to favourites" will be reported).
Note 3: In 6.x series, MaxLengthOfURL parameter has been renamed into MaxLengthOfShownURL
Note 4: When migrating to 6.x series, to enable the new worm detection, you must add parameter
LevelForWormsDetection=2 in your config file.
Note 5: 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.
* Your old analyzed data should not be lost 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.
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.
