IBM Business Process Manager - Process Federation Server 8.5.7 Cumulative Fix 2016.12 (8.5.7 CF2016.12)

Download Description

This cumulative fix applies to all distributed operating systems on Process Federation Server for IBM Business Process Manager Standard, IBM Business Process Manager Advanced, and IBM Business Process Manager Advanced - Process Server. It is a single package that bundles a number of individual fixes.

Table of Contents

• Downloading the cumulative fix
• Prerequisites
• Problems addressed in this cumulative fix
• Installation instructions
• Installing the cumulative fix
• Downloading repositories to the local system
• Upgrading an installation interactively
• Upgrading an installation silently using the command line (imcl)
• Post-upgrade steps
• Rolling back the cumulative fix
• Rolling back the cumulative fix installation interactively
• Rolling back the cumulative fix installation silently using the command line (imcl)
• Trademarks and service marks
  
  © Copyright International Business Machines Corporation 2016. All rights reserved. 
  US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 

Downloading the cumulative fix

The download link in the Change history section links to the download package required to install V8.5.7 CF2016.12 for Process Federation Server for the following products on all applicable operating systems:

• IBM Business Process Manager Standard
• IBM Business Process Manager Advanced
• IBM Business Process Manager Advanced - Process Server

Prerequisites

You can install this cumulative fix on top of IBM Business Process Manager - Process Federation Server V8.5.7, V8.5.7 CF2016.04, V8.5.7 CF2016.06, V8.5.7 CF2016.07, or V8.5.7 CF2016.09.



Problems addressed in this cumulative fix

By installing the cumulative fix, you raise the fix level of your Process Federation Server to Version 8.5.7 CF2016.12.

See the Process Federation Server 8.5.7 Cumulative Fix 2016.12 fix list.

Back to top

Installation instructions

Installing the cumulative fix

To install the cumulative fix, follow these instructions to download the cumulative fix repository and then choose your installation path.

1. Download the cumulative fix repository to a local directory.

2. Choose one of the installation paths based on your environment.

• Upgrading an installation interactively
• Upgrading an installation silently using the command line (imcl) 
  

Your Process Federation Server installation is now upgraded to V8.5.7 CF2016.12.


Downloading the repositories to the local system

Download the cumulative fix repository to a local directory so that the files can be used with IBM Installation Manager during the upgrade process. 

1. Download pfs.8570.delta.cf2016.12.repository.zip to a temporary disk location. 

2. Unpack the repository files to any directory that you choose. Note the location where you have unpacked the files.

Back to top

Upgrading an installation interactively

These steps upgrade one installation of Process Federation Server.


1. Start the Installation Manager. For more information about where Installation Manager is installed and the type of installation, see Installation directories for the product and profile. 
Note: Before you start the Process Federation Server cumulative fix installation, the IBM Installation Manager must be at a minimum level of Version 1.8.0.

On Windows, right-click IM_INSTALL_LOCATION\IBMIM.exe and select Run as administrator.

On Linux or UNIX, start IBM Installation Manager by using the IM_INSTALL_LOCATION/IBMIM command.

2. Add the repository to the IBM Installation Manager preferences by clicking File > Preferences and, under Repositories, adding the location of the local repository that you downloaded.
a. Click Add Repository. 

b. Type or browse to the repository.config file for the Process Federation Server repository that you extracted and click OK.

c. Click OK to save the new repository settings.

3. Click Update.

4. Select the package group where you installed Process Federation Server and click Next. After Installation Manager checks the service repositories, the Update Packages window opens and the Process Federation Server cumulative fix is shown.

5. Ensure that the cumulative fix is selected.

6. Read and accept the terms of the license agreements by selecting the appropriate button and click Next. The Features window opens. All the installed features are selected.

7. Click Next. All the features that need to be updated are shown in the Summary window. The disk space that is required to perform the update is shown at the bottom.

8. Click Update to start the update. The cumulative fix is downloaded from your local repository and installed. When the installation is complete, you receive a confirmation.

9. To upgrade additional Process Federation Server installations, repeat the steps, or return to step 4 to install the cumulative fix by using the same Installation Manager.

10. Before you restart the server the first time, run the server start pfsserver --clean command for each installation that you upgraded.

Back to top

Upgrading an installation silently using the command line (imcl)

You can use the command-line interface in Installation Manager to update your product installation silently. These steps upgrade one installation of Process Federation Server.

1. Gather the following information about your environment and the cumulative fix you want to apply.

IM_INSTALL_LOCATION
The location where Installation Manager is installed. See table 7 in Installation directories for the product and profile for more information about Installation Manager default installation directories.

INSTALL_DIR
The full path to the installation directory of the product you are upgrading.

REPOSITORY
The full directory path to the unpacked cumulative fix repository associated with the cumulative fix package that you are applying.

LOG_FILE
A full path and name for a log file to capture the logging output of the command.

FIX_PACKAGE
com.ibm.bpm.pfs.v85

2. Using the information gathered in the previous step, run the imcl command from the tools directory under the Installation Manager installation location. For more information, see Installing packages by using imcl commands.

IM_INSTALL_LOCATION/eclipse/tools/imcl install FIX_PACKAGE -acceptLicense -installationDirectory INSTALL_DIR -repositories REPOSITORY -log LOG_FILE

By including the -acceptLicense parameter, you agree to the terms and licenses of this product.

The following command is an example of upgrading Process Federation Server on Windows:
C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl install com.ibm.bpm.pfs.v85 -acceptLicense -installationDirectory C:\IBM\PFS\v8.5 -repositories C:\PFS857CF201612_repository -log silent_update.txt

3. When the silent installation completes, check the log files to ensure that the installation completed successfully. A success message that is similar to the following message displays on the command line for each package that was installed:
Updated to com.ibm.bpm.pfs.v85_8.5.7000.20160928_1119 in the C:\IBM\BPM\v8.5 directory

4. Repeat the process for each installation in the environment.

5. Before you restart the server the first time, run the server start pfsserver --clean command for each installation that you upgraded.

Back to top

Post-upgrade steps

After upgrading an installation of Process Federation Server, you must rebuild the Process Federation Server indexes by following these steps:

1. For each existing Process Federation Server instance, remove the elasticsearch directory from within the Process Federation Server instance home directory.

2. When all elasticsearch directories are removed, restart the Process Federation Server instances to rebuild the indexes.

Back to top

Rolling back the cumulative fix

You can roll back the cumulative fix by using one of the following options: 
Rolling back the cumulative fix installation interactively 
Rolling back the cumulative fix installation silently using the command line (imcl) 

Note: The following procedure rolls back only the Process Federation Server installation.



Rolling back the cumulative fix installation interactively

1. Close all programs that were installed by using Installation Manager.

2. Start Installation Manager. For information about where Installation Manager is installed, see Installation directories for the product and profile,

3. From the Start page of the Installation Manager, click Roll back.

4. On the Roll Back Packages page, from the Package Group Name list, select the package group that contains the packages that you want to roll back and click Next.

5. Select the version of the package that you want to roll back to and click Next. 

6. Read the summary information and click Roll Back to roll back the package. 

When the rollback process completes, a message that confirms the success of the process is displayed near the top of the page. 

7. Optional: Click View log file to open the log file for the current session in a new window. 

8. Click Finish to close the wizard. 

9. Close Installation Manager. 

10. Repeat the process for each installation in the environment.

11. Before you restart the server the first time, run the server start pfsserver --clean command for each installation that you rolled back.

Back to top

Rolling back the cumulative fix installation silently using the command line (imcl)

Installation Manager offers a command-line interface to silently roll back your product installation to the previous version.

1. Gather the following information about your environment and the target version you want to roll back to.

IM_INSTALL_LOCATION
The location where Installation Manager is installed. See table 7 in Installation directories for the product and profile for more information about Installation Manager default installation directories.

INSTALL_DIR
The full path to the installation directory of the product that you upgraded.

LOG_FILE
A full path and name for a log file to capture the logging output of the command.
PACKAGE_VERSION_IDS
The package and version IDs for the target version you want to roll back to. You will need the package ID followed by an underscore and the specific version ID. If you are rolling back multiple packages in the installation, separate each package and version ID with a space. If you supply only the package ID, the package is rolled back to the most recent previous version.

REPOSITORIES
Optionally, you might need to supply the fix repositories for the target of the rollback if you did not use the option to save files for rollback and do not have access to the live repository. Download and unpack the fix repositories for the target version. Gather the full directory path to your unpacked repositories associated with each fix package that you are applying. If you are rolling back multiple products, separate the repository directory paths with commas.

2. Using the information gathered in the previous step, run the imcl command to roll back to the previous target version of a product in the installation.

IM_INSTALL_LOCATION/eclipse/tools/imcl rollback PACKAGE_VERSION_IDS -installationDirectory INSTALL_DIR -log LOG_FILE

To include local repositories for the target version, add the -repositories REPOSITORIES option.

3. When the rollback completes, check the log files to ensure that the rollback completed successfully. A success message displays on the command line:

Rolled back to com.ibm.bpm.pfs.v8.5.7000.20160301_1551 in the C:\IBM\BPM\v8.5 directory. 

4. Repeat the process for each installation in the environment.

5. Before you restart the server the first time, run the server start pfsserver --clean command for each installation that you rolled back.

Trademarks and service marks

For trademark attribution, visit the IBM Terms of Use Web site.