Managing Business Units and Accounts › How to Configure Common Tenant Administration › How to Create the Common Tenant Mapping File

How to Create the Common Tenant Mapping File

When you configure common tenant administration, a required task is creating the common tenant mapping file. To create the common tenant mapping file, follow this process:

1. Review the tenant structures in CA Service Catalog and CA Service Desk Manager, and plan the merged structure that you want to use for both. If necessary, map the structure by hand or by using modeling or graphics software. Keep the drawing or print version of the structure on hand for reference while completing these steps.
2. At the computer where the MDB is installed, using the Windows Control Panel, stop these CA Service Catalog services: CA Service Accounting, CA Service Catalog, and CA Service Fulfillment (if used).
3. Run the ant command to create the mapping file.
4. Open the mapping file. After the Service Provider mapping entry, add a new line for each new mapping entry that you create. Specify each entry using the following format, using the Service Provider entry as a model:

   CA Service Desk Manager business unit ID=CA Service Catalog business unit ID
   

   For example:

   0x60B4EAC8B85E41DH97E647CF84A93CFA=87958EK983987D42AB2A4PAEF808C129

   Important! Mapping a parent tenant maps the parent only, not the children! Therefore, to cause the automatic mapping noted in the next step, do the following: Either map parents and children individually or omit the mapping of the parent.

5. Follow the rules for creating entries in the common tenant mapping file.
6. Review the sample common tenant mapping file to become more familiar with the format and contents of the file and the results of running it. Use the sample file to help verify the contents of your mapping file.
7. Restart the CA Service Catalog services that you stopped at the beginning of this procedure.

You have created the common tenant mapping file. You are ready to run the utility.

Run the Ant Command to Create the File

When you configure common tenant administration, a required task is creating the common tenant mapping file. To create this file, you run the ant generate-merge-config command.

Follow these steps:

1. 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 generate-merge-config
   

   The common tenant merge utility runs and creates the tenant mapping file, which is named merge-tenants.conf. The utility does the following in this file:

   • Creates the initial mapping entry, which maps the Service Provider business units for each product to each other; this entry is the only required entry. The CA Service Catalog entry is named ca_tenant, and the CA Service Desk Manager entry is named usm_tenant_ext.
   • Lists the names and database IDs of all CA Service Catalog tenants
   • Lists the names and database IDs of all CA Service Desk Manager tenants

   You use these names and database IDs to create the mapping entries.

3. Open the merge-tenants.conf file, using a text editor such as Notepad.

   This file is located in USM_HOME.

   If you open the file with a program that is not a text editor, save the file in text-only format.

4. Review the contents of the file and verify that the main sections listed earlier exist and appear appropriate for your enterprise. If they do not, verify that you have configured common multi-tenant administration before creating the mapping file. If necessary, verify your configuration and rerun the ant generate-merge-config command.

You have run the ant command to create the common tenant mapping file.