Migration/Upgrade

Initial remarks

This is the very first installment of the documentation on this subject, so please bare with us, and please submit your comments or suggestions as you perform your own upgrades or migrations.

Introduction

The general idea is to treat a full migration as a series of controlled updates. In another words, upgrade or replace components of the Islandora Minimum Viable Functionality within the context of each milestone, and use its test mechanism to ensure the upgrade works.

• For instance, the most frequent releases come from Drupal (as of this writing release 7.36). That would be milestone 2. Once you perform the Drupal upgrade test that milestone by itself and all subsequent milestones, keeping every other component of the stack unchanged. So, before starting the process be sure to do a tarball snapshot backup of Fedora, MySQL and Drupal.
• The next most frequent release upgrade is Islandora itself (in this case version 7.x-1.5), and for most cases it's backward compatible with older versions of Fedora (3.5, 3.6.2, 3.7.0, 3.8.0). That would be milestone 5 onwards. So again, before starting the process be sure to do a tarball snapshot backup of Fedora, MySQL and Drupal. Then proceed to the upgrade and testing of milestones 5 and 6.
• The least frequent new releases are that of Fedora Commons (as of this writing release 3.80), and since it's the most basic of all components of the solution stack it could be a little trickier, since it entails a true migration from the previous information on the MySQL database. Again, before starting the process be sure to do a tarball snapshot backup of Fedora, MySQL and Drupal, Then proceed to milestone 1 installation and testing, leaving all other components above alone. After that move on to "fix" any outstanding issues with subsequent milestones, in the normal order.

Update Drupal from version 7.31 to version 7.36

• download version 7.36
  
  • drupal-7.36.tar.gz
  • drupal-7.36.zip
• Create tarball snapshot backup of Fedora, MySQL and Drupal

# $FEDORA_HOME/tomcat/bin/shutdown.sh
# /etc/init.d/mysql stop
# /etc/init.d/apache stop

# cd /var/www
# tar -cvzf drupal-7.31-backup.tar.gz drupal

• install drupal 7.36 (check milestone 2 - Installing Drupal for more details)

  # mv drupal drupal-7.31-old
  # unzip drupal-7.36.zip
  # mv drupal-7.36.zip drupal
  # cd drupal-7.31-old
  # rsync -va sites /var/www/drupal
  # rsync -va libraries /var/www/drupal
  # rsync -va jwplayer /var/www/drupal
  # rsync -va php /var/www/drupal
  
  # /etc/init.d/mysql start
  # $FEDORA_HOME/tomcat/bin/startup.sh
  # /etc/init.d/apache start