Oracle8 ConText Cartridge Workbench User's Guide Release 2.3 A57700-01 |
|
This appendix documents the various procedures for configuring and deconfiguring Oracle WebServer 2.1 and Oracle Web Application Server 3.0 for use with the ConText Viewer Cartridge.
This appendix contains the following topics:
The section provides details for the notational conventions that apply to all of the 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 Oracle WebServer 2.1 for use with the Viewer Cartridge 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 Viewer Cartridge installation fails, manual configuration is necessary to set up Oracle WebServer 2.1 for use with ConText Viewer Cartridge.
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 Viewer Cartridge from Oracle WebServer 2.1.
See Also:
For more information about deconfiguring Oracle WebServer 2.1 to remove the Viewer Cartridge, see "Deconfiguring Oracle WebServer 2.1" in this chapter. |
The following information is required during configuration:
http://<hostname>:8888/ows-adoc/Intro.html
There are three major tasks in the configuration procedure:
This section describes how to configure a Web Listener for use with the Viewer Cartridge. A MIME type is mapped to a File Extension for use with the Viewer Cartridge. Security for the virtual directory is also configured.
Select the <Oracle Web Listener> link.
The Oracle Web Listener Administration page appears.
Select <CONFIGURE> for the listener used to access the Viewer Cartridge.
The OWL Administration - Server Advanced Configuration page appears.
Scroll down to the MIME Types block of fields to insert values into the first empty row.
In the Mime Type column, enter:
application/x-ctxv
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.
ctxquery
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 create the Web Request Broker cartridge configuration for the ConText Viewer Cartridge. The configuration provides the Viewer Cartridge with information it requires when processing requests.
The Web Request Broker Administration page appears.
The WRB Cartridge Administration Page appears.
CTXWVIEW
Click [Create Cartridge].
The WRB Cartridge Configuration Page appears.
CLASSPATH
%ORACLE_HOME%/ows21/java/classes.zip:%ORACLE_HOME%/ows21/javaoracle.zip:%ORACLE_HOME%/jdbc/lib/ classes102.zip:%ORACLE_HOME%/ctxw/middlectxvcart/ctxvcart.zip
%ORACLE_HOME%\ows21\java\classes.zip;%ORACLE_HOME%\ows21\java\oracle.zip;%ORACLE_HOME%\jdbc\lib\classes102.zi p;%ORACLE_HOME%\ctxw\middle\ctxvcart\ctxvcart.zip
%ORACLE_HOME%/ows21/bin:%ORACLE_HOME%/ows21/lib:%ORACLE_HOME%/ows21/java/lib:%ORACLE_HOME%/jdbc/lib
This section describes how to set up the ConText Viewer Cartridge so that the Web Request Broker knows how to invoke it. The physical cartridge is mapped to the virtual path of the Viewer Cartridge, and security for the Viewer Cartridge is configured.
The Web Request Broker Administration page appears.
The WRB Cartridge Administration Page appears.
In the App. column, enter:
CTXWVIEW
If the Oracle WebServer platform is UNIX, in the Object Path column, enter:
%ORACLE_HOME%/ows21/lib/libjava.so
If the Oracle WebServer platform is NT, in the Object Path column, enter:
%ORACLE_HOME%\ows21\bin\javai.dll
Scroll to the Applications and Directories block of fields. In the Virtual Path column, enter:
/ctxwview
Scroll to the Protecting Applications block of fields. In the Virtual Path column, enter:
/ctxwview/
The configuration of Oracle WebServer for use with the ConText Viewer Cartridge is now complete.
To use WebServer and the Viewer Cartridge, stop and restart the associated WebServer.
This section provides detailed instructions for deconfiguring Oracle WebServer 2.1 for the Viewer Cartridge.
The following information is required before deconfiguration starts:
There are three major tasks in the deconfiguration procedure:
This section describes how to remove the Viewer Cartridge configuration from the Web Listener used to access the Viewer Cartridge.
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 Mime Type column:
application/x-ctxv
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:
ctxquery
Scroll to the Basic Groups block of fields. Remove all values from the row that has the following value in the Group Name column:
ctxview_group
Scroll to the Basic Realms block of fields. Remove all values from the row that has the following value in the Realms column:
ctxview_realm
Scroll to the Protection block of fields. Remove all values from the row that has the following value in the Virtual Path column:
/ctxwview/
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 Web Request Broker cartridge configuration for the ConText Viewer Cartridge.
The Web Request Broker Administration page appears.
The WRB Cartridge Administration Page appears.
The Confirm Cartridge Deletion page appears.
Click [Confirm Delete].
The resulting page shows that the CTXWVIEW cartridge configuration has been deleted.
This section describes how to remove the ConText Viewer Cartridge configuration from the Web Request Broker of the Web Listener used to access the Viewer Cartridge.
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 App. column:
CTXWVIEW
Scroll to the Applications and Directories block of fields. Remove all values from the row that has the following value in the Virtual Path column:
/ctxwview
Scroll to the Protecting Applications block of fields. Remove all values from the row that has the following value in the Virtual Path column:
/ctxwview/
Configuration of Oracle Web Application Server 3.0 for use with the Viewer Cartridge 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 Viewer Cartridge installation fails, manual configuration is necessary to set up Web Application Server for use with the ConText Viewer Cartridge.
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 Viewer Cartridge from Oracle Web Application Server 3.0.
See Also:
For more information about deconfiguring Oracle WebServer 3.0 to remove the Viewer Cartridge, see "Deconfiguring Oracle Web Application Server 3.0" in this chapter. |
The following information is required during configuration:
http://<hostname>:8888/ows-adoc/Intro.html
There are four major tasks in the configuration procedure:
This section describes how to configure a Web Listener for use with the Viewer Cartridge. A MIME type is mapped to a File Extension for use with the Viewer Cartridge. 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 Mime Type column, enter:
application/x-ctxv
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:
ctxquery
Click [Modify Listener].
The Oracle Web Listener Security page reappears.
Scroll to the end of the page and click [Admin].
This section describes how to create a configuration for the ConText Viewer Cartridge. The configuration provides the Web Request Broker with information required to access the Viewer Cartridge; it also defines and protects the virtual path used to access the cartridge.
The Oracle Web Application Server Administration page appears.
The Cartridge Administration Page appears.
The New Cartridge Configuration Page appears.
The New Cartridge Configuration Page appears.
CTXWVIEW
If the Oracle Web Application Server platform is UNIX-based, in the Object Path column, enter:
%ORAWEB_HOME%/lib/libjava.so
If the Oracle Web Application Server platform is Windows NT, in the Object Path column, enter:
%ORAWEB_HOME%\bin\javai.dll
Scroll to the Virtual Path Protection block of fields. In the Virtual Path column, enter:
/ctxwview/
This section describes how to create specific parameters used by the ConText Viewer Cartridge when processing requests.
The Oracle Web Application Server Administration page appears.
The Cartridge Administration Page appears.
The CTXWVIEW Cartridge Configuration page appears.
Select the <CTXWVIEW Cartridge specific parameters> link.
The Cartridge Configuration Page appears.
CLASSPATH
%ORAWEB_HOME%/java/classes.zip:%ORAWEB_HOME%/java/oracle.zip:%ORACLE_HOME%/jdbc/lib/ classes102.zip:%ORACLE_HOME%/ctxw/middle/ctxvcart/ctxvcart.zip
%ORAWEB_HOME%\java\classes.zip:%ORAWEB_HOME%\java\oracle.zip:%ORACLE_HOME%\jdbc\lib\classes102.zip:%ORACLE_HO ME%\ctxw\middle\ctxvcart\ctxvcart.zip
%ORAWEB_HOME%/bin:%ORAWEB_HOME%/lib:%ORAWEB_HOME%/java/lib:%ORACLE_HOME%/jdbc/lib
This section describes how to configure the Authorization Server for use with ConText Viewer Cartridge. It provides authentication for Web Application Server cartridges to authenticate users before allowing them to use the cartridge.
The Oracle Web Application Server Administration page appears.
The Authentication Configuration page appears.
The Basic Authentication page appears.
In the User Name column, enter:
ctxquery
The configuration of Oracle Web Application Server for use with the ConText Viewer Cartridge is now complete. Scroll to the end of the page and click [Administration].
This section describes how to remove the ConText Virtual Cartridge configuration from the Web Listener used to access the Viewer Cartridge.
Oracle Web Application Server needs to be restarted after the deconfiguration has been completed.
The following information is required before deconfiguration starts:
There are four major tasks in the deconfiguration procedure:
This section describes how to remove the ConText Viewer Cartridge configuration from the Web Listener used to access the cartridge.
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 Mime Type column:
application/x-ctxv
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:
ctxquery
Scroll to the Basic Groups block of fields. Remove all values from the row that has the following value in the Group Name column:
ctxview_group
Scroll to the Basic Realms block of fields. Remove all values from the row that has the following value in the Realms column:
ctxview_realm
Scroll to the Protection block of fields. Remove all values from the row that has the following value in the Virtual Path column:
/ctxwview/
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 delete the Viewer Cartridge from the Web Request Broker.
The Oracle Web Application Server Administration page appears.
The Cartridge Administration Page appears.
The Delete Cartridge Configuration Page appears.
CTXWVIEW
Click [Delete].
The Confirm Cartridge Deletion page appears.
Click [Delete].
The resulting page shows that the CTXWVIEW cartridge configuration has been deleted.
This section describes how to remove the ConText Viewer Cartridge configuration from the Web Request Broker.
The Oracle Web Application Server Administration page appears.
The Cartridge Administration Page appears.
The Web Request Broker Administration page appears.
Remove all values from the rows that have the following value in the Virtual Path column:
/ctxwview/
This section describes how to remove the ConText Viewer Cartridge configuration from the Authorization Server.
The Oracle Web Application Server Administration page appears.
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:
ctxquery
Scroll to the Basic Groups block of fields. Remove all values from the row that has the following value in the Group Name column:
ctxview_group
Scroll to the Basic Realms block of fields. Remove all values from the row that has the following value in the Realms column:
ctxview_realm
Click [Modify].
The resulting page shows that the Basic Authentication was updated.
The Oracle Web Application Server Authentication Configuration reappears.
The deconfiguration of Oracle Web Application Server 3.0 for use with the ConText Viewer Cartridge is now complete.