1ipa-csreplica-manage(1)      FreeIPA Manual Pages      ipa-csreplica-manage(1)
2
3
4

NAME

6       ipa-csreplica-manage - Manage an IPA CS replica
7

SYNOPSIS

9       ipa-csreplica-manage  [OPTION]...  [connect|disconnect|del|list|re-ini‐
10       tialize|force-sync]
11

DESCRIPTION

13       Manages the CA replication agreements of an IPA server.
14
15       connect [SERVER_A] <SERVER_B>
16              - Adds a new replication  agreement  between  SERVER_A/localhost
17              and SERVER_B
18
19       disconnect [SERVER_A] <SERVER_B>
20              - Removes a replication agreement between SERVER_A/localhost and
21              SERVER_B
22
23       del <SERVER>
24              - Removes all replication agreements and data about SERVER
25
26       list [SERVER]
27              - Lists all the servers or the list of agreements of SERVER
28
29       re-initialize
30              - Forces a full re-initialization of the IPA CA server  retriev‐
31              ing data from the server specified with the --from option
32
33       force-sync
34              -  Immediately  flush  any  data  to be replicated from a server
35              specified with the --from option
36
37       The connect and disconnect options are used to manage  the  replication
38       topology.  When a replica is created it is only connected with the mas‐
39       ter that created it. The connect option may be used to  connect  it  to
40       other existing replicas.
41
42       The  disconnect  option  cannot  be  used  to remove the last link of a
43       replica. To remove a replica from the topology use the del option.
44
45       If a replica is deleted and then re-added  within  a  short  time-frame
46       then  the  389-ds  instance  on  the  master  that created it should be
47       restarted before re-installing the replica. The master  will  have  the
48       old service principals cached which will cause replication to fail.
49

OPTIONS

51       -H HOST, --host=HOST
52              The  IPA  server to manage.  The default is the machine on which
53              the command is run Not honoured by the re-initialize command.
54
55       -p DM_PASSWORD, --password=DM_PASSWORD
56              The Directory Manager password to use for authentication
57
58       -v, --verbose
59              Provide additional information
60
61       -f, --force
62              Ignore some types of errors
63
64       --from=SERVER
65              The server to pull the data from, used by the re-initialize  and
66              force-sync commands.
67

EXAMPLES

69       List a server's replication agreements.
70               # ipa-csreplica-manage list srv1.example.com
71               srv2.example.com
72               srv3.example.com
73
74       Re-initialize a replica:
75               # ipa-csreplica-manage re-initialize --from srv2.example.com
76
77              This will re-initialize the data on the server where you execute
78              the command,  retrieving  the  data  from  the  srv2.example.com
79              replica
80
81       Add a new replication agreement:
82               #   ipa-csreplica-manage  connect  srv2.example.com  srv4.exam‐
83              ple.com
84
85       Remove an existing replication agreement:
86               # ipa-csreplica-manage disconnect  srv1.example.com  srv3.exam‐
87              ple.com
88
89       Completely remove a replica:
90               # ipa-csreplica-manage del srv4.example.com
91
92       Using connect/disconnect you can manage the replication topology.
93

EXIT STATUS

95       0 if the command was successful
96
97       1 if an error occurred
98
99
100
101FreeIPA                           Jul 14 2011          ipa-csreplica-manage(1)