[gatein-commits] gatein SVN: r8766 - in epp/docs/branches/5.2/Installation_Guide: en-US and 1 other directory.

Author: jaredmorgs Date: 2012-07-04 00:53:20 -0400 (Wed, 04 Jul 2012) New Revision: 8766 Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml epp/docs/branches/5.2/Installation_Guide/en-US/Getting_Started.xml epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.xml epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml epp/docs/branches/5.2/Installation_Guide/en-US/Introduction.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 epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml epp/docs/branches/5.2/Installation_Guide/publican.cfg Log: BZ#803152 - Added user name validator configuration information to the guide, based on community source as reference info. 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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -8,8 +8,8 @@ <subtitle>for use with JBoss Enterprise Portal Platform and Site Publisher &VZ;</subtitle> <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5.2</productnumber> - <edition>5.2.1</edition> - <pubsnumber>100</pubsnumber> + <edition>5.2.2</edition> + <pubsnumber>1</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> @@ -17,7 +17,7 @@ <corpauthor> <inlinemediaobject> <imageobject> - <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG"/> + <imagedata fileref="Common_Content/images/title_logo.png"/> </imageobject> </inlinemediaobject> </corpauthor> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -86,10 +86,7 @@ </variablelist> </step> <step> - <formalpara> - <title>Result</title> - <para>You have provided the mandatory clustering configuration as it relates to the portal in the <filename>configuration.properties</filename> file.</para> - </formalpara> + <para>You have provided the mandatory clustering configuration as it relates to the portal in the <filename>configuration.properties</filename> file. This completes the procedure.</para> </step> </procedure> </task> 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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -24,7 +24,7 @@ <para>The formula to apply when provisioning JCR and IDM databases is:</para> <programlisting>(1 IDM + 1 JCR Database) * (Number of Portal Containers)</programlisting> <para>For example, if you intend running Site Publisher with JBoss Enterprise Portal Platform, you must create two separate JCR and IDM databases for the <literal>portal</literal> container, and <literal>ecmdemo</literal> container.</para> - <para>Refer to <xref linkend="task-Create_Production_Database"/> to provision the required database based on the number of portal instances. After completing this task, refer to <xref linkend="Single_Portal_JCR_IDM"/> and <xref linkend="Multiple_Portal_JRC_IDM"/> for instructions relating to configuring the JNDI names in the directive files.</para> + <para>Refer to <xref linkend="task-Create_Production_Database"/> to provision the required databases, based on the number of portal instances. After completing this task, refer to <xref linkend="Single_Portal_JCR_IDM"/> and <xref linkend="Multiple_Portal_JRC_IDM"/> for instructions relating to configuring the JNDI names in the directive files.</para> <warning> <title>Warning: Do not delete <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/data</filename></title> <para> @@ -45,7 +45,7 @@ <title>Prerequisites</title> <itemizedlist> <listitem> - <para>JBoss Enterprise Portal Platform installed.</para> + <para>JBoss Enterprise Portal Platform is installed.</para> </listitem> <listitem> <para>A JDBC-compliant database installer, from the list of certified databases described at <ulink url="http://www.redhat.com/resourcelibrary/articles/jboss-enterprise... Red Hat Resource Library for JBoss Enterprise Portal Platform</ulink></para> @@ -137,13 +137,8 @@ <important> <para>The password you specify in &lt;password&gt; is in plain text, and anyone with access to the server can discover the password. Consider encrypting this password.</para> </important> + <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the JCR datasource is ready for production use.</para> </step> - <step> - <formalpara> - <title>Result</title> - <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the JCR datasource is ready for production use.</para> - </formalpara> - </step> </procedure> </task> <task id="task-Configure_IDM_Database_Datasource"> @@ -191,13 +186,8 @@ <important> <para>The password you specify in &lt;password&gt; is in plain text, and anyone with access to the server can discover the password. Consider encrypting this password using a keypair.</para> </important> + <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the IDM datasource is ready for production use.</para> </step> - <step> - <formalpara> - <title>Result</title> - <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the IDM datasource is ready for production use.</para> - </formalpara> - </step> </procedure> </task> </section> @@ -275,13 +265,8 @@ <important> <para>The password you specify in &lt;password&gt; is in plain text, and anyone with access to the server can discover the password. Consider encrypting this password.</para> </important> + <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the JCR datasources for both portal containers are ready for production use.</para> </step> - <step> - <formalpara> - <title>Result</title> - <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the JCR datasources for both portal containers are ready for production use.</para> - </formalpara> - </step> </procedure> </task> <task id="task-Configure_Multiple_IDM_Database_Datasource"> @@ -289,7 +274,7 @@ <tasksummary> <para>Complete this task to configure multiple IDM datasource descriptors. </para> <note> - <para>This task uses Site Publisher as the second portal container, however if you are not running Site Publisher you can replace the Site Publisher JNDI name <literal>ecmdemo</literal> with the name of your second portal container.</para> + <para>This task uses Site Publisher as the second portal container. If you are not running Site Publisher, replace the Site Publisher JNDI name <literal>ecmdemo</literal> with the name of your second portal container.</para> </note> </tasksummary> <taskprerequisites> @@ -354,13 +339,8 @@ <important> <para>The password you specify in &lt;password&gt; is in plain text, and anyone with access to the server can discover the password. Consider encrypting this password.</para> </important> + <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the IDM datasources for both portal containers are ready for production use.</para> </step> - <step> - <formalpara> - <title>Result</title> - <para>You have provided the key information in the <filename>gatein-ds.xml</filename> directives, and the IDM datasources for both portal containers are ready for production use.</para> - </formalpara> - </step> </procedure> </task> </section> @@ -432,12 +412,9 @@ <para>MyISAM storage engine is not supported in JBoss Enterprise Portal Platform, and may lead to data corruption if used. </para> </warning> <programlisting>mysql&gt; CREATE DATABASE gateinjcr;</programlisting> - <formalpara> - <title>Result</title> - <para> + <para> The database is created, and MySQL returns a status similar to the following: </para> - </formalpara> <screen>Query OK, 1 row affected (0.00 sec)</screen> </step> <step> @@ -445,12 +422,9 @@ Use the <command>CREATE DATABASE</command> command to create a new <replaceable>gateinidm</replaceable> database. </para> <programlisting>mysql&gt; CREATE DATABASE gateinidm;</programlisting> - <formalpara> - <title>Result</title> - <para> + <para> The database is created, and MySQL returns a status similar to the following: </para> - </formalpara> <screen>Query OK, 1 row affected (0.00 sec)</screen> </step> <step> @@ -489,13 +463,8 @@ mysql&gt; GRANT ALL PRIVILEGES ON gateinidm.* TO &apos;<replaceable>gateinuser</replaceable>&apos;@&apos;localhost&apos; IDENTIFIED BY &apos;<replaceable>gateinpassword</replaceable>&apos; WITH GRANT OPTION;</programlisting> + <para>You have created a common user for all required database tables, and granted the user the correct permissions to make changes to the tables on behalf of the portal instance.</para> </step> - <step> - <formalpara> - <title>Result</title> - <para>You have created a common user for all required database tables, and granted the user the correct permissions to make changes to the tables on behalf of the portal instance.</para> - </formalpara> - </step> </procedure> </task> <para>Now the database has been provisioned correctly, the user and database information needs to be defined in the portal container&apos;s datasource descriptor. @@ -552,10 +521,7 @@ </datasources>]]></programlisting> </step> <step> - <formalpara> - <title>Result</title> - <para>You have specified the databases, driver class, and user credentials the portal instance requires to communicate using JDBC. </para> - </formalpara> + <para>You have specified the databases, driver class, and user credentials the portal instance requires to communicate using JDBC. This completes the procedure.</para> </step> </procedure> </task> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -64,10 +64,7 @@ <para>Save and close <filename>common-configuration.xml</filename>.</para> </step> <step> - <formalpara> - <title>Result</title> - <para>You have specified the gadget domains required in your installation.</para> - </formalpara> + <para>You have specified the gadget domains required in your installation. This completes the procedure.</para> </step> </procedure> <taskrelated> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Getting_Started.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Getting_Started.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Getting_Started.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -15,6 +15,10 @@ <para> The Site Publisher add-on (commonly referred to as Site Publisher) that is part of the &VZ; release can only be installed onto a <firstterm>clean</firstterm> installation of JBoss Enterprise Portal Platform version 5.1 or later. </para> + <formalpara> + <title>Clean Installation</title> + <para>An instance of JBoss Enterprise Portal Platform that has just been installed. The instance does not contain any non-standard configuration settings or data, common in pre-existing platform installations.</para> + </formalpara> <para>If you already have a clean installation of JBoss Enterprise Portal Platform, you can go directly to <xref linkend="Site_Publisher_Installation"/>.</para> </section> <section id="Getting_Started-Pre_Requisites"> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -66,10 +66,7 @@ <step> <para>Execute the following command to verify the keystore file has been correctly imported into the JDK keystore:</para> <programlisting>[conf]# keytool -list -keystore $JAVA_HOME/jre/lib/security/cacerts -alias <replaceable>epp5key</replaceable></programlisting> - <formalpara> - <title>Result</title> - <para>The command returns one PrivateKeyEntry</para> - </formalpara> + <para>The command returns one PrivateKeyEntry</para> </step> <step> <para>Open <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/jbossweb.sar/server.xml</filename>: @@ -97,10 +94,7 @@ <para>Restart the portal.</para> </step> <step> - <formalpara> - <title>Result</title> - <para>You have configured the platform to communicate using a secure connection.</para> - </formalpara> + <para>You have configured the platform to communicate using a secure connection. This completes the procedure.</para> </step> </procedure> <taskrelated> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Installation_Guide.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -1,9 +1,9 @@ <?xml version='1.0' encoding='UTF-8'?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!-- This document was created with Syntext Serna Free. --><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent"> %BOOK_ENTITIES; ]> -<book> +<book status="draft"> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book_Info.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Preface.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Introduction.xml"/> 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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -13,7 +13,7 @@ <task id="task-Download_Installation_Files"> <title>Task: Download Installation Files</title> <tasksummary> - <para>Complete this task to download the Zip archives from the Red Hat Customer Portal used to install the platform, and Site Publisher .</para> + <para>Complete this task to download the Zip archives from the Red Hat Customer Portal, which contain the installation binaries.</para> </tasksummary> <taskprerequisites> <title>Prerequisites</title> @@ -50,10 +50,7 @@ </step> <step> <para>Enter your login information.</para> - <formalpara> - <title>Result:</title> - <para>You are taken to the Software Downloads page.</para> - </formalpara> + <para>You are taken to the Software Downloads page.</para> </step> <step> <title>Download the Portal</title> @@ -61,10 +58,7 @@ <literal>Portal Platform</literal> from either the drop-down box or the menu on the left. </para> - <formalpara> - <title>Result:</title> - <para>You are presented with a list of file downloads.</para> - </formalpara> + <para>You are presented with a list of file downloads.</para> </step> <step> <para>Click the @@ -95,7 +89,7 @@ <task id="task-Install_The_Platform"> <title>Task: Install the Platform</title> <tasksummary> - <para>Complete this task to install the platform a Zip archive.</para> + <para>Complete this task to install the platform from the Zip archive.</para> </tasksummary> <taskprerequisites> <title>Prerequisites</title> @@ -110,12 +104,9 @@ <para>Unzip <literal>jboss-epp-<replaceable>VERSION</replaceable>.zip</literal> to extract the archive contents into the location of your choice. </para> - <formalpara> - <title>Result:</title> - <para> + <para> This creates the <filename>jboss-epp-<replaceable>VERSION</replaceable></filename> directory, with an installation of JBoss Enterprise Portal Platform in its default configuration.</para> - </formalpara> </step> <step> <title>Optional: Install Native Components</title> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Introduction.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Introduction.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Introduction.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -5,6 +5,7 @@ ]> <chapter id="Introduction"> <title>Introduction</title> + <graphic fileref="images/annoyed-facepalm-picard.svg"/> <para>Read this guide if you are a system administrator that needs to download and install JBoss Enterprise Portal Platform, and configure the product to work in a production environment.</para> <para>By following the tasks in this guide, you will configure mandatory settings required for the portal to start and operate correctly. The guide is structured in a way that you can jump to a relevant section of the guide at any time and have all the information you need to perform a discreet task. If you need to perform prerequisite configuration, this is declared in each task.</para> <para>Because JBoss Enterprise Portal Platform is a JBoss Middleware product, the platform runs and is supported on JBoss Enterprise Application Platform. References to detailed information in the JBoss Enterprise Application Platform documentation is called out when required. All JBoss Enterprise Application Platform product documentation is available online at the <ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Application_... Hat Documentation Portal</ulink>. 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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -143,11 +143,8 @@ </para> </listitem> <listitem> - <para>You have a valid JBoss Enterprise Portal Platform subscription, with entitlements to JBoss Enterprise Application Platform native binaries. </para> + <para>You have a valid JBoss Enterprise Portal Platform subscription. </para> </listitem> - <listitem> - <para>You have reviewed the JBoss Enterprise Portal Platform <citetitle>Release Notes</citetitle> to identify which version of JBoss Enterprise Application Platform is included in the portal version you are installing. </para> - </listitem> </itemizedlist> </taskprerequisites> <procedure> @@ -171,31 +168,18 @@ </step> <step> <para>If you are not already authenticated, enter your login information.</para> - <formalpara> - <title>Result:</title> - <para>You are taken to the Software Downloads page.</para> - </formalpara> + <para>You are taken to the Software Downloads page.</para> </step> <step> <para>Select - <literal>Application Platform</literal> + <literal>Portal Platform</literal> from either the drop-down box or the menu on the left. </para> - <formalpara> - <title>Result:</title> - <para>You are presented with a list of file downloads for the latest version of JBoss Enterprise Application Platform.</para> - </formalpara> + <para>You are presented with a list of file downloads for the latest version of JBoss Enterprise Portal Platform.</para> </step> <step> - <para>From the Version drop-down, select the version number specified in the Portal <citetitle>Release Notes</citetitle>.</para> - <formalpara> - <title>Result:</title> - <para>You are presented with a list of file downloads for the applicable version of JBoss Enterprise Application Platform, as it relates to JBoss Enterprise Portal Platform.</para> - </formalpara> - </step> - <step> <para>Click the - <filename>JBoss EAP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable></filename> + <filename>JBoss EPP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable></filename> download link that corresponds with your native operating system.</para> </step> <step> @@ -224,7 +208,7 @@ </taskprerequisites> <procedure> <step> - <para>Open the <filename>JBoss EAP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable></filename> Zip archive.</para> + <para>Open the <filename>JBoss EPP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable></filename> Zip archive.</para> </step> <step> <para>Extract the <filename>native</filename> directory from the zip archive into the @@ -248,12 +232,12 @@ <para>Refer to <xref linkend="task-Install_The_Platform"/> to verify all other base installation steps are complete.</para> </listitem> <listitem> - <para>Refer to <xref linkend="Post_Installation_Configuration"/> to ensure you meet all post installation requirements.</para> + <para>Refer to <xref linkend="Post_Installation_Configuration"/> to ensure you meet all post-installation requirements.</para> </listitem> </itemizedlist> </taskrelated> </task> - <para>Once you have completed all post installation configuration requirements, you can verify native components are loaded during server startup by reviewing the server startup terminal information.</para> + <para>Once you have completed all post-installation configuration requirements, you can verify native components are loaded during server startup by reviewing the server startup terminal information.</para> <screen>12:12:29,826 INFO [ServerInfo] VM arguments: -Dprogram.name=run.sh -Xms1303m -Xmx1303m -XX:MaxPermSize=256m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Dsun.lang.ClassLoader.allowArraySyntax=true 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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -4,7 +4,7 @@ %BOOK_ENTITIES; ]> <chapter id="Post_Installation_Configuration"> - <title>Post Installation Configuration</title> + <title>Post-installation Configuration</title> <section id="Choose_a_Server_Profile"> <title>Choose a Server Profile</title> <para>The server profiles shipped with the platform include: <literal>minimal</literal>, <literal>default</literal>, <literal>production</literal>, <literal>all</literal>, <literal>standard</literal> and <literal>web</literal>. @@ -75,7 +75,7 @@ <title>Adjust Memory Settings</title> <para> If the server is running out of memory, you can adjust the memory settings before deploying the applications. </para> - <para>You can do this by updating <literal>JAVA_OPTS</literal> settings in the file <filename><replaceable>JBOSS_HOME</replaceable>/jboss-as/bin/run.conf</filename> on Linux or <filename><replaceable>JBOSS_HOME</replaceable>\jboss-as\bin\run.conf.bat</filename> on Windows. </para> + <para>You can do this by updating <literal>JAVA_OPTS</literal> settings in the file <filename><replaceable>JBOSS_HOME</replaceable>/jboss-as/bin/run.conf</filename> on Linux, or <filename><replaceable>JBOSS_HOME</replaceable>\jboss-as\bin\run.conf.bat</filename> on Windows. </para> <para>The default values do not take into account the memory requirements of your applications: <programlisting>-Xms1303m -Xmx1303m -XX:MaxPermSize=256m ....</programlisting> </para> @@ -83,7 +83,7 @@ <section id="Configure_Security"> <title>Configure Security </title> <para> - When installed from the zip archive, authentication is required to access the majority of JBoss services, including administrative services. User accounts have not been set up to eliminate the possibility of default username/password based attacks. + When installed from the zip archive, authentication is required to access the majority of JBoss services, including administrative services. User accounts are not configured to eliminate the possibility of default username/password based attacks. </para> <important> <title>Default Admin User Configuration</title> @@ -91,7 +91,7 @@ It is recommended that the admin=admin username and password configuration, which is commented out by default, not be used for a production server. The admin user is included as an example of the username/password definition format only. </para> </important> - <para>The JBoss Enterprise Application Platform <citetitle>Installation Guide</citetitle> features a comprehensive chapter about <citetitle>Post Installation Security Configuration</citetitle>. Refer to this chapter for the guidance on the following required configuration tasks:</para> + <para>The JBoss Enterprise Application Platform <citetitle>Installation Guide</citetitle> features a comprehensive chapter about <citetitle>Post-installation Security Configuration</citetitle>. Refer to this chapter for guidance on the following required configuration tasks:</para> <itemizedlist> <listitem> <para>Security Configuration: JMX Console, Admin Console, HttpInvoker</para> @@ -103,7 +103,7 @@ </section> <section id="Disable_Authentication"> <title>Disable Authentication</title> - <para>The JBoss Enterprise Application Platform <citetitle>Installation Guide</citetitle> features a comprehensive chapter about <citetitle>Disabling Authentication</citetitle>. Refer to this chapter for the guidance on the following configuration tasks:</para> + <para>The JBoss Enterprise Application Platform <citetitle>Installation Guide</citetitle> features a comprehensive chapter about <citetitle>Disabling Authentication</citetitle>. Refer to this chapter for guidance on the following configuration tasks:</para> <itemizedlist> <listitem> <para>Disabling Authentication for JMX Console</para> @@ -125,7 +125,7 @@ JBoss Enterprise Portal Platform includes four pre-configured user accounts for testing and evaluation purposes. These accounts can be used for direct access to the portal. </para> <para> - For security reasons, before going in production, you should restrict the access to the login servlet to POST. + For security reasons, you should restrict access to the login servlet to POST before commissioning your installation for production use. </para> <task> <title>Task: Restrict Login Servlet Access</title> @@ -164,7 +164,7 @@ <step> <formalpara> <title>Result</title> - <para>The login links on the front page of the portal main screen will not display, and the accounts are not available for use. + <para>The login links on the front page of the portal main screen will not allow anonymous login. </para> </formalpara> </step> @@ -176,4 +176,5 @@ <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"/> </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-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -9,6 +9,20 @@ <simpara> <revhistory> <revision> + <revnumber>5.2.2-1</revnumber> + <date>Tue Jul 4 2012</date> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email/> + </author> + <revdescription> + <simplelist> + <member>BZ#803152 - Added a new section describing the user name validator, and how to configure it. Removed any unsupported developer information present in the community version. Added to post-installation section.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>5.2.1-100</revnumber> <date>Tue Apr 17 2012</date> <author> @@ -22,7 +36,6 @@ </simplelist> </revdescription> </revision> - <revision> <revnumber>5.2.0-100</revnumber> <date>Wed Dec 14 2011</date> @@ -37,7 +50,6 @@ </simplelist> </revdescription> </revision> - </revhistory> </simpara> </appendix> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -112,14 +112,9 @@ </para> </listitem> </itemizedlist> + <para>You have copied all required configuration files to the platform. Site Publisher is now ready to use once all other configuration tasks have been completed in this guide.</para> </step> <step> - <formalpara> - <title>Result</title> - <para>You have copied all required configuration files to the platform. Site Publisher is now ready to use once all other configuration tasks have been completed in this guide.</para> - </formalpara> - </step> - <step> <title>Perform post-installation configuration</title> <para>Refer to <xref linkend="Post_Installation_Configuration"/> for post-installation configuration instructions.</para> </step> @@ -165,7 +160,5 @@ </note> </step> --> </procedure> </task> -<!-- <para> - If you did not include the <filename>gatein-ecmdemo-portal-&lt;version&gt;-GA.ear</filename> file, refer to the documentation available at <ulink type="http" url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... /> for instructions on how to create a portal using Site Publisher's features. - </para> --> </section> + </section> </chapter> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -5,7 +5,7 @@ ]> <chapter id="Test_your_Installation"> <title><remark>BZ#794687 and BZ#801244 </remark>Test your Installation</title> - <para>After you have installed JBoss Enterprise Portal Platform and completed the relevant post installation configuration steps, verify your configuration is correct by starting the platform. + <para>After you have installed JBoss Enterprise Portal Platform and completed the relevant post-installation configuration steps, verify your configuration is correct by starting the platform. </para> <remark>BZ#801244 - 20120309 - Refined task information to include note about sybase startup commands, cluster URL, portal screens dependent on add-ons. One task to cover all start up scenarios.</remark> <task> @@ -159,7 +159,7 @@ <title>Standard Portal Home Page</title> <mediaobject> <imageobject role="html"> - <imagedata fileref="images/test_install.png" format="PNG" align="center" scale="100"/> + <imagedata fileref="images/annoyed-facepalm-picard.svg"/> </imageobject> <imageobject role="fo"> <imagedata fileref="images/test_install.png" format="PNG" align="center" contentwidth="444px"/> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml 2012-07-04 04:53:20 UTC (rev 8766) @@ -5,7 +5,7 @@ <title>Remove JBoss Enterprise Application Platform</title> <para>Read this section to learn how to remove JBoss Enterprise Portal Platform from a server.</para> <task> - <title>Remove Platform by Deleting Root Installation Directory </title> + <title>Remove Platform by Deleting the Root Installation Directory </title> <tasksummary> <para>Complete this task to remove the root installation directory, which removes the platform from your system. To verify the root installation directory, ensure the directory contains the <filename>/jboss-as</filename> directory.</para> </tasksummary> @@ -26,7 +26,7 @@ </step> <step> <warning> - <para>This step completely removes the platform, and all related configuration files stored in the location indicated in Step 2. Ensure you have made copies of configuration files you may want to reuse if you decide to reinstall the platform later.</para> + <para>This step completely removes the platform, and all related configuration files stored in the location in Step 2. Ensure you have made copies of configuration files you may want to reuse if you decide to reinstall the platform later.</para> </warning> <para>Execute the following command, substituting <replaceable>[root_folder_name]</replaceable> with the full path, and name of the platform&apos;s root installation folder. </para> <para>If you installed the platform to a protected directory on your system, ensure you run this command with the correct access privileges.</para> Modified: epp/docs/branches/5.2/Installation_Guide/publican.cfg =================================================================== --- epp/docs/branches/5.2/Installation_Guide/publican.cfg 2012-07-03 12:10:17 UTC (rev 8765) +++ epp/docs/branches/5.2/Installation_Guide/publican.cfg 2012-07-04 04:53:20 UTC (rev 8766) @@ -2,5 +2,5 @@ type: Book brand: JBoss debug:1 -#show_remarks:1 +show_remarks:1 git_branch: docs-rhel-6