Supported Servers
Urchin 4 can be installed on any H-Sphere *nix server. It doesn't require any special configuration and, once installed, can poll statistics from all web servers and winboxes. To support Urchin 4, H-Sphere winboxes must be no older than 2.3.1.
Compatibility With Urchin 3
Urchin 3 and Urchin 4 are not interchangeable. H-Sphere has no migration tool to move statistics between Urchin 3 and Urchin 4. For migration, use standard utilities provided by Urchin.
If you don't use Urchin 3 on some web servers, we recommend
that you disable it in Global Resources.
Urchin Lisence Manager is to be used only for Urchin 3.
Urchin 4 is managed without it.
Installation Procedure
To install Urchin 4 on Unix-type systems, do the following:
- Go to www.urchin.com and click the Download link.
- Select the installer that most closely matches your
platform. The name of the
installer will include the Urchin version and the operating
system type (e.g.
urchin4100_redhat6x.sh).
Note: If necessary, upload the installer to a temporary location on the system on which you are installing Urchin. If you are not on the console, telnet (or use ssh if available) to the system and cd to the directory where the installer is located. - From the command line type in the name of the installer.
For example:
./urchin4100_redhat7x.sh
This will unpack several files that comprise the installation kit. - From the command line execute the main installation
script by typing:
./install.sh
The script will prompt you for input as needed; just follow the instructions. - Following the instructions of the manual, configure
Urchin4 in the directory:
/hsphere/local/urchin
Note: Urchin port and owner can be set by default (9999, nobody). - Create directory /hsphere/local/urchin/var/logs
by running:
mkdir /hsphere/local/urchin/var/logs - Set directory owner the same as for Urchin on step 5:
chown nobody:nobody /hsphere/local/urchin/var/logs
Important: Make steps 8-10 on all webboxes. - Copy script print-log.pl from /hsphere/shared/scripts to the main directory cgi-bin (it should be configured in httpd.conf in tag ScriptAlias)
- Create file loglist in the same cgi-bin directory:
touch loglist - Change httpd owner by running:
chown httpd:httpd loglist - In the hsphere.properties file configure the following
variables:
URCHIN_SERVER_ID = 1
URCHIN_PORT = 9999
URCHIN_SCHEDULER_START = 2
URCHIN_SCHEDULER_FINISH = 4
URCHIN_PROTOCOL = https
Where:
URCHIN_SERVER_ID is ID of a logical server where Urchin4 is installed;
URCHIN_PORT is a port where Urchin 4 is installed;
URCHIN_SCHEDULER_START and
URCHIN_SCHEDULER_FINISH variables set the period of
time when statistics can be collected. e.g: between 2 and 4
o'clock; - Restart HSphere for changes to take effect.
URCHIN_PROTOCOL sets a protocol to connect to the Urchin control panel.