Skylight Gateway 24.05 Release Notes

These release notes cover the prerequisites, features, and limitations of the Skylight 24.05 release. Read this document before installing the firmware.

For further information, questions, or clarifications regarding this release, contact the Accedian Technical Assistance Center (TAC) at skylight_tac@cisco.com.

Prerequisites

Features

Skylight Gateway version 0.93.3 has the following features:

• Extended intent model

  • Integration of the TWAMP feature from Skylight orchestrator using Skylight sensor: control (support for local interface and VCE (SFP))

• NE Endpoint with optional vlan and interfaceID

  • NE Endpoint allows optional vlan and interface ID fields

• NE Endpoint support on Skylight sensor: control and Sensor Orchestrator

  • Reused the ne-endpoint object for YANG model support

Related Documentation

Notes

• If an agent 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 prior to deleting an agent.
• The error path returns the URI provided in the request, so 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 model filter for IDs and names has been changed to accept a number as a first character followed by 0 to 127 letter, numbers, underscores and hyphens.
• The Yang datastore model is the master “view” of the configuration, therefore, the resync will attempt to re-configure the agent orchestrator 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 service can be created on a single POST operation.
• Bulk session can be created on a single POST operation.
• Session can be added to a service using POST/PUT (no PATCH operation needed)

Limitations

Skylight Gateway version 0.93.3 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:

  • Persistency of the Skylight gateway configuration cannot be upgraded from 23.04 version. (This is due to a change in the persistency implementation).
  • Only the twamp-sf protocol is supported (Agent Actuate) with this current version of the gateway.

• YANG limitations:

  • YANG model RPCs are not implemented yet.
  • 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 rc1-24.04 will be limited in terms of IPv6 support. 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