NAME
dbreplicate - Provide replication services SYNOPSIS
dbreplicate [-MVv] [-h home] [-L file] [-P password] [-T num-threads]
[-t secs] DESCRIPTION The dbreplicate utility is a daemon process that provides replica‐ tion/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. OPTIONS
-h home Specify a home directory for the database environment; by default, the current working directory is used.
-L file Log the execution of the dbreplicate utility to the specified
file in the following format, where ### is the process ID, and the date is the time the utility was started.
dbreplicate: ### Wed Jun 15 01:23:45 EDT 1995 Additionally, events such as site role changes will be noted in the log file. This file will be removed if the dbreplicate utility exits gracefully.
-M Start the dbreplicate utility to be the master site of the replication group. Otherwise, the site will be started as a client replica.
-P password Specify an environment password. Although Berkeley DB utilities overwrite password strings as soon as possible, be aware there may be a window of vulnerability on systems where unprivileged
users can see command-line arguments or where utilities are not
able to overwrite the memory containing the command-line argu‐ ments.
-T num-threads Specify the number of replication message processing threads.
-t secs Specify how often (in seconds) the utility will check for pro‐ gram interruption and resend the last log record.
-V Write the library version number to the standard output, and exit.
-v Turn on replication verbose messages. These messages will be written to the standard output and will be quite voluminous. The dbreplicate 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 dbreplicate utility should be started. The application must use the DBINITREP and DBTHREAD flags when creating the environ‐ ment. The dbreplicate utility uses a Berkeley DB environment (as described
for the -h option, the environment variable DBHOME, 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 envi‐ ronment, dbreplicate should always be given the chance to detach from the environment and exit gracefully. To cause dbreplicate to release all environment resources and exit cleanly, send it an interrupt signal (SIGINT). EXIT STATUS The dbreplicate utility exits 0 on success, and >0 if an error occurs. ENVIRONMENT DBHOME
If the -h option is not specified and the environment variable DBHOME is set, it is used as the path of the database home, as
described in DBENV->open. NOTES This utility is not supported for use with the DB SQL APIs. SEE ALSO dbarchive(1) dbcheckpoint(1) dbdeadlock(1) dbdump(1) dbhot‐ backup(1) dblogverify(1) dbload(1) dbprintlog(1) dbrecover(1) dbstat(1) dbtuner(1) dbupgrade(1) dbverify(1) BerkeleyDB 5.3.21 06 December 2016 DBREPLICATE(1)