Skip Headers

Oracleâ E-Business Suite Certified Configuration Installation Guide
Release 11i (11.5.8) for Linux Intel
Part No. B10709-01
Go To Table Of Contents
Contents

Previous

Copyright © 2003, Oracle Corporation. All Rights Reserved.

Oracle is a registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners.

Oracleâ E-Business Suite Certified Configuration

Installation Guide

Release 11i (11.5.8) for Linux Intel

March 2003

Part No. B10709-01

This document provides instructions for setting up and installing Oracle E-Business Suite Certified Configuration. You can also use the procedures in this document to recover a system after system failure. If a vendor preinstalls the system, refer to the Oracle E-Business Suite Certified Configuration Getting Started Guide to configure your system.

This guide includes the following topics:

Oracle E-Business Suite Certified Configuration Overview

The Oracle E-Business Suite Certified Configuration consists of the following main components:

You can install each component independently of the other components.

Before you can deploy Oracle E-Business Suite Certified Configuration components, you must fulfill the certified operating system and hardware requirements that this guide specifies. For Linux, this includes installing the operating system. This guide provides instructions on performing the following tasks:

  1. Run setup.sh to install the auxiliary E-Business Suite Outsourcing (ebso) scripts to your machine and update the operating system.

  2. Run setup_oap.sh to install OAP tools and utilities.

  3. Install the volume manager software and configure disk group vg00.

  4. Run the ocheck validation script to make sure you have the proper operating environment.

Naming Conventions

The Oracle E-Business Suite Certified Configuration release 11.5.8 distribution contains zip files for the default GOLD environment. The default GOLD environment consists of the IGOLD, DGOLD, SGOLD and IOLAP components. These components are deployed using /admin/ebso/install/deploy.sh. You can use the default GOLD naming, or you can specify a new name for your environment. You can update (rename) the environment at a later time.

Before you begin, gather the following information:

The name of your environment determines the database system identifier (SID), mount points, and user names and groups. You can deploy each component as one of the following four environment types: Test, Development, Stage, or Production. Each environment type has its own set of port numbers.

The name of an environment consists of six characters. The first letter must be the initial letter of the type of environment that you want to deploy, for example, (T)est, (D)evelopment, (S)tage, or (P)roduction. The next four characters represent the unique customer short code. And the last letter identifies the software component.

Configuration Options

The following are possible configuration options:

Oracle Applications 11i

Oracle Applications 11i consists of the following five tiers:

  • Database

  • Concurrent Processing

  • Admin

  • Web

  • Forms

The letter i uniquely identifies an Oracle Applications 11i environment. The deployment process will combines the letter i with the first letter of the environment type to form the database system identifier (SID), mount points, and user names and groups.

Table 1 provides examples of users, groups, passwords, and directory structure for the IGOLD environment:

Table 1 IGOLD Examples

User Name/
Password
Group Home Directory Description
origold/origold dbigold /igold/oracle Oracle Owner
apigold/apigold aaigold /igold/applmgr Apps Owner

Table 2 provides examples of users, groups, passwords, and directory structure for the TEST environment, where the customer short code is abcd:

Table 2 TABCDI Examples

User Name/
Password
Group Home Directory Description
ortabcdi/
ortabcdi
dbtabcdi /tabcdi/oracle Oracle Owner
aptabcdi/
aptabcdi
aatabcdi /tabcdi/applmgr Apps Owner

An Oracle Applications 11i environment consists of the mount points in Table 3.

Table 3 Oracle Applications 11i Mount Points

Type Mount Points Size
Oracle

/mount_point/oracle 3 GB
/mount_point/oradata 25 GB
/mount_point/arch 3 GB
/mount_point/backup

(Created in the Production Environment type only)

30 GB
Apps

/mount_point/applmgr 25 GB
/mount_point/applcsf 3 GB

The installation options are as follows:

  • Single node – An installation where all five tiers are on the same machine.

  • Multi-node – An installation where the five tiers are spread across two or more machines.

  • Full environment – An installation where you create all the mount points. Oracle intends this for single-node installations or multi-node installations, where you install the Database tier and one or more of the Apps tiers on the same machine.

  • Partial environment – An installation where you can only install the Oracle mount points or the Apps mount points. The intent of this is to save disk space for multi-node installations.

  • Database version - An installation where the Database tier can either be Release 8.1.7.4 or Release 9.2.0.2.

Oracle Database Certified Configuration

The Oracle Database Certified Configuration is essentially the Oracle code tree from Oracle Applications 11i, but it has separate naming conventions and an empty seed database.

The letter d uniquely identifies an Oracle Database Certified Configuration environment. The deployment process combines the letter d with the first letter of the environment type to form the database system identifier (SID), mount points, and user names and groups.

Table 4 provides examples of users, groups, passwords, and directory structure for the DGOLD environment and the TEST environment, where the customer short code is abcd:

Table 4 Oracle Database Certified Configuration Variable Examples

Environment User Name/
Password
Group Home Directory Description
DGOLD ordgold/
ordgold
dbdgold /dgold/oracle Oracle Owner
TABCDD ortabcdd/
ortabcdd
dbtabcdd /tabcdd/oracle Oracle Owner

An Oracle Database Certified Configuration environment consists of the mount points in Table 5.

Table 5 Oracle Database Certified Configuration Mount Points

Type Mount Points Size
Oracle

/mount_point/oracle 3 GB
/mount_point/oradata 25 GB
/mount_point/arch 3 GB
/mount_point/backup

(Created in the Production Environment type only)

30 GB

The only installation option is Database version, in which you can select Release 8.1.7.4 or Release 9.2.0.2.

Oracle Internet Directory

The Oracle Internet Directory has separate naming conventions.

The letter s uniquely identifies an Oracle Internet Directory environment. The deployment process combines the letter s with the first letter of the environment type to form the database system identifier (SID), mount points, and user names and groups.

Table 6 provides examples of users, groups, passwords, and directory structure for the SGOLD environment and the TEST environment, where the customer short code is abcd:

Table 6 OID Variable Examples

Environment User Name/
Password
Group Home Directory Description
SGOLD orsgold/
orsgold
dba /sgold/oracle Oracle Owner
TABCDS ortabcds/
ortabcds
dba /tabcds/oracle Oracle Owner

An Oracle Internet Directory environment consists of the mount points in Table 7.

Table 7 Oracle Internet Directory Mount Points

Type Mount Points Size
Oracle

/mount_point/oracle 3 GB
/mount_point/oradata 25 GB
/mount_point/arch 3 GB
/mount_point/backup

(Created in the Production Environment type only)

30 GB

Online Analytical Processing

The Online Analytical Processing (OLAP) has separate naming conventions.

The letter x uniquely identifies an OLAP environment. The deployment process combines the letter x with the first letter of the environment type to form the database system identifier (SID), mount points, and user names and groups.

Table 8 provides examples of users, groups, passwords, and directory structure for the IOLAP environment and the TEST environment, where the customer short code is abcd:

Table 8 OLAP Variable Example

Environment User Name/
Password
Group Home Directory Description
IOLAP oriolap/
oriolap
dba /iolap/oracle Oracle Owner
TABCDX ortabcdx/
ortabcdx
dba /tabcdx/oracle Oracle Owner

An OLAP environment consists of the OLAP mount point, /mount_point, which is 3 GB.

Limitations and Considerations

To avoid conflicts, you cannot have two environments of the same environment type on one machine.

Also, Oracle Applications 11i and Oracle Database Certified Configuration environments share the same port list, which means that you cannot have these components with the same environment type on one machine.

Oracle E-Business Suite Certified Configuration Components

The following components are common to all platforms of the Oracle E-Business Suite Certified Configuration:

Table 9 Oracle E-Business Suite Certified Configuration Components

Main Component Key Subcomponents
Oracle Applications Release 11i (11.5.8) Oracle Applications Manager 2.1

Oracle Database 8.1.7.4 or 9.2.0.2

Oracle Developer 6i P11

Oracle Discoverer 4.1.44

Oracle iSetup 11i

Oracle JInitiator 1.1.8.16

Oracle Login Server 3.0.9.8.2

Oracle Portal 3.0.9.8.2

Oracle9i Application Server 1.0.2.2.2

Web Applications Desktop Integrator 8.3.0.0

Sun JDK 1.3.1_02

Oracle Database Certified Configuration Oracle Database 8.1.7.4 or 9.2.0.2
Oracle Internet Directory 3.0.1 Oracle Database 9.0.1.4
OLAP Oracle Express Server Multi-Language Edition (MLE) 6.3.4

Oracle Financial and Sales Analyzer Server (MLE) 6.4.0

Tools and Utilities Cloning utility

NLS Toolkit

ocheck validation tool

Oracle Outsourcing custom application

Oracle Outsourcing database accounts

Database and system administration scripts

VERITAS Netbackup client 3.4 GA

Oracle Automation Platform (OAP) Oracle Enterprise Manager Intelligent Agent 9.0.1

Support Agent 1.0

Unified Serviceability Interface 1.0

Patch Tracking System (PTS) client 2.9.1.1

AutoVerify 2.2.13

APPSAUTO


Minimum Requirements

This section contains information on minimum operating system, hardware, and configuration requirements. You must make sure that you fulfill these requirements before you deploy Oracle E-Business Suite Certified Configuration. This section includes the following topics:

Minimum Operating System Requirements

The minimum operating system requirements for the Oracle E-Business Suite Certified Configuration are as follows:


Note:

When you run the setup.sh utility, it updates the kernel parameters and installs the packages to match the requirements in Table 10 and Table 11.

  • Red Hat Linux Advanced Server 2.1 (kernel version 2.4.9-e.3smp or later)

  • Current software patches

  • Kernel parameters set to the values in Table 10

    Table 10 Kernel Parameters

    Kernel Parameter Value Purpose
    SEMMNI 128 Number of semaphore identifiers
    SEMMNS 32000 Maximum number of semaphores
    SEMMSL 1000 Maximum number of semaphores per semaphore set
    SEMOPM 100 Maximum number of operations per semop call
    SHMMAX 1073741824 Maximum size per shared memory segment (bytes)
    SHMMNI 100 Number of shared memory identifiers

  • The system packages in Table 11

    Table 11 Packages

    Packages Version
    bc 1.06
    expect 5.32.2
    gcc and gcc-c++ 2.96
    glibc 2.2.4
    jdk 1.3.1_02
    openmotif 2.1.30
    pdksh 5.2.14
    perl 5.6.1
    sudo 1.6.5p2
    tcl 8.3.3
    tk 8.3.3
    unzip 5.42
    XFreefb-Xvfb 4.1.0

  • Existing file system sizing as shown in Table 12

    Table 12 Sizing

    Directory File size
    /
    9 GB
    /admin 10 GB
    /boot 128 MB
    /oem 2 GB
    /stage 20 GB (If you perform a CD-ROM installation)
    /tmp 1 GB


Note:

For Linux, you do not have to put the /tmp directory in a separate partition. You can put it in a directory under the root partition.

Minimum Hardware Requirements

The minimum hardware requirements for the Oracle E-Business Suite Certified Configuration are as follows:

  • 2 CPUs

  • 450 MHz speed

  • 900 CPU power factor (port specific)


    Note:

    To calculate CPU power factor, multiply the number of processors with the speed of the processors:

    CPU power factor = CPU count * speed


  • 2 GB of physical memory

  • 2 GB disk swap space

  • 2 internal 36 GB drives

  • 230 GB free disk space on external disk storage, RAID 0+1 configuration (Recommended)

    Table 13 lists the space needed for each environment deployment type.

    Table 13 Deployment Sizing

    Deployment Type Production Environment Other Environments
    Oracle E-Business Certified Configuration 90 GB 60 GB
    OID 61 GB 31 GB
    OLAP 3 GB 3 GB


    Note:

    The recommended 230 GB provides enough space to deploy approximately three environments. To deploy more than two, verify that you have sufficient free disk space for each deployment.

  • 2 Network Interface Cards (NIC), 10/1000 Mbps

Other Configuration Requirements

Before you stage the installation environment, make sure that the host name and domain are set for your host. Also, make sure that the ports in Appendix B of the Oracle E-Business Suite Certified Configuration Getting Started Guide Release 11i (11.5.8) for UNIX are available.

Operating System Setup

In the event that you must install the operating system, use the instructions in this section to set up your system. If you do not need to install the operating system, proceed to the Updating the Red Hat Linux Advanced Server Environment section.

Preconfiguring the System for OS installation

Before you install the operating system, perform the following procedure to preconfigure the system:

  1. Run OpenManage Server Assistant CD-ROM for Dell and select Server Setup.

  2. In Array Manager running Custom Mode, use the Virtual Disk Wizard to create RAID1 for internal storage and RAID 10 for external storage (if any).

Installing the Operating System

Perform the following procedure to install the operating system:

  1. Insert the RedHat Advanced Server 2.1 CD-ROM and reboot the system to start the install.

  2. In the Installation Type screen, select Advanced Server.

  3. In the Partition Setup screen, select the option to manually partition with Disk Druid on disk /dev/sda only. Make sure all existing partitions are removed.

  4. Make the necessary adjustments in the partition creation screen to match the following (based on a 36 GB device):

    • / 9 GB

    • /boot 128 MB

    • swap 2 GB

    • swap (Additional) 2 GB

    • /admin 10 GB

    • /oem 2 GB

  5. In the Boot Loader Configuration screen, select LILO as the boot loader. Make sure the boot record is on the same device as the partitions that you created above, and accept all other defaults.

  6. Enter the Network Configuration details for the system:

    • Static IP address

    • Subnet mask (tab to Network and Broadcast to allow the installer to populate these fields)

    • Enter the host name and domain name, in the Hostname field, using the following syntax:

      hostname.domainname

    • Gateway

    • 3 Domain Name Server (DNS) entries.

  7. In the Firewall Configuration screen, select No Firewall.

  8. Enter welcome as the password for root.

  9. In the Time Zone Selection screen, configure the Location tab.

  10. In the Package Group Selection screen, select GNOME, KDE, and Software Development.

  11. Allow the installation to run to completion. Select KDE as the default desktop environment.

  12. Verify that the SMP kernel is the default kernel for machines with 4 GB of physical memory, or the Enterprise kernel for machines that are larger than 4 GB.

  13. Verify that the /etc/hosts file contains a line with the appropriate network information using the following syntax:

    IP_address hostname.domainname hostname

  14. Verify that hostname -d command returns the correct domain name.

Updating the Red Hat Linux Advanced Server Environment

Perform the following procedure to update the Red Hat Linux Advanced Server environment:

  1. Log in as the root user.

  2. You can install the auxiliary Oracle E-Business Suite Outsourcing (ebso) files to the /admin/ebso from an NFS mount location or from the CD-ROM.

    • To install from an NFS mount location, enter the following commands:

      # mkdir /stage
      # mount psd-sun.us.oracle.com:/image/1158/Linux/CD/Start_Here\ /stage
      # cd /stage/ebso/install
      # ./setup.sh
      
      

      When prompted for the location of EBSO_HOME, press Enter to accept the default value, /admin/ebso.

      Unmount the /stage directory, using the following commands:

      # cd /
      # umount /stage
      
      
    • To install from CD-ROM, disable the DMA on the CD-ROM drive:

      # hdparm -d0 /dev/cdrom
      
      

      Then, insert the Start_Here CD-ROM into the CD-ROM drive and start the install:

      # cd /mnt/cdrom/ebso/install
      # ./setup.sh
      
      

      When prompted for the location of the EBSO_HOME, press Enter to accept the default value, /admin/ebso. Then, return to the root directory and eject the CD.

Installing the Outsourcing Automation Platform Distribution

The Outsourcing Automation Platform (OAP) distribution contains files for installing the following products:

  • APPSAUTO

  • AutoVerify

  • OEM Intelligent Agent

  • PTS Client

  • Serviceability

  • Support Agent

After you perform the procedure in the Updating the Red Hat Linux Advanced Server Environment section, you can install the OAP distribution from an NFS location or from the CD-ROM.

  • To install from an NFS mount location, enter the following commands:

    # mount psd-sun.us.oracle.com:/image/1158/Linux/CD/Start_Here/oap\ /stage
    # cd /stage/install
    # ./setup_oap.sh
    
    

    When prompted for the location of the OAP_HOME, press Enter to accept the default value, /admin.

    Unmount the /stage directory, using the following commands:

    # cd /
    # umount /stage
    
    
  • To install from CD-ROM, insert the Start_Here CD-ROM into the CD-ROM drive and start the install, using the following commands:

    # cd /mnt/cdrom/oap/install
    # ./setup_oap.sh
    
    

    When prompted for the location of the OAP_HOME, press Enter to accept the default value, /admin. Then, return to the root directory and eject the CD-ROM.

VERITAS Volume Manager and NetApps Storage Options

If you chose NetApps as your storage option, make sure that file volumes to house the IGOLD application, OLAP, and FTP interface environment exist and are available.

If VERITAS Volume Manager is your storage option, perform the following installation and configuration steps:

  1. Log out of the system, and then log back in as the root user. Make sure that you set the EBSO_HOME environment variable.

  2. For VERITAS VxVM only, create a 32 MB partition on the system disk, for example, /dev/sda8, using the fdisk utility. Make sure that the partition appears in the /proc/partitions file. If it does not appear in the file, reboot the server.

  3. Install the VERITAS Volume Manager 3.2 rpm packages in the following order:

    • VRTSvlic

    • VRTSvxvm (Update 2)

    • VRTSvmdoc

    • VRTSvmman

  4. Run the vxinstall utility to install a valid VERITAS VxVM license key.

  5. When prompted, enter the license key.

  6. After the system accepts the license key, exit the vxinstall utility.

  7. Configure the VxVM root disk group using the sda8 partition that you created in step 2, as follows:

    # cd /admin/ebso/install/bin
    # ./crvxrtdg.sh
    

Validation Script

You can install Oracle E-Business Suite Certified Configuration on existing hardware with an existing operating system, if the hardware and operating system meet the minimum requirements. The media kit includes the validation script, ocheck, that checks the hardware and operating system before you install Oracle E-Business Suite Certified Configuration.

Running the Validation Script

The validation script, ocheck, checks your system for the minimum Oracle E-Business Suite Certified Configuration requirements listed in the Minimum Requirements section.

To verify if your system meets Oracle E-Business Suite Certified Configuration requirements, run ocheck from /admin/ebso/ocheck directory as the root user. You can run ocheck with or without capturing the output in a log file, as follows:

  • To run the ocheck script without capturing the output in a log file, use the following syntax:

    # ./ocheck -product ebiz -preinstall -prettyprint
    
    
  • To run the ocheck script while generating a log file, use the following syntax, substituting a log file name for output_filename:

    # ./ocheck -product ebiz -preinstall -prettyprint -o output_filename
    
    
  • To run the ocheck script for the Oracle Database Certified Configuration, substitute the keyword rdbms for the keyword ebiz in the two examples above.


Note:

ocheck does not check external disks and does not verify that VERITAS is configured.

Deploying Oracle E-Business Suite Certified Configuration

Perform the following tasks to create the Oracle E-Business Suite Certified Configuration:

  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. Perform one of the following tasks:

    • Deploy the image from an NFS location, using the following commands:

      # mkdir /stage
      # mount psd-sun.us.oracle.com:/image/1158/Linux/NFS /stage
      
      
    • Deploy from CD-ROM, making sure that you mounted the /stage partition with 20 GB of available space in order to unload the contents of the CD-ROM.

  4. Run deploy.sh, using the following commands:

    # cd /admin/ebso/install
    # ./deploy.sh
    
    

    The following menu appears:

    1. Deploy EBiz CC 11i
    2. Deploy DB CC with seed database
    3. Deploy OLAP
    4. Deploy Oracle Internet Directory
    5. Quit
    Please enter action:
    
    
  5. Enter the number corresponding to the action that you want to perform.

  6. At the prompt, enter the desired mount point.

  7. If you selected option 1 or 2 in step 5, then follow the directions in the corresponding section below; otherwise, go to step 8:

    • Option 1 - Deploy Ebiz CC 11i

      If you selected this option, you will see the following prompt.

      Choose deployment option all, oracle or apps [all]:
      
      

      Enter the keyword all, oracle, or apps, depending on whether you want to deploy both the database and apps, just the database, or just the apps, respectively.

      Depending on your entry follow the directions in Table 14 for each entry type.

      Table 14 Ebiz CC 11i Deployment Instructions

      Entry Instructions
      all The following prompt appears:
      Is this a multinode environment? (y/n) [n]:
      

      If you want to configure one or more database, concurrent processing, admin, web, and forms tiers on different servers, enter y for yes; otherwise enter n for no.

      If you enter y for yes, then the following prompt appears:

      Enter the 5 hostnames to configure multi-node delimited by comma:
      

      Enter the host names of five tiers for the nodes that you are deploying in the following order, without spaces and without the domain:

      database_host,concurrent_processing_host,admin_host,\
      web_host,forms_host

      After entering the five host names the following prompt appears:

      Configure multi-node using database_host, concurrent_processing_host, admin_host, web_host, forms_host (y/n) [y]:
      

      Enter y to proceed or n to re-enter the host names.

      The following prompt appears:

      Select database release 817 or 920 [817]:
      

      Enter either 817 or 920 for Release 8.1.7 or 9.2.0, respectively.

      Then go to step 8.

      apps The following prompt appears:
      Enter the 5 hostnames to configure multi-node delimited by comma:
      

      Enter the host names of five tiers for the nodes that you are deploying in the following order, without spaces and without the domain:

      database_host,concurrent_processing_host,admin_host,\
      web_host,forms_host

      After entering the five host names the following prompt appears:

      Configure multi-node using database_host, concurrent_processing_host, admin_host, web_host, forms_host (y/n) [y]:
      

      Enter y to proceed or n to re-enter the host names.

      Go to step 8.

      oracle The following prompt appears:
      Select database release 817 or 920 [817]:
      

      Enter either 817 or 920 for Release 8.1.7 or 9.2.0, respectively.

      Go to step 8.


    • Option 2 - Deploy DB CC with seed database

      If you selected this option, the following prompt appears:

      Select database release 817 or 920 [817]:
      
      

      Enter 817 or 920 for Release 8.1.7 or 9.2.0, respectively, then go to step 8.

  8. When the following menu appears, enter 1 or 2:

    1. Proceed to read /stage
    2. Load CD distribution to /stage
    3. Quit
    Please enter action:
    
    
    • Enter 1 if you want to deploy from an NFS location or if you previously uploaded the CD-ROM contents to /stage.

    • Enter 2 if you want to perform an initial deployment directly from the CD-ROM.

  9. When the following menu appears, enter the number corresponding to the action that you want to perform.

    1. Create vg00 volume group on local storage array and start the install
    2. Use existing vg00 volume group and start the install
    3. Install over network attached storage
    4. Install on existing users and mount points
    5. Quit
    Please enter action:
    
    

    Table 15 describes under what conditions you should perform each action and what additional steps you need to take to accomplish the action.

    Table 15 Installation Actions

    Action Condition
    1 If the vg00 volume group does not already exist. A volume group is a grouping of physical disk partitions. vg00 must exist before you create logical volumes for mounting file systems. When prompted, enter the external storage device (For example, sdb).
    2 If the vg00 volume group already exists.
    3 If you want to NFS mount the directories. Depending on the product that you are deploying, enter the mount points for some or all of the following, when prompted:
    • /interface

    • /mount_point/oracle

    • /mount_point/oradata

    • /mount_point/arch

    • /mount_point/applmgr

    • /mount_point/applcsf

    4 If the apmount_point and ormount_point users and the corresponding Apps mount points already exist.

The script then deploys the environment you selected. The log files are written to the log directory under EBSO_HOME.

Documentation Accessibility

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

Accessibility of Code Examples in Documentation

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

Accessibility of Links to External Web Sites in Documentation

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