3 Installation of Oracle E-Business Suite Certified Configuration

3.1.1 Mounting and Installing from a Known Stage Area Server

Oracle provides a stage area server for Oracle E-Business Suite Certified Configuration for each platform for Oracle internal use. Use the following command syntax to mount and install from the Oracle stage area:

# mkdir /stage
# mount cclibrary:/vol/LTrepos/CCrepos/platform/EBizCC/11510CC-Final /stage

In the preceding syntax, replace <platform> with the operating system used with the system on which you are installing, using the following syntax:

• AIX: aix

• hp-ux: hpux

• Linux: linux

• Solaris: solaris

3.1.2 Mounting and Installing from a Local File System Stage Area

This section describes how to create a stage area on your local file system.

Table 3-1 provides path directions for staging each of the DVD-ROMs on your local file system. In the following table, n represents the disk number of each type of disk label.

The stage area is created on one server, and can be shared on another server by mounting the /stage file system to the other servers. It is recommended that you create the stage area only once.

The following is an example of the command syntax used to create a stage path:

$ mkdir /stage/startCD
$ cd /stage/startCD
$ cp -r * /mountpoint

In the preceding syntax example, <mountpoint> is the mount point for the DVD-ROMs on your system.

3.2.1 Creating a Single-Node Oracle E-Business Suite Certified Configuration

In a single-node installation, install both the applications tier and the database tier on the same server. Use the following to create an installation on a single-node system:

1. Log out of the system, and then log back in as the root user.

2. Verify that you set the EBSO_HOME environment variable, such as EBSO_HOME=/admin/ebso.

3. Run the wizard.sh script, using the following commands:

   # cd /admin/ebso/admin
   # ./wizard.sh mode=install dest_mntpt=<tabcdi> tier=all
   
   

   To install Oracle E-Business Suite Certified Configuration with a vision database, specify "dbtype=vision" in the wizard.sh script. For example:

   # ./wizard.sh mode=install dest_mntpt=<tabcdi> tier=all dbtype=vision
   
   

4. To check the status of the installation, review the log files in the $EBSO_HOME/log directory.

3.2.2 Creating a Two-Node Oracle E-Business Suite Certified Configuration

In a two-node installation, install both the applications tier and the database tier servers across two nodes. Use the following to create an installation on a two-node system:

1. Log out of the system, and then log back in as the root user.

2. Verify that you set the EBSO_HOME environment variable.

3. To install the database tier on the database tier system, use the following commands:

   # cd /admin/ebso/admin
   # ./wizard.sh mode=install dest_mntpt=<tabcdi> tier=oracle mnode=<dbhost>,<cphost>,<admhost>,<webhost>,<frmhost>
   
   

   For example, if the database tier host name is node1, and the middle-tier host name is node2, then the command would be:

   # ./wizard.sh mode=install dest_mntpt=tabcdi tier=oracle mnode=node1,node2,node2,node2,node2
   
   

   To install Oracle E-Business Suite Certified Configuration with a vision database, specify "dbtype=vision" in the wizard.sh script. For example:

   # ./wizard.sh mode=install dest_mntpt=tabcdi tier=oracle mnode=node1,node2,node2,node2,node2 dbtype=vision
   
   

4. To check the status of the installation, review the log files in the directory $EBSO_HOME/log.

5. To install the applications tier on the applications tier system, use the following commands:

   # cd /admin/ebso/admin
   # ./wizard.sh mode=install dest_mntpt=<tabcdi> tier=apps mnode=<dbhost>,<cphost>,<admhost>,<webhost>,<frmhost>
   
   

   For example, if the database tier host name is node1, and the middle-tier host name is node2, then the command would be:

   # ./wizard.sh mode=install dest_mntpt=tabcdi tier=apps mnode=node1,node2,node2,node2,node2
   
   

   If the database-tier is configured with the "dbtype=vision" option, then you must specify this option while configuring the middle-tier.

6. To check the status of the installation, review the log files in the $EBSO_HOME/log directory.

You can install Oracle E-Business Suite Certified Configuration components across more than two nodes to create a multi-node setup. To perform such a setup, specify the appropriate host name in the wizard.sh script using the option for mnode.

3.2.3 Post Installation Task for Password Management Utility

You must complete the following post-installation tasks for the password management utility.

• As the apps user, run the passwd_mod.sh script located in the $APPL_TOP/../BOL/scripts directory.

• As the oracle user, run the passwd_mod_sys.sh script located in the $ORACLE_HOME/appsutil/BOL/scripts directory. This script changes the sys and ssosdk passwords.

3.2.4 Configuring an Oracle E-Business Suite Middle-Tier with a Virtual URL

Use the following instructions to configure Personnel Home Page (PHP) to use a virtual server URL using a load balancer (like BIG-IP) after the initial installation:

1. Log in as the apps user.

2. Run the pre-cloning step for the instance.

   $ cd /admin/ebso/admin
   $ ./pre_crenv.sh mntpt=<mount point>
   
   

   where <mount point> is the top-level directory, typically six-letter (like ÒtabcdiÓ) in an On Demand environment.

3. Log in as the apps user and reconfigure the instance to use the virtual server URL in the load balancer using the following command:

   $ cd /admin/ebso/admin
   $ ./wizard.sh mode=preconfig src_mntpt=<source mount point> dest_mntpt=<dest mount point> tier=apps bigd=true,<URL>
   
   

   where you specify the same value for src_mntpt and dest_mntpt, and an example of a valid URL is http://testebiz.abcd.com.

   
   

   Note: You will be prompted to enter the apps password several times during the reconfiguration process.

   
   

4. Review the log files for any errors.

3.2.5 Adding a New Oracle E-Business Suite Middle-Tier

Use the following instructions to add a new middle-tier to an existing Oracle E-Business Suite Certified Configuration instance.

The following are prerequisites for adding a new middle-tier to an existing Oracle E-Business Suite Certified Configuration instance:

• You have an existing installation of Oracle E-Business Suite Certified ConfigurationIf you plan to add a Web tier, you must configure the existing middle-tier to use the Virtual URL as described in the preceding section "Configuring an Oracle E-Business Suite Middle-Tier with a Virtual URL"

The following contains instructions on how to add a new middle-tier using shared APPL_TOP configuration:

1. Run the pre-cloning step on the first (or one of the existing) middle-tier using the following commands:

   1. Log in as the apps user.

   2. Run the pre-cloning step for the instance.

      $ cd /admin/ebso/admin
      $ ./pre_crenv.sh mntpt=<Mount Point>
      
      

2. Create users, groups, and mount points on the new middle-tier node.

   1. On the new middle-tier node, ensure that you create application and oracle users that correspond to those on the source node. For example, use the following command to ass users and groups:

      # groupadd -g aa<mntpt># useradd -d <home directory> -g <group> \ 
      -p <password> -s <shell> ap<mntpt>
      
      

   2. Copy the user profile (.profile) from the source middle-tier and put it in the <home directory>.

3. Copy the iAS ORACLE_HOME under the /<mount point>/product directory from the existing middle-tier to the new middle-tier. For example, you have a two-tier deployment with node 1 running a database and node 2 running a middle-tier, and you want to add a new middle-tier to node 3.

4. Make sure the same /<mount_point>/applmgr directory on an existing middle-tier (node 2) is mounted read-write on the new middle-tier (node 3) to set up the new middle-tier in a shared APPL_TOP mode.

5. Modify the sqlnet.ora file in the ORACLE_HOME database (database-tier) to include the host name of the new middle-tier node in the tcp.invited_nodes file and restart the Oracle Net listener.

   For example, if node3 is your new middle-tier and node2 is your source middle-tier node, and node1 is your database-tier node, then modify sqlnet.ora to add node3 as follows:

   tcp.invited_nodes=(node1.<domain_name>,node2.<domai_name>,node3.<domain_name>)
   $ lsnrctl stop <listener name>
   $ lsnrctl start <listener name>
   
   

6. Install Oracle E-Business Suite Certified Configuration Tool and Utilities under the /admin/ebso directory on a new middle-tier (node 3), if it does not exists. Use the following commands:

   1. Login as the root user on the new middle-tier (node 3).

   2. Mount the Oracle E-Business Suite stage area on to this system, under the /stage directory:Run the following commands to install Oracle E-Business Suite Certified Configuration Tools and Utilities:

      # mkdir /admin/ebso
      # cd /stage/StartCD/Disk1/ebso/install
      #./setup.sh
      
      

7. The new middle-tier could be configured to run one or more of the following:

   • Concurrent Processing

   • Administration

   • Web

   • Forms

   1. Log in as the apps user on the new middle-tier node.

   2. Determine which services you want to configure on the new middle-tier, then use the following instructions to configure them:

      #  cd /admin/ebso/admin
      #  wizard.sh mode=preconfig src_mntpt=<Source Mount Point > dest_mntpt=<Dest Mount Point> tier=apps bigd=true,<URL> src_host=<Source Host> shared_appl_top=true mnode=<dbhost>,<cphost>,<admhost>,<webhost>,<frmhost>
      
      

      In the preceding command, specify the host name of the new middle-tier for the services that you want to configure on the new middle-tier.

      For example, if you want to configure all services (Concurrent Processing, Administration, Web, and Forms) on a new middle-tier (node 3), the preceding command would be:

      wizard.sh mode=preconfig src_mntpt=<Source Mount Point > dest_mntpt=<Dest Mount Point> tier=apps bigd=true,<URL> src_host=<Source Host> shared_appl_top=true mnode=node1,node3,node3,node3,node3
      
      

      If you want to configure only Concurrent Processing, then the command will be:

      wizard.sh mode=preconfig src_mntpt=<Source Mount Point > dest_mntpt=<Dest Mount Point> tier=apps bigd=true,<URL> src_host=<Source Host> shared_appl_top=true mnode=node1,node3,node2,node2,node2
      
      

      If you want to configure Concurrent Processing and Web, then the command will be:

      wizard.sh mode=preconfig src_mntpt=<Source Mount Point > dest_mntpt=<Dest Mount Point> tier=apps bigd=true,<URL> src_host=<Source Host> shared_appl_top=true mnode=node1,node3,node2,node3,node2
      
      

8. Run the following commands on the newly configured middle-tier (node 3) to add the new middle-tier node into Oracle E-Business Suite Certified Configuration:

   $ cd $OAH_TOP/clone/bin
   $ perl adaddnode.pl