Author: smumford Date: 2010-02-15 02:03:11 -0500 (Mon, 15 Feb 2010) New Revision: 1676 Modified: portal/trunk/docs/reference-guide/en/modules/Introduction.xml portal/trunk/docs/reference-guide/en/modules/SSO.xml Log: further edits Modified: portal/trunk/docs/reference-guide/en/modules/Introduction.xml =================================================================== --- portal/trunk/docs/reference-guide/en/modules/Introduction.xml 2010-02-15 07:02:54 UTC (rev 1675) +++ portal/trunk/docs/reference-guide/en/modules/Introduction.xml 2010-02-15 07:03:11 UTC (rev 1676) @@ -22,42 +22,39 @@ 02110-1301 USA, or see the FSF site: http://www.fsf.org. --><title>Introduction</title> + + <para> + &PRODUCT; is a merge of two mature projects; JBoss Portal and eXo Portal. It takes the best of both offerings and incorporates them into a single new project. The aim is to provide an intuitive portal for as-is use and a framework to build upon depending on your needs. + </para> <mediaobject> <imageobject> <imagedata fileref="images/Frontpage.png" format="PNG" scalefit="1" width="444" /> </imageobject> </mediaobject> <para> - &PRODUCT; comes from a merge of two mature projects; the JBoss Portal and the eXo Portal. It takes the best of both into a single new project. The aim is to provide both an intuitive portal to use as-is and a portal framework to build upon depending on your needs. + This book explains how to configure various aspects of &PRODUCT;, including navigation, skins and database variables. </para> - <section id="sect-Reference_Guide-Introduction-Links"> - <title>Links</title> + <para> + Refer to the <ulink type="http" url="http://redhat.com/docs">&PRODUCT; Installation Guide</ulink> for information on downloading and installing the product or the <ulink type="http" url="http://redhat.com/docs">&PRODUCT; User Guide</ulink> for information on basic usage. + </para> + <section id="sect-Install_Guide-Introduction-Related_Links"> + <title>Related Links</title> <itemizedlist> <listitem> <para> - GateIn homepage: <ulink url="http://www.gatein.org">www.gatein.org</ulink> + GateIn project homepage. GateIn 3.0 is the community project that &PRODUCT; is based on. <ulink url="http://www.gatein.org" /> </para> </listitem> <listitem> <para> - Further documentation about the Red Hat &PRODUCT; and other Red Hat products can be found at <ulink type="http" url="www.redhat.com/docs" /> + GateIn downloads: <ulink url="http://www.jboss.org/gatein/downloads.html">www.jboss.o... </para> </listitem> - <!-- <listitem> - <para> - GateIn videos: <ulink url="http://www.jboss.org/gatein/videos.html">www.jboss.org/... - </para> - </listitem> <listitem> <para> - GateIn documentation: <ulink url="http://www.jboss.org/gatein/documentation.html">www.jbo... + Further documentation about the Red Hat &PRODUCT; and other Red Hat products can be found at <ulink type="http" url="www.redhat.com/docs" /> </para> </listitem> - <listitem> - <para> - GateIn downloads: <ulink url="http://www.jboss.org/gatein/downloads.html">www.jboss.o... - </para> - </listitem> --> </itemizedlist> </section> Modified: portal/trunk/docs/reference-guide/en/modules/SSO.xml =================================================================== --- portal/trunk/docs/reference-guide/en/modules/SSO.xml 2010-02-15 07:02:54 UTC (rev 1675) +++ portal/trunk/docs/reference-guide/en/modules/SSO.xml 2010-02-15 07:03:11 UTC (rev 1676) @@ -1,24 +1,30 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> -<chapter id="chap-Reference_Guide-Single_Sign_On"> - <title>Single Sign On</title> - <section id="sect-Reference_Guide-Single_Sign_On-Overview_of_SSO"> - <title>Overview of SSO</title> +<chapter id="chap-Reference_Guide-SSO_Single_Sign_On"> + <title>SSO - Single Sign On</title> + <section id="sect-Reference_Guide-Single_Sign_On-Overview"> + <title>Overview</title> <para> - Portal as an integration and aggregation platform provides some form of Single Sign On (<literal>SSO</literal>) by itself. When you log into the portal you gain access to many systems through portlets using a single identity. Still in many cases you need to integrate the portal infrastructure with other SSO enabled systems. There are many different Identity Management solutions on the market. In most cases each SSO framework provides its own way to plug into Java EE application. + &PRODUCT;, as an integration and aggregation platform provides some form of Single Sign On (<literal>SSO</literal>). </para> + <para> + When logging into the portal users gain access to many systems through portlets using a single identity. In many cases, however, the portal infrastructure must be integrated with other SSO enabled systems. There are many different Identity Management solutions available. In most cases each SSO framework provides a unique way to plug into a Java EE application. + </para> <section id="sect-Reference_Guide-Overview_of_SSO-Prerequisite"> <title>Prerequisite</title> <para> - In this tutorial, the SSO server is installed in a Tomcat installation, you can obtain Tomcat from: http://tomcat.apache.org + In this tutorial, the SSO server is installed in a Tomcat installation. Tomcat can be obtained from <ulink type="http" url="http://tomcat.apache.org">http://tomcat.apache.org</ulink>. </para> <para> - Various files are required to setup the integration, all the packages can be found in a zip file located at: http://repository.jboss.org/maven2/org/gatein/sso/sso-packaging + All the packages required for setup can be found in a zip file located at: <filename>http://repository.jboss.org/maven2/org/gatein/sso/sso-packagi... </para> <para> - As we are manipulating gatein.ear directly it&#39;s better to not run any portal extension that could override some of the data, make sure you remove $JBOSS_HOME/server/default/deploy/gatein-sample-extension.ear and $JBOSS_HOME/server/default/deploy/gatein-sample-portal.ear as they ship by default with GateIn. + When manipulating <filename>gatein.ear</filename> directly it is better to not run any portal extensions that could override the data. </para> + <para> + Remove <literal>$JBOSS_HOME/server/default/deploy/gatein-sample-extension.ear</literal> and <literal>$JBOSS_HOME/server/default/deploy/gatein-sample-portal.ear</literal> which are packaged by default with &PRODUCT;. + </para> </section> </section> @@ -26,10 +32,10 @@ <section id="sect-Reference_Guide-Single_Sign_On-CAS_Central_Authentication_Service"> <title>CAS - Central Authentication Service</title> <para> - This Single Sign On plugin enables seamless integration between GateIn Portal and the CAS Single Sign On Framework. Details about CAS can be found <ulink url="http://www.ja-sig.org/products/cas/">here.</ulink> + This Single Sign On plugin enables seamless integration between &PRODUCT; and the CAS Single Sign On Framework. Details about CAS can be found <ulink url="http://www.ja-sig.org/products/cas/">here</ulink>;. </para> <para> - The integration consitsts in two parts, the first part consists of installing or configuring a CAS server, the second part consists of setting up the portal to use the CAS server. + The integration consists of two parts; the first part consists of installing or configuring a CAS server, the second part consists of setting up the portal to use the CAS server. </para> <section id="sect-Reference_Guide-CAS_Central_Authentication_Service-CAS_server"> <title>CAS server</title>