Installing WebSphere Application Server V5.0 on AIX 5.3
 Technote (troubleshooting)
 
Problem(Abstract)
During an installation of IBM® WebSphere® Application Server V5.0 on AIX® 5.3, the prerequisite checker runs and the following message appears:

"Operating System Level Check: A supported operating system was not detected. Installation may not be successful."
 
Cause
The message appears because the WebSphere prerequisite checker does not recognize AIX 5.3 or later. It declares that AIX 5.3 is not supported, as AIX 5.3 was not available when the WebSphere Application Server V5.0 product was originally released.
 
Resolving the problem
The following solutions are possible to bypass the warning.


Recommended solution
Bypass the warning by clicking Next.

This message is a warning only. Check the WebSphere Application Server system requirements page for the latest status of supported operating systems. If the Web page or IBM service declares support for your operating system, click Next to continue the installation.

The following is a sample screenshot of the warning in the product installation wizard when the product is installed on AIX 5.3:





Alternate Solution
Alternatively, this problem can be avoided by using this solution instead of the preceding solutions proposed. In this case, the alternate solution is to bypass prerequisite checking completely by invoking the installer differently.

To suppress the warning page entirely, launch the installer using the following command.

install -W osLevelCheckActionBean.active=false -W osLevelCheckPanelBean.active=false


Another Alternate Solution
Alternatively, this problem can be avoided by using this solution instead of the preceding solutions proposed. Modify the prereqChecker.xml file to recognize AIX 5.3 as a supported operating system for WebSphere Application Server V5.0.

To do so, edit the file, install_root/waspc/prereqChecker.xml, before starting the installation.

Note: You must edit the file separately for the base, Network Deployment, and Enterprise editions of the product.
  1. Locate the following directory on the installation media:

    install_root/waspc

    Note: install_rootrefers to the source installation directory for the product.

  2. Copy the following files from the directory located in step 1 to a temporary directory:

    prereqChecker.xml
    prereqChecker.dtd

    Both prereqChecker.xml and prereqChecker.dtd must be present in the same directory to allow the installer to process the prerequisite checker data.

  3. Edit the temporary copy of the prereqChecker.xml file. Locate the section labeled with the osLevel tag for AIX 5.1.0.2 (An example is provided in step 4).

    Alternatively, you can use the prereqChecker.xml file attached to this technote and skip to step 6.

  4. Add an entry for AIX 5.3 after the end-osLevel tag for AIX 5.1.0.2, as shown in the following example. The bold text indicates the entry that should be inserted into the prereqChecker.xml file.

    <osPlatform type="aix">
    .
    .
    .
    <osLevel version="5.1.0.2" checkId="aix5002" category="osversion" displayName="AIX 5.1.0.2">
    .
    .
    .
    </osLevel>

    <osLevel version="5.3.0.0" checkId="aix5300" category="osversion" displayName="AIX 5.3.0.0">
    </osLevel>

    </osPlatform>

    Note: The preceding text might appear differently in a text editor due to formatting variations.

  5. Save the edited prereqChecker.xml file.

  6. Invoke the installation wizard from a command prompt, using the parameter provided in the following example:

    ./install -W osLevelCheckActionBean.configFilePath="/tmp/prereqChecker.xml"

    Note: The reference to /tmp in this example should be replaced with the full path to the appropriate directory containing prereqChecker.xml.

  7. The installation should proceed as normal. The installation wizard should recognize AIX 5.3 as a supported operating system. Normal installation procedures can be followed afterward.
 
prereqChecker.xml
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers WebSphere Application Server - Express Install and migration AIX 5.0 Express
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Install
Operating system(s): AIX
Software version: 5.0
Software edition:
Reference #: 1198418
IBM Group: Software Group
Modified date: Sep 22, 2005