db_replicate [-MVv] [-h home]
    [-L file] [-P password] [-T num_threads] [-t secs]  

The db_replicate utility is a daemon process that provides replication/HA services on a transactional environment. This utility enables you to upgrade an existing Transactional Data Store application to an HA application with minor modifications. For more information on the db_replicate utility, see the Running Replication Using the db_replicate Utility section in the Berkeley DB Programmer's Reference Guide.


This utility is not supported for use with the DB SQL APIs.

The options are as follows:

The db_replicate utility uses a Berkeley DB environment (as described for the -h option, the environment variable DB_HOME, or because the utility was run in a directory containing a Berkeley DB environment). In order to avoid environment corruption when using a Berkeley DB environment, db_replicate should always be given the chance to detach from the environment and exit gracefully. To cause db_replicate to release all environment resources and exit cleanly, send it an interrupt signal (SIGINT).

The db_replicate utility does not attempt to create the Berkeley DB shared memory regions if they do not already exist. The application that creates the region should be started first, and once the region is created, the db_replicate utility should be started. The application must use the DB_INIT_REP and DB_THREAD flags when creating the environment.

The db_replicate utility exits 0 on success, and >0 if an error occurs.

Environment Variables


If the -h option is not specified and the environment variable DB_HOME is set, it is used as the path of the database home, as described in the DB_ENV->open() method.