[jboss-jira] [JBoss JIRA] Created: (JBAS-6011) Comments on Installation and Getting Started Guide

Tue Sep 30 23:04:21 EDT 2008

Comments on Installation and Getting Started Guide 
---------------------------------------------------

                 Key: JBAS-6011
                 URL: https://jira.jboss.org/jira/browse/JBAS-6011
             Project: JBoss Application Server
          Issue Type: Bug
      Security Level: Public (Everyone can see)
          Components: Docs/Installation and Getting Started Guide
    Affects Versions: JBossAS-5.0.0.CR2
            Reporter: Shelly McGowan
            Assignee: Samson Kittoli

Section 1.1 PreRequisites
The wiki reference:
Refer to http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossOperatingSystemSpecificIssues 
refers to issues with Linux 2.6 kernels and installation of JBoss AS 3.x on a MainFrame.
This reference should be removed.  

Section 1.1.1 Hardware and Operating System Requirements
This section refers to "supported" OS/JVM/DB combinations.  There is no support offered for the community release.

Section 1.1.2:  Configuring your Java Environment
Both JDK5 and JDK6 can be used with JBoss AS 5.  Please add JDK 6 to this section. 

Chapter 2 - Installation Alternatives

Binary Files Download
ADD
(extracted from release notes) JBossAS 5.0.0  can be compiled with both Java5 & Java6. The Java5 compiled binary is our primary/recommended binary 
distribution. It has undergone rigorous testing and can run under both a Java 5 and a Java 6 runtime. When running 
under Java 6 you need to manually copy the following libraries from the JBOSS_HOME/client directory to the 
JBOSS_HOME/lib/endorsed directory, so that the JAX-WS 2.0 apis supported by JBossWS are used:

    * jbossws-native-saaj.jar
    * jbossws-native-jaxrpc.jar
    * jbossws-native-jaxws.jar
    * jbossws-native-jaxws-ext.jar

The other option is to download the jdk6 distribution (jboss-5.0.0.CR2-jdk6.zip) in which case no configuration 
changes are required.   

Refer to the release notes for additional information about running with JDK 6.

Correct the following:
"Four types of server configurations will be included in your installation -  minimal  ,  default  , and  all  . The Getting Started Guide explains in detail the different server configuration file sets." to refer to only Three server configurations.  Instead of the reference to the Getting Started Guide (this guide), refer to the section that discusses this topic.

Section 3.1 Download and Installation

Replace references to jboss-4.2.2 to jboss-5.0.0

There are two binary distributions available:
jboss-5.0.0.CR2.zip
jboss-5.0.0.CR2-jdk6.zip

Source File Download

ANT and mvn are  included with the JBoss distribution in <installdir>/tools/ so the downloading this section of ANT should be removed.

4.3 Building with Ant
[from release notes: If you are building JBossAS from source you'll notice we are migrating to a maven2 build. At this point the build is 
a hybrid one because it declares all JBoss dependencies as maven2 artifacts, however after the dependencies are 
resolved/imported the legacy ant based build is used to compile and build the distribution. This will change to a 
full maven build at some point in time. The jboss maven repo can be found here. Starting from AS5 CR2, please note 
how the -sources.jar are also downloaded.] Revisit this section for GA for any build changes.

Add note: When JBossAS 5 is compiled with Java 6, support for the extended JDBC 4 API is included in the binary, however 
this can only be used under a Java 6 runtime. 

Correct the following:
 The JBoss Application Server files are built under the build/jboss-5.0.0.<release> directory 
they are built under:
build/output/jboss-5.0.0.<release>

Chapter 7 - Check your Installation

Correct the following:
 To test your installation, move to JBOSS_DIST/jboss-as/bin
to
move to JBOSS_DIST/jboss-5.0.0.<release>/bin

Remove the NOTE that there is no "Server Started" message.  That only pertains to the production config distributed with EAP.

Update or remove the reference to refer to "Refer to the Getting Started Guide" to the section that discusses the server layout.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira