Ciena MCP Adapter

General information

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:

 

Use cases

·       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

 

Feature Compatibility Matrix

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.

Discovery

Inventory

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

 

 

Topology

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

 

 

Service underlay

Details

Support

Additional information

Link layers

No

 

Cross domain links

No

 

Notifications

No

 

Protocol

NA

 

Data Model

NA

 

 

 

Services

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

 

 

Provisioning

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

 

Known Limitations

-        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)”.

 

Assurance (Statistics)

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

 

 

APIs (TAPI 2.1.3) used

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

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: ]