Nokia Network Services Platform (NSP) Adapter

General information

Controller name: Nokia Network Services Platform (NSP)

Vendor:  Nokia

Controller version:  R22.6, R23.11, R24.11

HCO version: 11.0

Adapter version: 11.0

Adapter release date:

 

Use cases

Inventory discovery - yes

Topology discovery - yes

Service underlay discovery (LSP, tunnels) - no

Service discovery - yes

Assurance - yes

Service provisioning – no

RON – no

 

Discovery

Inventory

 

Details

Support

Additional Information

Device types

 7750-SR

Device Versions:

7750-SR-2s (TiMOS-C-20.7.R2)

7750-SR7 (TiMOS-C-21.10.R2/TiMOS-C-19.10.R9)

7750-SRa8 (TiMOS-C-19.10.R9)

7750-SR12 (TiMOS-C-21.10.R2)

Shelf

No

 

Cards

Yes

 

Ports

Yes

The "Port " prefix in port name is removed during normalization to align classic and model-driven formats.

Fans

Yes

 

Power

Yes

 

Pluggable transceivers

Yes

 

Notifications

Yes (over Kafka)

 

Protocol

REST, RESTCONF and SDN

 

Data Model

JSON

 

 

Topology

 

Details

Support

Additional Information

Link layers

IP physical, IP aggregate, IP logical and IGP

·       For physical ports, the "Port " prefix in port name is removed during normalization to align classic and model-driven formats.

·       For aggregate ports, names are normalized to start with "lag-" for consistency across classic and model-driven formats.

Cross links

Yes

 

Cross domain links

no

 

Notifications

Yes

 

Protocol

RESTCONF

 

Data Model

JSON

 

Limitations

IPv6 support is not available

 

Service underlay

 

Details

Support

Additional Information

Link layers

no

 

Cross domain links

no

 

Notifications

no

 

Protocol

NA

 

Data Model

NA

 

 

Service discovery

 

Details

Support

Additional Information

Service types

E-Line, L2VPN (VPWS, VPWS_EVPN, VPLS and MPLS_EVPN) and L3VPN services

Priority-tagged, Dot1Q and QinQ encapsulation types are supported.

Supported Non IETF VLANs and HCO translations:

 C-VLAN:

0 –> Priority-tagged

4095 -> "1-4094, priority, untagged"

S-VLAN:

0 -> “untagged”

Service underlay

no

 

Cross domain services

no

 

Notifications

yes

 

Protocol

RESTCONF

 

Data Model

JSON

 

 

Assurance

 

Details

Support

Additional Information

PM types

Yes

·       Physical Ports, Lag ports and Logical Ports (PACKET_IN, PACKET_OUT, OCTET_IN, OCTET_OUT, PPS_IN, PPS_OUT, BPS_IN, BPS_OUT)

·       LSP (PACKET_OUT, OCTET_OUT)

Resource types

Yes

Physical Ports, Lag Ports, Logical Ports and LSPs,

Live PMs

Yes

There is no on-demand collection as the controller pushes live data on the Kafka stream.

PM collection method

Kafka

Subscription based

 

Provisioning

Not Supported

 

APIs used

Table 1.   APIs used by the Nokia NSP adapter

Discovery Type

Discovery Item

HTTP Requests/API

HTTP Method

Inventory

Network-Elements

/restconf/data/nsp-equipment:network/network-element?depth=2

GET

 

Shelf

/restconf/data/nsp-equipment:network/network-element/hardware-component/shelf

GET

 

Cards

/restconf/data/nsp-equipment:network/network-element/hardware-component/card

GET

 

Fans

/restconf/data/nsp-equipment:network/network-element/hardware-component/fan

GET

 

Power Supply

/restconf/data/nsp-equipment:network/network-element/hardware-component/power-supply

GET

 

Ports

/restconf/data/nsp-equipment:network/network-element/hardware-component/port

GET

Topology

Physical Links

/NetworkSupervision/rest/api/v1/physicalLinks

GET

 

Lag Ports

/restconf/data/nsp-equipment:/network/network-element/lag

GET

 

Logical Ports

/restconf/operations/nsp-inventory:find

Body:

{"input": {"xpath-filter": "/nsp-network:network/node[node-id='a.b.c.d']/node-root/openconfig-interfaces:interfaces/interface/subinterfaces/subinterface

", "fields": "config;state;openconfig-if-ip:ipv4/addresses/address

"}}

POST

 

Isis Topology

/restconf/data/ietf-network:networks/network

GET

 

L3 Topology

/sdn/api/v4/nsp/net/l3/networks

GET

 

TE Tunnels

/restconf/data/ietf-te:te/tunnels/tunnel

GET

 

TE Tunnels (per tunnel)

/restconf/data/ietf-te:te/tunnels/tunnel/tunnel={0}

GET

 

RSVP LSP Paths

/sdn/api/v4/mpls/lsp-paths?pathType=RSVP

GET

 

SRTE LSP Paths

/sdn/api/v4/mpls/lsp-paths?pathType=SRTE

GET

Service Discovery

L2VPN Service

/restconf/data/ietf-l2vpn-ntw:l2vpn-ntw/vpn-services/vpn-service

GET

 

L2VPN service (per service)

/restconf/data/ietf-l2vpn-ntw:l2vpn-ntw/vpn-services/vpn-service={0}

GET

 

L3VPN services

/restconf/data/ietf-l3vpn-ntw:l3vpn-ntw/vpn-services/vpn-service

GET

 

L3VPN services (per service)

/restconf/data/ietf-l3vpn-ntw:l3vpn-ntw/vpn-services/vpn-service={0}

GET

Statistics

Get Subscription

/restconf/data/md-subscription:/subscriptions/subscription={0}

GET

 

Create Subscription

/restconf/data/md-subscription:/subscriptions/subscription={0}

 

Body:

{

"name": "subscription_name",
 "description": "subscription_description",
 "period": 30,
 "sync-time": "00:00",
 "state": "enabled",
 "type": <kpi_type>,
 "notification": "enabled",
 "db": "enabled"

}

 

KPI-Types Used:

PHY_PORTS :"telemetry:/base/sros-port/port_statistics”,
 AGG_PORTS: "telemetry:/base/sros-lag/lag_statistics”,
 LGC_PORTS: "telemetry:/base/sros-router/router_interface_statistics”,
 LSP: LINKS: "telemetry:/base/lsps/lsp-egress"

POST

Token Management

Create Token

/rest-gateway/rest/api/v1/auth/token

 

Body:

{"grant_type": "client_credentials"}

POST

 

Refresh Token

/rest-gateway/rest/api/v1/auth/token

 

Body:

{"grant_type": "refresh_token", "refresh_token": <token>"}

POST

 

Revoke Token

rest-gateway/rest/api/v1/auth/revocation

 

Body:

{"token": <token-to-revoked>, "token_type_hint": "token"}

POST

Configuration

 

Name

Description 

Default

Adapter Properties 

 

 

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

Polling Cycle [sec] 

Poll every X seconds.

3600

Server Configuration 

 

 

Host (including protocol, port, and URI prefix)

(http|https)://<server>[:<port>]

For example: https://10.133.11.10

 

SDN API PORT

Port number for connecting to the SDN API.

8543

REST API PORT

Port number for connecting to the REST API.

8544

REST CONF API PORT

Port number for connecting to the REST CONF API.

8545

Credentials

Credentials are defined in the “Credentials” tab of the Device Manager.

HTTP credentials

Connection Timeout [sec] 

Maximum amount of seconds will wait for a response from Nokia NSP.

60

Notification and Stats Configuration 

 

 

Enable Interface Stats 

Enables collection of interface-level traffic statistics.

 

Enable LSP Stats 

Enables collection of lsp traffic and perfomance statistics

 

Enable Change notifications

Enable notifications.

 

Kafka Port

Kafka Port for Notifications and Stats support.

9192

Certificate Authority 

CA pem certificate Credentials.

Credential of type SSH-Key

Enable Notification Logging

Enabling logs for notifications.

 

Log level

The logging level at which the notifications are logged.

INFO

Notification Congestion Control Period [sec]

Time interval to suppress repeated notifications during congestion.

5

Max Notification Wait Period [sec]

Maximum delay before sending queued notifications.

60

Collection Parameters 

 

 

Enable Inventory Collection 

Whether the inventory collection is enabled or disabled.

True

Enable Topology Collection 

Whether the topology collection is enabled or disabled.

True

Enable TE Tunnels Collection 

Whether the TE Tunnels collection is enabled or disabled.

True

Enable IGP IS-IS Collection 

Whether the IGP IS-IS collection is enabled or disabled.

True

IGP IS-IS Priority

Sets the priority for IS-IS routing protocol in IGP.

1

Enable L2/L3VPN Services Collection 

Whether the L2/L3VPN Services collection is enabled or disabled.

True

 

Limitations 

·       The Logical links are populated using the Logical ports only when the Sedo setting "persistor.logical.create_by_subnets" is enabled.

·       IGP collection is supported only for IS-IS.

·       In Service discovery, service underlay as RSVP tunnel or SR policy is not supported as not provided by Nokia.

·       In Nokia NSP, Service oper-status field support is not complete when using IETF API.

·       Service QoS setting will include only the profile name.

·       Port Statistics for devices with OS version < 21 is not supported in this adapter.

·       Nokia NSP notifications are partial for certain objects. Therefore, the adapter uses notifications as triggers to refresh collection through polling.

·       Provisioning use cases will use NSO.

·       The Nokia NSP adapter with HCO 11.0 is able to handle only L3 topology P2P link. However, a broadcast link is received in the response. To address this, The broadcast link is handled gracefully to prevent the DTO parser failure when processing the broadcast link.

·       The IETF response, which provides the network-types key as “ietf-te-topology:te-topology” delivers partial data. To mitigate this, the adapter handles the issue by not passing the data to the processing module.

·       The Nokia NSP adapter is capable of listening to change notifications messages on the topic nsp-yang-model.change-notif. The updates are processed using the key to HCO model mapping. For mapping of HCO objects to Nokia NSP adapter notification keys, see the table below:

 

S No.

HCO Objects

Nokia NSP Notification Key

1

Network Elements

nsp-equipment:network-element

2

Shelf

nsp-equipment:shelf

3

Card

nsp-equipment:card

4

Port

nsp-equipment:port

5

Fan

nsp-equipment:fan

6

Power Supply

nsp-equipment:power-supply

7

Lag Ports

nsp-equipment:lag

8

Logical Ports

nsp-inventory:output

9

IGP- ISIS

ietf-network:network

10

TE Tunnels

ietf-te:tunnel

11

L2 VPN Service

ietf-l2vpn-ntw:vpn-service

12

L3 VPN Service

ietf-l3vpn-ntw:vpn-service