3
Oracle9i Application Server

This chapter guides you through the steps for the Oracle9i Application Server (Oracle9iAS) installation. The topics include:

• 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/oraInventory
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

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.

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

   Input 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 stored in 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 /var/opt/oracle/oraInst.loc file, which provides a pointer to the oraInventory directory.

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

3. 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 of ora9ias 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 program group associated with a specific Oracle home and 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 the preinstallation chapter.

     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

4. 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 Container 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 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 machine. 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. Accurate install file size is available from the Summary screen in Step 8.

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

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

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

4. Enter a username and password to logon 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

5. 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 users 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

   2. 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 users password following installation, refer to the Oracle9i Application Server Administrator's Guide for the steps you can follow to reset the password.

   3. 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 users password following installation, refer to the Oracle9i Application Server Administrator's Guide for the steps you can follow to reset the password.

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

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

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

9. 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> ORACLE_HOME/root.sh
      

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

   3. Exit root user.

      Once you see "Finished running generic part of the root.sh script" and "Now product-specific root actions will be performed," exit root user and 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.

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

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

    Figure 3-14 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/installActiontodays_date_time.log
    

    in which 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

Interdependencies between Oracle9iAS components and what the configuration of the component is dependent upon can be found in the Oracle9i Application Server Administrator's Guide.

3.3.4 Configuring Additional Components

You can configure additional Oracle9iAS components following 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

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 at t the OTN Web site at:

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 manual 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 alternate port in the range allocated for that component. 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 uses the port numbers for select components during installation of Oracle9iAS. If you are planning on adding additional Oracle9iAS instances, make sure the installed instances are running at the time of additional installation.

.

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.

To obtain 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".