Chapter 20. Configuring and running standalone Business Central

Procedure

1. Extract the downloaded rhdm-7.12.0-addons.zip to a temporary directory. This archive includes the rhdm-7.12.0-standalone-sample-configuration.zip file.

2. Extract the rhdm-7.12.0-standalone-sample-configuration.zip file to the directory that contains the rhdm-7.12.0-decision-central-standalone.jar file. The rhdm-7.12.0-standalone-sample-configuration.zip file contains the following sample configuration files:

   • application-script.cli: Sample script for adding a user and kie server system properties

   • kie-fs-realm-users: Sample user data

     You can run the rhdm-7.12.0-decision-central-standalone.jar files with the sample data provided in the configuration files or you can customize the data for your requirements.

3. To customize the configuration data, complete the following steps:

   1. Edit the application-script.cli file to include an administrative user with admin, user, rest-all, rest-client and kie-server roles. In the following example, replace <USERNAME> and <PASSWORD> with your username and password of the user you want to create.

      /subsystem=elytron/filesystem-realm=KieRealm:add-identity(identity=<USERNAME>)
      /subsystem=elytron/filesystem-realm=KieRealm:set-password(identity=<USERNAME>, clear={password="<PASSWORD>"})
      /subsystem=elytron/filesystem-realm=KieRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=["admin","user","rest-all","rest-client","kie-server"])

      Copy to Clipboard Toggle word wrap

4. To run the Business Central standalone JAR file, enter the following command:

   java -jar rhdm-7.12.0-decision-central-standalone.jar --cli-script=application-script.cli

   Copy to Clipboard Toggle word wrap

5. To set application properties when you run the JAR file, include the -D<PROPERTY>=<VALUE> parameter in the command, where <PROPERTY> is the name of a supported application property and <VALUE> is the property value:

   java -jar rhdm-7.12.0-decision-central-standalone.jar --cli-script=application-script.cli -D<PROPERTY>=<VALUE> -D<PROPERTY>=<VALUE>

   Copy to Clipboard Toggle word wrap

   For example, to run Business Central and connect to KIE Server as the user controllerUser, enter:

   java -jar rhdm-7.12.0-decision-central-standalone.jar \
    --cli-script=application-script.cli \
   -Dorg.kie.server.user=controllerUser \
   -Dorg.kie.server.pwd=controllerUser1234

   Copy to Clipboard Toggle word wrap

   Doing this enables you to deploy containers to KIE Server. See Appendix A, Business Central system properties for more information.

   Note

   To enable user and group management in Business Central, set the value of the org.uberfire.ext.security.management.wildfly.cli.folderPath property to kie-fs-realm-users.