[jbosstools-commits] JBoss Tools SVN: r9856 - trunk/documentation/guides/GettingStartedGuide/en/modules.

Author: ochikvina Date: 2008-08-21 10:55:54 -0400 (Thu, 21 Aug 2008) New Revision: 9856 Modified: trunk/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml Log: https://jira.jboss.org/jira/browse/JBDS-296 - updating info about JBoss Tools installation Modified: trunk/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml 2008-08-21 13:21:39 UTC (rev 9855) +++ trunk/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml 2008-08-21 14:55:54 UTC (rev 9856) @@ -18,9 +18,11 @@ required to use JBoss Developer Studio to develop on JBoss Enterprise Middleware and/or Red Hat Linux. But, many find these pre-configured tools offer significant time-savings and value, making them more productive and speeding time to deployment.</para> - <para>This guide covers the first steps to get started working with JBoss Developer Studio. You will learn how to install and - configure necessary software for your OS (currently Linux, Microsoft Windows or Mac OSX).</para> - <para>Thus this guide will provide you with detailed info on how to start JDK, JBDS and JBoss Tools.</para> + <para>This guide covers the first steps to get started working with JBoss Developer Studio. You + will learn how to install and configure necessary software for your OS (currently Linux, + Microsoft Windows or Mac OSX).</para> + <para>Thus this guide will provide you with detailed info on how to start JDK, JBDS and JBoss + Tools.</para> </section> <section id="ConfigJavaEnvironment"> @@ -28,8 +30,8 @@ <title>Configuring Your Java Environment</title> <para>You must have a working installation of JDK 5 before you install JBoss Developer Studio. Currently it will only fully work with a 32-bit JVM, not a 64-bit JVM. On a 64-bit JVM the visual - editor fails to launch because of feature of OS architecture. 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.</para> + editor fails to launch because of feature of OS architecture. 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.</para> <section id="InstallJDK50onLinux"> <title>Installing and Configuring 32-bit Sun JDK 5.0 on Linux</title> @@ -39,8 +41,8 @@ <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.</para> + 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.</para> </listitem> <listitem> <para>If you don&apos;t want to use SysV service scripts you can install the @@ -152,7 +154,8 @@ </listitem> <listitem> <para>Create an environment variable called JAVA_HOME that points to the JDK installation - directory, for example: <literallayout> + directory, for example: + <literallayout> <emphasis>C:\Program Files\Java\jdk1.5.0_11\</emphasis> </literallayout></para> </listitem> @@ -180,7 +183,7 @@ <section id="Instfromdownver"> <title>Installing from the downloaded version</title> - <para>Let's start with the JBDS installation.</para> + <para>Let&apos;s start with the JBDS installation.</para> <para>JBDS comes with a simple installer, bundled with tested/pre-configured versions of Eclipse, WTP, JBossEAP, Seam, and SpringIDE. Thus, to start perform the next steps:</para> @@ -236,7 +239,8 @@ <note> <title>Note:</title> - <para>JBoss Developer Studio needs Java 5 and &quot;gij&quot; isn&apos;t available on every platform.</para> + <para>JBoss Developer Studio needs Java 5 and &quot;gij&quot; isn&apos;t available + on every platform.</para> </note> <itemizedlist> @@ -253,11 +257,11 @@ <figure> <title>JBoss Enterprise Application Platform Installing</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_3.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_3.png"/> + </imageobject> + </mediaobject> </figure> <para/> <note> @@ -282,11 +286,11 @@ <figure> <title>Summary Information</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_4.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_4.png"/> + </imageobject> + </mediaobject> </figure> </section> @@ -322,7 +326,8 @@ <section id="JBossToolsInstall"> <title>JBoss Tools Installation</title> - <para>Here, let&apos;s consider the installation of the JBoss Tools modules.</para> + <para>Here, let&apos;s consider the installation of the <property>JBoss Tools</property> + modules.</para> <para>JBoss Tools is an umbrella project for the JBoss developed plugins that will make it into JBoss Developer Studio. The JBoss Tools modules are:</para> <itemizedlist> @@ -350,25 +355,53 @@ <itemizedlist> <listitem> - <para>Get Eclipse 3.3.1 and Web Tools 2.0.1</para> + <para>Get Eclipse and Web Tools</para> </listitem> </itemizedlist> - <para>The quickest way to get a WTP version is to download "Eclipse IDE for Java EE Developers" - via <ulink url="http://www.eclipse.org">www.eclipse.org</ulink>.</para> + <para>The currant version of JBoss Tools (3.0.0 Alpha) targets at Eclipse 3.4/Ganymede and WTP + 3.0.</para> + + <tip> + <title>Tip:</title> + <para>We recommend you do not use Eclipse.org update site to go from Eclipse 3.3 to Eclipse + 3.4. Instead we suggest that you download the full binary from <ulink + url="http://www.eclipse.org/downloads/">here</ulink>.&... + </tip> + + <para>If you can only use Eclipse 3.3 use <ulink + url="http://www.jboss.org/tools/download/index.html#stable">... Tools 2.1.2</ulink>, but + JBoss Tools 2.x will not have any of the new features.</para> + <note> <title>Note:</title> <para>Remember to choose the download that matches your OS and use Java 5 when you run it.</para> </note> + <itemizedlist> <listitem> - <para>Get the <ulink url="http://labs.jboss.com/tools/download/index.html">JBoss Tools - build</ulink></para> + <para>Get the <ulink + url="http://download.jboss.org/jbosstools/builds/nightly/latestBuild... JBoss + Tools build</ulink></para> </listitem> </itemizedlist> - <para>You can also find the latest development release of JBossTools from <ulink - url="http://download.jboss.org/jbosstools/updates/stable/">J... Stable Update - Site</ulink></para> + + <para>Some of our newer plugins, like TPTP and BIRT, need additional drivers. On the left side of the download page + you can find all of the required drivers for chosen build and their versions.</para> + <para>Instead of downloading the nightly build version manually, it&apos;s also possible to + get the latest release of <property>JBoss Tools</property> from one of our update sites: <itemizedlist> + <listitem> + <para>Stable Updates: <ulink url="http://download.jboss.org/jbosstools/updates/stable" + >http://download.jboss.org/jbosstools/updates/stable</ulink></para> + </listitem> + <listitem> + <para> Development Updates: <ulink + url="http://download.jboss.org/jbosstools/updates/development" + >http://download.jboss.org/jbosstools/updates/development</ulink></para> + </listitem> + </itemizedlist> + </para> + <itemizedlist> <listitem> <para>Finally, install the build</para> @@ -396,11 +429,11 @@ <figure> <title>Welcome to JBoss Developer Studio</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_5.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_5.png"/> + </imageobject> + </mediaobject> </figure> <para>With the help of its page you will be able:</para> @@ -413,11 +446,11 @@ <figure> <title>Getting Started Documentation</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_6.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_6.png"/> + </imageobject> + </mediaobject> </figure> <itemizedlist> @@ -429,11 +462,11 @@ <figure> <title>Create New...</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_7.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_7.png"/> + </imageobject> + </mediaobject> </figure> <itemizedlist> @@ -445,11 +478,11 @@ <figure> <title>Perspectives</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_8.png"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_8.png"/> + </imageobject> + </mediaobject> </figure> <itemizedlist> @@ -460,11 +493,11 @@ <figure> <title>Web Resources</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/getting_started/getting_started_9.png" scale="90"/> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject> + <imagedata fileref="images/getting_started/getting_started_9.png" scale="90"/> + </imageobject> + </mediaobject> </figure> <para>Start work with JBoss Developer Studio by clicking on <emphasis> @@ -483,9 +516,12 @@ <?dbhtml filename="Uninstalling.html"?> <title>Uninstalling</title> <itemizedlist> - <listitem><para>Make sure JBoss Developer Studio is not running</para></listitem> - <listitem><para>Uninstall your current version of JBoss Developer Studio by running - uninstaller</para></listitem> + <listitem> + <para>Make sure JBoss Developer Studio is not running</para> + </listitem> + <listitem> + <para>Uninstall your current version of JBoss Developer Studio by running uninstaller</para> + </listitem> </itemizedlist> </section> @@ -539,22 +575,39 @@ their machines.</para> <orderedlist> - <listitem><para>On Red Hat based Linux distributions install the xpLib.i386 package</para></listitem> - <listitem><para>Type</para> <programlisting role="JAVA"><![CDATA[ln -s libstdc++.so.5.0.7 libstdc++.so.5 + <listitem> + <para>On Red Hat based Linux distributions install the xpLib.i386 package</para> + </listitem> + <listitem> + <para>Type</para> + <programlisting role="JAVA"><![CDATA[ln -s libstdc++.so.5.0.7 libstdc++.so.5 ]]></programlisting> </listitem> - <listitem><para>and/or use</para><programlisting role="JAVA"><![CDATA[yum install libXp + <listitem> + <para>and/or use</para> + <programlisting role="JAVA"><![CDATA[yum install libXp ]]></programlisting> </listitem> - <listitem><para>Open the JBDS perspective. If you see the Help view open, close it and restart JBDS</para></listitem> - <listitem><para>If none of these work, do the following:</para><itemizedlist> - <listitem><para>Clear the Eclipse log file, - <emphasis>&lt;workspace&gt;\.metadata\.log</emphasis></para></listitem> - <listitem><para>Start Eclipse with the -debug option:</para> <programlisting role="JAVA"><![CDATA[eclipse -debug + <listitem> + <para>Open the JBDS perspective. If you see the Help view open, close it and restart + JBDS</para> + </listitem> + <listitem> + <para>If none of these work, do the following:</para> + <itemizedlist> + <listitem> + <para>Clear the Eclipse log file, + <emphasis>&lt;workspace&gt;\.metadata\.log</emphasis></para> + </listitem> + <listitem> + <para>Start Eclipse with the -debug option:</para> + <programlisting role="JAVA"><![CDATA[eclipse -debug ]]></programlisting> </listitem> - <listitem><para>Post the Eclipse log file - (<emphasis>&lt;workspace&gt;\.metadata\.log</emphasis>) on the forums.</para></listitem> + <listitem> + <para>Post the Eclipse log file + (<emphasis>&lt;workspace&gt;\.metadata\.log</emphasis>) on the forums.</para> + </listitem> </itemizedlist> </listitem> </orderedlist> @@ -631,8 +684,8 @@ <para> <emphasis role="bold">How can I add my own tag library to the JBoss Tools Palette?</emphasis> </para> - <para>See <ulink url="&jsflink;#AddingCustomJSFTagsToTheRedHatPalette7433" - >Adding Tag Libraries</ulink> in Visual Web Tools Guide.</para> + <para>See <ulink url="&jsflink;#AddingCustomJSFTagsToTheRedHatPalette7433">Adding Tag + Libraries</ulink> in Visual Web Tools Guide.</para> </section> </section> @@ -646,8 +699,9 @@ url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... Forum</ulink></para> <para>Download: <ulink url="http://www.jboss.com/products/devstudio">JBDS Download</ulink></para> - <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://www.jboss.com/products/devstudio/docs">here</... - <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">her... + + <para>The latest documentation builds are available <ulink + url="http://download.jboss.org/jbosstools/nightly-docs/">her... </section> </chapter>