4
Postinstallation Tasks

This chapter describes the tasks you should perform after every application server installation.

It contains the following topics:

• Task 1: View the Oracle9iAS Welcome Page

• Task 2: Check for Port Conflicts

• Task 3: Complete Component Configuration

• Task 4: Run Demos (optional)

Task 1: View the Oracle9iAS Welcome Page

The Oracle9iAS Welcome Page is the entry point for managing the application server. It provides links to documentation, demos, management tools, and new features. Figure 4-1 displays the Oracle9iAS Welcome Page.

Figure 4-1 Oracle9iAS Welcome Page

Text description of the illustration welcome.gif

You can access the Welcome Page by pointing your browser to the HTTP Server URL for your installation. For example, the default HTTP Server URL is:

http://hostname:7777

Task 2: Check for Port Conflicts

The application server automatically assigns port numbers for many services during installation. It chooses port numbers from a set of default port numbers and port ranges.

See Also: Appendix D, "Default Port Numbers and Port Ranges"

A port should only be assigned to a single service. If two services attempt to use the same port, there will be a port conflict, and one or both services will not function properly.

When assigning ports, the application server attempts to avoid port conflicts in the following ways:

• It internally tracks the port numbers used by all application server instances (running or not running) on a host and will not use the same port number twice.

• It performs a system check to determine if any non-Oracle9iAS processes are running on the port.

Despite this strategy, a port conflict may still occur between the application server and a non-Oracle9iAS process that was not running during the application server installation.

Oracle recommends that you review the application server port numbers assigned during installation to determine if there are any port conflicts with the rest of your system. You can view application server port numbers in the following ways:

• Point your browser to the Oracle9iAS Welcome Page and select the Ports tab. You can access the Welcome Page using the HTTP Server URL, for example:

  http://host:7777
  

• View the following file:

  (UNIX) ORACLE_HOME/install/portlist.ini.
  (Windows) ORACLE_HOME\install\portlist.ini
  

If you determine there is a port conflict, you must change the port number used by the application server or the non-Oracle9iAS process.

See Also: Component administration guides for information on changing port numbers for specific components

Task 3: Complete Component Configuration

If you configured any of these components during installation, you may need to perform some additional steps to complete the configuration:

• Oracle9iAS Clickstream Intelligence

• Oracle9iAS Discoverer

• Oracle9iAS Personalization

• Oracle9iAS Portal

• Oracle9iAS Unified Messaging

If you would like to use mod_plsql, it was installed with Oracle HTTP Server but requires some additional steps for configuration.

This section describes the steps to complete the configuration of each component.

Oracle9iAS Clickstream Intelligence

After completing a Business Intelligence and Forms or Unified Messaging installation, you can configure Oracle9iAS Clickstream Intelligence to use the metadata repository or a customer database (also referred to as a dedicated Clickstream database). If you plan to acquire and store a large volume of Web log data, it is recommended that you use a customer database.

See Also: To configure Clickstream to use a customer database, follow the steps in Appendix B, "Installing a Dedicated Clickstream Database" in Oracle9iAS Clickstream Intelligence Administrator's Guide.

Oracle9iAS Discoverer

If you configured Oracle9iAS Discoverer during installation, you must install Discoverer workbooks and End User Layer (EUL) into each customer database that contains the data to be analyzed.

See Also: Oracle9i Discoverer Administrator Administration Guide for information about preparing a customer database for Discoverer to use

Oracle9iAS Personalization

If you configured Oracle9iAS Personalization during installation, you must load schemas into a customer database so they can be co-resident with the Personalization data. You can do this using the Oracle Personalization Schema Creation Wizard.

See Also: Oracle9iAS Personalization Administrator's Guide for information on running the Oracle Personalization Schema Creation Wizard

Oracle9iAS Portal

If you configured Oracle9iAS Portal during the application server installation, it was configured to use the metadata repository, and no additional steps are required.

If you did not configure Oracle9iAS Portal during installation, you can configure it any time after installation by using the Oracle Portal Configuration Assistant. When you configure Portal after installation, you can use the metadata repository or a customer database.

See Also: Oracle9iAS Portal Configuration Guide for information on configuring Oracle9iAS Portal using Oracle Portal Configuration Assistant

Oracle9iAS Unified Messaging

If you configured Oracle9iAS Unified Messaging during installation, you must install the mail store and middle-tier servers by running the umconfig.sh script that is located in ORACLE_HOME/oes/bin.

See Also: Oracle9iAS Unified Messaging Administrator's Guide for information on configuring the Unified Messaging system

mod_plsql

The mod_plsql module is installed as part of Oracle HTTP Server. In order to use mod_plsql, you must perform the following steps:

1. Install the PL/SQL Web Toolkit into a database.

   The method for installing the PL/SQL Web Toolkit into a database depends on the type of database, as described in Table 4-1.

   Table 4-1 Methods for Installing PL/SQL Web Toolkit into a Database  

   Database Type	Method for Installing PL/SQL Web Toolkit
   Metadata Repository (Oracle9iAS Portal was not configured during installation)	You must manually install the PL/SQL Web Toolkit using the owaload.sql script. See Also: mod_plsql User's Guide
   Metadata Repository (Oracle9iAS Portal was configured during installation)	You do not need to install the PL/SQL Web Toolkit because it was already installed for Oracle9iAS Portal.
   Customer Database with no prior Oracle9iAS Portal or PL/SQL packages	You must manually install the PL/SQL Web Toolkit using the owaload.sql script. See Also: mod_plsql User's Guide
   Customer Database configured for Oracle9iAS Portal	You do not need to install the PL/SQL Web Toolkit because it was already installed for Oracle9iAS Portal.
   Customer Database with pre-9.0.2 Oracle9iAS version of PL/SQL Web Toolkit, or WebDB	You must upgrade the PL/SQL Toolkit and perform some migration tasks. See Also: mod_plsql User's Guide and Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2)
   Customer Database with Oracle Application Server (OAS) PL/SQL Web Toolkit	You must upgrade the PL/SQL Toolkit and perform some migration tasks. See Also: mod_plsql User's Guide and Migrating from Oracle Application Server

2. Create a Database Access Descriptor (DAD).

   You can create a Database Access Descriptor (DAD) using Oracle Enterprise Manager.

   See Also: "Creating a Database Access Descriptor (DAD) for mod_plsql" .

Task 4: Run Demos (optional)

Oracle9iAS provides demonstration software for many components, as described in Table 4-2, "Oracle9iAS Demos".

In order to run a demo for a particular component, you must have the following:

• An application server installation that contains the component

• The component must be configured

• The required component instances must be running

For example, the Portal demonstration will work only with the Portal and Wireless install type, or higher, Portal must be configured and the Portal, OC4J_Portal, and OC4J_Demos instances must be running.

See Also: To view more information and run demos, point your browser to the Oracle9iAS Welcome Page and select the Demonstrations tab.

Table 4-2 Oracle9iAS Demos  

Component	Required Running Component Instances	Demo	Description
Oracle HTTP Server	HTTP Server	CGI	Displays environment setting using CGI.
	HTTP Server	Perl	Displays environment settings using a Perl script and mod_perl.
	HTTP Server	FastCGI	Displays environment settings using FastCGI.
Oracle9iAS Containers for J2EE (OC4J)	OC4J_home OC4J_Demos	JSP	Demonstrates the Oracle JSP Tag Libraries, JDBC access, and Java Edge Side Includes (JESI).
	OC4J_home OC4J_Demos	JSP	Standard JSP examples from Sun.
	OC4J_home OC4J_Demos	Servlets	Standard servlet examples from Sun.
	OC4J_home OC4J_Demos	Java Object Cache	Demonstrates performance gains by caching Java objects.
	OC4J_home OC4J_Demos	BC4J	Demonstrates an online order system built with BC4J, with pages to browse, search, and order toys.
	OC4J_home OC4J_Demos	XML-based JAAS	Demonstrates the XML-based JAAS Provider to authenticate a user and enforce associated roles and permissions.
	OC4J_home OC4J_Demos	JDBC	Run these JDBC examples from the command line.
	OC4J_home OC4J_Demos	JMS	Run these Oracle Advanced Queuing JMS examples from the command line.
Oracle9iAS Web Services	OC4J_home OC4J_Demos	Web Services	Demonstrates Web Services.
Oracle9iAS Developer Kits	OC4J_home OC4J_Demos	XSQL Pages	Demonstrates examples of XML database publishing using XSLT for styling the output for delivery to the browser.
Oracle9iAS Web Cache	Web Cache	Web Cache Invalidation APIs	Provides sample code for Web Cache Invalidation APIs.
	Web Cache	Web Cache	Links to the Web Cache page on OTN for additional sample code.
Oracle9iAS Portal	Portal OC4J_Portal OC4J_Demos	Portal	Links to a Portal page which includes a sample document repository and links to Oracle Portal Center and Oracle9iAS Portal Developer Kit.
Oracle9iAS Wireless	Wireless OC4J_Wireless OC4J_Demos	Wireless	Demonstrates sending messages and accessing email from any mobile device.
Oracle9iAS Discoverer	Discoverer OC4J_BI_Forms OC4J_Demos	Discoverer	Demonstrates Discoverer Viewer and Discoverer Plus.
Oracle9iAS Reports Services	Reports OC4J_BI_Forms OC4J_Demos	Reports Services	Demonstrates dynamic report output to both paper and the Web.
Oracle9iAS Forms Services	Forms OC4J_BI_Forms OC4J_Demos	Forms Services	Demonstrates a test form to verify your install. You will be prompted to install JInitiator on the client as part of this demo.
	Forms OC4J_BI_Forms OC4J_Demos	Forms Services	Links to the Forms page on OTN for additional demos and sample code.