Update Fedora from version 3.7.0 to version 3.8.1

Prepare and save components of the old installation

• Create a tarball snapshot backup of Fedora, MySQL and Drupal

  # $FEDORA_HOME/tomcat/bin/shutdown.sh
  # /etc/init.d/mysql stop
  # /etc/init.d/apache2 stop
  
  # cd /usr/local 
  # tar -cvzf fedora3.7.0-with-old-data-info-backup.tar.gz fedora
  
  # cd /var/lib 
  # tar -cvzf mysql-with-old-fedora3-info-backup.tar.gz mysql
  
  # cd /var/www
  # tar -cvzf drupal-backup.tar.gz drupal

• Drop and Cleanup the fedora3 database information from the exiting MySQL and recreated it

  # mysql -u root -p
  Enter password:
  
  mysql> drop database fedora3;
  Query OK, 1 row affected (0.00 sec)
  
  mysql> flush privileges;
  mysql> exit
  
  # /usr/local/fedora/server/bin/fedora-rebuild.sh  (first Rebuild SQL database, then Rebuild the Resource Index)
  
  # /etc/init.d/mysql start

• Rename the old Fedora installation location (you'll need components from this path later on)

  # cd /usr/local 
  # mv fedora  fedora3.7.0
  

Fresh installation of Fedora 3.8.1 (with some caveats)

• Read through the Fedora Repository 3.8.1 Release Notes, in particular the references to Java 8, since v3.8.1 will not run under JDK 7.

• Download release 3.8.1 of Fedora (fcrepo-installer-3.8.1.jar)

• Refer to the Installation section on milestone 1 - Installing Fedora, however take note of the steps described on the Upgrading from 3.5+ to 3.8 section of the Fedora wiki for your reference. We'll take a slightly different approach.
• Be sure to Shut down your old 3.7.0 repository

• Proceed to do a "fresh" installation of Fedora 3.8.1, in the usual /usr/local/fedora location, but before starting it, tarball/backup the contents of /usr/local/fedora/ and only then start fedora

  # cd /usr/local 
  # tar -cvzf fedora-3.8.1-fresh-install-not-started fedora 
  # $FEDORA_HOME/tomcat/bin/startup.sh

• Verify that Fedora has successfully started:

$FEDORA_HOME/tomcat/logs/catalina.out should contain no errors.

Troubleshooting:

• • Debugging the dreaded “SEVERE: Error listenerStart”
  • Fedora 3.8.0 fails to start under Tomcat7

• View your Fedora instance through a web browser:

http://localhost:8080/fedora/

or

https://[yourdomain]:8443/fedora

• Continue with the remaining steps in the milestone 1 - Installing Fedora, (XACML Policies, testing, snapshot backup, etc), and all remaining milestones 2 through 6 (Drupal, Drupal Filter, Tuque, Solr and GSearch)

  NOTE: some of your previous Drupal/Islandora contents won't be shown yet, but that is to be expected, since your old fedora3 database and data contents have not been migrated yet, however most of the other normal components of the islandora stack should be in place and working.

Migration of the old components to the new installation

• Time to start the migration phase: replace the new MySQL with the old one, and copy the old fedora data components to the new installation:

  # $FEDORA_HOME/tomcat/bin/shutdown.sh
  # /etc/init.d/mysql stop
  
  # cd /var/lib 
  # mv mysql mysql-with-fresh-fedora3.8.1
  # tar -xvzf mysql-with-old-fedora3-info-backup.tar.gz 
  
  # cd /usr/local/fedora/data/
  # mv datastreamStore datastreamStore.off  
  # mv objectStore objectStore.off
  
  # rsync /usr/local/fedora3.7.0/data/datastreamStore /usr/local/fedora/data
  # rsync /usr/local/fedora3.7.0/data/objectStore /usr/local/fedora/data
  
  # /etc/init.d/mysql start
  # $FEDORA_HOME/tomcat/bin/startup.sh

• Check the newly migrated instance of Fedora 3.8.1 and browse the contents of your old Drupal/Islandora repository

Troubleshooting

• If you can not see the Top-level Collection as you had before shut down your repository and run the Policy Index Rebuilder.

  # $FEDORA_HOME/tomcat/bin/shutdown.sh
  # /etc/init.d/mysql stop
  
  # /usr/local/fedora/server/bin/fedora-rebuild.sh  (first Rebuild SQL database, then Rebuild the Resource Index)
  
  # /etc/init.d/mysql start
  # $FEDORA_HOME/tomcat/bin/startup.sh
  
  

• Check for more details on the Fedora 3.8 Documentation