Overview
The installer is in the form of an executable, which when launched will guide you through all the steps necessary to install Urchin. The basic components of the Urchin 4 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 4 task scheduler which manages log processing jobs as an NT service
- Initial configuration and demo licensing of Urchin 4 via the administration interface
Installation Preparation
It is currently required that you be logged in as Administrator on the console of your system in order to install Urchin 4. 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, which is required to complete the demo licensing and activate your Urchin distribution once it is installed.
Installation and Upgrade Instructions
Simply double click on the urchin4XXX_win_setup.exe (e.g. urchin4100_win_setup.exe) icon to launch the installer, and follow the instructions in the dialog screens. If you already have a previous version of Urchin installed, the installer should detect this and examine your current configuration to deduce the appropriate installation parameters for an upgrade.
Initial Configuration Using the Administration Interface
Once Urchin is installed you can connect to your Urchin 4 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. When 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 4 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 4 Services
There are 2 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
For users to see their individual reports, they should use the URL http://yourhost:9999, where yourhost should be replaced by the name of the system where Urchin is installed. If, during installation, you have chosen some other port number than the default of 9999 for the Urchin webserver to run on, then that number should be used instead.