Overview
This section only applies to upgrading an existing installation of Urchin 4.1 or higher to a newer Urchin 4 version. These instructions will not apply if you are upgrading from Urchin 3 or if you are upgrading from an Urchin 4.0xx version (i.e. 4.002 through 4.006). The installation instructions differ for Windows and UNIX platforms. Please follow the instructions for your platform below.
Procedure
Windows Installation
Before proceeding with the upgrade, it is recommended that you make a full backup of your existing Urchin installation. You should know the location of your existing Urchin 4 installation and the port number that the webserver is running on, so that you can verify this information during upgrade.
- Doubleclick on the urchin4xxx_win_setup.exe file and follow the instructions in the Welcome and License Agreement dialog screens.
- In the dialog screen labeled Preparing to Upgrade Urchin Installation, the installer will present you with a list showing you the directory location and webserver port number it has determined for your existing installation. It will use these parameters for your upgrade.
- If you decide you don't want to use these installer settings, you may exit the installation by clicking the Cancel button. It is not an option to alter the settings of your current installation during your software upgrade, since the upgrade has to match the previous configuration information stored in your Urchin 4 databases.
- Click the Next button and the installer will proceed with converting your installation to the new version. Your report and configuration data will automatically be preserved during this process.
Your Urchin 4.1 installation is now ready for use. Launch the Urchin Administration interface in a web browser by going to the URL provided when the installer finishes.
UNIX
Before proceeding with the upgrade, it is recommended that you make a full backup of your existing Urchin installation. You'll need to know the location of your Urchin 4 installation. The default location is /usr/local/urchin4.
- Execute the shell archive script (e.g. urchin4104_redhat7x.sh) to expand the installation binaries.
- Run the ./install.sh installer script that was created in the previous step. When prompted for the type of installation, be sure to select u for upgrade. The script will walk you through the rest of the steps necessary to perform an upgrade.
Mac OS X 10.2.x
For the majority of cases the Urchin 4 package installer for Mac OS X systems will automatically detect existing installations and upgrade the Urchin 4 files as needed. You simply follow the same instructions for a new Mac OS X 10.2.x installation to perform an upgrade. The one exception to this standard package installer upgrade procedure is if you previously installed using the shell archive installer but did not install in the default location of /usr/local/urchin4, and are now using the package installer to upgrade. In this case you should take the following steps:
- Backup your entire existing Urchin distribution
- Turn off your existing Urchin services using the urchinctl program (i.e. ./urchinctl stop)
- Install normally using the package installer, but do not do any initial configuration using the admin interface. When the browser launches at the end of the install, simply close the window.
- After the package installer has completed, go to the Urchin Preference Pane in the System Preferences and stop all running Urchin services
- In the new Urchin 4 installation directory, /usr/local/urchin4, rename the data subdirectory to data-saved
- Move the entire data subdirectory from your old Urchin version install directory into /usr/local/urchin4
- In /usr/local/urchin4 update the ownership of the data
subdirectory using the command:
chown -R www:www data - Launch your new Urchin 4 services by using the Urchin preference pane in System Preferences to start the scheduler and webserver
Your old configuration and report data should now be available in your new Urchin installation. Once you have confirmed that the configuration and processing is normal you can remove your old Urchin 4 distribution, as well as the /usr/local/urchin4/data-saved directory.
Sun Cobalt
Before proceeding with the upgrade, it is recommended that you make a full backup of your existing Urchin installation. The Urchin 4 pkg installers for Sun Cobalt systems automatically detect existing installations and upgrade the Urchin 4 files as needed. Simply follow the instructions for a new Sun Cobalt installation to perform an upgrade.