Kimberlite Cluster    v1.0.0  README

Kimberlite is a complete framework providing high availability for application
services on Linux.  The key features of the architecture include the following:

- A complete high-availability service infrastructure prevents you from having 
  to assemble an infrastructure from disparate components.

- An extensible service-configuration framework enables you to easily
  integrate a wide variety of applications.

- An exceptional data integrity guarantee differentiates the software from
  other contemporary offerings from the Linux community.  Because of this
  guarantee, a Kimberlite cluster provides a solid foundation for
  highly-available data services, such as network-exported databases and
  NFS file systems, and is ideal as the data tier for dynamic web content.

- Services fail over automatically when problems occur, without requiring
  manual intervention by system administrators.

- A command line user interface and a web-based graphical user interface
  enable you to monitor and manage the cluster.

- A cluster utilizes commodity hardware and storage options, such as SCSI and 
  FibreChannel.

- Extensive documentation is provided, including end-user documents and design 
  specifications.

See the "Design Specification" and "Installation and Administration" documents 
for more information.

This package includes:

doc/     - Documentation on the cluster architecture and management:

	   cluster.html - The Kimberlite cluster "Installation and
	   Administration" document provides a high-level cluster
	   overview, followed by complete instructions on configuring and
	   administering a cluster.

	   Cluster_Specs.pdf - This document contains a detailed design
	   specification.
 
etc/     - Files that get placed in the /etc directory

include/ - Headers exported by the source files

init.d/  - Files that belong in the sysv init directory

src/     - Source code directory

Documentation on the installation process can be found in the doc directory
and in the INSTALL file that is located in the same directory as this
README file.

Hardware Requirements

Kimberlite clusters must contain the following hardware components:

- 2 computers running Linux; each must include the following:

	- One external storage adapter (e.g., SCSI)
	- Disks on a shared storage bus (e.g., SCSI disks)
	- One serial port
	- One supported remote power switch
	- One network interface

 For a higher degree of availability, you can add the following hardware:

	- Multiple network interfaces
	- Multiple serial ports
	- RAID storage subsystems for disk redundancy

Refer to the "Installation and Administration" document for more 
information about supported hardware configurations.
