[jboss-cvs] JBossAS SVN: r66202 - projects/docs/trunk/Installation_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Oct 17 00:20:10 EDT 2007
Author: mhideo at redhat.com
Date: 2007-10-17 00:20:10 -0400 (Wed, 17 Oct 2007)
New Revision: 66202
Removed:
projects/docs/trunk/Installation_Guide/en-US/Appendix.xml
projects/docs/trunk/Installation_Guide/en-US/Author_Group.xml
projects/docs/trunk/Installation_Guide/en-US/Book_Info.xml
projects/docs/trunk/Installation_Guide/en-US/Feedback.xml
projects/docs/trunk/Installation_Guide/en-US/Installation_Guide.xml
projects/docs/trunk/Installation_Guide/en-US/Installing_JBoss.xml
projects/docs/trunk/Installation_Guide/en-US/Legal_Notice.xml
projects/docs/trunk/Installation_Guide/en-US/Preface.xml
projects/docs/trunk/Installation_Guide/en-US/Revision_History.xml
Log:
init
Deleted: projects/docs/trunk/Installation_Guide/en-US/Appendix.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Appendix.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Appendix.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,13 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<appendix id="Book-Revision_History">
- <appendixinfo>
- <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- </appendixinfo>
- <title>Revision History</title>
- <para>
- </para>
-</appendix>
-
Deleted: projects/docs/trunk/Installation_Guide/en-US/Author_Group.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Author_Group.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Author_Group.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,5 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<authorgroup><corpauthor> JBoss Community Documentation Project </corpauthor></authorgroup>
Deleted: projects/docs/trunk/Installation_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Book_Info.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Book_Info.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,14 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<bookinfo>
- <title>JBoss Application Server</title>
- <subtitle>Installation Guide</subtitle>
- <issuenum>4.2</issuenum>
- <productnumber>2</productnumber>
- <!--copyright>
- <year>2007</year>
- <holder>Red Hat, Inc.</holder>
- </copyright-->
- <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</bookinfo>
Deleted: projects/docs/trunk/Installation_Guide/en-US/Feedback.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Feedback.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Feedback.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,23 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<section id="Book-We_Need_Feedback">
- <title>Help Contribute</title>
- <para>
- If you find a typographical error in the <citetitle>Installation Guide</citetitle>, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA: <ulink url="http://jira.jboss.com/jira/secure/IssueNavigator.jspa?reset=true&&pid=10030&resolution=-1&component=12311310&sorter/field=priority&sorter/order=DESC">http://jira.jboss.com</ulink> against the project <citetitle>JBoss Application Server</citetitle> and component <citetitle>Installation_Guide</citetitle>.
- </para>
- <para>
- If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.
- </para>
- <note><title>Note</title><para>Be sure to give us your name so you can receive full credit.</para></note>
-
- <note><title>Note</title><para>This content is taken from svn.jboss.org/repos/jbossas/projects/docs/trunk and has yet to be branched.</para></note>
-
- <para>To access the content directly and make changes yourself:</para>
- <screen>
- svn co https://svn.jboss.org/repos/jbossas/projects/docs/trunk --username yourname
- </screen>
-</section>
-
-
Deleted: projects/docs/trunk/Installation_Guide/en-US/Installation_Guide.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Installation_Guide.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Installation_Guide.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
- [
-
-]>
-<book>
- <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Installing_JBoss.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <!--xi:include href="Directory_Structure.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Configuration_Files.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Starting_Stopping_JBoss.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /-->
- <xi:include href="Appendix.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</book>
Deleted: projects/docs/trunk/Installation_Guide/en-US/Installing_JBoss.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Installing_JBoss.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Installing_JBoss.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,165 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<chapter id="install">
- <title>Installing JBoss</title>
- <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>
- <para>The most recent release of JBoss is available from the JBoss downloads page, <ulink url="http://www.jboss.org/products/jbossas/downloads"/>. After you have downloaded the version you want
- to install, use the JDK <literal>jar</literal> tool (or any other ZIP extraction tool) to extract the
- <literal>jboss-4.0.4.zip</literal> archive contents into a location of your choice. It does not matter
- where on your system you install JBoss. Note, however, that installing JBoss into a directory that has a
- name that contains spaces causes problems in some situations with Sun-based VMs. This is caused by bugs with
- file URLs not correctly escaping the spaces in the resulting URL. The <literal>jboss-4.0.4.tgz</literal>
- archive is a gzipped tar file that requires a gnutar-compatible tar program that can handle the long
- pathnames in the archive. The default tar binaries on Solaris and OS X do not currently support the long
- pathnames. </para>
- <para> JBoss also provides a GUI installer that can simplify the installation process. In addition to the basic
- installation, the installer allows you to select the which services are installed secure the JBoss
- management applications. Using a custom JBoss install created by the installer can greatly simplify the
- installation and configuration of JBoss. </para>
- <para>The installer can be run directly from a web browser using Java Web Start or can be downloaded as an
- executable JAR file named <literal>jboss-4.0.4-installer.jar</literal>. On many operating system, you can
- run executable JARs by double-clicking them. If your system doesn't support that, you can run the installer
- directly from the command line: </para>
- <programlisting>[tmp]$ java -jar jboss-4.0.4-installer.jar</programlisting>
- <para> When you launch the installer, you will be able to select the starting server configuration set, as shown
- in <xref linkend="ch1.installgroup.fig"/>.</para>
- <figure id="ch1.installgroup.fig">
- <title>The JBoss AS installer configuration set selection screen</title>
- <mediaobject>
- <imageobject>
- <imagedata align="center" fileref="images/installgroup.jpg"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The starting configuration determine which sets of packages are available for installation. The following
- table describes each of the configuration sets. </para>
- <table id="ch1.installgroup.table">
- <title>The JBoss AS installer configuration sets</title>
- <tgroup cols="3">
- <colspec colname="c1" colnum="1" colwidth="2*"/>
- <colspec colname="c2" colnum="2" colwidth="4*"/>
- <colspec colname="c3" colnum="3" colwidth="4*"/>
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Description</entry>
- <entry>Notes</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <literal>default</literal>
- </entry>
- <entry>A base J2EE 1.4 server profile.</entry>
- <entry/>
- </row>
- <row>
- <entry>
- <literal>all</literal>
- </entry>
- <entry>A full J2EE 1.4 server profile with enterprise extensions such as clustering and IIOP. </entry>
- <entry/>
- </row>
- <row>
- <entry>
- <literal>minimal</literal>
- </entry>
- <entry>A minimal JMX microkernel</entry>
- <entry>This is not a J2EE 1.4 compatible configuration.</entry>
- </row>
- <row>
- <entry>
- <literal>ejb3</literal>
- </entry>
- <entry>An EJB3 profile supporting the full EJB3 specification with Tomcat</entry>
- <entry>This requires a Java 5 runtime and is not a J2EE 1.4 compatible configuration.</entry>
- </row>
- <row>
- <entry>
- <literal>ejb3-clustered</literal>
- </entry>
- <entry>An EJB3 profile supporting the full EJB3 specification with Tomcat and clustering.</entry>
- <entry>This requires a Java 5 runtime and is not a J2EE 1.4 compatible configuration.</entry>
- </row>
- <row>
- <entry>
- <literal>jms</literal>
- </entry>
- <entry>A JMS 1.1 server profile</entry>
- <entry>This is not a J2EE 1.4 compatible configuration.</entry>
- </row>
- <row>
- <entry>
- <literal>tomcat</literal>
- </entry>
- <entry>A Servlet 2.4 container profile</entry>
- <entry>This is not a J2EE 1.4 compatible configuration.</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para> After selecting the configuration set, you have the option to further customize the services installed,
- eliminating unneeded options. When choosing configuration sets, be aware that you can not add packages not
- in the configuration set. If you you wanted a simple web container (the tomcat configuration) that also had
- JMS support (the jms configuration), it would be necessary to go to a larger configuration, such as the
- default configuration, and remove the unwanted packages. <xref linkend="ch1.install.fig"/> shows the package
- selection screen.</para>
- <figure id="ch1.install.fig">
- <title>The JBoss installer package selection screen</title>
- <mediaobject>
- <imageobject>
- <imagedata align="center" fileref="images/installer.jpg"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The following screen (<xref linkend="ch1.installconfig.fig"/>) allows for the customization of the server
- configuration name. Unless you need to create multiple configurations, you should use a configuration name
- of <literal>default</literal>. Use of any other configuration requires you to start JBoss with the
- <literal>-c</literal> option to specify the configuration JBoss should use. </para>
- <figure id="ch1.installconfig.fig">
- <title>The JBoss installer configuration name screen</title>
- <mediaobject>
- <imageobject>
- <imagedata align="center" fileref="images/installconfig.jpg"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The installer will then guide you through a few install customization screens. The first screen allows you
- to enable applications isolation, completely separating the classloading space of all applications.
- Application isolation can be helpful in some instances, but it comes with the cost of requiring slow
- pass-by-value semantics for passing data between applications. In most cases, it is preferable to use loader
- repositories to control the sharing of classes on an application-by-application basis rather than enabling
- isolation for the entire server. </para>
- <para> When installed from the tar/zip archive, all JBoss services are left in a developer-friendly state
- requiring no authentication to access most JBoss services, including administrative services. The installer
- gives you a chance to secure those services on the security screen, shown in <xref linkend="ch1.installsecurity.fig"/>. It is recommended that you click to enable security for all
- services and change the password from the default <literal>admin</literal>/<literal>admin</literal> values. </para>
- <figure id="ch1.installsecurity.fig">
- <title>The JBoss installer security configuration screen</title>
- <mediaobject>
- <imageobject>
- <imagedata align="center" fileref="images/installsecurity.jpg"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para> When you install from the installer, you get a smaller install image that is more tuned for your
- environment. However, the directory structure will be slightly different than when using the tar/zip
- archive. The examples in the book need to make use of many different configurations and will assume the
- complete install. Although use of the installer is recommended for normal JBoss use, you'll need to download
- the complete image to work through all the examples. </para>
-</chapter>
Deleted: projects/docs/trunk/Installation_Guide/en-US/Legal_Notice.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Legal_Notice.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Legal_Notice.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,17 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<legalnotice id="Book-Legal_Notice">
- <title>Legal Notice</title>
- <para>
- <address>
- <street>1801 Varsity Drive</street>
- <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country><phone>Phone: +1 919 754 3700</phone>
- <phone>Phone: 888 733 4281</phone>
- <fax>Fax: +1 919 754 3701</fax>
- <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>
- </address>
- </para>
-</legalnotice>
-
Deleted: projects/docs/trunk/Installation_Guide/en-US/Preface.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Preface.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Preface.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,18 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-
-<preface id="Book-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>
- <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</preface>
-
Deleted: projects/docs/trunk/Installation_Guide/en-US/Revision_History.xml
===================================================================
--- projects/docs/trunk/Installation_Guide/en-US/Revision_History.xml 2007-10-17 04:15:38 UTC (rev 66201)
+++ projects/docs/trunk/Installation_Guide/en-US/Revision_History.xml 2007-10-17 04:20:10 UTC (rev 66202)
@@ -1,22 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE revhistory PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<revhistory>
- <revision>
- <revnumber>4.2.2-1</revnumber>
- <date>Oct 15 2007</date>
- <author>
- <firstname>Michael</firstname>
- <surname>Hideo</surname>
- <email>mhideo at redhat.com</email>
- </author>
- <revdescription>
- <simplelist>
- <member>Migrated Content from 4.0.4</member>
-
- </simplelist>
- </revdescription>
- </revision>
-</revhistory>
-
More information about the jboss-cvs-commits
mailing list