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

bullet Introduction

The default installation of Urchin is configured for your main host and any subhosts listed in your httpd.conf file (whether or not they have separate log files). There are, however, several changes you can make to the default configuration to suit your personal needs.

 

bullet Urchin Configuration File

The primary configuration file for Urchin is in your ~/usr/local/urchin/ directory and is named config. The format of the config file is similar to your apache httpd.conf file, and contains instructions on what the listed directives mean. You can use the urchin configuration file to set up automatic logfile rotation, DNS resolution , and reporting styles. The file also contains important license information.

NOTE: Do not edit the license information in your urchin configuration file. If the license information is changed, it can cause the program to stop functioning

The LogDestiny directive is used to determine whether Urchin should archive, delete, or leave logfiles alone.

The second section of the urchin configuration file contains the individual report settings. There must be a Report configured for each domain you want Urchin reporting done. The default install sets up a report for each of the hosts listed in your httpd.conf file, and configures the reports to be stored in the urchin directory off the host's DocumentRoot directory.

The following is an example of what a Report configuration should look like:

<Report>
ReportName: YOUR-DOMAIN.NAME
ReportDirectory: /usr/local/LOGIN/usr/local/etc/httpd/vhosts/YOUR-DOMAIN.NAME/htdocs/urchin/
TransferLog: /usr/local/LOGIN/usr/local/etc/httpd/vhosts/YOUR-DOMAIN.NAME/logs/access_log
ErrorLog: /usr/local/LOGIN/usr/local/etc/httpd/vhosts/YOUR-DOMAIN.NAME/logs/error_log
</Report>

NOTE: Each directive should be on a single line in the config file.

NOTE: Urchin requires CGI execution to be enabled in the report directory. If you don't want your subhosts to be able to run their own CGIs, you may want to locate their report directory outside their Document Root so they can not add scripts to that directory

 

bullet Urchin Settings in the httpd.conf file

The default installation of Urchin will add Directory configurations for the locations where urchin reports will be located. If you make changes to any reports in the urchin configuration file, you need to make sure that the appropriate changes are also made in the httpd.conf file also.

Urchin requires that CGI execution be enabled in the directories where reports are located, and that symbolic links are followed by the web server so that the program files only have to be in one place on your virtual server. These settings are configured inside specific Directory configuration directives in the httpd.conf file. The Directory settings should look something like this:

<Directory /usr/local/etc/httpd/htdocs/urchin/YOUR-DOMAIN.NAME>
AddHandler cgi-script .cgi
DirectoryIndex index.html index.cgi
Options FollowSymLinks ExecCGI</Directory>

The only part of the directory settings that you would normally need to change is the path indicated in the opening tag. If you change any of the other settings, it is possible that Urchin will not work properly.


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