Urchin 4 Web Analytics software provides detailed metrics about a website's visitor activity. It is essential for anyone interested in the marketing, design or success of a website. Urchin 4 is 100% browser-based admin system allowing to easily manage user access levels, groups, and affiliations. It produces usage reports in HTML format for viewing with a standard web browser, reporting for up to 100 sites included in base license (comparing to 25 for Urchin 3). It reports in 10 languages with all reports generated on-the-fly and exportable to Excel or other formats. Read more about Urchin 4 at www.urchin.com.

IMPORTANT NOTES:
- Urchin3 and Urchin4 are independent and non-interchangeable resources. Make sure you don't confuse them.
- Urchin Lisence Manager is to be used only for Urchin3. New Urchin4 is managed without it.
- H-Sphere has no migration tool to move statistics between Urchin3 and Urchin4. For migration use standard utilities provided by Urchin.

To install Urchin 4 on Unix-type systems, do the following:

1. Go to www.urchin.com and click the Download link.
2. 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.
3. 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.
4. 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.
5. 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).
6. Create directory /hsphere/local/urchin/var/logs by running:
   mkdir /hsphere/local/urchin/var/logs
7. Set directory owner the same as for Urchin on step 3:
   chown nobody:nobody /hsphere/local/urchin/var/logs
Important: Make steps 8-10 on all webboxes.

8. 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)
9. Create file loglist in the same directory:
   touch loglist
10. Change httpd owner by running:
    chown httpd:httpd loglist
11. In the hsphere.properties file configure the following variables:
    URCHIN_SERVER_ID = 1
    URCHIN_PORT = 9999
    Where:
    URCHIN_SERVER_ID is ID of a logical server where Urchin4 is installed;
    URCHIN_PORT is a port where Urchin 4 is installed
12. Restart HSphere for changes to take effect.

Notes: Urchin 4 can be installed on any logical server. The given instruction tells how to install Urchin4 on the Unix servers.