Author: afedosik
Date: 2007-12-26 09:29:51 -0500 (Wed, 26 Dec 2007)
New Revision: 5448
Added:
trunk/as/docs/reference/en/images/quick_start/
trunk/as/docs/reference/en/images/quick_start/quick_start1.png
trunk/as/docs/reference/en/images/quick_start/quick_start2.png
trunk/as/docs/reference/en/images/quick_start/quick_start3.png
trunk/as/docs/reference/en/images/quick_start/quick_start4.png
trunk/as/docs/reference/en/images/quick_start/quick_start5.png
trunk/as/docs/reference/en/images/quick_start/quick_start6.png
trunk/as/docs/reference/en/images/quick_start/quick_start7.png
trunk/as/docs/reference/en/images/quick_start/quick_start8.png
trunk/as/docs/reference/en/modules/quick_start.xml
Modified:
trunk/as/docs/reference/en/images/modules/modules_1.png
trunk/as/docs/reference/en/images/modules/modules_2.png
trunk/as/docs/reference/en/images/perspective/perspective_13.png
trunk/as/docs/reference/en/images/perspective/perspective_15.png
trunk/as/docs/reference/en/images/perspective/perspective_2.png
trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_1.png
trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_2.png
trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_3.png
trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_4.png
trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_5.png
trunk/as/docs/reference/en/images/webtools/webtools_1.png
trunk/as/docs/reference/en/images/webtools/webtools_2.png
trunk/as/docs/reference/en/images/webtools/webtools_3.png
trunk/as/docs/reference/en/master.xml
trunk/as/docs/reference/en/modules/perspective.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-199 "Quick Start with JBoss Server"
chapter is added.
Modified: trunk/as/docs/reference/en/images/modules/modules_1.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/modules/modules_2.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/perspective/perspective_13.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/perspective/perspective_15.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/perspective/perspective_2.png
===================================================================
(Binary files differ)
Added: trunk/as/docs/reference/en/images/quick_start/quick_start1.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start2.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start3.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start4.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start4.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start5.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start5.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start6.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start6.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start7.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start7.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/as/docs/reference/en/images/quick_start/quick_start8.png
===================================================================
(Binary files differ)
Property changes on: trunk/as/docs/reference/en/images/quick_start/quick_start8.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_1.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_2.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_3.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_4.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/runtimes_servers/runtimes_servers_5.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/webtools/webtools_1.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/webtools/webtools_2.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/images/webtools/webtools_3.png
===================================================================
(Binary files differ)
Modified: trunk/as/docs/reference/en/master.xml
===================================================================
--- trunk/as/docs/reference/en/master.xml 2007-12-26 14:03:59 UTC (rev 5447)
+++ trunk/as/docs/reference/en/master.xml 2007-12-26 14:29:51 UTC (rev 5448)
@@ -2,7 +2,8 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
"../../resources/support/docbook-dtd/docbookx.dtd"
-[<!ENTITY runtimes_servers SYSTEM "modules/runtimes_servers.xml">
+[<!ENTITY quick_start SYSTEM "modules/quick_start.xml">
+<!ENTITY runtimes_servers SYSTEM "modules/runtimes_servers.xml">
<!ENTITY perspective SYSTEM "modules/perspective.xml">
<!ENTITY webtools SYSTEM "modules/webtools.xml">
<!ENTITY modules SYSTEM "modules/modules.xml">
@@ -23,7 +24,8 @@
</bookinfo>
- <toc/>
+ <toc/>
+ &quick_start;
&runtimes_servers;
&perspective;
&webtools;
Modified: trunk/as/docs/reference/en/modules/perspective.xml
===================================================================
--- trunk/as/docs/reference/en/modules/perspective.xml 2007-12-26 14:03:59 UTC (rev 5447)
+++ trunk/as/docs/reference/en/modules/perspective.xml 2007-12-26 14:29:51 UTC (rev 5448)
@@ -12,12 +12,12 @@
</chapterinfo>
<title>JBoss AS Perspective</title>
- <para>This chapter tells how to manage installed JBoss AS servers via JBoss
AS Perspective</para>
+ <para>This chapter tells how to manage installed JBoss Servers via
<property>JBoss AS Perspective</property>.</para>
<para>The <property>JBoss AS</property> Perspective is similar to
the Java perspective, but it contains a few additional views. Two of the additional views
are standard views, specifically the <property>Console </property> view and
the <property>Properties</property> view.
The other two views that are added are the <property>Project
archives</property> view and the <property>JBoss Servers
View</property>.</para>
- <section id="JBossServersView">
+ <section id="JBossServerView">
<?dbhtml filename="JBossServerView.html"?>
<title>The JBoss Servers View</title>
<para>This chapter will focus on the the JBoss Server's View. The
JBoss Servers View is based on the WTP view, Servers View. The top half of the JBoss
Servers View essentially embeds the original Servers View directly into it, making slight
changes to the context menu.
Added: trunk/as/docs/reference/en/modules/quick_start.xml
===================================================================
--- trunk/as/docs/reference/en/modules/quick_start.xml (rev 0)
+++ trunk/as/docs/reference/en/modules/quick_start.xml 2007-12-26 14:29:51 UTC (rev 5448)
@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="quick_start">
+ <title>Quick Start with JBoss Server</title>
+
+ <para>This chapter covers the basics of working with the JBoss server. If you
already have installed JBoss server and runtime you can quickly learn
+ how to configure, start, stop the server, to know deployment and archiving processes.
How to install runtimes and servers read in the
+ <link linkend="runtimes_servers">Runtimes and Servers in the JBoss AS
plugin</link> chapter.</para>
+
+ <para>To start working with JBoss AS, select a <property>JBoss AS
Perspective</property> via
+ <emphasis><property>Window > Open Perspective > Other > JBoss
AS</property>.</emphasis></para>
+
+<section id="starting">
+ <title>Starting JBoss server</title>
+
+ <para>Starting JBoss server is quite simple. You can control the server behaviour
with the help of a special toolbar in the
+ <property>JBoss Server View</property> where you could
<property>start</property> it in a regular or debug mode,
+ <property>stop</property> it or <property>restart</property>
it, <property>publish</property> to the server.</para>
+
+ <figure>
+ <title>JBoss Server Toolbar</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To launch the server click the green-with-white-arrow icon on the
<property>JBoss Server View </property>or right click server name in this view
and
+ select <emphasis><property>Start</property></emphasis>. If
this view is not open, select <emphasis><property>Window > Show View
> Other > Server >
+ JBoss Server View</property>.</emphasis></para>
+
+ <figure>
+ <title>Start JBoss Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+</section>
+
+ <section id="stopping">
+ <title>Stopping JBoss Server</title>
+
+ <para>To stop the server, click the <property>Stop</property> icon
in JBoss Server View or right click the server name and press
<property>Stop</property>.</para>
+
+ <figure>
+ <title>Stop JBoss Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When the server is stopped you will see
<property>Stopped</property> next to its name in the State
column.</para>
+ <para>Learn more about the JBoss Server View <link
linkend="JBossServerView">here</link>.</para>
+ </section>
+
+ <section id="deployment">
+ <title>Deploying an Application to a Server</title>
+
+ <para>There are two times to deploy your application:</para>
+ <itemizedlist>
+ <listitem><para>While creating it</para></listitem>
+ <listitem><para>After it already exists</para></listitem>
+ </itemizedlist>
+
+ <para>When you create a new project (Seam, JSF or Struts) with the New Project
or Import Project wizards, the one of wizards steps
+ has a Target Runtime and Target Server sections. You can deploy the application
through the appropriate selection in these sections.</para>
+
+ <figure>
+ <title>Runtime and Server Sections in the New Project Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start4.png"
scale="68"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can deploy an existing application to a server by right-clicking the
target defined server in the <property>JBoss Servers View</property>
+ and then selecting <property>Add and Remove Projects</property> from
the context menu.</para>
+
+ <figure>
+ <title>Add and Remove Projects From the Context Menu.</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>If this application is not assigned to a server, it will be in the
left-hand available projects list. Clicking on the <property>Add
></property> button will add it to
+ the right-hand configured projects list and deploy the application to this
server.</para>
+
+ <figure>
+ <title>Modifying The Projects that are Configured on the
Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+ </section>
+
+ <section id="archiving">
+
+ <title>Project Archiving</title>
+
+ <para>JBoss Tools comes with our own archives tool. The Project Archives plugin
consists primarily of a view to set up each packaging configuration
+ (<emphasis><property>Window > Show View > Other > JBoss Tools
> Project archives</property></emphasis>).</para>
+ <para>Right clicking in the Project archives view you can create War, EJB War
or EAR archive.</para>
+
+ <figure>
+ <title>Archive Creating</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Using the context menu on the item you can initiate a full
<property>build</property> on archive, <property>edit</property>,
+ <property>delete</property> or <property>publish</property>
it.</para>
+
+ <figure>
+ <title>Context Menu on the Item</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/quick_start/quick_start8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Learn more about the <property>Project archives
View</property> <link
linkend="Project_archivesView">here</link>.</para>
+
+ </section>
+
+
+
+</chapter>