8:58 a.m.
Author: sabrashevich
Date: 2007-11-12 09:58:15 -0500 (Mon, 12 Nov 2007)
New Revision: 4849
Added:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/default.png
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMLocation.png
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation.png
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation2.png
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation3.png
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation4.png
Modified:
trunk/jbpm/docs/reference/en/modules/jBPMDesignerInstall.xml
Log:
http://jira.jboss.com/jira/browse/RHDS-288 updated second chapter
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/default.png
===================================================================
(Binary files differ)
Property changes on: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/default.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMLocation.png
===================================================================
(Binary files differ)
Property changes on:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMLocation.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation.png
===================================================================
(Binary files differ)
Property changes on:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation2.png
===================================================================
(Binary files differ)
Property changes on:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation3.png
===================================================================
(Binary files differ)
Property changes on:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation4.png
===================================================================
(Binary files differ)
Property changes on:
trunk/jbpm/docs/reference/en/images/jBPMDesignerInstall/jBPMinstallation4.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: trunk/jbpm/docs/reference/en/modules/jBPMDesignerInstall.xml
===================================================================
--- trunk/jbpm/docs/reference/en/modules/jBPMDesignerInstall.xml 2007-11-12 14:40:01 UTC
(rev 4848)
+++ trunk/jbpm/docs/reference/en/modules/jBPMDesignerInstall.xml 2007-11-12 14:58:15 UTC
(rev 4849)
@@ -11,6 +11,121 @@
</keywordset>
</chapterinfo>
<title>JBoss jBPM Graphical Process Designer Installation</title>
-
+ <para>The JBoss jBPM comes as a plugin for Red Hat Developer Studio. So a
prerequisite to install the Designer is of course that you have a version of RHDS up and
running.</para>
+<para>Before installation you should download <property>jBPM</property>
installation pack from this page: <ulink
url="http://labs.jboss.com/auth/jbossjbpm/">jBPM Downloads</ulink>.
The 3.1 release of the designer comes bundled with the corresponding 3.2 releases of the
core jBPM project and the jBPM database project. After downloading save the archive on
your computer.</para>
+<section id="InstallationProcess">
+<?dbhtml filename="InstallationProcess.html"?>
+<title>jBPM Installation Process</title>
+<para>Having RHDS up and running and the JBoss jBPM package downloaded somewhere on
your harddrive, let's describe the process of installing the
plugin.</para>
+<figure>
+<title>Find And Install</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/jBPMinstallation.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>Experienced Eclipse users will feel very comfortable with this description as
it is the normal plugin installation mechanism for local archive update sites. As is
illustrated on the figure above "Find And Install" you have to navigate
to the <emphasis><property>Find and
Install...</property></emphasis> submenu of the Help menu.</para>
+<para>Clicking the <emphasis><property>Find and
Install...</property></emphasis> submenu shown above results in the opening of
a wizard, as shown in the next screen. This wizard enables you to choose between searching
for updates of currently installed plugins and searching for new features. This is the
option we need, so we select it and push the
<emphasis><property>Next</property></emphasis>
button.:</para>
+<figure>
+<title>Search New Features</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/jBPMinstallation2.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>On the next page of the wizard we click the
<emphasis><property>New Archived Site...</property></emphasis>
button.</para>
+<figure>
+<title>Update Sites to Visit</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/jBPMinstallation3.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>The <emphasis><property>Select Local Site
Archive</property></emphasis> dialog opens, we navigate to the freshly
downloaded zipped update site and select it.</para>
+<figure>
+<title>Select Local Site Archive</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/jBPMinstallation4.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>Selecting the archive file and clicking the
<emphasis><property>OK</property></emphasis> button brings us to
another dialog that enables us to edit the name of the update site.</para>
+<figure>
+<title>Edit Local Site Name</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>We accept the defaults and this brings us back to the installation wizard.
The selected archive containing the jBPM Designer plugin site should appear. Make sure the
checkbox next to it is selected before clicking the
<emphasis><property>Finish</property></emphasis>
button:</para>
+<figure>
+<title>Select Update Site to Visit</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>The <emphasis><property>Select Update
Site</property></emphasis> wizard closes but we aren't done yet as
the <emphasis><property>Updates</property></emphasis> wizard opens
immediately. In this wizard expand the tree of your newly added update site, select the
checkbox next to the <emphasis><property>org.jbpm.ide.feature feature
3.1.0</property></emphasis> feature and click the
<emphasis><property>Next</property></emphasis>
button:</para>
+<figure>
+<title>Select the Feature to Install</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>We arrive on the <emphasis><property>Accept Feature
License</property></emphasis> page of the wizard. Select
<emphasis><property>I accept the terms in the license
agreement</property></emphasis> if you do and click the
<emphasis><property>Next</property></emphasis> button
again.</para>
+<figure>
+<title>Accept Feature License</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>Clicking on the
<emphasis><property>Next</property></emphasis> button in the
<emphasis><property>Accept Feature License</property></emphasis>
page has brought us on the final page of this installation wizard: the
<emphasis><property>Installation</property></emphasis> page. Click
<emphasis><property>Finish</property></emphasis> to end this
wizard.</para>
+<figure>
+<title>Install the Selected Feature</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>For a moment, a progress monitor appears, indicating that Red Hat Developer
Studio is busy extracting the necessary information out of the archive file to be able to
install the contained plugins.</para>
+<figure>
+<title>Progress of the Download</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>After a while a new wizard appears:</para>
+<figure>
+<title>Feature Verification</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>Clicking on the <emphasis><property>Install
All</property></emphasis> button results in a progress dialog showing up.
After the installation is finished another dialog asks us whether or not to restart the
workbench immediately. We want to be able to use the newly installed plugins immediately
so we click
<emphasis><property>Yes</property></emphasis>:</para>
+<figure>
+<title>Restart the Workbench</title>
+<mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jBPMDesignerInstall/default.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+<para>Congratulations. The JBoss jBPM GPD plugin is installed and ready to use.
Let's see how we can set up a project and create a process definition in the
following chapter.</para>
+</section>
</chapter>