It was possible use ipa-replica-manage connect/disconnect/del to end up
orphaning or or more IPA masters. This is an attempt to catch and
prevent that case.
I tested with this topology, trying to delete B.
A <-> B <-> C
I got here by creating B and C from A, connecting B to C then deleting
the link from A to B, so it went from A -> B and A -> C to the above.
What I do is look up the servers that the delete candidate host has
connections to and see if we're the last link.
I added an escape clause if there are only two masters.
>From 9260967f3ef9df090df86e9705596b7cb4d322b6 Mon Sep 17 00:00:00 2001
From: Rob Crittenden <rcrit...@redhat.com>
Date: Fri, 31 Aug 2012 11:56:58 -0400
Subject: [PATCH] When deleting a master, try to prevent orphaning other
If you have a replication topology like A <-> B <-> C and you try
to delete server B that will leave A and C orphaned. It may also
prevent re-installation of a new master on B because the cn=masters
entry for it probably still exists on at least one of the other masters.
Check on each master that it connects to to ensure that it isn't the
last link, and fail if it is. If any of the masters are not up then
warn that this could be a bad thing but let the user continue if
Document how to remove a cn=masters entry in the man page.
install/tools/ipa-replica-manage | 57 ++++++++++++++++++++++++++++++++++
install/tools/man/ipa-replica-manage.1 | 12 +++++++
2 files changed, 69 insertions(+)
diff --git a/install/tools/ipa-replica-manage b/install/tools/ipa-replica-manage
index 5023d9a8d761943515c8753237db0ed5c42ab813..21e2868042c9adfbce5ff9ca5ebf8690ab5a76a6 100755
@@ -373,6 +373,48 @@ def clean_ruv(realm, ruv, options):
print "Cleanup task created"
+def check_last_link(delrepl, realm, dirman_passwd):
+ We don't want to orphan a server when deleting another one. If you have
+ A topology that looks like this:
+ A B
+ | |
+ | |
+ | |
+ C---- D
+ If we try to delete host D it will orphan host B.
+ What we need to do is if the master being deleted has only a single
+ agreement, connect to that master and make sure it has agreements with
+ more than just this master.
+ @delrepl: a ReplicationManager object of the master being deleted
+ returns: hostname of orphaned server or None
+ replica_names = delrepl.find_ipa_replication_agreements()
+ orphaned = 
+ # Connect to each remote server and see what agreements it has
+ for replica in replica_names:
+ repl = replication.ReplicationManager(realm, replica, dirman_passwd)
+ except ldap.SERVER_DOWN, e:
+ print "Unable to validate that '%s' will not be orphaned." % replica
+ if not ipautil.user_input("Continue to delete?", False):
+ names = repl.find_ipa_replication_agreements()
+ if len(names) == 1 and names == delrepl.hostname:
+ if len(orphaned):
+ return ', '.join(orphaned)
+ return None
def del_master(realm, hostname, options):
force_del = False
@@ -426,6 +468,21 @@ def del_master(realm, hostname, options):
if not ipautil.user_input("Continue to delete?", False):
+ # Check for orphans
+ masters_dn = DN(('cn', 'masters'), ('cn', 'ipa'), ('cn', 'etc'), ipautil.realm_to_suffix(realm))
+ masters = delrepl.conn.getList(masters_dn, ldap.SCOPE_ONELEVEL)
+ sys.exit("Failed read master data from '%s': %s" % (delrepl.hostname, str(e)))
+ # This only applies if we have more than 2 IPA servers, otherwise there is
+ # no chance of an orphan.
+ if len(masters) > 2:
+ orphaned_server = check_last_link(delrepl, realm, options.dirman_passwd)
+ if orphaned_server is not None:
+ print "Deleting this server will orphan '%s'. " % orphaned_server
+ print "You will need to reconfigure your replication topology to delete this server."
# 4. Remove each agreement
for r in replica_names:
diff --git a/install/tools/man/ipa-replica-manage.1 b/install/tools/man/ipa-replica-manage.1
index 4a1c489f33591ff6ac98fe7f9a16ebb6a52ee28a..3eeadd8d6f5af61d9890994f7cadf3acfdc2f3e0 100644
@@ -59,6 +59,18 @@ Each IPA master server has a unique replication ID. This ID is used by 389\-ds\-
When a master is removed, all other masters need to remove its replication ID from the list of masters. Normally this occurs automatically when a master is deleted with ipa\-replica\-manage. If one or more masters was down or unreachable when ipa\-replica\-manage was executed then this replica ID may still exist. The clean\-ruv command may be used to clean up an unused replication ID.
\fBNOTE\fR: clean\-ruv is \fBVERY DANGEROUS\fR. Execution against the wrong replication ID can result in inconsistent data on that master. The master should be re\-initialized from another if this happens.
+The replication topology is examined when a master is deleted and will attempt to prevent a master from being orphaned. For example, if your topology is A <\-> B <\-> C and you attempt to delete master B it will fail because that would leave masters and A and C orphaned.
+The list of masters is stored in cn=masters,cn=ipa,cn=etc,dc=example,dc=com. This should be cleaned up automatically when a master is deleted. If it occurs that you have deleted the master and all the agreements but these entries still exist then you will not be able to re-install IPA on it, the installation will fail with:
+An IPA master host cannot be deleted or disabled
+Use ldapdelete to remove these entries:
+ $ kinit admin
+ $ ldapdelete -vr -Y GSSAPI cn=ipa.example.com,cn=masters,cn=ipa,cn=etc,dc=example,dc=com
+This should only be used as a last resort.
\fB\-H\fR \fIHOST\fR, \fB\-\-host\fR=\fIHOST\fR
Freeipa-devel mailing list