[jboss-cvs] jboss-docs/jbossas/install/en ...
Norman Richards
norman.richards at jboss.com
Tue Sep 19 14:31:38 EDT 2006
User: nrichards
Date: 06/09/19 14:31:38
Modified: jbossas/install/en master.xml
Log:
installer
Revision Changes Path
1.2 +35 -18 jboss-docs/jbossas/install/en/master.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: master.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-docs/jbossas/install/en/master.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- master.xml 18 Sep 2006 16:48:19 -0000 1.1
+++ master.xml 19 Sep 2006 18:31:38 -0000 1.2
@@ -13,24 +13,38 @@
<holder>JBoss, Inc.</holder>
</copyright>
</bookinfo>
- <toc/>
+ <!-- <toc /> -->
- <chapter>
+ <!-- installing as a service on red hat? -->
+
+ <preface>
+ <title>About this Guide</title>
+ <para>JBoss, a J2EE 1.4 certified application server, is the most widely used open source application server on
+ the market. The highly flexible and easy-to-use server architecture has made JBoss the ideal choice for
+ users just starting out with J2EE, as well as senior architects looking for a customizable middleware
+ platform. The ready availability of the source code allows you to debug the server, learn its inner workings
+ and create customized versions for your personal or business use. This guide will show you how to download
+ and install JBoss 4.0. You will learn how to start and stop your JBoss instance, and you will also learn
+ about the directory structure and understand what the key services and configuration files are. </para>
+ </preface>
+
+
+ <chapter id="install">
<title>Installing JBoss</title>
- <para>JBoss, a free J2EE 1.4 certified application server, is the most widely used open source application
- server on the market. The highly flexible and easy-to-use server architecture has made JBoss the ideal
- choice for users just starting out with J2EE, as well as senior architects looking for a customizable
- middleware platform. The server binary and source code distributions are available from the SourceForge
- repository. (<ulink url="http://sourceforge.net/projects/jboss"
- >http://sourceforge.net/projects/jboss</ulink>). The ready availability of the source code allows you to
- debug the server, learn its inner workings and create customized versions for your personal or business use.</para>
- <para>This chapter will show you how to download and install JBoss 4.0. You will learn about the directory
- structure and understand what the key services and configuration files are. </para>
- <para>Before installing and running the server, you need to check your system to make sure you have a working
- Java 1.4 or 1.5 installation. Java 1.5 is required to use the new simplified EJB3 technologies. The simplest
+ <para>JBoss 4 requires either a Java 1.4 or Java 5 JVM (Java Virtual Machine) to run.
+ Before installing the server, you need to check your system to make sure you have a working
+ Java 1.4 or 1.5 installation.
+
+ Java 1.5 is required to use the new simplified EJB3 technologies.
+
+ </para>
+
+ <para>The simplest
way to check on your Java environment is to execute the <literal>java -version</literal> command to ensure
that the <literal>java</literal> executable is in your path and that you are using an appropriate version:</para>
+
+
<programlisting>[tmp]$ java -version
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_02-56)
Java HotSpot(TM) Client VM (build 1.5.0_02-36, mixed mode, sharing)</programlisting>
@@ -209,7 +223,7 @@
the complete image to work through all the examples. </para>
</chapter>
- <chapter>
+ <chapter id="dirs">
<title>Directory Structure</title>
<para>Installing the JBoss distribution creates a <literal>jboss-4.0.4</literal> directory that contains server
start scripts, JARs, server configuration sets and working directories. You need to know your way around the
@@ -269,7 +283,7 @@
<literal>server/default</literal> set. JBoss ships with <literal>minimal</literal>,
<literal>default</literal> and <literal>all</literal> configuration sets. The
subdirectories and key configuration files contained <literal>default</literal>
- configuration set are discussed in more detail in <xref linkend="ch1.config.section"/>
+ configuration set are discussed in more detail in <xref linkend="config-files"/>
</entry>
</row>
<row>
@@ -348,7 +362,7 @@
<para> The contents of the <literal>conf</literal> and <literal>deploy</literal> directories will be shown in
the following section. </para>
</chapter>
- <chapter id="ch1.config.section">
+ <chapter id="config-files">
<title>The Default Server Configuration File Set</title>
<para>The <literal>JBOSS_DIST/server</literal> directory contains one or more configuration file sets. The
<literal>default</literal> JBoss configuration file set is located in the
@@ -979,7 +993,7 @@
</variablelist>
</chapter>
- <chapter>
+ <chapter id="start-stop">
<title>Starting and Stopping JBoss</title>
<para>After you have installed the JBoss distribution, 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,
@@ -1093,6 +1107,9 @@
<para>Use of the shutdown command requires a server configuration that contains
<literal>jmx-invoker-service.xml</literal> service, so the shutdown command cannot be used with the
<literal>minimal</literal> configuration. </para>
+
</chapter>
+
+
</book>
More information about the jboss-cvs-commits
mailing list