Portal Spectrum Alarms tab for devices show a synchronization error

Products

• Network Observability
• CA Performance Management
• Spectrum

Issue/Introduction

DX NetOps Performance Management and Spectrum are integrated together.

We see the IP Domain GC in Spectrum and have added device models to sync them to Portal Inventory.

Some of the device models in Spectrum show the CAPC_Item_ID attribute populated but most don't.

All devices in Portal, on their Context Page Alarms tab, show an error that states "This item is not being synchronized from Spectrum to Monitoring".

When the Portal MySql DB is queried we see no items coming from the Spectrum Data Source. Enter a Portal MySql prompt (default path /opt/CA/MySql/bin) with "./mysql -uroot -p netqosportal". Determine the Data Source IDs using the select statement "select SourceID,ConsoleName from data_sources2;". Lastly query the DB for a count of devices synchronized to Portal from the Spectrum Data Source using it's SourceID from the data_sources2 table. That query is "select count(*) from dst_device where SourceID=<SpectrumDS_ID>;". If that returns no rows, it tells us there are no models synced from Spectrum to Portal.

Enabling PCIntegrationSync debug (see KB article How to enable Spectrum debug for the Performance Management integration) through a tomcat restart we see these messages that indicate the cause.

2025-01-24 07:50:30,273 [https-jsse-nio-443-exec-20] INFO  com.aprisma.debuglog -  (NetqosSyncLog) - (TRACE) - Dropping IPDomain : Default Domain to be Synced as its PCGUID_Attr is not matching with Integrated CAPC PCGUID

Environment

All supported and integrated DX NetOps Performance Management and Spectrum environments

Cause

When the integration creates an IP Domain GC in Spectrum it stores the Portal GUID in an attribute against the newly created the IP Domain GC.

This is done to cover the scenario where the OC host is part of a DSS with more than 1 Portal connected to other OC instances in the DSS. This allows it to create two IP domain GC's, one for each Portal instance. This allows it to sync only those items per PCGuid_Attr.

The likely "how we ended up here" is Spectrum OC and Portal integration hosts being moved around.

Resolution

To resolve this take the following steps to rebuild the integration.

NOTE: Before starting record things like IP Domain GC search rules or other configurations in Portal relying on Spectrum GCs. These will need to be recreated.

1. Log into the Portal UI as an admin user and go to the Administration -> Data Sources -> Data Sources page.
2. Select the Spectrum Data Source (DS) and choose to delete it. The remove is complete:
   • When the Manage Data Sources page no longer shows the Spectrum DS entry.
   • When the Spectrum OC UI shows the IP Domain GCs are gone.
3. After confirming the Spectrum DS deletion is complete add the Spectrum DS to Portal again.
4. When the DS is finished binding and goes Available in the Manage Data Sources page it's done being added.
5. Recreate the Default Domain GC rules that were in place.
6. Confirm the items are properly synchronized to the Portal inventory.