Author: jaredmorgs
Date: 2012-03-21 00:47:38 -0400 (Wed, 21 Mar 2012)
New Revision: 8622
Modified:
epp/docs/branches/5.2/Reference_Guide/en-US/Book_Info.xml
epp/docs/branches/5.2/Reference_Guide/en-US/Revision_History.xml
epp/docs/branches/5.2/Reference_Guide/en-US/modules/AuthenticationAndIdentity/SSO.xml
Log:
https://bugzilla.redhat.com/show_bug.cgi?id=794433 - Updated the Java Open Single Sign-On
Project section to included the required JOSSO version in the procedures.
Modified: epp/docs/branches/5.2/Reference_Guide/en-US/Book_Info.xml
===================================================================
--- epp/docs/branches/5.2/Reference_Guide/en-US/Book_Info.xml 2012-03-20 17:05:38 UTC (rev
8621)
+++ epp/docs/branches/5.2/Reference_Guide/en-US/Book_Info.xml 2012-03-21 04:47:38 UTC (rev
8622)
@@ -9,7 +9,7 @@
<productname>JBoss Enterprise Portal Platform</productname>
<productnumber>5.2</productnumber>
<edition>5.2.1</edition>
- <pubsnumber>6</pubsnumber>
+ <pubsnumber>8</pubsnumber>
<abstract>
<para>
This Reference Guide is a high-level usage document. It deals with more
advanced topics than the Installation and User Guides, adding new content or taking
concepts discussed in the earlier documents further. It aims to provide supporting
documentation for advanced users of the JBoss Enterprise Portal Platform product. Its
primary focus is on advanced use of the product and it assumes an intermediate or advanced
knowledge of the technology and terms.
Modified: epp/docs/branches/5.2/Reference_Guide/en-US/Revision_History.xml
===================================================================
--- epp/docs/branches/5.2/Reference_Guide/en-US/Revision_History.xml 2012-03-20 17:05:38
UTC (rev 8621)
+++ epp/docs/branches/5.2/Reference_Guide/en-US/Revision_History.xml 2012-03-21 04:47:38
UTC (rev 8622)
@@ -8,8 +8,8 @@
<simpara>
<revhistory>
<revision>
- <revnumber>5.2.1-6</revnumber>
- <date>Tue Mar 20 2112</date>
+ <revnumber>5.2.1-8</revnumber>
+ <date>Tue Mar 20 2012</date>
<author>
<firstname>Jared</firstname>
<surname>Morgan</surname>
@@ -19,6 +19,7 @@
<simplelist>
<
member>https://bugzilla.redhat.com/show_bug.cgi?id=794466 - Added line
break to Redirect to CAS procedure code sample.</member>
<
member>https://bugzilla.redhat.com/show_bug.cgi?id=794455 - Changed
the LocalePolicy file path as declared in the diff.</member>
+ <
member>https://bugzilla.redhat.com/show_bug.cgi?id=794433 - Updated
the Java Open Single Sign-On Project section to included the required JOSSO version in the
procedures.</member>
</simplelist>
</revdescription>
</revision>
Modified:
epp/docs/branches/5.2/Reference_Guide/en-US/modules/AuthenticationAndIdentity/SSO.xml
===================================================================
---
epp/docs/branches/5.2/Reference_Guide/en-US/modules/AuthenticationAndIdentity/SSO.xml 2012-03-20
17:05:38 UTC (rev 8621)
+++
epp/docs/branches/5.2/Reference_Guide/en-US/modules/AuthenticationAndIdentity/SSO.xml 2012-03-21
04:47:38 UTC (rev 8622)
@@ -556,11 +556,13 @@
</step>
</procedure>
<procedure
id="proc-Reference_Guide-Java_Open_Single_Sign_On_Project-Modifying_JOSSO_server">
- <title>Modifying JOSSO server</title>
+ <title><remark>BZ#793838</remark>Modifying JOSSO
server</title>
<step>
<para>
Copy the files from
<filename><replaceable>PORTAL_SSO</replaceable>/josso/plugin</filename>
into the <filename>JOSSO_HOME</filename> directory created in the last step.
</para>
+ <para>If you have JOSSO 1.8.1, copy the files from
<filename>PORTAL_SSO/josso/josso-181/plugin</filename> into the Tomcat
directory (<filename>JOSSO_HOME</filename>).</para>
+ <para>If you have JOSSO 1.8.2 or newer, copy the files from
<filename>PORTAL_SSO/josso/josso-182/plugin</filename> into the Tomcat
directory (<filename>JOSSO_HOME</filename>).</para>
<para>
This action should replace or add the following files to the
<filename>JOSSO_HOME/webapps/josso/WEB-INF/lib</filename> directory:
</para>
@@ -606,15 +608,22 @@
</step>
</procedure>
<procedure
id="proc-Reference_Guide-Java_Open_Single_Sign_On_Project-Setup_the_JOSSO_client">
- <title>Setup the JOSSO client</title>
+ <title><remark>BZ#793838</remark> Setup the JOSSO
client</title>
+ <note>
+ <para>
+There are some changes in JOSSO agent API between versions 1.8.1 and 1.8.2, which require
different modules for different JOSSO versions.
+This procedure uses <replaceable>josso-18X</replaceable> to substitute the
directory <emphasis>josso-181</emphasis> if you
+have JOSSO 1.8.1 and <emphasis>josso-182</emphasis> if you have JOSSO 1.8.2
or newer.
+</para>
+ </note>
<step>
<para>
- Copy the library files from
<filename><replaceable>PORTAL_SSO</replaceable>/josso/gatein.ear/lib</filename>
into <filename>gatein.ear/lib</filename> (or into
<filename>GATEIN_HOME/lib</filename> if the product is running in Tomcat).
+ Copy the library files from
<filename><replaceable>PORTAL_SSO</replaceable>/josso/<remark>josso-18X</remark>/gatein.ear/lib</filename>
into <filename>gatein.ear/lib</filename> (or into
<filename>GATEIN_HOME/lib</filename> if the product is running in Tomcat).
</para>
</step>
<step>
<para>
- Copy the
<filename><replaceable>PORTAL_SSO</replaceable>/josso/gatein.ear/portal.war/WEB-INF/classes/josso-agent-config.xml</filename>
file into the <filename>gatein.ear/02portal.war/WEB-INF/classes</filename>
directory (or into
<filename>JBOSS_HOME/webapps/portal.war/WEB-INF/classes</filename>, or
<filename>GATEIN_HOME/conf</filename> if the product is running in Tomcat).
+ Copy the
<filename><replaceable>PORTAL_SSO</replaceable>/josso/<replaceable>josso-18X</replaceable>/gatein.ear/portal.war/WEB-INF/classes/josso-agent-config.xml</filename>
file into the <filename>gatein.ear/02portal.war/WEB-INF/classes</filename>
directory (or into
<filename>JBOSS_HOME/webapps/portal.war/WEB-INF/classes</filename>, or
<filename>GATEIN_HOME/conf</filename> if the product is running in Tomcat).
</para>
</step>
<step>