Service Activation Testing (RFC 2544 and Y.1564)
  • 01 Nov 2024
  • 8 Minutes to read
  • Contributors
  • PDF

Service Activation Testing (RFC 2544 and Y.1564)

  • PDF

Article summary

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"
                 }]
             }

nid-endpoint-sat-overview.png

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



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.