6330N/A<?
xml version="1.0" encoding="UTF-8"?>
6330N/A ! This work is licensed under the Creative Commons 6330N/A ! Attribution-NonCommercial-NoDerivs 3.0 Unported License. 6330N/A ! To view a copy of this license, visit 6330N/A ! or send a letter to Creative Commons, 444 Castro Street, 6330N/A ! Suite 900, Mountain View, California, 94041, USA. 6330N/A ! You can also obtain a copy of the license at 6330N/A ! See the License for the specific language governing permissions 6330N/A ! and limitations under the License. 6330N/A ! If applicable, add the following below this CCPL HEADER, with the fields 6330N/A ! enclosed by brackets "[]" replaced with your own identifying information: 6330N/A ! Portions Copyright [yyyy] [name of copyright owner] 6330N/A ! Copyright 2011-2012 ForgeRock AS 6330N/A ! Portions Copyright 2013 Jens Elkner 6330N/A version="5.0" xml:
lang="en" 6330N/A <
refentrytitle><
application>dsreplication</
application></
refentrytitle>
6330N/A <
xi:
include href="common.xml" xpointer='xpointer(//manvolnum[@name="v1m"])'/>
6330N/A <
refname><
application>dsreplication</
application></
refname>
6330N/A <
refpurpose>manage OpenDJ directory data replication</
refpurpose>
6330N/A <
command>dsreplication</
command>
6330N/A <
arg choice="plain"><
replaceable>subcommand</
replaceable></
arg>
6330N/A <
arg>-I <
replaceable class="parameter">adminUID</
replaceable></
arg>
6330N/A xpointer='xpointer(//para[@name="s-remote"]/*)'/>
6330N/A xpointer='xpointer(//para[@name="s-auth"]/*)'/>
6330N/A xpointer='xpointer(//para[@name="s-props"]/*)'/>
6330N/A xpointer='xpointer(//para[@name="s-misc"]/*[@name="sc-quiet"])'/>
6330N/A xpointer='xpointer(//para[@name="s-general"]/*)'/>
6330N/AThis utility can be used to configure replication between servers so that the
6330N/Adata of the servers is synchronized. For replication to work you must first
6330N/Aenable replication using the <
command>enable</
command> subcommand and then
6330N/Ainitialize the contents of one of the servers with the contents of the other
6330N/Ausing the <
command>initialize</
command> subcommand.
6330N/AThe following subcommands are supported.
6330N/A $ print '<?xml version="1.0" encoding="UTF-8"?>\n<refentry>' >$FNAME 6330N/A $ print '</refentry>' >>$FNAME 6330N/A <!-- End of generated stuff --> 6330N/AThe following options are supported.
6330N/A <
term><
option>--advanced</
option></
term>
6330N/AAccess advanced settings when running this command in interactive mode.</
para>
6330N/A <
term><
option>-b, --baseDN</
option> <
replaceable 6330N/A class="parameter">baseDN</
replaceable></
term>
6330N/ABase DN of the data to be replicated, initialized or for which you want to
6330N/Adisable replication. Multiple base DNs can be provided by using this option
6330N/A <
title>LDAP Connection Options</
title>
6330N/A xpointer='xpointer(//para[@name="l-remote"]/*)'/>
6330N/A <
term><
option>-I, --adminUID</
option> <
replaceable 6330N/A class="parameter">adminUID</
replaceable></
term>
6330N/AUser ID of the global administrator to use to bind to the server. For the
6330N/A<
command>enable</
command> subcommand, if no global administrator was defined
6330N/Apreviously for any servers, the global administrator will be created using the
6330N/AUID provided (Default: admin).
6330N/A xpointer='xpointer(//para[@name="l-auth"]/*[not(@name="lc-dn")])'/>
6330N/A <
term><
option>--commandFilePath</
option> <
replaceable 6330N/A class="parameter">path</
replaceable></
term>
6330N/AThe full path to the file where the equivalent non-interactive commands will be
6330N/Awritten when this command is run in interactive mode.
6330N/A <
term><
option>--displayCommand</
option></
term>
6330N/ADisplay the equivalent non-interactive option on standard output when this
6330N/Acommand is run in interactive mode.
6330N/A <
term><
option>-n, --no-prompt</
option></
term>
6330N/AUse non-interactive mode. If data in the command is missing, the user is not
6330N/Aprompted and the command exits with an error.
6330N/A xpointer='xpointer(//para[@name="l-props"]/*)'/>
6330N/A xpointer='xpointer(//para[@name="l-misc"]/*[@name="lc-quiet"])'/>
6330N/A <
title>General Options</
title>
6330N/A xpointer='xpointer(//para[@name="l-general"]/*)'/>
6330N/AThe following example enables and then initializes replication for a new replica
6330N/A>$ </
prompt><
command>dsreplication enable -I admin -w password -X -n \
6330N/A --bindDN1 "cn=Directory Manager" --bindPassword1 password \
6330N/A --bindDN2 "cn=Directory Manager" --bindPassword2 password \
6330N/A --replicationPort2 8989</
command></
literallayout>
6330N/AEstablishing connections ..... Done.
6330N/AChecking registration information ..... Done.
6330N/AUpdating replication configuration for baseDN dc=example,dc=com on
6330N/AUpdating replication configuration for baseDN dc=example,dc=com on
6330N/AUpdating registration configuration on server
6330N/AUpdating registration configuration on server
6330N/AUpdating replication configuration for baseDN cn=schema on server
6330N/AUpdating replication configuration for baseDN cn=schema on server
6330N/AReplication has been successfully enabled. Note that for replication to
6330N/A work you must initialize the contents of the base DN's that are being
6330N/A replicated (use dsreplication initialize to do so).
6330N/Afor a detailed log of this operation.
6330N/A>$ </
prompt><
command>dsreplication initialize-all -I admin -w password -X -n \
6330N/AInitializing base DN dc=example,dc=com with the contents from
6330N/ABase DN initialized successfully.
6330N/Afor a detailed log of this operation.
6330N/A <
xi:
include href="common.xml" xpointer='xpointer(//refsection[@name="env"])'/>
6330N/A <
xi:
include href="common.xml" xpointer='xpointer(//refsection[@name="exit-0-gt0"])'/>
6330N/A <
xi:
include href="common.xml" xpointer='xpointer(//refsection[@name="seeAlso"])'/>