From: <jbo...@li...> - 2006-05-02 08:03:32
|
Author: mic...@jb... Date: 2006-05-02 04:03:25 -0400 (Tue, 02 May 2006) New Revision: 4034 Modified: labs/jbossrules/trunk/documentation/manual/en/Chapter-Install/Section-Install.xml Log: Modified: labs/jbossrules/trunk/documentation/manual/en/Chapter-Install/Section-Install.xml =================================================================== --- labs/jbossrules/trunk/documentation/manual/en/Chapter-Install/Section-Install.xml 2006-05-02 07:34:20 UTC (rev 4033) +++ labs/jbossrules/trunk/documentation/manual/en/Chapter-Install/Section-Install.xml 2006-05-02 08:03:25 UTC (rev 4034) @@ -20,7 +20,7 @@ <para>Alternatively, you can download the binary distribution, and include the relevant jars in your projects classpath.</para> - <para /> + <para></para> <section> <title>Dependencies and jars</title> @@ -77,6 +77,11 @@ provides runtime compiling capability, "POI" which provides the spreadsheet parsing ability, and "antlr" which provides the parsing for the rule language itself.</para> + + <para>NOTE: if you are using Drools in J2EE or servlet containers and you + come across classpath issues with "JDT", then you can switch to the janino + compiler. Set the system property "drools.compiler": For example: + -Ddrools.compiler=JANINO.</para> </section> <section> @@ -93,169 +98,151 @@ environments.</para> </section> - <section> - <title>Installing IDE (Rule Workbench)</title> - <para>The rule workbench (for Eclipse) requires that you have eclipse 3.2 or greater. You can install it either by downloading the plugin or, or using the update site.</para> + <title>Installing IDE (Rule Workbench)</title> - <section> - <title>Installing from zip file</title> - <para> - To install from the zip file, download and unzip the file. Inside the zip you will see a plugin directory, and the plugin jar itself. You place the plugin jar into your eclipse applications plugin directory, and restart eclipse. - </para> - </section> + <para>The rule workbench (for Eclipse) requires that you have eclipse 3.2 + or greater. You can install it either by downloading the plugin or, or + using the update site.</para> - <section> - <title>Installing from the update site</title> - <para>Using the update site is a handy way to install the plug in, and keep it up to date (the eclipse platform will check for updates as needed). It gives you a good chance of staying up to date with improvements, fixes etc.</para> - <para>Some firewalls may cause trouble with using update sites in eclipse, if you have issues, then install it manually from the plugin. Also, if you have previously installed the plug in manually, you will need to manually remove it from your plug in directory.</para> + <section> + <title>Installing from zip file</title> - <para>Step 1. Use the eclipse help menu to fine the feature installer. - <screenshot> - <screeninfo>Access the software updates menu</screeninfo> + <para>To install from the zip file, download and unzip the file. Inside + the zip you will see a plugin directory, and the plugin jar itself. You + place the plugin jar into your eclipse applications plugin directory, + and restart eclipse.</para> + </section> - <mediaobject> - <imageobject> - <imagedata fileref="help_menu.png" /> - </imageobject> - </mediaobject> - </screenshot> + <section> + <title>Installing from the update site</title> - - </para> + <para>Using the update site is a handy way to install the plug in, and + keep it up to date (the eclipse platform will check for updates as + needed). It gives you a good chance of staying up to date with + improvements, fixes etc.</para> - <para>Step 2: Choose the option for installing a new feature (obviously in future, if you want to check for updates, you use the other option !). - <screenshot> - <screeninfo>Search for new features</screeninfo> + <para>Some firewalls may cause trouble with using update sites in + eclipse, if you have issues, then install it manually from the plugin. + Also, if you have previously installed the plug in manually, you will + need to manually remove it from your plug in directory.</para> - <mediaobject> - <imageobject> - <imagedata fileref="search_new_features.png" /> - </imageobject> - </mediaobject> - </screenshot> + <para>Step 1. Use the eclipse help menu to fine the feature installer. + <screenshot> + <screeninfo>Access the software updates menu</screeninfo> - </para> + <mediaobject> + <imageobject> + <imagedata fileref="help_menu.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <para>Step 3: This screen will show what update sites are already configured for your Eclipse instance. - <screenshot> - <screeninfo>Update sites</screeninfo> + <para>Step 2: Choose the option for installing a new feature (obviously + in future, if you want to check for updates, you use the other option + !). <screenshot> + <screeninfo>Search for new features</screeninfo> - <mediaobject> - <imageobject> - <imagedata fileref="update_sites_existing.png" /> - </imageobject> - </mediaobject> - </screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="search_new_features.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - </para> + <para>Step 3: This screen will show what update sites are already + configured for your Eclipse instance. <screenshot> + <screeninfo>Update sites</screeninfo> - <para>Step 4: This screen is where you enter in the remote site details. You give it a name eg "JBoss Rules" and the url. + <mediaobject> + <imageobject> + <imagedata fileref="update_sites_existing.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <programlisting>URL: http://anonsvn.labs.jboss.com/labs/jbossrules/updates/drools-ide-update/</programlisting> + <para>Step 4: This screen is where you enter in the remote site details. + You give it a name eg "JBoss Rules" and the url. <programlisting>URL: http://anonsvn.labs.jboss.com/labs/jbossrules/updates/drools-ide-update/</programlisting> + <screenshot> + <screeninfo>New remote site</screeninfo> - <screenshot> - <screeninfo>New remote site</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="new_remote_site.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <mediaobject> - <imageobject> - <imagedata fileref="new_remote_site.png" /> - </imageobject> - </mediaobject> - </screenshot> + <para>Step 5: Select the new update site you just added. Eclipse will + remember this for when it checks for updates automatically in the + future. <screenshot> + <screeninfo>Choose the newly added update site</screeninfo> - </para> + <mediaobject> + <imageobject> + <imagedata fileref="update_sites.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <para>Step 5: Select the new update site you just added. Eclipse will remember this for when it checks for updates automatically in the future. + <para>Step 6: You should see the available features (Drools IDE) + retrieved from the update site. <screenshot> + <screeninfo>Available features</screeninfo> - <screenshot> - <screeninfo>Choose the newly added update site</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="search_results.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <mediaobject> - <imageobject> - <imagedata fileref="update_sites.png" /> - </imageobject> - </mediaobject> - </screenshot> + <para>Step 7: The licence agreement. Choose the option to accept the + licence agreement. Once this happens, the workbench will start + downloading. Might be an opportune time to go have a coffee. <screenshot> + <screeninfo>Licence</screeninfo> - </para> + <mediaobject> + <imageobject> + <imagedata fileref="licence.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <para>Step 6: You should see the available features (Drools IDE) retrieved from the update site. + <para>Step 8: Confirm that this is the feature you want. <screenshot> + <screeninfo>Confirmation</screeninfo> - <screenshot> - <screeninfo>Available features</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="confirm.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <mediaobject> - <imageobject> - <imagedata fileref="search_results.png" /> - </imageobject> - </mediaobject> - </screenshot> + <para>Step 9: Press Accept to accept the fact that the feature is not + digitally signed. No one signs their features, its a silly default + screen in Eclipse. <screenshot> + <screeninfo>Verify</screeninfo> - </para> + <mediaobject> + <imageobject> + <imagedata fileref="digital_sign.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <para>Step 7: The licence agreement. Choose the option to accept the licence agreement. Once this happens, the workbench will start downloading. Might be an opportune time to go have a coffee. + <para>Step 10: The workbench will need to restart now for the feature to + take effect. <screenshot> + <screeninfo>Restart the workbench</screeninfo> - <screenshot> - <screeninfo>Licence</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="restart.png" /> + </imageobject> + </mediaobject> + </screenshot></para> - <mediaobject> - <imageobject> - <imagedata fileref="licence.png" /> - </imageobject> - </mediaobject> - </screenshot> - - </para> - - <para>Step 8: Confirm that this is the feature you want. - - <screenshot> - <screeninfo>Confirmation</screeninfo> - - <mediaobject> - <imageobject> - <imagedata fileref="confirm.png" /> - </imageobject> - </mediaobject> - </screenshot> - - </para> - - <para>Step 9: Press Accept to accept the fact that the feature is not digitally signed. No one signs their features, its a silly default screen in Eclipse. - - <screenshot> - <screeninfo>Verify</screeninfo> - - <mediaobject> - <imageobject> - <imagedata fileref="digital_sign.png" /> - </imageobject> - </mediaobject> - </screenshot> - - </para> - - <para>Step 10: The workbench will need to restart now for the feature to take effect. - - <screenshot> - <screeninfo>Restart the workbench</screeninfo> - - <mediaobject> - <imageobject> - <imagedata fileref="restart.png" /> - </imageobject> - </mediaobject> - </screenshot> - - </para> - - - <para>Now go have another coffee, and then take a look at the chapter on the Rule Workbench for what you can do with it.</para> - - - - </section> + <para>Now go have another coffee, and then take a look at the chapter on + the Rule Workbench for what you can do with it.</para> + </section> </section> - </section> \ No newline at end of file |