Configuring Y.1564

This document describes the Y.1564 test feature and configuration steps to execute Y.1564 feature.

Prerequisites for Configuring Y.1564

  • You must disable:

    • Link Layer Discovery Protocol (LLDP) transmit and receive on source port.

    • Loop protection on destination port or Spanning Tree Protocol (STP) on destination and source port.

    • Spanning Tree Protocol (STP).

  • NID must have an IP address.

  • Loop should not be configured.

Information About Y.1564

ITU-T Y.1564 (Or sometimes called Y.156sam or EtherSAM - Ethernet Service Activation Methodology) is a QoS and network performance ITU-T Ethernet-based service test methodology. This testing procedure tests service turn-up, installation and troubleshooting of Ethernet-based services.

Y.1564 allows simultaneous testing of multiple Ethernet services and measures. It also validates the different QoS mechanisms provisioned in the network to prioritize different service types - allowing faster deployment, easier service and network troubleshooting.

Y.1564 allows simultaneous testing of multiple Ethernet services and measures. It also validates the different QoS mechanisms provisioned in the network to prioritize different service types - allowing faster deployment, easier service and network troubleshooting.

Configuring New Y.1564 Profile

     Command or ActionPurpose
    Step 1Configure NID


    Example: 
    UCS# Configure NID 1
          		Opens a new session for NID 1.  
    Step 2 ciscoY1564


    Example: 
    UCS# ciscoY1564
          		Enters ciscoY1564 configuration mode.  
    Step 3setY1564Profile y1564ProfileProfile name|description|acceptable_fdv acceptable_gdv|acceptable_flr acceptable_flr|acceptable_ftd acceptable-_td | cir_test {dm_interval dm-_nterval |duration duration | step_count step_count | start { enable | disable } } | dst_oam_ aware { enable | disable } | dwell_time dwell_time | eir_test { enable | disable } | meg_level meg_level duration | performance_test { enable | disable } | traffic_policing_test { dm_interval | duration } | } traffic_type { customer_simulated | oam } | emix | user_defined_frame_size }


    Example: 
    UCS(ciscoY1564)# setY1564Profile y1564Profile profileName
UCS(ciscoY1564)# setY1564Profile y1564Profile description
UCS(ciscoY1564)# setY1564Profile y1564Profile acceptable_fdv 0-10000
UCS(ciscoY1564)# setY1564Profile y1564Profile acceptable_flr 0-1000
UCS(ciscoY1564)# setY1564Profile y1564Profile acceptable_ftd 0-10000
UCS(ciscoY1564)# setY1564Profile y1564Profile cir_test start enable
UCS(ciscoY1564)# setY1564Profile y1564Profile cir_test dm-interval 100-10000
UCS(ciscoY1564)# setY1564Profile y1564Profile cir_test duration <cr>
UCS(ciscoY1564)# setY1564Profile y1564Profile cir_test step-count 1-1000
UCS(ciscoY1564)# setY1564Profile y1564Profile dst_oam-aware enable
UCS(ciscoY1564)# setY1564Profile y1564Profile dwell_time 100-10000
UCS(ciscoY1564)# setY1564Profile y1564Profile eir_test enable
UCS(ciscoY1564)# setY1564Profile y1564Profile meg_level 0-7
UCS(ciscoY1564)# setY1564Profile y1564Profile performance_test enable
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_policing_test dm_interval 100-10000
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_policing_test duration <cr>
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_policing_test duration start enable
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_type
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_type customer-simulated <cr>
UCS(ciscoY1564)# setY1564Profile y1564Profile traffic_type oam <cr>
UCS(ciscoY1564)# setY1564Profile y1564Profile  emix
UCS(ciscoY1564)# setY1564Profile y1564Profile e emix U       
UCS(ciscoY1564)# setY1564Profile y1564Profile user_defined_frame_size <cr>
     
    • profileName— Enter the name of the profile for Y1564 .
    • description— Enter a brief description about the profile .
    • acceptable_fdv— Enter frame delay variation in milliseconds to configure Y1564. Acceptable limit is 0-10000. The default value is 0, which disables the test.
    • acceptable_flr— Enter frame loss ratio per mile to configure Y1564. Acceptable limit is 0-1000. The default value is 0 and 1000 disables the test.
    • acceptable_ftd— Enter frame transfer delay in milliseconds to configure Y1564. Acceptable limit is 0-10000.Acceptable limit is 0-10000. The default value is 0, which disables the test.
    • cir_test— Enter frame delay variation in milliseconds to configure Y1564. Acceptable limit is 0-10000.
      • dm_interval— Enter the interval of between sending delay measurement frame. Acceptable limit is 100-10000.
      • duration— Enter the duration of one step.
      • step_count— Enter the number of steps to configure CIR. Acceptable limit is 1-1000
      • start—Enter enable or disable to configure CIR test.
    • dst_oam_aware— Enter enable or disable to configure remote end Y.1731 OAM aware.
    • dwell_time— Enter the time frame of execution, pauses in milliseconds after each trial before reading counters, and status from hardware. Acceptable limit is 100-10000. Default value is 500.
    • eir_test— Enter EIR configuration test and optionally set its parameters to configure Y1564. Parameters are dm-interval, duration and start.
    • meg_level— Enter the profile MEG level to configure Y1564 . Acceptable limit is 0-7.
    • performance_test— Enter the performance test parameters.
      • dm_interval— Enter the time interval in milliseconds between sending delay measurement frame. Acceptable limit is 100-10000.
      • duration— Enter the duration of performance test.
      • start—Enter enable or disable to start the performance test.
    • traffic_policing_test— Enter the traffic policing test parameters..
      • dm_interval— Enter the time interval in milliseconds between sending delay measurement frame. Acceptable limit is 100-10000.
      • duration— Enter the duration of traffic policing test.
      • start—Enter enable or disable to start the traffic policing test.
    • traffic_type— Enter the type of traffic generated at the near end.
      • customer_simulated— Enter the frames that simulate real customer traffic as background traffic.
      • oam— Enter the duration of traffic policing test.
    • emix— select the frame size(EMIX letter-encoded) that the enabled tests will use. Encoding is as follows: a: 64, b: 128, c: 256, d: 512, e: 1024,f: 1280, g: 1518, h: MTU, u: user-defined.
    • user_defined_frame_size— Enter the frame size if emix is set to 'U'.
     
    Step 4 review


    Example: 
    UCS(ciscoY1564)# setY1564Profile review
          		Reviews the ciscoY1564 profile configuration parameters.  
    Step 5 commit


    Example: 
    UCS(ciscoY1564)# setY1564Profile commit
          		Sends the ciscoY1564 profile parameters to the NID.  
    Step 6 exit


    Example: 
    UCS(ciscoY1564)# exit
          		Exits ciscoY1564 profile configuration mode.  

    Getting the Profile Configuration using Profile Name

       Command or ActionPurpose
      Step 1Configure NID


      Example: 
      UCS# Configure NID 1
              		Opens a new session for NID 1.  
      Step 2 ciscoY1564


      Example: 
      UCS# ciscoY1564
              		Enters ciscoY1564 configuration mode.  
      Step 3getY1564ProfilegetY1564ProfileReq


      Example: 
      UCS(ciscoY1564)# getY1564Profile getY1564ProfileReq
              		Retrieves the Profile configuration.  
      Step 4getY1564Profilereview


      Example: 
      UCS(ciscoY1564)# getY1564Profile review
              		Displays the Y.1564 profile configuration.  
      Step 5getY1564Profilecommit


      Example: 
      UCS(ciscoY1564)# getY1564Profile commit
              		Sends the Y.1564 profile configuration information to the NID.  
      Step 6 exit


      Example: 
      UCS(ciscoY1564)# exit
              		Exits ciscoY1564 profile configuration mode.  

      The following example shows the Profile Configuration using the Profile Name: 

      UCS # getY1564Profile commit 
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.profileName = 'cisco123456'
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.description = 'oamunaware'
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.acceptable_fdv = 0
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.acceptable_ftd = 0
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.acceptable_flr = 0
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.dst_oam_aware = false
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.dwell_time = 500
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.emix = '1024'
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.meg_level = 7
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.traffic_type.t = 1
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.traffic_type.u.oam = '0'
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.user_defined_frame_size = 2000
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.cir_test.start = true
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.cir_test.duration = 60
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.cir_test.dm_interval = 500
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.cir_test.step_count = 4
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.eir_test.start = true
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.eir_test.duration = 60
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.eir_test.dm_interval = 500
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.performance_test.start = true
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.performance_test.duration = 10
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.performance_test.dm_interval = 100
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.traffic_policing_test.start = true
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.traffic_policing_test.duration = 10
GetY1564Profile_Output.y1564Profile.y1564Profile_ELEM_0.traffic_policing_test.dm_interval = 100

 GetY1564Profile Commit Success

      Viewing Profile Names

         Command or ActionPurpose
        Step 1Configure NID


        Example: 
        UCS# Configure NID 1
                  		Opens a new session for NID 1.  
        Step 2 ciscoY1564


        Example: 
        UCS# ciscoY1564
                  		Enters ciscoY1564 configuration mode.  
        Step 3showY1564showY1564Req{profiles|reports}


        Example: 
        UCS(ciscoY1564)# showY1564 showY1564Req
                  		Displays existing profiles or report information.  
        Step 4showY1564review


        Example: 
        UCS(ciscoY1564)# showY1564 review
                  		Displays the profile configurations.  
        Step 5 exit


        Example: 
        UCS(ciscoY1564)# exit
                  		Exits ciscoY1564 profile configuration mode.  

        The following example shows the configurations to display a particular Profiles using the profile name or description: 

        UCS (ciscoy1564)# showY1564 commit 
ShowY1564_Output.showY1564Resp.t = 1
ShowY1564_Output.showY1564Resp.u.profile[0].profileName = 'NewProfile1'
ShowY1564_Output.showY1564Resp.u.profile[0].description = ''
ShowY1564_Output.showY1564Resp.u.profile[1].profileName = 'cisco123456'
ShowY1564_Output.showY1564Resp.u.profile[1].description = 'oamunaware'
ShowY1564 Commit Success

        Managing Y.1564 Profile Names

           Command or ActionPurpose
          Step 1Configure NID


          Example: 
          UCS# Configure NID 1
                      		Opens a new session for NID 1.  
          Step 2 ciscoY1564


          Example: 
          UCS# ciscoY1564
                      		Enters ciscoY1564 configuration mode.  
          Step 3y1564ProfileManagementy1564ProfileManagmentReq{delete|rename{new-name|old_name}}


          Example: 
          UCS(ciscoY1564)# y1564ProfileManagement y1564ProfileManagmentReq rename old-name cisco123456
UCS(ciscoY1564)# y1564ProfileManagement y1564ProfileManagmentReq rename new-name cisco
UCS(ciscoY1564)# y1564ProfileManagement y1564ProfileManagmentReq delete cisco
           

          • rename—Set rename to rename a old profile name.

          • delete—Set delete to delete an existing profile.

           
          Step 4 review


          Example: 
          UCS(ciscoY1564)# y1564ProfileManagement review
                      		Reviews the ciscoY1564 profile names.  
          Step 5 commit


          Example: 
          UCSh(ciscoY1564)# y1564ProfileManagement commit
                      		Sends the changed or deleted ciscoY1564 profile names to the NID .  
          Step 6 exit


          Example: 
          UCS(ciscoY1564)# exit
                      		Exits ciscoY1564 profile configuration mode.  

          Configuring Y.1564 Test Parameters

             Command or ActionPurpose
            Step 1Configure NID


            Example: 
            UCS# Configure NID 1
                          		Opens a new session for NID 1.  
            Step 2 ciscoY1564


            Example: 
            UCS# ciscoY1564
                          		Enters ciscoY1564 configuration mode.  
            Step 3setY1564TestParams y1564TestsReq {dei |description |dscp|ece |evc |interface |pcp|peer_mac |profile_name |report-name | vlanvlan_id }


            Example: 
            UCS(ciscoY1564)#setY1564TestParams y1564TestsReq profile-name cisco123456 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq report-name controllerreport123456 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq description dstmodeno 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq evc 1 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq ece 1 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq interface 3 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq peer-mac 00-00-00-00-00-01 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq pcp 2 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq vlan untagged 
UCS(ciscoY1564)#setY1564TestParams y1564TestsReq dei 0 
UCS(ciscoY1564)#setY1564TestParams review
UCS(ciscoY1564)#setY1564TestParams commit
             

            • dei— Enter the DEI number of the profile. The valid range is 0-1.

            • description— Enter the description about the test.

            • dscp— Enter the DSCP number of the profile. The valid range is 0-63.

            • ece— Enter the ECE ID number of the profile, on which the test needs to be executed. The valid range is 1-1024.

            • evc— Enter the EVC ID number of the profile. The valid range is 1-1024.

            • interface— Enter the UNI port. The valid range is 1-125.

            • pcp— Enter the PCP number of the profile. The valid range is 0-7.

            • peer-mac— Enter peer MAC address.

            • profile-name— Enter the name of the existing profile, that needs to be tested.

            • report-name— Enter a unique name for the test report.

            • vlan— Enter the Vlan ID.

             
            Step 4 review


            Example: 
            UCS(ciscoY1564)# setY1564TestParams review
                          		Reviews the ciscoY1564 profile test parameters.  
            Step 5 commit


            Example: 
            UCS(ciscoY1564)# setY1564TestParams commit
                          		Sends the test parameter reports to the NID.  
            Step 6 exit


            Example: 
            UCS(ciscoY1564)# exit
                          		Exits ciscoY1564 profile configuration mode.  

            Configuration Example

            when profile is configured as DST, then OAM-aware port and peer-mac address need to be specified in setY1564TestParams. 

            UCS# ciscoY1564
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq profile-name cisco123456 
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq report-name controllerreport123456 
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq description dstmodeno
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq peer-mac 00-02:01:00:01:03 
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq evc 1 
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq ece 1 
UCS(ciscoY1564)# setY1564TestParams y1564TestsReq interface 3 
UCS(ciscoY1564)# setY1564TestParams review
UCS(ciscoY1564)# setY1564TestParams commit

            Viewing Y.1564 Test Parameters

               Command or ActionPurpose
              Step 1Configure NID


              Example: 
              UCS# Configure NID 1
                              		Opens a new session for NID 1.  
              Step 2 ciscoY1564


              Example: 
              UCS# ciscoY1564
                              		Enters ciscoY1564 configuration mode.  
              Step 3getY1564TestParamsgetY1564TestsReq


              Example: 
              UCS(ciscoY1564)# getY1564TestParams getY1564TestsReq
                              		Retrieves the parameters set for latest tet.  
              Step 4 review


              Example: 
              UCS(ciscoY1564)# getY1564TestParams review
                              		Reviews the ciscoY1564 profile configuration parameters.  
              Step 5 commit


              Example: 
              UCS(ciscoY1564)# getY1564TestParams commit
                              		Sends the test parameter reports to the NID.  
              Step 6 exit


              Example: 
              UCS(ciscoY1564)# exit
                              		Exits ciscoY1564 profile configuration mode.  

              Saving Y.1564 Test Report

                 Command or ActionPurpose
                Step 1Configure NID


                Example: 
                UCS# Configure NID 1
                                  		Opens a new session for NID 1.  
                Step 2 ciscoY1564


                Example: 
                UCS# ciscoY1564
                                  		Enters ciscoY1564 configuration mode.  
                Step 3y1564ReportManagement y1564ReportManagementReq{save|stop}


                Example: 
                UCS(ciscoY1564)# y1564ReportManagemen  y1564ReportManagementReq save reportName controllerreport
UCS(ciscoY1564)# y1564ReportManagemen  y1564ReportManagementReq save tftpPath tftp://202.153.144.25/auto/tftp-blr-users1/sharsh
                 

                • Save—Set save to save a profile test report.

                • Stop—Set stop to stop an ongoing profile test .

                 
                Step 4 review


                Example: 
                UCS(ciscoY1564)#y 1564ReportManagement review
                                  		Reviews the ciscoY1564 profile test report.  
                Step 5 commit


                Example: 
                UCS(ciscoY1564)# y1564ReportManagement commit
                                  		sends the ciscoY1564 profile test report to the NID.  
                Step 6 exit


                Example: 
                UCS(ciscoY1564)# exit
                                  		Exits ciscoY1564 profile configuration mode.  

                Deleting Y.1564 Test Report

                   Command or ActionPurpose
                  Step 1Configure NID


                  Example: 
                  UCS# Configure NID 1
                                      		Opens a new session for NID 1.  
                  Step 2 ciscoY1564


                  Example: 
                  UCS# ciscoY1564
                                      		Enters ciscoY1564 configuration mode.  
                  Step 3y1564ReportManagement y1564ReportManagementReq{delete|stop}


                  Example: 
                  UCS(ciscoY1564)# y1564ReportManagemen  y1564ReportManagementReq delete controlerreport
                   

                  • delete—Set delete to delete an existing profile test report.

                  • Stop—Set stop to stop an ongoing profile test .

                   
                  Step 4 review


                  Example: 
                  UCS(ciscoY1564)# y1564ReportManagement review
                                      		Reviews the ciscoY1564 profile test report.  
                  Step 5 commit


                  Example: 
                  UCS(ciscoY1564)# y1564ReportManagement commit
                                      		sends the ciscoY1564 profile test report to the NID.  
                  Step 6 exit


                  Example: 
                  UCS(ciscoY1564)# exit
                                      		Exits ciscoY1564 profile configuration mode.