DB_ENV->repmgr_add_remote_site()
Prev | Chapter 10. Replication Methods | Next

## 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

#### host

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

#### port

The port number on which the remote site is receiving.

#### 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.

  You can configure one or more remote sites as client peers. To remove a remote site as a possible client peer, call the `DB_ENV->repmgr_add_remote_site()` method for that site with a flags value excluding the DB_REPMGR_PEER bit value.

### 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

Prev | Up | Next
DB_ENV->rep_sync() | Home | DB_ENV->repmgr_get_ack_policy()