Huawei NCE-IP Adapter

General Information

Controller name: NCE-IP Adapter

Vendor: Cisco

Controller version: R23C10

HCO version: 10.0

Adapter version: 10.0.2

Adapter release date: 28/03/2025

 

Use cases

·       Inventory discovery - yes

·       Topology discovery - yes

·       Service underlay discovery (LSP, tunnels) - yes

·       Service discovery - yes

·       Assurance - yes

·       Service provisioning – yes

·       RON – no

 

Discovery

Inventory

Details

Support

Additional information

Device types

OptiX PTN 910E-F

OptiX PTN 905E

OptiX PTN 970

OptiX PTN 990

OptiX PTN 7900-12

 

Shelf

Yes

 

Cards

Yes

 

Ports

Yes

 

Fans

Yes

 

Power

Yes

 

Pluggable transceivers

Yes

 

Notifications

Yes

 

Protocol

Proprietary RESTCONF

SOAP

 

Port Soap IDs that are used in provisioning requests

Data Model

JSON

 

Limitations

·       For Equipment (port, card, chassis) Model number, serial number and part number are not modeled sometimes, depending on the API response.

·       For the Card/ SFP removal/in, Controller is not generating any card/SFP out/in notifications, only modification is generated for which HCO will attempt a modification of the entity

·       The SFP count in the controller API response is mismatching with the controller UI

 

Topology

Details

Support

Additional information

Link layers

IP physical, IP logical, LSP(MPLS-TP)

 

Cross links

No

 

Cross domain links

No

 

Notifications

Yes

 

Protocol

Proprietary RESTCONF

SOAP

LSP Soap IDs that are used in provisioning requests

Data Model

JSON

 

Limitations

Tunnel Protection information and Operational status is not modeled as these values are not present in the controller API response

 

Service underlay discovery

Details

Support

Additional information

Link layers

Yes

E-Line, Pseudo Wires and LSPs

Cross domain links

No

 

Notifications

Yes

 

Protocol

NA

 

Data Model

NA

 

 

Service discovery

Details

Support

Additional information

Service types

E-Line

Packet E-Lines

Service underlay

Yes

Static Tunnels only

Cross domain services

No

 

Notifications

Yes

 

Protocol

Proprietary RESTCONF

SOAP

 

Service Soap IDs that are used in provisioning requests

Data Model

JSON

 

Limitations

·       The admin-status, oper-status and service health are not modeled.

·       Service to Service Intent mapping fails when tagged services are created over untagged port or vice versa.  It is recommended not to create such configurations.

·       The notification processing takes a longer time due the time taken by the controller for

o    To respond to the create request

o    Create notification generation is taking time after the create request response

o    The export task to get the Service end points and the Underlay tunnels information

 

Assurance

Details

Support

Additional information

Performance Monitoring type

Yes

PACKET_IN

PACKET_OUT

OCTET_IN

OCTET_OUT

Resource type

Yes

R_PHYSICAL

Live performance monitoring

No

 

Performance Monitoring collection method

SFTP Pull

 

 

Provisioning

Service type

Creation / Deletion

Modification

Brownfield

Packet E-Line

Yes

Yes (CIR Only)

 Deletion Only

Protocol

SOAP

 

Data Model

 

 

Limitations

1.     Since the create notification processing is taking time the discovery step time in the Service Manager App need be increased.

e.g sedo config add service-manager-app_sm-configuration_global '"{\"discovery_timeout_ms\":1200000}"' --ro-access permission/hco/service-manager-app:ro  --rw-access permission/admin --rw-access permission/hco/service-manager-app:rw   

2.     There are no notifications generated by the controller for CIR and EIR modification, So polloing interval needs to be reduced to go through the discovery step of modification flow.

3.     Tagged and untagged services cannot/should not be created on the same endpoints

4.     Tagged A-side and Untagged Z-side services are not allowed – this is an invalid configuration on the Controller

5.     QoS parameters in payload are CIR and PIR whereas CIR and EIR are used in HCO.  PIR=CIR+EIR will be sent in the create and modify payloads.

 

 

APIs Used

 

Discovery Type

Item

HTTP Requests

HTTP Method

Authentication

Token

/rest/plat/smapp/v1/sessions

PUT

 

DELETE

Inventory 

ONE, Shelf, Card, Port, Transceiver

/restconf/v2/data/huawei-nce-resource-inventory:network-elements

/ManagedElementRetrieval (SOAP)

GET

 

 

POST

/restconf/v2/data/huawei-nce-resource-inventory:frames

GET

/restconf/v2/data/huawei-nce-resource-inventory:cards

GET

/restconf/v2/data/huawei-nce-resource-inventory:ltps

GET

/restconf/v2/data/huawei-nce-resource-inventory:tranceivers

GET

Topology

Links, Tunnels, Services

/restconf/v2/data/huawei-nce-resource-inventory:links

GET

 

 

/restconf/v2/data/huawei-nce-service-inventory:tunnel-trails?signal-type=static-cr

/restconf/v1/operations/huawei-nce-static-cr-tunnel:get-paths-by-ids

/ConnectionRetrieval (SOAP)

GET

 

 

GET

 

 

POST

 

 

/restconf/v2/data/huawei-nce-service-inventory:pwe3-trails

/restconf/v1/operations/huawei-nce-resource-inventory-action:export

restconf/v1/data/huawei-nce-resource-inventory-action:export-tasks/export-task

/restconf/v1/operations/huawei-nce-resource-inventory-action:download-file

/FlowDomainRetrieval (SOAP)

GET

 

 

POST

 

 

GET

 

 

 

GET

 

 

POST

 

 

Provisioning 

Create Service,

Modify Service

Delete Service

/FlowDomainControl

/ConnectionControl

/FlowDomainControl

POST

 

POST

 

POST

Configuration

Parameter name

Default value

Recommended

Enabled

Logging level

 

Adapter Properties

Polling Cycle [sec]

Service Delegation

 

NCE-IP Server Configuration

Host (including protocol)

Port

Credentials

Timeout

Request Retries

 

Collection Parameters

Enable Inventory Collection

Enable Topology Collection

 

Provisioning Configuration

Enable Service Provisioning

Host (including protocol)

Port

Credentials

Timeout [sec]

Request Retries

 

Notifications Configuration

Enabled

Log Notifications

Log Level

Congestion Control Period Sec

Max Notification Wait Period Sec

Notification Silent Period Sec

 

PM Configuration

Enabled

PM Data Fetch Interval [sec]

SFTP Host (including protocol)

Port

SFTP Path

Credentials

FALSE

INFO

 

 

7200

FALSE

 

 

 

 

 

60

3

 

 

TRUE

TRUE

 

 

FALSE

 

 

 

60

3

 

 

 

 FALSE

TRUE

DEBUG

5

60

120

 

 

FALSE

900