The Community Forums

Interact with an entire community of cPanel & WHM users!
  1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

How to Install Urchin Stat

Discussion in 'General Discussion' started by gopal, Jul 4, 2004.

  1. gopal

    gopal Guest

    * Download the file from

    * And follow the Instruction :-

    Installation Instructions

    The installer archive could be either a .tar.gz or a .sh archive, depending on your OS, and will be labeled with a name that identifies it for your OS type (e.g., urchin5000_redhat9.tar.gz). Copy the archive to any writeable area on your system and depending on your install image type do one of the following:

    * For a shell archive (e.g. simply type the name of the file like so:


    If you get a "Permission Denied" error, then run the command in this fashion:

    sh ./

    * For a .tar.gz image (e.g. urchin5000_redhat9.tar.gz), uncompress and unpack the installation files with the commands:

    gunzip urchin5000_redhat9.tar.gz
    tar xf urchin5000_redhat9.tar

    Once the archive has been unpacked you should have the following files-

    * (the installation script)
    * install.txt (instructions similar to this document)
    * license.txt (legal restrictions, licensing, and purchasing info)
    * inspector (verifies the installed distribution)
    * gunzip (supplied to unpack urchin.tar.gz)
    * urchin.tar.gz (a tarred and compressed Urchin distribution)

    To install simply type:


    and follow the instructions.

    Initial Configuration Using the Administration Interface

    The installation script will start the Urchin webserver and Task Scheduler daemons. Once they are started you can connect to your Urchin administration interface by using the URL http://yourhost:9999, where yourhost is the DNS hostname for your system. If you have changed the default port number from 9999 to some other port during the installation, then you should use that port number in the URL. You will get a login screen. Use these initial login values:

    Username: admin
    Password: urchin

    Upon initial login, the interface will take you to a License Urchin wizard. You should click on "Obtain Demo License". The interface will connect to the licensing server at the Urchin Software Corporation website and walk you through the process. When finished with the license process, you will be returned to the Urchin administration interface where you will be led through a Setup wizard that will set some required initial configuration parameters.

    Managing Urchin 5 Services

    There are 2 daemons, urchind and urchinwebd, that need to be running in order for log processing, reporting, and configuration administration to occur. These daemons are stopped and started by the urchinctl program in the bin subdirectory of your Urchin distribution. To start or stop both daemons, use:

    ./urchinctl start
    ./urchinctl stop

    You can also specify to only start or stop one daemon at a time by using a -w option for the webserver or a -s option for the scheduler. To see all of the available options, execute urchinctl with the -h option.

    Any errors encountered when one of the daemons is launched should be reported on the command line. For the urchinwebd daemon, once you think it is running successfully, you should also check the var/error_log file for any startup problems.

    At install time, the script will create a bootup/shutdown script that you can use in conjunction with your system rc files to cause the Urchin services daemons to be started at boot time and halted at shutdown. The script is named urchin_daemons and is located in the util subdirectory of your Urchin distribution.

    User Access to Reports

    Users should use URL http://yourhost:portnumber, where yourhost is the name of the system where Urchin is installed and portnumber is the port number for the Urchin webserver (9999, unless you specified a different number during installation).

    Advanced Reporting Options

    If you require unique visitor and session tracking, continue with the Visitor Tracking section of the Documentation Library. If you would like to know about processing e-commerce data, please see the E-commerce Module section as well.

Share This Page