10:39 p.m.
Author: jaredmorgs
Date: 2012-02-28 23:39:06 -0500 (Tue, 28 Feb 2012)
New Revision: 8489
Modified:
epp/docs/branches/5.2/Installation_Guide/en-US/Author_Group.xml
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/Revision_History.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
Log:
Improved MySQL IDM and JCR chapter, and Test Your Installation chapter
Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Author_Group.xml
===================================================================
--- epp/docs/branches/5.2/Installation_Guide/en-US/Author_Group.xml 2012-02-29 02:48:07
UTC (rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/Author_Group.xml 2012-02-29 04:39:06
UTC (rev 8489)
@@ -6,20 +6,20 @@
%BOOK_ENTITIES;
]>
<authorgroup>
- <editor>
- <firstname>Scott</firstname>
- <surname>Mumford</surname>
+ <author>
+ <firstname>Jared</firstname>
+ <surname>Morgan</surname>
<affiliation>
<shortaffil>Red Hat</shortaffil>
<orgdiv>Engineering Content Services</orgdiv>
</affiliation>
- </editor>
+ </author>
<editor>
- <firstname>Luc</firstname>
- <surname>Texier</surname>
+ <firstname>Scott</firstname>
+ <surname>Mumford</surname>
<affiliation>
<shortaffil>Red Hat</shortaffil>
- <orgdiv>JBoss Engineering</orgdiv>
+ <orgdiv>Engineering Content Services</orgdiv>
</affiliation>
</editor>
<editor>
@@ -39,6 +39,6 @@
</emphasis></orgname>
<orgdiv>Documentation Teams</orgdiv>
</affiliation>
- <contrib>Original product documentation by:</contrib>
+ <contrib>Original project documentation by:</contrib>
</othercredit>
</authorgroup>
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-02-29 02:48:07 UTC
(rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-02-29 04:39:06 UTC
(rev 8489)
@@ -9,10 +9,10 @@
<productname>JBoss Enterprise Portal Platform</productname>
<productnumber>5.2</productnumber>
<edition>5.2.1</edition>
- <pubsnumber>4</pubsnumber>
+ <pubsnumber>7</pubsnumber>
<abstract>
<para>
- This book provides information about obtaining, installing and running JBoss
Enterprise Portal Platform. It forms part of the complete document suite along with the
<emphasis role="bold">User Guide</emphasis> and <emphasis
role="bold">Reference Guide</emphasis> available at <ulink
url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf...
type="http"/>.
+ This book provides information about obtaining, installing and running JBoss
Enterprise Portal Platform. 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>
</abstract>
<corpauthor>
Modified: epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml
===================================================================
--- epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-02-29
02:48:07 UTC (rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-02-29
04:39:06 UTC (rev 8489)
@@ -375,73 +375,89 @@
<para>Before starting the server for the first time, continue to <xref
linkend="sect-Reference_Guide-EMail_Service_Configuration"/> for the next
mandatory configuration requirement.</para>
</section>
<section>
- <title><remark>BZ#794386 </remark>Example with MySQL Server
5.1</title>
+ <title><remark>BZ#794386 and BZ#794687 </remark>MySQL Server 5.1
JCR and IDM Example</title>
<para>This section describes an example how to configure MySQL to work with a
single portal container. Refer to <xref
linkend="Multiple_Portal_JRC_IDM"/> if you need to configure multiple portal
containers in your installation, or intend to use Site Publisher. </para>
<para>More information about setting up other datasources can be found in the
JBoss Enterprise Application Platform <citetitle>Getting Started
Guide</citetitle>, in the <citetitle>Using Other Databases</citetitle>
chapter. </para>
- <formalpara
id="form-Portal_EAP-Using_a_MySQL_Database-Installing_the_MySQL_RDBMS_JDBC_connector">
- <title>Installing the MySQL JDBC connector</title>
- <para>The MySQL JDBC connector is required for EPP to use a
<application>MySQL</application> database:</para>
- </formalpara>
- <para>
- The <literal>mysql-java-connector</literal> package is available
through <ulink
url="https://www.redhat.com/wapps/sso/rhn/login.html?redirect=http%3...
type="http">Red Hat Network</ulink>. This is the recommended
installation method.
- </para>
- <para>
- For users who are not able to access the Red Hat Network,
<application>MySQL</application> is available directly from <ulink
url="http://www.mysql.com/downloads/connector/j/"
type="http">http://www.mysql.com</ulink>. You should download a version
listed in the Certified Configurations table available on the <ulink
url="http://www.jboss.com/products/platforms/portals/testedconfigura...
Enterprise Portal Platform</ulink> JBoss website.
- </para>
- <formalpara
id="form-Portal_EAP-Using_a_MySQL_Database-Creating_a_MySQL_Database">
- <title>Creating a MySQL Database</title>
+ <important>
+ <title>Important</title>
<para>
- If you have just installed MySQL, make sure the MySQL server is running,
and then run the following command to set the root user password:
+ Some underlying JBoss Enterprise Application Platform services may still be
using Hypersonic which is an in-VM database server loaded in the same memory space. To
connect these services to another RDBMS, or disable them, refer to the JBoss Enterprise
Application Platform documentation, or contact JBoss Support for assistance.
</para>
- </formalpara>
- <para>
-<screen>
-mysqladmin -u root password
'<replaceable>new-root-user-password</replaceable>'
-</screen>
- </para>
- <orderedlist>
- <listitem>
+ </important>
+ <task id="task-Create_a_MySQL_Database">
+ <title>Task: Create a MySQL Database</title>
+ <tasksummary>
+ <para>Complete this task to configure MySQL with the required database
tables and user information for a single portal instance.</para>
+ <para>The MySQL JDBC connector is required to use a
<application>MySQL</application> database.</para>
<para>
+ The <literal>mysql-java-connector</literal> package is available
through <ulink
url="https://www.redhat.com/wapps/sso/rhn/login.html?redirect=http%3...
type="http">Red Hat Network</ulink>. </para>
+ <note>
+ <title>Note: Database Names</title>
+ <para>The configuration examples that follow assume the database names to
be <replaceable>gateinjcr</replaceable> and
<replaceable>gateinidm</replaceable>. If you change the database names,
update the <filename>gatein-ds.xml</filename> datasource descriptor file
accordingly (for each server configuration used).
+ </para>
+ </note>
+ </tasksummary>
+ <taskprerequisites>
+ <title>Prerequisites</title>
+ <itemizedlist>
+ <listitem>
+ <para>Complete <xref
linkend="task-Create_Production_Database"/> to install the
<literal>mysql-java-connector</literal> package mentioned in the task
summary.</para>
+ </listitem>
+ <listitem>
+ <para>Read and understand the basics of IDM and JCR provisioning in
<xref linkend="Single_Portal_JCR_IDM"/></para>
+ </listitem>
+ <listitem>
+ <para>Be familiar with MySQL commands.</para>
+ </listitem>
+ </itemizedlist>
+ </taskprerequisites>
+ <procedure>
+ <step>
+ <para>
+ If you have just installed MySQL, make sure the MySQL server is running,
and then run the following command to set the root user password:
+ </para>
+ <programlisting>mysqladmin -u root password
'<replaceable>new-root-user-password</replaceable>'</programlisting>
+ </step>
+ <step>
+ <para>
Run the following command to log in to MySQL. Enter the root user
password when prompted:
</para>
- <para>
-<screen>
-mysql -u root -p
-</screen>
+ <programlisting>mysql -u root -p</programlisting>
+ </step>
+ <step>
+ <para>
+ Use the <command>CREATE DATABASE</command> command to
create a new <replaceable>gateinjcr</replaceable> database.
</para>
- </listitem>
- <listitem>
- <para>
- Use the <command>CREATE DATABASE</command> command to
create a new gateinjcr database.
+ <warning>
+ <para>MyISAM storage engine is not supported in JBoss Enterprise Portal
Platform, and may lead to data corruption if used. </para>
+ </warning>
+ <programlisting>mysql> CREATE DATABASE
gateinjcr;</programlisting>
+ <formalpara>
+ <title>Result</title>
+ <para>
+ The database is created, and MySQL returns a status similar to the
following:
</para>
- <note>
- <title>Note: Database names</title>
- <para>
- The remainder of this guide, and the configuration examples that
follow assume the database names to be gateinjcr and gateinidm. If you change the database
names, please update <filename>gatein-ds.xml</filename> accordingly (for each
server configuration used).
- </para>
- </note>
- <para>
-<screen>
-mysql> CREATE DATABASE gateinjcr;
-</screen>
+ </formalpara>
+ <screen>Query OK, 1 row affected (0.00 sec)</screen>
+ </step>
+ <step>
+ <para>
+ Use the <command>CREATE DATABASE</command> command to
create a new <replaceable>gateinidm</replaceable> database.
</para>
- <para>
- The output should be similar to the following:
+ <programlisting>mysql> CREATE DATABASE
gateinidm;</programlisting>
+ <formalpara>
+ <title>Result</title>
+ <para>
+ The database is created, and MySQL returns a status similar to the
following:
</para>
- <screen>
-Query OK, 1 row affected (0.00 sec)
-</screen>
- <para>
- Then repeat with:
- </para>
- <screen>mysql> CREATE DATABASE gateinidm;
-</screen>
- <para>
- At this point, the <command>SHOW DATABASES;</command>
command should display the <command>gatein</command> databases:
+ </formalpara>
+ <screen>Query OK, 1 row affected (0.00 sec)</screen>
+ </step>
+ <step>
+ <para>Execute the <command>SHOW DATABASES;</command> command
to display and verify the <replaceable>gatein</replaceable> databases:
</para>
- <para>
-<screen>
-mysql> SHOW DATABASES;
+ <para>
+<screen>mysql> SHOW DATABASES;
+--------------------+
| Database |
+--------------------+
@@ -450,110 +466,70 @@
| gateinidm |
| mysql |
+--------------------+
-4 rows in set (0.00 sec)
-</screen>
+4 rows in set (0.00 sec)</screen>
</para>
- <para>
- It is safe to ignore the other databases.
+ <note>
+ <para>
+ It is safe to ignore the other databases for the purposes of this
procedure.
</para>
- </listitem>
- <listitem>
- <para>
- Add a new user and give that user access to the gatein databases. The
following example adds a new user named
<computeroutput>gateinuser</computeroutput>, with the password
<computeroutput>gateinpassword</computeroutput>. It is recommended that you
choose a different password to the one supplied here by changing
<replaceable>gateinpassword</replaceable> to some other password:
+ </note>
+ </step>
+ <step>
+ <para>Add a new user. </para>
+ <para>The following example adds a new user named
<literal>gateinuser</literal>, with the password
<literal>gateinpassword</literal>. Choose a different password to the one
supplied here by changing <replaceable>gateinpassword</replaceable> to a
unique value:
</para>
- <screen>CREATE USER
'gateinuser'@'localhost' IDENTIFIED BY
'gateinpassword';</screen>
- </listitem>
- <listitem>
- <para>
- Grant the necessary privileges to the user:
+ <programlisting>CREATE USER
'<replaceable>gateinuser</replaceable>'@'localhost'
IDENTIFIED BY
'<replaceable>gateinpassword</replaceable>';</programlisting>
+ </step>
+ <step>
+ <para>
+ Grant read/write privileges to the user on both databases:
</para>
- <para>
-<screen>
-mysql> GRANT ALL PRIVILEGES ON gateinjcr.* TO
'<replaceable>gateinuser</replaceable>'@'localhost'
+ <programlisting>mysql> GRANT ALL PRIVILEGES ON gateinjcr.* TO
'<replaceable>gateinuser</replaceable>'@'localhost'
IDENTIFIED BY '<replaceable>gateinpassword</replaceable>'
WITH GRANT OPTION;
-</screen>
-<screen>
+
mysql> GRANT ALL PRIVILEGES ON gateinidm.* TO
'<replaceable>gateinuser</replaceable>'@'localhost'
-IDENTIFIED BY '<replaceable>gateinpassword</replaceable>'
WITH GRANT OPTION;
-</screen>
- </para>
-<!--
- <note><title>Note: Changed password?</title>
- <para>
- If you changed the portal user's password, remember to also
change the password in the MySQL Datasource descriptor.
- </para>
- </note>
---> </listitem>
- </orderedlist>
- <formalpara
id="form-Portal_EAP-Using_a_MySQL_Database-MySQL_Datasource_Descriptor">
- <title>MySQL Datasource Descriptor</title>
- <para>
- You now need to change the portal database descriptor
+IDENTIFIED BY '<replaceable>gateinpassword</replaceable>'
WITH GRANT OPTION;</programlisting>
+ </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's datasource descriptor.
</para>
- </formalpara>
- <orderedlist>
- <listitem>
- <para>
- Edit the file located at
<filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/gatein-ds.xml</filename>.
+ <task>
+ <title>Task: Edit Portal Datasource Descriptor</title>
+ <tasksummary>
+ <para>Complete this task to define the database and database user
credentials the portal instance will use to communicate with the MySQL
database.</para>
+ </tasksummary>
+ <taskprerequisites>
+ <title>Prerequisites</title>
+ <itemizedlist>
+ <listitem>
+ <para>Complete all requirements in <xref
linkend="task-Create_a_MySQL_Database"/></para>
+ </listitem>
+ </itemizedlist>
+ </taskprerequisites>
+ <procedure>
+ <title>Edit Datasource Descriptor</title>
+ <step>
+ <para>Edit the file located at
<filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/gatein-ds.xml</filename>.
</para>
- </listitem>
- <listitem>
- <para>
- Update the following lines in the Datasource descriptor to reflect
the correct database, username and password respectively:
- <itemizedlist>
- <listitem>
- <para>
-
<computeroutput><connection-url>jdbc:mysql://mysql-hostname:3306/<replaceable>DATABASE</replaceable></connection-url></computeroutput>;
- <itemizedlist>
- <listitem>
- <para>
- In this example the database name is
<literal>gateinjcr</literal> for the first datasource listed in
<filename>gatein-ds.xml</filename>.
- </para>
- </listitem>
- <listitem>
- <para>
- The database name for the second datasource is
<literal>gateinidm</literal>. See the example
<filename>gatein-ds.xml</filename> file provided.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- <listitem>
- <para>
-
<computeroutput><user-name><replaceable>USER-NAME</replaceable></user-name></computeroutput>;
- <itemizedlist>
- <listitem>
- <para>
- The user-name for this example is
<literal>gateinuser</literal>.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- <listitem>
- <para>
-
<computeroutput><password><replaceable>PASSWORD</replaceable></password></computeroutput>;
- <itemizedlist>
- <listitem>
- <para>
- This example uses the
<literal>gateinpassword</literal> password. Enter this or the password chosen
at <xref
linkend="form-Portal_EAP-Using_a_MySQL_Database-Creating_a_MySQL_Database"/>.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </itemizedlist>
+ </step>
+ <step>
+ <para>Update following lines in the Datasource descriptor to reflect the
correct database, username and password respectively.
+
</para>
- </listitem>
- </orderedlist>
- <para><filename>gatein-ds.xml</filename> will then look
like:</para>
- <programlisting language="XML"><![CDATA[<datasources>
+ <programlisting language="XML"><![CDATA[<datasources>
<no-tx-datasource>
- <jndi-name>gatein-idm</jndi-name>
-
<connection-url>jdbc:mysql://mysql-hostname:3306/gateinidm</connection-url>
+
<jndi-name><replaceable>gatein-idm</replaceable></jndi-name>
+
<connection-url>jdbc:mysql://mysql-hostname:3306/<replaceable>gateinidm</replaceable></connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
- <user-name>gateinuser</user-name>
- <password>gateinpassword</password>
+
<user-name><replaceable>gateinuser</replaceable></user-name>
+
<password><replaceable>gateinpassword</replaceable></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
@@ -562,24 +538,26 @@
</no-tx-datasource>
<local-tx-datasource>
- <jndi-name>gatein-jcr</jndi-name>
-
<connection-url>jdbc:mysql://mysql-hostname:3306/gateinjcr</connection-url>
+
<jndi-name><replaceable>gatein-jcr</replaceable></jndi-name>
+
<connection-url>jdbc:mysql://mysql-hostname:3306/<replaceable>gateinjcr</replaceable></connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
- <user-name>gateinuser</user-name>
- <password>gateinpassword</password>
+
<user-name><replaceable>gateinuser</replaceable></user-name>
+
<password><replaceable>gateinpassword</replaceable></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>0</idle-timeout-minutes>
<prepared-statement-cache-size>32</prepared-statement-cache-size>
</local-tx-datasource>
-</datasources>]]>
-</programlisting>
- <important>
- <title>Important</title>
- <para>
- Some underlying JBoss Enterprise Application Platform services might still be
using Hypersonic which is an in-VM database server loaded in the same memory space. To
connect these services to another RDBMS or disable them please refer to the JBoss
Enterprise Application Platform documentation, or contact JBoss Support for assistance.
- </para>
- </important>
+</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>
+ </step>
+ </procedure>
+ </task>
</section>
</section>
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-02-29
02:48:07 UTC (rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-02-29
04:39:06 UTC (rev 8489)
@@ -9,6 +9,20 @@
<simpara>
<revhistory>
<revision>
+ <revnumber>5.2.1-7</revnumber>
+ <date>Wed Feb 29 2012</date>
+ <author>
+ <firstname>Jared</firstname>
+ <surname>Morgan</surname>
+ <email/>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Incorporated https://bugzilla.redhat.com/show_bug.cgi?id=794687
by adding a Warning to the SQL database example chapter (and completely reworking the
section into task-based format). </member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ <revision>
<revnumber>5.2.1-4</revnumber>
<date>Tue Feb 28 2012</date>
<author>
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-02-29
02:48:07 UTC (rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml 2012-02-29
04:39:06 UTC (rev 8489)
@@ -4,44 +4,44 @@
%BOOK_ENTITIES;
]>
<chapter id="Test_your_Installation">
- <title>Test your Installation</title>
- <para>
- After you have installed the JBoss Enterprise Portal Platform, it is wise to
perform a simple start up test to validate that there are no major problems with your Java
VM/operating system combination. Make sure you have set the
<literal>JBOSS_HOME</literal> environment variables as explained in <xref
linkend="Post_Installation_Configuration"/>.
+ <title><remark>BZ#794687 </remark>Test your
Installation</title>
+ <para>After you have installed the JBoss Enterprise Portal Platform, it is wise
to perform a simple start up test to validate that there are no major problems with your
Java VM/operating system combination. Ensure you have set the
<literal>JBOSS_HOME</literal> environment variables as explained in <xref
linkend="Post_Installation_Configuration"/>.
</para>
- <warning>
- <title>Warning: Sybase Requirements</title>
- <para>Sybase requires a particular configuration of JBoss Enterprise Portal
Platform, to switch on that configuration, it is
+ <task>
+ <title>Task: Test Your Installation</title>
+ <tasksummary>
+ <para>Complete this task to verify your server starts, and navigate to the
Portal management console.</para>
+ <warning>
+ <title>Warning: Sybase Requirements</title>
+ <para>Sybase requires a particular configuration of JBoss Enterprise Portal
Platform, to switch on that configuration, it is
mandatory to run the portal with the extra <literal>sybase</literal>
profile. This would
mean to run the application server with <literal>sh run.sh
-Dexo.profiles=sybase</literal> in a single node
and <literal>sh run.sh -Dexo.profiles=sybase,cluster</literal> for a
cluster node.</para>
- </warning>
- <para>
- To test your installation:
- <itemizedlist>
- <listitem>
- <para>
- move to the
<filename><replaceable>JBOSS_HOME</replaceable>/bin</filename>
directory;
+ </warning>
+ </tasksummary>
+ <taskprerequisites>
+ <title>Prerequisites</title>
+ <itemizedlist>
+ <listitem>
+ <para>Complete all previous tasks and procedures in this user guide, or
assess each task for relevance to your installation.</para>
+ </listitem>
+ </itemizedlist>
+ </taskprerequisites>
+ <procedure>
+ <step>
+ <para>Move to the
<filename><replaceable>JBOSS_HOME</replaceable>/bin</filename>
directory.
</para>
- </listitem>
- <listitem>
- <para>
- execute the <filename>run.bat</filename> (for Windows) or
<filename>run.sh</filename> (for Linux) script, as appropriate for your
operating system;
- <itemizedlist>
- <listitem>
- <para>
- Ensure that you run the configuration corresponding to the
<filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/</filename>
chosen in <xref
linkend="form-Portal_EAP-Using_a_MySQL_Database-Creating_a_MySQL_Database"/>
- </para>
- </listitem>
- </itemizedlist>
+ </step>
+ <step>
+ <para>Execute the <filename>run.bat</filename> (for Windows) or
<filename>run.sh</filename> (for Linux) script, with the name of the server
profile you have configured as part of the tasks in this guide.
+
</para>
- </listitem>
- </itemizedlist>
- </para>
- <para>
+ <example>
+ <title>Sample Server Output using Production</title>
+ <para>
The example below uses the production configuration. Your output should look
like the following (accounting for installation directory differences and version numbers)
and should not contain any error or exception messages:
</para>
- <programlisting>
-[user@localhost bin]$ ./run.sh -c production
+ <programlisting>[user@localhost bin]$ ./run.sh -c production
=========================================================================
JBoss Bootstrap Environment
@@ -70,35 +70,47 @@
...
23:27:32,061 INFO [JMXKernel] Legacy JMX core initialized
</programlisting>
- <note>
- <title>Note: Production server log file</title>
- <para>
+ </example>
+ <note>
+ <title>Note: Production server log file</title>
+ <para>
There is no "Server Started" message shown at the console
when the server is started using the <literal>production</literal> profile.
This message may be observed in the <filename>server.log</filename> file
located in the
<filename><replaceable>JBOSS_HOME</replaceable>/server/production/log</filename>
subdirectory.
</para>
- </note>
- <para>
- Ensure that port 8080 is not already in use and open
<literal>http://localhost:8080/portal</literal> in your web browser.
- <note>
- <para>
- On some machines, the name localhost won’t resolve properly and you should use
the local loopback address <uri>127.0.0.1</uri> instead.
+ </note>
+ </step>
+ <step>
+ <para>Open <literal>http://localhost:8080/portal</literal> in
your web browser.
+ </para>
+ <para>If you have secured your portal for production use by following
<xref linkend="sect-Installation_Guide-HTTPS_Configuration"/>, open
<literal>https://localhost:8443/portal</literal><note>
+ <para>On some machines, the name
<literal>localhost</literal> will not resolve correctly and you should use the
local loopback address 127.0.0.1 instead.
+ </para>
+ </note>
+ </para>
+ </step>
+ <step>
+ <formalpara>
+ <title>Result</title>
+ <para>The contents of your page should look similar to <xref
linkend="Test_your_Installation-Test_your_Installation"/>.
</para>
- </note>
- The contents of your page should look similar to this: <xref
linkend="Test_your_Installation-Test_your_Installation"/>.
+ </formalpara>
+ <para>
+ You are now ready to use JBoss Enterprise Portal Platform. Refer to the
<citetitle>User Guide</citetitle> and <citetitle>Reference
Guide</citetitle> for more information about the product's feature set and
example applications showcasing JBoss Enterprise Portal Platform in action.
</para>
- <para>
<figure id="Test_your_Installation-Test_your_Installation">
- <title>Test your Installation</title>
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="images/test_install.png"
format="PNG" align="center" scale="100"/>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="images/test_install.png"
format="PNG" align="center" contentwidth="444px"/>
- </imageobject>
- </mediaobject>
- </figure>
- </para>
+ <title>Test your Installation</title>
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="images/test_install.png"
format="PNG" align="center" scale="100"/>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="images/test_install.png"
format="PNG" align="center" contentwidth="444px"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </step>
+ </procedure>
+ </task>
<para>
- You are now ready to use JBoss Enterprise Portal Platform. Refer to the User
Guide and Reference Guide for more information about the product's feature set
and example applications showcasing JBoss Enterprise Portal Platform in action.
+
</para>
</chapter>
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-02-29 02:48:07
UTC (rev 8488)
+++ epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml 2012-02-29 04:39:06
UTC (rev 8489)
@@ -4,8 +4,7 @@
%BOOK_ENTITIES;
]>
<chapter id="Uninstall_JBoss">
- <title>Uninstall JBoss Enterprise Portal Platform</title>
- <para>
- As JBoss Enterprise Portal Platform is installed from a Zip file, you can remove it by
deleting the JBoss Enterprise Portal Platform directory installed on your system.
+ <title>Remove the Platform</title>
+ <para>You can remove the platform by deleting the JBoss Enterprise Portal
Platform directory installed on your system.
</para>
</chapter>