Previous | Table of Contents | Next
Page 431
The following section provides an example of a Web Agent service entry in the
OWA.CFG file.
A description of each variable follows:
Developer's T#
(
owa_service = es
(
owa_user = www_samsona
)
(
owa_password = strong
)
(
oracle_home = /home/Oracle7x
)
(
oracle_sid = samsona22
)
(
owa_err_page = /samsona_err.html
)
(
owa_valid_ports = 8000 8888
)
(
owa_log_dir = /home/Oracle7x/ows/log
)
(
owa_nls_lang = AMERICAN_AMERICA.US7ASCII
)
)
Table 18.4 describes each item in the file. You need to specify values in these variables
after installation, but before running Web Server.
TIP
|
Never rely on Web Application Server default values. This is important because the default values
are not likely to be suited to your environment. For instance, your home directory most likely would be
/home/Oracle7x. Also, for security reasons, you'll use a different ID and password than the defaults.
|
Table 18.4O WA.CFG File Variables
Variable
|
Description
|
OWA_SERVICE
|
Name of the Web Agent service.
|
OWA_USER
|
Database username that the Web Agent uses to connect to
the database.
|
Continues
Page 432
Table 18.4 Continued
Variable
|
Description
|
OWA_PASSWORD
|
Database password that the Web Agent uses to connect to
the database.
|
ORACLE_HOME
|
The location of the Oracle7x code tree in the file system. This
should be the ORACLE_HOME for the database to which this Web
Agent service connects, unless the Web Agent service is set up to
connect to a remote database (over SQL*Net). In that case, specify
the ORACLE_HOME where the Web Agent is installed.
|
ORACLE_SID
|
Name of the database system ID to connect to. Does not apply
for connections to a remote database.
|
OWA_ERR_PAGE
|
HTML document returned by the Web Agent when an error
occurs in the PL/SQL procedure that the Web Agent invoked.
|
OWA_VALID_PORTS
|
The valid Web Listener network ports that the Web Agent
will service.
|
OWA_LOG_DIR
|
The directory to which the Web Agent writes its error file. The
name of the error file is SERVICE_NAME.ERR.
|
OWA_NLS_LANG
|
The NLS_LANG of the Oracle7x database to which the Web
Agent connects. If not specified, the Web Agent administration
program looks it up when Web Listener submits the service. To make
sure you've installed the correct version of Web Agent,
type $ORACLE_HOME/ows/bin/owa -v at the command line.
|
The Oracle Web Administrative Server is another Oracle Web Listener process that the
Oracle Web Application Server Administrator uses only for its own use. The Web
Administrative Server uses a separate Web Agent service for accessing the Oracle7x database. The name
of this service is the OWA_DBA service. Thus, in your configuration setup, remember that
the OWA_Default_Service is the default service that the Oracle Web Agent uses.
To install the Web Application Server option, follow these steps:
- Start the Oracle Installer.
- After you have answered initial questions about your database systempreferably
the Oracle7x databasechoose to install the Oracle Web Application Server option.
- Specify the hostname and network port for the Oracle Web Application Server
Administrative Server.
Page 433
- Specify the password for the Web Application Server Administrator account.
The username of the Web Application Server Administrator is admin.
- On UNIX systems, log in as root and run the
$ORACLE_HOME/orainst/root.sh shell script. This step is very important because it initializes and executes the Web
Application Server Administrative Server.
The following steps show you how to configure your Web Server. The steps also show how
to specify the host name, database name, and other vital pieces of information needed to
communicate with other servers, specifically database servers.
To configure your Web Server, follow these steps:
- Verify connectivity to the Oracle7x database, which is accessed by the Oracle
Web Listener. Note that, if the Oracle7x database is on a different node from the Oracle
Web Listener and the Oracle Web Agent, SQL*Net has to be installed and configured.
- Start any Web browser and specify the URL http://HOSTNAME:PORT/ows-abin/register to connect to the Oracle Web Application Server Administrative
Server. HOSTNAME is the name of the node where the Oracle Web Application
Server Administrative Server is running. PORT is the TCP/IP port used for connecting to
the Oracle Web Application Server Administrative Server.
- After supplying the username and password for the Web Application Server
Administrator, complete the Oracle Web Application Server Product Registration Form page
and click the Send Registration button. This takes you to the Web Application Server
Install Form.
- Choose to configure the OWA_DBA service and supply the following information:
- Username and password for the OWA_DBA Oracle Web Agent service
- ORACLE_HOME
- ORACLE_SID
- Port number of the Oracle Web Administrative Server
- SQL*Net v2 service for connecting to a remote Oracle database
- Existing DBA username and password
- Click the Create Service button. This creates the
OWA_DBA service. An entry for this service is written to
$ORACLE_HOME/ows/admin/owa.cfg on UNIX systems.
- Choose to configure the first Oracle Web Listener and enter the following information:
- Host name
- Port Number (note that this should be a different port from the one used by
the Oracle Web Administrative Server)
- UNIX user ID and password
Page 434
- Click the Create Listener button. Clicking this button starts the first Oracle
Web Listener. On UNIX systems, configuration information is written to
$ORACLE_HOME/ows/admin/svPORT.cfg, where PORT is the TCP/IP port number assigned to the Oracle
Web Listener.
- Choose to configure the OWA_DEFAULT_SERVICE and supply the information required
for configuring the OWA_DBA service. Remember that this is the service the Oracle
Web Listener will request for non-dba transactions.
- Click the Create Service button. Clicking this button creates the
OWA_DEFAULT_SERVICE service. An entry for this service is written to
$ORACLE_HOME/ows/admin/owa.cfg on UNIX systems.
Installing the Developer's Toolkit may not be a user-friendly process, but the steps
involved provide a good measure of security for your server. These steps ensure that only
authorized individuals are installing the toolkit. This also minimizes the risk of bringing down the
server. To install the toolkit, do the following:
- Connect to the Oracle Web Application Server Administrative Server and click the
Web Application Server Administration hyperlink. You find the
Web Application Server Administration hyperlink on the Oracle Web Application Server Products home page.
- Click the Oracle Web Agent link. You are prompted for the user name and password
of the Web Application Server administrator user. If you're not the administrator,
contact that person. This is important because there are settings in Web Application Server
that only the administrator knows.
- Select the service in which you installed the Developer's Toolkit.
- Scroll down to the button list. In this list, you see the following items:
- Create OWA database user
- Change OWA database user password
- Install Web Application Server Developer's Toolkit PL/SQL Package and choose
Install Web Application Server Developer's Toolkit PL/SQL Package.
- Click the Modify button.
Previous | Table of Contents | Next
|