Related Manuals for Oracle Oracle Web Application Server
Summary of Contents for Oracle Oracle Web Application Server
-
Page 1: Application Server
Oracle Web Application Server™ Installation Guide Release 3.0.1 for Windows NT Part No. A54857-03 Enabling the Information Age... - Page 2 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.
- Page 3 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,...
-
Page 5: Table Of Contents
Installing over an Existing Web Application Server ....3-9 Uninstalling Oracle Web Application Server ......3-11 Chapter 4 Post-Installation and Administration . - Page 6 Migrating to Oracle Web Listener ........6-1...
-
Page 7: Preface
Preface This Installation Guide is the primary source of introduction, installation, and configuration information for Oracle Web Application Server for Windows NT. Audience This Installation Guide is necessary for installing, configuring, or administering Oracle Web Application Server 3.0.1 for Windows NT. - Page 8 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.
- Page 9 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 Indicates command names, SQL reserved words and plain keywords as in ALTER DATABASE.
- Page 10 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: Oracle Web Application Server™ Installation Guide...
- Page 11 Web Application Server Documentation Manager Oracle Corporation 500 Oracle Parkway Redwood Shores, CA 94065 Preface...
- Page 12 Oracle Web Application Server™ Installation Guide...
-
Page 13: Introduction
Internet. 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. - Page 14 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.
-
Page 15: Supported Features
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. - Page 16 Fully portable WRB API • CORBA-compliant ORB-based Web Request Broker • unifying API for Netscape, Microsoft, and Oracle HTTP servers Java Cartridge • native Java environment • auto-generated wrapper classes for PL/SQL • native access to Oracle • HTML presentation classes •...
- Page 17 VRML Cartridge • 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 •...
-
Page 18: Oracle Web Application Server 3.0.1 - Advanced Edition
• 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 •... -
Page 19: Products Available For Installation
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 •... - Page 20 Oracle Web Application Server™ Installation Guide...
-
Page 21: Installation Requirements
C H A P T E R Installation Requirements System Requirements Hardware Requirements Hardware Item Required 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... - Page 22 Oracle 7.x or Oracle 8.0.x databases. Product Dependencies 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 Oracle Web Application Server™ Installation Guide...
-
Page 23: Supported Configurations
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. - Page 24 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) Oracle Web Application Server™ Installation Guide...
- Page 25 Multi-Node Remote - Listener Only Installation This installation shows an example of a remote-node in a multi-node configuration. • Listener (Oracle, Microsoft, or Netscape) Multi-Node Remote - Cartridge and Listener Installation This installation shows an example of a remote-node in a multi-node configuration.
- Page 26 Oracle Web Application Server™ Installation Guide...
-
Page 27: Installation Procedure
You may also use the Installer to configure third-party Web servers for use with Oracle Web Application Server. See the chapters on configuring third-party servers and migrating to the Oracle Web Listener for more information on using third-party servers. Note to Oracle8 Users: You must follow the pre-installation steps described in the section “Special... -
Page 28: Pre-Installation Information
Special Oracle8 User Information An Oracle8 database and Oracle Web Application Server can be installed on the same machine or different machines. However, doing so requires special considerations, which are outlined in the following steps: 1. - Page 29 If during installation “Remote Oracle RDBMS Connection” was not selected, then make sure that SQL*Net V2.3 on the Oracle Web Application Server CD is installed. Use the SQL*Net Easy Configuration tool to create a database alias for the database instance.
-
Page 30: First-Time Web Application Server Installation
User Password - The password you will use for the node. Web Listener Settings The following information is needed for the general usage Web listener. You may use the Oracle listener or a third-party HTTP listener such as Netscape FastTrack or Microsoft IIS. •... - Page 31 Install a Multi-Node Install a Single Node Select a single-node installation if you want to complete a full Oracle Web Application Server installation on a single machine. If you choose a single-node installation, the Web Request Broker (WRB), Web Listener, and cartridges are installed on the same machine.
- Page 32 If you are performing a multi-node installation, you will need to repeat the installation procedure for each node. That is, you can only install one node with each pass through the Oracle Installer. Each pass must be run on the individual node.
- Page 33 Oracle8 installation is local or remote. Site Installation Enter the following information about the installation site. Site Name - Defaults to “WEBSITE30”. Oracle Web Application Server allows you to have multiple server sites running in a single installation environment. Servers are differentiated by site names, so you must enter the current Web server site name.
- Page 34 Netscape Enterprise Server If you use a third-party server from Microsoft or Netscape, you may chose to configure it during installation. If you wish to use the Oracle Listener included with Web Application Server, select the choice “Oracle Web Application Server 3.0.1 Listener”.
-
Page 35: Installing Over An Existing Web Application Server
Note: Oracle Named Pipes Adapter, Oracle SPX Adapter, and Oracle DECNet Adapter are available, but are not supported for use with Oracle Web Application Server Release 3.0.1. Note: For first-time installations, you must restart your machine for the PATH settings to take effect. - Page 36 You may choose any number of the following components: Oracle Installer Oracle Web Listener - You will be given the opportunity to re- configure this Listener to run Microsoft or Netscape HTTP server in a later dialog in this install.
-
Page 37: Uninstalling Oracle Web Application Server
Once all services have been terminated, shutdown the Web Request Broker (WRB) services. owsctl stop wrb If you are running Microsoft Internet Information Server (IIS) configured with the Oracle WRB, use the regedt32 to delete the following entries from the NT Registry: Under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Service s\W3SVC\Parameters remove ndwfis30.dll reference in the... - Page 38 The right side of the window displays products installed on your system. Select the products you wish to remove. Use Shift + click, or click and drag to select multiple items. Click Remove. The Installer will remove the selected products from your system. 3-12 Oracle Web Application Server™ Installation Guide...
-
Page 39: Post-Installation And Administration
C H A P T E R Post-Installation and Administration Starting Web Application Server Start the Web Request Broker (WRB) and the Administration Listener by using the owsctl command. At the DOS prompt, type: owsctl start wrb This starts the WRB. To start the Administration Listener, type the following at the DOS prompt: owsctl start admin To start your listener, type the following at the DOS prompt:... -
Page 40: Listeners
• Port Number: 8888 • Username: admin Default Web Listener One general usage web listener is created by the install. This can be the Oracle listener or a third-party HTTP listener. • Web Listener Name: www • Port Number: 80... -
Page 41: Web-Based Administration
Use your Web browser to navigate to the Web Application Server Administrator Welcome Page at: http://<localhost:port> / where localhost is the hostname of the machine on which Oracle Web Application Server is installed, and port is the port number you have assigned to the administration web listener (8888 by default) A dialog box appears, requesting you to authenticate. -
Page 42: Setting Up A Secure Oracle Web Application Server
Dispatcher (which runs on the primary node), telling it about new cartridge instances that are started up and about unoccupied cartridge instances. The Dispatcher then knows where to direct requests. Setting Up a Secure Oracle Web Application Server Refer to the Web Application Server Manager page at: http://localhost:port/ows-adoc/Intro.html for instructions on generating a certificate request and obtaining a certificate from the certifying authority (CA). -
Page 43: Configuration Of Third-Party Http Servers
HTTP Servers Overview A feature of Oracle Web Application Server Version 3.0.1 is the HTTP daemon adapter which enables the Web Request Broker (WRB) to run seamlessly using third-party HTTP servers (listeners) instead of the Oracle Web Listener shipped with Oracle Web Application Server. - Page 44 OBJ.CONF file. Configuring Using the Oracle Migration Utility For the Netscape server you want to run with Oracle Web Request Broker: 1. Register the Netscape server with the Oracle Web Application Server Manager by using the External Listener Registration utility. The Web Application Server Manager is located at: http://localhost:port/ows-adoc/Intro.html...
- Page 45 %NS_HOME%/httpd-server/config (FastTrack Server), or %NS_HOME%/https-server/config (Enterprise) • The migration tool links these files with Oracle WRB and saves the original files into filename.sav. The init function causes the Netscape server to load the WRB modules and adds to the obj.conf and magnus.conf files as follows.
-
Page 46: Microsoft Internet Information Server
If FastTrack/Enterprise 2.1 is chosen, ndwfns201.dll and ndwfn201.dll are used. The default text/plain type is CMT Commented out (with ##) in the default object section because it does not interpret the output of Oracle Web Application Server Java and WRB samples as HTML: ##ObjectType fn=force-type type=text/plain Microsoft Internet Information Server For this release you must use the Oracle Installer to migrate Microsoft IIS. - Page 47 (default is 8888). Confirm that the following files exist: • %ORAWEB_HOME%\BIN\NDWFIS30.DLL • %ORAWEB_HOME%\ADMIN\ADPIIS.CFG If not, there was a problem with the installation. Try re-installing Oracle Web Application Server. Restart Microsoft IIS. Configuration of Third-party HTTP Servers...
- Page 48 Oracle Web Application Server™ Installation Guide...
-
Page 49: Migrating To Oracle Web Listener
Web Application Server. • If you want the port number to be re-used by the migrated Oracle Web Application Server make sure the Netscape server is stopped. Note: Only the first six characters of the Netscape server name are used as the migrated Oracle Web Application Server listener name. -
Page 50: Introduction
Introduction During Migration of the Netscape server to Oracle Web Application Server, the Netscape configuration files obj.conf, magnus.conf, and mime.types are read and parsed, then translated into the Oracle Web Application Server listener and WRB configuration files such as svserver.cfg and svserver.app. However, some of the Netscape server features are not converted to the Oracle Web Application Server listener. -
Page 51: Migrating A Netscape Server To Oracle Web Application Server
“ok to migrate” to migrate the Netscape server to the Oracle server. You must use the Oracle Manager to start up the newly migrated server, after which you can access your pages as usual. You can access the Oracle Web Application Server page from: http://hostname.domain:port/oracle... - Page 52 • reads and parses the Netscape obj.conf, magnus.conf, and mime.types files and translates the migratable items into the Oracle Web Application Server configuration • writes the translated configuration and the default Oracle Web Application Server configuration to the Oracle Web Listener svserver.cfg file •...
- Page 53 [MIMETypes] application/octet-stream bin exe [Encoding] x-gzip gz gzip Note: Oracle Web Application Server only allows extensions with less than five characters. Any extensions with more than four characters are not migrated and are reported after the migration is complete. •...
- Page 54 [Server] UserDir = public_html Note: Oracle Web Application Server allows only one directory to be specified in the Userdir parameter, while Netscape allows multiple directories to be specified in a comma-separated list. Only the first directory specified in the list is used by Oracle Web Application Server.
-
Page 55: Access Control And Server Side Includes (Parse-Html)
[Server] InitialFile = index.html Note: Oracle Web Application Server only allows one file to be specified in the InitialFile parameter, while Netscape allows multiple files to be specified in a comma-separated list. Only the first file specified in the list is used by Oracle Web Application Server. - Page 56 /d1/ows21/docs/sstest.html does allow exec on the server machine. Oracle Web Application Server only allows the SSI processing of the files under the directory specified in wrb.app [AppDirs] section with use of SSI. For example, in wrb.app:...
- Page 57 SSI files into the Oracle Application Server’s virtual directory to be processed with SSI. The SSI parameters ParseHTMLExtn, EnableExecTag, and ExtensionList can be configured as the user requires. The wlmigrat tool lists all files and directories with the parse-html option set to on at the end of migration.
- Page 58 6-10 Oracle Web Application Server™ Installation Guide...
-
Page 59: Upgrading From Previous Releases
WebServer 2.x. Make sure you do not use the same listener name and DCD name as used in WebServer 2.x. Warning: Windows NT does not support multiple Oracle Homes. If you already have an existing Oracle Home, changing it during installation of Release 3.0.1 will disable the Oracle products currently installed on your machine. - Page 60 Upgrades the Oracle Web PL/SQL Agent DCD in WebServer 1.0 and 2.x, and registers them in Web Application Server 3.0.1. If you are still using Oracle Web PL/SQL Agent 1.0, you will not be able Warning: to access it after you upgrade. Refer to “Upgrade Oracle PL/SQL Agent 1.0”...
- Page 61 Upgrades the Oracle Web Application Server svserver.cfg file from Oracle 1.2 format to Oracle 2.1 format. • Continues to upgrade the next chosen Oracle Web Application Server 2.x to be upgraded. Determine a List of Registered WebServer 2.x Listeners The following sections describe the upgrade tool in detail. The upgrade tool examines the %ORACLE_HOME%/ows2/admin/owl.cfg file or...
- Page 62 These DCDs are not upgraded because they are created during installation. Upgrade and merge the entries into wrb.app. The entries are split into two entries that are DAD and PL/SQL descriptors. In Oracle WebServer 2.x owa.cfg, you will find an entry. For example: owa_service=DOHC_WEB owa_user=www_dba owa_password=manager...
- Page 63 In order to direct the PL/SQL to use the appropriate DAD, the owa_dad_name=xx parameter is added to the PL/SQL_xx section of the Web Application Server 3.0.1 wrb.app file. Upgrade the Oracle WebServer 2.x svserver_name.cfg The upgrade tool updates the svserver_name.cfg file in two steps. Upgrading from Previous Releases...
- Page 64 The upgrade tool will update the entry to: [DynApps] %ORAWEB_HOME%/lib/libwrl.so oracle_adp_init 2. The upgrade tool updates the svserver_name.cfg from Oracle 1.2 format to 2.1 format. Merge WebServer 2.x svserver_name.app into Web Application Server 3.0.1 wrb.app In Web Application Server 3.0.1 there is only one wrb.app file that stores the cartridge application related information, as opposed to one svserver.app per...
- Page 65 Web Application Server 3.0.1 wrb.app are already defined in WebServer 2.x svserver.app with different values. For example: In WebServer 2.x svserver.app: [Apps] MYAPP1 /private/oracle/ows21/myapp1/libmyapp1.so myapp1entry 0 100 [AppDirs] /usr/myapp1 MYAPP1 /private/oracle/ows21/myapp1 [MYAPP1] MyApp1Param1 = True MyApp1Param2 = False In Web Application Server 3.0.1, wrb.app:...
- Page 66 DCD ows1 information and executes the cgi-bin based PL/SQL agent owa. Then, owa executes the PL/SQL package hr.tree. To abandon the use of Oracle PL/SQL Agent 1.0, so you can use the new PL/ SQL cartridge, do the following: •...
-
Page 67: Appendix A Starting And Stopping The Listener
Listener owsctl Utility Commands The owsctl utility starts, stops, reloads, and displays the status of the Oracle Web Listener, Oracle Web Status Monitor, WRB, ORB and Cartridge processes. You can also use it to display the version number of the cartridge. - Page 68 Displays the status of the process specified by the next argument as follows: • If listener_name is supplied, it shows the current status of the named Oracle Web Listener. • If NCX or ncx is given, it shows the current status of the ORB process.
- Page 69 To use owsctl, you must have the following environment variables set: • ORAWEB_HOME - Absolute path where Oracle Web Application Server is installed. • ORAWEB_SITE - This is the site name for the Oracle Web Application Server. • ORACLE_HOME - ORACLE_HOME is the absolute path where you install Oracle products.
- Page 70 Start the cartridge process on the remote machine by entering: owsctl start cartridge Example 6: Starting the Oracle Web Logger Process (Optional) Start the Oracle Web Logger process on the primary machine by entering: owsctl start -p wrblog Example 7: Checking the Oracle Web Logger Status (Optional)
- Page 71 %ORAWEB_HOME%/bin/owstat.exe Notes: • Always use owsctl to start the WRB processes on the primary machine and then start the Oracle Web Listener. • If you want to distribute the cartridge over remote machines, use owsctl with the start CARTRIDGE option.
- Page 72 Oracle Web Application Server™ Installation Guide...
-
Page 73: Appendix B Multi-Node Configuration
APPENDIX Multi-node Configuration The Oracle Web Application Server is made up of several processes — most of which are defined as services on Windows NT. You can run these processes on different machines on the network. You can do this because the architecture of the Web Application Server is based on CORBA (common object request broker architecture), which is a standard for distributed objects. -
Page 74: Cartridge Instances On Each Node
The WRB tries to ensure that each cartridge factory allocates approximately the same number of cartridge instances for a particular cartridge type for each node. 5. Each cartridge factory spawns the appropriate number of cartridge Oracle Web Application Server™ Installation Guide... - Page 75 instances for its node. The cartridge instances are then registered with the Dispatcher, so that the Dispatcher can direct requests to them. When subsequent requests for the cartridge come in, the Dispatcher sends the requests to unoccupied cartridge instances. Instance 1 of Cartridge A Client Cartridge Listener...
-
Page 76: Distributing The Authentication Server Processes
Authentication Server to a less busy machine. • If you are using the Oracle database server to authenticate clients, you can improve performance if you move the Authentication Server to the same machine as the database. -
Page 77: Troubleshooting And Tips
• You have to use the same UDP port number on all nodes. This number is saved in the registry entry HKZY_LOCAL_MACHINE\Software\Oracle\Medianet\OMNADD • If you are using remote nodes to run the Java or the LiveHTML cartridges, you have to use the same definition of the ORACLE_HOME environment variable for all nodes. - Page 78 Index Administration Listener, default settings, 4-2 External Listener Registration utility, 5-2 Adobe Acrobat Reader, installation, viii hardware requirements, 2-1 cartridges Home Page, 4-3 remote installation, 3-6 running on remote nodes, B-1 certificate, requesting, 4-4 common gateway interface, 1-5 installation procedure, 3-4 configuration files Installer Netscape Server, 6-2...
- Page 79 A-3 migrating, 6-2 files, A-5 transaction support, 1-6 syntax, A-1 uninstallation procedure, 3-11 Perl Cartridge, 1-4 upgrading persistent storage, 1-7 Oracle PL/SQL Agent, 7-8 PL/SQL Cartridge, 1-4 port, default for administration listener, 4-3 Oracle Web Application Server™ Installation Guide Index-2...
- Page 80 VRML Cartridge, 1-5 Web Application Server starting, 4-1 Web Request Broker, 1-3 administration page location, 5-5 Web Request Broker (WRB), 3-6 remote installation, 3-6 WebServer 2.1 Home Page, 4-3 WebServer Manager, home page location, 5-2 Index-3 Oracle Web Application Server™ Installation Guide...