From: eldy <> Date: Sun, 18 Jul 2004 22:24:22 +0000 (+0000) Subject: Updated documentation X-Git-Tag: AWSTATS_6_3_RELEASE~126 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=61a659e67bb12646b738c5dfcbe00cb7f75fa33b;p=thirdparty%2FAWStats.git Updated documentation --- diff --git a/docs/awstats_setup.html b/docs/awstats_setup.html index e7d2c2e2..b8606958 100644 --- a/docs/awstats_setup.html +++ b/docs/awstats_setup.html @@ -35,9 +35,9 @@ AWStats common use is made in 3 steps:

@@ -50,8 +50,8 @@ If not, you can install a recent Perl interpreter from A) With Apache or compatible server (on Unix/Linux, Windows, MacOS...)

-* Step 1-1:
-(if you use a package provided with a Linux distribution or Windows installer, action done in step 1-1 +* Step 0-1:
+(if you use a package provided with a Linux distribution or Windows installer, action done in step 0-1 might have already be done, if you don't know you, do it again)

After downloading and extracting the AWStats package, you should run the awstats_configure.pl script to do @@ -123,7 +123,7 @@ E) awstats_configure.pl ends.

-* Step 1-2:
+* Step 0-2:
Once a config file has been automatically created (by awstats_configure.pl, by you package installer or just by a manual copy of awstats.model.conf), it's important to edit it manually and change the "MAIN PARAMETERS" to match all your needs:
@@ -141,14 +141,14 @@ possible name for same site, add list in
-Step 1 (Install and Setup) is finished. You can jump to the Build/Update Statistics section.
+Step 0 (Install and Setup) is finished. You can jump to the Build/Update Statistics section.



B) With IIS server

-* Step 1-1:
+* Step 0-1:

Configure IIS to log in "Extended W3C log format" (You can still use your own log format but setup is easier if made like suggested). So, for @@ -175,33 +175,33 @@ your homepage. This is an example of records you should get then in the new log 2000-07-19 14:14:14 62.161.78.73 - GET / 200 1234 HTTP/1.1 Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.htm

-* Step 1-2:
+* Step 0-2:

Copy the contents of the provided cgi-bin folder from your hard drive to your server's cgi-bin directory (this includes awstats.pl, awstats.model.conf, and the lang, lib and plugins sub-directories).

-* Step 1-3:
+* Step 0-3:

Move AWStats icon sub-directories and its content into a directory readable by your web server, for example C:\yourwwwroot\icon.

-* Step 1-4:
+* Step 0-4:

Create a config file by copying awstats.model.conf file into a new file named awstats.myvirtualhostname.conf. You can use the value of your choice instead of "myvirtualhostname". This new file must be stored in
- Same directory than awstats.pl (so cgi-bin)

-* Step 1-5:
+* Step 0-5:

Edit this new config file with your own setup :
- Change LogFile value with full path of your web server log file (You can also use a relative path from your awstats.pl directory).
- Change LogType value with "W" for analyzing web server log files, "S" for a streaming server log file, "M" for mail log files, "F" for ftp log files, "O" otherwise.
-- Change LogFormat to a value with same field's name defined in step 1-1:
+- Change LogFormat to a value with same field's name defined in step 0-1:
LogFormat="date time c-ip cs-username cs-method cs-uri-stem cs-uri-query sc-status sc-bytes cs-version cs(User-Agent) cs(Referer)"
- Change DirIcons parameter to reflect relative path of icon directory.
- Edit SiteDomain parameter with the main domain name or the intranet @@ -209,7 +209,7 @@ web server name used to reach the web site to analyze (Example: www.mydomain.com - Set AllowToUpdateStatsFromBrowser parameter to 1 if you don't have command line access and have only cgi access.
- You can change other parameters if you want.

-Step 1 (Install and Setup) is finished. You can jump to the Build/Update Statistics section.
+Step 0 (Install and Setup) is finished. You can jump to the Build/Update Statistics section.


@@ -224,13 +224,13 @@ a personalized LogFormat if your log

-

Step 2 : Build/Update Statistics

 +

Step 1 : Build/Update Statistics
-* Step 2-1:
+* Step 1-1:

The first analyze/update of statistics should be made the first time manually from the command line since first time, -process may be long and it's easier to solve problems (if you don't have Command Line access, just go to Step 2-2). The +process may be long and it's easier to solve problems (if you don't have Command Line access, just go to Step 1-2). The AWStats update command line is:
awstats.pl -config=myvirtualhostname -update

@@ -275,7 +275,7 @@ address in your logfile if DNSLookup See Benchmark page for more accurate information.

-* Step 2-2:
+* Step 1-2:

AWStats statistics can be updated from a browser, to provide real-time statistics, by clicking the "Update now" link that appears when AWStats is used as a CGI (Next section 'Read Statistics @@ -294,7 +294,7 @@ See AWStats Benchmark page for recommanded

-

Step 3 : Read Statistics

 +

Step 2 : Read Statistics
To see results of analyze, you have several solutions depending on your security policy.