IBM Support

Install of the Rational Application Developer 6.x WebSphere Test Environment 6.0 server failed on Windows

Troubleshooting


Problem

The installation of IBM Rational Application Developer for WebSphere Software (RAD) version 6.x completed except for the WebSphere Test Environment (WTE) version 6.0 server.

Symptom

There was no <RAD Install Directory>/runtimes/base_v6 created in the installation process.

Cause

Unknown.

Resolving The Problem

Here is a list of things to CHECK first and then reinstall if your install completed without installing the WTE. A complete set of WTE V6 MANUAL INSTALL instructions also follows, to help you isolate the problem if required.

Note: This information is also applicable if an update of the WTE WAS version 6.0 server failed after an initial successful install of RAD version 6.x and WTE version 6.0. A reinstall may also be necessary if the server cannot start and you see the error message: "serverlaunch but failed initialization"


CHECK [and re-install]

  1. Check for any space constraints, especially if you tried installing before. Check the disk space available as per the provided installation instructions.

  2. Microsoft Windows operating system-related issues to consider:

    On Windows 2000 or Windows XP machines, check to see if the RAD/WTE install path exceeds the path length of 255. See Related Information Items:

    You cannot delete a file or a folder on an NTFS file system volume
    and
    File Names Seem to Be Limited to Less Than 255 Characters.

    In particular, if you are using Windows 2003 SP1, have a look at Related Information item:

    License registration fails in Rational Application Developer installation when Data Execution Protection is enabled

    which is based on the Microsoft Knowledge Base item:

    A detailed description of the Data Execution Prevention (DEP) feature in Windows XP Service Pack 2, Windows XP Tablet PC Edition 2005, and Windows Server 2003    .

  3. Check to see if the error log indicates that the problem appears to be occurring when copying files to install dir (such as, it does not get to profile creation).

    You can check log files for a successful installation at: <RAD_install_dir>\logs\was_v6_out.log,

    then if <RAD_install_dir>\base_V6 gets created, check:

    <RAD_install_dir>\base_V6\logs\log.txt
    <RAD_install_dir>\base_V6\logs\wsprofile\wasprofile_create_default.log

    Check for INSTCONFSUCCESS messages at the end of these files for confirmation of successful installation.

    It is possible that the install image could be corrupted.

    For example, the disk4 WTE version 6 installation image directory, disk4\external\was6, contains 420,185,074 bytes, 1013 files, 416 folders.

    If you are installing from CD or a network drive, you might want to copy the image to a local drive, which sometimes avoids these problems.

    Or, download the V6 WTE again and re-extract to get a clean copy.

    If you are downloading from Passport Advantage, it should look something like this:

    Download 3 of  21:
    Rational Application Developer V6.0 Windows Part 3 -  OPTIONAL: Contains WebSphere Application Server V6.0 Integrated Test  Environment.   Multilingual.
    File Name   C81CKML.bin
    File Size 384,736,660 bytes


  4. Manually Clean up the WTE/WAS version 6 installation (It might not be necessary to uninstall/reinstall RAD):
    • Uninstall WebSphere Application Server (WAS) version 6, if it is still installed.

      You can uninstall it by either of these methods:
      • Run the RAD uninstall GUI wizard at the command prompt or use Windows Explorer on the icon for uninstall.exe
        <install_dir>/rad_prod/_uninst/uninstall.exe

        . . .and uninstall only WAS V6 by ensuring that just the "IBM WebSphere Application Server V6.0 Integrated Test Environment" check box is checked.

        OR:
      • Use the WAS version 6 uninstall command directly if the RAD uninstall wizard has any problems.
        <at command prompt>:<install_dir>\runtimes\base_v6\_uninst\uninstall.exe
    • Edit the following files:
      • Open %USERPROFILE%\.WASRegistry with a text editor.
        If you find any line containing <install_dir>\runtimes\base_v6, delete it.

        Example: C:\Documents and Settings\Administrator\.WASRegistry

      • Open %WINDIR%\vpd.properties.
        If you find any lines starting with WSBAA60 and containing:
        <install_dir>\runtimes\base_v6, delete them.
        (For Windows 2000: WINDIR=C:\WINNT, for Windows XP: WINDIR=C:\WINDOWS)

    • Delete the following Windows registry key for WAS v6.0.x :

      Disclaimer

      This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986

      HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Application Server\6.0.0.0

      Note: From the Windows "Start" you would typically use: run regedit or enter: regedit on the command line. If uncertain about using regedit consult your Windows administrator or appropriate expert.

    • From
      %WINDIR%\IBM\RAT60\.sdpinst\cdi_ref.properties
      , remove the following line:
      was6_ref.products=xxx

    • Delete the base_v6 directory in which WAS v6.0 was installed:
      <install_dir>\runtimes\base_v6


  5. [re-install instructions]

    If the RAD version 6.0.x installation is otherwise well-behaved, try to re-install WTE version 6.

    This is a judgment decision local to your install and your use of RAD as it is now, that is, whether you can do most other things with it besides using the WTEversion 6.

    Go to step 6 if your decision is to do a complete uninstall/install of RAD v6.
    • Run the RAD installation Launcher GUI wizard from installation disk1 by choosing IBM Rational Application Developer V6.0 and then install only WAS version 6 by ensuring that only the "IBM WebSphere Application Server V6.0 Integrated Test Environment" box is checked.

      OR:
    • If there is any problem in using the RAD installation Launcher GUI, go to the section WTE v6 MANUAL INSTALL and try to reinstall WAS v6.0 from disk 4.

  6. If a complete uninstall/install of RAD v6.0 is necessary:
    1. Uninstall RAD version 6 using the Windows Add/Remove Programs feature from the Windows Control Panel, then delete the <RAD_Install_Directory>
      and possibly: %WINDIR%\IBM\RAT60 as per the next warning...

      Note: %WINDIR%\IBM\RAT60 affects all Rational Software Development Platform (RSDP) products sharing this common platform, such as Rational Software Modeler, Rational Functional Tester and Rational Performance Tester. If that is not an issue for you, it is suggested that you remove this directory. Consult the related technote: How to manually uninstall Rational Application Developer on Windows, if there are problems.
    2. Install RAD version 6 again.
    3. There should be a fully populated <RAD Install Directory>/runtimes/base_v6 created in the installation process. Test that the WAS version 6 server can be run:
      1. First, as stand-alone, such as <install_dir>\runtimes\base_v6\profiles\default\bin\startServer
        <at the command prompt>:
        <*!++!*><*!++!*>*!++!*><*!++!*>*!++!*><*!++!*>*!++!*> server1<*!++!*>/code> and
        <*!++!*>code><*!++!*><*!++!*>*!++!*><*!++!*>*!++!*>stopServer server1<*!++!*>/code>
      2. Then Start it from the Servers view of RAD version 6.


  7. [Optional] Apply any WAS server version 6.0.x provided update or RAD provided Rational Product Updater (RPU) WAS 6.0.x update again as required. If you have problems updating WTE/WAS version 6.0.x see the Related Information Item: Updating the WAS server instance in IBM RAD V6 fails

    Note: Update logs are kept in <*!++!*>code><*!++!*>RAD Install Dir>\runtimes\base_v6\logs\update\<*!++!*>/code>
    for example, for WAS 6.0.2 Refresh Pack and WAS 6.0.2.5 Fix Pack for Windows:
    <*!++!*>code>...\runtimes\base_v6\logs\update\6.0-WS-WAS-WinX32-RP0000002.install<*!++!*>/code>
    <*!++!*>code>...\runtimes\base_v6\logs\update\6.0.2-WS-WAS-WinX32-FP0000005.install<*!++!*>/code>

WTE v6 MANUAL INSTALL

If the process provided above does not work, here are the manual steps to install the WTE using only WebSphere components (and if this still fails, then it will be necessary to consult RAD support, which at this point would most likely involve WebSphere Support to help resolve the issue).

The RAD version 6.x WTE version 6.0 server install is a very thin layer on top of a true stand-alone WAS version 6.0 Base install. The main difference is that RAD disables the Windows Start menu, and it selects the optional features that need to be installed. To manually install:
  1. <*!++!*>at the command prompt>:
    cd <*!++!*>install_image>/disk4/external/was6

  2. <*!++!*>at the command prompt>:
    set DisableWASDesktopIntegration=false

    This environment variable disables the creation of Start menu shortcut for WAS version 6 in Windows.

  3. Remove the  <*!++!*><*!++!*>*!++!*>>/runtimes/base_v6 directory, where <*!++!*><*!++!*>*!++!*>> is the location where RAD is installed. Clean up the registry as described earlier in CHECK . . . Step 4. Manually Clean up. . . if you have not done so already, and stop any Java processes currently running that could interfere.

  4. Initiate the installation:
    • Using the GUI Installation wizard:

      <*!++!*>at the command prompt>:
      <*!++!*>code>install.exe -options "<*!++!*>install_image>\disk4\external\was6\rat_responsefile.txt"<*!++!*>/code> 

      [Note: on the command line do not use the option:
      -P wasProductBean.installLocation="<*!++!*><*!++!*>*!++!*>>/runtimes/base_v6"
      There is a problem in the WAS installer in reading this option properly in a GUI install.]

      Then in the GUI Install wizard:
      1. When prompted for the installation location, use:
        <*!++!*>code><*!++!*><*!++!*>*!++!*>>/runtimes/base_v6<*!++!*>/code>
        where <*!++!*><*!++!*>*!++!*>> is the location where RAD is installed.
      2. When prompted for features to install, select all the features except "Application Server Sample".
        The GUI Install, unlike the silent install, allows the user to directly see the install progress. If there is any problem related to the user's machine, it will be shown to the user.

        OR:
    • This can also be done as a silent installation:

      <*!++!*>at the command prompt>:
      install.exe -silent -options "<*!++!*>install_image>\disk4\external\was6\rat_responsefile.txt" -P  wasProductBean.installLocation="<*!++!*><*!++!*>*!++!*>>/runtimes/base_v6"
      Note: -silent must be placed before -options

  5. If the installation succeeds but RAD does not automatically recognize the WTE, then add this WebSphere instance as a run time, under the section Window > Preferences > Server > Installed Runtimes.

Note: in the overall installation of RAD on the latest Intel-based CPUs with the latest Microsoft Windows updates, be aware of Related Information item: License registration fails in RAD installation when Data Execution Protection (DEP) is enabled.

[{"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"6.0;6.0.0.1;6.0.1.0;6.0.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSYK2S","label":"Rational Software Architect Designer"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install \/ Migration","Platform":[{"code":"PF033","label":"Windows"}],"Version":"6.0;6.0.0.1;6.0.1.0;6.0.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
10 September 2020

UID

swg21209120

Page Feedback