AWStats for 5-Nano: Difference between revisions

Punctuation and grammatical changes.
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric)
(Punctuation and grammatical changes.)
Line 7: 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 (9.8) also installs password protection for online viewing.
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 19: 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 using ActivePerl version 5.10.0.1005.
It avoids the need to download and install a Perl plugin, however it does restrict you to ActivePerl version 5.10.0.1005.


'''''[[#top | Top]]'''''
=== V5.0_AWStats_2.0 ===
=== V5.0_AWStats_2.0 ===
This version does not include Perl hence increases flexibility by allowing you to choose a specific version of 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 33: 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.


'''''[[#top | Top]]'''''


== 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:


'''''Options 1'':'''
'''''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, no need to change the path.
# 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


'''''Options 2'':'''
'''''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 62: 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.  


'''''[[#top | Top]]'''''
 
=== 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.
Line 70: Line 68:
* 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.   


'''''[[#top | Top]]'''''


== Testing ==
== Testing ==
Line 85: Line 82:
Use UniTray '''Server Status''' to find the Apache port number.  
Use UniTray '''Server Status''' to find the Apache port number.  


'''''[[#top | Top]]'''''


== 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.


'''''[[#top | Top]]'''''
=== 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'''
Line 101: Line 96:
</pre>
</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.
'''''[[#top | Top]]'''''


=== View Stats on-line ===
=== View Stats on-line ===
Line 126: Line 119:
</pre>
</pre>


'''''[[#top | Top]]'''''


==== Set new name and password ====
==== Set new name and password ====
Line 145: Line 137:
Type the following into a browser: '''<nowiki>http://your_domain_name/cgi-bin/awstats/awstats.pl</nowiki> '''   
Type the following into a browser: '''<nowiki>http://your_domain_name/cgi-bin/awstats/awstats.pl</nowiki> '''   


'''''[[#top | Top]]'''''


== Conclusion ==
== Conclusion ==
Installing AWStats with this plugin is easy, to view your stats on-line requires minimum of changes.
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].


Related information [[Installing AWStats | How to install AWStats on Uniform Server 3.5-Apollo]]
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].


'''''[[#top | Top]]'''''


----
----