GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

VPS v2: Urchin: Web Log Analyzer

bullet Introduction
Urchin

The Urchin Web Log Analyzer is an efficient, fast, and easy to use web log analysis and reporting tool. Urchin installs directly on your Virtual Private Server and creates HTML-based graphical reports of your web server traffic. It offers several special features such as multi-language reporting, E-commerce log reporting, and up to 24 Virtual Subhosts (plus your primary host). Urchin also features a special domain-lookup utility which resolves IP addresses into domains without creating a load on your server.

NOTE: Urchin is available on the VPS platform only. Due to licensing restrictions, Urchin should not be installed on the MPS platform.

 

bullet Installation

Connect to your Virtual Private Server via SSH, su to root, and run the following command:

# vinstall urchin

 

bullet Usage

Urchin has already been compiled and configured for your Virtual Private Server, including up to 25 Virtual Subhosts with log files. Since Urchin should not be run on the same log files more than once, it is set up to automatically archive your log files when it runs. It does this by renaming the log files, but does not delete or compress them. You can either Rotate the Log Files separately, or use the Urchin configuration file to configure alternate methods of archiving log files.

To run Urchin and create your first report type the following while connected to your Virtual Private Server via SSH:

# /usr/local/urchin/urchin

This will create your reports at the following location:

http://YOUR-DOMAIN.NAME/urchin/YOUR-DOMAIN.NAME

You can also see a system report for the entire Virtual Private Server by viewing this URL:

http://YOUR-DOMAIN.NAME/urchin/system/

You can configure your VPS to run Urchin automatically. The following is an example of a Cron entry that will run Urchin at 11:50 PM every Sunday night:

50 23 * * 0 /usr/local/urchin/urchin

When Urchin runs, it generates a report of its activity. If you want to keep a log file of Urchin's activity, you can redirect the report to a file on your server by using the following cron entry:

50 23 * * 0 /usr/local/urchin/urchin >> /var/log/urchin 2>&1

 

bullet Documentation

See the Urchin Virtual Server Support site for more documentation.


Toll Free 1-866-GSP-4400 • 1-301-464-9363 • service@gsp.com
Copyright © 1994-2016 GSP Services, Inc.