Supported Configurations: IBM AIX

WebLogic Platform 9.2 and AquaLogic Service Bus on IBM AIX 5.3 pSeries

This section provides the following information:

• Related Information
• Configuration Requirements
• Known Issues
• Download and Installation Instructions
• Download and Apply Patches

Related Information

• For information about supported database configurations, Web servers, browsers, interoperability tools, and product support, see:
• AquaLogic Service Bus 2.5 Supported Configurations
• AquaLogic Service Bus 2.6 Supported Configurations
• Supported Configurations for WebLogic Platform 9.2
• For information about IBM AIX 5.3, visit IBM's Web site: http://www.ibm.com.
• For information about known issues with the Azul Virtual Machine, see http://www.azulsystems.com

Configuration Requirements

The following section provides requirements for BEA products supported on this configuration:

Known Issues

• IBM JVM Updates For DST
• WebLogic Server Known Issues
• Known Issues When Using the Azul Virtual Machine
• AquaLogic Service Bus 2.5 Known Issues
• WebLogic Portal 9.2 Known Issues
• Known Issues for Other BEA Products

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 Java^TM.

WebLogic Server Known Issues

The following sections provide information on known issues in WebLogic Server 9.2 on AIX:

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.

Workaround: Run WebLogic Server on AIX and your thin client on another operating system.

Serial Version UID Mismatch

A serial version UID mismatch is encountered when using WLS 9.2 with IBM Java 5 SR2.

Workaround: To be compatible with the serialization of previously compiled applications, modify the <BEA_HOME>/Weblogic92/common/bin/commEnv.sh file to include the following command:

JAVA_OPTIONS="$JAVA_OPTIONS  -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"

Alternatively, you can use the command line option:

export IBM_JAVA_OPTIONS="-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0" 

Note: If you intend to deploy new applications with previously compiled applications, they must be recompiled as necessary to have the same Serial Version UID.

AspectJClassLoader Not Supported

The weblogic.aspects.AspectJClassLoader is not supported on AIX using IBM Java 5.

Workaround: You are advised not to use this class loader.

JVM Debug Mode Impact

Using the JVM debug mode with the IBM JVM significantly degrades application performance. Therefore, whenever you run WebLogic Portal on an AIX configuration, BEA strongly recommends that you disable the JVM debug mode (default setting for WebLogic Platform). Disabling debug mode is recommended for all domains, including existing domains and those domains created using the Configuration Wizard.

To disable JVM debug mode, do one of the following:

• In the bin directory under the target domain directory, use a text editor to open the setDomainEnv.sh file. Search for the first occurrence of debugFlag=true and replace it with debugFlag=false.
• Pass the nodebug command-line argument to the server startup script. For example: $ ./startWebLogic.sh nodebug

Upgrade from WebLogic Server 8.1 to WebLogic Server 9.2

The WebLogic Server upgrade from WebLogic Server 8.1 to WebLogic Server 9.2 does not work properly on AIX platforms.

Workaround: Download and install the following WebLogic Server patch for AIX using the BEA Smart Update tool:

Patch ID: PM8M Pass Code: 3LLZUETZ

For more information on the BEA Smart Update tool, refer to http://download.oracle.com/docs/cd/E13179_01/common/docs92/smart_update/intro.html

After applying the upgrade patch on AIX, follow the workaround for Serial Version UID Mismatch. For example,

export IBM_JAVA_OPTIONS="-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0" 

Alternatively, you can pass -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 to the "java" command while upgrading.

To verify that the upgrade is successful, following the steps described in http://download.oracle.com/docs/cd/E13179_01/common/docs92/upgrade/.

Known Issues When Using the Azul Virtual Machine

A serial version UID mismatch is encountered when using WLS 9.2

Workaround: Create a Master Azul arguments file azul.java.vminitargs.post in Azul's JAVA_HOME if its not present and include:

 -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0

AquaLogic Service Bus 2.5 Known Issues

The following sections provide information on known issues in AquaLogic Service Bus 2.5 on AIX:

Cannot Import/Export AquaLogic Service Bus Configuration Data JAR file (with Password-based encrypted Resources) Between IBM JVM and other JVMs such as Sun or Jrockit

There are differences in the various JDK implementations of the Password-Based Encryption algorithms used by AquaLogic Service Bus to protect resources that include sensitive data. These differences cause import to fail when an encrypted resource created with the Sun or JRockit JDK is imported into the IBM JDK or vice versa.

For information about the encryption algorithms, see http://java.sun.com/j2se/1.5.0/docs/guide/security/jce/JCERefGuide.html#PBE.

There is no problem in exporting and importing encrypted resources with the same JDK.

Workaround: Export the resources without a pass-phrase by deselecting the Protect Sensitive Data flag when moving configuration JARs across different JDKs.

Caution: This resources file may contain passwords that are in the clear text.

WebLogic Portal 9.2 Known Issues

The following sections provide information on known issues in WebLogic Portal 9.2 on AIX:

DB2 Considerations

To ensure that portal applications run correctly on DB2, you must set some minimum configuration parameters. If you do not, heavy portal activity may exceed database capacity.

Use the following settings as guidelines to configure your DB2 database:

• Dynamic Sections: 20,000
• applheapsz: 24,000
• pckcachesz: 2,500
• stmt heapsize: 12000

For additional information, see Configuring DB2 Databases in the BEA WebLogic Portal 9.2 Database Administration Guide.

compoze API Patch Issue for Non-J2ee Clients

Non-J2EE clients using the compoze API must complete the following after applying the WLP patches located at Download and Apply Patches:

Apply the patch to WL_HOME/portal/lib/content_collab.jar archive by extracting the APP-INF/classes/com/compoze/collab/beacm/impl/CmMailSession*.class from WL_HOME/portal/lib/modules/maintenance/default/wlp-collab-api-app-lib.ear and update the classes com/compoze/collab/beacm/impl/CmMailSession*.class (CmMailSession.class and CmMailSession$1.class) in WL_HOME/portal/lib/content_collab.jar with the extracted files.

Known Issues for Other BEA Products

For more information about known issues with BEA products supported on this configuration, including available workarounds, see the appropriate Release Notes document.

Download and Installation Instructions

Complete the following procedures:

Downloading and Installing IBM Java 5
Download and install the IBM SDK for your environment:

• Downloading and Installing IBM SDK Java 5 with Service Refresh
• Download and Install IBM SDK Java 5 with Service Refresh 6B + IZ08455

Depending on your requirements:
Downloading and Installing WebLogic Server 9.2 Maintenance Packs on IBM AIX
Downloading and Installing the AquaLogic Service Bus Package Installer
Downloading and Installing the AquaLogic Service Bus Package Installer
Downloading and Installing the WebLogic Portal 9.2 (Including MP1/MP2) on IBM AIX
Downloading and Installing the WebLogic Portal 9.2 MP3 on IBM AIX
Downloading and Installing the WebLogic Integration 9.2 (Including MP1/MP2) on IBM AIX
Downloading and Installing the WebLogic Integration 9.2 MP3 on IBM AIX
Download and Apply Patches

Downloading and Installing IBM Java 5

Complete the following procedure to download and install IBM Java 5.

Go to the IBM AIX download site:

http://www.ibm.com/developerworks/java/jdk/aix/service.html

Download the IBM Java 5 32-bit (GA version) or 64-bit (GA version).
Install the IBM Java 5 on your system.

Downloading and Installing IBM SDK Java 5 with Service Refresh

Complete the following procedure to download and install IBM SDK Java 5 with Service Refresh.

Go to the IBM Support: Fix Center download site at the following URL:

http://www.ibm.com/developerworks/java/jdk/aix/service.html

Click the Fix Info link for your JDK version:
Select your APAR/SR number from the table and follow the instructions and/or prompts displayed on the screen to download and install the fix package on your system.

For SR2, use IY83355

For SR3, use IY90224

For SR4, use IY94334

For SR5a (32-bit), use IZ02874

For SR5a (64-bit), use IZ02875

For SR9 (32-bit), use IZ39401

For SR10 (32-bit) use IZ55273

For SR10 (64-bit) use IZ55274

For SR11 (32-bit) use IZ64936

For SR11 (64-bit) use IZ64937

Set the JAVA_HOME environment variable to the directory in which IBM Java5 is installed, and export JAVA_HOME. For example:

export JAVA_HOME=/usr/java5

Set the PATH variable to include $JAVA_HOME/bin. For example:

export PATH=$JAVA_HOME/bin:$PATH

Download and Install IBM SDK Java 5 with Service Refresh 6B + IZ08455

Complete the following procedure to download and install IBM SDK Java 5 with Service Refresh SR6B + IZ08455.

Go to the IBM site:

https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?lang=en_US&source=swg-ibmjavaisv

Register for a valid IBM ID if necessary.
Click on Sign In button.
Login using your IBM ID and password.
Enter the Access Key ZDGEEQQCJQ
Click Submit.
Select the IBM SDK for AIX your environment:

• 32-bit iSeries / pSeries
• 64-bit iSeries / pSeries

Click I Confirm.
Set the JAVA_HOME environment variable to the directory in which IBM Java5 is installed, and export JAVA_HOME. For example:

export JAVA_HOME=/usr/java5

Set the PATH variable to include $JAVA_HOME/bin. For example:

export PATH=$JAVA_HOME/bin:$PATH

Downloading and Installing WebLogic Server 9.2 Maintenance Packs on IBM AIX

Complete the following procedure to install WebLogic Server on AIX:

Go to Oracle E-Delivery and use the following information to download WebLogic Server 9.2 Maintenance Packs:
Select Product Pack "Oracle BEA".
Select the operating system.
Select the appropriate media pack for the BEA WebLogic product that you want to download. For example, if you want to download WebLogic Server for Microsoft Windows (32-bit), select the media pack "BEA WebLogic Media Pack for Microsoft Windows (32-bit)".
Select the part number for the WebLogic Server 9.2 Maintenance Pack and download the zip file. For example, select the part number corresponding to the description "WebLogic Server 9.2 MP4 for Microsoft Windows (32-bit)" and download the zip file.
Extract files from the downloaded zip file.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Install WebLogic Server using the instructions in http://download.oracle.com/docs/cd/E13179_01/common/docs92/install/start.html. This section describes the process of installing .jar files in the Graphical mode.

For more information on installing WebLogic Server, refer to the Installation Guide: http://download.oracle.com/docs/cd/E13179_01/common/docs92/install/index.html.

If your configuration includes the 32-bit JDK, your installation of WebLogic Server is now complete. If your configuration includes the 64-bit JDK, however, you must also complete the following steps:

Set the BEA_HOME to point to the directory in which WebLogic Server is installed and export BEA_HOME. For example:

   export BEA_HOME=<your_WebLogic_Server_installation_directory>

In a text editor, open the $BEA_HOME/weblogic92/common/bin/commEnv.sh and search for the following case statement:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Replace with the following:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc64

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc64

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Downloading and Installing the AquaLogic Service Bus Package Installer

To install AquaLogic Service Bus package installer on IBM AIX 5.3:

Go to Oracle Technology Network or Oracle E-Delivery and download WebLogic AquaLogic Service Bus for IBM AIX.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Note: The BEA Download Center (i.e. http://commerce.bea.com) will be decommissioned on February 2, 2009. After this time, customers will be able to download the BEA software from Oracle's E-delivery portal (http://edelivery.oracle.com) or Oracle Technology Network (http://otn.oracle.com).

Install AquaLogic Service Bus using the following instructions:

• For Aqualogic Service Bus 2.5, see http://download.oracle.com/docs/cd/E13171_01/alsb/docs25/install/guimode.html
• For Aqualogic Service Bus 2.6, see http://download.oracle.com/docs/cd/E13171_01/alsb/docs26/install/guimode.html

Downloading and Installing the WebLogic Portal 9.2 (Including MP1/MP2) on IBM AIX

To install WebLogic Portal on IBM AIX 5.3:

Go to Oracle Technology Network or Oracle E-Delivery and download WebLogic Portal for IBM AIX.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Note: The BEA Download Center (i.e. http://commerce.bea.com) will be decommissioned on February 2, 2009. After this time, customers will be able to download the BEA software from Oracle's E-delivery portal (http://edelivery.oracle.com) or Oracle Technology Network (http://otn.oracle.com).

Install WebLogic Portal using the instructions in Using Installers with Filenames Ending in .jar in the BEA Products Installation Guide. This section describes the process of installing .jar files in the Graphical mode.

Downloading and Installing the WebLogic Portal 9.2 MP3 on IBM AIX

To install WebLogic Portal on IBM AIX 5.3:

Go to Oracle Technology Network or Oracle E-Delivery and download WebLogic Portal for IBM AIX.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Note: The BEA Download Center (i.e. http://commerce.bea.com) will be decommissioned on February 2, 2009. After this time, customers will be able to download the BEA software from Oracle's E-delivery portal (http://edelivery.oracle.com) or Oracle Technology Network (http://otn.oracle.com).

Install WebLogic Portal using the instructions in Using Installers with Filenames Ending in .jar in the BEA Products Installation Guide. This section describes the process of installing .jar files in the Graphical mode.
Set the BEA_HOME to point to the directory in which WebLogic Server is installed and export BEA_HOME. For example:

   export BEA_HOME=<your_WebLogic_Server_installation_directory>

If your configuration includes the 32-bit JDK, your installation is now complete. If your configuration includes the 64-bit JDK, however, you must also complete the following steps:

In a text editor, open the $BEA_HOME/weblogic92/common/bin/commEnv.sh and search for the following case statement:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Replace with the following:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc64

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc64

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Downloading and Installing the WebLogic Integration 9.2 (Including MP1/MP2) on IBM AIX

To install WebLogic Integration on IBM AIX 5.3:

Go to Oracle Technology Network or Oracle E-Delivery and download WebLogic Integration for IBM AIX.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Note: The BEA Download Center (i.e. http://commerce.bea.com) will be decommissioned on February 2, 2009. After this time, customers will be able to download the BEA software from Oracle's E-delivery portal (http://edelivery.oracle.com) or Oracle Technology Network (http://otn.oracle.com).

Install WebLogic Integration using the instructions in Using Installers with Filenames Ending in .jar in the BEA Products Installation Guide. This section describes the process of installing .jar files in the Graphical mode.

Downloading and Installing the WebLogic Integration 9.2 MP3 on IBM AIX

To install WebLogic Integration on IBM AIX 5.3:

Go to Oracle Technology Network or Oracle E-Delivery and download WebLogic Integration for IBM AIX.

Note: For important information about how to download BEA products refer to BEA Product Download Changes (Document ID 762254.1 and 763603.1) at https://support.oracle.com/.

Note: The BEA Download Center (i.e. http://commerce.bea.com) will be decommissioned on February 2, 2009. After this time, customers will be able to download the BEA software from Oracle's E-delivery portal (http://edelivery.oracle.com) or Oracle Technology Network (http://otn.oracle.com).

Install WebLogic Integration using the instructions in Using Installers with Filenames Ending in .jar in the BEA Products Installation Guide. This section describes the process of installing .jar files in the Graphical mode.
Set the BEA_HOME to point to the directory in which WebLogic Server is installed and export BEA_HOME. For example:

   export BEA_HOME=<your_WebLogic_Server_installation_directory>

If your configuration includes the 32-bit JDK, your installation is now complete. If your configuration includes the 64-bit JDK, however, you must also complete the following steps:

In a text editor, open the $BEA_HOME/weblogic92/common/bin/commEnv.sh and search for the following case statement:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Replace with the following:

   AIX)

      if [ -n "${LIBPATH}" ]; then

         LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc64

      else

         LIBPATH=${WL_HOME}/server/native/aix/ppc64

   fi

   LIBPATH=${PATCH_LIBPATH}:${LIBPATH}

   export LIBPATH

;; 

Download and Apply Patches

Download and install the following patches for AIX using Oracle Smart Update:

WLS 9.2 MP4

• Patch ID: RDFY PassCode: VFFBNM94

WLS 9.2 MP3

• Patch ID: NGZ8 PassCode: 3GR4S52Q

WLP 9.2 MP3

• Patch ID: NGZ8 PassCode: 3GR4S52Q

WLI 9.2 MP3

• Patch ID: NGZ8 PassCode: 3GR4S52Q

WLS 9.2 MP2 (32-bit)

• Patch ID: 6VZH PassCode: SIQ7P1D7
• Patch ID: IA8Q Passcode: DDDJ1831 (Required for SR5a)

WLS 9.2 MP2 (64-bit)

• Patch ID: 6VZH PassCode : SIQ7P1D7
• Patch ID: GQ6G PassCode : IATKHEU6
• Patch ID : IA8Q Passcode : DDDJ1831

WLS 9.2 MP1

• Patch ID: 5NZ3 PassCode : DUI2TJN7
• Patch ID: BJC9 PassCode : L5Z8U5L7

WLS 9.2

• Patch ID: 5W3R Pass Code: 276K2L83

ALSB 2.6

• Patch ID: 5NZ3 PassCode : DUI2TJN7
• Patch ID: BJC9 PassCode : L5Z8U5L7

ALSB 2.5

• Patch ID: 5W3R Pass Code: 276K2L83
• Patch ID: NFDM Pass Code: WKBBEBPR

WLP 9.2 MP2

• Patch ID: 6VZH PassCode: SIQ7P1D7

WLP 9.2 MP1

• Patch ID: 5NZ3 PassCode : DUI2TJN7
• Patch ID: BJC9 PassCode : L5Z8U5L7

WLP 9.2

• Patch ID: 5W3R Pass Code: 276K2L83
• Patch ID: I4DR Pass Code: JVBELVXT
• Patch ID: KPY9 Pass Code: YZF6EPS6

Note: After applying Patch IDs I4DR and KPY9, see compoze API Patch Issue for Non-J2ee Clients.

• Patch ID: PRA2 Pass Code: BLPTEX35
• Patch ID: DY4Y Pass Code: GL8HWQWZ (Required when using Remote Autonomy, see Post-Installation Instructions for BEA Smart Update Patch DY4Y.)

WLI 9.2 MP2

• Patch ID: 6VZH PassCode: SIQ7P1D7

WLI 9.2 MP1

• Patch ID: 5NZ3 PassCode : DUI2TJN7
• Patch ID: BJC9 PassCode : L5Z8U5L7
• Patch ID: GA8A Passcode : DZ3WY86J

For more information about Oracle Smart Update tool, see http://download.oracle.com/docs/cd/E14759_01/index.htm.

Copyright © 1994, 2016, Oracle and/or its affiliates. All rights reserved.