Author: jaredmorgs Date: 2012-07-25 00:43:08 -0400 (Wed, 25 Jul 2012) New Revision: 8797 Added: epp/docs/branches/5.2/Installation_Guide/en-US/JON_Installation.xml Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.ent epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml Log: BZ#803567 - Added JON Installation section to the guide, to cover the Admin and Monitoring section now in the Admin Guide Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -9,7 +9,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5.2</productnumber> <edition>5.2.2</edition> - <pubsnumber>2</pubsnumber> + <pubsnumber>3</pubsnumber> <abstract> <para>This book provides information about obtaining, installing and running JBoss Enterprise Portal Platform and its add-ons. It forms part of the complete document suite along with the <citetitle>User Guide</citetitle> and <citetitle>Reference Guide</citetitle> available at <ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... type="http"/>. </para> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -37,7 +37,7 @@ You can change this directory location by editing the <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/conf/gatein/configuration.properties</filename> file, the name of the property being: <literal>gatein.jcr.storage.data.dir</literal></para> </warning> <task id="task-Create_Production_Database"> - <title><remark>BZ#794386</remark>Task: Provision JCR and IDM Production Databases</title> + <title>Task: Provision JCR and IDM Production Databases</title> <tasksummary> <para>Read and understand the guideline steps in this task to prepare production databases for JBoss Enterprise Portal Platform. </para> </tasksummary> @@ -93,7 +93,7 @@ <para>For production instances that use a single portal container, you can configure a single JCR and IDM database. If you run JBoss Enterprise Portal Platform with the default configuration from a clean install, without Site Publisher, you meet this requirement.</para> <para>For customers installing Site Publisher, or customers that require multiple portal containers in their JBoss Enterprise Portal Platform, follow the tasks in <xref linkend="Multiple_Portal_JRC_IDM"/> to ensure you configure the JNDI requirements for multiple platforms correctly.</para> <task id="task-Configure_JCR_Database_Datasource"> - <title><remark>BZ#794386</remark>Task: Configure the JCR Database Datasource</title> + <title>Task: Configure the JCR Database Datasource</title> <tasksummary> <para>Complete this task to configure the JCR datasource descriptor for instances that have one portal container (the default when you install the platform for the first time, without Site Publisher).</para> </tasksummary> @@ -196,7 +196,7 @@ <para>If you run Site Publisher with JBoss Enterprise Portal Platform, or need to configure multiple portal containers in your installation of JBoss Enterprise Portal Platform, JNDI requires a separate JCR and IDM datasource definition for <emphasis role="italic">each portal container</emphasis> in <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/gatein-ds.xml</filename>. </para> <para>This requirement also means a separate JCR and IDM database is required for <emphasis role="italic">each portal container</emphasis>. </para> <task id="task-Configure_Multiple_JCR_Database_Datasource"> - <title><remark>BZ#794386</remark>Task: Configure Multiple JCR Database Datasources</title> + <title>Task: Configure Multiple JCR Database Datasources</title> <tasksummary> <para>Complete this task to configure the JCR datasource descriptors for two portal containers.</para> <note> @@ -270,7 +270,7 @@ </procedure> </task> <task id="task-Configure_Multiple_IDM_Database_Datasource"> - <title><remark>BZ#794386</remark>Task: Configure Multiple IDM Database Datasource</title> + <title>Task: Configure Multiple IDM Database Datasource</title> <tasksummary> <para>Complete this task to configure multiple IDM datasource descriptors. </para> <note> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.ent =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.ent 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.ent 2012-07-25 04:43:08 UTC (rev 8797) @@ -16,4 +16,4 @@ <!-- Version Specifcs: --> <!ENTITY VX "5"> <!ENTITY VY "5.2"> -<!ENTITY VZ "5.2.0"> \ No newline at end of file +<!ENTITY VZ "5.2.2"> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -25,7 +25,8 @@ </para> </listitem> <listitem> - <para>You have a valid JBoss Enterprise Portal Platform subscription.</para> + <remark>BZ#803567 - added this in for the benefit of the JON Plugin section.</remark> + <para>You have an entitlement to <literal>EPP with Management</literal> in the Customer Portal. If you do not have this entitlement, you will not be able to benefit from JBoss Operations Network management of the portal.</para> </listitem> </itemizedlist> </taskprerequisites> @@ -83,6 +84,24 @@ </step> </substeps> </step> + <step> + <title>Optional: Download the JBoss Operations Network plug-in</title> + <para>If you intend to use the JBoss Operations Network EPP plug-in to manage the production server, select <literal>JBoss ON for EPP</literal> + from either the Software Downloads drop-down box, or the menu on the left.</para> + <substeps> + <step> + <para>Click the + <filename>JBoss Operations Network <replaceable>VERSION</replaceable> Base Distribution</filename> + download link.</para> + </step> + <step> + <para>Click the <guibutton>Download</guibutton> link to start the Base Distribution download.</para> + </step> + <step> + <para>Repeat the steps to download the <filename>EPP Plugin Pack for JBoss ON <replaceable>VERSION</replaceable></filename></para> + </step> + </substeps> + </step> </procedure> </task> <para>Now you have downloaded the required Zip archives, you can install the platform.</para> @@ -117,6 +136,10 @@ <para>If you need to install Site Publisher, complete the tasks in to <xref linkend="Site_Publisher_Installation"/>.</para> </step> <step> + <title>Optional: JBoss ON </title> + <para>If you need to install JBoss ON for EPP, complete the tasks in <xref linkend="JBoss_ON_Installation"/> to download the additional files. Configuring JBoss ON is done after other key configuration has been implemented.</para> + </step> + <step> <title>Perform post-installation configuration</title> <para>Refer to <xref linkend="Post_Installation_Configuration"/> for post-installation configuration instructions.</para> </step> Added: epp/docs/branches/5.2/Installation_Guide/en-US/JON_Installation.xml =================================================================== (Binary files differ) Property changes on: epp/docs/branches/5.2/Installation_Guide/en-US/JON_Installation.xml ___________________________________________________________________ Added: svn:mime-type + application/xml Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -2,8 +2,7 @@ <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> <chapter id="Install_Native_Components"> - <title><remark>BZ#798839 </remark>Install Native Components</title> - <remark>BZ#798839 - 20120307 - Converted this chapter from the EAP Installation Guide.</remark> + <title>Install Native Components</title> <para/> <para>The Native Components package is an optional JBoss Enterprise Application Platform package that incorporates native operating system components and connectors for web servers including:</para> @@ -33,7 +32,6 @@ <para>Installing JBoss Native can result in higher server performance, as native operating system code becomes available for the server to optimize tasks. <xref linkend="exam-Native_Web_vs_Java_IO"/> describes a scenario where Native Components perform better over standard components.</para> - <remark>BZ#798839 - 20120307 - Added this example based on peformance info from Andrig Miller, as recorded in the bug.</remark> <example id="exam-Native_Web_vs_Java_IO"> <title>Native Web Connector vs Java I/O</title> <para>If your implementation has many thousands of users, all with active sessions, but only 20% of all active users are making concurrent requests, the native web connector is the correct choice. </para> @@ -87,7 +85,6 @@ </para> </listitem> <listitem> - <remark>BZ#798839 - 20120307 - Added this as part of the manifest, as it wasn&apos;t declared in the EAP version (NSAPI is now covered in the HTTP Connectors Guide for EAP).</remark> <para><literal>NSAPI</literal> is a connector for the Netscape web server.</para> </listitem> <listitem> @@ -126,7 +123,6 @@ </section> <section id="Native_Components_Download"> <title>Download</title> - <remark>BZ#798839 - 20120307 - Adapted the EAP instructions to cater for the fact no native binaries are currently included in EPP.</remark> <para>Read this section to learn how to download the required native libraries for JBoss Enterprise Portal Platform.</para> <task id="task-Download_Native_Files"> <title>Task: Download Native Files</title> @@ -190,7 +186,6 @@ </section> <section id="Native_Components_Install"> <title>Install</title> - <remark>BZ#798839 - 20120307 - Converted this chapter from the EAP Installation Guide to cover EPP installation of EAP native binaries.</remark> <para>Read this section to learn how to install the native libraries for JBoss Enterprise Portal Platform.</para> <task> <title>Install Native Components</title> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -172,9 +172,10 @@ </task> </section> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="DatabaseConfiguration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="JON_Installation.xml" encoding="UTF-8"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="EMailServiceConfiguration.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ClusteringConfiguration.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="HTTPSConfiguration.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GadgetProxyConfig.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ValidatorConfiguration.xml" encoding="UTF-8"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ValidatorConfiguration.xml" encoding="UTF-8"/> </chapter> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-07-25 04:24:46 UTC (rev 8796) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-07-25 04:43:08 UTC (rev 8797) @@ -9,6 +9,20 @@ <simpara> <revhistory> <revision> + <revnumber>5.2.2-3</revnumber> + <date>Wed Jul 25 2012</date> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email/> + </author> + <revdescription> + <simplelist> + <member>BZ#803567 - Added JBoss ON installation instructions.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>5.2.2-2</revnumber> <date>Thu Jul 5 2012</date> <author>