Installation Guide (Windows)

The installer is an executable which guides you through all the steps necessary to install Urchin. The basic components of the Urchin 5 installation process are:

  • Creating the distribution directory and unpacking the files
  • Installing and starting an Apache webserver as an NT service to allow web based configuration and report delivery
  • Installing and launching the Urchin task scheduler which manages log processing jobs as an NT service
  • Initial configuration and demo licensing of Urchin via the administration interface

Installation Preparation

You must be logged in as Administrator on the console of your system in order to install Urchin. By default the Urchin webserver service will use port 9999 when it launches. You will have the option of choosing a different port number during installation. Please verify that any port you choose does not conflict with existing operational services on your system.

You will need access to the Internet from your machine. Internet access is required to complete the demo licensing and activate your Urchin distribution once it is installed.

Installation Instructions

If you are upgrading an existing installation of Urchin, please consult the Upgrades section of the Documentation Center for relevant details.

Double click on the urchin5XXX_win_setup.exe (e.g. urchin5000_win_setup.exe) icon to launch the installer, and follow the instructions in the dialog screens.

Initial Configuration Using the Administration Interface

Once Urchin is installed you can connect to your Urchin administration interface by going to the Start Menu, and selecting Programs->Urchin->Urchin Administration. Alternatively, you can enter the direct URL

http://localhost:port_number

into your browser, where port_number is either 9999 or a number you may have chosen during the installation. Wen you initially connect to the configuration interface, you will be presented with 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.

Remote Access Configuration

If you connect to the Urchin configuration interface by using the hostname in the URL (e.g. http://yourhost:9999 instead of http://localhost:9999) the program will detect this as a remote access (even if you are on the console of the machine you're connecting to) and will prompt you for a username and password. The default settings for logging in with administration privileges are:

Username: admin
Password: urchin

Managing Urchin Services

There are two programs that are installed as NT services, the Urchin Task Scheduler and the Urchin Webserver. These services may be manually stopped and started by using the Disable Services and Enable Services shortcuts under Start Menu->Programs->Urchin. When these shortcuts are used both services are simultaneously turned off or on.

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.