Skip Headers
Oracle® Fusion Applications Installation Guide
11g Release 7 (11.1.7)

Part Number E16600-24
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Preparing for an Installation

This chapter describes the prerequisites for provisioning a new applications environment.

This chapter includes the following sections:

2.1 Provisioning Prerequisites

To provision a new Oracle Fusion Applications environment, you must ensure that your system meets certain requirements and that you perform the necessary prerequisite tasks in preparation for an installation of Oracle Fusion Applications product offerings.

Review the following prerequisites:

2.1.1 System Requirements

This release of Oracle Fusion Applications relies on supported platforms documentation for Oracle Fusion Applications to supply certified versions of Oracle components. This documentation provides details about hardware and software, minimum disk space and memory requirements, required system libraries, packages, or patches, and minimum database requirements. Consult an Oracle Fusion Applications sizing-certified representative to obtain specific, customized system hardware requirements.

Note:

The self-signed certificate is set to three years when provisioning is complete.

2.1.1.1 Download Instructions

If you are downloading Oracle Fusion Applications 11g Media Pack for the following platforms, then use the following versions of the 64-bit UnZip utility to extract the Oracle software. UnZip is freeware that is available at: http://www.info-zip.org.

  • IBM AIX on POWER Systems (64-bit) - Info-ZIP unzip version 6.10

  • Oracle Solaris on SPARC (64-bit) - Info-ZIP unzip version 6.0

  • Oracle Solaris on x86-64 (64-bit) - Info-ZIP unzip version 6.0

If you are downloading Oracle Fusion Applications 11g Media Pack for the Microsoft Windows x64 (64-Bit) platform, then use 7zip v9.20 to extract the Oracle software.

2.1.2 Supported Platforms

Oracle Fusion Applications is supported on the following platforms:

  • Linux x86-64

  • Oracle Solaris

  • IBM AIX on POWER Systems (64-Bit)

  • Microsoft Windows x64 (64-Bit)

As the Oracle Fusion Applications 11g Media Pack is specific for a platform, you must install Oracle Fusion Applications on the same platform. This includes the Oracle Database, Oracle Identity Management, and Oracle Fusion Applications.

2.1.3 Installing Oracle Database

Oracle Fusion Applications supports only Oracle Database 11.2.0.3 for storing transactional data. You can install either a single-instance Oracle Enterprise Edition Database or Oracle Real Application Clusters. See Chapter 3 for more information about database installations.

2.1.4 Installing Oracle Identity Management Components

Review this section to learn about Oracle Identity Management components required for Oracle Fusion Applications, review references to documentation about installing those components, and read about how to create an IDM properties file that can supply default configuration parameters in your response file.

Note:

You must install Oracle Identity Management and Oracle Fusion Applications on different hosts. Installing Oracle Identity Management and Oracle Fusion Applications on the same host is not a supported topology.

You should not share the same database instance for Oracle Identity Management and Oracle Fusion Applications. Oracle Fusion Applications should have a separate database instance.

2.1.4.1 Oracle Identity Management Overview

The following sections provide an overview of the Oracle Identity Management required components, IDM properties file, and patches for Oracle Fusion Applications 11g Release 7 (11.1.7).

2.1.4.2 Required Components

These components must be installed and configured specifically for use with Oracle Fusion Applications.

  • One instance of Oracle Database 11.2.0.3 where the Identity Store and the Policy Store are in the same OID in a dedicated setup.

  • Oracle Internet Directory 11g (OID)

  • Oracle Virtual Directory 11g (OVD)

  • Oracle Identity Manager 11g (OIM)

  • Oracle Access Manager 11g (OAM)

Follow the instructions in Oracle Fusion Middleware Identity Management Provisioning Guide (Oracle Fusion Applications Edition) to install and configure these components. Keep a record of the configuration details. You must supply them to the Oracle Fusion Applications Provisioning Wizard when you create your response file.

Apply all mandatory Oracle Identity Management patches, as listed in the "Oracle Identity Management Patches for the FA Domain" section of Oracle Fusion Applications release notes.

See Section 4.1, "Introduction to Response Files" for information about the configuration details required by provisioning. For specific information about how provisioning links the Oracle Identity Management components and your new applications environment, see Section 4.1.3, "Wizard Actions for Oracle Identity Management Components" and Section 5.1.3, "Installation Phase Actions for Oracle Identity Management Components".

2.1.4.3 Using the IDM Properties File

A properties file, idmsetup.properties, is automatically generated during the provisioning of an Oracle Identity Management enviroment. This file includes some of the configuration values that you must supply to the Provisioning Wizard when you create a response file. These values must be included in your response file to integrate Oracle Identity Management components with an Oracle Fusion Applications environment.

Example 2-1 Sample idmsetup.properties file

#OIM Domain information
WLSHOST: <adminserver_virtualhostname>
WLSPORT: 7001
WLSADMIN: weblogic_idm
 
#OAM Domain information
OAM11G_WLS_ADMIN_PORT: 7001
OAM11G_WLS_ADMIN_USER: weblogic_idm
OAM11G_WLS_ADMIN_HOST: <adminserver_virtualhostname>
 
# Access server information
OAM11G_OIM_INTEGRATION_REQ: true
ACCESS_SERVER_PORT: 5575
OAM11G_ACCESS_SERVER_HOST: <identity_host_name>
OAM11G_ACCESS_SERVER_PORT: 5575
OAM11G_SSO_ONLY_FLAG: true
ACCESS_SERVER_HOST: <identity_host_name>
OAM11G_IDSTORE_ROLE_SECURITY_ADMIN: OAMAdministrators
OAM11G_OIM_OHS_URL: https://<sso_lbr_endpoint>:443
OAM_MNGSERVER_PORT : 14100
 
#policy store
POLICYSTORE_CONTAINER: cn=jpsroot
POLICYSTORE_HOST: <oid_lbr_endpoint>
POLICYSTORE_PORT: 3060
POLICYSTORE_READONLYUSER : cn=IDMPolicyROUser,cn=Users,dc=us,dc=oracle,dc=com
POLICYSTORE_READWRITE_USERNAME : cn=IDMPolicyRWUser,cn=Users,dc=us,dc=oracle,dc=com
FA_POLICYSTORE_CONTAINER: cn=FAPolicies
FA_POLICYSTORE_READONLYUSER : cn=PolicyROUser,cn=Users,dc=us,dc=oracle,dc=com
FA_POLICYSTORE_READWRITE_USERNAME : cn=PolicyRWUser,cn=Users,dc=us,dc=oracle,dc=com
 
#idstore -oid info
IDSTORE_HOST : <ovd_lbr_endpoint>
IDSTORE_PORT : 6501
IDSTORE_READONLYUSER : cn=IDROUser,cn=Users,dc=us,dc=oracle,dc=com
IDSTORE_READWRITEUSER : cn=IDRWUser,cn=Users,dc=us,dc=oracle,dc=com
IDSTORE_USERSEARCHBASE : cn=Users,dc=us,dc=oracle,dc=com
IDSTORE_GROUPSEARCHBASE : cn=Groups,dc=us,dc=oracle,dc=com
IDSTORE_SUPERUSER : cn=orcladmin
IDSTORE_LOGINATTRIBUTE : uid
IDSTORE_USERNAMEATTRIBUTE : uid
#pstore -oid info
PSTORE_HOST : <oid_lbr_endpoint>
PSTORE_PORT : 3060
PSTORE_USERSEARCHBASE : cn=Users,dc=us,dc=oracle,dc=com
PSTORE_GROUPSEARCHBASE : cn=Groups,dc=us,dc=oracle,dc=com
PSTORE_SUPERUSER : cn=orcladmin
 
#OIM server information
OIM_FRONT_END_HOST : <sso_lbr_endpoint>
OIM_FRONT_END_PORT : 443
OIM_T3_HOST : <identity_host_name>
OIM_T3_PORT : 14000
OIM_HTTP_INTERNAL_URL : http://<idminternal_lbr_endpoint>:80
OIM_HTTPS_URL : https://<sso_lbr_endpoint>:443
OIM_ADMIN_USER_DN : cn=oimAdminUser,cn=systemids,dc=us,dc=oracle,dc=com
 
#Extra parameters for automation
OID_SSL_PORT : 7501
IDM_KEYSTORE_FILE_LOC : <shared_config_location>/fa/idmcerts.jks 
IDM_DB_HOST : <idmdb_host_name>
IDM_DB_PORT : 5521
IDM_DB_SERVICE : <idmdb_service_name>
IDM_DB_USERNAME : FA_MDS
OAM_ACCESS_SERVER_ID : wls_oam1
OAM_ADMIN_USER : oamAdminUser
OAM11G_OAM_ADMIN_USER : oamAdminUser
POLICY_STORE_SSL_PORT : 3131
OHS_HOST : <webtier_host_name>
OHS_PORT : 7777
OHS_SSL_PORT : 4443
OHS_INSTANCE_HOME : /u02/local/oracle/config/instances/ohs1
ADMIN_DN : cn=IDM Administrators,cn=Groups,dc=us,dc=oracle,dc=com
IDM_DB_OH_HOME : 
IDM_OID_OH_HOME : /u01/oracle/idmtop/products/dir
IDM_OHS_OH_HOME : /u01/oracle/idmtop/products/ohs
IDM_OIM_OH_HOME : /u01/oracle/idmtop/products/app
IDM_OIM_SERVER : /u01/oracle/idmtop/products/app/iam/server 
IDM_DB_TYPE : enterprise
OIM_MDS_RACDB_PARAMS :
OIM_ADMIN_USERNAME : xelsysadm
OIM_DOMAIN_HOME : /u01/oracle/config/domains/IDMDomain
OIM_PROTOCOL : http
OIM_EM_URL : http://<webtier_host_name>:7777/em
POLICY_STORE_ADMINUSER : cn=orcladmin
OVD_HOST : <ovd_lbr_endpoint>
OVD_PORT : 6501
IDM_OIM_HOME_NFS_PATH : <shared_idmtop_location>/products/app/iam
OAM_POLICYSTORE_USER : cn=oamSoftwareUser,cn=systemids,dc=us,dc=oracle,dc=com
SUPER_USER_NAME : FAAdmin
SSL_ENABLED : false
POLICYSTORE_OID_SEARCH_DN : dc=us,dc=oracle,dc=com
EM_URL : http://<admin_lbr_endpoint>:80/em
IDM_OIM_SERVER_DIR : /u01/oracle/idmtop/products/app/iam/server
IDM_OIM_DC_HOME : /u01/oracle/idmtop/products/app/iam/designconsole
IDM_APPSERVER_HOME : /u01/oracle/idmtop/products/app/wlserver_10.3
IDM_SOA_HOME : /u01/oracle/idmtop/products/app/soa
IDM_SOA_HOST : <identity_host_name>
IDM_SOA_PORT : 8001
IDM_DB_ORASDPM_USERNAME : FA_ORASDPM
IDM_IDSTORE_INSTANCE_HOME : /u02/local/oracle/config/instances/oid1
IDM_OHS_ORACLE_HOME : /u01/oracle/idmtop/products/ohs/ohs
RESERVE_BASE_DN : cn=reserve,dc=us,dc=oracle,dc=com
OIF_HOST : <identity_host_name>
OIF_PORT : 7499

Select the Load IDM Configuration from IDM Properties file option available on the IDM Properties File screen of the Oracle Fusion Applications Provisioning Wizard, if you want the values on the Identity Management Configuration screen and the Access and Policy Management Configuration screen to default to the values in the IDM properties file. You must however review these screens to ensure that all values are accurate before proceeding to the next screen.

The properties file is created in:

SHARED_CONFIG_DIR/fa/idmsetup.properties, where SHARED_CONFIG_DIR is the shared configuration location that you selected in the Install Location Configuration page of the Oracle Identity Management Provisioning Wizard.

For more information about the IDM properties file, see "Pass Configuration Properties File to Oracle Fusion Applications" in the Oracle Fusion Middleware Identity Management Provisioning Guide (Oracle Fusion Applications Edition).

2.1.4.4 Oracle Identity Management Patches for the IDM Domain

For details about the Oracle Identity Management Patches for the IDM Domain, see "Chapter 6, Patching Oracle Identity Management Artifacts" in the Oracle Fusion Applications Patching Guide.

2.1.4.4.1 Additional Mandatory Patches for the IDM Domain

Follow the steps detailed in "Additional Mandatory Patches for the IDM Domain" in the Oracle Fusion Applications release notes.

2.1.5 Recommended Installation for Security

Consider installing Oracle Enterprise Governance, Risk and Compliance (GRC) with Oracle Fusion Applications. Although not required, GRC can serve as part of the user provisioning flow to ensure that proper controls for security exist. For more information, see "Security Components: How They Fit Together" in the Oracle Fusion Applications Security Guide and the Oracle Application Access Controls Governer Implementation Guide.

2.1.6 Known Issues

This section describes the platform specific known issues and their resolution.

2.1.6.1 Xcopy Utility Should Not Be Used To Copy Fusion Application Repositories and Appltop on Microsoft Windows

The Microsoft Windows utility Xcopy does not copy long path names. Therefore, do not use Xcopy to copy Fusion Applications repositories and APPLTOP.

Resolution: Use Robocopy instead of Xcopy.

2.1.6.2 ODI Offline Pre-Verification Fails on Microsoft Windows

On Microsoft Windows, if Oracle WebCenter Content Management is not installed properly, ODI Offline Preverification fails in Oracle Fusion Applications Release Update Patches (RUP) Installer.Oracle WebCenter Content Management install fails with the following error:

[C\AT\fusionapps\ecm\ucm\Distribution\Kofax\Autorun.inf (Access is denied)]

Resolution:

  1. Disable Prevent remote creation of autorun files from McAfee ePolicy Orchestrator (ePO) in the FusionApp Windows boxes before starting the RUP Installer.

  2. When the install is done, enable it again.

2.2 Preparing Your Applications Environment

Before creating your new environment, review the following actions in this section to help ensure a smooth installation.

2.2.1 Tune the Socket Buffer Size (AIX Only)

For IBM AIX on POWER Systems (64-Bit) platforms, run the following commands as the root user:

no -o rfc1323=1

no -o sb_max = 4194304

2.2.2 Set the SKIP_SLIBCLEAN Variable (AIX Only)

For IBM AIX on POWER Systems (64-Bit) platforms, the provisioning install phase installs the Oracle Database client and a database patch update. To prepare your environment for this action, set the SKIP_SLIBCLEAN environment variable as follows:

SKIP_SLIBCLEAN = TRUE;export SKIP_SLIBCLEAN;

Run /usr/sbin/slibclean as root and ensure that the value TRUE is in uppercase as this value is case sensitive.

2.2.3 Add Variable for SKIP_ROOTPRE to Command Line (AIX Only)

When installing a transaction database with the Provisioning Wizard on IBM AIX on POWER Systems (64-bit), you must add the following variable to the command line syntax used to start the wizard:

export SKIP_ROOTPRE=TRUE

2.2.4 Improve Provisioning Performance (AIX Only)

On IBM AIX on POWER Systems (64-Bit) systems, the provisioning performance slows down or times out when the Oracle Fusion Applications Provisioning host, the Oracle Database host, and the Oracle Identity Management host are located in different subnets or when these hosts are situated at a distance of more than four network hops.

For provisioning, use the hosts that are located in the same subnet or the hosts that are within a distance of four network hops.

2.2.5 Check for the Required Solaris Patch (Solaris Only)

For Oracle Solaris platforms, ensure that the Solaris Operating System patch 144540-01 is installed on the servers. Do this for both Oracle Solaris on SPARC (64-Bit) and Oracle Solaris on x86-64 (64-Bit) platforms. The Solaris OS patch 144540-01 can be obtained from My Oracle Support.

2.2.6 Increase the Open Files Limit

Increase the limit of open files to 16384 or higher for the operating system.

For Linux x86-64:

Modify /etc/security/limits.conf to read as follows:

  • FUSION_USER_ACCOUNT soft nofile 327679

  • FUSION_USER_ACCOUNT hard nofile 327679

Edit /etc/ssh/sshd_config as follows:

  1. Set UsePAM to Yes.

  2. Restart sshd.

  3. Logout (or reboot) and log in again.

Increase the maximum open files limit.

Edit /proc/sys/fs/file-max and set it to 6553600. The change becomes effective immediately but does not persist after a reboot. To make the change permanent edit /etc/sysctl.conf and set fs.file-max = 6553600. This change will not be effective until the sysctl command is run or the server is rebooted.

For Oracle Solaris on SPARC (64-Bit):

Edit /etc/system and set as follows:

set rlim_fd_cur=327679

set rlim_fd_max=327679

For IBM AIX on POWER Systems (64-Bit):

Modify /etc/security/limits defaults to read as follows:

fsize = -1

core = 2097151

cpu = -1

data = 1024000

rss = 512000

stack = -1

stack_hard = -1

nofiles = 327679

nofiles_hard = 327679

Note:

Do not set nofiles and nofiles_hard parameters to -1 on IBM AIX platforms. Use the recommended values specified in this section. Setting the parameters to -1 (unlimited) will cause the postconfigure phase to fail with an error message: Too many open files, when the provisioning process tries to start up managed servers, such as the HelpPortalServer.

Note:

If you select any Supply Chain Management offerings, then the host where the Global Order Promising (GOP) server is located has a different requirement for the data segment (data) setting. The data segment for the host running the GOP server should be set to a minimum of 2 GB (2097152) or higher.

This means instead of setting data = 1024000 in the /etc/security/limits file on the host where the GOP server is located, you should set data = 2097152 (or a larger number).

For All Platforms:

Typically, you would have max user processes set to 16384:

$ulimit -u
16384

2.2.7 Verify Swap Space (Unix)

For Unix platforms, ensure that the provisioning hosts have a miminum of 1 GB of swap space. During the provisioning of an Oracle Fusion Applications environment, a validation test is performed in the preverify phase. An error message is displayed if the provisioning hosts do not have at least 1 GB of swap space. This error must be resolved by increasing the swap space before you can proceed with provisioning the environment.

You will receive a warning if there is at least 1 GB of swap space but less than the larger of 2 GB and 10% of memory allocated to the host. This means if a host has less than 20 GB of memory, then the swap space must be at least 2 GB. If a host has more than 20 GB of memory, then the swap space must be at least 10% of the memory.

The decision on whether to set swap space higher than 10% of the memory is a performance tuning exercise that you can make at a later time. Under certain conditions in some platforms, you may need to increase swap space to 30% of the memory in order to complete provisioning an environment.

2.2.8 Edit Host Names (Unix)

For Unix platforms, confirm that the host names are correctly formatted in /etc/hosts, for each host that is participating in provisioning. Review /etc/hosts for each participating host and edit any host entries that do not meet the following recommendations:

  1. The format for each host entry should follow this format:

    IP_address canonical_hostname [aliases]
    

    The canonical_hostname should be the same as the fully qualified host name. Errors can occur if a short version, or alias, of the host name is specified first in /etc/hosts. The usage of aliases is optional and can be left empty. Examples of correct and incorrect entries follow:

    (Correct) 141.80.151.100 myMachine.company.com  myMachine
    (Incorrect) 141.80.151.100  myMachine  myMachine.company.com
    
  2. If the machine name is a logical host name and is different from the physical host name specified in /etc/sysconfig/network, then the entry for the logical machine should be listed before the entry of the physical host name in /etc/hosts. If the machine is always accessed using its logical host name, there is no need to have an entry for the physical host name in /etc/hosts. Examples of entries in the correct order follow:

    141.80.151.100 myLogicalMachine.company.com  myLogicalMachine
    141.80.151.100 myPhysicalMachine.company.com  myPhysicalMachine
    

    If the order of host names is reversed from what is shown in the example, then there may be errors in retrieving the logical host name.

Note:

Do not enter multiple host aliases into a single line in the /etc/hosts file. There are some software components which do not process a line with more than 700 characters. You may encounter error messages during provisioning phases, such as "UNABLE TO OPEN CREDENTIAL STOREFAILED TO ADUTPSINITIALIZE" caused by incorrect resolution of the host names. If you have a host that has many aliases, then limit the line to 700 characters and break it down into separate lines. Ensure that each line begins with the IP_address and canonical_hostname, then the aliases.

2.2.9 Increase Entropy Values (Linux)

Make sure the hosts have enough entropy values in the provisioning hosts. If this value is less than 1000, increase it to a value to a greater value using the rngd command. Run these commands as the root user for the current session:

To check the entropy value:

cat /proc/sys/kernel/random/entropy_avail

To increase the entropy value:

rngd -r /dev/urandom -o /dev/random

To set the rngd service to start automatically after rebooting the host, enter the following text into a script, such as, start.rngd, and run the script as root user:

#! /usr/bin/perl -w 
 . 
 # minimum required bytes to be happy with the device 
 my $want_bytes = 8192; 
 . 
 # list of commands to check 
 my clist = qw(/sbin/rngd /usr/sbin/rngd); S
 . 
 # list of device names to check 
 my slist = qw( 
   /dev/hwrandom /dev/hw_random /dev/hwrng /dev/intel_rng /dev/i810_rng 
   /dev/urandom 
 ); 
 . 
 . 
 use Fcntl qw(O_RDONLY); 
 . 
 # find the rngd binary 
 my $command; 
 . 
 foreach (clist) { 
   -x && ($command = $_) && last; 
 } 
 . 
 # stop if rngd isn't installed 
 defined $command || die "$0 error: rngd is not installed\n"; 
 . 
 . 
 # look for a hw random device 
 my $source; 
 my $continue = 1; 
 $SIG{'ALRM'} = sub { $continue = 0 }; 
 . 
 foreach my $test (slist) { 
   -e $test || next; 
 . 
   alarm 2; 
   $continue = 1; 
 . 
   my $bytes = 0; 
 . 
   sysopen FILE, $test, O_RDONLY or next; 
   while ($continue) { 
     sysread FILE, $_, 4096 or last; 
     $bytes += length $_; 
   } 
   close FILE; 
 . 
   if ($bytes > $want_bytes) { 
     $source = $test; 
     last; 
   } 
 } 
 . 
 . 
 # use the select command and source 
 print "starting $command with $source... "; 
 system "$command -r $source"; 
 print "done.\n"; 
 . 
 exit 0; 

2.2.10 Set Up the Server and the Shared Area Permissions (Windows x64)

For Microsoft Windows x64 (64-Bit) platforms, complete these steps on each provisioning host:

  1. Create a domain\user that is part of the Administrators group.

  2. Log in as the user that you created.

  3. Run secpol.msc (security policy) and add the domain\user that you created to "Log on as service" under the Local Policies, User Rights Assignment option.

  4. Create a folder on a shared disk which will be the Oracle Fusion Applications Home (denote this location as APPLICATIONS_BASE). The folder must be accessible to all hosts in the provisioned environment. The name of the folder must not exceed eight characters. For example, create a folder called appbase under \ComputerName and refer to the folder as \ComputerName\appbase. Next, you must share this folder with the Windows domain user who will be provisioning the Oracle Fusion Applications environment and give that user read/write permissions to the shared folder as follows:

    1. In Windows Explorer, right click on the appbase folder and select Properties from the context menu.

    2. In the Properties window, click the Sharing tab, then click Share.

    3. In the File Sharing window enter the domain user name using the format DomainName\userid.

    4. Click Add. This adds the given domain user name to the list of users whom the folder is shared with.

    5. Select the domain user name that has been added and change the permission level to Read/Write.

    6. Click Share and then click Done to save and close the File Sharing window.

    7. Click Close to close the Properties window.

  5. Create a symbolic link to the folder that you created in Step 4. Perform this step on all hosts to be provisioned. For example, at the MS-DOS prompt, type the following:

    C:\>mklink /d C:\falink \ComputerName\appbase

    Make note of the location and the name of the symbolic link. Later when you create the provisioning response file, enter C:\falink in the Oracle Fusion Applications Home field.

    Note:

    For non-Windows platforms, you must enter the full file path in the Provisioning Wizard UI when prompted (for example, Oracle Fusion Applications Home, Applications Configuration Directory, and so on). Using symbolic link paths will cause provisioning failure in the later phases.

  6. Confirm that a file or folder can be created through the symbolic link from all hosts in the provisioned environment.

  7. If you choose not to use the default location, APPLICATIONS_BASE\instance, as the Applications Configuration Directory, then repeat Steps 5 and 6 to create another symbolic link to the location of your choice. Later when you create the provisioning response file, enter the newly created symbolic link in the Applications Configuration Directory field. If you choose to use the default location, for example, then enter C:\falink\instance in the Applications Configuration Directory field.

2.2.11 Update Virtual Memory setting to Custom Size (Windows Only)

Before provisioning, change the Virtual Memory setting to Custom Size in the Advanced System Settings of the Microsoft Windows operation system. The recommended Initial Size is one and one-half times the physical RAM and Maximum Size is three times the physical RAM.

2.2.12 Microsoft Windows Resource Locking (Windows Only)

Ensure that no other windows or sessions are open while running provisioning. Do not access any of the files or directories under APPLICATIONS_BASE/instance/, which can create locking of the resources and cause failure.

2.2.13 Define the Local Port Range

You must define your local port range to ensure that it does not overlap with the ports used by the Java Virtual Machines (JVMs) and other servers. This action avoids port conflicts during server startup. To view and modify localRange:

For Linux x86-64:

To view:

$cat /proc/sys/net/ipv4/ip_local_port_range

To modify:

$echo "32768 61000" > /proc/sys/net/ipv4/ip_local_port_range

To make the local port range permanent after server restart, add (or update) the following line in /etc/sysctl.conf:

net.ipv4.ip_local_port_range = 32768 61000

For Oracle Solaris

To view:

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

To modify:

#/usr/sbin/ndd -set /dev/tcp tcp_smallest_anon_port 32768

#/usr/sbin/ndd -set /dev/tcp tcp_largest_anon_port 61000

For IBM AIX on POWER Systems (64-Bit):

To view:

#/usr/sbin/no -a | fgrep ephemeral

To modify:

#/usr/sbin/no -o tcp_ephemeral_low=32768 -o tcp_ephemeral_high=61000

Typically, the port range settings would be as follows:

$ /usr/sbin/no -a | fgrep ephemeral
     tcp_ephemeral_high = 61000
     tcp_ephemeral_low = 32768
     udp_ephemeral_high = 61000
     udp_ephemeral_low = 32768

For more information about setting port values, see "Viewing and Changing Ports for Components" in Oracle Fusion Applications Administrator's Guide.

2.2.14 Synchronize the System Clocks

All engine and data tier servers (including SIP) must accurately synchronize their system clocks to a common time source, to within one or two milliseconds. Large differences in system clocks can cause severe problems.

2.2.15 Support for File Locking (UNIX)

The shared drive such as, Network File System (NFS) or Common Internet File System (CIFS) must support file locking. For NFS Version 3 and NFS Version 4 , the advisory locking must be configured for the NFS mount. This applies to all UNIX platforms.

2.2.16 Synchronize Date Time Stamp

Before provisioning, ensure that the provisioning server and the computer hosting Oracle Access Server have the same date and time stamp settings. The WebGate installation fails with an Oracle Access Manager certificate error if the date and time settings on the provisioning server are different from the Oracle Access Server.

2.2.17 Set the Kernel Parameter Value

Before you install the Oracle Database using the Provisioning Wizard, ensure that the value of the kernel parameter shmmax on the database host is greater than the value of the System Global Area (SGA) Memory.

The value of SGA Memory (sga_target) is 9 GB in the default Database Configuration Assistant (DBCA) template for the Starter database. If you are running DBCA using the production DBCA template packaged with Oracle Fusion Applications Provisioning, the value of the SGA Memory is 18 GB. Ensure that shmmax > (shmall * shmmni) > SGA Memory, where shmmax, shmall, shmmni are kernel parameters.

For example, to retrieve the values of these kernel parameters on Linux, use the following command:

user@host> /sbin/sysctl -a | grep shm 
kernel.shmmni = 4096 
kernel.shmall = 3145728 
kernel.shmmax = 12884901888

To set the value of a kernel parameter:

user@host> /sbin/sysctl -w sys.kernel.shmmax=value

2.2.18 Unset LIBPATH Variable

Before provisioning an Oracle Fusion Applications environment make sure the LIBPATH variable is not set. See Section 5.4.1 for details.

For Unix:

  • Use env or echo $LIBPATH to check if the variable is set.

  • Use unsetenv LIBPATH to unset the variable.

2.2.19 Monitor Disk Space Available for /tmp (UNIX)

For each provisioning host, ensure that there is atleast 4 GB free space available for /tmp before installing Oracle Fusion Applications on the provisioning hosts. If the disk space for /tmp is low, you will encounter performance issues. In this case, you should make disk space available or restart the hosts to clean up /tmp.

2.2.20 Default Shell (UNIX)

Oracle Fusion Applications provisioning uses "Bash" as the default shell on Unix platforms. Make sure /bin/bash shell is installed on the hosts before provisioning an Oracle Fusion Applications environment.

2.2.21 Install en_US.UTF-8 Locale (Unix)

If you are provisioning on Unix platforms, ensure that the en_US.UTF-8 locale is installed on the operating system of the provisioning hosts. Oracle Business Intelligence expects the en_US.UTF-8 locale in the operating system before provisioning the Oracle Fusion Applications environment. If the en-US.UTF-8 locale is not installed, you will encounter an error during the provisioning configure phase. The runProvisioning-bi-configure.log displays the following error message:

FAILED:Distributing Repository

Error:

<APPLICATIONS_BASE>/fusionapps/bi/bifoundation/provision/scripts/bidomain/bi-install.xml:274: exec returned: 1.

Inspecting the oraInventory logs, it indicates that the EN_US.UTF-8 locale must be installed on the provisioning host for Oracle Business Intelligence. The error message is:

Executing Task: Distributing Repository

[CONFIG]:Distributing Repository

ReEncrypting RPD: [nQSError: 46116] The locale EN_US.UTF-8 needs to be installed on the machine for the Oracle BI locale setting english-usa specified in NQSConfig.INI.javax.management.RuntimeMBeanException:javax.management.RuntimeMBeanException: Repository File '<APPLICATIONS_CONFIG>/BIInstance/tmp/OracleBIApps.rpd' does not exist or is not accessible.

If you encounter this error during the configure phase, install the missing locale and then retry the configure phase to complete the task.

2.2.22 Using SCIM with VNC (Linux)

This step is applicable ONLY on Oracle Linux and Red Hat Enterprise Linux when Smart Common Input Method (SCIM) is used along with Virtual Network Computing (VNC) to perform tasks on a remote system.

If you are using Oracle Linux or Red Hat Enterprise Linux, you may have Smart Common Input Method (SCIM) installed and running. SCIM may prevent you from entering a password in the Provisioning Wizard when you use Virtual Network Computing (VNC).

You can resolve this issue by implementing either one of the following steps:

  • Edit the ~/.scim/config file:

    • Either add entry "/FrontEnd/X11/Dynamic = true" to ~/.scim/config or if entry "/FrontEnd/X11/Dynamic" exists in ~/.scim/config edit its value to "true".

    • Kill any already running vncserver processes

      • ps -ef | grep -i vncserver

      • vncserver -kill:<display_number>

    • Restart vncserver

      • vncserver

OR

  • Remove the SCIM packages completely from the computer.

2.2.23 32 bit Libraries (SUSE Linux Enterprise Server 11)

For SUSE Linux Enterprise Server 11 (Linux x86-64 SLES 11), you must ensure the following 32 bit libraries are available before provisioning a new environment. Otherwise, the user will encounter an error during installation:

  • glibc-devel-32bit-2.9-13.2

  • libgcc43-4.3.3_20081022

  • libstdc++43-4.3.3_20081022-11.18

  • gcc-32bit-4.3

  • libaio-32bit-0.3.104

  • libaio-devel-32bit-0.3.104

  • libstdc++43-32bit-4.3.3_20081022

  • libstdc++43-devel-32bit-4.3.3_20081022

2.2.24 Set the System Time Zone

All server machines must have the same time zone settings as described in the following paragraph:

  • The time zone should be the standard time zone for the instance.

  • Set the TZ environment variable on Linux or an equivalent on other operating systems to have a valid time zone ID. On Windows, double click on the clock in the corner of the desktop, then navigate to time zone to set it.

  • Check the time zone setting using the command: echo $TZ. The tzselect tool may be handy if you need to change the setting.

  • Oracle WebLogic Server and Oracle Database will then derive the default VM and database time zones from the system, respectively, unless otherwise configured. JVMs and the database need to be running in the same time zone.

2.2.25 Create the hwrepo directory

If you are provisioning the Human Capital Management (HCM) application offerings, namely Workforce Development and Workforce Deployment, you need to:

  1. Create a directory named /mnt/hwrrepo (Windows: C:\mnt\hwrrepo) for the provisioning hosts.

  2. Mount a shared disk as needed by the Workforce Reputation (HWR) application.

  3. Grant directory permission to the user/group who owns the Oracle Fusion Applications WLS domain(s).This user can start or shut down the Oracle Fusion Applications environment.

    (UNIX) Run this shell command as root and replace <user id>:<group id> with appropriate user and group identifiers:

    chown <user id>:<group id> /mnt/hwrrepo

  4. Change read/write permission for the directory /mnt/hwrrepo to be globally readable/writable.

    (UNIX) Run this shell command as root:

    chmod 750 /mnt/hwrrepo

If the directory is not setup, you will see a warning message in the provisioning log during the preverify phase when you select the Workforce Development and Workforce Deployment offerings for provisioning.

You can proceed with provisioning the environment and mount the shared disk after provisioning is complete and before you start using the Workforce Reputation application.

2.2.26 Recommended Minimum Disk Space

It is recommended that you maintain the minimum amount of free disk space specified in Table 2-1 to accommodate the initial installation, and a reasonable number of incremental backups, daily or weekly thereafter, and subsequent upgrade activities for future releases. If your environment does not meet the minimum requirements, a warning message will be recorded in the provisioning log. You can continue with the installation but may encounter insufficient disk space issues.

In Table 2-1, the Installation/Upgrade Storage column represents the free disk space required for installation and upgrade. The Base Storage column is free disk space required to maintain a working application environment.

Table 2-1 Recommended Minimum Disk Space

Host Installation/Upgrade Storage (GB) Base Storage (GB)

Web Tier Host

50

50

Provisioning Host

300

500

Database Host

200

600


2.2.27 Recommended Memory Requirement for HCM Workforce Reputation Management Product

This section is only applicable if you plan to use the Human Capital Management (HCM) Workforce Reputation Management product packaged with the Workforce Deployment, or Workforce Development product offerings. To provision an environment with these two product offerings, see Section 4.1.2, "Selecting Product Offerings".

The physical machine hosting HCM Workforce Reputation Management (WorkforceReputationServer_1) managed server must have a minimum of 24 GB of memory. You need to allocate 8 GB of memory to the HCM Workforce Reputation Management (WorkforceReputationServer_1) managed server. The HCM Workforce Reputation Management externalization process may use up to 16 GB of memory.

To specify memory allocation for HCM Workforce Reputation Management (WorkforceReputationServer_1) managed server:

  1. Edit the fusionapps_start_params.properties file located under APPLICATIONS_CONFIG/domains/<host>/HCMDomain/config.

  2. Locate the # HCMDomain: Main Settings section in the file. Replace the line:

    fusion.HCMDomain.WorkforceReputationCluster.default.minmaxmemory.main=-Xms512m -Xmx2048

    with

    fusion.HCMDomain.WorkforceReputationCluster.default.minmaxmemory.main=-Xms4096m -Xmx8192m

  3. Save the fusionapps_start_params.properties file.

  4. Restart HCM Workforce Reputation Management (WorkforceReputationServer_1) managed server either from the WebLogic console or Enterprise Management for the HCM domain. For more information, see "Chapter 4, Performing Routine Administrative Tasks" in the Oracle Fusion Applications Administrator's Guide.

2.2.28 Verify UCB ps Version (Solaris Only)

Before you start provisioning an Oracle Fusion Applications environment, you need to ensure that the correct version of the UCB ps command is available on Solaris (Sparc and Solx86) platform. If the correct version of the ps command is not available, you will encounter an error in the Configure phase and the provisioning will not continue unless it is resolved. To verify and resolve the issue, complete the following steps before provisioning on Solaris 10 and Solaris 11.

For Solaris 10

  1. Search whether /usr/ucb/ps is already installed using the command
    pkg search -r /usr/ucb/ps.

  2. If the command returns the package information, confirm whether the package version is 0.5.11.

  3. If the command returns an error or does not return the package information, install the compatibility/ucb pkg downloaded from http://pkg.oracle.com/solaris/release/en/index.shtml.

For Solaris 11

  1. Check whether package for /usr/ucb/ps is already installed using the command /usr/sbin/pkgchk -l -p /usr/ucb/ps.

  2. If the command returns the status as installed for package SUNWscpu, then /usr/ucb/ps is available.

  3. If the command returns an error or does not return the package information, install the SUNWscpu package downloaded from the CD image or ISO.

2.3 Creating the Provisioning Repository

The provisioning repository contains all the installers required to provision a new Oracle Fusion Applications environment. You download the repository from the Oracle Fusion Applications Product Media Package to a location of your choice (repository_location).

Note:

If you want to set up a demilitarized zone (DMZ) for the web tier in your new environment, see Section 2.5 before you create the repository.

2.3.1 Obtaining the Software

Oracle groups its software releases by product area. A Product Media Pack refers to those groupings. Each media pack may also include a zipped file containing electronic documentation files or "Quick Install" files, which facilitate the initial installation of the software.

Note:

For installations of Oracle Fusion Applications, you must have available the complete set of software contained in the product media pack. You cannot install from individual pieces. Therefore, if you need to install from media that is no longer available on Oracle Software Delivery Cloud, contact My Oracle Support to obtain the complete media pack.

After you have completed the software licensing agreements, you can obtain the Oracle Fusion Applications software using one of these two methods:

  • Oracle Software Delivery Cloud Portal: Provides you with a readme document that helps you to determine which media you need to fulfill the license you have purchased. You download only the media you need. This is the default delivery method.

  • Oracle Store: Provides a complete set of the software in DVD format. You use only the DVDs covered by your software licensing agreement.

Using either method, you can obtain the Oracle Fusion Applications Provisioning repository and gain access to the Oracle Fusion Applications documentation library.

If you are downloading Oracle Fusion Applications 11g Media Pack for the following platforms, then use the following versions of the 64-bit UnZip utility to extract the Oracle software. UnZip is freeware and available at http://www.info-zip.org.

  • IBM AIX on POWER Systems (64-bit) - Info-ZIP unzip version 6.10

  • Oracle Solaris on SPARC (64-bit) - Info-ZIP unzip version 6.0

  • Oracle Solaris on x86-64 (64-bit) - Info-ZIP unzip version 6.0

If you are downloading Oracle Fusion Applications 11g Media Pack for the Microsoft Windows x64 (64-Bit) platform, then use 7zip v9.20 to extract the Oracle software.

2.3.2 Downloading from the Oracle Software Delivery Cloud Portal

Go to http://edelivery.oracle.com/ and follow these instructions:

  1. Complete the Export Validation process by entering basic identification information using the online form.

  2. On the Media Pack Search page, specify the product pack and platform to identify the media pack you want to download. If you do not know the name of the product pack, you can search for it using the license list.

  3. Choose the appropriate media pack from the search results and download the provisioning repository (in zipped format). You can download the repository to a location of your choice.

  4. Extract the contents of all the zipped files to the same target directory. The directory must be on a networked drive or shared disk so that it will be accessible to all the hosts in your new environment. By default, the unzip process places the installers in repository_location/installers.

    Note:

    Create the repository location name so that unzipping the files does not run into the Windows MAX_PATH limitation.

    Note:

    Do not unzip different versions of Oracle Fusion Applications Media Packs into the same location. This will cause errors when you try to provision Oracle Fusion Applications files.

2.3.3 Obtaining DVDs from Oracle Store

To order the Oracle Fusion Applications DVDs from the Oracle Store, go to http://oracle.com. Navigate to the Products and Services page. Click Oracle Applications and then Oracle Fusion Applications.

  1. Log in as the operating system user with sufficient privileges to mount, unmount, and eject a DVD.

  2. Each DVD in the media pack is assigned a unique name and typically contains only one zipped file. Insert the first DVD in the Oracle Fusion Applications Media Pack.

  3. Extract the contents of the first DVD, and each of the remaining DVDs one by one to the same target directory. The directory must be on a networked drive or shared disk so that it is accessible and writable to all hosts in your environment. By default, the unzip process places the installers in repository_location/installers.

    Note:

    Be sure to create the repository location name so that unzipping the files does not run into the Windows MAX_PATH limitation.

    Note:

    Do not mix or unzip different versions of Oracle Fusion Applications Media Packs into the same location. This will cause errors when you try to provision Oracle Fusion Applications files.

2.3.4 Verify Required Operating System Packages and Libraries

Oracle Fusion Applications require specific operating system packages and libraries in the hosts where the software is installed. During the preverify phase of provisioning an Oracle Fusion Applications environment as detailed in Chapter 5, the Provisioning Wizard and the provisioning command line verifies if the hosts have the required packages, libraries, and other requirements such as swap space, free space, and kernel parameters. Any issues during the check are reported in the provisioning log. If you want to perform the manual checks ahead of time, follow these steps after you create the provisioning repository.

For Database Host

  1. Navigate to REPOSITORY_LOCATION/installer/database/Disk1.

  2. Run the command:

    (Unix) ./runInstaller -executePrereqs -silent

    (Windows) setup.exe -executePrereqs -silent -jreLoc REPOSITORY_LOCATION\jdk6

  3. Review the output located at: oraInventory/logs/installAction<timestamp>.log. For example, oraInventory/logs/installAction2013-04-09_09-26-04PM.log.

Other Oracle Fusion Applications Hosts

  1. Navigate to REPOSITORY_LOCATION/installer/<product>/Disk1. where <product> represents:

    • atgf

    • biappsshiphome

    • bishiphome

    • dbclient

    • ecm_bucket2

    • fusionapps

    • odi

    • soa

    • wc

    • webgate

    • webtier

    Optionally, you can also include the following products:

    • bhd

    • gop

  2. Run the command:

    (Unix) ./runInstaller -sv -jreLoc REPOSITORY_LOCATION/jdk6

    (Windows) setup.exe -sv -jreLoc REPOSITORY_LOCATION\jdk6

  3. Review the output located at: oraInventory/logs/install<timestamp>.out. For example, oraInventory/logs/install2013-06-25_10-33-04AM.out.

  4. Repeat Step 1 to Step 3 for all products listed in Step 1.

Example 2-2 Sample Output

$$$$$DEBUG>>>>Packages
Checking for binutils-2.17.50.0.6; found binutils-2.17.50.0.6-20.el5_8.3-x86_64.    Passed
Checking for compat-libstdc++-33-3.2.3-x86_64; found compat-libstdc++-33-3.2.3-61-x86_64.    Passed
Checking for compat-libstdc++-33-3.2.3-i386; found compat-libstdc++-33-3.2.3-61-i386.    Passed
Checking for elfutils-libelf-0.125; found elfutils-libelf-0.137-3.el5-x86_64.    Passed
Checking for elfutils-libelf-devel-0.125; found elfutils-libelf-devel-0.137-3.el5-x86_64.    Passed
Checking for gcc-4.1.1; found gcc-4.1.2-54.el5-x86_64.    Passed
Checking for gcc-c++-4.1.1; found gcc-c++-4.1.2-54.el5-x86_64.    Passed
Checking for glibc-2.5-12-x86_64; found glibc-2.5-107.el5_9.5-x86_64.    Passed
Checking for glibc-2.5-12-i686; found glibc-2.5-107.el5_9.5-i686.    Passed
Checking for glibc-common-2.5; found glibc-common-2.5-107.el5_9.5-x86_64.    Passed
Checking for glibc-devel-2.5-x86_64; found glibc-devel-2.5-107.el5_9.5-x86_64.    Passed
Checking for glibc-devel-2.5-12-i386; Not found.    Failed <<<<
Checking for libaio-0.3.106-x86_64; found libaio-0.3.106-5-x86_64.    Passed
Checking for libaio-0.3.106-i386; found libaio-0.3.106-5-i386.    Passed
Checking for libaio-devel-0.3.106; found libaio-devel-0.3.106-5-i386.    Passed
Checking for libgcc-4.1.1-x86_64; found libgcc-4.1.2-54.el5-x86_64.    Passed
Checking for libgcc-4.1.1-i386; found libgcc-4.1.2-54.el5-i386.    Passed
Checking for libstdc++-4.1.1-x86_64; found libstdc++-4.1.2-54.el5-x86_64.    Passed
Checking for libstdc++-4.1.1-i386; found libstdc++-4.1.2-54.el5-i386.    Passed
Checking for libstdc++-devel-4.1.1; found libstdc++-devel-4.1.2-54.el5-x86_64.    Passed
Checking for make-3.81; found make-1:3.81-3.el5-x86_64.    Passed
Checking for sysstat-7.0.0; found sysstat-7.0.2-12.0.1.el5-x86_64.    Passed
Check complete. The overall result of this check is: Failed <<<<
 
Check Name:Kernel
Check Description:This is a prerequisite condition to test whether the minimum required kernel parameters are configured.
Checking for VERSION=2.6.18; found VERSION=2.6.18-348.4.1.0.1.el5.    Passed
Checking for hardnofiles=4096; found hardnofiles=327679.    Passed
Checking for softnofiles=4096; found softnofiles=327679.    Passed
Check complete. The overall result of this check is: Passed
Kernel Check: Success.
Checking for VERSION=2.6.18; found VERSION=2.6.18-348.4.1.0.1.el5.    Passed
Checking for hardnofiles=4096; found hardnofiles=327679.    Passed
Checking for softnofiles=4096; found softnofiles=327679.    Passed
Check complete. The overall result of this check is: Passed
 
Check Name:GLIBC
Check Description:This is a prerequisite condition to check whether the recommended glibc version is available on the system
Expected result: ATLEAST=2.5-12
Actual Result: 2.5-107.el5_9.5
Check complete. The overall result of this check is: Passed
GLIBC Check: Success.
Expected result: ATLEAST=2.5-12
Actual Result: 2.5-107.el5_9.5
Check complete. The overall result of this check is: Passed

If any of the stated library (or package) is not found, you should obtain and install the library (or package) in order to continue after the preverify phase of the provisioning process.

2.4 Installing the Provisioning Framework

The Oracle Fusion Applications Provisioning installer (faprov) is delivered with the other installers in the provisioning repository. The purpose of faprov is to create the Oracle Fusion Applications Provisioning framework, which contains the following components:

Because the provisioning installer is a customized version of the Oracle Universal Installer (OUI), its behavior closely resembles that of the OUI.

2.4.1 Run the Provisioning Framework Installer

To install the provisioning framework, locate the directory repository_location/installers/faprov/Disk1 and run the script, runInstaller or setup.exe, depending on your hardware platform. Note that repository_location is the directory where you created the provisioning repository.

Note:

You should not run the scripts, runInstaller or setup.exe, located in repository_location/installers/fusionapps/Disk1. These scripts are used and run by the Provisioning Wizard and Provisioning Command-line Interface when needed. They are not meant for installing the provisioning framework.

  1. Use this command to start OUI from the command line to install the Provisioning Wizard. Ensure that you replace repository_location with the full file path to the provisioning repository :

    (UNIX) runInstaller -jreLoc repository_location/jdk6

    Note: If you did not specify -jreLoc repository_location/jdk6 in the command line, you can enter the file path on the command prompt.

    (Windows) setup.exe -jreLoc repository_location\jdk6

    Note: Ensure you are using the 8-character file path format for repository_location.

2.4.2 Provisioning Installer Screens and Instructions

Table 2-2 lists the steps for running the provisioning framework installer. For examples of the interview screens, see Appendix A.

Table 2-2 Provisioning Framework Installation Screen Flow

Screen Description and Action Required

Specify Inventory Directory (UNIX)

If this is your first Oracle installation on this host, you must specify the location of the Central Inventory Directory. It is used by the installer to keep track of all Oracle products installed on this host. The default location for this file varies by platform.

In the Operating System Group Name field, select the group whose members will be granted access to the inventory directory. All members of this group can install products on this host. Click OK to continue.

The Inventory Location Confirmation dialog prompts you to run the inventory_directory/createCentralInventory.sh script as root to create the /etc/oraInst.loc file. This file is a pointer to the central inventory and must be present for silent installations. It contains two lines:

inventory_loc=path_to_central_inventory

inst_group=install_group

The standard location for this file is /etc/oraInst.loc, but it can be created anywhere. Note that the default for Linux and AIX platforms is /etc/oraInst.loc and for Solaris and HP, it is /var/opt/oracle/oraInst.loc. If you create it in a directory other than /etc, you must include the -invPtrLoc argument and enter the location of the inventory when you run the provisioningWizard or the runProvisioning script.

If you do not have root access on this host but want to continue with the installation, select Continue installation with local inventory.

Click OK to continue.

Welcome

No action is necessary on this read-only screen.

Click Next to continue.

Prerequisite Checks

Analyzes the host computer to ensure that specific operating system prerequisites have been met. If any prerequisite check fails, the screen displays a short error message at the bottom. Fix the issue that caused the error and click Retry.

To ignore the error or warning message, click Continue. Click Abort to stop the prerequisite check process for all components.

Click Next to continue.

Specify Installation Location

In the Location field, specify where you want to install the provisioning framework. This is the location where the Provisioning Wizard and the start command for provisioning are installed. This location is denoted as framework_location. You can choose any location if it is on a shared disk in a location that is accessible to all hosts in your new environment.

The installation process creates a logical directory called the Oracle home. This location is where software binaries will be stored. No runtime process can write to this directory. The directory must initially be empty.

If you are performing the installation on a Windows operating system, ensure that the directory paths are valid and do not contain a double backslash (\\).

Click Next to continue.

Installation Summary

Summarizes the selections that you have made during this installation session. To change this configuration before installing, select one of the screens from the left navigation pane or click Back to return to a previous screen. When you are satisfied with the details, click Save to create a text file (response file) to use if you choose to perform the same installation later.

Click Install to begin installing this configuration.

Installation Progress

The progress indicator shows the percentage of the installation that is complete, and indicates the location of the installation log file.

Click Next when the progress indicator shows 100 percent.

Installation Complete

Summarizes the installation just completed. To save the details to a text file, click Save and indicate a directory where you want to save the file.

Click Finish to dismiss the screen and exit the installer.


2.4.3 Provisioning Framework Components

Table 2-3 shows the components in the framework_location/provisioning directory.

Table 2-3 Contents of the Provisioning Framework

Component Type Component Name General Use

ANT

ant

Java processes for installing binaries, configuring domains and subsystems (JDBD and SOA composites), deploying applications, and domain startup

Binary files

bin

Executable files, compiled programs, system files, spreadsheets, compressed files, and graphic (image) files

Library files

lib

Previously defined functions that have related functionality or are commonly used, stored in object code format

Location of saved response files

provisioning-response file

Location for completed or partially completed response files

Location of provisioning build scripts

provisioning-build

Location for build scripts that are available when called for during the provisioning of an environment

Location of templates

template

Start parameters, single sign-on configuration, and database templates

Location of utility files

util

Other provisioning utilities


2.5 Setting Up a Demilitarized Zone (DMZ) for the Web Tier

The web tier contains Oracle HTTP Server, which can be installed on the same shared file system (inside the firewall) as the other components, or exist on a host in a DMZ. If you install the web tier in a DMZ, the web tier host cannot be the same as any other host deployed, regardless of domain.

Installing the web tier in a DMZ enables you to impose more restrictions on communication within the portion of the system that is within the firewall, including the following:

However, the APPLICATIONS_BASE file path and the directory structure under it remain the same on the DMZ host as for the other hosts that exist inside the firewall.

During the provisioning process, phase guard files are generated automatically to determine when a specific phase has been completed on a specific host. For systems that do not use a DMZ, these phase guard files are generated automatically under the shared APPLICATIONS_CONFIG area on the hosts inside the firewall.

To set up and configure your web tier on a DMZ host, go to http://edelivery.oracle.com/ and follow these directions:

Note:

On a DMZ host, you should not have any symlink or mount points that point to a repository or APPLICATIONS_BASE residing inside the firewall, that is, the repository and APPLICATIONS_BASE should be accessible from the DMZ host.

  1. Copy the provisioning repository zipped files to a location on the web tier host to be designated as a demilitarized zone. Follow the instructions in Section 2.3.

  2. Run the provisioning framework installer (faprov), as described in Section 2.4. You can create the framework in any location, or you can create it on the DMZ host.

  3. Copy the provisioning framework (framework_location/provisioning) from the location where you installed it to the DMZ host. If you installed it initially on the DMZ host, no action is required.

  4. When you create the response file for this environment, indicate this web tier configuration when prompted. See Section 4.3 for details.

  5. When the preverify phase is successful on the primordial host, place a copy of the response file and the generated provisioning plan (<APPLICATIONS_BASE>/provisioning/plan/provisioning.plan) on the DMZ host.

2.6 Deinstalling the Provisioning Framework

Deinstalling Oracle Fusion Applications involves removing the Oracle Fusion Applications Provisioning Oracle home. The deinstaller attempts to remove the Oracle home from which it was started, and removes only the software in the Oracle home.

Before you remove the Oracle Fusion Applications Provisioning Oracle home, ensure that it is not in use. After you remove the software, you will no longer be able to provision a new Oracle Fusion Applications environment.

2.6.1 Run the Provisioning Framework Deinstaller

To start the deinstaller, navigate to (UNIX) framework_location/oui/bin or (Windows) framework_location\oui\bin and use this command:

(Unix) runInstaller -deinstall -jreLoc repository_location/jdk6

(Windows) setup.exe -deinstall -jreLoc repository_location\jdk6

On Windows operating systems, you can also start the deinstaller from the Start menu by selecting Programs, then Oracle Fusion Applications Provisioning 11g-Home1, and finally Uninstall.

The Uninstall menu is a Windows shortcut to the setup.exe -deinstall command. Note that you should not use the Start -> All Programs -> Oracle - OHnnnn -> Oracle Installation Products -> Uninstall menu option on Windows operating systems, where nnnn is a number. This Uninstall menu is also a shortcut to the setup.exe program but does not have the -deinstall command line option. Therefore, it will not deinstall the provisioning framework.

The deinstaller described in this section removes the provisioning framework that you can use to provision the Oracle Fusion Applications environment. It does not deinstall the Oracle Fusion Applications environment. If you want to deinstall an Oracle Fusion Applications environment, refer to Chapter 6 before removing the provisioning wizard from your system.

For Windows operating systems, after removing provisioning wizard, you can delete the Oracle - OHnnnn folder located in the ProgramData -> Microsoft -> Windows -> Start Menu -> Programs folder.

2.6.2 Deinstaller Screens and Instructions

Table 2-4 contains instructions for deinstalling the provisioning framework. For help with any of the interview screens, see Appendix A or click Help on any interview screen.

Table 2-4 Provisioning Deinstaller Screen Flow

Screen Description and Action Required

Welcome

No action is required on this read-only screen.

Click Next to continue.

Deinstall Oracle Home

Verify that the directory path is correct. Click Save to create a text file with the details of the configuration you are deinstalling. Click Deinstall to continue.

On the Warning screen, select whether you want the deinstaller to remove the Oracle home directory in addition to removing the software. Click Yes to remove the software files and the provisioning Oracle home directory. Click No to remove only the software files, or click Cancel to return to the previous screen.

If you clicked No, remove the framework software files manually. For example, you would use this syntax if the directory is /d1/oracle/provisioning:

(Unix)cd /d1/oracle/provisioning

(Windows) rm -rf provisioning

If the Oracle home directory is C:\Oracle\Provisioning, use a file manager window and navigate to the C:\Oracle directory. Right-click the Provisioning folder and select Delete.

Deinstallation Progress

Monitor the progress of the deinstallation. Click Cancel to stop the process. Click Next to continue.

Deinstallation Complete

Click Finish to dismiss the screen.


2.7 What to Do Next

You must install a transaction database before you create a response file. See Chapter 3 for complete information.