Upgrading IBM Process Federation Server V8.6.0 to Process Federation Server V19.0.0.3

To upgrade to IBM Process Federation Server V19.0.0.3, follow the instructions to install the V19.0.0.3 refresh pack for each process federation server in the upgraded installation.

Before you begin

Make sure that the following prerequisites are completed.
  • Upgrade Process Portal to V19.0.0.3 before you upgrade Process Federation Server.
  • Upgrade your version of IBM WebSphere® Application Server Liberty to 19.0.0.9, as it is required for Process Federation Server V19.0.0.3.
  • Get hold of Installation Manager V1.8.9 or later, as it is required to install IBM WebSphere Application Server Liberty 19.0.0.9.

Procedure

  1. Stop all servers that are defined on the Process Federation Server installation that is being upgraded.
  2. Install the V19.0.0.3 refresh pack onto the existing Process Federation Server installation.
    1. Install the version of Installation Manager that is provided with the refresh pack. Otherwise, the upgrade might fail with java.lang.OutOfMemoryError errors.
    2. Follow the instructions for Installing fix packs and interim fixes on IBM Process Federation Server.
    Attention: In V19.0.0.3, Process Federation Server can only run on WebSphere SDK Java Technology Edition for Liberty V8.
  3. If needed, install WebSphere SDK Java Technology Edition Version 8 for Liberty on Process Federation Server, then uninstall WebSphere SDK Java Technology Edition Version 7 for Liberty.
    1. Start the Process Federation Server Installation Manager and install WebSphere SDK Java Technology Edition Version 8 for Liberty.
    2. After the installation completes, click Finish.
    3. In Installation Manager, go to the Uninstall Packages page, and select the WebSphere SDK Java Technology Edition Version 7 for Liberty.
    4. After the uninstallation completes, click Finish.
  4. Because Process Federation Server V19.0.0.3 needs IBM WebSphere Application Server Liberty 19.0.0.9, retrieve the fix pack as follows.
    1. Download Liberty fix pack 19.0.0.9-WS-LIBERTY-ND-FP from this Fix Central page.
    2. Add the configuration repository of the fix pack to IBM Installation Manager.
  5. Decompress the pfs.18001.delta.repository.zip and pfs.19002.delta.repository.zip files, and add the corresponding configuration repository to IBM Installation Manager.

    You need these two files because upgrading Process Federation Server from 8.6.0.0 to V19.0.0.3 requires the 18.0.0.1 delta image and the 19.0.0.2 delta image.

  6. Start the servers.
  7. Verify the changes, including those for customized applications.
  8. Update customized applications if required.

What to do next

Process Federation Server requires a dedicated database for the process federation servers in the federated environment. If you do not configure a database, you cannot create saved searches that span multiple federated systems.

For information about creating and configuring the Process Federation Server database, see Creating the Process Federation Server database and Configuring the Process Federation Server database.