DB_ENV->repmgr_add_remote_site()

#include <db.h>

int
DB_ENV->repmgr_add_remote_site(DB_ENV *env,
    const char *host, u_int port, int *eidp, u_int32_t flags);  

The DB_ENV->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 DB_ENV->repmgr_add_remote_site() method may be called at any time during the life of the application.

The DB_ENV->repmgr_add_remote_site() method returns a non-zero error value on failure and 0 on success.

Parameters

eidp

If eidp is non-NULL, and the database environment has already been opened by calling DB_ENV->open(), then the environment ID assigned to the remote site is returned in the memory location referenced by eidp.

flags

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.

host

The site's host identification string, generally a TCP/IP host name.

port

The port number on which the remote site is receiving.

Errors

The DB_ENV->repmgr_add_remote_site() method may fail and return one of the following non-zero errors:

EINVAL

If this method is called from a base replication API application; or if an invalid flag value or parameter was specified.

Class

DB_ENV

See Also

Replication and Related Methods