You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lenya.apache.org by an...@apache.org on 2007/12/10 17:21:09 UTC
svn commit: r602960 - in
/lenya/branches/docu_shibboleth/src/documentation/content/xdocs:
docs/1_2_x/components/accesscontrol/shibboleth/problems.xml
docs/1_2_x/components/accesscontrol/shibboleth/setup.xml site.xml
Author: andreas
Date: Mon Dec 10 08:21:08 2007
New Revision: 602960
URL: http://svn.apache.org/viewvc?rev=602960&view=rev
Log:
Use separate document for shibboleth troubeshooting
Added:
lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/problems.xml
Modified:
lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/setup.xml
lenya/branches/docu_shibboleth/src/documentation/content/xdocs/site.xml
Added: lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/problems.xml
URL: http://svn.apache.org/viewvc/lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/problems.xml?rev=602960&view=auto
==============================================================================
--- lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/problems.xml (added)
+++ lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/problems.xml Mon Dec 10 08:21:08 2007
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Common Problems with the Shibboleth Setup</title>
+ </header>
+ <body>
+
+ <p>
+ The University of Leuven has published an excellent list of basic tests to verify a correct setup:
+ <a href="http://shib.kuleuven.be/docs/idp/testing-idp-1.3.shtml"
+ >Testing a Tomcat, CAS3 and Shibboleth IdP 1.3 setup</a>
+ </p>
+
+ <p>
+ Here's a list of typical Lenya-specific issues.
+ </p>
+
+ <dl>
+ <dt>SSLHandShakeException</dt>
+ <dd>
+ <p>
+ This usually means that the Java VM can't verify your certificate.
+ </p>
+ <ul>
+ <li>
+ After updating the Java VM to a new version, don't forget to re-add your
+ server certificate to the default Java truststore. This applies to operating
+ system updates as well.
+ </li>
+ <li>
+ Lenya's LDAP configuration file <code>ldap.properties</code> overrides the default
+ Java keystore location. If you use this setting, make sure to add the certificate
+ to this keystore.
+ </li>
+ </ul>
+ </dd>
+ <dt>Login fails</dt>
+ <dd>
+ If you don't run the Lenya web application in the Tomcat root context, you'll have
+ to set the <em>emptySessionPath</em> attribute of the connector to <em>true</em>.
+ For more information, refer to the
+ <a href="http://tomcat.apache.org/tomcat-5.5-doc/config/http.html">Apache
+ Tomcat Configuration Reference</a>.
+ </dd>
+ </dl>
+
+ </body>
+</document>
Modified: lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/setup.xml
URL: http://svn.apache.org/viewvc/lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/setup.xml?rev=602960&r1=602959&r2=602960&view=diff
==============================================================================
--- lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/setup.xml (original)
+++ lenya/branches/docu_shibboleth/src/documentation/content/xdocs/docs/1_2_x/components/accesscontrol/shibboleth/setup.xml Mon Dec 10 08:21:08 2007
@@ -681,30 +681,5 @@
</ul>
</section>
- <section>
- <title>Common Pitfalls</title>
- <ul>
- <li>
- After updating the Java VM to a new version, don't forget to re-add your
- server certificate to the default Java truststore.
- </li>
- <li>
- Lenya's LDAP configuration file <code>ldap.properties</code> overrides the default
- Java keystore location. If you use this setting, make sure to add the certificate
- to this keystore.
- </li>
- <li>
- <p><strong>Login fails</strong></p>
- <p>
- If you don't run the Lenya web application in the Tomcat root context, you'll have
- to set the <em>emptySessionPath</em> attribute of the connector to <em>true</em>.
- For more information, refer to the
- <a href="http://tomcat.apache.org/tomcat-5.5-doc/config/http.html">Apache
- Tomcat Configuration Reference</a>
- </p>
- </li>
- </ul>
- </section>
-
</body>
</document>
Modified: lenya/branches/docu_shibboleth/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/lenya/branches/docu_shibboleth/src/documentation/content/xdocs/site.xml?rev=602960&r1=602959&r2=602960&view=diff
==============================================================================
--- lenya/branches/docu_shibboleth/src/documentation/content/xdocs/site.xml (original)
+++ lenya/branches/docu_shibboleth/src/documentation/content/xdocs/site.xml Mon Dec 10 08:21:08 2007
@@ -455,6 +455,7 @@
<shibboleth12Introduction href="introduction.html" label="Introduction"/>
<shibboleth12Setup href="setup.html" label="Setup"/>
<shibboleth12Architecture href="architecture.html" label="Architecture"/>
+ <shibboleth12Problems href="problems.html" label="Troubleshooting"/>
</shibboleth12>
</accesscontrol>
<authoring href="authoring/" label="Authoring">
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org