| AWStats logfile analyzer 6.4 Documentation |

# Upgrading AWStats to a new version

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.