AWStats for 5-Nano: Difference between revisions
Upazixorys (talk | contribs) No edit summary |
m Text replace - "projects/uniformserver" to "projects/miniserver" |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<span id="top"></span> | |||
{| cellpadding="2" | |||
{| cellpadding= | |||
| | | | ||
__TOC__ | __TOC__ | ||
| Line 8: | Line 7: | ||
'''''UniServer AWStats plugin for Uniform Server 5-Nano series''''' | '''''UniServer AWStats plugin for Uniform Server 5-Nano series''''' | ||
This plugin installs [http://awstats.sourceforge.net/ AWStats] on Uniform Server Nano. AWStats is a free powerful and fully featured tool that generates advanced web, streaming, ftp or mail server statistics, graphically. | This plugin installs [http://awstats.sourceforge.net/ AWStats] on The Uniform Server 5-Nano. AWStats is a free, powerful and fully featured tool that generates advanced web, streaming, ftp or mail server statistics, graphically. | ||
Due to UniServer's architecture change there are two versions of this plugin with and without Perl. Both plugins use AWStats ( | Due to UniServer's architecture change, there are two versions of this plugin: with and without Perl. Both plugins use AWStats (6.8) also installs password protection for online viewing. | ||
This page describes how to install the AWStats plugin and provides information for viewing stats on-line. | This page describes how to install the AWStats plugin and provides information for viewing stats on-line. | ||
| Line 20: | Line 19: | ||
This version includes V5.0_mini_perl (ActivePerl 5.10.0.1005) and is intended for users who just want to display server statistics. | This version includes V5.0_mini_perl (ActivePerl 5.10.0.1005) and is intended for users who just want to display server statistics. | ||
It avoids the need to download and install a Perl plugin however it does restrict you to | It avoids the need to download and install a Perl plugin, however it does restrict you to ActivePerl version 5.10.0.1005. | ||
=== V5.0_AWStats_2.0 === | === V5.0_AWStats_2.0 === | ||
This version does not include Perl | This version does not include Perl. This increases flexibility by allowing you to choose a specific version of Perl. However it requires the additional step of selecting the desired plugin. | ||
Currently there are two versions of the Perl plugin split into mini and full: | Currently there are two versions of the Perl plugin split into mini and full: | ||
| Line 34: | Line 32: | ||
* V5.1_full_perl ActivePerl 5.10.0.'''1006''' | * V5.1_full_perl ActivePerl 5.10.0.'''1006''' | ||
Before proceeding to AWStats installation download and install one of the above Perl versions see [[5.0-Nano: Perl | '''Perl page''']] for details. | Before proceeding to AWStats installation download and install one of the above Perl versions, see the [[5.0-Nano: Perl | '''5-Nano Perl page''']] for details. | ||
== Download and Install == | == Download and Install == | ||
There are two installation options as follows replace # with the version you are installing: | There are two installation options as follows: replace "#" with the version you are installing: | ||
''''' | '''''Option 1'':''' | ||
# Download file '''V5.0_AWStats_#.0.exe''' from [http://sourceforge.net/projects/miniserver/files/ Sourceforge] | # Download file '''V5.0_AWStats_#.0.exe''' from [http://sourceforge.net/projects/miniserver/files/ Sourceforge] | ||
# Save it to folder '''UniServer'''. | # Save it to folder '''UniServer'''. | ||
# To extract files, double click on file V5.0_AWStats_#.0.exe | # To extract files, double click on file V5.0_AWStats_#.0.exe; no need to change the path. | ||
# If you wish to save space delete V5.0_AWStats_#.0.exe | # If you wish to save space, delete V5.0_AWStats_#.0.exe | ||
''''' | '''''Option 2'':''' | ||
# Download file '''V5.0_AWStats_#.0.zip''' from [http://sourceforge.net/projects/miniserver/files/ Sourceforge] | # Download file '''V5.0_AWStats_#.0.zip''' from [http://sourceforge.net/projects/miniserver/files/ Sourceforge] | ||
# Save to any folder (e.g. '''''temp1''''') | # Save to any folder (e.g. '''''temp1''''') | ||
# Extract files, navigate to folder V5.0_AWStats_#.0 | # Extract files, navigate to folder V5.0_AWStats_#.0 | ||
# Copy the entire contents (read_me.txt, usr, www ... etc) to Uniform Server's folder UniServer allow overwrite. | # Copy the entire contents (read_me.txt, usr, www ... etc) to Uniform Server's folder UniServer allow overwrite. | ||
# If you wish to save space delete '''''temp1''''' | # If you wish to save space, delete '''''temp1''''' | ||
'''''Folders and files''''' | '''''Folders and files''''' | ||
| Line 63: | Line 60: | ||
* Folder UniServer\www is updated with folders '''css''', '''icon''' and '''js''' containing support files for AWStats. | * Folder UniServer\www is updated with folders '''css''', '''icon''' and '''js''' containing support files for AWStats. | ||
=== Common === | === Common === | ||
Whichever installation option you choose all Perl scripts must have their shebang updated to match current server location. | Whichever installation option you choose all Perl scripts must have their shebang updated to match current server location. | ||
'''''Update Shebang'':''' | '''''Update Shebang'':''' | ||
* Left mouse click UniTray | * Left mouse click UniTray > Mouse over '''Advanced''' and select '''Perl Shebang Update cgi-bin''' | ||
* The above requires performing once (before starting servers) thereafter shebangs are automatically on relocating the servers. | * The above requires performing once (before starting servers) thereafter shebangs are automatically on relocating the servers. | ||
== Testing == | == Testing == | ||
Testing is straight forward: | Testing is straight forward: | ||
* Start the servers | * Start the servers | ||
* Type the following into a browser ''' | * Type the following into a browser '''<nowiki>http://localhost/cgi-bin/awstats/awstats.pl</nowiki>''' | ||
'''''Note'':''' | '''''Note'':''' | ||
| Line 82: | Line 78: | ||
If you have moved the servers remember to include the port number for example: | If you have moved the servers remember to include the port number for example: | ||
''' | '''<nowiki>http://localhost:82/cgi-bin/awstats/awstats.pl</nowiki>''' | ||
Use UniTray '''Server Status''' to find the Apache port number. | Use UniTray '''Server Status''' to find the Apache port number. | ||
== Security == | == 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. | 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. | ||
=== Default Local access only === | === Default Local access only === | ||
Local access is implemented using a '''.htaccess''' file located in folder UniServer\cgi-bin\'''awstats''' | Local access is implemented using a '''.htaccess''' file located in folder UniServer\cgi-bin\'''awstats''' | ||
The file contains the following lines: | The file contains the following lines: | ||
<pre> | |||
Order Deny,Allow | Order Deny,Allow | ||
Deny from all | Deny from all | ||
Allow from 127.0.0.1 | Allow from 127.0.0.1 | ||
</pre> | |||
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. | 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. | ||
=== View Stats on-line === | === View Stats on-line === | ||
| Line 114: | Line 106: | ||
Comment (add hash) these lines as shown: (Allows anyone access) | Comment (add hash) these lines as shown: (Allows anyone access) | ||
<pre> | |||
#Order Deny,Allow | #Order Deny,Allow | ||
#Deny from all | #Deny from all | ||
#Allow from 127.0.0.1 | #Allow from 127.0.0.1 | ||
</pre> | |||
Uncomment (remove hash) these lines as shown: (Enables name/password protection) | Uncomment (remove hash) these lines as shown: (Enables name/password protection) | ||
<pre> | |||
AuthName | AuthName "Uniform Server - Server Access" | ||
AuthType Basic | AuthType Basic | ||
AuthUserFile /htpasswd/awstats/.htpasswd | AuthUserFile /htpasswd/awstats/.htpasswd | ||
Require valid-user | Require valid-user | ||
</pre> | |||
==== Set new name and password ==== | ==== Set new name and password ==== | ||
| Line 135: | Line 126: | ||
'''''Default'':''' Contains the following: | '''''Default'':''' Contains the following: | ||
<pre> | |||
root:root | root:root | ||
</pre> | |||
'''''Change'':''' Choose a suitable name and password and change the file as follows: | '''''Change'':''' Choose a suitable name and password and change the file as follows: | ||
<pre> | |||
new_name:new_password | new_name:new_password | ||
</pre> | |||
==== To view on-line ==== | ==== To view on-line ==== | ||
Type the following into a browser: ''' | Type the following into a browser: '''<nowiki>http://your_domain_name/cgi-bin/awstats/awstats.pl</nowiki> ''' | ||
== Conclusion == | == Conclusion == | ||
Installing AWStats with this plugin is easy | Installing AWStats with this plugin is easy. Viewing your stats on-line requires a minimum of changes. | ||
The stats provided may not meet your requirements, however AWStats and Apache are customisable. For details check out AWStats [http://awstats.sourceforge.net/ web site]. | |||
---- | ---- | ||