This documentation refers to an earlier version of Islandora. https://wiki.duraspace.org/display/ISLANDORA/Start is current.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Next »

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. 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). This is 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

  • Create tarball snapshot backup of MySQL and Drupal

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

# cd /var/lib 
# tar -cvzf mysql-backup.tar.gz mysql
# 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

  • Access the Reports menu of your Islandora site, and proceed to do any further updates it may require. http://localhost/node#overlay=admin/reports

  • Test the updated modules (check the test section of the milestone 2 - Installing Drupal for more details)

  • Create a new milestone 2 snapshot backup of your site:

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

# cd /usr/local 
# tar -cvzf fedora-milestone2.tar.gz fedora

# cd /var/lib 
# tar -cvzf mysql-milestone2.tar.gz mysql

# cd /var/www
# tar -cvzf drupal-milestone2.tar.gz drupal

# /etc/init.d/mysql start
# $FEDORA_HOME/tomcat/bin/startup.sh
# /etc/init.d/apache start

     

     

Update Islandora from version 7.x-1.3 to version 7.x-1.5

  • Create tarball snapshot backup of MySQL and Drupal

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

# cd /var/lib 
# tar -cvzf mysql-backup.tar.gz mysql
# cd /var/www
# tar -cvzf drupal-7.31-backup.tar.gz drupal
 
# /etc/init.d/mysql start
# $FEDORA_HOME/tomcat/bin/startup.sh
# /etc/init.d/apache start
  • Access the Modules section of Drupal and take note of all Islandora modules, solutions packs and libraries that are loaded. You could just as well make a recursive list of the contents of /var/www/sites
  • Return to the Modules section of Drupal and disable all Islandora modules, solutions packs and libraries that are loaded. You may have to do this in 5 or 6 rounds, until you are able to disable the Islandora core module, and save the configuration.
  • Then download and install version 7.x-1.5 of the Essential Modules, as described on the milestone 5 - Installing the Islandora Essential Modules section. Make sure to replace each and all four Essential Modules with the new versions in /var/www/sites/all/module (you may want to save the old module with a new name and recreate a new one)
  • Proceed enable and test the four Essential Modules, and install any dependencies as required.
  • At this stage, if all tests are a pass, you should already be able to see all your collections from before listed at the Top-level, even though you may not be able to access them yet.
  • Now proceed  to install all the remaining Enhancement Modules and dependencies as you had still on version 7.x-1.3. Use the Installing the Islandora Enhancement Modules section as a reference
  • Proceed enable and test the Enhancement Modules, and install any dependencies as required.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  • No labels

For more information please visit https://islandora.ca