These installation notes pertain to installing Urchin 5 on systems running a minimum of Mac OS X 10.2. For older Mac OS X versions please see the general instructions for UNIX-type installations.
The Mac OS X 10.2 installer is a point-and-click package style installer that is downloaded in the form of a disk image. The basic components of the Urchin 5 installation process are:
- Download Urchin and unpack the installation archive
- Double-click the Urchin.mpkg file, which will launch an interactive installation process
The installer will install 3 distinct parts:
- Urchin binaries, utilities, and support files, including an Apache webserver for administration and report delivery
- Urchin StartupItems
- Urchin Preference Pane
Installation Preparation
The Mac OS X installer requires Mac OS X 10.2 or higher. Users of older Mac OS X systems need to use the Mac OS X 10.1.x shell archive installer.
An installing user must be able to authenticate using an account that has administrative privileges on the system since the installer will be installing files in restricted locations.
While installing a dialog will inquire about what disk you want to install on. Currently, it is required that you install on the Startup volume.
Installation Instructions
If you are upgrading an existing installation of Urchin, please consult the Upgrades section of the Documentation Center for relevant details.
If the installation disk image is downloaded to your system via a browser, it will automatically unpack and create an Urchin 5 folder on the desktop. If the installer image is downloaded via ftp or other mechanism, once the disk image is double-clicked, it will uncompress and create the desktop folder. Inside the folder the contents will be as follows:
Urchin.mpkg
Readme.rtf
Install.rtf
License.rtf
uninstall_urchin.sh
Packages folder
Double-click the Urchin.mpkg icon and follow the instructions in the dialog boxes to complete your installation. The dialogs will prompt you
Initial Configuration Using the Administration Interface
The installer will start the Urchin webserver and Task Scheduler daemons and launch a browser to connect you to the Urchin administration interface. 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.
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 5 administration interface where you will be led through a Setup wizard that will set some required initial configuration parameters. At any time in the future you can connect to your Urchin 5 administration interface by using the URL http://yourhost:9999, where yourhost is the DNS hostname for your system.
Managing Urchin 5 Services
The Urchin 5 services can be controlled or monitored by launching the System Preferences and clicking the Urchin icon.
User Access to Reports
Users should use URL http://yourhost:9999, where yourhost is the name of the system where Urchin is installed.
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.