[jboss-cvs] JBossAS SVN: r101517 - in projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US: images and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Fri Feb 26 01:03:37 EST 2010
Author: gmeintjes
Date: 2010-02-26 01:03:36 -0500 (Fri, 26 Feb 2010)
New Revision: 101517
Modified:
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Appendix.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Getting_Started.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_Using_Graphical_Installer.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_RHN.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_ZIP_Download.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Post_Installation.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Revision_History.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Test_Your_Installation.xml
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step3.png
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step3_5.png
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step4.png
projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step8.png
Log:
Amended to comply with review comments on JBPAPP 3362
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Appendix.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Appendix.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Appendix.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -106,10 +106,10 @@
<programlisting>
<descriptors>
<interceptors>
- <! Uncomment to require authenticated users >
+ <!-- Uncomment to require authenticated users -->
<interceptor code="org.jboss.jmx.connector.invoker.AuthenticationInterceptor"
securityDomain="java:/jaas/jmx-console"/>
- <! Interceptor that deals with non-serializable results >
+ <!-- Interceptor that deals with non-serializable results -->
<interceptor code="org.jboss.jmx.connector.invoker.SerializableInterceptor"
policyClass="StripModelMBeanInfoPolicy"/>
</interceptors>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Getting_Started.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Getting_Started.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Getting_Started.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -7,14 +7,14 @@
<section id="Getting_Started-Pre_Requisites">
<title>Pre-Requisites</title>
<para>
- You must have adequate disk space<!--TODO how much --> to install JDK and JBoss Enterprise Application Platform while also allowing enough space for your applications. Before installing JBoss Enterprise Application Platform you must have a working installation of Java and a C runtime. The JBoss Enterprise Application Platform 5 includes offerings of JBoss Native and mod_jk which require a C runtime to be installed. <!--Since JBoss is 100% pure Java you can have it working on any Operating System / Platform that supports Java. However there are a few Operating System-specific issues that you must be aware of.--> Refer to <ulink url="http://www.jboss.org/community/wiki/JBossOperatingSystemSpecificIssues"></ulink> for more information.
+ You must have adequate disk space<!--TODO how much --> to install JDK and JBoss Enterprise Web Platform (JBoss EWP) while also allowing enough space for your applications. Before installing JBoss EWP you must have a working installation of Java and a C runtime. The JBoss EWP 5 includes offerings of JBoss Native and mod_jk which require a C runtime to be installed. <!--Since JBoss is 100% pure Java you can have it working on any Operating System / Platform that supports Java. However there are a few Operating System-specific issues that you must be aware of. Refer to <ulink url="http://www.jboss.org/community/wiki/JBossOperatingSystemSpecificIssues"></ulink> for more information.-->
</para>
<section id="Pre_Requisites-Hardware_and_Operating_System_Requirements">
<title>Hardware, Operating System, and JVM Requirements</title>
<formalpara>
<title>Hardware Requirements</title>
<para>
- The following table details the minimum hardware requirements for a basic JBoss Enterprise Application Platform installation that allows for all examples to be run correctly.
+ The following table details the minimum hardware requirements for a basic JBoss EWP installation that allows for all examples to be run correctly.
</para>
</formalpara>
<table>
@@ -29,15 +29,15 @@
<tbody>
<row>
<entry>CPU</entry>
- <entry>Intel Pentium 1GHz or faster for simple applications</entry>
+ <entry>Intel Pentium 1 GHz or faster for simple applications</entry>
</row>
<row>
- <entry>Hard disc space</entry>
- <entry>1.5GB</entry>
+ <entry>Hard disk space</entry>
+ <entry>1.5 GB</entry>
</row>
<row>
<entry>System RAM</entry>
- <entry>1.5GB</entry>
+ <entry>1.5 GB</entry>
</row>
</tbody>
</tgroup>
@@ -46,7 +46,7 @@
<!-- <formalpara>
<title>Minimum Hardware Requirements</title>
<para>
- Detailed in this section are the minimum hardware requirements in reguards to a server using the <classname>production</classname> configuration shipped with the JBoss Enterprise Application Platform.
+ Detailed in this section are the minimum hardware requirements in reguards to a server using the <classname>production</classname> configuration shipped with the JBoss EWP.
</para>
</formalpara>
<itemizedlist>
@@ -64,18 +64,18 @@
<formalpara>
<title>Supported Operating Systems</title>
<para>
- This release of JBoss Enterprise Application Platform is certified for the following Operating Systems:
+ This release of JBoss EWP is certified for the following Operating Systems:
</para>
</formalpara>
<itemizedlist>
<listitem>
<para>
- Red Hat Enterprise Linux 4 (32-bit systems, 64-bit systems)
+ Red Hat Enterprise Linux 4 (32-bit systems and 64-bit systems)
</para>
</listitem>
<listitem>
<para>
- Red Hat Enterprise Linux 5 (32-bit systems, 64-bit systems)
+ Red Hat Enterprise Linux 5 (32-bit systems and 64-bit systems)
</para>
</listitem>
<listitem>
@@ -95,7 +95,7 @@
</listitem>
<!-- <listitem>
<para>
- Microsoft® Windows Vista™ Ultimate (32-bit systems 64-bit systems)
+ Microsoft® Windows Vista™ Ultimate (32-bit systems and 64-bit systems)
</para>
</listitem> -->
<listitem>
@@ -111,7 +111,7 @@
</itemizedlist>
<important>
<para>
- The JBoss Enterprise Application Platform 5 is supported on any Operating System as long as a certified JVM is used, following the JBoss Support Policy: <ulink url="http://www.jboss.com/products/platforms/application/supportedconfigurations/">http://www.jboss.com/products/platforms/application/supportedconfigurations/</ulink>. However this does not apply to the optional Native code install, which only applies to the Operating Systems included in the list above.
+ The JBoss EWP 5 is supported on any Operating System as long as a certified JVM is used, following the JBoss Support Policy: <ulink url="http://www.jboss.com/products/platforms/application/supportedconfigurations/">http://www.jboss.com/products/platforms/application/supportedconfigurations/</ulink>. However this does not apply to the optional Native code install, which only applies to the Operating Systems included in the list above.
</para>
</important>
@@ -341,7 +341,7 @@
<section id="Pre_Requisites-Configuring_Your_Java_Environment">
<title>Configuring Your Java Environment</title>
<para>
- Enterprise Application Platform 5 requires Java SE 6. You must have a working installation of <emphasis role="bold">JDK 1.6</emphasis> before you install JBoss Enterprise Application Platform. You can install the 32-bit or 64-bit JVM as per your requirements.
+ Enterprise Application Platform 5 requires Java SE 6. You must have a working installation of <emphasis role="bold">JDK 1.6</emphasis> before you install JBoss EWP. You can install the 32-bit or 64-bit JVM as per your requirements.
</para>
<itemizedlist id="Configuring_Your_Java_Environment-Benefits_of_64_bit_JVM_on_64_bit_OS_and_Hardware">
<title>Benefits of 64-bit JVM on 64-bit OS and Hardware:</title>
@@ -357,7 +357,7 @@
</listitem>
<listitem>
<para>
- Applications that require more than 1GB of Java memory could utilize the 64-bit JVM.
+ Applications that require more than 1 GB of Java memory could utilize the 64-bit JVM.
</para>
</listitem>
<listitem>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_Using_Graphical_Installer.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_Using_Graphical_Installer.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_Using_Graphical_Installer.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -36,11 +36,11 @@
</listitem>
<listitem>
<para>
- Select the Installation Path where you would like the JBoss Enterprise Application Platform to be installed. You can either type the complete path or browse for it. If the directory corresponding to the path you entered does not exist, the installer will create the target directory in the specified path. If the directory corresponding to the path you entered exists already, the installer will overwrite the contents of the directory. In either case the installer will prompt you to confirm the action.
+ Select the Installation Path where you would like the JBoss EWP to be installed. You can either type the complete path or browse for it. If the directory corresponding to the path you entered does not exist, the installer will create the target directory in the specified path. If the directory corresponding to the path you entered exists already, the installer will overwrite the contents of the directory. In either case the installer will prompt you to confirm the action.
</para>
<warning>
<para>
- Install the JBoss Enterprise Application Platform into a directory path that does not contain spaces. This will avoid issues with file URLs not correctly escaping the spaces in the directory path.
+ Install the JBoss EWP into a directory path that does not contain spaces. This will avoid issues with file URLs not correctly escaping the spaces in the directory path.
</para>
</warning>
<figure id="Installation_Steps-Select_Installation_Path">
@@ -54,7 +54,7 @@
</listitem>
<listitem>
<para>
- At this point you now have the choice of installing optional components. Currently the JBoss Enterprise Application Platform is distributed with an optional <package>Native</package> package.
+ At this point you now have the choice of installing optional components. Currently the JBoss EWP is distributed with an optional <package>Native</package> package.
</para>
<para>
The <package>Native</package> package will be of interest for users who wish to use a HTTPd and Tomcat or JBoss Web configuration. This package includes JBoss Native and mod_jk; for more information refer to the <ulink url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/5.0.0/html-single/Release_Notes/index.html">release notes</ulink>.
@@ -120,7 +120,7 @@
</listitem>
<listitem>
<para>
- The JBoss Enterprise Application Platform is now ready to install. Verify the installation path displayed in the summary screen before you hit the Next button. Pressing the Next button will begin the installation.
+ The JBoss EWP is now ready to install. Verify the installation path displayed in the summary screen before you hit the Next button. Pressing the Next button will begin the installation.
</para>
</listitem>
<listitem>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_RHN.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_RHN.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_RHN.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -111,7 +111,7 @@
</para>
<note>
<para>
- Installation of the documentation (rh-eap-docs) and the log-based event profiler (jboss-profiler) are optional but recommended as these will assist you in understanding and troubleshooting the JBoss Enterprise Application Platform.
+ Installation of the documentation (rh-eap-docs) and the log-based event profiler (jboss-profiler) are optional but recommended as these will assist you in understanding and troubleshooting the JBoss EWP.
</para>
</note>
</listitem>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_ZIP_Download.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -22,10 +22,10 @@
<itemizedlist>
<listitem>
<para>
- Unzip <literal>jboss-ewp-<replaceable>5.0</replaceable>.zip</literal> to extract the archive contents into the location of your choice.</para>
+ Unzip <literal>jboss-ewp-5.0.0.zip</literal> to extract the archive contents into the location of your choice.</para>
<programlisting>
[vsr]$ <literal>cd /directory/to/install/in</literal>
-[vsr]$ <literal>unzip jboss-ewp-<replaceable>5.0</replaceable>.zip jboss-ewp-native-5.0.0-<replaceable><operating_system>-<system_architecture></replaceable>.zip</literal>
+[vsr]$ <literal>unzip jboss-ewp-5.0.0.GA.zip jboss-ewp-native-5.0.0.GA-<replaceable><operating_system>-<system_architecture></replaceable>.zip</literal>
</programlisting>
</listitem>
@@ -51,7 +51,7 @@
<formalpara>
<title>Windows Installation Notes for JBoss Native</title>
<para>
- The version of the <filename>jboss-ewp-native</filename> package being installed on Windows, must align with the architecture version of the isntalled JVM. If you have a 32-bit JVM installed on a 64-bit Windows system then a 32-bit JBoss Native package will need to be installed.
+ The version of the <filename>jboss-ewp-native</filename> package being installed on Windows, must align with the architecture version of the installed JVM. If you have a 32-bit JVM installed on a 64-bit Windows system then a 32-bit JBoss Native package will need to be installed.
</para>
</formalpara>
<formalpara>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Post_Installation.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Post_Installation.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Post_Installation.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -48,12 +48,12 @@
<para>
To avoid memory issues, adjust the memory settings before deploying the applications. You can do this by updating <literal>JAVA_OPTS</literal> settings in the file <filename>$JBOSS_HOME/bin/run.conf</filename> to match your application requirements. The default settings are:
<programlisting>
- -Xms1303m -Xmx1303m -XX:PermSize=256m -XX:MaxPermSize=256m
+ -Xms1303m -Xmx1303m <!-- -XX:PermSize=256m --> -XX:MaxPermSize=256m
</programlisting>
</para>
<important>
<para>
- If you are running the JBoss Enterprise Application Platform on a Windows operating system then you will need to update the <filename>$JBOSS_HOME/bin/run.conf.bat</filename> file to match your application requirements.
+ If you are running the JBoss EWP on a Windows operating system then you will need to update the <filename>$JBOSS_HOME/bin/run.conf.bat</filename> file to match your application requirements.
</para>
</important>
</section>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Revision_History.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Revision_History.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Revision_History.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -8,15 +8,15 @@
<revhistory>
<revision>
<revnumber>1.1</revnumber>
- <date>Wed Feb 10 2010</date>
+ <date>Thurs Feb 25 2010</date>
<author>
- <firstname>Laura</firstname>
- <surname>Bailey</surname>
- <email>lbailey at redhat.com</email>
+ <firstname>Gary</firstname>
+ <surname>Meintjes</surname>
+ <email>gmeintje at redhat.com</email>
</author>
<revdescription>
<simplelist>
-<member>Initial draft.</member>
+<member>Amend as per Tech Review</member>
</simplelist>
</revdescription>
</revision>
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Test_Your_Installation.xml
===================================================================
--- projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Test_Your_Installation.xml 2010-02-26 05:58:22 UTC (rev 101516)
+++ projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/Test_Your_Installation.xml 2010-02-26 06:03:36 UTC (rev 101517)
@@ -5,9 +5,9 @@
<chapter id="Test_your_Installation">
<title>Test your Installation</title>
<para>
- After you have installed the JBoss Enterprise Web Platform, it is wise to perform a simple startup test to validate that there are no major problems with your Java VM/operating system combination. Make sure you have set the <literal>JBOSS_HOME</literal> environment variable as explained in <ulink url="Post_Installation_Configuration"/>. To test your installation, move to <filename>$JBOSS_HOME/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. Your output should look like the following (accounting for installation directory differences) and contain no error or exception messages:
+ After you have installed the JBoss Enterprise Web Platform, it is wise to perform a simple startup test to validate that there are no major problems with your Java VM/operating system combination. Make sure you have set the <literal>JBOSS_HOME</literal> environment variable as explained in <xref linkend="Post_Installation_Configuration"/>. To test your installation, move to <filename>$JBOSS_HOME/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. Your output should look like the following (accounting for installation directory differences) and contain no error or exception messages:
</para>
-<programlisting>
+<!-- <programlisting>
[vrenish at vinux bin]$ ./run.sh
=====================================================
@@ -35,7 +35,38 @@
18:45:51,824 INFO [Server] Core system initialized
18:45:59,622 INFO [WebService] Using RMI server codebase: http://127.0.0.1:8083 /
18:45:59,659 INFO [Log4jService$URLWatchTimerTask] Configuring from URL: resour ce:jboss-log4j.xml
-</programlisting>
+</programlisting> -->
+
+<programlisting>
+[<username>@machine jboss-as-web]$ ./bin/run.sh
+=========================================================================
+
+ JBoss Bootstrap Environment
+
+ JBOSS_HOME: /home/<username>/dist/ewp/jboss-ewp-5.0/jboss-as-web
+
+ JAVA: /usr/java/jdk1.6.0_17/bin/java
+
+ JAVA_OPTS: -Dprogram.name=run.sh -server -Xms1303m -Xmx1303m -XX:MaxPermSize=256m -Dorg.jboss.resolver.warning=true
+-Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000
+-Dsun.lang.ClassLoader.allowArraySyntax=true -Djava.net.preferIPv4Stack=true
+
+ CLASSPATH: /home/<username>/dist/ewp/jboss-ewp-5.0/jboss-as-web/bin/run.jar:/usr/java/jdk1.6.0_17/lib/tools.jar
+
+=========================================================================
+
+14:57:53,572 INFO [ServerImpl] Starting JBoss (Microcontainer)...
+.
+.
+.
+14:57:56,663 INFO [ServerInfo] Java version: 1.6.0_17,Sun Microsystems Inc.
+14:57:56,663 INFO [ServerInfo] Java Runtime: Java(TM) SE Runtime Environment (build 1.6.0_17-b04)
+14:57:56,663 INFO [ServerInfo] Java VM: Java HotSpot(TM) 64-Bit Server VM 14.3-b01,Sun Microsystems Inc.
+14:57:56,663 INFO [ServerInfo] OS-System: Linux 2.6.30.10-105.2.23.fc11.x86_64,amd64
+14:57:56,663 INFO [ServerInfo] VM arguments: -Dprogram.name=run.sh -Xms1303m -Xmx1303m -XX:MaxPermSize=256m ...
+14:57:56,692 INFO [JMXKernel] Legacy JMX core initialized
+</programlisting>
+
<note>
<para>
There is no <emphasis>Server Started</emphasis> message shown at the console when the server is started using the <literal>production</literal> profile. This message can be observed in the <filename>server.log</filename> file located in the <filename>server/production/log</filename> subdirectory.
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step3.png
===================================================================
(Binary files differ)
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step3_5.png
===================================================================
(Binary files differ)
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step4.png
===================================================================
(Binary files differ)
Modified: projects/docs/enterprise/EWP_5.0/Installation_Guide/en-US/images/step8.png
===================================================================
(Binary files differ)
More information about the jboss-cvs-commits
mailing list