Author: mmcallis
Date: 2008-01-31 18:10:24 -0500 (Thu, 31 Jan 2008)
New Revision: 9689
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml
Log:
2.2.1.3. Database Setup adding a bit more content,
rephrasing
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
18:26:29 UTC (rev 9688)
+++
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-01-31
23:10:24 UTC (rev 9689)
@@ -83,33 +83,29 @@
</sect3>
<sect3>
<title>Database Setup</title>
- <para>You will need a database for JBoss Portal to run, you can use any
database
- supported by Hibernate.
+ <para>
+ A database is required for JBoss Portal to run. JBoss EAP and JBoss AS include an
embedded Hypersonic SQL database that JBoss Portal can use; however, this is only
recommended for developer use. The following databases are recommended for production use,
and have had test suites run against them: MySQL 4, MySQL 5, Microsoft SQL Server,
PostgreSQL 8, Oracle 9, and Oracle 10. JBoss Portal can use any database that is supported
by Hibernate.
+ </para>
+ <para>
+ To configure a database to use with JBoss Portal:
+ </para>
<orderedlist>
<listitem>
<para>
- <emphasis role="bold">Create a new
Database:</emphasis>
- For example purposes we call this new database
- <emphasis>jbossportal</emphasis>
+ <emphasis role="bold">Create a new Database:</emphasis>
this guide assumes that the new database will be called
<emphasis>jbossportal</emphasis>.
</para>
</listitem>
<listitem>
<para>
- <emphasis role="bold">Grant access rights for a
user to your database:</emphasis>
- You must make sure the user has access to this new DB, as JBoss
Portal will need to create the
- tables and modify data within them.
+ <emphasis role="bold">Grant access rights for a user to the
<emphasis>jbossportal</emphasis> database:</emphasis> JBoss Portal needs
to create tables and modify table data. Grant access rights to a desired user to the
<emphasis>jbossportal</emphasis> database. Configure the same username and
password in the Datasource descriptor.
</para>
</listitem>
<listitem>
<para>
- <emphasis role="bold">Deploy your JDBC
connector:</emphasis>
- You must make available a JDBC connector for JBoss Portal to
communicate with your database. The
- connector lib should be placed in
-
<filename>JBOSS_INSTALL_DIRECTORY/server/default/lib/*</filename>
+ <emphasis role="bold">Deploy a RDBMS JDBC
connector:</emphasis> a RDBMS JDBC connector is required for JBoss Portal to
communicate with a database. Copy the connector into the
<filename>JBOSS_INSTALL_DIRECTORY/server/default/lib/</filename> directory.
For example, a RDBMS JDBC connector for MySQL can be download from <ulink
url="http://www.mysql.com/products/connector/j/"></ulink>. For the
correct RDMBS JDBC connector, please refer to the database documentation.
</para>
</listitem>
</orderedlist>
- </para>
</sect3>
<sect3>
<title>DataSource Configuration</title>