home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / webalizr.zip / README.FIRST < prev    next >
Text File  |  1999-06-25  |  6KB  |  138 lines
  1. Upgrade information for the Webalizer Version 1.30
  2.  
  3. ***********
  4. * NOTICE! *
  5. *********** Version 1.30 and higher are INCOMPATABLE with any and
  6. all previous versions of this program. File names have been changed,
  7. and file formats have been modified.  If you are upgrading from
  8. a previous version,  please read this ENTIRE DOCUMENT before you
  9. proceed, as it contains important information that you will need.
  10.  
  11. Note: If you plan on re-processing all of your logs so they will
  12. contain the new statistics, you can safely ignore the rest of
  13. this document (although you really should read it anyway...).
  14.  
  15.  
  16. QUICK UPGRADE INSTRUCTIONS:
  17.  
  18. 1) If you use incremental mode, read the section below, then
  19.    delete your current incremental data file (webalizer.current).
  20.  
  21. 2) Modify your history file (webalizer.hist) as described below.
  22.  
  23. 3) Add any new configuration options that you want to your
  24.    configuration file(s).  (See sample.conf for examples)
  25.  
  26. 4) Rename existing files to use 4 digit year (see below).
  27.  
  28. 5) Re-process your logs from beginning of the month (minimum).
  29.  
  30.  
  31. INCREMENTAL PROCESSING CHANGE
  32.  
  33. The incremental file format has changed, therefore you MUST
  34. REMOVE your current incremental file before running this
  35. version.  Doing so will also force you to re-process all logs
  36. from the beginning of the month, so if you have a large
  37. site, you may want to wait until the end/beginning of the
  38. month to perform the upgrade.
  39.  
  40.  
  41. HISTORY FILE CHANGE
  42.  
  43. The history file format changed as well.  In order to use your
  44. existing history file, you must manually edit it to add two
  45. additional numbers to the end of each line.  These numbers
  46. represent the total 'pages' and 'visits' for that particular
  47. month.  You can do this using any standard text editor.
  48.  
  49. For example, if your existing history file looks like:
  50.  
  51. 3 1999 56614 24758 234 180875 5 31
  52. 4 1999 156711 90240 1529 931048 1 30
  53.  
  54. You should change it to look like:
  55.  
  56. 3 1999 56614 24758 234 180875 5 31 0 0
  57. 4 1999 156711 90240 1529 931048 1 30 0 0
  58.  
  59. Notice the extra two zeros ('0') at the end of each line.  There
  60. will be _at most_ 12 lines for you to change.  You could of course
  61. put some fake values (or real ones if you have them) and they
  62. will show up on the main index page.  If you have access to a
  63. unix command prompt and sed, you could also simply type:
  64.  
  65. cat webalizer.hist | sed "s/$/ 0 0/g" > webalizer.hist
  66.  
  67. For those curious, the format of the history line is:
  68. Month# Year# Hits Files Sites KBytes Fdom Ldom Pages Visits
  69. (Fdom=First Ldom=Last day of month processed)
  70.  
  71. Note: It may be possible to leave your existing history file
  72. in place, and the first run with the new version will convert
  73. it to the new format.  It works on my linux system, it may
  74. not work on yours...  It depends on how your particular platform
  75. handles the missing data.  Probably better to not chance it ;)
  76.  
  77.  
  78. CONFIGURATION FILE CHANGES
  79.  
  80. Several new configuration and command line options have been
  81. added.  The default values for these should be suitable for
  82. most users,   however you might want to at least define the
  83. PageType extensions for your particular system (default is to
  84. use '.htm*' and '.cgi' extensions).  You should refer to the
  85. CHANGES file to see what has been changed/added. See the files
  86. README and sample.conf for additional details.
  87.  
  88.  
  89. GENERATED FILE NAME CHANGES
  90.  
  91. Previous versions of the Webalizer created html and image files
  92. using a format that included the month and year as two digit
  93. strings (ie: 0399).  Even though the filenames themselves were
  94. _only_ for humans, the Y2K scare has people freaked out over
  95. such behaviour, and I'm tired of getting all the email about it :)
  96. As a result, any existing files need to be renamed to include
  97. the extra two digits.  The old format was MMYY, new format is
  98. YYYYMM (and now they will sort correctly in directory listings :)
  99. For example, change the file "usage_0599.html"to "usage_199905.html",
  100. "ctry_usage_0599.gif" to "ctry_usage_199905.gif", and so on...
  101. You should change _all_ files in the output directory to use the
  102. new format.
  103.  
  104.  
  105. ---------------------------------------------------------------------
  106. ---------------------------------------------------------------------
  107. The remainder of this document contains the prior V1.22 upgrade info.
  108. This should only be of interest to those who are upgrading from older
  109. versions of the software and need to see those changes as well.
  110. ---------------------------------------------------------------------
  111. ---------------------------------------------------------------------
  112.  
  113. Upgrade Information for Webalizer V1.21 and higher
  114.  
  115. Some significant changes have occured between V1.20 and V1.21 of
  116. the Webalizer.  Additional configuration keywords have been added
  117. and incremental processing has been modified.  Due to these changes,
  118. the following must be observed:
  119.  
  120. Old incremental data files are no longer compatable with the new
  121. version.  Remove any existing incremental data files before running
  122. the new version.  This version also adds the ability to define the
  123. name and location of the incremental data file.  It will default to
  124. the normal name and location (webalizer.current in the specified
  125. output directory), however can be changed to an alternate location.
  126. See "IncrementalName" and "HistoryName" configuration directives.
  127. Note: you may check existing data files by looking at the first
  128. line of the file... if it doesn't start with "# Webalizer ", then
  129. it is an old style file and needs to be removed.
  130.  
  131. The configuration file has changed, however the only significant
  132. difference is the definition of the HTMLHead keyword, which has
  133. been changed in this version.  If you were using the HTMLHead
  134. keyword in previous versions, change it to "HTMLBody", in order
  135. to have it work as expected (as in previous versions).  See the
  136. README file for additional information.
  137.  
  138.