Oracle9i Application Server Installation Guide Release 1.0.2.1 for Windows NT/2000 Part Number A88726-01 |
| Library | Contents | Index

# 5
Enterprise Edition

This chapter guides you through the installation steps for the Enterprise Edition of Oracle9i Application Server. The following topics provide detailed installation steps, and basic postinstallation tasks:

- Installation

- Postinstallation

## Installation

The installation process is divided into two parts:

- Preparing System for Installation

- Installing Oracle9i Application Server

### Preparing System for Installation

The following instructions prepare your machine for the installation of Oracle9i Application Server.

1. Review the Installation Overview screen and make the appropriate choice for the installer to display additional help, and click Next.

   #### Figure 5-1 Installation Overview Screen

   Text description of the illustration over.gif

   The Installation Overview screen enables you to launch and view additional installation help and information during installation. Both choices enable you to click Help to view information for each screen.

   - Yes: This will launch a Web browser that displays additional installation information such as installation summary and frequently asked questions.

   - No: This option will disable the additional help option.

2. Review the Welcome screen and click Next.

   #### Figure 5-2 Welcome Screen

   Text description of the illustration n_wel.gif

   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 to deinstall the entire product or components.

   - Previous: Return to the previous screen.

   - Next: Move to the next screen.

3. Select Enterprise Edition and click Next.

   #### Figure 5-3 Installation Types Screen

   Text description of the illustration n_ent.gif

   The Installation Types screen allows you to select the Oracle9i Application Server installation option that you are licensed to use.

   See Also: Table 2-1, "Oracle9i Application Server Components" for a complete list of components.

   - Enterprise Edition: Installs Oracle9iAS Database Cache, Oracle9iAS Discoverer, Oracle9iAS Forms Services, Oracle9iAS Portal, Oracle9iAS Reports Services, Oracle9iAS Web Cache, Oracle9iAS Wireless, Oracle Enterprise Java Engine, Oracle Enterprise Manager Client, Oracle HTTP Server, Oracle Internet File System, and Oracle Management Server.

   - Standard Edition: Installs Oracle9iAS Portal, Oracle9iAS Wireless, Oracle Enterprise Java Engine, Oracle Enterprise Manager Client, Oracle HTTP Server, and Oracle Internet File System.

   - Minimal Edition: Installs Oracle9iAS Portal, Oracle9iAS Wireless, Oracle Enterprise Manager Client, and Oracle HTTP Server.

4. Verify the Oracle home name and location for the 8.1.7 RSF based products, and click Next.

   #### Figure 5-4 Destination Oracle Home and Oracle Home Name Screen

   Text description of the illustration n_oh.gif

   The Destination Oracle Home and Oracle Home Name screen allows you to enter the name and location of your Oracle home for the 8.1.7 RSF based products. You can accept or change the defaults.

   - Oracle Home Name: This is the name of the Oracle home, which is the root directory in which Oracle9i Application Server is installed.

   - Oracle Home Location: This is the full path of the Oracle home directory. There should be no spaces in the Oracle home path.

     Note: Do not to install Oracle9i Application Server in an Oracle home containing other Oracle products, including the database. Such an installation could overwrite shared components, causing the products to malfunction.

   - Browse: To navigate through the file system to find source and destination locations.

5. Create a new Oracle home or select an existing one for the 8.0.6 RSF based products, and click Next.

   #### Figure 5-5 Destination Oracle home and Oracle Home Name

   Text description of the illustration n_filloc.gif

   The Destination Oracle Home and Oracle Home Name screen allows you to either enter the name and location for the 8.0.6 RSF based products, or select an existing Oracle home if you are upgrading from a previous version of Oracle9i Application Server. You can accept or change the defaults.

   - Create New Oracle Home

     - Oracle Home Name: This is the name of the Oracle home, which is the root directory in which Oracle9i Application Server is installed.

     - Oracle Home Location: This is the full path of the Oracle home directory.

     Note: Do not to install Oracle9i Application Server in an Oracle home containing other Oracle products, including the database. Such an installation could cause the products to malfunction.

   - Browse: To navigate through the file system to find source and destination locations.

   - Selecting Existing Oracle Home: This options displays all existing Oracle homes from pervious Oracle9i Application Server installations. If you are upgrading from a pervious version, then you may select an existing Oracle home to install the 8.0.6 RSF based products.

6. Review the following screen and click Previous to fix errors. This screen appears only if you have entered an invalid Oracle home for the 8.0.6 RSF based products.

   #### Figure 5-6 Invalid Oracle Home Entry Warning Screen

   Text description of the illustration n_filerr.gif

   The Invalid Oracle Home Entry Warning screen alerts you of an invalid Oracle home entry made for the 8.0.6 RSF based products. It requires you to click the Previous button to go back to the Destination Oracle Home Name and Oracle Home Location screen and enter a valid name. After making the appropriate corrections, click Next.

7. You do not have sufficient space to install Oracle9i Application Server. Free enough disk space to meet the hardware requirements and click Next, or click Previous to select another drive. This screen will appear only if you do not have sufficient disk space.

   #### Figure 5-7 Insufficient Disk Space Screen

   Text description of the illustration n_disksp.gif

   Insufficient Disk Space screen appears only if you do not have enough disk space on your selected drive to install Oracle9i Application Server. You can:

   - Click Next once you have freed sufficient disk space.

   - Click Previous to select another drive to install product.

     See Also: Chapter 1, "Requirements"

8. Select the components for configuration and startup after installation and click Next.

   #### Figure 5-8 Component Configuration and Startup Screen

   Text description of the illustration n_startu.gif

   The Component Configuration and Startup screen allows you to select the components that you want the installer to configure and start after installation. This screen offers two configuration options:

   - If you select a component here, then the installer prompts you for any or all configuration information required by that component. After installation, the installer starts that component.

   - If you de-select a component here, then the installer installs it, but does not configure or start it. After installation, if you decide to use that component, then manually launch the configuration assistant to configure that component.

     See Also: Appendix A, "Configuration Tools"

   You can select or de-select multiple components by holding down the Control key while clicking on the component name.

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

   #### Figure 5-9 Install Screen

   Text description of the illustration n_inst1.gif

   The Install screen appears while Oracle Universal Installer incorporates all the user input for Oracle9i Application Server. It also displays the full path of the installation log.

   - Cancel: To discontinue the installation process.

10. Review the system reboot information and click Next. This screen will not appear under the following conditions:

    - The machine has previously installed Oracle9i Application Server. In this case you do not have to reinstall the system DLLs and the reboot is not necessary.

    - You are installing on Windows 2000. In this case, the machine will not reboot.

      Note: Be sure to close all other open applications and processes as your machine will automatically reboot after the configuration files are copied.

    #### Figure 5-10 System Reboot Screen

    Text description of the illustration n_reboot.gif

    The System Reboot screen informs you that after the installer copies the necessary files required to install Oracle9i Application Server, your machine will reboot to allow the configuration changes to take effect. When the machine starts up again, Oracle Universal Installer appears and begins the installation process of the Oracle9i Application Server.

11. Monitor the installation process and after the installer finishes, your machine reboots. This screen will not appear if you are installing on Windows 2000.

    #### Figure 5-11 Install Screen

    Text description of the illustration n_inst2.gif

    The Install screen appears while Oracle Universal Installer installs required configuration files for Oracle9i Application Server. It also displays the full path of the installation log.

    - Cancel: To discontinue the installation process.

    Your machine will reboot once the configuration files are copied. Do not attempt to restart the installer after reboot. It will launch automatically.

### Installing Oracle9i Application Server

Once your machine starts up after rebooting, the Oracle Universal Installer appears and proceeds to install Oracle9i Application Server The reboot process will not occur if you are installing on Windows 2000.

Note: Be sure to log in with administrator privileges after your machine starts up again.

The following screen appears as Oracle Universal Installer relaunches.The installer may take up to several minutes to start, and might pause if some screensavers are activated.

Text description of the illustration n_oui.gif

1. If needed, verify and change the locations of the components displayed on the screen, and click Next.

   This screen appears only if Oracle Universal Installer has detected insufficient disk space in the Oracle home directory.

   #### Figure 5-12 Component Locations Screen

   Text description of the illustration comploc.gif

   The Component Locations screen allows you to select alternative locations for some components.

   - Show all components to be installed: To view the complete list of components chosen for installation. Select check box to display component list.

   Click individual components to view and change destination location path. The installer enables you to change the destination location of the components displayed on the screen.

   - Destination Location: To view the full path of the selected component.

   - Change Location: To browse for alternate locations for the selected component.

   - Available Disk Space: To view available disk space in the current directory. The installer also provides information about the total disk space required for the installation of additional components.

   - Required Disk Space for directory_name: To view the total disk space required for installation in the selected directory.

   - Total Required Disk Space: To view the total disk space required for the product to be installed.

   - Show all available volumes: To browse through file system for available disk space. Select check box to display the file system.

     Note: Insufficient disk space is indicated in red with a hand icon next to it.

2. Enter the host name, port number, and service name of the origin database and click Next. This screen will appear only if you selected Oracle9iAS Database Cache in the Component Configuration and Startup screen.

   #### Figure 5-13 Origin Database Connection Information

   Text description of the illustration n_dbconn.gif

   The Origin Database Connection Information screen enables you to identify the origin database for the middle-tier cache.

   - Host Name: The name of the machine where the origin database is located.

   - Port Number: The port number of the listener for the origin database. The default port number is 1521.

   - Service Name: The database service name is the global database name. The global database name uniquely distinguishes the database from other databases in your network domain. The installation procedure uses this name to create an entry in the `tnsnames.ora` file on the local cache node.

     For example, if `oasdocs` is the database name and `us.oracle.com` is the network domain in which the database is located, then the service name is `oasdocs.us.oracle.com`.

3. Enter or accept the default Portal DAD and Schema names. Also, enter the TNS Connect String, if necessary. Click Next. This screen will appear only if you selected Oracle9iAS Portal in the Component Configuration and Startup screen.

   #### Figure 5-14 Apache Listener Configuration for Oracle Portal (DAD and Schema name) Screen

   Text description of the illustration n_adad.gif

   The Apache Listener Configuration for Oracle Portal DAD screen allows you to enter the name of the Database Access Descriptor (DAD) that will be used to access Oracle Portal, and the name of the database schema where Oracle Portal will be installed. It also enables you to enter the TNS connect string if Oracle Portal and Oracle HTTP Server are installed in different Oracle homes. The information you enter here is used to create the PL/SQL Gateway settings which you can access upon installation from the following location: `http://`machine_name`:`port`/pls/admin_/gateway.htm`

   - Portal DAD Name: Enter the name of the DAD for each instance you installed in the database. A Database Access Descriptor (DAD) is a set of values that specify how the Apache Listener connects to your Oracle database server to fulfill an HTTP request. Based on this DAD name, the installation automatically sets other DAD-related and default settings such as the name and location of the document table. The default DAD name is `portal30`.

   - Portal Schema Name: Enter the name of the database schema that will contain Oracle Portal. A schema is a collection of components and database objects under the control of a given database user. Each Oracle Portal application maps to an Oracle database schema. The default schema name is `portal30`.

   - TNS Connect String: Enter the TNS connect string or TNS alias that you will use to connect to the remote Oracle database after installation. It enables you to install the Portal database objects into a remote database. Since you are installing in a new Oracle home, you will need to enter a TNS connect string before it is actually created. The Net8 Assistant will appear later in the installation process to guide you in the configuration of a new TNS alias. Be sure to note the name of the TNS connect string you enter here, so that you will use the same name when the Net8 Assistant appears later.

4. Enter or accept the default Login Server DAD and Schema names. Also, enter the TNS Connect String, if necessary. Click Next. This screen will appear only if you selected Oracle9iAS Portal in the Component Configuration and Startup screen.

   #### Figure 5-15 Apache Listener Configuration for Oracle Portal (Login Server) Screen

   Text description of the illustration n_alog.gif

   The Apache Listener Configuration for Oracle Portal screen allows you to enter the Login Server DAD and Schema Name, with a `_sso` extension for easy recognition. The Login Server provides an enterprise-wide Single Sign-On (SSO) mechanism that enables an Oracle Portal user to log in securely to Oracle Portal and any partner and external applications using a single user name and password. It also enables you to enter the TNS Connect String if Oracle Portal and Oracle HTTP Server are installed in different Oracle homes.

   - Login Server DAD Name: Enter the name of the DAD for each instance you installed in the database.The default DAD name is `portal30_sso`.

   - Login Server Schema Name: Enter the name of the database schema that will contain Oracle Portal.The default schema name is `portal30_sso`.

   - TNS Connect String: Enter the TNS connect string or TNS alias that you have defined for the remote Oracle database.

     For more information on these fields, refer to the previous screen.

5. Enter the `SYSDBA` name and password and click Next. This screen will appear only if you have selected Oracle9iAS Database Cache in the Component Configuration and Startup screen.

   #### Figure 5-16 Origin Database User Information Screen

   Text description of the illustration n_dbinf.gif

   The Origin Database User Information screen allows you to enter the `SYSDBA` information created for the origin database.

   - User Name: The `SYSDBA` user name for the origin database that the installer detects and defaults. You can change the name or accept the default.

   - Password: The password for the `SYSDBA` user.

6. Enter the hostname, port number, and SID of the database where you will install the Oracle9iAS Wireless repository, and click Next. If you are upgrading from Oracle9i Application Server, Release 1.0.2.0, then an "Upgrade Installation Detected" screen will appear. Review the screen and click Next or Exit accordingly. If you click Next, then the following screen will appear.

   #### Figure 5-17 Wireless Edition Repository Information Screen

   Text description of the illustration n_repinf.gif

   The Wireless Edition Repository Information screen allows you to enter the hostname, Net8 Listener port number, and SID of the database where you will install the Oracle9iAS Wireless repository.

   Note: Do not install Oracle9iAS Wireless on Oracle9iAS Database Cache.

   - Hostname: Enter the `hostname.domain` of the database where you will install the Oracle9iAS Wireless.

   - Port: Enter the Net8 Listener port number.

   - SID: Enter the System Identifier (SID) of the database where you will install the Oracle9iAS Wireless repository.

7. Enter the new username and password for the database user to store the Oracle9iAS Wireless repository, and click Next. If you are upgrading from Oracle9i Application Server, Release 1.0.2, then the "Oracle9iAS Wireless Schema Information Screen" will be slightly different. Enter the existing Oracle9iAS Wireless username and password, and click Next.

   #### Figure 5-18 Wireless Edition Schema Information Screen

   Text description of the illustration n_schema.gif

   The Wireless Edition Schema Information screen allows you to create a database user to store the Oracle9iAS Wireless repository.

   - Username: Enter a new user name for the database user to store the Oracle9iAS Wireless repository.

   - Password: Enter a password for the database user.

     Note: Do not use an existing database user, (that is, `SYS` or `SYSTEM)` as the username.

8. Enter and confirm the `SYSTEM` password of the database, and click Next. If you are upgrading from Oracle9i Application Server, Release 1.0.2, then a "Wireless Edition Administrator Password Information" screen appears. Enter and confirm the "Administrator" password, and click Next.

   Note: Do not enter the database schema owner password.

   #### Figure 5-19 System Password Screen

   Text description of the illustration n_system.gif

   The System Password screen allows you to enter and confirm the `SYSTEM` password of the database where you are loading the Oracle9iAS Wireless repository.

   - Enter Password: Enter the `SYSTEM` password of the database where you will install the Oracle9iAS Wireless.

   - Confirm Password: Re-enter the `SYSTEM` password as entered above for verification.

9. Review the summary and click Install to begin the installation process.

   #### Figure 5-20 Summary Screen

   Text description of the illustration n_esumm.gif

   The Summary screen allows you to review all the settings before the actual installation process. These settings include source, destination, installation type, product language, space requirements, 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 and after the installer finishes, click Next.

    #### Figure 5-21 Install Screen

    Text description of the illustration n_inst3.gif

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

    - Cancel: To discontinue the installation process. You can then choose to stop the installation of an individual component or the entire product.

Changing Disks: During the installation process, the Disk Location dialog appears and prompts you to change disks. Insert the requested disk into your disk drive, or specify an alternative location, and click `OK`.

Text description of the illustration n_1_2.gif

The following screen indicates that Oracle Installer is installing Oracle9iAS Forms Services, Oracle9iAS Reports Services, and Oracle9iAS Discoverer. No user input is required.

#### Figure 5-22 Oracle Installer

Text description of the illustration n_orca19.gif

1. Verify the list of configuration tools and click Next. This screen appears only if you select components to configure and start in the Components Configuration and Startup screen.

   Note: The installer has completed copying and linking the necessary files. Be sure to start the database if it had been shut down for the installation process. The configuration tools such as Oracle9iAS Portal Configuration Assistant need to connect to an active database for configuration purposes.

   #### Figure 5-23 Configuration Tools Screen

   Text description of the illustration n_econf.gif

   The Configuration Tools screen lists the configuration tools for all installed components.

   Scroll down the 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.

   - Displays all the configuration settings in the display window below as it executes a configuration tool for each component.

   - Enables you to view configuration settings after all configuration tools are executed. Click on each component to review all the changes made.

   - 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: To re-execute the configuration script if the configuration of a component fails.

   - Stop: To quit the configuration process.

   Configuration Tools

   Depending on the components you select in the Configuration and Startup screen, the following configuration tools launch:

   Oracle9iAS Database Cache Configuration Assistant - This configuration assistant enables you to configure your middle-tier caches. Oracle9iAS Database Cache Configuration Assistant will not appear if you are migrating from Oracle9i Application Server 1.0.2.0 to 1.0.2.1.

   See Also: "Oracle9iAS Database Cache Configuration Assistant" for instructions on running Oracle9iAS Database Cache Configuration Assistant.

   Oracle9iAS Web Cache Configuration Assistant - This launches the service to start Oracle9iAS Web Cache. Oracle9iAS Web Cache service starts up automatically by default. If you choose not to use Oracle9iAS Web Cache, you will need to stop the service manually.

   See Also: "Starting and Stopping Components"

   Starting Oracle HTTP service- This starts the Oracle HTTP Server.

   Oracle HTTP Server starts up in a DOS window. In that window, you can test the Oracle HTTP Server installation.

   To administer the Oracle HTTP service from the `Control Panel`, reboot your machine after Oracle9i Application Server installation completes. Then, Oracle HTTP service will start automatically and you will no longer need to start it in a DOS window.

   Oracle9iAS Portal Configuration Assistant - This configuration assistant loads necessary database objects for Oracle9iAS Portal to run.

   See Also: "Oracle9iAS Portal Configuration Assistant" for instructions on running Oracle9iAS Portal Configuration Assistant.

2. Ensure that the installation was successful. Click Exit to quit the installer.

   #### Figure 5-24 End of Installation Screen

   Text description of the illustration end.gif

   The End of Installation screen appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful.

   - Release Information: To view the latest release information.

   You have successfully installed the Enterprise Edition installation option of Oracle9i Application Server. Proceed to "Postinstallation" to complete the installation process.

   ## Postinstallation

   The following instructions guide you through the basic postinstallation tasks for Oracle9i Application Server. Before performing these tasks, install, if needed, Oracle9iAS Wireless client from the Oracle9i Application Server Administrative and Development Client CD included in the Oracle9i Application Server CD pack.

   See Also: Appendix B, "Installing Oracle9i Application Server Administrative and Development Client CD-ROM"

   The postinstallation contains the following sections:

   - Component-specific Tasks

   - Starting and Stopping Components

   - Component Web Sites

   - Component Port Numbers

   - Additional Documentation

   ### Component-specific Tasks

   This section contains postinstallation tasks for the following topics:

   - Oracle Internet File System

   - Oracle Management Server

   - Oracle9iAS Database Cache

   - SSL Authentication Method Configuration

   - Multi-threaded Server Configuration

   #### Oracle Internet File System

   You must run the Oracle Internet File System Configuration Assistant to configure Oracle Internet File System.

   See Also: "Oracle Internet File System Configuration Assistant" for instructions on running Oracle Internet File System Configuration Assistant.

   #### Oracle Management Server

   You must run the Oracle Enterprise Manager Configuration Assistant to configure Oracle Management Server.

   See Also: "Oracle Management Server Configuration Assistant" for instructions on running Oracle Enterprise Manager Configuration Assistant.

   #### Oracle9iAS Database Cache

   Be sure to perform the following postinstallation steps for Oracle9iAS Database Cache:

   - Setting Up the Oracle9iAS Database Cache Environment for Your Applications

   - Modify the initicache.ora File

   - Set NTFS File System and Windows NT Registry Permissions

   ##### Setting Up the Oracle9iAS Database Cache Environment for Your Applications

   When you install Oracle9iAS Database Cache, the installation procedure installs files that are specific to Oracle9iAS Database Cache and files that are updates to Oracle8i Server or Client release 8.1.6.1. These files contain the Oracle9iAS Database Cache functionality, as well as bug fixes to files usually installed with the Oracle8i Server or Client.

   To use Oracle9iAS Database Cache, you must make sure that your applications are using the files and libraries installed for Oracle9iAS Database Cache. You can do this in the following ways:

   - Run your application from the Oracle Home in which you installed Oracle9iAS Database Cache. This is the supported method.

     See Also: "Using the Oracle9iAS Database Cache Home" for a description of the steps you must take.

   - If you have multiple Oracle homes and you need to run your application from the Oracle home for Oracle8i Server or Client release 8.1.6 or 8.1.6.1, you must copy files from the Oracle9iAS Database Cache Oracle home to the Oracle8i Server or Client Oracle home.

     See Also: "Using a Previous Oracle8i Release 8.1.6 Oracle Home" for a description of the steps you must take.

   - If your application was compiled and linked using a release prior to Oracle8i Server or Client release 8.1.6, you must relink your application using the `OCI` libraries that are installed by Oracle9iAS Database Cache.

     See Also: "Relinking Applications That Use Releases Previous to Release 8.1.6" for more information.

   ##### Using the Oracle9iAS Database Cache Home

   To run your application from the Oracle home in which you installed Oracle9iAS Database Cache, you must take the following steps:

   1. From the process in which you will run your application, set the following environment variables:

      - Set `ORA_OCI_CACHE` to "1" so that all applications started from the process will use the cache. (Alternatively, you can use parameters within `OCI` applications to control which applications or statements use the cache.

        See Also: Oracle9iAS Database Cache Concepts and Administration Guide in the Oracle9i Application Server Documentation Library.

      - If you use the environment variable `TNS_ADMIN`, make sure that it is set to the ORACLE_HOME`\network\Admin` directory in the Oracle home for Oracle9iAS Database Cache.

      - Set the value of the environment variable `PATH` so that the Oracle9iAS Database Cache library directory (ORACLE_HOME`\lib`) precedes other Oracle library directories.

      - If you use the `CLASSPATH` environment variable, set it to the Oracle home in which you installed Oracle9iAS Database Cache.

   2. If you use the environment variable or registry parameter `TNS_ADMIN`, make sure that it is set to the ORACLE_HOME`\network\Admin` directory in the Oracle home for Oracle9iAS Database Cache. The registry parameter is located in the following location:

      `HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\HOME` id

   3. From the Start menu, select `Oracle for Windows NT` -> `Oracle Home Selector`. Then, select the Oracle home in which you installed Oracle9iAS Database Cache.

   4. If your application was running previously on the node on which you installed Oracle9iAS Database Cache and the application connected to the origin database by using an entry in an existing `tnsnames.ora` file, you must copy that entry to the `tnsnames.ora` file used by Oracle9iAS Database Cache.

      The `tnsnames.ora` file is located in the ORACLE_HOME`\network\Admin` directory. Copy the entry from the file in the previously existing Oracle home to the `tnsnames.ora` file in the Oracle home in which you installed Oracle9iAS Database Cache.

      Note that the Oracle9iAS Database Cache installation creates an entry for the origin database in the `tnsnames.ora` file on the local cache node. It assigns the alias `ora_icache_origin`. Do not modify or delete the `ora_icache_origin` entry. To assign a different alias for another purpose, edit the `tnsnames.ora` file and add another entry. The Oracle9iAS Database Cache installation also creates an entry, ora_icache, for the cache. Do not modify or delete this entry.

   ##### Using a Previous Oracle8 i Release 8.1.6 Oracle Home

   If you previously ran your application from the Oracle home for Oracle8i Server or Client release 8.1.6 or 8.1.6.1 and you continue to need to run your application from that Oracle home, you must take the following steps:

   Note: Use this method only if you cannot use the Oracle home for Oracle9iAS Database Cache. Do not use this method if your application ran from a release later than 8.1.6.1.

   See Also: "Using the Oracle9iAS Database Cache Home" for the recommended method.

   1. Copy the following library files from the Oracle home in which you installed Oracle9iAS Database Cache to the Oracle home for the Oracle8i server or client that your application uses:

      ORACLE_HOME`\bin\oraclient8.dll
      `ORACLE_HOME`\bin\orageneric8.dll` (not required for 8.1.6.1)
      ORACLE_HOME`\bin\orawtc8.dll
      `ORACLE_HOME`\bin\orawtc8.lib`

   2. From the Start menu, select `Oracle for Windows NT` ->`Oracle Home Selector`. Then, select the Oracle home for the Oracle8i server or client that your application uses.

   3. Copy the SQL*Plus executable file from the Oracle home in which you installed Oracle9iAS Database Cache to the Oracle home for the Oracle8i server or client that your application uses.

   4. Set the value of the environment variable `ORA_OCI_CACHE` to "1" so that all applications started from the process will use the cache. (Alternatively, you can use parameters within `OCI` applications to control which applications or statements use the cache.)

   5. If you use the environment variable or registry parameter `TNS_ADMIN`, make sure it points to the Oracle home that your application uses.

   6. Copy the entries in the `tnsnames.ora` file from the Oracle home in which you installed Oracle9iAS Database Cache to the `tnsnames.ora` file in the Oracle home for the Oracle8i server or client that your application uses.

   ##### Relinking Applications That Use Releases Previous to Release 8.1.6

   If your application was compiled and linked using a release prior to Oracle8i Server or Client release 8.1.6, you must relink your application using the `OCI` libraries that are installed by Oracle9iAS Database Cache.

   Then, you must take the steps described in "Using the Oracle9iAS Database Cache Home" .

   ##### Modify the initicache.ora File

   The Oracle9iAS Database Cache installation creates a cache using the same database character set as the origin database. However, it does not set other National Language Support (NLS) features, such as date format or currency symbols.

   If the initialization file (`init` `SID``.ora`) of your origin database specifies NLS parameters, you must copy those parameters to the initialization file (`initicache.ora`) of the cache. (NLS parameters begin with "NLS_".)

   For example, if the initialization file of your origin database contains the following parameters, copy them to `initicache.ora`:

   `NLS_LANGUAGE = JAPANESE
   NLS_CALENDAR = "Japanese Imperial"
   NLS_DATE_FORMAT = "E YY-MM-DD"`

   `initicache.ora` is located in the `ORACLE_HOME``\Admin\icache\pfile` directory.

   ##### Set NTFS File System and Windows NT Registry Permissions

   Oracle Corporation recommends that you configure Oracle9iAS Database Cache files, directories, and registry settings to allow only authorized database administrators to have full control. The following sections describe how to perform these tasks.

   See your Windows NT documentation for more information about modifying NTFS file system and Windows NT registry settings.

   ##### NTFS File System Security

   Oracle9iAS Database Cache uses files to store data and configuration information. To do this, the Oracle9iAS Database Cache process runs under a security account. This security account (the account under which you installed Oracle9iAS Database Cache) includes the ability to create and access these files. The security account is assigned to the service that Oracle9iAS Database Cache uses (in the Control Panel). This account requires full file system permissions to create, read, write, delete, and execute files.

   To ensure that only authorized users have full file system permissions:

   1. From Windows NT Explorer, select Oracle9iAS Database Cache executables and dynamic link libraries (in `ORACLE_HOME\bin`), Oracle9iAS Database Cache directories, and files for the cache (in `ORACLE_HOME\dbs`).

   2. Right-click and select Properties.

   3. Adjust the file and directory permissions to ensure that:

      - Only the security account has full control permissions to these files

      - User accounts that must run Oracle applications (for example, SQL*Plus, Server Manager, and Pro*C) have read privileges on the necessary executables (for example, `sqlplus.exe` for SQL*Plus)

   ##### Windows NT Registry Security

   Oracle Corporation recommends that you remove write permissions in the NT registry from users who are not DBAs or system administrators.

   To remove write permissions:

   1. From the Windows NT Start menu, select Run. For Open, type regedt32.

   2. Select the key `HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE`.

   3. From the Security menu, select Permissions.

   4. In the Registry Key Permissions dialog box, remove write permissions from any users who are not Oracle9iAS Database Cache DBAs or system administrators. Note that the SYSTEM account must have Full Control.

   5. Ensure that user accounts that must run Oracle applications have read privileges.

   6. Click OK.

   7. Exit the registry.

   #### SSL Authentication Method Configuration

   This section guides you through configuring SSL for Oracle9iAS Database Cache, Oracle Servlets Engine for Java, Distributed CORBA Applications, and Enterprise JavaBeans.

   These steps guide you through the SSL configuration for the following:

   ##### Oracle9iAS Database Cache

   To configure Oracle9iAS Database Cache to use SSL, remove the comment characters (#) from the following entry in the `listener.ora` file:

   For secure connections over SSL, uncomment the following lines:

       #  (DESCRIPTION = # Secure TCP connections
       #      (ADDRESS =
       #         (PROTOCOL = TCPS) (HOST = host_name) (PORT = 2484)
       #      )
       #  )

   The listener will listen for all SSL requests.

   ##### Oracle Servlets Engine for Java

   To configure Oracle Servlets Engine for Java to use SSL, (in addition to removing the comment characters from the appropriate line in the initialization file) you must remove the comment characters (#) from the following entry in the `tnsnames.ora` file:

       # Support for mod_ose over TCP with SSL connections.
       # inst1_https =
       #   (DESCRIPTION =
       #      (ADDRESS =
       #         (PROTOCOL=TCPS)
       #         (HOST=host_name)
       #         (PORT=2484)
       #      )
       #      (CONNECT_DATA=
       #         (SERVICE_NAME=MODOSE)
       #         (SERVER=shared)
       #         (PRESENTATION=http://admin)
       #      )
       #   )

   ##### Distributed CORBA Applications and Enterprise JavaBeans

   To configure distributed CORBA application and Enterprise JavaBeans to use SSL, (in addition to removing the comment characters from the appropriate line in the initialization file) you must remove the comment characters (#) from the following entry in the `listener.ora` file:

   For secure IIOP connections over SSL, uncomment the following lines:

       # (DESCRIPTION = # Secure IIOP Connections
       #    (PROTOCOL_STACK =
       #       (PRESENTATION=GIOP)
       #       (SESSION=RAW)
       #     )
       #    (ADDRESS=(PROTOCOL=TCPS)(HOST=% s_host_name%)(PORT=2482))
       #  )

   #### Multi-threaded Server Configuration

   These steps guide you through configuring Oracle9iAS Database Cache as a Multi-threaded server for Oracle Servlets Engine for Java, Distributed CORBA Applications, and Enterprise JavaBeans:

   ##### Oracle Servlets Engine for Java

   To configure Oracle9iAS Database Cache as a multi-threaded server (MTS) for Oracle Servlets Engine for Java, you must make one or both of the following changes to your initialization file (`inst` `SID``.ora`):

   - For standard connections, remove the comment character (#) from the following line:

         # mts_dispatcher = "(PROTOCOL=TCP)(SERV=MODOSE)"

   - To use the secure socket layer (SSL) authentication method, remove the comment character (#) from the following line:

         # mts_dispatcher = "(PROTOCOL=TCPS)(SERV=MODOSE)"

   For information on enabling SSL for Oracle9iAS Portal, refer to Oracle Portal 3.0.8 Configuration Guide.

   Distributed CORBA Applications and Enterprise JavaBeans

   To configure Oracle9iAS Database Cache as a multi-threaded server (MTS) for distributed CORBA applications and Enterprise JavaBeans, you must make the following changes in your initialization file (`inst` `SID``.ora`):

   - Remove the comment character (#) from the following line:

         # mts_dispatcher = "(PROTOCOL=TCP)(PRE=oracle.aurora.server.SGiopServer)"

   - To use the secure socket layer (SSL) authentication method, remove the comment character (#) from the following line:

         # mts_dispatcher = "(PROTOCOL=TCPS)(PREoracle.aurora.server.SGiopServer)"

   ### Starting and Stopping Components

   You can manually start and stop a component by doing the following:

   1. In the Windows Control Panel, open Services.

   2. In Services, select the service then click Start or Stop for desired result.

   Table 5-1 lists the service names for the Oracle9i Application Server components.

   ##### Table 5-1 Starting and Stopping Components

   Component | Service Name
   --- | ---
   Oracle9iAS Database Cache |
       OracleiSuiteDataGatherer
       OracleServiceicache
       OracleWTCicache
   Oracle9iAS Discoverer |
       OracleDiscoverer4i
   Oracle9iAS Forms Services |
       Oracle Forms Server [Forms60Server]
       Oracle_Load_Balancer_60_Client-Oracle_806
       Oracle_Load_Balancer_60_Server-Oracle_806
   Oracle9iAS Reports Services |
       Oracle Reports Server [Reports_machine_name]
   Oracle9iAS Web Cache |
       OracleiSuitesWebCache
       OracleiSuitesWebCacheAdmin
   Oracle9iAS Wireless Web Integration Server |
       Oracle Web Integration Server
   Oracle HTTP Server |
       OracleiSuitesHTTPServer
       Net8/SQLNET
       OracleiAS_6iServerClientCache80
       OracleiAS_HomeTNSListener
       OracleiSuitesAgent
       OracleiSuiteTNSListener
       OracleiSuiteAgent
   Oracle Management Server |
       OracleiSuitesManagementServer
       OracleiSuitesPagingServer

   Note: Use the following commands for Oracle Internet File System: Setting Environment`:ifs1.bin\ifsenv.bat and ifs1.1\bin\ifsconfig.bat` Start`: ifs1.1\bin\ifstart.bat` Start`:ifs1.1\bin\ifstop.bat`

   ### Component Web Sites

   Table 5-2 lists Web sites for Oracle9i Application Server components.

   ##### Table 5-2 Component Web sites

   Component | Web Site
   --- | ---
   Oracle9iAS Discoverer |
       http://hostname.domain:80/discoverer4i/viewer
   Oracle9iAS Forms Services |
       http://hostname.domain:80/dev60html/runform.htm
   Oracle9iAS Portal |
       http://hostname.domain:80/pls/portal30
   Oracle9iAS Reports Services |
       http://hostname.domain:80/dev60html/runrep.htm
   Oracle9iAS Wireless Web Integration Server |
       http://hostname.domain:5555
   (Log on as `Administrator/manager`.)
   Oracle9iAS Web Cache |
       http://hostname.domain:4000
       (Log on as Administrator/Administrator.)
   Oracle HTTP Server Oracle HTTP Server (SSL-enabled) |
       http://hostname.domain:80

       https://hostname.domain:443
   Oracle Internet File System |
       http://hostname.domain:80/ifs/files
   (Log on as `system/manager`.)
   Oracle Management Server |
       http://hostname.domain:3339

   ### Component Port Numbers

   Table 5-3 lists the default port numbers on which requests are received for each component.

   ##### Table 5-3 Port Numbers

   Components | Port Number
   --- | ---
   Oracle9iAS Database Cache Oracle9iAS Database Cache TNS Listener Oracle9iAS Database Cache `-wtcme` process Oracle9iAS Database Cache Data Gatherer `-vppdc` process | 51719 TCP/IP: 1521, IIOP: 2481 51719, 51720 1808, 1809
   Oracle9iAS Discoverer | Oracle9iAS Discoverer uses the same port number as Oracle HTTP Server
   Oracle9iAS Forms Services Load Balancer Client Load Balancer Server | 9001 9011 9021
   Oracle9iAS Portal | Oracle9iAS Portal uses the same port number as Oracle HTTP Server
   Oracle9iAS Reports Services | 1950
   Oracle9iAS Web Cache Oracle9iAS Web Cache Administration Port Oracle9iAS Web Cache Invalidation Port Oracle9iAS Web Cache Statistics Port | 1100 4000 4001 4002
   Oracle9iAS Wireless Oracle9iAS Wireless Web Integration Server | Oracle9iAS Wireless uses the same port as Oracle HTTP Server 5555
   Oracle HTTP Server Oracle HTTP Server (SSL-enabled) Oracle HTTP Server Jserv Servlet Engine | 80 443 8007
   Oracle Internet File System | Oracle Internet File System uses the same port number as Oracle HTTP Server FTP: 21 SMB: 139 SMTP: 2500 IMAP: 143 CUP: 4180
   Oracle Enterprise Java Engine TNS Listener | TCP/IP: 1521 IIOP: 2481
   Oracle Management Server | 7771, 7772, 7773

   ### Additional Documentation

   For further information on postinstallation and configuration tasks, refer to component-specific documentation. For information on viewing and installing the documentation, refer to Appendix E, "Installing Documentation Library".

| Copyright © 2001 Oracle Corporation. All Rights Reserved. |
| Library | Contents | Index