Chapter 54. Configuring Oracle WebLogic Server for KIE Server

Procedure

1. In the WebLogic Administration Console, click Security Realms.
2. Choose your desired security realm or click New to create a new security realm.
3. Navigate to Users and Groups Groups New and create the kie-server group.
4. Navigate to Users New and create a new user.

5. Enter a user, such as server-user, and a password for this new user and click OK.

   Important

   Make sure that the selected user name does not conflict with any known title of a role or a group. For example, if there is a role called kie-server, then do not create a user with the user name kie-server.

6. Click the newly created user, then return to the Groups tab.
7. Use the selection tool to move the kie-server group from the Available field to the Chosen field, and click Save.

Procedure

1. Set the following system property to increase the Java Virtual Machine (JVM) memory size:

   USER_MEM_ARGS=-Xms512m -Xmx1024m

   Copy to Clipboard Toggle word wrap

   If you do not increase the JVM memory size, Oracle WebLogic Server freezes or causes deployment errors when deploying KIE Server.

2. Specify the following system properties for KIE Server on the Oracle WebLogic Server instance:

   Expand

   Table 54.3. System properties for KIE Server

   Name	Value	Description
   kie.server.jms.queues.response	jms/KIE.SERVER.RESPONSE	The JNDI name of JMS queue for responses used by the KIE Server.
   org.kie.server.domain	OracleDefaultLoginConfiguration	JAAS LoginContext domain used to authenticate users when using JMS.
   org.jbpm.server.ext.disabled	true	Disables Business Central features, which are not supported in RHDM. If not set, KIE Server will work, but will show error messages during start up.
   org.jbpm.ui.server.ext.disabled	true	Disables Business Central features, which are not supported in RHDM. If not set, KIE Server will work, but will show error messages during start up.
   org.jbpm.case.server.ext.disabled	true	Disables Business Central features, which are not supported in RHDM. If not set, KIE Server will work, but will show error messages during start up.

   Show more

3. Set the same property values in the JAVA_OPTIONS environment variable:

   JAVA_OPTIONS="-Dkie.server.jms.queues.response=jms/KIE.SERVER.RESPONSE
    -Dorg.kie.server.domain=OracleDefaultLoginConfiguration
    -Dorg.jbpm.server.ext.disabled=true
    -Dorg.jbpm.ui.server.ext.disabled=true
    -Dorg.jbpm.case.server.ext.disabled=true"

   Copy to Clipboard Toggle word wrap

Procedure

1. In the WebLogic Administration Console, navigate to Change Center Lock & Edit.
2. Under Domain Structure, click Environment Servers Control.
3. Select the server that you want to stop and click Shutdown.
4. Select When Work Completes to gracefully shut down the server or select Force Shutdown Now to stop the server immediately without completing ongoing tasks.
5. On the Server Life Cycle Assistant pane, click Yes to complete the shutdown.

6. After the shutdown is complete, navigate to the domain directory in the command terminal, WLS_HOME/user_projects/<DOMAIN_NAME>. For example:

   WLS\user_projects\mydomain

   Copy to Clipboard Toggle word wrap

7. Enter one of the following commands to restart Oracle WebLogic Server to apply the new configurations:

   On UNIX-based operating systems:

   startWebLogic.sh

   Copy to Clipboard Toggle word wrap

   On Windows operating systems:

   startWebLogic.cmd

   Copy to Clipboard Toggle word wrap
8. Open the Administration Console in a web browser (for example, http://localhost:7001/console/) and log in with your credentials.