AWStats for 5-Nano: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
No edit summary
m (Text replace - "projects/uniformserver" to "projects/miniserver")
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=[http://usuzezyjiza.co.cc UNDER COSTRUCTION, PLEASE SEE THIS POST IN RESERVE COPY]=
<span id="top"></span>
&lt;span id=&quot;top&quot;&gt;&lt;/span&gt;
{| cellpadding="2"
{| cellpadding=&quot;2&quot;
|
|
__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 (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 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 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 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.


'''''[[#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 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.  


'''''[[#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.
    
    
'''''Update Shebang'':'''
'''''Update Shebang'':'''
* Left mouse click UniTray &gt; Mouse over '''Advanced''' and select '''Perl Shebang Update cgi-bin'''
* 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.   


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


== Testing ==
== Testing ==
Testing is straight forward:
Testing is straight forward:
* Start the servers
* Start the servers
* Type the following into a browser '''&lt;nowiki&gt;http://localhost/cgi-bin/awstats/awstats.pl&lt;/nowiki&gt;'''
* 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:


'''&lt;nowiki&gt;http://localhost:82/cgi-bin/awstats/awstats.pl&lt;/nowiki&gt;'''
'''<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.  


'''''[[#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'''


The file contains the following lines:
The file contains the following lines:
&lt;pre&gt;
<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
&lt;/pre&gt;
</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 114: Line 106:


Comment (add hash) these lines as shown: (Allows anyone access)
Comment (add hash) these lines as shown: (Allows anyone access)
&lt;pre&gt;
<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
&lt;/pre&gt;
</pre>
Uncomment (remove hash) these lines as shown: (Enables name/password protection)  
Uncomment (remove hash) these lines as shown: (Enables name/password protection)  
&lt;pre&gt;
<pre>
AuthName &quot;Uniform Server - Server Access&quot;
AuthName "Uniform Server - Server Access"
AuthType Basic
AuthType Basic
AuthUserFile /htpasswd/awstats/.htpasswd
AuthUserFile /htpasswd/awstats/.htpasswd
Require valid-user
Require valid-user
&lt;/pre&gt;
</pre>


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


==== Set new name and password ====
==== Set new name and password ====
Line 135: Line 126:


'''''Default'':''' Contains the following:
'''''Default'':''' Contains the following:
&lt;pre&gt;
<pre>
root:root
root:root
&lt;/pre&gt;
</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:
&lt;pre&gt;
<pre>
new_name:new_password
new_name:new_password
&lt;/pre&gt;
</pre>


==== To view on-line ====
==== To view on-line ====
Type the following into a browser: '''&lt;nowiki&gt;http://your_domain_name/cgi-bin/awstats/awstats.pl&lt;/nowiki&gt; '''   
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]]'''''


----
----

Latest revision as of 16:10, 17 October 2012

UniServer AWStats plugin for Uniform Server 5-Nano series

This plugin installs 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 (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.

Version choice

There are two versions of AWAtats plugin:

V5.0_AWStats_1.0

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 ActivePerl version 5.10.0.1005.

V5.0_AWStats_2.0

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:

  • V5.0_mini_perl ActivePerl 5.10.0.1005
  • V5.0_full_perl ActivePerl 5.10.0.1005
  • V5.1_mini_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 the 5-Nano Perl page for details.


Download and Install

There are two installation options as follows: replace "#" with the version you are installing:

Option 1:

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

Option 2:

  1. Download file V5.0_AWStats_#.0.zip from Sourceforge
  2. Save to any folder (e.g. temp1)
  3. Extract files, navigate to folder V5.0_AWStats_#.0
  4. Copy the entire contents (read_me.txt, usr, www ... etc) 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\cgi-bin\awstats
  • Password file .htpasswd can be found in folder UniServer\htpasswd\awstats
  • Perl bin and lib are added to folder UniServer\usr (If using V5.0_AWStats_1.0)
  • Folder UniServer\www is updated with folders css, icon and js containing support files for AWStats.


Common

Whichever installation option you choose all Perl scripts must have their shebang updated to match current server location.

Update Shebang:

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


Testing

Testing is straight forward:

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

Note:

If you have moved the servers remember to include the port number for example:

http://localhost:82/cgi-bin/awstats/awstats.pl

Use UniTray Server Status to find the Apache port number.


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.

Default Local access only

Local access is implemented using a .htaccess file located in folder UniServer\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.

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 UniServer\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


Set new name and password

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

Edit file UniServer\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


Conclusion

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 web site.