Installation

Without any installation, you may look at the examples of business decision models and even download many models for free from here and open them in Excel. To get OpenRules Decision Manager software, click on one of the following links:

In all cases, you will receive the latest version of the fully functional OpenRules Decision Manager software by downloading one file. An installed Decision Manager will allow you to execute the standard decision models, create your own projects, deploy them on-cloud or on-premise, and execute them using your preferable communication interface such as JSON, XML, or Java.  

Pre-Requisites:

  1. Java. You need to have Java Development Kit Standard Edition 8 or higher installed. After installation, make sure to correctly set up the Environment variables in the box “User variables“:
    • JAVA_HOME=C:/Program Files/Java/jdk-11 (if you installed JDK 11 or use your actual JDK version)
    • Add %JAVA_HOME%bin to the Path variable.
  2. Maven. You need to have Apache Maven installed. For instance, for Windows download “apache-maven-3.x.y-bin.zip“. After unzipping it to “C:\Program Files\”, make sure to add Maven’s “bin” folder “C:\Program Files\apache-maven-3.x.y\bin” to the Path variable in the user environment variables.
  3. Excel. You will need MS Excel or Google Sheets for rules editing only (you don’t need Excel in run-time).

P.S. If during the installation you are experiencing issues with downloads from the Maven Repository, please check your proxy settings as described here.

Recommend hardware configuration: RAM 8Gb or more and CPU 2.2 GHz or more.

After Download. We assume that you’ve already downloaded “OpenRulesDecisionManager_9.x.x.zip” for Windows or “OpenRulesDecisionManager_9.x.x.tar.gz”  for Mac or Linux. First, make sure that you have JDK 1.8 or higher installed – see the above Pre-Requisites. Then unzip this file on your hard drive. You will get the folder “OpenRulesDecisionManager” that contains everything you need to learn about how OpenRules decision models are organized, how to build, test, and deploy them, and finally how to develop your own operational decision models.

To install OpenRules Decision Manager, use File Manager to locate “OpenRulesDecisionManager/openrules.config” and execute “install.bat” – just double-click on this file.

You need to have Internet connection as the installation will download different related products freely available for downloads. The installation may take up to 1-2 minutes based on your connection speed displaying all downloadable files at the “black” screen. Internally, OpenRules uses Maven plugins but you as a user don’t have to know Maven or even Java. Just make sure that during the installation you don’t receive any red messages and at the end you will see the message:

“OpenRules Decision Manager x.y.z: INSTALLATION COMPLETED”

Any issues? Contact support@openrules.com – we will help.

If you use Linux or Mac OS: The main difference with Windows is that to start any execution, you will use scripts like “install”, “clean”, “test” instead of “install.bat”, “clean.bat”, “test.bat”.

Standard Decision Models. The workspace “OpenRulesDecisionManager” contains several examples of OpenRules projects (decision models) that can be used as prototypes for your own projects:

  • Hello – this is an basic decision project that produces a customer greeting
  • VacationsDays – this is an example of a basic OpenRules project
  • VacationsDaysLambda – this project demonstrates how to deploy the project VacationDays as AWS Lambda function
  • VacationsDaysSpingBoot – this project demonstrates how to deploy the project VacationDays as RESTfull Web Service and how to create a Docker image.

Additional Decision Models. You may download more decision model samples:

Visualize, Test, Debug, and Deploy Decision Models. Each project (under Windows) includes the file “explore.bat” used to start OpenRules Graphical Explorer:

OpenRules Explorer for the decision model “PatientTherapy”

You can see and adjust the decision model diagram, click on the nodes to open Excel files, test, debug, and deploy the decision projects directly from the Explorer.

You also can build and test a decision model from any File Manager such as Windows Explorer or from the command line by running the batch file “test.bat“ .  For Mac or Linux, use the script-file “test“. When you try it for the first time, you may need to confirm that it’s safe to execute this script. If you make any changes in your Excel tables or configuration files, the decision model will be automatically re-built before its execution. If it finds any errors, they will be displayed using the business terms and pointing to the corresponding places in your Excel files.

When you execute the decision model, the Decision Manager produces a user-friendly execution protocol and explanation reports in the HTML format in the generated folder “target/reports“. They also can be seen from OpenRules Explorer.