IBM Support

Profile upgrade instructions for WebSphere Enterprise Service Bus V7.5.1 Fix Pack 2 (V7.5.1.2) installations with existing profiles

Product Readmes


Abstract

This document provides instructions for upgrading to IBM WebSphere Enterprise Service Bus Version 7.5.1 Fix Pack 2 (V7.5.1.2)

Content




Table of Contents



Common steps for all configurations


Attention: The Installation Manager on the Microsoft Windows XP operating system does not recognize profile update errors. When you upgrade an installation on Windows XP, you must look at the Identifying Profile Update Errors section, even if Installation Manager ended with the following message: "The packages are updated".
  1. Back up existing profiles in WebSphere Enterprise Service Bus

    This fix pack updates the core product files and all the existing profiles that require maintenance update.

    Before upgrading an existing installation, run the backupConfig command to back up the configuration files of each profile that the fix pack can update. See Backing up and restoring administrative configurations in the product documentation for more information about running this command.

  2. Stop all the Java processes

    Before installing V7.5.1 Fix Pack 2 (V7.5.1.2), stop all Java™ processes that are associated with the Java SDK, which shipped with WebSphere Enterprise Service Bus. These processes include the node agent process, the Deployment Manager process, and all server processes that belong to serviceable products, such as the IBM HTTP Server.

    Note: The product might not continue to run successfully if you install V7.5.1 Fix Pack 2 (V7.5.1.2) while a WebSphere Application Server-related Java process is running.

  3. (For Windows Servers only) Stop the WebSphere Windows services

    WebSphere Application server fix pack installation might update the WASServiceMsg.dll file. If any of the WebSphere servers, including node agents and Deployment Manager, are configured to start automatically using Windows services, the WASServiceMsg.dll file gets locked by the Microsoft Windows operating system.

    If you see a "WASServiceMsg.dll file can not be replaced" error during the fix pack installation of WebSphere Application Server, change the starting option for all the WebSphere services so that they start manually. Then, restart the Windows server before installing the WebSphere Application Server fix pack.

    Refer to the WASServiceMsg.dll is locked when installing fix packs document for more information.



Steps for upgrading a stand-alone environment



For each stand-alone profile, complete the following steps:
  1. Back up the configuration and stop the stand-alone server following the previous common steps instructions.

  2. Install V7.5.1 Fix Pack 2 (V7.5.1.2) using either IBM Installation Manager or silent installation as explained in the fix pack installation instructions.


    Note: The stand-alone profile is automatically updated during fix pack installation and additional steps are not required to update the profile.

  3. Check for any errors, as explained in the Identifying Profile Update Errors section, before continuing.

  4. Restart the stand-alone application server.

Steps for upgrading in a network deployment environment



Notes and restrictions when upgrading in a network deployment environment

When upgrading from V7.5.1 releases in a network deployment environment, you must complete some additional steps. Complete the appropriate steps for your environment.
  • If minimum downtime is the objective during this upgrade, special precautions should be taken. These precautions are documented separately in the Clustered servers in a network deployment environment where minimum downtime is required during the upgrade document.

  • The Deployment Manager has to be the highest level in the cell. Upgrade the installation that contains the Deployment Manager before upgrading the nodes.

  • You cannot start cluster members at different versions at the same time.

    • You must stop all members of the older version before starting any of the upgraded members.

    • After an upgraded member has been started, you must no longer start ‘old' members.

  • Do not upgrade more than one installation at a time.

  • The Deployment Manager should be up and running when managed nodes are upgraded. This step is necessary because the fix pack installer must connect to the central configuration repository on the Deployment Manager to make the updates.

  • Note: The only exception to this rule is for managed nodes that are hosted by the same installation as their Deployment Manager profile. The managed node configuration is updated as part of the Deployment Manager profile in this scenario.




Security-enabled network deployment environments

When you apply the fix pack in a network deployment environment where WebSphere administrative security is enabled, the connection to the Deployment Manager requires that you provide a user ID and password. The IBM Installation Manager does not prompt you for these credentials when you start updating an installation that contains managed profiles. However, 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.

For more information on how to configure security for WebSphere administration scripts, for which the IBM WebSphere Enterprise Service Bus scripts depend, see Configuring security with scripting in the WebSphere Application Server Information Center.



Upgrading the Deployment Manager


  1. Back up your configuration.

  2. Stop all of the Java processes that are associated with the IBM WebSphere Enterprise Service Bus installation as documented in the previous common steps instructions.

  3. Install V7.5.1 Fix Pack 2 (7.5.1.2) on to the Deployment Manager installation using either IBM Installation Manager or silent installation, as explained in the fix pack installation instructions. The Deployment Manager profile is automatically updated during fix pack installation.

  4. Check for any errors, as explained in the Identifying Profile Update Errors section, before continuing.





Upgrading managed nodes
  1. Start the Deployment Manager. 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 that are hosted by the same installation as their Deployment Manager profile. The managed node configuration is updated as part of the Deployment Manager profile in this scenario and a separate log file is not written.

    Skip step 2 in this section for managed nodes that are hosted by the same installation as their Deployment Manager.

  2. Complete the following steps if the managed profile is hosted by an installation other than its Deployment Manager profile:

    1. Ensure that all of the servers and their node agents are stopped.

    2. Install V7.5.1 Fix Pack 2 (V7.5.1.2) using either the IBM Installation Manager or silent installation as explained in the fix pack installation instructions.


      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 might have to enter the credentials in a separate prompt near the end of the update process. 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.

    3. Check for any errors, as explained in the Identifying Profile Update Errors section, before continuing.

  3. If Business Space is configured on a non-clustered server on this node, manual steps are required for updating existing Business Space templates and spaces. Follow step 2a of Updating Business Space templates and spaces after installing or updating widgets. Do not complete the node synchronization and server restart until you have read the following next steps.

  4. If any of the nodes contain cluster members, follow the steps described under Upgrading Clusters before starting the servers.

  5. For each node, restart the node agent and wait for the node synchronization to complete.

  6. If you have disabled automatic synchronization, ensure that all your nodes are correctly synchronized before starting the cluster members.

  7. Start all the servers and cluster members as needed.





Upgrading clusters

After upgrading the Deployment Manager and the managed nodes containing cluster members, follow these steps to upgrade each of the clusters in your network deployment environment before starting the cluster members (servers).


Note: If minimum downtime is the objective during this upgrade, special precautions should be taken. These precautions are documented separately in the Clustered servers in a network deployment environment where minimum downtime is required during the upgrade document.


  1. Stop the Deployment Manager, if it is running.

  2. On the Deployment Manager, change directories to <install_root>.

  3. Depending on the platform, run one of the following commands for each cluster:

    On Windows operating systems:
    bin\ws_ant.bat -f util\BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true –Dcluster=<clusterName>

    On UNIX-based and Linux operating systems:
    bin/ws_ant.sh -f util/BPMProfileUpgrade.ant -profileName <profileName> -Dupgrade=true –Dcluster=<clusterName>

    where <profileName> is the name of the Deployment Manager profile and <clusterName> is the name of the cluster.

  4. Check the following log file for errors: <profile_root>/logs/BPMProfileUpgrade.<profileName>.<clusterName>.<timestamp>.log where <profile_root> is the root directory of the Deployment Manager profile.

    If there is an error, fix the cause and then rerun step 3.

  5. If Business Space is configured on the cluster, manual steps are required for updating existing Business Space templates and spaces. Follow steps 1a and 1b of Updating Business Space templates and spaces after installing or updating widgets. Do not complete the node synchronization process and restart the server until you have read the following next steps.

  6. When all clusters have been successfully upgraded, restart the Deployment Manager.

  7. For each node, restart the node agent and wait for node synchronization to complete.

  8. If you have disabled automatic synchronization, ensure that all your nodes are correctly synchronized before starting the cluster members.

  9. Start all the servers and cluster members as needed.




Identifying profile update errors



If an "The packages are updated with warnings" error message is displayed on the Installation Manager summary panel (GUI installation) or on the command line (silent installation), check the <install_root>/logs/wbi/install.FP7501/installconfig_wps_profileMaintenance.log file.


If it contains the Result of executing [...]BPMProfileMaintenance.ant was: false
message, 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 with which profile this error is associated.


Fix the cause, then follow the appropriate steps in the Recovering after profile update errors section.


When you upgrade an installation on the Windows XP operating system, you must check the installconfig_wps_profileMaintenance.log file, even if the Installation Manager reported that the packages are updated.


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 that the stand-alone application server or the Deployment Manager is stopped.

  2. Change directories to <install_root> where the profile update error has occurred and run one of the following commands as appropriate for your platform.

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

    On UNIX-based and Linux operating systems:
    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 that the Deployment Manager has been started. This step is necessary because the BPMProfileUpgrade.ant script must connect to the central configuration repository on the Deployment Manager to make the updates.

  2. Change directories to <install_root> where the profile update error has occurred and run one of the following commands as appropriate for your platform:

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

    On UNIX-based and Linux operating systems:
    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.



Rolling back V7.5.1 Fix Pack 2



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 might have configured the profile after installing the maintenance.

Warning: Profiles might 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 restoreConfig command. After you run the restoreConfig command, re-install the exported enterprise applications and redo any other applicable configuration changes that you made since you ran the restoreConfig command.



Additional information



You can find additional information on any of these topics in the WebSphere Enterprise Service Bus product documentation. For more information about the update strategy or to obtain updates to WebSphere Enterprise Service Bus, see the Recommended Fixes pages for WebSphere Enterprise Service Bus.



Trademarks and service marks:

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



Original Publication Date

07 March 2014

[{"Product":{"code":"SS7J6S","label":"WebSphere Enterprise Service Bus"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5.1.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WESB

Document Information

Modified date:
17 June 2018

UID

swg27041423