Author: mcaspers Date: 2011-02-17 17:57:24 -0500 (Thu, 17 Feb 2011) New Revision: 29221 Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml trunk/documentation/guides/GettingStartedGuide/en-US/installation.xml Log: General Documentation Updates Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml 2011-02-17 22:49:33 UTC (rev 29220) +++ trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml 2011-02-17 22:57:24 UTC (rev 29221) @@ -8,7 +8,7 @@ <productname>JBoss Developer Studio</productname> <productnumber>4.0</productnumber> <edition>4.0.0</edition> - <pubsnumber>11</pubsnumber> + <pubsnumber>12</pubsnumber> <abstract> <para>The Getting Started Guide explains the JBoss Developer Studio.</para> </abstract> @@ -25,13 +25,13 @@ <!-- The following code is used to build an installation guide, which includes only the installation.xml file. To build the Installation Guide simply uncomment the following <bookinfo> tag and comment out the <bookinfo> tag above --> -<!--<bookinfo> +<!--bookinfo> <title>Installation Guide</title> <subtitle>Provides information on how to install JBoss Developer Studio.</subtitle> <productname>JBoss Developer Studio</productname> <productnumber>4.0</productnumber> <edition>4.0.0</edition> - <pubsnumber>11</pubsnumber> + <pubsnumber>12</pubsnumber> <abstract> <para>JBoss Developer Studio Installation Guide.</para> </abstract> @@ -44,4 +44,4 @@ </corpauthor> <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -</bookinfo>--> +</bookinfo--> Modified: trunk/documentation/guides/GettingStartedGuide/en-US/installation.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/installation.xml 2011-02-17 22:49:33 UTC (rev 29220) +++ trunk/documentation/guides/GettingStartedGuide/en-US/installation.xml 2011-02-17 22:57:24 UTC (rev 29221) @@ -14,17 +14,24 @@ <?dbhtml filename="ConfigJavaEnvironment.html"?> <title>Configuring Your Java Environment</title> <para> - You must have a working installation of JDK before you install <property>JBoss Developer Studio</property>. Thus in this guide we will show you how to install a 32-bit Sun JDK 5.0 on a Linux Platform and Microsoft Windows Platform. + You must have a working installation of JDK before you install <property>JBoss Developer Studio</property>. Thus in this guide we will show you how to install a 32-bit Sun JDK 6 on a Linux Platform and Microsoft Windows Platform. </para> - <section id="InstallJDK50onLinux"> - <title>Installing and Configuring 32-bit Sun JDK 5.0 on Linux</title> - <para>To install 32-bit Sun JDK 5.0 on Linux and configure it, you should follow the next steps:</para> + <section id="InstallJDK60onLinux"> + <title>Installing and Configuring 32-bit Sun JDK 6 on Linux</title> + <para>To install 32-bit Sun JDK 6 on Linux and configure it, you should follow the next steps:</para> <itemizedlist> <listitem> <para> - Download the <ulink url="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun JDK 5.0 (Java 2 Development Kit)</ulink> from Sun&apos;s website. Choose &quot;JDK 5.0 Update &lt;x&gt;&quot; (where &quot;x&quot; is the latest update number) for download and then select &quot;Red Hat Package Manager in self-extracting&quot; file for Linux. Read the instructions on Sun&apos;s website for installing the JDK. + Download the <ulink url="http://www.oracle.com/technetwork/java/javase/downloads/index.h... JDK 6</ulink> from Sun&apos;s website. Click the <guibutton>Download JDK</guibutton> button for the &quot;JDK SE 6 Update &lt;x&gt;&quot; (where &quot;x&quot; is the latest update number) option, select the Linux platform, agree to license agreement, anc click the <guibutton>Continue</guibutton> button. You can then download the JDK installation package. </para> + <para> + You may need to set the executable flag on the downloaded file before it can be launched by running the <code>chmod +x</code> command, like so: + <screen>chmod +x jdk-6u24-linux-i586-rpm.bin</screen> + </para> + <para> + Launch the installation package, and follow the prompts to install Java JDK 6. + </para> </listitem> <listitem> <para> @@ -34,14 +41,14 @@ <listitem> <para> Download and install the appropriate -compat RPM from JPackage <ulink url="ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-f...;. Please ensure you choose a matching version of the -compat package to the JDK you've installed. - </para> + </para> </listitem> <listitem> <para> Create an environment variable that points to the JDK installation directory and call it JAVA_HOME. Add <emphasis><property>$JAVA_HOME/bin</property></emphasis> to the system path to be able to run java from the command line. You can do this by adding the following lines to the .bashrc file in your home directory. </para> - <programlisting><![CDATA[#In this example /usr/java/jdk1.5.0_11 is the JDK installation directory. -export JAVA_HOME=/usr/java/jdk1.5.0_11 + <programlisting><![CDATA[#In this example /usr/java/jdk1.6.0_24 is the JDK installation directory. +export JAVA_HOME=/usr/java/jdk1.6.0_24 export PATH=$PATH:$JAVA_HOME/bin]]></programlisting> </listitem> </itemizedlist> @@ -58,46 +65,67 @@ <itemizedlist> <listitem> <para> - If you have more than one version of JVM installed on your machine, make sure you are using the JDK 1.5 installation as the default java and javac. You can do this using the alternatives system. The alternatives system allows different versions of Java from different sources to co-exist on your system. + If you have more than one version of JVM installed on your machine, make sure you are using the JDK 1.6 installation as the default java and javac. You can do this using the alternatives system. The alternatives system allows different versions of Java from different sources to co-exist on your system. </para> + <note> + <title>Note</title> + <para> + If the JDK is not listed by the alternatives command, you can manually add it with the following commands (substitute the location of your JDK for <filename>/usr/java/jdk1.6.0_24</filename> where appropriate): + <screen>sudo /usr/sbin/alternatives --install "/usr/bin/java" "java" "/usr/java/jdk1.6.0_24/bin/java" 1 +sudo /usr/sbin/alternatives --install "/usr/bin/javac" "javac" "/usr/java/jdk1.6.0_24/bin/javac" 1 +sudo /usr/sbin/alternatives --install "/usr/lib/jvm/java-1.6.0" "java_sdk_1.6.0" "/usr/java/jdk1.6.0_24" 1</screen> + </para> + </note> </listitem> </itemizedlist> <section id="SelectAlternativesforJava"> - <title>Select alternatives for java, javac and java_sdk_1.5.0</title> + <title>Select alternatives for java, javac and java_sdk_1.6.0</title> <itemizedlist> <listitem> <para>As a root user, type the following command at the shell prompt and you should see something like this:</para> </listitem> </itemizedlist> - <programlisting><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config java -There are 2 programs that provide 'java'. -Selection Command + <programlisting><![CDATA[sudo /usr/sbin/alternatives --config java + +There are 3 programs which provide 'java'. + + Selection Command ----------------------------------------------- - 1 /usr/lib/jvm/jre-1.4.2-gcj/bin/java -*+ 2 /usr/lib/jvm/jre-1.5.0-sun/bin/java -Enter to keep the current selection[+], or type selection number:]]></programlisting> + 1 /usr/lib/jvm/jre-1.5.0-gcj/bin/java +* 2 /usr/lib/jvm/jre-1.6.0-openjdk.x86_64/bin/java + + 3 /usr/java/jdk1.6.0_24/bin/java + +Enter to keep the current selection[+], or type selection number: ]]></programlisting> <para> - Make sure the Sun version [jre-1.5.0-sun in this case] is selected (marked with a &apos;+&apos; in the output), or select it by entering its number as prompted. + Make sure the Sun version [/usr/java/jdk1.6.0_24/bin/java in this case] is selected (marked with a &apos;+&apos; in the output), or select it by entering its number as prompted. </para> <itemizedlist> <listitem> - <para>Repeat the same for javac and java_sdk_1.5.0.</para> + <para>Repeat the same for javac and java_sdk_1.6.0.</para> </listitem> </itemizedlist> - <programlisting><![CDATA[[root@vsr ~]$ /usr/sbin/alternatives --config javac -There is 1 program that provides 'javac'. - Selection Command + <programlisting><![CDATA[sudo /usr/sbin/alternatives --config javac + +There are 2 programs which provide 'javac'. + + Selection Command ----------------------------------------------- -*+ 1 /usr/lib/jvm/java-1.5.0-sun/bin/javac -Enter to keep the current selection[+], or type selection number: +* 1 /usr/lib/jvm/java-1.6.0-openjdk.x86_64/bin/javac + + 2 /usr/java/jdk1.6.0_24/bin/javac -[root@vsr ~]$ /usr/sbin/alternatives --config java_sdk_1.5.0 -There is 1 program that provide 'java_sdk_1.5.0'. - Selection Command +Enter to keep the current selection[+], or type selection number: + +sudo /usr/sbin/alternatives --config java_sdk_1.6.0 + +There are 2 programs which provide 'java_sdk_1.6.0'. + + Selection Command ----------------------------------------------- -*+ 1 /usr/lib/jvm/java-1.5.0-sun -Enter to keep the current selection[+], or type selection number:]]></programlisting> - <para>You should verify that java, javac and java_sdk_1.5.0 all point to the same manufacturer and version.</para> +* 1 /usr/lib/jvm/java-1.6.0-openjdk.x86_64 + + 2 /usr/java/jdk1.6.0_24 + +Enter to keep the current selection[+], or type selection number: ]]></programlisting> + <para>You should verify that java, javac and java_sdk_1.6.0 all point to the same manufacturer and version.</para> <note> <title>Note:</title> <para>You can always override this step by setting the JAVA_HOME environment variable as explained in the previous step.</para> @@ -109,26 +137,26 @@ </para> </listitem> </itemizedlist> - <programlisting><![CDATA[[root@vsr ~]$ java -version -java version "1.5.0_11" -Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03) -Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode, sharing)]]></programlisting> + <programlisting><![CDATA[java -version +java version "1.6.0_24" +Java(TM) SE Runtime Environment (build 1.6.0_24-b07) +Java HotSpot(TM) Server VM (build 19.1-b02, mixed mode)]]></programlisting> </section> </section> - <section id="InstallJDK50onWindows"> - <title>Installing and Configuring 32-bit Sun JDK 5.0 on Microsoft Windows</title> + <section id="InstallJDK60onWindows"> + <title>Installing and Configuring 32-bit Sun JDK 6 on Microsoft Windows</title> - <para>To install and configure 32-bit Sun JDK 5.0 on Microsoft Windows, follow these steps:</para> + <para>To install and configure 32-bit Sun JDK 6 on Microsoft Windows, follow these steps:</para> <itemizedlist> <listitem> <para> - Download the <ulink url="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun JDK 5.0 (Java 2 Development Kit)</ulink> from Sun&apos;s website. Choose &quot;JDK 5.0 Update &lt;x&gt;&quot; (where &quot;x&quot; is the latest update number) for download and then select your Windows Platform options to perform the installation. + Download the <ulink url="http://www.oracle.com/technetwork/java/javase/downloads/index.h... JDK 6</ulink> from Oracle&apos;s website. Choose &quot;JDK 6 Update &lt;x&gt;&quot; (where &quot;x&quot; is the latest update number) for download and then select your Windows Platform options to perform the installation. </para> </listitem> <listitem> <para> - Create an environment variable called JAVA_HOME that points to the JDK installation directory, for example: <emphasis>C:\Program Files\Java\jdk1.5.0_11\</emphasis> + Create an environment variable called JAVA_HOME that points to the JDK installation directory, for example: <emphasis>C:\Program Files\Java\jdk1.6.0_24\</emphasis> </para> </listitem> </itemizedlist> @@ -136,7 +164,7 @@ <para>In order to run java from the command line, add the <emphasis>jre\bin</emphasis> directory to your path, for example:</para> <para> - <emphasis>C:\Program Files\Java\jdk1.5.0_11\jre\bin</emphasis> + <emphasis>C:\Program Files\Java\jdk1.6.0_24\jre\bin</emphasis> </para> <para>To do this, open the <emphasis> <property>Control Panel</property> @@ -149,7 +177,7 @@ </emphasis> Tab, and click on the <emphasis> <property>Environment Variables</property> </emphasis> button.</para> - <para>Now, when 32-bit Sun JDK 5.0 has been successfully installed, we can pass on to the next + <para>Now, when 32-bit Sun JDK 6 has been successfully installed, we can pass on to the next step.</para> </section> @@ -363,6 +391,13 @@ </note> </section> + + <section> + <title>Updating JBoss Developer Studio</title> + <para> + Updates to JBDS can be installed by selecting <menuchoice><guimenuitem>Help</guimenuitem><guimenuitem>Check For Updates</guimenuitem></menuchoice> from withing Eclipse. You may be prompted for a username and password. These are the same credentials that are required to access the Tech Preview update site (see <xref linkend="tech_previews"/>). + </para> + </section> <!--section id="jbds_jbosstools">