Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

Oracle E-Business Suite Installation and Upgrade Notes Release 12 (12.2) for HP-UX Itanium
(Doc ID 1330704.1)

Oracle® E-Business Suite Installation and Upgrade Notes

Release 12 (12.2) for HP-UX Itanium

November 2022

See Change Record

This document updates the following documentation with HP-UX Itanium-specific information for Oracle E-Business Suite
(EBS) Release 12 (12.2). 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 E-Business Suite
Release Notes Document 1320300.1 and Oracle E-Business Suite NLS Release Notes Document 1314621.1)
• Oracle E-Business Suite Upgrade Guide: Release 11i to Release 12.2
• Oracle E-Business Suite Upgrade Guide: Release 12.0 and 12.1 to Release 12.2

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

• New Installations of Release 12.2 using the EBS Rapid Install wizard
• Upgrades of EBS from versions 11i, 12.0, 12.1 to 12.2 using the EBS Rapid Install wizard

For HP-UX Itanium installation and upgrade notes corresponding to the older Release 12.1 version, please see the My
Oracle Support Document 762891.1, Oracle E-Business Suite Installation and Upgrade Notes Release 12 (12.1.1) for HP-
UX Itanium.

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:

• Certification Information
• Operating Systems Requirements
• Software Requirements
• Other Requirements
• Before Installing or Upgrading
• Installing or Upgrading
• After Installing or Upgrading
• Unsupported Products
• Known Issues
• Change Record

CERTIFICATION INFORMATION

The latest certification information for Oracle E-Business Suite Release 12 is available on My Oracle Support's Certification
tab:

https://support.oracle.com

OPERATING SYSTEMS REQUIREMENTS

The operating system requirements for HP-UX Itanium are listed in the following sections.

1 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Operating System Supported Versions

The following table lists the supported operating system versions.

Operating System Supported Version

HP-UX Itanium 11.31

Use the following command to check the operating system version:

$ uname -r

Required Patches and Packages

The following table lists the required patches and packages and the minimum required versions for HP-UX Itanium. Unless
otherwise noted, the patches and packages must be installed manually.

Note: 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 Packages

HP-UX Itanium 11.31
• HP-UX 11i v3 1705
• March 2018 Quality Pack
• PHKL_39773 (for customers using Veritas File System (vXFS) 5.0)

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

$ /usr/sbin/swlist -l patch | more

Use the following command to check for a specific patch:

$ /usr/sbin/swlist -l patch [patchname]

Use the following command to check for a superseded patch:

$ /usr/sbin/swlist -l patch -a supersedes [patchname]

Use the following command to check for existing quality packs:

$ /usr/sbin/swlist -l bundle QPK\*

Java Requirements

A number of Java Development Kits (JDK) and Java Runtime Environments (JRE) are included with Oracle E-Business
Suite Release 12.2, the associated Oracle Database (11gR2 or 12cR1), and the bundled Application Server components
(10gR2 Forms/Reports, WebLogic Server 11gR1).

2 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

The Oracle E-Business Suite's core use of the Java runtime environment for application tier processing is with JDK version
6 (for startCD 46) or JDK version 7 (for startCD 47 and higher) as bundled in the $COMMON_TOP/util/jdk directory. The full
list of Java versions on the application and database tiers that come with Oracle E-Business Suite Release 12.2 are as
follows:

StartCD Version StartCD Version

StartCD Version
Application Tier Location 12.2.0.47 and 12.2.0.51 and
12.2.0.46
higher higher
<AS 10.1.2 Oracle Home>/jdk/bin 1.6.0.15 1.7.0.07 1.7.0.14
<FMW_HOME>/webtier/jdk/jre 1.6.0.12 1.6.0.12 1.7.0.10
<COMMON_TOP>/util/jdk 1.6.0.15 1.7.0.07 1.7.0.14

StartCD Version StartCD Version

StartCD Version
Database Tier Location 12.2.0.47 and 12.2.0.51 and
12.2.0.46
higher higher
<Oracle Database Home>/jdk 1.5.0.23 1.5.0.23 1.6.0.23
<Oracle Database Home>/appsutil/jre 1.6.0.08 1.7.0.07 1.7.0.07

Note: Check the following HP web site for the latest required or recommended patch information for Java on HP-UX
Itanium:

https://downloads.hpe.com/pub/softlib/hpuxjava-patchinfo/index.html

and review the need to upgrade the above listed Java versions for particular HP-UX Itanium systems if necessary.
Please review My Oracle Support Knowledge Document 418664.1, Overview of Using Java with Oracle E-Business
Suite Release 12 for requirements and instructions.

SOFTWARE REQUIREMENTS

The following are software requirements for HP-UX Itanium.

Install 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
• cc
• aCC_link
• make

Install the HP aC++ Linker Driver (aCC_link)

The HP aC++ Linker Driver is provided to allow linking aC++ objects for deployment on end-user systems. aCC_link is
derived from the aCC(1) interface but provides only linking functionality. Oracle E-Business Suite requires the linker as part
of its installation process.

aCC_link (CPL Product: HP-ACC-Link) is available from HP on the March 2008 (or later) Application Release (AR) media
for HP-UX 11i v3 (11.31). Information on the aC++ Linker driver can be found in the HP-UX 11i v3 Release Notes and its
corresponding manpage: aCC_link(1). The latest HP-UX 1i v3 Release Notes can be found on the HP Support Center.
Enter and select: "HP-UX Operating Systems", then "HP-UX 11i v3", select "Manuals" (on the left), then "Getting started".

3 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

HP-UX Software & Update information can be found at https://www.hpe.com/global/softwarereleases/releases-media2

/HPEredesign/pages/overview.html.

OTHER REQUIREMENTS

The following are other requirements for HP-UX Itanium.

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) = value of maxdsiz from the Kernel Settings table above
• stack (kbytes) = value of maxssiz from the Kernel Settings table above
• memory (kbytes) = unlimited
• coredump (blocks) = unlimited
• nofiles (descriptors) = 4096

Use the following command to check the ulimit settings:

$ ulimit -a

Note:

• Add the command "ulimit -c unlimited" to the apps and database user shell or login profile. This defines how
big a core file can be created should a process fail in a way that a core dump will be taken.
• Do not add any additional ulimit commands to shell or login profiles for data, stack, and nofiles. All key settings
should be set via the kernel parameters.

Kernel Settings

The following table lists the recommended kernel parameter settings for HP-UX Itanium.

Note: Verify that the following kernel parameters are set either to the formula or value shown. Refer to your
operating system documentation or contact your operating system vendor for more information on how to set kernel
parameters.

Application and Database Tiers for Single-

Parameter Application Tier for Multi-node Installation node Installation1 or Database Tier for
Multi-node Installation2
executable_stack 0 0
ksi_alloc_max (8 * nproc) (8 * nproc)
max_async_ports Default value For Database tier using async_io: 200
Otherwise, set to default value
max_thread_proc 1024 1024
maxdsiz 0xC0000000 -> 3 Gbyte 0xC0000000 -> 3 Gbyte

4 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

maxdsiz_64bit 0x100000000 -> 4 Gbyte 0x100000000 -> 4 Gbyte

Note: Customers who use 64-bit EBS
applications (such as APS) often require larger
amounts of memory and may need to increase
the value of maxdsiz_64bit to a much higher
value (e.g. 16Gb to start with). If these
applications receive an out of memory
indication, increasing this kernel parameter
further may help resolve the issue. However,
care should be exercised in not setting this value
too high. For details and usage notes on setting
this parameter, refer to the man page using the
command "man maxdsiz_64bit".
maxfiles 4096 4096
maxfiles_lim Default value 63488

maxssiz 0x04000000 -> 64 Mbyte 0x08000000 -> 128 Mbyte

maxssiz_64bit 0x10000000 -> 256 Mbyte 0x40000000 -> 1Gbyte
maxtsiz 0x40000000 -> 1 Gbyte 0x40000000 -> 1 Gbyte
maxtsiz_64bit Default value Default value
maxuprc ((nproc*9)/10)+1 ((nproc*9)/10)+1
msgmbs 8 Mbyte 8 Mbyte
msgmni nproc nproc
msgtql nproc nproc
ncsize 8976 ((8 * nproc) + 3072)
nflocks (2 * nproc) (2 * nproc)
ninode 34816 34816
Note: If you do not use HFS, then retain the Note: If you do not use HFS, then retain the
default ninode value. default ninode value.
nkthread (2 * nproc) (2 * nproc)
nproc Default value Default value
semmni (2 * nproc) (2 * nproc)
semmns (4 * nproc) (4 * nproc)
semmnu (nproc - 4) (nproc - 4)
semume 100 Default value
semvmx 32767 32767
shmmax As large as physical memory
For single-node installation: As large as physical
memory
For Application tier only:: 0x40000000 -> 1
Gbyte

shmmni nproc nproc

shmseg 512 512
vps_ceiling 256 256

5 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

vx_ninode Default value Default value

Notes:
1In a single-node installation, both application and database tiers reside on the same server.
2In a multi-node installation, the database typically resides on a different server than the application tier. This allows for
further tuning of kernel parameters to optimize performance on each tier.

Use the kctune administrative command to verify or change HP-UX kernel tunable parameters.

$ /usr/sbin/kctune

UDP and TCP Kernel Parameters

Use NDD to ensure that the kernel TCP/IP ephemeral port range is broad enough to provide enough ephemeral ports for
the anticipated server workload.

Ensure that the lower range is set to at least 9000 or higher, to avoid Well Known ports, and to avoid ports in the
Registered Ports range commonly used by Oracle and other server ports. Set the port range high enough to avoid reserved
ports for any applications you may intend to use. If the lower value of the range you have is greater than 9000, and the
range is large enough for your anticipated workload, then you can ignore OUI warnings regarding the ephemeral port
range.

Use the following command to check your current range for ephemeral ports:

# /usr/bin/ndd /dev/tcp tcp_smallest_anon_port tcp_largest_anon_port

49152
65535

In the preceding example, tcp_smallest_anon_port is set to the default range. This range is less than what Oracle
recommends. You should start dynamic allocation at a lower number that does not conflict with any other application on
your server, but will be broad enough to provide 20,000 or more ephemeral ports.

If necessary, edit the file /etc/rc.config.d/nddconf and add entries to update the UDP and TCP ephemeral port range to
9000-65500. For example:

TRANSPORT_NAME[0]=tcp
NDD_NAME[0]=tcp_largest_anon_port
NDD_VALUE[0]=65500

TRANSPORT_NAME[1]=tcp
NDD_NAME[1]=tcp_smallest_anon_port
NDD_VALUE[1]=9000

TRANSPORT_NAME[0]=udp
NDD_NAME[0]=udp_largest_anon_port
NDD_VALUE[0]=65500

TRANSPORT_NAME[1]=udp
NDD_NAME[1]=udp_smallest_anon_port
NDD_VALUE[1]=9000

Ensure that the entries are numbered in proper order. For example, if there are three entries present for TCP ports in
nddconf, then they are numbered 0 through 2: TRANSPORT_NAME[0]=tcp, TRANSPORT_NAME[1]=tcp, and
TRANSPORT_NAME[2]=tcp. The entries you add are then TRANSPORT_NAME[3]=tcp and TRANSPORT_NAME[4]=tcp.

Host Names Settings

6 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

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]

Note: Ensure that the hostname length does not exceed 8 characters.

Secure Shell (SSH)

In order to successfully perform Online Patching in a multi-node environment, please choose one of the following options:

• Follow the guidelines in the Principles sub-section under Set Up Secure Shell on Application Tier Nodes in Chapter 3
(Patching Procedures) of the Oracle E-Business Suite Maintenance Guide Release 12.2.

Note: Do not use the 'txkRunSSHSetup.pl' utility as there is a known limitation which precludes the usage of
its "enable", "disable", and "verify" functions.

• Utilize any available native solution to set up and configure passwordless SSH login between the application tier
nodes.

BEFORE INSTALLING OR UPGRADING

Note: If the Release 12.2 installation or upgrade is performed with the Rapid Install wizard (either a new R12
installation or upgrade from 11i or 12.0/12.1 to 12.2), it is recommended to use the latest StartCD version and any
additional bundle patches in order to obtain the newest set of patches and other technologies required to successfully
install and run E-Business Suite. Please review the "Current Version of startCD" section in My Oracle Support
Knowledge Document 1320300.1, Oracle E-Business Suite Release Notes, Release 12.2 for more information.

Note: If you plan to store your Oracle datafiles on NAS devices, use the correct mount options (-forcedirectio) as
directed in the Oracle Database Installation Guide for your database release.

Note: You should review the Known Issues section to implement any required actions if necessary.

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

OPMN port conflict

Note: By default, the OPMN service of the Application Server technology stack listens on port 6000 when started up
during RapidInstall. This can conflict with the X11 port used for the graphics console on HP-UX servers and prevent
the RapidInstall from completing.

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

7 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

• Disable the graphics console login process on the HP-UX server. This can be accomplished by logging in as the
UNIX root user and issuing the following commands:
◦ Shutdown the dtlogin process with the command "/sbin/init.d/dtlogin.rc stop"
◦ Confirm that nothing is listening at port 6000 ("netstat -a | grep 6000")
◦ Disable the local X console for dtlogin by editing /etc/dt/config/Xservers. The local console specification is at
the end of the file. Comment the line out.
◦ Restart dtlogin ("/sbin/init.d/dtlogin.rc start")

MLOCK Privilege

To permit the Oracle database to process asynchronous I/O operations, the OSDBA group (dba) must have the MLOCK
privilege. For instructions on how to grant the dba group the MLOCK privilege, refer to the "Administering Oracle Database
on HP-UX" appendix in the Oracle Database Administrator's Reference for UNIX-Based Operating Systems for your Oracle
database version.

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.2 or Oracle E-Business Suite Upgrade Guide:
Release 12.0 and 12.1 to Release 12.2) 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.2 and before allowing users to access the system.

SHLIB_PATH and LD_LIBRARY_PATH Environment Variables

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 two places:

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

In the AutoConfig interface, this corresponds to:

Location Parameter
adovars LD_LIBRARY_PATH
tools_home (10.1.2) 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

8 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

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

Note: See Applications DBA System Maintenance Tasks and Tools in the Oracle E-Business Suite Maintenance Guide
for more information on AutoConfig.

Net Service Listeners in Multi-user Installations

Net Service Listeners use the /tmp/.oracle directory to store temporary files. In a multi-user installation of E-Business Suite,
it is required that the /tmp/.oracle file be owned by the Oracle OS user oracle while the Apps OS user applmgr should also
have read/write/execute permissions in this directory. Use the following command to set the permissions appropriately:

$ chmod <options> /tmp/.oracle

Review the 'Before You Install' section of Chapter 1 of Oracle E-Business Suite Installation Guide: Using Rapid Install for
information on user accounts.

Review Disk Asynchronous Input-Output Initialization Parameter Setting

Oracle Database 11.2.0.3 (or 12.1.0.2 with StartCD51), which is installed by Rapid Install, mandates that HP-UX customers
using a file system for database file storage must set disk_asynch_io=FALSE in the database initialization file (i.e.
init<SID>.ora). By default, the value of disk_asynch_io is TRUE.
See Appendix C "Administering Oracle Database on HP-UX" in Oracle Database Administrator's Reference 11g Release 2
(11.2) for Linux and UNIX-Based Operating Systems for more information (for 12.1.0.2, see Appendix D "Administering
Oracle Database on HP-UX" in Oracle Database Administrator's Reference 12c Release 1 (12.1) for Linux and UNIX-
Based Operating Systems).

UNSUPPORTED PRODUCTS

The following products are currently not supported on the HP-UX Itanium operating system:

Product
Oracle Field Sales
Oracle Mobile Field Service

KNOWN ISSUES

The following are known issues for this release.

vx_iget - inode table overflow error

This error has been observed on some HP-UX servers during the EBS installation process, resulting in a failed RapidWiz
installation. The error message could appear in the shell window from which RapidWiz was launched as well as the system
log file (/var/adm/syslog/syslog.log). The problem occurs only on servers where the kernel parameter vx_ninode has been
set to a non-default value that is insufficient for the number of active files during the installation process. To resolve the
error, reset the parameter to its default with the command kctune vx_ninode=Default. This kernel parameter is dynamic in
HP-UX 11.31 (no reboot is required). The EBS installation process can then be restarted.

Limitation of Demand Planning and Service Parts Planning due to dependency on Matlab library

Service Parts Planning incorporates the Demantra product which has a dependency on a third-party product called Matlab
whose libraries are not available on HP-UX Itanium. If you plan to use Service Parts Planning, you must run the SPP Java

9 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

concurrent program on a platform that supports these libraries and set up a specialized Concurrent Manager. Please refer
to My Oracle Support Knowledge Document 731363.1, Setup Instructions- Inline Forecast Support on HP-UX Itanium for
detailed information.

Intermittent Failure of OACore Services

OACore Services will fail intermittently due to WebLogic monitoring of /dev/poll. Users may see the following error
message:

java.io.IOException: DP_POLL failed for /dev/poll

To avoid this issue, /dev/poll monitoring of polled file descriptors needs to be disabled. Please review sub-section
"Customizing Managed Server Configuration via WebLogic Server Administration Console" in My Oracle Support
Knowledge Document 1905593.1, Managing Configuration of Oracle HTTP Server and Web Application Services in Oracle
E-Business Suite Release 12.2 to disable /dev/poll monitoring and make sure the following actions are performed:

• Choose 'oacore' as the managed server which needs the configuration change
• Add the new server start-up argument: -Dweblogic.DevPollDisabled=true
• Save and Activate the configuration change

CHANGE RECORD

Date Description

18-Nov-2022 12.2.12 release

10-Nov-2021 12.2.11 release

25-Sep-2020 12.2.10 Release; cleanup

25-Jul-2019 Removed APS 64-bit 16992927:R12.MSC.C patch requirement

29-Aug-2018 Revise OS patch requirements

11-Jun-2018 Revise OS version and Quality Pack requirements

21-Mar-2018 Uprade OS patch requirements and startCD JDK versions

21-Feb-2018 Update QPK requirement and update aCC_link reference information

22-Aug-2016 Updated for 12.2.6 release

22-Mar-2016 Revise MAXTSIZ kernel setting requirement for single-node column

18-Feb-2016 Add StartCD51 updates

21-Jan-2016 Miscellaneous updates (broken links, OS required patches, Known Issues)

22-Sep-2015 Updated for 12.2.5

3-Aug-2015 Update link for aCC_link due to HP site reorg

18-Mar-2015 Add clarification regarding limitations for SSH setup

10 of 11 24-01-2023, 08:36
Document 1330704.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

4-Jun-2014 Add recommendation to use latest startCD

29-May-2014 Revise "startCD 47" references to read "startCD 47 and higher"

2-Apr-2014 Revise column header for Kernel Settings table

Add JDK 7 to Java requirements section

8-Dec-2013 Remove superseded patches PHCO_38050 and PHKL_40208
Clarified known issue with RAC/shared OH as being for StartCD 46 only

2-Oct-2013 Add known issue regarding Shared OracleHome option on RAC

19-Sep-2013 Initial release for 12.2 GA

Oracle E-Business Suite Installation and Upgrade Notes Release (12.2) for HP-UX Itanium

My Oracle Support Knowledge Document 1330704.1 by Oracle E-Business Suite Development.

Copyright © 2013, 2022, Oracle and/or its affiliates.

Didn't find what you are looking for?

11 of 11 24-01-2023, 08:36