Use of JVM debug mode with the IBM JVM 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.

IBM JVM Updates For DST

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/commEnv.sh in a text editor, and append the following line to the IBM section under $JAVA_VENDOR:

export JAVA_OPTIONS="$JAVA_OPTIONS -Djava.net.preferIPv4Stack=true"

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 buffer size for UDP_SENDSPACE is 9216 (9 KB), but WebLogic Server sends fragments up to 32 KB. As a result, use of a buffer size smaller than 32 KB may cause an I/O exception.

To prevent such I/O exceptions:

Set the buffer size to 32 KB:

no -o udp_sendspace=32768

Reboot WebLogic Server.

JVM Debug Mode Impact

Use of JVM debug mode with the IBM JVM significantly degrades application performance and debugging effectiveness. 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.

To disable JVM debug mode:

Go to the target domain directory.

In the setDomainEnv.sh file, find the first occurrence of debugFlag=true.

Change it to: debugFlag=false.

If you are going to use QuickStart, repeat steps 2 and 3 in the setDomainEnvQS.sh file.

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

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

Once you have completed these procedures, you must also download and install the SDK/Database Patch. See the note at the end of this section.

Note: If you plan to use the WebLogic Integration sample DBMS adapter for DB2, you may want to install an additional patch. For more information, or to obtain the patch, contact BEA Customer Support and specify the patch for CR134068.

For caveats about using this version of WebLogic Platform on an AIX configuration, see Known Issues.

Step 1: Download and Install Operating System Patch

To download and install operating patch IY46667, complete the following steps:

Following the instructions and/or prompts displayed on the screen, make the appropriate selections to have IY46667 downloaded and installed on your system.

Step 2: Download and Install the IBM SDK

To run WebLogic Platform 8.1 SP2 on an IBM AIX 5.1 configuration, your environment must include IBM SDK 1.4.1 32-bit PTF: ca1411-20030930. This SDK is not delivered with WebLogic Platform; you must download and install it manually before installing 8.1 SP2.

Note: You cannot use an older version of the IBM SDK, even if one is already installed on your system. You must download and install IBM SDK 1.4.1 32-bit PTF with the following APARs: IY43555, IY46206, IY47536, and IY48525.