Previous | Table of Contents | Next

Page 431

Inside the OWA.CFG File

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.


Using the Web Administrative Server

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.

Installing the Oracle Web Application Server Option

To install the Web Application Server option, follow these steps:

  1. Start the Oracle Installer.
  2. After you have answered initial questions about your database system—preferably the Oracle7x database—choose to install the Oracle Web Application Server option.
  3. Specify the hostname and network port for the Oracle Web Application Server Administrative Server.

Page 433

  1. Specify the password for the Web Application Server Administrator account. The username of the Web Application Server Administrator is admin.
  2. 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.

Configuring Web 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:

  1. 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.
  2. 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.
  3. 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.
  4. Choose to configure the OWA_DBA service and supply the following information:
  5. 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.
  6. Choose to configure the first Oracle Web Listener and enter the following information:

Page 434

  1. 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.
  2. 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.
  3. 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 Web Application Server
Developer's Toolkit

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:

  1. 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.
  2. 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.
  3. Select the service in which you installed the Developer's Toolkit.
  4. Scroll down to the button list. In this list, you see the following items:
  5. Install Web Application Server Developer's Toolkit PL/SQL Package and choose Install Web Application Server Developer's Toolkit PL/SQL Package.
  6. Click the Modify button.

Previous | Table of Contents | Next