Author: mmcallis
Date: 2008-02-03 23:44:30 -0500 (Sun, 03 Feb 2008)
New Revision: 9726
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml
Log:
updating 2.4. Deploying JBoss Portal
2.5. Portal Modules
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-02-04
04:12:45 UTC (rev 9725)
+++
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-02-04
04:44:30 UTC (rev 9726)
@@ -436,37 +436,61 @@
For further details about Datasource descriptors, please refer to the <ulink
url="http://wiki.jboss.org/wiki/Wiki.jsp?page=CreateAJDBCDataSource&...
JDBC Datasource wiki page</ulink>.
</para>
</sect2>
- <sect2>
- <title>Starting and running JBoss Portal</title>
- <para>
- <emphasis role="bold">Start the Server:</emphasis>
- Go to JBOSS_HOME/bin and execute run.bat (run.sh, if Linux)
- <note>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>
- </note>
- </para>
- <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:
- <emphasis>user/user</emphasis>
- or
- <emphasis>admin/admin</emphasis>
- .
- <note>
- This installs a bare version of Portal. In previous versions, several
additional modules were deployed as
- well but this has since been modularized to provide greater flexibility.
You might want to deploy
- additional modules to augment Portal (see
- <ulink
url="http://wiki.jboss.org/wiki/Wiki.jsp?page=PortalModules">...
module list</ulink> for more
- information). You can also deploy all the modules all at once using
<command>build deploy-all</command>
- in the <filename>build</filename> directory.
- </note>
- </para>
- </sect2>
- </sect1>
+</sect1>
+ <sect1>
+ <title>Deploying JBoss Portal</title>
+ <para>
+ To start JBoss EAP or JBoss AS and deploy JBoss Portal:
+ </para>
+ <para>
+ <orderedlist>
+ <listitem>
+ <para>
+ <emphasis role="bold">Datasource descriptor:</emphasis>
if you have not done so already, change into the <filename>setup</filename>
subdirectory where the JBoss Portal binary was extracted to. Copy the correct Datasource
descriptor file (<filename>*-ds.xml</filename>) you modified in the previous
steps into the
<filename>JBOSS_INSTALLATION_DIRECTORY/server/<replaceable>configuration</replaceable>/deploy/</filename>
directory.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Start the server:</emphasis>
change into the <filename>JBOSS_INSTALLATION_DIRECTORY/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 JBoss Portal:</emphasis>
using a Web browser, navigate to
<computeroutput>http://localhost:8080/portal</computeroutput> to open the
JBoss Portal homepage. 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>
+ <para>
+ <mediaobject>
+ <imageobject>
+ <imagedata align="center" valign="middle"
fileref="images/frontpage.png"/>
+ </imageobject>
+ </mediaobject>
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <note>
+ <title>SQL Errors</title>
+ <para>
+ Tables are automatically created the first time JBoss Portal starts. When
deployed for the first time, JBoss Portal checks for the existence of the initial tables,
which have not been created yet. This causes errors such as the following, which can
safely be ignored:
+ </para>
+ <para>
+<programlisting><![CDATA[
+WARN [JDBCExceptionReporter] SQL Error: -22, SQLState: S0002
+ERROR [JDBCExceptionReporter] Table not found in statement ...
+WARN [JDBCExceptionReporter] SQL Error: 1146, SQLState: 42S02
+ERROR [JDBCExceptionReporter] Table 'jbossportal.jbp_cms_repositoryentry'
doesn't exist
+WARN [JDBCExceptionReporter] SQL Error: 1146, SQLState: 42S02
+ERROR [JDBCExceptionReporter] Table 'jbossportal.jbp_cms_version_refs'
doesn't exist
+]]></programlisting>
+ </para>
+ </note>
+</sect1>
+<sect1>
+ <title>Portal Modules</title>
+ <para>
+ The previous steps install a bare version of JBoss Portal. In previous versions,
several additional modules were deployed as well, but this has since been modularized to
provide greater flexibility. To deploy additional modules, see the <ulink
url="http://wiki.jboss.org/wiki/Wiki.jsp?page=PortalModules">...
module list</ulink> for more information. To deploy all modules at once, change into
the <filename>build</filename> directory and run the <command>build
deploy-all</command> command.
+ </para>
+</sect1>
<!--<sect1 id="install_installer">
<title>Installing using the JEMS Installer</title>
<para>As of JBoss 4.0.4GA, users are able to install JBoss Portal using the
@@ -573,11 +597,5 @@
</sect2>
</sect1>-->
- <para>
- <mediaobject>
- <imageobject>
- <imagedata align="center" valign="middle"
fileref="images/frontpage.png"/>
- </imageobject>
- </mediaobject>
- </para>
+
</chapter>