6:31 a.m.
Author: abogachuk
Date: 2010-05-03 07:31:35 -0400 (Mon, 03 May 2010)
New Revision: 21852
Modified:
trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml
trunk/drools/docs/guvnor_ref/en-US/introduction.xml
Log:
https://jira.jboss.org/jira/browse/TOOLSDOC-6 Show java-doc is shown for EL content assist
item. Screenshot has been made.
TOOLSDOC-63 Eclipse Guvnor Tools Reference Guide restructureing and update. Text was
updated.
Modified: trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml 2010-05-03 09:58:56 UTC
(rev 21851)
+++ trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml 2010-05-03 11:31:35 UTC
(rev 21852)
@@ -266,7 +266,7 @@
<para>As mentioned in the <link
linkend="introduction">"Introduction"</link>, the
main purpose
of the <property>EGT</property> is to allow development using
resources held in a Guvnor
- repository. There are two method of getting local copies of Guvnor
repository
+ repository. There are two methods of getting local copies of Guvnor
repository
resources:</para>
<orderedlist>
@@ -305,10 +305,10 @@
above you can see the <emphasis>
<property>Dummy rule.drl</property></emphasis> file
with the decoration in the <property>Resource Navigator</property>. The Guvnor
icon decorator is on the top right of the file image, and the Guvnor
revision details are appended to the file name. (The presence/location of
these can be
- changed the <link
linkend="resource_decoration_preferences">Guvnor
+ changed in the <link
linkend="resource_decoration_preferences">Guvnor
Preferences</link>.)</para>
- <para>Here we see that, <emphasis><property>Dummy
role.drl</property></emphasis> is associated with a Guvnor repository
+ <para>Here we see that, <emphasis><property>Dummy
rule.drl</property></emphasis> is associated with a Guvnor repository
resource and the local copy is based on revision 0, with a
<code>02-10-2008, 4:21:53</code> date/time
stamp. The file
<emphasis><property>Sample.drl</property>,</emphasis> however, is
not associated with a Guvnor repository
file. Further details about the association can be found in the standard
Eclipse
@@ -496,7 +496,7 @@
<para>The <emphasis>
<property>Show History</property>
- </emphasis> action is enable for one Guvnor repository associated
file and causes
+ </emphasis> action is enabled for one Guvnor repository associated
file and causes
the <link linkend="guvnor_history_view">Guvnor Resource
History view</link> to be
populated with revision history for the selected file.</para>
</section>
@@ -634,7 +634,7 @@
<para>Here we see that the file <emphasis>
<property>test.txt</property>
- </emphasis> has three revisions. Double clicking on a revision row (or
the context menu <emphasis>
+ </emphasis> has seven revisions. Double clicking on a revision row (or
the context menu <emphasis>
<property>Open (Read only)</property>)</emphasis> opens
an Eclipse read-only editor
with the revision contents.</para>
Modified: trunk/drools/docs/guvnor_ref/en-US/introduction.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/introduction.xml 2010-05-03 09:58:56 UTC (rev
21851)
+++ trunk/drools/docs/guvnor_ref/en-US/introduction.xml 2010-05-03 11:31:35 UTC (rev
21852)
@@ -119,7 +119,7 @@
<title>How to start with Guvnor Tools</title>
<para><property>Guvnor Tools</property> is a part of the
<property>JBoss Tools</property>
- project. Thus to get started with <property>Guvnor
Tools</property>, you should have the following:</para>
+ project. Thus to get started with Guvnor Tools, you should have the
following:</para>
<itemizedlist>
<listitem>
@@ -128,14 +128,35 @@
</listitem>
<listitem>
- <para>JBoss Server 4.2 or higher with Guvnor repository deployed.
Thus, you should
- download <ulink
-
url="http://download.jboss.org/drools/release/5.0.0.25561.CR1/drools...
- >Guvnor CR1</ulink> and extract it to the deploy
directory of the
- server.</para>
+ <para>JBoss Server 4.2 or higher with Guvnor repository
deployed.</para>
</listitem>
</itemizedlist>
-
+ <para>To have JBoss Server with Guvnor repository deployed, you should
+ download <ulink
url="http://www.jboss.org/drools/downloads.html">Guvnor</...;.
+ When downloading you may choose either web based Guvnor to deploy to your
+ JBoss Server or Standalone Guvnor with JBoss AS.</para>
+ <para>If you use a JBoss AS 5 and a <property>Guvnor
Tools</property> doesn't work when deployed to the server,
+ you should do the following to get Guvnor Tools running:</para>
+ <orderedlist>
+ <listitem>
+ <para>Remove the JBoss Security libraries
(authorization-spi-2.0.2.CR6.jar,
+ identity-*, acl-spi-2.0.2.CR6.jar) from drools WAR file (not the app
server itself).
+ The JBoss Security libraries are provided in AS 5.</para>
+ </listitem>
+ <listitem>
+ <para>Remove the JAXP libraries (xercesImpl-2.8.0.jar,
xml-apis-2.*)</para>
+ </listitem>
+ <listitem>
+ <para>Remove the EL libraries (el-*)</para>
+ </listitem>
+ </orderedlist>
+ <para>After this, Guvnor should operate as normal.
+ During deployment, you would see the following exception in the log which
indicates that the experiemental
+ JBoss Security based ACL integration has defined some EJB3/JPA stuff in
guvnor that has not been configured.</para>
+ <programlisting>ERROR [AbstractKernelController] Error installing to Start:
name=persistence.unit:unitName=#ACL state=Create
+java.lang.RuntimeException: Specification violation [EJB3 JPA 6.2.1.2] - You have not
defined a non-jta-data-source
+for a RESOURCE_LOCAL enabled persistence context named: ACL
+ </programlisting>
<para>Now refer to the <link
linkend="functionality_overview">"Functionality
Overview"</link> section to find out what you can do with
Guvnor and
Eclipse synchronisation tool.</para>