#include <db_cxx.h> int DbEnv::repmgr_add_remote_site(const char *host, u_int port, int *eidp, u_int32_t flags);
The DbEnv::repmgr_add_remote_site() method adds a new replication
site to the Replication Manager's list of known sites. It is not
necessary for all sites in a replication group to know about all other
sites in the group.
The DbEnv::repmgr_add_remote_site() method may be called at any time
during the life of the application.
The DbEnv::repmgr_add_remote_site()
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
If eidp is non-NULL, and the database environment has already been opened by calling DbEnv::open(), then the environment ID assigned to the remote site is returned in the memory location referenced by eidp.
The flags parameter must be set to 0 or by bitwise inclusively OR'ing together one or more of the following values:
DB_REPMGR_PEER
Specifying the DB_REPMGR_PEER flag configures client-to-client
synchronization with the specified remote site.
Currently, the Replication Manager framework only supports a single client peer, and the last specified peer is used.
The DbEnv::repmgr_add_remote_site()
method may fail and throw a DbException
exception, encapsulating one of the following non-zero errors, or return one
of the following non-zero errors: