4
Oracle9iAS Infrastructure

This chapter describes how to perform an Oracle9iAS Infrastructure installation. It contains the following sections:

• Oracle9iAS Infrastructure Installation

• Oracle9iAS Infrastructure Postinstallation

4.1 Oracle9iAS Infrastructure Installation

The following instructions guide you through the Oracle9iAS Infrastructure installation of Oracle9i Application Server (Oracle9iAS).

Note: J2EE and Web Cache installs with Oracle9iAS Infrastructure, but Oracle Corporation does not support the use of this copy of J2EE and Web Cache for customer application deployment. This installation of J2EE and Web Cache configures Oracle HTTP Server and Oracle9iAS Container for J2EE.

Table 4-1 lists required information for Oracle9iAS Infrastructure installation. Enter your values for the listed installation information in the Your Information column before beginning.

Table 4-1 Installation Information  

Information	Example Values	Your Information
Oracle base directoryFoot 1 (Section 2.5.3.1, "ORACLE_HOME")	/private
Oracle home location (Section 2.5.3.1, "ORACLE_HOME")	/private/ora9ias
OSDBA groupFootref 1 (Section 2.5.5.3, "UNIX Group Names for Privileged Groups")	svrtech
OSOPER groupFootref 1 (Section 2.5.5.3, "UNIX Group Names for Privileged Groups")	svrtech
Instance Name (Section 2.5.3.1, "ORACLE_HOME")	instance1
ias_admin Password (Section 2.5.3.1, "ORACLE_HOME")	oracle1
Oracle9iAS Single Sign-On Server Host NameFoot 2 (Section 1.3, "Oracle9iAS Infrastructure Installation")	oasdocs.us.oracle.com
Oracle9iAS Single Sign-On Port NumberFootref 2 (Appendix F, "Default Port Numbers and Port Ranges")	7777
Oracle Internet Directory Host Name (Section 1.3, "Oracle9iAS Infrastructure Installation")	oasdocs.us.oracle.com
Oracle Internet Directory Port Number (Appendix F, "Default Port Numbers and Port Ranges")	389
Database Character Set (Step 9 )	default
JDK Home Directory (required only for AIX-Based Systems, Compaq Tru64 UNIX and HP 9000 Series HP-UX)	/jdkhome

1 Required for first time installation of Oracle9iAS. 2 Required for Portal and Wireless, Business Intelligence and Forms, and Unified Messaging install types. Also required for application server clustering with J2EE and Web Cache install type. See the Oracle9i Application Server Administrator's Guide for more information about clustering.

To perform the installation:

1. Review the Oracle Universal Installer Welcome screen and click Next.

   The Welcome screen provides information about the Oracle Universal Installer. The following function buttons appear on the installation screens:

   • Deinstall Products: Deinstall individual components or the entire product. This button appears only on the Welcome screen.

   • About Oracle Universal Installer: View the version number of the installer in use.

   • Exit: Quit the installation process and exit the installer.

   • Help: Access detailed information about the functionality of each screen.

   • Installed Products: View currently installed products or deinstall the entire product or components.

   • Previous: Return to the previous screen.

   • Next: Proceed to the next screen.

2. Verify the location of the base directory for installation files and click OK.

Figure 4-1 Inventory Location Screen

Text description of the illustration inventoryloccommon.gif

The Inventory Location screen appears during the first installation on a host to set a location for installation files. Product components use a different directory. The installation files can vary in size depending on the complexity of the product. For file storage considerations, assume a file size of 150 KB per product.

• Browse: Navigate through the available directory to select a location for the base directory for your installation.

The base directory has the following attributes:

• Contains the permanent and per-product component files in subdirectories

• Must be writable by anyone in the same user group installing or deinstalling products on the install computer

Enter the location where you would like the base directory to be stored. For example:

/private

The storage location for product component files is the Components directory. For example:

/private/oraInventory/Components

• You need root privileges to execute certain actions before the installation can continue. You need to run a shell script with root privileges, that is, the orainstRoot.sh file. (You may need to execute the shell script by typing "./" before orainstRoot.sh). The Root.sh installation screen shows the location of the orainstRoot.sh file. The script creates pointers to the components as the installer installs them in the system, so that they can be identified later in the installation procedure. It produces the oraInst.loc file, which defines the location of the oraInventory directory. See Table 2-13 for the location of the orainst.loc file for your system.

After you execute the shell script, continue with the installation process.

Verify the source path, destination name, and destination path for your Oracle9iAS installation and click Next.

Figure 4-2 File Locations Screen

Text description of the illustration fileloc.gif

The File Locations screen allows you to enter the full path for the source and destination locations for your installation.

• Source: This is the full path to the products.jar file from which the product will be installed. The installer detects and uses the default values of the products.jar file of the installation program. Do not change the path.

• Name: Enter an Oracle home name or select a name from the drop-down list. You may use the default Oracle home name provided or select your own name. If you do not have a home created on your computer, one is created for you during the installation.

  Oracle homes are identified by name. The Oracle home name identifies the installed Oracle services associated with the home.

  The Oracle home name must consist of 1 to 16 characters long and can only include alphanumeric characters and underscores; spaces are not allowed.

• Destination: This is the full path to the Oracle home where the product will be installed. The installer defaults to the Oracle home set in Chapter 2.

  Note: The Oracle home path must be an absolute path. It cannot contain environment variables or spaces.

  See Also: Section 2.5.3.1, "ORACLE_HOME"

• Browse: Navigate through the file system to find source and destination locations.

Oracle9iAS Infrastructure needs to be installed in a separate Oracle home, preferably on a separate host from any Oracle9iAS installations. Do not install Oracle9iAS Infrastructure into an existing:

• Oracle9i Database home directory

• Oracle8i Database home directory

• Another Oracle9iAS Infrastructure home directory unless it is for an upgrade

• Another Oracle9iAS instance home directory

Select the Oracle9iAS Infrastructure product type and click Next.

Figure 4-3 Available Products Screen

Text description of the illustration availprodinfra.gif

Oracle9iAS Infrastructure installs Oracle9iAS Metadata Repository, Oracle Internet Directory, Oracle9iAS Single Sign-On, and Oracle Management Server. Oracle9iAS Infrastructure is required for all of the Oracle9iAS middle-tier applications except when installing the J2EE and Web Cache install type without single sign-on or clustering. Prior to installing an instance of either Portal and Wireless, Business Intelligence and Forms, or Unified Messaging, you must install and configure the Oracle9iAS Infrastructure somewhere in your network.

See Also : Oracle9i Application Server Concepts Guide

Choose to either accept installer recommendations for Oracle9iAS Infrastructure components, or specify existing instances of components and click Next.

Figure 4-4 Select Configuration Options Screen

Text description of the illustration compinfra.gif

The Select Configuration Options screen offers two configuration options

• Accept default selection: Installation and configuration of Oracle9iAS Metadata Repository, Oracle Internet Directory, and Oracle9iAS Single Sign-On is completed at the end of the installation process.

• Specify your choice: Previous instances of Oracle Internet Directory and Oracle9iAS Single Sign-On are available for use. If you wish to use an existing Oracle Internet Directory or Oracle9iAS Single Sign-On server, deselect each component, and you will be asked to provide their locations. Choose this option if you also want to configure Oracle Management Server.

If you deselect a component here, the installer installs it, but does not configure or start it. After installation, the installer starts the selected Oracle9iAS component. If you decide to use that component at a later time, then launch the Oracle Enterprise Manager Home Page to configure that component.

If you would like to configure Oracle Internet Directory and Oracle9iAS Single Sign-On on separate hosts:

1. Choose to configure Oracle Internet Directory and not to configure Oracle9iAS Single Sign-On, on the first host, Host 1.

2. Choose to configure Oracle9iAS Single Sign-On and not to configure Oracle Internet Directory, on the second host, Host 2.

3. Point the Oracle9iAS Single Sign-On configuration on Host 2 to the Oracle Internet Directory configuration on Host 1.

If you plan to install copies of Oracle Internet Directory on different hosts to form a directory replication network, configure Oracle9iAS Single Sign-On with only one of the Oracle Internet Directory copies. The remaining copies of Oracle Internet Directory must not be associated with any Oracle9iAS Single Sign-On configuration. Refer to the Oracle Internet Directory Administrator's Guide for more information.

Oracle9iAS Metadata Repository is always configured and started during Oracle9iAS Infrastructure installation.

One of the following two screens may appear based on your configuration choices on the "Select Configuration Options Screen", (Figure 4-4)

• Existing Oracle9iAS Single Sign-On: This screen appears if you have unchecked the configuration of Oracle9iAS Single Sign-On on the Component Configuration and Startup screen.

• Existing Oracle Internet Directory: This screen appears if you have unchecked the configuration of Oracle Internet Directory on the Component Configuration and Startup screen.

1. Existing Oracle9iAS Single Sign-On

   Enter the host name and port number for the existing instance of Oracle9iAS Single Sign-On that you wish to use with this installation of Oracle9iAS Infrastructure and click Next.

Figure 4-5 Existing Oracle9iAS Single Sign-On Screen

Text description of the illustration existsso.gif

If you do not have Oracle9iAS Single Sign-On installed, return to the Component Configuration and Startup screen and select the default configuration option for Oracle9iAS Single Sign-On.

Existing Oracle Internet Directory

Enter the host name and port number for the existing instance of Oracle Internet Directory that you wish to use with this installation of Oracle9iAS Infrastructure and click Next.

Figure 4-6 Existing Oracle Internet Directory Screen

Text description of the illustration existoid.gif

This screen appears if you have unchecked the configuration of Oracle Internet Directory on the Component Configuration and Startup screen.

If you do not have Oracle Internet Directory installed, you must install it through the Oracle9iAS Infrastructure installation before proceeding with this installation.

Oracle Internet Directory and Oracle9iAS Single Sign-On are required components for using Infrastructure.

• Host Name: The unique identity for each computer within a domain. Enter the host name where Oracle Internet Directory is located. For example, oid.oracle.com.

• Port: The number used to route transmitted data to and from a particular program. Enter the port number where Oracle Internet Directory is located.

You will need the following to add information about the Oracle9iAS instance into Oracle Internet Directory:

• Username: The name used for connection to Oracle Internet Directory.

• Password: The password for users to access Oracle Internet Directory.

The username and password are defined in Oracle Internet Directory as either the:

• orcladmin (root user)

• a member of the IASAdmins group in Oracle Internet Directory

The username creates a user entity in Oracle Internet Directory. The user must be a member of the IASAdmins group. By default, orcladmin (the Oracle Internet Directory administrator) is also a member of the IASAdmins group. If the Oracle Internet Directory administrator does not wish to give out the orcladmin password, the administrator creates a username and password for a member of the IASAdmins group. Refer to the Oracle Internet Directory Administrator's Guide for more information.

One of the following screens will appear based on whether an Oracle9iAS installation exists on this host:

• Create Instance Name and ias_admin Password Screen: This screen appears if this is a first time installation of Oracle9iAS on this host.

• Create Instance Name Screen: This screen appears if the Oracle Universal Installer has detected a previous Oracle9iAS installation on this host but in a different Oracle home.

The following terms may be used on the following three screens:

Instance Name: Identifies the installation instance of Oracle9iAS Infrastructure on this host.

ias_admin password: The ias_admin user's password used to administer any Oracle9iAS on this host. This password is required for installing additional Oracle9iAS instances. If you are configuring Oracle Internet Directory, the default administrative user, "orcladmin", will be assigned the same password as the ias_admin user by default. The orcladmin user is a superuser for Oracle Internet Directory.

1. Create Instance Name and ias_admin Password

   Enter a unique instance name and ias_admin user's password for this installation of Oracle9iAS Infrastructure and click Next.

Figure 4-7 Create Instance Name and ias_admin Password Screen

Text description of the illustration createinstance.gif

This screen appears if this is a first time installation of Oracle9iAS on this host.

Enter a unique name in the instance name field for this installation of Oracle9iAS Infrastructure. The instance name must contain alphanumeric and underscore characters only.

Select an ias_admin password for this instance of Oracle9iAS Infrastructure and then re-enter the password for confirmation. The ias_admin password must consist of at least five alphanumeric characters. Additionally, at least one of the characters must be a number.

The unique instance name will be used to identify this installation of Oracle9iAS Infrastructure on the install host.

The ias_admin password allows you to:

• Manage all instances of Oracle9iAS across the install host

• Run management tools

• Facilitate future installations

• Access the Oracle Enterprise Manager Home Page

Note: If you are configuring Oracle Internet Directory as part of this installation, the default administrative user, orcladmin, will be assigned the same password as the ias_admin user by default.

Create Instance Name

Enter a unique instance name and the ias_admin password for this installation of Oracle9iAS Infrastructure and click Next.

Figure 4-8 Create Instance Name Screen

Text description of the illustration createinstance2.gif

If the Oracle Universal Installer has detected a previous Oracle9iAS installation on this host but in a different Oracle home this screen appears. Enter a unique instance name and the existing ias_admin password for this host to continue with the installation. The instance name must contain alphanumeric and underscore characters only.

If you forget your ias_admin user's password following installation, refer to the Oracle9i Application Server Administrator's Guide for information about how you can reset the password.

This screen appears only if the oracle account is not a member of the dba group. Enter the database administrator and operator group name and click Next.

Figure 4-9 Privileged Operating System Groups Screen

Text description of the illustration privos.gif

The Privileged Operating System Groups screen allows you to enter the database administrator and operator group name for installation of the Oracle9iAS Metadata Repository. For more information regarding privileged group names, refer to Section 2.5.5.3, "UNIX Group Names for Privileged Groups". The installer detects and defaults to the your OS group.

• Database Administrator (OSDBA) Group: The UNIX group that has database administrator privileges

• Database Operator (OSOPER) Group: The UNIX group that has database operator privileges

Select the Database Character Set you would like to use and click Next.

Figure 4-10 Database Character Set Screen

Text description of the illustration dbcharset.gif

Choose from one of the three following character sets for your database:

• Default character set: Based on the language of the install operating system. If you intend to store data in one language, accept the default database character set

• Unicode as the character set: Enables you to store multiple language groups

• Choose one of the common character sets: Click Help to view the list of available common character sets

If you are installing Oracle9i Application Server on AIX-Based Systems, Compaq Tru64 UNIX, or HP 9000 Series HP-UX, you are prompted for the JDK home directory. Enter the full path of the JDK home directory. Refer to "Operating System Requirements" for a list of JDK requirements.

JDK is a prerequisite for the Oracle HTTP component. The Choose JDK Home Directory screen prompts for the JDK_HOME path during the Oracle9i Application Server installation.

Figure 4-11 Choose JDK Home Directory Screen

Text description of the illustration jdk.gif

Review the Summary screen and click Install to begin the installation process.

The Summary screen allows you to review all the settings before the installation begins. These settings include source, destination, installation type, product language, install file sizes, and a list of Oracle9iAS components.

• To make changes to any of these settings, click Previous to return to the respective screens.

  Note: Insufficient disk space is indicated in red under Space Requirements.

When you click Install, the installation process begins.

Monitor the installation process and after the installer finishes, click Next.

The Install screen appears while the product is installing. The Install screen shows installation operations, including executing actions such as file copy and linking, and executing decision points and calculations. It displays the full path of the installation log.

• Cancel: Discontinues the installation process. You can then choose to stop the installation of an individual component or the entire product.

  See Also: Section 2.6.3, "oraInventory Directory"

Running root.sh

During installation of Oracle9iAS, the installer prompts you to run the root.sh script.

Use the following steps to run the root.sh script.

1. Log on as the root user.

2. Run the root.sh script in the Oracle home directory.

   prompt> cd ORACLE_HOME
   prompt> ./root.sh
   
   

   You may need to execute the shell script by typing "./" before root.sh.

3. Exit root user.

   After you see the Finished running generic part of the root.sh script and Now product-specific root actions will be performed messages, wait for the prompt, then exit the root account to return to the Install screen.

The root.sh script detects:

• Settings of ORACLE_OWNER, ORACLE_HOME and ORACLE_SID environment variables.

• Full path of local bin directory. You can accept the default or change to a different local bin directory.

Review the status of Oracle9iAS configuration tools and click Next.

The Components Configuration and Startup screen appears for Oracle9iAS components to configure and start. The screen lists the configuration tools for all installed components.

Depending on the configurations selected, you will see some component configuration screens, but no input is required.

Monitor the progress of each configuration tool by scrolling down the tools list to review the configuration status of each tool. The status changes as each component is configured.

The installer performs the following functions in this screen:

• Executes a configuration tool for each component selected previously in the Component Configuration and Startup screen.

• Allows you to view data for failed executions in the display window. You can either fix the error and click Retry to execute the configuration tool again, or ignore the error and click Next to proceed to the next screen.

• Retry: Re-executes the configuration script if the configuration of a component fails.

• Stop: Quits the configuration process.

Review the End of Installation screen. Click Exit to quit the installer or click Next Install to install additional Oracle9iAS instances.

Figure 4-12 End of Installation Screen

Text description of the illustration eoiinfra.gif

The End of Installation screen appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful and provides information about accessing the Oracle9iAS instance.

The End of Installation screen displays the URL and port number for accessing the Oracle HTTP Server page and the Oracle Enterprise Manager Web Site. The default Oracle HTTP Server page is the Oracle9iAS Welcome page. The Oracle9iAS Welcome page provides links to demonstrations and information about new features.

See Also: Section 4.2.1, "Starting Oracle Enterprise Manager Web Site" Oracle9i Application Server Administrator's Guide

You can view the Install Log for the completed installation at:

/your_base_directory/oraInventory/logs/installActionstodays_date_time.log

where your_base_directory is the location for your installation files and todays_date_time is the date and time of installation.

A complete listing of log files is included in the Oracle9i Application Server Administrator's Guide.

You have successfully installed the Oracle9iAS Infrastructure installation of Oracle9iAS.

Proceed to Section 4.2, "Oracle9iAS Infrastructure Postinstallation" to complete the installation process.

4.2 Oracle9iAS Infrastructure Postinstallation

The following instructions guide you through the basic postinstallation tasks for Oracle9iAS Infrastructure.

The postinstallation contains the following sections:

• Starting Oracle Enterprise Manager Web Site

• Installing the Oracle9iAS Infrastructure Patches

• Starting and Stopping Components

• Component Port Numbers

• Additional Oracle9iAS Product Installations

• Additional Documentation

4.2.1 Starting Oracle Enterprise Manager Web Site

The Oracle Enterprise Manager Web Site is available after Oracle9iAS Infrastructure installation and component configuration. The Oracle Enterprise Manager Web Site is comprised of Oracle Enterprise Manager Home Pages. Each Oracle Enterprise Manager Home Page is used to manage an installed Oracle9iAS component or instance.

Oracle strongly recommends that you use the Secure Socket Layer (SSL) protocol and HTTPS for all connections to the Oracle Enterprise Manager Web Site. Refer to the Oracle9i Application Server Administrator's Guide for setup information.

4.2.2 Installing the Oracle9iAS Infrastructure Patches

Following successful installation and configuration of Oracle9iAS Infrastructure you must download and install the Oracle9iAS Infrastructure patches. You can download the patches from:

http://metalink.oracle.com

Select the Patches link. On the patch download form, select Oracle9i Application Server in the Product Family field and then submit the form.

4.2.3 Starting and Stopping Components

Oracle9iAS components can be started and stopped using the Oracle Enterprise Manager Home Page. For information on manually starting and stopping of Oracle9iAS components refer to the component specific documentation.

4.2.4 Component Port Numbers

Following installation, the Oracle Universal Installer creates a file showing the port assignments during installation of Oracle9iAS components. The installation process automatically detects any port conflicts and chooses an alternative port in the range allocated for that component. Appendix F, "Default Port Numbers and Port Ranges" lists the default port ranges. The file portlist.ini is located at:

OracleHome/install/portlist.ini

This file lists component entries as "port name = port value". For example:

Oracle HTTP Server port = 7777
Oracle HTTP Server SSL port = 4443
Oracle HTTP Server listen port = 7778
Oracle HTTP Server SSL listen port = 4444
Oracle HTTP Server Jserv port = 8007
Enterprise Manager Servlet port = 1810

You can also view the port numbers by pointing your browser to the Oracle9iAS Welcome page and selecting the Ports tab

Note: The Oracle Universal Installer allocates the port numbers for the selected components during installation. If you want to install additional Oracle9iAS instances, make sure the existing instances are running before attempting to install these additional instances.

.

See Also: Section 4.2.1, "Starting Oracle Enterprise Manager Web Site" Appendix F, "Default Port Numbers and Port Ranges" Section 2.5, "Preinstallation Tasks" Oracle9i Application Server Administrator's Guide

4.2.5 Additional Oracle9iAS Product Installations

For information regarding installation of additional Oracle9iAS installations, refer to Section 2.8, "Additional Oracle9iAS Product Installations", and Chapter 7, "Coexistence".

4.2.6 Additional Documentation

For further information on postinstallation and configuration tasks, refer to the Oracle9i Application Server Administrator's Guide and component-specific documentation. For information on viewing and installing the documentation, refer to Appendix G, "Installing the Documentation Library".