Last updated 2003-02-25 13:08:55 EST
Doc Title DLXS Release Notes
Author 1 Farber, Phillip
Author 2 Weise, John
CVS Revision $Revision: 1.12 $
DLXS Release Notes

These notes summarize the DLXS releases chronologically, most recent first. They are structured into release numbers and within that level into General Information and then Middleware and XPAT-specific sections.

DLXS Release 11a - 5 MAR 2004

General Information

DLXS Release 11a is an interim release consisting of a few enhancements to Release 11. Refer to that section below for more detail. Release 11a is a full release of all DLXS middleware. There are no database schema changes. No database upgrades are required. A Release 11 version 4 database is fully compatible with release 11a.

Unicode support available in XPAT since Release 11 has been extended to the middleware and is delivered with working sample data under TextClass. FindaidClass shares the TextClass Unicode support changes. Refer to DLXS Unicode Data Preparation and Online Presentation Issues. ImageClass and BibClass still require minor changes to be fully Unicode compliant.

Release 11a is comprised of:

Known Problems

XPAT Known Problems

XPAT 5.3.0 is generally backward-compatible with indexes generated by 5.2.x subject to a few isolated misses during searching. Re-indexing with 5.3 xpatbld resolves this deficiency.

Database Known Problems

The SQL::Statement version 1.005 perl module is not backward compatible with version 0.1021. Version 0.1021 was typical with Perl version 5.6.1 whereas 1.005 is typical of Perl 5.8.0. We recommend you install perl 5.8.0 or higher and SQL::Statement 1.005 or higher.

Image Class Known Problems

XPAT version 5.3.0

Lib version 3.3.3

New and Changed Functionality

Text Class version 3.3.0

New and Changed Functionality

Bib Class version 3.1.2

New and Changed Functionality

Release of Z39BC.pm implementing a subclass of BibClass that is able to query Z3950 search engines. It uses Net::Z3950 (obtained from CPAN) to connect and create Z3950 queries which it then issues to a Z3950 search engine.

Presently it is designed to expect UTF-8 responses from its Z3950 queries, so the Z39App.pm application subclass should be modified to insert charset=UTF-8 <META> tags when outputting template files to handle the UTF-8 responses.

The collmgr 'host' field for Z39-based collections indicates the server where the Z3950 engine resides.

It is important to note that presently the Z39 implementation will only create queries for following fields: title, author, pubyear, language, and id, and that it assumes that the Z3950 search engine has a database with the same name as the collid, which is indicated when connecting to the engine. Here at UM, we are using Zebra as our Z3950 general-purpose structured text indexing and retrieval engine.

Image Class version 3.1.0

New and Changed Functionality

Broker20 version 1.1.0

New and Changed Functionality

Collmgr version 3.1.0

New and Changed Functionality

FindaidClass version 5.2.0

New and Changed Functionality

XClass version 2.1.1

New and Changed Functionality

DLXS Release 11 - 5 DEC 2003

General Information

DLXS Release 11 is comprised of:

Known Problems

XPAT 5.3.0 is generally backward-compatible with indexes generated by 5.2.x subject to a few isolated misses during searching. Re-indexing with 5.3 xpatbld resolves this deficiency.

The SQL::Statement version 1.005 perl module is not backward compatible with version 0.1021. Version 0.1021 was typical with Perl version 5.6.1 whereas 1.005 is typical of Perl 5.8.0. We recommend you install perl 5.8.0 and SQL::Statement 1.005 or higher. The workaround mentioned below may not be required when SQL::Statement 1.006 becomes available. Because of this the following constraints and workarounds apply.

Image Class Known Problems

XPAT version 5.3.0

Lib version 3.2.0

New and Changed Functionality

lib

bin/db

Obsolete fields in this release are as follows (TableName:fieldname):

Text Class version 3.2.0

New and Changed Functionality

web/t/text

bin/t/text, bin/WW

cgi/t/text

Bib Class version 3.1.0

New and Changed Functionality

web/b/bib

cgi/b/bib

Image Class version 3.0.0

New and Changed Functionality

web/i/image

cgi/i/image

/bin/i/image

Broker20 version 1.1.0

New and Changed Functionality

bin/b/broker20

  • Purge_CGM_Database: This file is executed from a cron job. It deletes cgm records that are two hours old or older.
  • Collmgr version 3.1.0

    New and Changed Functionality

    FindaidClass version 5.0.0

    New and Changed Functionality

    XClass version 2.1.0

    New and Changed Functionality

    XslFallback version 2.1.0

    New and Changed Functionality

    IdResolver version 1.0.0

    New and Changed Functionality

    DLXS Release 10 - 15 FEB 2003

    General Information

    DLXS Release 10 is comprised of:

    Known Problems

    The SQL::Statement version 1.005 perl module is not backward compatible with version 0.1021. Version 0.1021 was typical with Perl version 5.6.1 whereas 1.005 is typical of Perl 5.8.0. We recommend you install perl 5.8.0 and SQL::Statement 1.005 or higher. The workaround mentioned below may not be required when SQL::Statement 1.006 becomes available. Because of this the following constraints and workarounds apply.

    XPAT version 5.2.3

    Lib version 3.0.0

    New and Changed Functionality

    lib

    bin/db

    Bugs Fixed

    Text Class version 3.0.0

    New and Changed Functionality

    web/t/text

    bin/t/text

    cgi/t/text

    misc/t/text/maps

    Bugs Fixed

    Bib Class version 2.3.0

    New and Changed Functionality

    web/b/bib

    cgi/b/bib

    misc/b/bib/maps

    Bugs Fixed

    Image Class version 2.5.0

    New and Changed Functionality

    web/i/image

    cgi/i/image

    Broker20 version 1.0.0

    New and Changed Functionality

    web/b/broker20

    Broker has been replaced by Broker20.

    bin/b/broker20

    cgi/b/broker20

    Collmgr version 3.0.0

    New and Changed Functionality

    web/c/collmgr

    cgi/c/collmgr

    Finding Aids version 2.1.0

    cgi/f/findaid

    XClass version 2.0.0

    web/x/xclass

    cgi/x/xclass

    DLXS Release 9 - 8 JUL 2002

    General Information

    DLXS Release 9 is comprised of:

    Significant functional changes and enhancements introduced in Release 9:

    XPAT version 5.2.3

    Lib version 2.4.15

    New and Changed Functionality

    Bugs Fixed

    Text Class version 2.5.10

    New and Changed Functionality

    cgi/t/text

    web/t/text

    Bugs Fixed

    Bib Class version 2.2.7

    New and Changed Functionality

    cgi/b/bib

    web/b/bib

    Bugs Fixed

    Image Class version 2.3.3

    New and Changed Functionality

    General

    cgi/i/image

    web/i/image

    Bugs Fixed

    Broker version 1.2.0

    New and Changed Functionality

    cgi/b/broker

    Collmgr version 1.1.0

    New and Changed Functionality

    In release 9 Collmgr expects to see a version 2.0 DLXS database. This is either a new sample database as delivered with Release 9 or a version 1.0 database compatible with Release 8 and upgraded to version 2.0 by the upgrade_1_2 utility.

    cgi/c/collmgr

    web/c/collmgr

    Finding Aids version 2.0.4

    XClass version 1.0.0

    DLXS Release 8 - 22 Mar 2002

    General Information

    This is an interim release of DLXS middleware.

    DLXS Release 8 is comprised of TextClass version 2.5.0, BibClass version 2.1.6, FindingAids version 2.0.3, ImageClass version 2.3.1, Broker version 1.1.2, Collmgr version 1.1.0, mrsid_retrieve version 1.3.1, tif2web version 1.0.0, dlxsd version 1.0.0 and XPAT version 5.2.3. In particular, dlxsd (the remote daemon), mrsid_retrieve and tif2web are first-time deliverables in this release.

    Release 8 introduces a new architecture incorporating an Application Object which encapsulates the mainline code from a given class of middleware (text-idx, image-idx, bib-idx) and abstracts it into a Perl class that can be instantiated and manipulated as an object. The main program is reduced to just a few lines. The Application Object's class can be subclassed to change functionality in a manner similar to the subclasses of the TextClass collection object base class. In addition, a single CGI program can instantiate multiple application objects (from different middleware classes) and combine their functionality to produce "cross-class" applications. We expect to demonstrate such functionality in an upcoming release.

    Release 8 has a new top-level directory structure "misc/{db,c/class/maps}" that replaces obj/c/class/lib/{db,maps}.

    XPAT version 5.2.3

    Lib version 2.4.7

    New and Changed Functionality

    Bugs Fixed

    Text Class version 2.5.0

    New and Changed Functionality

    bin/t/text

    web/t/text

    Fixed Bugs

    Bib Class version 2.1.6

    New and Changed Functionality

    Image Class version 2.3.1

    New and Changed Functionality

    Fixed Bugs

    Known Problems

    Finding Aids version 2.0.1

    Broker version 1.1.2

    Collmgr version 1.0.0

    Finding Aids version 2.0.3

    DLXS Release 7 - 9 JAN 2002

    General Information

    This is an interim release of DLXS middleware intended to distribute Image Class version 2.0.0, which is a complete rewrite of the class.

    DLXS Release 6 is comprised of TextClass version 2.3.0, BibClass version 2.1.0, FindingAids version 2.0.1, ImageClass version 2.0.0, Broker version 1.1.0 and XPAT version 5.2.3.

    XPAT version 5.2.3

    Text Class version 2.3.0

    Bib Class version 2.1.0

    Image Class version 2.0.0

    New and Changed Functionality

    Image Class was rewritten to improve performance and to make better use of DLXS Lib, colldb, and groups. To the extent possible, backward compatability for cgi parameters was maintained.

    Several key enhancements have been made:

    Known Problems

    imageclass.cfg attempts to establish connection with mysql for BookBagDB functionality, even if BookBag functionality is turned off. Please make the following adjustments (in bold) to the imageclass.cfg...

    ### BookBagDB Configuration
    {
        my $dsn;
        my $username = 'usernamehidden';
        my $pw = 'passwordhidden';
        $gbbagentrydivsdefault = 'full image';
        $gBbagTableName = 'BookBagDB';
    
    
        if ($gBookBagToggle)
          {
            if ( $ENV{'DLPS_DEV'} )
              {
                $dsn = 'DBI:mysql:dlxs:fizzie.umdl.umich.edu:';
              }
            else
              {
                $dsn = 'DBI:mysql:dlxs:dlps1.umdl.umich.edu:';
              }
            eval{ $gDBHBbag = &DbUtils::Connect_DBI($dsn, $username, $pw); };
            if ( $@ )
              {
                &DlpsUtils::errorBail( $@ );
              }
    
          }
      }
    

    Finding Aids version 2.0.1

    Broker version 1.1.0

    Lib version 2.4.0

    Backward Compatibility

    No changes from #6

    DLXS Release 6 - 1 OCT 2001

    General Information

    This is an interim release of DLXS middleware intended to distribute bug fixes, functional enhancements and coding clean-ups which have occurred since the 30 MAR 2001 Release 5.

    DLXS Release 6 is comprised of TextClass version 2.3.0, BibClass version 2.1.0, FindingAids version 2.0.1, ImageClass version 1.0.6, Broker version 1.1.0 and XPAT version 5.2.3.

    These fixes and enhancements apply primarily to TextClass, BibClass and Lib. ImageClass version 1.0.6 and XPAT 5.2.3 (both first delivered in DLXS Release 5) are unchanged in this release.

    With this release comes the initial delivery of Broker version 1.1.0.

    XPAT version 5.2.3

    New and Changed Functionality

    Fixed Bugs

    Known Problems

    Text Class version 2.3.0

    New and Changed Functionality

    cgi/t/text

    web/t/text

    obj/t/text/maps

    obj/t/text/db

    Fixed Bugs

    Known Problems

    Bib Class version 2.1.0

    This release does not include any significant improvements in functionality. It is focused mainly on bug fixes. Not listed in a separate item below is support for an ID attribute on the A element in bib.map.

    New and Changed Functionality

    cgi/b/bib

    Fixed Bugs

    Known Problems

    Image Class version 1.0.6

    This release is identical to that contained in DLXS Release 5. Considerable architectural and functional enhancements are scheduled for version 2 of the Image Class, expected to be released in late 2001.

    Finding Aids version 2.0.1

    New and Changed Functionality

    Fixed Bugs

    Known Problems

    Broker version 1.1.0

    Functionality

    Fixed Bugs

    Known Problems

    Lib version 2.4.0

    This release of the shared DLXS library modules incorporates some minor enhancements to the API and significant additional functionality in the database interface defined in DbUtils.pm.

    New and Changed Functionality

    Backward Compatibility

    DLXS #6 introduces some minor non-backward compatible changes. One, as a result of a generalization in the database connect mechanism, is trivial because the class middleware interface to DbUtils.pm is mediated by the CollsInfo.pm and GroupsInfo.pm APIs this change should have no effect on existing middleware.

    Fixed Bugs

    Known Problems

    DLXS Release 5 - 30 MAR 2001

    General Information

    This is the first release that incorporates all three Classes (Text, Bib, Image) and the Finding Aid middleware in a single release.

    XPAT version 5.2.3

    Enhancements

    Known Problems

    Text Class version 2.2.3

    Enhancements

    Known Problems

    Bib Class version 2.0.2

    This release is a significant re-development of BibClass which uses the DLXS common library modules found in Lib. In particular, it uses a database for collection data and session management for BookBag and Search History functionality.

    Enhancements

    Known Problems

    Image Class version 1.0.6

    The primary goal was to make essential changes to keep pace with core DLXS developments. This was intentionally done without drastically modifying the architecture or functionality of the programs. Considerable architectural and functional enhancements are scheduled for version 2 of the Image Class, expected to be released in spring 2001.

    Enhancements

    There are a few remarkable enhancements in Version 1.

    Version 1 includes a significant DTD change, which requires collection metadata to be reprocessed. It is a general goal to keep DTD changes to an absolute minimum.

    Dependencies

    Finding Aids version 2.0.0

    Enhancements

    Known Problems

    Lib version 2.1.1

    This is the first release of the shared DLXS library modules (collectively known as Lib). Release of Lib as a separately versioned deliverable gives us needed flexibility to supply updates for functionality enhancements and bug fixes and to better maintain backward-compatibility when newer Lib versions are released.

    Enhancements

    Backward Compatibility

    DLXS #5 introduces 2 non-backward compatible changes as a result of the move to the Perl DBI database interface and the update of Apache::Session to version 1.53 with its correspondingly different file structure for session management

    Known Problems