3
Oracle9i Application Server

This chapter describes how to perform an Oracle9i Application Server (Oracle9iAS) installation. It contains the following sections

• Oracle9iAS Installation

• Oracle9iAS Install Types

• Oracle9iAS Postinstallation

3.1 Oracle9iAS Installation

The following instructions guide you through the installation steps for the four install types for Oracle9iAS.

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

Table 3-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
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 UsernameFootref 2 (Step 4 )	orcladmin
Oracle Internet Directory PasswordFootref 2 (Step 4)	welcome1
Oracle9iAS Metadata Repository (Section 1.3, "Oracle9iAS Infrastructure Installation")Foot 3	oasdocs.us.oracle.com
Oracle9iAS Reports Services Outgoing Mail Server Information (Step 7 )	oasdocs.us.oracle.com
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. 3 Required for multiple metadata repository availability.

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 3-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 3-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.

Do not install Oracle9iAS into any of the following directories:

• Oracle9iAS Infrastructure home directory

• Oracle9iAS home directory (unless it is for an install extension)

• Oracle9i Database home directory

• Oracle8i Database home directory

Select the Oracle9i Application Server installation and click Next.

Figure 3-3 Available Products Screen

Text description of the illustration availableprods.gif

After choosing the Oracle9iAS install, select one of the four install types listed in Section 3.2, "Oracle9iAS Install Types".

• Product Languages: Select product language for installation. The languages available for this product are Arabic, Bengali, Brazilian Portuguese, Bulgarian, Canadian French, Catalan, Croatian, Czech, Danish, Dutch, Egyptian, English, English (United Kingdom), Estonian, Finnish, French, German, Greek, Hebrew, Hungarian, Icelandic, Indonesian, Italian, Japanese, Korean, Latin American Spanish, Latvian, Lithuanian, Malay, Mexican Spanish, Norwegian, Polish, Portuguese, Romanian, Russian, Simplified Chinese, Slovak, Slovenian, Spanish, Swedish, Thai, Traditional Chinese, Turkish, Ukrainian, and Vietnamese. The default language is English.

3.2 Oracle9iAS Install Types

The Oracle9iAS installation offers the following install types:

• J2EE and Web Cache: Provides a Web server that enables you to develop and deploy Java and Enterprise Edition (J2EE) applications, use J2EE and Simple Object Access Protocol (SOAP) based Web services, and accelerates Web site performance with Oracle9iAS Web Cache.

• Portal and Wireless: Enables the deployment of enterprise portals and wireless applications. Includes all Oracle9iAS components available in the J2EE and Web Cache install type.

• Business Intelligence and Forms: Enables analysis of clickstream data, personalization of applications, use of forms-based applications, and deployment of Decision Support System and Web-based reports. Includes all Oracle9iAS components available in the Portal and Wireless install type.

• Unified Messaging: Enables the messaging capabilities of Oracle9iAS. Includes all of the Oracle9iAS components available in the Business Intelligence and Forms install type.

Table 3-2 lists the four installation options for Oracle9iAS and the Oracle9iAS components that are installed with each option.

See Also: Appendix E, "Components" Oracle9i Application Server Concepts Guide

Table 3-2 Oracle9iAS Components 

Component	J2EE and Web Cache	Portal and Wireless	Business Intelligence and Forms	Unified Messaging
Oracle9iAS Web Cache	Yes	Yes	Yes	Yes
Oracle HTTP ServerFoot 1	Yes	Yes	Yes	Yes
Oracle9iAS Containers for J2EE	Yes	Yes	Yes	Yes
Oracle Enterprise Manager Web site	Yes	Yes	Yes	Yes
Oracle9iAS PortalFoot 2	No	Yes	Yes	Yes
Oracle9iAS Wireless	No	Yes	Yes	Yes
Oracle9iAS DiscovererFoot 3	No	No	Yes	Yes
Oracle9iAS Reports Services	No	No	Yes	Yes
Oracle9iAS Clickstream Intelligence	No	No	Yes	Yes
Oracle9iAS Forms Services	No	No	Yes	Yes
Oracle9iAS Personalization	No	No	Yes	Yes
Oracle9iAS Unified Messaging	No	No	No	Yes

1 Oracle HTTP Server installs the following Oracle mods: mod_oc4j, mod_jserv, mod_osso, mod_ossl, mod_plsql, mod_proxy, DMS, FastCGI, HiAv Infrastructure, Oracle9iAS Object Caching Services for Java, SOAP, DBI/DBD, Clickstream Collector Agent. 2 Oracle9iAS Portal installs Oracle Ultra Search and Oracle9i Syndication Server. 3 Oracle9iAS Discoverer installs Discoverer Viewer and Discoverer Plus.

1. Select the Oracle9iAS install type you would like to install and click Next.

Figure 3-4 Installation Types Screen

Text description of the illustration installtypesjee.gif

The J2EE and Web Cache install type does not require Oracle9iAS Infrastructure.

During the installation you will be asked if you would like to use the single sign-on or clustering functionality. An application server cluster is a collection of application server instances with identical configuration and application deployment. Clusters enforce homogeneity between member instances so that a cluster of application server instances can appear and function as a single instance. With appropriate front-end load balancing, any instance in an application server cluster can serve client requests. This simplifies configuration and deployment across multiple instances and enables fault tolerance among clustered instances.

Clustering enables you to expand your application server capabilities and single sign-on simplifies security over your network. If you want to use either of these features you need to install Oracle9iAS Infrastructure first. Information about the application server cluster is maintained in the Oracle9iAS Infrastructure Metadata Repository. If you are not sure, you can configure for application server clustering and single sign-on later.

Prior to installing the Portal and Wireless, Business Intelligence and Forms, and Unified Messaging install types, you must install and configure the Oracle9iAS Infrastructure somewhere in your network, optimally on a separate server. The Oracle9iAS Infrastructure components, Oracle9iAS Single Sign-On, Oracle Internet Directory, and Oracle9iAS Metadata Repository must be running before proceeding with installation.

Note: The installation size shown in parentheses for the four Oracle9iAS install types may vary based on your system settings and file allocation during installation.

Select the Oracle9iAS components to configure during the installation process and click Next.

Figure 3-5 Component Configuration and Startup Screen

Text description of the illustration compconfum.gif

The Oracle9iAS components listed for configuration and startup will differ depending on the Oracle9iAS install type you choose.

If you de-select a component here, then 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 the Oracle9iAS component at a later time, launch the Oracle Enterprise Manager Home Page for component configuration.

Oracle9iAS Portal and Oracle9iAS Clickstream Intelligence use the Oracle9iAS Metadata Repository for metadata. If you want to use existing database metadata, do not select to configure Oracle9iAS Portal and Oracle9iAS Clickstream Intelligence.

See Also: Section 3.3.5.4, "Using a Customer Database" Oracle9iAS Portal User's Guide and Administrator's Guide Oracle9iAS Clickstream Intelligence Administrator's Guide Oracle9iAS Clickstream Intelligence Release Notes

In order to use mod_OraDAV with your Oracle9iAS Metadata Repository, you must select and configure Oracle9iAS Portal.

Oracle recommends selection and configuration of Oracle9iAS Portal for installations of Portal and Wireless, Business Intelligence and Forms, and Unified Messaging install types. Oracle9iAS Portal enables enhancement of features for Oracle9iAS Discoverer, Oracle9iAS Reports Services, and Oracle9iAS Clickstream Intelligence.

Oracle recommends selection and configuration of Oracle9iAS Discoverer for Oracle9iAS Clickstream Intelligence installation. Oracle9iAS Discoverer enables enhancement of many of Oracle9iAS Clickstream Intelligence features.

See Also: Oracle9iAS Reports Services: Publishing Reports to the Web Oracle9iAS Clickstream Intelligence Release Notes Oracle9iAS Discoverer Plus User's Guide

One of the following screens will appear based on the presence or absence of an instance of Oracle9iAS Single Sign-On on the install host:

• Infrastructure Summary: The Infrastructure Summary screen appears if you have an installation of Oracle9iAS Infrastructure on the install host.

• Oracle9iAS Infrastructure Use: The Oracle9iAS Infrastructure Use screen appears for the installation of J2EE and Web Cache.

• Existing Oracle9iAS Single Sign-On: The Existing Oracle9iAS Single Sign-On screen appears for all other Oracle9iAS install types.

1. Infrastructure Summary

   If you have installed Oracle9iAS Infrastructure on the install computer, the Infrastructure Summary screen appears. Review and note the information provided on the screen and click Next.

   The Infrastructure Summary screen provides you with the domain and port numbers for the installations of Oracle9iAS Single Sign-On and Oracle Internet Directory on the install computer.

2. Oracle9iAS Infrastructure Use

   Select whether to use Oracle9iAS Infrastructure and click Next.

Figure 3-6 Oracle9iAS Infrastructure Use Screen

Text description of the illustration infrause.gif

The Oracle9iAS Infrastructure Use screen appears for:

• The first time installation of Oracle9iAS

• Other Oracle9iAS instances on the installation host are not using single sign-on or clustering functionality

The Oracle9iAS Infrastructure Use screen allows you to select whether or not you will use Oracle9iAS Single Sign-On or clustering (with Oracle9iAS Infrastructure) with this installation of J2EE and Web Cache. This screen offers two options:

• Do not use Oracle9iAS Single Sign-On: Install a Web server without Oracle9iAS Infrastructure functionality.

• Use Oracle9iAS Single Sign-On: Use an existing Oracle9iAS Single Sign-On with Oracle9iAS Infrastructure that enables an authenticated user to access multiple accounts and Oracle9iAS applications, and enable clustering.

In order to use Oracle9iAS Single Sign-On, you must have the following information:

• Host Name: The name of the host where your instance of Oracle9iAS Single Sign-On and Oracle9iAS Infrastructure is located.

• Port Number: The port number of the host for your instance of Oracle9iAS Single Sign-On.

Oracle9iAS Single Sign-On is installed as part of the Oracle9iAS Infrastructure installation.

See Also: Chapter 1, "Installation Concepts" Chapter 4, "Oracle9iAS Infrastructure"

Existing Oracle9iAS Single Sign-On

Enter the Host Name and Port for your existing Oracle9iAS Single Sign-On instance and click Next.

Figure 3-7 Existing Oracle9iAS Single Sign-On Screen

Text description of the illustration existsso.gif

This screen appears for you to enter information about an existing instance of Oracle9iAS Single Sign-On that you will be using for your installation of Oracle9iAS.

The Existing Instance of Oracle9iAS Single Sign-On screen enables you to enter the following:

• Host Name: The location (host) of your Oracle9iAS Single Sign-On instance.

• Port: The port number of your Oracle9iAS Single Sign-On instance.

Enter a username and password to log on to Oracle Internet Directory and click Next.

Figure 3-8 Oracle Internet Directory Screen

Text description of the illustration oid.gif

In order to configure an instance of Oracle9iAS (J2EE and Web Cache, Portal and Wireless, Business Intelligence and Forms, or Unified Messaging) to use Oracle9iAS Infrastructure, the instance must be registered in Oracle Internet Directory.

Oracle Internet Directory enables retrieval of shared information about dispersed users and network resources. Oracle Internet Directory implements the Lightweight Directory Access Protocol (LDAP), version 3.

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

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

• Password: The password for user 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.

Enter the username and password for your registration of Oracle9iAS configuration information into Oracle Internet Directory. The username you enter must be a member of the IASAdmins group.

The default user is orcladmin.The default password for the orcladmin user is the same as the password for the ias_admin user on the host where Oracle Internet Directory is configured. The Oracle Internet Directory administrator may add other users and assign a different password for this group.

See Also: Chapter 4, "Oracle9iAS Infrastructure" Oracle Internet Directory Administrator's Guide

One of the following screens appears based on whether Oracle9iAS has been installed on this host:

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

• Enter ias_admin Password: This screen appears if the Oracle Universal Installer has detected a previous installation of Oracle9iAS in your Oracle home.

• Create Instance Name: This screen appears if the Oracle Universal Installer has detected a previous installation of Oracle9iAS 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 on this host.

ias_admin Password: The ias_admin user's password used to administer any Oracle9iAS this host. This password is required for installation of additional Oracle9iAS instances.

1. Create Instance Name and ias_admin Password

   Enter a unique Oracle9iAS instance name and ias_admin password and click Next.

Figure 3-9 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. The instance name must contain alphanumeric and underscore characters only.

Select an ias_admin password for this instance of Oracle9iAS 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 on the install host.

The ias_admin password enables 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 Oracle9iAS Portal as part of this installation, the portal and portal_admin user accounts in Oracle Internet Directory use the ias_admin password by default. Refer to the following URL for more Oracle9iAS Portal information: http://portalstudio.oracle.com

Enter ias_admin Password

Enter your Oracle9iAS ias_admin password and click Next.

Figure 3-10 Enter ias_admin Password Screen

Text description of the illustration manage.gif

If the Oracle Universal Installer detects a previous installation of Oracle9iAS in your Oracle home, this screen appears. The existing Oracle9iAS instance name will be used for this installation. Enter your existing Oracle9iAS ias_admin password for this host to continue with the installation.

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.

Create Instance Name

Enter a unique Oracle9iAS instance name and the ias_admin password and click Next.

Figure 3-11 Create Instance Name Screen

Text description of the illustration createinstance2.gif

If the Oracle Universal Installer has detected a previous installation of Oracle9iAS 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 the steps you can follow to reset the password.

This screen appears if the Oracle Universal Installer detects multiple installations of Oracle9iAS Metadata Repository. Oracle9iAS Metadata Repository installs as part of the Oracle9iAS Infrastructure installation.

Select the Oracle9iAS Metadata Repository you would like to use for this Oracle9iAS installation and click Next.

Figure 3-12 Oracle9iAS Metadata Repository Screen

Text description of the illustration metadata.gif

Oracle Universal Installer has detected multiple Oracle9iAS Metadata Repositories registered in your Oracle Internet Directory. Select the Oracle9iAS Metadata Repository that you want to use with this installation of Oracle9iAS.

If you want to implement application server instance clustering, you must select the metadata repository used by other application server instances in your network.

If you do not want to use application server instance clustering, select any listed metadata repository. Your selection will be the default location for Oracle9iAS component metadata.

If you want an Oracle9iAS component within this Oracle9iAS installation to use a different database, use the Oracle Enterprise Manager Home Page following installation to change database connectivity.

See Also: Chapter 1, "Installation Concepts" Chapter 4, "Oracle9iAS Infrastructure" Section 3.3.1, "Starting the Oracle Enterprise Manager Web Site"

The Provide Outgoing Mail Server Information screen appears if you have selected Oracle9iAS Reports Services for installation.

Enter the outgoing mail server to use with Oracle9iAS Reports Services and click Next.

Figure 3-13 Provide Outgoing Mail Server Information Screen

Text description of the illustration outgoingmail.gif

Oracle9iAS Reports Services supports distribution of reports using Email. To use this feature, you must provide the name of the outgoing mail server. For example:

oasdocs.us.oracle.com

You can leave this field blank and proceed with the installation. At a later time you can make changes to the outgoing Email server in the Oracle9iAS Reports Services configuration file at the following location:

ORACLE_HOME/reports/conf/reports_server_name.conf

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 3-14 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 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.

For more information about the installation log, refer to 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 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.

• Exit: Quit the configuration tool and continue with the installation.

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

Figure 3-15 End of Installation Screen

Text description of the illustration eoiappsrv.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 3.3.1, "Starting the 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 your selected Oracle9iAS install type. Proceed to Section 3.3, "Oracle9iAS Postinstallation" to complete the installation process.

3.3 Oracle9iAS Postinstallation

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

The postinstallation section contains the following topics:

• Starting the Oracle Enterprise Manager Web Site

• Component Dependent Configuration

• Configuring Additional Components

• Postinstallation Configuration Tasks

• Starting and Stopping Components

• Component Port Numbers

• Additional Oracle9iAS Product Installations

• Additional Documentation

3.3.1 Starting the Oracle Enterprise Manager Web Site

The Oracle Enterprise Manager Web site is available after Oracle9iAS 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.

3.3.2 Installing the Oracle9i Application Server Patches

Following successful installation and configuration of Oracle9i Application Server you must download and install the Oracle9i Application Server 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.

3.3.3 Component Dependent Configuration

Descriptions of interdependencies between Oracle9iAS components and configuration dependencies can be found in the Oracle9i Application Server Administrator's Guide.

3.3.4 Configuring Additional Components

You can configure additional Oracle9iAS components after installation. Configuration of additional Oracle9iAS components is described in Chapter 9, "Reconfiguring the Application Server", in the Oracle9i Application Server Administrator's Guide.

3.3.5 Postinstallation Configuration Tasks

Complete the following postinstallation configuration tasks

3.3.5.1 Java Authentication and Authorization Service

You must configure Java Authentication and Authorization Service (JAAS) components before using your JAAS-based applications. JAAS configuration tasks are described in the Oracle9iApplication Server Security Guide.

3.3.5.2 Oracle9iAS Discoverer

In order for Discoverer Plus or Discoverer Viewer to query a database, you must set up a Discoverer End User Layer. Oracle9i Discoverer Administrator creates the End User Layer. Installation information is available in the Oracle9i Discoverer Administrator's Guide that is shipped with the Oracle9i Developer Suite, Release 2.

Additional product and component information can be found on the OTN Web site:

http://technet.oracle.com/docs/index.htm

3.3.5.3 Using the Oracle9iAS Metadata Repository

For information on using Oracle9iAS Clickstream Intelligence with the Oracle9iAS Metadata Repository, refer to Oracle9iAS Clickstream Intelligence Release Notes.

3.3.5.4 Using a Customer Database

In order to use the following Oracle9iAS components you must use an existing customer database. Refer to component documentation for the following:

• Oracle9iAS Unified Messaging (Oracle9iAS Unified Messaging Administrator's Guide)

• Oracle9iAS Discoverer (Oracle9iAS Discoverer Administrator's Guide)

• Oracle9iAS Personalization (Oracle9iAS Personalization Administrator's Guide)

• Oracle9iAS Portal (optional) (Oracle9iAS Portal User's and Administrator's Guide)

• Oracle9iAS Clickstream Intelligence (optional) (Oracle9iAS Clickstream Intelligence Release Notes and Oracle9iAS Clickstream Intelligence Administrator's Guide)

Oracle9iAS Portal and Oracle9iAS Clickstream Intelligence can connect to a customer database or use the Oracle9iAS Metadata Repository.

By default, Oracle Management Server configuration will use the Oracle9iAS Metadata Repository that is installed and configured in the same Oracle home. If you want to configure Oracle Management Server to use a different installation of Oracle9iAS Metadata Repository or Oracle9i Database Server, follow the steps detailed in Oracle9i Application Server Administrator's Guide.

3.3.5.5 Using mod_plsql

In order to use mod_plsql to deploy PL/SQL applications with an existing customer database, without using Oracle9iAS Portal, follow the instructions in the Oracle9i Application Server mod_plsql User's Guide.

3.3.6 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 component specific documentation.

3.3.7 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. The file portlist.ini is located at:

$ORACLE_HOME/install/portslist.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 3.3.1, "Starting the Oracle Enterprise Manager Web Site" Appendix F, "Default Port Numbers and Port Ranges" Section 2.5, "Preinstallation Tasks" Oracle9i Application Server Administrator's Guide

3.3.8 Changing the X Server Display

To change the X server display following installation, you must edit the opmn.xml file installed on your computer.

The opmn.xml file is located at:

ORACLE_HOME/opmn/conf/opmn.xml

The format of the opmn.xml file is:

<prop name="DISPLAY" value= "hostname:display_number.screen_number"/>

hostname:display_number.screen_number is the X server you want to use.

After you modify the opmn.xml file, restart all of your OC4J instances.

See Also: Section 2.5.3.2, "DISPLAY"

3.3.9 Oracle9iAS Demonstration Software

Oracle9iAS provides demonstration applications for many Oracle9iAS components.

In order to run a demonstration for a specific Oracle9iAS component, you must have an Oracle9iAS installation that contains the component, the component must be configured, and the required component instances must be running.

For more information and run the demonstration software go to the Oracle Enterprise Manager Home Page and click Demonstrations.

See Also: Oracle9i Application Server Administrator's Guide

3.3.10 Additional Oracle9iAS Product Installations

For information on installing additional Oracle9iAS installations, refer to Section 2.8, "Additional Oracle9iAS Product Installations", and Chapter 7, "Coexistence".

3.3.11 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".