8.1 Supported Configurations: IBM AIX 5.1 on pSeries
IBM AIX 5.1 on pSeries with WebLogic Platform 8.1
Note: WebLogic Platform 8.1 includes WebLogic Server 8.1 Service Pack 1 (SP1).
This section provides the following information:
Table 6-1 Requirements for WebLogic Platform 8.1 on IBM AIX 5.1 on pSeries
Operating System Version and Patches
AIX 5L V5.1-ML4 with Recommended Maintenance Package AIX 5100-04; APAR IY39794 and any later compatible level
Chip Architecture and Minimum Processor Speed
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.
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
BEA jDrivers for Oracle
For this Oracle client version:
The following shared libraries are provided:
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:
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/commEnv.sh in a text editor, and append the following line to the IBM section under
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 [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
- Set the buffer size to 32 KB:
no -o udp_sendspace=32768
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
startWebLogic.sh file, find the first occurrence of
- Change it to:
- If you are going to use QuickStart, repeat steps 2 and 3 in the
Note: If you are going to perform this procedure, you must do so before launching QuickStart.
JAXP Incompatibility Causes Problems with Using SDK Built-in XML Parsers on WebLogic Platform 8.1 GA
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 126.96.36.199 is based on JAXP 1.2. This incompatibility causes problems with using the JDK built-in XML parsers.
To compensate for this incompatibility:
- Open the following file in a text editor:
- Append the following line:
export IBM_JAVA_OPTIONS="$IBM_JAVA_OPTIONS -D
Database Cannot Be Loaded on AIX
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.
Before you begin . . .
- On your AIX system, open the Configuration Wizard.
- Select the Create a new WebLogic configuration option.
- Configure your new domain by completing all the necessary steps except one: do not load the database.
When the "Test JDBC Connection Pools and Setup JDBC Database" window is displayed, proceed to the next window without clicking Load Database.
Now load your database by completing the following steps:
- On an operating system other than AIX, open the Configuration Wizard.
- Select the Create a new WebLogic configuration option. The Select a Configuration Template window is displayed.
- Select the same template you used to create a new domain on your AIX system. Click Next. The Choose Express or Custom Configuration window is displayed.
- Select Custom and click Next. The Configure the Administration Server window is displayed.
- Click Next. The Managed Servers, Clusters, and Machines Options window is displayed.
- Select No and click Next. The Database (JDBC) Options window is displayed.
- Select Yes and click Next. The Configure JDBC Connection Pools window is displayed.
- For each connection pool listed, enter the information about your database.
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.
- Click Next. The Configure JDBC Data Sources window is displayed.
- Click Next. The Test JDBC Connection Pools and Setup JDBC Database window is displayed.
- For each connection pool:
- Test the connection for the pool.
- Select a database from the drop-down menu in the DB Version field.
When all the desired databases are loaded, click Exit.
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.
Problem in getClass.getResourceAsStream()
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.
Running xbean.jar with the JIT Enabled May Cause Problem
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:
Download and Installation Instructions
This section provides instructions for the following tasks:
Downloading and Installing the IBM SDK
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:
- Go to the following IBM download site:
- Set the search criteria to the following:
- OS level: From the drop-down list, select the appropriate OS level.
- Search by: APAR number or abstract
- Search string: IY43555
Following the instructions and/or prompts displayed on the screen, make the selections required for your configuration and proceed to the next step.
When a list of filesets is displayed, download and install the following filesets:
Repeat steps 1-3 with the following changes:
- In step 2, specify the following value for Search string: IY46206.
- In step 3, download and install one fileset:
Repeat steps 1-3 with the following changes:
- In step 2, specify the following value for Search string: IY47536.
- In step 3, download and install one fileset:
After all packages are installed, verify that all of them are also applied. To do so, run the following commands:
$ instfix -ivqk IY43555
$ instfix -ivqk IY46206
$ instfix -ivqk IY47536
To verify that the required SDK fixes are now installed on your system, run the following command:
Make sure that the output contains the following string:
IBM AIX build ca141-20030703a
Downloading and Installing WebLogic Platform 8.1
Complete the following procedure:
- AIX-specific installer for BEA WebLogic Platform 8.1
- Supplemental JAR file for 8.1:
Note: For details, see Installing BEA WebLogic Platform at the following URL:
aix_supplement.jar file as
weblogic_knex_patch.jar, and save the file in
$BEA_HOME/weblogic81/server/lib and run the
ln command to create a link to the
weblogic_knex_patch.jar file. The link must be called
weblogic_sp.jar. For example:
ln weblogic_knex_patch.jar weblogic_sp.jar
CLASSPATH definition, specify the
aix_supplement.jar file before the