Author: mmcallis Date: 2008-01-31 19:02:29 -0500 (Thu, 31 Jan 2008) New Revision: 9691 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml Log: adding more content to 2.2.1.4. Datasource Configuration 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 23:58:12 UTC (rev 9690) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-02-01 00:02:29 UTC (rev 9691) @@ -57,7 +57,7 @@ <sect3 id="install_binarydownload"> <title>Getting the Binary</title> <para> - The binary download is available from the <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... Portal Downloads</ulink> page. Look for the <computeroutput>JBoss Portal Binary</computeroutput> package. Once the binary zip file is downloaded and extracted, the folder hierarchy will look like the following: + The binary download is available from the <ulink url="http://labs.jboss.com/portal/jbossportal/download/index.html&qu... Portal Downloads</ulink> page. Look for the <computeroutput>JBoss Portal Binary</computeroutput> package. Once the binary zip file has been downloaded and extracted, the folder hierarchy will look similar to the following: </para> <para> <mediaobject> @@ -92,7 +92,7 @@ <orderedlist> <listitem> <para> - <emphasis role="bold">Create a new Database:</emphasis> this guide assumes that the new database will be called <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> @@ -108,24 +108,22 @@ </orderedlist> </sect3> <sect3> - <title>DataSource Configuration</title> - <para> - The JBoss Portal download you extracted in - <xref linkend="install_binarydownload"/> - contains pre-configured datasource descriptors, you can use for most popular RDBMS under the - <emphasis>setup</emphasis> - directory. For more details about the datasource descriptor or if your database server is not part - of the pre-built descriptors, please refer to - <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=CreateAJDBCDataSource&... dedicated wiki page.</ulink> - <mediaobject> - <imageobject> - <imagedata align="center" valign="middle" fileref="images/setup/dsfiles.png"/> - </imageobject> + <title>Datasource Configuration</title> + <para> + The JBoss Portal binary download that was extracted in <xref linkend="install_binarydownload"/>, contains pre-configured Datasource descriptors for the more popular databases. Datasource descriptors are provided for the MySQL 4, MySQL 5, PostgreSQL, Microsoft SQL Server, and Oracle databases, and can be found in the <filename>setup</filename> subdirectory where the JBoss Portal binary was extracted to: + </para> + <mediaobject> + <imageobject> + <imagedata align="center" valign="middle" fileref="images/setup/dsfiles.png"/> + </imageobject> </mediaobject> - </para> - <para>At this point, you should configure the one that suits you best with your Database and JDBC - driver. - <programlisting><![CDATA[ + <para> + Copy the Datasource descriptor that matches your database into the <filename>JBOSS_INSTALLATION_DIRECTORY/server/<replaceable>configuration</replaceable>/deploy/</filename> directory, where <replaceable>configuration</replaceable> is either all, default, minimal, or production. For example, if you are using the production configuration, copy the Datasource descriptor into the <filename>JBOSS_INSTALLATION_DIRECTORY/server/production/deploy/</filename> directory. + </para> + <para> + After the Datasource descriptor has been copied into the <filename>deploy</filename> directory, make sure the username, password, connection-url, and driver-class are correct for your chosen database. Datasource descriptor files can be deployed to test before being used in production. The following is an example Datasource descriptor for the PostgreSQL database: + </para> +<programlisting><![CDATA[ <?xml version="1.0" encoding="UTF-8"?> <datasources> <local-tx-datasource> @@ -136,11 +134,10 @@ <password>portalpassword</password> </local-tx-datasource> </datasources> - ]]></programlisting> - Please verify that the username, password, url, and driver-class are correct for - your flavor of DB. You can deploy the datasource file by itself to test, in - advance. - </para> +]]></programlisting> + <para> + 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> </sect3> </sect2> <sect2>