Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

28.6. Removing a Replica

Deleting or demoting a replica removes the IdM replica from the server/replica topology so that it no longer processes IdM requests and it also removes the host machine itself from the IdM domain.
  1. On an IdM server, obtain a Kerberos ticket before running IdM tools. 
    [root@replica ~]# kinit admin
    Copy to Clipboard Toggle word wrap
  2. List all of the configured replication agreements for the IdM domain. 
    [root@replica ~]# ipa-replica-manage list
Directory Manager password:

ipaserver.example.com: master
ipaserver2.example.com: master
replica.example.com: master
replica2.example.com: master
    Copy to Clipboard Toggle word wrap
  3. Removing the replica from the topology involves deleting all the agreements between the replica and the other servers in the IdM domain and all of the data about the replica in the domain configuration. 
    [root@replica ~]# ipa-replica-manage del replica.example.com
    Copy to Clipboard Toggle word wrap
  4. If the replica was configured with its own CA, then also use the ipa-csreplica-manage command to remove all of the replication agreements between the certificate databases for the replica.
    This is required if the replica itself was configured with a Dogtag Certificate System CA. It is not required if only the master server or other replicas were configured with a CA. 
    [root@replica ~]# ipa-csreplica-manage del replica.example.com
    Copy to Clipboard Toggle word wrap
  5. On the replica, uninstall the replica packages. 
    [root@replica ~]# ipa-server-install --uninstall -U
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat