Chapter 3. Migrating Red Hat JBoss Enterprise Application Platform 7.2 to 7.3

Red Hat Process Automation Manager 7.8 only supports Red Hat JBoss Enterprise Application Platform 7.3. If you want to upgrade Red Hat Process Automation Manager 7.7 instances to 7.8 you must first migrate Red Hat JBoss EAP from 7.2 to 7.3.

Prerequisites

  • Your Red Hat Process Automation Manager and KIE Server instances are not running. Do not apply updates while you are running an instance of Red Hat Process Automation Manager or KIE Server.
  • Red Hat JBoss Enterprise Application Platform 7.2 is installed.

Procedure

  1. Download Red Hat JBoss EAP 7.3 to each Red Hat JBoss EAP instance:

    1. Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) and select the product and version from the drop-down options:

      • Product: Red Hat JBoss EAP
      • Version: 7.3
    2. Click Download next to Red Hat JBoss Enterprise Application Platform 7.3. (jboss-eap-7.3.0.zip).
  2. Extract the jboss-eap-7.3.0.zip file to the same base directory of Red Hat JBoss EAP 7.2.

    Note

    The base directory of the Red Hat JBoss EAP installation is referred to as EAP_HOME.

  3. Run the jboss-server-migration.sh script to migrate configurations and deployments from Red Hat JBoss EAP 7.2 to Red Hat JBoss EAP 7.3:

    $ ./bin/jboss-server-migration.sh -s ../jboss-eap-7.2/

    Answer yes to all questions except the following question. Answer no to this question:

    This tool is not able to assert if the non-persistent deployments found are compatible with the target server, skip scanner's deployments migration?
  4. Copy the .niogit directory from Red Hat JBoss EAP 7.2 directory to the new .niogit directory. For example:

    $ cp -r ../jboss-eap-7.2/.niogit .niogit
  5. Change the MaxMetaspaceSize memory setting value to 1024m in the bin/standalone.conf file. For example:

    -XX:MaxMetaspaceSize=1024m
  6. Optional: To migrate unmanaged KIE Server instance configurations to Red Hat JBoss EAP, perform the following tasks:

    Important

    Proceed with this section only if there are unmanaged KIE Server instances configured in the migrated Red Hat JBoss EAP server instance that need to be migrated.

    1. Locate the KIE Server state XML files for the unmanaged instances. The XML files should be located in the directory from where the Red Hat JBoss EAP server is launched. These are usually named after the KIE Server instance identifier, for example example-kieserver.xml. You can use grep to search for kie-server-state, for example:

      $ grep -FR "<kie-server-state>"
    2. Copy the server’s state files to the directory where you will launch the new Red Hat JBoss EAP 7.3 instance.