Oracle8
ConText Cartridge Workbench User's Guide
Release 2.4 A63822-01 |
|
This appendix documents the various procedures for manually
configuring and deconfiguring Oracle WebServer 2.1 and Oracle Web Application
Server 3.0 for use with the ConText Viewer Cartridge.
Note: You only need to refer to this appendix if configuration of the Viewer Cartridge via the Oracle Installer failed. For more information, see "Configuring the Viewer Cartridge" in Chapter 3, "Document Viewing". |
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 Oracle WebServer 2.1 for use with the ConText
Viewer Cartridge 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 Viewer Cartridge.
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 Viewer Cartridge". |
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 Viewer Cartridge from WebServer.
See
Also:
For more information about deconfiguring WebServer 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
In the File Extension(s) column, enter:
ctxv
The Oracle Web Listener Administration page appears.
The OWL Administration - Server Advanced Configuration page appears.
The Oracle Web Listener Security page appears.
ctxquery
In the Password field, enter:
ctxquery
Scroll to the Basic Groups block of fields. In the Group Name column, enter:
ctxview_group
In the User(s) column, enter:
ctxquery
Scroll to the Basic Realms block of fields. In the Realms column, enter:
ctxview_realm
In the Group(s) column, enter:
ctxview_group
Scroll to the Protection block of fields. In the Virtual Path column, enter:
/ctxwview/
In the Basic/Digest column, select Basic.
In the Realm column, enter:
ctxview_realm
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
The WRB Cartridge Configuration Page appears.
CLASSPATH
If the WebServer platform is UNIX-based, in row 1, column 2, enter:
%ORACLE_HOME%/ows21/java/classes.zip:%ORACLE_HOME%/ows21/javaoracle.zip:%ORACLE_ HOME%/jdbc/lib/classes102.zip:%ORACLE_HOME%/ctxw/middlectxvcart/ctxvcart.zip
If the WebServer platform is NT, in row 1, column 2, enter:
%ORACLE_HOME%\ows21\java\classes.zip;%ORACLE_HOME%\ows21\java\oracle.zip;%ORACLE_ HOME%\jdbc\lib\classes102.zip;%ORACLE_HOME%\ctxw\middle\ctxvcart\ctxvcart.zip
In row 2, column 1, enter:
LD_LIBRARY_PATH
If the WebServer platform is UNIX-based, in row 2, column 2, enter:
%ORACLE_HOME%/ows21/bin:%ORACLE_HOME%/ows21/lib:%ORACLE_HOME%/ows21/java/lib:%ORACLE_HOME%/jdbc/lib
If the WebServer platform is NT, in row 2, column 2, enter:
%ORACLE_HOME%\ows21\bin
In row 3, column 1, enter:
JAVA_HOME
In row 3, column 2, enter the physical path:
%ORACLE_HOME%/ows21/java
Click the [Modify Cartridge Configuration] button.
The WRB Cartridge Configuration page reappears.
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 WebServer platform is UNIX-based, in the Object Path column, enter:
%ORACLE_HOME%/ows21/lib/libjava.so
If the WebServer platform is NT, in the Object Path column, enter:
%ORACLE_HOME%\ows21\bin\javai.dll
In the Entry Point column, enter:
ojsdinit
In the Min column, enter:
0
In the Max column, enter:
30
Scroll to the Applications and Directories block of fields. In the Virtual Path column, enter:
/ctxwview
In the App. column, enter:
CTXWVIEW
In the Physical Path column, enter:
%ORACLE_HOME%/ctxw/middle/ctxvcart/ctxvcart.zip
Scroll to the Protecting Applications block of fields. In the Virtual Path column, enter:
/ctxwview/
In the Basic/Digest column, select Basic.
In the Realm column, enter:
ctxview_realm
Click [Modify WRB Configuration].
The WRB Cartridge Administration page reappears.
The configuration of Oracle WebServer 2.1 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
WebServer for the Viewer Cartridge.
The following information is required before deconfiguration starts:
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 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
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/
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.
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/
Click [Modify WRB Configuration].
The WRB Cartridge Administration page reappears.
The deconfiguration of Oracle WebServer 2.1 for use with
the ConText Viewer Cartridge is now complete.
Configuration of Oracle Web Application Server 3.0 for use
with the ConText Viewer Cartridge 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 Viewer Cartridge.
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 Viewer Cartridge" 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 Viewer Cartridge from Web Application Server.
See
Also:
For more information about deconfiguring Web Application Server 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:
Note: Web Application Server must be restarted once configuration has completed. |
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
In the File Extension(s) column, enter:
ctxv
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
In the Password field, enter:
ctxquery
Scroll to the Basic Groups block of fields. In the Group Name column, enter:
ctxview_group
In the User(s) column, enter:
ctxquery
Scroll to the Basic Realms block of fields. In the Realms column, enter:
ctxview_realm
In the Group(s) column, enter:
ctxview_group
Scroll to the Protection block of fields. In the Virtual Path column, enter:
/ctxwview/
In the Basic/Digest column, select Basic.
In the Realm column, enter:
ctxview_realm
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 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 Web Application Server platform is UNIX-based, in the Object Path column, enter:
%ORAWEB_HOME%/lib/libjava.so
If the Web Application Server platform is Windows NT, in the Object Path column, enter:
%ORAWEB_HOME%\bin\javai.dll
In the Entry Point field, enter:
ojsdinit
In the Minimum # of Instances field, enter:
0
In the Maximum # of Instances field, enter:
100
In the Cartridge Description field, enter:
ConText Viewer Cartridge
In the Cartridge Icon field, enter:
/ows-img/32java.gif
In the Client Certificate field, select:
Disabled
In the Client Sessions field, select:
Disabled
In the Max session idle time field, select:
0
In the Error Page field, enter
%ORAWEB_HOME%/admdoc/wrberr.html
Scroll to the Virtual Paths block of fields. In the Virtual Path column, enter:
/ctxwview
In the Physical Path column, enter:
%ORACLE_HOME%/ctxw/middle/ctxvcart/ctxvcart.zip
Scroll to the Virtual Path Protection block of fields. In the Virtual Path column, enter:
/ctxwview/
In the Scheme field, select:
Basic
In the Realm field, enter:
ctxview_realm
Click [Register New Cartridge].
The Cartridge Administration page reappears.
This section describes how to create specific parameters used by the ConText Viewer Cartridge when processing requests.
The 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
If the Web Application Server platform is UNIX-based, in row 1, column 2, enter:
%ORAWEB_HOME%/java/classes.zip:%ORAWEB_HOME%/java/oracle.zip:%ORACLE_HOME%/jdbc/lib/classes102.zip:%ORACLE_ HOME%/ctxw/middle/ctxvcart/ctxvcart.zip
If the Web Application Server platform is NT, in row 1, column 2, enter:
%ORAWEB_HOME%\java\classes.zip:%ORAWEB_HOME%\java\oracle.zip:%ORACLE_HOME%\jdbc\lib\classes102.zip:%ORACLE_ HOME%\ctxw\middle\ctxvcart\ctxvcart.zip
In row 2, column 1, enter:
LD_LIBRARY_PATH
If the Web Application Server platform is UNIX-based, in row 2, column 2, enter:
%ORAWEB_HOME%/bin:%ORAWEB_HOME%/lib:%ORAWEB_HOME%/java/lib:%ORACLE_HOME%/jdbc/lib
If the Web Application Server platform is NT, in row 2, column 2, enter:
%ORAWEB_HOME%\bin
In row 3, column 1, enter:
JAVA_HOME
In row 3, column 2, enter the physical path:
%ORAWEB_HOME%/java
Click [Modify Cartridge Configuration].
The Cartridge Configuration page reappears.
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 Web Application Server Administration page appears.
The Authentication Configuration page appears.
The Basic Authentication page appears.
In the User Name column, enter:
ctxquery
In the Password column, enter:
ctxquery
Scroll to the Basic Groups block of fields. In the Group Name column, enter:
ctxview_group
In the User(s) column, enter:
ctxquery
Scroll to the Basic Realms block of fields. In the Realms column, enter:
ctxview_realm
In the Group(s) column, enter:
ctxview_group
The resulting page shows that the Basic Authentication was updated.
The configuration of Oracle Web Application Server 3.0 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.
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
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/
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 Web Application Server Administration page appears.
The Cartridge Administration Page appears.
The Delete Cartridge Configuration Page appears.
CTXWVIEW
The Confirm Cartridge Deletion page appears.
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 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/
Click [Modify WRB Configuration].
The WRB Cartridge Administration page reappears.
This section describes how to remove the ConText Viewer Cartridge configuration from the Authorization Server.
The 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
The resulting page shows that the Basic Authentication was
updated.
The 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.