Managing Business Units and Accounts › How to Configure Common Tenant Administration › Run the Common Tenant Merge Utility

Run the Common Tenant Merge Utility

When you configure common tenant administration, a required task is running the common tenant merge utility.

Follow these steps:

1. On the computer where the MDB is installed, open the CA Service Catalog command prompt by clicking Start, Programs, CA, Service Delivery, Service Delivery Command Prompt.
2. At the CA Service Catalog command prompt, enter the following command:

   ant merge-tenants
   

   The command runs. The utility prompts you for the information that you collected when you prepared to run this utility.

3. Continue answering the prompts until the utility stops prompting you.

   If the utility detects one or more invalid mappings in the common tenant mapping file, the utility aborts, and you receive an error message. In such cases, correct the error in the file and run the utility again.

   Important! If the same name is used for two or more tenants being created in CA Service Desk Manager, a warning message is issued, and the utility aborts. In such cases, check each product's tenant structure, rename any duplicate tenant names to be unique, and re-run the utility.

   Otherwise, the utility runs and performs the following tasks:

   • Summarizes the changes to be made in each product's tenant table in the MDB before making the changes
   • Creates any missing tenants in those tables
4. Restart the CA Service Catalog services that you stopped at the beginning of this procedure.
5. Start CA Service Catalog and CA Service Desk Manager, and verify that the tenant structure and common attributes of tenants are the same in both products.

You have run the common tenant merge utility.