spectrumgtw Advanced Configuration

This article describes the concepts and procedures to configure the following advanced properties of the spectrumgtw (Spectrum Gateway) probe.
uimpga-ga
spectrumgtw_Advanced_Config
This article describes the concepts and procedures to configure the following advanced properties of the spectrumgtw (Spectrum Gateway) probe.
3
2
This article is for spectrumgtw probe versions 8.64 and later.
Configure Multi-Tenant Mapping
You can map your UIM origins to multiple landscapes within your DX NetOps Spectrum environment. You can then map each landscape to an origin in your UIM environment.
The following diagram outlines the process to configure multi-tenancy in the spectrumgtw probe.
Configuring spectrumgtw multi-tenancy
Configuring spectrumgtw multi-tenancy
Verify Prerequisites
For multi-tenant synchronization, the probe version 8.64 or later requires the following software in addition to the requirements specified in Spectrumgtw Release Notes.
  • CA Unified Infrastructure Management 8.51 or later
  • DX NetOps Spectrum 10.2.2 or later
  • webservices_rest package version 8.51 or later on the same robot where UMP is deployed
Enable Multi-tenant Origins
The probe retrieves the list of origins in your UIM environment. You can now map your UIM origins to DX NetOps Spectrum landscapes, which helps in modeling the inventory belonging to a specific origin in the mapped landscape.
Follow these steps:
  1. Upgrade the probe to version 8.64 or later.
  2. Open the probe configuration interface.
  3. In the
    spectrumgtw
    node >
    UMP Connection Details
    section, select
    Configure Multi-tenancy
    to enable the probe to connect to multiple DX NetOps Spectrum landscapes.
  4. Update the following information to configure identification details of the UMP to retrieve UIM origin information. CA recommends you to specify the details of the UMP deployment within your UIM environment.
    • Hostname/IP
      : specifies the hostname of the system where the CA UMP is deployed.
    • Username
      : specifies the UIM user that can access the UMP. The probe retrieves the list of origins as applicable for the user.
    • Password
      : specifies the password for the UIM user.
    • Port
      : specifies the port of your CA UMP deployment.
  5. Click
    Actions
    >
    Validate Connection
    to verify the connection to the CA UMP deployment.
  6. Save the configuration.
The probe configuration interface displays the
Multi-tenant Mapping
node.
Map DX NetOps Spectrum Landscapes to UIM Origins
The probe automatically maps information from your landscapes to the primary hub of your UIM environment.
Till you have completed configuring the origin to landscape mapping following the steps below, the spectrumgtw probe pauses/does not process alarm synchronization jobs.
Follow these steps:
  1. In the
    Multi-tenant Mapping
    node >
    Spectrum-UIM Mapping
    section, click
    New
    to create a new mapping.
  2. Update the following information to map DX NetOps Spectrum landscapes to UIM hubs:
    • DX NetOps Spectrum Landscape
      : allows you to select from the DX NetOps Spectrum landscapes from the drop-down list. The probe lists landscapes and landscapes + associated SDC combinations.
    • UIM Origin
      : allows you to select from the UIM origins from the drop-down list. You can map multiple landscapes to a single origin.
  3. Save the configuration.
  4. (Optional)
    In the
    spectrumgtw
    node >
    Spectrum Configuration
    section, click
    Actions
    >
    Synchronize Multi-tenant Information
    to retrieve the list of landscapes again.
See the Admin Console GUI for the Multi-Tenancy section below, for your reference:
Spectrum-UIM Mapping
Map UIM Origins to DX NetOps Spectrum Landscapes
The probe automatically maps information from the primary hub of your UIM environment to your landscapes.
Follow these steps:
  1. To map Origins to Landscapes, navigate to the
    Spectrum-UIM Mapping
    section, click
    New
    to create a new mapping.
  2. Update the following information to map UIM hubs to DX NetOps Spectrum landscapes:
    • UIM Origin
      : allows you to select from the UIM origins from the drop-down list. You can map multiple origins to a single landscape
    • DX NetOps Spectrum Landscape
      : allows you to select from the DX NetOps Spectrum landscapes from the drop-down list. The probe lists landscapes and landscapes + associated SDC combinations.
  3. Save the configuration.
See the Admin Console GUI for the Multi-Tenancy section below, for your reference:
UIM-Spectrum Mapping
Synchronize Specific Alarms
You can filter that alarms that the spectrumgtw probe synchronizes between UIM and DX NetOps Spectrum.
Alarm Filter Attributes
The probe uses alarm attributes for filters.
Alarm Attribute
Description
Attribute Value Type
Assigned To
applies the filter to alarms assigned to the specified user
String
Cause Code
applies the filter to alarms with a specific cause code
Numeric
Hostname
applies the filter to alarms for the specified hostname
String
Level
applies the filter to alarms of the specified severity
Numeric
Message
applies the filter to alarms with the specified message text
String
Primary IPv4 Address
applies the filter to alarms for devices with the specified primary IPv4 address
String
Significant Model IP
applies the filter to alarms for devices with the specified significant model IP
String
User Clearable
applies the filter to alarms that the user can clear
String (uses True or False values)
Alarm Filter Operators
Each attribute in the probe allows string or numeric comparison operators.
Operator
Description
String Values
Numeric Values
Contains
applies the filter to alarms that include the specified string in the attribute
Yes
No
Does Not Contain
applies the filter to alarms that do not include the specified string in the attribute
Yes
No
Does Not End With
applies the filter to alarms that do not end with the specified string in the attribute
Yes
No
Does Not Start With
applies the filter to alarms that do not start with the specified string in the attribute
Yes
No
Ends With
applies the filter to alarms that end with the specified string in the attribute
Yes
No
Starts With
applies the filter to alarms that start with the specified string in the attribute
Yes
No
Equals To
applies the filter to alarms that exactly matches the specified string or number in the attribute
Yes
Yes
Does Not Equals To
applies the filter to alarms that exactly does not match the specified string or number in the attribute
Yes
Yes
Greater Than
applies the filter to alarms when the number in the attribute is more than the specified value
No
Yes
Greater Than Equals To
applies the filter to alarms when the number in the attribute is more than or equal to the specified value
No
Yes
Less Than
applies the filter to alarms when the number in the attribute is less than the specified value
No
Yes
Less Than Equals To
applies the filter to alarms when the number in the attribute is less than or equal to the specified value
No
Yes
Filter DX NetOps Spectrum Alarms
You can filter the alarm synchronization from DX NetOps Spectrum to UIM. For example, you can filter alarms that only contain the text
Secure
in the alarm message.
Follow these steps:
  1. Navigate to the
    spectrumgtw > Alarm Filters > DX NetOps Spectrum Alarm Filters
    node.
  2. Update the following information in the
    Filter Configuration
    section:
    • Enable Alarm Filters:
      enables the filters for alarm synchronization.
      Default: Not Selected
    • Filter Criteria
      : specifies the criteria that the probe applies on filters from the following options.
      • All Filters
        : synchronizes alarms that match all filter criteria. This is the default selection.
      • Any Filter
        : synchronizes alarms that match any filter criteria.
      For example, you can create separate filters for text in alarm message for
      Secure
      and
      Mode
      . If you select
      All Filters
      , the probe only synchronizes alarms with both
      Secure
      and
      Mode
      in the message text. If you select
      Any Filter
      , the probe synchronizes alarms with
      Secure
      or
      Mode
      or both
      Secure
      and
      Mode
      in the message text.
  3. In the
    Filters
    section, click
    New
    to add a filter to the probe.
  4. Update the following information to configure the filter. For more information about attributes and operators, see the Synchronize Specific Alarms section.
    • Enable Filter:
      enables the filter for alarm synchronization.
      Default: Selected
    • Filter Name:
      specifies a unique name for the filter.
    • Attributes:
      specifies the alarm attribute that the filter is applicable for
    • Operator:
      specifies the comparison operator for the filter.
    • Value:
      specifies the value of the alarm attribute that the probe uses to filter alarms.
  5. Click
    Save
    .
Filter UIM Alarms
You can filter the alarm synchronization from UIM to DX NetOps Spectrum. For example, you can filter alarms that only contain the text
Secure
in the alarm message.
Follow these steps:
  1. Navigate to the
    spectrumgtw > Alarm Filters > UIM Alarm Filters
    node.
  2. Update the following information in the
    Filter Configuration
    section:
    • Enable Alarm Filters:
      enables the filters for alarm synchronization.
      Default: Not Selected
    • Filter Criteria
      : specifies the criteria that the probe applies on filters from the following options.
      • All Filters
        : synchronizes alarms that match all filter criteria. This the the default selection.
      • Any Filter
        : synchronizes alarms that match any filter criteria.
      For example, you can create separate filters for text in alarm message for
      Secure
      and
      Mode
      . If you select
      All Filters
      , the probe only synchronizes alarms with both
      Secure
      and
      Mode
      in the message text. If you select
      Any Filter
      , the probe synchronizes alarms with
      Secure
      or
      Mode
      or both
      Secure
      and
      Mode
      in the message text.
  3. In the
    Filters
    section, click
    New
    to add a filter to the probe.
  4. Update the following information to configure the filter. For more information about attributes and operators, see the Synchronize Specific Alarms section.
    • Enable Filter:
      enables the filter for alarm synchronization.
      Default: Selected
    • Filter Name:
      specifies a unique name for the filter.
    • Attributes:
      specifies the alarm attribute that the filter is applicable for.
    • Operator:
      specifies the comparison operator for the filter.
    • Value:
      specifies the value of the alarm attribute that the probe uses to filter alarms.
  5. Click
    Save
    .