Old:UniServer AWStats for 4-Mona: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
(New page: <span id="top"></span> {| cellpadding="2" | __TOC__ || |} '''''UniServer AWStats plugin for Uniform Server 4.*-Mona series''''' This plugin installs AWStats on Uniform Server Mona. AWStat...)
(No difference)

Revision as of 14:30, 23 April 2009

UniServer AWStats plugin for Uniform Server 4.*-Mona series

This plugin installs AWStats on Uniform Server Mona. AWStats is a free powerful and fully featured tool that generates advanced web, streaming, ftp or mail server statistics, graphically.

The latest version of AWStats (9.8) requires extra Perl modules that are not included in a default installation of Uniform Server. The plugin installs these extra modules along with password protection for online viewing.

This page describes how to install the AWStats plugin and provides information for viewing stats on-line.

Top

Download and Install

Options 1:

  1. Download file UniServer_AWStats_1.0.exe from Sourceforge
  2. Save it to folder UniServer.
  3. To extract files, double click on file UniServer_AWStats_1.0.exe, no need to change the path.
  4. If you wish to save space delete UniServer_AWStats_1.0.exe

Options 2:

  1. Download file UniServer_AWStats_1.0.zip from Sourceforge
  2. Save to any folder (e.g. temp1)
  3. Extract files, navigate to folder UniServer_AWStats_1.0
  4. Copy the entire contents (read_me.txt and folder udrive) to Uniform Server's folder UniServer allow overwrite.
  5. If you wish to save space delete temp1

Folders and files

The following are added to Uniform Server

  • AWStats is installed in folder UniServer\udrive\cgi-bin\awstats
  • Password file .htpasswd can be found in folder UniServer\udrive\htpasswd\awstats
  • Perl modules Encode.pm and bytes.pm are added to folder UniServer_AWStats_1.0\udrive\usr\lib
  • Perl support modules are included in folder Encode
  • Folder \UniServer\udrive\www is updated with folders css, icon and js containing support files for AWStats.

Top

Testing

Testing is straight forward:

  • Start the servers
  • Type the following into a browser http://localhost/cgi-bin/awstats/awstats.pl

Top

Security

The plugin defaults to restricting access to localhost. This can be overridden to put AWStats online allowing you to view your server stats over the Internets. This may be a security risk hence you heve the option to password protect this information.

Top

Default Local access only

Local access is implemented using a .htaccess file located in folder \Uniform Server\udrive\cgi-bin\awstats

The file contains the following lines:

Order Deny,Allow
Deny from all
Allow from 127.0.0.1

The line Allow from 127.0.0.1 restricts access to localhost only. This prevents every one on the Internet viewing your stats information. You can however view the statistics page locally.

Top

View Stats on-line

To view your server statistics online password protect folder awstats.

Enable Password protection

The above .htaccess file contains additional lines allowing you to password protect folder awstats.

To put your stats online edit file Uniform Server\udrive\cgi-bin\awstats\.htaccess as follows:

Comment (add hash) these lines as shown: (Allows anyone access)

#Order Deny,Allow
#Deny from all
#Allow from 127.0.0.1

Uncomment (remove hash) these lines as shown: (Enables name/password protection)

AuthName "Uniform Server - Server Access"
AuthType Basic
AuthUserFile /htpasswd/awstats/.htpasswd
Require valid-user

Top

Set new name and password

The default name and password is root they are compromised hence need changing as follows:

Edit file UniServer\udrive\htpasswd\awstats\.htpasswd

Default: Contains the following:

root:root

Change: Choose a suitable name and password and change the file as follows:

new_name:new_password

To view on-line

Type the following into a browser: http://your_domain_name/cgi-bin/awstats/awstats.pl

Top

Conclusion

Installing AWStats with this plugin is easy, to view your stats on-line requires minimum of changes.

The stats provided may not meet your requirements however AWStats and Apache are customisable for details check out AWStats web site.

Related information How to install AWStats on Uniform Server 3.5-Apollo

Top