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

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.