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">&quot;Introduction&quot;</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">&quot;Functionality Overview&quot;</link> section to find out what you can do with Guvnor and Eclipse synchronisation tool.</para>