[jboss-cvs] JBossAS SVN: r69599 - in projects/docs/trunk: AS_5/Getting_Started/en-US and 4 other directories.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Mon Feb 4 23:30:19 EST 2008


Author: skittoli at redhat.com
Date: 2008-02-04 23:30:19 -0500 (Mon, 04 Feb 2008)
New Revision: 69599

Modified:
   projects/docs/trunk/AS_4/Getting_Started/en-US/Using_Other_Databases.xml
   projects/docs/trunk/AS_5/Getting_Started/en-US/Using_Other_Databases.xml
   projects/docs/trunk/AS_5/Installation_Guide/en-US/Setting_JBOSS_HOME.xml
   projects/docs/trunk/AS_5/Installation_Guide/pom.xml
   projects/docs/trunk/AS_5/Server_Configuration_Guide/en-US/Virtual_Deployment_Framework.xml
   projects/docs/trunk/AS_5/Server_Configuration_Guide/pom.xml
Log:
updates

Modified: projects/docs/trunk/AS_4/Getting_Started/en-US/Using_Other_Databases.xml
===================================================================
--- projects/docs/trunk/AS_4/Getting_Started/en-US/Using_Other_Databases.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_4/Getting_Started/en-US/Using_Other_Databases.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -5,13 +5,13 @@
 <chapter id="Using_other_Databases">
 	<title>Using other Databases</title>
 	<para>
-		In the previous chapters, we’ve just been using the JBossAS default datasource in our applications. This datasource is configured to use the embedded Hypersonic database instance shipped by default with the distribution. This datasource is bound to the JNDI name <literal>java:/DefaultDS</literal> and its descriptor is named <literal>hsqldb-ds.xml</literal> under the deploy directory 
+		In the previous chapters, we have been using the JBoss Application Server default datasource in our applications. This datasource is configured to use the embedded Hypersonic database instance shipped by default with the distribution. This datasource is bound to the JNDI name <literal>java:/DefaultDS</literal> and its descriptor is named <literal>hsqldb-ds.xml</literal> under the deploy directory 
 	</para>
 	<para>
-		Having a database included with JBossAS is very convenient for running the server and examples out-of-the-box . However, this database is not a production quality database and as such should not be used with enterprise-class deployments. As a consequence of this JBoss Support does not provide any official support for Hypersonic.
+		Having a database included with JBoss Application Server is very convenient for running the server and examples out-of-the-box. However, this database is not a production quality database and as such should not be used with enterprise-class deployments. As a consequence of this JBoss Support does not provide any official support for Hypersonic.
 	</para>
 	<para>
-		In this chapter we will explain in details how to configure and deploy a datasource to connect JBossAS to the most popular database servers available on the market today.
+		In this chapter we will explain in details how to configure and deploy a datasource to connect JBoss Application Server to the most popular database servers available on the market today.
 	</para>
 	
 	<section id="Using_other_Databases-DataSource_Configuration_Files">
@@ -39,14 +39,11 @@
 	<section id="Using_other_Databases-Using_MySQL_as_the_Default_DataSource">
 		<title>Using MySQL as the Default DataSource</title>
 		<para>
-			The MySQL® database has become the world's most popular open source database thanks to its consistent fast performance, high reliability and ease of use. This database server is used in millions of installations ranging from large corporations to specialized embedded applications across every continent of the world. . In this section, we'll be using the community version of their database server (GA 5.0.45)  and the latest JDBC driver (GA 5.1.5) both available at <ulink url="http://www.mysql.com"></ulink>.
+			The MySQL® database has become the world's most popular open source database thanks to its consistent fast performance, high reliability and ease of use. This database server is used in millions of installations ranging from large corporations to specialized embedded applications across every continent of the world. In this section, we'll be using the community version of their database server (GA 5.0.45)  and the latest JDBC driver (GA 5.1.5) both available at <ulink url="http://dev.mysql.com"></ulink>.
 		</para>
 	
 		
 		
-		
-		
-		
 		<section id="Using_MySQL_as_the_Default_DataSource-Installing_the_JDBC_Driver_and_Deploying_the_DataSource">
 			<title>Installing the JDBC Driver and Deploying the datasource</title>
 			
@@ -84,7 +81,7 @@
 <section id="configuring_jbossmq_persistence_manager"><title>Configuring JBoss MQ Persistence Manager</title>
 	<para>
 		The persistence manager of JBoss MQ uses the default datasource to create tables to store JMS messages, transaction data and other indexes. The DDLs used by this service are vendor-specific and should be updated accordingly as follows:
-		From docs/examples/jms, copy mysql-jdbc2-service.xml over to deploy/jms. Then delete the existing hsqldb-jdbc2-service.xml file located in the same folder. Last, make sure to point the service at the right datasource jndi name i.e. “DefaultDS”:
+		From <literal>docs/examples/jms</literal>, copy <filename>mysql-jdbc2-service.xml</filename> over to <literal>deploy/jms</literal>. Then delete the existing hsqldb-jdbc2-service.xml file located in the same folder. Last, make sure to point the service at the right datasource jndi name i.e. “DefaultDS”:
 	</para>
 <programlisting> <![CDATA[
 <mbean code="org.jboss.mq.pm.jdbc2.PersistenceManager"
@@ -104,7 +101,7 @@
 		
 		
 		<section id="Using_MySQL_as_the_Default_DataSource-Testing_the_MySQL_DataSource">
-			<title>Testing the MySQL DataSource</title>
+			<title>Testing the data source</title>
 			<para>
 				Using the test client described in <xref linkend="creating_a_jdbc_client"/>, you may now verify the proper installation of your datasource. 
 			</para>
@@ -119,7 +116,7 @@
 			Oracle is one of the main players in the commercial database field and most readers will probably have come across it at some point. You can download it freely for non-commercial purposes from <ulink url="http://www.oracle.com/technology/products/database/xe/index.html"/>
 		</para>
 		<para>
-		In this section, we'll connect the server to Oracle Database 10g Express Edition using the latest JDBC driver (11g)  available at <ulink url="http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html"/>
+		In this section, we'll connect the server to Oracle Database 10g Express Edition using the latest JDBC driver (11g) available at <ulink url="http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html"/>
 		</para>
 			
 		
@@ -185,9 +182,9 @@
 		<section id="Setting_up_an_XADataSource_with_Oracle_9i-Testing_the_Oracle_DataSource">
 			<title>Testing the Oracle DataSource</title>
 			<para>
-				Before you can verify the datasource configuration, Oracle XE should be reconfigured to avoid port conflict with JBossAS as by default they  both start a web server on port 8080.
+				Before you can verify the datasource configuration, Oracle XE should be reconfigured to avoid port conflict with JBoss AS as by default they  both start a web server on port 8080.
 			</para>
-			<para>Open up an Oracle SQLcommand line and execute the following commands:
+			<para>Open up an Oracle SQL command line and execute the following commands:
 			</para>
 <screen>
 <command>SQL> connect;
@@ -207,7 +204,7 @@
 
 <para>
 	The web server started by Oracle XE to provide http-based administration tools is now running on port 8090.
-	Start the JBossAS server instance as you would normally do. You are now ready to use the test client described in Chapter 6.5 to verify the proper installation of your datasource. 
+	Start the JBoss AS server instance as you would normally do. You are now ready to use the test client described in Chapter 6.5 to verify the proper installation of your datasource. 
 </para>
 	
 		</section>
@@ -238,7 +235,7 @@
 	  <type-mapping>MS SQLSERVER2000</type-mapping>
   </metadata>
   </local-tx-datasource>
-</datasources> ]]>		
+</datasources> ]]>
 </programlisting>
 
 The datasource is pointing at a database “pubs” provided by default with MS SQL Server 2000.

Modified: projects/docs/trunk/AS_5/Getting_Started/en-US/Using_Other_Databases.xml
===================================================================
--- projects/docs/trunk/AS_5/Getting_Started/en-US/Using_Other_Databases.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_5/Getting_Started/en-US/Using_Other_Databases.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -202,7 +202,7 @@
 SQL> <command>select dbms_xdb.gethttpport from dual;</command>
 GETHTTPPORT
 -----------
-8090	
+8090
 </screen>
 
 <para>
@@ -220,10 +220,10 @@
 		
 		<section><title>Installing the JDBC Driver and Deploying the DataSource</title>
 		<para>
-			To make the JDBC driver classes available to JBoss Application Server, copy the archive sqljdbc.jar from the sqljdbc_1.2 distribution to the lib directory in the default server configuration (assuming that is the server configuration you’re running).
+			To make the JDBC driver classes available to JBoss Application Server, copy the archive <filename>sqljdbc.jar</filename> from the <filename>sqljdbc_1.2</filename> distribution to the <filename>lib</filename> directory in the default server configuration (assuming that is the server configuration you’re running).
 		</para>
 		<para>
-			Then create a text file in the deploy directory called mssql-ds.xml with the following datasource descriptor :
+			Then create a text file in the <literal>deploy</literal> directory called <literal>mssql-ds.xml</literal> with the following datasource descriptor :
 <programlisting><![CDATA[ 
 <?xml version="1.0" encoding="UTF-8"?>
 <datasources>
@@ -310,7 +310,7 @@
   if(con != null){
   con.close();
  }      
-}]]></programlisting>
+}]]> %> </programlisting>
 
 Open up a web browser and hit the url: <ulink url="http://localhost:8080/jdbcclient/client.jsp"/>.
 A list of users and password should show up as a result of the jdbc query:

Modified: projects/docs/trunk/AS_5/Installation_Guide/en-US/Setting_JBOSS_HOME.xml
===================================================================
--- projects/docs/trunk/AS_5/Installation_Guide/en-US/Setting_JBOSS_HOME.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_5/Installation_Guide/en-US/Setting_JBOSS_HOME.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -46,7 +46,7 @@
 		<itemizedlist>
 			<listitem>
 				<para>
-				Create an environment variable called <literal>JBOSS_HOME</literal> that points to the JBoss Application Server installation directory, for example: <literal>C:\Program\Files\JBoss\jboss-5.0.0.&lt;release&gt;\</literal>.
+				Create an environment variable called <literal>JBOSS_HOME</literal> that points to the JBoss Application Server installation directory, for example: <literal>C:\Program Files\JBoss\jboss-5.0.0.&lt;release&gt;\</literal>.
 				</para>
 			</listitem>
 			<listitem>

Modified: projects/docs/trunk/AS_5/Installation_Guide/pom.xml
===================================================================
--- projects/docs/trunk/AS_5/Installation_Guide/pom.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_5/Installation_Guide/pom.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -4,12 +4,11 @@
 
     <modelVersion>4.0.0</modelVersion>
 
-
-    <groupId>org.hibernate-sandbox</groupId>
-    <artifactId>docbook-testing</artifactId>
+    <groupId>org.jboss.jbossas</groupId>
+    <artifactId>installation-guide-${translation}</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jdocbook</packaging>
-    <name>Server Installation Guide (${translation})</name>
+    <name>Installation Guide (${translation})</name>
 
     <build>
         <plugins>
@@ -18,61 +17,77 @@
                 <artifactId>maven-jdocbook-plugin</artifactId>
                 <version>2.0.0</version>
                 <extensions>true</extensions>
-                <!--dependencies>
+                <dependencies>
                     <dependency>
-                        <groupId>org.hibernate</groupId>
-                        <artifactId>hibernate-docbook-xslt</artifactId>
+                        <groupId>org.jboss</groupId>
+                        <artifactId>jbossorg-docbook-xslt</artifactId>
+                        <version>1.0.0</version>
+                    </dependency>
+                    <dependency>
+                        <groupId>org.jboss</groupId>
+                        <artifactId>jbossorg-jdocbook-style</artifactId>
+                        <version>1.0.0</version>
                         <type>jdocbook-style</type>
-                        <version>0.1</version>
                     </dependency>
-                </dependencies-->
+                </dependencies>
                 <configuration>
-                    <sourceDocumentName>Installation_Guide.xml</sourceDocumentName>
+                    <!--minmemory>1024m</minmemory>
+                    <maxmemory>1024m</maxmemory -->
+                    <sourceDocumentName>resolved.xml</sourceDocumentName>
+                    <sourceDirectory>en-US</sourceDirectory>
                     <imageResource>
                         <directory>en-US</directory>
-                        <excludes>
-                            <exclude>*.xml</exclude>
-                        </excludes>
+                        <includes>
+                          <include>images/*</include>
+                        </includes>
                     </imageResource>
                     <cssResource>
-                        <directory>en-US</directory>
-                        <excludes>
-                            <exclude>*.xml</exclude>
-                        </excludes>
+                        <directory>src/main/css</directory>
                     </cssResource>
+<!--put back css -->
+
                     <formats>
-                        <format>
+                    <format>
                             <formatName>pdf</formatName>
-                            <!--stylesheetResource>classpath:/standard/fopdf.xsl</stylesheetResource-->
+                            <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>
 			    <finalName>Installation_Guide.pdf</finalName>
                         </format>
                         <format>
                             <formatName>html</formatName>
-			    <!--stylesheetResource>classpath:/standard/html_chunk.xsl</stylesheetResource-->
+			    <stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>
                             <finalName>index.html</finalName>
                         </format>
-<!--
-                        <format>
+                    <!--<format>
                             <formatName>html_single</formatName>
                             <stylesheetResource>classpath:/xslt/nochunk-html.xsl</stylesheetResource>
-                        </format>
--->
-<!--                        <format>
+                        </format>-->
+                    <!--<format>
                             <formatName>eclipse</formatName>
                             <stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>
                             <finalName>index.html</finalName>
-                        </format>
--->
+                        </format>-->
                     </formats>
                     <options>
                         <xincludeSupported>true</xincludeSupported>
                         <xmlTransformerType>saxon</xmlTransformerType>
                         <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme -->
                         <!--     could also locate the docbook dependency and inspect its version... -->
-                        <docbookVersion>1.72.0</docbookVersion>
+                        <!--docbookVersion>1.72.0</docbookVersion -->
+			<docbookVersion>1.72.0</docbookVersion>
+                        <transformerParameters>
+                          <property>
+                              <name>javax.xml.parsers.DocumentBuilderFactory</name>
+                              <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value>
+                          </property>
+                          <property>
+                              <name>javax.xml.parsers.SAXParserFactory</name>
+                              <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value>
+                          </property>
+                          <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory>
+                          <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory>
+                          <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>org.apache.xerces.jaxp.validation.XMLSchemaFactory</javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>-->
+                        </transformerParameters>
                     </options>
-
-		<sourceDirectory>${basedir}/en-US</sourceDirectory>
                 </configuration>
             </plugin>
         </plugins>
@@ -80,6 +95,5 @@
 
     <properties>
         <translation>en-US</translation>
-    </properties>
-
+    </properties> 
 </project>

Modified: projects/docs/trunk/AS_5/Server_Configuration_Guide/en-US/Virtual_Deployment_Framework.xml
===================================================================
--- projects/docs/trunk/AS_5/Server_Configuration_Guide/en-US/Virtual_Deployment_Framework.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_5/Server_Configuration_Guide/en-US/Virtual_Deployment_Framework.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -11,7 +11,7 @@
 			<title>The JBoss5 Deployment Framework Classes</title>
 			<mediaobject>
 				<imageobject>
-					<imagedata align="center" fileref="images/vdf.jpg" />
+					<imagedata align="center" fileref="images/vdf.png" />
 				</imageobject>
 			</mediaobject>
 		</figure>

Modified: projects/docs/trunk/AS_5/Server_Configuration_Guide/pom.xml
===================================================================
--- projects/docs/trunk/AS_5/Server_Configuration_Guide/pom.xml	2008-02-05 04:03:23 UTC (rev 69598)
+++ projects/docs/trunk/AS_5/Server_Configuration_Guide/pom.xml	2008-02-05 04:30:19 UTC (rev 69599)
@@ -4,9 +4,8 @@
 
     <modelVersion>4.0.0</modelVersion>
 
-
-    <groupId>org.hibernate-sandbox</groupId>
-    <artifactId>docbook-testing</artifactId>
+    <groupId>org.jboss.jbossas</groupId>
+    <artifactId>server-configuration-guide-${translation}</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jdocbook</packaging>
     <name>Server Configuration Guide (${translation})</name>
@@ -18,51 +17,53 @@
                 <artifactId>maven-jdocbook-plugin</artifactId>
                 <version>2.0.0</version>
                 <extensions>true</extensions>
-                <!--dependencies>
+                <dependencies>
                     <dependency>
-                        <groupId>org.hibernate</groupId>
-                        <artifactId>hibernate-docbook-xslt</artifactId>
+                        <groupId>org.jboss</groupId>
+                        <artifactId>jbossorg-docbook-xslt</artifactId>
+                        <version>1.0.0</version>
+                    </dependency>
+                    <dependency>
+                        <groupId>org.jboss</groupId>
+                        <artifactId>jbossorg-jdocbook-style</artifactId>
+                        <version>1.0.0</version>
                         <type>jdocbook-style</type>
-                        <version>0.1</version>
                     </dependency>
-                </dependencies-->
+                </dependencies>
                 <configuration>
-                    <sourceDocumentName>Server_Configuration_Guide.xml</sourceDocumentName>
+                    <minmemory>1024m</minmemory>
+                    <maxmemory>1024m</maxmemory>
+                    <sourceDocumentName>resolved.xml</sourceDocumentName>
+                    <sourceDirectory>en-US</sourceDirectory>
                     <imageResource>
                         <directory>en-US</directory>
-                        <excludes>
-                            <exclude>*.xml</exclude>
-                        </excludes>
+                        <includes>
+                          <include>images/*</include>
+                        </includes>
                     </imageResource>
-                    <cssResource>
-                        <directory>en-US</directory>
-                        <excludes>
-                            <exclude>*.xml</exclude>
-                        </excludes>
-                    </cssResource>
+                    <!--<cssResource>
+                        <directory>src/main/css</directory>
+                    </cssResource>-->
                     <formats>
-                        <format>
+                    <format>
                             <formatName>pdf</formatName>
-                            <!--stylesheetResource>classpath:/standard/fopdf.xsl</stylesheetResource-->
+                            <stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>
 			    <finalName>Server_Configuration_Guide.pdf</finalName>
                         </format>
                         <format>
                             <formatName>html</formatName>
-			    <!--stylesheetResource>classpath:/standard/html_chunk.xsl</stylesheetResource-->
+			    <stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>
                             <finalName>index.html</finalName>
                         </format>
-<!--
-                        <format>
+                    <!--<format>
                             <formatName>html_single</formatName>
                             <stylesheetResource>classpath:/xslt/nochunk-html.xsl</stylesheetResource>
-                        </format>
--->
-<!--                        <format>
+                        </format>-->
+                    <!--<format>
                             <formatName>eclipse</formatName>
                             <stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>
                             <finalName>index.html</finalName>
-                        </format>
--->
+                        </format>-->
                     </formats>
                     <options>
                         <xincludeSupported>true</xincludeSupported>
@@ -70,9 +71,20 @@
                         <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme -->
                         <!--     could also locate the docbook dependency and inspect its version... -->
                         <docbookVersion>1.72.0</docbookVersion>
+                        <transformerParameters>
+                          <property>
+                              <name>javax.xml.parsers.DocumentBuilderFactory</name>
+                              <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value>
+                          </property>
+                          <property>
+                              <name>javax.xml.parsers.SAXParserFactory</name>
+                              <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value>
+                          </property>
+                          <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory>
+                          <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory>
+                          <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>org.apache.xerces.jaxp.validation.XMLSchemaFactory</javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>-->
+                        </transformerParameters>
                     </options>
-
-		<sourceDirectory>${basedir}/en-US</sourceDirectory>
                 </configuration>
             </plugin>
         </plugins>
@@ -80,6 +92,5 @@
 
     <properties>
         <translation>en-US</translation>
-    </properties>
-
+    </properties> 
 </project>




More information about the jboss-cvs-commits mailing list