Installing Shibboleth

My friend Ken has worked for a week getting the authentication system "Shibboleth" to work with appsoma.  It was a nightmare.  He's written a comprehensive guide here for those who will follow.