8.1 Supported Configurations: IBM AIX 5.3 on pSeries
IBM AIX 5.3 on pSeries with 8.1 SP6
This section provides the following information:
Related Information
Configuration Requirements
Table 1-1 Requirements for 8.1 SP6 on IBM AIX 5.3 on pSeries
Operating System Version and Patches
|
AIX 5L v5.3-ML2 and higher MLs
|
Chip Architecture and Minimum Processor Speed
|
|
SDK
|
IBM JDK 142 SR5 Java
version 1.4.2 JavaTM 2
Runtime Environment,
Standard Edition (build 1.4.2)
Classic VM (build 1.4.2, J2RE
1.4.2 IBM AIX build
ca142-20060421 (SR5) (JIT
enabled: jitc))
IBM JDK 142 SR7 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-20061124 (SR7) (JIT
enabled: jitc))
|
The IBM SDK is not delivered with WebLogic Platform; you must download it 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 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.
|
Azul Virtual Machine 2.2.1.0 and later patches
|
|
Design and Development Tools
|
Supports WebLogic Server design and development tools.
|
RAM
|
512 MB required; 1 GB recommended
|
Performance Pack
|
Included
|
lib/aix/libmuxer.so
|
Node Manager
|
Included
|
Native
|
BEA jDrivers for Oracle
|
For this Oracle client version:
|
The following shared libraries are provided:
|
|
|
Known Issues
This section lists known issues pertaining to WebLogic Platform 8.1 SP6, and where available, provides workarounds:
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:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/interm/relnotes.html
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.
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:
- Set the buffer size to 32 KB:
no -o udp_sendspace=32768
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:
ERROR-WARNING: Could not create system preferences directory. System preferences are unusable.
ERRORjava.util.prefs.FileSystemPreferences checkLockFile0ErrorCode
ERROR>WARNING: Could not lock System prefs. Unix error code 1103701049.
To work around this problem, implement one of the following steps:
- Before installing WebLogic Platform, log in as root and create a directory called
/etc/.java
.
- Specify the following option when you enter the
java
command to install WebLogic Platform:
-Djava.util.prefs.userRoot=$HOME/
temp_directory
Note: If you enter the latter option on the java
command line, make sure the value of temp_directory
is a directory for which you have full permissions.
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
- 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.
Method 2
Pass the 'nodebug
' command-line argument to the server startup script. For example:
$ ./startWebLogic.sh nodebug
How to Enable JVM Debug Mode
Note: Enabling debug mode is not recommended because this mode affects server performance.
- In a text editor, open the
setDomainEnv.sh
script and comment the following line:
JAVA_OPTIONS="${JAVA_OPTIONS} -ea -da:com.bea... -da:javelin ... -da:weblogic ..."
- Save your changes. Then start (or restart) the WebLogic domain.
JAXP Incompatibility Causes Portability Issues with WebLogic Server 8.1 SP6
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 setDomainEnv.sh
- In a text editor, open the
setDomainEnv.sh
script.
- Append the following values to
JAVA_OPTIONS
: "-Djavax.xml.transform.TransformerFactory=weblogic.apache.xalan.processor.TransformerFactoryImpl
-Djavax.xml.parsers.SAXParserFactory=weblogic.apache.xerces.jaxp.SAXParserFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=weblogic.apache.xerces.jaxp.DocumentBuilderFactoryImpl"
Method 2: Uncomment JAXP Properties Lines for JAXP 1.1 Parser and Transformer Factories
- Copy the
$JAVA_HOME/jre/lib/jaxp.properties.sample
file to $JAVA_HOME/jre/lib/jaxp.properties
.
- 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:
javax.xml.transform.TransformerFactory=weblogic.apache.xalan.processor.TransformerFactoryImpl
javax.xml.parsers.SAXParserFactory=weblogic.apache.xerces.jaxp.SAXParserFactoryImpl
javax.xml.parsers.DocumentBuilderFactory=weblogic.apache.xerces.jaxp.DocumentBuilderFactoryImpl
Method 3: Create the XML Registry
- If WebLogic Server boots successfully, create the XML Registry, using the WebLogic transformer and parser factories for the required values.
- If WebLogic Server fails to boot and you cannot create an XML Registry, you can manually add the XML Registry to the
config.xml
file. In a text editor, open config.xml
and make the following changes:
- Change the Server Tag to the following format:
<Server Name="Server_Name"
...
...
...
XMLRegistry="SampleXMLRegistry">
- Add the XML Registry entry for
SampleXMLRegistry
, as follows:
<XMLRegistry Name="SampleXMLRegistry"
TransformerFactory="weblogic.apache.xalan.processor.TransformerFactoryImpl"
SAXParserFactory="weblogic.apache.xerces.jaxp.SAXParserFactoryImpl"
DocumentBuilderFactory="weblogic.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
- For more information, see:
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/ConsoleHelp/xml.html
Upgrade to WebLogic Platform 8.1 SP6 Requires Library Cleanup
Before you can upgrade your WebLogic Platform system from a pre-8.1 SP6 version to 8.1 SP6 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 libmuxer.so which is in use.
To perform a proper memory cleanup, log in as root and run slibclean
, an AIX utility. Then re-start the upgrade procedure. For more information, see the instructions for upgrading from SP1 to SP3 in the Release Notes for WebLogic Platform 8.1:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/relnotes/relnotes.html#cr206782
Note: The instructions provided in the Release Notes were originally written to explain how to upgrade from SP1 to SP3, but they are also valid for performing an upgrade to 8.1 SP6 from any pre-SP6 version of WebLogic Platform 8.1.
Download and Installation Instructions
Complete the following procedures:
Downloading and Installing 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 ca1420-20060421:
- Go to the IBM download site:
http://www-106.ibm.com/developerworks/java/jdk/aix/service.html
- Download the GA version of the IBM SDK 1.4.2.
- Install the IBM SDK 1.4.2 on your system.
Downloading and Installing IBM SDK 1.4.2 SR5/SR7
To download and install IBM SDK 1.4.2 SR5 (IY84053) or IBM SDK 1.4.2 SR7 (IY91756) on AIX system, complete the following procedure:
- Verify that the GA version of the IBM SDK 1.4.2 for AIX is installed on your system:
- If it is already installed, skip to step 2.
- If it is not installed, download it from the IBM SDK download site and install it on your system. For instructions, see the previous section, Downloading and Installing IBM SDK 1.4.2.
- Go to the following IBM download site:
https://techsupport.services.ibm.com/server/aix.fdc
Set the search criteria to the following:
- Product family: From the drop-down list, select the following entry: "System p"
- Product: From the drop-down list, select the following entry:
"AIX operating system"
- Version: From the drop-down list, select the following entry: "5.3"
- Fix type: From the drop-down list, select the following entry: "Specific fixes"
- Search by: Specify an APAR number or abstract
- For SR5: In Search string: Specify "IY84053."
- For SR7: In Search string: Specify "IY91756"
- Following the instructions displayed on the screen, make the selections necessary to download and install the specified APAR.
- To verify that the required SDK fix is now installed on your system, run the following command:
/usr/java14/bin/java -version
Make sure the following output is displayed:
For SR5:
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 ca1420-20060421 (SR5) (JIT enabled: jitc))
For SR7:
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-20061124 (SR7) (JIT enabled: jitc))
Downloading and Installing WebLogic Platform or WebLogic Server 8.1 SP6
To install WebLogic Platform 8.1 SP6 on an IBM AIX 5.3 configuration:
- Go to the BEA download site:
http://commerce.bea.com
- Click on "BEA WebLogic" link to go to "BEA WebLogic Product Family" page. Then click on "BEA WebLogic Platform 8.1SP6".
- Go to "WebLogic Platform 8.1 with SP6" under "WebLogic Platform Package Installer" section.
- From the list of installers for WebLogic Platform 8.1 SP6 or WebLogic Server 8.1 SP6, select "IBM AIX (5.1, 5.2, 5.3)."
- Download the IBM AIX-specific package installer for the appropriate product:
- For WebLogic Platform:
pj_platform816_generic.jar
- For WebLogic Server:
pj_server816_generic.jar
- Install WebLogic Platform 8.1 SP6 or WebLogic Server 8.1 SP6 using the instructions provided for
.jar
installation files, as described in Installing WebLogic Platform. For example, if you are installing in console mode, enter the following on the command line:
$ java -jar pj_platform816_generic.jar -mode=console
For detailed instructions, see "Starting Console-Mode Installation on UNIX Systems" in Installing BEA WebLogic Platform:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/install/console.html#instcon003
For more information, see Installing BEA WebLogic Platform.
Switching from IBM SDK 1.4.2 SR5 to SR7
The following instructions provide one method to switch from IBM SDK 1.4.2 SR5 to 1.4.2 SR7:
- Modify the
startWebLogic.sh
script located in your domain's root directory.
Update all references of the JAVA_HOME
variable to point to the install directory for IBM 1.4.2 SR7.
- Modify the
setDomainEnv.sh
script located in your domain's bin directory.
Update all references of the JAVA_HOME
variable to point to the install directory for IBM 1.4.2 SR7.
- Modify the
commEnv.sh
script located at BEA_HOME
/weblogic81/common/bin directory
.
Update all references of the JAVA_HOME
variable to point to the install directory for IBM 1.4.2 SR7.
A server restart is required to implement the change in SDK.
Downloading and Installing WebLogic Platform 8.1 SP6 with Azul Virtual Machine
- Install Azul Virtual Machine following the instructions provided in the Azul Virtual Machine installation documents.
- Set the AZUL_JAVAHOME to Azul Virtual Machine installation path.
- From AZUL_JAVAHOME, run
domain_specify
script. The script prompts for the Azul domain and policy server host: specify appropriate values.