3
Installation

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

• Installation

• Postinstallation

3.1 Installation

The following instructions guide you through the installation steps for Oracle9iAS 9.0.3.

During the Oracle9iAS 9.0.3 installation, you will be asked if you want to use single sign-on or clustering. If you want to use either single sign-on or enable cluster management, then you need to install Oracle9iAS Infrastructure 9.0.2. Oracle9iAS 9.0.3 is compatible with Oracle9iAS Infrastructure 9.0.2.

When you are installing Oracle9iAS 9.0.3 and will be using an existing Oracle9iAS Infrastructure 9.0.2, ensure that the following components are running on the infrastructure host:

• Oracle9iAS Metadata Repository

• Oracle Internet Directory

• Oracle9iAS Single Sign-On

• Oracle HTTP Server

• The OC4J_DAS instance of Oracle9iAS Containers for J2EE

  Note: If you will be using Oracle9iAS 9.0.3 on the same host or farm as Oracle9iAS 9.0.2, then you must install the Oracle9i Application Server 9.0.2.1 patch. See Section 2.7.2.1, "Installing the Oracle9i Application Server 9.0.2.1 Patch" for more information.

  See Also: Chapter 1, "Installation Concepts" Oracle9i Application Server 9.0.2 Installation Guide Oracle9i Application Server Administrator's Guide

Table 3-1 lists required information for Oracle9iAS 9.0.3 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 home location (Section 2.5.2.1, "Oracle Home")	D:\ora9ias
Instance Name (Section 2.5.2.1, "Oracle Home")	instance1
ias_admin Password (Section 2.5.2.1, "Oracle Home")	welcome1
Oracle9iAS Single Sign-On Server Host NameFoot 1 (Oracle9i Application Server 9.0.2 Installation Guide)	iasdocs.us.oracle.com
Oracle9iAS Single Sign-On Port NumberFootref 1 (Oracle9i Application Server 9.0.2 Installation Guide)	7777
Oracle Internet Directory UsernameFootref 1(Oracle9i Application Server 9.0.2 Installation Guide)	orcladmin
Oracle Internet Directory PasswordFootref 1(Oracle9i Application Server 9.0.2 Installation Guide)	welcome1Foot 2
Oracle9iAS Metadata RepositoryFoot 3 (Oracle9i Application Server 9.0.2 Installation Guide)	iasdocs.us.oracle.com

1 Required for using single sign-on functionality or enabling application server cluster management. See the Oracle9i Application Server Administrator's Guide for more information about clustering. 2 The default password for orcladmin user is the same as the password for the ias_admin user. 3 Required only if you have multiple metadata repositories. See Chapter 10, "Reconfiguring the Application Server", in the Oracle9i Application Server Administrator's Guide for details.

Note: Before installation on a host that already has an Oracle9iAS instance, you must stop the Oracle Enterprise Manager Web site using the Services panel: (Windows NT) Go to Start > Settings > Control Panel > Services. Select the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop button. (Windows 2000) Go to Start > Programs > Administrative Tools > Services. Select the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop icon. After installation, you can restart the Oracle Enterprise Manager Web site by clicking the Start button or icon.

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

   The Welcome screen provides information about the Oracle Universal Installer.

   The following 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.

   • 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 source path, destination name, and destination path for your Oracle9iAS 9.0.3 installation and click Next.

   Figure 3-1 File Locations Screen

   

   Text description of the illustration nt_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_home and path name ora9ias provided or select your own name and path. 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 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.

     Note: The Oracle9iAS 9.0.3 instance must be installed in its own Oracle home. For example, you cannot install Oracle9iAS 9.0.3 into any Oracle9iAS 9.0.2 Oracle home. The Oracle9iAS 9.0.3 instance can be installed on the same or a different host from Oracle9iAS Infrastructure 9.0.2.

     See Also: Section 2.5.2.1, "Oracle Home"

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

   Do not install Oracle9iAS 9.0.3 into any existing Oracle directories. For example:

   • Oracle9i Application Server 9.0.2 home directory

   • Oracle9iAS Infrastructure 9.0.2 home directory

   • Oracle9iAS Developer Kits 9.0.2 home directory

   • Oracle9i Database home directory

   • Oracle8i Database home directory

   • Oracle9i Developer Suite directory

   If you want to migrate applications and configuration data from an existing Oracle9iAS 9.0.2 J2EE and Web Cache mid-tier, you install Oracle9iAS 9.0.3 in a separate directory, then migrate your applications from 9.0.2 to 9.0.3. You cannot migrate by installing 9.0.3 in the 9.0.2 directory. See the Oracle9i Application Server Migrating to Release 2 (9.0.3) guide for details.

3. (Windows NT only) If Windows system files on your machine are outdated, then you will see a warning dialog.

   

   Text description of the illustration wsf_warning.jpg

   If you see this dialog:

   1. Click OK to dismiss it.

   2. Click Exit to quit the Oracle9iAS 9.0.3 installation.

   3. If you have any open or unsaved documents from other applications, save and close them. This is important because wsf.exe (the executable that you need to run) will reboot the machine automatically when it is complete.

   4. Change to the root directory on the Oracle9iAS 9.0.3 CD-ROM.

   5. Run wsf.exe.

      Click Next to start the file copying process.

      When wsf.exe is complete, it restarts Windows automatically, if required; otherwise the Windows System Files installation will end without displaying any Installation Finished dialog.

   6. After Windows restarts or at the end of the Windows System Files installation, restart the Oracle9iAS 9.0.3 installation.

      See Also: Section 2.6.4, "Windows System Files Installation"

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

   Figure 3-2 Component Configuration Screen

   

   Text description of the illustration compconf.gif

   If you de-select a component here, the installer still installs it, but does not configure or start it. After installation, the installer starts the selected Oracle9iAS 9.0.3 components. If you decide to use the Oracle9iAS 9.0.3 component at a later time, launch the Oracle Enterprise Manager Web site and click Configure Component on the Instance Home Page.

   See Also: Section 1.1, "Oracle9iAS 9.0.3 Installation Overview"

5. One of the following screens will appear based on whether you will use Oracle9iAS Infrastructure 9.0.2, or if an Oracle9iAS Infrastructure 9.0.2 is on the install host:
   • Oracle9iAS Infrastructure Use: The Oracle9iAS Infrastructure Use screen appears to allow you to associate with an existing installation of Oracle9iAS Infrastructure 9.0.2.

   • Infrastructure Summary: The Infrastructure Summary screen appears if you have an installation of Oracle9iAS 9.0.3 that is already associated with an Oracle9iAS Infrastructure 9.0.2.

     Note: To associate an instance of Oracle9iAS 9.0.3 with an Infrastructure, make sure the required Infrastructure components are running. See Section 3.1, "Installation" for details.

   1. Oracle9iAS Infrastructure Use

      The Oracle9iAS Infrastructure Use screen appears to enable single sign-on or clustering functionality on the Oracle9iAS 9.0.3 installation host. Oracle9iAS Infrastructure 9.0.2 enables management of the application server cluster. Select whether to use an existing Oracle9iAS Infrastructure 9.0.2 and click Next.

      Figure 3-3 Oracle9iAS Infrastructure Use Screen

      

      Text description of the illustration infrause.gif

      Oracle9iAS Single Sign-On is installed as part of the Oracle9iAS Infrastructure 9.0.2 installation. The single sign-on host name refers to the existing Oracle9iAS Infrastructure 9.0.2.

      The Oracle9iAS Infrastructure Use screen allows you to select whether or not you will use Oracle9iAS Infrastructure 9.0.2 with this installation of Oracle9iAS 9.0.3. This screen offers two options:

      • No: Install Oracle9iAS 9.0.3 without Oracle9iAS Infrastructure 9.0.2 functionality.

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

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

      See Also: Chapter 1, "Installation Concepts" Oracle9i Application Server 9.0.2 Installation Guide

      Note: You cannot create a cluster that consists of J2EE and Web Cache 9.0.3 instances and J2EE and Web Cache 9.0.2 instances. The J2EE and Web Cache instances in an application server cluster can be on different hosts, however, all J2EE and Web Cache instances in a single cluster must reside on hosts that use the same operating system type (for example, Windows). This is because the configuration information that is shared between instances in a cluster contains operating system-specific information, such as file path names.

   2. Infrastructure Summary

      Review the Infrastructure Summary screen and click Next.

      Figure 3-4 Infrastructure Summary Screen

      

      Text description of the illustration infrasummary.gif

      If you have an installation of Oracle9iAS 9.0.3 on the install host that is already associated with an Oracle9iAS Infrastructure 9.0.2, the Infrastructure Summary screen appears.

      The Infrastructure Summary screen provides you with the following information about the associated Oracle9iAS Infrastructure 9.0.2:

      • The Oracle9iAS Single Sign-On domain and port number

      • The Oracle Internet Directory domain and port number

      • The Oracle9iAS Infrastructure 9.0.2 Database (Metadata Repository) name

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

   Figure 3-5 Oracle Internet Directory Screen

   

   Text description of the illustration oid.gif

   In order to associate an instance of Oracle9iAS 9.0.3 with an Infrastructure, the instance must be registered in the Oracle Internet Directory associated with the Infrastructure.

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

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

   • Username: The name used to log into Oracle Internet Directory.

   • Password: The password for the user.

   The username and password are defined in Oracle Internet Directory as one of the following:

   • orcladmin (root user)

   • a user who is member of the IASAdmins group in Oracle Internet Directory

   For additional Oracle9iAS 9.0.3 installations using Oracle Internet Directory, you must use a username that is 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 user and password. The administrator then adds this user to the IASAdmins group.

   You are prompted to enter username and password during subsequent Oracle9iAS 9.0.3 installs that use Oracle Internet Directory. The username and password you enter enables the registration of Oracle9iAS 9.0.3 configuration information into Oracle Internet Directory.

   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: Oracle9i Application Server Administrator's Guide Oracle9i Application Server 9.0.2 Installation Guide

7. One of the following screens appears based on whether an instance of Oracle9iAS 9.0.3 or Oracle9iAS 9.0.2 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 9.0.3 on this host.

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

   1. Create Instance Name and ias_admin Password

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

      Figure 3-6 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 (9.0.2 or 9.0.3) on this host.

      Instance Name: Enter an instance name for this installation of Oracle9iAS 9.0.3. The instance name must contain alphanumeric and underscore characters only.

      The instance name identifies this instance of Oracle9iAS 9.0.3 on this host. Instance names are unique for each host.

      ias_admin Password: Enter a password for the ias_admin user for this instance of Oracle9iAS 9.0.3, and then re-enter the password for confirmation. The ias_admin user's password must consist of at least five alphanumeric characters. Additionally, at least one of the characters must be a number.

      The ias_admin user's password enables you to:

      • Manage all instances of Oracle9iAS 9.0.3 on the install host

      • Run management tools

      • Install additional Oracle9iAS instances

      • Access the Oracle Enterprise Manager Home Page

      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.

   2. Create Instance Name

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

      Figure 3-7 Create Instance Name Screen

      

      Text description of the illustration createinstance2.gif

      If the Oracle Universal Installer has detected a previous installation of Oracle9iAS 9.0.3 or another Oracle9i Application Server product on this host but in a different Oracle home, this screen appears.

      Instance Name: Enter the instance name for this installation of Oracle9iAS 9.0.3. Because instance names identify instances of Oracle9iAS on a host, the instance name must be unique on each host.

      Instance names can only contain alphanumeric and underscore characters.

      ias_admin Password: Enter the existing password for the ias_admin user for this host.

      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.

8. This screen appears if the Oracle Universal Installer detects multiple installations of Oracle9iAS Metadata Repository with which you can associate your Oracle9iAS 9.0.3 instance. Oracle9iAS Metadata Repository installs as part of Oracle9iAS Infrastructure 9.0.2.

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

   Figure 3-8 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 9.0.3.

   Chapter 10, "Reconfiguring the Application Server", in the Oracle9i Application Server Administrator's Guide describes how to create a configuration with multiple metadata repositories.

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

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

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

   See Also: Chapter 1, "Installation Concepts" Section 3.2.3, "About the Oracle Enterprise Manager Web Site" Oracle9i Application Server 9.0.2 Installation Guide

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

10. Monitor the installation process.

    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, "Oracle Universal Installer Inventory Directory"

11. Review the status of Oracle9iAS 9.0.3 configuration tools.

    The Component Configuration screen appears and displays Oracle9iAS 9.0.3 components that will be configured and started. 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 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.

    • Creates log files to show the status of Oracle9iAS Configuration Tools. You can determine why a specific Oracle9iAS Configuration Tool failed by reviewing these files. Refer to Appendix C, "Troubleshooting" for a list of configuration tool log files.

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

    • Stop: Quits the configuration of a selected component.

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

12. Review the End of Installation screen. Click Exit to quit the installer.

    If you want to install additional instances of Oracle9iAS 9.0.3 on the same machine, exit the installer first, then restart it. This method is recommended over clicking the Next Install button.

    Figure 3-9 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 9.0.3 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.

    • Release Information: Access the Oracle9iAS Welcome page by clicking the Release Information button.

      See Also: Section 3.2.3, "About the Oracle Enterprise Manager Web Site" Oracle9i Application Server Administrator's Guide

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

    C:\Program Files\Oracle\Inventory\logs\installActiondate_time.log
    
    

    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 Oracle9iAS 9.0.3. Proceed to Section 3.2, "Postinstallation" to complete the installation process.

3.2 Postinstallation

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

The postinstallation section contains the following topics:

• Installing the Oracle9i Application Server 9.0.2.1 Patch

• Set Permission Tool

• About the Oracle Enterprise Manager Web Site

• Automatic Switching of the Active Oracle Enterprise Manager

• Associating an Instance with an Infrastructure (Joining a Farm)

• Component Dependent Configuration

• Configuring Additional Components

• Postinstallation Configuration Tasks

• Starting and Stopping Components

• Component Port Numbers

• Oracle9iAS 9.0.3 Demonstration Applications

• Oracle9iAS TopLink

• Oracle9iAS Portal Developer Kit for J2EE and Web Services

• Additional Oracle9iAS 9.0.3 Installations

• Additional Documentation

3.2.1 Installing the Oracle9i Application Server 9.0.2.1 Patch

If you will be using Oracle9iAS 9.0.3 on the same host or farm as Oracle9iAS 9.0.2, then you must apply the Oracle9i Application Server 9.0.2.1 patch to all Oracle9iAS 9.0.2 instances, either before or after your installation of Oracle9iAS 9.0.3. You can download the patch 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.2.2 Set Permission Tool

In earlier releases of Oracle9iAS, you could run the set-permission tool (ORACLE_HOME\bin\setPmsn) to allow only users in the Administrators group to access the Oracle9iAS files.

In this release of Oracle9iAS, you do not have to run the set-permission tool because, by default, only users in the Administrators group have access to the files.

3.2.3 About the Oracle Enterprise Manager Web Site

The Oracle Enterprise Manager Web site is available after Oracle9iAS 9.0.3 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 9.0.3 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.2.4 Automatic Switching of the Active Oracle Enterprise Manager

When you install a 9.0.3 instance on a machine that already has 9.0.2 instances, the installer automatically switches the active Oracle Enterprise Manager to the 9.0.3 instance.

This means that you need to start up Oracle Enterprise Manager from the 9.0.3 Oracle home.

If you start up Oracle Enterprise Manager using the Services panel, you would see the name of the 9.0.3 ORACLE_HOME in the service name (OracleORACLE_HOMEEMWebsite). Verify the start-up type (manual or automatic) and status (running or not) of the service. Also verify that the old service (from 9.0.2) is no longer running.

To determine the instance that contains the active Oracle Enterprise Manager, see the first step in Section 3.2.8, "Multi-User Installations".

3.2.5 Associating an Instance with an Infrastructure (Joining a Farm)

If you have an Oracle9iAS 9.0.3 instance that is not associated with an infrastructure and you would like to use Oracle9iAS Single Sign-On or clustering, you can associate the instance with an existing infrastructure using the Oracle Enterprise Manager Web site. Refer to the Oracle9i Application Server Administrator's Guide for more information.

3.2.6 Component Dependent Configuration

Interdependencies between Oracle9iAS 9.0.3 components and component configuration dependencies can be found in the Oracle9i Application Server Administrator's Guide.

3.2.7 Configuring Additional Components

You can configure additional Oracle9iAS 9.0.3 components following installation. Configuration of additional Oracle9iAS 9.0.3 components is described in the Oracle9i Application Server Administrator's Guide.

3.2.8 Multi-User Installations

You can perform multiple Oracle9iAS 9.0.3 installs on the same host but as different users. However, the users must be members of the Administrators group. If you have installed one or more installations of Oracle9iAS 9.0.3, you must complete the following steps before enabling multi-user installations.

Note: There is a limitation to having different users install Oracle9iAS 9.0.3 on the same host: if you have multiple instances of Oracle9iAS 9.0.3 on the same host and they were installed by different users, you can use Oracle Enterprise Manager to manage only the instance that was installed by the first user. You cannot use Oracle Enterprise Manager to manage instances installed by other users.

1. Determine the location of the active Enterprise Manager.
   1. Click Start > Run, type in regedit.exe, and click OK.

      The Registry Editor is displayed.

   2. Navigate to the following key in the Registry: HKEY_LOCAL_MACHINE > SOFTWARE > ORACLE > em_loc. em_loc appears on the right side of the window.

   You need to know the location of the active Enterprise Manager if you are going to stop it from the command-line. You do not need to know it if you are going to stop it using the Services panel (this is the recommended method).

2. Stop the Oracle Enterprise Manager Web site using the Services panel:

   (Windows NT) Go to Start > Settings > Control Panel > Services. Highlight the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop button.

   (Windows 2000) Go to Start > Programs > Administrative Tools > Services. Highlight the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop icon.

3. Start the Oracle9iAS 9.0.3 installation(s).

4. After successful additional user(s) installations, restart the Oracle Enterprise Manager Web site using the Services panel:

   (Windows NT) Go to Start > Settings > Control Panel > Services. Highlight the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Start button.

   (Windows 2000) Go to Start > Programs > Administrative Tools > Services. Highlight the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Start icon.

3.2.9 Postinstallation Configuration Tasks

This section includes postinstallation configuration tasks for the following:

• Oracle9iAS Java Authentication and Authorization Service

• Enabling Oracle9iAS Web Cache and mod_osso

3.2.9.1 Oracle9iAS Java Authentication and Authorization Service

You must configure Oracle9iAS Java Authentication and Authorization Service (JAAS) components before using applications that use JAAS. JAAS configuration tasks are described in the Oracle9i Application Server Security Guide.

3.2.9.2 Enabling Oracle9iAS Web Cache and mod_osso

This section applies only if your Oracle9iAS 9.0.3 instance is associated with an Infrastructure.

When the Oracle Universal Installer initially registers mod_osso with Oracle9iAS Single Sign-On, it passes the registration URLs containing the port number of Oracle HTTP Server, instead of the port number of Oracle9iAS Web Cache. Because Oracle Universal Installer passes the incorrect port number, it bypasses Oracle9iAS Web Cache.

In order for mod_osso to work correctly, you must manually re-register mod_osso using URLs that have the Oracle9iAS Web Cache port.

For more information refer to the Oracle9i Application Server Administrator's Guide.

3.2.10 Starting and Stopping Components

Oracle9iAS 9.0.3 components can be started and stopped using the Oracle Enterprise Manager Web site. For information on manually starting and stopping of Oracle9iAS 9.0.3 components, refer to Oracle9i Application Server Administrator's Guide.

3.2.11 Component Port Numbers

Following installation, the Oracle Universal Installer creates a file showing the port assignments during installation of Oracle9iAS 9.0.3 components. The installation process automatically detects any port conflicts and chooses an alternative port in the range allocated for that component. The portlist.ini file is located at:

ORACLE_HOME\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 9.0.3. If you are installing additional Oracle9iAS instances, make sure the existing instances (with the exception of Enterprise Manager) are running at the time of additional installation.

See Also: Section 3.2.3, "About the Oracle Enterprise Manager Web Site" Appendix B, "Default Port Numbers and Port Ranges" Section 2.5, "Preinstallation Tasks" Oracle9i Application Server Administrator's Guide.

3.2.12 Oracle9iAS 9.0.3 Demonstration Applications

Oracle9iAS 9.0.3 provides demonstration applications for Oracle9iAS 9.0.3 components.

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

For more information and to run the demonstration applications, go to the Welcome Page and click Demonstrations.

See Also: Oracle9i Application Server Administrator's Guide

3.2.13 Oracle9iAS TopLink

Oracle9iAS TopLink enables you to map a Java object model to a relational database and non-relational data sources. This bridges the gap between objects and the relations that exist among them and relational databases. Objects are a very flexible way of storing data and relationships between data, so representing objects in a relational database can be complicated. Oracle9iAS TopLink is supported by Oracle9iAS 9.0.3 and Oracle9iAS 9.0.2. Oracle9iAS TopLink is available in the Oracle9iAS CD pack. Refer to the Oracle9iAS TopLink CD for more information.

3.2.14 Oracle9iAS Portal Developer Kit for J2EE and Web Services

The Oracle9iAS Portal Developer Kit for J2EE and Web Services (9.0.2.0.2) can be used to develop portlets based upon J2EE 1.3 applications running in Oracle9iAS 9.0.3. You can also develop portlets from available Web Services. These portlets can be registered with an Oracle9iAS Portal 9.0.2 environment. The Oracle9iAS Portal Developer Kit for J2EE and Web Services is available for download from

http://portalstudio.oracle.com.

3.2.15 Additional Oracle9iAS 9.0.3 Installations

For information on installing additional Oracle9iAS 9.0.3 installations, refer to Section 2.7.3, "Additional Oracle9iAS 9.0.3 Installations".

3.2.16 Additional Documentation

For further information on postinstallation and configuration tasks, refer to the Oracle9i Application Server Administrator's Guide and component-specific documentation.