IBM WebSphere Studio Application Developer Integration Edition 5.0.1 Fix Pack 001

Installation Instructions

This document describes how to install IBM WebSphere Studio Application Developer Integration Edition 5.0.1 Fix Pack 001from a downloaded copy of the wsappdevie_fix_pack001.zip, available from IBM WebSphere Studio Application Developer Integration Edition support. Installation is performed through the Update Manager capability included in the product.

Please Note: There are known issues that may result in problems during or after applying the fix. To ensure a proper installation:

• Follow the instructions below carefully.
• If you have disabled any plug-ins either through Update Manager or by modifying plugin.xml files, enable them prior to the installation.

Install IBM WebSphere Studio Application Developer Integration Edition 5.0.1 Fix Pack 001

1. Log on to your system with an ID that has write permission to the install location and start WebSphere Studio Application Developer Integration Edition 5.0.1. (This is typically an ID with Administrator authority on Windows, and root authority on Linux).
   Linux Note: Do not start with a workspace that a non-root user may later use. This can cause problems since certain files may be written into the workspace during the Update process that cannot be accessed by other users.
    
2. Open the Install/Update perspective (select Help > Software Updates > Update Manager). In the Feature Updates view, navigate the My Computer section to find the directory where you unzipped the wsappdevie_fix_pack001.zip. From there, find the wsappdevie/fix_pack001/fixes/IBM WebSphere Studio Application Developer Integration Edition Updates section, and choose WebSphere Studio Application Developer Integration Edition 5.0.1 Fix Pack 001.
   
   
3. Details about this interim fix are shown in the Preview view. For more information about what is included in the interim fix, click the More Info link. Click Install to begin the installation.
   
   
4. An install wizard will be shown. Click Next to continue.
   
   
5. Once you have read and accepted the license, click Next.
   
   
6. The Optional Features page will appear. Click Next to continue.
   Warning: Do not modify the selections. Changing the default choices may result in errors.
   
   
7. The final screen of the Install Wizard will show the install location. Click Finish to begin the installation.
   Warning: Errors may occur if you change the default install location.
   
   
8. If you are warned that you are about to install an unsigned feature, click Install to continue.
   This warning will not cause problems during installation.
   
   
9. When the installation is complete you will be asked to restart the product. Click Yes.
   Note: This action will not reboot your machine.
   
   
10. To confirm that the installation was successful, click on Current Configuration in the Install Configuration view and verify that WebSphere Studio Application Developer Integration Edition 5.0.1 Fix Pack 001is installed.

Additional User Instructions

These additional instructions apply to your projects after you have installed the fix pack. 

IMS Users Only - Updating your IMS projects

If you have imported the IMS resource adapter into your workspace and wish to update it with the IMS resource adapter added by the fix pack, do the following:

1. Select File > New >Service built from.... The New Service wizard is displayed.
2. Since you have already imported the IMS resource adapter into your workspace you should see IMS in the left pane of the New Service wizard. Click on the Import resource adapter... button. The Import wizard is displayed.
   1. In the Import wizard, browse to or enter the ims.rar file installed by the interim fix. This file can be found in WS_installdir\resource adapters, where WS_installdir is the WebSphere Studio installation directory. The ims.rar file installed by the interim fix should appear in the Connector file entry field.
   2. Select the Existing radio button and browse to the name of the IMS resource adapter you are updating. Click Finish. Since you have already imported the IMS resource adapter into your workspace, you will be asked if you wish to replace the IMS resource adapter jar files. Select Yes for all the jar files.
   3. All the projects in your workspace will be rebuilt and you will be returned to the New Service wizard.
3. Select Cancel on the New Service wizard.

If you have also configured a server in the WebSphere Test Environment with the same IMS resource adapter, you may need to stop and restart the server in order for the updated IMS resource adapter to be used.

Optional - Updating the run time
 

WebSphere Studio Application Developer Integration Edition consists of a set of tools to build applications running on an application server. To test those applications, it includes a run-time test environment that simulates an application server within the product. At the beginning of this fix pack, some prerequisites were made to modify the run-time test environment. They were necessary for the fixes designed for the tools to be effective.

In addition, you can also optionally update the run-time environment to match the current level of your standalone WebSphere application server. Although it is not necessary or recommended to update the run-time test environment just to match the application server level, some users may choose to match the application server level they deploy their applications to.

To update your run-time environment, click here.