Multitenant support in CA Spectrum

casp1031
Introduction
From the release 10.2.2, CA Spectrum supports multitenancy for CA Spectrum-CA UIM integration that is configurable in the Spectrum Gateway (spectrumgtw) probe.
The Multitenancy model in CA UIM is based on the Origin tag (Ownership). CA Spectrum-CA UIM integration leverages this origin tag information. The spectrumgtw probe allows you to map Origin with Landscape. Mapping CA UIM origins to CA Spectrum landscapes, ensures that the inventory belonging to a specific origin is modeled in the landscape it is mapped to.
To enable and configure multitenancy, you need to install spectrumgtw probe v8.64 on CA UIM 8.51 or 8.51 SP1 This capability is not supported by previous versions of the probe. You also need to deploy the webservices_rest package version 8.51 or later on the same robot where UMP is deployed.
The following diagram outlines the process to enable multitenancy in CA Spectrum.
Multi-tenancy Configuration workflow
Multi-tenancy Configuration workflow
In deployments where there is a clear distinction in terms of CA UIM and CA Spectrum installation setups, i.e. one UIM hub and one SpectroSERVER per tenant (where the tenant has one origin), simply mapping origin to landscape is enough.
However, for deployments where there are multiple origins per tenant (with overlapping IP addresses that need to be modeled in same landscape), or where entities of multiple UIM tenants have to be modeled in the same landscape, you need to configure Secure Domain Connectors on the landscape and map the SDC + landscape combination to an origin.
The probe retrieves the list of origins in your CA UIM environment. You can then map your CA Spectrum landscapes to CA UIM origins. 
While you can map multiple origins to the same landscape, the same origin cannot be mapped to multiple landscapes.
How multitenancy works in the CA Spectrum-CA UIM integration
Once you manually map the origins to landscapes, using REST calls provided by CA Spectrum, spectrumgtw probe sends the Origin to Landscape mapping. These mappings are sent to CA Spectrum every time CA Spectrum OneClick server or spectrumgtw probe restarts. Once the mappings are in place, Spectrum ensures that entities belonging to an origin are modeled on the landscape, it's origin is mapped to.
The spectrumgtw probe restarts every time you change a mapping and save the configuration
When spectrumgtw probe gets alarms from CA Spectrum, the probe determines the landscape for each alarm and fetches the corresponding origin (by checking against the mapping and filling the origin in the alarm) before sending it to CA UIM.
Until Spectrum 10.2.2, at the most two UIM Event admin models were created (one in selected landscape and another in MLS if the selected SS is down) to handle alarms coming from CA UIM. When origins are mapped to landscapes then one UIM event Admin model is created per landscape as specified in the map. This allows segregation of alarms into their respective landscapes. 
Event models are created for alarms whose IP or host name are not present in CA Spectrum. In cases like overlapping IPs or duplicate host names, chances are that same event model is used as a place holder for asserting such alarms. Now origin in the alarm will be used to identify the correct event model to assert the alarm.
Configuring Multitenancy for CA Spectrum-CA UIM Integration
To enable multitenancy, follow these steps:
  1. In the probe Admin Console, navigate to the spectrumgtw probe configuration interface/ GUI.
  2. In the 
    UMP Connection Details
     section, enable the 
    Configure multitenancy
     option, update the UMP details and save the configuration.
    The probe configuration interface displays the 
    Multitenant Mapping 
    node. 
  3. In the 
    Multitenant Mapping 
    node > 
    Landscape Mapping
     section, click 
    New
     to create a new landscape to origin mapping.
  4. Map CA UIM Origins to CA Spectrum Landscapes, from the list of options displayed and save the mapping changes.
  5. In the OneClick Administration web server, click the Administration tab and navigate to the UIM Configuration page.
  6. Update the integration configuration details, enable the integration(s).
  7. Test and Save the integration.
For more information about configuring and enabling multitenancy on the spectrumgtw probe, see spectrumgtw Advanced Configuration.