Welcome to the wiki landing page for Drools. This site is for the project Drools - for information about the product (sometimes known as JBoss Rules or BRMS platform) - see here. Drools is the upstream project of the BRMS platform (as well as feeding into other platforms). Please feel free to add your own tips/gotchas - you just need to sign-up for a jboss.org account (free and open to everyone).
Events and up to date info
Please read and subscribe to the the blog. Upcoming events and latest news appear there, as well as articles and much more.
Getting help from the community
Pre-installed Development environment for Virtual Box
Details on the virtual box image can be found here.
We are now running the excellent Hudson build tool. Whenever a change is made, it will build. You can track it from https://hudson.jboss.org/hudson/job/drools/. To get the latest SNAPSHOT releases, go to https://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/. After a commit, a new build is usually available 30-ish minutes later (if successful), depending on load/time of day etc.
NOTE: There is also a complete manual for JBoss Drools, this wiki supplements the formal manual (see below for links).
Help in translations is always welcome. Guvnor (the web console) is available in various languages thanks to volunteers..
Getting help and helping out
As normal, the maniacs can be found in the drools IRC room at irc.codehaus.org. Web client available for those behind a firewall http://irc.codehaus.org. Mark Proctor is known as "conan", and he is a vegetarian, so he won't bite. The others are not though
Use the mailing lists. Use the "user" list for end user issues, "dev" for when you are mucking about with the internals.
Use jira to log issues.
Business Rules community A useful site especially for business rule analysis (your best buddies remember !)
- Solving planning problems: Introducing drools-solver (now known as drools-planner)
From the download page there are samples to show of various aspects. Some samples may be found on the wiki from time to time which are more up to date/richer.
Drools Puzzles - (A Regular Drools Programming Contest)
Since August 2007 we have a regular programming contest for JBoss-Drools. Initiated by E.Zhao, open to everyone. See the JBoss-Drools puzzle page for details. You might even win a price...
Drools Research Network
Drools is used in a number of research projects in various universities, this page attempts to list some of these and provides details on the mailing list for academic collaborative efforts.
TIPS, TRICKS & FAQ for users (rule developers)
- Deploying Guvnor on JBoss AS 5
- Clustering Guvnor (if you really really have to)Drools Guvnor 5.0 in JBoss AS 5
Deploying BRMS on Tomcat 6, Jetty etc (some tweaks to libs are needed).
Dynamically add a property change listener to your beans This means you don't need to "modify" object changes
Tomcat (and JBoss AS) Issues and tricks - also applies to app servers that use tomcat or similar for JSP compilation
Drools library in JBoss AS- NullPointerException at org.drools.compiler.PackageBuilder.compile(Unknown Source) using JBossAS 4.0.4GA
Have problems with serialization? Then read this
Counting facts from the LHS
- Ant Task
- Eclipse plug-in Installation Instructions for Rational Application Developer v. 7.0: here
Rule patterns and practices
Tips for JBoss Rules developers/contributors
We have just moved to an ant driven build system (it uses maven 2 underneath, but you don't need to install maven yourself) due to complaints. See the manual for details on how to build.
Presentations (feel free to use as needed)
Many more, scan the blog for links to them.
JBoss Rules is made available at the JBoss maven2 repository http://repository.jboss.com/maven2/ in the following directory http://repository.jboss.com/maven2/org/drools/. We do not currently upload to ibiblio, but community members are welcome.
Feel free to edit/add to this wiki - the aim of the wiki is not to be a manual, but to be a general "catch all" area for helpful tips and links. Also, articles and documentation may be entered here first, when its ready, it will then be formally moved into the manual for future reference. In the old Drools web site, the wiki was also the documentation, but for Drools 3 onwards, we are providing a formal manual for this purpose.
Many tips are from real world deployments, add more of your own Feedback/contributions are always appreciated. Its a wiki !
Information can still be located here
Design and Enhancement ideas
This section is for contributors (of ideas and code) or people interested in the future directions of JBoss Rules. Some of these ideas are works well in progress, some are just concepts/thoughts. Jump in, the water is warm (its a wiki !).