Previous Topic: Rules for Mapping File EntriesNext Topic: Prepare to Run the Common Tenant Merge Utility

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

Sample Common Tenant Mapping File

When you configure common tenant administration, a required task is creating the common tenant mapping file. Review the following sample common tenant mapping file to help you construct your own file:

... 
# CA Service Catalog Tenants (id, name)
# ca.222.com   ca.222.com
# 00234A51DC4A4F70A03D3BDE5526278C	  BB
# 9F6309A0CB654781B08080AD78C2280F	  CC
# 9CF5655B4B8D4833A0C6E74EB56128C5	  AA
# 
# CA Service Desk Manager Tenants (id, name)
# 0xB3484A535A3D994B9FBCD28D3845F292   ca.111.com
# 0xBB83719AA93DFC48B909D7D72CF8B0CB   A
# 0xD9DC8FF2EB84CC43988FE71F4B489D3D   E
# 0x67958EA983987D42AB2A4BAEF808C029   D
#
# Service Provider tenants must map to each other. This mapping is mandatory.
0xB3484A535A3D994B9FBCD28D3845F292=ca.222.com
#
# Map A to AA
0xBB83719AA93DFC48B909D7D72CF8B0CB=9CF5655B4B8D4833A0C6E74EB56128C5
...

In this example, the following tenants exist:

Service Provider tenants must map to each other. For this reason, you merge the CA Service Desk Manager Service Provider tenant (ca.222.com) and the CA Service Catalog Service Provider tenant (ca.111.com).

Otherwise, you add a mapping entry only when you want to merge two tenants together. For example, in the sample file, you merge CA Service Desk Manager tenant A and CA Service Catalog tenant AA.

When you merge tenants, the CA Service Desk Manager tenant overwrites all common attributes in the CA Service Catalog tenant, but CA Service Catalog-specific attributes remain intact. Thus, after you run the common tenant merge utility with this sample file, the tenant ca.222.com in CA Service Catalog is renamed ca.111.com. Similarly, tenant AA in CA Service Catalog is renamed A. Each of these tenants also inherits the other common attributes of the CA Service Desk Manager tenant with which it was merged.

If you are simply adding tenants from one product to the other, you do not need to map them in the common tenant mapping file. For this reason, the sample file does not map any other tenants. Thus, the following changes occur when you run the common tenant merge utility with this sample file: