487
edits
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 ( | 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 | 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 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. | ||
== 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 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. | ||
=== 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. | ||
== 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. | ||
== 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''' | ||
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. | ||
=== View Stats on-line === | === View Stats on-line === | ||
Line 126: | Line 119: | ||
</pre> | </pre> | ||
==== 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> ''' | ||
== 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]. | |||
---- | ---- |