- Print
- PDF
Service Activation Testing (RFC 2544 and Y.1564)
RFC 2544 and Y.1564 Service Activation Tests
Endpoint Definition
To perform Service Activation Tests (SAT) using the RESTCONF YANG interface, you must first create the service-endpoints.
The example below defines two Assurance Sensor SFP devices as endpoints for tests. The key parameters are:
- nid-id - Specifies the Provider Connectivity Assurance Sensor Control instance that is controlling the Assurance Sensor SFP.
- sub-id - Specifies the Assurance Sensor SFP ID.
- port - Specifies which port on the Assurance Sensor SFP to test from: NNI is the side facing the Assurance Sensor Control, and UNI is the other end of the Assurance Sensor SFP.
RESTCONF POST :: /restconf/dataAccedian-service-endpoint:service-endpoints
{
"Accedian-service-endpoint:service-endpoint": [
{
"endpoint-id": "my_first_endpoint",
"endpoint-name": "my_first_endpoint",
"description": "SAT y1564 or RFC2544 endpoint",
"type": "Accedian-service-endpoint-type:nid-endpoint",
"config": {
"Accedian-service-endpoint-nid:nid-config": {
"nid-id": "PCASC-DEMO-1",
"sub-id": "P802-0325",
"port": "P802-0325-NNI"
}
}
},
{
"endpoint-id": "my_second_endpoint",
"endpoint-name": "my_second_endpoint",
"description": "SAT y1564 or RFC2544 endpoint",
"type": "Accedian-service-endpoint-type:nid-endpoint",
"config": {
"Accedian-service-endpoint-nid:nid-config": {
"nid-id": "PCASC-DEMO-1",
"sub-id": "P802-0323",
"port": "P802-0323-UNI"
}
}
}
]
}
If you use a third-party loopback device that is not managed by the Provider Connectivity Assurance system, a service-endpoint of the appropriate type must be defined for that endpoint. This type of service-endpoint only includes ID, name, group, and geo-location data.
Below is an example of adding an unmanaged endpoint for testing towards a third-party loopback:
RESTCONF POST :: /restconf/data/Accedian-service-endpoint:service-endpoints
{
"Accedian-service-endpoint:service-endpoint":[{
"endpoint-id":"example-unmanaged",
"endpoint-name":"example-unmanaged",
"geo-location":{
"latitude":"51.5072",
"longitude":"0.1276"
},
"type":"Accedian-service-endpoint-type:unmanaged-endpoint"
}]
}
The image above illustrates two Assurance Sensor SFP endpoints and one third-party responder/loopback.
RFC 2544
Sample Test Definition for a Layer 2 Test
This example designates "my_first_endpoint" as the sender and "my_second_endpoint" as the reflector/loopback for a Layer 2 RFC 2544 test.
RESTCONF POST :: /restconf/data/Accedian-session:sessions
{
"Accedian-session:session": [
{
"session-id": "my_rfc2544_l2_test",
"session-name": "my_rfc2544_l2_test",
"session-type": "Accedian-session-type:rfc2544",
"service-endpoints": [
{
"endpoint-id": "my_first_endpoint",
"session-protocol": {
"Accedian-session-rfc2544:rfc2544": {
"transport-type": "layer2",
"session-sender": {
"admin-state": true,
"outgoing-port-name": "P802-0325-NNI",
"layer2": {
"y1731-meg-level": 5
},
"test-config": {
"frameloss": {
"duration": 10
}
}
},
"session-reflector": {
"admin-state": false
}
}
}
},
{
"endpoint-id": "my_second_endpoint",
"session-protocol": {
"Accedian-session-rfc2544:rfc2544": {
"transport-type": "layer2",
"session-sender": {
"admin-state": false
},
"session-reflector": {
"admin-state": true,
"layer2": {
"mac-address": "3C:C5:C2:D0:AD:98"
}
}
}
}
}
]
}
]
}
Y.1564
Sample Test Definition for a Layer 2 Test
This example designates "my_first_endpoint" as the sender and "my_second_endpoint" as the reflector/loopback for a Layer 2 Y.1564 test.
RESTCONF POST :: /restconf/data/Accedian-session:sessions
{
"Accedian-session:session": [
{
"session-id": "my_y1564_l2_test",
"session-name": "my_y1564_l2_test",
"description": "Y1564 full configured session",
"session-type": "Accedian-session-type:y1564",
"group-id": "Group1",
"service-endpoints": [
{
"endpoint-id": "my_first_endpoint",
"session-protocol": {
"Accedian-session-y1564:y1564": {
"transport-type": "layer2",
"session-sender": {
"admin-state": true,
"outgoing-port-name": "P802-0325-NNI",
"layer2": {
"y1731-meg-level": 5
},
"test-config": {
"step-duration": 30,
"parallel-test-enable": true,
"test-duration": 60
},
"service": [
{
"service-name": "sgw_service1_fixed_size",
"frame-size-type": "fixed",
"fixed-packet-size": 128,
"cir": 9.5,
"eir": 8.5,
"fdv": 800,
"fdv-type": "average-value",
"flr": 0.00001,
"ftd": 1000,
"ftd-type": "max-value",
"m-factor": 1.5,
"availability": true,
"policing": false,
"step-load": false
},
{
"service-name": "sgw_service2_emix",
"frame-size-type": "emix",
"emix-size-sequence": "bceu",
"emix-user-packet-size": 256,
"cir": 12.5,
"eir": 10.5,
"fdv": 900,
"fdv-type": "max-value",
"flr": 0.0001,
"ftd": 1200,
"ftd-type": "average-value",
"m-factor": 1.8,
"availability": false,
"policing": false,
"step-load": true
},
{
"service-name": "sgw_service3_l2_override",
"frame-size-type": "fixed",
"fixed-packet-size": 128,
"cir": 9.5,
"eir": 8.5,
"fdv": 800,
"fdv-type": "average-value",
"flr": 0.00001,
"ftd": 1000,
"ftd-type": "max-value",
"m-factor": 1.5,
"availability": true,
"policing": false,
"step-load": false,
"config-override": {
"layer2": {
"y1731-meg-level": 4,
"mac-address": "3C:C5:C2:D0:AD:00"
}
}
},
{
"service-name": "sgw_service4_vlan1",
"vlan-1": {
"id": 100,
"tpid": "0x8100",
"cfi": 1,
"prio": 6
}
},
{
"service-name": "sgw_service5_vlan12",
"vlan-1": {
"id": 100,
"tpid": "0x8100",
"cfi": 1,
"prio": 6
},
"vlan-2": {
"id": 200,
"tpid": "0x88a8",
"cfi": 1,
"prio": 5
}
},
{
"service-name": "sgw_service6_l2_override_mac",
"config-override": {
"layer2": {
"mac-address": "3C:C5:C2:D0:AD:00"
}
}
},
{
"service-name": "sgw_service3_l2_override_meg",
"config-override": {
"layer2": {
"y1731-meg-level": 4
}
}
},
{
"service-name": "sgw_service8_default"
}
]
},
"session-reflector": {
"admin-state": false
}
}
}
},
{
"endpoint-id": "my_second_endpoint",
"session-protocol": {
"Accedian-session-y1564:y1564": {
"transport-type": "layer2",
"session-sender": {
"admin-state": false
},
"session-reflector": {
"admin-state": true,
"layer2": {
"mac-address": "3C:C5:C2:D0:AD:98"
}
}
}
}
}
]
}
]
}
Sample Test Definition for a Layer 3 Test
This example designates "my_first_endpoint" as the sender and "my_second_endpoint" as the reflector/loopback for a Layer 3 Y.1564 throughput test.
RESTCONF POST :: /restconf/data/Accedian-session:sessions
{
"Accedian-session:session": [
{
"session-id": "my_y1564_l3_test",
"session-name": "my_y1564_l3_test",
"description": "Y1564 full configured session",
"session-type": "Accedian-session-type:y1564",
"group-id": "Group1",
"service-endpoints": [
{
"endpoint-id": "my_first_endpoint",
"session-protocol": {
"Accedian-session-y1564:y1564": {
"transport-type": "layer3",
"session-sender": {
"admin-state": true,
"outgoing-port-name": "P802-0325-NNI",
"layer3": {
"source-udp-port": 32000,
"dscp": 6
},
"test-config": {
"step-duration": 30,
"parallel-test-enable": true,
"test-duration": 60
},
"service": [
{
"service-name": "sgw_service1_fixed_size",
"frame-size-type": "fixed",
"fixed-packet-size": 128,
"cir": 9.5,
"eir": 8.5,
"fdv": 800,
"fdv-type": "average-value",
"flr": 0.00001,
"ftd": 1000,
"ftd-type": "max-value",
"m-factor": 1.5,
"availability": true,
"policing": false,
"step-load": false
},
{
"service-name": "sgw_service2_emix",
"frame-size-type": "emix",
"emix-size-sequence": "bceu",
"emix-user-packet-size": 256,
"cir": 12.5,
"eir": 10.5,
"fdv": 900,
"fdv-type": "max-value",
"flr": 0.0001,
"ftd": 1200,
"ftd-type": "average-value",
"m-factor": 1.8,
"availability": false,
"policing": false,
"step-load": true
},
{
"service-name": "sgw_service3_l3_override",
"frame-size-type": "fixed",
"fixed-packet-size": 128,
"cir": 9.5,
"eir": 8.5,
"fdv": 800,
"fdv-type": "average-value",
"flr": 0.00001,
"ftd": 1000,
"ftd-type": "max-value",
"m-factor": 1.5,
"availability": true,
"policing": false,
"step-load": false,
"config-override": {
"layer3": {
"dscp": 8,
"ip": "10.11.12.13"
}
}
},
{
"service-name": "sgw_service4_vlan1",
"vlan-1": {
"id": 100,
"tpid": "0x8100",
"cfi": 1,
"prio": 6
}
},
{
"service-name": "sgw_service5_vlan12",
"vlan-1": {
"id": 100,
"tpid": "0x8100",
"cfi": 1,
"prio": 6
},
"vlan-2": {
"id": 200,
"tpid": "0x88a8",
"cfi": 1,
"prio": 5
}
},
{
"service-name": "sgw_service6_l3_override",
"config-override": {
"layer3": {
"dscp": 8
}
}
},
{
"service-name": "sgw_service7_l3_override",
"config-override": {
"layer3": {
"ip": "10.11.12.13"
}
}
},
{
"service-name": "sgw_service8_default"
}
]
},
"session-reflector": {
"admin-state": false
}
}
}
},
{
"endpoint-id": "my_second_endpoint",
"session-protocol": {
"Accedian-session-y1564:y1564": {
"session-sender": {
"admin-state": false
},
"session-reflector": {
"admin-state": true,
"layer3": {
"ip": "20.20.20.21",
"destination-udp-port": 31000
}
}
}
}
}
]
}
]
}
SAT Test Reports
The example below demonstrates how to use Cisco NSO to check available reports and retrieve a specific report.
Get Available SAT Test Reports
admin@ncs(config-device-skylight)# rpc rpc-get-available-reports get-available-reports session-id
Value for 'session-id' (<string>): si-rfc2544L2_full_op1
available-reports [ si-rfc2544L2_full_op1_1727164728127 ]
admin@ncs(config-device-skylight)# rpc rpc-get-available-reports get-available-reports session-id si-rfc2544L2_full_op1
available-reports [ si-rfc2544L2_full_op1_1727164728127 ]
Retrieve SAT Test Report
admin@ncs(config-device-skylight)# rpc rpc-get-report get-report session-id si-rfc2544L2_full_op1 report-name si-rfc2544L2_full_op1_1727164728127
data *******************************************************************************************************************************
* RFC-2544 Conformance testsuite.
*******************************************************************************************************************************
General settings:
File name : 35422-2024_09_24_07_58_48_3
Technician name : SGW
Description : Created with SGW
Note : N/A
Product name : Cisco Provider Connectivity Assurance Sensor Control
Unit identifier : 0FA64D56-9A76-12ED-B40F-1BE05A5E4DB7
Firmware version : VCX_24.09.0_25877
Operation mode : Standard
Serial number : 0FA64D56-9A76-12ED-B40F-1BE05A5E4DB7
Assembly : 500-090-B1:30:46:00
*******************************************************************************************************************************
Testsuite settings:
Name : si-rfc2544L2_full_op1
Description : A SAT description HCCM
Throughput test : Enabled
Delay test : Enabled
Frame loss test : Enabled
Back-to-back test: Enabled
Strict failure : Enabled
Verbose report : Disabled
Exclude VLAN size: Yes
*******************************************************************************************************************************
Peer settings:
Testing layer : Layer-2
Peer MAC address : 00:15:AD:4D:40:38
NID MAC address : 00:15:AD:4E:90:BC
Ethertype : 0x8902
Opcode : 3
MEG level : 5
*******************************************************************************************************************************
Error codes:
Binary search failure (1), Out Of Order or duplicate failure (2),
Frame loss failure (3), Loss of connection with peer (4),
Remote device lost (5)
*******************************************************************************************************************************
Throughput settings:
Trial duration : 120 secs
Maximum rate : 300 Mbps
Minimum rate : 10 Mbps
Step size : 25 Mbps
Frame loss : 0.1%
Fine stepping : True
Binary duration : 10 secs
Frame sizes : 64 128 256 Bytes
Started at : 2024-09-24 07:58:56+00:00
*******************************************************************************************************************************
Frame Tx Tx Rx Rx Frame Status
Size rate rate rate rate loss
(bytes) (Mbps) (frames/sec) (Mbps) (frames/sec) (%)
------- --------- ------------ --------- ------------ ------ ------
64 300 446,428 300 446,428 0.0 Pass
128 300 253,378 300 253,378 0.0 Pass
256 300 135,869 300 135,869 0.0 Pass
*******************************************************************************************************************************
Delay settings:
Trial duration : 30 secs
Maximum rate : 300 Mbps
Minimum rate : 10 Mbps
Step size : 25 Mbps
Fine stepping : True
Binary duration : 10 secs
Frame loss : 1.0%
Frame sizes : 64 128 256 Bytes
Started at : 2024-09-24 08:05:32+00:00
*******************************************************************************************************************************
Frame Tx Minimum Average Maximum Minimum Average Maximum Frame Status
Size rate delay delay delay DV DV DV loss
(bytes) (Mbps) (usec) (usec) (usec) (usec) (usec) (usec) (%)
------- --------- ------- ------- ------- ------- ------- ------- ------ ------
64 300 18 19 32 0 0 13 0.0 Pass
128 300 23 23 35 0 0 11 0.0 Pass
256 300 31 31 40 0 0 8 0.0 Pass
*******************************************************************************************************************************
Frame loss settings:
Trial duration : 100 secs
Maximum rate : 300 Mbps
Step size : 20 Mbps
Fine stepping : True
Binary duration : 10 secs
Frame sizes : 64 128 256 Bytes
Started at : 2024-09-24 08:07:38+00:00
*******************************************************************************************************************************
Frame Tx Tx Rx Rx Frame Status
Size rate rate rate rate loss
(bytes) (Mbps) (frames/sec) (Mbps) (frames/sec) (%)
------- --------- ------------ --------- ------------ ------ ------
64 300 446,428 300 446,428 0.0 Pass
64 275 409,226 275 409,226 0.0 Pass
128 300 253,378 300 253,378 0.0 Pass
128 275 232,263 275 232,263 0.0 Pass
256 300 135,869 300 135,869 0.0 Pass
256 275 124,547 275 124,547 0.0 Pass
*******************************************************************************************************************************
Back-to-back settings:
Trial duration : 1100 milli-secs
Repeat : 5 times
Frame sizes : 64 128 256 Bytes
Started at : 2024-09-24 08:18:50+00:00
*******************************************************************************************************************************
Frame Port Average Repeat Status
Size speed Burst
(bytes) (Mbps) (frames)
------- ---------- ------------ ------ ------
64 999 918,279 5 Pass
128 1000 637,646 5 Pass
256 1000 365,300 5 Pass
*******************************************************************************************************************************
Ended at : 2024-09-24 08:19:34+00:00
Testsuite status : Completed
*******************************************************************************************************************************
report-name si-rfc2544L2_full_op1_1727164728127
admin@ncs(config-device-skylight)#
Delete SAT Test Report
rpc rpc-delete-report delete-report session-id ss-SAT_Test001_id report-name ss-SAT_Test001_id_1729678102752
© 2024 Cisco and/or its affiliates. All rights reserved.
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms
For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks