Author: mmcallis Date: 2008-01-31 00:14:15 -0500 (Thu, 31 Jan 2008) New Revision: 9663 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/supported.xml Log: changing bundle install to use an orderedlist/procedure Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-01-31 04:25:15 UTC (rev 9662) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-01-31 05:14:15 UTC (rev 9663) @@ -1,53 +1,44 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="installation"> <title>Installation</title> - <para>Depending on your needs, there are several different methods to get JBoss Portal up and running. - <note>Pre-configured clustered versions are available - from the - <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... page</ulink>. - The installation differences, being that they must be deployed in the <emphasis>all</emphasis> - configuration in JBoss AS and all your instances must reference the same datasource. Read - <xref linkend="clustering"/> for more details on how to customize your clustered install, once deployed. - </note> + <para>Depending on your needs, there are several different methods to install JBoss Portal. Pre-configured clustered versions (<computeroutput>JBoss Portal Binary (Clustered)</computeroutput>) are available from the + <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... Portal Downloads</ulink> page. Clustered versions of JBoss Portal must be deployed in the <filename><replaceable>JBOSS_INSTALLATION_DIRECTORY</replaceable>/server/all/deploy/</filename> directory. All JBoss AS instances must reference the same datasource. See <xref linkend="clustering"/> for details on how to configure JBoss Portal for clustering. </para> <sect1 id="install_bundle"> - <title>Installing from Bundled Download</title> - <para>This is the easiest and fastest way to get JBoss Portal installed and running. The reason is that the - download bundle contains JBoss Application Server, and JBoss Portal uses the embedded Hypersonic Database. + <title>JBoss Portal and JBoss AS Bundle</title> + <para>This is the easiest and fastest way to get JBoss Portal installed and running. The JBoss AS and JBoss Portal bundle contains JBoss AS, JBoss Portal, and the embedded Hypersonic SQL database. To install the JBoss Portal and JBoss AS bundle: </para> - <sect2> - <title>Installing the Bundle</title> - <para> - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Get the Bundle:</emphasis> - The download bundle is available from our - <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... page</ulink> - . Bundles are noted with the 'JBoss Portal + AS' naming convention. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Extract the bundle:</emphasis> - Extract the zip archive to a directory of your choosing. In windows, we - recommend, <command>C:\jboss-X.X.X</command> - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Start the Server:</emphasis> - Go to JBOSS_INSTALL_DIRECTORY/bin and execute <command>run.bat</command> (<command>run.sh</command>, if - Linux) - </para> - </listitem> - </itemizedlist> - <note>During the first boot (ever), SQL errors in the log, like the one below, can be safely ignored. They + <orderedlist> + <listitem> + <para> + <emphasis role="bold">Get the Bundle:</emphasis> the bundle is available from the <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... Portal Downloads</ulink> page. Bundles use the <computeroutput>JBoss Portal + JBoss AS</computeroutput> naming convention. + </para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Extract the bundle:</emphasis> extract the zip archive. It does not matter which directory is used. On Microsoft Windows, the recommended directory is <filename>C:\jboss-<replaceable>version-number</replaceable></filename>. + </para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Start the Server:</emphasis> change into the <filename>$JBOSS_HOME/bin</filename> directory. On Microsoft Windows, execute <command>run.bat</command>. On Linux, run the <command>./run.sh</command> command. + </para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Log in to Portal:</emphasis> use a Web browser to navigate to <computeroutput>http://localhost:8080/portal</computeroutput>. The JBoss Portal home page should appear. Log in using one of the two default accounts: username <emphasis>user</emphasis>, password <emphasis>user</emphasis>, or username <emphasis>admin</emphasis>, password <emphasis>admin</emphasis>. + </para> + </listitem> + </orderedlist> + <note> + <para>During the first boot (ever), SQL errors in the log, like the one below, can be safely ignored. They are thrown when the portal checks for the existence of the initial tables, before it creates them for you. <programlisting><![CDATA[16:43:39,234 WARN [JDBCExceptionReporter] SQL Error: -22, SQLState: S0002 16:43:39,234 ERROR [JDBCExceptionReporter] Table not found in statement ...]]></programlisting> + </para> </note> + <para> Point your browser to <emphasis>http://localhost:8080/portal</emphasis> , and you should see the Portal HomePage. You can now login using one of the two default accounts: @@ -55,7 +46,6 @@ or <emphasis>admin/admin</emphasis>. </para> - </sect2> </sect1> <sect1 id="install_binary"> <title>Installing from Binary Download</title> Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/supported.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/supported.xml 2008-01-31 04:25:15 UTC (rev 9662) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/supported.xml 2008-01-31 05:14:15 UTC (rev 9663) @@ -58,7 +58,7 @@ <listitem>MaxDB</listitem> </itemizedlist> <note> - <para>JBoss Portal employs <ulink url="http://hibernate.org/">Hibernate</ulink> as an interface to a relational database management system (RDBMS). Most relational database management systems supported by Hibernate will work with JBoss Portal.</para> + <para>JBoss Portal employs Hibernate as an interface to a relational database management system (RDBMS). Most relational database management systems supported by Hibernate will work with JBoss Portal.</para> </note> </sect1> <sect1>