This section describes how to remove a replica. You must complete all steps; if you do not, synchronization and mastership problems can occur in other replicas in the family.
When you remove a replica, the replicas in its family stop tracking epoch numbers for that replica. Removing a replica does not delete the database.
Removing a replica requires two synchronization cycles: one to transfer mastership of all of the replica’s objects to another replica, and one to inform all other replicas that the removed replica is no longer participating in the update process. Because this information can be communicated only through the synchronization process, you cannot remove a replica at its own site, because doing so prevents the replica from creating update packets.
After a replica is removed from a family, it no longer participates in synchronization activities and MultiSite information is not tracked. The replica no longer updates its oplog, and you cannot transfer mastership of any object in that replica.
To remove a replica that is still accessible and functioning, perform the following steps. The example syntax shows how to remove the replica in the DOC family at site tokyo and decommission the site named tokyo for a clan that also includes sites sanfran_hub and boston_hub (which contains the working schema repository). Each command must be entered on a single physical line.
At site tokyo, run this command:
multiutil chmaster -clan telecomm -site tokyo -family DOC -user masako -password secret boston_hub -all -long
If the chmaster command reports errors, fix them and run the command again.
At site tokyo, run this command:
multiutil chmaster -clan telecomm -site tokyo -family MASTR -user masako -password secret boston_hub -all -long
If the chmaster command reports errors, fix them and run the command again.
At site tokyo, run this command:
multiutil syncreplica -export -clan telecomm -site tokyo -family DOC -user masako -password secret -workdir c:\work -fship boston_hub
At site boston_hub, run this command:
multiutil syncreplica -import -clan telecomm -site boston_hub -family DOC -user susan -password passwd -receive
At site boston_hub, run this command:
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user susan -password passwd -workdir c:\work -fship sanfran_hub
At site sanfran_hub, run this command:
multiutil syncreplica -import -clan telecomm -site sanfran_hub -family DOC -user jcole -password secret -receive
At site boston_hub, run this command:
multiutil rmreplica -clan telecomm -site boston_hub -family DOC -user susan -password passwd tokyo
At site boston_hub, run this command:
multiutil rmreplica -clan telecomm -site boston_hub -family MASTR -user susan -password passwd tokyo
At site boston_hub, run this command:
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user susan -password passwd -workdir c:\work -fship sanfran_hub
At site sanfran_hub, run this command:
multiutil syncreplica -import -clan telecomm -site sanfran_hub -family DOC -user jcole -password secret -receive
Note: Rational does not support the use of a database after it has been removed from a clan using rmreplica. Attempting to use such a database may result in data corruption.
If you have a site whose databases have been damaged beyond repair or deleted without a backup, and you want to remove the site from the clan, perform the following steps. The examples show how to remove the replica in the DOC family at site tokyo and decommission the site tokyo from a clan that also includes sites sanfran_hub and boston_hub (which contains the working schema repository). Each command must be entered on a single physical line.
At site boston_hub, run this command:
multiutil chmaster -clan telecomm -site boston_hub -family DOC -user admin -password secret boston_hub -all -force tokyo
At site boston_hub, run this command:
multiutil chmaster -clan telecomm -site boston_hub -family MASTR -user admin -password secret boston_hub -all -force tokyo
At site boston_hub, run this command:
multiutil rmreplica -clan telecomm -site boston_hub -family DOC -user admin -password secret tokyo
At site boston_hub, run this command:
multiutil rmreplica -clan telecomm -site boston_hub -family MASTR -user admin -password secret tokyo
At site boston_hub, run this command:
multiutil syncreplica -export -clan telecomm -site boston_hub -family DOC -user admin -password secret -workdir c:\work -fship sanfran_hub
At site sanfran_hub, run this command:
multiutil syncreplica -import -clan telecomm -site sanfran_hub -family DOC -user admin -password secret -receive