Versions Compared

Old Version 40

changes.mady.by.user astuart4@ed.ac.uk

Saved on

compared with

New Version 41

changes.mady.by.user shopkins@ed.ac.uk

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reordered first 3 bullet points and corrected ref to another.

...

These instructions are for upgrading a currently operational version 2.x Shibboleth IdP. See Upgrade from 1.3 to 2.x for strategies for upgrading from version 1.x software.

  1. Stop your IdP (or stop the servlet container, eg. Tomcat), and stop Apache httpd too, if you're using itDownload the .zip archive of the most recent Shibboleth IdP 2.x and unzip the archive. Do not use the .msi installer for upgrading an existing IdP 2.x installation.
  2. Make a back-up copy of your $IDP_HOME/conf directory "just in case" (recent versions of the IdP installer should not overwrite your config unless you answer "yes" in point 7 9 below).
  3. Download the .zip archive of the most recent Shibboleth IdP 2.x and unzip the archive. Do not use the .msi installer for upgrading an existing IdP 2.x installationStop your IdP (or stop the servlet container, eg. Tomcat), and stop Apache httpd too, if you're using it.
  4. If you don't already have one, it's a good idea to create a source directory specifically for storing the IdP unzipped archives. This makes it easier to manage any additional libraries or branding you might have.
  5. Copy your additional libraries (e.g. JDBC drivers or plugins and/or filters, like uApprove) into the lib/ directory (i.e. lib/ inside the source directory where you unzipped the archive; not $IDP_HOME/lib/, which is inside the deployment directory).
  6. If using User Password authentication, reapply any branding you have made: ie. copy your customised login.jsp etc. pages into the src/main/webapp subdirectory of the unzipped archive.
  7. Open a command window and cd to the top-level directory of the unzipped archive
  8. Set the JAVA_HOME variable to the location of your jre, eg. export JAVA_HOME="/usr/lib/jvm/jdk1.8.0_40/jre"
  9. Run the install script from the command line (install.sh on Unix machines, install.bat on Windows).
    • Provide the location of your $IDP_HOME directory.
    • Answer "no" when the installer asks if you wish to overwrite your configuration files.
  10. If your config files have been overwritten (eg. due to human error) copy the files from your back-up back in to your $IDP_HOME/conf directory.
  11. Start your IdP (or the servlet container), and start Apache httpd too, if you're using it.