This documentation is a work in progress.
Prepare R6 for migration
This migration requires:
- An R6 instance be stood up and run concurrently with an existing R5 instance.
- The R5 fedora needs to be made accessible to the server running the R6 instance. (See the fedora migration step below.)
- The R6 instance is empty. Run wipeout rake task to clean out R6 database, solr, and fedora.
Dump R5 database
Data from your R5 database will be loaded directly into your R6 database then migrated for R6 in a later step. Role_map data will be needed in R6 for the Fedora migrate step, so it needs to be imported first.
Load to R6 database
SSH into your R6 box and load the R5 database dump.
If you are a developer wanting to test your migration on sqlite locally...
Sqllite3 doesn't like mysql dump files so a transformation script needs to be run on it. Download https://raw.githubusercontent.com/dumblob/mysql2sqlite/master/mysql2sqlite, make it executable, and run it on the dump file.
".read" returns "memory", which is good.
Clear role_map cache (TODO: fix me)
Rails won't use your newly imported role_map data unless you clear it from cache.
Add users to administrator group as necessary (TODO: is this necessary?)
Migrate Fedora Objects
SSH tunnel or open up your fedora3 server to your new Avalon app:
keep the ssh mirror running in another tab as you do the next steps.
Setup config/fedora3.yml in your Avalon 6 app
The fedora3.yml should work without change, but if you do have trouble, here's an example fedora3.yml for the avalon demo server.
Run the migration! You can watch it run on your target avalon by going to <your avalon url>/admin/migration_report .
After this command is finished, look through the report and see which items have failed and troubleshoot using the errors listed.
Migrate Database Tables
Delete Failed Bookmarks