Page History

The following instructions are meant to get you going as quickly as possible. If you want a better understanding of what's going on, go to the next sections of this document.

Software Installation

• Tomcat: You are most likely already running Shrine, and so Tomcat is already installed. If you followed the instructions for installing Shrine you are running version 9.0.52 (as per SHRINE 4.0.0 Chapter 5 - Set up Apache Tomcat.)
  • The Tomcat home should be /opt/shrine/tomcat
• Apache: version 2.4.10 or higher
  • The Apache configuration files should be in /etc/httpd/
  • The Apache document root should be /var/www/html (specified in /etc/httpd/conf/httpd.conf)
• Shibboleth SP version 3
  • The Shibboleth configuration files should be in /etc/shibboleth

In summary, the folders containing configuration files which matter are:

/opt/shrine/tomcat ← Tomcat home

/etc/shibboleth ← Shibboleth configuration files

/etc/httpd/* ← Apache configuration files

/var/www/html ← Apache static content as set in, for instance, /etc/httpd/conf/httpd.conf

Sample configuration files

Sample configuration files can be found in the Git repository in the shrine-setup module, specifically at shrine-setup/src/main/resources/sso

• sso/apache/sp.conf-sample
• sso/apache/sp-metadata.xml-sample
• sso/shibboleth/attribute-map.xml-sample
• sso/shibboleth/shibboleth2.xml-sample
• sso/tomcat/server.xml-sample

Among the many configuration files, there are nine which need to be modified to reflect your installation, as follows in the table below. Search for the marker: 'ADJUST_FOR_YOUR_SITE' in those files for indications of what / where you need to edit.

...