v1.5.0

GW ScholarSpace v1.5.0 completes the Fedora migration from LevelDB to PostgreSQL in the next release. This release make Shibboleth authentication an optional configuration setting. Additionally this release further documents upgrade steps and technical architecture of GW ScholarSpace

• Write deployment steps for upgrades (#208)
• Add technical info about GW ScholarSpace software (#168)
• Make shibboleth authentication option config (#229)
• Migrate Fedora from levelDB to postgresql (#206)

GW ScholarSpace application migration:

• Pull the latest milestone

  % git fetch
  % git pull origin
  % git checkout v1.5.0
  

• If this is an environment which should have Shibboleth enabled (such as production), enable Shibboleth in the appropriate environment file (ie: config/environments/production.rb):

  config.shibboleth = true
  

• Restart the application.

Fedora Migration Steps:

• Create a backup of the Fedora repository

  % mkdir /opt/fedora_backups
  % chown -R tomcat7:tomcat7 /opt/fedora_backups
  % curl -X POST -u <FedoraUsername>:<FedoraPassword> --data "/opt/fedora_backups" yourserver.com/fcrepo/rest/fcr:backup
  

  Confirm a backup exists in /opt/fedora_backups/

• Stop Tomcat

  % sudo service tomcat7 stop
  

• Move the contents of /opt/fedora

  % mkdir /opt/fedora_leveldb
  % mv /opt/fedora/* /opt/fedora_leveldb
  

• Create a postgresSQL database user for Fedora

  % sudo su - postgres
  (postgres)% psql
  postgres=# create user YOURDBUSERNAME with createdb password 'YOURDBPASSWORD';
  

• Create a postgresSQL database for Fedora

  postgres=# \q
  (postgres)% createdb -O YOURDBUSERNAME ispn
  (postgres)% exit
  

  Note the database name for Fedora must be 'ispn'

• Create a Fedora settings folder

  % sudo mkdir /etc/fcrepo
  % sudo chmod -R 774 /etc/fcrepo
  % sudo chown -R tomcat7:tomcat7 /etc/fcrepo
  

• Copy the infinispan.xml file from the repo

  % cp infinispan.xml /etc/fcrepo/infinispan.xml
  

  Edit this file with your database username and database password

• Copy the tomcat7 file from the repo
  % cp tomcat7 /etc/defaults/tomcat7

• Start Tomcat/Fedora

  % sudo service tomcat7 start
  

• Restore the Fedora Backup

  % curl -X POST -u <FedoraUsername>:<FedoraPassword> --data "/opt/fedora_backups" yourserver.com/fcrepo/rest/fcr:restore
  

• Log into the Fedora web UI and verify the Fedora repository has restored successfully.

v1.4.0...v1.5.0