[ Top | Up |
Prev | Next |
Map | Index ]
Analog 4.15:
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?.
- 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/.
- *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.
- 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.
- 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.
- There may be slight differences in the results in this version owing to
stripping anchors off filenames.
- Some of the default paths have changed in anlghead.h.
- 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.
- 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).
- 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.
- 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.
- 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.
- 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
- LOGFORMAT MICROSOFT has been replaced by
LOGFORMAT MICROSOFT-NA and LOGFORMAT MICROSOFT-INT;
and similarly for LOGFORMAT NETPRESENZ.
- 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.
- Filenames for logfiles etc. should now be given DOS-style, with
backslashes, rather than Unix-style with forward slashes.
- There is no longer an automatic progress report. Use the
PROGRESSFREQ command
instead.
- 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.
Stephen Turner
01 February 2001
Need help with analog? Use the analog-help
mailing list.
[ Top | Up |
Prev | Next |
Map | Index ]