IBM WebSphere Studio Application Developer Integration Edition Interim Fix 009 - IMS Fixes

Installation Instructions

This document describes how to install IBM WebSphere Studio Application Developer Integration Edition Interim Fix 009 - IMS Fixes from a downloaded copy of the wsappdevie_interim_fix009.zip, available from the IBM WebSphere Studio Application Developer Integration Edition Support site. 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 Interim Fix 009 - IMS Fixes

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_interim_fix009.zip. From there, find the wsappdevie501/interim_fix009/fixes/IBM WebSphere Studio Application Developer Integration Edition Updates section, and choose WebSphere Studio Application Developer Integration Edition Interim Fix 009 - IMS Fixes.
   
   
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, in the Install/Update perspective expand Current Configuration in the Install Configuration view. Expand WSinstalldir/wstools/eclipse/. Verify that WebSphere Studio Application Developer 5.0.1 Integration Edition Interim Fix 009 - IMS Fixes is installed. A Disable button should replace the former Install button in the Preview view.

Additional Instructions for IMS Users

If you have imported the IMS resource adapter into your workspace and wish to update it with the IMS resource adapter added by the interim fix, 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 opens.
   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 field.
   2. Select the Existing radio button. Click Browse beside the Existing project name field and navigate to the name of the IMS resource adapter you are updating. Click OK to add it and then 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.