[jboss-cvs] JBossAS SVN: r105593 - in projects/docs/community/6/Installation_And_Getting_Started_Guide: en-US and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Jun 2 16:08:53 EDT 2010
Author: smcgowan at redhat.com
Date: 2010-06-02 16:08:53 -0400 (Wed, 02 Jun 2010)
New Revision: 105593
Modified:
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Appendix2.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Getting_Started.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Installation.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Preface.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Setting_JBOSS_HOME.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Test_Your_Installation.xml
projects/docs/community/6/Installation_And_Getting_Started_Guide/pom.xml
Log:
JBAS-8006 - doc updates
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Appendix2.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Appendix2.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Appendix2.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -9,11 +9,9 @@
<para>
For more JBoss documentation related to JBoss Application Server 6 and its' underylying technologies, refer to the manuals available online at <ulink url="http://www.jboss.org/jbossas/docs/6-x.html"/>.
</para>
-<!--
<para>
- For general EJB instruction, with thorough JBoss coverage, see <emphasis>Enterprise JavaBeans, 5th Edition</emphasis>. (2010. Andrew Rubinger)
+ For the latest information on EJB 3.1 with thorough JBoss coverage see <ulink url="http:http://www.amazon.ca/Enterprise-JavaBeans-3-1-Andrew-Rubinger/dp/0596158025"><emphasis>Enterprise JavaBeans 3.1, 6th Edition</emphasis></ulink>. (O'Reilly, 2010. Andrew Rubinger, Bill Burke, Richard Monson-Haefel). The book examples show how Java EE integration testing is made easier using <ulink url="http://www.jboss.org/arquillian">Arquillian</ulink> and <ulink url="http://jboss.org/shrinkwrap">ShrinkWrap</ulink>, two breakthrough community projects simplifying Java EE integration testing.
</para>
--->
<para>
To learn more about Hibernate, see <emphasis>Java Persistence With Hibernate</emphasis>. (Manning, 2007. Christian Bauer, Gavin King)
</para>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Getting_Started.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Getting_Started.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Getting_Started.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -4,7 +4,7 @@
<chapter id="Getting_Started">
<title>Getting Started</title>
- <section id="Configuring your Java Environment">
+ <section id="Configuring your Java Environment"><title>
<para>
You must have a working installation of <emphasis>JDK 1.6</emphasis> before you install JBoss Application Server. You can install the 32-bit or 64-bit JVM depending on your requirements.
</para>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Installation.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Installation.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Installation.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -3,17 +3,49 @@
"http://www.docbook.org/xml/4.4/docbookx.dtd">
<chapter id="Installation">
- <title>Zip Distribution</title>
- <para>
- In this form of installation, simply unzip the downloaded zip file to the directory of your choice. You can unzip JBoss Application Server 6 on any operating system that supports the zip format. The zip file is available on <ulink url="http://labs.jboss.com/jbossas/downloads/"/>. Refer to the Release Notes for additional information on the milestone release you select for download which includes new features and bug fixes included in the release.
- </para>
-
+ <title>Installation</title>
+ <section id="Zip Distribution"><title>Installation with the Zip Distributino</title>
+ <para>
+ In this form of installation, simply unzip the downloaded zip file to the directory of your choice. You can unzip JBoss Application Server 6 on any operating system that supports the zip format. Zip distributions of the latest milestone releases are available on <ulink url="http://www.jboss.org/jbossas/downloads/">JBoss AS Download</ulink> site. Refer to the Release Notes for additional information on the milestone release you select for download which includes new features and bug fixes included in the release.
+ </para>
+</section>
- <title>Building Distribution from Source</title>
- <para>
- <emphasis>Source Files download</emphasis>
- </para>
- <para>
- Three types of server configurations will be included in your installation - <emphasis>minimal</emphasis>, <emphasis>default</emphasis>, and <emphasis>all</emphasis>.
- </para>
+ <section id="Building Distribution from Source"><title>Building Distribution from Source</title>
+ <para>Check out the latest version of the JBoss AS 6 sources from the anonymous <ulink url="http://anonsvn.jboss.org/repos/jbossas/trunk/">JBoss subversion repository</ulink>:</para>
+ <programlisting>
+ svn co http://anonsvn.jboss.org/repos/jbossas/trunk
+ </programlisting>
+
+<para> If you are already an authorized committer check out the sources providing your username and password from:</para>
+ <programlisting>
+ svn co https://svn.jboss.org/repos/jbossas/trunk --username your_username
+ </programlisting>
+
+<para>
+The location where the checked out source resides will be referenced as <emphasis>LOCAL_REPO_HOME</emphasis>.
+
+Change directory to <emphasis>$LOCAL_REPO_HOME</emphasis>.
+
+Refer to the <file>README.txt</file> file which gives an overview of building the JBoss Application Server 6 source distribution. JBoss Application Server 6 builds are fully mavenized. Build scripts are provided for UNIX and Windows operating systems. These scripts provide default settings to build out of box. As noted, you can call maven directly but that will require updates to your maven settings. For the latest information on building JBoss Application Server 6 with maven, refer to the following references:
+<itemizedlist>
+<listitem><ulink url="http://community.jboss.org/wiki/MavenGettingStarted-Users">Maven Getting Started for JBoss Users</ulink></listitem>
+<listitem><ulink url="http://community.jboss.org/wiki/MavenRepository-FAQ">Maven Repository FAQ</ulink></listitem>
+<listitem><ulink url="http://community.jboss.org/wiki/MavenSettingsExample-Developers">Maven Settings Example for Developers</ulink></listitem>
+</itemizedlist>
+If you have additional questions, post your question on the <ulink url="http://community.jboss.org/en/jbossas/">JBoss AS community forum</ulink>.
+</para>
+
+To build JBoss Application Server 6, simply execute:
+
+<programlisting>
+On Unix:
+<literal>./build.sh</literal>
+</programlisting>
+<programlisting>
+On Windows:
+<literal>build</literal>
+</programlisting>
+
+<para>Refer to the <ulink url="http://www.jboss.org/help/contributingcode.html">Contributing Code</ulink> wiki if you're interested in getting involved and want to become a committer. </para>
+</section>
</chapter>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Preface.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Preface.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Preface.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -1,7 +1,8 @@
<?xml version='1.0'?>
-<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd">
-<preface id="Book-Preface">
+<chapter id="Book-Preface">
+ <section id="Introduction">
<title>Introduction</title>
<para>
JBoss Application Server 6 is the open source implementation of the Java EE 6 Enterprise Edition Platform. It comprises the set of technologies for enterprise developers looking for an easy-to-use, out-of-box, robust solution for running enterprise applications. Offering an extensible core architecture, JBoss Application Server 6 is the ideal choice for users new to enterprise development as well as senior architects looking for a customizable middleware platform.
@@ -9,15 +10,10 @@
<para>
Because it is Java-based, JBoss Application Server 6 runs on any operating system that supports Java. This guide will provide information to get you started using JBoss Application Server 6 in a few easy steps. It will also provide an overview of the distribution layout and other feature highlight. The readily available source code is a powerful learning tool to debug the server and understand it. It also gives you the flexibility to create customized versions for your personal or business use.</para>
+</section>
<section id="Book-We_Need_Feedback">
<title>Help Contribute</title>
<para>
- If you find a typographical error in the <citetitle>Installation Guide and Getting Started Guide</citetitle>, or if you have thought of a way to make this manual better, please submit a report in JIRA: <ulink url="http://jira.jboss.com">http://jira.jboss.com</ulink> against the project <citetitle>JBoss Application Server</citetitle> and component <citetitle>Docs/Installation and Getting Started Guide</citetitle>.
- </para>
-
- <para>To access the content directly and make changes yourself:</para>
- <screen>
- svn co https://svn.jboss.org/repos/jbossas/projects/docs/community/6 --username yourusername
- </screen>
- </section></preface>
-
+ If you find a typographical error in the <citetitle>Installation Guide and Getting Started Guide</citetitle>, or if you have thought of a way to make this manual better, please submit a report in JIRA: <ulink url="http://jira.jboss.com">http://jira.jboss.com</ulink> against the project <citetitle>JBoss Application Server</citetitle> and component <citetitle>Docs/Installation and Getting Started Guide</citetitle>.</para>
+ </section>
+</chapter>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Setting_JBOSS_HOME.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Setting_JBOSS_HOME.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Setting_JBOSS_HOME.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -21,7 +21,7 @@
# User specific aliases and functions
# The following are the environment variables for Java, ANT and JBoss
-export JAVA_HOME=/usr/java/jdk1.6.0_07
+export JAVA_HOME=/usr/java/jdk1.6.0_18
export PATH=$PATH:$JAVA_HOME/bin
export ANT_HOME=/usr/ant/apache-ant-1.6.0
@@ -55,7 +55,7 @@
</para>
</listitem>
</itemizedlist>
- You are now ready to start the JBoss Application Server.
+ You are now ready to start JBoss Application Server 6.
</para>
</section>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Test_Your_Installation.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Test_Your_Installation.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/en-US/Test_Your_Installation.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -4,7 +4,7 @@
<chapter id="Test_your_Installation">
<title>Test your Installation</title>
<para>
- After you have installed the JBoss Application Server, it is wise to perform a simple startup test to validate that there are no major problems with your Java VM/operating system combination. To test your installation, open the <filename>JBOSS_DIST/jboss-<release>/bin</filename> directory and execute the <filename>run.bat</filename> (for Windows) or <filename>run.sh</filename> (for Linux) script, as appropriate for your operating system.
+ After you have installed or built the JBoss Application Server, it is wise to perform a simple startup test to validate that there are no major problems with your Java VM/operating system combination. To test your installation, open the <filename>JBOSS_DIST/jboss-<release>/bin</filename> directory and execute the <filename>run.bat</filename> (for Windows) or <filename>run.sh</filename> (for Unix) script, as appropriate for your operating system.
</para>
<para>
Your output should look similar to the following (accounting for installation directory differences) and contain no error or exception messages:
@@ -15,31 +15,20 @@
JBoss Bootstrap Environment
- JBOSS_HOME: /home/svn/JBossHead/jboss-head/build/output/jboss-5.0.0.GA
+ JBOSS_HOME: /home/jboss-head/build/target/jboss-6.0.0-SNAPSHOT
JAVA: /Library/Java/Home/bin/java
JAVA_OPTS: -Dprogram.name=run.sh -Xms128m -Xmx512m -XX:MaxPermSize=256m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000
- CLASSPATH: /home/svn/JBossHead/jboss-head/build/output/jboss-5.0.0.GA/bin/run.jar
+ CLASSPATH: /home/jboss-head/build/target/jboss-6.0.0-SNAPSHOT/bin/run.jar
=========================================================================
- 21:47:23,874 INFO [ServerImpl] Starting JBoss (Microcontainer)...
- 21:47:23,875 INFO [ServerImpl] Release ID: JBoss [Morpheus] 5.0.0.GA (build: SVNTag=JBoss_5_0_0_GA date=200812011226)
- .
- .
...output truncated
- .
- .
- 21:47:46,090 INFO [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009
- 21:47:46,112 INFO [ServerImpl] JBoss (Microcontainer) [5.0.0.GA (build: SVNTag=JBoss_5_0_0_GA date=200812011226)] Started in 22s:227ms
+ 21:05:03,808 INFO [org.jboss.bootstrap.impl.base.server.AbstractServer] (Thread-2) JBossAS [6.0.0.SNAPSHOT "Neo"] Started
+
</screen>
- <!--<note>
- <para>
- Note that there is no "Server Started" message shown at the console when the server is started using the <literal>default</literal> profile, which is the default profile used when no other is specified. This message may be observed in the <filename>server.log</filename> file located in the <filename>server/defaut/log</filename> subdirectory.
- </para>
- </note>-->
<para>
Now open <literal>http://localhost:8080</literal> in your web browser. (Make sure you dont have anything else already on your machine using that port).<footnote><para>
Note that on some machines, the name localhost may not resolve properly and you may need to use the local loopback address 127.0.0.1 instead.</para></footnote> The contents of your page should look similar to the following: <xref linkend="Test_your_Installation-Test_your_Installation"/>.
@@ -55,6 +44,6 @@
</figure>
</para>
<para>
- You are now ready to use the JBoss Application Server.
+ You are now ready to use the JBoss Application Server. This landing page provides links to assist in managing your JBoss AS instance as well as many on-line resources.
</para>
</chapter>
Modified: projects/docs/community/6/Installation_And_Getting_Started_Guide/pom.xml
===================================================================
--- projects/docs/community/6/Installation_And_Getting_Started_Guide/pom.xml 2010-06-02 20:05:56 UTC (rev 105592)
+++ projects/docs/community/6/Installation_And_Getting_Started_Guide/pom.xml 2010-06-02 20:08:53 UTC (rev 105593)
@@ -58,15 +58,15 @@
<finalName>index.html</finalName>
</format>
+<!--
<format>
<formatName>pdf</formatName>
<stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource>
<finalName>Installation_And_Getting_Started_Guide.pdf</finalName>
- <profilingTypeName>two_pass</profilingTypeName>
</format>
- <!--<format>
+ <format>
<formatName>eclipse</formatName>
<stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>
<finalName>index.html</finalName>
@@ -74,11 +74,12 @@
</formats>
<options>
<xincludeSupported>true</xincludeSupported>
- <xmlTransformerType>saxon</xmlTransformerType>
+ <!--<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> -->
+ <!--
+ <docbookVersion>1.72.0</docbookVersion>
<transformerParameters>
<property>
<name>javax.xml.parsers.DocumentBuilderFactory</name>
@@ -88,10 +89,11 @@
<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>
+ <!-- </transformerParameters> -->
</options>
</configuration>
</plugin>
More information about the jboss-cvs-commits
mailing list