Initialization
Replica initialization transfers a copy of the backend containing the replication domain to a target server. You should perform this after replication is enabled with the dsreplication initialize
subcommand. There is no impact on the source server during this process.
When enabling or initializing servers, the This option is used in place of specifying |
dsreplication initialize
-
The recommended approach for replica initialization. The
dsreplication initialize
subcommand performs the most efficient copy of data needed to initialize one or more replicas on a target server. Existing data on the target server replica is lost and the backend containing the base DN is taken offline on the target server during the initialization. - Binary copy
-
The database copy method involves copying database backup files from the source PingDirectory server to one or more target servers. The PingDirectory server provides tools necessary for backing up and restoring backends. Using
server-root/bin/backup
, create a backup of the backend containing the replicated base DN. The backup files must then be transferred to the target servers and restored individually withserver-root/bin/restore
. There are additional considerations when using database copy as the means to initialize a target replica:-
If encryption is enabled on the servers, then a database
bin/encryption-settings export
followed bybin/encryption-settings import
must be performed on theencryption-settings
backend. -
When using database copy to initialize a server that has been offline longer than the replication purge delay, the database copy of the
replicationChanges
,schema
, andadminRoot
backends are required.
-
- Import/export LDIF
-
The import/export LDIF method is the most flexible approach, as it works well in environments where target replicas are configured differently than the backend containing the data (for example, the target replica has different indexes than the source server). The process involves exporting the backend data as LDIF from the source server and importing the LDIF into the target servers. Replicas can be initialized locally while the server is offline or online through remote access. For more information, see Importing and exporting data.