Ciena MCP Adapter
Controller name: Ciena Navigator Network Control Suite (NCS), formerly known as Ciena MCP
Vendor: Ciena
Controller version: v6.1, v6.2, v7.1, v7.2, v8.0, v8.1,
v8.2, v9.0, v9.2
HCO version: 11.0
Adapter version: 11.0.6
Adapter release date:
· Inventory discovery - Yes
· Topology discovery - Yes
· Service underlay discovery (LSP, tunnels) - Yes
· Service discovery – Yes
· Service provisioning – Yes
· RON – Yes
· Assurance (Statistics) - Yes
· Notification - Yes
Following table documents the compatibility for various use cases with controller versions:
|
Ciena MCP Controller Version |
Inventory Discovery |
Topology Discovery |
Service Discovery |
Service Provisioning |
Statistics |
Notifications |
|
V6.1 TAPI 2.1.3 |
Supported* |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V6.2 TAPI 2.1.3 |
Supported |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V7.1 TAPI 2.1.3 |
Supported |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V7.2 TAPI 2.1.3 |
Supported |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V8.0 TAPI 2.1.3 |
Supported |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V8.1 TAPI 2.1.3 |
Supported |
Supported |
Supported |
Supported |
Supported |
Supported |
|
V8.2 TAPI 2.1.3 |
Certified* |
Certified |
Certified |
Certified |
Certified |
Certified |
|
V9.0 TAPI 2.1.3 |
Certified |
Certified |
Supported |
Supported |
Supported |
Supported |
|
V9.2 TAPI 2.1.3 |
Certified |
Certified |
Certified |
Certified |
Certified |
Certified |
|
Comments |
For Ciena Domain Controller V9.0 and V9.2 TAPI 2.1.3, current
certification is done with Optical functionality. Adapter is not certified to
support MPLS-TP functionality. |
|||||
*Certified = Functionality is validated with specified version.
*Supported = Functionality is expected to work fine on specified version, but it is not validated.
|
Details |
Support |
Additional information |
|
Device types |
6500, 51XX, 54XX, 81XX, 87XX, 6500
Reconfigurable Line System (RLS) |
|
|
Shelf |
Yes |
|
|
Cards |
Yes |
|
|
Ports |
Yes |
|
|
Fans |
Yes |
|
|
Power |
Yes |
|
|
Pluggable transceivers |
Yes |
|
|
Notifications |
Yes |
|
|
Protocol |
RESTCONF |
|
|
Data Model |
TAPI |
|
|
Details |
Support |
Additional information |
|
Link layers |
OTS, OMS, NMC, OCH, OTU, ODU, ETH, RLogical, E Line, PW, LSP, LAG |
Ports (OTS, OMS, NMC, OCH, OTU, ODU, ETH, RLogical, RPhysical, MPLS-TP,
UNI, VUNI, ENNI) Multilayer path view
for OCH connection over RLS devices. |
|
Cross links |
Yes |
|
|
Cross domain links |
No |
|
|
Notifications |
Yes |
|
|
Protocol |
RESTCONF |
|
|
Data Model |
TAPI |
|
|
Details |
Support |
Additional information |
|
Link layers |
No |
|
|
Cross domain links |
No |
|
|
Notifications |
No |
|
|
Protocol |
NA |
|
|
Data Model |
NA |
|
|
Details |
Support |
Additional information |
|
Service types |
Circuit-E-Line, Packet-E-Line, Wavelength, OTN-Line, SDH-Line, Mpls-TP
Tunnels |
Packet E-Line: ·
EPL ·
EVPL regular ·
EVPL Q-in-Q ·
EPL Q-in-Q Circuit Eline: ·
ODUFix ·
ODUFlex |
|
Service underlay |
No |
|
|
Cross domain services |
No |
|
|
Notifications |
Yes |
|
|
Protocol |
RESTCONF |
|
|
Data Model |
TAPI |
|
|
Service type |
Creation / Deletion |
Modification |
Brownfield |
|
Circuit E-Line |
Yes |
Yes (Bandwidth modification for Greenfield and Brownfield Services) |
Yes |
|
OTN Line |
Yes |
No |
Yes |
|
OCH |
Yes |
No |
Yes |
|
Packet E-Line |
Yes (With existing TP tunnel as underlay) |
Yes (CIR, EIR, CBS and EBS Modification for Greenfield and Brownfield
Services) |
Yes |
|
OCH-NC (RON) |
Yes |
No |
Yes |
|
SDH Line |
Yes |
No |
Yes |
- For Packet Eline (and Q-in-Q) Service creation and modification, the Ciena MCP Controller expects the CIR and EIR values to be in multiple of 64 Kbps (Kilobits per second) so that same value is assigned to the endpoint. Since SM (Service Manager) App UI allows value in Mbps (Megabits per second), it is recommended to use the SM App NBI (Rest APIs), which takes CIR and EIR values in Kbps for service creation and modification requests.
- After the CIR and EIR values are over-subscribed, modification as well as rollback fails, and service becomes “out of sync”.
- After a brownfield service is promoted for managing through HCO, it should not be modified or deleted from outside of HCO setup as that may result in “out of sync” data and affect the visibility of newly created service which is using same endpoints.
- Users should provide valid LSP links in specific order while creating the Packet Eline and Q-in-Q Services with multi-link tunnel. For example: While creating a service from A to C via B, the first link must be given as A-B, and not B-C.
In case of invalid links or incorrect order, creation of service fails at Ciena MCP Controller, and it returns an error as “Failed to find path(s)”.
|
Details |
Support |
Additional information |
|
Performance Measurement (PM) types |
Yes |
PACKET_IN PACKET_OUT OCTET_IN OCTET_OUT AVG_RX_POWER_DBM_SCALE_100 MIN_TX_POWER_DBM_SCALE_100 MAX_TX_POWER_DBM_SCALE_100 |
|
Resource types |
No |
Include here LSPs and services |
|
Live PMs |
Yes |
Not supported for 6500 RLS Devices |
|
PM collection method |
RESTCONF |
|
|
Protocol |
RESTCONF |
|
|
Data Model |
TAPI |
|
The following list comprises APIs utilized by the Ciena MCP adapter.
|
Discovery Type |
Item |
HTTP Requests |
HTTP Method |
|
Authentication |
Token |
/tron/api/v1/tokens |
POST |
|
Inventory |
ONE, Shelf, Card, Port, Power Supply, Fan |
/tapi/data/tapi-common:context/tapi-equipment:physical-context/device/ |
GET |
|
/tapi/data/tapi-common:context/tapi-topology:topology-context/topology={uuid}/node/ |
GET |
||
|
/tapi/data/tapi-common:context/tapi-equipment:physical-context/equipment/ |
GET |
||
|
/tapi/data/tapi-common:context/tapi-equipment:physical-context/equipmentholder/ |
GET |
||
|
Topology |
Links (OTS, OMS) |
/tapi/data/tapi-common:context/tapi-topology:topology-context/topology={uuid}/link/ |
GET |
|
Links (NMC, OCH, OTU, ODU, ETH, RLogical, E Line, PW, LSP, LAG) |
/tapi/data/tapi-common:context/tapi-connectivity:connectivity-context/connection/ |
GET |
|
|
Ports (OTS, OMS, NMC, OCH, OTU, ODU, ETH, RLogical, RPhysical, MPLS-TP, UNI, VUNI) |
/tapi/data/tapi-common:context/tapi-topology:topology-context/topology={uuid}/node-edge-point/ |
GET |
|
|
/tapi/data/context/topology-context/topology={uuid}/connection-end-point/ |
GET |
||
|
Service |
Circuit-E-Line, Packet-E-Line, Wavelength, OTN-Line, SDH-Line |
/tapi/data/tapi-common:context/tapi-connectivity:connectivity-context/connectivity-service/ |
GET |
|
Provisioning Endpoint (SIP) |
/tapi/data/tapi-common:context/service-interface-point/ |
GET |
|
|
Notifications |
Get supported streams |
/tapi/data/context/stream-context/supported-stream-type/ |
GET |
|
Get available streams |
/tapi/data/context/stream-context/available-stream/ |
GET |
|
|
Establish WebSocket (per stream) |
/tapi/data/context/stream-context/available-stream={uuid} |
WSS |
|
|
Stats |
Get PMs |
/pm/api/v2/query/metrics |
POST |
|
Provisioning |
Service |
/tapi/data/context/connectivity-ontext/provisioning/connectivity-service/ |
POST |
|
/tapi/data/context/connectivity-context/provisioning/connectivity-service/{uuid} |
DELETE |
||
|
/tapi/data/tapi-common:context/tapi-connectivity:connectivity-context/connectivity-service={uuid}/requested-capacity -- Circuit Eline ODUFlex Modify |
PUT |
||
|
Packet Eline Service Modification |
Get Service ID: /bpocore/market/api/v1/resources?resourceTypeId=ifd.v6.resourceTypes.L2ServiceIntentFacade&q=properties.name:{service_name} |
GET |
|
|
Modify Service: /bpocore/market/api/v1/resources/{service-id}/operations |
POST |
||
|
Get modify_operation_id: /bpocore/market/api/v1/resources/{service-id}/operations/{modify_id} |
GET |
||
|
Get Modification Status: /bpocore/market/api/v1/resources/{service-id}/operations/{modify_operation_id} |
GET |
Configuration Parameters for the Ciena MCP Adapter:
|
Name |
Description |
Default |
Range |
|
Enabled |
Whether to enable/disable the adapter. |
False |
|
|
Logging Level |
The logging level at which the discovery cycle will be reported in the adapter’s log. |
Info |
Critical, Error, Warning, Info, Debug |
|
Adapter Properties |
|
|
|
|
Provisioning Timeout [sec] |
The provisioning timeout in seconds. |
150 |
[90: ] |
|
Polling Cycle [sec] |
Poll every X seconds. |
3600 |
[90: ] |
|
Connection Timeout [sec] |
The connection timeout. |
120 |
|
|
Max run time for a single discovery cycle[sec] |
The maximum time for a discovery cycle. To prevent endless cycles which may put the adapter into a deadlock. |
600 |
[30: ] |
|
Minimal interval time between data updates [sec] |
The minimum time between data updates. This is the period, for example 30 seconds, during which notifications are stored in the local adapter cache, after which discovery runs on the cache. If this is set to 0 seconds (default) the discovery runs immediately. |
0 |
[0: ] |
|
Save persistor request to disk? |
Whether to save the persistor request to disk. |
false |
|
|
Service Delegation |
Allows ownership of existing services for service deletion. When enabled, the adapter discovers controller connectivity-service entries for "brownfield" services (those created outside of Cisco Crosswork Network Controller). The Service
Manager application recognizes these entries created by the adapter and adds
them to the Point-to-Point table (in Service Manager). Users can
then delete these "brownfield" services using Service Manager (even
though they were created outside of Cisco Crosswork Network Controller). |
false |
|
|
Connection Properties |
|
|
|
|
Host (including protocol, port, and URI prefix) |
(http|https)://<server>[:<port>] For example: https://10.1.2.3 |
|
|
|
Credentials |
Credentials are defined in the “Credentials” tab of the Device Manager. |
|
HTTP credentials |
|
MCP API version |
The MCP API version. |
V5 |
[V5, V6] |
|
Filter out non Ciena-devices |
Whether or not to filter out non-Ciena devices. |
false |
|
|
Statistics Configuration |
|
|
|
|
Enabled |
Whether to enable/disable statistics collection. |
true |
|
|
Stats Interval Polling [sec] |
Poll for statistics every X seconds. |
900 |
[300: ] |
|
Concurrent Devices Stats Collection |
The number of concurrent devices to collect statistics from. |
10 |
[1:30] |
|
Notifications Configuration |
|
|
|
|
Enabled |
Should the notifications listener be initialized or not? |
true |
|
|
Idle
Connection Refresh Time [sec] |
Reset
notification connection after this idle timeout. |
3600 |
[300: ] |
|
Idle
Connection Check Interval [sec] |
Check
for idle connection time after specified duration. |
60 |
[30: ] |