Here is a list of things to CHECK first and then re-install 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 v6 server failed after an initial successful install of RAD v6 and WTE v6.
CHECK [ and re-install ]
- Check for any space constraints - especially if you tried installing before. Check the disk space available as per the provided install instructions.
- On Microsoft® Windows® 2000 or 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.
- 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). Log files can be checked for a successful installation:
{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_crreate_default.log
Check for INSTCONFSUCCESS messages at end of file(s) for successful installation.
It is possible that the install image could be corrupted. For example, the disk 4 WTE version 6 install 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
- Manually Clean up the WTE/WAS v6 install before retrying (It might not be necessary to uninstall/reinstall RAD itself):
- Uninstall WebSphere Application Server (WAS) version 6, if it is still installed. It can be uninstalled by running :
- the RAD uninstall GUI wizard at the command prompt or using Windows Explorer on the icon for uninstall.exe:
<install_dir>/rad_prod/_uninst/uninstall.exe
and uninstall only WAS V6 by insuring that only the IBM WebSphere Application Server V6.0 Integrated Test Environment checkbox is checked.
OR . . .
- Use the WAS v6 uninstall command directly if the RAD uninstall wizard has any problems.
<at the 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 Windows2000: WINDIR=C:\WINNT , Windows XP : WINDIR=C:\WINDOWS)
- Delete the following registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Application Server
- Remove the following line from %WINDIR%\IBM\RAT60\.sdpinst\cdi_ref.properties:
was6_ref.products=xxx
- [ re-install instructions]
If the RAD v6.0.x install is otherwise well-behaved, try to just re-install WTE v6. This is a judgement 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 WTEv6. (Go to step 6 if your decision is to do a complete uninstall/install of RAD v6.)
- Run the RAD install Launcher GUI Wizard from install disk1 by choosing IBM Rational Application Developer V6.0 and then install only WAS v6 by insuring that only IBM WebSphere Application Server V6.0 Integrated Test Environment box is checked.
OR . . .
- If there is any problem in using the RAD install Launcher GUI, go to the section WTE v6 MANUAL INSTALL and try to re-install WAS v6.0 from disk 4.
- If a complete uninstall/install of RAD v6.0 is necessary:
- Uninstall RAD version 6 using the Windows provided Add/Remove Programs from the Windows Control Panel, then delete the: {RAD Install Directory} and possibly: %WINDIR%\IBM\RAT60
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, it is suggested that this directory be removed. Consult the related technote: How to manually un-install Rational Application Developer on Windows , if there are problems.
- Install RAD v6 again.
- There should be a fully populated { RAD Install Directory}/runtimes/base_v6 created in the installation process. Test that the WAS v6 server can be run:
- first standalone e.g.
<at the command prompt> :
<install_dir>\runtimes\base_v6\profiles\default\bin\startServer server1
<install_dir>\runtimes\base_v6\profiles\default\bin\stopServer server1
- then Start it from the Servers view of RAD V6.
- [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 {RAD Install Dir}\runtimes\base_v6\logs\update\
e.g. for WAS 6.0.2 Refresh Pack and WAS 6.0.2.5 Fix Pack for Windows:
...\runtimes\base_v6\logs\update\6.0-WS-WAS-WinX32-RP0000002.install
...\runtimes\base_v6\logs\update\6.0.2-WS-WAS-WinX32-FP0000005.install
WTE v6 MANUAL INSTALL
If the process 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 v6 WTE v6 server install is a very thin layer on top of a true stand-alone WAS v6 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:
- <at the command prompt>
cd <install_image>/disk4/external/was6
- <at the command prompt>
set DisableWASDesktopIntegration=false ,
This environment variable disables the creation of Start Menu shortcut for WAS v6 in Windows.
- Remove the <install_dir>/runtimes/base_v6 directory, where <install_dir> 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.
- Initiate the install:
- Using the GUI Install wizard :
<at the command prompt>:
install.exe -options "<install_image>\disk4\external\was6\rat_responsefile.txt"
[Note: on the command line do not use the option:
-P wasProductBean.installLocation="<install_dir>/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:
- When prompted for the install location, use:
<install_dir>/runtimes/base_v6
where <install_dir> is the location where RAD is installed.
- 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 user's machine, it will be shown to the user.
OR
- This can also be done as a silent install:
<at the command prompt>:
install.exe -silent -options "<install_image>\disk4\external\was6\rat_responsefile.txt" -P wasProductBean.installLocation="<install_dir>/runtimes/base_v6"
Note:-silentmust be placed before-options
- If the install succeeds but RAD does not automatically recognize the WTE, then add this WebSphere instance as a runtime, under the section Window > Preferences > Server > Installed Runtimes.
|