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

# A
Viewer Cartridge: Manual Configuration

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:

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

Note: These procedures are different from those that apply for Oracle Web Application Server 3.0.

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.

### Configuration Requirements

The following information is required during configuration:

- the name of the machine on which Oracle 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 Oracle WebServer is running on (UNIX-based or Windows NT)
- the Oracle home directory for the Oracle WebServer 2.1 installation

  Note: In certain steps of the configuration process for Oracle WebServer 2.1, it is necessary to enter filesystem 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 Oracle WebServer Administration page.
2. On the Oracle 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.

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

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

    The Oracle Web Listener Security page appears.

  - 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 Oracle WebServer Administration page.
2. On the Oracle 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.

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

        CLASSPATH

  If the Oracle WebServer platform is UNIX, 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 Oracle 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.zi
    p;%ORACLE_HOME%\ctxw\middle\ctxvcart\ctxvcart.zip

  In row 2, column 1, enter:

      LD_LIBRARY_PATH

  If the Oracle WebServer platform is UNIX, 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 Oracle 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 Oracle WebServer Administration page.
2. On the Oracle 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 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

  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 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 Oracle WebServer 2.1 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 Oracle WebServer 2.1, it is necessary to remove filesystem 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: Oracle 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 Oracle WebServer Administration page.
2. On the Oracle 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.

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

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

    The Oracle Web Listener Security page appears.

  - 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 Oracle WebServer Administration page.
2. On the Oracle 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 Oracle WebServer Administration page.
2. On the Oracle 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.

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

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.

Note: These procedures are different from those that apply for Oracle WebServer 2.1.

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.

### Configuration Requirements

The following information is required during configuration:

- the name of the machine on which Oracle 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 Oracle Web Application Server is running on (UNIX-based or Windows NT)

  Note: In certain steps of the configuration process for Oracle Web Application Server 3.0, it is necessary to enter filesystem paths. Part of the path may be the Oracle or Oracle 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: Oracle 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 Oracle Web Application Server Administration page.
2. On the Oracle 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.

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

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

    The Oracle Web Listener Security page appears.

  - 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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 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

  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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 Oracle 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 Oracle 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_HO
    ME%\ctxw\middle\ctxvcart\ctxvcart.zip

  In row 2, column 1, enter:

      LD_LIBRARY_PATH

  If the Oracle Web Application Server platform is UNIX, in row 2, column 2, enter:

    %ORAWEB_HOME%/bin:%ORAWEB_HOME%/lib:%ORAWEB_HOME%/java/lib:%ORACLE_HOME%/jdbc/lib

  If the Oracle 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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 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.

Oracle 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 Oracle Web Application Server Administration page.
2. On the Oracle 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.

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

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

    The Oracle Web Listener Security page appears.

  - 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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 Oracle Web Application Server Administration page.
2. On the Oracle Web Application Server Administration page, select the <Oracle Web Application Server> link.

   The Oracle Web Application Server Administration page appears.

3. On the Oracle 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 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.

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