Oracle8 ConText Cartridge Workbench User's Guide Release 2.4 A63822-01 |
Library | Product | Contents | Index

# A
Viewer Cartridge: Manual Configuration

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:

- Notational Conventions for Configuration/Deconfiguration

- Configuring Oracle WebServer 2.1 for the Viewer Cartridge

- Deconfiguring Oracle WebServer 2.1

- Configuring Oracle Web Application Server 3.0 for the Viewer Cartridge

- Deconfiguring Oracle Web Application Server 3.0

## Notational Conventions for Configuration/Deconfiguration

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

Buttons referenced appear within square brackets, with capitalization the same as it appears in the browser.

For example: [Modify Listener]

#### Links

Links appear within angle brackets.

For example: <Web Request Broker>

#### Pathnames

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.

## Configuring Oracle WebServer 2.1 for the Viewer Cartridge

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.

### Configuration Requirements

The following information is required during configuration:

- the name of the machine on which WebServer is running

- the URL of the WebServer Administration Page; usually:

      http://<hostname>:8888/ows-adoc/Intro.html

- the name of the listener used to access the Viewer Cartridge

- the type of platform that WebServer is running on (UNIX-based or Windows NT)

- the Oracle home directory for the WebServer installation

  Note: In certain steps of the configuration process for WebServer, it is necessary to enter file system paths. Part of the path may be the Oracle home directory, which is represented in the configuration steps as %ORACLE_HOME%. The actual value of ORACLE_HOME should be used instead. The following example assumes an Oracle home directory of D:\ORANT on Windows NT. If the step asks you to enter the following value in a field: `%ORACLE_HOME%/ctxw/middle/ctxvcart/` then enter the value: `D:\ORANT\ctxw\middle\ctxvcart\`

### Configuration Tasks

There are three major tasks in the configuration procedure:

- Configuring Oracle Web Listener

- Creating the Web Request Broker Cartridge Configuration

- Configuring Oracle Web Request Broker

#### Configuring Oracle Web Listener

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.

1. Access the WebServer Administration page.

2. On the WebServer Administration page:

   Select the <Oracle Web Listener> link.

   The Oracle Web Listener Administration page appears.

3. On the Oracle Web Listener (OWL) Administration page:

   Select <CONFIGURE> for the listener used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

4. On the OWL Administration - Server Advanced Configuration page:

   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

   Click [Modify Listener].

   The Oracle Web Listener Administration page appears.

5. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

6. On the OWL Administration - Server Advanced Configuration page, select <Security: Access Control and Encryption>.

   The Oracle Web Listener Security page appears.

7. On the Oracle Web Listener Security page, scroll to the Basic Users block of fields. 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

   Click [Modify Listener].

   The Oracle Web Listener Security page reappears.

   Scroll to the end of the page and click [Administration].

#### Creating the Web Request Broker Cartridge Configuration

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.

1. Access the WebServer Administration page.

2. On the WebServer Administration page, select the <Web Request Broker> link.

   The Web Request Broker Administration page appears.

3. On the Web Request Broker Administration page, select <Modify> for the listener used to access the Viewer Cartridge.

   The WRB Cartridge Administration Page appears.

4. On the WRB Cartridge Administration Page:

5. In the Cartridges field, enter:

       CTXWVIEW

   Click [Create Cartridge].

   The WRB Cartridge Configuration Page appears.

6. On the WRB Cartridge Configuration Page, in row 1, column 1 of the Cartridge Parameters block of fields, enter:

       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.

#### Configuring Oracle Web Request Broker

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.

1. Access the WebServer Administration page.

2. On the WebServer Administration page, select the <Web Request Broker> link.

   The Web Request Broker Administration page appears.

3. On the Web Request Broker Administration page, select <Modify> for the listener used to access the Viewer Cartridge.

   The WRB Cartridge Administration Page appears.

4. On the WRB Cartridge Administration Page, scroll to the Application and Objects block of fields.

   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.

## Deconfiguring Oracle WebServer 2.1

This section provides detailed instructions for deconfiguring WebServer for the Viewer Cartridge.

### Deconfiguration Requirements

The following information is required before deconfiguration starts:

- the name of the listener configured to access the Viewer Cartridge

- the URL of the WebServer Manager Home Page

  Note: In certain steps of the deconfiguration process for WebServer, it is necessary to remove file system paths. A portion of the path may be the Oracle home directory, which is represented in the configuration steps as %ORACLE_HOME%. The actual value of ORACLE_HOME should be used instead. The following example assumes an Oracle home directory of D:\ORANT on Windows NT. If the step asks you to remove the following value from a field: `%ORACLE_HOME%/ctxw/middle/ctxvcart/` then remove the value: `D:\ORANT\ctxw\middle\ctxvcart\`

### Deconfiguration Tasks

There are three major tasks in the deconfiguration procedure:

- Deconfiguring Oracle Web Listener

- Deleting the Web Request Broker Cartridge Configuration

- Deconfiguring Oracle Web Request Broker

  Note: WebServer must be restarted once deconfiguration has completed.

#### Deconfiguring Oracle Web Listener

This section describes how to remove the Viewer Cartridge configuration from the Web Listener used to access the Viewer Cartridge.

1. Access the WebServer Administration page.

2. On the WebServer Administration page, select the <Oracle Web Listener> link.

   The Oracle Web Listener Administration page appears.

3. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener which is used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

4. On the OWL Administration - Server Advanced Configuration page, scroll down to the MIME Types block of fields.

   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.

5. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener which is used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

6. On the OWL Administration - Server Advanced Configuration page, select <Security: Access Control and Encryption>.

   The Oracle Web Listener Security page appears.

7. On the Oracle Web Listener Security page, scroll to the Basic Users block of fields.

   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].

#### Deleting the Web Request Broker Cartridge Configuration

This section describes how to remove the Web Request Broker cartridge configuration for the ConText Viewer Cartridge.

1. Access the WebServer Administration page.

2. On the WebServer Administration page, select the <Web Request Broker> link.

   The Web Request Broker Administration page appears.

3. On the Web Request Broker Administration page, select <Modify> for the listener which is used to access the Viewer Cartridge.

   The WRB Cartridge Administration Page appears.

4. On the WRB Cartridge Administration Page, in the Cartridges section, select <Delete> for the CTXWVIEW cartridge.

   The Confirm Cartridge Deletion page appears.

   Click [Confirm Delete].

   The resulting page shows that the CTXWVIEW cartridge configuration has been deleted.

#### Deconfiguring Oracle Web Request Broker

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.

1. Access the WebServer Administration page.

2. On the WebServer Administration page, select the <Web Request Broker> link.

   The Web Request Broker Administration page appears.

3. On the Web Request Broker Administration page, select <Modify> for the listener which is used to access the Viewer Cartridge.

   The WRB Cartridge Administration Page appears.

4. On the WRB Cartridge Administration Page, scroll to the Application and Objects block of fields.

   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.

## Configuring Oracle Web Application Server 3.0 for the Viewer Cartridge

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.

### Configuration Requirements

The following information is required during configuration:

- the name of the machine on which Web Application Server is running

- the URL of the Web Application Server Manager Home Page; usually:

      http://<hostname>:8888/ows-adoc/Intro.html

- the name of the listener used to access the Viewer Cartridge

- the type of platform that Web Application Server is running on (UNIX-based or Windows NT)

  Note: In certain steps of the configuration process for Web Application Server, it is necessary to enter file system paths. Part of the path may be the Oracle or Web Application Server home directory, which is represented in the configuration steps as either %ORACLE_HOME% or %ORAWEB_HOME%. Do not substitute the real values unless explicitly instructed to do so.

### Configuration Tasks

There are four major tasks in the configuration procedure:

- Configuring the Oracle Web Listener

- Creating the Web Request Broker Cartridge

- Configuring Viewer Cartridge Specific Parameters

- Configuring Authorization Server

  Note: Web Application Server must be restarted once configuration has completed.

#### Configuring the Oracle Web Listener

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.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Listener> link.

   The Oracle Web Listener Administration page appears.

3. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

4. On the OWL Administration - Server Advanced Configuration page, 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

   Click [Modify Listener].

   The Oracle Web Listener Administration page appears.

5. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

6. On the OWL Administration - Server Advanced Configuration page, select the <Security> link.

   The Oracle Web Listener Security page appears.

7. On the Oracle Web Listener Security page, scroll to the Basic Users block of fields.

   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

   Click [Modify Listener].

   The Oracle Web Listener Security page reappears.

   Scroll to the end of the page and click [Admin].

#### Creating the Web Request Broker Cartridge

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.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Cartridge Administration> link.

   The Cartridge Administration Page appears.

4. On the Cartridge Administration Page, select the <Add New Cartridge> link.

   The New Cartridge Configuration Page appears.

5. On the New Cartridge Configuration Page, select the <Add New Cartridge with Manual Configuration> link.

   The New Cartridge Configuration Page appears.

6. On the New Cartridge Configuration Page, in the Cartridge Name field, enter:

       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.

#### Configuring Viewer Cartridge Specific Parameters

This section describes how to create specific parameters used by the ConText Viewer Cartridge when processing requests.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Cartridge Administration> link.

   The Cartridge Administration Page appears.

4. On the Cartridge Administration Page, select the <ConText Viewer Cartridge> link.

   The CTXWVIEW Cartridge Configuration page appears.

   Select the <CTXWVIEW Cartridge specific parameters> link.

   The Cartridge Configuration Page appears.

5. On the Cartridge Configuration Page, in row 1, column 1 of the Cartridge Parameters block of fields, enter:

       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.

#### Configuring Authorization Server

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.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Authorization Server> link.

   The Authentication Configuration page appears.

4. On the Authentication Configuration page, select the <Basic> link.

   The Basic Authentication page appears.

5. On the Basic Authentication page, scroll to the Basic Users block of fields.

   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

   Click [Modify].

   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].

## Deconfiguring Oracle Web Application Server 3.0

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.

### Deconfiguration Requirements

The following information is required before deconfiguration starts:

- the name of the listener configured to access the Viewer Cartridge

- the URL of the Web Application Server Manager Home Page

### Deconfiguration Tasks

There are four major tasks in the deconfiguration procedure:

- Deconfiguring the Oracle Web Listener

- Deleting Web Request Broker Cartridge

- Deconfiguring Viewer Cartridge Specific Parameters

- Deconfiguring Authorization Server

#### Deconfiguring the Oracle Web Listener

This section describes how to remove the ConText Viewer Cartridge configuration from the Web Listener used to access the cartridge.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Listener> link.

   The Oracle Web Listener Administration page appears.

3. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener which is used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

4. On the OWL Administration - Server Advanced Configuration page, scroll down to the MIME Types block of fields.

   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.

5. On the Oracle Web Listener (OWL) Administration page, select <CONFIGURE> for the listener which is used to access the Viewer Cartridge.

   The OWL Administration - Server Advanced Configuration page appears.

6. On the OWL Administration - Server Advanced Configuration page, select <Security>.

   The Oracle Web Listener Security page appears.

7. On the Oracle Web Listener Security page, scroll to the Basic Users block of fields.

   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].

#### Deleting Web Request Broker Cartridge

This section describes how to delete the Viewer Cartridge from the Web Request Broker.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Cartridge Administration> link.

   The Cartridge Administration Page appears.

4. On the Cartridge Administration Page, select <Delete Cartridge>.

   The Delete Cartridge Configuration Page appears.

5. On the Delete Cartridge Configuration Page, in the Select a Cartridge field, select:

       CTXWVIEW

   Click [Delete].

   The Confirm Cartridge Deletion page appears.

   Click [Delete].

   The resulting page shows that the CTXWVIEW cartridge configuration has been deleted.

#### Deconfiguring Viewer Cartridge Specific Parameters

This section describes how to remove the ConText Viewer Cartridge configuration from the Web Request Broker.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Cartridge Administration> link.

   The Cartridge Administration Page appears.

4. On the Cartridge Administration Page, select the <Cartridge Summary (Web Request Broker)> link.

   The Web Request Broker Administration page appears.

5. On the Web Request Broker Administration Page, scroll to the Protecting Applications block of fields.

   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.

#### Deconfiguring Authorization Server

This section describes how to remove the ConText Viewer Cartridge configuration from the Authorization Server.

1. Access the Web Application Server Administration page.

2. On the Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Web Application Server Administration page appears.

3. On the Web Application Server Administration page, select the <Authorization Server> link.

   The Authentication Configuration page appears.

4. On the Authentication Configuration page, select the <Basic> link.

   The Basic Authentication page appears.

5. On the Basic Authentication page, scroll to the Basic Users block of fields.

   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 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.

Prev | Next
| Copyright © 1998 Oracle Corporation. All Rights Reserved. |
Library | Product | Contents | Index