Installing WebSphere Business Modeler Publishing Server V6.2.0 Fix Pack 1

Content

Pre-installation steps
Installing the Publishing Server V6.2.0 Fix Pack 1
Updating Publishing Server servers in a network deployment environment
Uninstalling Fix Pack 1

Pre-installation steps

It is recommend that you back up your WebSphere Business Modeler Publishing Server 6.2.0 profiles and Business Space applications before installing the WebSphere Business Modeler Publishing Server V6.2.0 Fix Pack 1 (6.2.0.1).

Important: If you have WebSphere Business Modeler Publishing Server installed on a server with WebSphere Process Server, you must install the WebSphere Process Server v6.2 fix pack 1 before installing this fix pack for WebSphere Business Modeler Publishing Server.

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
   
   
   backupFileindicates 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
   
   
   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 V6.2.0 Fix Pack
   
   
5. Back up the following files located in the <WAS>/installableApps dir for EAR files and the <WAS>/plugins dir for the JAR files :
• BSpaceManager.ear
• BSpaceWidgets.ear
• com.ibm.bspace.plugin_6.2.0.jar

Installing the Publishing Server V6.2.0 Fix Pack 1

1. Stop the server.
   
   
2. In <PubServerRoot>\properties\version\nif\backup\ directory, open the NIFStack.xml file with an XML Editor.
   
3. Change
   <param name="commonComponentRequires" value="BSCC:=6.3.0.0"/>
   to
   <param name="commonComponentRequires" value="BSCC:=6.2.0.0"/>
   
4. Download and install the Update Installer (7.0.0.3wpbs) for WebSphere Business Modeler Publishing Server.
   
5. Download 6.2.0-WS-WPBS-<platform>-FP0000001.zip (See the Download packages section and click the FTP link of the appropriate platform package.) Depending upon your current platform, the name of your file will be one of the following:
• (LinuxS390) 6.2.0-WS-WPBS-LinuxS390_64-FP0000001.tar
• (Linux) 6.2.0-WS-WPBS-LinuxX32-FP0000001.tar
• (Windows) 6.2.0-WS-WPBS-WinX32-FP0000001.zip
  
  
6. Extract the files from the file you downloaded into the maintenance directory in the Update Installer (7.0.0.3) installation directory. There are three files extracted from the the file:
• 6.1.0-WS-WASSDK-platform-FP0000023.pak
• 6.1.0-WS-WAS-platform-FP0000023.pak
• 6.2.0-WS-WPBS-platform-FP0000001.pak
  
  
7. Launch Update Installer.
   
   
8. Select the path where the 6.2.0.1 Fix Pack for IBM WebSphere Modeler Publishing Server v6.2 will be installed.
   
   
9. Select Install Maintenance Package.
   
   
10. Specify the location of the fix pack.
    
    
11. Ensure that the Fix Pack (6.2.0-WS-WPBS-<platform>-RP0000001.pak) is selected and press Next to install the Fix Pack.
    
    
12. Verify that the Success message is displayed.
    
    

Verifying the Fix Pack 1 installation

1. Start the server.
   
   
2. Log into the Administrative Console.
   
   
3. Go to System administration > Nodes and verify that the WebSphere Business Modeler Publishing Server version is now 6.2.0.1.
   
   Note: WebSphere Business Modeler Publishing Server is shortened to WBPS in the nodes list.
   
   
4. If any of the nodes that should contain WebSphere Business Modeler Publishing Server do not contain it, you can manually update fix pack EARs with the administrative console. Go to Applications > Enterprise Applications, uninstall and install the Publishing Server.ear, BSpaceManager.ear, and BSpaceWidgets.ear.

Updating Publishing Server servers in a network deployment environment

Perform the following instructions on all nodes where WebSphere Business Modeler Publishing Server installs exist and where you are going to apply the fix pack.

1. Stop all servers and node agent must be stopped.
   
   
2. On each server where where WebSphere Business Publishing Server is installed, goto the <PubServerRoot>\properties\version\nif\backup\ directory and open the NIFStack.xml file with an XML Editor.
   
3. Change
   <param name="commonComponentRequires" value="BSCC:=6.3.0.0"/>
   to
   <param name="commonComponentRequires" value="BSCC:=6.2.0.0"/>
   
4. Download and install the Update Installer (7.0.0.3wpbs) for WebSphere Application Server.
   
5. Download 6.2.0-WS-WPBS-<platform>-FP0000001.zip (See the Download packages section and click the FTP link of the appropriate platform package.) Depending upon your current platform, the name of your file will be one of the following:
• (Linux) 6.2.0-WS-WPBS-LinuxX32-FP0000001.zip
• (Windows) 6.2.0-WS-WPBS-WinX32-FP0000001.zip
  
  
6. Extract the files from the zip file you downloaded into the maintenance directory in the Update Installer (7.0.0.3) installation directory.
   
   
7. Launch Update Installer.
   
   
8. Select the path where the 6.2.0.1 Fix Pack for IBM WebSphere Modeler Publishing Server v6.2 will be installed.
   
   
9. Select Install Maintenance Package.
   
   
10. Specify the location of the Fix Pack.
    
    
11. Ensure that the Fix Pack (6.2.0-WS-WPBS-<platform>-RP0000001.pak) is selected and press Next to install the Fix Pack.
    
    
12. Verify that the Success message is displayed.

Now you must perform the following manual steps each server in an ND deployment.

Verifying the Fix Pack 1 installation

1. Start the Deployment Manager and all node agents.
   
2. Log into the Administrative Console.
   
3. Go to System administration > Nodes and verify that the WebSphere Business Modeler Publishing Server version is now 6.2.0.1.

Note: WebSphere Business Modeler Publishing Server is shortened to WBPS in the nodes list.

Updating the EAR files

1. Manually deploy the following EAR files using the administrative console.

• PublishingServer.ear
• BSpaceManager.ear
• BSpaceWidgets.ear
  
  

1. Start the Deployment Manager.

2. Start all node agents.

3. If the clusters are started, stop the clusters. Do not start the clusters.

4. Go to WebSphere Administrative Console and complete the following for the three applications.

Applications:

Name IBM_WPBS_PUBSERVER EAR File: PublishingServer.ear
Name: BusinessSpaceManager EAR File : BSpaceManager.ear
Name: IBM_BSPACE_WIDGETS EAR File : BSpaceWidgets.ear

5. Start the clusters and make sure applications are working properly

Uninstalling Fix Pack 1

Note: The server must be stopped in order to uninstall the WebSphere Business Modeler Publishing Server V6.2.0 Fix Pack 1. Additionally, in a network deployment environment, the node agent must be stopped.

1. Launch the Update Installer.
   
   
2. Select Uninstall maintenance package.
   
   
3. Select the WebSphere Application Server installation location from where the 6.2.0.1 Fix Pack for IBM WebSphere Business Modeler Publishing Server V6.2.0 is to be removed.
   
   
4. Ensure that you have selected the Fix Pack (6.2.0-WS-WBM-<platform>-RP0000100.pak) and press Next to uninstall the Fix Pack.
   
   
5. Verify Success message is displayed.

Restoring a profile backup after successful uninstallation of Fix Pack 6.2.0.1

1. Stop the server and the running processes for the profile that you want to restore.
   
   
2. Go to <profilePath> and rename the <profileName> directory to <profileName>.620
   
   
3. Go to <pubserverRoot>\bin directory.
   
   
4. Run the following command:
   
   manageprofiles.bat -validateAndUpdateRegistry
   
   The output on the console should display
   
5. Run the following command:
   
   manageprofiles.bat
   -restoreProfile
   -backupFile <backupDirectory>\<profileName>.backup.zip
   
   Where:
   
   backupFile indicates which backup file should be restored. 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 where the backup of the profile is located
   
   <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.
   
   
6. Optional: If you backed up the Business Space EAR file and Jar file in the pre-installation steps and want to restore them, copy replace the newer ones with the copies versions from you back up location. Note: It is not recommended to keep profiles with new and old levels of Business Space (in case of multiple profiles) since the plugin jar is used for WebSphere Application Server and is not tied to the profiles.