Oracle E-Business Suite Installation and Upgrade Notes Release 12 (12.1.1) for IBM AIX on Power Systems (64-bit) [ID 761569.1]

 

  Modified 01-JUL-2010     Type BULLETIN     Status PUBLISHED

 

Oracle® E-Business Suite Installation and Upgrade Notes

Release 12 (12.1.1) for IBM AIX on Power Systems (64-bit)

July 2010

See Change Record

This document updates the following documentation with AIX specific information for Oracle E-Business Suite (EBS) Release 12 (12.1.1). Refer to the information contained here and to the appropriate manual when you install or upgrade your system.

Oracle E-Business Suite Installation Guide: Using Rapid Install (which is supplemented by Oracle Applications Release Notes and Oracle Applications NLS Release Notes)

Oracle E-Business Suite Upgrade Guide: Release 11i to Release 12.1.1 Oracle E-Business Suite Maintenance Pack (MP) Installation instructions

These documents respectively correspond to the following install/upgrade scenarios:

New Installations of Release 12.1.1 using the EBS Rapid Install wizard Upgrades of EBS from versions 11i to 12.1.1 using the EBS Rapid Install wizard Upgrades of EBS from versions 12.0 (including 12.0 RUPs) to 12.1.1 using the Maintenance

Pack (MP)

For AIX installation and upgrade notes corresponding to the older Release 12.0.4 version, please see the My Oracle Support Document 402306.1.

Specific steps in this document may be conditional depending on the scenario and will be highlighted as such.

Complete all operating system requirements, software requirements, and other requirements before installing or upgrading Oracle E-Business Suite.

This document may be updated on a weekly basis. Currently, it contains the following sections:

Certification Information Operating Systems Requirements Software Requirements Other Requirements Before Installing or Upgrading Installing or Upgrading After Installing or Upgrading Known Issues Change Record Documentation Accessibility

Certification Information

The latest certification information for Oracle E-Business Suite Release 12 is available on My Oracle Support (formerly OracleMetaLink):

http://support.oracle.com

Operating Systems Requirements

The operating system requirements for IBM AIX on Power Systems (64-bit) are listed in the following sections.

Operating System Supported Versions

The following table lists the supported operating system versions.

Operating System Name Supported Version

IBM AIX (64-bit) 5L (5.3) - technology level 7, Service Pack 3 or higher (> 5300-07-03)

IBM AIX (64-bit) 6 (6.1) - technology level 0, Service Pack 4 or higher (> 6100-00-04)

Use the following command to check the operating system, technology level and Service Pack versions:

$ oslevel -s

This command returns a string 'XXXX-YY-ZZ-yw' where XXXX is the base operating system version, YY is the technology level, ZZ is the Service Pack number and 'yw' is the year and week of the Service Pack build.

Required Patches

The following table lists the required patches and the minimum required versions for AIX on Power Systems. Unless otherwise noted, the patches must be installed manually.

Additional Information: Refer to your vendor's operating system installation manual or the operating system media for information on obtaining and applying patches.

Operating System Required Patches

AIX 5L (5.3) IY58143, IY59386, IY60930, IY66513, IY70159, IY68989, IY76140IY89080, IY92037, IY94343IZ01060 or efix for IZ01060IZ03260 or efix for IZ03260

AIX 6 (6.1) IZ10223 (TL 0)IZ67400 (TL 4 and higher)

Use the following command to retrieve the list of operating system patches already applied:

$ /usr/sbin/instfix -i | more

Use the following command to check for a specific patch:

$ /usr/sbin/instfix -ik [patchname]

JDK 6 Requirements

JDK 6 is bundled with Oracle E-Business Suite version 12.1.1.

Additional Information: Check the IBM Web site for any updates to the JDK 6 requirements for AIX on Power Systems:

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

Required Filesets

The following table lists the required filesets for AIX on Power Systems.

Operating System Required Filesets

AIX 5L (5.3) xlC.aix50.rte:8.0.0.7 or later xlC.rte:8.0.0.7 or later

AIX 6 (6.1) xlC.aix61.rte:9.0.0.1 or later xlC.rte:9.0.0.1 or later

AIX 5L (5.3)&AIX 6 (6.1)

bos.adt.base bos.adt.lib bos.adt.libm bos.perf.libperfstat bos.perf.perfstat bos.perf.proctools rsct.basic.rte rsct.compat.clients.rte X11.motif.lib

Use the following command to check for existing filesets:

$ lslpp -l [fileset]

The state of the fileset should be 'COMMITTED'.

If any fileset is in an 'APPLIED' state, it is recommended that it be 'COMMITED' using smit or the following command:

$ installp -c [fileset]

 

Software Requirements

The following are software requirements for IBM AIX on Power Systems (64-bit).

Maintenance Tools

The following maintenance tools must be installed on all machines, and their locations specified both in the PATH of the account that runs Rapid Install and in the PATH of the accounts that will own the database tier and application tier file systems.

ar ld linkxlC make X Display Server

Install the IBM XL C/C++ Utilities package

The XL C/C++ Enterprise Edition V8.0 for AIX Utilities is available from the IBM Web site for those who do not have a full version of the compiler installed. Download and install the XL C/C++ utilities package (xlcpp.util.8.0.0) and any prerequisites. Review the information at:

http://www-1.ibm.com/support/docview.wss?uid=swg24010670

Note: The XL C/C++ runtime package (xlcpp.rte.8.0.0) in the above web page should not be downloaded as they are provided as part of the AIX OS technology levels (TLs) that are current.

.

Note: The XL C/C++ runtime utilities are not needed if you are using the full version of XL C/C++ Enterprise Edition V8.0 for AIX. Please note that if you are installing the full version of 8.0 on a current AIX Technology Level, you may see an apparent downgrade of the OS (using 'oslevel -s') - this is due to the fact that the full version of the 8.0 compiler includes an older version of a package (xlsmp.rte:1.6.0.0). The workaround to this is to re-install the package to the current level provided by the AIX Technology Level - one way to do this is by installing the latest V8.0 XL compiler PTF (available here).

.

Note: For AIX 6, the 8.0 runtime utilities needs to be at least at the November 2007 PTF level (8.0.0.17).

Other Requirements

The following are other requirements for AIX on Power Systems.

ulimit Value Settings

Verify that the owner of the Oracle Application Server and Oracle Database server file systems have the following 'ulimit' values:

time (seconds) = unlimited file (blocks) = unlimited data (kbytes) = unlimited

stack (kbytes) = unlimited memory (kbytes) = unlimited coredump (blocks) = unlimited nofiles (descriptors) = 65536

Use the following command to check the ulimit settings:

$ ulimit -a

Kernel Settings

The following table lists the kernel settings for AIX on Power Systems:

Note: Verify that the following kernel parameters are set either to the formula shown, or to values greater than or equal to the recommended value shown. Refer to your operating system documentation or contact your operating system vendor for more information on configuring kernel parameters.

Parameter Value

Soft FILE size -1 (unlimited)

Soft CPU time -1 (unlimited)

Soft DATA segment -1 (unlimited)

Soft STACK size -1 (unlimited)

Soft NOFILE size 65536

Maximum number of PROCESSES allowed per user 2048

ARG_MAX 524288

Start "smitty" as the root user to verify or change the kernel settings:

$ /usr/bin/smitty

Host Names Settings

Verify that the /etc/hosts file is formatted as follows:

127.0.0.1 localhost.localdomain localhost[ip_address] [node_name].[domain_name] [node_name]

Before Installing or Upgrading

If the Release 12.1.1 installation or upgrade is performed with the Rapid Install wizard (either a new R12 installation or upgrade from 11i to R12), ensure you have the latest Rapid Install patch as described in Oracle Applications Release Notes, Release 12.1.1 (My Oracle Support Doc 798258.1) before you begin your installation or upgrade. Complete all operating system requirements, software requirements, and other requirements before installing or upgrading Oracle E-Business Suite.

Enable Asynchronous I/O (conditional)

Use the following steps to enable asynchronous I/O if you're on AIX 5L (asynchronous I/O is enabled by default on AIX 6):

1. Log in as the root user.2. Enter the following command to verify whether asynchronous I/O services are running. If they are

not, the command will start services:

# mkdev -l aio0

3. To ensure the services are configured with each system restart:

a. At the command prompt, enter the following:

# smit aio

b. Select the menu item: Change/Show Characteristics of Asynchronous I/O.c. Change the field: "STATE to be configured at system restart" from DEFINED to

AVAILABLE.

 

Set Environment Variables

Set the environment variable AIXTHREAD_SCOPE on the application and database tiers prior to installing 12.1.1:

$ export AIXTHREAD_SCOPE=S

For upgrade customers (upgrading from 11i or earlier versions of 12.0 and 12.0 RUPs). set the environment variable ADJREOPTS prior to the upgrade:

$ export ADJREOPTS="-mx256m"

 

OPMN port conflict

Attention: By default, the OPMN service of the Application Server technology stack listens on port 6000 when started up during Rapid Install. This can conflict with the X11 port used for the graphics console on AIX servers and prevent Rapid Install from completing.

To address this issue, perform the following steps before installing or upgrading:

Check if the port 6000 is being used ("netstat -a | grep 6000") If so, then you should disable the graphics console login process on the AIX server. This can be

accomplished by logging in as the UNIX root user and issuing the following commands:o Shutdown the dtlogin process with the command "/usr/dt/bin/dtconfig -kill"o Confirm that nothing is listening at port 6000 ("netstat -a | grep 6000")o Disable the local X console for dtlogin with command "/usr/dt/bin/dtconfig -d"o Restart dtlogin with command "/usr/dt/bin/dtconfig -e"

 

Installing or Upgrading

Perform the installation or upgrade following the documentation (Oracle E-Business Suite Installation Guide: Using Rapid Install, Oracle E-Business Suite Upgrade Guide: Release 11i to Release 12.1.1 or Oracle E-Business Suite Release 12.1.1 Maintenance Pack instructions) relevant to the specific installation or upgrade scenario described above.

After Installing or Upgrading

Perform the following steps after installing or upgrading to Release 12.1.1 and before allowing users to access the system.

Set LIBPATH Environment Variable

Dynamic libraries are used as part of the relinking and execution processes. The LIBPATH environment variable is used by Oracle E-Business Suite to locate the required dynamic libraries at runtime - this variable is set by the Rapid Install wizard during the installation of EBS as well as by the Rapid Clone script (adcfgclone) when configuring the target system.

If you need to change these values, use the Edit Parameters function of the OAM AutoConfig tool (by logging in as 'System Administrator' responsibility, clicking on 'System Administrator', selecting 'AutoConfig' under 'Oracle Applications Manager', and clicking on the 'Environments' tab):

On each application tier server node:

LIBPATH is set in three places:

$APPL_TOP/admin/adovars.env $ORA_CONFIG_HOME/10.1.2/[CONTEXT_NAME].env, in the 10.1.2 Oracle home

directory $ORA_CONFIG_HOME/10.1.3/[CONTEXT_NAME].env, in the 10.1.3 Oracle home

directory

In the AutoConfig interface, this corresponds to:

Location Parameter

adovars LIBPATH

tools_home (10.1.2) LIBPATH

web_home (10.1.3) LIBPATH

On the database server node:

LIBPATH is set in $ORACLE_HOME/[CONTEXT_NAME].env which corresponds in the AutoConfig interface to:

Location Parameter

db_home LIBPATH

After making these changes, run AutoConfig (adautocfg.sh) to implement the changes on the application and database tiers.

Additional Information: See AutoConfig in Oracle E-Business Suite Maintenance Utilities for more information on AutoConfig.

Set AIXTHREAD_SCOPE Environment Variable

Set the environment variable AIXTHREAD_SCOPE on the application tier prior to starting or re-starting EBS processes:

$ export AIXTHREAD_SCOPE=S

This environment variable is set on the database tier's DB Oracle Home [CONTEXT_NAME].env file when it is sourced, so an explicit setting of it here is unnecessary.

 

Net Service Listeners in Multi-user Installations

Net Service Listeners use the /tmp/.oracle directory to store temporary files. To give all users in a multi-user installation write privileges, update /tmp/.oracle with 777 permissions:

$ chmod 777 /tmp/.oracle

Known Issues

The following are known issues for this release on IBM AIX on Power Systems

Maintain Snapshot errors

The following errors are seen for various '.a' third party product libraries in $SHT_TOP/lib when running the 'Maintain Snapshot' in adadmin (bug 8974677):

# Begin Product sht Filesar xv $APPL_TOP/sht/12.0.0/lib/libeng.aar: 0707-108 File $APPL_TOP/sht/12.0.0/lib/libeng.a is not an archive file.An error occurred while extracting all object modules from library.Continue as if it were successful [No] :

These errors are ignorable and users should type in 'Yes' at the prompt to continue.

 

Change Record

The following sections were changed in this document.

Date Summary of Changes

1-Jul-2010

Clarified that LIBPATH is also set by Rapid Clone when configuring the target system.

29-Jun-2010

Added the OPMN port conflicts section to check before installing/upgrading.

25-Jun-2010

Cleaned up references of 'Oracle Applications' to 'Oracle E-Business Suite'; cleaned up description of LIBPATH setting

04-Jun-2010

Added AIX 6 patch IZ67400 due to DB install failure (see MOS Doc 980602.1); removed Javascript 'lessthan' and 'greaterthan' since issues with < and > have been fixed.

21-Dec-2009

Added missing rsct packages due to 11gR1 installer requiring them at install time (bug 6628595, 8810253). Replaced various instances of 'less than' (<) and 'greater than' (>) signs with square brackets ([, ]), because of bug in Orion.

27-Oct-2009

Added new Known Issues section with the ignorable "Maintain Snapshot' errors for library (.a) files

16-Sep-2009

Name change to 'IBM AIX on Power Systems'; removed the 'Runtime' package requirements and only left the 'Utilities' package since the 8.0 rte's (xlcpp.rte.8.0.0.aix) cause an apparent downgrade of the TL due to an older version of one package (xlsmp.rte)

09-July-2009

Fixed reference to setting the env variable AIXTHREAD_SCOPE from 'on the database tier' to both tiers in the 'Before Installing or Upgrading' section; added explicit setting on the application tier to the 'After Installing or Upgrading' section.

27-Apr-2009

Initial publication of 12.1.1 IUN - for the older 12.0.4 IUN changes, please see My Oracle Support Doc 402306.1

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at:

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, 7 days a week. For TTY support, call 800.446.2398. Outside the United States, call +1.407.458.2479.

Oracle E-Business Suite Installation and Upgrade Notes, Release 12 (12.1.1) for IBM AIX on Power Systems (64-bit)

Copyright © 2009, Oracle. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

This software and documentation may provide access to or information on content, products and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third party content, products and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third party content, products or services.

 Related

Products

Oracle E-Business Suite > Applications Technology > Lifecycle Management > Application Install

Back to top