DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(heimdal.info) Incremental propagation

Info Catalog (heimdal.info) Slave Servers (heimdal.info) Setting up a realm (heimdal.info) Salting
 
 Incremental propagation
 =======================
 
 There is also a newer and still somewhat experimental mechanism for
 doing incremental propagation in Heimdal.  Instead of sending the whole
 database regularly, it sends the changes as they happen on the master to
 the slaves.  The master keeps track of all the changes by assigned a
 version number to every change to the database.  The slaves know which
 was the latest version they saw and in this way it can be determined if
 they are in sync or not.  A log of all the changes is kept on the master
 and when a slave is at an older versioner than the oldest one in the
 log, the whole database has to be sent.
 
 Protocol-wise, all the slaves connects to the master and as a greeting
 tell it the latest version that they have (`IHAVE' message).  The
 master then responds by sending all the changes between that version and
 the current version at the master (a series of `FORYOU' messages) or
 the whole database in a `TELLYOUEVERYTHING' message.
 
 Configuring incremental propagation
 -----------------------------------
 
 The program that runs on the master is `ipropd-master' and all clients
 run `ipropd-slave'.
 
 Create the file `/var/heimdal/slaves' on the master containing all the
 slaves that the database should be propagated to.  Each line contains
 the full name of the principal (for example
 `iprop/hemligare.foo.se@FOO.SE').
 
 You should already have `iprop/tcp' defined as 2121, in your
 `/etc/services'.  Otherwise, or if you need to use a different port for
 some peculiar reason, you can use the `--port' option.  This is useful
 when you have multiple realms to distribute from one server.
 
 Then you need to create these principals that you added in the
 configuration file.  Create one `iprop/hostname' for the master and for
 every slave.
 
      master# /usr/heimdal/sbin/ktutil get iprop/`hostname`
 
 The next step is to start the `ipropd-master' process on the master
 server.  The `ipropd-master' listens on the UNIX-socket
 `/var/heimdal/signal' to know when changes have been made to the
 database so they can be propagated to the slaves.  There is also a
 safety feature of testing the version number regularly (every 30
 seconds) to see if it has been modified by some means that do not raise
 this signal.  Then, start `ipropd-slave' on all the slaves:
 
      master# /usr/heimdal/libexec/ipropd-master &
      slave#  /usr/heimdal/libexec/ipropd-slave master &
 
Info Catalog (heimdal.info) Slave Servers (heimdal.info) Setting up a realm (heimdal.info) Salting
automatically generated byinfo2html