__________________________________________

Oracle8 ConText Cartridge Workbench

Release Notes

Release 2.4.5.0.0

July 1998

__________________________________________

Copyright (C) 1998 Oracle Corporation.

Primary Authors: D. Yitzik Brenman

Contributors: Franco Cravero, Dave Allewell, John Barry, Roy Clarke

This software/documentation contains proprietary information of Oracle Corporation; it is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited.

If this software/documentation is delivered to a U.S. Government Agency of the Department of Defense, then it is delivered with Restricted Rights and the following legend is applicable:

RESTRICTED RIGHTS LEGEND:

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, Rights in Technical Data and Computer Software (October 1988).

If this software/documentation is delivered to a U.S. Government Agency not within the Department of Defense, then it is delivered with "Restricted Rights," as defined in FAR 52.227-14, Rights in Data - General, including Alternate III (June 1987).

Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065

The information in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free.

Oracle, SQL*Loader, Net8, SQL*Plus, and ConText are registered trademarks of Oracle Corporation. Oracle8, PL/SQL, and Gist are trademarks of Oracle Corporation.

All other trade names referenced are the service mark, trademark, or registered trademark of the respective manufacturer.

_______________________________________________

These Release Notes include updated information and known restrictions to the Oracle8 ConText Cartridge Workbench, release 2.4.5.0.0.

For more detailed setup and usage information for the ConText workbench and its components, see the Oracle8 ConText Cartridge Workbench User's Guide.

TABLE OF CONTENTS

1. New Features

1.1 Application Generator

2. Installation Issues

2.1 Disk Space Requirements

2.2 Level of Browser Support for the Browser Plugin

3. Upgrade Issues

3.1 Upgrading ConText Workbench

4. Setup Issues

4.1 Post-installation Setup Required for Configuration Manager and Viewer Cartridge

4.2 Installation and Setup Required for TextServer3 Dictionary Migration Tool

5. Known Problems

5.1 Out-of-date Status May Cause Errors in the System Administration Tool Page

5.2 Embedded Graphics Not Supported in Viewer

5.3 Netscape Navigator Refresh Problem

5.4 Viewer Cartridge and Oracle Web Server v2.1

5.5 Configuration Manager and Oracle8 Databases on UNIX Platforms

6. Bugs Fixed In This Release

1. New Features

1.1 Application Generator

In release 2.4.5, the Configuration Manager includes a utility for quickly and easily generating prototype Web-based ConText applications based on user data stored directly in database tables.

The Application Generator is configurable, allowing you to tailor the generated application(s) to your specific data. It is presented as a series of wizards that step you through the minimum information required by ConText to create indexes for your text, generate linguistic information, and build a basic query and document viewing interface.

The Application Generator and the applications you generate are accessed by clicking the [Application] link in the list of options on the main screen of the Configuration Manager.

Full usage information for the Application Generator is provided as part of the online help system for the Configuration Manager.

2. Installation Issues

2.1 Disk Space Requirements

The disk space requirement for installing the ConText Workbench components is approximately 10 Megabytes.

Note: This figure does not include the disk space required for Oracle Forms, which is needed for using the sample application, but must be installed separately. Nor does it include the disk space required by the Oracle product dependencies.

2.2 Level of Browser Support for the Viewer Plugin

The Viewer Plugin is supported on Netscape Browser, Version 2 and upwards, on Windows NT and Windows 95.

3. Upgrade Issues

3.1 Upgrading ConText Workbench

Upgrading the ConText Workbench is not necessary. When you install the ConText Workbench, the Installer automatically overwrites any previous installations.

Note: The components from previous installations of the ConText Workbench will not work with release 2.4.5 of ConText and the ConText Workbench.

However, the release 2.4.5 System Administration tool is backward compatible and will work with all previous 2.x releases of ConText.

4. Setup Issues

4.1 Post-installation Setup Required for Configuration Manager and Viewer Cartridge

Installation of the Cartridge Workbench is automatic; however, the Oracle Installer does not set up the Configuration Manager and the Viewer Cartridge. Instead, it creates two icons which can be used later to set up these components.

Note: Setup does not need to be performed for each client that uses the Configuration Manager or Viewer Cartridge; setup of both the Configuration Manager and Viewer Cartridge only needs to be performed once for each Oracle8 installation.

For complete setup instructions for the Configuration Manager and Viewer Cartridge, see the Oracle8 ConText Cartridge Workbench User's Guide.

4.2 Installation and Setup Required for the TextServer3 Dictionary Migration Tool

The ConText Workbench provides a tool for generating SQL scripts that can be used to migrate your TextServer3 data dictionary to the ConText data dictionary. The tool is presented as a PL/SQL package that must be created in the database where TextServer3 is installed.

As such, the Oracle Installer does not install or set up the tool. Instead, it installs a SQL script for creating the package.

Note: The Oracle Installer does not list the migration tool in the list of installable components for the ConText Workbench. The script for creating the migration tool is automatically installed on your client machine when the ConText Workbench is installed.

For complete installation/setup instructions for the TextServer3 Dictionary Migration Tool, see the Oracle8 ConText Cartridge Workbench User's Guide.

5. Known Problems

5.1 Out-of-date Status May Cause Errors in the System Administration Tool

When the status of an object, such as a policy or the Services Queue, displayed in the administration tool does not reflect the actual system status, the administration tool will display an error message and exit if a user attempts to modify the object.

For example, the administration tool displays a status of NO_INDEX for a policy; however, the policy has been used to create a text index and the display has not been updated to reflect the change in status. If a user attempts to delete the policy, an error message is returned stating the policy has been used to create an index and the administration tool exits.

To ensure the display is up-to-date, use the View -> Refresh menu item.

Note: If the status of an object changes as the System Administration tool display is refreshed, the refreshed display may not reflect the actual system status.

5.2 Embedded Graphics Not Supported in Viewer

In release 2.4.5 of ConText Workbench, the Viewer Control and Viewer Plugin do not display graphics that are embedded in a document.

5.3 Netscape Navigator Refresh Problem

In Netscape Navigator Version 3, a document that is present in the local cache, and which has previously been displayed, is sometimes not redisplayed immediately on request. It appears that this version of Netscape Navigator does not always refresh the page, and a blank page ensues instead. For pages with forms in some cases the browser may not redisplay all the buttons.

The workaround is to toggle between the Netscape window and other windows on the desktop. Netscape Navigator then normally performs a refresh as required.

5.4 Viewer Cartridge and Oracle Web Server v2.1

When using the Viewer Cartridge against Oracle WebServer v2.1 on Solaris, the thin JDBC driver should be used. To do this, edit the "[Default]" section in the ctxvcart.cfg file (located on the server machine) as follows:

- change "database=tnsalias" to "database=host:port:sid"

- add line "subprotocol=thin"

In a UNIX-based environment, the ctxvcart.cfg file is located in $ORACLE_HOME/ctxw/middle/ctxvcart.

In Windows NT, the file is located in ORACLE_HOME\CTXW\MIDDLE\CTXCART

5.5 Configuration Manager and Oracle8 Databases on UNIX Platforms

When attempting to use the Configuration Manager to connect to an Oracle8 database running on a platform other than Windows NT, users may receive an ORA-3113 error. To resolve this issue, please contact Oracle Worldwide Support and request the patch for bug 593630.

6. Bugs Fixed in This Release

Bug No Description

420455 TEMPLATE/PREFERENCES BUTTONS SHOULD BE INACTIVE.

525309 DEINSTALL DOES NOT REMOVE ALL COMPONENTS

546395 PROBLEM IN EDITING SECTIONS IN A SECTION GROUP (CONFIGURATION

MANAGER)

597314 DISPLAY OF 'TABLE' AND 'COLUMN' ARE MISPLACED IN QUERY POLICY

SCREEN OF CONFIGURATION MANAGER

597357 'MORE TERMS' AND 'LESS TERMS' IN QUERY SCREEN DOESN'T WORK

IN CONFIGURATION MANAGER

597367 INSTALLATION (WIN 95): HOST NAME IS DISPLAYED IS REVERSE ORDER

609999 NLS:SOME OF MESSAGES AREN'T JAPANESE.

618936 FILE NAMES IN WRONG CASE ON UNIX INSTALL OF CONFIG MANAGER