IBM Support

Installing Business Space powered by WebSphere: V7.5.1.0 Interim Fix 3

Product Documentation


Abstract

This document contains instructions on how to install V7.5.1.0 Interim Fix 3 for Business Space powered by WebSphere (Business Space V7.5.1.0 Interim Fix 3).

Content

Installing Business Space V7.5.1.0 Interim Fix 3

Uninstalling Business Space V7.5.1.0 Interim Fix 3





Installing Business Space V7.5.1.0 Interim Fix 3


Before you install Business Space V7.5.1.0 Interim Fix 3, do the following:


Important: Before you install this Interim Fix, you must back up your WebSphere product profile. Use the instructions below titled "Backing up your WebSphere product profile."

Backing up your WebSphere product profile
Note: Before you install this Interim Fix, use these steps for each WebSphere product profile that you want to back up.
  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 <WAS_root>\bin.
  4. Run the following command:
    manageprofiles.bat
    -backupProfile
    -profileName <
    profileName>
    -backupFile <
    backupDirectory>\<profileName>.backup.zip

Where:

<
profileName> represents the name of your profile

<backupDirectory> is the directory you created to store the backup of the profile. 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."

The console should display the following message: INSTCONFSUCCESS: Success: The profile backup operation was successful. You can proceed with installing Business Space V7.5.1.0 Interim Fix 3.


For more information about these parameters, access the link: http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.nd.doc/info/ae/ae/rxml_manageprofiles.html


Installing the Interim Fix in a network deployment environment

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

Installing the Interim Fix



  1. Download Business Space V7.5.1.0 Interim Fix 3 to a temporary disk location.
  2. Unpack the repository to any directories you choose. Take note of where you have unpacked the repository.
  3. Start IBM Installation Manager.
  4. Click File > Preferences.
  5. On the Repositories panel click the Add Repository button. Type or browse to the location of the repository.config file for the Business Space V7.5.1.0 Interim Fix 3 repository that you unpacked in step 2. Click OK to save the new repository settings.
  6. Click Update, and click Next.
  7. From the Update Packages panel, select the package group that has IBM Business Space 7.5.1.0 installed, and click Next. If only one package group is available, it is selected by default; therefore, just click Next.
  8. Under the installed IBM Business Space Version 7.5.1.0, select 7.5.1.0-WS-BSPACE-IFJR43382, and click Next.
  9. Ensure that you have already backed up all profiles. If yes, click Next.
  10. Verify the information on the panel and click Update to start applying the Interim Fix.
  11. When the update is completed, click View Log File on the last panel to verify that there are no errors.


Upgrading your WebSphere product profiles in a stand-alone environment



Use the procedure in this section to upgrade your WebSphere product profiles that were created prior to installing Business Space V7.5.1.0 Interim Fix 3, in a stand-alone environment. If you do not have any WebSphere product profiles that were created prior to installing Business Space V7.5.1.0 Interim Fix 3, proceed to the section Restarting the environment after installation of Business Space V7.5.1.0 Interim Fix 3.

You will use one of the following scripts depending on your platform:

Windows: <WAS_root\BusinessSpace\scripts\upgradeBSpaceProfile.bat
UNIX and Linux: <WAS_root>/BusinessSpace/scripts/upgradeBSpaceProfile.sh

Run the script as shown:

upgradeBSpaceProfile -profileName <profile_name> -nodeName <node_name> -serverName <server_name>

Proceed to the section Updating the Business Space configuration.


Upgrading your WebSphere product profiles in a network deployment environment


Use the procedure in this section to upgrade your WebSphere product profiles that were created prior to installing Business Space V7.5.1.0 Interim Fix 3, in a network deployment environment. If you do not have any WebSphere product profiles that were created prior to installing Business Space V7.5.1.0 Interim Fix 3, proceed to the section Restarting the environment after installation of Business Space V7.5.1.0 Interim Fix 3.



Security-enabled network deployment environments

When you apply the Interim Fix in a network deployment environment where WebSphere administrative security is enabled, the connection to the deployment manager requires a user ID and password to be supplied. The IBM Installation Manager does not prompt for these credentials when you start updating an installation containing managed profiles. However, depending on your configuration, you may have to enter the credentials in a separate prompt near the end of the upgrade process.

Note:
The credential panel appears twice during the upgrade process, and has a default timeout period of one minute. If you miss this prompt, or your security configuration is set up such that no prompt is 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 (which the Business Space scripts depend on), see Configuring security with scripting in the WebSphere Application Server Information Center.


Upgrading the deployment manager
  1. Install Business Space V7.5.1.0 Interim Fix 3 onto the deployment manager’s installation using IBM Installation Manager as described in the section Installing the Interim Fix. The Deployment Manager profile is automatically updated during Interim Fix 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. The deployment manager must be running when you apply the Refresh 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. For each managed node with an independent installation, perform the following steps:

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

    b. Install Business Space V7.5.1.0 Interim Fix 3 onto the managed node's installation using IBM Installation Manager as described in the section Installing the Interim Fix.

    Note: When applying the Interim Fix 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 Interim Fix installation.
    Log files are saved as:

    <profile_root>/logs/BSpaceProfileUpgrade.<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 Upgrading Clusters before starting the servers.
  4. For each node, restart the node agent and wait for the node synchronization to complete.
  5. If you have disabled automatic synchronization, ensure all your nodes are correctly synchronized before starting the cluster members.
  6. 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 the clusters before starting the cluster members (servers).
  1. On the deployment manager change to <WAS_root>.
  2. Depending on the platform, run one of the following commands for each cluster:

    Windows: <WAS_root>\bin\ws_ant.bat -f ..\BusinessSpace\upgrade\BSpaceProfileUpgrade.ant -profileName <profileName> -Dupgrade=true -Dcluster=<clusterName>

    UNIX and Linux: <WAS_root>/bin/ws_ant.sh -f ../BusinessSpace/upgrade/BSpaceProfileUpgrade.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.
  3. Check the following log file for errors:

    <profile_root>/logs/BSpaceMigrateCluster.<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, then rerun step 2.
  4. When all clusters have been successfully upgraded, stop and restart the deployment manager.
  5. For each node, restart the node agent and wait for the node synchronization to complete.
  6. If you have disabled automatic synchronization, ensure all your nodes are correctly synchronized before starting the cluster members.
  7. Start all the servers and cluster members as needed.


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 <WAS_root>/logs/bspace/install.IFJR43382/installconfig_bspace_profileMaintenance.log.
If it contains the message:

Result of executing [...]BSpaceProfileMaintenance.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



Note: For network deployment environments that are not using clusters, please refer to this technote for instructions on identifying and recovering from a particular Business Space profile upgrade error that can occur. For all other profile upgrade errors (in any type of environment), follow the instructions in this section that are appropriate for the profile for which update failed.

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 <WAS_root> directory where the profile update error has occurred and run one of the following commands as appropriate for your platform.

    Windows: <WAS_root>\bin\ws_ant.bat -f BusinessSpace\upgrade\BSpaceProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    UNIX and Linux: <WAS_root>/bin/ws_ant.sh -f BusinessSpace/upgrade/BSpaceProfileUpgrade.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. 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 <WAS_root> directory where the profile update error has occurred and run one of the following commands as appropriate for your platform.

    Windows: <WAS_root>\bin\ws_ant.bat -f BusinessSpace\upgrade\BSpaceProfileUpgrade.ant -profileName <profileName> -Dupgrade=true

    UNIX and Linux: <WAS_root>/bin/ws_ant.sh -f BusinessSpace/upgrade/BSpaceProfileUpgrade.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.


Updating the Business Space configuration



You must manually update the ConfigService.properties file and then update the Business Space configuration for each of for your existing WebSphere product profiles, using the following procedure:
  1. Open the file ConfigService.properties in a text editor.

    In a stand-alone environment, this file is located in <profile_root>/BusinessSpace/<node_name>/<server_name>/mm.runtime.prof/config.

    In a clustered environment, this file is located on the deployment manager, in <deployment_manager_profile_root>/BusinessSpace/<Business_Space_cluster_name>/mm.runtime.prof/config.
  2. Add the following property to the list of properties in the section com.ibm.mashups.properties.client (section begins near the top of the file), if it is not already present:

    com.ibm.mashups.user.groupCacheUpdateFrequency

    Ensure that each property in the section is followed by a comma and a backslash (",\"), except for the last property in the list.
  3. Add the following at the end of the file (note that the text above the last line should be on a single line, as as a comment) :

    # Description: This property controls how often the Mashup Center group cache is updated for a group cache entry. The default number shows an entry is updated after 24 hours when it is retrieved. Value 0 indicates no caching.
    com.ibm.mashups.user.groupCacheUpdateFrequency=24

    (Note: This Interim Fix includes a fix for APAR JR43382, to address an issue with duplicate LDAP queries in group searches.)
  4. Save and close ConfigService.properties.
  5. Open a command window. In a stand-alone environment, go to the directory <profile_root>/bin. In a clustered environment, go to the directory <deployment_manager_profile_root>/bin.
  6. Type the wsadmin command to start the wsadmin interactive environment.
  7. In the wsadmin environment, run the updatePropertyConfig command.

    For a stand-alone environment:
    • The following example uses Jython:
    AdminTask.updatePropertyConfig('[-serverName server_name -nodeName
     node_name-propertyFileName "profile_root\BusinessSpace\node_name\
     server_name\mm.runtime.prof\config\ConfigService.properties" -prefix
     "Mashups_"]')
    AdminConfig.save()
    • The following example uses Jacl:

    $AdminTask updatePropertyConfig {-serverName server_name -nodeName
     node_name -propertyFileName "profile_root\BusinessSpace\node_name\
     server_name\mm.runtime.prof\config\ConfigService.properties" -prefix
     "Mashups_"}
    $AdminConfig save

    For a clustered environment:
    • The following example uses Jython:

    AdminTask.updatePropertyConfig('[-clusterName Business_Space_cluster_name
     -propertyFileName "deployment_manager_profile_root\BusinessSpace\ 
     Business_Space_cluster_name
     \mm.runtime.prof\config\ConfigService.properties" -prefix "Mashups_"]')
    AdminConfig.save()
    • The following example uses Jacl:

    $AdminTask updatePropertyConfig {-clusterName Business_Space_cluster_name
     -propertyFileName "deployment_manager_profile_root\BusinessSpace\
     Business_Space_cluster_name
     \mm.runtime.prof\config\ConfigService.properties" -prefix "Mashups_"}
    $AdminConfig save



Restarting the environment after installation of Business Space V7.5.1.0 Interim Fix 3



If you have not already restarted your environment, do so now, as follows.
  • In a network deployment environment, start the following components (use the links for instructions):



Creating a Business Space group cache


This Interim Fix includes a fix for APAR JR43382, to address an issue with duplicate LDAP queries in group searches. The fix requires a new group cache that you must add to the WebSphere Application Server resource configuration. To create this cache, use the following procedure:

  1. In the WebSphere administrative console, navigate to Resources > Cache Instances -> Object Cache Instances (in the left pane).
  2. In the Scope pull-down, select the appropriate scope. In a stand-alone environment, select the server ("Node=<node_name>, Server=<server_name>"). In a network deployment environment, select the cluster where Business Space is deployed.
  3. Click New.
  4. Enter the following values in the appropriate fields:

    Name: Lotus Mashups Group Object Cache
    JNDI name: services/cache/group/mashupInstance
    Category: Lotus Mashups
    Cache size: 2000
    Default priority: 1
  5. Click OK, then click Save.



Uninstalling Business Space V7.5.1.0 Interim Fix 3


Before you uninstall Business Space V7.5.1.0 Interim Fix 3, do the following:



  • Deployment manager - http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.nd.doc/info/ae/ae/rxml_stopmanager.html

  • Uninstalling the Interim Fix

    1. Start the IBM Installation Manager and click Uninstall.

    2. Select the package group that has your WebSphere product installed and click Next


    3. Select 7.5.1.0-WS-BSPACE-IFJR43382 and click Next.
    4. Verify the information on the panel and click Uninstall to start uninstalling the Interim Fix.
    5. When the uninstallation is completed, click View Log File on the last panel to verify that there are no errors.
    Restoring a profile backup after successful uninstallation of Business Space V7.5.1.0 Interim Fix 3

Important: After uninstalling Business Space V7.5.1.0 Interim Fix 3, you must follow the steps below for each WebSphere profile that you want to restore.
  1. Stop the server and the running processes for the profile that you want to restore.
  2. Go to <WAS_HOME>\profiles and rename the <profileName> directory to <profileName>.7510if3.
  3. Go to <WAS_HOME>\bin.
  4. Run the following command:

    manageprofiles.bat -validateAndUpdateRegistry

    The output on the console should display [ <profileName> ].
  5. Run the following command:

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

    Where:

    <
    backupDirectory> is the directory where the backup of the profile is located. 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."

    <profileName> is the name of your profile that is being restored.

    The output on the console should display the message: INSTCONFSUCCESS: Success: The profile was successfully restored. If the restoration fails, refer to If your profile restoration fails below.

    For more information about these parameters, access the link: http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.nd.doc/info/ae/ae/rxml_manageprofiles.html

Restarting the environment after uninstallation of Business Space V7.5.1.0 Interim Fix 3

  • In a network deployment environment, start the following components (use the links for instructions):

[{"Product":{"code":"SS7NQD","label":"IBM Business Monitor"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Business Space","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","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSWLGF","label":"WebSphere Service Registry and Repository"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Business Space","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"","label":"HP Itanium"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux pSeries"},{"code":"","label":"Linux zSeries"},{"code":"","label":"Linux\/x86"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5.0.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Business Space","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5.1","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSCTJ4","label":"IBM Case Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux on System z"},{"code":"PF033","label":"Windows"},{"code":"PF027","label":"Solaris"}],"Version":"5.1.0.0;5.1.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SS7J6S","label":"WebSphere Enterprise Service Bus"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Business Space","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"","label":"i5\/OS"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux iSeries"},{"code":"","label":"Linux pSeries"},{"code":"","label":"Linux xSeries"},{"code":"","label":"Linux zSeries"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg27035637