Previous | Table of Contents | Next

Page 438

After you've filled in the fields just listed, click the Submit New Service button to create the service. Next, you need to activate it. To activate your new service, go to the Oracle Web Application Server Administration form and click Configure for the Web Listener you want to associate with this agent. Choose Directory Mappings to create a virtual path. The service name should be the last part of the path. This virtual path is mapped to the OWS/bin directory.

Defining Configuration Parameters
for the Web Listener

Because the Web Listener plays such an important role in Web Application Server operations, you should understand the various configuration parameters that Web Listener needs. Table 18.5 explains each of these parameters.

Table 18.5 Web Listener Configuration Parameters
Parameter
Name
Default
Name
Description
UserDir none Directory within a user's home directory searched by the Web Listener when the URL
/~username/ is received. For UNIX plat-
forms, this allows users to store their own
home pages in their home directories.
InitialFile initial The Web Listener looks for this file when it encounters an URL ending in a directory rather than a file. This is the "index" file for the Web Listener.
UserDirInitialFile initial.html This parameter represents the default file name when the /~username/ construction is used in an URL with no file specified.
DefaultMIMEType application/
octet-stream
This parameter represents the default MIME type used by the Web Listener when the file name extension requested in an URL is not recognized.


Page 439

Table 18.5 Web Listener Configuration Parameters (Continued)
Parameter
Name
Default
Value
Description
DefaultCharset iso-8859-1 This parameter represents the default
character set if none is inferred from the file extension.
PreferredLanguage en (English) This parameter represents the language a
Web Listener prefers, given a choice of languages when searching for a file. Default is English (en).
ImageMap none This is the extension the Web Listener expects image maps to have. Oracle suggests this extension be set to "map."
ServiceTimeout none On Windows NT, the time the NT control panel waits for a start, stop, or continue to complete before failure. Not used on any
other platform.


Troubleshooting

Because Web Application Server 3.0 is pretty new to the market, you can expect to run into numerous problems. Other users have encountered several, and so have users on the Internet and at Oracle. The following paragraphs include information culled from personal experience, Oracle's online manual, and other sources on the Internet. The sources are cited after each troubleshooting item.

Problem

Getting unusual errors when running Web Application Server 3.0 on Sun Solaris 2.4 platform.

Solution

Install the Solaris Patch 101945-27.

Problem

Web Application Server Administrative Server is not running.

Solution

Make certain that $ORACLE_HOME/orainst/root.sh shell script has been run by the root user. You can use the $ORACLE_HOME/bin/wlctl utility as an alternative method for starting the Web Application Server Administrative Server. For example, if your Web Application Server Administrative Server is configured for port 8888, use the following startup command:

wlctl start 8888

Page 440

Problem

Web Application Server Listener is not starting.

Solution

Make certain that it was configured to listen on a different port from the Web Application Server Administrative Server.

Problem

You receive the error message OWS-05526: Service OWA_DEFAULT_SERVICE submission failed due to error 1034.

Solution

Start up the Oracle7x database before attempting to create a service.

Other Helpful Notes on Installation

Just when you were ready to turn on the television and unwind, you've got more things to learn. The following represents some helpful suggestions and warnings found on the Web. They deal with installing parts of the Oracle Web Application Server option. Note that the important Web Agent binary file is just for Solaris 2.4. If you don't have Solaris 2.4, you're at the mercy of Oracle for a future release. Nevertheless, you might find other components interesting to examine. Finally, Web Application Server provides a simplified, extremely basic default installation process that you might need to modify often. Check out the following suggestions:

     drop user www_dba cascade;
     create user www_dba identified by *****
     default tablespace users
     temporary tablespace temp
     quota 5M on users;
     grant select on v_$session to www_dba;
     grant select on dba_users to www_dba;
     grant select on dba_data_files to www_dba;
     grant select on dba_segments to www_dba;
     grant create any procedure to www_dba;

Page 441

The words that are boldfaced let you know that they are data definition language (DDL) keywords. Because of the nature of DDL statements, you want to be careful with permissions you grant to users. The www_user needs only the ability to grant sessions, create procedures, and create tables.

Attempting to Install Oracle Web Application Server
on Windows NT

As of this writing, Oracle's Web site states that there have been problems installing Web Application Server on Windows NT. This explains why you would find it so difficult to get the Web Application Server NT Option CD-ROM. However, at least one of my colleagues at Legacy Software in Dallas, Texas, was able to install Web Application Server on Windows NT.

Previous | Table of Contents | Next