Oracle A54857-03 User Manual

Oracle Web
Application Server™
Installation Guide

Release 3.0.1 for Windows NT

Part No. A54857-03

Enabling the Information Age

Oracle Web Application Server™ Installation Guide
Release 3.0.1

Copyright © Oracle Corporation 1996, 1997, 1998
All rights reserved. Printed in the U.S.A.
This software was not developed for use in any nuclear, aviation, mass transit, medical,

or other inherently dangerous applications. It is the customer’s responsibility to take all
appropriate measures to ensure the safe use of such applications if the programs are used
for such purposes.

This software/documentation contains proprietary information of Oracle Corporation; it
is provided under a license agreement containing restrictions on use and disclosure and
is also protected by copyright law. Reverse engineering of the software is prohibited.

If this software/documentation is delivered to a U.S. Government Agency of the Depart­ment of Defense, then it is delivered with Restricted Rights and the following legend is
applicable:

Restricted Rights Legend Use, duplication, or disclosure by the Government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, Rights in Tech­nical Data and Computer Software (October 1988).

Oracle Corporation, 600 Oracle Parkway, Redwood Shores, CA 94065.
If this software/documentation is delivered to a U.S. Government Agency not within the

Department of Defense, then it is delivered with “Restricted Rights”, as defined in FAR

52.227-14, Rights in Data - General, including Alternate III (June 1987).
The information in this document is subject to change without notice. If you find any

problems in the documentation, please report them to us in writing. Oracle Corporation
does not warrant that this document is error-free.

REGISTERED TRADEMARKS of Oracle Corporation:
CASE Designer, CASE Dictionary, CASE Exchange, CASE Workshops, CoAuthor, ConText, Cooperative Develop-

ment Environment, Cooperative Server Technology, Datalogix, Easy*SQL, Express, GEMMS, NLS*WorkBench,
Oracle, Oracle Alert, Oracle Application Object Library, Oracle Book, Oracle Card, Oracle ConText, Oracle Finan­cials, Oracle Glue, Oracle Leasing, Oracle Media Objects, Oracle Media Server, Oracle Power Objects, Oracle Press,
Oracle Procedural Gateway, Oracle Secure Network Services, Oracle Transparent Gateway, OracleWare, Pro*Ada,
Pro*COBOL, Pro*FORTRAN, Pro*Pascal, Pro*PL/I, Pro*Rexx, Secure Network Services, SQL*Connect,
SQL*Forms, SQL*Loader, SQL*Menu, SQL*Module, SQL*Net, SQL*Plus, SQL*Report.

NON-REGISTERED TRADEMARKS of Oracle Corporation:
Advanced Networking Option, Advanced Replication Option, AIM Advantage, Alexandria, Alliance Online, Ap-

plication Agent, Architected Best in Class, Athenia, Better Decisions Made Simple, CASE Generator, Charlotte,
CDM Advantage, Content/2000, Corporate Planner Option, Database Server, DDE Manager, Des40, Designer/
2000, Developer/2000, Discoverer, Dynamic Discovery Option, Easy*Query, Enabling the Information Age, End
User Layer, Gist, Global Accounting Engine, Hyper*SQL, Intelligent Data Manager, Internet Video Server, Inter­Office, J/SQL, Live HTML, Media Talk, Network Computing Architecture, Object Marketplace, ODP Pulse, ODP
Techwire, Open/2000, Oracle Access, Oracle Access Manager, Oracle Accounts Receivable, Oracle Advanced Ben­efits, Oracle Agents, Oracle Application Display Manager, Oracle Applications, Oracle Applications Window Man­ager, Oracle Assets, Oracle Automotive, Oracle BASIC, Oracle Bills of Material, Oracle Bookbatch, Oracle
BookBuilder, Oracle Browser, Oracle Business Analysis, Oracle Business Manager, Oracle Call Interface, Oracle Ca­pacity, Oracle CASE, Oracle CDD/Administrator, Oracle CDD/Repository, Oracle Clinical, Oracle CODASYL
DBMS, Oracle Cooperative Applications, Oracle Cost Management, Oracle Data Browser, Oracle Data Query, Or­acle Departmental Server, Oracle DEVCONNECT, Oracle Developer Programme Pulse, Oracle Digital Library So­lutions Framework, Oracle Documents, Oracle EDI Ex*tender, Oracle EDI Gateway, Oracle Energy, Oracle
Engineering, Oracle Enterprise Interface Manager, Oracle Enterprise Manager, Oracle Enterprise Manager Perfor­mance Pack, Oracle Expert, Oracle Expert Option, Oracle Express Administrator, Oracle Express Analyzer, Oracle
Express Server, Oracle Financial Analyzer, Oracle Financial Controller, Oracle Forms, Oracle Forms Generator, Or­acle Foundation, Oracle GEMMS, Oracle General Ledger, Oracle Government Financials, Oracle Government Gen­eral Ledger, Oracle Government Human Resources, Oracle Government Payables, Oracle Government Payroll,

Oracle Government Purchasing, Oracle Government Receivables, Oracle Government Revenue Accounting, Ora­cle Graphical Schema Editor, Oracle Graphics, Oracle Human Resource Management Systems, Oracle Human Re­sources, Oracle Illustrated, Oracle Illustrated Series, Oracle Imaging, Oracle Incident, Oracle Industries, Oracle
Installer, Oracle InstantSQL, Oracle Integrator, Oracle Internet Commerce, Oracle Internet Server, Oracle InterOf­fice, Oracle InterOffice Client, Oracle InterOffice Manager, Oracle InterOffice Server, Oracle Inventory, Oracle
Magazine, Oracle Magazine Interactive, Oracle Manufacturing, Oracle Master Scheduling, Oracle Master Schedul­ing/MRP, Oracle Media Data Store, Oracle Media Library, Oracle Mission Control, Oracle Mobile Agents, Oracle
Module Language, Oracle MRP, Oracle MultiProtocol Interchange, Oracle Names, Oracle NetSolutions, Oracle
Network Manager, Oracle Newsroom Manager, Oracle Object Marketplace, Oracle Objects, Oracle Office, Oracle
Office Directory, Oracle Office Mail, Oracle Office Manager, Oracle Office Scheduler, Oracle Online, Oracle Open
Client Adapter, Oracle Open Gateways, Oracle Open World, Oracle Order Entry, Oracle Parallel Server [or Oracle7
Parallel Server], Oracle Payables, Oracle Payroll, Oracle Personal Time and Expense, Oracle Planner Workbench,
Oracle PowerBrowser, Oracle Procedure Builder, Oracle Process Modeller, Oracle Product Configurator, Oracle
Project Accounting, Oracle Project Billing, Oracle Project Costing, Oracle Projects, Oracle Public Sector, Oracle Pur­chasing, Oracle Quality, Oracle RALLY, Oracle Rdb7, Oracle Receivables, Oracle Release Management, Oracle Rep­lication Manager, Oracle Replication Services, Oracle Reports, Oracle Reports Generator, Oracle Repository
Administrator, Oracle Revenue Accounting, Oracle RMU, Oracle Sales Analysis, Oracle Sales Analyzer, Oracle
Sales and Compensation, Oracle Sales and Marketing, Oracle Sales Brief, Oracle Sales Compensation, Oracle Server
Generator, Oracle Server Manager, Oracle Smart Video, Oracle Store, Oracle System Sizer, Oracle SQL*Tutor, Or­acle SQL/Services, Oracle Supplier Scheduling, Oracle Supply Chain Planning, Oracle SupportNotes, Oracle Sys­tems Designer, Oracle Systems Modeller, Oracle Terminal, Oracle Text Server, Oracle TextServer3, Oracle Toolkit,
Oracle TRACE, Oracle TRACE Collector, Oracle TRACE Option, Oracle Training Administration, Oracle Transla­tion Manager, Oracle Universal Database, Oracle Upstream, Oracle Video Client, Oracle Video Server, Oracle Web
Customers, Oracle Web Employees, Oracle Web Suppliers, Oracle Web Application Server, Oracle Work in Pro­cess, Oracle Workflow, Oracle Workgroup Server [or Oracle7 Workgroup Server], Oracle*Mail, Oracle7, Oracle7
Enterprise Backup Utility, Oracle7 Server, Oracle7 Spatial Data Option, Oracle8, Oracle 64 Bit Option, Oracle/2000,
PC Express, Personal Express, Personal Oracle [or Personal Oracle7], Personal Oracle Lite, PJM Advantage, PL/
SQL, Profit, ProREXX, Pro*C, Pro*C/C++, Pro*REXX, Programmer/2000, ProRexx, RDB7, Report Card, Security
Without Compromise, Server/2000, Services/2000, Set-top/2000, Smart Application Client, SmartBox, Smart­Charts, SmartClient, SmartHints, SmartLayout, SmartSpring, SmartStandards, SmartTab, SmartTriggers,
SQL*TextRetrieval, SQL*VDM, SupportAssistant, SupportNotes, SupportNews, The Oracle Network Builder,
Trusted Oracle, Trusted Oracle7, Tutor, Video Client, Video Server, Web Request Broker, Workgroup/2000,
World/2000.

SERVICE MARKS of Oracle Corporation:
BAP, Business Alliance Programme, CASE*Method, Cooperative Applications Initiative, International Oracle Us-

er's Group, International Oracle User's Week, IOUG, IOUW, Migration Technology Initiative, OOW, Operations
Readiness Assessment, Oracle Alliance Program, Oracle Bronze, Oracle Business Alliance Programme, Oracle Con­sulting Services, Oracle Education, Oracle Gold, Oracle Master, Oracle Mercury, Oracle Metals, Oracle Platinum,
Oracle Service, Oracle Silver, Oracle Sterling, Oracle SupportFax, Real Time Support Services, Systems Manage­ment Tools Initiative, Warehouse Technology Initiative, Web System Initiative.

All other products or company names are used for identification purposes only, and may be trademarks of their
respective owners.

Contents

Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Overview of the Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Supported Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Oracle Web Application Server 3.0.1 — Advanced Edition . . . . . . . . . . . . . . 1-6

Products Available for Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Chapter 2 Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Supported Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Chapter 3 Installation Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Supported Installation Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Pre-installation Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

First-time Web Application Server Installation . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Installing over an Existing Web Application Server . . . . . . . . . . . . . . . . . . . . 3-9

Uninstalling Oracle Web Application Server . . . . . . . . . . . . . . . . . . . . . . . . . 3-11

Chapter 4 Post-Installation and Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Starting Web Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Database Access Descriptors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Web-based Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Web Application Server Control Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Configuration for Multi-node Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Setting Up a Secure Oracle Web Application Server . . . . . . . . . . . . . . . . . . . 4-4

Chapter 5 Configuration of Third-party HTTP Servers. . . . . . . . . . . . . . . . . . . . . . . . . .5-1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Configuring Netscape Using the Oracle Installer . . . . . . . . . . . . . . . . . . . . . . 5-1

Microsoft Internet Information Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

Chapter 6 Migrating to Oracle Web Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

Migrating a Netscape Server to Oracle Web Application Server . . . . . . . . . 6-3

Changes Made During Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Access Control and Server Side Includes (parse-html). . . . . . . . . . . . . . . . . . 6-7

Chapter 7 Upgrading from Previous Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-1

Upgrade from WebServer 2.x to Web Application Server 3.0.1 . . . . . . . . . . 7-1

Appendix A Starting and Stopping the Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

owsctl Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Appendix B Multi-node Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Cartridge Instances on Each Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Distributing the Authentication Server Processes. . . . . . . . . . . . . . . . . . . . . . B-4

Troubleshooting and Tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-5

vi Oracle Web Application Server™ Installation Guide

Audience

Prerequisites

Preface

This Installation Guide is the primary source of introduction, installation, and
configuration information for Oracle Web Application Server for Windows NT.

This Installation Guide is necessary for installing, configuring, or administering
Oracle Web Application Server 3.0.1 for Windows NT.

This Installation Guide assumes that you are familiar with:

• Windows NT and have installed and tested it for your PC and network
hardware

• Oracle7 or Oracle8 Server and relational database concepts

Oracle Documentation Set

Online documentation is provided in HTML and Adobe Acrobat Portable
Document Format (PDF). To read the HTML documentation, go to the Web

Listener Administrator Home page, and follow the online documentation link
icon. The PDF documentation can be found by clicking the online
documentation icon in the Oracle for Windows NT program group.

Note: To read the PDF online documentation, install the Adobe Acrobat Reader by

double-clicking the file ACROREAD.EXE in the ACROBAT directory on the
product CD.

The Web Application Server 3.0.1 for Windows NT contains the following
documentation:

• Oracle Web Application Server Installation Guide for Windows NT - This
contains installation information for the Oracle Web Application Server
for Windows NT.

• Overview - This provides general information about the Oracle Web
Application Server.

• Using Oracle Web Application Server Cartridges - This describes how to use
the cartridges provided by Oracle for the Web Application Server.

• Developing your own Web Application Server Cartridges - This provides
information for developing your own Web Application Server cartridges.

• Security - This describes how to use the security features of the Web
Application Server. It also describes how to generate certificate requests.

Related Oracle Documentation

Oracle Server Getting Started for Windows NT
Oracle Server Administrator’s Guide
Oracle Server Utilities User’s Guide
Oracle Server Messages and Codes Manual
SQL Language User’s Guide
SQL Language Reference Manual
SQL*Plus User’s Guide

viii Oracle Web Application Server™ Installation Guide

Conventions Used in This Manual

This table lists the typographical conventions used in this manual.

Convention Meaning

Monospace text Indicates text that must be typed exactly as shown.

set echo off

All uppercase
plain

Bold Used for filenames, directories, and utilities such as:

Italics Indicate a value that you must provide. For example, if a

Horizontal
ellipsis...

Vertical bar | Represents an ‘or’ option between several options. You

Indicates command names, SQL reserved words and
keywords as in ALTER DATABASE.

All uppercase plain is also used for directory names and
file names.

ORANT\DATABASE\INITORCL.ORA

owsctl.

command asks you to type filename, you must type the
actual name of the file.

Italics are also used for emphasis in the text and to
indicate the titles of other manuals.

Indicate that parts of the statement or command not
directly related to the example have been omitted.

CHKVAL fieldname value 1 value 2... valueN

must enter only one of the options. Do not enter the
vertical bar. The set of alternative choices is enclosed by
curly braces if one of the items is required, or by square
brackets if the item is an optional alternative.

Curly braces {} Enclose required items. You must choose one of the

alternatives.
..DEFINE { macro1 | macro2 }

Square brackets [ ] Enclose optional items. You can choose one or none of

the alternatives.
cvtcrt termname [outfile]
Square brackets also indicate a function key, for example

[Enter].

Preface ix

Customer Support

Convention Meaning

C:\> Represents the Windows NT command prompt of the

current hard disk drive. Your prompt may differ and
may, at times, reflect the subdirectory in which you are
working.

Symbols Symbols other than brackets and vertical bars must be

entered in commands exactly as shown.

Oracle Worldwide Technical Support can be reached at the following number
1-650-506-1500 in the United States of America
Be prepared to supply the following information:

• your CSI number (this helps Oracle Corporation track problems recorded
for each customer)

• the release numbers of the Oracle Web Application Server and associated
products

• the operating system name and version number

• details of error numbers and descriptions (write down the exact errors—it
helps Oracle Technical Support track down the problem more quickly)

• a description of the problem

• a description of the changes made to the system

Documentation Sales

To order printed documentation, please call:
1-800-252-0303 in the United States

Your Comments Are Welcome

We value and appreciate your comments as an Oracle user. We encourage you
to send your comments to us at the following address:

x Oracle Web Application Server™ Installation Guide

Web Application Server Documentation Manager
Oracle Corporation
500 Oracle Parkway
Redwood Shores, CA 94065

Preface xi

xii Oracle Web Application Server™ Installation Guide

C H A P T E R

1 Introduction

Overview of the Product

As the World Wide Web matures, a new generation of Internet and Intranet
business applications is emerging. These new applications will incorporate real
business transactions, data-driven multimedia content, and interactive
information. Database-powered Web applications built on this new platform
will enable corporations to expand their services and customer base as well as
explore lucrative new business endeavors while still leveraging their investment
in existing client-server systems. Such powerful Web applications demand a
new breed of Web platform that combines all the power and reliability of
traditional client-server environments with the flexibility and ease-of-use of the
Internet.

Note: Refer to the online glossary for definitions of terms with which you may not be

Open Architecture

Operating within the framework of Network Computing Architecture, Oracle
Web Application Server 3.0.1 expands dramatically upon the power of standard
Web servers, enabling the development and deployment of full-featured
transaction-based Web sites that are scalable, reliable, and secure.

familiar.

A typical technology infrastructure involves a wide range of operating systems,
languages, networks, applications, Web servers, and databases.

Oracle Web Application Server 3.0.1 operates across a wide range of operating
systems, from PCs to workstations, and through its open cartridge API, supports
a diverse class of languages and applications. Oracle Web Application Server

3.0.1 is the first Web server to support real transactions and it does so using X/
Open DTP standards.

Note: A cartridge is a program, run on the server by the Web Request Broker (WRB),

that interfaces to a Web server (Oracle or otherwise) through the WRB API. A
given cartridge will have a varying number of execution instances called
WRBXs.

Transaction Enable your Netscape or Microsoft Server

The WRB is portable not only across a range of operating systems, but across a
range of Web servers. Oracle bundles its own HTTP listener with Web
Application Server 3.0.1, but this portability means that it can also integrate with
Netscape and Microsoft listeners. This allows application developers to protect
their existing investments as technological infrastructures change.

Scalability

Building a presence on the Web can expand horizons considerably, but only if
your Web site can perform and scale to support the vast Internet audience.
Oracle Web Application Server 3.0.1 can scale to serve tens of thousands of users.
Through the WRB, Oracle delivers vastly superior performance, dispatching,
and access times, even in the extremely high network traffic environments that
are synonymous with the Internet. Built to a true multi-threaded, multiprocess
architecture, the Web Request Broker offers a superior application environment
over low-level, first generation HTTP APIs.

Reliability

A mission-critical application demands high availability. Oracle Web
Application Server 3.0.1 brings the robustness and reliability of the client-server
world to the Web. Process separation, an object architecture, and independent
cartridge management allow administrators to build, manage, and service their
system on a component basis. Through its independent processing architecture,
the WRB guarantees that third-party server extensions will not affect other parts
of the system security.

1-2 Oracle Web Application Server™ Installation Guide

Security

With all the potential of real business applications, but no face-to-face contact,
the Web presents new security challenges. Oracle Web Application Server 3.0.1
supports full end-to-end security at the client, at every level within the Web
server architecture, and through the firewall to an Oracle database. This
unprecedented degree of granularity supports not only username-password
protection, but also custom security schemes. For even greater protection of vital
data, Oracle Web Application Server 3.0.1 supports industry standard SSL 3.0.1
encryption, as well as Oracle Advanced Networking Option for secure
communications and transactions.

Supported Features

Oracle Web Application Server 3.0.1 — Standard Edition

• cartridge-based development platform

• CORBA compliant ORB-based Web Request Broker

• support for fully distributed applications

• listener independence

• language-independent development

• third-party cartridges available through the cartridge solutions network

CORBA-compliant ORB

• Web Request Broker (WRB) services implemented as CORBA-compliant

object services

• supports distributed listener and cartridge architecture

Web Request Broker

• automatic server redirection on maximum connections reached

• safe, scalable architecture

• dynamic load-balancing

• automatic context management

• open API for custom extensions

Introduction 1-3

Fully portable WRB API

Java Cartridge

PL/SQL Cartridge

• CORBA-compliant ORB-based Web Request Broker

• unifying API for Netscape, Microsoft, and Oracle HTTP servers

• native Java environment

• auto-generated wrapper classes for PL/SQL

• native access to Oracle

• HTML presentation classes

• National Language Support (NLS)

• support for persistent database connections

• HTML 3.2 support

• 100-percent data encapsulation through stored procedures

• 100-percent portable code

• transparent dispatch to Oracle server

• automatically translates HTML parameters to PL/SQL calls

• HTML 3.2 support

• ICX and transaction support

• enhanced error mapping to relay RDBMS messages to user

• object-oriented design

LiveHTML Cartridge

• enhanced Server Side Include (SSI)

• access to other cartridges through ICX

• HTML files can be target of an HTML form submission

Perl Cartridge

• Perl Version 5 interpreter

• Oracle DBI/DBD extensions

• OraPerl Emulation

1-4 Oracle Web Application Server™ Installation Guide

VRML Cartridge

Inter-cartridge Exchange

Security

• VRML 2.0 standard support

• platform for building and deploying business applications in VRML

• VRML Data Repository that manages persistent, scalable, and secure

VRML worlds

• Logic Repository ties together database triggers with the VRML event

model

• easy-to-use mechanism for embedding dynamic content, generated by

custom scripts or SQL statements within a VRML scene

• transport-independent, stateless protocol

• mirrors the HTTP request model

• set of APIs to allow a cartridge to address, send, request, and receive a

response from another cartridge

• IP address restriction

• domain name restriction

• basic authentication

• digest authentication

• SSL 3.0 (International version uses 40-bit key)

• client-side digital ID authentication

Built-in Logging and Analysis Tools

• support for clf/xlf system message formats and client-defined statistics

• support for log file cycling/archiving based on size/date

• support for logging into the database

• graphical log analyzer tool

• report generation on accesses, errors, clients, URLs, etc.

Common Gateway Interface

• CGI 1.1 compliant

Introduction 1-5

Miscellaneous

Optional Extensibility

• dedicated process per request

• automatic cleanup

• native imagemap support

• multiple imagemap extensions

• configurable DNS resolution

• Common Log Format

• OCI cartridge (Oracle Call Level Interface)

• Rdb cartridge

• Oracle Security Server

• Oracle Internet Commerce Server (cartridge-based solution for electronic
commerce)

• third-party cartridges available through the Cartridge Solutions Network

Oracle Web Application Server 3.0.1 — Advanced Edition

In addition to the standard features, the advanced edition offers the following:

ODBC Cartridge

• accepts SQL statements

• returns HTML table with formatted results

• optional use of format strings

• callable through ICX from any other cartridge

Transaction support

• supports X/Open DTP model

• supports open standards — SQL, X/Open’s XA and X/Open’s TX

• defines a set of APIs that is modeled on the XA interface

• APIs to start or join a transaction, retrieve transaction information, commit
and rollback a transaction

1-6 Oracle Web Application Server™ Installation Guide

• transactional support across multiple cartridges

Persistent Storage Services

• APIs for storing and retrieving content or managing content from a SQL
database

• schema attributes include content-type, author, creation date, etc.

• service supports Oracle DBMS, or file system storage

Products Available for Installation

Components

• Oracle Web Listener

• W eb Application Server Cartridges - The PL/SQL, Java, and Live HTML
cartridges are bundled under the label Web Application Server cartridges
and are automatically installed on the single node and primary multi­node install.

• Web Request Broker

Additional Cartridges

You may choose to install the following additional cartridges during installation:

• ODBC

• JDBC

• VRML

Introduction 1-7

1-8 Oracle Web Application Server™ Installation Guide

C H A P T E R

2 Installation Requirements

System Requirements

Hardware Requirements

Hardware Item Required

CPU An Intel compatible 486 or higher processor
Memory 64 MB (32 MB for a listener only machine)
Disk Space 150 MB
Swap Space 64 MB
CD-ROM Device RockRidge format

Software Requirements

Software Item Version

Operating System Windows NT Server v. 4.0
Web Browser Any browser that supports tables and forms
Listener Oracle 40-bit

Oracle 128-bit
Netscape FastTrack V2.0, V2.0.1
Netscape Enterprise Server V2.0, V2.0.1
Microsoft Internet Information Server V2.0, V3.0

Oracle RDBMS 7.1.6

7.2.2x

7.2.3x

7.3.2.x

7.3.3.x

8.0.3*

8.0.4*

*Note: For cartridges that link with the Oracle client libraries (OCI/PRO*C and

Product Dependencies

JAVA Developer Kit
(JDK)

transactional), the Oracle 7.3 RDBMS client libraries must be used. With these
libraries, the cartridge can connect to supported versions of either Oracle 7.x or
Oracle 8.0.x databases.

If you want to use Oracle Web Application Server with an Oracle database, you
are required to install other products. The following table lists the required

1.0.2

2-2 Oracle Web Application Server™ Installation Guide

Oracle products and minimum release levels for using the Web Application
Server with an Oracle database.

Products Minimum Release

Oracle Server 7.1.6
PL/SQL 2.1.6
SQL*Net 2.1.6
TCP/IP Protocol Adaptor 2.1.6

Note: The Oracle Server and PL/SQL are not installed automatically with Web

Application Server.

Remote Database Installation

If you wish to access an Oracle database on a remote machine, install the
products listed above on the remote machine.

On your local machine, you must also install SQL*Net and the TCP/IP Protocol
Adapter provided on the Web Application Server CD.

Local Database Installation

If you wish to install Oracle Web Application Server as a stand-alone Internet
server, and you want to access a database on your local machine, you need only
install an Oracle database and PL*SQL.

Note: If you wish to use either Oracle8 or the Multi-Threaded Server option to connect

to a local database, you must install SQL*Net 2.3 and the TCP/IP Protocol
Adaptor. These products are automatically installed with Oracle Web
Application Server 3.0.1.

Supported Configurations

Oracle Web Application Server can be installed as a single-node, where
everything is installed on a single computer; or as a multi-node, which consists
of a primary-node installed on one computer and multiple remote-nodes
installed on different computers.

Oracle Web Application Server is made up of several processes, and you can run
these processes on different machines on the network. You can do this because

Installation Requirements 2-3

Single-Node

Multi-Node Primary

the architecture of the Web Application Server is based on CORBA (common
object request broker architecture), which is a standard for distributed objects.

One advantage of distributing the processes on different machines is
performance and scalability. You can handle more requests without using up too
much resources from one machine.

See Appendix C, “Multi-node Configuration” on page 1 for additional
information.

The following are examples of typical Web Application Server installation
configuration choices:

This installation shows components installed on a single-node:

• WRB with Oracle Administrator Listener

• Listener (Oracle, Microsoft, or Netscape)

• Web Application Server cartridges (required)

• Additional cartridges (optional)

This installation shows components installed on the primary-node in a multi­node configuration.

• WRB with Oracle Administrator Listener

• Listener (Oracle, Microsoft, or Netscape)

• Web Application Server cartridges (required)

• Additional cartridges (optional)

Multi-Node Remote - Cartridge Only Installation

This installation shows an example of a remote-node in a multi-node
configuration.

• Web Application Server cartridges (required)

• Additional cartridges (optional)

2-4 Oracle Web Application Server™ Installation Guide