Release 12 (12.1.1) for Oracle Solaris on SPARC (64-bit)
September 2012
See Change Record
This document updates the following documentation with Oracle Solaris on SPARC (64-bit)-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.
These documents respectively correspond to the following install/upgrade scenarios:
For Solaris (SPARC) installation and upgrade notes corresponding to the older Release 12.0.4 version, please see the My Oracle Support Document 402312.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 regular basis. Currently, it contains the following sections:
The latest certification information for Oracle E-Business Suite Release 12 is available on the Certifications tab of My Oracle Support:
http://support.oracle.com
The operating system requirements for Oracle Solaris on SPARC (64-bit) are listed in the following sections.
The following table lists the supported operating system versions.
Operating System Name | Supported Version |
---|---|
Oracle Solaris on SPARC (64-bit) | 8 (5.8) - maintenance update 7 or higher 1 |
Oracle Solaris on SPARC (64-bit) | 9 (5.9) - maintenance update 8 or higher |
Oracle Solaris on SPARC (64-bit) | 10 (5.10) - GA or higher maintenance updates |
Oracle Solaris on SPARC (64-bit) | 11 (5.11) - GA or higher updates 2 |
1: only supported on the application (or middle) tier for upgrade customers in a multi-node system, or for both application and database tiers if the customer is on 10gR2. These OS'es are not supported for a new installation of 12.1.1 because 11gR1 of the Database is delivered with Rapid Install and is not supported on these OS'es.
2: Oracle Database 11gR2 (11.2.0.3 or higher) is required for EBS 12.1 on Solaris 11.
Use the following command to check the operating system version:
$ uname -r
Use the following command to check the maintenance update level:
$ cat /etc/release
The following table lists the required patches and the minimum required versions (the number after the '-' sign for the patch) for Solaris. 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 and Minimum Versions |
---|---|
Solaris 8 (5.8) |
|
Solaris 9 (5.9) |
|
Solaris 10 (5.10) |
|
Solaris 11 (5.11) |
|
3: required for use with NUMA (Non-Uniform Memory Architecture) only
4: required if using Solaris Fair Share Scheduler (package SUNWfss) - see My Oracle Support Note 558374.1
Use the following command to retrieve the list of operating system patches already applied:
$ showrev -p | sort > patchList
Use the following command to check for a specific patch:
$ /usr/sbin/patchadd -p | grep patch_number (without version number)
For example, to check for patch 123456-01, enter::
$ /usr/sbin/patchadd -p | grep 123456
The following table lists the required packages for Solaris 8 (5.8), 9 (5.9), 10 (5.10), 11 (5.11).
Operating System | Required Packages |
---|---|
Solaris 8 (5.8), 9 (5.9) |
|
Solaris 8 (5.8), 9 (5.9), 10 (5.10) |
|
Solaris 8 (5.8), 9 (5.9), 10 (5.10), 11 (5.11) |
|
Solaris 9 (5.9), 10 (5.10) |
|
Solaris 9 (5.9), 10 (5.10), 11 (5.11) |
|
Solaris 11 (5.11) |
|
Use the following command to check for existing packages:
$ pkginfo
JDK 6 is bundled with Oracle E-Business Suite version 12.1.1.
Additional Information: Check the Oracle Web site for any updates to the JDK 6 requirements for Oracle Solaris on SPARC (64-bit): http://www.oracle.com/technetwork/java/javase/install-solaris-139361.html#requirements |
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.
The following are other requirements for Oracle Solaris on SPARC (64-bit).
Verify that the owner of the Oracle Application Server and Oracle Database server file systems have the following 'ulimit' values:
Use the following command to check the ulimit settings:
$ ulimit -a
The following table lists the kernel settings for Oracle Solaris on SPARC (64-bit):
Note: Verify that the following kernel parameters are set to values greater than or equal to the recommended values shown. Refer to your operating system documentation or contact your operating system vendor for more information on configuring kernel parameters. |
Operating System | Parameter | Value |
---|---|---|
Solaris 8 (5.8) | rlim_fd_max | 65536 |
noexec_user_stack | 1 | |
semsys:seminfo_semmni | 100 | |
semsys:seminfo_semmns | 1024 | |
semsys:seminfo_semmsl | 256 | |
semsys:seminfo_semvmx | 32767 | |
shmsys:shminfo_shmmax | 4294967295 | |
shmsys:shminfo_shmmin | 1 | |
shmsys:shminfo_shmmni | 100 | |
shmsys:shminfo_shmseg | 10 | |
Solaris 9 (5.9) | rlim_fd_max | 65536 |
noexec_user_stack | 1 | |
semsys:seminfo_semmni | 100 | |
semsys:seminfo_semmns | 1024 | |
semsys:seminfo_semmsl | 256 | |
semsys:seminfo_semvmx | 32767 | |
shmsys:shminfo_shmmax | 4294967295 | |
shmsys:shminfo_shmmni | 100 | |
Solaris 10 (5.10) | rlim_fd_max | 65536 |
noexec_user_stack | 1 | |
semsys:seminfo_semmni | 100 | |
semsys:seminfo_semmsl | 256 | |
shmsys:shminfo_shmmax | 4294967295 | |
shmsys:shminfo_shmmni | 100 | |
Solaris 11 (5.11) | rlim_fd_cur | 65536 |
rlim_fd_max | 65536 | |
noexec_user_stack | 1 | |
semsys:seminfo_semmns | 1024 | |
semsys:seminfo_semvmx | 32767 | |
project.max-sem-ids | 100 | |
process.max-sem-nsems | 256 | |
project.max-shm-memory | 4294967295 | |
project.max-shm-ids | 100 |
Check the /etc/system file or use the resource control facility to verify the kernel settings.
Verify that the /etc/hosts file is formatted as follows:
127.0.0.1 localhost.localdomain localhost .
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 that you have the latest Rapid Install patch as described in Oracle Applications Release Notes, Release 12.1.1 (My Oracle Support Document 798258.1) before you begin your installation or upgrade. Complete all operating system, software, and other requirements before installing or upgrading Oracle E-Business Suite.
If installing Oracle E-Business Suite on Solaris 11 for the first time, you must apply the startCD patch 12.1.1.13 or later (patch 11072566) prior to running Rapid Install. This patch includes the Solaris 11 oraparam.ini changes in the 10.1.3 Oracle Home required for the installation on Solaris 11 to succeed.
Customers who are cloning to or are performing an in-place OS upgrade to Solaris 11 must first upgrade the Oracle Database to 11gR2 (11.2.0.3 or higher) and the Oracle Application Server 10gR3 to 10.1.3.5 using the respective documents:
Customers who are installing the E-Business Suite on Solaris 11 using Rapid Install must upgrade these technology components after installation.
If you are upgrading the operating system to Solaris 11 (in-place upgrade) or if you are cloning an existing Release 12 environment to a Solaris 11 system, download and apply the relevant patch applicable to the Application Server Oracle Home (10.1.3.x) prior to the cloning or in-place OS upgrade:
AS 10g Version | EBS oraparam.ini patch | |
---|---|---|
App Server 10.1.3 (Java middle tier) | 10.1.3.5 | 12335816 |
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 Unix servers and prevent Rapid Install from completing. |
To address this issue, perform the following steps before installing or upgrading:
Perform the installation or upgrade by 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.
Perform the following steps after installing or upgrading to Release 12.1.1 and before allowing users to access the system.
Customers who installed E-Business Suite 12.1.1 on Solaris 11 using Rapid Install must upgrade the Oracle Database to 11gR2 (11.2.0.3 or higher). Validate System Configuration post-install checks which failed for the Oracle Application Server, such as the HTTP server not starting up, should be ignored. Instead, customers must upgrade the Oracle Application Server 10gR3 to 10.1.3.5. Please use the following documents for the Oracle Database and Application Server upgrades:
Customers who cloned or performed an in-place OS upgrade must ensure that their original E-Business Suite instance had been upgraded to Oracle Database 11gR2 and Oracle Application Server 10.1.3.5 prior to performing the clone or in-place OS upgrade.
Dynamic libraries are used as part of the relinking and execution processes. The LD_LIBRARY_PATH 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:
LD_LIBRARY_PATH 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 LD_LIBRARY_PATH tools_home (10.1.2) LD_LIBRARY_PATH web_home (10.1.3) LD_LIBRARY_PATH
On the database server node:
LD_LIBRARY_PATH is set in $ORACLE_HOME/[CONTEXT_NAME].env which corresponds in the AutoConfig interface to:
Location Parameter db_home LD_LIBRARY_PATH
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. |
Net Service Listeners use the /var/tmp/.oracle directory to store temporary files. To give all users in a multi-user installation write privileges, update /var/tmp/.oracle with 777 permissions:
$ chmod 777 /var/tmp/.oracle
Product | Operating System |
---|---|
Oracle Profitability Manager | Solaris 8 (5.8), 9 (5.9) * |
Oracle Advanced Supply Chain Planning (MSC) | Solaris 11 (5.11) ** |
Oracle Inventory Optimization (MSR) | Solaris 11 (5.11) ** |
Oracle Constraint Based Optimization (MSO) | Solaris 11 (5.11) ** |
Oracle Sourcing (PON) | Solaris 11 (5.11) ** |
Oracle Engineering (ENG) | Solaris 11 (5.11) ** |
Oracle Work In Process (WIP) | Solaris 11 (5.11) ** |
Oracle Manufacturing Scheduling (WPS) | Solaris 11 (5.11) ** |
*: This product is not supported on Solaris 8 and 9 because of a bug fix that's only available on Solaris 10.
**: The indicated products are currently not supported on the corresponding Solaris version due to third party products' lack of support.
There is a known issue with the Oracle Database (which is bundled by the EBS R12 distribution) on Sun CMT (Chip Multithreading ) systems with UltraSPARC T1/T2/T2 Plus/T3/T4 processors, which are multi-socket, multi-core processors that can run multiple threads in parallel. The Database installer treats each thread as a virtual CPU and allocates memory that usually exceeds what these systems can support when the number of virtual CPUs typically exceed 64.
Users may see installation errors such as:
ORA-00821: Specified value of sga_target 1024M is too small, needs to be at least 1452M
This issue is fixed in Oracle Database 11g Release 2 (11.2.0.3 or higher). For older database versions, two possible workarounds are recommended:
1. Users can turn off some of the hardware threads seen by the system using the 'psradm (1M)' command before the installation and then turn them back on as a post EBS install step. Please refer to the man page of 'psradm(1M)' for more information.
The following examples show the commands to turn off and on eight virtual CPUs:# psradm -f 0-7 # psradm -n 0-72. If using a virtualization technology such as Oracle VM for SPARC (previously known as LDoms or Logical Domains) or Solaris Containers, you can limit the number of virtual CPUs seen by the system to <= 64 using the following commands as an EBS pre-installation step:
Solaris Containers:
To limit the number of dedicated VCPUs for a given Container, use the 'zonecfg(1M)' command's 'dedicated-cpu resource' and 'ncpus' property.The 'dedicated-cpu resource' specifies that a subset of the system's processors should be dedicated to a Solaris Container while it is running, and 'ncpus' property specifies the actual number of VCPUs be dedicated for the Container.The following example configures eight VCPUs for the Solaris Container named "ebs1":
# zonecfg -z ebs1 zonecfg:ebs1> add dedicated-cpu zonecfg:ebs1:dedicated-cpu> set ncpus=8 zonecfg:ebs1:dedicated-cpu> end zonecfg:ebs1> verify zonecfg:ebs1> commit zonecfg:ebs1> exitPlease review the Solaris Containers-Resource Management and Solaris Zones guide for detailed information.
Oracle VM Server for SPARC (previously known as LDoms or Logical Domains) :
To set the number of VCPUs for a given Logical Domain (LDom), use the 'ldm(1M)' with the 'set-vcpu' option:
# /opt/SUNWldm/bin/ldm set-vcpu <number> <logical_domain>For example to configure eight VCPUs for the Logical Domain named "ebs1":
# /opt/SUNWldm/bin/ldm set-vcpu 8 ebs1Please review the Logical Domains Administration guide for detailed information.
Users can then revert the number of VPUs to the original or desired values as a post EBS install step.
There was a known issue with the Java Runtime Environment (JRE) on systems with UltraSPARC T1/T2/T2 Plus/T3/T4 processors which are multi-socket, multi-core and can run multiple threads in parallel. As the JRE treats the systems using these processors (T-series systems) as a server class machine, the server can appear to be a very large CPU machine and each Java Virtual Machine (JVM) could spawn anywhere from 32 to over 256 garbage collector threads.
There was a pending bug filed for the garbage collector issue which was fixed in JDK 6 Update 14 (or higher). For older JDK 6 versions, we recommended that the following option be set for invoking the Java VM on T-series systems:
There are a number of places where the JVM option (" -XX:+UseParallelGC -XX:ParallelGCThreads=4") should be added (if not already there) using the Oracle Applications Manager interface:
Once these changes are made, you will need to re-run AutoConfig to ensure these changes take effect.
The following sections were changed in this document.
Date | Summary of Changes |
---|---|
26-Sep-2012 | Updated Solaris 11 (SPARC) platform support |
27-Jul-2012 | Removed App Server 10.1.2 oraparam.ini patch entry |
21-Feb-2012 | Clarified Solaris 10 minimum version |
19-Dec-2011 | Clarified rationale for upgrading Oracle Database and Application Server (Solaris 11 only) in "After Installing or Upgrading" section |
07-Dec-2011 | Updated Solaris 11 required packages |
15-Nov-2011 | Added Solaris 11 (SPARC) platform support |
29-Mar-2011 | Added note about Solaris 10 Zones support within Solaris 11 Express (SPARC). |
05-Oct-2010 | Added opmn port conflict workaround |
20-Aug-2010 | Modified kernel settings as verified with the 12.1.3 RUP release. |
01-Jul-2010 | Clarified that LD_LIBRARY_PATH is also set by Rapid Clone when configuring the target system. |
25-Jun-2010 | Cleaned up references of 'Oracle Applications' to 'Oracle E-Business Suite'; cleaned up description of LD_LIBRARY_PATH setting |
18-Jun-2010 | Noted that the GC issue on T-series systems is fixed in JDK6U14; removed the Max page size parameter for CMT since it was fixed in an early build of JDK 6, and all official updates to JDK 6 should reflect it. |
17-Jun-2010 | Added clarification on min versions supported for Solaris patches |
02-Jun-2010 | Added Solaris 9 patches (including the one for Solaris Fair Share Scheduler). |
26-May-2010 | Added workarounds for DB install error seen on CMT (T1/T2) Sun systems due to excessive memory being allocated. |
27-Apr-2009 | Initial publication of 12.1.1 IUN - for the older 12.0.4 IUN changes, please see My Oracle Support Document 402312.1 |
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/
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.
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.
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 Oracle Solaris on SPARC (64-bit)
Copyright © 2011, 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.
NOTE:1058763.1 - Interoperability Notes EBS R12 with Database 11gR2
NOTE:402312.1 - Oracle Applications Installation and Upgrade Notes Release 12 (12.0.4) for Solaris Operating System (SPARC)
NOTE:558374.1 - Database Startup Fails With ORA-00443: Background Process "VKTM" Did Not Start
NOTE:798258.1 - Oracle Applications Release Notes, Release 12.1.1