Print...

Migrate Urchin to Angelfish

Angelfish includes two utilities for migrating from Urchin 7 to Angelfish:

configmigration

migrates config settings from Urchin to Angelfish: user accounts, passwords, profiles, filters, log sources

datamigration

migrates report data from Urchin to Angelfish, using the Urchin 7 API

If you have your log files, it's best to only run migrate config information and reprocess the logs in Angelfish.

If your data is stuck in Urchin 7 and you don't have log files, the datamigration utility should be used.

Step 1 - Migrate Configuration information

The configmigration utility is located in the Angelfish installation directory. Please run ./configmigration --help for a full explanation of required and optional flags.

NOTES

The "admin" user account is not moved, since one already exists in Angelfish
Funnel paths are not migrated
Inactive Urchin goals are not migrated

Here's an example command for the configmigration utility:

./configmigration --dir /usr/local/urchin7 --profiles 1,3,6,8,14 --skipsummary

STEP 2 - MIGRATE REPORT DATA

The datamigration utility is also located in the Angelfish installation directory. Please run ./datamigration --help for a full explanation of required and optional flags.

Migrating data from Urchin to Angelfish will take a significant amount of time due to limitations in the Urchin 7 API. The datamigration utility requests data from the Urchin API and recreates a hit for each pageview. Each newly created hit is then processed by Angelfish.

NOTES

Ecommerce/CPC data is not migrated
IT Reports Data is not migrated
Geolocation Data will be different - use of different geographic database.
Average Time on Site will be different. Angelfish calls it "Engagement" and it excludes bounces.
Log tracking data isn't migrated, which means Angelfish might "re-read" a log file again during processing.
Migrated visitor data will have different visitor IDs in Angelfish than in Urchin
Angelfish does not store events.

Here is an example command for the datamigration utility:

./datamigration --startdate 2011-01-01 --enddate 2011-12-31 --apiuser johndoe --apipass itsasecret --apiport 9999

Creation date: 5/18/2022 5:09 PM Updated: 6/10/2022 2:52 PM