What is the Shore Release?

The Version 1.0 release of the Shore software is a release of work-in-progress. The release is targeted for sites that will use Shore as a system for writing applications using the Shore Data-definition Language and for those who want to write their own servers using the Shore Storage Manager. This document describes the release and provides pointers to other documents explaining how to install and use the software.

If you have questions, comments or bug reports, please mail them to

    shore_support@cs.wisc.edu

For information on other mailing lists, see the Shore WWW home page: http://www.cs.wisc.edu/shore/.

Requirements

The Version 1.0 release of Shore is supported for SPARCStations and Pentiums running Solaris 2.5. It will probably build OK for SunOS 4.1.3 and Solaris 2.4, but there are no guarantees.

You will need the GNU C/C++ compiler, gcc, version 2.7.2 and the 2.7.1 version of libg++ (and include files). We have built and tested the system with gcc 2.6.3, but we no longer support Shore built with that version of the compiler.

Complete details about required software and hardware are available in the Requirements section of the Installation manual.

Copyright and Disclaimer

The Shore software is distributed with the following copyright notice and disclaimer, and is subject to its terms:

Copyright (c) 1994, 1995 Computer Sciences Department, University of Wisconsin - Madison. All Rights Reserved.

Permission to use, copy, modify and distribute this software and its documentation is hereby granted, provided that both the copyright notice and this permission notice appear in all copies of the software, derivative works or modified versions, and any portions thereof, and that both notices appear in supporting documentation.

THE COMPUTER SCIENCES DEPARTMENT OF THE UNIVERSITY OF WISCONSIN -- MADISON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS" CONDITION. THE DEPARTMENT DISCLAIMS ANY LIABILITY OF ANY KIND FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.

The Shore Project Group requests users of this software to return any improvements or extensions that they make to the Shore Project Group, Computer Sciences Department, University of Wisconsin, 1210 West Dayton Street, Madison, WI 53706-1685.

In addition, the Shore Project Group requests that users grant the Computer Sciences Department rights to redistribute these changes.

What is New in the Release

General

• Ported to Solaris 2.5.

• The software builds under gcc 2.7.2 with the libg++ 2.7.1 library and include files.

• Numerous bugs were fixed.

Applications

• Applications linked with the no-debug libraries must be recompiled with the no-debug include files, because the two implementations of the return-code class are incompatible.

• Ref<Pool> can be used in applications.

• Enumerations can be used for index key types.

• Reference-counting on modules is enabled and under the control of the option oc_refcount. If you use this, use it with caution.

Object cache

No changes.

Shore server

See Storage manager.

Storage manager

• The format of logs and volumes has changed; data created under previous releases cannot be read by a Version 1.0 server.

• The SM programming interface is slightly changed to support multi-threaded transactions (in limited circumstances: see smthread_t(SSM) ),

  external two-phase commit (see transaction(SSM)), and faster record creation in a file in append-only context (see scan_file_i(SSM) ).

• The log can be a raw device. The SM can be configured to use a separate (diskrw) process for the log or to perform the log I/O locally (and synchronously). The SM layer has a new option sm_reformat_log to control reformatting the log, in the event that a raw device is used. The meaning of the option sm_logsize has changed. (See options(SVAS) for details.)

• More statistics are reported.

• Miscellaneous performance improvements were made (logging uninitialized data, append-only file population, store-descriptor cache expands as needed, lock manager simplified).

• The programming interface for threads has changed. The changes are incorporated into the example value-added server, and described in the companion document.