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

From The Uniform Server Wiki
Jump to navigation Jump to search
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric)
(Punctuation and grammatical changes; some clarification.)
Line 5: Line 5:
 
||
 
||
 
|}
 
|}
'''''UniServer AWStats plugin for Uniform Server 4.*-Mona series'''''
+
'''''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.
+
This plugin installs AWStats on The Uniform Server 4-Mona series. AWStats is a free, powerful and fully featured tool that generates advanced web, streaming, ftp or mail server statistics in graphical format.
  
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.
+
The latest version of AWStats (6.8) requires extra Perl modules that are not included in a default installation of The Uniform Server 4-Mona. 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.
 
This page describes how to install the AWStats plugin and provides information for viewing stats on-line.
  
'''''[[#top | Top]]'''''
 
 
== Download and Install ==
 
== Download and Install ==
'''''Options 1'':'''
+
'''''Option 1'':'''
 
# Download file '''UniServer_AWStats_1.0.exe''' from [http://sourceforge.net/project/showfiles.php?group_id=53691&package_id=49448&release_id=677883 Sourceforge]
 
# Download file '''UniServer_AWStats_1.0.exe''' from [http://sourceforge.net/project/showfiles.php?group_id=53691&package_id=49448&release_id=677883 Sourceforge]
 
# Save it to folder '''UniServer'''.
 
# Save it to folder '''UniServer'''.
# To extract files, double click on file UniServer_AWStats_1.0.exe, no need to change the path.
+
# To extract files, double click on file UniServer_AWStats_1.0.exe; no need to change the path.
# If you wish to save space delete UniServer_AWStats_1.0.exe
+
# If you wish to save space, you can delete UniServer_AWStats_1.0.exe
  
'''''Options 2'':'''
+
'''''Option 2'':'''
 
# Download file '''UniServer_AWStats_1.0.zip''' from [http://sourceforge.net/project/showfiles.php?group_id=53691&package_id=49448&release_id=677883 Sourceforge]
 
# Download file '''UniServer_AWStats_1.0.zip''' from [http://sourceforge.net/project/showfiles.php?group_id=53691&package_id=49448&release_id=677883 Sourceforge]
 
# Save to any folder (e.g. '''''temp1''''')
 
# Save to any folder (e.g. '''''temp1''''')
 
# Extract files, navigate to folder UniServer_AWStats_1.0
 
# Extract files, navigate to folder UniServer_AWStats_1.0
# Copy the entire contents (read_me.txt and folder udrive) to Uniform Server's folder  UniServer allow overwrite.   
+
# Copy the entire contents (read_me.txt and folder udrive) to The Uniform Server's folder  UniServer, allowing overwrite.   
# If you wish to save space delete '''''temp1'''''
+
# If you wish to save space, delete '''''temp1'''''
  
 
'''''Folders and files'''''
 
'''''Folders and files'''''
  
The following are added to Uniform Server
+
The following are added to The Uniform Server
  
 
* AWStats is installed in folder UniServer\udrive\cgi-bin\'''awstats'''
 
* AWStats is installed in folder UniServer\udrive\cgi-bin\'''awstats'''
Line 38: Line 37:
 
* Folder \UniServer\udrive\www is updated with folders css, icon and js containing support files for AWStats.  
 
* Folder \UniServer\udrive\www is updated with folders css, icon and js containing support files for AWStats.  
  
'''''[[#top | Top]]'''''
 
  
 
== Testing ==
 
== Testing ==
Line 45: Line 43:
 
* Type the following into a browser '''<nowiki>http://localhost/cgi-bin/awstats/awstats.pl</nowiki>'''
 
* Type the following into a browser '''<nowiki>http://localhost/cgi-bin/awstats/awstats.pl</nowiki>'''
  
'''''[[#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 have 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 \Uniform Server\udrive\cgi-bin\'''awstats'''
 
Local access is implemented using a '''.htaccess''' file located in folder \Uniform Server\udrive\cgi-bin\'''awstats'''
Line 61: Line 59:
 
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 69: Line 66:
 
The above .htaccess file contains additional lines allowing you to password protect folder awstats.
 
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:
+
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)
 
Comment (add hash) these lines as shown: (Allows anyone access)
Line 85: Line 82:
 
</pre>
 
</pre>
  
'''''[[#top | Top]]'''''
 
  
 
==== Set new name and password ====
 
==== Set new name and password ====
The default name and password is '''root''' they are compromised hence need changing as follows:
+
The default name and password is '''root'''.  Since they are compromised they need changing as follows:
  
 
Edit file UniServer\udrive\htpasswd\awstats\'''.htpasswd'''
 
Edit file UniServer\udrive\htpasswd\awstats\'''.htpasswd'''
Line 104: Line 100:
 
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. 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 [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 both customisable. For details, check out AWStats [http://awstats.sourceforge.net/ web site].
  
'''''[[#top | Top]]'''''
 
  
 
----
 
----
  
[[Category: Uniform Server 4.0-Mona]]
+
[[Category: Uniform Server 4-Mona]]
 
[[Category: Plugins]]
 
[[Category: Plugins]]

Revision as of 13:33, 13 December 2011

UniServer AWStats plugin for Uniform Server 4-Mona series

This plugin installs AWStats on The Uniform Server 4-Mona series. AWStats is a free, powerful and fully featured tool that generates advanced web, streaming, ftp or mail server statistics in graphical format.

The latest version of AWStats (6.8) requires extra Perl modules that are not included in a default installation of The Uniform Server 4-Mona. 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.

Download and Install

Option 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, you can delete UniServer_AWStats_1.0.exe

Option 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 The Uniform Server's folder UniServer, allowing overwrite.
  5. If you wish to save space, delete temp1

Folders and files

The following are added to The 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.


Testing

Testing is straight forward:

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


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 have the option to password protect this information.


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.


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


Set new name and password

The default name and password is root. Since they are compromised they 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


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 both customisable. For details, check out AWStats web site.