Berkeley DB Reference Guide: Berkeley DB Replication

Initializing a new site

Perform the following steps to add a new site to the replication group:

1. Do an archival backup of the master's environment, as described in Database and log file archival. The backup can either be a conventional backup or a hot backup.

2. Copy the archival backup into a clean environment directory on the client.

3. Run catastrophic recovery on the client's new environment, as described in Recovery procedures.

4. Reconfigure and reopen the environment as a client member of the replication group.

If copying the backup to the client takes a long time relative to the frequency with which log files are reclaimed using the db_archive utility or the DB_ENV->log_archive function, it may be necessary to suppress log reclamation until the newly restarted client has "caught up" and applied all log records generated during its downtime.

As with any Berkeley DB application, the database environment must be in a consistent state at application startup. This is most easily assured by running recovery at startup time in one thread or process; it is harmless to do this on both clients and masters even when not strictly necessary.

Copyright Sleepycat Software