spectrumgtw (Spectrum Gateway) Release Notes

The Spectrum Gateway (spectrumgtw) probe enables bidirectional integration between DX NetOps Spectrum and UIM. You can view and manage alarms using UIM and DX NetOps Spectrum. The probe inventory synchronizes DX NetOps Spectrum inventory only through the Global Collections in DX NetOps Spectrum. The probe always asserts new alarms from UIM as new alarms in DX NetOps Spectrum.
uimpga-ga
spectrumgtw_RN
The Spectrum Gateway (spectrumgtw) probe enables bidirectional integration between DX NetOps Spectrum and UIM. You can view and manage alarms using UIM and DX NetOps Spectrum. The probe inventory synchronizes DX NetOps Spectrum inventory only through the Global Collections in DX NetOps Spectrum. The probe always asserts new alarms from UIM as new alarms in DX NetOps Spectrum.
For the latest Spectrum-UIM integration compatibility information, refer to DX NetOps Spectrum and DX UIM Interoperability page.
UIM service desk gateway probes manage tickets in connected service desks. DX NetOps Spectrum alarms are not annotated with information about root cause and symptomatic conditions in these tickets. For example, a service desk gateway probe in UIM generates a ticket in the service desk for a DX NetOps Spectrum alarm. When DX NetOps Spectrum identifies the alarm as symptomatic to another alarm from DX NetOps Spectrum, the ticket for the initial alarm is not annotated with the information.
Contents:
Revision History
This section describes the history of the revisions for the spectrumgtw probe.
Support cases may not be viewable to all customers.
Version
Description
State
Date
8.69
What's New
  • Upgraded Graph Transform Library to graph-transform-0.0.7
  • Added configuration to enable/disable VMotion Sync with default value as true, that is, VMotionSync enabled
  • Improvements to Queue Subscription mechanism for vMotion updates
    - Creating spectrumgtw_udm queue only if both Vmware sync and vMotion sync enabled.
    - Monitoring queue subscription every 10 sec [can be configurable] and re-subscribing if the queue is disconnected
    - Before every Vmware full sync, queue if exists will be deleted and re-created. Ensuring that queue monitoring thread is completed while deleting the queue
    .
Fixed Defects:
Symptom:
Spectrumgtw sends false alarm updates to Spectrum when there is no change to the UIM custom attributes which is resulting in unnecessary email notifications from Spectrum.
Resolution:
Added additional validation in Spectrumgtw to find actually updated attributes from the UIM alarm update. With this change.
  • Spectrumgtw does not send alarm updates when the value of custom attributes is not updated.
  • The alarm update payload includes only the changed attributes.
For more information on the integrated product and probe versions compatible with spectrumgtw, see DX NetOps Spectrum and DX UIM Interoperability.
GA
March 2021
8.68
What's New
Install the PTF 10.04.02.PTF_10.4.203 to get the following features and enhancements:
  • Multitenancy Enhancements:
    Added support to map multiple origins to a Single Spectrum Landscape so that hosts from multiple Hubs can be modeled in a specific SpectroServer. Similarly, Devices from Multiple Spectrum Landscapes can be modeled in UIM with a specific Origin.
  • VMware probe managed entities are filtered as part of Host Server synchronization by default. This is to avoid duplicate models in Spectrum when a UIM Host/robot is also managed by a VMware probe. This can be controlled using the attribute
    FilterVMwareEntities
    under
    Raw Configuration > setup > HostServerConfiguration
    section.
  • When Host Server Integration or VMware Integration is disabled in Spectrumgtw, the respective hosts or virtual machines get deleted from Spectrum automatically.
  • Maintenance Schedules Synchronization:
      Added an action "Sync Maintenance Schedules" in Spectrumgtw > Spectrum Configuration section for on-demand synchronization of maintenance schedules.
  • Added a field "Ticketing System Integrated In" in the Spectrumgtw probe Configuration page which can be set to Spectrum or UIM. This helps to sync troubleshooter and troubleTicketID in one direction which prevents overwrites.
  • SpectrumgtwUdm queue has been created with the default size of 100 to process vMotion data and it is configurable to by changing the value of the attribute SpectrumgtwUdmQueueBulkSize in VMServerConfiguration section of spectrumgtw.cfg.
  • The minimum value of the queue size is 100 which is configured as the default value. To change the value of queue size, deactivate the probe and change the value and start the probe.
For more information on the integrated product and probe versions compatible with spectrumgtw, see DX NetOps Spectrum and DX UIM Interoperability.
GA
September 2020
8.67
What's New:
  • Provided support for filtering UIM VMware entities to be synchronized in Spectrum using a UIM Group. For more information refer to the UIM Group Name for VMware section in the AC Configuration page.
  • Provided support for spectrumgtw in a UIM High Availability (HA) environment using the HA probe (v.1.46)
    *
    . For instructions on deploying spectrumgtw in a UIM HA environment, see Deploy spectrumgtw in a UIM HA Environment.
For more information on the integrated product and probe versions compatible with spectrumgtw, see DX NetOps Spectrum and DX UIM Interoperability.
GA
January 2019
8.66
What's New:
  • Enhanced HTTPS connection between the spectrumgtw probe and Spectrum OneClick for successful communication.
    (From spectrumgtw probe v8.66) It is required to import SSL Certificate of DX NetOps Spectrum OneClick server into the keystore of spectrumgtw probe for the successful communication.
  • Provided support for secured connection (HTTPS) between UIM and DX NetOps Spectrum.
In SSL environment, after upgrading to spectrumgtw probe 8.66 ensure that SSL certificate of DX NetOps Spectrum OneClick is imported to keystore of spectrumgtw probe. Otherwise, connection to Spectrum OneClick server fails. For instructions, see Import DX NetOps Spectrum SSL (https) Certificate into Spectrum Gateway Probe.
Following are the dependent probes versions for spectrumgtw probe 8.66:
  • EMS probe - v10.17 or higher
  • NAS probe - v9.00 or higher
  • maintenance_mode probe - v8.53
  • Spectrum UIM Services - v8.66
Fixed Defects:
  • The spectrumgtw probe uses wrong TLS protocol version (1.1) with java version 1.8 for HTTPS communication. Changed the TLS protocol version to 1.2 to use for Java version 1.8 and above. Support case number 0100484
GA
September 2018
8.65
What's New:
  • Moved the integration configuration GUI for Host Servers, VMware, and Alarm synchronization to the probe Admin Console from DX NetOps Spectrum OneClick Admin.
  • Added support for maintenance mode schedule synchronization between DX NetOps Spectrum and UIM.
  • Showing the vMotion changes reflection in DX NetOps Spectrum hierarchy is enhanced.
  • Enhanced the spectrumgtw probe 8.65 version to allow the Spectrum users to customize (changing the severity) UIM alarms in DX NetOps Spectrum.
GA
February 2018
8.64
What's New:
  • Added support for the following advanced features. For more information, see spectrumgtw Configure Multi-Tenancy.
    • Configure multi-tenant UIM origins for each DX NetOps Spectrum landscape
    • Synchronize specific alarms using filters
  • UIM generated alarms can be either root cause or symptom alarm. This categorization is supported only for EMS alarms. NAS alarms cannot be categorized as root cause or symptom. For routing legacy NAS alarms to EMS, refer the Deploy the Alarm Routing Service and Configure Legacy Alarm Routing sections.
GA
November 2017
8.61
Fixed Defect:
  • The probe was unable to synchronize values of User Tag 1 and User Tag 2 fields in alarms from UIM to DX NetOps Spectrum.
    Support case number 693640
GA
April 2017
8.60
What's New:
  • Added support to synchronize the following SNMP device details from the connected DX NetOps Spectrum Global Collection to Operator Console.
    • SNMP profiles
    • Community strings or attributes
    Note:
    SNMP synchronization requires CA Spectrum 10.2.1 or later.
  • Added support to connect to DX NetOps Spectrum using HTTPS.
  • Added support to view details of the following UIM alarm fields in the corresponding DX NetOps Spectrum alarm details.
    • User Tag 1 and User Tag 2
    • Custom 1, Custom 2, Custom 3, Custom 4, and Custom 5
  • Added support to retrieve and publish all DX NetOps Spectrum inventory and alarms (including from outside the global collection) to UIM hub subjects. This feature enables synchronization with
    CA App Experience Analytics
    . For more details, see spectrumgtw Synchronize All DX NetOps Spectrum Inventory.
Fixed Defect:
  • The probe truncated long object names to the last 20 characters in the probe log. The probe logs also incorrectly spelt
    Information
    as
    Iformation
    .
    Support case number 697375
GA
March 2017
8.51
What's New:
  • Added support for
    UIM 8.51
    release.
GA
March 2017
8.49
Fixed Defects:
  • Incident ID from ServiceNow was not getting processed in DX NetOps Spectrum.
  • Troubleshooter that is assigned by service desk (for UIM alarms in Spectrum) getting overridden / Nullified.
  • Trouble Ticket ID updated incorrectly in Spectrum during synchronization.
  • For newly created UIM alarms, Ticket ID was getting overridden, when running full sync job immediately after an incremental sync.
Beta
January 2017
8.47
What's New:
  • Initial GA release of the spectrumgtw probe.
GA
September 2016
8.43
  • Beta version refresh
Beta
September 2016
8.41
  • Initial release of the probe
Beta
August 2016
Probe-Specific Hardware Requirements
The spectrumgtw probe is installed on systems with the following minimum resources:
  • Memory: 4 GB of RAM; The OOB configuration of the probe requires 256 MB of RAM.
  • CPU: 3-GHz dual-core processor; 32-bit or 64-bit
Probe-Specific Software Requirements
The spectrumgtw probe requires the following software environment:
  • CA Spectrum 10.1.2 or later
  • CA Unified Infrastructure Management 8.47 or later
    : The spectrumgtw probe version 8.51 and later require UIM 8.51 or later.
  • Robot 7.80 or later (recommended)
  • Java_jre version 7 or later
  • Spectrum UIM Services package on the primary hub
    Deploy the same version of the spectrumgtw probe and the Spectrum UIM Services package.
  • The ems and trellis probes on the primary hub. The probes must be of the applicable UIM version. Ensure that the
    spectrum-uim-service-impl
    service is deployed in trellis on the primary hub.
  • vmware probe version 6.72 or later to synchronize VMware inventory from UIM to DX NetOps Spectrum
The probe requires more software for advanced features. For more information, see from the following articles:
Probe Supported Operating Systems
The probe supports the following operating systems:
  • Windows Server 2008, 2012, and 2016
  • Red Hat Enterprise Linux 6
Installation Considerations
Consider the following points before you install the probe:
  • The probe only synchronizes with the DX NetOps Spectrum Global Collection that you specify in the
    spectrumgtw
    node >
    Spectrum Configuration
    section. Create a Global Collection of the devices that you want to synchronize with UIM.
  • (For bi-directional integration between UIM and DX NetOps Spectrum)
    Enable the
    DX NetOps Spectrum OneClick
    >
    UIM Configuration
    node >
    UIM Integration
    section >
    CA Spectrum-UIM Bidirectional Management
    check box and click Save. Starting from CA Spectrum 10.2.3, the integration can be configured through either CA Spectrum or spectrumgtw probe Admin Console (from v8.65).
    To configure the integration in DX NetOps Spectrum, choose the integration option as
    Legacy Integration,
    configure and select the
    CA Spectrum-UIM Bidirectional Management
    check box then click Save. To configure the integration in spectrumgtw probe, choose the integration option as
    SpectrumGateway Integration
    and click Save. Configure the integration in the
    spectrumgtw
    probe
    configuration page.
    Disable the associated profile in the snmpgtw probe, if applicable, to move from uni-directional to bi-directional integration.
  • Secure Hub & Robot (UIM 9 SP1 and above) - In a secure environment, if any probe that is installed on an independent secure robot tries to subscribe to queues in the related secure hub, the probe fails to attach to the queues. As a workaround, if the probes require reading or publish to a hub queue, then deploy the probe on the primary hub robot. For more information, see Secure Hub and Robot.
Known Issues
  • Operator Console Device hierarchy (Tree structure) might not get refreshed automatically when the DX NetOps Spectrum nodes are removed from the Global Collection. You must refresh the Operator Console page manually.
  • If a SpectroSERVER in a Fault-Tolerant setup comes up/ goes down, the
    UIM Alarm ID
    column in DX NetOps Spectrum OneClick is empty, and
    Source
    and
    Change Owner
    values are set to Default. Trigger a full synchronization job manually from the Actions menu in the spectrumgtw probe Admin Console.
  • In the DX NetOps Spectrum OneClick, alarm messages that are received from UIM are displayed with English texts, instead of the localized languages in this release. In the Unified Service Manager portlet in Operatr Console, the alarm messages are displayed with localized texts for non-English languages.
If the troubleshooter is updated for a DX NetOps Spectrum alarm on UIM and immediately a full synchronization job is triggered, then the update is lost, and the alarm from the Source Product is synchronized.
Similarly, if the troubleshooter is updated for a UIM alarm on DX NetOps Spectrum, and a full synchronization job is triggered immediately the update is lost and the alarm from the source product is synchronized.
  • Unable to save the probe configuration. "Probe spectrumgtw on the robot is busy, Please wait and retry loading configuration later" error. Wait and select Retry.