[jbosstools-commits] JBoss Tools SVN: r41802 - in trunk/documentation/guides/GettingStartedGuide/en-US: images/manage and 1 other directory.
jbosstools-commits at lists.jboss.org
jbosstools-commits at lists.jboss.org
Thu Jun 7 21:06:25 EDT 2012
Author: irooskov at 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'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.jboss.com/jbossas/downloads</ulink>
- </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'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>
More information about the jbosstools-commits
mailing list