Installation instructions for WebSphere Enterprise Service Bus V7.5.1 Fix Pack 2 (V7.5.1.2)

This document details the installation instructions for IBM WebSphere Enterprise Service Bus Version 7.5.1 Fix Pack 2 (V7.5.1.2), including instructions for binary installation and prerequisites.

This fix pack is a maintenance package for a specific product and applies to all distributed platforms. It is a single package that bundles a number of individual fixes.

The V7.5.1 Fix Pack 2 is intended to be used on WebSphere Enterprise Service Bus installations. By installing the V7.5.1 Fix Pack 2, you raise the fix level of your product, WebSphere Enterprise Service Bus, to V7.5.1.2.

Table of Contents

• About the fix pack and prerequisites
• Problems addressed in this fix pack
• Fix pack prerequisites

• Installing the fix pack
• Upgrade instructions for installations with existing profiles
• Network deployment environments
• Installing V7.5.1 Fix Pack 2 (7.5.1.2)
• Fix pack install verification
• Rolling back V7.5.1 Fix Pack 2 (7.5.1.2)

• Additional information
• Reference
• Trademarks and service marks

© Copyright International Business Machines Corporation 2014. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

About the fix pack and prerequisites

Problems addressed in this fix pack

The fixes addressed in V7.5.1 Fix Pack 2 are explained in the Fix List for Business Process Manager products and WebSphere Enterprise Service Bus document.

Back to top

Fix pack prerequisites

To use this fix pack, you must have one of the following versions of WebSphere Enterprise Service Bus installed:

• 7.5.1.0
• 7.5.1 Fix Pack 1 (7.5.1.1)

Hardware and software prerequisites for WebSphere Enterprise Service Bus are available on the web on their respective Hardware and Software Support pages.

Back to top

Installing the fix pack

Upgrade instructions for installations with existing profiles:

If you have been using WebSphere Enterprise Service Bus at the V7.5.1.0 or V7.5.1 Fix Pack 1 release and profiles have been created, additional steps are required. These steps include backing up the profile, stopping all Java™ processes, and sequencing the upgrade. Before you continue with the fix pack installation, see Upgrade instructions for installations with existing profiles for details on these steps. Return to this document, when instructed, to complete the Version 7.5.1 Fix Pack 2 installation.

Important:

Depending on the topology, instructions for updating the profile vary. The product might not continue to run successfully if you do not follow the instructions that are provided in Upgrade Instructions for installations with existing profiles.

Back to top

Network deployment environments


When you apply the fix pack in a Network Deployment environment, the connection to the deployment manager requires a user ID and password. Depending on your configuration, you might have to enter the credentials in a separate prompt near the end of the upgrade process.

Note: The credential panel displays twice during the upgrade process and has a default time out period of one minute. If you miss this prompt, your security configuration is set up such that a prompt is not displayed, or if you are running the silent installation script, follow the instructions in the Identifying Profile Update Errors section.

Installing V7.5.1 Fix Pack 2 (7.5.1.2)

If you have existing profiles under this installation, before you continue with the fix pack installation, see Upgrade instructions for installations with existing profiles for details on steps to follow for various topologies. Return to this document, when instructed, to complete the Version 7.5.1 Fix Pack 2 installation.

Download repositories to local system

If the machine on which you have installed WebSphere Enterprise Service Bus has Internet access, skip the next three steps.

1. Download the appropriate V7.5.1 Fix Pack 2 from the WebSphere Enterprise Service Bus download site. Download the package to a temporary disk location.
   wesb.7512.repository.zip
2. Download the required WebSphere Application Server and WebSphere Application Server Feature Pack fix packs.
3. Unpack the repositories to any directories that you choose. Note where you have unpacked the repositories. You should unpack each repository to its own directory.

You can install the fix packs by using one of the following options:
Graphical user interface (GUI) of IBM Installation Manager to update an installation
Command line interface of IBM Installation Manager for a silent installation


Graphical user interface (GUI) of IBM Installation Manager to update an installation

1. Start IBM Installation Manager.
   On Windows operating systems with Internet access, you can click Start > Programs > IBM > WebSphere Enterprise Service Bus > Update. Then, skip to step 3b.
   If you do not have Internet access or are on a Linux or UNIX-based system, you can start IBM Installation Manager using the <install_location>/IBMIM command on UNIX-based operating systems and the <install_root>\IBMIM.exe command on Windows operating systems. See Installation directories for the product and profiles for more information on where Installation Manager is installed.
   
   Note: On the Windows 7, Windows Vista, or Windows 2008 operating systems, right-click <install_root>\IBMIM.exe and select Run as administrator.
   
2. Add repositories to the IBM Installation Manager preferences.
   Click File -> Preferences. Under Repositories select one of the following:
   
   If the machine on which you have installed WebSphere Enterprise Service Bus has Internet access, ensure that the Search service repositories during installation and updates option is selected.
   
   If the machine on which you have installed WebSphere Enterprise Service Bus does not have an Internet connection, add the location of all the local repositories that you downloaded from the Download repositories to local system section.
   
1. Click Add Repository.
   Type or browse to the repository.config file for the WebSphere Enterprise Service Bus repository that you have unpacked.
   
2. Click OK.
   
3. Repeat this process for the interim fix repository.
   
4. Click OK to save the new repository settings.
   
3. To graphically install the fix packs:
1. Click Update.
2. Select the Package Group where you have installed WebSphere Enterprise Service Bus and click Next > to continue.
   After Installation Manager checks the service repositories the Update Packages window opens and the WebSphere Enterprise Service Bus Version 7.5.1.2 Fix Pack is shown (unless there is a later fix pack available from the live update repository).
   
3. Ensure that the fix pack is selected and click Next >. If you have Internet connectivity or you have added local Interim fix repositories, another Update Packages window opens. A list of interim fixes is displayed.
4. Ensure that the interim fixes are all selected and then click Next > to continue. The Licenses window opens.
5. Read and accept the terms of the license agreements by selecting the appropriate button and click Next > to continue. The Features window opens. All of the installed features are selected.
6. Click Next > to continue. The Summary window opens. All of the features that need to be updated are shown. The disk space required to perform the update is shown at the bottom.
7. Click Update to start the update. The updates are downloaded either from the live update repository or from your local repository. The updates are installed. After the installation of the updates is complete, you receive a confirmation.


Note: To graphically install the fix packs during a full installation when you have Internet access, follow the normal install instructions for a full installation. Go to Install Packages > Check for Other Versions and Extensions. All of the fix packs are discovered. Follow the instructions to select the Show all versions check box, then proceed with the full installation as normal.

Back to top

Command line interface of IBM Installation Manager for a silent installation

Installation Manager offers a command-line interface to silently update your product installation.

1. Use the following command to update your WebSphere Enterprise Service Bus installation to V7.5.1 Fix Pack 2:
   
   <IM_INSTALL_LOCATION>/tools/imcl install com.ibm.ws.WESB75_7.5.1002.20140228_1844 -acceptLicense -installationDirectory <INSTALL_DIR> -repositories <FIXPACK_REPOSITORY> -log <LOG_FILE>
   
   
   Update the following variables for your installation:
   
   The <IM_INSTALL_LOCATION> variable is the location where Installation Manager is installed. See Installation directories for the product and profile for more information on Installation Manager default install directories.
   
   The <INSTALL_DIR> variable is the installation directory of the product.
   
   The <FIXPACK_REPOSITORY> variable is the location of the fix pack repository.
   
   The <LOG_FILE> variable is the location and name of the silent log file to write.
   
   By including the -acceptLicense parameter, you agree to the terms and licenses of this product.
   
2. After updating the command for your environment, run the command from the tools directory under the Installation Manager installation location.
   
   The following command is an example:
   C:\Program Files (x86)\IBM\InstallationManager\eclipse\tools\imcl installcom.ibm.ws.WESB75_7.5.1.20110729_1919 -acceptLicense -installationDirectory C:\IBM\WESB\v7.5 -repositories C:\WESB7511_repository -log silent_update.txt
   
3. When the silent fix pack installation completes, check the logs to ensure that the installation completes successfully. A success message that is similar to the following text displays on the command line:
   Updated to com.ibm.ws.WESB75_7.5.1002.20140228_1844 in the C:\IBM\WESB\v7.5 directory.
   

Back to top




---

Fix pack install verification

For upgrades of installations with existing profiles, refer to the Identifying profile update errors section under the Profile upgrade tab for details on verifying the fix pack installation.

Attention notice: Installation Manager on the Windows operating system does not recognize profile update errors. When you upgrade an installation on Windows operating systems, you must look at the Identifying Profile Update Errors section, even if Installation Manager ends with the following message:
The packages are updated.

Back to top

Rolling back the V7.5.1 Fix Pack 2 (V7.5.1.2)

You can 'roll back' the fix pack to a previous version, by using one of the following options:

Graphical user interface (GUI) of IBM Installation Manager to roll back an installation
Command line interface of IBM Installation Manager for a silent roll back of a fix pack

Note: The following procedure only rolls back the product binary. Any existing profiles that were upgraded during a fix pack installation are not rolled back; you must restore the profiles from the backup you took before you upgraded the product. Any new profiles that are created after the upgrade cannot be reused; you must delete and recreate the profiles after you have completed the rollback.

Graphical user interface (GUI) of IBM Installation Manager to rollback an installation

1. Close all programs that were installed using Installation Manager before rolling back.
   
   
2. Start Installation Manager. See Installation directories for the product and profile for more information on where Installation Manager is installed.
   
   
3. From the Start page of the Installation Manager, click Roll back to start the Roll back packages wizard.
   
   
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 to which you want to roll back 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. Restore the backed up data from the original version.



Back to top




---

Command line interface of IBM Installation Manager for a silent roll back of a fix pack

Installation Manager offers a command-line interface to silently rollback your product installation to the previous version. In the instructions, it is assumes that you completed all of the necessary profile, database, and fix pack-specific data backup tasks, which are described in Profile Upgrade instructions, before you migrated to Version 7.5.1 Fix Pack 2. This data is restored after you complete the roll back task.

1. The following command rolls back your IBM Business Process Manager product to V7.5.1.0.
   
   <IM_INSTALL_LOCATION>/tools/imcl rollback
   com.ibm.ws.WESB75_7.5.1002.20140228_1844 -installationDirectory <INSTALL_DIR> -log <LOG_FILE>
   
   Update the following variables for your installation:
   The <IM_INSTALL_LOCATION> variable is the location where Installation Manager is installed. See Installation directories for the product and profile for more information on Installation Manager default install directories.
   
   The <INSTALL_DIR> variable is the installation directory of the product.
   
   The <FIXPACK_REPOSITORY> variable is the location of the fix pack repository.
   
   The <LOG_FILE> variable is the location and name of the silent log to write.
   
2. After updating the command for your environment, run the command from the tools directory under the Installation Manager install location.
   
   The following command is an example:
   
   
   C:\Program Files (x86)\IBM\InstallationManager\eclipse\tools\imcl rollback com.ibm.ws.WESB75_7.5.1002.20140228_1844 -installationDirectoryC:\IBM\WESB\v7.5 -log silent_rollback.txt
   
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.ws.WESB75_7.5.1002.20140228_1844 in the C:\IBM\WESB\v7.5 directory.
   
   
4. Restore the backed up data from the original version.

Additional information

Reference

You can find additional information on any of these topics in the WebSphere Enterprise Service Bus product documentation.

For further information on the update strategy or obtaining updates to WebSphere Enterprise Service Bus, see also the Recommended Updates page.

Back to top

Trademarks and service marks

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

Back to top