If you have an existing SEEK installation, and you haven’t done so already, please take a moment to fill out our very short,optional SEEK Registration Form. Doing so will be very useful to us in the future when we try and raise further funding to develop and support SEEK and the associated tools.
Always backup your SEEK data before starting to upgrade!! - see the Backup Guide.
This guide assumes that SEEK has been installed following the Installation Guide guide. It assumes it is a production server that is being updated, and that commands are run from the root directory of the SEEK application.
Identifying your version
The version of SEEK you are running is shown at the bottom left, within the footer, when viewing pages in SEEK.
You can also tell which version you have installed by looking at the config/version.yml file, so for example version 0.13.2 looks something like:
major: 0 minor: 13 patch: 2
Upgrading between patch versions (e.g. between 1.4.0 and 1.4.1)
It should only be necessary to run bundle install and the db:migrate rake task. Using seek:upgrade should still work, but could take a lot of unnecessary time.
Steps to upgrade from 1.5.x to 1.6.x
This version requires at least Java 8. Please make sure this is installed by trying:
which should report java version 1.8.0 or greater. If not, install with:
sudo apt install openjdk-8-jdk java --version
if this still doesn’t report the correct version you may need to do:
sudo update-alternatives --config java
.. and select the java-8 version
You can also use the Oracle version of Java 8. This can be easily installed with Apt, through the Oracle PPA
If upgrading a production instance of SEEK, remember to set the RAILS_ENV first
Stopping services before upgrading
bundle exec rake seek:workers:stop bundle exec rake sunspot:solr:stop
Updating from GitHub
If you have an existing installation linked to our GitHub, you can fetch the files with:
git pull git checkout v1.6.1
Updating using the tarball
You can download the file from https://bitbucket.org/fairdom/seek/downloads/seek-1.6.1.tar.gz You can unpack this file using:
tar zxvf seek-1.6.1.tar.gz mv seek seek-previous mv seek-1.6.1 seek cd seek/
and then copy across your existing filestore and database configuration file from your previous installation and continue with the upgrade steps. The database configuration file you would need to copy is config/database.yml, and the filestore is simply filestore/
If you have a modified config/sunspot.yml you will also need to copy that across.
Doing the upgrade
After updating the files, the following steps will update the database, gems, and other necessary changes. Note that seek:upgrade may take longer than usual if you have data stored that points to remote content.
cd . #this is to allow RVM to pick up the ruby and gemset changes gem install bundler bundle install --deployment bundle exec rake seek:upgrade bundle exec rake assets:precompile # this task will take a while
bundle exec rake sunspot:solr:start bundle exec rake seek:workers:start
Earlier upgrade notes
For details of how to upgrade between earlier versions please visit Upgrades between earlier versions