Quickstart Installation Guide

This Quickstart article is for first time installers of Urchin. If you have an existing installation, read the Upgrades section.

When you have completed the installation steps, login to the Urchin administration interface to perform configuration. The initial username and password are:

Username: admin
Password: urchin

Reset the password during your initial configuration in the Setup Wizard.

If you require unique visitor and session tracking, complete the steps in this Quickstart Guide and continue with the UTM Quick-Install article in the Visitor Tracking section.

Installing on Windows Systems

  • Go to www.urchin.com and click the Download link.
  • Download the Urchin for Windows installer to your desktop.
  • Once the download has completed, double-click the installer file to start the InstallShield® wizard.
  • Follow the on-screen instructions. The defaults should be acceptable for most installations.
  • Once the installer has completed, go to Start -> Programs -> Urchin -> Urchin Administration and login. You will get a License Urchin screen. 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.
  • Once licensing is completed you will be presented with a Setup Wizard. Follow the instructions to complete your initial configuration. Please make sure to reset the password for the admin account and to record this password somewhere for safekeeping.
  • When the Setup Wizard has completed you'll be taken to the Profile configuration screen. Click Add to create a new Profile.
  • Once you have created the appropriate Profiles, you're ready to start processing logs so that you can view Report data for your sites. To access the administration interface remotely or for users to see their individual reports, use the URL http://yourhost:9999, where yourhost should be replaced by the name of the system where Urchin is installed.

Installing on UNIX-type Systems

  • Go to www.urchin.com and click the Download link.
  • Select the installer for the OS type that most closely matches your platform. The name of the installer image will include the Urchin version and the operating system type (e.g. urchin5000_freebsd4x.sh, urchin5000_redhat9.tar.gz)
  • If necessary, upload the installer to a temporary location on the system on which you are installing Urchin.
  • If you are not on the system's console, telnet (or use ssh if available) to the system and cd to the directory where the installer is located.
  • Installers will have either a .sh or a .tar.gz suffix. Depending on the type of installer you will do one of the following:
    • For a shell archive (e.g. urchin5000_freebsd4x.sh) simply type the name of the file like so:

      ./urchin5000_freebsd4x.sh.

      This will unpack several files that comprise the installation kit.

    • 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

  • 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.
  • When the installer has finished, you will be given the URL to access the Urchin administration interface, as well as the default admin password.
  • Copy/paste the URL into a browser window, and enter the admin username and password to start configuring Urchin. You will get a License Urchin screen. 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.
  • Once licensing is completed you will be presented with a Setup Wizard. Follow the instructions to complete your initial configuration. Please make sure to reset the password for the admin account and to record this password somewhere for safekeeping.
  • When the Setup Wizard has completed you'll be taken to the Profile configuration screen. Click Add to create a new Profile.
  • Once you have created the appropriate Profiles, you're ready to start processing logs so that you can view Report data for your sites. To access the administration interface remotely or for users to see their individual reports, use the URL http://yourhost:9999, where yourhost should be replaced by the name of the system where Urchin is installed.

Installing on Mac OS X 10.2.x Systems

  • Go to www.urchin.com and click the Download link
  • Download the Urchin installation archive for Mac OS X 10.2.x
  • If the installer is downloaded directly via a browser to the system where it will be installed, an Urchin 5 folder will automatically be created on the desktop. If downloaded via some other mechanism such as ftp, double-clicking the installation archive icon which will unpack the archive and create the desktop folder.
  • Open the Urchin 5 folder, and double-click the Urchin.mpkg file, which will launch an interactive installation process. It's required that you are using an account with administration privileges to install.
  • At the end of the installation a browser will launch and take you to the Urchin administration screen. You will get a License Urchin screen. 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.
  • Once licensing is completed you will be presented with a Setup Wizard. Follow the instructions to complete your initial configuration. Please make sure to reset the password for the admin account and to record this password somewhere for safekeeping.
  • When the Setup Wizard has completed you'll be taken to the Profile configuration screen. Click Add to create a new Profile.
  • Once you have created the appropriate Profiles, you're ready to start processing logs so that you can view Report data for your sites. To access the administration interface remotely or for users to see their individual reports, use the URL http://yourhost:9999, where yourhost should be replaced by the name of the system where Urchin is installed.

Installing on Sun Cobalt Systems

  • Use a web browser from your desktop system to connect to http://www.urchin.com/download/urchin5
  • On the download page select the installer that most closely matches your platform. The name of the installer will include the Urchin version and the Sun Cobalt system type. For example:

    urchinc-5.0.00_cobalt_raq550.i386.pkg

  • Save the .pkg file to your desktop or to a temporary folder
  • Using your browser connect to the main Site Administrator's page for your Cobalt box
  • Navigate to the section of the interface for installing new third party software. The location of this area in the Cobalt interface will be platform specific:
    • Raq 3, RaQ 4 - click on Maintenance in the left hand frame, then click Install Software in the top row
    • Qube 3, RaQ 550 - click on the BlueLinQ tab, then click Third Party Software, then click the Install Manually button
    • XTR - click on the BlueLinQ tab, then click New Software, then click the Install Manually button
  • Prepare and launch the package installer:
    • RaQ 3, RaQ 4 - In the Software Package box select the Upload radio button, then click the Browse button to the right and navigate to the location on your desktop system where you saved the .pkg file you downloaded. Once you click the Open button in the browse window, the pkg filename will be entered into the Upload text box. Then click the "Install a pkg Package" button. When the installation is finished an Urchin link will appear in the lower box for installed software.
    • Qube 3, XTR, RaQ 550 - In the Location box select the Upload radio button, then click the Browse button to the right and navigate to the location on your desktop system where you saved the .pkg file you downloaded. Once you click the Open button in the browse window, the pkg filename will be entered into the Upload text box. Then click the Prepare button. Once the package has been prepared, an Install Software window will appear. In this window click the Install button. When the installation is finished Urchin 5 will be listed under the Programs tab.
  • Click on the Urchin link in your Cobalt administration interface and the Urchin admininstration login window will appear. Enter the admin username and password to start configuring Urchin. You will get a License Urchin screen. 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.
  • Once licensing is completed you will be presented with the Setup Wizard. Follow the instructions to complete your initial configuration. Please make sure to reset the password for the admin account and to record this password somewhere for safekeeping.
  • When the Setup Wizard has completed you'll be taken to the Profile configuration screen. Click Add to create a new Profile.
  • Once you have created the appropriate Profiles, you're ready to start processing logs so that you can view Report data for your sites. To access the administration interface remotely or for users to see their individual reports, use the URL http://yourhost:9999, where yourhost should be replaced by the name of the system where Urchin is installed.