IBM Support

Installation Instructions for IBM WebSphere Business Compass V7.0.0.0 Fix Pack 3 (7.0.0.3)

Product readme


Abstract

This document details and provides the installation and usage instructions for IBM WebSphere Business Compass Version 7.0.0.0 Fix Pack 3.

Content

Tab navigation


This document details the installation instructions for IBM WebSphere Business Compass Version 7.0.0.0 Fix Pack 3.

Table of contents

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

About Fix Pack and prerequisites
About V7.0.0.0 Fix Pack 3

This Fix Pack is a cumulative maintenance package for a specific combination of product and platform. It is a single package that bundles a number of individual fixes.

The V7.0.0.0 Fix Pack 3 is intended to be used on IBM WebSphere Business Compass installations.

Back to top


Change History
Release date: 3 September 2010
Initial publish: 3 September 2010

Back to top


Problems addressed in this Fix Pack

The fixes addressed in V7.0.0.0 Fix Pack 3 are detailed in the Fix List for IBM WebSphere Business Compass.

This Fix Pack also includes updates for Business Space and details can be found in the download documented titled Business Space powered by WebSphere: V7.0 Fix Pack 3 (7.0.0.3).

Back to top


Fix Pack contents

V7.0.0.0 Fix Pack 3 includes the following files:

7.0.0-WS-WPBS-FP000000300.all.all_7.0.300.201008311815.pak
atlas.client.FP7003.all.all_7.0.3.201008161700.pak
atlas.FP7003.all.all_7.0.3.201008161700.pak
bspace.client.FP7003.all.all_7.0.3.201008231416.pak
bspace.FP7003.all.all_7.0.3.201008231416.pak
com.ibm.bpm.panel.bpminvoke_7.0.3.201008161655.jar
com.ibm.wpbs.panel.bpminvoke_7.0.3.201008311808.jar
wpbs.db.FP700300.all.all_7.0.300.201008311814.pak
wpbs.install.FP700300.all.all_7.0.300.201008311814.pak
wpbs.pmt.plugins.FP700300.all.all_7.0.300.201008311814.pak
wpbs.profile.template.FP700300.all.all_7.0.300.201008311814.pak
wpbs.pubserver.FP700300.all.all_7.0.300.201008311815.pak

Back to top


Fix Pack prerequisites

To use this Fix Pack, you must have one of the following versions of IBM WebSphere Business Compass installed:
* 7.0.0.0
* 7.0.0.2

You must also either have WebSphere Application Server V7.0.0 Fix Pack 11 installed or must install the WebSphere Application Server V7.0.0 Fix Pack 11 during the upgrade. See the Steps for installing for specific update instructions.

Hardware and software prerequisites for IBM WebSphere Business Compass are available on the Web on its Hardware and Software Support pages. Select the operating system where IBM WebSphere Business Compass V7.0.0.0 will be running to view supported software options.



Ensure that the required disk space is available prior to installing the Fix Pack. See the Space requirements section for details.

Back to top


Space requirements

Space requirements vary depending on your platform. The size of each download is available on the download page, IBM WebSphere Business Compass V7.0.0.0 Fix Pack 3.

Back to top

Installing and using the Fix Pack

Pre-installation steps
It is recommend that you back up your WebSphere Business Compass V7.0.0.0 profiles before installing the WebSphere Business Compass V7.0.0.0 Fix Pack 3.

Note: If you have a Network Deployment environment, perform the following for each server where you are applying the Fix Pack.
  1. Stop the server and the running processes for the profile that you want to back up.
  2. Create a directory to store the backup of the profile.

    For example:


    C:\backup\profiles

  3. Go to the following directory:


    <pubserverRoot>\bin

  4. Run the following command:


    manageprofiles.bat
    -backupProfile
    -profileName <profileName>
    -backupFile <backupDirectory>\<profileName>.backup.zip



    Where:
    <profileName> is the name of your profile


    backupFile indicates that a backup of the profile should be created and placed in the identified directory. You must provide a fully qualified file path for the backup file.If the path contains any spaces, you must use quotation marks ( " ) before and after the fully qualified path name. For example:
    C:\Program Files\profiles\myprofilename.backup.zip


    <backupDirectory> is the directory you created to store the backup of the profile

  5. The console should display the following message:
    INSTCONFSUCCESS:  Success: The profile backup operation was successful.


    You can proceed with installing the WebSphere Business Modeler Publishing Server V7.0.0.0 Fix Pack 3.
    For more information about these parameters, see manageprofiles command.


This Fix Pack includes updates for Business Space. If you have installed Business Space V7.0 Interim Fix 1 for WebSphere Business Compass V7.0.0.0, you must install the Interim Fix JR36142 prior to applying this Fix Pack. The download document for this Fix Pack includes information on obtaining the Interim Fix, see the prerequisites section.

If you have Lotus Forms Turbo integrated in your environment or are planning to install, please review the relevant topics in the Troubleshooting section.

In general, it is recommended that you review the Troubleshooting section to be aware of extra install procedures or other special processing which is dependant on your environment.



Installing the Fix Pack in a network deployment environment
In a network deployment environment, if you have any WebSphere Business Compass profiles that were created prior to installing WebSphere Business Compass V7.0.0.0 Fix Pack 3, please proceed to the section Upgrading your WebSphere Business Compass profiles in a network deployment environment for the correct procedure to install WebSphere Business Compass V7.0.0.0 Fix Pack 3. If you do not have any WebSphere Business Compass profiles that were created prior to installing Business Space V7.0.0.0 Fix Pack 3, please continue with the procedure in the section Steps for installing to install WebSphere Business Compass V7.0.0.0 Fix Pack 3 on each WebSphere Application Server installation where WebSphere Business Compass V7 exists.


Steps for installing
Before you install IBM WebSphere Business Compass V7.0.0.0 Fix Pack 3, note the following:



Any interim fixes that have been installed using the Update Installer (UPDI) must be removed with the Update Installer before starting V7.0.0 Fix Pack 3 activities. Two interim fixes were installed silently during the V7.0.0.0 install: SDKPM00452.pak and 7.0.0.7-WS-WAS-<platform><arch>-IFPK98944.pak. These will need to be removed, if you have not already done so.
  1. Download IBM Update Installer V7.0.0.11 for WebSphere Software for your platform.
  2. Install IBM Update Installer V7.0.0.11.
  3. Use the IBM Update Installer to uninstall the following Interim Fixes from your WebSphere Application Server V7.0.0.7 installation, if they have been installed:
    • SDKPM00452.pak
    • 7.0.0.7-WS-WAS-<platform><arch>-IFPK98944.pak

To install the Fix Pack from a local repository:
  1. Installation of WebSphere Business Compass V7.0 Fix Pack 3 requires IBM Installation Manager V1.4.1. Refer to the IBM Installation Manager download site for instructions on downloading and updating IBM Installation Manager to V1.4.1 on a machine without Internet access.
  2. If your WebSphere Application Server installation is not at version 7.0.0.11. Download WebSphere Application Server V7.0 Fix Pack 11. Optionally download the WebSphere Application Server V7.0.0 Fix Pack 11 (added features) repository. This is only required if you are adding features.
  3. Download the 7.0.0.0-WB-Compass-MultiOS-FP0000003.zip file.
  4. Extract the downloaded ZIP files into separate temporary directories.
  5. Go to Start > All Programs > IBM Installation Manager > IBM Installation Manager. IBM Installation Manager opens.
  6. On the menu bar, go to File > Preferences.
  7. In the navigation pane, click Repositories.
  8. In the Repositories pane, click Add Repository.
  9. Click the Browse button and navigate to the directory where you have downloaded and extracted the Fix Pack files.
  10. Select repository.config.
  11. Click Open.
  12. In the Add Repository dialog box, click OK. The Add Repository dialog box closes. NOTE: If Compass has been installed with WPS or Monitor, either the XML or SCA GM repository needs to be pointed to.
  13. Repeat this process of adding repositories for all repositories extracted (specifically the WebSphere Application Server v7.0.0.11 repository and optionally the WebSphere Application Server v7.0.0.11 Add Features repository).
  14. In the Preferences window, click OK.
  15. Follow the instructions below to apply the Fix Packs to your IBM WebSphere Business Compass package.
 
To complete the installation of the Fix Pack:
  1. Go to Start > All Programs > IBM Installation Manager > IBM Installation Manager. IBM Installation Manager opens.
  2. Click Update. The Update Packages wizard starts.
  3. Note: At this point, the following message might be displayed. indicating that your Installation Manager needs to be updated: "A new version of IBM Installation Manager is available. You must update Installation Manager before you can continue. To update Installation Manager, click Yes..." Click Yes. When the Installation Manager update completes, click OK to restart the Installation Manager, and then click Update. (This will update Installation Manager to V1.4.1 or higher, as required for installation of WebSphere Business Compass V7.0 Fix Pack 3.)
  4. Select the package group that has IBM WebSphere Business Compass installed.
  5. Click Next. Installation Manager searches for updates in its repositories.
  6. In the Updates window, under the installed IBM WebSphere Application Server, select Version 7.0.0.11 and under WebSphere Business Compass, select Version 7.0.0.3.
  7. Click Next. The License window opens, displaying the list of licenses for the updates you selected.
  8. Click each item to review the license agreement text.
  9. If you agree to the terms of the license agreements, select the I accept the terms of the license agreements radio button.
  10. Click Next. The Update Packages window opens.
  11. Select the components that you want to update.
  12. Ensure that you have already backed up all WebSphere Business Compass profiles. If yes, click Next.
  13. The summary window opens.
  14. Click Update. Installation Manager installs the Fix Pack. After the installation finishes, the Update Packages window refreshes, displaying the list of installed packages and the following message: “Success! The packages were updated.”
  15. Click Finish. The Update Packages wizard closes. You have successfully installed the Fix Packs.
  16. Close IBM Installation Manager.

The Fix Pack is now installed.



Upgrading your WebSphere Business Compass profiles in a network deployment environment
Use the procedure in this section to upgrade your WebSphere Business Compass profiles that were created prior to installing WebSphere Business Compass V7.0.0.0 Fix Pack 3, in a network deployment environment. If you have a stand-alone profile or you do not have any WebSphere product profiles that were created prior to installing WebSphere Business Compass V7.0.0.0 Fix Pack 3, proceed to the section Restarting the environment after installation of WebSphere Business Compass V7.0.0.0 Fix Pack 3.

Upgrading the deployment manager
  1. Install WebSphere Business Compass V7.0.0.0 Fix Pack 3 onto the deployment manager’s installation using IBM Installation Manager as described in the section Steps for installing. The deployment manager profile is automatically updated during Fix Pack installation.
  2. Check for any errors, as explained in the Identifying Profile Update Errors section, before continuing.


Upgrading the nodes
  1. Start the deployment manager, refer to the section Restarting the environment after installation of WebSphere Business Compass V7.0.0.0 Fix Pack 3. The deployment manager must be running when you apply the Fix Pack to an installation with a managed profile.

    Note: The only exception to this rule is for managed profiles hosted by the same installation as their Deployment Manager profile. The upgrade script contains special case code for this scenario. If starting the Deployment Manager is not possible, the upgrade script (BSpaceProfileUpgrade.ant) must be called manually after the appropriate error messages have been received.
  2. For each managed node with independent install, perform the following steps:

    a. Ensure all the servers and their node agents are stopped.

    b. Install WebSphere Business Compass V7.0.0.0 Fix Pack 3 onto the deployment manager’s installation using IBM Installation Manager as described in the section Steps for installing.

    Note: When applying the Fix Pack in a network deployment environment where WebSphere administrative security is enabled, the connection to the deployment manager requires a user ID and password. Depending on your configuration you may have to enter the credentials in a separate prompt near the end of the update process. Please refer to Security enabled network deployment environments for details.

    The managed node (profile) is automatically updated during Fix Pack installation.
    Log files are saved as:

    <profile_root>/logs/BPMProfileUpgrade.<profileName>.<timestamp>.log

    where <profile_root> is the root directory of the managed profile.

    c. Check for any errors, as explained in the Identifying Profile Update Errors section, before continuing.
  3. If any of the nodes contain cluster members follow the steps described under Recovering after profile update errors before starting the servers.
  4. For each node, restart the node agent and wait for the node synchronization to complete.

Validating cluster updates

After upgrading the deployment manager and the managed nodes containing cluster members, follow these steps to validate the clusters before starting the cluster members (servers).
  1. Check the following log file for errors:

    <profile_root>/logs/BPMProfileUpgrade.<profileName>.<timestamp>.log

    where <profile_root> is the root directory of the managed profile. There may be more than one file whose name matches this pattern. Open the log files and search for "-cluster" to find the cluster associated with this particular log file. If there is an error, fix the cause, and follow steps in Identifying profile update errors.
  2. When all clusters have been successfully upgraded, stop and restart the deployment manager.
  3. For each node, restart the node agent and wait for the node synchronization to complete.

Identifying profile update errors
If an error message "The packages are updated with warnings" is displayed on the Installation Manager summary panel, check the log file <Compass_root>/logs/wpbs/install.FP7003/installconfig_wpbs_profileMaintenance.log.
If it contains the message:

Result of executing [...]BPMProfileMaintenance.ant was: false

then a profile update error has occurred. If multiple profiles in the installation are being updated, search for the first occurrence of
"profileName=" prior to the error to know which profile this error is associated with. Fix the cause, then follow the appropriate steps in the Recovering after profile update errors section.

Note: For network deployment environments the most likely cause of an error is that a connection to the deployment manager cannot be established.

Recovering after profile update errors

Stand-alone profiles and deployment manager profiles
  1. Make sure the stand-alone application server or the deployment manager is stopped.
  2. Change to the <Compass_root> directory where the profile update error has occurred and run one of the following commands as appropriate for your platform.

    Windows: bin\ws_ant.bat -f util\BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    Linux: bin\ws_ant.sh -f util\BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    where <profileName> is the name of the stand-alone profile or deployment manager profile that had update errors.


Federated profiles
  1. Make sure the deployment manager has been started, refer to the section Restarting the environment after installation of WebSphere Business Compass V7.0.0.0 Fix Pack 3. This is necessary because the BSpaceProfileUpgrade.ant script must connect to the central configuration repository on the deployment manager to make the updates.
  2. Change to the <Compass_root> directory where the profile update error has occurred and run one of the following commands as appropriate for your platform.

    Windows: bin\ws_ant.bat -f util\BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    Linux: bin\ws_ant.sh -f util\BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    where <profileName> is the name of the federated profile that had update errors.

    If you are updating a federated node when WebSphere administrative security is enabled, you must also supply the -Duser=<userID> -Dpassword=<password> parameters, where <userID> is a user ID from the user registry that has administration authority and <password> is the password for that user ID.



Restarting the environment after installation of WebSphere Business Compass V7.0.0.0 Fix Pack 3
  • In a network deployment environment, start the following components (use the links for instructions):
In a network deployment environment, start the following components (use the links for instructions):


Rolling back V7.0.0.0 Fix Pack 3

You can use the IBM Installation Manager for WebSphere Software to roll back this Fix Pack.

If you roll back the Fix Pack, the IBM Installation Manager does not roll back Fix Pack updates from profiles because you may have configured the profile after installing the maintenance.

Warning: Profiles may not be usable after rolling back the Fix Pack.

To restore an original profile, use the restoreConfig command to restore your backup.

Before running the restoreConfig command, export any custom enterprise applications that you have installed since you ran the backupConfig command. After running the restoreConfig command, re-install the exported enterprise applications and redo any other applicable configuration changes that you made since you ran the backupConfig command.

Back to top

Additional Information

Reference:
You can find additional information on any of these topics in the IBM WebSphere Business Compass Information Center.

See also the Recommended Updates pages for IBM WebSphere Business Compass .

Back to top


Trademarks and service marks:
For trademark attribution, visit the IBM Terms of Use Web site.

Back to top


Document information

More support for: WebSphere Business Compass

Software version: 7.0, 7.0.0.1, 7.0.0.2, 7.0.0.3

Operating system(s): Linux, Windows

Reference #: 7019611

Modified date: 15 September 2010


Translate this page: