  00..11..  NNAAMMEE

  InterMezzo - the high availability replicating file system.


  00..22..  SSYYNNOOPPSSIISS


  This manpage gives a quick overview of the components of InterMezzo.


  00..33..  DDEESSCCRRIIPPTTIIOONN


  IInntteerrMMeezzzzoo provides the capability to share directory trees and keep
  them synchronized.  InterMezzo deals gracefully with network and
  server failures and provides disconnected operation with automatic
  synchronization.


  InterMezzo consists primarily of a kernel based file system in the
  iinntteerrmmeezzzzoo kernel module and a file server / cache manager named
  lleennttoo.  An instance of a Unix mounted InterMezzo file system is
  referred to as a cache.  A cache contains one or more filesets.  In
  order to configure InterMezzo a system needs to be told what server,
  and what file sets needs replication to what replicators.
  InterMezzo's lento follows a client server model: its role is either
  that of a server or that of the cache manager.


  To get InterMezzo running you need to:

  +o  Format an InterMezzo file system on a partition or logical volume
     with mkizofs

  +o  Create configuration files /etc/intermezzo/{sysid,fsetdb,serverdb}.
     The iinnccoonnffiigg tool can help to do so.

  +o  insert the kernel module, mount the file systems and start the file
     server lento.

  The kernel module intermezzo.o contains the file system and the pseudo
  device for kernel fileserver communication. It needs character device
  files /dev/intermezzo0...3 (major 185), as well as an entry "char-
  major-185 intermezzo" in /etc/modules.conf.



  There must also be an ffssttaabb entry for each fileset you wish to
  replicate. An example of a typical fstab entry is something like this:


  /dev/hda9    /mnt/izo    intermezzo  fileset=<fsetname>,mtpt=/mnt/izo,cache_type=ext3,prestodev=/dev/intermezzo0,noauto  0 0




  Make sure you specify the device that you have used mkizofs on, and
  that the mountpoint directory exists. The fileset name must correlate
  with the fileset name specified in the fsetdb config file (man
  fsetdb).

  nnoottee:: The mtpt directory must NOT have a trailing slash.



  The configuration files required are

  +o  /etc/intermezzo/sysid

  +o  /etc/intermezzo/fsetdb

  +o  /etc/intermezzo/serverdb


  The iinnccoonnffiigg utility is capable of correctly formatting these, while
  iinnccoonnffiigg__cchhkk can check the environment for obvious errors.  Mountain
  View Data has commercial software that makes managing InterMezzo
  considerably easier.


  InterMezzo is finally brought up by starting the file server or cache
  manager lleennttoo.


  00..44..  BBUUGGSS




  00..55..  SSEEEE AALLSSOO

  inconfig (2), lento(2), mkizofs(8), fsetdb(5), serverdb(5), sysid(5)



  00..66..  AAUUTTHHOORR

  Mountain View Data, 2001, created.  Peter J. Braam,
  braam@clusterfs.com, corrected, edited.
































