Installing Kie Server & Drools Workbench Part 2: installing kie-server & Drools Workbench

Yes. yes, I admit that the title is ridiculous. Anyhow, you should now have WildFly up and running, so let’s move on. To accommodate the kie-server and specifically the Drools Worbench, we need to modify the JVM Heap Size of our WildFly server. Open up the standalone.conf:

[root@devdm ~]# vi /opt/wildfly11/bin/standalone.conf

Update the following line, from:

JAVA_OPTS="-Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"


JAVA_OPTS="-Xms128m -Xmx2048m -XX:MetaspaceSize=512M -XX:MaxMetaspaceSize=1024m"

Next, download kie-server and drools workbench:

[root@devdm ~]# wget
[root@devdm ~]# wget
Configuring kie-server

Let’s do the kie-server first. Unzip and copy the ee7 kie-server to the deployment directory:

[root@devdm ~]# unzip
[root@devdm ~]# cp kie-server-7.12.0.Final-ee7.war /opt/wildfly11/standalone/deployments/kie-server.war

Create a service user for kie-server:

[root@devdm ~]# cd /opt/wildfly11/bin/
[root@devdm bin]# ./ -a -u kieserver -p kieserver1! -ro admin,kie-server
Added user 'kieserver' to file '/opt/wildfly11/standalone/configuration/'
Added user 'kieserver' to file '/opt/wildfly11/domain/configuration/'
Added user 'kieserver' with groups admin,kie-server to file '/opt/wildfly11/standalone/configuration/'
Added user 'kieserver' with groups admin,kie-server to file '/opt/wildfly11/domain/configuration/'

Create another one for our admin use:

[root@devdm bin]# ./ -a -u kieadmin -p kieserver1!! -ro admin,kie-server
./ -a -u kieadmin -p kieserver1./ -a -u kieserver -p kieserver1! -ro admin,kie-server -ro admin,kie-server
Updated user 'kieserver' to file '/opt/wildfly11/standalone/configuration/'
Updated user 'kieserver' to file '/opt/wildfly11/domain/configuration/'
Updated user 'kieserver' with groups admin,kie-server to file '/opt/wildfly11/standalone/configuration/'
Updated user 'kieserver' with groups admin,kie-server to file '/opt/wildfly11/domain/configuration/'

kie-server requires the standalone-full configuration, so let’s configure those:

[root@devdm bin]# vi /opt/wildfly11/standalone/configuration/standalone-full.xml

Change all instance of “ ” to “”, and then save


        <interface name="management">
            <inet-address value="${}"/>
        <interface name="public">
            <inet-address value="${jboss.bind.address:}"/>
        <interface name="unsecure">
            <inet-address value="${jboss.bind.address.unsecure:}"/>

If WildFly is currently running, shut it down:

[root@devdm ~]# cd /opt/wildfly11/bin/
[root@devdm bin]# ./ 
You are disconnected at the moment. Type 'connect' to connect to the server or 'help' for the list of supported commands.
[disconnected /] connect
[standalone@localhost:9990 /] shutdown
[disconnected /] exit

Let’s try starting up the kie-server:

nohup ./ --server-config=standalone-full.xml -Dorg.kie.server.location=http://your.server.ip.address:8080/kie-server/services/rest/server &

Point your browser to http://your.server.ip.address:8080/kie-server/services/rest/server to see if it’s up:

Configuring Drools Workbench

Now for the Drools Workbench. Rename and move the the Drools Workbench file to the deployment directory:

[root@devdm ~]# cp kie-drools-wb-7.12.0.Final-wildfly11.war /opt/wildfly11/standalone/deployments/kie-drools-wb.war

Point the URL configuration to each of servers on the startup command:

[root@devdm bin]# nohup ./ --server-config=standalone-full.xml -Dorg.kie.server.user=kieserver -Dorg.kie.server.pwd=kieserver1! -Dorg.kie.server.controller.user=kieserver -Dorg.kie.server.controller.pwd=kieserver1! -Dorg.kie.server.location=http://your.server.ip.address:8080/kie-server/services/rest/server -Dorg.kie.server.controller=http://your.server.ip.address:8080/kie-drools-wb/rest/controller &

A couple explanation for the parameters:

  • –server-config=standalone-full.xml tells the startup process to use standalone-full configuration which is required for the kie-server
  • -Dorg.kie.server.user=kieserver -Dorg.kie.server.pwd=kieserver1! tell startup script to use these credentials for remote communication between the kie-server and the workbench
  • -Dorg.kie.server.controller.user=kieserver -Dorg.kie.server.controller.pwd=kieserver1! is the same as the above
  • -Dorg.kie.server.location=http://your.server.ip.address:8080/kie-server/services/rest/server configures the URL for kie-server
  • -Dorg.kie.server.controller=http://your.server.ip.address:8080/kie-drools-wb/rest/controller configures the URL for the Drools Workbench
  • configures  the name of automatically generated default server configuration

Additionally, kie-server and kie-drools-wb are the names of the war files for kie-server and the workbench respectively, that we put into the deployment directory on the previous step. If you rename your war files differently, then you should modify the url accordingly.

Open the workbench by pointing your browser to http://your.server.ip.address:8080/kie-drools-wb

Log into the Workbench using the admin user we created earlier, click on “Menu”, and on “Deploy” section, click on “Execution Servers”

If we got it correctly, a remote server and default configuration named “wildfly-kieserver should be automatically configured and listed on the web console:

The kie-server and Drools Workbench are now ready to use.


One Comment Add yours

  1. Zuhdan Ubay says:

    Hello blog keeper…
    i got error while starting standalone.bat using params…
    this is my error…

    D:\WORK\TAB\workbench\wildfly-18.0.1.Final\wildfly-18.0.1.Final\bin> .\standalone.bat –server-config=standalone-full.xml -Dorg.kie.server.location=http://localhost:8080/kie-server/services/rest/server
    Calling “D:\WORK\TAB\workbench\wildfly-18.0.1.Final\wildfly-18.0.1.Final\bin\standalone.conf.bat”
    Setting JAVA property to “C:\Program Files\Java\jdk1.8.0_221\bin\java”

    JBoss Bootstrap Environment

    JBOSS_HOME: “D:\WORK\TAB\workbench\wildfly-18.0.1.Final\wildfly-18.0.1.Final”

    JAVA: “C:\Program Files\Java\jdk1.8.0_221\bin\java”

    JAVA_OPTS: “ -Xms64M -Xmx512M -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djboss.modules.system.pkgs=org.jboss.byteman ”


    11:16:39,263 INFO [org.jboss.modules] (main) JBoss Modules version 1.9.1.Final
    WFLYSRV0073: Invalid option ‘.kie.server.location=http://localhost:8080/kie-server/services/rest/server’

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.