Urchin 6 Installation Walk-through

Once either a MySQL or PostgreSQL database has been installed on the Urchin server, the following will guide you through installing the Urchin 6 software.

1. Make sure you have the database name, username, and password used to setup the MySQL or PostgreSQL database.
2. Unpack the Urchin 6 distribution into a temporary directory:
   
   Linux/FreeBSD
   mkdir /var/tmp/urchintemp
   cd /var/tmp/urchintemp
   tar xzvf urchin6[minor version]_[platform]_installer.tar.gz
   
   
3. Run the Urchin 6 installer:
   
   Linux/FreeBSD
   ./install.sh. Run run completely from the command line, enter ./install.sh -h to see a list of all necessary parameters.
   
   Windows
   Run the MSI installer (urchin[version]_windows_installer.msi) and follow the on-screen instructions.
   
   Note
   If you had a previous version of Urchin 6 installed and want to preserve
   your original configuration, be sure to choose "No" (option 2 in linux) when prompted with "Initialize configuration database during install"
   
   
4. Check the Urchin installation: Point your web browser at http://localhost:[port]. Where [port] is the port you chose
   during installation (default: 9999).

Important Note to FreeBSD Users
FreeBSD has hard-coded the process datasize limit to just 500MB. This is not enough for Urchin to run
due to the size of the geodata that has to be in memory during log processing. The runtime error you
will see is:

ERROR: (8011-323-1057) Failed to allocate memory

To fix this, you will need to increase the system’s default process datasize. To do this, edit the
/boot/loader.conffile and add these lines:

# Increase max process data segment size to 1GB
kern.maxdsiz="1073741824"

You must then reboot. Warning: Be extremely careful when changing system limits. Setting
kern.maxdsize too large may cause your system not to boot. We recommend you read the FreeBSD
documentation before making this change and be sure to asses the potential risks.