3
Oracle HTTP Server Only

This chapter guides you through the installation steps for the Oracle HTTP Server Only 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 Oracle Universal Installer Welcome screen and click Next.

   Figure 3-1 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: To deinstall individual components or the entire product. This button appears only on the Welcome screen.

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

   • Exit: To quit the installation process and exit the installer.

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

   • Installed Products: To view currently installed products or to deinstall the entire product or components.

   • Previous: To return to the previous screen.

   • Next: To move to the next screen.

2. Verify the source and destination paths and click Next.

   Figure 3-2 File Locations Screen

   
   
   Text description of the illustration n_filloc.gif

   The File Locations screen allows you to enter the full path for the source and destination locations of Oracle9i Application Server.

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

   • Destination: This is the full path of ORACLE_HOME, which is the root directory in which product is installed.

     - Name: This is the name Windows uses to identify your ORACLE_HOME.

     - Path: This is the full path of the ORACLE_HOME.

     Note: Be sure 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.

3. Select Oracle HTTP Server Only and click Next.

   Figure 3-3 Installation Types Screen

   
   
   Text description of the illustration n_apac.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.

   The following are the installation options:

   • Oracle HTTP Server Only: Installs Oracle Portal, Oracle Portal-to-Go, Oracle Enterprise Manager Client, and Oracle HTTP Server.

   • Standard Edition: Installs Oracle 8i JVM, Oracle Enterprise Manager Client, Oracle Portal, Oracle Portal-to-Go, Oracle Internet File System, and Oracle HTTP Server.

   • Enterprise Edition: Installs Oracle Forms Services, Oracle Reports Services, Oracle Database Cache, Oracle Management Server, Oracle Enterprise Manager Client, Oracle 8i JVM, Oracle Web Cache, Oracle Portal, Oracle Discoverer 3i Viewer, Oracle Portal-to-Go, Oracle Internet File System, and Oracle HTTP Server.

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

   Figure 3-4 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"

5. Review the system reboot information and click Next.

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

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

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

   Figure 3-6 Install Screen

   
   
   Text description of the illustration n_inst1.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 installer appears and proceeds to install Oracle9i Application Server. The following instructions guide you through the installation process.

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

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 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 under the following condition(s):

   • Oracle Universal Installer is being run on your machine for the first time.

   • Oracle Universal Installer has detected insufficient disk space in the ORACLE_HOME directory.

   Figure 3-7 Component Locations Screen

   
   
   Text description of the illustration entcploc.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 or accept the default Portal DAD and Schema names. Also, enter the TNS Connect String, if necessary. Click Next.

   Figure 3-8 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 have defined for the remote Oracle database. 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.

3. Enter or accept the default Login Server DAD and Schema names. Also, enter the TNS Connect String, if necessary. Click Next.

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

4. Enter the hostname, port number, and SID of the origin database, and click Next.

   Figure 3-10 Portal-to-Go Repository Information Screen

   
   
   Text description of the illustration n_prep.gif

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

   • Hostname: Enter the hostname.domain of the origin database.

   • Port: Enter the Net8 Listener port number.

   • SID: Enter the System Identifier (SID) of the origin database.

5. Enter the new username and password for the database user to store the Portal-to-Go repository, and click Next.

   Figure 3-11 Portal-to-Go Schema Information Screen

   
   
   Text description of the illustration n_pscma.gif

   Portal-to-Go Schema Information screen allows you to create a database user to store the Portal-to-Go repository.

   • Username: Enter a new user name for the database user to store the Portal-to-Go 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.

6. Enter and confirm the SYSTEM password of the database, and click Next.

   Figure 3-12 System Password Screen

   
   
   Text description of the illustration n_psys.gif

   System Password screen allows you to enter and confirm the SYSTEM password of the database where you are loading the Portal-to-Go repository.

   • Enter Password: Enter the SYSTEM password of the origin database.

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

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

   Figure 3-13 Summary Screen

   
   
   Text description of the illustration n_asumm.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.

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

   Figure 3-14 Install Screen

   
   
   Text description of the illustration n_inst2.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.

9. Verify the list of configuration tools and click Next.

   Figure 3-15 Configuration Tools Screen

   
   
   Text description of the illustration a_cft.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 components.

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

   • Automatically starts the components.

   • Retry: To re-execute the configuration script if the configuration of a component fails.

   • Stop: To quit the configuration process.

   Configuration Tools

   This installation option launches the following configuration tools:

   Net8 Configuration Assistant - It enables you to connect and configure the Oracle client/server network environment.

   See Also: Net8 Administration's Guide in the Oracle Database Documentation Library for information on running Net8 Configuration Assistant.

   Starting Oracle HTTP service- It 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.

   Oracle Portal Configuration Assistant - It loads necessary database objects for Oracle Portal to run.

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

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

    Figure 3-16 End of Installation Screen

    
    
    Text description of the illustration n_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 Oracle HTTP Server Only 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, be sure to install Oracle Portal-to-Go client from the Oracle9i Application Server Administrative and Development Client CD included in the Oracle9i Application Server CD pack.

See Also: Appendix B, "Installing Oracle Portal-to-Go Client"

The postinstallation contains the following sections:

• Environment Variables

• Component Port Numbers

• Component-specific Tasks

• Starting and Stopping Oracle HTTP Server

• Additional Documentation

Environment Variables

Table 3-1 lists the environment variables that must be set for Oracle HTTP Server Only installation option:

Table 3-1 Environment Variables

Environment Variable	Must Be or Include
ORACLE_HOME	The ORACLE_HOME used for installing Oracle9i Application Server.
PATH	<ORACLE_HOME>\bin <ORACLE_HOME>\Apache\Apache\bin

Component Port Numbers

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

Table 3-2 Port Numbers

Components	Port Number
Oracle HTTP Server Oracle HTTP Server (SSL-enabled)	80 443
Oracle Portal	Oracle Portal uses the same port number as Oracle HTTP Server
Oracle Portal-to-Go	Oracle Portal-to-Go uses the same port number as Oracle HTTP Server

Component-specific Tasks

Oracle Portal-to-Go

The following section describes postinstallation configuration instructions for Oracle Portal-to-Go:

• Loading Oracle Portal-to-Go Repository

• Oracle Portal-to-Go Web Integration Server Configuration

• Oracle Portal-to-Go Configuration Parameters

• Oracle Portal-to-Go Configuration Verification

Loading Oracle Portal-to-Go Repository

To load the bootstrap repository in the Oracle Portal-to-Go schema:

1. Open a DOS session, and go to ORACLE_HOME\panama\setupconf directory.

2. Type the following command:

   Set JAVA_HOME=ORACLE_HOME\Apache\jdk
   
   

3. Type the following to run the batch files:

   pa_java_inst
   

Oracle Portal-to-Go Web Integration Server Configuration

Oracle Portal-to-Go Web Integration Server hosts services that applications can use to exchange data and information sources via the Web. The Web Integration Server is installed with the Oracle Portal-to-Go components.

Note: The Web Integration Developer, the development environment for creating and testing Web Integration services written in Web Interface Definition Language (WIDL), is installed as part of the Oracle Portal-to-Go client.

See Also: Appendix B, "Installing Oracle Portal-to-Go Client"

The following steps guide you through the configuration process of the Web Integration Server:

1. Run the Web Integration Server.

   Web Integration Server is installed as a service. Select Oracle Web Integration Server from the Services dialog, and click the Start button.

2. From a browser, go to the Web Integration Server URL:

   http://host_name.domain:5555

3. Log in to the Web Integration Server with the user name Administrator, and password manage, which is the default password.

4. Select Settings. The server settings appear. Click Edit.

5. Enter the Proxy (HTTP) and Secure Proxy (HTTPS) settings for your environment.

6. Click Submit.

7. Click Logout.

Oracle Portal-to-Go Configuration Parameters

1. Configure the httpd.conf file.

   The httpd.conf file is in the ORACLE_HOME\Apache\Apache\conf directory.

   Create a Personalization Portal (papz) alias. This is needed so that the application server can find the

   http://hostname/papz/login.jsp.

   Add a line at the end of the Alias section:

   # PTG Start
   Alias /papz/ "<ORACLE_HOME>\panama\server\papz\"
   # PTG End
   
   

2. Configure the jserv.conf file.

   The jserv.conf file is in the ORACLE_HOME\Apache\Jserv\conf directory.

   In the ApJServMount section, add the Oracle Portal-to-Go specific mount point:

   # PTG Start
   ApJServMount /ptg /root
   # PTG End
   

3. Configure the jserv.properties file.

   The jserv.properties file is in the ORACLE_HOME\Apache\Jserv\conf directory.

   Next to the other "wrapper.classpath" entries, add all the required Oracle Portal-to-Go files to the classpath.

   # PTG Start
   wrapper.classpath=<ORACLE_HOME>\panama\server\classes
   wrapper.classpath=<ORACLE_HOME>\panama\lib\panama_core.zip
   wrapper.classpath=<ORACLE_HOME>\panama\lib\panama_papz.zip
   wrapper.classpath=<ORACLE_HOME>\panama\lib\client.zip
   wrapper.classpath=<ORACLE_HOME>\panama\lib\server.zip
   # PTG End
   
   

4. Configure the zone.properties file.

   The zone.properties file is in the

   ORACLE_HOME\Apache\Jserv\servlets directory.

   1. In the List of Repositories section, add the Oracle Portal-to-Go specific repository to the existing repository line with a comma (,) separator:

      # PTG Start
      repositories=<ORACLE_HOME>\Apache\Jserv\servlets,<ORACLE_HOME>\panama\
      server\papz
      # PTG End
      
      

   2. In the Startup Servlets section, add the Oracle Portal-to-Go specific servlets:

      # PTG Start
      servlets.startup=oracle.panama.ParmImpl
      # PTG End
      
      

   3. In the Servlet Aliases section, add the Oracle Portal-to-Go specific servlets:

      # PTG Start
      servlet.rm.code=oracle.panama.ParmImpl
      # PTG End
      
      

Oracle Portal-to-Go Configuration Verification

After installation, you can verify that individual Oracle Portal-to-Go components are properly configured:

1. Test the sample Java Servlet at the following URL:

   http://host_name.domain/papz/test.jsp

   "Hello World" should appear on the screen.

2. Test whether the Personalization Portal is working properly by accessing the following URL:

   http://host_name.domain/papz/login.jsp

   The login page should appear. The Personalization Portal prompts you to enter a user name and a password. You can log in using "Administrator" as the user name and "manager" as the password.

3. Run the Oracle Portal-to-Go Request Manager by accessing the following URL:

   http://host_name.domain/ptg/rm

Starting and Stopping Oracle HTTP Server

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.

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