487
edits
Old:Installing AWStats on 3.5-Apollo: Difference between revisions
Old:Installing AWStats on 3.5-Apollo (view source)
Revision as of 13:18, 13 December 2011
, 13 December 2011Punctuation and grammatical changes; moved to Category: Archive.
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric) |
(Punctuation and grammatical changes; moved to Category: Archive.) |
||
| Line 2: | Line 2: | ||
<div style="padding:0;margin:0; border-bottom:3px inset #000000"> | <div style="padding:0;margin:0; border-bottom:3px inset #000000"> | ||
{| | {| | ||
| | |||
How to install AWStats on Uniform Server 3.5-Apollo | How to install AWStats on The Uniform Server 3.5-Apollo | ||
|} | |} | ||
</div> | </div> | ||
| Line 13: | Line 13: | ||
'''''Installing AWStats on 3.5-Appolo''''' | '''''Installing AWStats on 3.5-Appolo''''' | ||
AWStats is a Perl scripts for analysing Apache log files | AWStats is a set of Perl scripts for analysing Apache log files. Note that a standard installation uses absolute paths. This page covers installing AWStats using relative paths thus making it portable. The easiest way to install AWStats is manually. This gives you finer control over the process. | ||
== Preparation == | == Preparation == | ||
Unfortunately some of the Perl modules in 3.5-Appolo do not match the corresponding executable | Unfortunately some of the Perl modules in 3.5-Appolo do not match the corresponding executable. This prevents AWStats from working. The quickest way to resolve this is to apply the bug fix found on [[Bugs 3.5-Apollo: Perl incompatible modules | this page]]. | ||
== Download == | == Download == | ||
Go to http://awstats.sourceforge.net and download the latest version. The following installation guide is for '''version 6.8''' | Go to http://awstats.sourceforge.net and download the latest version. The following installation guide is for '''version 6.8''' We are going to perform a manual installation, so download the '''zip file''' (awstats-6.8.zip) and save it to a folder of your choice. | ||
== Extract files == | == Extract files == | ||
Right click on the file downloaded (awstats-6.8.zip) and select extract all | Right click on the file downloaded (awstats-6.8.zip) and select extract all. No need to change the folder location. This creates a folder named awstats-6.8; inside this is a second folder named awstats-6.8 containing folder wwwroot. Open folder wwwroot, which contains the following folders that need to be copied to The Uniform Server: | ||
This creates a folder named awstats-6.8 inside this is a second folder named awstats-6.8 containing folder wwwroot. Open folder wwwroot, | |||
* cgi-bin | * cgi-bin | ||
| Line 34: | Line 30: | ||
* js | * js | ||
== Installation == | == Installation == | ||
# Copy folders: '''css''', '''icon''' and '''js'''<br>To Uniform Server folder: '''\Uniform Server\udrive\www''' | # Copy folders: '''css''', '''icon''' and '''js'''<br /> To Uniform Server folder: '''\Uniform Server\udrive\www''' | ||
# Copy folder: '''cgi-bin'''<br>To Uniform Server folder: '''\Uniform Server\udrive\cgi-bin'''<br>Rename the copied folder cgi-bin to '''awstats''' | # Copy folder: '''cgi-bin'''<br /> To Uniform Server folder: '''\Uniform Server\udrive\cgi-bin'''<br />Rename the copied folder cgi-bin to '''awstats'''. | ||
== AWStats Configuration == | == AWStats Configuration == | ||
| Line 71: | Line 65: | ||
The section starting at line 156 is worth a read. | The section starting at line 156 is worth a read. | ||
== View Stats == | == View Stats == | ||
You can view the initial stats page by typing the following into your browser: | You can view the initial stats page by typing the following into your browser: | ||
| Line 77: | Line 70: | ||
'''<nowiki>http://localhost/cgi-bin/awstats/awstats.pl</nowiki>''' | '''<nowiki>http://localhost/cgi-bin/awstats/awstats.pl</nowiki>''' | ||
Note: To recalculate statistics click on the '''Update now''' link located top of page. | Note: To recalculate statistics, click on the '''Update now''' link located top of page. | ||
== Security == | == Security == | ||
The above configuration allows you to view your server statistics online | The above configuration allows you to view your server statistics online. This includes any other users with access to your server. You probably don’t want users to view this valuable information. To restrict access you have two options: either password protect the folder or restrict access to localhost only. | ||
=== Local access only === | === Local access only === | ||
Copy file .htaccess from folder \Uniform Server\udrive\www to folder \Uniform Server\udrive\cgi-bin\awstats | Copy file .htaccess from folder \Uniform Server\udrive\www to folder \Uniform Server\udrive\cgi-bin\awstats . | ||
Edit the file you just copied to look like this: | Edit the file you just copied to look like this: | ||
| Line 93: | Line 86: | ||
Allow from 127.0.0.1 | Allow from 127.0.0.1 | ||
</pre> | </pre> | ||
This prevents | This limits viewing the statistics page to your local machine and prevents everyone on the Internet form seeing your stats information. | ||
=== Password protect === | === Password protect === | ||
If you need to view your server statistics online password protect folder awstats. | If you need to view your server statistics online, password protect the folder awstats. | ||
Again | Again use Uniform Server's default .htaccess file. Copy it from folder \Uniform Server\udrive\www to folder \Uniform Server\udrive\cgi-bin\awstats | ||
Edit the file you just copied to look like this: | Edit the file you just copied to look like this: | ||
| Line 117: | Line 110: | ||
== Download == | == Download == | ||
I am lazy and tend to keep overlay files (plugins) | I am lazy and tend to keep overlay files (plugins). You may find this one of use. | ||
Download this file [http://wiki.uniformserver.com/exeload/awstats/uc_awstats_6_8_plugin.exe uc_awstats_6_8_plugin.exe] save it to folder '''*\Uniform Server''' (where Stop.bat and Server_Start.bat are located). | Download this file [http://wiki.uniformserver.com/exeload/awstats/uc_awstats_6_8_plugin.exe uc_awstats_6_8_plugin.exe] and save it to folder '''*\Uniform Server''' (where Stop.bat and Server_Start.bat are located). | ||
'''MD5 = 7156b9ad91a84c13e7e3d8c66641ff4d''' | '''MD5 = 7156b9ad91a84c13e7e3d8c66641ff4d''' | ||
| Line 125: | Line 118: | ||
The file is a self-extracting archive; double click to run, no need to change the path, allow overwriting existing files. This updates Uniform Server as described above. | The file is a self-extracting archive; double click to run, no need to change the path, allow overwriting existing files. This updates Uniform Server as described above. | ||
'''''Note'':''' Remember to download and apply [[Bugs 3.5-Apollo: Perl incompatible modules | Uc_bug_fix_5.exe]] | '''''Note'':''' Remember to download and apply [[Bugs 3.5-Apollo: Perl incompatible modules | Uc_bug_fix_5.exe]]. Otherwise you will receive a "Server Configuration Error" message. | ||
== Conclusion == | == Conclusion == | ||
The above is intended to get AWStats up and running quickly; depending on your requirements you may need to make additional changes. | The above is intended to get AWStats up and running quickly; depending on your requirements you may need to make additional changes. | ||
I performed the above installation on a clean install of Uniform Server | I performed the above installation on a clean install of Uniform Server. Due to a lack of data to analyse, the output from AWStats was unimpressive. I copied the access.log file from a working server into folder \Uniform Server\udrive\usr\local\apache2\logs; now that was impressive and fast. | ||
---- | ---- | ||
{| | {| | ||
| [[Image:uc_small_logo.gif]] || [[User: | | [[Image:uc_small_logo.gif]] || [[User:Ric | Ric]] | ||
|} | |} | ||
[[Category: User Made|Tutorials]] | [[Category: User Made|Tutorials]] | ||
[[Category: How To]] | [[Category: How To]] | ||
[[Category: | [[Category: Uniform Server 3.5-Apollo]] | ||
[[Category: Archive]] | |||