Readme for analog3.3

Upgrading from earlier versions

Upgrading from 3.2 and earlier

• In the computer-readable output style, the line L7, the time the last seven days begins after, has been replaced by E7, the time the last seven days ends. This is for consistency with the other output styles.
• Also in the computer-readable output, there is a new line reporting the floor and the SORTBY for the report. In 3.11 and earlier, this didn't exist, and in 3.2 it only reported the floor, not the SORTBY.
• %R (Mac-style filename) has been abolished in the LOGFORMAT. Just use plain %r instead.
• It is no longer allowed to set the CACHEOUTFILE to be the same as a previous cache file.
• The definition of the common log format and related formats changed between 3.11 & 3.2, and again between 3.2 & 3.3. This could cause differences in output, but they are likely to be only very minor.

Upgrading from 3.11 and earlier

• Lines without a particular item now work properly with INCLUDE and EXCLUDE commands. For example, if you do an INCLUDE to look at only certain lines, then lines without that type of item at all will not now be included, whereas previously they would have been. This can make the results lower than in these earlier versions.
• I have reluctantly removed support for NetPresenz logs. This hasn't worked for some time, and I have already been advising NetPresenz users not to use newer versions of analog because they could get wrong results. Unfortunately, fixing it would require a complete rewrite of the entire parsing code, which isn't going to happen any time soon. So my advice remains the same: continue to use version 2.11 or (even better) pre-process your logfiles into a form which analog can handle safely.

Upgrading from 3.0, Win32 form interface

• If using the form interface on Windows, it is now necessary to put the analog executable at \analog\analog.exe instead of \Program Files\analog\analog.exe

Upgrading from 2.90beta1

• LOGFORMAT MICROSOFT has been replaced by LOGFORMAT MICROSOFT-NA and LOGFORMAT MICROSOFT-INT; and similarly for LOGFORMAT NETPRESENZ.

Upgrading from 2.11 and earlier

• It is possible that there may be small discrepancies between the results from previous versions and the results from this version because the parsing code has changed, but any such differences should be minor. However...
• If you used to use REFEXCLUDE or BROWEXCLUDE, you most likely now want REFREPEXCLUDE or BROWREPEXCLUDE instead, or you will exclude lots of lines that were previously included.
• It is possible that this version may not automatically parse a logfile that previous versions could parse, because it checks more carefully that the logfile is in the format claimed. If so, you will have to use a LOGFORMAT command.
• Approximate host counting has been abolished, unless there's a significant demand for it.
• The Error Report has been abolished (together with the configuration commands ERROR, ERRLOG and ERRMINOCCS). See the What's new? page.
• The BROWLOG and REFLOG commands have also been abolished: just use LOGFILE instead.
• The HASHSIZE commands have been abolished: analog now chooses the size of the hash tables itself.
• The MINREQS and similar options have been replaced by the FLOOR commands.
• Only one * is now allowed on the left-hand side of aliases, to avoid ambiguities.
• Automatic detection of log type is now on a per-file rather than a per-line basis.
• ISPAGE is now called PAGEINCLUDE.
• WITHARGS and REFWITHARGS are now called ARGSINCLUDE and REFARGSINCLUDE.
• MONTHLYBACK is now called MONTHBACK.
• FULLHOSTS is now just called HOST.
• LOGOURL is now called LOGO, and is assumed to be within the IMAGEDIR.
• The UNIT commands have been abolished. They weren't very useful, and they didn't make much sense with the different ways of displaying the time report bar charts. The unit is now always chosen automatically.
• DIRLEVEL has been abolished, because the SUBDIR command is more general. Use SUBDIR */* or whatever instead.
• Comments aren't allowed in the domains file. I don't think this should cause a problem.
• GRAPHICAL is abolished. Instead, use lower case letters with the GRAPH commands.
• NUMLOOKUP has been replaced by DNS, and DNSFRESHHOURS by the commands DNSGOODHOURS and DNSBADHOURS.
• DNS cache files from previous versions are not compatible with this version.
• You can't use PAGES in the columns or SORTBY or FLOOR for the Request Report. Use REQINCLUDE pages instead.
• - as a synonym for none has been abolished in some places, e.g., HOSTURL.
• The following command line arguments have been abolished from earlier versions, many of the letters getting new meanings: 7, l, n, p, s, u, v, w. (-v has moved to -settings.) Others have been changed since version 1.2 as well.

Upgrading from 2.0, Win32 users

• Filenames for logfiles etc. should now be given DOS-style, with backslashes, rather than Unix-style with forward slashes.

Upgrading from 1.92 and earlier, Mac users

• There is no longer an automatic progress report. Use the PROGRESSFREQ command instead.

Upgrading from 1.9beta's

• Use REQINCLUDE and LINKINCLUDE instead of REQTYPE and PAGELINKS.

Upgrading from 1.2's and earlier

• Use *INCLUDE and *EXCLUDE instead of *ONLY and *IGNORE.
• The syntax of the *FLOOR commands has changed.
• Use *SORTBY REQUESTS or BYTES instead of *SORTBY BYREQUESTS or BYBYTES.

[ Top | Up | Prev | Next | Map | Index ]