8.1 Supported Configurations: IBM AIX 5.1 on pSeries
Note: WebLogic Platform 8.1 includes WebLogic Server 8.1 Service Pack 1 (SP1).
This section provides the following information:
http://www.ibm.com
.
AIX 5L V5.1-ML4 with Recommended Maintenance Package AIX 5100-04; APAR IY39794 and any later compatible level |
||
IBM SDK 1.4.1 32-bit (IY47536) JavaTM 2 Runtime Environment, Standard Edition (build 1.4.1) Classic VM (build 1.4.1, J2RE 1.4.1 IBM AIX build ca141-20030703a (JIT enabled: jitc)) |
Download the IBM SDK from the IBM Web site and install it, manually, before installing WebLogic Platform. For instructions, see Download and Installation Instructions. 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. |
|
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. |
||
This section provides workarounds for the following problems:
For more information about known issues with any components of this release, see the appropriate Release Notes document. For a complete list of Release Notes supporting WebLogic Platform 8.1, see:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/interm/relnotes.html
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.
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"
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.
The default buffer size for UDP_SENDSPACE
is 9216 (9 KB), but WebLogic Server sends fragments up to 32 KB [to UDP_SENDSPACE]
. As a result, use of a buffer smaller than 32 KB may cause an I/O exception.
To prevent I/O exceptions due to insufficient space in the UDP_SENDSPACE
buffer:
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.
Note: This limitation is reported, in CR112245, in the "Known Limitations" section of the WebLogic Platform 8.1 Release Notes.
WebLogic Platform 8.1 is based on JAXP 1.1, and IBM SDK 1.4.1.2 is based on JAXP 1.2. This incompatibility causes problems with using the JDK built-in XML parsers.
To compensate for this incompatibility:
export IBM_JAVA_OPTIONS="$IBM_JAVA_OPTIONS -D
javax.xml.parsers.SAXParser
Factory=weblogic.xml.jaxp.RegistrySAXParserFactory
-Djavax.xml.parsers.Document
BuilderFactory=weblogic.xml.jaxp.RegistryDocumentBuilderFactory -Djavax.xml.
transform.TransformerFactory=weblogic.xml.jaxp.RegistrySAXTransformerFactory"
Note: This limitation is reported, in CR112867, in "Problems Fixed in Service Pack 2" in the WebLogic Platform 8.1 Release Notes.
Using the Configuration Wizard on an AIX platform, you can perform all but one of the steps necessary to configure a domain. The exception is the task of loading the database. This task must be performed on an operating system other than AIX. The remainder of this section provides instructions for doing so.
Note: The alternative procedure for loading the database must be performed for any template in which WebLogic Portal and/or WebLogic Integration functionality is included. If you are using a custom template, this procedure is necessary only if your template includes a script that initializes the database. Keep in mind that a template may not provide all the connection pools required for your domain or application.
Now load your database by completing the following steps:
Note: If multiple connection pools reference the same database, perform this step for only one of them.
After you finish configuring all connection pools, click Next. The Configure JDBC MultiPools window is displayed.
Now all your databases are loaded. You can return to the domain that you created initially, on your AIX system, and start running it with the fully populated databases.
A problem in getClass.getResourceAsStream()
, IBM PMR 16136,004, prevents installation of some examples and turns off the execution bit for all run scripts upon completion of the installation.
To avoid these limitations, download and apply the vendor fix APAR IY46206.
Sometimes the JVM crashes when the xbean.jar
is run while the JIT is enabled (IBM PMR 19060,004).
To work around this issue, run either of the following commands:
-Dcom.ibm.jit.compileopt=NQCOMMONING_COSTBENEFIT
-Dcom.ibm.jit.compileopt=NQCOMMONING_COSTBENEFIT{com/bea/xbean/common/XmlWhitespace}{collapse}
This section provides instructions for the following tasks:
Before you can run WebLogic Platform 8.1 on IBM AIX, you must have an SDK at the following level: IBM SDK 1.4.1 32-bit PTF: ca141-20030703a. Because this SDK is not delivered with WebLogic Platform, you must download and install it manually before installing WebLogic Platform.
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 APAR IY43555, APAR IY46206, and APAR IY47536.
To download IBM SDK 1.4.1 32-bit PTF: ca141-20030703a, complete the following procedure:
Following the instructions and/or prompts displayed on the screen, make the selections required for your configuration and proceed to the next step.
Java14.sdk.1.4.1.1
.Complete the following procedure:
http://commerce.bea.com
), download:aix_supplement.jar
Note: For details, see Installing BEA WebLogic Platform at the following URL:http://download.oracle.com/docs/cd/E13196_01/platform/docs81/install/index.html
aix_supplement.jar
file as weblogic_knex_patch.jar
, and save the file in $BEA_HOME/weblogic81/server/lib
.