Provider Connectivity Assurance Gateway 24.09 Release Notes

These release notes cover the prerequisites, features, and limitations of the Cisco Provider Connectivity Assurance Gateway (formerly Skylight Gateway) 24.09 release. Read this document before using the gateway YANG interface.

For further information, questions, or clarifications regarding this release, contact the Provider Connectivity Assurance Technical Assistance Center (PCATAC) at skylight_tac@cisco.com.

Prerequisites

Features

Provider Connectivity Assurance Gateway version 24.09 has the following features:

• Extended intent model

  • Integration of the Service Activation Test (SAT) feature on SFP compute, supporting both RFC2544 and Y.1564 type throughput tests.

• Metadata tags added

  • For individual Session objects
  • For Service object, applied to all sessions in the service

• Topology metadata for Session objects

• Support for geo-location tags on the service-endpoint objects

  • Populates the source and destination lat/long settings for sessions between two endpoints

• Threshold crossing alert policy configuration

  • On Service object, applied to sessions tied to this Service

• RESTCONF Notification support for

  • service-endpoint state changes
  • session state changes
  • alerts from alert policies

Related Documentation

Notes

• If an Agent, Sensor SFP, or Sensor Control is removed manually while sessions are running, sessions will create an error in the Gateway. The Gateway will fail to delete sessions because the endpoint is not ready. To avoid this issue, remove the session from the YANG before deleting an agent.
• The error path returns the URI provided in the request; if the request targets a list node instead of a specific instance, the error path will show the list URI, not the instance.
• The YANG datastore model is the master “view” of the configuration, therefore, the resync will attempt to re-configure the orchestrator(s) if there is a discrepancy between the two configurations.
• If the resync fails to push a mismatched configuration to the Agent orchestrator, the instance is flagged as an error at the YANG level.
• Bulk services can be created on a single POST operation.
• Bulk sessions can be created on a single POST operation.

Limitations

Provider Connectivity Assurance Gateway version 0.113.0 has the following limitations:

• Error limitation:

  • Error-path is not included in the message from the ODL framework if constraint limits are reached.

• Deployment limitations:

  • Supported PCA actuators and devices: Agent actuate, Sensor Control, Sensor SFP

• YANG limitations:

  • Even though the YANG model supports 128 characters, the session name should be kept at 64 characters maximum, as there is a limitation in Agents.
  • Session Auto-Start is not supported.

• Notification limitation:

  • Without retention time, because start time is not supported, the client must keep the connection open to receive notifications.

• IPv6 limitation:

  • Current version 24.09 is limited in terms of IPv6 support. Sensor Collector (formerly Roadrunner) needs to connect to the NGINX in IPv4.

• CRUD limitations:

  • Changing parameters from a Session/Endpoint/Service is not supported. In this version, you need to delete and recreate. (add/del in the list is supported with PUT/DELETE)
  • PATCH operation is not supported.
  • PUT operation is not supported to edit, it can only be used to create an instance.

Addressed Issues

None