How to remove one replica from one clan

How to remove one replica from one clan

1. Remove one replica which is never imported into another site



We can use multiutil mkreplica –export to export one project and import the package in the destination site to create another family replica using multiutil mkreplica –import command. After each mkreplica –export command, some records will be logged into the schema db and project db before the project really setup in another site. For example, we have a family WOS in Q3 site and the clan name is OL. Now we want to make replica in another site ZH.  We run the below command to export the project in Q3 site,

multiuitl –export –cl OL –site Q3 –family WOS –u admin –p adminpwd –out c:\temp\export_wos_to_zl zhengol:ZH

After execute the command successfully, we can view the replica info in Q3 site as below (the project is not imported into ZH yet),

multiutil –lsreplica –cl OL –site Q3 –family WOS –u admin –p adminpwd
You can see that the WOS has the replica in ZH already.

Sometimes maybe the site name you type in the command is wrong; the site name should be ZL instead of ZH for example. How can we remove the replica form the master site? If we do not remove the obsolete replica and then setup the project in ZL maybe another site XX, the ZH replica can still be found in the family replicas. It may cause some error if some defects is changed its mastership to ZH wrongly. We use above scenario to remove the ZH replica records in Q3 (master) site.

multiutil –rmreplica –cl OL –site Q3 –family WOS –u admin –p adminpwd ZH

If the project is created in other sites, need to sync the package into other sites.
Pls note that even the ZH replica removed, it still can be viewed by the multiuitl lsreplica but the ZH can not be viewed in ClearQuest mastership dropdown list.




2.      Remove one functionality replica

Supposed we have one clan OL with family WOS in OL and Q3 (Master) sites. Now we want to remove the WOS replica from OL site. Here are the steps,

a.      change mastership of all objects in WOS project from OL to Q3 in OL site

multiutil chmaster –cl OL –site ZL –family WOS –u admin –p adminpwd Q3 –all –long

b.      sync the updated package from OL to Q3

multiutil syncreplica –export –cl OL –site ZL –family WOS –u admin –p adminpwd –out c:\temp\syncout.txt Q3
In Q3 site, import the package
multiutil syncreplica –import –cl OL –site Q3 –family WOS –u admin –p adminpwd c:\temp\syncout.txt

c.      remove WOS replica from OL site in master site

In the master site Q3, run the command as blow,
multiutil rmreplica –cl OL –site Q3 –family WOS –u admin –p adminpwd ZL

               Here are some cases need be mentioned here,

1. If the OL site has only one family WOS and is not used any more, we should change mastership of the user/groups from OL to Q3 before above step b. Here is the command in OL site,

multiutil chmaster –cl OL –site ZL –family Mastr –u admin –p adminpwd Q3 –all –long

b.      If we have another site named JC, we need to sync the update info from Q3 to JC after above step c.

c.      For the removed replica+site, we can not use it any more. As this case, after remove the WOS from OL site, we can not make replica of WOS in OL site again. That means it will fail if run below command

multiutil mkreplica –export –cl OL –site Q3 –family WOS –u admin –p adminpwd –out c:\temp\wos_out_to_ZL zhengol:ZL