Overview
Please read and understand all these instructions first before proceeding with your migration from Urchin 3 to Urchin 5 on Sun Cobalt systems. The recommended way to upgrade on Sun Cobalt is to start with a fresh installation of Urchin 5 which has not gone through any configuration other than the having the initial Setup Wizard run. You should not manually configure any Profiles, Log Sources, Users, etc. after installing. The migration utilities will create these as needed while importing your Urchin 3 data.
The basic steps in upgrading a Sun Cobalt system are:
- Backup your entire Urchin 3 distribution
- Deactivate Urchin 3 log processing
- Install Urchin 5, connect to the administration interface and run the Setup Wizard
- Run u3importer to import Urchin 3 report configurations as Urchin 5 profiles and convert Urchin 3 data to Urchin 5 format
- Download and run the u5_cobalt_import.pl script to import other Urchin 3 for Cobalt config settings, such as Customers and Users, into your Urchin 5 configuration
- Schedule tasks to process logs for each newly created Profile
You will have to telnet or ssh into your Cobalt system as root to perform some of these instructions. You should keep a terminal window open so that you can move back and forth from the command line to the graphical interfaces as necessary.
1. Backup Urchin 3 distribution - this is suggested strictly as a standard precaution. The process of importing your Urchin 3 data into Urchin 5 does not alter your Urchin 3 installation.
2. Deactivate Urchin 3 log processing - on Cobalt systems this requires that you move 2 scripts that manage the daily execution of Urchin. On the command line in your terminal window execute these commands:
mv /etc/cron.daily/urchin /home/urchin3da/admin/bin
mv /etc/cron.daily/urchin_purge_weblogs /home/urchin3da/admin/bin
3. Install Urchin 5 following the instructions for Sun Cobalt in the Installation section of this guide, and run the Setup Wizard to do the initial configuration. Important: in the Admin Settings screen of the Setup Wizard, you must set Data Center Mode to On.
4. Run u3importer - this program, located in the util subdirectory of your Urchin 5 installation, will prompt you to import report directives from your Urchin 3 config file. When prompted for the location of your config file path, enter
/home/urchin3da/config
Subsequently you will see additional prompts that say
Import Urchin 3 Configurations
and then
Import Urchin 3 Data
Just hit the return key to accept the default response of all for these last two steps. When u3importer has finished you should verify that correct Profiles were created by examining the configuration via the Urchin administration interface.
5. Download and run u5_cobalt_import.pl - since u3importer only deals with importing Urchin 3 databases and creating Urchin 5 Profiles for your existing Urchin 3 reports, other configuration info that is specific to Cobalt installations has to be imported separately using this tool. You can download u5_cobalt_import.pl from ftp://ftp.urchin.com/urchin5/support. Put this script in the /home/urchin/util directory on your Cobalt system. Then in your terminal window execute the program like so:
./u5_cobalt_import.pl
The script will prompt you for input as needed. When the script has finished, the configuration import portion of the migration process will be complete.
6. Schedule tasks to process logs for the Urchin 5 profiles - when
you
import Urchin 3 data using u3importer, a task is created in the
Scheduler
for each Profile, but the scheduled time to run is not set. You can
either
set each schedule manually via the Urchin 5 administration interface,
or use the
uconf-schedule utility to set all tasks
simultaneously.