Skip navigation.

8.1 Supported Configurations: IBM AIX 5.1 on pSeries

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

IBM AIX 5.1 on pSeries with 8.1 SP4

Provides full support for WebLogic Server and run-time support for WebLogic Workshop, WebLogic Integration, and WebLogic Portal. See below for Design and Development Tools support.


This section provides the following information:

Related Information


Configuration Requirements

Table 3-1 Requirements for 8.1 SP4 on IBM AIX 5.1 on pSeries 

Operating System Version and Patches

AIX 5L v5.1-ML6 and higher MLs

Chip Architecture and Minimum Processor Speed

  • POWER3 (450 MHz)

  • POWER4 (1.1 GHz)

  • POWER5 (1.5 GHz)


  • 1.4.2 GA—IBM SDK 1.4.2 32-bit JavaTM 2 Runtime Environment, Standard Edition (build 1.4.2) Classic VM (build 1.4.2, J2RE 1.4.2 IBM AIX build ca1420-20040626 (JIT enabled: jitc))

  • 1.4.2 SR2—IBM SDK 1.4.2 32-bit JavaTM 2 Runtime Environment, Standard Edition (build 1.4.2) Classic VM (build 1.4.2, J2RE 1.4.2 IBM AIX build ca142-20050609 (JIT enabled: jitc))

  • If you are installing WebLogic Platform 8.1 SP4 on your IBM AIX configuration for the first time, we recommend that you install the 1.4.2 SR2 SDK.

  • If you already have WebLogic Platform 8.1 SP4 installed with the 1.4.2 GA version, the 1.4.2 SR2 SDK is optional.

  • The IBM SDKs are not delivered with WebLogic Platform; you must download them from the IBM Web site and install them, manually, before installing WebLogic Platform. For instructions, see Download and Installation Instructions.

  • Use of JVM debug mode with IBM JVMs significantly degrades application performance and debugging effectiveness. The JVM debug mode is enabled by default on WebLogic Platform; BEA strongly recommends that you manually disable it when running WebLogic Platform on AIX. For instructions, see JVM Debug Mode Impact.

Design and Development Tools

The WebLogic Workshop IDE and WebLogic Integration Format Builder are not supported on IBM AIX systems. IBM AIX is supported for the production deployment of applications developed in the WebLogic Workshop IDE. Debugging of applications developed in the WebLogic Workshop IDE, for deployment on AIX, should be accomplished to the extent possible on the Workshop development system; use of JVM debug mode with the IBM JVM significantly degrades application performance and debugging effectiveness. IBM AIX is also supported for the development and production deployment of WebLogic Server applications developed with other tools.


512 MB required; 1 GB recommended

Performance Pack



Node Manager



BEA jDrivers for Oracle

For this Oracle client version:

The following shared libraries are provided:

Oracle 8.1.7

  • lib/aix/oci817_8/

  • lib/aix/oci817_8/

Oracle 9.2.0

  • lib/aix/oci920_8/

  • lib/aix/oci920_8/



Known Issues

This section provides workarounds for the following problems:

For more information about known issues with this release, see the Release Notes for WebLogic Platform 8.1 or the appropriate product component of WebLogic Platform. For a list of available Release Notes documents, see:

IBM JVM Updates For DST

IBM has released a Timezone Update Utility to update DST data without the need to upgrade Java. See IBM Time Zone Update Utility for JavaTM.

WebLogic Server Clustering Limitation

If you want to support WebLogic Server clustering on an AIX 5.1 configuration, open the file $BEA_HOME/weblogic81/common/bin/ in a text editor, and append the following line to the IBM section under $JAVA_VENDOR:


IIOP Thin Client Not Supported

The IIOP thin client is not supported on AIX due to dependencies on the JVM. Only thin-client applications are affected by this issue.

To work around this issue, run WebLogic Server on AIX and your thin client on another operating system.

Insufficient Buffer Size for UDP_SENDSPACE

The default size of the buffer for UDP_SENDSPACE is 9216 (9 KB), but WebLogic Server sends fragments, up to 32 KB in size, to UDP_SENDSPACE. As a result, use of a buffer size smaller than 32 KB may cause an I/O exception.

To prevent such I/O exceptions:

  1. Set the buffer size to 32 KB:
  2. no -o udp_sendspace=32768

  3. Reboot WebLogic Server.

GUI-based Installation Fails Due to FileSystemPreferences

If your system does not include a directory called /etc/.java, GUI-mode installation fails with one of the following error messages:

To work around this problem, implement one of the following steps:

Oracle 8.1.7 jDriver Not Supported on AIX 64-bit Kernel

The jDriver for Oracle is supported on the AIX 32-bit kernel, but it is not supported on the AIX 64-bit kernel. For a list of AIX versions on which Oracle is supported, see the Oracle support site:

JVM Debug Mode Impact

Use of the JVM debug mode with the IBM JVM significantly degrades application performance. Therefore, whenever you run WebLogic Platform on an AIX configuration, BEA strongly recommends that you disable the JVM debug mode (which, by default, is enabled by WebLogic Platform). Disabling debug mode is recommended for all domains, both existing ones and domains created using the Configuration Wizard.

If you would still like to enable JVM debug mode, see How to Enable JVM Debug Mode for the procedure.

How to Disable JVM Debug Mode

To disable JVM debug mode, you have a choice of two methods, which are described in the following sections.

Method 1

  1. Go to the target domain directory.
  2. In the file, find the first occurrence of debugFlag=true.
  3. Change it to: debugFlag=false.
  4. If you are going to use QuickStart, repeat steps 2 and 3 in the file.

Note: If you are going to perform this procedure, you must do so before launching QuickStart.

Method 2

Pass the 'nodebug' command-line argument to the server startup script. For example:

$ ./ nodebug

How to Enable JVM Debug Mode

Note: Enabling debug mode is not recommended because this mode affects server performance.

  1. In a text editor, open the script and comment the following line:
  2. JAVA_OPTIONS="${JAVA_OPTIONS} -ea -da:com.bea... -da:javelin ... -da:weblogic ..."
  3. Save your changes. Then start (or restart) the WebLogic domain.

JAXP Incompatibility Causes Portability Issues with WebLogic Server 8.1 SP4

Note: This limitation is reported, in CR135846, in the "Known Limitations" section of the WebLogic Platform 8.1 Release Notes.

Because the Xalan transformer shipped with the IBM SDK 1.4.2 is JAXP 1.2-compliant, but WebLogic Server only supports applications based on JAXP 1.1, you must set the Transformer Factory to weblogic.apache.xalan.processor.TransformerFactoryImpl.

To set the XML Transformer and Parser Factories, you have a choice of three methods:

A procedure for each method is provided in the following sections.

Method 1: Edit

  1. In a text editor, open the script.
  2. Append the following values to JAVA_OPTIONS: "-Djavax.xml.transform.TransformerFactory=weblogic.apache.xalan.processor.TransformerFactoryImpl

Method 2: Uncomment JAXP Properties Lines for JAXP 1.1 Parser and Transformer Factories

  1. Copy the $JAVA_HOME/jre/lib/ file to $JAVA_HOME/jre/lib/
  2. Uncomment the last three lines so that they point to JAXP 1.1 parser and transformer factories. The JAXP 1.1 parser and transformer factories provided by WebLogic Platform are:

Method 3: Create the XML Registry

For more information, see: 

Upgrade to WebLogic Platform 8.1 SP4 Requires Library Cleanup

Before you can upgrade your WebLogic Platform system from a pre-8.1 SP4 version to 8.1 SP4 on AIX, you must clean out any unused libraries manually. If you have not done such a cleanup before trying to upgrade your system, the upgrade installation may fail with the following message:

Fatal error. Cannot move which is in use.

To perform a proper memory cleanup, log on as root and run slibclean, an AIX utility. Then re-start the upgrade procedure. (It is not necessary to re-boot your machine after running slibclean.)


Download and Installation Instructions

Complete the following procedures:

Downloading and Installing the IBM SDK 1.4.2

Complete the following procedure to download and install the IBM SDK 1.4.2 on IBM AIX (32-bit) build ca142-20050929a (SR3):

  1. Go to the IBM download site:

  3. Download the IBM SDK 1.4.2 (GA version).
  4. Install the IBM SDK 1.4.2 on your system.

For caveats about using WebLogic Platform 8.1 SP5 on an IBM AIX 5.2 configuration, see Known Issues.

Downloading and Installing IBM SDK 1.4.2 SR2

Note: This SDK patch is optional for existing applications based on IBM SDK 1.4.2 GA.

Complete the following procedure to download and install IBM SDK 142sr2 (IY72469) on AIX:

  1. Check whether the GA version of the IBM SDK 1.4.2 for AIX is installed on your system:
  2. Go to the following IBM download site:

    Set the search criteria to the following:

  4. Following the instructions displayed on the screen, make the selections necessary to download and install the specified APAR.
  5. To verify that the required SDK fix is now installed on your system, run the following command:
  6. /usr/java14/bin/java -version

    Make sure the following output is displayed:

    java version "1.4.2"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2)
    Classic VM (build 1.4.2, J2RE 1.4.2 IBM AIX build ca142-20050609
    (JIT enabled: jitc))

Downloading and Installing WebLogic Platform 8.1 SP4

To install WebLogic Platform 8.1 SP4 on an IBM AIX 5.1 configuration:

  1. Go to the BEA download site:
  3. Download the WebLogic Platform package installer for IBM AIX 5.1.
  4. Install WebLogic Platform 8.1 SP4 for IBM AIX 5.1 using the instructions provided for .jar installation files, as described in Installing WebLogic Platform. For example, if you
  5. are installing in console mode, enter the following on the command line:

    $ java -jar pj_platform814_generic.jar -mode=console

    For detailed instructions, see "Starting Console-Mode Installation on UNIX Systems" in Installing BEA WebLogic Platform:

    Note: When using an Asian version of an installer (such as an installer for Japanese, Korean, or Simplified Chinese), you need to increase the maximum heap size to 256 MB by specifying the -Xmx256m argument on the command line. For example, if you are using a Japanese installer, enter the following command:
    $ java -Xmx256m -jar pj_platform814_ja_generic.jar -mode=console

For more information, see Installing BEA WebLogic Platform.

Downloading and Installing the WebLogic Platform 8.1 SP4 AIX Patch

On an AIX 5.1 system, WebLogic Platform 8.1 SP4 requires a patch, which is delivered in This zip file contains two files:

To obtain the patch and instructions, complete the following procedure:

  1. Go to the BEA download site:
  3. From the OS Platform menu, select AIX 5.1 and download the installer.
  4. When prompted, select and download, the supplemental JAR file.
  5. Unzip the contents of the supplemental JAR file to a temporary location, such as <your_home>/temp.
  6. Complete the instructions in 81sp4-CR209405-patch-README.txt.


Skip navigation bar  Back to Top Previous Next