Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  1. Configure the system to use Apache 2.2.x, according to other pages on this wiki.
  2. Check that the install of OpenSSL has the development extensions. If the system received a custom build of OpenSSL, there will be a /usr/local/ssl directory, and this step can be skipped.
    1. Check the rpmlogs for openssl-devel. Install it if it is missing.
      Code Block
      
      grep openssl-devel /var/log/rpmpkgs
      yum install openssl-devel
      
  3. Download the source code tarball and build script from either Trogdor or the /mit/webauth/shibboleth/source webauth Athena locker.
    1. Download from Aether:
      Code Block
      cd /home/www/tmp
      scp root@trogdor.mit.edu:/opt/software-repository-tmp/Touchstone/shibboleth-sp-1.3.1-sources.tgz \
         /home/www/tmp
      
    2. Download for the webauth Athena locker:
      Code Block
      cd /home/www/tmp
      scp athena.dialup.mit.edu:/mit/webauth/shibboleth/source/shibboleth-sp-1.3.1-sources.tgz /home/www/tmp
      
  4. Make certain that the correct version of apxs from httpd-devel packages are installed.
    • If apxs is not in /home/www/apache/bin, install it from rpm:
      Code Block
      yum install httpd-devel
      
  5. Create a Shibboleth build directory, unpack the tarball into it, and run the build script.
    • If Apache was built locally:
      Code Block
      mkdir /home/www/tmp/shibboleth-build-directory
      cd /home/www/tmp/shibboleth-build-directory
      tar -xzvf /home/www/tmp/shibboleth-sp-1.3.1-sources.tgz
      ./build-sp.sh -p /home/www/shibboleth -a /home/www/apache/bin/apxs
      chown -R www:www /home/www
      
    • If Apache was installed from rpm:
      Code Block
      mkdir /home/www/tmp/shibboleth-build-directory
      cd /home/www/tmp/shibboleth-build-directory
      tar -xzvf /home/www/tmp/shibboleth-sp-1.3.1-sources.tgz
      ./build-sp.sh -p /home/www/shibboleth
      chown -R www:www /home/www
      
  6. Configure Shibboleth, as described in Configuring+and+customizing+the+Shibboleth+SP.
    • Download to the config files from Trogdor or the webauth Athena locker and run the gen-shib.sh script:
      Code Block
      cd /home/www/shibboleth/etc/shibboleth
      scp root@trogdor:/opt/software-repository-tmp/Touchstone/config-SP/* \
         /home/www/shibboleth/etc/shibboleth
      chmod u+x /home/www/shibboleth/etc/shibboleth/gen-shib.sh
      ./gen-shib.sh
      
    • Edit the file /home/www/apache/conf/httpd. After the line "Include conf/extra/httpd-ssl.conf", insert the following:
      Code Block
      # Touchstone/Shibboleth
      Include /home/www/shibboleth/etc/shibboleth/apache22.config
      
  7. Add the init script to /etc/init.d, and set to run on appropriate runlevels.
    Code Block
    cd /home/www/shibboleth/etc/shibboleth
    cp /home/www/shibboleth/etc/shibboleth/shibd-redhat /etc/init.d/shibd
    chmod u+x,a-w /etc/init.d/shibd
    cd /etc/init.d
    ln -s /etc/init.d/shibd /etc/rc.d/rc3.d/S45shibd
    ln -s /etc/init.d/shibd /etc/rc.d/rc4.d/S45shibd
    ln -s /etc/init.d/shibd /etc/rc.d/rc5.d/S45shibd
    ln -s /etc/init.d/shibd /etc/rc.d/rc3.d/K45shibd
    ln -s /etc/init.d/shibd /etc/rc.d/rc4.d/K45shibd
    ln -s /etc/init.d/shibd /etc/rc.d/rc5.d/K45shibd
    /etc/init.d/shibd start
    
  8. At a convenient time, bounce Apache and related web services.
    Code Block
    /etc/init.d/web stop
    /etc/init.d/web start