____________________________________________________________

 Analog 4.11 for OS/2, KOT Patch Level 2        (16/11/2000) 
____________________________________________________________
                              supported by Russian Team OS/2



You must read the license before using analog.

Contents.
1. What is it?
2. Contents of distributive.
3. System reqirements.
4. Changes.
5. Some limitations.
6. Installation.
7. Where to get?
8. Greetings.
9. Feedback.


1. What is it?
==============

Webserver logfile analyzer analog version 4.11 compiled for OS/2 Warp. The 
sources and description you can get at  http://www.analog.cx/, the 
original documentation is in 'docs' subdirectory, which is a part of the 
distributive.

I believe that the documentation is enough for understanding the 
principles of its work and setting up and see no reason to repeat it here. 
In this document I'll have a look only at the aspects referring to the 
distributive. 

As the program is ported from UNIX environment I will use / as separation 
symbol of catalogs.  But you can use \ as well.


2. Contents of distributive.
============================

readme.txt - Documentation in English that you are reading now.
readme.rus - Documentation in Russian.
docs       - directory with documentation of the Analog
examples   - examples of configuration.
images     - pictures necessary for the work of program.
lang       - localization files.
analog.exe . executable Analog file ready for use.
analog.cfg - example of configuration files


3. System requirements.
=======================

The program requires  OS/2 Warp 3.0 and higher,  EMX runtime 0.9d + fix3, 
but as specific calls practically are not used it is quite possible that it 
will work with younger versions of emx.


4.Changes.
==========

PL1:
- localization  RUSSIAN_ALT is added.  The reason- I believe that 
files on the disk should be stored in the code native for the operating 
system.

- option SET_CHARSET is added. When it is switched off  analog does 
not write  charset=   to the generated html  code.  The reason -  the 
Russian  apache  can recode documents to the necessary code page. As a 
result   charset of the file on the disk and got by the user can differ. 
By default analog writes charset to the file which could lead to 
undesirable results. For instance, when using old versions of   apache.

PL2:
- lang/rualtdom.tab is created. Now when using LANG=RUSSIAN_ALT
  domain names will be written in Russian,  as it should be when using 
LANG.
- parameter of command line - analog.config is added,  where 
analog.config is the path to the configuration file analog.
ATTENTION! When you use this option all the other parameters of the 
command line will be ignored.
- option LANGDIR is added. It determines the catalog with 
localization. It is necessary when the path to the catalog differs 
from ../analog/lang/. Remember that at the end of the line should be 
present the separation symbol of the catalogs. 
- for using the program as CGI script it is enough to correct several 
lines in the configuration file.
- the sources are located in the separate archive.

5. Some limitations.
     As the path to the configuration file is compiled into the program 
there are some limitations in using the program.  

Some settings by default:
					Variable	Value
Configuration file					../analog/analog.cfg
Path to the catalog with localization 	LANGDIR		../analog/lang
Path to the logfile     		LOGFILE		../logs/access_log
Path to the pictures      		IMAGEDIR    	images/
Output of  HTML code to			OUTFILE 	../htdocs/analog

The settings correspond to the commented lines in the configuration file.
If you change the corresponding variables you can configure analog path 
for necessary files and catalogs.

The full variant of the example of configuration file you can find in 
examples/big.cfg.

As you could mention the settings are oriented to co-work with 
Apache server but making some intellectual efforts for changing the 
configuration file you can use analog for other webservers too. At least 
you can recompile analog yourself.

ATTENTION! Starting from PL2 you can indicate the path to the 
configuration file with the help of option -c,  but if you want to use 
analog as CGI script you will have to create a .cmd file (or another) 
starting analog:

@analog.exe -c /path/to/config.file

For switching on certain features especially referred to  ANALOGDIR when 
using analog   with paths different from   ../analog/,  it is possible 
that you will have to recompile the program. 


6. Installation.
================

Let us assume that     analog  will be used together with apache webserver 
having paths to the file that almost do not differ from standard. 

Let us denote catalog with apache   as $APACHEDIR. The file with ready 
report and necessary pictures will be located in  $APACHEDIR/htdocs/analog.

For installation it is necessary to :

1) place analog.cfg and catalog lang to $APACHEDIR/analog.

2) When using  analog  in standalone regime . to place analog.exe to 
$APACHEDIR/analog,    in   CGI   regime -   to place cgi/analog.exe to    
$APACHEDIR/cgi-bin.

3) Catalog images place to  $APACHEDIR/htdocs/analog, the location of the 
pictures can be changed by the variable IMAGEDIR in the configuration 
file. It will be indicated regarding  DocumentRoot   of the location of 
report /CGI-script.

4) Configure   $APACHEDIR/analog/analog.cfg.  It is desirable to indicate 
HOSTNAME and    HOSTURL  in that file.  When using analog  as CGI  script -
it is necessary to delete comments in the following lines:

OUTFILE stdout
CGI on

Now the is ready to work by default.
The installation is over - analog  is ready for use!


7. Where to get?
================
Home page of Analog/2 KOT Patch:
     http://os2.ru/projects/analog
The sources ready for compilation for OS/2:     
     ftp://kot.spb.ru/pub/os2/analog/analog-4.11.KOT.PL2.src.zip
Home page of  analog:
     http://www.analog.cx/
You can download the sources of this version at:
     ftp://kot.spb.ru/pub/src/www/analog-4.11.tar.gz


8. Greetings.
=============

Thanks a lot to      Stephen  Turner  for writing this program 
I should say that the author previewed the possibility of porting it to 
for OS/2, so, the compilation was not difficult. 

Thanks to IBM for its operating system which I use. 

Thanks to all the people working at the project emx-gcc. Without it the 
compilation could be a torture. 

Special thanks to  banshee (Dmitry Ban) and OS2OK (Konstantin Okounkov)
living at #os2russian@EFNet for kicking and making me do it. 

Thanks to me dear for existing. 

     
9.Feed back.
============

The questions concerning this port you can address to me at
KOT@MATPOCKuH.SPb.Ru, 2:5030/1340@fidonet.


Translated to English by Irina Koudina (irink@os2.ru)
____________________________________________________________
Analog/2 
