此内容没有您所选择的语言版本。
Chapter 11. Running standalone Business Central
You can use the Business Central standalone JAR file to run Business Central without needing to deploy it to an application server such as Red Hat JBoss EAP.
Red Hat supports this installation type only when it is installed on Red Hat Enterprise Linux.
Prerequisites
-
The Red Hat Decision Manager 7.4.0 Business Central Standalone (
rhdm-7.4.0-decision-central-standalone.jar
) file has been downloaded, as described in Chapter 3, Downloading the Red Hat Decision Manager installation files.
Procedure
-
Create a directory and move the
rhdm-7.4.0-decision-central-standalone.jar
file to this directory. - In a terminal window, navigate to the directory that contains the standalone JAR file.
Create the
application-users.properties
file. Include an administrative user and if this Business Central instance will be a Decision Manager controller for Decision Server, include a Decision Manager controller user, for example:rhdmAdmin=password1 controllerUser=controllerUser1234
Create the
application-roles.properties
file to assign roles to the users that you included in theapplication-users.properties
file, for example:rhdmAdmin=admin controllerUser=kie-server
Create the
application-config.yaml
configuration file with the following contents, where<APPLICATION_USERS>
is the path to theapplication-users.properties
file and<APPLICATION_ROLES>
is the path to theapplication-roles.properties
file:thorntail: management: security-realms: ApplicationRealm: local-authentication: default-user: local allowed-users: local skip-group-loading: true properties-authentication: path: <APPLICATION_USERS> plain-text: true properties-authorization: path: <APPLICATION_ROLES> datasource: management: wildfly: admin: admin
Enter the following command:
java -jar rhdm-7.4.0-decision-central-standalone.jar -s application-config.yaml
In addition, you can set any properties supported by Business Central by including the
-D<property>=<value>
parameter in this command, for example:java -jar rhdm-7.4.0-decision-central-standalone.jar -s application-config.yaml -D<property>=<value> -D<property>=<value>
See Section 11.1, “Supported properties” for more information.
11.1. Supported properties
The Business Central system properties listed in this section are passed to standalone*.xml
files.
To install standalone Business Central, you can use the listed properties in the following command:
java -jar rhdm-7.4.0-decision-central-standalone.jar -s application-config.yaml -D<property>=<value> -D<property>=<value>
In this command, <property>
is a property from the following list and <value>
is a value that you assign to that property.
- Git directory
Use the following properties to set the location and name for the Business Central Git directory:
-
org.uberfire.nio.git.dir
: Location of the Decision Server Git directory. -
org.uberfire.nio.git.dirname
: Name of the Decision Server Git directory. Default value:.niogit
.
-
- Git over HTTP
Use the following properties to configure access to the Git repository over HTTP:
-
org.uberfire.nio.git.proxy.ssh.over.http
: Specifies whether SSH should use an HTTP proxy. Default:false
-
http.proxyHost
: Defines the host name of the HTTP proxy. Default:null
-
http.proxyPort
: Defines the host port (integer value) of the HTTP proxy. Default:null
-
org.uberfire.nio.git.http.enabled
: Enables or disables the HTTP daemon. Default:true
-
org.uberfire.nio.git.http.host
: If the HTTP daemon is enabled, it uses this property as the host identifier. This is an informative property that is used to display how to access the Git repository over HTTP. The HTTP still relies on the servlet container. Default:localhost
-
org.uberfire.nio.git.http.hostname
: If the HTTP daemon is enabled, it uses this property as the host name identifier. This is an informative property that is used to display how to access the Git repository over HTTP. The HTTP still relies on the servlet container. Default:localhost
-
org.uberfire.nio.git.http.port
: If the HTTP daemon is enabled, it uses this property as the port number. This is an informative property that is used to display how to access the Git repository over HTTP. The HTTP still relies on the servlet container. Default:8080
-
- Git over HTTPS
Use the following properties to configure access to the Git repository over HTTPS:
-
org.uberfire.nio.git.proxy.ssh.over.https
: Specifies whether SSH should use an HTTPS proxy. Default:false
-
https.proxyHost
: Defines the host name of the HTTPS proxy. Default:null
-
https.proxyPort
: Defines the host port (integer value) of the HTTPS proxy. Default:null
-
org.uberfire.nio.git.https.enabled
: Enables or disables the HTTPS daemon. Default:false
-
org.uberfire.nio.git.https.host
: If the HTTPS daemon is enabled, it uses this property as the host identifier. This is an informative property that is used to display how to access the Git repository over HTTPS. The HTTPS still relies on the servlet container. Default:localhost
-
org.uberfire.nio.git.https.hostname
: If the HTTPS daemon is enabled, it uses this property as the host name identifier. This is an informative property that is used to display how to access the Git repository over HTTPS. The HTTPS still relies on the servlet container. Default:localhost
-
org.uberfire.nio.git.https.port
: If the HTTPS daemon is enabled, it uses this property as the port number. This is an informative property that is used to display how to access the Git repository over HTTPS. The HTTPS still relies on the servlet container. Default:8080
-
- Git daemon
Use the following properties to enable and configure the Git daemon:
-
org.uberfire.nio.git.daemon.enabled
: Enables or disables the Git daemon. Default value:true
. -
org.uberfire.nio.git.daemon.host
: If the Git daemon is enabled, it uses this property as the local host identifier. Default value:localhost
. -
org.uberfire.nio.git.daemon.hostname
: If the Git daemon is enabled, it uses this property as the local host name identifier. Default:localhost
-
org.uberfire.nio.git.daemon.port
: If the Git daemon is enabled, it uses this property as the port number. Default value:9418
. org.uberfire.nio.git.http.sslVerify
: Enables or disables SSL certificate checking for Git repositories. Default:true
NoteIf the default or assigned port is already in use, a new port is automatically selected. Ensure that the ports are available and check the log for more information.
-
- Git SSH
Use the following properties to enable and configure the Git SSH daemon:
-
org.uberfire.nio.git.ssh.enabled
: Enables or disables the SSH daemon. Default value:true
. -
org.uberfire.nio.git.ssh.host
: If the SSH daemon enabled, it uses this property as the local host identifier. Default value:localhost
. -
org.uberfire.nio.git.ssh.hostname
: If the SSH daemon is enabled, it uses this property as local host name identifier. Default:localhost
org.uberfire.nio.git.ssh.port
: If the SSH daemon is enabled, it uses this property as the port number. Default value:8001
.NoteIf the default or assigned port is already in use, a new port is automatically selected. Ensure that the ports are available and check the log for more information.
-
org.uberfire.nio.git.ssh.cert.dir
: Location of the.security
directory where local certificates are stored. Default: the working directory. -
org.uberfire.nio.git.ssh.passphrase
: Pass phrase used to access the public key store of your operating system when cloning git repositories with SCP style URLs. Example:git@github.com:user/repository.git
. -
org.uberfire.nio.git.ssh.algorithm
: Algorithm used by SSH. Default value:RSA
. -
org.uberfire.nio.git.ssh.ciphers
: A comma-separated string of ciphers. The available ciphers areaes128-ctr
,aes192-ctr
,aes256-ctr
,arcfour128
,arcfour256
,aes192-cbc
,aes256-cbc
. If the property is not used, all available ciphers are loaded. org.uberfire.nio.git.ssh.macs
: A comma-separated string of message authentication codes (MACs). The available MACs arehmac-md5
,hmac-md5-96
,hmac-sha1
,hmac-sha1-96
,hmac-sha2-256
,hmac-sha2-512
. If the property is not used, all available MACs are loaded.NoteIf you plan to use RSA or any algorithm other than DSA, make sure you set up your application server to use the Bouncy Castle JCE library.
-
- Decision Server nodes and Decision Manager controller
Use the following properties to configure the connections with the Decision Server nodes from the Decision Manager controller:
-
org.kie.server.controller
: URL for connecting with a Decision Manager controller, for example:ws://localhost:8080/decision-central/websocket/controller
-
org.kie.server.user
: User name used to connect with the Decision Server nodes from the Decision Manager controller. This property is only required when using this Business Central installation as a Decision Manager controller. -
org.kie.server.pwd
: Password used to connect to the Decision Server nodes from the Decision Manager controller. This property is only required when using this Business Central installation as a Decision Manager controller.
-
- Maven and miscellaneous
Use the following properties to configure Maven and other miscellaneous functions:
-
org.uberfire.gzip.enable
: Enables or disables Gzip compression on theGzipFilter
compression filter. Default value:true
-
org.uberfire.metadata.index.dir
: Place where the Lucene.index
directory is stored. Default: the working directory -
org.uberfire.ldap.regex.role_mapper
: Regex pattern used to map LDAP principal names to the application role name. Note that the variable role must be part of the pattern because it is substituted by the application role name when matching a principal value to a role name. Default: Not used. -
org.uberfire.sys.repo.monitor.disabled
: Disables the configuration monitor. Do not disable unless you are sure. Default value:false
-
org.uberfire.secure.key
: Password used by password encryption. Default value:org.uberfire.admin
-
org.uberfire.secure.alg
: Crypto algorithm used by password encryption. Default value:PBEWithMD5AndDES
-
org.uberfire.domain
: Security-domain name used by uberfire. Default value:ApplicationRealm
-
org.guvnor.m2repo.dir
: Place where the Maven repository folder is stored. Default value:<working-directory>/repositories/kie
-
org.guvnor.project.gav.check.disabled
: Disables group ID, artifact ID, and version (GAV) checks. Default value:false
-
org.kie.build.disable-project-explorer
: Disables automatic build of a selected project in Project Explorer. Default value:false
-
org.kie.verification.disable-dtable-realtime-verification
: Disables the real-time validation and verification of decision tables. Default value:false
kie.maven.offline.force
: Forces Maven to behave as offline. If true, disable online dependency resolution. Default:false
.NoteUse this property for Business Central only. If you share a runtime environment with any other component, isolate the configuration and apply it only to Business Central.
-