[jbosstools-commits] JBoss Tools SVN: r41802 - in trunk/documentation/guides/GettingStartedGuide/en-US: images/manage and 1 other directory.

Author: irooskov(a)redhat.com Date: 2012-06-07 21:06:24 -0400 (Thu, 07 Jun 2012) New Revision: 41802 Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/eap5runtime.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_1.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_15.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_16.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_17.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_3.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_4.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_6.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_8.png trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_9.png trunk/documentation/guides/GettingStartedGuide/en-US/manage.xml Log: updated, rewriting chapter 7 for new server Modified: trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml 2012-06-08 00:45:13 UTC (rev 41801) +++ trunk/documentation/guides/GettingStartedGuide/en-US/Book_Info.xml 2012-06-08 01:06:24 UTC (rev 41802) @@ -8,7 +8,7 @@ <productname>JBoss Developer Studio</productname> <productnumber>5.0</productnumber> <edition>5.0.0</edition> -<pubsnumber>22</pubsnumber> +<pubsnumber>23</pubsnumber> <abstract> <para>The Getting Started Guide explains the JBoss Developer Studio.</para> </abstract> Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/eap5runtime.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_1.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_15.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_16.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_17.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_3.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_4.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_6.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_8.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/images/manage/manage_9.png =================================================================== (Binary files differ) Modified: trunk/documentation/guides/GettingStartedGuide/en-US/manage.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/manage.xml 2012-06-08 00:45:13 UTC (rev 41801) +++ trunk/documentation/guides/GettingStartedGuide/en-US/manage.xml 2012-06-08 01:06:24 UTC (rev 41802) @@ -1,212 +1,30 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="manage"> - <?dbhtml filename="manage.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Deploy</keyword> - <keyword>Deployment</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title condition="jbds">Manage a JBoss Server within JBoss Developer Studio</title> - <title condition="jbt">Manage a JBoss Server within JBoss Tools</title> - <para> - In this chapter we&apos;ll focus more on how to operate the <property>JBoss AS</property> from <property condition="jbds">JBoss Developer Studio</property><property condition="jbt">JBoss Tools</property>. - </para> - <para condition="jbds"> - <property>JBoss Developer Studio: Portfolio Edition</property> ships with <property>JBoss EAP</property>. When you followed the default installation of <property>JBoss Developer Studio</property>, you should already have a JBoss EAP Server installed and defined. To run JBoss AS you need you will need to have JDK 6 installed. - </para> - - <para condition="jbt"> - <property>JBoss Tools</property> can be used to operate a wide range of <property>JBoss Application Server</property> versions, which can be downloaded from the <ulink url="http://www.jboss.org/jbossas/downloads.html">JBoss Application Server</ulink> website. - </para> - - <!--<note> - <title>Note:</title> - <para>You can leave <property>JDK 1.5</property> configuration for <property>JBoss Developer Studio</property> and set <property>JDK 6</property> as <property>JRE</property> only for <property>JBoss EAP Server</property>. For this you need to select <menuchoice> - <guimenuitem>Windows</guimenuitem> - <guimenuitem>Preferences</guimenuitem> - </menuchoice>, and then click <menuchoice> - <guimenuitem>Server</guimenuitem> - <guimenuitem>Runtime Environments</guimenuitem> - </menuchoice>. On the opened preference page you should select <property>JBoss EAP Runtime</property> and clicking the <guibutton>Edit</guibutton> button. In <property>Edit Server Runtime Environment</property> dialog you can configure <property>Jave Runtime Environment</property> by clicking the <guibutton>JRE</guibutton> button. </para> - </note>--> - - <section id="JBossbundled"> - <?dbhtml filename="JBossbundled.html"?> - <title condition="jbds">How to Manage the JBoss Server Bundled in JBoss Developer Studio</title> - <title condition="jbt">How to Manage JBoss AS with JBoss Tools</title> - <para>This section covers the basics of working with the <property>JBoss Server</property> - supported directly by <property>JBoss Developer Studio</property> via bundled AS plug-in. The server points to - the JBoss Enterprise Application Platform Runtime shipped with <property>JBoss Developer Studio</property>.</para> - - <figure> - <title>JBoss Enterprise Application Platform Runtime</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/eap5runtime.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>To read more about AS plug-in, refer to the Server Manager guide.</para> - <section id="StartingServer"> - <?dbhtml filename="StartingServer.html"?> - <title>Starting JBoss Server</title> - <para>Starting <property>JBoss Server</property> is quite simple. <property>JBoss - Developer Studio</property> allows you to control its behavior with the help of - a special toolbar, where you could start it in a regular or debug mode, stop it or - restart it.</para> - - <itemizedlist> - <listitem> - <para>To launch the server click the green-with-white-arrow icon in the <property>Servers</property> view or right click server name in this view and click the <guibutton>Start</guibutton> button. If this view is not open, select <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice> - </para> - </listitem> - </itemizedlist> - <figure> - <title>Starting from Icon</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_1.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>While launching, server output is written to the <property>Console - view</property>:</para> - - <figure> - <title>Console Output</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_3.png"/> - </imageobject> - </mediaobject> - </figure> - <para>When the server is started you should see <emphasis><property>Started</property></emphasis> in the square brackets right next its name in the <property>Servers</property> view.</para> - - <figure> - <title>Server is Started</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_4.png"/> - </imageobject> - </mediaobject> - </figure> - <!--para>To see event log after the server is started, expand <property>Event - Log</property> branch beneath <property>Servers</property>:</para> - <figure> - <title>Event Log</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_5.png"/> - </imageobject> - </mediaobject> - </figure--> - </section> - - <section id="StoppingJBoss"> - <?dbhtml filename="StoppingJBoss.html"?> - <title>Stopping the JBoss Server</title> - <para>To stop the server, click the <guibutton>Stop</guibutton> button icon in <property>Servers</property> or right click the server name and press <guimenuitem>Stop</guimenuitem>. - </para> - - <figure> - <title>Stopping Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_6.png"/> - </imageobject> - </mediaobject> - </figure> - <para>When the server is stopped you will see <emphasis> - <property>Stopped</property> - </emphasis> in the square brackets next to its name.</para> - </section> - <section id="ServerPreferences"> - <?dbhtml filename="ServerPreferences.html"?> - <title>Server Container Preferences</title> - <para>You can control how <property>JBoss Developer Studio</property> interacts with - server containers in the <property>Server editor</property>. Double-click the server - to open it in the editor.</para> - - <figure> - <title>Server Overview</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/manage/manage_8.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Here you can specify some common settings: host name, server name, runtime as well - as settings related to publishing, timeouts and server ports.</para> - - </section> - </section> - - <section id="JBossInstances"> - <?dbhtml filename="JBossInstances.html"?> - <title>How to Use Your Own JBoss Server Instance with JBoss Developer Studio</title> + <title>Setting up a JBoss runtime and managing the server</title> <para>Although <property>JBoss Developer Studio</property> works closely with - <property>JBoss EAP 5</property> we do not ultimately tie you to any particular + <property>JBoss Enterprise Application Platform 6</property> we do not ultimately tie you to any particular server for deployment. There are some servers that Studio supports directly (via the - bundled Eclipse WTP plug-ins). In this section we discuss how to manage self-installed - JBoss AS. Suppose you want to deploy the application to <property>JBoss 4.2.3 - server</property>. First of all you need to install it.</para> - <section id="JBossInstalling"> - <?dbhtml filename="JBossInstalling.html"?> - <title>JBoss Server Installation</title> - <itemizedlist> - <listitem> - <para>Download the binary package of JBoss AS, e.g. <property>JBoss 4.2.3</property> and save - it on your computer: <ulink url="http://labs.jboss.com/jbossas/downloads">http://labs.jb... - </para> - </listitem> - </itemizedlist> - <para>It does not matter where on your system you install JBoss server.</para> - + bundled Eclipse WTP plug-ins). In this chapter we discuss how to manage a JBoss server.</para> <note> - <title>Note:</title> - <para>The installation of JBoss server into a directory that has a name containing - spaces provokes problems in some situations with Sun-based VMs. Try to avoid - using installation folders that contain spaces in their names.</para> + <para> + This chapter assumes you have a JBoss application server installed on your system. If you do not, consult the installation instructions that accompanied your server. + </para> </note> - <para>There is no requirement for root access to run JBoss Server on UNIX/Linux systems - because none of the default ports are within the 0-1023 privileged port - range.</para> - <itemizedlist> - <listitem> - <para>After you have the binary archive you want to install, use the JDK jar - tool (or any other ZIP extraction tool) to extract the <filename>jboss-4.2.3.GA.zip</filename> - archive contents into a location of your choice. The <filename>jboss-4.2.3.GA.tgz</filename> - archive is a gzipped tar file that requires a gnutar compatible tar which - can handle the long pathnames in the archive. The extraction process will - create a <filename>jboss-4.2.3.GA</filename> directory. </para> - </listitem> - </itemizedlist> - </section> - <section id="AddingJBossServer"> <?dbhtml filename="AddingJBossServer.html"?> - <title>Adding and Configuring JBoss Server</title> - <para>Now we should add the just installed server into server manager in <property>JBoss Developer Studio</property>.</para> + <title>Adding and configuring a JBoss server runtime</title> <itemizedlist> <listitem> - <para>Select the <property>Servers</property> view by selecting <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice>. + <para>Select the <property>Servers</property> view by navigating to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice>. </para> </listitem> <listitem> - <para>Right click anywhere in this view and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Server</guimenuitem></menuchoice>. + <para>Click the <guibutton>new server wizard</guibutton> text in the <guilabel>Servers</guilabel> view or if this is not your first server, right-click anywhere in the view and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Server</guimenuitem></menuchoice>. </para> </listitem> <listitem> - <para>Select <menuchoice><guimenuitem>JBoss Community</guimenuitem><guimenuitem>JBoss 4.2 Server</guimenuitem></menuchoice> + <para>Select the server option that matches your installed server. </para> </listitem> </itemizedlist> @@ -219,22 +37,16 @@ </mediaobject> </figure> - <note> - <title>Note:</title> - - <para>Now in the <property>New Server wizard</property> there is a separation between the .org servers (the <emphasis><property>JBoss Community</property></emphasis> category) and product server that comes bundled with JBoss EAP (the <emphasis><property>JBoss Enterprise Middleware</property></emphasis> category).</para> - </note> - <itemizedlist> <listitem> - <para>To create a new runtime, which Jboss AS 4.2 matches to, click the <guibutton>Next</guibutton> button + <para>To setup the new runtime, click the <guibutton>Next</guibutton> button. </para> </listitem> </itemizedlist> - <itemizedlist> +<!-- <itemizedlist> <listitem> - <para>In the next step you need to specify the location of the Server and define JRE to be used.</para> + <para>In the next step you need to specify the location of the Server and define the JDK to be used.</para> </listitem> </itemizedlist> <figure> @@ -247,15 +59,14 @@ </figure> <note> <title>Note:</title> - <para>When adding a new server you will need to specify what JRE to use. It is + <para>When adding a new server you will need to specify what JDK to use. It is important to set this value to a full JDK, not JRE. Again, you need a full JDK to run Web applications, JRE will not be enough.</para> </note> - + --> <itemizedlist> <listitem> - <para>In the next dialog verify the specified information and if something is - unfair go back and correct it</para> + <para>In the next dialog verify the specified information and set local or remote server information.</para> </listitem> </itemizedlist> <figure> @@ -268,8 +79,8 @@ </figure> <itemizedlist> <listitem> - <para>In the last wizard&apos;s dialog modify the projects that are - configured on the server and click the <guibutton>Finish</guibutton> button.</para> + <para>Lastly, a screen will appear that will allow you yo modify projects that are + to be configured for the server. Click the <guibutton>Finish</guibutton> button.</para> </listitem> </itemizedlist> <figure> @@ -289,8 +100,97 @@ </imageobject> </mediaobject> </figure> - <para>Now, we are ready to create the first web application.</para> </section> + <section id="StartingServer"> + <?dbhtml filename="StartingServer.html"?> + <title>Starting JBoss Server</title> + <para>Starting <property>JBoss Server</property> is quite simple. <property>JBoss + Developer Studio</property> allows you to control its behavior with the help of + a special toolbar, where you could start it in a regular or debug mode, stop it or + restart it.</para> + + <itemizedlist> + <listitem> + <para>To launch the server click the green-with-white-arrow icon in the <property>Servers</property> view or right click server name in this view and click the <guibutton>Start</guibutton> button. If this view is not open, select <menuchoice> + <guimenuitem>Window</guimenuitem> + <guimenuitem>Show View</guimenuitem> + <guimenuitem>Other</guimenuitem> + <guimenuitem>Server</guimenuitem> + <guimenuitem>Servers</guimenuitem> + </menuchoice> + </para> + </listitem> + </itemizedlist> + <figure> + <title>Starting from Icon</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/manage/manage_1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>While launching, server output is written to the <property>Console + view</property>:</para> + + <figure> + <title>Console Output</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/manage/manage_3.png"/> + </imageobject> + </mediaobject> + </figure> + <para>When the server is started you should see <emphasis> + <property>Started</property> + </emphasis> in the square brackets right next its name in the <property>Servers</property> view.</para> + + <figure> + <title>Server is Started</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/manage/manage_4.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StoppingJBoss"> + <?dbhtml filename="StoppingJBoss.html"?> + <title>Stopping the JBoss Server</title> + <para>To stop the server, click the <guibutton>Stop</guibutton> button icon in <property>Servers</property> or right click the server name and press <guimenuitem>Stop</guimenuitem>. + </para> + + <figure> + <title>Stopping Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/manage/manage_6.png"/> + </imageobject> + </mediaobject> + </figure> + <para>When the server is stopped you will see <emphasis> + <property>Stopped</property> + </emphasis> in the square brackets next to its name.</para> + </section> + <section id="ServerPreferences"> + <?dbhtml filename="ServerPreferences.html"?> + <title>Server Container Preferences</title> + <para>You can control how <property>JBoss Developer Studio</property> interacts with + server containers in the <property>Server editor</property>. Double-click the server + to open it in the editor.</para> + + <figure> + <title>Server Overview</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/manage/manage_8.png"/> + </imageobject> + </mediaobject> + </figure> - </section> + <para>Here you can specify some common settings: host name, server name, runtime as well + as settings related to publishing, timeouts and server ports.</para> + + </section> </chapter>