Oracle8
ConText Cartridge Workbench User's Guide
Release 2.4 A63822-01 |
|
This appendix documents the various manual procedures for
creating the Configuration Manager PL/SQL packages, as well as configuring
and deconfiguring Oracle WebServer 2.1 and Oracle Web Application Server
3.0 for use with the Configuration Manager.
Note: You only need to refer to this appendix if configuration of the Configuration Manager via the Oracle Installer failed. For more information, see "Configuring the Configuration Manager" in Chapter 2, "Administration Tools". |
The following topics are covered in this appendix:
The section provides details for the notational conventions
that apply to all of the manual configuration and deconfiguration procedures
for Oracle WebServer 2.1 and Oracle Web Application Server 3.0.
Buttons referenced appear within square brackets, with capitalization
the same as it appears in the browser.
For example: [Modify Listener]
Links appear within angle brackets.
For example: <Web Request Broker>
All paths mentioned in the configuration steps follow the
UNIX convention of directory names separated by forward slashes (i.e. '/').
If a path is a physical path (as opposed to a virtual path), and the platform
is Windows NT, instead of a UNIX-based platform), then use the backslash
character (i.e. '\') to separate directory names.
Configuration of the Configuration Manager, which includes
creation of PL/SQL packages used by the Configuration Manager, is normally
performed through a separate Oracle Installer session after installation
of the ConText Workbench.
If the I/O utility (ctxio32), which is called by the Oracle
Installer to create the PL/SQL packages, fails to create the packages,
you may need to manually create the packages.
A SQL script (CFGPACK.SQL) is provided for this purpose.
The script is installed during configuration of the Configuration Manager;
however, the script only needs to be run if the normal configuration procedure
fails.
The location of the script depends on whether the installation
was attempted against WebServer (or Web Application Server) installed on
the current (i.e. local) machine or a remote machine.
If the configuration was attempted against WebServer (or Web Application Server) installed on the current machine, the files are located in the following directory:
%ORACLE_HOME%\ctxw\middle\cfgmgr\install
If the configuration was attempted against WebServer (or Web Application Server) installed on a remote machine, the files are located in the following directory:
$ORACLE_HOME\ctxw\middle\cfgmgr\remote\install
To create the packages, change directories to the directory in which the packages are installed and use the following command from the command-line prompt:
> plus80 ctxsys/passwd@connect_string @cfgpack
Configuration of Oracle WebServer 2.1 for use with the ConText
Configuration Manager is normally performed through a separate Oracle Installer
session after installation of the ConText Workbench.
In the event that the WebServer portion of the configuration
fails, manual configuration is necessary to set up WebServer for use with
the Configuration Manager.
Note: These manual procedures are different from those that apply for Oracle Web Application Server 3.0. If Web Application Server is installed, see "Configuring Oracle Web Application Server 3.0 for the Configuration Manager" in this chapter. |
Manual configuration is performed through a browser, such
as Netscape Navigator or Microsoft Internet Explorer. The browser should
support forms and frame capabilities.
Deconfiguration procedures can also be applied to remove
the Configuration Manager from WebServer.
See
Also:
For more information about deconfiguring WebServer to remove the Configuration Manager, see "Deconfiguring Oracle WebServer 2.1" in this chapter. |
The following information is required during configuration steps:
http://<hostname>:8888/ows-adoc/Intro.html
There are three major tasks in the configuration procedure:
Note: WebServer must be restarted once configuration has completed. |
This section describes the creation of a new Database Connection Descriptor (DCD) which provides PL/SQL Agent with the required information when connecting to a database. It also installs the WebServer Developer's Toolkit packages to the database. The DCD is used by the ConText Configuration Manager to process administration requests from a browser.
The PL/SQL Agent Administration page appears.
The PL/SQL Agent Administration - Create New DCD page appears.
ctx_dba
Click the Identified by Password radio button.
In the PL/SQL Agent User Password and Confirm Password fields,
enter the password of the CTXSYS user.
If the database on which ConText is installed is a local
database, enter the ORACLE_SID in the ORACLE_SID field; otherwise, enter
a connect string in the SQL*Net V2 Service field.
In the Authorized Ports field, enter the port number of
the listener. This port number is used to access the Configuration Manager.
Select the Install WebServer Developer's Toolkit PL/SQL
Packages checkbox.
In the DBA Username field, enter:
CTXSYS
In the Password field, enter the password of the CTXSYS
user.
Click the [Submit New Service] button.
The resulting page shows that the DCD has been created. This page may take some time to appear since packages are installed in the database.
This section describes how to configure a Web Listener for use with the Configuration Manager. A physical file-system directory is mapped to a virtual directory to specify a root directory for the Configuration Manager. Security for the virtual directory is also configured.
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
In the File-System Directory column, enter the physical path:
%ORACLE_HOME%/ctxw/middle/cfgmgr/
In the Virtual Directory column, enter:
/ctxw_cm/
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
The Oracle Web Listener Security page appears.
In the User Name column of a blank row, enter:
ctxsys
In the Password field, enter the CTXSYS password, scroll
to the Basic Groups block of fields.
In the Group Name column, enter:
ctxdba_group
In the User(s) column, enter:
ctxsys
Scroll to the Basic Realms block of fields. In the Realms column, enter:
ctxdba_realm
In the Group(s) column, enter:
ctxdba_group
Scroll to the Protection block of fields. In the Virtual Path column, enter:
/ctx_dba/owa/
In the Basic/Digest column, select Basic.
In the Realm column, enter:
ctxdba_realm
The Oracle Web Listener Security page reappears.
Scroll to the end of the page and click [Administration].
This section describes how to configure the Web Request Broker for a particular Web Listener for use with the Configuration Manager. The PL/SQL Agent is mapped to the virtual path of the Configuration Manager, and security for the PL/SQL Agent is configured.
The Web Request Broker Administration page appears.
The WRB Cartridge Administration Page appears.
In the Virtual Path column, enter:
/ctx_dba/owa
Scroll to the Protecting Applications block of fields. In the Virtual Path column, enter:
/ctx_dba/owa/
The configuration of Oracle WebServer 2.1 for use with the
ConText Configuration Manager is now complete.
Before using the Configuration Manager, restart WebServer.
This section describes how to remove the Configuration Manager
from Oracle WebServer 2.1.
The following information is required during deconfiguration steps:
http://<hostname>:8888/ows-adoc/Intro.html
There are three major tasks in the deconfiguration procedure:
Note: WebServer must be restarted once deconfiguration has completed. |
This section describes how to remove the Database Connection Descriptor (DCD) called CTX_DBA. It does not remove packages from the database account associated with the DCD.
The PL/SQL Agent Administration page appears.
The Modify DCD (Database Connection Descriptor) page appears.
The Delete DCD (Database Connection Descriptor) page appears.
The resulting page shows that the CTX_DBA DCD has been deleted.
This section describes how to remove the ConText Configuration Manager configuration from the Web Listener used to access the Configuration Manager.
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
Remove all values from the row that has the following value in the File-System Directory column:
%ORACLE_HOME%/ctxw/middle/cfgmgr/
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
The Oracle Web Listener Security page appears.
Remove all values from the row that has the following value in the User Name column:
ctxsys
Scroll to the Basic Groups block of fields.
Remove all values from the row that has the following value in the Group Name column:
ctxdba_group
Scroll to the Basic Realms block of fields.
Remove all values from the row that has the following value in the Realms column:
ctxdba_realm
Scroll to the Protection block of fields.
Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa/
The Oracle Web Listener Security page reappears.
Scroll to the end of the page and click [Administration].
This section describes how to remove the ConText Configuration Manager configuration from the Web Request Broker of the particular Web Listener used to access the Configuration Manager.
The Web Request Broker Administration page appears.
The WRB Cartridge Administration Page appears.
Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa
Scroll to the Protecting Applications block of fields. Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa/
The deconfiguration of Oracle WebServer 2.1 for use with
the ConText Configuration Manager is now complete.
Configuration of Oracle Web Application Server 3.0 for use
with the ConText Configuration Manager is normally performed through a
separate Oracle Installer session after installation of the ConText Workbench.
In the event that the Web Application Server portion of the
configuration fails, manual configuration is necessary to set up Web Application
Server for use with the Configuration Manager.
Note: These manual procedures are different from those that apply for Oracle WebServer 2.1. If WebServer is installed, see "Configuring Oracle WebServer 2.1 for the Configuration Manager" in this chapter. |
Manual configuration is performed through a browser, such
as Netscape Navigator or Microsoft Internet Explorer. The browser should
support forms and frame capabilities.
Deconfiguration procedures can also be applied to remove
the Configuration Manager from WebServer.
See
Also:
For more information about deconfiguring Web Application Server to remove the Configuration Manager, see "Deconfiguring Oracle Web Application Server 3.0" in this chapter. |
The following information is required during configuration steps:
http://<hostname>:8888/ows-adoc/Intro.html
There are five major tasks in the configuration procedure:
Note: Web Application Server must be restarted once configuration has completed. |
This section describes the creation of a new Database Access Descriptor (DAD) which provides the PL/SQL Agent with information used when connecting to a database. The DAD is used by the Configuration Manager to process administration requests from a browser.
The Web Application Server Administration page appears.
Select the <DAD Administration> link.
The Database Access Descriptor Administration page appears.
The Database Access Descriptor Creation page appears.
ctx_dba
Click the Identified by Password radio button.
In the Database User Password and Confirm Password fields,
enter the password of the CTXSYS user.
If the database on which ConText is installed is a local
database, enter the ORACLE_SID in the ORACLE_SID field; otherwise, enter
a connect string in the SQL*Net V2 Service field.
Click the Store The User Name And Password in the DAD checkbox.
In the DBA Username field, enter:
CTXSYS
In the Password field, enter the password of the CTXSYS
user.
Click the [Submit New Service] button.
The resulting page shows that the DAD was created.
This section describes the creation of a new PL/SQL Agent configuration for use with the Configuration Manager. It also installs the Web Application Server Developer's Toolkit packages to the database.
The Web Application Server Administration page appears.
The Cartridge Administration page appears.
The PL/SQL Agent Administration page appears.
The PL/SQL Agent Administration Service Creation page appears.
ctx_dba
In the Authorized Ports field, enter the port number of
the listener used to access the Configuration Manager.
In the DAD Username field, enter:
CTXSYS
In the DAD Password field, enter the password of the CTXSYS
user.
Select the Install Web Application Server Developer's Toolkit
PL/SQL Packages checkbox.
If the database is remote to the Web Application Server
host OR if the database is local and admin listener owner is NOT a DBA
then:
Enter the CTXSYS and password in the DBA Username and Password
fields.
Click the [Submit New Agent] button.
The resulting page shows that the PL/SQL Agent was created. This may take time as packages are installed in the database.
This section describes how to configure a Web Listener for use with the Configuration Manager. A physical filesystem directory is mapped to a virtual directory to specify a root directory for the Configuration Manager. Security for the virtual directory is also configured.
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
In the File-System Directory column, enter the physical path (substitute real value of the Oracle home directory):
%ORACLE_HOME%/ctxw/middle/cfgmgr/
In the Virtual Directory column, enter:
/ctxw_cm/
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
The Oracle Web Listener Security page appears.
In the User Name column of a blank row, enter:
ctxsys
In the Password field, enter the CTXSYS password.
Scroll to the Basic Groups block of fields. In the Group Name column, enter:
ctxdba_group
In the User(s) column, enter:
ctxsys
Scroll to the Basic Realms block of fields. In the Realms column, enter:
ctxdba_realm
In the Group(s) column, enter:
ctxdba_group
Scroll to the Protection block of fields. In the Virtual Path column, enter:
/ctx_dba/owa/
In the Basic/Digest column, select Basic.
In the Realm column, enter:
ctxdba_realm
The Oracle Web Listener Security page reappears.
Scroll to the end of the page and click [Administration].
This section describes how to configure the Web Request Broker for a particular Web Listener for use with the Configuration Manager. The PL/SQL Agent is mapped to the virtual path of the Configuration Manager, and security for the PL/SQL Agent is configured.
The Web Application Server Administration page appears.
The Cartridge Administration Page appears.
Select the <Cartridge Summary (Web Request Broker)> link.
The Web Request Broker Administration page appears.
In the Virtual Path column, enter:
/ctx_dba/owa
Scroll to the Protecting Applications block of fields. In the Virtual Path column, enter:
/ctx_dba/owa/
Click the [Modify WRB Configuration] button.
The resulting page shows that the update of Web Request Broker was successful.
This section describes how to configure the Authorization Server for use with the Configuration Manager. It provides authentication for Web Application Server cartridges to authenticate users before allowing them to use the Configuration Manager.
The Web Application Server Administration page appears.
Select the <Authorization Server> link.
The Authentication Configuration page appears.
The Basic Authentication page appears.
In the User Name column, enter:
ctxsys
In the Password column, enter the password of the CTXSYS
user.
Scroll to the Basic Groups block of fields. In the Group Name column, enter:
ctxdba_group
The configuration of Oracle Web Application Server 3.0 for
use with the Configuration Manager is now complete.
This section describes how to remove the Configuration Manager
configurations from Oracle Web Application Server 3.0.
The following information is required during deconfiguration steps:
http://<hostname>:8888/ows-adoc/Intro.html
There are five major tasks in the deconfiguration procedure:
Note: Web Application Server must be restarted once configuration has completed. |
This section describes how to remove the Database Access Descriptor (DAD) called ctx_dba.
The Web Application Server Administration page appears.
Select the <DAD Administration> link.
The Database Access Descriptor Administration page appears.
The Modify DAD (Database Access Descriptor) page appears.
The Delete DAD (Database Access Descriptor) page appears.
Click the [Confirm Delete] button.
The resulting page shows that the ctx_dba DAD was deleted.
This section describes how to delete the PL/SQL Cartridge Agent used by the Configuration Manager.
The Web Application Server Administration page appears.
The Cartridge Administration page appears.
The PL/SQL Agent Administration page appears.
The PL/SQL Agent Administration Service Creation page appears.
The Modify PL/SQL Cartridge Agent (PLSQL) page appears.
The Delete PL/SQL Agent (PLSQL) page appears.
The resulting page shows that the ctx_dba PL/SQL Agent has been deleted.
This section describes how to remove the ConText Configuration Manager configuration from the Web Listener used to access the Configuration Manager.
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
Remove all values from the row that has the following value in the File-System Directory column:
%ORACLE_HOME%/ctxw/middle/cfgmgr/
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
The Oracle Web Listener Security page appears.
Remove all values from the row that has the following value in the User Name column:
ctxsys
Scroll to the Basic Groups block of fields.
Remove all values from the row that has the following value in the Group Name column:
ctxdba_group
Scroll to the Basic Realms block of fields.
Remove all values from the row that has the following value in the Realms column:
ctxdba_realm
Scroll to the Protection block of fields.
Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa/
The Oracle Web Listener Security page reappears.
Scroll to the end of the page and click [Administration].
This section describes how to remove the ConText Configuration Manager configuration from the Web Request Broker.
The Cartridge Administration page appears.
The Web Request Broker Administration page appears.
Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa
Scroll to the Protecting Applications block of fields.
Remove all values from the row that has the following value in the Virtual Path column:
/ctx_dba/owa/
This section describes how to remove the Configuration Manager configuration from the Authorization Server.
The Web Application Server Administration page appears.
Select the <Authorization Server> link.
The Authentication Configuration page appears.
The Basic Authentication page appears.
Remove all values from the row that has the following value in the User Name column:
ctxsys
Scroll to the Basic Groups block of fields.
Remove all values from the row that has the following value in the Group Name column:
ctxdba_group
Scroll to the Basic Realms block of fields.
Remove all values from the row that has the following value in the Realms column:
ctxdba_realm
The deconfiguration of Oracle Web Application Server 3.0
for use with the ConText Configuration Manager is now complete.