Chapter 5. Upgrading a Decision Server

You can upgrade a BRMS 6.4 KIE Server to Red Hat Decision Manager 7.0 Decision Server by installing the new server on the same host. You can use existing KJAR files. However, for optimal performance, upgrade and rebuild the projects.

Procedure

  1. Install Red Hat Decision Manager 7.0 Decision Server on the same host as a BRMS 6.4 KIE Server. Use a separate JBoss EAP installation. For instructions, see Installing Red Hat Decision Manager on premise.
  2. Configure the Red Hat Decision Manager 7.0 Decision Server to bind to the same port as the BRMS 6.4 KIE Server. (The default settings are the same).

  3. Configure the Decision Server to use a Maven repository that contains your decision services (KJAR files). Use one of the following approaches:

    • Use the same KJAR files as of the BRMS 6.4 KIE Server. To copy the Maven configuration, copy the value of the kie.maven.settings.custom system property from the old version $EAP_home/standalone/configuration/standalone.xml file to the same file in the new version.
    • Upgrade your decision services to the new version. For instructions, see Chapter 2, Migrating projects in Decision Central and Chapter 3, Migrating Java projects. Upload the new KJAR files to a Maven repository. Then configure the Decision Server to use the repository:
    1. Create a settings.xml file for the Maven repository

    2. In the $EAP_home/standalone/configuration/standalone.xml file for Red Hat Decision Manager 7.0 Decision Server, under the <system-properties> tag, set the kie.maven.settings.custom property to the full pathname of the settings.xml file, for example: 

      <property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>

      In this case, you need to change the version of the KJAR files. Change the version of the services that you start accordingly. You can still use the same container name to ensure maximum compatibility with existing clients.

  4. Stop the BRMS 6.4 KIE Server.
  5. Start the Red Hat Decision Manager 7.0 Decision Server.
  6. Use the API to start the necessary decision services. For instructions, see Packaging and deploying a decision service.

Result

The Red Hat Decision Manager 7.0 Decision Server operates on the same URLs and provides the same services as the BRMS 6.4 KIE Server.

You might need to change client applications that use the REST API in order to adapt to the following API change:

  • The ServiceResponse wrapper was removed from the Planner service responses.
Important

You can also configure the Decision Server to connect to a Decision Central. The Decision Central can manage several Decision Servers and deploy the same or different decision services on them. For instructions, see Packaging and deploying a decision service.