Oracle A54857-03 Manuel d'utilisateur Page 1

Enabling the Information AgeOracle WebApplication Server™Installation GuideRelease 3.0.1 for Windows NTPart No. A54857-03

x Oracle Web Application Server™ Installation GuideCustomer SupportOracle Worldwide Technical Support can be reached at the following number1-650-506-

Preface xiWeb Application Server Documentation ManagerOracle Corporation500 Oracle ParkwayRedwood Shores, CA 94065

xii Oracle Web Application Server™ Installation Guide

C H A P T E R1 IntroductionOverview of the ProductAs the World Wide Web matures, a new generation of Internet and Intranetbusiness applications is eme

1-2 Oracle Web Application Server™ Installation GuideOracle Web Application Server 3.0.1 operates across a wide range of operatingsystems, from PCs to

Introduction 1-3SecurityWith all the potential of real business applications, but no face-to-face contact,the Web presents new security challenges. Or

1-4 Oracle Web Application Server™ Installation GuideFully portable WRB API• CORBA-compliant ORB-based Web Request Broker• unifying API for Netscape,

Introduction 1-5VRML Cartridge• VRML 2.0 standard support• platform for building and deploying business applications in VRML• VRML Data Repository tha

1-6 Oracle Web Application Server™ Installation Guide• dedicated process per request• automatic cleanupMiscellaneous• native imagemap support• multipl

Introduction 1-7• transactional support across multiple cartridgesPersistent Storage Services• APIs for storing and retrieving content or managing con

Oracle Web Application Server™ Installation GuideRelease 3.0.1Copyright © Oracle Corporation 1996, 1997, 1998All rights reserved. Printed in the U.S.A

1-8 Oracle Web Application Server™ Installation Guide

C H A P T E R2 Installation RequirementsSystem RequirementsHardware RequirementsHardware Item RequiredCPU An Intel compatible 486 or higher processorM

2-2 Oracle Web Application Server™ Installation GuideSoftware Requirements*Note: For cartridges that link with the Oracle client libraries (OCI/PRO*C

Installation Requirements 2-3Oracle products and minimum release levels for using the Web ApplicationServer with an Oracle database.Note: The Oracle S

2-4 Oracle Web Application Server™ Installation Guidethe architecture of the Web Application Server is based on CORBA (commonobject request broker arc

Installation Requirements 2-5Multi-Node Remote - Listener Only InstallationThis installation shows an example of a remote-node in a multi-nodeconfigu

2-6 Oracle Web Application Server™ Installation Guide

C H A P T E R3 Installation ProcedureSupported Installation ActivitiesThe following installation activities are described in this chapter:• Pre-instal

3-2 Oracle Web Application Server™ Installation GuideInstalling a Primary Node in a Multi-node ConfigurationThe following activities are supported whe

Installation Procedure 3-32. Install Oracle Web Application Server. During installation, make sure thatyou check the “Remote Oracle RDBMS Connection (

Oracle Government Purchasing, Oracle Government Receivables, Oracle Government Revenue Accounting, Ora-cle Graphical Schema Editor, Oracle Graphics, O

3-4 Oracle Web Application Server™ Installation GuideAdministrator Listener SettingsThis information is required for a single node or primary node (in

Installation Procedure 3-5Then launch the SETUP.EXE program, which starts the Oracle Installer.2. Choose the language you want to use during installat

3-6 Oracle Web Application Server™ Installation GuideIf you install Oracle Application Server in a multi-node configuration, you mustinstall one prima

Installation Procedure 3-7• ODBC Cartridge• Oracle JDBC Drivers (Beta)• Remote Oracle RDBMS Connection (SQL*Net V 2.3)• VRML CartridgeNote: If you use

3-8 Oracle Web Application Server™ Installation GuideThe shared key can vary from 0 to 255 bytes. The string is made upof only hexadecimal characters;

Installation Procedure 3-9Note: The Microsoft Internet Information Server does not use a listener name.Port Number - Defaults to 80. Do not change thi

3-10 Oracle Web Application Server™ Installation Guideinformation. An upgrade copies library and message files onlybased on component choices and skip

Installation Procedure 3-11Uninstalling Oracle Web Application ServerTo uninstall the Oracle Web Application Server for Windows NT, follow thesesteps:

3-12 Oracle Web Application Server™ Installation GuideHome, the Software Asset Manager is displayed.Figure 3-1: Software Asset ManagerThe right side o

C H A P T E R4 Post-Installation andAdministrationStarting Web Application ServerStart the Web Request Broker (WRB) and the Administration Listener by

4-2 Oracle Web Application Server™ Installation GuideTo verify that a listener is running, at the DOS prompt, type:owsctl status <listener_name>

Post-Installation and Administration 4-3Web-based AdministrationUse the Oracle Web-based administration pages to configure and administerWeb Applicati

4-4 Oracle Web Application Server™ Installation Guide1. Add the remote node names to the wrb.app file on the primary node.a. In the primary node’s wrb

C H A P T E R5 Configuration of Third-party HTTP ServersOverviewA feature of Oracle Web Application Server Version 3.0.1 is the HTTP daemonadapter whi

5-2 Oracle Web Application Server™ Installation GuideOracle Installer automatically creates registry entries underHKZY_LOCAL_MACHINE\Software\Oracle w

Configuration of Third-party HTTP Servers 5-3owsctl start fnslTo stop the server:owsctl stopservernameTo check the status of the server:owsctl statuss

5-4 Oracle Web Application Server™ Installation GuideNameTrans fn=pfx2dir from=/tr-img \dir=”%ORAWEB_HOME%/demo/img” \NameTrans fn=pfx2dir from=/sampl

Configuration of Third-party HTTP Servers 5-5browsers that support NTLM (Microsoft Internet Explorer) can configurethe server.3. Enable anonymous acce

5-6 Oracle Web Application Server™ Installation Guide

C H A P T E R6 Migrating to Oracle WebListenerThis chapter describes how to migrate from a Netscape server to Oracle WebApplication Server.Requirement

ContentsPreface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiChapter 1 Int

6-2 Oracle Web Application Server™ Installation GuideIntroductionDuring Migration of the Netscape server to Oracle Web Application Server, theNetscape

Migrating to Oracle Web Listener 6-3determine if and how it should service the request. This file containsinformation like directory mappings and secu

6-4 Oracle Web Application Server™ Installation Guide• reads and parses the Netscape obj.conf, magnus.conf, and mime.typesfiles and translates the mig

Migrating to Oracle Web Listener 6-5Migrating the obj.conf and mime.types FilesTheobj.conffile defines how the server should handle the incoming reque

6-6 Oracle Web Application Server™ Installation Guide[DirMaps]/Netscape/cgibin/ CR /cgibin/• NameTrans fn=document-root root=/Netscape/docsThe value o

Migrating to Oracle Web Listener 6-7[Server]UseDirIndexing = true• PathCheck index-names=index.html,home.html fn=find-indexThe value of index-names= i

6-8 Oracle Web Application Server™ Installation GuideServer Side Includes (parse-html)On Netscape, the parse-html option means it will parse the HTML

Migrating to Oracle Web Listener 6-9parsed-html or SSI files into the Oracle Application Server’s virtual directory tobe processed with SSI. The SSI p

6-10 Oracle Web Application Server™ Installation Guide

C H A P T E R7 Upgrading from PreviousReleasesUpgrade from WebServer 2.x to Web Application Server 3.0.1To upgrade from WebServer 2.x to Web Applicati

vi Oracle Web Application Server™ Installation GuideWeb Application Server Control Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7-2 Oracle Web Application Server™ Installation Guide• %ORAWEB_HOME%/admdoc/OWS2xto30.html• %ORAWEB_HOME%/admbin/wlupgradeAccess the Upgrade PageMake

Upgrading from Previous Releases 7-3• If conflicts are found, it lists the conflicts and prompts you to ‘keep 2.xparameters’ or ‘use 3.0.1 parameters’

7-4 Oracle Web Application Server™ Installation GuideThere are two built-in DCDs, owa_dba and owa_default_service, in theowa.cfg. These DCDs are not u

Upgrading from Previous Releases 7-5username=www_dbapassword=manageroracle_home=private/home/wchan/work/ows-homeconnect_string=DOHCnls_lang=AMERICAN_A

7-6 Oracle Web Application Server™ Installation Guide1. The upgrade tool updates the [DynApps] section to Web ApplicationServer 3.0.1. In WebServer 2.

Upgrading from Previous Releases 7-7Conflicts occur when cartridges, application directory mapping, sectionparameters, and application protection defi

7-8 Oracle Web Application Server™ Installation Guideexample shown above, the cartridge MYAPP1 is in conflict, thus the definitionfor MYAPP1 in WebSer

APPENDIXA Starting and Stopping theListenerowsctl Utility CommandsTheowsctl utility starts, stops, reloads, and displays the status of the Oracle WebL

A-2 Oracle Web Application Server™ Installation Guide•Iflistener_name is supplied, it starts the named Oracle Web Listener.• If the Netscape server i

Starting and Stopping the Listener A-3• If CARTRIDGE or cartridge is supplied, it shows the current status ofcartridge processes, such as wrbfac.-eThi

PrefaceThis Installation Guide is the primary source of introduction, installation, andconfiguration information for Oracle Web Application Server for

A-4 Oracle Web Application Server™ Installation GuideThe following examples show how to run the processes:Example 1: Starting the WRB ProcessStart the

Starting and Stopping the Listener A-5owsctl start ncxExample 10: Starting the WRB Processes without the ORB processes:To exclusively start the WRB pr

A-6 Oracle Web Application Server™ Installation Guide

APPENDIXB Multi-node ConfigurationThe Oracle Web Application Server is made up of several processes — most ofwhich are defined as services on Windows

B-2 Oracle Web Application Server™ Installation GuideCartridge Instances on Each NodeThis section describes when cartridge instances are started up an

Multi-node Configuration B-3instances for its node.6. The cartridge instances are then registered with the Dispatcher, so that theDispatcher can direc

B-4 Oracle Web Application Server™ Installation GuideDistributing the Authentication Server ProcessesYou can run the Authentication Server on machines

Multi-node Configuration B-5To stop the processes for the Authentication Server:owsctl stop -p wrbasrvowsctl stop -p wrbahsrvTroubleshooting and TipsI

IndexAAdministration Listener, default settings, 4-2Adobe Acrobat Reader, installation, viiiCcartridgesremote installation, 3-6running on remote nodes

Oracle Web Application Server™ Installation Guide Index-2LListenerremote installation, 3-6LiveHTML Cartridge, 1-4local database installation, 2-3local

viii Oracle Web Application Server™ Installation GuideListener Administrator Home page, and follow the online documentation linkicon. The PDF document

Index-3 Oracle Web Application Server™ Installation GuideVVRML Cartridge, 1-5WWeb Application Serverstarting, 4-1Web Request Broker, 1-3administration

Preface ixConventions Used in This ManualThis table lists the typographical conventions used in this manual.Convention MeaningMonospace text Indicates