Oracle8 ConText Cartridge Workbench User's Guide Release 2.3 A57700-01 |
|
This appendix documents the various manual procedures for installing the Configuration Manager packages, as well as configuring and deconfiguring Oracle WebServer 2.1 and Oracle Web Application Server 3.0 for use with the Configuration Manager.
The following topics are discussed in this chapter:
Installation of Configuration Manager is handled through prompts provided by the Oracle Installer during installation of the ConText Workbench; however, if the I/O utility (ctxio32), which is called by the Oracle Installer to create the database packages used by the Configuration Manager, fails to create the database packages, it may be necessary to manually install the database packages.
A SQL*Plus script is provided for this purpose. It is installed with the Configuration Manager. The script, and the packages it installs, only need to be installed if the normal installation procedure fails.
If the normal installation procedure fails, the location of the installed files depends on whether the installation was attempted against a Web Server running on the local machine or a remote machine.
If the installation was against a Web Server on the local machine, the files are located in the following directory:
%ORACLE_HOME%\ctxw\middle\cfgmgr\install
If the installation was against a Web Server on a remote machine, the files are located in the following directory:
$ORACLE_HOME\ctxw\middle\cfgmgr\remote\install
To install the packages, change directories to the directory in which the packages are installed and use the following command from the command-line prompt:
> plus33 ctxsys/ctxsys@connect_string @cfgpack
The section provides details for the notational conventions that apply to all of the configuration and deconfiguration procedures for Oracle WebServer 2.1/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 Oracle WebServer 2.1 for use with the Configuration Manager is normally performed through prompts provided by the Oracle Installer during installation of the ConText Workbench.
In the event that the WebServer configuration portion of the Configuration Manager installation fails, manual configuration is necessary to set up Oracle WebServer 2.1 for use with ConText Configuration Manager.
The manual configuration is carried out through a browser, such as Netscape Navigator or Microsoft Internet Explorer. The browser should have forms and frame capabilities.
Deconfiguration procedures can also be applied to remove the Configuration Manager from Oracle WebServer 2.1.
See Also:
For more information about deconfiguring Oracle WebServer 2.1 to remove the ConText 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:
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/
Click [Modify Listener].
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
Click [Modify Listener].
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 for use with the ConText Configuration Manager is now complete.
Before using the Configuration Manager, restart Oracle WebServer.
This section describes how to remove the Configuration Manager configurations from Oracle WebServer 2.1.
The following information is required during deconfiguration steps:
There are three major tasks in the deconfiguration procedure:
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/
Click [Modify Listener].
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/
Click [Modify Listener].
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 Configuration Manager is normally performed through prompts provided by the Oracle Installer during installation of the ConText Workbench.
In the event that the Web Application Server configuration portion of the Configuration Manager installation fails, manual configuration is necessary to set up Web Application Server for use with the ConText Configuration Manager.
The manual configuration is performed through a browser, such as Netscape Navigator or Microsoft Internet Explorer. The browser should have forms and frame capabilities.
Deconfiguration procedures can also be applied to remove the Configuration Manager from Oracle Web Application Server 3.0.
See Also:
For more information about deconfiguring Oracle WebServer 3.0 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:
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 Oracle 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 Oracle 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 Oracle 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/
Click [Modify Listener].
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
Click [Modify Listener].
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 Oracle 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 Oracle 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 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:
This section describes how to remove the Database Access Descriptor (DAD) called ctx_dba.
The Oracle 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 Oracle 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/
Click [Modify Listener].
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/
Click [Modify Listener].
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 Oracle 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