JBoss.orgCommunity Documentation

Chapter 2. Quick Start Guide

2.1. Quick start guide
2.1.1. Supported browser platforms
2.1.2. Initial configuration
2.1.3. Writing a rule
2.1.4. Finding stuff
2.1.5. Deployment

If you are reading this, you must be the impatient type who wants to kick the tires (and light the fires) and have a look around as soon as possible. This section will provide a quick end to end tour of the steps involved (but does not go through the concepts in detail). This assumes you have installed the repository correctly, and are able to access the main login screen.

You can also consult the wiki for some tutorials and user tips (it IS a wiki, so you can even contribute your own tips and examples and even upload files if you desire !).


The above picture shows the main feature areas of Guvnor.

  • Info: This is the initial screen, with links to resources.

  • Rules: This is the category and business user perspective.

  • Package: This is where packages are configured and managed.

  • Deployment: this is where deployment snapshots are managed.

  • Admin: Administrative functions (categories, statuses, import and export)

Some initial setup is required the first time. The first time the server starts up, it will create an empty repository, then take the following steps:

  • Once deployed, go to http://localhost:8080/guvnor-webapp/ This will show the initial info screen or login screen depending on the configuration.

  • If it is a brand new repository, you will want to go to "Admin", and choose "Manage Categories"

    (Add a few categories of your choosing, categories are only for classification, not for execution or anything else and are optional, but recommended).

  • Rules and other assets belong to a Package, a container for related artifacts.

    • Select the "Knowledge Bases" section of the menu-bar on the left-hand side of the Guvnor main window.

    • Click on "Create New" to show the types of asset that can be created and select "New Package". Click on "Create new package" and enter a suitable name.

    • Click "Create package".

  • Rules need a fact model (object model) to work. The model defines your domain artifacts representing the knowledge you wish to manage.

    • Select the "Knowledge Bases" section of the menu-bar on the left-hand side of the Guvnor main window.

    • Click on "Create New" and select "Upload POJO model JAR" (if you have a JAR containing your Java model).

    • Enter a suitable name and ensure the package you defined above is selected in the "Create in package" dropdown.

    • Click OK

    • The POJO Upload screen is displayed.

    • Click on "Browse" and select your JAR file.

    • Click on "Upload".

  • At this point, the package is configured and ready to go (you generally won't have to go through that step very often).

    (Note that you can also import an existing DRL package - it will store the rules in the repository as individual assets).