Readme for analog -- upgrading from earlier versions

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

# Analog 4.16: Upgrading from earlier versions

This section lists those commands which existed in older versions of analog, but which have been changed or abolished in this version. It also lists reasons why the same input might now produce different output. The new features in this version are listed in the section What's new in this version?.

## Upgrading from 4.13 and earlier

- Regular expressions in an `INCLUDE` or `EXCLUDE` command must now occur on a line on their own, not within a comma-separated list.
- The search terms reported in the Search Word and Search Query Reports are no longer converted to lower case if you are using a multibyte character set.
- Unprintable characters in the output are now replaced by '?', except for multibyte character sets.
- If you're compiling analog yourself, the default location of the analog directory in `anlghead.h` changed from `/usr/local/analog-VERSION/` to `/usr/local/analog/analog-VERSION/`.

## Upgrading from 4.11 and earlier

- `*INCLUDE ""` and `*EXCLUDE ""` (see documentation) now apply to items which were present but corrupt. This may have the effect of including or excluding some new lines.
- There has been a tiny change in computer-readable output style. Previously if a time was blank, it took up only one column. Now it takes up as many columns as if it had been present.

## Upgrading from 4.1 and earlier

- The default definition of "pages" is now case insensitive: so it includes `*.HTM` and even `*.hTmL` etc. It also now includes `*.asp`. These changes will serve to increase the page count.

## Upgrading from 4.04 and earlier

- There is better parsing of extended format and WebSTAR format logs, which may cause differences in some cases.
- All referrers now count as "pages" irrespective of any `PAGEINCLUDE` and `PAGEEXCLUDE` commands. Consequently, for example, "`REFLINKINCLUDE pages`" is now the same as "`REFLINKINCLUDE *`". You can recreate the previous behaviour with "`REFLINKINCLUDE *.html,*.htm,*/`".
- The default `REPORTORDER` has changed.
- New anchor names are used internally to the report.

## Upgrading from 4.03 and earlier

- There may be slight differences in the results in this version owing to stripping anchors off filenames.

## Upgrading from 4.0 and earlier

- Some of the default paths have changed in `anlghead.h`.

## Upgrading from 3.90beta1 and earlier

- It is now recommended that you don't run analog as a CGI program, or put it in the directory with your CGI programs, for security reasons.
- Each browser in the Browser Summary is now sorted by major version number then minor version number. So `SUBBROW */*` will now only show the major versions. To get all the minor versions, you need `SUBBROW */*.*`
- `PAGEWIDTH` has been replaced by `HTMLPAGEWIDTH` and `ASCIIPAGEWIDTH`.
- `PRINTVARS` has been renamed `SETTINGS`.

## Upgrading from 3.32 and earlier

- The form interface has been completely rewritten, and old versions of `anlgform.html` will not work with this version.
- The Browser Summary now diagnoses MSIE, Opera and WebTV browsers better. This will cause differences in output from previous versions.
- With `RAWBYTES OFF`, bytes are now listed as, for example, 47.68 Mbytes instead of 48,832 kbytes. This should be less confusing.
- The DNS file has a new time encoding. It's only a few hours different, so I haven't made any special provision for it. The effect is that the `DNSGOODHOURS` and `DNSBADHOURS` may be a few hours out for existing entries (but not for new ones).
- Most languages don't work in this beta version, but should be added again by version 4. (The language files are included in the distribution, but contain lots of English strings).

## Upgrading from 3.3 and earlier

- There is a new set of graphics in the `images` directory, which you will have to move to your web directory.
- In the Mac version, if a configuration file is dragged onto the analog icon, it is used instead of, not as well as, the default configuration file.

## 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.
- The English domains file has changed name from `domains.tab` to `ukdom.tab`.

## 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.
- Count of number of new hosts in last seven days abolished. It was too confusing because it depended on which old logfiles you analysed.
- 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`.
- 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`.

Go to the analog home page.

Need help with analog? Use the analog-help mailing list.

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