Changesets can be listed by changeset number.
The Git repository is here.
- Revision:
- 269
- Log:
Overdue upgrade to AWStats v6.9, the most recent version
available at the time of writing.
- Author:
- rool
- Date:
- Wed May 27 23:57:15 +0100 2009
- Size:
- 5698 Bytes
- Properties:
- Property svn:executable is set
| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| 2 | <html> |
| 3 | <head> |
| 4 | <meta name="description" |
| 5 | content="AWStats Documentation - Upgrade setup"> |
| 6 | <meta name="keywords" content="awstats, awstat, udpate, upgrade"> |
| 7 | <meta name="robots" content="index,follow"> |
| 8 | <meta name="title" content="AWStats Documentation - Upgrade setup"> |
| 9 | <title>AWStats Documentation - Upgrade setup</title> |
| 10 | <link rel="stylesheet" href="styles.css" type="text/css"> |
| 11 | <!-- $Revision: 1.17 $ - $Author: eldy $ - $Date: 2008/09/29 19:28:21 $ --> |
| 12 | </head> |
| 13 | <body topmargin="10" leftmargin="5"> |
| 14 | <table |
| 15 | 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;" |
| 16 | bgcolor="#ffffff" border="0" cellpadding="0" cellspacing="0" |
| 17 | width="100%"> |
| 18 | <!-- Large --> <tbody> |
| 19 | <tr |
| 20 | 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;"> |
| 21 | <td align="center" bgcolor="#9999cc"><a href="/"><img |
| 22 | src="images/awstats_logo4.png" border="0"></a></td> |
| 23 | <td align="center" bgcolor="#9999cc"> <br> |
| 24 | <font |
| 25 | 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;" |
| 26 | color="#eeeeff"><b>AWStats logfile analyzer 6.9 Documentation</b></font><br> |
| 27 | <br> |
| 28 | </td> |
| 29 | <td align="center" bgcolor="#9999cc"> </td> |
| 30 | </tr> |
| 31 | </tbody> |
| 32 | </table> |
| 33 | <br> |
| 34 | <br> |
| 35 | <h1 |
| 36 | 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 |
| 37 | AWStats from a previous version</h1> |
| 38 | To upgrade AWStats, all you have |
| 39 | to do is:<br> |
| 40 | <br> |
| 41 | 1. Read this page completely before beginning the upgrade.<br> |
| 42 | <br> |
| 43 | 2. <b>Optionally backup your AWStats configuration and history |
| 44 | data files</b>.<br> |
| 45 | Standard AWStats distributions do not change these, but |
| 46 | backing them up allows you to recover them if something does go |
| 47 | amiss. The AWStats default distribution will only overwrite the |
| 48 | configuration file example called <i>awstats.model.conf</i>. |
| 49 | Your |
| 50 | history data files are saved in the |
| 51 | directory defined with the DirData parameter in your AWStats |
| 52 | configuration file (awstats.<span style="font-style: italic;">mysite</span>.conf).<br> |
| 53 | <br> |
| 54 | 3. <b>Replace AWStats runtime files</b> with the new ones.<br> |
| 55 | To do this you can:<br> |
| 56 | - decompress the new AWStats zip or tgz |
| 57 | package over the old installation directory (old AWStats runtime files |
| 58 | are replaced by new ones. This works for AWStats versions 3.x and |
| 59 | higher).<br> |
| 60 | - or just run your OS package tool (i.e. |
| 61 | rpm, apt for Linux, .exe for MS Windows).<br> |
| 62 | <br> |
| 63 | Migrating to 6.x versions from earlier versions, observe the following additional notes:<br> |
| 64 | <u>i.</u> As of AWStats 6.0+, Perl version is 5.005_03 or |
| 65 | higher is required. To see the version number, run the command <i>perl |
| 66 | -v</i> |
| 67 | from your operating system's command line.<br> |
| 68 | <span style="text-decoration: underline;">ii</span>. If you use the <a href="awstats_extra.html#Extra">ExtraSections</a> feature, you |
| 69 | must check that the parameter(s) ExtraSectionConditionX uses a full |
| 70 | REGEX syntax (with the 5.x series, this parameter could contain simple |
| 71 | string values). If you don't update your configuration, the feature |
| 72 | will be broken. |
| 73 | <br> |
| 74 | <u>iii</u>. If you use the <a href="awstats_config.html#MiscTrackerUrl">MiscTrackerUrl</a> |
| 75 | feature, you must check |
| 76 | that your <a href="awstats_config.html#ShowMiscStats">ShowMiscStats</a> parameter is set to "ajdfrqwp" in addition to |
| 77 | setting up <a href="awstats_config.html#MiscTrackerUrl">MiscTrackerUrl</a> tags and a JavaScript include for your web |
| 78 | site. Otherwise the new default value "a" will be used (only the "Add |
| 79 | to favorites" will be reported). |
| 80 | <br> |
| 81 | <u>iv</u>. The MaxLengthOfURL parameter has been renamed |
| 82 | <a href="awstats_config.html#MiscTrackerUrl">MaxLengthOfShownURL</a>; |
| 83 | update your configuration file accordingly. |
| 84 | <br> |
| 85 | <u>v</u>. To enable the worm |
| 86 | detection feature (not enabled by default), you must add |
| 87 | the parameter <a href="awstats_config.html#MiscTrackerUrl">LevelForWormsDetection</a>=2 |
| 88 | in your configuration file. |
| 89 | <br> |
| 90 | <u>vi</u>. If you use the <span style="font-weight: italic;">urlalias</span> |
| 91 | or <span style="font-weight: italic;">userinfo</span> plugins, you must |
| 92 | move the urlalias.*.txt |
| 93 | or userinfo.*.txt file from the Plugins directory to the DirData |
| 94 | directory. |
| 95 | <br> |
| 96 | <br> |
| 97 | 4. <b>Convert your AWStats history files when migrating from 3.x or |
| 98 | 4.x |
| 99 | versions to 5.x or higher</b>.<br> |
| 100 | If you upgrade from the 3.x or 4.x |
| 101 | series to 5.x or higher, AWStats will still be able to 'read' your |
| 102 | old history files but |
| 103 | a warning may appear to ask you to run the 'migrate' process on your |
| 104 | old data files. |
| 105 | Just run the command that will appear in warning message. |
| 106 | This warning will only appear if data migration is necessary after an |
| 107 | upgrade from the 3.x or 4.x series to a |
| 108 | 5.x or higher |
| 109 | version.<br> |
| 110 | <br> |
| 111 | 5. <b>Review new feature </b><b> default </b><b>settings</b>.<br> |
| 112 | Sometimes new feature parameters are introduced in a new AWStats |
| 113 | version. AWStats will |
| 114 | use default values for them, maintaining backward compatibility with |
| 115 | your existing AWStats configuration. However, you can review the |
| 116 | "New Features / Change Log" to see how you might change the new |
| 117 | feature's |
| 118 | behavior.<br> |
| 119 | <br> |
| 120 | <br> |
| 121 | |
| 122 | <hr> |
| 123 | <script language="javascript"> |
| 124 | var date='$Date: 2008/09/29 19:28:21 $'; |
| 125 | document.writeln("Last revision: "+date); |
| 126 | </script> |
| 127 | |
| 128 | </body> |
| 129 | </html> |
