This page will guide you through the steps necessary to obtain and operate your own Kinetic Rules Engine (KRE).
Learning Objectives
After completing this quickstart lesson, you will:
- understand important concepts about programming in KRL including ruleset structure*
- know how to install and operate the node pico-engine
- know how to use the "Engine Rulesets" page to register a ruleset
- know how to add a ruleset to a pico
- become familiar with using the "My Picos" page to work with your picos
Concepts
*This section is copied verbatim from Quickstart (the one for the original KRE system)
...
KRL is executed by your instance of the node pico-engine, an open-source, cloud-based rule processing system. All of the properties listed above are present in any KRE system.
Install and run the node pico-engine
Prerequisite: you will need to install node (also known as Node.js) on your machine. It includes npm, the node package manager.
...
Note that the web server displays the URL of its document root, ex. "http://localhost:8084" and then continues to run. As we will see later, messages will be logged to this console.
Create a primary, or owner pico
Visit the default web page of your web server. As this page loads, it will perform a bootstrap sequence, which creates a pico, naming it "Owner Pico" and then registers and installs two rulesets.
...
In the console window in which the node pico-engine is running, there will be some logging concerning the two events sent during intial bootstrapping. You may find it interesting to try to make sense of these log messages.
Writing KRL
Here is a sample KRL ruleset:
...
Finally, click on the "install" button. This causes the pico-engine to compile the KRL and cache the compiled version in a rulesets folder. Once this has been done, the ruleset can be added to picos.
Adding the Ruleset to your pico
So far, you have installed the ruleset into your pico-engine. But it can't run unless it has been added to a pico.
...
Notice that you are able to delete the ruleset from the pico.
Next Steps
Having completed this quickstart, you should continue with Lesson 1. events Events and queriesQueries