Upgrading Rational Software Development Platform version 7.0 to Microsoft Windows Vista

Answer

Starting with version 7.0.0.2, Microsoft Windows Vista is supported on products in the Rational Software Development Platform.

It is recommended that you install version 7.0.0.2 (or later) Rational Software Development Platform products on a Windows Vista computer that did not previously have a Rational Software Development Platform product installed on it prior to being upgraded to Windows Vista.

If you have not already installed a version 7.0 or version 7.0.0.1 product on your system, then upgrade from Windows XP to Windows Vista before you install the version 7.0.0.2 product (version 7.0 and version 7.0.0.2 fix pack). For instructions on installing on a product for the first time on Windows Vista, refer to the installation instructions in the Readme for the product.

If you have already installed a version 7.0, 7.0.0.1, or 7.0.0.2 product on your Windows XP computer and you are upgrading from Windows XP to Windows Vista, then follow these steps before upgrading to Windows Vista:

1. Uninstall all Rational Software Development Platform products on your computer as well as IBM Installation Manager.
2. Upgrade from Windows XP to Windows Vista.
3. Install IBM Installation Manager, version 1.0.0.3 and then re-install your Rational Software Development Platform product at version 7.0.0.2.

For instructions on installing the version 7.0.0.2 product, refer to the installation instructions in the version 7.0.0.2 Readme file for the product.

In the case that your computer has already been upgraded to Windows Vista from Windows XP and a Rational Software Development Platform product (version 7.0, 7.0.0.1, or 7.0.0.2 ) was installed on the computer before the operating system upgrade, then you must uninstall all Rational Software Development Platform products on your computer as well as IBM Installation Manager.
Important: If you cannot start Installation Manager (and, therefore, cannot uninstall the products), follow the manual uninstall steps below to remove Installation Manager and the corresponding product. If you have more than one product installed, check and follow each of the product's uninstall steps.

Manually uninstalling Rational Application Developer or Rational Software Architect: overview
To manually uninstall one of these products, complete the following steps:

1. If you installed it, then manually uninstall IBM Rational Agent Controller.
2. If you installed either of the features IBM WebSphere Application Server, version 6.0 or IBM WebSphere Application Server, version 6.1, then manually uninstall them.
3. Manually uninstall the product.

Manually uninstalling Rational Software Modeler or Rational Systems Developer: overview
To manually uninstall one of these products, refer to the instructions below.

Manually uninstalling Rational Manual Tester: overview
To manually uninstall this product, refer to the instructions below.

Manually uninstalling Rational Functional Tester: overview
To manually uninstall this product, complete the following steps:

1. Manually uninstall IBM Rational Agent Controller, if you installed it.
2. Manually uninstall the product.

Manually uninstalling Rational Performance Tester: overview
To manually uninstall this product, complete the following steps:

1. Manually uninstall IBM Data Collection Infrastructure.
2. Manually uninstall IBM Rational Agent Controller, if you installed it.
3. If you installed either of the features IBM WebSphere® Application Server, version 6.0 or IBM WebSphere Application Server, version 6.1, then manually uninstall them.
4. Manually uninstall the product.

The instructions for completing these steps are provided below:

---

Manually uninstalling the features WebSphere Application Server, version 6.0 and WebSphere Application Server, version 6.1
If you installed the features WebSphere Application Server, version 6.0 or WebSphere Application Server, version 6.1 when you installed your product, then you must uninstall it manually by running the uninstall program for this feature.
To manually uninstall this feature, complete the following steps:

1. In an Explore window, navigate to the following directory:
• For WebSphere Application Server, version 6.0: <Installation directory>\runtimes\base_v6\_uninst
• For WebSphere Application Server, version 6.1: <Installation directory>\runtimes\base_v61\uninstall
  (Note: By default, <Installation directory> is C:\Program Files\IBM\SDP70).
2. Start the uninstall program uninstall.exe.
   (Note: the file extension might not be displayed, so the file might appear to names as uninstall.):
• On Windows XP: Double-click uninstall.exe.
• On Windows Vista: Right-click uninstall.exe and click Run as administrator. When prompted by the User Account Control dialog box, click Allow. I trust this program. I know where it's from or I've used it before.
3. The Install Shield Wizard starts. Follow the on-screen instructions to uninstall the version of WebSphere Application Server.

Note: If the "Program Compatibility Assistant" dialog box opens during the process, click Cancel.

(These steps are not necessary for the WebSphere Application Server, version 5.1 feature; it will be uninstalled when you uninstall the Rational Software Development Platform program.)

---

Manually uninstalling Rational Agent Controller
If you attempt to uninstall Rational Agent Controller and the uninstall program gives an error message that it cannot be uninstalled as it is being referenced by another product, try the following steps to uninstall Agent Controller:

1. In a text editor, open the file C:\WINDOWS\IBM\IBMAGENT_70\.sdpinst\cdi_ref.properties
2. Examine the line ibmrac_reference_7.products
1. If it contains a product ID other than "ibmrac", then you need to pass this ID to the uninstall program. For example, run uninstall.exe -W prod_id_uninstall.value=product_X
2. If more multiple product IDs are listed, then change the line to:  ibmrac_reference_7.products=ibmrac and run 'uninstall.exe' without any parameters.
3. If no product id is found add a line ibmrac_reference_7.products=ibmrac and run 'uninstall.exe' without any parameters.

If the method above does not work, try the following steps:

1. Run _uninstall\uninstall.exe -W refcounting.active=false
2. Remove cdi_ref.properties

If you receive an error "java.lang.ClassCastException: com.installshield.product.service.registry.LoggedSoftwareObject", then InstallShield database might be corrupted. In this case, delete the ibmrac directory from C:\Program FIles\Common Files\InstallShield\Universal\*\

---

Manually uninstalling the IBM Data Collection Infrastructure
If you are uninstalling Rational Performance Tester, then you must first uninstall the Data Collection Infrastructure.
To uninstall the Data Collection Infrastructure, complete the following steps:

1. Log in as Administrator.
2. Open a command prompt and change to the <rpt installation directory>\rpt\DCI\_unins directory of the Rational Performance Tester installation directory.
   (By default, <rpt installation directory> is C:\Program Files\IBM\RPT70).
   For example, change to C:\Program Files\IBM\RPT70\rpt\DCI\_uninst.
3. Run uninstall -W prod_id_uninstall.value=ibmrpt.
4. The uninstall wizard starts. Follow the on-screen instructions to uninstall IBM Data Collection Infrastructure.

---

Manually uninstalling Rational Application Developer; Rational Software Architect; Rational Software Modeler; Rational Systems Developer

Notes: The instructions that follow use the default installation location for these products (C:\Program Files\IBM\SDP70) and the default shared resources directory (C:\Program Files\IBM\SDP70Shared). Ensure that you adjust the directory paths to match your installation choices.

To manually uninstall one of these products, complete the following steps:

1. Open Windows Explorer and browse to C:\Program Files\IBM
2. Delete the following sub-directories:
• Installation Manager
• SDP70
• SDP70Shared
  Tip: If the only sub-directories are the three listed above, then you can delete the IBM directory instead.
  Note: On Windows Vista, you might be prompted to confirm this action. If you get a permission denied error, reboot your computer and try to delete the directories again..
3. Browse to the following directory:
• On Windows XP: C:\Documents and Settings\All Users\Application Data\IBM
• On Windows Vista: C:\ProgramData\IBM
  Note: You might have to enable displaying Hidden files and Folders in order to view this directory.
4. Delete the Installation Manager sub-directory. If it is delete the IBM directory. If it is not then just delete the Installation directory.Tip: If there are other sub-directories (for example, RFT) and only version 7.0 or higher Rational Software Development Platform products are installed on your computer, then you can safely delete the entire IBM directory.
5. Important: If you have other Rational products installed on the system that are not Rational Software Development Platform products, then skip this step. Delete the following directories:
• On Windows XP: Browse to the directory C:\Documents and Settings\<SDP 70 User>\Application Data and delete the IBM and Rational sub-directories.
• On Windows Vista: Browse to the directory C:\Users\<SDP70 User>\AppData\Roaming and delete the Rational directory.
  Note:<SDP70 User> is the name of any user on the system that has run one of the Rational Software Development Platform products.
6. Browse to the C:\ directory and delete the IBM sub-directory if it exists.
7. If you plan on re-installing the product, ensure that you do not delete the projects in your workspace.
   Important: Do not use the original workspace after re-installing the product. Instead, manually import the projects into a new workspace.
8. If you are using the recycle bin, it is recommended that you empty it before you re-install the products.
9. Open Control Panel > Programs and Features.
   Tip: You might have to select Classic view to see this option on Windows Vista.
10. Select IBM Installation Manager and remove it.
11. Select IBM Software Development Platform and remove it.

You have uninstalled the product.

---

Manually uninstalling IBM Rational Functional Tester

Notes: The instructions that follow use the default installation location for Rational Functional Tester (C:\Program Files\IBM\SDP70) and the default shared resources directory (C:\Program Files\IBM\SDP70Shared). Ensure that you adjust the directory paths to match your installation choices

To manually uninstall Rational Functional Tester, complete the following steps:

1. In an Explore window, navigate to C:\Program Files\IBM\SDP70\FunctionalTester\installscripts\uninstall.bat.sample file, or refer the file from the Installation Directory that you had specified at the time of RFT Installation. On Vista, the Default Install Directory will be: "C:\Program Files_IBM\SDP70".
2. In a text editor, open the file uninstall.bat.sample and modify the parameters of the file as per Comments, if required.
3. Save the file and rename it uninstall.bat
4. Run the file uninstall.bat.
5. When the program completes, delete the directory C:\Program Files\IBM\SDP70\FunctionalTester.

Tip: If no other Rational Software Development Platform products are installed, then delete the following directories:
• C:\Program Files\IBM\SDP70
• C:\Program Files\IBM\SDP70Shared

You have uninstalled Rational Functional Tester.

---

Manually uninstalling IBM Rational Manual Tester

Notes: The instructions that follow use the default installation location for Rational Manual Tester, (C:\Program Files\IBM\RMT70) and the default shared resources directory (C:\Program Files\IBM\SDP70Shared). Ensure that you adjust the directory paths to match your installation choices

To manually uninstall Rational Manual Tester, complete the following steps:

1. Open an Explore Window and browse to C:\Program Files\IBM.
2. Delete the following sub-directories:
• Installation Manager.
• RMT70.
• SDP70Shared.

Tip: If the only sub-directories are the three listed above, then you can delete the IBM directory instead.
1. For Windows Vista: Browse to C:\ProgramData and delete the IBM sub-directory. (In other words, delete C:\ProgramData\IBM.)
2. For Windows Vista: Browse to the directory C:\Users\<SDP70 User>\AppData\Roaming and delete the IBM sub-directory, where <SDP70 User> is the name of user on the system that has run one of the IBM Rational Software Development Platform version 7.0 products.
3. Browse to the C:\ directory. If there is an IBM directory (C:\IBM), then delete it.
4. If you will be re-installing the product, then ensure that you do not delete any workspace directories that you created.
Note: Do not attempt to use the workspace after re-installing of the product. Instead, you must manually import projects from your workspace into a new workspace after re-installing the product.
5. Open Control Panel > Programs and Features. (Tip: You might have to select Classic view to see this option on Windows Vista).
6. Select IBM Installation Manager and remove it.
7. Select IBM Rational Manual Tester and remove it.

You have uninstalled Rational Manual Tester.

---

Manually uninstalling IBM Rational Performance Tester

Notes: The instructions that follow use the default installation location for Rational Performance Tester (C:\Program Files\IBM\RPT70) and the default shared resources directory (C:\Program Files\IBM\SDP70Shared). Ensure that you adjust the directory paths to match your installation choices.

To manually uninstall Rational Performance Tester, complete the following steps:

1. Log in as Administrator.
2. Open an Explore Window and browse to C:\Program Files\IBM.
3. Delete the following sub-directories:
• Installation Manager.
• RPT70.
• SDP70Shared.
  Tip: If the only sub-directories are the three listed above, then you can delete the IBM directory instead.
4. Browse to the following directory:
• On Windows XP: C:\Documents and Settings\All Users\Application Data\IBM
• On Windows Vista: C:\ProgramData\IBM
  Note: You might have to enable displaying Hidden files and Folders in order to view this directory.
5. Delete the Installation Manager sub-directory. (In other words, delete C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager, or C:\ProgramData\IBM\Installation Manager.)
6. Important: If you have other Rational products installed on the system that are not Rational Software Development Platform products, then skip this step. Delete the following directories:
• On Windows XP: Browse to the directory C:\Documents and Settings\<SDP 70 User>\Application Data and delete the IBM and Rational sub-directories.
• On Windows Vista: Browse to the directory C:\Users\<SDP70 User>\AppData\Roaming and delete the Rational directory.
  Note:<SDP70 User> is the name of any user on the system that has run one of the Rational Software Development Platform products.
7. Browse to the C:\ directory. If there is an IBM directory (C:\IBM), then delete it.
8. If you will be re-installing the product, then ensure that you do not delete any workspace directories that you created.
   Note: Do not attempt to use the workspace after re-installing of the product. Instead, you must manually import projects from your workspace into a new workspace after re-installing the product. If you are using the Recycle bin it is recommended that you empty the recycle bin before trying to re-install the products.
9. If you are using the recycle bin, it is recommended that you empty it before you re-install the products.
10. Open Control Panel > Programs and Features.
    Tip: You might have to select Classic view to see this option on Windows Vista.
11. Select IBM Installation Manager and remove it.
12. Select IBM Software Development Platform and remove it.

You have uninstalled Rational Performance Tester.