How to list the unique Data Collector id DCM_ID in Performance Management
search cancel

How to list the unique Data Collector id DCM_ID in Performance Management

book

Article ID: 13251

calendar_today

Updated On:

Products

CA Infrastructure Management CA Performance Management - Usage and Administration

Issue/Introduction

User would like to find out the Data Collector unique ID so that they can backup it in case they need to reinstall to other machine.

Where I can find the unique Data Collector id DCM_ID?

This shows how to gather a full set of DCM_ID values in case a Data Collector needs to be reinstalled. Reusing the same DCM_ID during the install allows the freshly installed version to behave the same as the previous one. Without doing so the devices managed by the previously installed DC will not be associated to the reinstalled DC.

Environment

All supported Performance Management releases

Resolution

An example DCM_ID value looks like this:

DCHostName:22a4e9a7-8aa4-4db1-9f45-3b0b2b86eb4f

The format of the Data Collector component ID, or DCM_ID, is HOSTNAME:UUID (universally unique identifiers).

There are two ways to find the Data Collector DCM_ID value.

  1. Log into the Performance Center Web UI. Go to Administration->Monitored Items Management->Data Collectors
    1. The ID column in the Data Collectors pane contains the DCM_ID
    2. If the ID column isn't exposed:
      1. Hover the mouse over a column title in the Data Collectors pane
      2. Select the Gear icon.
      3. Select Columns
      4. Enable the ID column
  2. The second method is to use a REST call via a web browser tab or REST API client.
    1. Using a web browser tab enter the following URL:
      1. http://<DA_HostName>:<port>/rest/dcms
        1. Replace <Port> with the configured port. Default Port is 8581.
        2. Replace <DA_HostName> with the DA host name or IP address
        3. TIP: Use this URL for a single DCs output using it's ID from the /rest/dcms outpu
          1. http://<DA_HostName>:<port>/rest/dcms/<ID>
            1. Replace <ID> with the DC ID
      2. The value will be seen in the <DcmID> tag.
        1. If many DCs are present search for the host name
        2. See example of the output for a single DC below in Additional Information.
    2. Using a REST API client issue a GET to the URL above that is used in a web browser tab.

Additional Information

<DataCollectionMgrInfo version="1.0.0">
<ID>452</ID>
<DcmID>DC_HOSTNAME:a0b64748-c761-4508-b9af-9527a996ac31</DcmID>
<Enabled>true</Enabled>
<IPAddress>127.0.0.1</IPAddress>
<RelatedDeviceItem>467</RelatedDeviceItem>
<ProtocolCollectorStateGroupList>
<ProtocolCollectorStateGroup>
<ProtocolCollectorName>com.ca.im.dm.sdn.performance.impl.SDNCollector</ProtocolCollectorName>
<ProtocolCollectorState>true</ProtocolCollectorState>
</ProtocolCollectorStateGroup>
<ProtocolCollectorStateGroup>
<ProtocolCollectorName>com.ca.im.dm.snmp.collector.SnmpCollector</ProtocolCollectorName>
<ProtocolCollectorState>true</ProtocolCollectorState>
</ProtocolCollectorStateGroup>
<ProtocolCollectorStateGroup>
<ProtocolCollectorName>com.ca.im.dm.mediation.platform.impl.MediationSimpleCollector</ProtocolCollectorName>
<ProtocolCollectorState>true</ProtocolCollectorState>
</ProtocolCollectorStateGroup>
<ProtocolCollectorStateGroup>
<ProtocolCollectorName>com.ca.im.dm.health.collector.DCMHealthCollector</ProtocolCollectorName>
<ProtocolCollectorState>true</ProtocolCollectorState>
</ProtocolCollectorStateGroup>
<ProtocolCollectorStateGroup>
<ProtocolCollectorName>com.ca.im.dm.icmp.collector.IcmpCollector</ProtocolCollectorName>
<ProtocolCollectorState>true</ProtocolCollectorState>
</ProtocolCollectorStateGroup>
</ProtocolCollectorStateGroupList>
<HostName>DC_HOSTNAME</HostName>
<MonitoredDeviceCount>49</MonitoredDeviceCount>
<CollectorState>RUNNING</CollectorState>
<IPAddressType>4</IPAddressType>
<TenantName>Default Tenant</TenantName>
<IsAlso>
<IsA name="Versions" rootURL="versions"/>
<IsA name="DeviceComponent" rootURL="devices/components"/>
<IsA name="IPDomainMember" rootURL="ipdomainmember"/>
<IsA name="Pollable" rootURL="pollable"/>
<IsA name="DistributedItemRepositoryInfo" rootURL="distireps"/>
</IsAlso>
<NormalizedDCMHealthInfo version="1.0.0">
<SourceFacetTypesList>
<SourceFacetTypes>{http://im.ca.com/certifications/dcmp}DCMHealthInfo</SourceFacetTypes>
</SourceFacetTypesList>
<NRM_PolledItemCount>3588</NRM_PolledItemCount>
</NormalizedDCMHealthInfo>
<IPDomainMember version="1.0.0">
<IPDomainID>2</IPDomainID>
</IPDomainMember>
<DistributedItemRepositoryInfo version="1.0.0">
<Status>OK</Status>
<LastStateChangeTime>Tue May 26 10:48:00 2020 -0400</LastStateChangeTime>
</DistributedItemRepositoryInfo>
<Item version="1.0.0">
<Name>DC_HOSTNAME - DCM0</Name>
<CreateTime>Mon Sep 30 12:12:35 2019 -0400</CreateTime>
<MDRItemID>452</MDRItemID>
</Item>
<Versions version="1.0.0">
<ComponentVersionsList>
<ComponentVersions>
<ComponentNames>Data Collector</ComponentNames>
<MajorVersions>3</MajorVersions>
<MinorVersions>7</MinorVersions>
<PatchVersions>10</PatchVersions>
<BuildNumbers>602</BuildNumbers>
</ComponentVersions>
</ComponentVersionsList>
</Versions>
</DataCollectionMgrInfo>