You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

Related Jira(s)

CPS-1415 - Getting issue details... STATUS

Description

  1. Define scenarios which cause a CM Handle to go stale
  2. Implement changes to support tracking of CM Handle Freshness/Staleness

What might trigger a cmhandle to go to STALE?

  1. dmi plugin identifies that the device is no longer contactable
  2. dmi plugin identifies that an underlying device manager managing the device (node) is out of sync with the device itself. 

Requirements

Functional

#InterfaceRequirementAdditional Information
1CPS-NCMP-I-01A Rest endpoint to allow DMI Plugin Reregistration, A kafka interface for DMI Plugin to provide trust level state changes for a CM HandleReregistration is to reregister all CMHandles managed by a CMHandle. Kafka interface schema allows for CMHandle as id and trust level as only value in data
2DMI-I-01A Rest endpoint to trigger DMI Plugin ReregistrationAsynchronous interaction to trigger DMI Plugin to hit endpoint in CPS-NCMP-I-01 with reregistration

Error Handling

#Error ScenarioExpected behavior
1DMI Plugin goes downCMHandles managed by that DMI have NONE trust level, when the DMI comes back up, a reregistration process occurs, CMHandles are individually assessed for trust level then.
2Node goes downDMI Plugin informs NCMP of the trust level state change. DMI will update on changes to a cmhandles trust level change.

Capabilities

  1. re-registration, once a day, same requirement as first time registration
  2. single node heart beat failures 30,000 / minute per instance

Scope

  1. Currently only supporting NONE and COMPLETE. PARTIAL and POOR may be added later as below.

Reregistration

  1. This process occurs when the DMI Plugin Availability is down and then comes back up.
  2. NCMP makes a synchronous call to the DMI Plugin (New Audit Endpoint) to trigger a reregistration
  3. DMI Plugin then reregisters its CMHandles with NCMP (new reregistaration Endpoint?)
  4. NCMP then compares the CMHandles which are being reregistered with the CMHandles which already exist.
  5. CMHandles which are in NCMP but not in DMI reregistration request are kept as trust level none
  6. What happens if there is conflict between the old and new properties of a CMHandle, just take the new properties?
  7. New CMHandles could be registered


High Level Interactions

InterfaceNameTriggerDescriptionTypeEndpoint or TopicSchema
1HealthCheck30 second interval (configurable)NCMP is to perform a health check against each of the DMI PluginsRESThttp://'$1'/manage/health/readiness
2Reregistration requestDMI Plugin has gone down and comes back upNCMP makes a call to that DMI Plugin telling it to reregisterRESTTBD
3ReregistrationDMI Plugin received a reregistration requestDMI Plugin makes a call to NCMP to reregister its CM HandlesREST/v1/ch/reregistration
{
  "dmiPlugin": "my-dmi-plugin",
  "dmiModelPlugin": "my-dmi-model-plugin",
  "cmHandles": [
    {
      "cmHandle": "my-cm-handle",
      "publicCmHandleProperties": {
        "key": "my-property"
      },
      "cmHandleProperties": {
        "key": "my-property"
      }
    },
    {
      "cmHandle": "my-cm-handle",
      "publicCmHandleProperties": {
        "key": "my-property"
      },
      "cmHandleProperties": {
        "key": "my-property"
      }
    }
  ],
  "dmiDataPlugin": "my-dmi-data-plugin"
}
4CMHandle trust level changeA CMHandle managed by DMI Plugin's trust level has changed

data contains {trustLevel: ENUM} 

event id is cmhandle id

KafkaTBD

<cloudEvents-header>

  id : <cmhandleId>

  type : org.onap.cm.events.trustlevel-notification


  data : {

                                trustlevel : "COMPLETE"

  }

5TrustLevel RequestClient RequestTrustLevel is to be returned based on the values in above MapsRESTTBD

Managing TrustLevels

DMI Plugins

  1. NCMP is checking every DMI Plugin for health at interface 1 every 30 seconds using the DMI Trust Map
  2. IF a DMI Plugin goes down, that DMI Plugin's trust level is updated to NONE in the DMI Trust Map
  3. IF a DMI Plugin comes back up, NCMP requests that DMI Plugin to do a reregistration via interface 2
    1. That DMI reregisters itself using interface 3
    2. NCMP analyses the registration and compares the CMHandles it knows about to the CMHandles which have been reregistered, any CMHandles which did exist and are not reregistered are now added to the untrustworthy CMHandles Map. Existing CMHandles are updated and new ones are created.
    3. After the reregistration is complete, the DMI Plugin TrustMap is updated to set the trust level for that DMI to complete.

CMHandles HB

  1. It is the responsibility of the DMI Plugins to update NCMP about the HBs of CMHandles
  2. Through interface 4, DMI Plugins will provide a kafka event on the changing of trustworthiness state of a CMHandle.
    1. NCMP receives this event and updates the Untrustworthy CMHandles Map accordingly
  3. Needs to be able to handle a throughput of 30,000 State changes per minute

Reading Trust Level

  1. Body of request to be discussed, Will the request provide a DMI or a list of CMHandles?
  2. Interface 5
  3. NCMP will first check DMI Trust Map for the CMHandle
    1. If that DMI which is managing the CMHandle is marked as untrustworthy then we return NONE without checking the Untrustworthy CMHandles Map
    2. If that DMI is trustworthy, we check the individual CMHandles Map, if the CMHandle is in the Map then return NONE.
  4. Logically IF (DMITrustMap.getDMIPlugin.getTrustLevel ==  NONE) Return NONE
    1. ELSE (IF UntrustworthyCMHandlesMap.getDMIPlugin.contains(CMHandle) RETURN NONE
    2. ELSE return COMPLETE



  • No labels