From de52a488b6d690b60d4bf872654e2ab2f627f54e Mon Sep 17 00:00:00 2001 From: kannankvs Date: Wed, 17 Aug 2022 10:33:10 +0530 Subject: [PATCH 01/18] Update on Index file (#1042) Updated Index file for font alignment (wiki, github, linux foundation) and link change for Sonic build image url Co-authored-by: Xin Liu --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 75f120a000..2c088d2205 100644 --- a/index.html +++ b/index.html @@ -95,7 +95,7 @@
  • Building Guide
  • Testing Guide
  • Technical FAQ
    • -
  • SONiC Latest Images
    • +
  • SONiC Latest Images
  • @@ -149,11 +149,11 @@

    Software for Open Networking in the

    - Wiki + Wiki        - GitHub + GitHub        - Linux Foundation + Linux Foundation

    From 52bbb2d492306235f4690a305d90d0cea783a6b0 Mon Sep 17 00:00:00 2001 From: Yanzhao Zhang Date: Thu, 18 Aug 2022 13:33:09 -0700 Subject: [PATCH 02/18] added https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md updated the CLI/YANG section by adding https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md --- doc/hld_template.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/hld_template.md b/doc/hld_template.md index 3a96629539..a32d3f99a7 100755 --- a/doc/hld_template.md +++ b/doc/hld_template.md @@ -66,6 +66,7 @@ Paste a preliminary manifest in a JSON format. This sub-section covers the addition/deletion/modification of CLI changes and YANG model changes needed for the feature in detail. If there is no change in CLI for HLD feature, it should be explicitly mentioned in this section. Note that the CLI changes should ensure downward compatibility with the previous/existing CLI. i.e. Users should be able to save and restore the CLI from previous release even after the new CLI is implemented. This should also explain the CLICK and/or KLISH related configuration/show in detail. +https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md needs be updated with the corresponding CLI change. #### Config DB Enhancements @@ -88,4 +89,4 @@ Example sub-sections for unit test cases and system test cases are given below. ### Open/Action items - if any -NOTE: All the sections and sub-sections given above are mandatory in the design document. Users can add additional sections/sub-sections if required. \ No newline at end of file +NOTE: All the sections and sub-sections given above are mandatory in the design document. Users can add additional sections/sub-sections if required. From 96d1442da29da850d229401f672c21b2f0db9240 Mon Sep 17 00:00:00 2001 From: svshah-intel <102195908+svshah-intel@users.noreply.github.com> Date: Sun, 21 Aug 2022 11:45:27 -0700 Subject: [PATCH 03/18] SRv6 uSID design for srv6orch (#1034) * SRv6 uSID design for srv6orch --- doc/srv6/SRv6_uSID.md | 112 ++++++++++++++++++++++++++ doc/srv6/images/SRv6_uSID_Example.png | Bin 0 -> 20866 bytes 2 files changed, 112 insertions(+) create mode 100755 doc/srv6/SRv6_uSID.md create mode 100755 doc/srv6/images/SRv6_uSID_Example.png diff --git a/doc/srv6/SRv6_uSID.md b/doc/srv6/SRv6_uSID.md new file mode 100755 index 0000000000..c951a17577 --- /dev/null +++ b/doc/srv6/SRv6_uSID.md @@ -0,0 +1,112 @@ +# SONiC uSID + +## Table of Content +- [Overview](#Overview) +- [Scope](#Scope) +- [Design](#Design) +- [Example](#Example) + +## Revision + +| Rev | Date | Author | Change Description | +| :--: | :-------: | :------------------------------: | :--------------------------: | +| 0.1 | 7/17/2022 | Shitanshu Shah, Reshma Sudarshan | Initial version | +| 0.2 | 7/24/2022 | Shitanshu Shah, Reshma Sudarshan | Incorporate review comments | + +## Overview +SRv6 uSID (micro-segment) is extension of the SRv6 network programming model, refer to IETF drafts [Compressed SRv6 Segment List Encoding]( draft-ietf-spring-srv6-srh-compression-02) and [SRv6 uSID instructions IETF draft](https://datatracker.ietf.org/doc/draft-filsfils-spring-net-pgm-extension-srv6-usid/). uSID is a compressed SID value which can be for example carried in 16-bits (unlike full IPv6 address to represent a SID). uSID as is designed scales well with much lower MTU overhead required per uSID carrier. uSID carrier is 128-bit IPv6 address that can carry upto 6 uSIDs [Refer to Example for more details] + +## Scope +The scope of this document is to enhance orchagent to support uSID programming instructions in this IETF draft. Current SAI API definitions already support uSID instructions. No SAI API change required in scope of this document. Current version of routing protocols in SONiC does not support SRv6, it is not in the scope of this document to add such a support for FRR routing stack. + +## Design +Current srv6orch is designed, per [SRv6 HLD](https://github.com/sonic-net/SONiC/blob/master/doc/srv6/srv6_hld.md), to support SRv6 programming instructions as described in RFC 8754 and RFC 8986. This design extends SRv6 Network Programming with a new type of SRv6 SID behaviors defined as uSID. + +SRv6 uSID fully leverages current SRv6 control-plane, without any change, as is implemented by srv6orch. +Following uSID behaviors are added, +uN - uN behavior is implemented with PSP and USD flavor +uA - uA local behavior is implemented with PSP and USD flavor +uDT - uDT local behavior is implemented exactly same as that of End.DT4/End.DT6 +uDX - uDX local behavior is implemented exactly same as that of End.DX4/End.DX6 + +PSP and USD end behavior flavors are already supported by SAI API today. End.DT4/6 and End.DX4/6 end behaviors are supported by SAI APIs as well. Thus there is no additional change required in SAI to support uN, uA, uDT and uDX behaviors. + +Changes in orchagent, +- While processing MYSID entries, from SRV6_MY_SID_TABLE off of APPDB, handling of new actions uN, uA, uDT and uDX added in srv6orch. No APPDB schema changes required. +- SAI end behavior and end behavior flavor are determined, before calling SAI APIs, to program MYSID entries + +```text +const map end_behavior_map = +{ + {"end", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_E}, + {"end.x", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_X}, + {"end.t", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_T}, + {"end.dx6", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DX6}, + {"end.dx4", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DX4}, + {"end.dt4", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT4}, + {"end.dt6", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT6}, + {"end.dt46", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT46}, + {"end.b6.encaps", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_B6_ENCAPS}, + {"end.b6.encaps.red", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_B6_ENCAPS_RED}, + {"end.b6.insert", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_B6_INSERT}, + {"end.b6.insert.red", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_B6_INSERT_RED}, ++ {"udx6", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DX6}, ++ {"udx4", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DX4}, ++ {"udt6", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT6}, ++ {"udt4", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT4}, ++ {"udt46", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_DT46}, ++ {"un", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_UN}, ++ {"ua", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_UA} +}; + +const map end_flavor_map = +{ + {"end", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_FLAVOR_PSP_AND_USD}, + {"end.x", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_FLAVOR_PSP_AND_USD}, + {"end.t", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_FLAVOR_PSP_AND_USD}, ++ {"un", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_FLAVOR_PSP_AND_USD}, ++ {"ua", SAI_MY_SID_ENTRY_ENDPOINT_BEHAVIOR_FLAVOR_PSP_AND_USD} +}; +``` + +## Example +uSID carrier is 128-bit IPv6 address which is specified in following format: +```text +...[...] +``` +- uSID Block: An IPv6 prefix (defines a block of SRv6 uSIDs) +- Active uSID: The first uSID +- Next uSID: The next uSID after the Active uSID. +- Last uSID: The last uSID in the carrier before the End-of-Carrier +- End-of-Carrier: A globally reserved uSID that marks the end of a uSID list. The End-of-Carrier ID is 0000. As many End-of-Carriers as required to complete full 128-bits IPv6 address + +![](images/SRv6_uSID_Example.png) + +- uSID block: 2001:41f0 +- Active uSID: 0100 +- Next uSID: 0200 +- Last uSID: 0A00 +- 2 End-of-Carriers (0000) to complete full 128-bits IPv6 address + +A node with local uSID of 2001:41f0:0100 is to be programmed with following SRV6_MY_SID_TABLE entry, with appropriate uSID end behavior. Following shown two separate examples with 2 different end behaviors. + +```text +Note: prefix of "16:8:8:8" is (locator_block_len:locator_node_len:function_len:args_len) as is currently consumed by srv6orch. + +If end-behavior "un" +"SRV6_MY_SID_TABLE" : { + "16:8:8:8:2001:41f0:0100::" : { + "action": "un", + } +} + +If end-behavior is "udt46" +"SRV6_MY_SID_TABLE" : { + "16:8:8:8:2001:41f0:0100::" : { + "action": "udt46", + "vrf": "VRF-1001" + } +} + +A node with local uSID of 2001:41f0:0200 is to be programmed with appropriate uSID end behavior, similarly for node with 2001:41f0:0500, and for node with 2001:41f0:0A00 +``` diff --git a/doc/srv6/images/SRv6_uSID_Example.png b/doc/srv6/images/SRv6_uSID_Example.png new file mode 100755 index 0000000000000000000000000000000000000000..3885802945ed1429e2c8e4d99c61dc4365859185 GIT binary patch literal 20866 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 +C z)o_P^II%^R%}}S@XHC_EkT)fq5d%LjyEE?!UJ>+pbhwa|6IHyA($?&bM~njLCXYUa zZ-tFPtBl}SGL1*QRNzb6fbrX%qW}BhUmTadK_-H3WIn;V!{ZE*j23$Qs#`Z;lkBYK z2E<7APebx|#x>o2JZ58mnzeengyvFG1=?=!!%5p_&<%(BE@5Kkp%YzP&@G|1igm&> zp!K~9gj`Un^~J;-5w$4WM{N2Rqs%%TuxsnGtF$Hb`ob>HqcAJL(dhb0%C{Jq03L80 zQ3g1qaPwV-TTB{p`WMSRgxdR*j(~v;NfK7J=x%zb%=;1Z7LQpr=NS|h@W`L*9k&4| zfaY%dh}W3&9ggGb`;Sbnx&oUwe+$v}k|R(4!-c6w>>K{{fRf2Yn{{7I)0zm8rr zXTjc25D&_Bc~;s%sFx5e9o^LjnoFmF)PqiFUu}|EfMd2kb)uDo* zgIQ4V{_#Hga9M#op%kVm1Xdh@>tWRcSw){* z1ho;>UlO%?pDy87A24OSh~YgHYSs*&^f`EbFVbKz*9Hhem<>}*X8Fxk4)W7bMJ%y@ZD_+|HM%Lhb_fx6tP6vI*b3noVK~QBFOgq)pLbs-0%MzCfGcq literal 0 HcmV?d00001 From 6411027619614bfd70918156acc41970b33b0923 Mon Sep 17 00:00:00 2001 From: bhaveshdell <55215495+bhaveshdell@users.noreply.github.com> Date: Tue, 23 Aug 2022 16:24:14 -0700 Subject: [PATCH 04/18] Event and Alarm Managment Framework HLD. (#1064) --- .../event-alarm-framework-alarm-lifecycle.png | Bin 0 -> 180240 bytes .../event-alarm-framework-blockdiag.png | Bin 0 -> 193926 bytes .../event-alarm-framework-seqdiag.png | Bin 0 -> 252171 bytes .../event-alarm-framework.md | 1300 +++++++++++++++++ 4 files changed, 1300 insertions(+) create mode 100644 doc/event-alarm-framework/event-alarm-framework-alarm-lifecycle.png create mode 100644 doc/event-alarm-framework/event-alarm-framework-blockdiag.png create mode 100644 doc/event-alarm-framework/event-alarm-framework-seqdiag.png create mode 100644 doc/event-alarm-framework/event-alarm-framework.md diff --git a/doc/event-alarm-framework/event-alarm-framework-alarm-lifecycle.png b/doc/event-alarm-framework/event-alarm-framework-alarm-lifecycle.png new file mode 100644 index 0000000000000000000000000000000000000000..9773603e4b71d33559ea0862cb2585fe752de689 GIT binary patch literal 180240 zcmeFZXH=A3(l)Ay3i_ZRAPN#pC?KFflanASN{}pBMPdU@&Oty7D8WEzqGV{2m+ErIwRdv6ABKLso6z!=aM~;w5 zKfI@StMEc%cWe1&^enS@(72Mh)Tl6{y6UjrGC-=mk zh~NA5hV0f&R#tAkyQuafZE;r>rP?nl8&C;-e0u+r0`a}$aS!K7NIWmEL@u~=hB}Y; zNXykr3tTV58yN5xr><&m&-AUAHo2!=$h`dO2oVX>zy1+_bNmID%L%!EeZ|53R~&|! z#g7~%CjZwzOq9eVIIg3gl>W{8pr?s1REhkD_lYx;kfZg9t|b2Jx9zXx)u6BQzhBf5 z4;gYMhkD|BavuL)5=YAE*8js5L`bmqAkuf?ME_O}M~-^(&HaZfh`H{*8f2#=7dZZJ z)pLZ17}0m^-zg9*`K9NPa!qC?t5g3@IY3GzxPp`aMtzVRYlx3}=F5nWQ2mEjlA|rp z{s%1wkb<=%U)8YuhgUK=3^V)(E&tcB{ua=G4U2^7|7V6JaplSMz#fN{D9dE;)5+eD zkdP{xc)0E23-17)Hy^I-JIa7uqB3a>D}}8)YBCK|!sAV88he9YH?r0~htnT88i~u| z3+GSSroaE=!^F?fB#GM3#rnLz82y2Uvw4Whh7r1&$?()n$xT@tF1`O(c#o@-@BS^~ zE2qfOQuEzy+=tvqh1|ETlZ;;#B84&6Y)Oi%TA2v{nWfHjUxOixP3>)?{XhwK7-!?? z!7*q00Q^iANf3sxa)O^1f8;U6=q@ainJH;`m*B5Gl!>IJf9Chw58T%J`_`r7B)BW? ze@z}eHH13}2q zynEk+WMfX)9dn)&h{Ui=h!HmXi52KC`RapWioee~G5NbA9-+%)xetpR7Pm=^SY_|+ zi;n3Q@#nZO`y6=w?OU{xSN|4XKXA8`%)>_xX^)&l`CD&aVgHM`WRJOKw}bV5^T77z z(s>;_5c0hQu>6;PbZPeqirKf2E5xYgh;6?(KZ@3;v;>n9zd-Wq*RO_tr}>iEpWj$` zjvmO)6NJ~(M81-T-8|E6k16Z%xgceh?KCH8yr#|yQ?n|&AsHnN58rX#%X zDu5ZT2T~t_Ona`o)#}jo6*@rYGjHFW*f*Zn(ctC_XHLmV5M(S4;^2|!ZnA^5?{BV+ z6GVSEZa;#8{y-0p8fqqo4}F=jqX!a(-uk)(Jh1yL1=+sRNF>4YZeOAbeN8xPuYj_S zN@UUbjzS&~=Sf^7_)+~U#~*5O|KEk!Tnt~2d_sWsIMo3k-k&a>U` z+@nvcT2^{$w8=~i>$()Tn`er&i{z(xA~u#|6n#JbQIBi$jq8)EX__#{;i^}D`ZtJU zq`;0e?tgaMhbSZWz{o!LEkUAuQd7h`WPp1_nk_%Agw>Q^* z_((B5A-FE? z01VE1yr2a&Ls3xlQd-u${UPD)%BcRi>GOLTpDQ`2a3D&B)RlZwa+r> zjTXktW09iS+e@PwVFAy!htnOlUkr%mvgqn;T93AE7uy-vgu-+dqmtE?wBa3})gPFb z@8XMMC5{(!QX_h-%d7$yfR&uiSo{V%a61ox1VuDvKI|XjgP%!o&0`uGp$EuUl-DYE zbvru8^r}~0;I~*q`7%TYiq%R~Qy0328%S`TC3(gH*;QfAC~0{ze3mU-g;Vif^1Ag& zM0TE8wvtjPYaZDHf7I~rND3zZa-|PtPBFLRORh9Qpm(TE&;zDBzZE@{E$Zppa)Cr ziEe;ZC=90iP{Z1l^G9pH#1y5CQ>$%|edVG>>yPw$oIo_uA_`yVVU*|N&)~uzmAy!4 zLkx(nYLyB%2KXlF4!p5uw%~@B!)~g#Whn9c37JVSWkXr#pWB&Rlo_ z@=>X9W~QLUR?dkGoir);olkxK?d8}JUpiOSE#z`3HpY93ijBGYTEMH%VP`yy&I5^$ zwZlSW;X+U=JZ!qGKNXqIsZ=%n zEnHTnJq()<|NVxHVSSMby@^_Jjx|>5f0`a{7bTor#;%zVaYGJRN0*u>ju--|#I$b- zsv>8Gtd@(M=h&aMcoT|@RlX+AfOi^s$Do;Y?*^yVLyW9^d00;^l4v<3rLCEC zgoFL*?SA;s@!$2LB==B2E^&UBW(l}Q91t8Ff1nqz;#)u{^;{ZqmlBBVRZ^3pSEo~+ zMhYLzZBh0Yz_1CPB&I{_SLMpmh5O{Umxpc60N>Vu(h|7NeBF4>kDfN$T>D3Pn9^jh zm>Ne(89ew+s(Ngx?KH|d*F+E*67r%~HX-z{iM8j6HzBL}T^7MAOFfk&!(7n)P0~~7a=BF*^2yv?oz>pxFJ8KXA;KU;yuOOt6@S^%Ac>&tu zxh93dE{6EA{N6?^ULJwn=Ii?ge-zZN(AECIVBnc&enU}SVQGdB-|}WlN_yMRVBPfY zkPEKPgRf>2otMv}1*$_?*qX0jpY+l$wvms2#QK#j*uZQcopieEM%0@@_EV+gHkT!V z(OmpJ{EVVL_y8Z8@x)SEgxTIR!dK|%CAJowePgj_9 z*|gc1Q4g#MmM@DEjE`hfHCi3|NsMqwCf^VPgpc`g!h-%Snz~JS`~bAXCqG-Zd!O<+ zsD0$VuX6OWaw=-8xj{317c>r=TMuXB)Iu92qQcvg6cV(A0tOprFv%LQ)nugy$E`-& zI)|$}@Z(Xrvm2IJIo8%x6&8cu^D!s-JOs!5-6dXHLUQ*CAk^Xe z|GRk`5Y0VGZ-?h?nxIG?01QP+&PRjy98rG4N$@6izQ5vDh@Fyr584DyW5=<0}Y=DeJ%CYRD_3&REYAMR4Ei4nW^!gCiwJYqsSB84kG_v^3tBmA?~0D2m;Nf`4rJHdfGL=;wrAfV>%#541f8i%D7tGK;rECW$A<+$9*vengPC z0iG!6oc?it1%+S*pM>mkE)jg;A9zlP9yMG*pSNO1e-WI-EpTh4*W<4J|BQh$nW?uS zXAY&@)-FICFUu()#qez z`aUeW2c=-`XYbGx@@7I}X9KQ}&K|GZf7(A~R{u;z{!a)XsHhT>gm8h)ep1LZ1u59= z-6RuXVf)XEhT>?1h#EnTT0o99^gQ6_j5)maX0Nk|CqoWR187+(nP=Z*&{@&veE!mv4TUylFe#QqP$ z{{LmB?g21ar}I3SwqC)$aE=f?XMLiFLsPL|bvTXjh*2j9oEWh8=Z~B#CZLaleOmyf zmKR!5?F+RD$_mwoWf25xf>@!V>R=oJWbfZV4yAShOV*bAN+Y2F<{RJPG{B5a?!AFHXx%-x+3vTZ3R_I8vUdcJUQGO4H;~Z8Ql~%<1TY z_0e$X?e(bjGaPNpUe7kM9x!pH;Z{v%M}^KfUOmgab%8*#Q@cz+MD6)jv?N zCK<LZ0 zyLq(IfpnJF44bw-#@@2jL1!9po{lc1j=Da161KYXq*zmV_p{=fFb&7GDMoA2j<9*x zgt)kC8N&g52nN}Ut&hp3bw8ocmTM~a=h>Xt4}%^u0D;vj%gOBr)xQsmxyM6NoLr<} zTItnk(X^?V z?BkDltd_#^=o`b@)yCh>wZ-e#cVi+%omEr1%vuw5**iA@Y;(NFNzJZ!b5l`np>tzO zkhX7GdbB>QOON}-3%!?a-#-c2b3{2Pqc_X)y9ueA$3w^we*F{^aYzsMzKO>XBc^%h zpL7+F7R@G1qfa0xYUIBF-|AsXvv3|=NcSSa-enr!ygG$t#6GDTX#bQgwj+TtbWQS` zMRa_MyuWIFb2*NHHDZJ`4d;}vdm}~+hgY7( z=3R04kggek1Bi|HH1Rn!lG&_3vsyKiUcj!x@LiC_N`cc~kxA@AYesDgk%BHGA#db& ziZx*HB${oJ*=)rowFNu=p^(T)vCj1Q^AFzzhkhDl4@2DIAe08gi2-bqYI)YG3>}ljT$@b|p~kKRv*MR1$_7CZ>bgMHuprs?%>Fc%1pFg2 zJsp(W?L9j7rz>C9=r=HO*HsIi9PLQgkviMgp}`)il@_Iz(KXUFkj<$hVm9~a#Q1UZ z!1_A)Siw>=S1Mk|-b+ zVoBRAFzSB`2M8ofjj4NZ_Q?)~E#1mzyBXYgZaFMPwXOcA^VH|I>xwga3Aef7Cw-Ay zL1fdyW^(br#Ks!B+=Fkaxl||=XONCP3cMNQ@(?cwYfr3?B0Y^G4qY3DUV(YS#M>ZwlV zojY6@iQR=|jqR+JjasFtl^^tLQmM|GdB4?G83p=P!?dmS*|!~YS*ZhW*qhVuEPq!` z?T>4_{$X}YcWmd>CfwZ-xN;Ce{D37ZRV_8giikjHmc}f#bC=Kh#G~X%RXi~|d z>tfCQ)1|)j?NWR?11)+q_~VF3*0>MU?5TG7`R)DrxMzv^E2^^NAT2dLrY)3Hg?40- z%T3c3!u4$a96i`$g)*pjJr}&q^LH%`O6rWrYkUS93vOv;Nm$0}C`_$(cADX$(=91& zF5gj5y1%0Mb4!i*SIDQqMj3@3=WePrjeG$|RvvjylYWoqQ^7TJgNfeODe@w7#@@N3GDFiKe4$5Z{8jU0 zq#G|_jZ03*uw zSuMRMi9wP%`CjG~mdIc~Tvb}}%vtsZURN1iZH3rJwB5jajf+zj;n5}~IQ$4(nogOD zw6wHcZ|!*0T+()L-Xn@qfpX2^l<68`ug#^gRsQdrOQWPoOQAmb6T3PsLi^hZzYZ7x zK=9)ZCE@{TL>EbMeo_3%@%3GGuT>0Yd9ruaD?aJ5^hOo^Zgivw-5S8#3SKP_E7mZZ zs==A`evj;`cXTG53IBO%qb|e^rLfB7Kh6Xwl+P|8lZ-yU0P7fu(NEzqnn}s4FkAZ2 zjJ4$#F*7jfzk|VbChEE}KCu^0TQ@!J3#9=Fd~vCKR^(i>vJTF+OTKe*fpdpLfT?|s5rik zH88I@0eqrO$sLepw^|pOI2n&{79d>i>IfZz8`y_X0qjKO#E687w7n!Xn<0r926Oulf?_s?p)}bz)-usO zgJjp_um~mDIk5{F9QbPE0S`%9?g@chb6ibI8aH)9ell~Thca5fKCM;?a5f)^0m>Nr zJjeQ++gtCgv$JGnnk%q5AMD<9I)jdp1$!~k5(w@gE_kN zxep$c50GC3;I%NgOW^&pGciP)%RO*FtF)5+GTu)o$=?w{#L9(xMSsITfJVd%PQ~## zaATZ75X&3G8-4<4!l>&=T^OHy=v;}=I$YMxRSp=LZJ2#G%$?&Jvq{}M9h0YfKCg_p zxH{stuP^JZ52U9@Fg{#9*TYk>Vz!lfcD32RGzVTFd#O{>`!x0USx^pp_2zv9*dP({ z4%ndj2Ebd>Y3pKYg^wQ@_a=#=v@*49Qnxjd=rffBB2@ zZFkWq>K}g9_F}2+uN1gvY7fR(Px8NCBoc9}h5kmHR z>7?Ad#*%#5@jAneJJ`=rokoKp7X_`?!nGxnu(}L6cS9V@oknUb)39jmX}^Rwb;38a78LMG8C4xUW;Akv|YM8(p~@i5+>KvFqIaHN@_Y zz&Vmq2B&SPP#TuT9y>X#lCP>FOWXRm^22$#(z75kHmG^}T_Im3@*oB(+xhXLr5nj> zK?fUD&qb$u$Q;Lp7$dN@qON%I3g3_eKr4&2OWaiO0`b>n?RT8}#G3@N_N5}YGJeU& zj<&YD`zgJc<)eBvM9aXyW`4x|ZYBLlN;Isr$nV6ui{j?e?)<#;6gx9-)vk!Orxb!u z+}Ckg(Isa;hDqV`y$QVJy_6&FzhZ4)PSPAA%$_rm%PiO}G!tuH%+s$%FgQQcd9}Ox z$(d(3&0jgk;&S69KJn|1sbq0oGJ3pw)0Iw>9rmUhW5$n5RGXvT`gg-aY4Yb9>1QC2 zb!Y67S5-qh%69McaS=0S8*UYc(fS~{#XF#}qc0WeSK*RkY5|x;cXle!Ecbh|#I)eT z_1S*+mf=t{9PPx;v!CIHbu~Buab*~rbd&Vix+d3;y)_LnNXX{7jPnBn8rODSn=UL^^pWQ`I3~m`HS!BN?<8z@5VKrG z_dx7SbHL@;2Jdcg-v!Zg?ZWa-hIWb1931}FC)JJw&QWNl9h2$%r{DliAH3($8xB=AT_2$a>;bO*7e*iA}E)br& z0XXGl#4iTIzwY?}>ND;m)$CysmR2|E3B1#pTiSEUYI$Nr+;LCr%Xmv}<=Y2yH>?9n6Fbo{`%`~#7H;9>p{tgqZb zEotxm%)w^kpt^e9!&W(hEcVmJD^EbICOYZMydMZ(7K8oeeX+hvxZ)qkc8HCGV$C1E ze-QK-HI`90A7C;Tu(VHHiaC^riNHmR{!B!<^t93LNvH*Ks0$C@82t;BwHAp0zhQ#u)ZQ9dM&!Dz zp1>~}dVc==nF_F3S@DmP$^&z4HB%Byl=nb;RYd*Tx<$nu5sZ7P-E2=(!d{c5Z$^6T z_Pj|NNc32k$M(v21zpEdPxwVf11y^$kXNTa3bXDzQnK45jE!6|2mDE!l7HWHu300k zZhY&p;w1517Y2FPo1%B4*q_EA&U1D}y1Gv^^jO=KovZwS(ilBuf?3k&?~BO<0C6PO z_=bFh>Hq~M=SAcFe%EO-pXs#%!0oK|1g`Iuh=X{?=01D+m)9UW`SmqIhbI#kz?EP(7@6AhxdU@`4FMdhn znamZ~dNFjC*JdRbdBmzBz`PbOT{2(PDAW!!_mqnejfEgk;2r!+A}L+E@~{D{KmGoR zC$ISg4yu4v_ax7uefEG7WRRtyE;V9IY6C=dw%rAas1Bx!h~tI;pjl8n-CCwCxxEXc zb3s1JqYLG2IcATGt7lXBE{hHbNz&yr#{}IU?Smt!~IVbi!tK}+( z>e^%7v75&NPHHEHvkb4$FDUj6V7qmPbciZGfV9ehNm#*_9K&;XwbP@`x&_Z9ZyMG;M1ZO~G2nMiR@(Dt+I^W{heCX+wjygK41FAdqy0TI&-T#T zkL;QQ_tAlX#SHkOe2Q5|L~=v%cwUf?t*q~)`3EI3L)J}Uvy*44Ql@_d+pP5oh~S?J zm8?t&treP7)W%4m<>jRpg0$^LyAI4b3o>Uo+KBy-nkk^9()Oo5D^Kax+=J~U0q#zk zx}qQ}1CX)*$;U`>4WtlEEO{fBM{SF_znX^; zDawCx62VM$NnleJ8#f;1_7u>Cg0d<)PR}6j%2{;z*6cv;mlGeID&_12^zU)PQr*3~ zlqk^g50I`0(Mtd_M8nj{!;q$jgWPl>$YwFdZNo7Q7qP9fq#=>8sQ)PNNlCBDtc`vb zZxWo1UJ+s7^BtKzZZg^{3m{fQDL*e~V$_61q6SZiVBwV)qoKZ2cV2!@JAo8U$e8Lt zO?6Z|vP>s${Zx)@*j+e{x34`#?;{_OoOCdSVWPWD(fcdLOK{rtV>%xDh%o{bnNn^m8uE8)r zk&_b*WAme#8N2%1vOhtX{t^2F;sf%pVU*|0?B{gs z-$wdyb2s*U55|2TU&`r7Q&AZ{Vc&5*{&Cz!x1%wB>3gK0?byfra-sUi_zb53xtJ$n zuuO$Un)v67ZD>`?g=Y=LkTP+yXe&0|f{${rq!rBhW0ymNG3x_>Xt8tT(Z<&Y(Y^iv zlG-0cay5FWeo(b(ezQ2)Peg`m5VT78o%Xb~!bx9dfCr=ghRebFt*4i>sPWItkEU|p zkYet*mum8RW0SO?z30>TQ-Ty?px$Js>Y&KOC0HvD&`Q)?rf!m`#LXG}c6Bo>Vys@- z4f&02sK%0Ab2BAxzBk2CFjrndHqT8m!GsOY2V9ALRrDCvG$=#Hp(o8 zPcW}c1vnccwhJ;+Udg6O+9g>DA7|3eRrG@`LzDR*lW+@r$^Q`(`L@r6oi%?-P@U{r|K}9vmFa(<(D5{ zTK{X!-gSK(HrDt!a~sS!I2Z;qh_6Wz2%V3_8&?_bd)-wcL=^&9X7RR>f;G`IzL&8<#NMceQPX zSIID1%}A>TJW;O*O#K718vI^aVjDWd&a?1KVso58KIVaS=9ugh++iT`C2B+14A5a` zE`3z%^5CqM(VtA?`lYl-Bw=_1xHI0P_T)Bz0LruKB3_y72V~56lWt4UY%y%QWK&}a zL#rt*B$)oe^?p1~;v!n$xth0?K98Q3dth0dveU)S>-LeKoYxs;mc#Ab3I^F-cy3&F zI2{^!?0|hS0jNBQK}Yb=oQAm3aX@kPVUlGpv}xO#=*;C))~oKABucTV#3XgGbpNLG zL)E`p?A^r9PXW&eB{J{dOVe`CnjvXYBRiKYPdd#F)*+{6+L75hUGmmtH{BQJ!aBx# z9(>*&Lg#RpCt6M?(yDMS_f~%-M$DO~U;S#9Rz2PCq1-l>A98xk!y!dqK zZ+8?Y{4Tg#63UR6MD`ZssdM_@y)rFoPgVLlRqAyt9|W>9^rF941>_gbrwUgSP6atM z`q3&^r4wIV6PK&jOkyd8_b^>>w|KGK_o4;Y2x0nfc3a>RKMLhTGNT=*=&~2RyzNG;7mz$^KyEYClO3&m#fl9syq=x8HH4 zdzQJl%?&XKoZ`nTyiX-<>k4%zUyeA%KYsnY`j-h%^%{-8%~9CQ2ScP9G9sdO$_(8% zyc;wO=O!<#&umL-|E{VhwmxA0ug%Y+O<~lIqjg`GiaQk#>R@(_*Ru5u7Yx$JmFEiC zur8~dn&xLXJdY4fp0i+eF7X!k2yf`3MLh6}c#?7XOOD&}ng6M_c4*%8f~d$Ocpvfh zG2iHtJyaea-|4t%mNiTHpL7%Dk)5^I98N3y;}3AFIs_Ns=*h!?riV44b+FMm)ls?# z-t6WZCaMX@LG{ec%mXepy1(+Z0kiO9ZT0g;hK+?$ALuf;4V$jZR~vP@(g|!fQaum1 zE(Pu%HAK0W{;cal9VlcZPhqq4yuc8^b0fkCGLSE7_oGu8aNl=`TrB4A57ztk2C z{B!{%US(YM5$Q-e+Kd{tB@>S1{aTLA9KO-vx^T~|J4-1o6xRL$AE}B%I}%O0Es4%O z8W(LAMTKedtU2w3&AS`0VTIGa0My1|XGh@5nW{m4JsJ|75PQgIUzUj*fEMlgehhO_ z;)j*I^P1m8?4s6@aOigoQy zBE~}HRCK4$`@)i{zc^X8iJ9(sx_U&VpULJ1=K6GSBpGv1*t)4yVv?YK3sf+Rnx;7& zxSJ)GV?B?9qy?&Nw!PC~)yc64g}(;jR;;`aX)AL;PkGp)B?{YDj*Z?R zUcJO6t!Y2gD!HDguwG`fASe~er#CK@iaehMAK!)z?x92>G@zPSn2!N9o56{T8bvN? z8a#y>AaKS@96wDg?1H36gBrHF()~5n_b;T-dF9Dd+?=Rwk@b+OvL*TA`Hy$-HtOD4 zNAn}-0U2yV1Y9+0_i7?Gms9pOui#vdjW+`DUKsA>OEBsm22-^lQ;`Q53%twQ1`&M* zw=3*&4|0Y80b(cLLa@R0e4=?`;wP)UmfyQV2*m*o|1IGrdWQsDluv$(E6v}{WJ6H5 zWmBvq_Hfv=fItX9Ux}dcBexiTU)#>OXXMCih4(!OT|}5Kb-!1l?Htc2O6#z#m3Zu? z5$mC6FwwVp+OGF|nGITK)4|%bqE%0$(C!OaeWZJlo~6z6-oJYRLIdiMPNsY14iL#& zy18pu?571lqe%Ktp5wOp_V0C25{HVtnitiwHS|Xtzi2{z3^kvIHS!&ccZ*-fgPgV) zrJ5el*V%9i7oI#Wv)2%6dv?J2Lxk1rj`wLF1sR`(JD~AJFQJ5;yYeNdZ%!rZc5ct; zz8-MmVf09%x{aB0<9CnNaWnG+^#|Ll^96;-xzc!VZA4qo8G5;v&{fUc=k*+`E>qDX zs9bSCH~Qw|_Ovoe@tGp#Q%Ry+LvH+la%Z12{Jwd&yu%irq_?f9k~jv+$M16+MO@cX zwX^5mj+RYDVl|TPmS|Y91~o^DMJ0GPVr7SA8a0z81Y{ZeAB=KrM&(kXk!2SXocMKd zduhXy#%x*z-|*XmX0gB7S@i&f0^tft-HTRip_oWe}3_E>BsWTPWjQ)1Jk!H?j_rSi9NP z5Bvv>RgS&d^6)%Ip;`}+@&albpEob=GwB#H*f?K#U7%|{kF#8p$!Erk5O!Wd)M6EX z>!U;Y#udf=d}9G`T7J$o+o5o6X8UKU3rzFPS_s9bS~X{tM6^rrvMMCg~bs@)4qXSfTlPsoq@sGMQCm z4=BG!Pt$f{X45i)k)>Rqh*PU~q2{rX;rKzv5(X`9FUr^DKK>MvqQ?`z-@DyhO_HiCU;tl`h(f6Dz)qKnPH)wU1w<e@HlCn9GA4(9_-yM+$@wJ)#wINjkC9GBEYjhnI!$@yUwM_j`Lupq}T6>R0Cp z3~vAwfRWd09S^xKaVB4I%|;*9-0EP1leA?&gM7A*;zmwT5Oj~gV~}wf`tp_R=M3-6 z0cf6J&~-WtnjeBpRiZA+WpVh1oJp^kXghlEmLgKIa<d50e)GXZ}VEQMi{!I5tOjpO(Z#o9#3vbh(AGCmj<1RVDEGV!lQn~LXSE@5ahpn z)OWgbwEJ_q|2$U91UByZdieIC69by`#23Z}-iZ*_^QVKH$q8^dF^0D$Ne`**In?rR zCn@2ze{}^!NKtq#5-&zi)-aP@YfBKx?&qIO}{{d!#!`!c~5o#%aI`=&$pnkr{%(xqe-05p* z3aOinlx%-Q`kyD7|93k-T#5Npg&_Zz=1_b&`tJTKpWg(MdgCSWg|J)_s6XK$|CxOo z|GVCV;ku=Wg$nXV2G z8-#pve-$LqQ8Mb|wo>uTA6y02kw5&9*s2KpQLgM5VYFYI2kQF67`4$HGMfr$CZgfQ zwO3mQ-n_n4bc`BNjuu}&!fEaYrdcQ}C-)*OJ#ki!kDw7S|4 z{BibSpaUu)z4;rN=Uc0M{?jV=4!>VEOSgGr$aahf%Cf-IB&_g+52buzY z$`u>rP3mo-bkb19mmogYH+&}nzkZNoJ zQTO0UygO%0ddaq#?qe!W6o^j>i6`ft0H<8yS0BA`H55NYvqfm%Y*@<%%`8*hyQ;aS zz2cl@q7R~6cGG(E&Ek)03&jgGCu0m(nm~W?G9qXSl)q<0o>z^Q=J8F=X=--6PoLw{ zQB%%{IVkRc9XG)cZ)@b#APqoj~)M<<#5F z!|v|6-JlansZmdeE*RFQ5;hX89u+q9|>k7xJZ6^k#s~gr{9K4{TE;me37!yh0 zlr=JSBDa&be=2|ZWcRjBhj4(gsNm*>!<5`RU2uiD&6F+lv|neJ ze&Km9@!a)GY<&H=S*%}SJ=ZLd*@c_)wXAp^=;F}XHc1yTw@?EuXFmPopdr{84V>1{sK``jq9S>m(8adKQ4Zu zpUW8^$T0(FI!Hu?-%^g^cJq6hs*(iP?Xy!qq8;cK!dg-RQNoxYw);$T`zLX>Ky$h? z0-pR}u2}ZieOdX%)Fh>4tL+jVvF@6WgN-}Se#dT}hHd(;n_|%-7@dg@b?;N>7lcfS z5pM6h311ZPcn8Ivkm#7`L$T*xr1+S4@TDkLF6Ej0Ku_!pjpxz| z4%vdPg*w%XwzE6pr$Y4E+*I~HVa#A{FtyICD76$t1xKs#&T_G{@XB6UFxC)~j<5+7 zY0_LU(20|CUzXIIG>`~sj}8;)B*n?RGL%TW!B|vZO3a~<`p#^+slN<9laoJ7WgN)* z6|>Un`ci_&kh_b4YZu0@k@pC6-l#SwGN{&1({=~vjBUX?5t%9%0W#06mZj^cRyDg2 z1$u+x{YAGk=8XDf#wyLzwK8kRVbp4%mXIH)mB*U$>}cbKF5OWjZEW(2bApnyt=mRA z6=z0@mZ}bSHQAHeb5dWL;VANLzmNo7w|-MBMHik_TRS6xJ`8jK!CX7v=6!BdM$2C8 z(F6cYM$~Q{cZ^pCwjD3J28e>tz14G#4%1h$I@$5*4&2)zKbk*gWI}wVhK{{&S_pU4 z#h)M@l0LI4tdbRClFQ(wo44+l+{C^9#uBEN>(qaqt~1mw^v;FW`AMn{D^SXPaZHi2 zsL&s#_k3%mE{w6KR7jI2LyFo_{))z>S|Sg*ADQECZW6X5Vkh_Wbn7w(e84 zRHNtHsSO_o&4zxD((>3Ph|K?-HCF&*2+E%-yl1kVTeEa|%(qOpg}FM=fRzvVeR0-U z7*xbIIpSvt#t;WU%<#bnSoS$>XiOXQi!66AQQCyO8joUhMH+$%|r&im4t{tDNxXwn!H$|YK@)Pla-m}{)Sx(S z0GNF<+vx+E=DQe?1w!t&T9UY%(Dm<1nKNb^pa|9ND{H?WZeuh6NlTwMqcXEi^mX;!G}?DD|S?h1jd1&<%fc^{nf*g*1xlGO(z$2 zU4_c&AHEp$JZTVFjZa(?^aw6CY0|W?o7*|ANnxb375aU)d4pIJ7A#1ze7?`|G_Ft1 zzu&z$?fi0%LBz5IHr0zy&(vKLKhC>gYYIC2Z7<%|5pv%ak*d`EraH%)06rLTWCdd4 z=gHO=nMY=pXRg}u6P0AhEOfyqUTRW5SQwiRs~#sIW(F--W5y+N>m5KQ0t2gx*L`|d z?=%j?fNp0;16G?x<)5Xzp7}rKPOcq%4(J?In0@}$=qdq~5TFTbfJ%8-zC{h`7ci*) z#lS=g@p|sNe$BFbD-=VQ;MOm7lAKUeR#DZYICNUH!P+WsV7zk#FCbj1?eZPy^_6DV zwEBphIT8gMU3J!#Kglr}%JJ&Sh|!B!DryfiCz&EY*9KaaCZJXfiuazOi&hvDT~D5g zPmZ+a>l47qoHW*X7zSGm=fzu2d~eok#1@!6=+3An9Ma zcU+vCWbOCxBMp&h8DY6*RUyuOJSMq-d%6Lc%#i`NiSN6sI>mCcb%H1U*&O>QdKYYJ=6uaE7`v(C`AZ(6}9S8A(9n_BG=k>Vio1R6*{ zkAtFc(&du97}j8Ilm+O66qEsc|05meCe0gDUCGg++6++N_pwq)4i!uFk7CJ5lsv@C z)S^jn4a-BIqCh=7KHDqXNH^V6joqe7_{}bZ5D(q|bkQqua*%=C{bosW$nFW}$AGnO z%il=~8i6|~t)dKt3&O0i}OmW>1s+uBS1qpUbcR7t}g?&xhi11HP%Nrnf%6v zcJdOuvpYv!zt(P6@-!W7Z+V{zI zz}|;o3^{}eK0<{m>D)uafCQ3@YmlR1dW6bXo1N`JsHo4?umzj5}kZ4Jxx9uYml^aJ)THMzJ1_3 zNG2(NA5^!lK%Ymls`3dsH2y$tNi<1@>!UtlpJSdt<76wxef^vIb|bMk)DYgN{AJFf zMmfXR&$&}CK9sHv;4z7`v*VoY^%;!{IN?GVsP=~PNvkIZ0$a&>e$XQFLhpret?1+6F3tjh5;@}29WNt7(Po5AhW35+E*rBZ1#IFYPqYY8%Ub2STX5`pHtHevrWl{b>c z0jEsc|8~wScFuh=UgH>sC@Ro^xnpBsQZuM#txFyNKPoDd8&F>H#&0DP)pn_C7(s928k?e=Q?r*q1dE!-Ig9JMug9WP3T5p3 z+k`jU#|DbYoTQ=lDlkqmwce+PQc6M5Yg&gp){1}><8#+403={^Q=;UJOcs0|dFS2q z?(6h)H4FnH738E>xEaO-4Is?ozCZqT=WHco=K7mtbc%Xf7MW@zezcEqPdiI7f}ucL zg-z|D`JUnFpl+08HquRGb)tj|-j96J`a0I#eSH9e*xR3RAdR8e+lV>#{L0|&-TPn; zZ^oaBBf};cKNlflj}xtK42lHy!k(($Z21hdX>((gVPWH+HaW_6GYWO09*jB7p(a43 zu~SzNmsZcg4nM}fEc1xpNrtV7s0@RUjMALHcKF=&xQ}6 zM_^_!YHb`ZW*pSRol@&8@&_)>oAuUhypEmXdWN>!T`MkWz=Nj3Qf&rV?$Ow?;4XIt z(U|9)CDBo8W($tk^#f+RQq%xnN>f!9w8JH|N@{L`t0{f5S6v*HkbL{jw)sG=Jd`S) z=~86W1;Y&5j#4nXmrfv%?Shem??cgx3wdAwvHMLh7yu7Ke{lRHif=qSTNq){=!$mi z*=>)V1r4Jo;F1gf7klp+*5uZ$jVg)=2%-qsC{`3iRGM@wSg2AGIw%OC_g)1HCb|HV33#I!Ud@P0Wv0%NDV<8vC zDd5^irKb@(%(pnp)=c4NOoKw)l2p1RzEp~%afuZ~?FCM!oUKzY^D3R>zHnO9HUb)r{K{LpHA}7;nTT0x&S(*r-yl^m)(@< zZ<28eLgL(XN&e`eozngjd{cP0Fu7k5j{szip2Zco%_7DQ(cOYAu)A4gm$hahvTu>iv;y zT`ohtRR;`Y>2|V@HkU@)UEdN^D~-$%+7e`W9gu(`9ftqT0#{4>v{8~_?&x{lE$V||R}1Mbp!z;Q)$O0U6r@8YI5#;n)`(8r*| zzpOP!%^|e}+9f_TvHn0e4A@S@jEjzY&qhtC)GlK(j5`i!qn{wL3{j@>-}Ygh|NOKO zU>T=bEN}CZl?HGwX{&2Caq<8jU7)sS$hm`Mw1`CFLy1U=%7M@BGr0T^kN)&2iH*Cd zosB+XdazHMCu?KWET#RB+c`7n(P2RF{kD(Hw)tPh(|1BjH=bo>$n{HYUVJeq{vgnC z|6b~2cP)SB>|vd;I<0b-`c{S?SLwmCXQzLpC7u;NF3!XA{2*Nb7oX$){l2Z@=hwQW zww24Ge=mo6%oUZRyE9LGaBy~8ZfL@4gC>ALH@N zF1wt`zxL%qfX-g#5{Bc~Wf$4_R(RBtRoxf}9k8ZTxI0Iod+ijMOW_HglO(dHXU~)Y zMk4-hKRJL$*_KL>?V#qZbtt0F&CSj8ny~iT`qr{;wqS47pR4B|avE(d|L}4`=QPZz zD;d?b)+?``d)ICcaC3bN0XaY*a^y=6d6=$%sKLnZzgP$PO40+2;Bkl6$L%C|ith^m zHj!VwyoWLh(i87Ngg!8a?*a**@xNQ+|9Cgj?BwL%T7dtXzw`gacL(?n6Mil*pS))H zW}II;OaJiD=c^+6M?~M`cuOeGh_`x9}bZEXgzCx`LEcHUiXuiWPaA9m;{>Q_1hW`VZKQ#L;KE(qk@- zk=4+xW<`F!B58_Y^a=z=SK@cUHH zgXgOx`mkI4PMp`^7Z06t9ligzCB!d~h~wk9|5liE`pIg9iJR*4ej9&A&bCe224dZe zn>N}T&B!Tg68jQ{lB3qMTUf&;cEEUGxrO&>9m2ae;=PeJ3){FSeUvVl)A7P7tfoaUsv*C*=E#jAcekiU4- z^TvkHN#TW|ZXC^u`y=+NHqjGt$-M1LKPwh^;7PX2^wvIpB51u|5kq{fK|9`wO?}Rq zUVs<$V^+zk=YT^)euidQP_120Y?*+o&_mI-_>J z!TOtv^wsX!C9fXiPohpu##ZWSk1C&eR{;;;%L0FSqA{|&$g4T?S+p27zCMg^%&833 zR|pGP=1fGN>gt-`4l%{Wl}4?1EAZ+5DHh@eNTno`xA>{g#bPEcsVJY>_N7R)&_r#u zsKgxJKDIaCI_oLFLvtfe1mT%NjK)l@zW&hdX*KZ6QqohI8`Q;I;M!*$Tq47@*cd0D z0xSB4+>Al^dcsfNbk)o*6_DrjS$Iy2{52aTm>HpsF%8{X!xPX|{ZDs18}+_+u4{=z ztYw-H7RC`h5@b7Gbx+t|DyM0jSWzy&f-4q4Aa=5D5Y?|3z!gt+7f5-uh^OWd7x9D) z5es;*P4-;pYZvGDJ2_ttkX6{(vlaXc0bf-w?T+po_kH|aggHn;*fvJkx@Y!Ct~Vjd z-TT2|SjHpaT1gYxADBf}v)@S~nP000oXq-I-LsT6cpon;S9J+FB308%Y7Tp!tt~(R zQ<>kpc)$fstm@h?I(wD*s$>t5aiDXgU1B7fHeNwScy3}yV!5kRa(!ynT%ErQJ2CwE z9HgDK^PNBReQhn7@iuAXUH9HTir-!)Xq){|JDmQg^5bbIh3M_{lro}SFpD-I>t**L zv^{&zZ(-bf4?_?dd7ES9p^ugr+F8SextlDh1Ec3B0Ue?DQ#DyWytR?v#}*{}!mfF} zDotaE9%u=yVK7H__&$7`7y9}$!9!7ZrzX95i;BfC<$_7t{Wn@RL5M)Ig=#DFX9-c+ zLO*3rJfVDflRXrc^+@OXkoT&?WB{> zFl#)BMGx(}AIyO+s9sv?vFX*yb-j*1e14|IMp+;LpeUquI!S<3z&QZCn<_pzw_UoF z>m47kh)t-DqT44bK7Yd!Y8qf@cbLUkaB1%2`JWobRr}D``jVSYrL0%B^}PHQ3*hrH z9?tvl8&0Z7M0Eo^t7|oVPMbHh(Se_F&I&bqL&_+%1a(+?LkU-4gG9JXy*sDdQ{v>GZ(sj{ zzgsTFP*%v;(E!#2!<4qqjd+ORefzR8QDc0r0!XI#lj~o+w&KFKUi^ettHtr8&@(6j@{74igf2%ec=rQM+< zaNy2{BUGWVZ{19of4#}ot>ScQIF(nWWu!n&79<=dFI`DL$_$Go%h# z&X7RoW+QNYU0?Ohmv07nE;L!D_9J5(OHN*&Vu)no#w4B?G6P&>Qv&4$<7is0zB~zW zlD2s!z1Rpy)Z_W6idlw* zGIe;9hW43^5#BBAJzw3T8xfh=VR-;SywmfUqEY@p z)nnyJ>AQJU_aB22boY$)O{1PoNOO8eat~kI8$|nxm0!oo>Vjxq%N=;Y7{Q+H#VRv4 z@&C=dcXf(@m)9TfKg#dlL7J%1d3wQ|FX42w<^1S_k~dEK|D&03P^3+io& zwyhY5abOtN7Pd&rdCsx8CUA`DsEGd+U?wecy9WN2pdUk@?Hq1;u`xgs)WHeZu?vDV zCKr4hbEwuIY;w%AZc~f3?zi!MV@C-U=0Kss;{OO0diXv71QFGYvAQkIHw-W>QsS}i zKeN4B&VzHVV(n?pjAvdm;2oH`L5Rqjt>WL{Kr=kfMi{&kRc<04Dhdixun4@t{HDm- zYbvXBS>6%{bBOap19z|?^I(ioLEq`swB@8ZH2ldJW0eH8OPrsG1~-nc*B*moq*k~j zXsm8vL5xTGVh~NN4g>3N+d%z5BM2p1jP=&^S4MB$*qK~l=9qYeUj%8qtsk-Q6@>(k zU*FRu?ilHhM_f_4;<53_hw6yWa}fY}BJ>m+99}sA*wbg>o>BMQGrl<`Ct*YpRE=@Z zxib`|jsm8c5Odu6hQgh!pG@i5na+98ZeG>fVBCSVa?OR?=`k?TYRt zv~3%qa%Z~Cvc|C1EM_$JDc6{zPT%yrJFpRw50~xX9WAkfP1SX0#!Yv-KbVl5s&geuuPt(J1 z?&(f}7n|1}*~=(zMk2tM-bW!md%{1B&w|FB*$Jlx02kIb4|aK={_C zEUG1k%FY9?VL-%s1Kq>KH%mdG6@c5v(8JS|eV5f?$Hyc$Z&JV)Q*K%`zLTo}Vo2{r zLrjOZpNmS^XS<>e9!zXwMegF*vP5)yn#B?u_sd+o86{ZavV1~jwtgNFeO>uXfW@<4 z*rUyQl5u`a%-13l>V)>>Vj}at$)GQM*0Mu1M+)fZMe!Zdd!E@p@-}t2DIZW`$l-?h z-f`8&nsLG7ZqshyxAO-2nVW{2I^#Dig^LHWSmSPA_Zg2VX9OG{a$`eYBXomjg<5W} zWnQzQ6LNK6i`zIE`^fw7C+Y5MPlh()J)^zu8BeKRa8&b`cfu1Rkh(ppWf_<<<@s?o zW)Vu6CmWCqC3A?b^#tG;vGJ+o$}isxO?80)F{jwqz`F% zAT||vA(4GMR4Kl>l@OcNxeue48hYW)1k(~YlgLuP0rU3E10Dsq=VDG`ca$09E}^T9 ziWj3TOym94OEd=w^|xsUHwTtm9Q%ngVmQ8ogfI&e*#xboaP7rI7UB;aYGN%COqwG+ zEQeir)dedfdg|?dton@g1h;jL)pa`+KQI{4nw^?m&on~-IBe0@Yg@_q<_`FWvVt*B zmvJ1h2bUzg&=dE#kZ1O7Q3_=aIB-|D^WV?huPdX@#P}Lk_XLPSk0c) z@8ag?@}-7wxAYC~KMZzeW{*#|7w|3V#%J-Ur#fZ!jDemA!b#Jr_@a+)cUqe8V#zhnt8oLN;DP?ALhr_$zK=>}lR)8GmwksV!)g z22||yFX4&bU(x&67H_!z2^d^|x-8M~b3oJ}&JT0$e#lh%XMXdA+%D_*#RG(stNmV! zLetw7d~R2o7PD4>Je)WY>26&m=ye@YRuY>!;chUyh=XVMS;jg=ypK$$_?TYJZ)I%e zNh@dKd9Q3WMJPVYY6#x4WR9CaPin5)gXp+uS+}I1b_YRU1td&ho!3znlE-p&SDCL(fl23 zXu99PPDmFt zU35DR(Xn~o7>d$YIYo_5IF$y&H(7VwF`=pyF8Bb z2@vVf8F&11{>*nj_FuUZ=l*~#2G>cK(%54YU9g#+qqc4I(t6w;W0g>iX&?rmZH zDa?h4@67ds36#&QEewRnJGSuQ(wtG|!0znTagSP-u(v@B3@*r7RF9{3q=qG($B+5s zJ;(GrH1E%0@5R7+Zd^dY0#dwu2!j?)YnhE#BpqF9pB*X`B_Aak=qMFtc?$W+EI5YH zJgxFx6mXyJyv%ZSX{9JIPRd7b$F!>71vn4x^UbH!fv;$6^3;6D_xZZ<6c1s*MaE^w z9tDGc1!e;g=?omx2y~bjug@=9iM{r*Yj776`rl3q@BT^fd+?F~9y3+K`<8*ZU zY|5t0`s$awXgX0t$F0^!m63h^@wn#MF;nvt^=Jpmd3?3-> zHfGhe@m}03s|>_n8$xJal2?+68M0un9}@fP{rYNkX zcOf%Ih1l>|-mB_4Ut}eeLd`m)yE-va1!eIb(GNGy;1-7)arYQK)d~ETk*Nxx<;lRH zth~k)A*8ImK98a2R+N?snnjc9YLt6RIT@}hzTTg zb7opyYpRz}{@l`LR7-5GMWYhhgDmXrbMvWYQy3$(l`cB6OB3}%Dx=K;FOQ;aygNbk z)O@jkz59)*0}KS#th5E&gb4hP(CF#4{MNgb=#a0hK0nn8{geD*`0%yg>5qC+9hBa<_?RTNyHEdP z0Rm_{qlNJ5a5(&pUS$hTH_`qj{ryZSItmhgaQ|}5&CkLH-c!9ZLBv=w$N{SLo-Q9J$P~F60yPcTOQ=qlo_@Gc{3AAcT)0i+*L@J&D09v;kC%s zyA}9njHqAid;}RnUS6gE5nmd%E3N(I+x6DYaMgCTQ)14i*=)8FN+~0p#{k5kz&|$s z?8VmAtrcX3{lPhVR&D6>6K$_jHHed|*r z&uPj{IW@mQF4E}UzYh>Vjozi6ZjM=dorKrp)xzZ%-Nh%_QcT-h34@thqEV4yVM0!K zCYnRO-{~{^TgY4p&b5)rKVI~mdb%mf=_W5Pvd}_yR41>MLCE}Wi8T*d61ckezuMX^ z9_;^m27wL@-PRn+F+yot@DeCO=vx62o>Ys!C>0dsy*YS0VbEvCLj`U!-rpahuUnLR zHA7b`U;g8xZ|%vj&$c66auY|$qczldJolPe+hy`yH>X&VGRCSSbZJR~L8Et`Kto!rhy#*)5Kb11#TDrexX_Fr^x8Q6PI+P^*(<+mRu zG&e?;h9=paVX30@={WzYVgPK2yZCji9OZ{>!G=T&)Q0KrDh~n1%G)8I^6#(xs5Rs> zIG7o}93ijG_gop(_7u=Sx~bi|WZ}^jkq-rwuRTLRCwO;=;2=1`+nHK~8|d6^wj8=k zx7bDl1kP_K4+w`50qKi4_%~ZE>3Y1co z@2HArK)<~W>g(>HoU)_3K)Y3P?-|&w-9jN*^t|8B{yy`0E_p$1LuG&_Yjk24cXn2d zpQNX(I?&VM4-yp(cCGpkgfCVAVf|iRARd`4MmftGT$jx@)`QtaPYHS7e@AZFd%h6J zvY+xEED1D9F`&;w>L8M(?$2ck;W{^6CMo}?bXs$rROR-LiE8txa=??64-{Pmee*8l z2aC;ilG~yUfxBx#(mRio9Oudb*WXc(%_&KW5`whG5pa_QUgCdAu60od^+ccd$zw>% zc@(ORIP)q}X?Hm=J6Pe#LN#9K6*7>hR?{wIx+nSy(kFgZyUo%fN^9o3JJpj}`Ln)U zzI>xp$jD`B$&7H*SwVWPClMoJoo89ZbPx*e-8^>rFM=5&r>Kq9-gO)(`#tVC_dD`} z++@D6l{(VZ4mk^>VVn$hTkJmocOI=`DS4@l5xK(r+fvF?^PA6(p2N;MZ!IdTGP>NW zfZi45WTB^;Ea&X@`GAcGE+csm5u5zyCA|mx#=cY~vmd#}8EUyte?G^YVAD%-Xb3}3 z4|y-8xnI%G99o`jYKyZ4;qtWDpSi$T$%OQ@6Slnego}O)dqh%k9m>Q7&$Wgg$ zvh+hBlIt~*`n#o{1;|L+SMjoTe>_fO%I!lma{bE4-~_uR$`ewNdx@yPjJ0E0x!r6f(7-g_0NQ>M$gv*3?gu-4Ct zVL1)s(^mIaiic16QQy&CFsT>d-Oga+H9?gKe4a?v!I%%#eSnLbM_fr4X5mTmPFL-9 zT>UDxJrB}Zh4+%>Cup;pFKZ}aIx~zV5%4otn^??b( zY_@Q+H*$j6Z`!4>l2zGR2-!^wtKY@Tyk{>+AHIFfMC&_6=uJ0X`_t|G>f+`#-l6fC z{&fG+Okp~WdDe8S;)A6>YZJWrcWEs)s`_sMzt~FD{;n|{i)y+bwWM{MQI`38FRUD_8_k+L`9cFleo;9zab;+@Zx4m&i((3Zm ztd<9|MLL9|Yw!cNlXK(^?INFYmOpC_YdYEZ>6#^GZox^+&=N72-5Qx@=+~r{T9Sob zO10{L{tW1v8eNJB;th`duYdO}B%S{2P+!+YfDU2E(-4mwo=W7?Q7^E4lAoGD*FN)nseakkq%QAQCiIHbo@U1uHhbNS&%+IJgS-WSr(GhHMWqB?9$-{hwV&_Hu)h zDf;A?5%TbzXd$(T&dwPWE2tq25wT1=cDRq>m4IuY<3JW7G!n%|b471j*mc8tLP_#b zYA`6Y>lw721_d%Sb&Pa@ESDamE)`D)2~@F`#MU?F-Nw)&HE1MnZ8B8o@_xmv3-Zn? z#J4kYbUHLerK^9w?Ty+aXbiT&0u(8fH9Jh?e&L&J8?TfBOHIWx>P?m@L+JK$uJI!= znUIzp6y)6mw?-|4nL3D4ZhIs(i7k>E zu@>DQiyt*ORqN~|%cC6n8Z-FOp@e0iVS)qk;X#tD{NY+EY}0QrKHW$Jb*wDivDT>P zG+hpDUnBt6k@!Ps0u5-)x}zRpV%B1?m+3(%`fAbLw+$b2nvV!h{E#d+4=W!SmD+zB zSg-W2L;T4)E&ysrtiF~`vCT;HL4f;F)WdVJ*k#!~m8uAi>Cq94svs1NH4qm#eO^eC zm%4-?YIl3fdkY5Xx?;|(%03~7aZ_`AcQ>n!W{7M=dw%?O^=DIP6+`E+G;`tMCT7QsR-0p9Ou1D?}j zPIBc*srXSo9q5>PE9T2kT~kXa^_%-S)zRa1!@xyyrKyijrdY+ddqbfk1q*szH}vY( zIChMDTX(KyY;c;$G4duxL^B<{3uI|m))JTlh87a047<#MV6cM@owoP#1tMVSUye+~ zoO4L&`+Fsrwgd%UZ7&+DuXCcmjXMRBOjTMKk?-K9Ubk&veXEnt(=wd{lHFQv%azq^ zNd3A{_`y!6k=yukLIWcmflsu_yaHSXDU516%x_Oly_)WVW!a9*?71qRTM)OovQE4) z(dkx9MO)DbkI&9GOVq9oMA!&SW0NPp!%>-g7Aw-#PUc!hN(~e=8Fl$~TClZesa~)M zR74Y=f}49LSMij>9z;#ho~s$0M}mNwBhw#RbWi3x;q4ul(`()mWn#s;agAEKMjBa-3tNx;Ft*(UvlrbQ5^3Be zF%jWFi;evx-0+Pp&1mu*(BG?h_JXX9<e{}U1T3=Iu*t}$$B2mUfr zSW%~3pBbLLeDm@?+KL$#PtZWdrQ;%lR++^8qGh@YU`_PsSh#20eCO^E@dUm$04pxI zny#y5a!PqowfeHDKx@6c^Zo{DeoO%%%%S7hpUy%G>yTqR6niY# zmAlD2RYMySzGmZ-6}GX096c=kyHE%O$wHl?VMhG%K4rb?nU|Q=6_w;Wcr9>P!k6M< z!ms);q3M1H*clv;jQG1gk3Ua?(Z9~Jl=LtNf9^D5I5qty1BQYOd(f~#pfA$5Ax3_k;{-jz?=Ad-uL}F%t`6*UC~phC_h6a_JSyWK z0!~pTparhdPwXd8?&1oP*@Ud=o#QpP56^Tdz1*=83da)HEhTiT3F1r?CtBm%S zbY_bq-`sys#1CXe*|U|Lpb>wUi}@*G`{$|igGdkg<_9!3%Y_oSk|OJLm^^i8=+fFU zVLHcD{9h1LjM&0 zdRfRnEA?d>L0xV2Ol#|I0;OM|BLUxb?KM{Sd2M_*Hc5`ff;tQoMr0e+_6s9brrK{H z-_fyLdWR^k1U=0+(>#`nChGHAbmOi1QuO7+e^14Ov>4+7#UI86KP4PNqj(Y11cka@ z>qY5PA|?@GAXJQxbd@FyqC6&AT*URa4?JF`D^rV%bVqbtL`m6JShFn+j#Np&x} zAwp+w41VmgtA%z!=EZz-V^rY{9m`oM?|!<=BJ5I`034^iV`Z>#9PA5mDoeSDd!C|Q zw9XLT88nb6YFW9DoOf=BOqZg=R;S@$NLX^1Fh z7x1CF<{=xeRlV94&Np4|n2uZU$*?nm%mcdf+#V%E@$QNj#%F{btR(Hf8^vCXVYh1* z%}@u1@UpwO&Q%_18TFGGFfluEM?uO(d8Fhz?XF2d0YHGlOH>T-)6)Av^rCNB*usq`yxFIOYr>KU@YHHIp zAohwBXWd@vHekkjfyVXS<`OvAo3fx)DXKwmt$yMpn`+;)fm+`DS0iz9C~X`Vc!u5q zhFIV1d~2&%jqy2i?qY$gK4$MStLXe`p4MTj+P1_S$kZx53LRjanE=B)eTb5Fe1L0=WbXVKZ95N)kIpnlv&f3iam~@@{RF8 zG;4V{4Tve~mWo+#$bUN$zzzPl>q)*|a`;R}2@1vS-(@d>P#l<=VcxMInIBYO$zTnC z#==5>Z*Ox}6rbw< z_PUXHE_{!J7;RwXtt84C%WQ7(`@r6I$r$pxaISqmswD@SSC&&Hw)L5@+h^7K0teKs{G>Eb?Go2gz&MKggMAT+G~);IAx0sgpTa6 zDLB>l5A(*W?Q=OrA_^v{b(Ga^YVdN340=CcbkfSSPk%Z#YK%G4TU$~XC zKqk5L1GBmC^I3-;X$bcrhuPf~!nXeFD{asYWl86g!oJ_3Fr#M>Gm0E_ssJG=5ucBR zyUNw~?)QWI@;7fOz7V9bDi6fWl2-I4AVg|v`zAj@*0v;-9*_lI>A0274xM!_DX=2H z{@svh8~7b-iQjkEJ#jGsyG!Shr35($|4-++4a_b0KYA26f?fZDS0<3Av;alTI7jdD zlGXA&gy7}8F#C@TZ~_>EpW)~k(u(c}Fg*FMdsB-^Uk?T`c88_;c2UxDk^lJum51y3 zn3KZT0f)hctsdvrCP&quNrM4xU$Q&AYe5h0hm6T%rw)@;-}z5qHhv5@2S|By+dRmo z{13(`J@CrS6;7cwKCjKSmFfNwRU+P7d0XV!Nzx>!z?kSi1^vCj{yW!ZZ0GpVlCg48 zp|j6qT&bN?=Q{Z1H7;9yV-35auYhVc%e=^7&U+zQ#+CQY=XRh=|Bbmk16fK3e~kWH zCV(hvap?l$@^AMAH$djSYlS|~uECjI%Dyop@9x5v3_WC2Z|smRuAp3or6GdB^`=ss zMDpwG(p2TLxK!@q!OzV&{iC)gcsqnMR^B}XwRe6s5*>N~hfZ48|F;Lq|}zbLOD7H|5to^6(7x zxxV_Gd%HH<`VZ==fC~`h4UM&G#|tbCX4+(i9bOsiy|q)g<<7#R-fFc1QimTS-=BC7 zD4Ub4^7IcFcxjyqsnod=iT=eGe(!k!P|f93063I@ky^dY7cJEO^HxZ@Yt9!@4!vB< z{J7(Sw~XZ@IzPVmQcu)2_6ZCQ+yF|#@RKPewFK3=tyOL4feEFS|T7y;h(F z4~ieLs8N7j=F~fTG-GZ01MQN&hex=+&kD2CtnKB>X#Q(uP~K_(na9n98R87RHukKd zBnMW{#Swc$`LYSJ&U&lHw1d;f{CCCuuI;MuTb;*>L%`O}{%oaq3{*f((yIq;>@xRc zDr}(MFb>TvKiGykxzRhR(=c8Dqg75fAEWcenORFXZ@xGX^yw^``nUYKjkMXwu6)Zb z_fkQ^K9p{8n;3r1VypE`L5LKRC!w zdzUE4+QvXL^m?{-7#;T4uSKW(sYv^N8|fc!FwauxL_qVeLkBGfwj;1a&ct%(xvr!q zrJY#W4<+%R0ha*)x(Ojb2d?6}!I1tF`}htUFax9<;vvQ6y9=cdd(X*i?b@lEnh?{9 z6YSf7h(Y4);r^rZMOL7Uui$me&Aim`D+Y;|Z9J128yhVNpqxqFzoF0l(4fBeqLJ6i z=-J5SPpwFxZlM12%Zp9T8L5K z?{oj>gG!BzgN<);Ec!5Am_=`uL~OeI@G`zDL5a`U1hm^|JKOD}JLjagVDfyG`Kg=E zLIGmVTT;~Z3kx=Kc=olAvkIOSp@ZyVO1-uSkt+MtirW;>w) z;fHzT=*9{Ag>RjA?SjwTMbzh3|~;7fGrGgPfyx!Q=%hrK9r`F$x_90C40SXHtR%XC42ejZ&2J z2V98Pd3V_`P}Bq<)JL=zoEM!Ura%(v0nz!0y0|aygaj0IyYzVHeN~-WYH1w7Z0E_X4QG_#?{t3vz>vG* z%$+8j^Xp%RvJBTn$N{w1G(EP<)M{peD2Mp~^hRbTaabg)llxN?qy zhIIc@WJC|-Lv$5tZa%_s-SL(6oMSRaAwewc%6kWKp@OJGree0BbIkX`in4wFpvc+O z>SxKosN4j^;6MB$LI_~7kIirzf4{L0Tx%hWR%8R63$orTN(w0zB;<2LMH*A}4jGOq z8wogoaA&SZIQz<~=2MHFQ}N zQogUC)xis!@#wRk8`jhYQv?67SK*#DC_DYcV!QR6UO7JOJqSO-AAvP7K5t4y z|I+#a?Jo5TXm&sWYtw!NpuRM;O8o@NCMCDsqOHryN<&Luz_Szs?#_?%9b7D+`g?rS z6w;3ZG%P>)^osnoytw4+}ZoqN0Wez*4A?wbj;Tll9slX`_h4K=q769!OY(ZJf(5E5XgpZzJ?txNrAJE&tMdFwmW}b-pRQw;s9jP zP%Q$KHFCvML&djo&o2UK#XUT_#069QREnlaZrC6qyDcFn+Z@6lQ0HmU60C@}QX-O9 zx&R;9%lDL8y8v1sGoOwhIJt`qUMlYGSZWZ=)TJ6RJ1^cFSCV+ zs%J4&6+(E-Z`0=%lMp`paHK=vIzznWOUv1-=##U6yF)$O`K^Sn(d z^-;3iF#W3@V7XLG-9eq$Duww&7rRy>i zEn8XuZJk%i|0n zW~)?ka4_a(#u6>bH&p=|=BU%}DM~dW=@hMTF@ZaSGwLA=>CfvI9~b#af>Ie(RV@L!`{vIc3)Barc&&7DjR1~MrE`7xbV z+r7?=Q2qSso(@UU2);t;$p6!k0b3`UwM1@jR03u^LQE1QkKhaVaaKjI>0Py}6(isY zM$X4rl4Hii3P$ktnkt31^*R(ZVE!g^Zr7Fn&w9%jP?V=6?jt$KEF%b(`%Aj=0C_`5 z`*;)7H#UvzQ&=IrqY7$!&U%lI9CzTl2qF%KhR01Qu`ANo{y~@II}iEbxDV~*5d=Wh zw}Qm<-4}~L6ua?!MhMn);CY2Z``%J6ZD=1WBEgKCPiwf7Lc&b? zV8-+AsuZTSHYiw|BIUHJ)^FGrh=l*)YXc-PJ_xzmn#V8iCyT@%a4^bwh@qsk#ISN}R<-Xk2M?h4SI6BvOin6>%0H?%=4$&QAnSgFsQ`JkR} zPyN;{r5Nx`kK&JzTs^K~|BAW~sY~li%Ea-FcwPaJtYZdnV0=;8VTk!hTJBA`4sbJV z8cna0Es8j>q@Pah+EOm2>%O4EAfmwP^TfI%WaoMnIMwBLxf{0bk7O$xrvvSvN6Uvy zH#=QWu;cu}lPL6b{1jS|OuRO%#|2;?{7N1MbKVjR+N-Z^5=nF!rxSa%5W~TljDMq!FKKE@Wk#`u}P4Mg~*Hc(Hz!k@-%zO*@e{m zX7K@?n=9znOS9hMZ;%0)ia@8`J3pU`06?*O_aiB)gXh0gOglw)mF{Q)u1{USp{0k> z9nydJ(5JkhHy;rncUnTlLS*~1j!mJiBqvsnn(n;#o7cllD&HO=NYePbBf)rdzw)0C0UL&%}0{eqA&m{A(MM@4;Ch0HrBXFw~pcM{CxUlzmrV*n`STwOh3 zHo4dV7LlR!T4qF}yoNFk^1`1m?^wOG&bNsB3?fqZ=UMCardWal!F7lV@Z6~ZmWI}L z7PIMvRstZE3UiYa(ouBAi`ujPS8 z%@)5|J7T7m8$W3Xx>Txyrm1&)EQicutH-B;FdeA^d6r#bUZNA+e44qpi#t}d#=`m3 z3q(AyojNofT_kO>(JWaHeC4aS z%wCH}sV2*;=2?gPj9q4J)7PEK@81t$$DI<8>hM9dbd+t;7#9r2+yHd6;Vy$~_g=3t z-_8cDoBu1{Ug8>PEZ;p0EEj;d>~{W8%30K*;`+bZ1L2aLbKT+Z!R?I>MFAcVtYlxU z6la=t*PHJ8!fYSS$?L8HeHy_&YwTY0Q>Q})_yHXL-qIZ4C$R}1v;VQG(UVT@f$)(r>TI=ZGsJadID2jje2fCH7MFBie1B@z1V zUJsB7nKHUh=spgDG<^I*7-mtTwsbRiaOby9zIb_2pS9( z8N|Ox(rje)7I5&zIoDIy6QTj>RVIiTXjFs7xezlBN?q!{hvKktGtG^W7%$d-K+iSm zR2?nKKlv8W9kIt|<-*%ocs?11txYr!oD^J!@fqan&-z`3W)_$=_q9$8bS>@0SR`k; zxIhuRu$YfYfTErR%mchw#_+xYT=H{{qLq}>yhAg&r$o}Mwiun zTLs?$(;X3Z4f?T%L`C)PFx4``AX4>0$pM=(Dcs`c^dm?=a^8?^iPe* zQod#P10x#A@N=E(BdHgFAiTM1?GPM?@965Sy8aQQx3e6b@Z#EiF0;)JgYQy@t;h^) z@Kk{tC2_I{{}+HPqfS2-arl{D!P>-MzQdfH&yOLc0N=kUD&CRTwXM72Tw{{Cbh*_T zQ1)Ubn1OG1N@kY2>O_gvAodQ#f;L*KY?5s*Aj7R3*DheB-?p+CVM>W2 zhU;9a?E6a`;uIy&1re4>vc~B%`A|HTHSL@y@Y1(2ODQJ*4|`u76@}WpdqfOOkP=0} zQIJMj8WjXdC8brGA*35bjz}Zj&4|Q+)C@6{N=OYk(xAjh#|TK@cNjbezu&j+UH9L+ z?muUF1ZUpZ?~Z5h{cKPEuY;j>fW^z$#(rkW32H0B{R4lU*@thl)&82#~~Kc zBU}Bcb4sF15#u5BBm{pa37-Z^`g0oD=OoEHzDR&yhj^?gdIAQz%I#@re&6$l4Q_8spu; zAOpOSGHt5Clg4Q&;uQ(7n%P-5bDoW8YxoNSSn`^%UGEa54YAD*E#6YpljIMT_iY^y z1hhLkYzc{c?-vjZ+hJ68g;W;`F#T?U;~a=aUkt&hkm6A$W;fA;JRBjB_7{=$R(>{51*`fEcsse3_b2KdhWI#Ll~X7mvriYMT|> zJ_8`-L)0lpJ326dr?N12Z>*(iSkh!_)Smp^Opp*x%$k4ZGcM@YW4x0nN)m@&x88jK z{WQJs8|Xp9@iV;Y0D0Rex^@N+>}iOJ%s^c1yAOw@`A7k;S^g)D zYXC>2u9O1y>Q|J%X17ncIStpURa?Mlv5tdN@i;L&i-(0q-uLzGddyWeG*DJ8vYm&O zZTG;LgRzX4j;gCVU&))VkcLglW_A8734o&q5W@vd@e%wPAsIH&6E;pSOgn6NhoZ$? zupt;4n`xfBE@-#2~soy35Y@;#Ijnu*8BzkF}Vmw58a zar4UgE8Dqi1G9@IJtQW?HcFSJw+Iqmhc8-fBPJ*j!hZbYz)l2vp14nesc+N_u#V=eT+gjU?93HOlk^eB`^|VM3 zP+GF$+c!V^)CHD?xY>0Q&*6G@?n=SVOd0L_i2$H)vFS`|luqLD7)n8Z_P0-8rCpqK!Tk{X!H+E>{yfMG2^>1Z)K2B_b1 zY&>aSfF64ZhhP5Ud*4raa$~dSS6gFPU{s1%O=44{qBabg@L@q{&vO8s7rqoSv2YQ|!NdJ;J*OZxfjsyR7UcgO zJMoL>%L0IOb5;UOqQJb*&B@%(0bEPr$Fq#^x9#(1cNGbUR$~~BD+(T2y}#c}@>h7L z)j{~ied#mQ-9RRpL6_5n&JpAJk==tw9jU|K0*qM^Zn8xK`C`(=V@GwQ`a1)~&qJ zc>dnCMI{S&eN{%rl|nTI$AevV;w_C})}equmwxFj9~>Q?c8ze%gdp}2__)O5Z(egA zU=yG5+4|t~r`rz$cVZBRkuJL&$vqq+M&Z4c`-JDRjIRh8@;~%l{HejOyU?%<9&Nd! z1(AKjx3n(8!FvGh(dumXyG4~yj0wYgBLDcK02@7|86OAvw00!f;XFQ4E^s(2JSwH+ zM?BX%_(1;C-OMisd)fpzQ_Rw&8i57ike~ceY7RI3Z{1QI=+8^Exv@z2W(IvAV&9Fk z{%N7cACE15%IF*42ayMYv5Id{AN!JXP>}T>jr51>2kl8h1l{r<6>2CvM${_XrF3Mc z-|>Zf7fyvR9iR}CRp97rB2}*wgor?o%yHrfLh%x`iXWDA9m8v`nvn9tb~qP&-(hTc zM)HxH{hSUykM_b9MLY_W!TtdtnqFF!a^_bN?aI>F8+24G47Pm8ybyW!_=PAc zj-7U0tqHx9arlZQ4Gkgwcn3;6pcb|Tzx#y2HYBf*^a{Fcqa%#%K4rPHX1!BFDLtSQ zYrVe!ln`yqoOsVrd zLwiCg&;-f+fGQ+RT#v!qT>uhetX|o9*VFys-mg5E!B|R&rX+8u!ZIfKm+lq9qHY2? zXQYYxc0@EK$7_kcoEcTRA}+Psq{qmiW76AFHJOQ?Y8d^(dO2o z|8S))+57GNi{fb*TcHE#PFo>vX<>IAFEX9V!D55Z*vMxxbgVbR=vn7#huB|p)iUZJ zc9~Dn_si_XIY&Ay6e~|qb}QT)n83wCOx75j(pTt~@{9dKFu4T4#qT6cj}qMYXgP2Q!RBHy+oVI{YX`DvC@ zfYe0sR{MeG%EGgICyf17dbFX|@XXB{F57DXO|rkj!oJj>T94VjHO4x9|Ld&2J+}6G z&N={di%!MC>(MByW9wgo~bC=enStYr3ujhDH4Wz((}l zxAj)125n%R=v{?-u8KUw^*WKa?GNb)5~N;^!ym>~936l)!}2zGe8F!ll?(Zr{w-kq zY2N*oXxu#RW6RynJ7Tx!_C((sd%Qw$iAk%<%XgO+>4N@8(6elo=y;%83*F|a)vS$4 z>*M6BA5mYYd{~f!U)^vL^eq!;ik84W1JGX;UuyHU(QCc40h?rEV@fk}h6BM|qGGdh zD)md`zS~112kqJ4wE*IJMcQqrS~;|T!E6fY>`bNuB6jB{vaAv@>TUyNRZkYn?caHT zw^Lm`efQMQ2r!EB9-W&d!lTkIMDLU0zP*nwXyKW0Rqf&@I_;t~p15{(YLLYFOJlpv zlyam^w81$VHCU4vBP>E>g3NWTyqhGS zb##ZPbg0C-EcZS#-7zmlQNz&Cz<(TG^qPh+_r>QOD4v4~LkkF1vjp#KkOYWe6;MeF zf6Z?NY&6#-ugApqG|7h*B(rH*z#ByAoBy`&GOZWGeQ!N~W>g!|_BMuwV{-NEgQ2{h zHmX3B88wzNK)S6yv27*H$P;-w$1 z1z+#VW?QJN`DKypIeJ`mk70XbR)5B$#WOFxa3WBFP_YN21fJ!E$Kj6yqTh)|wxIf`BVG)^*>Ht%IDLcomPcpqNR4vf<)wtAwKPx_($7bL{K(+5!u2c1Yn$ ze5$oQh!%%}A0KwP^Z^O{kLkV#TY>ges!P8Wa9Ea%Cqs?u-=*@D{=`{Q%pRCeIkXPcY}v^P^U!X)Uw)!ejT)3LtVimKc_rvY^1clc^tZ2) z!yQ}Y@;g_2G0%GbK|I4ryggKre7f=`bpX9GoaZ@oC3R)JH|d1k*bU{@>k~CiBE$(+ob;8THPI0ljMPlj#|Vr>Yxxlq0qm~MVyZ{pu1D%E6Y4L%VeJJJ zjq!#gqgQP74;&TQcalG;$=0Ky2H6r$oxgK?ak+=i<6cS_dsKqP&08e}?`VU@;Vfkp zRD`XEu+;@38`q2-j(lIYHUp@ELC_;xLn0T$qoFn7=H!LZ^>40O?k|?N;OM`-6h*KJoZ~IGhJmRp0qlO0^iSn={(KwHi8I*(u=_|lYN5Jnp)Mg9KWg* zbtVT_dW?7d+M`pj@e$|yGMQf?-O_B&5Dt$8A5dnH-`6^_NSC{5+yDd7^fWG{z-@bW z!+J(n8#L#Px)ozvXR=cs1>}RXQ>_E$EB31IMxZiFh5g4eyWt{rO>4_7uf*X9_tbpd z5=?>nN6^r`ecc83QBV2eX@*DiKCx6aH`1&2A=PdU@SmuTA5XdrG=B7yxDRj4*|)0+ zzZvI#gRMEbOI=V)${*n-pyjIXYMwCPq3)g&8D_u6(>nIh$)`81a`w6&SM z-G0(+V$X8PZ#!8{zT2;;18}UyMEr)h&L(Vl7kkTiliEOjqaYdBdGEKo?v91;lPPU> zBJcg><3RBXsLQG8@#@u?K>i5VRj#RvU-j9q4VF=sM7Yc}wKCqBAR9nUovN7MVXv4* zV*OP{w`7CHIj$|axgF$xmvdhtz2sJA*}INDNlr@qf*(m~ipTAT>Ty%SEDFZkb-kN9 z^z87KFI;o9z-e0Hhk$4I6Po^78<^qgQC+tZRbVRlp45qMuf_m}_g*;$t}XYKGkJc& zS@2*MQ3VSNsmjFt*g}TWn3WTXTH; zExGl=utUP- z05-!U6Z`S#s{swP?c4SWZw~(MJcz%c<=1ZzR{WL~e0dHJdGFC;oKpZb5WSOAO6Whp zH+^MA@-PsdWjp8x!C3y(JtRpw&}>U!39jCuGY4UD8otipyr9t`=AeSFlu$Q$B}{lb z2M4>H2IB5hx1wVX{w@L^vOB1pBs5&44S?__AtdGOk+65%6P)N0n)}*8I)@L`8Nk2! z1s}R1xgf5FwJ1C~%IHJ~Fag|nR`)@xlw>#9PJ~j+OTv-xC4vJk>9PlI4?!&PUId`t znBEn7cmLo-{lIqkhu@MBelClrWKoMJnf>RtL1lq2*dtw%nl>R-T?sz1`ytICDqwP%iABIUmua&7w!?{oUKZ#MF>Gj=OkJwq!l&`H3 zo8!rXhBCSU9sl@n#!VSGnLfGC$Nt?rFc1bll_voaewEjEvF?vcv8S>}O$uN5Z)k(K zA~^Z>eW%4i4)>)#eYyl;r7ik?k;S4sjK__yiskZNzh+GFaUP9V+xQluXA;a&)?;@b z235iOJ4NScL?0~{Tz_i0`n??gyxvOr6!XZ_xy)<1&Tejg$88$*hrelQo_N!;wIm?_ zt<~mBjFm(Sh-t$mfUVc7nveX+Y$pbDsBE9+Y(dCnBrU8DV&8KUF zLrW1{U%l9n`kvuQ-i?J5p;z^2s69*G85(%bdB)$Kx;}%jxfL(unDldTpq;;@AyDwE z0_AJaPjmc)xWQWV?paC^r-c}ug33pY!E`KgyZcQVi8W(P$jQ-LY+v)EaZ2=zz*$en zYV2P^@h_kJe(3qA;Q1n6Gx@6g`{YQM6D0LOPsR7^`=d=+Kl+fylPjNYE+N=p#t(wz z*gMppW+%Div%Bo-37P*Q{X*{?U1}Nsc;*SYZhPEjmZ;{hgmd&xe-FDhm36;!WGm$E z!8ag{yZM}=Pvih7Lax*HI3v9$r{Kw@Xis6M7b9GcZ}JF%L0-(Z2eIg1M2n!H$G%DQ zG2;;_FQ5QIX_63(T18Bb;HdGD*YCgrHd?Dy`?w(aMeMG#;Le^${7UB-Og%5gR>I#= z{OsbaJUV7f@6KR!C4rkh+B6?RXM{DYjeFcAY8nKJfbH1U@ytSTHxw3yh!izRw4dHh~>U( zc6G+5{O+OkPs;1|!Rt$XdPFz8jcxKU2*o+p9`1$uTa%m3_k={|ZdQ2C!zh6Vve3>@Ua`;Qr@!@1#Vid`VvMM{P|% zcdz;)p^Lk!e2fg`Y9VY+z|h-)w(Z_InRdwBejs#LRMW)kbrkb@lXMbhWZ@IgnA)&SX(@hj9!WFv5jw$4=?6|CP33`a$R zff&u)Al-d^7I(exzG~CM{p0RUR(p#Q`}b3lw*zUt=fl^zcuTGOx_QBvmXvt8D}*Rf z^7Lr=A9M$4UBt8GD52C=s_i7?4-LaPLCbpPk|R5IOiqtc&Ae3!#IaX@1Pz^rg6_YSXY?o zk-50V*-^Y2+_kK_0Px|EefyeSpVApvX{mzvmIEvf*M6q_5DcXBObCkWV-!5G&kRBx zn?h9Li%-UOlWD#U*-@6;wpA3IE~z(HhC9LUm!yT8%>7 z>f4|5HHB?S;`(k;Z_G`M2ihw(2ChGLIHAKA%=@jo+Ewri*Bd%(;2v0mrSK@6D__DhWYCVf<`^i|5BIy+6!*#J^k~ zl}SNp+S0oJWN`1(84`fAUU+!Zh1YR7);oyS(`Cv^sGY&4b|XAEb@gpr+H!gh5)W_Y zTpqG?H`h1^iim7B4M!E77%p$S6)f{}=P9&dqCw%<*gaa{bvTmxpS0-{8{!pK<8zt& zip*|H5*XcMJXHwle^ES^N#3zPq=X6$^gz!|n1kP|mB!GMHX_c{nwB9nOXUgT4ocw0hEx;kxJRLL zh}6m1m7dS}-|bJ@biL@Y6r`D(p*2;0m^0boBBk$X&t0#RAxPSE{iS3wamLv339F?! zTIMULKJ2zz@)-+1Uy{*;W6AP|PM<6=6d}Z|ACB5}29>e#_I|N-2cI^#@0)?9n{ngK z`A?xkh_XYxT;ndSUSFB(+(oB4$Io?pzwxQ>y4SEtUG=li+_Ue&`u*an zk#E`z8ZFcOppLABF75~#t$KP>;(X@gx^7Ix3~y)M-$tlwGzlTYhif&RZhMth zxr8YsZJD~_MlQnMEjW$@DlSiB;xiA+>vQqwtmZ$CI*<>5&VqBbFL++H^QvogvD;EAOP4qE(HizB&-Kgrj{i(~BfPhQOL-rvyiew){% z7z@xS7pI0qT)Zp4r~iWJ;(UJOpU8rXr#3(!W9NZ3ilZbm5s}4-7FP?G z=5;rOCRa@&mX8{W#qU^Kt(bm&bxXpPER&Sx7%W}K%SVTzmgta^WP@(dj2i8@Kmj>Jm*Vnn3 zP;5_@V?Ts-t$-D$j$rSG8a|a9+H$cGz~p*y+3pEI`X= zbxTCvxbePsEWOv(fcP6qn~-(o*FI#j?#FPR)BhDt8d>NLi2gy&D(hW1>C3G9R4ScjjBL)LTw4XM{`h4W7PVZ?2Gbi7 zNI8DP1vebkO^Vk%l2`Cx=gMRcKFLUc4E`bt;pprfhv&CN?6}iMW@wHT2*}#6KSgAs zY=N(^6I6IK7Gbs0)^1JQ-+V;p{qB)Q{+_m+eCzy0*HiQu15WW6s&#qYo1)5JU_yqg?-0VRja1?hn^uLMTlgE16vqGGC-$D- zeDnBAY6pBs7=>jLeJ5Z~ z0FZ=sJUiG_08opJtPQq=9cBT1L}wOFcC;XPTpPeJy(z-vC_Rv6@K|ei=BILNzPsHT zHB=ZrDpmz^y03;WM<@pj)9o;F8GNNR_}|X}k()pq0fYYXd4NZJ_y)7iS(ymeBRZr#owTRKk)#Hm7D;Z=MQDeJT&sOz{t0! zckmxUc4W!HD*58g1_|ikTd)t`Uw00xCZYfliG0pX+U28I7U15PhHqwFJ;1UW!D^wj znhy?Z2ZZq8+WllG;rk9Q@hub4u7OLs6m$eKxL6e*-<_kL$2XHAKv=_jz47hu&o`$~ zt{ul)YwpbD2ksAPZJ(z74HxF%Y02eE?s5{H0Y z?K7&obk(hle7|2tH6P z;k?DsG@2pNsp{pAju~sdT?jviMfQEsJ(oY$xUqz~QD`&#g!`q&ETYde#nt)$yv7fv zsSEl^;YCVPJ6#&yLxrgd!aFa*oRtVoZ>M`XZ*L^pOkx=2lTO8KdDiS|CfPP3%Tn8a z_Y}Pi1oxkFhpqQWHu>cn;tL79rUm}NPKeUkHeRvb>u`b|dnDnr$Ax+{BL!c}?=wyH zR0LEWfV1O3GG$NT_Z)Y^;EBG@jv}Us8|P>s*&B-sD;?&9 z5dl8AM3EAkQhNwD$0@-m?d^tm)5Wmgxr1_iN!AEXX6?xRl;2C+58_Hm5VDne2q|A*=~!&k8pE2s-O_Th zKy+hx%8@4aaB_(x!x|pAv{8Cbn1Mh5E|t&F@|kwrBcu8DW!mhZ_3bYoKN9w>@A)N4 z7X742zk3367=U1&DUm#Crm_O+>d|7({(Tt@9$l5n38e~&giWZir9};1mph@6Y}|AyXoD?F_W;#$H1DaMn){hlMhd26p05027Jpfh5oYC zWI`O50@}jpyjxhZOIw?pT{NVKAjLgc+=(-1&gd7KqvGsYL#UTfppB<`$7`P!zV-#O z`Xlt3NP&K-*<+B9X`X9g`XD?iQf|=_VU41+?#Y-fFe*y*s(_`7)t3lH zMw8(lWr=DXEv*3vnb1uHHf}CAKR>?+Vpr%-0fnQvSXo*5n(ib?L&eJ8zc#5n+>K<9)4VUvRL-!svuSu3b$crW!+MR;Hd1w zdY$B8+jo5ILz-COWfj>eNrE<`34_xOT6I6VGKaKd_~oR$*dR@TvdT@{b7dHLPw_Ec zV`Jm9)9s1K0axobPjy3sfZ^k1^~*<*!6TR03kD)JUIYE7=c&v-gZ6d>rq9A`mjW#F z3OWH)4X)@3thW`?eOIbxZPVk%*)wNiZV{24CJt4T6T1$1bL+*GQP8X&3c0ZeOHbNdVZAg=3!o>}6EW{QUfk_S}$^5zL>K9YT3b zOVK_mIy#yWvd?_+pog;kj*00}l|?9L^0@eMn}V?=q$X!f zRMdQS)RoMrN);*L#Attro%GF1++~B`5)COQ#I@(}=u`JE0pIJ^Y}BQ%5VNFGo6v>QgBO z$qWnS&7+T2VJpR8A3(y5R|*U@^tL?2OSI9%G1Fzz&|QBLMqVDC`MQGg^8VQHaNGBo z!C_}C8*K0KlP7mZU6t=FvB7#zh^M0SbAz{80b4S^%_u4rwdLtwLog)2?Z^MHD|J&u zArz>1j*T`8PIBSi^2$8UdL1VxCwll=tM;4#H6+u6+)K+L@!_E6TVkU1nXUa6eIn6 zFUw&7$sMxnXHfHT5vTdfNVBetk(DjssVLP-6CG(*;Obhh4itdfGu#u9_917p)RhhKZNUp(%P6A;e{(WcmO?RA|u_ zEC;J0G-pbe@-(p$zm8puP3Be#8r#as%=~NAoQ&KlfzoaR2n`B|taag{7tc^46$Qnw zOr6*VVR;KRcAH457DC+kkB}11ug(z|_JTy7GY^1GyTalk(wJXd%+8h-CHz=QznFb) z$A!&l_7Vyx0KMxFZ*DY1RZh=P3u7ZfzuaI7`v7Czgu*Cv3V%i#__rf`F*k z<}7S_m?qgiSnBTXhLmI|LwDOcl0~?JPC9C7Y4u1Mp)hWDtDF`(;>Fz8(H(9?K6NB= zIh)#Z$_nG=h5%&&Q`t^_YkC)!$AQ_;wwVs`SMrTjjs&z_}| zShA*YP+e_|vxkH?@3{0&p?i6Bq*JcxRZyG{lA7!SGjepRfi!gA`PSFDYWlIS@?(DG z!vao*FD)%svZCCSpkiqV(ngvLaBH-!#Sn;{f?~RnVtwL7g(Zm?7w2H&4b+Z43xDp1 z56d@j`mSke@5}ZYMFk5#e0UMv^XZvbNq)Yi-`J91-q?Dd_I~C2_doQoMP1k`bNGVk zvUHQ({pD#CTFNNLSS!0d5wK6qa7|a2vwfdk4S6*V=hUYCqnqlVjZfe+%r)Gal65$u z5E_&;B>aSr|qeZgv%)zm zL=nJv>WilqN=k+1TP4caSND@z{ru5&3qvKRL5*qJ^4)QiYSs3 zVy6WZ(U5Wi7PW?CpHqja*o*P`{;rEd36Kpeo})^B;5f3%Gdc_cEW0MV!*ts3y&ZZQieP9Q#sQ;Ca_sBr z$;nCD!YCee?yRL2#&>gbGZmxeapRN?P9}_Qgt4+x9;%mCR?}ZGW%Q~(v8AIUrJ$^) zy`qxChoMRI)WS2eO?t8%Rmmy7p!2eF^70baT^S7$?Yv#z*C@~;O8zD(EL7(iC#-$6 z^uYKG1;l=c6hyP3;AXyc2T+$A!1@)&FEA-Sy$saA?WV@I`!Fm@`jaqxt>DKQ#E(D` zST7X3J5yIU`b~n zPLN@sICITP3v&Wu7voP$0sn}_B~zSvP1UESZg|ROdT>hT;-0*ec0hA`xa?%T*`p}X z803Lys{6(2kci!B(~N|$Dv)yOc9yjDJtG3Nns^z6_I1NlEGX+(PNLOOW-h z=1jcK)U)P2CI|BHT?K(l0aC0Qd!PU2EC~z@EXYB#Hxb_)lFsrqOzHy{ovH6O11q$+ zQdLRH!4!qM4qVmX(8#CD8f51fyLEz{VQ_}yc$LS33$9Mhe5P$;V#3yhh@ku$NQ2z~ z*YMbW7q}Kbbk#|+XUShRRLEFBOIThZr@U&tKMz;fw+E)m6~^`1MUMvQ*~)-)gxYG& z8{!)3aAXAfRsA?08I3`YYYrF?eZ?>( zU>$U=ez9pQsRd^8LGb0SO1&zlebVp}>8x%le-mBu*)r%?>llCCZ^M4wD9xVPf=U;# zYh%cB4N0+EkZGZ(+l<8{Mvm79-(J7ZQ|UM-aG%A|(2_a+>2gdPrOimRiplH2^e!yw z1d)%~hl)a+t7#*;=$j%^kkx#Z*>DsJWdqGEWr0THHe!RNu#DMt>yN1GECXfg#|qP@3a^ItV6?r- zJx|69Av|CsnQ}SuWtg*rWl-mi`GFGe0;{C{4Z~N+01#lrJ-hc-lHo*qG?(WC8EJ9eC)bD5fn0 zvvq2s#(iT^5w2a9ptCn$#mcr40bJUxB!pQActZ@NcT`x`0{tCAPrfxlf!Kwej9bUo zx=T9@gf3gRoeC7+g4KPk1}>b(v>3e1wej0ole7KW8Yp#bFjLDtYJ$wn!iPom-Ov7N z_YE(v+S*ji)(adXWO}Y{tM_@0HyaES<4tb>)xrn@`LufYFkrLx*%(~6!tN8;aXXjz z@_#w(LkN%NvQIC?>650%Y%umCj3Ess6fb5GdYp zEnlvFct&GfpM^*} zZVWt7h1;rA>Y(ggA4?;b;~gmLhuPWyiX}|bIh6NNuqU04m1jeKb0zzwfSq>N&zr9!oQf*M5*weIeWJKOl#oNm0nflg~^R=0~NXRyvL$dX6;*x+X5>PMR^l#{NR=H zPolO`u6kNOwXB;yHz}1Bs3*ETn?h|G3SX?rwYuO+@1sU_S;EVsDL6QIB3fm7?he_e zdhu+ZwvC3IXLc0Nvti8`<9IB)moZT#@R~w^679cy=Jo7OE9IBmFx&ssVv=>cz};I+ zy)P`u@XRMEDe0SB4)VEjr*hD0Rg%Z;r&&n`3k1^S-~1-VI3xu`qLuwc z(6gi8Uq^trM-7DX+H?BDDTyP>uvzD0|S+bq*83TRe> zMY-w^QIOFTlyz{jvhvt}^APfVj5}Am(W=?R5vq61R0()QG4b&gv13cAnPuWa>-tyt zE!3KR1d5Znf?*ifYPCwux)u|LNk%VKun9G`5*aoIuUx!*d)y@zEqD*=nW19wckDJy zkeKwB_c8byC#*MS)!_NS^SvPtb9lSvT`#Y_swYSC^gx5=fO5!~z><54r}-izZ(kl} zfQ%%4g2D}O+q<paWp#E|U01jlJRz$_Vc~vHsVMXbtDB$IaNrq8Z3-^X@D%V%r&>p`QVgWkjhK@YLn) z-Ph@le()y!A*M&5sViCxm(Pi_KxzXj6!h=V3g{>c{GcRPP_KI4s{45*7=eJ;x!=4L zzld_l07iJWK&H*flj$5UdWnpzgi)(OAoRwAV6%||y((}2=7GKwLLJbipU)&x*{}FV zy}7^7qr(u`><$bs_A8@D9^h?r1OtuZ$CqbT6LN`pK#W~9VFpiCl}o1Qa$%FeSPqz{ zu$k(64;C3VUF(C_{f_bCqF-kRG$VhAMJ&UavCQ( zD0P5!Mvs_lVUpGth5%WjvP7BXK(VnVe2srP@7*Iv7odai95l~fTif0RxSE6vJ!QQP z1L*;X(4D=1r&JJqwh|TaidM=^he#x z&>6hGMy95T98AeWZW`O7C2`pH_?`*tXXc~+6%tHayL&QuRd32L#`pcs4OkGtE0Z*J zb#-}w0krDsEUWy$MR8^`hFz=sp;Vhjx)#K)+JD|aAAJ=DgHgAoN{kVIRL2J%zELV@ zbNH#K+RXs}I8$m)5D#xFCJHQoL2!AtHd7nh?E=Z(>;~su4Ie*#%*PCOFkpdkE^m4S z<>HvZJ}IvfG0lxhOfZa}1g=4EaaLBAP7oD`0_j&(sV!#M){_|HJ-+M7T4dHWgH`GD z7E*utloRa(HB4>zXH?1u#%So+&)QoNC&+>qk$|;GzEYh;axub(F zr%ZrtPT`K~LTf%TD+kB!E+AMGXrNPz9dA#%dYYJ1Rc=>WO5w7JKDaEv&_ELSu0h;1 z@7-Y15LY9pbRgzfs@>nC)Sjb(bQe)o{dOA#6DBSJR!m#&ymVGL9q3pqAyX2udO5aa z@KpSXz6iUJal_f$_49Xg0JbwHps1BiY#d~jhNfd>rC%?^D3o`+-_c~5E~Wk<0gjYj$2h@+;Y%Z z_XkitiU6rLiwY?NR?^cyxx5SXOg3i~alvTo5u2M)ANzgqrm@55s(=k7P3(bk^D#`BqTHu zrP6_YUrm1Djd%3&U-;6m-;udw;298!$C<8Z%Ae`1{khJ^dfy zbVuz>ofzH|if3b$PV2z0t_c9_6M${aQwkXJTaI+W?rA|i%O;5Fcv3&mo%%OHTCNDh z-I0rpO(!p^#UE2p=EWf);hi<)mVU_HMA*R#{16@yY)CGdEM9wvvq20qP603NOKWRl zbmte^qba?!_yCU)vif(41MqroQk>y%d?ph0$J#jYYa96cF(;8DnSV)N$H2E2E=qch z<4=yn%)?Bi=T1@wH9wLW;r;k+`3`dJZuRfW#-G=?ILOv-w9`=Dc>4j|1J~aHP$+X*Nu+6GhaZRvOjns8Yfqm~IGVga z>vI$2%NUP^U;p>Vx-8(f(3ironGL`>ZAGK$XIe~{2}}crNQf?;#VR2u;}P*J=-|+B z=I!{sa?qmd2UO=)w6T_rNaZFo?FIUoki{QFM?>f&E|Jpw`{TN3 zqDUsiSuAd|<^@G9C+&p|Cu81&O7(wIeFdOWfY1iv2zov8s%T9A`O#^Y`*@X)WQV$! zUIoC}&dv_v|8DPWb?8q8$--xjpyPFAcuXAscWF+?#LeE1_}}>Vuu%AaFq*6*e1urw zkJDYgd;iZ3mJ#iU&JX5fzWDdLiFLu;lIerLv!EXL^&1SibL2#-@c&?>0>*pfAN+BI z^n5q}yuklgHlg(RvBmFNfd79h_$T!LzGyKR6BnRXTY@?DDjh69lmRL~ZowT*$%^*X zXj9GM_2-i~KFg!r^i`9NJKv@xJrVr6?7h4FDHSZ7v(a&AaZrZE**!c;7B z4m_o8NvW9E_tMWR>K>0h^4|YCMh)^q6=ucEls=WfC+SlUp7^&gD&hXq?yQH$J;hT= zFc-KCU?zL>J+x&vU$k>c8|C6Ee5V* zx?f?~6j~Yc6afqV}^mhLf1|MJ#Y{s-}Z1$lgbSQ%f$t^KSzv0|`+@ zMTLwRJd)*B@2n@ii zAV|JNso>GuFmkbgiGTG!s8BlUIRboxY2vV<6#SBp+v&gWrTcQU2KrguAgB4B=6fN+ zYjIBip8c}xhykk>tE%=gl*K}6m2z-Aj#e2$J?G; zKXXnGwP{44qy#McACY~8>s29`A^f>t zL9LYtknUk_WwijwYVfDohQ^2gKD{Zt$a%IoMNG@HlqrkG0oncnavPIBGQ%3-bVT54 zq8a65nn9}LdkVa4)C7^nXW;7U%Fh{{*EA(`;;7#g0V-)?j2`*jXNU%0qhc=b{+}Pe z2s_YSQ)nCByy5TSaaQ1>k)IGZ!bH2pLSQdo^j^Qx<470h3Tq1rS`;CxFI@l9T;Qpo zuns?@F+b1;vS&e|N@<))f&zX7t3$Hu)<50fvs`#&sEnOWS!%2C>eS2Q7d{+E-Uz*u zu}A%_&Ekak-Y-Lum)onYTzMkXY^mtjt7l%Pyd*oidKG2h^{q|+9Y`vRZ?NcQrunB@ zZW#quZ_NdFl$9#*|7uz5wL8zjcu{2jHd-g^o^PtxR!;SasoB0h@zI6HFg0c_F0MVg z=$uYs{(l`mhPQseOEbSSQ<@|W{xHM))qya&6DWQ@DTZ6Oun_X^{<8c1wp$xZHm9tQ zpSob#%y<1?-b&@;h=8ClFdA2N@J!Et|KV4IT<oM6~wbo zego+`pyF#}Fy+?VXoY?DwHgk6)E#~A)F4@F5CAWHnKmcX91^Y|7I^s;Mj6cHK3m{V zeKH~T|EMsVvkGyy)9qVhIPPoD6%{2r&Gvq|FnmE`=Y`FUa#WSF_~z#e;|S{!Z5TPM z*Y|%>_7*@utc5SkZvQS}f_xaN4vHg1_IQQYu z%{4Gp!^;b@Yg0u6D4Ve1e|F^|OoxjjWef~M$N<2Z{Wf#ZU*B8C3F%v0RzV^;*4+2R zgsc&v~GrD5% zU-H_#J>D2YXXv?RV)e}sa89?OpdY~VCRuTR6F^mB@naF{>Plz`{=;7U`Dchl@D>>w zM)FcA<#}muBz${V`&?3ktDxe?-Vn_hZ0%B{I+X&_+(`*0O!&tNw>rSFS2SyiBzs_o z7XjnM)4#iuM*?2>9eab$Dc!Gr2)bWp=mj}3Z?COs!^MSfm$b~G!W4MI=cdmjzCD8KC3(7n9tR!^2yoR zDwLcC)L9<}e7+1-rfC+a|5LktQi?BuiFm08iwDALdujH6O#Cq(d(xX6ffg&ol5!M_ zA3j0-`XaG|_PeULQUS(8pM4gB&QhK5HLLocfS?XCVfi4sclfC_z?u+XC*NaDz}o5Y z#f5$VTUDQUTuq@RlO*a9_L%*!eNh!-k~?jS$f{oCm3$2U_{79cU0>gAk$-9n>2SqH z)H$3u1u+kPXvn*4u0I0@fO)}%KNofgSGL0B^R{KT1s$g%xExhwrie2QD-ABXj)uAr znLtHMW=dV|&qa{CCb}4Z|3m`rRwpq%9)?eL`p93!Mv+4t*d1j;@s(2S(Xga>cWx@H z+uNUMh#v)((F$>V$ogt`(SZ;Zru=;KkAp1xI|i@lf`4cnPEL#X2YxgE3_1aK%ui%z zZ}0V{z>~4C6l+_l-;-}X(v&vIl1>2DD-^oW>SxEc3k$s9Jlne#>i28z*HW*2 zOXQc6V!ha=cKvt6nfj%g7d@7~|Hu(rTyw7^@wq8QAb^T9 z3V?P$EVp^7Pwb#%Nr&$LBdlWlohxIfW!8v0Km%&F{zBEEVsqx$wv;65p_BbrgmkUI zL^e&`dG7dg`fPf|DwOOxe%7_mI+|_OfrS50$}dE?!kXXF>pWk8Z6FWOan7TG$yF7z8<^Q%>)H4{Xyp z5c}@1Pj6GOeU>ZC$$w{`C*Q#9J{!WdU!eBj5o(%feJAZ_HDktv7N=aGEnu>?IF{oZ zf8m7h1kL{(QeJ@2J@Ta)yocXXWe((@ZGJLA1Z}%k0XjOPH-6L?t(_{jR>JW|U(o5- z&$Vsy>@`BCUq3D@i!4WE>J~L?e`N$rBqQGS%HuR@BL8tY{~tS%+>Jj9ms)j#11a0m z6wkY*>aNcA#g+4s%vV&sIDUQ<%wIGF>>4~75s$BOa?U-Tb5`D)zOyI04w%S;+;)n8 zDPE6fr)`qorrFmoGA$5X5F*qp!S*o0L4lPYMhJ=II>LUBRefd_7XR{oSEvL#g;RX; z`A2FGW5Aa;TzO@O_<+B)MnC`hUvQPoaXdi8ft7=UPgmi@D@~pUtu$x3Ym6V2kv-7y z?#?r7$Tew*r`jq5yey+){Pjmh?V6uE|9v)Gh#V(0{*ndp0dhdy@*mfC8EN=r<$)%c z>+AB8D1XZDZzPVCY%VsW+D|k$=}=KAD|@r+7StZQ{wc$A(V9C~=&-SM%1E6k7l z8(#k3WXMQlXJ^NuD!28eyZ5YF{AGOf!MKsi>`ct2k5)H;gify70_hbFF=d31V6xml znii`BJ3E(Ox*bY)RWDCRlr0`T_&cdQ8i|jY<-RG0cA^ z<*Yq&$$gO81^^_Z;0hh<(1%CO6X{ zlrWmxz!45~2K4)*EX$cy!D8D?@PDyYAG))9!hkWF5cK7~iyxe47{3*#4Nu}62lS?l8#IPYwibx)8%8MHG$_7=ElL9(cJw{5r}DMZqC=}|7&yi)FcsKa-Vruz}Mi5 zzI7fALc)jt3zA+uLyF$`_#Xn887rG`Rf{{YQXN|-g}v*x_8v`-pDa~OAx%3d2uto# zJWKSa(jy*=?;Z(B8Q;vGfkeKcn#wTVlq7%pmN&R@RZXPM7@LR1b?S;Qf#oW2DI(32 zs+}BX&cWLn6Q92g6r2`M#!#v==^zlCskBnxHbhqlvzz zniI;giw_|?=>8iDDE^J0(AtolHaZ1$M%2AH-Vvi6a+&O$H{SPaA}zGcHe#mH(J!tX zB-kSt;x$V=`2YcVKgkohaAHEKC!cjyZauxeuj$?^1O){JN1#R9?1bfAj%!yEQoI#J zeUyUW4Z>wIHF`ABZFb??hWCW4X(!h5jqFqLf2?tB-T|K?;b(2s1UF74&r_y+r}>*I z4yt+IVOt?h?eI$RV0jS-S$cMoml0`S#D#bpNgNAR+oPNay^6-luTy z8B>{$Ns8aTji{HpTl4DdJ62ZKCX1qa^=7p+h0yQsq@zg>y53S5ESX3Q$JcF>wC(Nf zaX$p?$AzgrImrGs;ZRIdB4R4Lc7x0>8+MrZBuDz6qb|-wG`#S8E*~Q%LsYri@7Azd zxwEA*ezTSMH<1l`5+)bJgqYw6)vm72PW>mllh*zONn@a-$lhD=?hSIF0@}y<>;5R5 zcoh-#H-Rc#S=Z*hMEAuyF4M->Po$Mxh#lCo?^lz!g5qNJA82E|gGS2wm;3boMl+D5 zIlya6nX%OodMCiAYs`POYLNIx;g%6%ZBAVhzyhHVgo#~0cmC+2MvQ_BA6p1TuY&_N+5ElW^DC?n z!St~T^53zXZx?Z^C0`x;PWzuDO!&t#s@w<3Gh94?mWC(5F-Vuk?w?cf6%f691ZLfJ z=YnZLoc3}JwAYDWciNbC#_gm=26}>2u`b6f@gx7KkhdKod0vx) zPBGDh8N|cpn~?J7c+ot;zb!MZp}ddN=EApz@6wkpRLLAY>YaF0c;V~mT;sY^UUXh| z`m56-mXW3ZoJrzf(3tsG6rr>s_|q9*SG+g05Pr0_^vTF|X_v&+SCvD%iPy=C@v9XN z$h=iad3bs2<~&zRo$lR?>Zwod?E4|Z;OT5@ zEJf&@DQU23S@9k#-DfV7X?yG1lt}e^ZdiMHE~BP?S1R^a|P#O*~66WX5 zOfe1F)Yyl2K_n7Czxs&>6DE4Dn*%m8v@$SSzw1KxyIUoD9P?cb@+KozaUuOggPq!0+IO}{iy-bzc%USL3;(wxNhoAVu zN&hdNT9SeH4E|kw*846gJbdLh+5SdK>e6_`)j>XC2u$wA2aJkN#J>q=i$_kl;+pue zo^K=2X($xRdRim3<$n*l=Rs`Y z&J|j>_nv$n>kd$*I3q(G5m+_VnK4#~wZTnnpr+9h^@pEG{&!aDRq>Yagph1>04&q) ztoh>Jw95nD$wxadn4oO7>1B02;3wLFBb0-x!c$6?1savB-oc{lGN_7m3v>8y`U|d% zvniH$I`XNb+?RjW8gU1n{_@C^Sp-uGJpSfX8-Aeq?hdr(Jh8^ANsb1mv%WZSfn_4z z{)91cL_(D!e;>VN7ixK8%eu>Pjzx(0)Zdyk8Pj>t8WZjgdYvG=9zE))+gF9BG^ZYPy-phJ5Ltn=Qo`@F%(@Hj#`8 z4a<8QzB@&7cX=V?pxp+DnAqXhf{q_wo#Q3BKv=Id*lm^+NkmHd8>du^(p7UJqyMKP z!-rp!=?B?-YVcc;BOk(d12k|wgf~FYKp1ADXn@R=35tNyWH;#!6Z*4cdu}~mo3Ztp zp0f`G(FFV-RvYj9rM{-I68hsqpdZ6ae-ll=>p|Q5ugJ5q^Wj|3MWFcniY`Y2apRx=cn7YrS#q z`2Br`xg7#F@D!p%FmmqEw+oElsO=R>Qj`;kf6-@y-F6**$+#(&<*4t>r@p^D*eS`| zpfBXok?~{?V4~L6J{AB@c8&U9o8-?)7W{3lO(!XFYORsGB?8W44&G=Blc3ecrBC}l$B*%ef-SsFQx%O)VVykIhm-)e9HR}`9 z*Ht(weh<4l-Owd|t~%IbnH34ty`t*=j*gCvn)9~3h2c6J1KW_FvQ}sSG=|R1@)v?7?XegYjQ6h~fpTOv{Bj6kMcuP>Gqh2(NI;jnv=P z!X{ifQ+v(`*rmif^_Yv8hq)pAo>z&i_R?{dcdR76xD&LJ$aP)eR+K6laQw|$0*3L%C2!5fUJi+%TbU1^)jTm<6>=;howf zpafN~S)OVU#3`4#^3|{L%SBEzI*;_VAP7DE=2xz~$@b=2uKU_zVL+tnP8JF^TlZ^r zoaLXe<})2c#ll8XDa4~}@X3tJ=FiJ|6O;ZZ6p@zXXrZlMbtfv0*Bt#(=#lFu95Q9p zTl|RY-sk6R=+Urb5`3hb>#{Ix>>_>9HHG@|&o=_Tazlz?FYslZfm!k{$4iZ8!|``} z@5evH#b9`zoFp5%+LkjVED142P6Jm|lkH{|e$?!=S`4RNHYn(Jc6N?4|E5K_7QB6Xe-lXL zd4fhY69b(pwhBd4!~K*9ZB|bm? zLjT(Ha_K%g({6FGv6}1H?Hc}y@0D6v2CIHD8kAd(f^)gWN%CY&CE{$9ZVJr2q7CAr zTtwHA%e{~qRhrrdTVu`QtXb8%EY-(B{FNAo ziQbxquq)!*B`>`w4t*9&OlBy%uBa>NuYt(^kf(3S|J;&X69Ah$SXUmt`iAeNQzhF z{qzD(;8s5j>`-?(+SYjRUA1`XNmLs8?;!*ha?XV|u`O$dGB2>CI?@qR*HYEr+efQ!rM65|jNmXCK zO|{{9_r(tU&cXUA**GB3T*^-{Y^}nur}(R5UbrJIFmGjl~exPMT(bav61J zC)m|9Ct-mD!6`YafJp!OD{<+wD&NU#IsrDTFKZFoZ{sEzk@KdW4whkJHCw{c518>2Gbl+nmy-FH9pS zE@`7KXR=|ulPgL4NaLd-1i_nH4ZOEcJ)|~^pKu*-neG=Dk7TJ5>Ff5$x$}z=sFY^+ z7J1Fv=+~ySDr1ebzL%Dzrb?m8S9%IRH*}<{nXE5OjyGJ!(*__gh3)Y0JFhqD zt$=MdzHJ*UvLaI$r#RF^-iL34WmRskD@pOU*XY`oGjN+VN8me7r-Hwk{Q8ljUlZ?n z(1$-%Y-gAl&X6eN}f{>NFhqO%8D7{29-i#LCe>f5SYHmmprtM#pY< z)0shggDH7a{ju&zvntG)&7`wk+EI?10G2nH8MfCb+~SYn6z1jOVVh)8@!Zc?#u!_d z2kh!wp1(r)y#gasdyL^Fp-M6uy{?BRF1zYWDh$zO*nVFRxQ{e1r=b;F6}FYlGAIvY zjgO6sJE<<0@HRpa0=pzWKED1~+MiRGU#yvCsZOoRrNdYhsuo-thhA}OW{O+|7kPi9 zT!t+iZr2Of%x=4=!2zf8_hY^idvh4z>VZHaDq>9y%UI6GB&`Z(=}2;%3VlO+e?6hQ zqho0x{jH&fM(151aJeinAeV#Boj>o@`RPzhM}6^VmQZP7TH3fea#cxu} z{EZ^6Ol9m4cCHx!XsF1<{}D8o`=PqskE7xdIwz!-uLm~c0OBmBt<5e-bt)6n8El%` zQ~gr%b7p+q9rp}SuiMOyW|sGIU=T%$>Xcv$E>WrJz2?Rv+C_atcUNxa(QRKPbDyFZ zSh>AWEGanufgG2G``l>>l!p%ePGY-!xfLJ0%S(<<+2n41+Kib)+thICrr4U{siM${ zb>J`cZ?+z{$~((#N`Jbi&^qqenXAeA-kI+difsB~*?w$IDv!Gn)4I);ypM;1Lmm4i zwTv$464SQ`<6a3b*3#8=`j{m+YU{-z7uPS3a#86aT{&eqwz{fXt}2!RRPkAD_K|SW8Ve z(^6NbkB*!Dkz?eiIz^w_(XBHrbpHH#voujUhvk@pch5am$2PTDk%}5>YW9)L^XsBn zMH`E^)6Q^JC#+|VyY`y_&zU*3@dSx!r=e!4G@;GIqx;wn5)Oz|2fsQz5ub$MB(ga% z@g4ghw$L;lvkqM(1KG!l*F7sMF9TT5?J&E@dgx0M%hiZ7h7f6`^_@ zvJ^8>fI*GBrz9AJGb+zcxF#~U!gUrT7D#1VD=US>x%-84zq+ypdNH5dg0E`p~WBt|`^-OGgA$SZ>6mwT^o#z?@ zC<-w5H8C2RnuP`3+Cxo-9Z(wG3d72#QS~WEq<30enZ@^4vhRJdyGX8C_7d=ytaht? zgA%b;RC$;EWUw6Oz!W=<8eiYXqh}>}+dO)xUlFo~Gh! z`<{wu8G1oIc6IPh`phPpbunGRr(Zs2CK=1O`|!^9;Pw&vG-4ol@`lQkz2+EXefx64 z)l4_aghcp@)M$~SqT)`dc|%<@iLJSrS>^*98;x{sHoGxNTn!f9)LIeOG( z#Y(g=wsB2f$@2_^uz_;vq{1zwTFj0zTG%gUYA*5{)KLo!_lYji3+{)@;`qAB(mWY8 zfe6I(7;drITgitG?iBJ?D$<{#($vz5LmsqkQm2tE7~)hhM_$sBQJ$AQIX~+ zB~+^$40NVrK?qXgt6&t~0a;q1a9d~kD8!}8DSgo_jWNDV6EW6-jrCVkJMv$=IE>3K zof#7vnBktZCMusd4VxFa+B13VhT%fjZ;zJB3+5cSIz9OzcCBlu;4mmvq>HI7hDNQa zK3Q9=Ue(n)&4?A=*~FDq5*uW4+pqaK&>XuZA z#NwBd7ZRTgp4CT#Ke*8G)ESG*MW$q){(gK6%eyJb`Vu|7F?W6<@ z_`2;WC&9pCaSQA@L^tDdV7G#pyxBa3cjKpP38+^M3zus&2i7d6*&75+z)m&@TF{mI ztw7{gfypuyQ{&l8^DDapM9XCWgKal?c~SWkb+}q)0EB^;k1rM{hIU_Tu|FLOq33e} zRtZ7f)bRm-u7aoR%VbiP9vcAQZ2{1@x&24`fvFNmOuq3$sIunCe?w9sXRZ@+kOc^I z4F^nG^{tk>JGZ(;Yh?@6c7s}bDdWmxtShP~gPrP;8Q0sql=lQ3D=vJovW`3(_c~f& zT>&<-+pSDIN zxw$8KacIivW5b`qdFTW}p0Ctbt8R}n0W4p83s<`7>D7GmcF{bOhNz7Q)d8~5IM~Q; zE?%>D!+|U!``wfrs0C5z#&44`;R}_t_uDnT6W-7Hv7;uZs3Lc~Lx*wa+K#TI>JB!3 zB&59|HzOk_=j3)--#Ox8)Lk zw6(W+T7|I&6_vHuIM1TS-Z{@U-V`o)q_DRb&<+r z>s+j5jZ=Ji1dWwwYk+g8YH2Z=#!2Uq%;J)E+=bqDW@s^z+Fo*>zhRg9qpM=2zy`5S zYAXhz+t|+b+)j_Ce$0*+q<#(=`a6oj!izGw$;SS>h(vq`AotrvH+oV>e0?2jQ>vKg zGTctoJBA)^vg&qS?lg6tEsS<;xtbx_Pdbn!fmY^6ggNB_R@H ztSlc<=85$=^P#3nq3T|II#=a>jTPG>)ctivXvDfp^WCWCmkZ@qSWkUPCxad!M0df| z_D_V3IYe^linO^f=&Wwj78krWFg}+K=|TN2f zdrc5D@@heN&H)iaOS>^4RBuIUYd#TEASBaQv}{;Ppu(a#U^r~Ab2ch5W9Qxzn1_MH zO0IBc6bZL%jDPka-RX=`mX^w&nws*mWgoOw<{Wf%P*x@tuV8qPr)2yLU}0GW!F4=KvtUpLM^jvyK|Hfnx)RdEke4? z8m&07Ty}iSe4!g{-E<_~+ESH`G5+Ca8!%Wgw$0}o@*`8`I2Q!0tzS3KT7HY)Ffl0o zjf#npp-26+%829ee=yGWDqPA~3R<>J5Y-LvTAOLRVAESWIwKY+`g>v^QGYcrZ2MBx z!msl6xKP}e%8%LBKJi{c^aFQdD2@mruf9?lnvn)U&aBMHm29}T`@T)!_bEb|vQ$bZ zn-Ppb_{18o@Ma8f59E1cl$RndFR-!U4G zAo#ibc0Q^>p<$z-o4lWoB~|Icg9k1ZLgmgAq|#|g!sPv`hJ!jouKizqNU65JtadXM z1g?g3L@gw^V`kZAD3QyGkZwdbCyDJmL%B1RIWl~mLl6g6-G`wkPSg{aR!N0qxB-F- zVp)cF?~MpaI3X{ZuUS&L4m}z*vpW>1a7(!7Z1K1wrg2hOA|w^tTF|XWzc0L#94qwFh&V*ZaoO!#| z&V!mSnZn#e0`~p7%0+Q{xyG_~yx74{&%y;}0Tpo8EL|X@*{Wo%-)%0^dMFTi<Xt9XY`6wiL7ak!ZR*c$6XqA-5i{=zwH22=C5&A>f7kRyTDa`QTw?`-Dg*m@h zM}=ki)r!caL-pcuLoSA&pFb-rGgEKwx{{{ZtFd#AkVaTwV-MvPufFRzYn*QBfn|&> zA69+ug+e zNDDD4jF0d6@uT=dtyvkv7u3g(A2sA+wmzI|T9E`DI}+FVLT7r^;tRg^p}GdAx4^@# zyV$l5y_^o*q9zTw1QUPT3-KjXzq$J%3tWi-H_`h(V*N#TKc3|@5qtB)&IGNU8g1xx zv33^eJYEZ^^7J$dTbY|*I~ijdAmhv0pO3kKN}g_ZAG=8SnFiV`w&1BbgL7hMI(kkx za(f~ct#2g4&6;K^HfBX^cIsKPB3e9V?ayMb5fwFXlqxjF zID><@GGeubEb9_@o!x1CI4))jkZ`fCSz<=gkcPQCMU2l~7eC~{-7Q%vpIS5SRVrUy^wo(2sM z=!cBawBQairyhn$9|5(@v~AsP9glIVV^Aa(i==-jD0RTQ3ZKqwk|Aga`lukC@erD2 z3xtdy$nUGr&n;~zTs?O7(%0|Hs}8#Actx^sYrROsYD?bTB2ErRX7rdgw3r=RxY^~n zL`G*_pyNBC=y2QRv|45k+q9RI@ms&mYWH_q%o^X@+HyPMO+qWiLbAl8+PfVq^13S` zCePPZ;ClP7O~63YtC6Z*{y!~Y~v6Te+@cM|lE~gvgm0EfCmo{katVqT-aV-Ppsag*{*%9}WziuSSg2t4Y zW7qu9mvEx=J|`@@>lPH?!dCftd1W8p=Eyj#%ek1eU`k?G`fIW7L{o+)QjW4$!Tmx) zQ9)>%%{wcBGUpuJxY_O*Bl^x{TI1>GI4@^^ zt1p`dw4o1*+A8ykp?H^8l$f;%V61RT4!z$KRzkyq5X~e(m0w7bS%Z!?Tqtagq6V+jPY%` zt@_+dfeS>#P&?Y*)R8pM+Kn#n7CwtOdin}JoV}A0!DZMzknR#;eP3Jj*wv=3>!C86 zSGMAc^(p!r1EKJA5xP~w7>SXlm`9bWaw3=;Lo-n0E-8%eUf~LrX>7O>4b~o~(&KJf z9KAzb)KOmHD=N`6r-(Hr(v@b-b@%!18fBu7uU?5(L{G*wrUhRGf211?^NNrY9R(Ee z9;{4?2Xk3MWnM2#E=dg`SucAU+U%DV22?M0eCchn2q{5L_uKa5?DerN+B1izX4i~G zUS*^d#YNhfI)*cU(6_5&Sd3|LzhWeumTg-2fQR)nN9CrSz|;rjM9Y~UITD_L8gB?! z7LBp`Vi?iDkP`$cYaqV2Wle+u*p)|mdV1YjSy6{(xZ6xYwBDm?3a-0VPhJhhybWij z2Sh`Tl~!5#GDg>K8aXr7yIO*Bv)~x1EAXM3_j*(JYdzLeNv9A&UOLYQ@8g%Gs zjUrU3V3P2VnQ9Bp^Z~M|zEE0MMrzI>>^-G&pSqz08RE<}QP;&C95Z&y%pK6*9v$lUk zFS)f{TyKOie=y)sC1Zzsa;9s)tHEc9oSU~*i!s;GX@!WJ^~{bl*zNYMj7U))0H0i6t5f!*g=u|C z2HQ}9WDL+woT$?_OJD$N+)#2AqdkNyDbcp6SQ{_I^*53fb9${c2*gwZ#VGAZY}q#} zLjinvwfY{l0kz47!ub`j?zO;j>Kli7VL2#NvsH8>>sG#N#yYF`#{65t%irPtL_$3No^ zwBqe@zxYs$p-Q3Eysd8g*veCL-@>9&Pe9=qet@yMR|mdQgsw`BW=hiL&_o|Ot1oiw z0}8cWhUpPj5WS*y<4VKlIBmqZ?SyM;#QTEn`;Uj3UTIGkhKzI4z>MLOOS63&zm8mV z87x=8nStHi5^mu(tBvt((=EUZKx)i$MX21pq=Jdo?E$h2x~>X(P=Qq1h*~3gl18?i z=11M#y&`jvqb$8Hobl3(YyS*wZm?e_PB_aHctKu@M?RuZi9qxz5GB`zndOgWp@9m{ zWq{qM=>FErTVnUf_J9}YxSZ`b1%pwKQq!%mrW#9Q>4onVVrbt<2hW;n4V76##j1`r zq8sy_d=Ra(5Y3VeVe$5~*!oYplJQu}(H5`mJQ(g)4-r`$?qfa_OmD5?o1ofxrZ1Ua z0jtcjj#h_bqP%=(d!x<`Zghi00;-=wK6Q7tIMoJAq4q)VsIFO(xUd2Q7XVE$QoTqs z&?-g=(Z%Np_uMW*{o?Y%Bv?@<``3B}LL)%%+oLio?zt&$OUfiI^k#2@#g|GUDd~xg z^$q!r;X9?cC#C+S%X!;g0ku-5T|IyM0EHZS0E-!-`Z?(LDnqZUoNco^^dJH8C_WXc zpf^9_eE?umq=U(1ZA#$v6;_4kqVf&PM$tAlh60=+)^LVJflMqldH~TqN$sc5w_bRA zlgR^;7KU)Ye3$?Su>7Rg6%h|Q`5+x z^Pqt?pn*8s_tDxz*8z9(+V8b*R81c_m*S^c4&*Xx+77@p@@yeOT;FXFnP^kxCyFdv zK->5?Oi#_?4@|R;_r@qOBi+d+^tR~Rh}SMM~Y-qB0m;W4N5wjl*b~>-qc%7s$NEJtw z)uvUOT4<_Q{@8JG1qK#tDO|&~N}RN2eHimOirF2uShxf||HB9y^g|wHTDk!IKPsjCSkmzRrxuF{1H-UH3L1_+KvQKhqC(3`(rVz-yBlYAhh z@T!{B_(qiawFPPup1}%dMnyB^hDpJ}-d;4uGd}lO?6%ZBQ8^F-`aM|>326>c?4p*eQwCb@B}u8CQ$IlaH?d)>5vsK_>M(Fv;LIBhp5c5Q&qd7VJ{ zBJQRkG{?Pui{Yf4R71`X5a%ELdOwFjF5PJ&f+e*%Gb6)t!=8+Tkc`O|JlL4Xw(+G$ z@BwjY&@aUdTPP54?OlN#m8xzrc1zlazumWF1=@kj zFfuKmtRH|i8whFYN6uyg@k&BeS?xD1!GfvF2muX?#{#QC&$Jr7eJ028A01T?+_l7+DVX+LW-c zv>XG!V(o0ItJOV#FYVwexe_K!{cZ96(dx|CQ&W!pt`jkwG5PvY(3{t@Y7Q%1pHim0 zG5)wej(IcYhoWKnaIBb89>MG@?q(UAa&tSTuFu$!V6ntr)s9ucZ;pLSoQ96PUpFiK z2!M96NCn-WrX({)hfeEtfwB_!*=s(f9TR=jvz8l~kv+{K?J?FDs{6i2PXpE=hR>rb zhEr708cvzl`yt?Gn$QkjZyp45#S268O{^D9g6cnHW$_#Gjp50g#6JAMQ$SDxbztaI zpo|6NC3U#6=*`IoNY0P&XHw6@DmSqhW0qt`%Dd77Zx#EDNUnhEHLO5ItlL-)J<95U zF(~IHN2QR<9!*V6&KpIVjVt%Wdt7bLvp2*-{PC1RfU@5h{7|V|qFM7Pp_`I|tdM5f z_Q~byFfSiMtmR@Jw_wWpwdC0OPXcK+Rt&}@o`PI7d6_V^c}Uif_0)w;PU+Db5q6?Zz7+0EgMGSLQL7tW4Dw!6@}(A15_ zF<5(<_uftHs=S>!OGH;}q)p{|XBHP_tDyV?xb=g}sOFd}0KK>G0!fIrfOL3*_K z_Bn7uOnLfEw7Df?zrX&khdxb^>LIHV`#1zlQmn*H{5%xmMkAWP4 z_~ak<05W!Rz$MAOQA#2vmj%Bbnmn1Ni*KXLq;@22@mnILJG;8#o?%`0ni?Tmcpx+b zZD|_sy2UhQvHgW_-SNRE%o<-``;eR4mKiT!u`=N0C4f`NJB+B6q~FWD3>DZ8N_Ie2(@U}ulqYYzT_5KrEKMWJoKB@h!Dz@i3yKV%-tw|0y2 zYh1c4JcpkBnS1N9E52>!{q*S9kpQHh&|H}Tv^ux1caB$i z9~v7D;A}Rd%J%_+3t*6Ry35wu*PWoLJ_pq6N778;mmlo);B<(ruzV8-Fa0_cGlRBa z7Y7aMhn3X3ZPtkn!v|W?s>{lp7lU_{EVm9Bo^wP^3tmmp(l`HN{aoZh*RR!22h}Spl;@!p;)h914^rGX@#VAwtb7PQIt=04C0* z(bq4J?}7HM@Ir7|Oj_Rf2InjwC<~VgFsqoZt|E^UY+6){yYO$~ zO1x?TY|*(wVY~#@aIkXdk`9;ne{eNIU64TbxA(p80;=x=c<|dA^>&kE-$p~9&*tun zf93=>00XU^BTM*5kdRW4!1(KV##@Jp9n|i^l}(FZPb>ePLjfMyi9c?HZ*QLo=-?~l zh&3Y?8szdjh+)1Rxgt&gZyE-q1JMqmD&mb2GC9f^h1q zIwRo0@#o?x9c=m0#0imj|DP~NC4{^AI^8Z2NQ$x;<}sK+({J0rQm;#qT;LdbkG()M zhi}E;gy)niUIrC}Wr?R{JpEBYj)iT<4FLEx45=UQ5kV zMlJ^80FFI)|IZu%bw3knapUh)0W9fQn>^>tqf(wH;&+G|*KEe)i#lLJjTRKH(Anb> zy?ao=6hd&XzPeG%Y0AdPX|$mv;CkxuTk9Gu)-A0EAHE*BJ~~-_KL_S;RiyKo!HLQ+yf5h2G&CIG466$xCm=Qk#5=ns3x_0)J81N0e$z4XYq-4lTXA~ua^8!; zx7kJK*Sk-3q;o;$x%iA`B$vu%rP~bOY4-GeK8@xzIe7>?ENHATp-TlK<_$f9a1l>a zw2k0-E0!Gfe;v%x->TdwoJKo;+8gE|u8v=AWGFDM7NKs%?iG~} zoJss@dqc>`eE7%r-YJIoFFgYdRpNbmM!n<{9t7DMOdA@V%E*GKBZ}`t3$B6(FsoYg zd)Ry$76M_ffO?s*BLr&z&xjI}*SSgakf3bgh>Z-f-{JCh<>UF|ed%kc6K91@v$LKENkc|CcA_Snqb%(v(;dnIo(puAysT}P8 zeMs=?^GNc$o?M9C)9@BpIZp5V6y(MP?tLaa%WtFC(SAjYu!k`5@f0&)adHfebEcug zRZG3QTEB<`E&Q~+@$}Ec4d4Kb`GnpgBThSDyZMQl>g~GZleId9UEkw}hSH8!KrKVM zFo0&jv^R3UOXOR-+P8r0h_J{4&SA60hcT-;lQ3I!5GeOa`05zPlOqcxFhnX!@C#h4qu$*MrX$`~Y=Hnum#$GoqS%-3A1xy_pNIwon18)J+gm=RG5N`dnGs(NCd zmN(XXa~nZfJQk%p3MGscvpaKW)P;&#n5BPO|+#2gK*JT z$8KcqnO0-gDqNsdYVis0MLcju)JQSSgsJMh*Vz+~{ZvgoUp&YrrohWM8P9IsWj*pb z{9!%zjX0U(30Z$xk9UCe7+tRMj8En3?zou{{)36Oqk&;B$o@ioX|nU+lr;L&kX{vg zCM@`MmrW633r?AnDpVldX|>zzlE7-OJ+ANg%w-ijZ@4+EK9<*V^HC#gwSU-=TL<=* zO)djcBzl^vO?VSeiun3W`X{ji1FRdu_lgLD#unA7cK+Q%l7pw^G9j07+nz0AJML$> zjAe2p-iQ&BT*0JD{@?TE+& z;_34HTg7{1YVVMv^X_!Uhi(-UlivW}g$S7>@K!xKUt`GPy54l_$y!X{sjgiHili(& z`%*xy*LypzjK0Q?{0795QdOBw+!_7uSvwB;t5mn^f`xabPgYA`g*!e@L_nMZQMr*4 zp26Awn@+eGArrWE*82wi?hG&Qc*1=~F@M4zMsa-4(0#(EOn({0KBjw&;)`EhUheUp zz1{H(HVn&u_CK^@mk~2nLhUDOXGgzZ-i=MXZ{h>W0du5Rh=mvAKv8pEI~zVzK~4y! z*nI|_^|UgxqX)QmA}P`*L3>LF;%W=O9HDa2|5iqAH$^B$w{MbM6(ike2H&87JgDX; zTr6Qis~Y3~2nIpHeH}lOUnuAiJ221hmGlPYDp4@)&h;12h7zY2O*wYWk2uXJSSjMQ z1E)j@h=35Kc|bi@l7)GDaItn;;#7X;Ot1t#L{#%ShjED1ge7LrE{K9V6o&e92&z6w5OT459KaqI8?dA~S>m;ANRFhppG)M}C8$+hlZ90lcfFT%z zqx^I-o){r>x)_=sW5}X@iw(GaD;i=)vBQ7vgtfzm4JEI5Txmnf!Fc^b7N7EN1)aQv zzRa5OBqqs(x0inRa<-5wD!RIE$tKz`bpVxam;h8NF1t~gOn~lG0ppJz4sWnn|4HGN z^FrX=yKaUPdhgNMTP466ERls^5q`<=3&bZ_m@kKbS4%2^pnTjcMB4Yqt~&T%hWNIV z)=u_g*3cK<1}OGxyh2SL@-8Fpg>jYmxshJFV)pv0ZDl-4bbHp|xg>1O<+DtmC6oQY zru+LTY7vv`!q(gmXgA~lYoM23ygT8A#(%dR)ue4Jm)`PzalaW6bRRuRe$89Uz*TA% zw!bhlAG5<_RtntF41ETU`{v;%_8hYioP%ewpe2*=E3Z!zgD>IVCO&CHsA}YS>n@q> zZe+DGSd+{k559|%0 zwWQw>?>0ETtXpTu4iXSS)K+;npC|qZY|lk9^Ie7`%@Up%e+g32Y3mksu7Pz-(J0LG zB=NAJC)4-VGW5`ZPB@3xQ@H=m2(loIB)=uspXfagPT6ai&m96__&|aGix*j>y^Aem zrOi<{dUp7D*kt>Ad8oE5wuuJPgedQ3UZ6cJFbQ>)Ul*KILW}1Ed@B=z-)v&A5o~l) z@x>;xNcfKfX{8NI6rk~)yNp8T$}BP+S0$N+PO?m)Zlr9(eG zm6A6A3AGCw+1jk!%8?Q4I`}N$p{ZoYo|KpH2S5ZjVng^AI%n+u@8pz-^TEHis1xTN zz;V~Uld#(T!)i)!glsK18{DefRQmgR7!arWOXcTD?-N7@E<;2mFq{Fq)t{R=Cm3We zwD%R_hz!`AddJba^WH&_$6OP_(-&$ zFkPitpfJ16_|}m9461^`5lOxG?SS~OjfLjzM)_?1H<7)yOG?4oZ=aQ26sPgRhhAo~ z@^EJ+XiwGgqX*aE@G2a^@8Uti9#Sx&<)8?azB|W| zSoP$~+LVk@;>Rp*67U1;l|3lb!$79*|VMo*z4Odo@aEWYXudM7nO4%wiD=TDP zm8`5XvPHPbD0`F4Y|0*Gh7gkM_j^)zcRla>dH=cZ?&tG#Ug!B6-+6qGgVyTjmm`jDG?@O#PD7sySEo!-hXX_Q(o=s1IR5Fm!{dvuGBV_Y z02!E6Cnke}xq7ayzP@M2ZKLN(S2})86RSW@^ahFa32a&*Bb9~y8Aer$qD~ z;l7v}5`W|r^pK|t&JPylC?<&L9XfGV_dWmTOksS$98Ms#D?s~Gfb)yW#Kk}4C+kxb z?CG19|KIbWH@=LmxVOrwqkQ(stTTX|>|k85*}80A^ZoVDndNv;=*BpWxTFDzTTj9d zLXd>z{|>{1eOL5P8|@2jicN!WG<*a>$6h99d=7~KkKILS7<)Xr(}CKXXHWe6Gh^Hk zItxsLc9WDGcm(u!di9)|UglIrk8D*zAKml$#tXgu{j6bz5b9OX8CyC)mt8GRHHW9j zv%!PYWxRHTh#}h$-FN?u%3u)Md$ilX8n}0eA8snDT+RA&`Xe)*9T8|{V})TzZ+<~l zz7=K;1139;?pqNWRbF^y#+c^}YIwO&r;gwuCC3nnK+N;@&#W8=?;bNalwIG(lAXKK zfv4#;(v;`TyN80sVybTiUt$32TP5<69>?KbuU{-LoP=-^qyB#<@gJ!4Sz^^Q>PKf_ zW+^2#bvW4nG;y4ij3MxacXf1x#CNb|&&3nR0SU{#iQIzc((R_^`-=5}jq!HJ^P`4g zX$Yh4{TW6j5`Yab&F_)Xw|p^DRh>2%e5_d&Tz%F!p?{PdG0d&E$JvC66W(m=wW^5!qq^#BWywbu!^&YkoW!^h);BdQqh-1mk~ltZa|ec3?Qo@(}@c_@AQnBUb(E8l)!&> z+wZ=DOS;((m(*P=DdeZLgaCX9oy-MxnZ%>Wu+|%zr#IKZ(il|UqJGp8m2l$}{ms3% zL1iG-w~U^RnQuQ}qIGW?UiB?Q_JJdAkf8vs;7c54S$NS4dczgyMAakvG{smkWEVQ# zUcQ40gF3d3T;B`{b_@m2KVy1tCLY$w)q3b>%|pK0HuiM;3fYT*mRJD|03{wH!KESq zU124J96rti*5^jhc&68JoF(Ez=D)B2`^P_*91P}nO2t}A%^yI}~)Pdiy?O!wuj&R~yo2M--Z-I;i($&5v!1-tP;K9kwXddFeO^syv^ z|I5t+FbNX($+N@FYVz?qAc%&Wb?N8L3WiKG(zo%$OjaDs^yRjTY)+&RYx_N{Cgdom z0YA8?Tw<2xdBwnB_oeJPxs&^Ll0*x9mDHg$Av_7lH`(wWNcw^nG}yL!B^F( zrtb0X07niq$;d&qMX7!5*L;}nsm45FY>GnUJGfmDGyV#Cz1tMOh)g;zL7d~z9#}@? zn+q`@V=#M3cm?=bV^MtEW7S(n_oj2;EyPgZXS2ydAARevxP99QCRJ%$d_z{~J32aO zfFij0{g42lh@RwlnC(;cVC_g?wFQC%1?W0Tz=oNipm_xalbQ#V*!Ry8(5EET_mTiq zEEFGa3AgLSpX~$0=49Wk;A6VwcvqaUkcz7SRaJ?GOoXx0-7}_X5>}t+l72enBziDq zW`XDXX+lnbtzTDtaSRWa85UgZ@S|5xpdiDr7abhH^+p5cgX)G>4*`1pag`4s6Lf(L zT=$u>IZp_#)39S?IS`T0ymkjA>p~dyZ^s^uPTb!rR1^dt61;{F1H{m9>Pc~;*ohd! zVQEsHq>Wm_qW3e}{v?GMCVmF=^oih2ILJaTZ?m0o=n&syGlp_%S?>iWZ;6jUJ`oAg zh{4FcxvX!_qX6o|Yp@+TDuuz@XMPYvA=SM5;uuLhf5@M+8b3Pth+TxL0!J#Z`y_Mq zR?F4LbNlt$MkTle9w4vi1PMi}=QJFeINfz#Xwnazo|sidA^b!z7sv=u9t(09#N`0j zyj^b`srTK3@g%M6{)v^qzygLGCAoo7{SSKxEa2<984hv?Z`rjG$PBXcYq0Z`T9R$w zi#niEr>~&Zq#gQQEl$4zq zO%)Pk&Ba516hK- zOZ5DtZ^QVi_T0d?MA-ITqa`co@;ra%VU-z!$KF6u&TnMCM87K4YsG1;YIxB{?fO5#sPD$8D0O zY5u&^pj8nk8G*_yXr_7C=`@8?V?5`9=OZ@$#Scr{3w+mcSY95q1$dw=}8 zuC@d0eP`3mKItU(E)ro_=xyJGt4j2PO(vb)fUBkx4EGrI>y+Q#*1bRQIN5l?+rMv+3SQA*K0&V*E%PXFue78k>ov zTK;|k^5>v7h!!6HS@SrC9T*t+6k!|(@_eL2*-_D_IE{SIKqiMw%=@m7mJ5=@`9o!?|WC=yo1X5xW z7VlCN2M>XNBSmfh-V!kH)o9e;WqNQ)6<1O@7J}z*1kUj%QpIl`946;ZeZ>v*Jz=bc z6#!GpHBm|<>@5VSHmH4yB1M~;C)Bq49{|NLh_ZV_&)eV$LX=(q<^N&tj9G{R>ZG+J z!iVmwOEL>R=yMu%AN0TDx)8NgT-+#V-S_HwR^N9ZZE^}X&Ffe0S}BLqWLTHsd)BRwgS%lD_yd+V4V+9i@d@WI2(Q+-$aXOgXz=$oy|p#w>~FStfkD`9u9)v%q?NN(`z|ec?ncN$`&hG0Hyu}sF1h@ zPeuC5*5qbB9Out5btQ(0x_zVc3HlWA7>uXlqPRsxK5*Bhj`ORe?6Suo>-N~f+&n5P z>~sR{#_3*1V((^uP*4(8G2Yp8rABm1ep=9>zUHFZjXGU=zv z2&D)>4ljFixY4c$Gu65;1sH?@^4QqkqBCc`L3AgSH8<*J%=$Fcdds-^_)IAq5)@x6 zF@^v0@}*AHyb^+f+`F80U_~01g>Af{9sRr^Sn36&TnX!*y&qPNLGd3Qs)gwix*XH4 z6Twq&dnSjUqKgn0MRFP3)5S0-{+&GHuv%}B^y)Ji_61aG{eFJ?H-sRwW~Ds3C;ZMW zyQX4;Dvu_KA$`|*dO%<~<(@M2&}`|2XyJ)B&q_P=G@tH{!QU3Ti5L7Vp}2 z=6B;}nk|p41A8R>?)>g(dP2(XX2R}P8q`SAg>FQ<>hsp|W;rH74R~pRx5j z!SUH}i7(QXJU;tkZ56Yu0i-<5-`w67&M*2mUWGxClRMX7vbhC_yz1JYoQ2)~ms=Cz zy^}_G?}SKUuf>1*0RzZC&NHSccW6^%Fd#ZbNZWgz1;gRn7=XzI(#|^CcAtHa1`(qL zwr8F;XMsSRX;oBvZgD-Q`CH!cff8=_!FSmk<7<#w9tX4g>D2io$wVDo65i6fdL^lo z;1`cXTmKAmv0_$M^KSrOLl%04wr$Hb!RygZgzvL?x&%IN-u4xJ1UpEH6Bz!Bt1yug z63L@xdaH#teAew#5k)%J%BodYxD~U2w(;4%gI0da|bxF z&cY&+7Tcs~imZaO06g?A*$#-UpOa4~)t)1bFy8(^GH|BBoZ0TE!>?nCpcjM~FxJ@8 zLcQKB4%IBUbMF#@<{-Z5=%LlLrkOk~8BqG3F zCrf-4YNIyLoCcNDgy{VJ1o-FG-FuaFsH&P)_2i9+M5YyvT3i~ma*Q8Hrhs7wq?&)= zH~}qf2nP-U<@%EsaS|x#**uqz`S}g|mlb&!Ff$Jp=Ac7&-)Y2%I_a&Qcex#40x`~i zOO}k56PH7I3Fu)b!&v8kM%};PM6428SnKL@8AW>c`le*EUJmOo+z=W9s#hEc$jQFq zV1)7RVPKce-y6~~gI#*=ZN9%tzn23CZy9Ma0FR2#CCfQMfRuf?L5Vzq78*lj_mQ-y zlm#A9W;b;0C_Dl&LI3^RduRC`Gq}9Uq%iHyr+4#vZq3fk?G8NUEe6fb8XzBLJ2NgB zhH?P7w{%foak?zT?ilgzU$lPvz5rR5Z`UCe*+qxim-Tn(_BvMewz`%;+gAb!mG@eN z6Ywo`3UfQ$55;BP_u(^6imNwO)A*Yb8 zGWx%p`x3k)kl`c?j5x*4l?G2bpNORM67xl3Bb1s7}SpXNB=|4Bl!$p z_2H?=Q+U_L{B?+M@NXTZIj%9i8{78ng~_w1h4`72j7^>Px5+m$+FaVFNm5-#MW+AV zI9Ne1peroXl+1Wy_8x}K0s(bRf}nQBV(g`LA;;kLH_N@ue`N#)N>BfnGkbr{yqL>Hgl-BY z{!jt-K%{c|KYtmAVv0Uex9e8X@ZGsyDB1(l+);e=SquFH2lFidPDSt1Ln@;a~LMsWs%L+^4Bt6o_1rls3Vto_!3N`eEx zm3o5PX}f2;dx5lP5~xLdce{5N{YEV|+f_ujukc!N%2YYdY`pY+Z=N*=qhC9HDP+#S zh_&{A7}*%y^I{%!cQho#P$UTYB`NmqAw7g{)ZaL@j90nAwsPJ@-_icHm4jdwtd~sX zQlL#EFxWEz(lo-xV)iRWbX0g) zSZ#piR4*V~$E6CPp7CPYtZi`}ro$!?b{ogJo;uH{n?o?Lq8>PIuJKSq{sX`YBQ@N8 zH-CTY&p*)=;ZE=gt};}G4)%tQ5cL5Dn34k@7ayspd7bAAd@c}_S2gY8cXRMax^O8% zM-79<e!!H#7GNRzx!3PL!v*TYBA7MIRKCk4`X8G4pBH-p_EfetcuV@W@{qR}JGhWZ zb*Qa0zJ`xJ^I*E93<7Ct5URSu#3Lnn&xxcBV*U^6pr0sb=Z668Q&4MAU~`bpRkCpR z>Dl-WP0n)c|6Xh(O}N;-mzr!GhJ((d8xb~W#oJwExHw=($zC04Qs;+wo%*&`1XE!Y z8~tWsZ=gWhJfLNLb1b=b+djPZ5+H8NeCP^A`myP^j(6PIF(&v!R9q%4*B_k!S^oNM zMI2P%$JVw6M3g+}^5XL!i3!3{?dlxU|LN_CBTS0nsB+}Ry;x5P+qmZ%eB!L|_2ang#rnb<%)3K|N-lf90|Mb*Nuh;Yx1W;I9XM z0k}S{2N$c$U?pY<)?ymwi{5Bk4DS=afs6+ltE{X)joDxmbagc(AV z5Y*Z!r6z)=aCLo}C+yDf{tT`E{S6wT>p07lB?+hDAAD&IV}SqDj9qE_CjjZKd{W9E z=bye8Pfi@_K0rAP9A9JjMWJ*uWFsFBUPy{G@DR}Vas>u-A^)jM&ACZI<3p5QcaHqa zivQEzW5ozUMjIFN;U77o737u3>nGfjzFv#mbkpVJ&d-Kf1#}qlLcR=8YO5~_J9F`- zke!c*H75{heRk&G|(&ijS|+r~lrae#8>9^=B6-cqCg`3ww(p z92rdye+b~xB2zG9O)K7K{Ump~No*yJt`DMNn2lBcju6oL5#D-5OIZiHiewzs$V~CP z)J_CbM9=&8L)5u9(CmNz4h1>_8YKymhJ)WK!xVJw1W&3H>vEYWD-rG^=vn>| zmWh>tg{oP(88V7$*F~GZf_sGT>fw7FYYma%9GQVWb)nU!1Nx#=QCviBAO#nLzQY`x zc>P;1R(cRUu|V=s&CKhaXIm{WCmr?HXor58qF+%LBN^=erx1d z7r8^dxeX99#Z21~F8`tQ-naC3!2Y2cgdNG~*8{({)6(rDoDqko1+jmGlWdt4SRuBY5XaI@;0z zu!pvV2tE@&(y@kg-pWSgbK-+BsUlF_Nqc{s4`0I&Z2Z#LAavXZ^u6o>Gt2lal=vrZ z`1jVQ6N331W`6ASWE3@?iMFqV513Sl_dqvdVTaDpIOP$-7{tlYmF-rT3l^%(nt++Q z&ek3mVOd~fL%~T_Vr09$NV;B$e(6lGh}60hSuOW*0#{@*2r(v zN9hwaBAor@uhQP9kMp|&!eK!}e!F_N8t|xyG6?6LkJVuVpHlDaq3=OcPED)GTJL3b zxVq=eaM@ZDwCA^3b?GqLe|jP8O){D)wb(ork7WMoIJGngaM&DK79?pLV9D+a7z45G znOD$ys>9g%iq;^&F@VirfLHv@(b#`DF^0z(;zd0x5$ft0NN*;+zJn+# zyz?hz86e!i1#yGpy=K1u%AxI>;KUI8MjMjlFL!M$C-_RI8@j#eA;ft#^|X_wLmuq> z1$|$LE>qNJdkQ-hqq*gd3xBOP#FHa&A-!JdRsuo?nH8t90kYTNaxAFruk|1zLN8O6 zA8NvDv^hsSHeCm?Mb>qbXj?KQiri9x?E-ocHY>Uk5VJDQsrdfR(@T=*)E-vvEXaGs zjdf}p00ZXAN;RH5&0j}U3hr_8=hX7%gA7%j#)4;AX&FnpwNjn#flC`bcl=4%SsM((^l)&<#6i=(6h{&~=6;YIlP z?w*b`*7AXHG2`Q*7O&r?V((7?_w=B9r9u3oy3q#D!yk1a06B=h3f-s)WCq5=gywXh zhm6Ix<=_a&sWAgtLYs=}x6{m6j;bwnleX9rjh6W7dC^<-kBcODPTl{H`V2v9>t8?iqwpb-s~d5 z6-TbuAjRGy41@f%0w%YpY8uhHIxh0#wY3!Vn?cttD}<&A2y!@ON-WKUipipNWH` z-HPU$rYbHRs%T;0Kgz0qQLy6Ou+z=i1Kw#aMW-%Eg1gJ@B>u<$fyI+&VE(xJ`*J=@=bs45gcVub~wZ7DK@pq>s2U zXdv1M_2~e>B4>=qFzm1A_9KQ&NpCAciMjls_#m4l7O|J9P3k zJo|aP$bFead-zko`(@}zFk-6K);NtCiK2vE?CuJst|pP~0T@?%4QwpF9_)3TCg(Z& z;IGL4^Ak9X?5~$p`M}^f5Qj7zLM(Q}Q?+LoZ}1~4`)jzX4WjIp~jRtd>e z6AbR}d3pVYeBE!jI)#>@2>1blElHD!(Y59-E@~XjJ7$X8w z;3~;LmD&m{K0(M|mzPNPDlAfl`cULCI6(cXDXlaB2O_LtB|3~LD z;|f5O65;YCip%sk5FD2E-(0SioI6bA5EAQAnqFs18=`~tIeSl5-+lF}XIjqc?1#Bx zO6%eqm#yiZ^Zj*kFF+oK>b4~H$OLoe85Cgk5HfnJdI}pguy@T{4ugg6Wxk4X`9noE z1_Ho5n*uzUQHzhs(6X3U=G_d4oZcizjIE8j_<;D`{a;n~U!Ni-0}JoWcmEt%IN3aL z)+pr49+4W@uLyGrT@00-5DizaS}77l#Pcd`G{T{NEk0qZjSDH zObI@x$17z7M%yiM1TDPVZNroj6kK=HqO9*+@P1$6-%~`A2+&YJ+DMuy#UfpFI(n^;>SF#s2o$f8=}gs$=0jC`@V5j0my z?)X~n?7uou`{#&J3{DL`e>y(*Iruksl#~bwi0|y+Uf8MuGZ7KB?s#Tew|!+{sR(fR zX-!}#W226n;bV`Y5cce4AfPC^-ISZTa;Bk#?_g{9-rU&lXh*COuGvF3+<$H@u}W)`5R{93dTuRdD_ zNJza$Wk~{mogSnzg94|R0TzfJg%EnaYNuJE>+pj=EmWN?v?{}#l*{J^Zl)h(Pl4@m z#sg8pdV~);@25xY?A|^)wi5v(s0Ca@q|osA{oe4Whq7?3d>H~%y|)f=i0|Vm5BX8U z25Y$MKmqoZ)=2IYlFm2;%JsTE|R`R#;J7^%!~mGVF$yVPC07v z(lm#0tG4HDknxJ;HHYN6(r&vBo?mc|U+<2m2(Mku@bHd0gtMWXq^2q0jqzOER^{j*k|K@6AKq=s_% z+gTleQ-kviPvSFT;MlvD4C9dsiVN=Nvsg=T?{lTuR)a;pjRk&Wdn#A)uGYPj6YvYH zcc4B416NtImZH$qEiBDQREKy+>& zXwGfvw{|CHi?yw%;JjJuo6XaxftnCE1Y^T#Ga~HSo&dBDniUnHK6gH!{A=+WVDasa zDm!VR;g?7?Pq!jaLDqxa!no^T*m`)jWzQ`G^SdW~{8<1~D8>tySOhMSz>7T-a>_;` zd^WUM)@~6fG|UP=lI;CuYkqFQuaavM5-n#EcZ)wl{NbsvDI(Mp_?>U2bSM2DUob86 zlU=Os1{&*($AG8Vu6M=-RVgF_2N8teAIW_tZTCR*Mk{W*%#Jyd?j8)# zxy%H(0UYuL3*BrY%~4cBvN86`P!#Oy{cx1_oV2U~ta0?C10h z10d|Biyv=Wv#dQ z@@4}Gu@dMDFbr5!vjwUMAt2>y_xy3F?VlT12bI6%XQoxo^~xT}&QpRdbSYoSruymb z;vpmf3iDvWU`Qh>yx0|j-zNYDzEI#(LI{;~K)%R8+>zM7C z=|LbYn66quB%`qh4>Nc^6Cy%IA%WOrZ`F?D%YOj*P-7cg_0W>>;Xa=9m*E8+FPf@1 zbE=B4+WzK+Zv`{~s1VDSBuzsPKBFnha`3LyxhKW;h(0KyiMsw^2rDLw5946g2%XDT zXK!(~g^vUO!+j{=zmNTzGwcQn!ax!Z3z8JQ&~YrHM(1V52h%CpQuFKp;(B_S1m5`#*gXM?|=r42+@YRhewm^CafZpfOGg**< zS_?AWhscTT6nlaQq~mi+6wY6-4H~WR+9&+gk=IssWjv(xiH)RNG6dzI1nbdNGk6=l zt~r)%J6_)uDs#4<$1)x{98j6dWYx}Zq+T+B@qP6FdiJy_;#x{%U`vb5R_cjh* zawf3B#-F`^8HN~0Mg-Z)3kDwDsM`Mi6wx1c{U{tL=8LybwkYDVIbWoM(UjjlM;1_E zS#dh)`ClhmH6PciDC%65T7Hg1=W$5yI+fiM4=evSp-J;Dx`$4e9l8i(aKLYwTza^z z8)BP}QKs>sbpbm2TARg0$FQn@lufWnGZqANea%pK=S);4Mm@az5js9-d(`X2jYh{|@lU?-jDI{A2k-IzGL!mi zBm1Y~X?Pe!2wrKxtf_+m?BC|2pT(~jzXV`$c<0!wcOFKMW<>OjTeV<0LT z9+%jPTA~RNhjUFuHiE&7F?igY2$gwPY&8s;^RBJtF#uisz!#zy~`0XimTI+>uBL}4XbqT^U7 z1nUDI?B^4OZH~jUcO+H*Owz?{p$V@9+h>3yJqjlK!8KYlICA%S>1rQ{9m2H#XaHBI zG^O~zDm{&XV4{ZjyA{5|qT_i6`LjttNq~3!anV2fq#8$+k3!vX8&sxWr~X4UaJ0uZ z78^h99`<8CH{oEznQfLqEBEPF(;Ekr+&d2NC$GxkGX zV$TVN0LKUT)R*_%3g${3y#@8_|189j+=p+HcqUaJA_opX>ivtX1!O<6Y1-+C46(B3 za<4EsmUGln1Hq$cHLd9-Zh#+=hU%Q8qVn8YvitJ7!KA`KP>kjuTo?lj2UfK%>Jf)t zN7F+*`eT1Jnu)+(>UfD+z|WMU_eItFK~$X+`52Pnt}eE}M<=cf<8!Gy?R0q}i!p=x(0f&n0g(ErTea-w_c-bwbCD>MNwYg8Yq zNgxB)@KcL1?c;|4)NjGu5=%UYg*ui+)@n*6H7Kb#-baCq1Sw`Y$XM%G(71EIe`n!5 zpQO>QRH_ znJouy6cV(%XlQ>yEJt<;B%dEKgv=<=X(W)q&3`PV-k>G@^_T#BP6Y&r__<4c* zsg!tva9`fMM3aEA5|27ECPt%x3ndW2l(5|cX{LI;^Zzu4r!WfIz|Fi3b7>4SLz!2& zbW}$s`P+o_j&Pq2JeyUpqcPUMCp-$`T-n@pTqu&TYS82}0%ldVTk7)e9Ap8PuBtvT z`m+ux76C@Vh~n84RBjMMbdC`*M4ZI6Sg{Daf$U|@VY959f6~)S*c9~crfUrrn))@a zG6`=v8Q`#IkqW@v22rT!xeb2sVaT`^lS305ilnd_fF}@FU}bdh&M++C2S&c~(q*4;|R0CFuh-7Ds4L`mt)rho_zD zCWj3uhzByV6$$2cq?X@b$Z5L>vWOfI4_Pt?Kbnn4rsy~wXRmmjEgb%!oE3%uL83L(%J>PIxlX)6>tFI`r&RGMDCmE7Am6l!JYcO_Y{JG;fBG&2avcO`nF5k>$;I`yF4+(<6;Wk z?~)~$XJ%$9B2$pgRjK?IV~pRLe~5yX`pymgkEIL4-XhlZf0oCLF2miQ&44^D1X|@< zATM_g(4mh2Ak4IL$J{&}CYDsCgU&D^ktJec*wzC;5!ugbkQ0WpoUK1v7;I|GQ!&IV zOq%pM8h`uTNi`C!9DlA;)^vMq_JabF0YN(Du%$3IALyqmyBq~=qaj}*JGv0z!RQ$N z&oD2U%LsXv5eN%0bY3gVc2y-SQz|oWunhtnca-lp#g$KzI1Bx4@d1*UUYK5vElx{H z+9N!8(SP-;jf&=V`N!2HpOpDO;gtZO02#=RJKo~E|VNvpqSwbkMV z=z^tGRszd&nrHz@m*U0d*mP5WtH&&wTU|4@_A^jsH+mh3uPE8_rN|M(PiHz$v6h1;r07Wuf_eW%L#`N-4BE^T~?AE)Yl7+Me0N_aJPx<;BJX zmZ^Ql?0Gla-3;%6RNy2;@B!pUh$E}4h|9FRdpnIar=mXC`Gvbvtv{PqDnrDh##uI} z+7qZb&P2}vy~Go!Te9mru+}zj88xl&CO88;__B5!Xhd}tjr|-+n@cKGye6XzUgv66w zt@A&x33w>Jwr}^vXb_?(4$Q%=H^9rx$iyVjYS*Owk>iNu9VZMECuPWvX2PeRE1(SD!rR!Y&R5lZrI6Nb1FvPrYu{e4gkFxA<6Avnw}dBd$6zIi0#sY2Z4~;{pvf9n4kv z)}XqZ8WKc;w2yQX%gfy&A?mZQOk4l3GkSaXQavANFMsIi@i6pYL3tMe1rJ@Ada$4G zdhjQ~=3M3Lz^gkKr=)P&yJ}TFJ;;hhrBa;=_F-^4qLDQUe*YLfcX6MBV-Y0+JmtyrGC z+pU&d=7ql8FF&;C&r#_$5!e9De#lRW$|qz?1K&dfPQ;|DXt=%1$^xWJ%jD<)rq4$F zUS|dPm8GkJm2>D`M`?g^np9}? zKDTQx<3U$~cAAieoXt9R1|M4uvjtX#5s&W@b*#vz(_=VAA;L&#PqZ2oQIXWXid%{f z)?&K=I^|@c<0t18qd4h3?pQt7OD7v?@d<^-lX#2INYL?Pywe5S6X!)kp@@=wjaO{M4tfFap#076wTrgLMXJ(?xV$rRehOW}_z zEu!X1P3DBz0j7AT?}pFnsSAeH!QtxH{A8c{4&{UD90l}EcatiPE8Vya#K81BnCpi? zchgF(pEnys!YcB6g3Ys9aYBG0Wmo$vopAy-nGU^Q`&I%$;vq>0Q zY*p66gq-@k=#tcAAM((jx)?xc~hB6(vs5b^SE51v|XMQzld&Y&&mN$SQ^6s#ejd>Zb>U*o{I z=l2xB=-;OSWzC2JmS@PfA1>R_9V`SfA$CBnKjWGTQ;&p``bvG)Fz-}Oc6Rn~p0pBW z`ZrH-Q<1BmJ8#98=t-Uh7Kd2S8JaJb|84g_f!$xqaaqZkIxXm6wxv*Awh+xfBCuMb zRN(cYur6C<+9plN<;j%|KIthlBKvQ3&wb9G-mUotOc5tfU?JRbdblNRN4Ef3G3d-8 z%8^)vx`qM0u152qSzL80=IWH&Yl$*-rtK$zu_@L-nB650#|E{@Nq50iAYjU(kv3B?S_YPx8QUN0he6v>wuFn_r zf0*8~;z>|i6GE>8-E0O}iG*ucuhQ>`I<^54fL#xfqhI)Dpry5Lk@7wz^;K_QpL0DJ zv#~)NI~W!Ej-L(k3AxCe_~pA0p63{AT@F(}7;`N#`szOh-P$p`6)G!>#-cR$_75|S zpV;+f%BjWWsemc~%iTYNWXm6}UaMOYZ)V@+dlW2t!8G z#6k$=c2c2GZe2@Nf)IpIn%)zqd4&t8P& zp<*nbP5iUBk6YynskcANAnf?A=N|=&?i5dojTV~5(0}Jz{Kw4nw1TEH*V?n|t@13y z0VRq!3p%445sLc_4$|P9issR~x$72XfhNq}KoO9d%VwI(e}Btf!x!Q|^CM~&6nPob6)gl8_ck0{T%+bM z|2Ds^?>a7*vI}l^n+3MfMUu%e*LO$@M)*@$q-UJ%IB@GQcc8<##=*u$Wu(=^2O=BO zvL2T$sCLtQkCLJ758S!IX2lWFWQ1)A|y4$s+!s*daLOEXhlcQJt;4q(G zXhguVdthHIsjqZ$xb_^iZ=)o7hP+QKkL3Dwk!PtwZo7veVjqUcXwq|M+S91k7d>yi z^aJQS8rJk|Y&LxYDf!-kK&KJVSdH-qLHElpEgLRDlurv^JplGgerN{4D=bQJnDC4t z7(3A)Z%({$vax^IRmCA$gF;R8QXM={WzOTcG;b>lL7>Fm!?Ho`z$RC3;Dhp zfQANAQde(z#|N5mJFe<%<@E6v@%dM>*t@6TqSm?%HtPcB#IwAy2xK)2xEF0Ufs8P) zp`+87!1>a>Z)WSZ*EGwKY3rpAo}ftBMB6|ih?@|sFGDh&PfdZ=}C^yuC zh4jpKuY6kk0k$RA2c)Qg+FQzqFKbmIYqfvAVB97W=

    ^?X|tur-OgO~5)jma9O%hvmzY)-Rt;-XRhvBumL| zyP&d>0UeQqNhh>`c4j~K!*xmAJ+J9*qI}?|pUHJfqSin_9kBo?Y#mcM0h;(u z7AV0HI9A=r!oHk5J`4DmyPTakTl9x_Mimf#q^8aDZkc|9>lLG~z+awm&7?k4DG_6+mq|E113B`K>)}Ts1)Bk+SzQuKKaV%ejw&7qv^ipw0(R`YM``J(^IXeeG zzgC3I!{?rZ@4P-`Ufb)2jRl{aA8p71(g!h#R=~h221C5PU;YOz*H`C7z~DvdV`T^TNL(hs-M_dRs(fHuq0Xfl z7^~l!jj4V@t96r7)lZI((`)kz3d*ANLO^Im2V$PYs6uweADaYOwU{ELl6e=Vb|AIe zHkKHmAFXtO4}SwT>`(Wof%+)>ggz<~F5PG)E5>|PX~3J}z7Emzk`L)IS&7#TG5$2kYmg-S#Zof< z&Rt0IU2$MGVq-*Ktq7U=(YaxSBl&o)u_jl0jUMU;*=7qQ52>k}Keo2JPls;EfOzu-}6Ze6Hxj%KS30qyI~ z$2Gbk!uJ{W&cZ0ftC*#>9S0w?SDtVYIsWnp1lv30@#0!&I*|bZb%hMYA%PHH(YNbN z%jb_h{+^`Wv^8I!D4_+Hwp*&L;|#4X>V4t*$mhy4szSHXpxyzgYEX$%7&3(#sWIsz z6+7Hqh0?GB!Gk$u*fT5D|n>5jBBCVgj|6Z4jX(VLnxKW({ltCHW>d zh}7i*tTo|AomM;#HnzxlD~8OgDC{4lKV?z)1n;dpb7XpcM2ef^jKGpVTVHzKunl#+^ivWPgZ@ zJH&ljSf0S9ylYscI=X1`J0MdZr4Va#b=U?jyl*)MMu?LSdwmKOo!RluZTbsxgK(aZvYd<3;2>)2Hp{N^73*xN6w446a@o0i>%r` z1!z&5QZYSDV%1jTiXrw^ub66^kqpA#7j?j;_w5F3VYc2;<{>MJ&rdqbMlqooQ-vwU zbIAb8ya8>Rmlvo7?>K`zjecBVx6me%5Ug9_c3@8Pz!V1%FDi!z1IR$hKb3<&Hh_1} zG44YU&OR^%6C`UYbs{&(Uv4@#LexF+lh*w=C}v|g!@eVb>O>E33-L_4!Hz^c{=z{^ zjxy?DyI`5;ua?Et%y$Z~hMd`_R@c{O{~&u#+W|CVG=>K9!)ju(sAigiqmACzrSri`73~I*_Fe?ICV?F8oUXHTm zr_Z$^>dOCDz8t*Cekmv^M>9|HaM0&UOFrO4JfIVht)sTBmu$JhsCB8^`cCa5CsEIO=K831839 z`WRoxhQ!CN`En8g8Mv6;uXn;8O#_m4+6Zk^o2CcM2DSruZ!1JsTa_I;SzV}dLIcC| zBXbPbw0<8ReSOLZ^Oov5#x6kVc?&&$eCdBO&$bhVk0M7Wjqhk6hNT6`wTj$PulD#l zfjvpW4`K&*_g}WQm~C|G9??2&h`j7U&sbEbul+_>dLA_HSyp>&yMQWOTTUXqhz@0e6B{QKnqy- z8v8{f@I@TZO4jx(c@K{bq5#6CY%K2}XkkjkkOl(}wJRV~{-7O%&d&ZK#<2T^Znfob zG`3*MI*y46po0Q7h?7rg1S}=qKmMB(eHkr+ulW@;T}v~Dkb|&tH;;In2zD!%EUr9Y z*LNiL*UjH5=`{+}{!Z#osAF$2_y916qa!ox|I2Q`D&=NCL^O3-RduDmPA zV+vgj{OSu&K@Z%T$F$2s=pNuolb{0qmi-;#!z|mW2^{BRWgCAY-A6)lB%|^648jLb z-u>v~5x`bpOEx;6%+a7C(4e`e`3r<`8Nm3H<#{)+ycMg3kz*tCZH)!Xm<52o+(_=jYHt?|-C02(8 z>Qedf<$eb)8oVNiDf=SeX~a6F{0I=t*_@^epl!XwdKkzLyd6?Iea%^hE8ik}E>7KG ziS3Wk!1<#Cx`~2$J8>^n{b=%_<7r(t(}#i;~f6s>a;#P}>AZQj3YHT4nz(+4+uj)D4*=Miu(w5EXp}mPKtqyVB8W_gY8)7@N8Q zO_5TTzWq!rQ_@PSlKNAog+2X(8*Q0}RRv@)D|$G7r18&pg1a0{IBqr7!IK5~-MA=a^*Q=ZpI0~CB?PUTZan*TY|*s70P7A! zvlIo745AQ^UsO$*uRe@oY*hevqJ<1oqum8Di&-XN%?vvW(;FsWBL-SqA7SJ~Lo9bd zKtzz$b0`$%NqTA_?g4wkvt9_IavewVh65`?PICVpA=bB>dbeUk@RM&sxeNKJIa7mP z?}84rAuuoqAJGNeaYaVW?pVo8#Uo%I*DKIgjOl^6BZ5OjU1Bv>COI=ODB#e}?1d31nNpkzEs|6mgqvSfG`l6#Bi@Y=$=gzDfOM;5UzeXj4?E^ANfx4tCB$=xGJ5mZ6l$T&ZW$Vn01j3pLQUd<~corch~3cDv*4m4d|9!JH!ww#9YQIC#FvaFOP~JUUwI#j_PLtzJPn}{gtd{_kAEUv zxIR6w@acR~X2{&ecfNai=9HZ-8v5`xlYVOkIwsvl43|vdEdCA^gLIX-%%ad8#e6yN zQ;ovK((sotju2Jm?CXL*#~(F3GFw(jCP? zitl!6)w=^95+m;hAU!#OnWn-#&+QDRqp=NA2; z>y~314Z2vf>?&8JNi|#SLC@VpuBTx^gw%@zoqw8joF<;gxPx&AAq5y+n5-6teYTjJ zZ~%xR2=RDc(zx|2QUZ-LH$Vg;v%#?7ItUCJ!A+!DFGOHmaXy^`q$uP9n8Bo`J7fGs zrmx@$Nr`C|8Eub%^((aUZzZ^PZ?yhus5E2Oq6v$!uZwfl%J^lL8DD9Y2Z!|v?$o5h zw~@Fpo4SOo2QyvgN0Tv!JAJ*nhQ?b+0%)FG&f5v?2qSO=;idXO`cA}AI$E*FJ z`d?TSRf*pSoj|RYWV6SML%mPGXQEu+#l~h70Mr=xCFG|D@L^JOsCD67V0>CyA?wib zrDgzwwAu18(#W*1Js%)<{MbQT*>0aJ4tWR*CeSD(u7N=pN*LnRqF4vs@dtGFQ6+C8 zUjhFrMDK6(X_wB+Va~gs+(d6XbpE&Z6O0!c0uAxBHH6A;jRz;sBX?@inMJYb5JXnO z>oSl{xG~@yH4nxMc`n}+_Pz=YxPmd-T-0MF4KIheadGm%mbd$;z&mwP{{g9rcdiKXzK zv};5R^SKIdDZEIr1-H|R`x~iDE-0u27&R)&rGnSczb{ziLS(`qa~?Y?Mdg~T>7u(d z-s?ju^>*`O*#uM$18*vtBnT)Y?kr`4&z_V`?K=)O={?ZF=mLCOpATcqPGb%a4|kGN z9sLQG>vo%lT;695Hmo&C#Yakx)*Yb!6LZta5u$hDm zo_w9e78E1lVnk~uS*n!j>Vn2Q_mhQSh3Wf21_ds4dos`A0d^t#I~;9&%@PA|M2 z;MZkmN*h`YQPz|MahMdVNJ>s1>g*X;S?Q49v^nfw=wb^K7vKCntNM3$v>>$eJ$p)~ z;ZM=?0^{Bf)i1u~-Y)^HO_IdEfHIR1=+LG(E_vkhH^;fr%fV*pWG@vQ$1*qYIQYtA z@~$Sz&4>+xvGGVPb><{VWdDHBkV5uH17Cj9HOJd! zRK`6wDyRO1xDdUpw?=@o#gRE;2WTy5K76zT3q^=ok5@fkKyv(crgJT`{D7GilDe-SCFLI0^SY{`;xyN#eRTLpts$-BR#xI$`}Bk`Px@I@ zl+&HC-F{w)2FeAy!#$f~I+0exNySo)XJy=aT45}d)C8SaNoAG@6HL!TtMayx!M9$h zYbf#CG{f-@Ai`jCQkXO@o_}}{slWnGjceo%Aq3KxLc!S%kjjY$^L-zi+ctpD{Tj-; z`0egrp5A1fg}8+ALx3!oFp~Lou6&SrYQtd0#ezhU)-%a{m4gi`m?r#oJ(zo#+NXe< zL|VXd|E6oA2Mfgvj;>f^4pM=PfF%(KN>^n`xcQw2P@W9t3nxKOyA_a#O&}4`07B&H=Lu3RJ&oYldi}7MB1u{$yRdE!LKg&VJ?NXG8`AB|yzqgwU+@%^BlQc>*#7I9PCu0Y;Q}-- zdQMt=hZF)a6L&!ZG(2b{@18(t#L-%W_)N>vP;C1&-Ja`DJ&IaOs;lGasO`<4<(Nw= zvb!TwPMTO&3wJW}OBQJt3zUT@uOUp@26T}y0iN0R3Ti=@y85pwQluQ-SqAE;_H z*6CS?Kw(x|o14|z>hL$)oB8wK$-bOpA{Dz?Eb@gEI_|C_A77i&e58HzeX;x8F%Vn2 zY^JR=nT-%I^7l|TeV#MT<1b=szKDoZEd{4q(2!9k^SQSZwuozhC0S7xZYOIpW5h=G zw=gjXC2VSh0{>l2Nf5({CRBp->K%=K@O#*PLVoQ*q@-ebfits+NQ%zZ1tw1IeD5H% zV24e+cxqd?`K}>RP9hi0+Ei;pve91^_NZ+F{RJB9^TNw<3^Lc% zBDnmH6M~LH6YF%7Q7leuG2cM_gJq_5wYsGoeBX?aXskSliT0V?`L$x8aplTG5Dw0T zIyCb^Vb~Ui5;RBB4src_vk`6`i7wOJrKo!tp1>_iG~b;yVDA+pg_KOY=-ujc$i60R zlI^ZyWQA$PokrAfgDs!JOv~&`_oOfHC=!}nVVNa#e+B&|#ee`j*nWL)^5tFMq$-+i zHXF7f4-oWGFz-4cpb_938dkHmdJ2>eiNe*Ny8U00^JE82t0=OZzYTt&s{!u+9XaE# zhI}w;_MmUKyvN=;^Jyr%fdlFF+V4v_-ylWfZ##*ZAw4Aj*!L3Eg} zJKo*Vvazm4+$)<5_BUJY&8|cX^*TZ3YvvN?qJS!Yc6V|GYZ+-eU`0Ta^5F z1)jMc{N^%;5{Hzn?d+pGw3{_cmy~Uk;@KDIw|?$I zQjPaE)~$KW3i#g2RnR+;@I>WGU3p~847IB9S*H+SY?}^DXp4&j73b-yz z<$p2ZRpM_9e_D8!<&ecz$@cB)yQ0v(C@GJbF4K8gi;0d&u3IERq;z}vK_`9{0OZG4 zH{03o#A}n`=ZHD0V8qVuD#8O zK-SG!Sl#omL|`^3feIR_R%9RJMupq-Ee}!$nfpH|cQ(ws7IAZLFiVN)UaDNyXW0kT z0^S)0L>^QSmLPjOGtspe#;FnOO4<3bZ*GkV1U~snKZdQXit}YRa`2Qe!Df=fAg^GE zC1yVf`PXyGk(61a3M`k7>|UtrUuxah!z2Vp1wtEw{%{@%^W}s|6d3h`=7tO8_a58{ z%Rw{O)q>_lv8>?S+sW+JrStt?GR*{4cyywZ*XtL>`2-lpSbMs=Rs1MeC@=mka{%a$-0xOliYQ;WOL`9R zwom@>#p-;l>2H~np;a=WO!^?%jgMl13PiWdVI}@>D>gAu-M6wR-KSg*u`Zr{J`sdr z7Hm8I9Z!V-{agxGmaquJtUR9y+Zk8yiUF14fk_WI)R?obHM98XI(XVs6gHY|O+n#{Ey_~~?Z2V~`9KZee`c8i7#N*$}b zQNsC@BRICEvT#GDcjuMl9gajbWc_F?>)2!03jP5-$iFtIoCz`cm$elQfs8k;qLu@b zuhGSqN+Zvn3~_ae1}tb6Cwyl=o*GgrsbSXY!7kMn>JY-t%WL(UlRht7GvEIQn~uj3*zp|F|{92-2z> z8FE?OTloA&KjrfppvX(XOyYnr!PFGi{w! zA0}u0(<)AikI7k!dThYMoiGDo!HR`!M&uGR&B7@3BXbCUM8DtxT*hsRV#Nbc2L|7! zt_~14%J*5Hr1KQy`iNWf6Xsp~$_!O5OHA5AbC8N+zxsAxr3Z&l>vi*wbDoSxQw*hl z2#c~#Kg)3|-g3s869EIJvUbt+@Wqwit(dVeX6WqBf!}XTm*)1(RSFg_-fS9AX=Z7qd@!gR)gft?P6+D!8HbC-3CxV4)VUc$FIneGG|+n;;!Uihr$t0)wETDrKYa z!ju34O|0Ey#-VU$FurP>^U7P5i>f6p*)8bJYcelKP38?;+RYR9$~~qxiznWS!TOFG z&MCe+#ZSqB^??{35XL6LG^Ye*sr}x&>n7WJ?Q-X6GXX`EG2$y-;w?8NfA-SV@zb7} zN0{U31jmz1`~RMy?L>c3W@SxT)-!p!^o?bxoUzB+ik5kcQWH%8nh^)oWXA;+8_wYT zTrn9p8Km4)n3Nl%3aJv!2d-R!4R+0O@=mG{E`(d*@TvLwKS0o&4O(yPmlBmZ#;*gD zqQbByKM^nKapH}?5_5%}=x|c|wxg{pSFLMkNC|NPUrWs}9@*pYcTmDt4c5{rF{fW5Pw;kk2i% zTOqHEnyjwYutwN>WrUTrVw#L`?$zP?M>>zhPWh8e#~#9s%Xh)o{1&zAf57ap{VA`z zLl8a3of%Ax2{*1}*nQ4B(NCW*T3%lM-1g~%usUMbs!lM3q@ZyK$*TGK2H#PGY65Oe z-$zgYE97ur9n8`PVH1rO_Yk*ckI-qskTCYd>}-vjH*Xeqd4SL9QuXxo?AXHfnT53K z%3wnq5WsY&+e6QZow2Gj3e${AsJ9z%I^S8G!l60&052>Y>)S1>_P!L_SoA_G4HV3S zM%7*|Di)UnoQ+BDv_iaR`A49HA(yBlS>erYAU%ViUn>u2f)eIt*dQ*GCob+>EV#TS z{h&PdZn=~)$ROaS5_*cS4*^z+f`)!=mPPC(^A(O?n#@MTt*I zlR@T^hOx25JT6I)P6=aM65gKNk!15BjNGahjkz~fcNt`4I;9$EO3%fs z?i=K~$gfQRUzAB#&UzXs_KwRRN}JDO`CTW&Pf8NW1PE2|Y12iDcdEe~68DboJQc#T ztvZM@b?|8pz2bDtqpr+zLBuFN8gEVrn{A3|D?D`0=y!Zhuzsa9`_v^=!UH7-DUiUo8Y60#I+`4U~j%drJYt* zgs~mjp&opNB{GF$n93E=r(gtVT8Bea7+8{L5Ng^NcarrF3*8Y`i&HZb4RGP_<~vEO z%99FK&{FArrmr|fAV4+~52*~kywKfak(TAVbbWTc_`T)$(LXADkNc~7`YuUoa**O7 zR9?tK<2T3t49l)KKM@m~UbhTuoonY?$Ze+M!*Hw-fq1rq%Wd&$ZWZg6&8~u38Y8w& zz*bR83idix@LbPaVQ7DsT0N_xBve_;2V7#USTgYH7XK6imoBwUFAS)Tl#^Y1a$V`) zl|VFZm|@M=qkv=S_d|IAn2}alY-n?|Hs_*_HNpu2PdT?RKOn`S-)CY+UQqddRses(p1`+ZzwS z6)D-O$34F1UaQGWj*RsT>KhwQv6(*ga}j#{))_UGO#Q(1f}0jK0g*3?o|NL}mG572 z1FHs=ct;pY?%Q!a{-MK~Qfw}WhNyijIe2wXrQbw;$XWg7ah-^SiJ{-hlM8-yS5Tu6 z9dLe+I7M_KIvr{3s6kH&jQI0IHFs8WbS|6VC#weZ}ZvovLfo9o{3MxQ;H2HgA>;N z4LbkM?J}0mDWr}pzl{3v*^vSW%ugw%?_{Da5%JB(5lyyRcanumr!J?TUGKOZn+PT@ z%gSsasT6N_YtiWKvZq{f+o8j^#cQ-=W)X15-PzXX)3=UmwalbZD5}2z5vY0SKOm4c z>9w1sZ3FWaVn9}z`rm?}LJSUM!sWpPpVkv|`@4l9a4FOr;#bW;5rRtV-){Vg=qjUFu__Sp10)?Xl7_0Arf_W31yZ7ddvT)8@YvNc8 z-`I07gcskr#<(E@_za4Nzkg6Tvzgmgb^Uq=h#*LKVuMO4>8PyN0^!Teo(pi#b9ZEk zEBvCVdDI0B16`LQNSL&M!bknmRDh<+tR?*`%*t5-qNv>dT*_0gMXdvngmQ!&FEuIY zGFQt~rLhP`M!02b}LuiT}it-y~qKQi?;k(F(2*oTjQR9}vW$g_0%STL>@jKp%BKDIjkaeG{Q zgX>PhsLPp;Vh>p#U7{pldo-e{uZrAyb^b)kcG6gqU2o#D;7FU6ssPrC>jIje=V{Iu2X;^E;%OE$Sr zD=5Fjm*^hR%f$P z1M{N&iy&>1!HRcYL#N9Ru(}n}J`p}PGLrm#cl~ilgTt-hx1+>9cdyPT%*wNlQL1m! zsC`hMCvhjY-UEht`h!-Pk&%gKt||hXR83239jEa7sVR1`2-fKZQd-64 zpFcs0`!; zG0)dhkk%bk31(o}-nHrs>f{ONGXR2_eQAp&z$2+Yz?36F^4DPbJE!!b+}`)lriE;0 z(hC=2j*bFcCZ1n4-T){o+LSBM$PB!So!fMEu#}XPV3uaItfb>RW>L3EqkV_E6R7=B zzQ5MRX%0dljlvd3+b{ux>TwQ$Z1j9!;mCZG^w66CoEf*P;mpKV%bRg$) zQ)(;o=FWBpbc!TaEUn57R-~YB;)Wd@Tgh+nRt8=44hs4zN~hbpiYWh3LUrAXi#o!f znU)W)33u+E&`w7NM9)hxZSg5+wvmrw7S*AwM$Uw@#8-3Hy6Fhi`^GH!=>l zQZ@8h$6`UuWq(c$eJ{lC;+6NJpo&9P%0Q28&1g0R`wXJoH$ zTJ?5dS$c5cC8E)A{?3NQgsL+yVZLMFra^^7q0n_YW}msKD`v~=pOa3-Gs#zb|CaIF zLSY0{3F#$u$QA?S6uurprwfSQ5h|nTWqc|DceSt zQl;{?^Jb=@1fI6~Ncn`7@ue&!!7p9)h3UB9Ut?pI+TWJ_-;8gy35ws|FwyWtkv>K$ z?4Q)0{1RAG4e~9L(7%PJ7ulEW$wjTQB9q{^8iGE_U^7o)kvEZ~vC-A0O>rAj^dAgC zimJcfQWT!sE{pE@?dv@(wc?ij$@V$sK!$@2kTb&)iYW-75$qIj!l=zO%KTVnf%xlh>kGhRv3RQ@5gp+pTc>Xk-wM(!sA) zmg*@g)*DVv6;B!pYi@`C3Ljs+k-Kc%`diL(3ep%h1svLRt!BvqV6YX+R#dS zbGfxmZAY4i+c=MuC$Y{LRGS(nZGaX{wW$!Fbs&h#OjeuxruMCcrqL!z36^)wW#bMY z$KLPU+}unn=P!yGD%hA99i!~+6tG;HkvbF^UXw4-|0yd7nmp37AH+ZK_v4~oDNP>i zynsFN%Aod#(SrXQomtP!>f75`xbaBVbTrpDrgQ`C%R>V`brR-*G_hCR;>%5R_+raF zMT{B9`wl(#IIw=;m)Wlfo{w1J_s-5u*@!CpGY-WWi)1$$ub44IvCD|TKN@uoYT|OyO1WDP}4$DXw*k>8J6=p7gY-K5W-*&M@ez33Re2P~Qk8x%3*ufZoGY0cZ&)R>SC<qC?$XqjR{hL=LZth0Jij4fg$fDlo>q!6 z?{0-pSj|{?sY;d~O4K*{>W>P&a#89cP^_1IRN@yfl?O|kk4w&seG92XL+%l048x1A ztR>IHz+dL`ljHJ(eHYCSPpP9XVj_SisJ|@T$DFs-|Cf{L-5<|jzF3-ova7k=clHoW*}(b;iEq2e{0AW?)P9QoL!F9B08M?+RQ4dP!5r9VIC4-pTH~l zvF&W9&aTOiGyPF&%t)ld=1HyVDed!PXVcFbcUz zLBIo&kTh3aJ$-lMWtp1ai7A}j{{H?B z&>BjBu8;445h@m3y4M=PEKR%)1)F6xM?u5Tml=|G-zxrz9G?_EX@^tXT*n37C0rIRP~AMc?^u7MkMGLb@>Q;D})x% zxP6}^t&C4|ouespu)N0Z2NB!y$FpOYQ zBt+mz$;tNt+bdR0VC<*r;7ED1Sg%lf2$K<*hhCE6_r^2CJgI)s@7ij#3w1*c2gUc{ z8&KylK*~RSZ?s@t)IcyxV-WyEU1j$ntr#fw`oxsEe}`Z?@eAEof4CB|mU zc7*Z{y*x}861`dcsLM(s!`f;*EfzcDelWl58JCte_qU=WP4thPnfSXkaupB9_T;2mEN1Y_?@AHCwL+=^XcgsWBx=h9NtmAZqG#=nu|Ochp?L-i#!{OAO}3 zKCF{ZT@U-MHxV$K^poG#Pt$w2*?dEJRKyVD7*|=Sf3KS{NlE2dHHhgqd%HiH`0>V# zfR6BSyRp$ckIL+Z(X*8skb2-He^h^+hxYW`(xlv1xE7mew|~s7_h?evyp$7NSG%(& znS$KWC`8r0%kowKv)I4F1Z&(O=M*&M>6TPSPyAVIl0S<*M9umYEckJs%S^xZ`|zL8 zvuq$u6FnA|$XR`E=*^qUFcv5Eho_fU+9otriD864`=WpVpycAhr=;2mGy|)zt$yPm z{R5%_4^3BB*TR;x4dv@1YluTwA3;-@LNaR7bAZ49K#NRRUY-flF}*O9_oNF$O#$FS z{lRB$`oQ0x9in1lI-%$BJ+Q*&`)%toq71yPDaW{Co+&~&EU7%E@ZQ4%BCc}tmoGY= z!`ntBBp7ayGSDT^OWg-f+qER(7VqWa-?)xWm%0_MriHerl3`1&GV{r6dEGGcCL^B; z+e<{3P;k}kM!Ie^*8Vt{Bx>A`a9}og-;>}wa7YhP=&hN_1Z00c<~W>Uy?gaj>k;uo ztMaeKYZ8mZs6r3K3=QGj;JrkV-Ol`^vzxzEg@!M+n3>aiElyI#l^NJiU*pq%FsjJ6 zHu~f0xQn8Jzy-RG;d6V(yTfK0qa2qsl1l>S6cMQJ@*%*tnzR+9?W)P#K_pos)Ygt?3%6WCgplD7fRt)LLv$(r-4y!kqX~)Wc`Gp=v+d`pYS9x&m;fRz4Oq< z)&(6p0SjEV{m}I@1D&ZPJ!J0&&r=eJ>EWN%g$zwzD>B#M=LW0dOJYH@eKg%h|GYZ0 zEN<%lq2lw-`at|SuU<2B2~V8WtLf#RSo&wL>GJX6l$$0a6*RwhWUy5WDV$Wf)9RXD z&6MH9Is1)aMUh^-kuyY?r7$Xt?vUAGEnLp);#@=Il}S}Z;JG&O)2^tD?mTnOGkm7Y7hBmcGJ%DsnIm4c0)-Z5oO1B`PH*Z>uK*>I zEc!b3?HJ?rS&%@zid&u)D)Z|3;S{aI?4(r`DLIB4eJD-1K@ z5zhbYq7r(R2qHUWiIn;2M2Jx&hphP!Q=*Z|*maN@5*_EWa3<4)y>CisP*Y zO%l`hs@~>D0M*n2tCC*MU!RP)yA?)SV?#YU@&lbajC;^H*QpZ~9{xF+w+xP%S4n9p zw@WwM48=D?T#tHp&Q8m`P@NjZI>8aD?-`8Q5_MvpCBMvNOY`=te=!|kqSuBMM9 z*CEO>z#=TPvGVk+cjWb#2)@qaGqN(03tJI=ayBD5S-0J-(PGC}wpW=igsq-WI}0YX zPDZhl&UFFYM#q)GhRs0A6=%ftLEsCVlOkeb96elTI3ArZ0toYwqKd&FHJ}R~vp1nZ z9jy)9xAHi9u+#|gJitg?_MFsWiF0P%a+ToowX5zZG{Wu(@?dF--#cakL%IR{nYZXk zXdkks%XN1|@yk&pU?Kc02rbUyoyG<0XR+dyv)A@v@d@wdHmLki@XyhP@J(5+tK;j- zRW{Bt5tru?JQ>78-Ys&UU0GPRZ%zxH59+Nj_=XTP$1fX?4+p*Vqsz%9IZsLb>AJva z6BercOpe6jlb|IO(bLuatt=Q>Sf*7cxTMz1j29*s@*z5Ws4H)ZpvCRWTn}qihNH?r zBqYzRnB@85hsj9f&Q;8ZJ<$E19~Omp9`q{Ib6C?CQ>J)+Bb~J1$ z7~r`!URMK?3!U*k(u*>PgO|>TY)?X~;g(YoD8DPdJFWfciH&dE`D%JNXC=9lqWAG2 zNB%w|a+@5N6@v#@{$D=bOt$!wC6mmY`SVV#tt7EmU!?uVhdUT+sbxBz>V^;Z=t8ez z^zTD!A+!22qw;}zVQzAFvc5y>C9_1r0#ZCYB}we}^Rsv9#x3jA+6<01*7V4RIyZK> zsSo1%4j5J2Qlk#9=l|F7Y-_Piw;&=U4x54#Jfo;<2s{ zcDLy8XAu(p*xemlPgs0eu`dUMXU7H%N)Ur5swQC^ zdhS((KPx~d+MjF%PDpEim=oXlB2itWJAYR2+g_!-o>TU{Vw~iBM$nKq5K}UZ#8<>wh|lZVSZU zF|%`1k-c+f^}c*inHN3YQZ~BwE0d?Wc;#vt+O%#hAU3Y0V|<0tYK z%vY2wyobSPu62<{FnohEhd>pcLjVwb-m-Dx+?C`J1Co8gbC}=c;>XTGSvhHF+${5A z1bg7d9O^ToS}fS)KQTDkR1rL4Jd;C8a6bHGL{BU$rVTl_#+Fg-kY=W*IVMM}sF2)t z#T}k59rJY0gRZwf_cCVDN`835s?`659gUhbAAV0)` zEeD{|AKVv>Yb0^;{_)S@YVL@GvCfg-C+PI=M&$4KLo8e6`Buvm)S`!ab=uf8UC*tg z8y7yf#z&Y++lzTS%sb9u{6+mJtQMlgsQf%L4ReS)dt!2OvTfr;o4|DcY#vs+MzXg; z`h3dS(CLy-PI5Pev$P<6n@e?AR}Ok77I?I`HJN`G9?&uIH9&@SR-F-rO6iO=kp}AO zq%ZM4`2WK1&o&JMSYIA?=Xkd38Z1fo9}@`spC-Ugity|)Hww(37Vn0fh_<4U(3TEz zRWov(!;{({7B~~X6Q;&9W#Ys2tFi?A(m1%`02TE}{jgm%OOubm@$^FHLX7YwUS=F@Q@KpjnMQDubVpJeD| zuZge&7gr=*feDjlUC7^2zz_T@IK1#ugO5jijDmtXU9;X2BS_s_lZ_t8J#fKy?2?>_<1X%$RPj|?^mpG~*h zzx(k09Se{ZzjHMOvYe~w;g{i>!7C>tINVtdh2i$>C)ateH_czJ6D+ZtUm#P1R2WH} z$DM+v!&o3O4<<8`%mHr#&!1oM##BS`^}(V{Ez`tOHcz*H=zfnwNcr9ezFsL*AunQ7 zez7yK@_RDd=852xAhE7DdyQYe14(=Rv|r;G;jilO<^J{;Gvu+hfG>oyj{W5wn6d9c zHL$$C`oD~wH8D5$=u+@ubeF7@n3#cST;+14bD5M4(^>fGfh{h?O3)a@w zrb2prgzEcE+~D1H_~xwOb#c$a3a@beAGf3^c#F>3BT<~%`Q}G4@!`c@EKKB4-iWQw zp|wXl)?=91egGwNf5DEN=BMSYI}vrBUb{SRkGDu9Hc zvWze}mms>UMNUlY*=@NZ zr)zM`|I4vmxrsOa;Z=m|Zid^(w+sbg`c*e?X3WWwzazq)sGhI=aolr!>@h`=NKQU= z$w9vP%xK)L=6gfne`zoHejU)`Q{gNy)HAs>&N zIm8lUC-JQRhn-w~?H2wAhGFpLhs=@u5phDAzq%F*dy15FBjMNZS%Sm{ zV#?UZ@9`fwt1h2atfeS2qID@YO+dnx3tu~!(6!$LcJg0WTSo|5L!*Blx;yVq8`&8% zirMw2N_4UWlCi-wl*g2_sE{o-on#}x?A(E^IUCJe%_YtS7qOwpx)S0m#zdO`cN0-2 z!am%Tx0(_ibH&q}2oW6FD7QBr0$)d3%d}55+D7xDO}?5IOEL69>hNdc%5c|-NVghZ zLuNzQ;+UfWRy;@yE~hys|K-PnFTuO%8>?c1CinzIi3EvgNzzP7j~TsW)YXfWs~5qS zSp5oWhcK^G-R94dM^g|0l_CzvmPMGR(X+~RwMt6#5R+?QV9c5M85F4y#-H+v{m(TY zA@4hN6>vY$9uwBp6w7RptMM@&;)EwB9ixv~jn7NiI$4s%OZ?GyYQ>sZFzf#|a|CCG zgy|c++Lkxw+WGUfhl#r8Kf|v6+fr~afR-zk303s3&ybSboF;7%QGvitpT9=~F|YVK z$H)kVu)++5Gaz5IErS~!9{6wuP0mFDrageFj8fn4gZu$4kL1wGy;B9FQ>lm4(&u>}X=c@n<<^%N(Q19Nu0-hs zBJr;v`Awecyr3K{zs6RG_5WHe{r8OopRwCV;M`5^_}!EL*X!p1@IWQ5#Trrwu?wwes%aFG_0Qcp59z^w`lL=yn)g+pkg7fI zKZZ3vRG{k8@W`=Y?OqoLdjxzK>+bgDn(wc-FBZQY5h%}0{T|(|^Mqg1P@cYiyh#Yp z@j>wX;b!8++|BdJMOreMUr0XcHf6_!TNl}1>3sdyVOL|G!LU+XvP_9fTa+FR}R2}vF=)2KB)5-^edBxGCX zZbOc1h*-$6xKC*&WZHRgtcjaCo!8AxQBJndDDb%?TZ+l&)xbP(HwdfmFC9} z`k#hM($%C9+oVS8^S#k zLVC}TGFpGYUi)oy_}3BzPK4_lfO-ZN96b%l-w}oYeWN-F_1L*6_#`Jg`yk66u_HnX zhy4DGAY1{#5DgR3(s3rDbui!YXbGqw$o_=IA0Q?EPsG70F@}##{+Q4w?hd8Hs}n7} z@&7yz*ngde@efaGcq8_@Oq#3@-X^a3vBbn&NI^@IMXiweyd+YH22@&Y)646h10aey z00R%z>uMz*zssuenNxs&4>Omg{B;gai3+Pkv_jk6@4=lhY?9F881VmR+0l{@!k=%` zB>wt%QLqO>7bPC|RxljdU+8PCZo{>X|iNrlfc(#F(fFYS$6Z+B>9;z>8Y zZMAXacFQjF?spb;5=9q69`pBS@fv+p<673yF4hgg%j=vsswCTNXg;)^5NADkr8*R! zS8JbV@LSm6$^AWQex0hjH2NE#aO&Ptu+R}=dpyq@Xs`37nJ&P4tkI}Y=l1WzclK#| zP5bYofZT~4c(DU&V`m9wheP6CDIv8e=lrmKh8pD`C%c6oo*60%XQkTN#!#IrYrB7} zS0sP3`W**k`x;>j&d%@&kdBEFea;o>>@QMnX)9>ZDM;A+2U-(p!_wwRIoBrahW^xns z5zW^0SMmFtpAi|maoxtEe>>X9=mUigp^uEfQ3FZuSL3i*f^Qd_Bf=#l)S_;EJnxz= zpb#F>ZE?kAKq?`H>E3;u;bHXG_cq;36rtD#(o@0q@Fpky;n()MSPG*w2L z+vLeD@`x3~my+Fo-o~shZYH>b;3N;k-?y<6A;!F~RB_k6OSHSu_zxE#L*G&KQf0}_ zhL=B*+?MA5!{jw{B{!i_G=x)Ddn3_FD=Dz( z_eRr(A4?-?998PDnp&suPrYxat`## z1t9MhWCwpN2%;KKS1@TU7BhJzLF4iE%K8rH%#~BmGtYnBdoA~E&ZB8>IB?A`fL{1| zH6GX5_f@q{8AFcy>o=k*3_f~Q^K~ZYhdkvh=zeTBU}lQ=tb`jY=Kl*FBURH$%d~O3 zqI|JAF35VL$u{?RUg9((1EpVXNW;G{towr9ZB+*MbDL{xS8r@rM!w<{nc|T}0vm?f z#*774i4)vi^iRfW_2(LDvhV7cDd`Y%Uf{mzvnsA1>dAtM{S!Z`!=)5`63hjc5#Q;A zVx7(^XB?D7_aLUHef7*{?f?T;Fx|GLMv*$fD}OS;WPg7_T7?F6@3OPP?{N=LFXj5m zd0ap#BSj2iBjql(eb<;{WsBSNaC~WtT`~3H?J-qLY;M&=?XPw0=y6U)1BMk_I+|UE z*UtkmYhd;P(Df31d=WL;F~y0$|mY`XA*Xk2dXnjvAe(9DFYgxb-w?5?(61Y}G2W@LP%a5Lx~AV!%IiZCL`m~|o%d5+`k=jN7IY&q zURd@JYv|it8*a0{QWID^pStdwpZ1G0!4P@vRzlN@{hh6vy1R3<8+oMRvg73}#pD&N zyYI+IE*tbErQKSJI;$P4@MWpY!{Zd&?gERD`TnQg@{#FmU5{xL#?ZL{0_#Y|-TY(q z@b4&7gcY~1<73loQi9_o{JeKhIcaqHMm~ht^PzOk!gi!%>kFs@a>NS@dfPyYgCYX{ zXN1*zT48`VFb+f+>ac%@D~?)xlxFKgwmb|wTKr}U3jB0LL zUAMT%cDO5FySw~AvT^xVqtvGtx39f8$a->}n=6NpZDY^F<%bCAqWE!Xz}JGIJFiyU z+U}4Y>RG%lGW_OEn1t#QbqOA2;#UZm7-jqzM(DfH@@ZUZE(t*gHH7N?;Ddxq_rL7! zDnDJq;xaq%NNyrN@Rp8$CC7Bmp><(&U)#MYpxtHui$g&Ip^>m~t=E!Tu5sN5p+QTu z>A*s*U4dSg3d^`b^QQmE-8~llSDVtAPYig+zquJ!KfEL!L`FQ6iFen{oTWzvHTi*v zpJpiJu_t>YX_yh0G?snk$>sglt>Ly?3JclK1hf{yoXT%+m5&&4$lObq9CXXhkb6Ti-{8F`lZ- z#4cVd3Y065Az1z~e!qKsdnpCVaIH`L#_}}A6mI2_rG?a2df%pGE!|uCjf+=*(+2fY z+RO?ix#u57>bKRYUAsE{{*33t%L)NGqmB*UWIUoSI(%X`hWtw8E)nGhDr7@*wGbvy^VV6VvJL<*Rs`YWpXyc;h9^@}fVH5F zXotGD4g(~ke`C0Jtk-KO-pC-}szKkISoP%IVpM5SyNp9Jz`Q7?;cC%TH~9(}i2 z3veu1Ww$U~rcRseGOv4^UHrCwH_bWy*k5U}Go`H7>nE=5N$pp%`owv+AMw;1t@B^m zueEYjTYi0xGjS;Y{e{0#v#=l9LK)bfGBk&#UvBljE`l34#ipFey5M{A$vnQx>S6HV zR&v|IZsNNvqXl~&H_hKA}M#Ok+N!@eA^Z)(dnOnA6$Uw3(V7i%k?QLi7BrP;JrblLIujDF*4 zit=vTaY`ALcV!BemjdF8z$q@(#OXi{d5l>6V0ProSq|wQg6690L{Cq?wUh@O-)3~C z{L#bp0_XaV4|M$B?h#y@S+S94l#*vUjV*}nyfyghslywO0qQ5LF6#x-FD)alu$n*V z-cEH6J-*lVY_Hmcb9X^~bHxam{v#4OLMOtNxO? zwd;G=F1Pp7$6`IJLI-70&%xo|SL(x5rdId3@ofTRtB+P}^jF-kqCGqWF$;-QfK_FF zDw+N_Si|}k%0&DC1SudG_x-QP1OR*ga9Sonx63hU!tFCnK_w7*&@OWZ@28;MG2Wy1 z-=&{Iyt;Qc7Ufxx#1~>A>Z7?^T6KfJOS(6K*YG5NVkcuOc?p-Ry8CMGK5J~9Q1$eT ziN(Ch^feo^0t&-L^JeQTL+*DE7rwqA$$sl7dZI2$f0)^u_EtlpyR^W1toB;Ga~Ks~ z9Y^)v+&%r)io9>CJl~sMnjTiV3+24G?MI51dCIw)7p&lA43M3+AKQuIr8gXM*mYujo^2quUi|Ms2yQQ_^$L#eB-35=bimv9od$EZs+lix&1@9wJ3 zJo#w#|1kCzP*HGQ+pr)F(%mRXN=SE0DIqQ0NOw1afRwa!h#=kFHA*8bC5?1jI|Fmw%do|RAEtj!oLHT@;-2N zOAHM(L7BN0hr)#aR%SAn3siX+`6RSG=35sLw6&T&@;jGqsWGwOd<2|P0)20%<1Hm) zkz3~-G%j*fgN9nL?hX>?`?$jQo$AuttB+KADkDoXLV>52UNU-*IBWm=Ko2d|1)Z5ZsB3n1eBNZNm>1?8AwmV@Lz zB8Abq_!BY>nzqzvKSm*)0NF`xJWPv!`M+iQhFH?^T3k?)-IZAE`D$h@gty1PF!YaFK?ld`*jfwUHJ|i zK$G{q3^ICV?`-?NaKz)cp@gc!K9XjQhP~Y-@&_V%MjmN zJS~rtz-P2lnhH*GR*l!4hNV$zB`nO(6~=PMmoD;s)^~g+H3n;W9Nc#$$LmAjn{iue+B*}&{_DXf+aPN zo@-}hCt=>or*_n|1fsx+<|x%8@Y=6|tJr(oBD#Fo)IZKZ3;(jSjF?v;zWGVJSl3go zqogOF8;TwY8*J%3)PAnZs?2n{sY_I5Y^=XN{E?^9F!zbJu){H4286R;%%bTZSa|wL zO|himbmBx&lKHVl)NYi|8czSE{WIVM-)I09aj+cfhf*!@$b|NsbO-(KK0@LUirDRhglw>Q6?U?CDR-%4H{L{hDmJ*- z8-al$o>W!)#1fGHDhOopJewx6`WpADX+W+nm*fp|>OpIFMClg-6QM6=Xj{% zRCs*uaT(eGeXJ6#IAIU-0k3*fin$DWn8UFC{1c@R;lvUfho0Dp!bE&ABQ)wvE!fZu z-`#|nab#o-x1H*Sfy7YgXaaQXe)Alp&cF0IF?#$k%jlr7+GYPmlYpuz8y{W1iFl{t zGMXnijZ%XCqkRdC2PowwYOO-j*ktI-%L0zkCMy~8>LsrRwHsSrIxy{S>b7&=^x;iS zoWVfm6H7kXG+sYZvAQd5Tl#3SLM{lk7v*~Cv&hx!kGRdw#2hKZ`(N421s2~fsLKt#N%Yr=PUHTIkIY$k;V-NjPSkW(Ak@G=#qQb2 z?mrdPKRPVv;^N%w+L+YGs0Q^b6&FIeOeky8s{%H;r#Q@>8!#DUI|3!A@zh;hmSJ3d z^Xi6l*Wc7gB3X0;1fzt0ZzR#mguI=4P%QlB-Fb~r7gra9B#)VgPn>I1B&bTc?}WBO}EXV_dKQwL*ilfEQh_m4a?4pYt}GrA|j8x4)UYoL)2 zD=3owEnq_%zFEE5iJ=<#@W6(-+y6BVfepPpR*;_B*gL(UyLKv3MNP997mGc2tIF3V z8qaZuk5RMe;pqqzG4&BTU0uuq^H7L`Gixh?zqTe3TmMcD?^j zOCWvH*vL)E*m$6kqmEIPbj0^=MRg)dN=jH{`mDE9=tVC2B(7Dd_H+~C%#~oK7jD$X z#N=Q2Y^cO@p6@wvcFxG!a(BLqTy4cG1q3D{qA6Y{>cJw7-yxb<&k(bwKPXeJw1|*n zAXmP#{E}w*!5xCn)B_|qvJ8e7^T$L{wTx-6o{o|5qP@yU`MiR+@nnhbu*YiK+cd_g zAmakA0pors!;b}8Gr9innhB@FG!~<>VXR#9U-^TG931)i4!4zn;|n<|Hhk=1K^R^C zqAP56QEa;V;Z*~4ZqOF10mDwzm`MKMI4s2HO~*!k;P4?1!qU0prV!uL4+MBHI~&`s zanIg8_+)44TIII>EU8fKpx%18bng+hD2rFn%fCvcFC`56MWD9R+QVV0Sn+3bzd2I%2iIsTedI%BPJhtcy=h4$pV=^`&m%BMU~kUhVM1 zK%#|W`Tgk0YZ9&$Ci-w_8PWVVAv$W@cKu!P9 zg;zP@Gn!1ob2J3{PQ!Q?$f-wP<(6N|1sn}OsC;Y)s!U_qDjO?~M+2SuyCuUdjR$Gq3%)7#w z+w?1qYqmp9;GDwGHT`>&23LMmP}!XiRPh4;i965QDMr8UHx46(>2jmRrE$~(4Q#T0 zyi_nC>fVLz+~G|XRD{pwK+39z9;{riZd|hPaXoE0Cf$rAT=IOT`C`6&8JYl%ZD*a{ zrvFV;Pp5yEZv=?$U7IHY2$SL<>Abu6P=btH?VFsSYuKq3v&9tP5az=ZY@H#f7K%k9AV zAv|_%R2Tc;{m==+Mi6s$fa6X3OvK-p)#9gk9^3B_pn!Wb{uRi&s0_`I`!zT`PGt@{ zkyi3D+Dovamii|b>U9YWQwf!S;5A7$F2!#W|9Y*KV_qvEqkS^7Xi=rxK&Uj11N&xN z3nF4~;xw~LfzPOZxydnQap0xWdgRh-v|lH$iIh1qQs>ZJfxRkkn?g6q*D6Q>da16> z+b1Yitxx`N1f*1ewc0+}BY^4;cq9WFx>QMaa+}(>ske!%X$U!su^Z%-wO@6Wq)?&l z`2Nh0phZeNK3-rnShcMb@+sN>4#uip>Z`kOsipDwzxwoPDls;&|JrNHM6-{IoeO)I z6efo{>xC0XvUN!iC5kj~G{YzBvyO&MTrn4^UK5-rxi@x2H!RgU zR0gc_vPI9foMgaK{?;Y-KhPLUEOMeC2hxCUYJrmp+KQ4y(*^2BuFJO&4k~)xar9zg z4~!9Ki!1G3aU>=aNKa;1Q1;c*$DAoPbDqK5YfF&}xQ=imDAM=~mUT^nzw`z?$nB`e z?Bxs;6Y0r&AQZ~S?ECmph9z=uvOyEriyGgp{0u)h7G%Eh;+f8}>G^#Tb-sEqd)UkV z?KgF%Gf0-zK%JEOdury7e3c1C_r;vys-f2fM^=hUW^Q17>)Vl?Q>5wlR>j(%7?6KX z9M2enW7dLXWEEa;a+78SL|4y@^bnw6&?!^LVma^bMRlp`+G#J(?7^&9*>eoB_CT^u zV&Fmk=Wb1?T}_qxxx8%WHG)0q=F4|;QSD|Q_=lOM5q3)*Abn!}J&>qmrhn&`$ddfN z)%lQ%W$|AwO7>p8oRtB^-$e+Q1V!}tTao(|zfHEKulm4!lg7Mt84NW5PO1n+2!E!q z6p3M5K8q<|WwDOE)k~(~rNu^`D)!^VsNf_hTgAVgOU}ElJaj*}>_+=$h9N#Egcibk zE4)OKq(J>GL*gX$D(`Oem=o+^==CVTM(tE$a5~(a_ognIm=xHDXa27Y;hz!&z8Slx zSCscqcZMHCumBMZ*8bzx(87Rat!jy_D1s+n?0KE#tNtc94cINp$(BHLL~lLCzsLSZ z*~<%M?dDw86%LO|g%w7&LgJl42SCOh{}DL_{6||&fr^3PV-|INtp!BVKDqyq2@|qA z7eH-xHXGR9;jjVH+38zniyeQ}gb>TJYUBJDF$hr4E2`DL$=z;<2i72(mSJn{LdX+ZlaA$O7l$a2$5V`-& zwgIIuB*VEShWa8lpWJcb$gC{ACvLzs%;T|&7;`Q-Fi4ZZ>G|*Zn>+pL!DA8JB!H7y z1Lj#?az2O3cl{0QmVe1H`!a1dQiBOQQ`4@Phf!qe!7@rp(y4+toV&X_B&l5b zNTG+64G|$y*O(`V3W=GA5oE}zPz)so263|ZuK(b}Jy3rRjo~EP`kb44C%>Aq6G!-B zKY|E-`Q~MELpMp*dI#eY<<@`TTrm>z=H@c<)X%g0$RFz)zx`{h2Vjjv3Ni2>bCrKu zpmIm@=|zaFW(N0&byZ6rdKQZy;NuZ@;|<31X-7=R5j-jI5Tlf9*D{l7ZD97mlDgS( z(%=yJmojhBd{iD!;mca>m<}n>%vnj55P0iZ?zlmhxUrE+eOP~37^U>Jlar>j6YE}} z`e*PLkO67G*9M^>JYb(IZab?t?Kb2tAho{q9Ld^Gv3b<#j(JwA}04G7!3ioPa=n%%~BZHm&hz;m7*pTsKgft z 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 ss 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

    %`ImBOOiiY5Oj@uvji8rnW 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%0Aa-*~4X9&Y|wee#!V0~68KO^h2l zJ0gnSwlL9E62ei@6AA5Mhm)?z@Kj=kpffWFlx^+e>=(xXR+#hap#fTLS4l4a%i$F) zl{dU|GkPh)1s>fdpoVYbojb8sBV^_xaz`7rw|JH4`7VzqS^+}sPLP{_=epS}Wk!8N znlp)q%o1`;oC7+B=I@C}m9)(O>NIw-nzP#|NKKic(wH-D&X^S*hQ0*hqv1I1oNw1; zXdD|CW-lEkQtdJks(5+MR5W=cn$VZ2Q*PV0Z|!-U&3OywpdQyvCT=<=WJLHxGnatN z8D#z;57xP*`ZycGY1spnxhz`|&!ZyGOR#a_eY_e_=DU*M{OV57CTOClUAtk<=t)U1 z@zGD=5Q6<`_Jua3-uxhwA74%>-bcr(Li!l-Faj}sC#h;G+9^q#jX2M+Z9W`H%o4UK87`7U-P7sqQwS-%BOj4MAM{||fF9PG^;{3H4Qc3)s%waKEcvQMv zdOU?^jT6wqX{2Ii_u<|%6b-T>p)h2y!Uo6+Yq}S?ZD8o!fPgHRQd>HOcOD_Euvjn9 zxOz{6U|eE2+M!}tZJf0rjMEoI(wb+a5E)w;G}`_GcOXtc;9nz7W=gJg6HWO+zA~ez zN83wVn!mX`>@p-xpis6^O$!BPA|5%+75nxh7rI}P19jL>PZYgf;CK|>~)Eo^EwtBo$4#+sUn2Ky zEoz07XJCgJ68;LFun4F=UYo5MxhyY&n!)IdZ~Sz7ky7mV(Oy8rqVDZN>&>M|Pm3fU zdS`_A)#N)`eeJw<;f!_DpX?VlM8_Wz^|^9yUMm$UF6&fy}lM>yHsypFR>z zQgZXdd8Ym1t*L6{DiZFC^p`(%~#Y;5s8s z5kA@JYW5E|Ej$??`6x#5hRZ$?c_j~kys9aL0HjHAE&gRFn%eA}mE^?*j|1eEo2E@{ z$bw_mu|~(rL5Ht4d;QU3+te?%-L?IO<=Gq@>NLS`R5cdvvhl1Wc?BpD=jcX@a4@C` zg~n7}0KS)#^Gs^AK7?Nw^NCJG9STjEhT5Z3_kS9MG8xV=R*Y8DsTF9oQcX3ls5PmV7$k&1P|2+bQn7A#zN(XK3M`7U4 Na%(%Q8y21i{tIh4(X9Xg literal 0 HcmV?d00001 diff --git a/doc/event-alarm-framework/event-alarm-framework-seqdiag.png b/doc/event-alarm-framework/event-alarm-framework-seqdiag.png new file mode 100644 index 0000000000000000000000000000000000000000..5473b2c63aa434cfb98298a3b7a2cefb61bb76ca GIT binary patch literal 252171 zcmeFZcT|(x*Dh)YLB)pH=uHTSQl*Q6kkCX7krEIA=^zk9x`>E?v_R-ZG1NflEi^?1 z=^BC1QA!|$q6C73b{2bozkBZ)+k3`$?ilxvGsgbMp-8gccdc2T`OIgou-kf?M_JCZ z?Af#DC{#=R&YnGok$d(WQe-{^ezI3BQgP27o;^@?wYyKu=hF`ln19$R(R9$Zjy-AHa2@%km}G5KK+a$(PwSt9F_lx@O>oNcoFnpF9h&2`!gMCJI?JqLL9>}9^bXWxJC zuQ4y*-OxgWU5jP@Z+_rEUw-}i9!hxBfByB~U6tqHUM%i(i5AQM#v}f<1|?kO-?jce z+W*BKUYFd*9k^MlKp(K`n`(yS9Z-m z*y3%^eOd^3^zqf;e;7`0%u^BU5l)4>tBa$GW$cPe_2ml7pZOt!L`^Pl^`qP>X2^i` zX@`$5Pn3E}XX9)Vkw&ABhn*ch$MAMfs?VN0H&Zhi#oDMz2>+C7`fMgM(0rl1N5z4J z^wJeroK;crXP{)B{QR!<#^G(G?48^+_iz)xU!Od1fr_@TP<`EBa~J;MI6=$IJV;Dy z2AcODCKxGrABJF4`Tcqb^-b4t*ht(!H&s>~gR1N|am-&E544CpCna=mwPQ85ube&} z7%1aQcQPV~)`nu)y-?g7B1;TvG2*1F%Jgxq3w7=e(ENWazL!}#at{&yjSuGgPse8G zd5Wq`W^AuD6`T7m$n=%l>U&bM6AR26d_2QmF(d1i8tW7`e}3qrt4bG>OPe>xmna5$b(T%Mu-IGnrj*Kx$Y%j=t)qE$7N12b?&MWWx$kdk$ESQQ3J6^I40nIYi%Hri-s{MV`-2xc49|N@>i8 zT6Dis)YzN)|@cBY(&d> z#m7!OX1XcTQ1E?Ccc}Qf#eL4PMF)FSHk<@0;2^$VZ!D|kh?mw^UX4$==9cC2J&5U< z51mSq$irzNO`S?Z=K70FV_Z|JlG)d1-$w6yth%$_)Au%7r9gJTYrLRcHL&q3I`HB} ze(v-oj;7xls~h7x=1A06jkyfpMS~9UYO^o0ijN7AzzUJaZS#W*FISSxeGi%%(wD{q z_cp3BzDDn>LYRAJ6Lz*Yc0D&Zu;VHd*OUA2%o5;GnT*|T2cuI{tK5ixjD?M%jn z6*o(XUrIZhv_4=##oM&ZoxEY!CZuk<0$dp!_}oJE__4YAZ+eOc7tFk;F^Y4>hsM{& zd?j9Xg>nbv;cLm~E5Z4A^=eLB@^}A#`o2PA-D#q|pw9YeeqHfr9r~51k3&Fu%PU3rt)aR-Y{} z)Xh#D*0N6ByZ_Ju`^uz>DYSM0IDDSpwgV-W?`5AhZB9#Iw2*u|7d?9of^<-mk#dJ7 zBDC~37OE|H_`+(gqGrE*v2&!ru;~j`!+QR-)bS%mr3zCqH_u$Vjb){JTWO3jY^?J)XML)2BK4_cS>uhTGCghowdEnOS^{Ln@ z);e9;L3L$Xr_^4>AImG>^qD3wFU6PF=gWKch0RaJ=^uM8cw)+DZLug|V|e_~ourrQ zd=_C9Lfqm9kDiy-QeK~mbBL7bXKs(#Ns!cNj(r?`LGH5M_;QEDcx+<4$VlVQ5Qzic z%4;JYb1(U$Za1xWxhl+wmZeYeubX@J!5tPVNsITz+`n;pjht8sJty@Lm5=L1GH#7G z`Uj)eJm-}^fHJ-J4YE` zK=i+`LV+6@3(htPXFPepv*g^kPF4#%by&OGjpFs#;v@w&)ey9w>5$}GY~t^Z{&b?I z69vY|Fyl85Shsl&S=9YQ5S+TPha$>RX#G#%VCTB82!^<^kdx}dVpLd)h-ZL3-w&Mx zp@Bs`)wADNv*B0Eg*o5x4Rapjzj6n#0tDab@ z_%uImVje_Jhe2TG_YZQ58+6n+f@7{* zap{N=MUv`JJkS1E$Tk*l4Hu_W6VG@E%8sr%|Im8CM~r2D#MfXSR4mrWHwZGUQcQ9q zEq&?0OLBMmg~AviVth#~O{3T@`{2#6>ErN`Ru;s9zeLvRKaMj<=`as+8k$)D&xGm><8g9S;W%b|6!ttk zJHbTsw@JsXU?w*6`w?mlmER9ta610^2A{S)^piO|bouLpXl6bWBJlzGr7{_&gjUhX zYU4w;&1vu@511aA>wEUFD}}w#XJtlpr#1p5h?7VM_V9jAkIy!ld-T|P>chk;=N(|T z!G1Q`!ui3Qrhz)V+S-Ve+`>z%fjet~?`0p6HCuI!Qqh?A>Ow@xSK?(9p9pmiB2@U` zvv~8bu;Oq5oHymHG5}of!!3yj)EL3ZQsh<7waHfp=d!aQiDJ12xoC=}BVmf3adbD| z)Eh_%k5uJR3!4p%*w5Ie&k4`St?}zC?N-3CX0n_#M4lyS-DS9z!3OxFl}@fi8|ujm z#_;U?ZdENnJ|4`r`XrZbR3#LT!6z6$Og=bNP<;;Lfz%FBc*y4%CT$zgIS^(oawmlu zQC5j9jc}(=!oxWs{zhhQpRQ*SiP7L? ztN5foT@t_7mJqm$D~Rqg{+0nTqZ+9_6OUzn4nT`|h0YWf44>Rs2y^&B6NVf#+$E1f7*7hGiwksA9o z2(Tg96IRxhe1m1W+DZ?T%L*_~*?HN#;`Y$(vWdGp+glv(iVzBD#^I$tghj(m0$PRV z!QC|g8Kd07^cmWU$I6~zoXYL+g;NE%!W4m%iBZ!BIn0hbY1+9mQNry(9xXYp_QfgH zSZ+}0cGV;4VIf@EpeZf6)ek((9Ef48>O!%D)~sFNRTW=0h`3P{IJyv-<98ZAy46l6 zurl7JB{ts_(4?@LB%ueiQv+9V79z&!x@*eD_Ill{rs3|Zf}<8r#=153$1b?kSn`;* z*ZPln&m8o>@I&;gV5<5*oMJC?1t_Ts4%%JZ_s`ssG>tPwweP}-rLZ|QB2#6QhQ5>c*h(*4=P=*o~GAPtD_TbBi$?d97 z9z_oX037wfE)s8TQAouWC72AS&}(*IUSB4{iB)0ugiH^M|teMsA%YC6t> z6%(%#Yy3U&{)}rGA$IG8fwobe&(HTv!Ok05>N(Oxj5#OF=!%IA22O~Fm=eS6_=gAW zYdhGr{a@=-UbW5>%QqV0qg4Dxw^y$N zuIP-GbQ$OO#*IZ>6~L)cMYCv^C80N$3<<>Hafzw)foH={TV2pn%tfFDFs@iMqtzBVDmN+ zjS>OBB3Pw6*d;88aEPDA<^>stcoT>G?B1`M+?<=$D~>0|txZ3=25t-o*$GZyKi}~h z^R_KvB>PQNacq7MW_#9Gy1hB0>g5Daw$8@62GCO9KMrxPccNS(vDUu$ESuu@&l>Ca z)2FVWAZiRlbN?Y$CTBy`?80GX1yRgrK_IL&c|2&N$n1DxvgLy7T@X8b#n#KPkcLmM zor;7^zlS*qdU8oxYu&ar&HG9;8R+*+=^{|^!)2)KPiF_Wb*sXu!_}@#stpQ>g%7ZZ z!{0p7;%voriwZNcfsgn2LDiZyKbA{%U*o@D{pAMhrxt<>5%W+6fZ5BY7K91jJ?&Gt zPg=40$5ejb_uTx|ic57Nh#bdNNUwtW@6hn!?FH9BRz`l|kRbQyT7tQcz2_%(M4k;u zB|%TZtwn}S+6x}}Xg3QGF|}P;<|2z77TfMIt?z>NTWuUU{HL9{ejeF$pyc4Nejwx9eb$=|M^g(g2@aQoER+q&&voJu#&NW@ zYs{p3Wz6;A5KJtCmko>*PnMF=+LsMFB%12wL}s_v#@UQ6qkWK|bOOPkYVP~5%$-e5 zsFQVN4ydVgBQMHJ<{5${;$-Q)SUXdo!GV-6D{c*Qvt$bG(=J8{Zkc1NK#8aL`39rg ze{Gbbq9ZC)f>OZVc&B=Nn_m51^v-TUyuY^nG|oCz)7Z1XcWqH^MT-UgHay;sj-LB&H-Ki zgR{R5eky`&YgcaYU5mn&PlQ7b?Te`$LSN*Wc=7pU8KJLBZoE)-$nNds_0O_T%81>m zu8sMi{LH=Yc`+8}(y-cpoe^8qV~uMTOt_aNNP$I&-zh1~5gfiS=S(z7 zjSe-3jhWnDe#FTic*WZPW{=$?Y$F?;O-x!njsj z#XcJ+??FDWZ`@*gIq~|>xPZEj%XQE31=FSkNewK<$V9|0I*m=rw)@D$qt2_X2VOC; zagCIoG)ndhDK#&J%?WR5Fb$f>UQ7e_DTsK1V*(Sg$) zGm<$aqCJynL_n8S#IHBAN*o{>^?G+qU-+lT>}AFZK1E>?&Qksfi;utDC7MdZFedju z2}w0Lrd~w^?0`tN|Hm!t=@SNwRVv3z`7(u=!f-6&tG!J&AVvb+2Nr_b!0_j87Pg%w2E zHrg%}s^W-;hdfV@cLS`RA54Ed6%&Se+@ziLJ)9hNXj$P)@gxC*~}67>L&JJ2uN0M#{`O78>`g zF<-Sub;qv+hDlR3IZ~kp^98Yne!ovno(b?4v9EXhcQ(cm|6zVwd5g3V?j_6?MAfSC zfQ|by(x&q|?*4p7|KvuGPFyEsS^R;f06ZXy_q8C0xM$G+D{nq4@D!!t`bR$AS?jt{ zi^BJ(`~N~3PM>UD_KFObaR&VU0jnATn`dP1JuNGs9`^@3*!{ladVqQ#+xt(HxaYu7 z%)7vy4GS5Uk!yb?01$fbIoB;zy?^X4(fB)yv05C+c|3N>YuLH^OVR1!;}>*a{0S)? zfBL_m_lM%&1#Z*0J$K7mNOAq0QGk1P`6eUa!wDc#r1$0-yzPCh7JM8(RN?x?>5t8b zAUlvbR*wJi|Niu1|CN12027=2RO8P7?&rW-|BG+^1MC5Z{_k44PY)hh|`;^vhyCd6S1_Z&}9KH0Exw9v$ z<$_ABS_=SWeU1IO?_#aysP9rkeiX0U#>u=nn$*^{9hKUzw=U!(y+&m`)s#%Jw_5hX z@{RB^9A=M#d;nJYk@)o88B?b>FW9&MUMn-PIC9@%8kZ@_ej*{nO8X>f-EX+ zIX~T>Lgc+|wNFxHxo&(5-y;6m+%pz`3{-RT=VEUTpE|4bq{L?;On4~crsDqN6bI1r zaI!s6q0Ae!+Z}Vp;*QD=TyJ~#DmrlA^8R=uEKY`G_ASunb7|=Ta#tz|jj9AhylleZ zqcqL?03g82ZF}g6Z(7r)rq6B-@ZZ)nk{kE)&?dqG#nUI8>4$cm{@h@2z@(x7C2BX( z$%Si}MH0qN__V~35 z4;KI?NSIDFT0Ya>RSH`d@H8&7x=ZHfGtKo z0I?m$##o%s#~73Tm_0pbqtZ8ZR#U8~Ej~1G1wi z!&N}XBYBbHmylb4(7#=#B+Jc=m9Du73iO40qoO#J%!7~2o?xpPxQp^K zQP=w&BSnx~pd2vp-=I5Rd@FVojiIf9whB)~A+c{4NEq9uW3m-4n(he#brhg+&sWr^iJI?r?nXR%j!`{#w9E8Az-_^QR?^^|^noX7Bmww#Dj zBj{7+hR3%bPoDky+UdYli1R2G!f>lfqQ13p_XnNBquZoVl#KI`v?@D);;oaPeTqu6 zacaSbWYC7VNWwOQ+5kf!%-l3^@E7WQ4aV1gzYR9I~ZtEd`F_fbH8X z)TxUcy$9;&SUik3v*@-VfdE>Ajy)Cc4195AvRWZ zAApe;h#1whsRKdQfIL=^=S2!qrLZi*0Ou}!0Y8~#H2{Aef?#p;Gg|#nk99a!r?-uX zBI>J@lCqx&H{>@>e{93f8*UfYKxCI_-MpRpdA$eT%e@bg5t@svn)5g@QUUjSDt z(myB>3BLAO>4{_>qzvDyTA6(m7D~J3OuK@86l$8ErK@K@rC|N)<+>1KjhB3L(I^a? z&0lNaQh_xdCBjiXHwX?*Qf!ohfU7+U0fiP3wEU|?xQbbu3@1>ppy~_I=PB)+hrt8* zULwLv>pMh`QVPVDmYQhy^b)FS1X9Y}^{X>gc8-a|`Skq&9~iRLoHb z_#J*^Eq@RS?!=}+5KZth&gMm8G&0 z!GqX|!WYJowGb**`H<`#b%n$jd^?|ht+OuR^`$no z5YGOhPwbV57>-wwpAS$9PFQvpozOyn)fEuHU9b>t1G@k&Ekswe+n{)-=#A3`fxs{? z{k_KMfiiQ)7<`uR86tcm-CGN>8sXjl%WBIcO+OOs*bf+V8q zSbX?2(#T#5VH2A>QYG{h)psrci>p#$ub1Ycw6nI{vVMl@dwGT2&y0nD)zcwVtUM7D zeMwrC4T~eU*36%I2)s2<6&Pmx-)p$+Gu};5UzJ%Y1zX)pSRCV%67_d!fOvOq3)rzo zf+Q610phO$m;)B#B@lxTUw8w&b@?(*8jCCYZ0KTo>N;WW2>3?ROcwL=(WvQzR{WA` z1PArA9*zfy>|ph7j3@CTaM;r+nM_1D&C2XCYkBx_jb3hGnC*Y9fshL-B%R0NW-~%i zeF3&yAY44i_%~eq8!rA&4;P{k?9GUVNCYYE9TJFSk9f{V9?w@(z)7A@(%b#szQRRpI^fIMv z^=7vWms#tU1eY{mAd9bwBR@q7PbC{=P(remNHr}Y3T#`2W#BxX^L@RlCD|DB>-k3o zm%>y1`tz`wj9)7>^@~hx9T#^fwgKh(pOkN=Y_-a8$iUs=PBokApPr8sLWU?;r(Qk&0`Q9N z9HAerUw<3k4lnlV#ILQjsQ&-{5 zCCc=qkH|L%O~>gP>9}<0a1!p8t|Y~|p=mUJ9?B~}meAAbn8#HzNWuV`+yBGrI`R5%eq?sT zJ{dXxZ&=9q+I#XX72}Q={3aA(plTFjr`~{-Ua|o_T>q@ZGmOR`=!p**;}aPh=+zW_ zK7ea8g2>u{G|T=m&p^^Rm7^ZiLiRs%Yi2HSTAk|^;KOYFfY#7oASoMpW9`3R*~IKg;ajY1gd73dqd*-zE~={@wb-bSk=<_@(zA;RVv1>sa+IzEl}&cOb>=WHUtao z_{;8cqELOSq2G#DzSUU8;3t@W`JWB~*h-Sp(jWyXbJ0Q|?S;eiW0&f}=h+Nw1b+}6 zkg<3ZLByh)4HV%edpP}*f$lgXUfgOkMWAJd+rg~6!o8PU#98WUtqGg>aR zr5-wdH57`ljC!Sjy>LS;CU=pwa3t9(l@S z)!LPKA7&KMGWaN~Ia1Sd`{Q&?4URLr|fF2Swx=v{$+&iD{-A||= zP$w|P+iTs3@c5rjjVR1a5|#)bU|lGgd2WE62Jz1d7Ww0A*G`@6c6NpwBlTnI#qfaIykpaeOD<&90Zko@VRvpRY-=Oh!2$DVw zas5l;R1l+LWRzckvN8Ai*1bPv>#DX2z0zXbYKk;d=1|$NytOL~1tQ%2ps`x44&)@i zss=OiYE_X<;N$$iOA8zYmy9yv(49d74Tt_l)p55#NrJY$rP2rR>9nv4IC6QRS_@%+ z{OYM}hbi=PZJdk-!2x4d+lm1NXR^dMB0RM!;~Z7(;snuS{ggosLzt%u7#98(lK{$a(PN=84kT$ot^eBAm;q3)MDv{?Yhp*S&$s7?k78sP@<`KUYJuS;Mt-7B_eA~;@W&I90ltwM|} zYY@QMqN7X;;?KG~i1oH9re+#_7ULxAWf=aGPbwyF+N*134~Z7DUcK8et#R$3h5BbE zCf@b&ox-km5#^@tVQ~{!i1P7%T+du$Yt=y7%AhC=Z9i@EAfYkdlUQGf!8_4Yf*Qgf zj@&ol=2*>=1Nsz)Hc!PIw@J}9ZPy=*?Q(jA@F5pb?HyvPkpZEs)$?`1LMoX6ywhcx=BlCQkoNfYsg4{(^lA4wOSV0T3 zglKn^7ZyrC#LEh9X{nr)+8AM@&bUEb>Y`XvwI3B-oIBszsw|vcTb&~x=s5%`i*X`` zYT|^y@!C84T+{4~xpI}8v*tyaF^3SGN)C|E_tuwGe5iNrxM#Q>d+mAA#q%6D6}gso z9_pY+mKMbAS|TrycpC{-9IsM064o8J{3eGkE9-LK_kAy2Q4lLj{r%M?ByIoW%po8Q z2crS(G>1MOLmh~KWZshcUJ55tL%e4tG1vwt)m)gT;h#31fhfi;ihAm^}ZH8>S zQl>YvtG1{c*TULW+KA=@6GNv+-V3i=J>8Y<`q((gFmu)QHvKdAWh4G8?a6l}gvCr!Z3X6=uAXEzTtStF*nlRFKGz zWQQOJPnOFc#%0rMf}*MC1_Met*CemH9L%dgv;fKhq%Ve&SKC1{&5t;Pq?tuuu=p71 ziT?O5%}$qZ?0MyfgvH4zF~m-(a7THgl1F8e129UZIF;Ac`BjLb@=SjjDSuV;()7Vs zwW1Lj6}@XroE|irC%qDbC~mpx?#H86&5L1twn=MZu^L^zF@6$!r2+QV7ENY78+7Gw z7dPezM=xG0v5L?p4agSzJ}^4L*XErnqYG;3lk0MAo>xF%FD2h|-<1$1MSorE5;4p< z;O`1LyODo+7g|Nix~(-}v3HHI+nAUuEbqQUjy|=@@=I>y(akS?aV`>etU}8>20b;F z9*5~3Mg#R4z1qPQYyC#ultNMpkR;Zgp>h<{*X?=~TOuu1SXrRCt?KvT{ zN%lNE9#8D_qHKhm`9AL$k$_kKuB*TmKHQ*rcDSd~a`FnzxP_~3kThE3_DU@0e)rXZ zHIurgAy3Inr21u#$R+C#{p8$UPpKZJx}DV4+y$@4K3H7gfe!hxYSi?3sidAn=uAiF zS|7AE$bR(sr3t{%hA9009vm#Nt1lrheG9P8zy|JYzqb@ld-O~JNIbtiEWOUSw6|q- z+(;!M*mbXw~MF$TP!4brEDX;=K^3} zXOiPU7{UL3kny%k-FiIlLpOp(TEZ$0C}j+X7qf)0}$OI5#wyiG4d&9H>#p zkT;IggiBYI95zo^5s@Rm`CJO)R`gC+`=FEc2WmtM*@l|l!Q2}CLf&f(vO$@9C3=4VG}L0zjr{fJ3rnqXmKWpxktl`N8ghpK za^yKG#n%xsA z%{@`PERMPV@sSVMn{_(LYb21ww#G7++@T}x-Bj6}^bNi976=6_PHd%JUKYH=s?ND8 zcgx;rJtz4Vq0_4wEsaa<9VQ#{qpLRyjo#h{Gdf*Eqil$;hC4!M zo;wCKB6!O-&Fux41bZ;WmefpU z?mXMlC72WGH4QA};Fo}FItte#sYmed69=7j;PU0*S5Zk(jFH@a#zRFqURWQM6$g6FW1K(K689a*X>Bdr{9QCITkVc%P_ znP1H$>Y5k3RPav$58q)%fepE;WY*9tT|GBX%Qjv?ENP{95wB4WpCLs!AdD?ZI;4(< z8Y&K{Io>pd2PJ@h$}BYI3Ro?A&bIBEn#erk`0D%xInCq1S7zGsN^=76eQ|+w`e`@k zvX1CDymjG4p&CYwFrbvt8M(&9XN~Fp)Au%Hv>P@p7$#vpb9Nb zmWtkNDip<6$H>e)_>ce8R{e;3Oi2`Q=T-*ur*(zjIpml)|<@IDA09hsK;O7T^r($y2kg!@-nyl!`;y~*yrU} zVoL^7Nb`Z{W1Wc$mP;IykAK;%I)GwAwAMYECV~t>lAH{_DviG#YfWX97dXenIO{uW z2PgqaL^`PlRmFp`9^vYzWs!gSjn#E7<3y1ZuL?%!VIM&?S-t&y_FAyp zNCzz>RIp;cs~IKo`!}-l2ASsj2oq#B0fr!0@E{{+`QQ{srvZP{ zOfS4|gCFn*48~&0rf%KIHlsr&8$uFIrhB8U^{#f+h5(kyNQU^3Q#FTTNN)I|#I)iq zye8otJ!vBUZPo7r2$(%rK&Nu)Y=xO?l&u*gXmFBqBbhG}m7U4n^(*$HzLAvFjAe6+ zr6lR>UrzCr^w?L>zMMOC>(&mkcv%YQMZaq@EsyceYci3`eFl`(GPr>Rr$9(I1>0;C z+n)HsB!!wm9ct2zkG;N8TL~2w`K7xdt=3uz!v<*^$_~8Y2*=yL>xW(FL7&4DXX1=;17JcGXc}9L)YGR@M;f zyj=fcR&c3;^1nc@Sp*{vNMci=4^z`GwurKe3?A{rbyuj=e!vgKZ%%wpzyS?Dd*!RF zWUpSC4zBB==``{xbf_>e_CadP!vJ)5#cG!aKV?_3O$Vf{+yjMMZ>2gT({IT~-i9RSsKUt3NvNN1gpdS$Q!&`J4gn{?FR!OC zb*4mXzbx-Dr3gz_1%hd>;G%=8(d=Cws-lMstRhM_iv67{igO=&rv$B2r}8$e2NLq# zNR0wpI=O9sC6Dl7^DABLg3xLXon`(+X*16u(PBWp(VtnWe%CFtu}nivr z={kxa5Iy*Xd^ZLK7oOzxEgbBcNf5x<=A3Jt1tC{mxQ#|1c18FzRt}GGCh^q;2(fKk z^-4Qp*JKgzC5adRXi|HF2U&TeXwwP^IEvDwZoFGn8C#r$wgfGJXupwCulR-ZRe+Xg zka1(+BD$wEW^jWFKF~Z^$$T4NCn)e^7@}Eb?%Z(NPUOa3(-E@=Ly&vfSllHo@|4;D z5shyv5x|}Lbo8m2aB|1*a^d;7DoruPb!;r&?9>efwhcADLN3D5p$APs8`B3Q`e&7< zlGwV*tjr|!gbeA5K!ehr;N4f|@`z;X{&6-MNsg8OX?f3a$>R~A_Io@=V zJ|vfb(q7550}v3eH3Po>7|IX=Hr^VFOzN^YI|v!3xOW9b<)Ej6-isl&hexuSxq4sd z5{CoX>hLu~wwb2n4{yhMRHC#~`uMY40Gn*@y49t-WJ+*vcqu^xCZ6VavSZuEbHLwV zxm-6eG2TXxFO?+heN8q~UOM&7&Co+6Ea2}mDx!QB?JAl0kr;ktGGuCCH$m`)j&iI@ ze+s!)MyBToa!U!AARaIz}lE;x`s{2T0Q_ zBvns&9o7C&)h+JG$YmG0q;3#Q|%|)6b^3tmSM}a+PuU)gry|feoKle zpu#A&3eJC*7=_QU#a&e&&&cjLj`?=d3?ejyJZJ&m8DC3!XtnJ`%t+I`?_2RhLsrKA z#|UIHD$_lk%5XIyNLtXTG+7G$nUA7ndZ>J{FzJx#WmlWUI*bRDI~autF_&)z$ziDS zm~W2sMg!I4p=vbsm-Yy)sBxQ;nBYd!_Bryp*t58SZqiEANnq|p5{PRNC63yVVOE0r zwbWAOMz&LRSuHO1tyk%0Z+hFfaw!|{!LX9z0T%xT+3`0YM>Vq+4>OQqRL)yC{}X@n zUNeRS_f^}vC82Z)N1KaD59d#4Ht0c+P*by>Sm+j;_qIMk*%FY;Lbh80!i(mUCmW{y z>~j8O2QVex2DSu%-MM*^=b}{Z79@lUVNy|AFG`6E64Z zYaoNFFUR0lROtAcnkivl_dX>(Rq2pV_ZZ~Gx+N|`R$Rc@nCzSW#i(p5mZ_VuvyhmF zr`^l-Y@Jp&Jdn2n}?d$9Wl*|q^i;@4VFPZO`;RvG8EXHs|q))>13Pvw$Q1Ssw0-P*nn~% z?0sDL(5{#zo0b?zov|S)i^2-Nyjlo&K#$GyeK5l2r|wrutFm&DM9Wg6D?}DLSk8Ho z{{mCkg>OaJH4&sn(KG8YsVR*CKq+%-P2+o3DBt?LXVN)V0vlj?$=#=~31pT)?;GCr zD(ZZ&mRJ+kEbWIAKxQY)l~Z zP|CzzMp9Jl%?%f9<;vOGFXA`(-L3@Qv!jD9skY4 zaxP}Ai^uTn%5O8+&`Nb!`Rd(a?}A%Hg_D|f?06N-RPt4)MMd46NZ+Lg(R;05iCTI3 z!sm?m481_XJ#J%eY66UviX3>b*Nuqz$mcTu(Dld6dC2he0F8yNs9@?NOSM$B9rjLM zi>>i}rUVITNOH~Q=KHUt19~&(kZ0UtqLmzz6a_;@Hx||Ioc_c{=2h7zW(Q4c^YfSm`wV%7E!#SIov;jqZjrDp z_YMX7MN>inx0*xR^Xs4kEwC!2>(6Yxt47S%rxd(o^k=^kg(5sHZz-D!1Myp2B8pvT zrD6<>xfiCOrh}i=JNbbEhp=h)RdY=DGtdwQ7<2+@W#2@h>Qnn{uH^~FE2-|=r-b#6 zjCNnKZv>bd-LEK`UeBE1%pGDdK!>Wd^Rfj3b<}35m}D*>K-~tw#DKU)WZ}KZt)a{S^zO!3?CBH-*Cb33K4E~Be|AW3z2+6 zR$>2N(k)J<|Gsn!*9}N%^_v3Ht>6dCKr@FfFYthYN7alb%)qWo6jMDe zNFy!5^M2t)P7g&6^LYTt8M8;$Ek2}Rb8l7H-?F>yzhrl;w|HF?Z$de%;LoC;7|8(D zS;4Iw`PFuyeN)@_AHA2SbLRa7YgdmLeer@s$G;_-I#e+vv;*xFX4GJgbcqByyXkQl z1!x0{;_bPtTmvA1&piDZ#-c4LpjBIG08R6QzK;J)q+=upiS@2Du-I0UKBH zYe5GT-qZLUn5l3GzVa49R2I;T|BC1S)!P26wf$FX`>)pa|C2Po3y12f^I9q!QmZ|l z#~!qMTVd1A){;Ync-8HujnO3sxYsyFCL0%aN|@1|u{reg9UOto-rl`%=Y8-AmLZ;z zSY7FC2wr$$>;j?6!a5OLRB`S1L@=AmZJ>B?V%5q?QgG!gy5Y|?v8UK zmM3<{qj#sD@YZ#d*7cBSaK{(3WD^)==>zJ96vAt8)gn$`WnDe;?A062Wo<(F(KAo! zya2FR!4M-oBU`sJdw@pt_J>e5{k~dqPi8T}lX~VN|Kx#W!yktJ`xMBMnW9-LnGUC} zfS0l=YMo2A%`k`)(q)nS4en&=iiYUan!M}^wzJ+9Cc>t z=ezS&IjFvv65=cL?lp`D8gG0`A;LonG~l9IuQ{`EEHB>B;q9WxKCV4SFFgnMxD>>| z?r1q5?$sa^h<^`9DB)1>Uu1&@mJ@b=Z4$eKo*)hlClpw}&ATfArWAZo#|;Sunvpn* zjzS`Q)l};!4h&cq%$+bP2{0iPAc`W2ia`5j;5@0W0{lXQ={Q#)*o z3hpHqdU}F!FHRK+%wMx7;=7Xeh$}N=T3Fo33B#wM82nS_piBFTfa2=53_{>iR{di! z03kWwn(L*S?oJm7Msxh{j(mx0BbJ(W0%T0pi+aJ8Ksnt?w9fm(dsO-aOMoI0QSE-P z*QvkI_+b2)rpSo3!5sK{&j|6uPu1ENf~Enz`WzyvB{AR}2oP*5^R z&aps3fg*@xfdV9h84!s@k|Y@l3MErSBT%3yQ8FqBMO2bRnf=<`bNbBbb8nxy_s;jt zo&KezP;YwPXYalCT5Hb+$j}E>btqkzCLK@Rc|c0H2za*74mS8nP#0EzNpdQ!yM%rl zhL~ghG|Cj=tpl6Q?u?ohQfF@VETz)==Tg>Sh5h1+0u7rBQ)QjnJHwUaEDUppES?BX z_(wg9vn9EHew}}h*(a~r%0bTvm6kT$69FsNTGVUK+yhL+y4mLl(M2yCoS*XYu_8jO zC)uy_b5l(XqssYmdHtQnnxmfK4{)bo^v73oZBCsq1Fh5{ti!!x8mHQCuhsEyiX1bi zaQnR{V#L09_ukvAIhfZf?G9a%si2+vbrGw-@fWMuVn5F1m75+R3VmNI`|bHTuPlOx zM(#|3VZ9%|0ee7Cg%XGP(OMesNaxjKVw=z8`QfoXtr@Aaq;6D0sLn9oQ`N@$gl_di z5Nmp<50e?ra$Hfa6S&erK;^S=7r94cU=bHb+pb)BD9)v}V46)WnR}sGL0)NMD*hM}hE5AQTC6`W1{>ZT;x zd`*L)*4}{4*SXTvj^I%h{JB+{ z2}~OAbDh3EDkpli?WhNEqk{{=shf$6SDGH8z;xC6gh4uqwmBk5)p&^DVbGbQWdKa{ z=Hhg*_BD83G^xF5;4U;e;#Z&{=P7jXo0-vh=lBC1C@qd~463tH&xz_HR6Uai!BhYT ze=+53a#aEq2w&2Tav}(ejHHq-p2)&+DVLi%!MkK6Ma%;c*0HWIAxOn5!D;mW{)AhIozCAPqT(X3d{bO%J{lo5k7;Fg(Xxk2x2M;2ab`KNC zS>IiRGYjA6^!fN*Om|gejy-5O`OHr`2g4cdd3XLKJ$$QS)$zomq=Kl+vmHDT*IzW`&d*?ce{MXZb%^qKE~ zG09(9kMYn^gJ8ahyZQSv+4rN)y@xM9Z#;(u0jUYz54BQx3=VL z)~s%nlR?GeOW z2y`-LpRTBWI7N<-M5YERi;v6r-6%b->~MtjIwV^8Keje-5Ic{E&~vk13A_B_Za!lE zOJB^}eM@eQLa<@etsFdw3qZV{zDd-*)j_2RYGD6a2TKF6DhjakNWVmNHl-1i{&}8* zt}5lA*Ev_0pItr=E=q=o9oYI?ulhq$m5cd;WFej4_?ZP}qhV7<9qw zl2(F&aa{oBr^W){&L!$Z)(uuOw;LhQr;qtDpT4w14msm2_S0ZQP~OZQmIv0{SrQLl z((>GDgbdxKyVAw78(gYHLUY>=Qa6|Xbb{6pthNp*PoLyEvxK0#s5ni^Jn zVk6fh$Bessk7Xo0s=xUg7l2DU`NP=Nj*49n{ZYrLbRhQ6f`8n;Yjj$w3YUNeV}vU# z2~85QQBQiIx+nN0#h3~7zu&8mf$4wqt)Rggna!^X9^mUU9wqJF6V!;9H1%A(vJbI% z>q@UMe2O9mH@JMnKN+!a?y*0@XiOXYTNVI@W+mwdd3TX7bN)UN=&q#ek~%}S_O0>5 z(<|LkD$I%ELL#tU2nQosNSNs!EpR*6f=Yy3QJn6^RDSNwiDg6+w0bUW>LB6>aa_zX z0Wpj&FjH$6RUjng^64X5vGn!is76<`WkB657}@wr}BCk zEWM6{9R8*dPC*SJ1Zs#yt0{ZB4wV0=2N+b^MZL}ih`CsnTYOy*CTaB2_aong(!_x5 z_2W$DVNkRlZpoyDU%zuHhn8v#l6pR`mxp%*zXn*?-tpRr-qTsQ*LTjMZowLda%T@5 z&@|{ZTRx(recs*t62kaihj?X>9do}0y=@4+s6ZN=^qO$qg?*9u0$R$cch>OjuM`<@TKrD}3sdb@>hJSFqE=rEQLJ+sC6l^&mWX zo;j|>fAG-iE1`hLVEdiv2@ZTOn<8n+?Wmedmq2HOLrhD~-UA2D5b8mw5|L z>bIBrkJw*q%wG3+FsM*?qQdU&J*IEU#B-Efi~BkdXK;w8qd!T*(%#2F!(jw*io_G9_z+Xr z0)+Bg=A(OEip)gnS~k{5-^{5T<@f1s*2Qb}lktCOv--DW16%$k`{zV(N zQKaKGN&OF*&A;fRAeymO?Jz+?9^#kk!B48bs%o4Xd;~kxm2ZGp^u(H9LTrbYIjK0yw$kzc{N`D=}V%eASTg$yTn99O`>Ev?!c}GOXK9)c51aQ^e zb|-NPOXmVcQNC~uIcr$q3M;9+*l)ppo%y*a=wq#$uL7P*iZ<@GTOoThbQ=J8|8oErk(rVTw}+xvaiU>m+7-(?#Mwkh zv4r1)In3SC2z~H<(LEV)0rEWhn~4`#BPEfm`h;B7rO;@6*-0DxXx4O+p`*wE*Bau= z`OK)KL_N0JCsv0<1d_$=Y9oSM(cP=Bb^1AQw@KYk+g3QWxSL+88AmJM=o2xz=v|1x zuAE|*rZ9!m=$5GAVhq7_-{vu@*{5pU{ZQwS{XOL4RR{1y5)1GUKTawTjM9H*#90Vw z?G3$7HzciXZQ#r1K%+Phc4g+n78V+E>Yw3GV*=>DfhUOr^@#_=obw#Q8iwn9y-tzY zIgea*skU|2<6cwp7aDJtSpaYGO^)aeh#DshUkqBDE_77OHC9iO_Vv7;?4TjJR&ykD z$tXY~1uffaub-qb$fxN^7>~CMAd^?`y$ov314dEme8F}hstNb~IC0h_f$b?Sbf4x- z4F5w{BNB0t=KTyVy0}_2b1fzA`SbP1{JX9OtcZWyxcPkLCfH|NTEKNIu$x8r0lr3; zE75z9RPgpaPG#ulM=6I843>LnY79Wbl#4IBDM)+|X-5>&V|H}V*U7`9dVk>O^27P9 zO%49D44)Mq(2)y{@3})T?RLsN~Bz`-CN+&TB`Trm38M5NAB$mk`o zEH!HEJ5rxP?BSOqeV!%s1(y!Y^^@xm7h42c(nCFm#m)C9J+})&bxtFC(xFR&EruO zWluOq9(fOgnY?{B%6Q)x>sAO~XI!%Rz&oW7-Iaoio=pj2PNpj88C20sMa%X8&ZTdS zG)w))XJzvJ6|($X6iMAev!BHsTYQpn$td{Cl-^~hcY$8QXIr(vpxZMHA8~BY#>UA3 zqa-^;0*&NuF3kj5>%cBO72d58_9Vn`E#$E6ipQFZyMwAF!;vh0%abkKhzYy*A-pFz zGyUxy`t6mXD+k-Dn{I11KMTSvQHb8^p%_|S8d9hQE0O{1{;lBjn1hP#`idUh`2(S2 zdQ@=dFPt`@qHyDm%*EJf2(GO7s%7CAEN(oj)=E91TDEFcY%vy{q?uqsgt-10t7qr2q$U5c%*p6S3@k_7n2eNA}P_n-xH7S54;FK=mRTrxE+U8D-D zsoR%}j{*OIiJ)V*z?CrXG~Fr3>DEGqqlmsxyq*W{h*A{(Dr|z?4>V%z!3`5jujXtS&u$ef`U7z0VG( zF$Zpb6U1?rgJa+ipN$J4!7ufVOcsD+=hSH%$iO9>Z8rkm0>e+=SSKvyY&3J5e z>U=d=P0#MsGHJIU@#SMUUF*LjIb7KAV`c#BFsZy~TV~{h(@oQ)5QrW}=mF<5d=yTn z?&rr^`%ny)q0fFC97u|8D0c7q-$K>p^g6K4_jz&V;N<@-ZMgttdeH>zt#36{-%iRC z*wp-Jb8Da2b^P@jE|Y=~vLipmVN1h0Yt!r1YwXNgZ!^taYoy`bF=^ z_y`x0`oi9rw3$`zDEvuTgF+FL>V;BHZnd*!))Y>}YiSX!J-2(JUjBBSZngP#BxyZsp8Tq)7Cx95U;NrQVYiV^5ELotF5SkRH z18B(RQNzc(V8q^ia*t~wu*9u0;GXQYWyyv)59zARcObpxqd0R%j@64C6fEo)`wrgc zl?*xU4q+ctD3WFTqJ#f3si+@u`7Y$KQ8$rYeRhESveF(?a^m4@$V`~#c^hB3wQC!h)xC8u~;3LP{69LWdE0*yOl`M0RARi$W#CgMpro z&3b_D(Cc|~i(gi5>TSL2p2)8I+!SG~ufsHP7FWVaGLwMD(Q(r(0f-r>#HCgta6sHV zdbSR3gjU4$wOQCAWOv#0!tI%%I&2{G`*>Qm2X2yQ2nHh=^=J1APHgYN5a;`GYKl}* z5zVJ^Q#?(-j)}it z$uh&h6!o?vvqxk_sLl(iKW+^*JYP@52@yxi3~eihUcH{H^qg7#=IYBKHTKh z8s9JT+Co)Gl~oM5wFRk&?Zx`zH~rl@=1xlO@>;%LJd3sR3q3-bL-s3`gXIzB8-`s=2@6~h*W>Ok~wE6V+Yvh4o@U%Q1nQMKbu_~h3==1AvgM~|M=fK_Xyp`X9;H!tKK(%no^3;A7ncBX6 z*&gNGKg)6`>2+qIo}SXMT-To+P}tc)mmuR$Fa_r*MBNk5Z>oPv!_(a|Wm2QsU*@%7X za=441LQ&~kiEtMOlYM^B^Y4Q3Ze8-bnGXNfhd>(1V@*}F3nqW7#nVeDH2XlyMk*-z zm|^wj%HDUo;2HF@HlL*%>8kMczkiNgfeC=ZLnlsF| zn}PubGYdno5b{8NHYRly0dSzSo?95|tzQvc4zt{R?%fu!F`F9z;|RRgoM94~9!#gn zT}*(ky*V<%6kTryai$yQ9i}uTyAgS(U}2CJ(Cw+x-7tK_c0w5Dn$#mREf;GLm*%NG zma7-y=L6O|(+c2mw|ck12(8C)Fb+p>1P!wY?b{NB-(G=Hj3fELXew{@LTEuF8^hm| zn+E+B-`GPzJijmmB9ROz(}gC4*_WNlyN%HGzTk@8{q^IElqPc+>1hvJ)bzp-_-y^0 zk2xW1o9dk-@wIVhjoGt!eUhgR#ZA>pS;-rR!XTb`b65+v9s4A z4a%Z0ZnJbBU;ikqT_CDc2=%Jm&V;P>ajWspU3+!e)2n2l>lS7Z8_mFUkI6G(@n}>m z48!Xlm-K!n>$7xiLKqpa41}gwpeWViJjNS=xPmUAhQgpL@6^ z;Q<*LKLs?)V>j9Jemv(;@ur^qo@!=lYCShtJ$|QgjP|;!T%ejtU|d6d z@nO@zw>ibVm5zPUn{Vg@$+r5Iz%EiTu--Th7;5QiK(IM`zW=TqWw0SZeg1s*CzQYf zeFVdp{>>c}$`Q;dRLc39hX&gRO@2qykO5i8K7jCxwDg488vG zIUjj~TT{;pbkizAN-WzTd{}8$uJi$FYWqr^s!IX(b7uQ56RhaOGp*Bmk($_`Hvt%c z!Xny1a*-5#;MJu@Ukv_I061Zd3s%B0^w!B|DanfAn`%GhT-*tN9uH!8mal3|cl+on zm8x;@?!)rF$fpmZ@M$0Usb-R@F(tM7NpC}HF9M&o1ttkFEdUkn=`)e|Voy$T7(o^i z5Um8x)P2hIS^Oss_q~ARkY6Z)mz->Zf&lo?lX_i^c|R1dB^z2i;x0KYRVrNhSGxD3 z+X(73rvVmAgKHZJV6nS<+^rYV60aW;(7hDL!+}1HLGLoTaPn**9A?dy_QGyeW40{0 z1HzELEW`+QU|HUZ6|kcF(wmtr0QB&Frb$P2p8H)2279EK>;K#Vb;B@Nu_$cuL#YK- zZ;-tte^&v-oYfpo`r}mvTP8@^up6O2FHHsv^%mr-2f@^yn9`sP+2cb8c#h}AVc~G| zOT0l^raz9|eg~W;D&BVr$V1=E3d4-wD-GvUH5TJ3xyJzCYH`|tg8VIY0+gv|^8Ly$ zJtLpk(u0Ukg|vyQ`rer!^sn)H_MZodAc1eRuAtYxES%d!aVO|9KOcv4(S~*PswGtW zr^q947aJxBLw|v0iS`UUK3Njj=zny~gtC8M=*&l0t5}A%!@)uB+F5V! zkHlY44Q94N>NRdO94^_(P@YgCA0=H2rPjjDM0VQi(0?Y1ThYj|A{}j*|1fk3{!p?% zOWT2^6FkBb&iwW_EDwZ}Wj#mvfgTu?aX~a6*58yaw#&-)A3JtxKRN9AF)%4IxR>(-BWaE>+(3{CP#ZOX?6xTDjbkL3G~b?^XtzjBdL>v0-U}< z47`|>ltexsyTTeN8w~UqOGq)Wn;&_Ef*~C;Mna$XY*{C9PjCy{XhI`2@OY8I>wcp< zS+1Ms*A8qWQ53p7t>Aq-mY4aEPv}0mCSIHgz#KP-o=4KnBn4Lbi`O}K|G5YigfU*4*pBO1H_`E@ZO08y@Ek6|4=vln_mUdp>CJw{IGze z*IX<#@D5|h`+>L=+Xx9P@A?lvsN2XWpb`n93kFUZ8p(#l!OScC?G<5)1=g<(+ZzpT zlaKGIHw0`g@aVi@qz10?3Bm5jAKBK)q)%WOvcl1 z?N|SCJvP1(8OKS2-eRx3w-6cEce$W>f5N>@C?sKs;{t>Cgycw~pZ{x!?{D&5M(VTI z`(VmKRqvI`lp=JE5oCs(Fo95DlA;V|TJQvOYQ!}cpm5f(gm)k_1TQIG0(a=ZtwO?Rz8$$!V;?-me7mb8?JE*z&=nXRbat`%7jsHFR@Pite4| z*u`qMY-pZ$8YmIv(yNf%=Hwm*!C1;YM-F>YNw_2g4c9)-&Q^j+)dOEG9Fe(fT@4Jn$xgGY(1D0^X&f~d9fuk()oPOL23>dD=o&|c) zUkCf^HvY9h{y%unZs}&@dM$jl02t?jiV`)?AWq#2tqnn^?Cn$aeFKt zQ^d^I?%`E6%Jh80sDEb%Htj5A>(?vvprN=+Y31vMOOS;uq|Ezq3pa`bvFX#ncMKnq zv1)!(25EeAw3z*5RAU!Lah6*JjQ&gS-JqQ?rk|EUn}=OxvzC2aIbW_<&z} zPv=Dj>R?1%<_0mf1@JS*7R3j2$AgiPO#xqTu{6UNvcskhONXd~o0xqy0q^GEvviG( zK@y+X%~29SDtz2Q(V9h;miftFA#tfXd5FPFbF2Tt2+Q(4aYjG|zf&N!qWEIl8Kpqi zh|F4wdSFt8s*k}%`{>dx9CkJD5`2VNhRlu#EO0J_nc(JCJhz{r_7)*Q$@<%;S8gDf zX;I@&ffISZw74;{ZL!2Kf3-bTK!wS}@T~i*^Y_1CV3I;Bl+0F)#Z#JfE4YA`KOD{Z z2U$m6a8T$u0HSmhsiYxo18a3=wUfy+pEvb+bNe}dEX6Mw6<%cXDW#Sca~U4|QT5EQ zr?1S;V4(uICZ1J?Vun-fz$|h$rC>GV9PXV2Olk0CPZEWI8~qy0P5A-;xN@&)kEgNO zxo$~W0n@U)PDkuD!>S}1e;?E?gB(q}G=bS-{xYmor#FyYMsF{|tgY^kczvu_ZUGqO zZmq8@OKA9Ho#ADuI}<;Al(kjw%=zUmgPJy@@9!O*tH+O211KJ2sjK^?&jgJ0U9vGK zaa)@TqCxRJ$c?0{D=-g{nO#WdVkNNCeQ8AHA!DD#Io~Z0FQ=aCcBQ}MQ4nxB%uoH3 zIi!D|Eb2Ow=Qqd5V7YxOb4ND6oD*>wu2poK(kAHNByr3d9#4WX4eZWLzB5l#6f+&` z3{R_b78%YUbKz?4pRw!6TH)S>I#lmdAbsQO=*nVg9jd0(U_1p#YdS1;=Ci!YeLp&z zmPx6w$Te0Gwb|@;ip&q8R*o8@5sPX|zDU&P>}5Vm{9MT_49hF|(ZZdkc{SgY8#l9w zOlW2gB$=i(xXmwZ#%l3BwV|vf{^;B?aMkqf5ETL?0edtuDYZq?w%oy>*9}QapQu57 z$ECIMr&3~C;ov3h3ns$6lFmh51a+n4r9s2yYQUop>Zx!R7+xUGS@O;q_Vm;U3Ru?H zZsAS9G8%8MlPV=%ZD3?(X6D9_OB^mxGr)GB%75^^%5iL87o#sUJgT0Z9{Y6o;}lTI z=2-=8lyaBwhD7yO*-Onmoi!oZ7xW2%*)Mapi`}!ldZzfyhAev@vdGpe)Xhls{QyA5 ze*VZ1wY6QH<94@V@!4BQ<_Ki@Q$x!v-)gurL8c%MSqza(g7cpYvxSuHcNzL&tlWyL zXP-(9Nvd4c7#5K~`#GC=Ml3cSX`qzLRtRledsg_sP^;O#tU}!wwhHI&iv%CVOBF8C zPy0XbKpid+E5*0VWIQRkzMjyCKgo+OX6$G>eYIVuIvuY?& zCg++!HEe}Gc+Kis>Y2f615gpXX)36_b-zl+@`MVbGi&B-f4RoW{D{y!MmJSfruTPU z$ZO|Tw4~B}#*zqlkA-tU3?h+Gn>4rZkgW`b5$H+2{bB=zNXeNr~k7m5| z^{Kt2(}D6)$yvfH^U>!kmO+-U`24-3Ty-S=?fK6S#^~;mt{iZv_OXw`7qna=4fm;h z_E=u6Axat}^XcP*%qL}y3Pv_a3^ zi{Jy~e~H26RzpHTt=R`C9bRVpz4|WW;4Nh5_y)+Q0_#azK&#UV5PVK27z`T|$C`K} z(vxzIiIW6B&b?i|o({cuEVRyBfWG99&Du}FIvNx-{Ke36#%ZK}=-HejXeVB3{#u9J z9~0|kq@_v>s<-GCDiL%1zzUt3ebp!*cR4v1QCaKe$gvX{jI`I~f2lyiXaatIko6*+ z^E~G~IBDg(a%x8~2vl3%Jyx(;p6aHYj5{*TnI7@!Jfry(YE zr+jm9_Fi=beumlMl4w+@gY*znQO=&)Fr{@3iS<4ANK7rq`@-C7xSlu-RE#aJLv9k? zApV^5wBPFW#M75=mQ_^T9mpDg8;L))bGe+U11r?g6&z#+7?tx{i6jLAY02@d1k;hgD7-yq_Xn^ReZ9ISb%I3XcCr^munac8VrZejQRU z8U_=)6Ho^_EwzjST={mSX$cXg#@9d>yLzz~U`wLwK42YkgSXEoYo**ZC;*AFw`e8u zj0x+I!SGC^cv)0(ShMiQ3u(s!laxSBYHp5bFDN}w?z z{V);6&-`Y|~~058AnVzhj`8%`D62=wjl~;Q zRnOONL^oA|JWBdD-6R>gJc64aI`B_$b3kJmg(+ESp{U1Q%M5o0!OtYS=y4bXMa2*{ z%?fD!?z7s$?68P$^AleIed%?-9SCy&5u`6yH_mrle!fTOq|-F|9s>48GG73+f1I1` ze+TUSS1?zfXgr?{t_)TTZAa!kb_7n2Irv|Fy$}o0Ek<_jNOMBvfD+uPac<84>MMn8 zBGvl;^p)mgJfI2M3Jqp%q1vw(w48DXiI(RK85SARs;KwawZF{HM)@Pg zGmAg>Mv?PFj14{aqw14zXQBmt6&ewJWnf`GMeqmM5njbzt6hXY9ytlbfPCyih-f%G zH~ZVn6FrDv{D``1F|ar#M=-Ff{NrMqztJQ)2L0Zcksm9S%Cmcqi75V<2>j7B$#_H| z9qFG8=79TFT=5%V&N_Bj3+2K;C4aJUr@8^tFvs_a-eILh29-{-hkLRj>%Pbi)_v0H zr+H+ssqbt2+?52U*nOLKN(okc(|`=)9{@_Xmb8)fxY`_Md1QNQM6?{n=6Zz$XthIa zgVB+j#~@P2In4O#1!(E*{qSi;)%eKe672sB8-9RUEhr^P(B4M|75gQ=mH>>bu%$-~ zY%ZLVFQO2XY`xF*suP^M{pZ7rd|9}J&aDB*KWcI4lkA~?sV2#9RG6n$Z(8Y`qWQPi zUzbz>8V6P5hXxn^{zS|w9HU$UHwN55RZuPPat=-oe%W-g++BRbv4sI8R(V zI<-v&VjD|3>>+3~vqw^BUxGSwAu7U8Q5&WNG)iVmQ;q4QmzSdq`J|z8U39s--;Lwz z9U(t?kXJB@e|~UAVkv#08))48LeN_19tM?R*n{Vk9O)h1vy~%)VCE7Xqa#y&X^0_r zXapQQLeBbt=!dI#0HXfa(OUmYwzyK{LH?l%PnOOUjJPV{%`zM&W`GoWxZ7O zA}ZStFoqL}Dgv0wny0=aJN6^7V{i90M$G$lJ9Eky=BVgdB$PHQ?( zRFkvx0;1!icAKcC_Fm&x)Hj+QGPU$R1L>B4b|;1=IGGA+g)`okq~2mnZ6;kY3Ua@} zy=;^|_fvL^Y+%y9LP?=0TTE&A8ww4r3dAgk;t(3(g;&$b+T!RE^ZK8`tT8 z%^Sx=tnWi_h-*TdhlQWaUtnl(Fd0Z@JIMv9CMN{9Q$&u<*1Yng(0)azXR_#f+>I^3;lVoxxu^Ntq}dn8L}-- zCTvhov850=k?f4(ARnl3(y%CY=_}z}d&FT*4$epMAXig$aB!&7GM(E?B8uo*4j?nY zwV0@?AYmPk6RJ^Qy$UN^QFDcEB9{8?67@#{m8_=jA7}2n@YtPB#}YssHzS z%g|b;GuT1?9=ZjgV*Qi5pp_t~pBao`bx*7I!$CacJ|E_QKb5O8%pYLrZ3R{EK{!|89$=5z-RY2-zQ1rz~neXh?@bsB)&-+-TUY*#yV9 zcpyqX(<1Y{gLDYeWvyktBwQKeU|CZwJ0o(Dkpgyj?yw^Q(ICof1+w?IgN9lbSP zDE@oxgtQxIj_)B*h0knn1O?#xe-94-J(Bnb*@x~S2=I^xQ~i=M{JTH@+YdBuLo)kG z{a-!YC9roO?l_|Hr-0Ajoi5-5OUFOdcol<7j>>+(#H4kh_z1Gtv_Y>q-ne+39j?uEio-K)0a8Kj;HR-4YeQXE#unb$e zePU5J!Qax2PLD{S{<{9sp8(u|LttzVEMHDphL2S7L0__DcfadpwGjs#Bx$L?+`$Ii z=Ryjf!IM55-x$rQVclJTDuI;d(|-90XwC>C^g#iz5{s;;s4$;0I80uC@Lex%owDcd zz7y6{UHRpyuL-JDzatfdShK&T3JX!zqTtzUGx+Zl#<)r*VA=+T!E3Z`z3}Ol|KFyFr$Csk$@kV%aUf}kg;@**SH;61) z{?@LR=XdtlJiAG`%l7G6F>>J0MnVCQDCy9rr zR*-nKOfL(VRh$fTzpZg;_3KBG%g-t7oSgPmsnjfAbOs~PU+IijWxSm;dsEO;yHo}0@)#-18|b1+ z%p~@-UQL;Ml;VvDTD}ytN!8e`n5tEG=~ud4jG0y~j`v>t(o$m6Dq&tpN+oR)FEl*+ zvH``VRRKmYgXt8?kv|ycMT@K0h|6qzzL3WGaK9Awdy-QK#YB>KCc# zH(f)8Xf>_Ade9Mcc_!k(q*7m^Aam?>a_gK>=Q9Y8Y zoIvyV2#K#K)7Nl#mY<&)4L#eTP%XOyByogGzPZ*OICp)wz@rXqj|OEGLe;-aDiA5g ze?Z|K3<*;t2@+`*+sA?SUW-(ugTBdb$Z*Bwa;?$u5==cm@JvK1N+R}ZzGC$+91P)3O^`B$t28&VTK~+l zogfvbGahHiN2ECqOth)%&gD(rHrYA&mpEuX^RWcS%UHR5e0~STvStkKsYR8s3Vd4K zJ`+WSUGAWE#@xU>)&d8kJ42*c=^oxuwbVfie-D5ZcaVqQxh z31Ig9DxRby5PuurbAWq-r@q%9+ksj=);CFua1msEfmZcV6MG&(+oG;y8nB{8)gu?# z-bn)vCu>ag_W)^C9NuvBy`%&*4h-W6pvfA0D><(@=ZvKPVS+Kz@O41ugSMZHLQm@Wkm@~sZ%JDKSSXr%0or~*c+CA$4 z)+{Jn-H+;h-%sAQamUsA8hU=7VS3dOI6nv7^u*litL@$W61SN7B%S)p@;gs;PvwN! zd)HnXXZrBv%_DALrp18woCo3UTR`MJNqpFD!_%6@m!%&YnG~mb1%M1Z&lMVC>F}hh z_J<-6B9B@%=@5yy&)9S81Y9wGS1yuur~7qSVo#UkMd`J%m{~6=bsJvn6T{c)lvw=S z`K2xco$^*Qtk>Zwb>@PV`;F>RdHie28_hE0!YA&BNEz@(p@`B5d`PeN=ulhAk|ld zP`&Xq|0(yvhJ`opc{gaBMt)S)8{$pNu0@rVmvdeS8njLd-B(KKE1Jl-#6~u{2smMMcOyp|%ng;$x8sBLjWKDostL;P;!M^gD#h1Y4RLk^} zh!Z3y4m$+)%y)KeuuFK^HM9HxV-vwCiGr5IE9^&jZLki{Kh6Vu5uhw4p$J6u_wCHc z24TR7pboBMA0`ijyBV?%VSpb*Y^Mi1)87;F@!9-L7hW;Yn=Dm<0$V~l$?5CpGo~zF z15&}lH-G8i(&Zb^mb5k2^IoPtH0&UNf@~c895oZNCPdlMcIa7!JGjh;66!ESIHFv` zXLqn*12B=ByIyfL5GM0p#^TrI&#hIhN&D_ZKGo^rP6 zX70UMZRGywj4enInmN>PpEfSXx%x@vKt}gcLm8M!=nGxCi*%bge02fD~Uga zB*b+D-fjvnwMXO_lDLb;?C4iXj!n?^4vm3O>ROV~xe2##JWZa8i4}b(l3W@|%7{83 z9{sy5RDq!HY6Aot5y1Ymy)yN^mFF?#H@Zp7)jD0h93!XZ)05llLO^_gRKnXFTi_IEb3c-xug=r(<$Yy%$ zKfakF*+L6Cdaia++jd!>H>V#Rs841K1h{A!=VG`q<0r7_9G$dbK{sGB@Y7j{IrVqR zsCc#$KXwpcJc?t(wBfo7sb8I!r$%MGpSZ>UiqGFS`vW#LhQ6fW&bzLzSXJ5eW&)l$ zvlrWJtw88VEwM80zmlzJ?4(7g5DBw)C^fMb&$6;uci}xi59FO990BXcUz`bQLhh&? z%kLy$JJ(U9d~aAthsEj zxGa>WZD~3KTRW-!G8=+KbEdPnFYUh#UPi)lth8r?p>k=NkohjIM{O#r;~pE$co&tdN;SVN`69;^#5}_C5T( z!EO)g+{V?#*C#W_qcsG1n;I!o^&2YQeQ%=UP(FNv#`Ing3;Ft<2HP}$&xO`yV0NU- z@{7Z4=<&8Q?Wcq&xb6ihkn^F3+*$=hycewX`fk727YvT0C}{62$3$8`~Tm5o+vHB`mZKLuSo7O);&j#Pg~1N!G@(2Rw&3BSq< zM8lVg>HI*3pj+e1DNFp5l3^m^sGLq}*jgDV@tU_lXft~x$ea{dWyqz~j7cv|*3?Jh zmvw-=|7quQ#h)!Bq?ZGf6a>>BE!+P{p>bC*^ai+l?SY{0=-9+e$^I3roz#jg>Q*nJ z(%V9N_$*H_2t56?jALn9njENf`IeM>g`Z;8{3_*@uaCYigHo*gTyyV{UzAFX8yY{w zQN8krIBJIChOB$qS7;$9S(Z)%n(rG9gms?Jy+)7-T0{(aR(Q^uf;+o|_1eNXWlB&5 z8!bz4ky#~?h~;-+)&vVTZtxk?>#O(oeKYZt7Lh3&JSy!|_5g+j^!NAgAP-Kbo)n^) zJWz1%SIP{*IH^C(WfM*vzW4?lFGCo%8@wDl-+Mdz?=nUHmB%C<_!5UjgU>07Iz5V;;EN(CFAlGEw-! z>o&a&2)<>1T?>Ms=*O?$RR}b)94DCAL4`PJdjLri^A93Cjq`4f7@A-6F9Je-n4kgc zh(91LbC5$KjV(bDghAS7h1~RGNJQHIUloyl)kz+u%i}_OaGGVG;6NW^yDAJ`4-f)h zjq4tUqbsQqwbFpoR8=xP0{MZfXceN>OS-X;C8uphUN5)*s@Dq^=zlV)NRB{*v{Atx z4x0wX!N2Fa|MxxEDDdK9Tmlv!xj`1-ov#8IP2;{`Fu~AI_5O0Knw0Zs@bD#L0B%fw zV(-sx?QR9w|M={Ky+?KyXNVQ&Gqol5_?WSC!x;u zv+^1=C+3T|?hutOy|}v%kut8qOdSjOk&2WcVu}i*>ut@Xv($Wahb}&~y7N;l091P= zDI3PjA+V=#gV`~yuz7zzdY_kdG_sM&Ymg0Lq>Y2Qg6G9MMGD;4!L$*f-78XFfwZPk z28cQ`8-49W*zI8ik6Y*#`Ah=s>d<@uH{x{Q2R0enf6IyT%x`?W^HI#My3}H0nS<=V zx0(@Y0P<5KCirNYeW<}Q!x;2;oIv%-_uBLJR?s8*ig1*Q9l)d3^A+om* z)L#R>$b1AWC9M8x@4WC-yVCjRoVu^S@BUwS2}>E{5Gq48F118+B3TELySUyzYYe~#(z-9 z|NRPI|8HD?KW!%P*Yo>#H2wdNtjtf(>2E-9&l;$!ZqPgq4e0EB^$iLm^Z4Y$Yv5iz!DDxTH{ebFk zZPI=c%yxA@GaiD>nyc)h*#RgIeDYp-?C(ICdwYt458uBeQBH*cS>7GU9y> zgXVmYcJ+Nkz)9IH5_BreoLvoq(0f!G%Q4GfF4c-;0|#U`ud}03%eREs@@CK#@N zpLYpQo31VtHBAp^zA;MX-CHxv2}WEd!GxS{k%J#9UD5_Yix#5mL*&hkrIXLMwE+Iv zNGQ1x)Ex9&wCol8)R{&Zmwch3o%?JM0u!R+@{Ui{O2j{mY2fC{$=H!*TRiRoQuc0HAwJZ-Jbb}W=1AK9rb`Q}&UItXVJ$3GqbVdE>N zn{Q8WJ-POt9pPY}g!Y2d4IwcIf)a;xN%qioaRbxU7G$y(y9x#3-_?RpJ)wuyGVKZ6 zzCo}bYk9+fSQK4?+p_(@o3JQlq4-V^e}ltBuk|-B0UU_(aNY)b zZ%hBt;M_idjh=PE@zWiQS?x?i;z*vA%v{VEu-CoqNWQU0y^J-`?#W^O8EA4G>{f zS{_<|w9UIcGt;+LuI#C7Q{W}lBGYqvypyS>?3%H=WQ}eg6ff`${y?Sq`+t?AL<%eF zpDYNoNDN1WqG5y@(D5 zJ(ot`R`SV2EZxwtAX(TZHWY<*(ecGYdmuY64%@}IhI$(#VqWi8y$Pg{xkx1m4dRtv zJX-B;ej~OB6p>9_&Qwv(rAV|pXuk4R5JsW926F(d~4nHb)l%k~Lp}M?} zwM{a@q7Dhds%x&V7=C##X^u>f*>YCno0~)@4uiuSaXxT+LvfBYr{~jckGqZtWGnYr zbg#b`VnkR|iF=am8C?2$QwHghEjV zRwk@=;jNW4TFLY?yb|gQ)7pd%f4+I2?n5=iYTv0lm4D_!ep6aT_=0fLa!Cg$Gtx%c zhr!t5kzC(MJT64NFA(v)lawL~wpy|{ctQ2S%^o>CuEx^o1;Ut<+e1A)ahvZYFV}%X zAQSU}ggHHvng!vzeWs)<U%gojX{R zz|+p8Sc<~njEbUX2P)4IP;Bkudjmy*Cepx?TUrBMOy>p@mS1hA3sv5~1v246+t2WFKUwXi-_xP}yVbMieo!v`A>N zi-;^`i^!DS_qtWja?Z1!b3W(y$M5`82{Z3`FZcbruIsgUJ`3l|KmKCl%96YMblW@; z6ImEMTj*BO#j@1BGDDs!;4~=HmZ0@m;1^tEnYrVGcN}PEe3#FAxmSi@+{PYW@?)4B zZWW#Odj(3rdG-`0Iws9uD*Xb}5~-?;p!8FOMI2eFU3I9OhI53W9n{jBRHd1D!p1B~ zS7`qx>VbJzzKzC&q*@W(`L#SEY}+-%TUuJsG7TY7Hi>10kb#6m5l%3@9IDg~Bf@l# zC~tnJy?3s`TCZ)es5jJ(Gn+8ql5-?d0j9!im;h`Td6Xay+O{m{mcVP57!c3oi(oD2foWSDeEPy>@~hP z7#Yg?^MGI0bfW3#MkG+PNCWHVDsgzsf5R^Ti*6dkllE))Jv+2;G9{XfG>(0e%O_(J zGSUrp@RK~!ynN)5Iv5o+mH+{B@n0J1(O&i?2p4 zrqdq_Uj{~^di&Uh6R~_KcEvilVDcsY)C!q%@=O!icVDWnKR&z}mcHsYlj+1ba=$jd zW3Xm=%-nStQ+PNf>yhe-9Oo1vJHc~rA*5;GjLhB( z|AJo|xc-+CNVGWY!fBZI%Y~`)?eJFP$7I`j8d!=Cs;^3E&@(yR^W+lu=sjGUPXC*N zXqC$x{Ank63epxWwAR&x7*gItas*o(jy}^iOl9N{r9n<_x7OGssj8>)@*7gYX}QwQ zk4S0SVV^BKsQy*mCiA+ES8a#72=)l1dhRF=_Qb~7sANNgj3Jt7F?(#;V{?HJOz59G zx0gN}nsoVR^X|kze^P?-XfHVS-biP9BiMkmO1|47)j$-#zTYv3fFbPTz6GYqf7{hY zump5>yFhohn`X1Vles zf0OL?{}TxRyM}T9tMUG7jh8smfbw>K@@TnZ^?2j^`A?76){1+*J@p7V@Hm`8W}x_Y@ljY^8W|u7(e+Vf-__^8Qfbk4%~nsA%Abb3~N%? z0o*ut-hX~9TMD<~41U;vBSy?7MA)=wS493~`gL-HILyNxbH~5K_DCvGPNw{|;J>dC z{3C}eKQJe&l`I=yQ~dRYQuyuHDE7ri12qcdOnJt$;-drAb;|tfisfOsXZDU@oCDt(0XU@7K zPPb9uj$@a6G2km}z}?`QoVK@&PnJET0_;%_lt1)_;U7n){fs0dNi{bttq>O@C z#S$s4##2cQKJ&vC(GcVQ3?xlV&5|$LwyX`d9~fywgCTR)1C|?Hw9Jg@ z1aPxF+jl}6n9fc{868K;Cu)RTUdesk)^(z#^&`x8>ta!CdNHtWm;A_nF{uwwWTw-j zIYeUhO-a}c(y2?&2nfh~1aI7T#%cB#4fW#;gMwUx8vXG%qw0hP@tH!X)A;>|>(hZ` zRiIvO)Lfc*2!E<{()pY;Z|b%`t8Tv408&Wpy9|2-h$H}V?CBcRK7Fflyp5%YfJu0g zlVo5zG?*7)1`~5nuV@S=#j9Q5V_BM;F-^7}Mg3JLJU;oIkUaE;N5yCpx8YyQDpgDe zkfNk@z6_OM*8>y_)IQpb@rt|j9Rv@=kbzzcR^ za;Q`_C5!ONR*p0q&3jZe=(nnwe=K)c_@QYbc+5r+RdbcR-_?^)ab5GJv+!EE!&k!f z3+uT~ITKw0RAphcG8BovTvj?_IQ85#x6aPNOcUBczudAJ+X;qBpzmR}3R3>k8!roF zhL2jryHsoPN+RX~R-F{~5frO8pT|gwMx+_s&U82MeqcGn@c2;V_JYfJxoU&Kx1Bi} zW6wxo!rA>IrbO@5Fq!9TVcAt(Zd#U;7ZEwX z4}1diQR(P#GU0Z7M`JI2npRBIzMe6N$%zJQYBglQ!tZgn<}F4@)*C=fSG;^rZcEjQ zRBv|yGm@AQ0J%k~&&SeRMnqqq+vIlviluZANw102Ad#|_&Irka#~=~4)}ejh2aeyX zmkc|)J6vB8dqZWlK`zj1=}{OIuq~Gq6BA()bFSS;j^BURy<3sn~B?gFukfI9wr-Nfl}afOV|m=cmogWFcd;ev-tlgCAdysZjjUIHsMRjcti+vP&%nduMMD8RU#Gfev@RRO zW?sL8Rmr{ATI05+ySM2Y+jmX}P!alC_p?52ZOwwIoK}j^{6ldV$$eK$fEPdcb*Xk% zE{S^KAXG+^CecUx5hpA@yX2MuDJx0&LJdft16g;|l%6YC__PA%!QoU+8F;*;U5`(_ zXyBs*%_jtT9iW(i-^t53U3r}!!U#xXQBHJkf(i5xkYTo%jbHvUdfRYN-2&+_!7PmX zxR7iXmn6s`QiO!|wmm_9A!%pYxM<(POuY2QJ~3UMc}ZZ_1kFMNNw)Kax(fe%PUECD z&Wyf^NFWV2${BPZ--&CS3!&@<$_=jt;i5@ANbOq6*N~aps%FiE28VN_!?lR)7mGk zZXnWMJbid0JRPJ(9T~}n(@a2MJ{6to2+{F2@rcg+AGU&q>$mBs?}Kh2roPHCwtHNe zNxM#Wa0rMV<_*&z@iL7>%Iu0njdrmH+@W)ei^sqo`9ELvsm032J2s^s-goWQbo0T$ zeT>%N%^eos2eRXRY{`X;aJ|_~#&c9CA)<|SAfRR188I~jo(H1(jhB#VN0*qTzF}JfZZH>ikOm9dmo&U)(rTtN=q@UUrCl8*xM2iN{)5TO zU*Z}N$z_uy(P~)5x*u@R!;sdA5hVAfevtUk+GL5f$T2O}Q@ygD5B4eXxT-A-eJTO6 zX8kJiSAe~0)yLw>xg=|T3bJOazVH*A9fMe%nFU)Y`Hyv;!f6JOt@L&}-@f9cRqVSU~8=pycyOSgrRq5Invlv)FxD?>!;oAN2MyN& zEUb{2xSW^3K#ExH&6ARK=X16D-)K9`jhs-3^q;HpzYgV!*AF@eVoOX!Cd?f`l9+EE z)o=@g8DZP~S}Zl^@vFDSU=ckXLu z78$#P=BYb){%RiA7W^7B``MoI=~;OmheOsHEP(Cmg3 z)aYZO(yH5a;15#%zN60IzjCJDbd!r%C31^7}3 zY4El|wekJCO&ZLRm$`WK_a7K;=gxRI`xFHm!r zIHy33c7nlBHS$dXUJxzRcFSnC(!wB%sIMc37|7o}Br1S6O9I_wz8|Db0Ei!(XsW$g z0i2yaXmo0rk2xt;(9@I_IuyNI0jtSE54f@g1)x-9_mS6p$owYhupTW$d_}WqOYH|t zXRJrtzaDOjS5e?^Vhn`Vn%z!;Y5Tx_+Xgzh6XRk24}e)JLpR3);qy)tCY}p()4)FE zKS+yw(uDzUk;@lmcxRJ$FtEo}0LvEXW^XH$BtToazKXGM(PFNLv-*`X%BAUZlZ7rW zT4@pD>i~ZsL>JnVB2=sBYkwbTxHrY^q6XIHNiEr+8s%GG$~GxbFLdlO@8BB%UzumY z72v6%V)0-?IneZzep3J#YCtbN_w?&KfsXsuJ6*QPSV;8x*2BJKq80=db6Elpdo z>j}%adTn94$(Z+8Gy9IB-BA%Y9*2Wpc9nTK=?52J$vd0j$@z|uLLX3RHvnz^**-2S zwmKf$Ogab)e12yWNtS_5@t2M4Wu0|O=09k+U|rwwz$8(G?)LV?rNpvG3#n#{_IFOo zmj5hlyhU&w(-A6>2J4 zD1X>y=S{V2HLHw1RR9R!Zz(Z;LSC?Zx;|kKP`n2(d;6*c#+n=K~kStt4ew+~v3b~YbtGu9_93~=%ihHLT zZRIZnv+Uwa%q8)7kL*UCftuRKcGB5y|5T9ctA)}X7C)_B)CKE{E0-%E4NMg652i4~ zbYAmxFE^+iA`s^la`SlEqylw(hxAYGqt-wnBxQ)do@6q z5k!cqb`?t22!|#B@B)cYl$t;q`QD|DLak`Iut%p`^uPxR-_DmPiDB>wo6dDW&cYqr zcY3t^BUt$jDDWFI`@nBzZkJSkfP)|V_Ye1qpV7~+UvL48*)Vw8pRm!dzxxwt`Nv;h z4ya(o9i#7_S%2}D0Of$};5Ux`4^=+_Gyr^-8}aQl1IxGP@p4DpKel7^j!c4O)%tZs zkQE0mYSSTeV2zjd?xygCWpp*#-3T1$YfG!3B8tdO|9PdhB@Fvrp7C9{SmqbE&(o#5 zvmxG|7IbLWQOn6N$Hd0l?#nqvC4jb~rbW67U`@K84iqo2rz#^Df}B?(=iB!B&>|dw zG%r8_diW`Z^q9hUWs{_~w#?u*Pp|+RdV7v-o<(Z1PT2;uIY{y~yW=2+f&E5BUe#vA z-kBKG@uz$jzCelva*u~`b6S0l6c5C|DOoNq%)5Y@Mm36c!JB*XU*Tc}vvNPat!kmy z6Bg$_xJ*yV&`nZpyUKiRU>YyxHq>OIbIfcT z-P150QRVZiBOp-ifEeqsAXPX$!)vd(k9KTWa%88O?;tfGudl7pVbf$xzmnY03~*3O z$Hq61;mU?Rs$ges4Va96h!UIgWw=%6*M=K3MEgljb`D`9OD7JEV_SDwRxCSp>QqFr z>xZWj8$T=ZG5}Dff??Trm#&R|T@Yg704R;uKm-|ig2 z4F0kWN)+2GJSS$6jboVGMI!XWHTlW$AjzoN^W+rzs?t#hno^!0aNr&yI`Q5ug8clZ zv#KY6Frwt_2v`Z2u3RD))a>jcc>G%4{p)$D5Pdi~+j8U{7-t+ajUaFAt!i6<(O2Vd*cylyZ#{9!5KH{P69TSWkH;Q1hozwZg}khE1E!UR zt^>*)ms-hAP$>US)QRotakSneT{DW#nOx~GxaThJ+AWAUnvjrNYK5}8qhzHk+_Htr z<0GF7gS@-;cCXG0i-l1&II<&Yd3%~t}E@xeSWrmp`m9_b)u zmiXzv8-}RXNN^;|@lAaZBUy_a5Ms;0lQGkENMR`M4io}j(ol3-gX@TxbI+5M=yPl3 zr3Uw(XxuvgwPthU{Szk|sKnKG=O{J&wFkYIjJ-XpWZypQr62Z@gu;%EE6o#WptwDC z=_ANzL$=l&2QYd?JRR^Rd=(8}xjY;#6>K1S^to|Dp!+6nfv9k}vlx|g#l-&d8Oy7Y z0}pXdOn8IZaK`Gr5J%}gxC0Xl1#j##x#m$5(kwKiw}0Sre!_a`*eGs~5KGk{NHjaL}Z~UZUjQ*0Zy5 zv(tDO?H@QdOlXLVmyN#p=4-s`Ol)HpS$)IJ(a-xne7<+a#;%%Z-OxFE{(Vzj@-;1A{xl%vWC| zC@2h(UYlMU&a%Y&Xj}1;^JTYK;MpiOtq*+P?o1L&NW*)M1(C6m*1;|G3}((3ZgB8| zpTO&RDx+Dk!d7nXb(DsrlPA_F;oU*Zc79n>)~@$PgCY!OIP5bj!#xqjftr`xN&_{a zcSEs3WP)J+c?^vb-tfkbvjNWV4DU8>*4AVqf_z#kztv|es z)3VxHplTH^)K)-ohr6_)uC8u!TUOCpDjqYb=exaCb73CFktQGUIY~-*;9A);Me)yG zRW{4i=Gv$61utw#`jV`4#5qwtF2QG}1?)+8!t7aO#ya;=8lke_nm2M+zole_wZwc4 zAIUQ^%E>R`^GBb)>$z{|?j#`#fwVM7CA=4xasL2q5V=TJa}^6kZ0E?rOc1#vAtIES z(QHun-rW^RLb5Ln7?lI+aO+*O37l}gFnwNhCY*4pJ}~nUY^sdaFiLnCcH_q(%aVkI zp0n?-D1uW}b8*#UP3Ld{KYnu;>Z8`)%KeE`%|7F;2{3jU5W}#9gtaIgsWiu}x8PK$ z+~MgPwps3$`A#X@ru5^vQ$j7dGX;;98AvB(S$FU7t1;N^OTDE?HOPL1-}3YW$12^7 zT>i%=h7K83hqu+w8C+Ewt{J`PW2QBLwfOwS^L`N7C*Hijl#Pfn)IB^EEHs@6J_3-&0-8e=n;U(ZQcw4vDQQ(uvdN81mE|bXu zcfqrbhI9;O##X5ev`^ty!Ks?Ar(nMrq&;F9&-w(b!B(tgO8iCQYI@QdGmLk;q1B5= zX$LEHp6Y$zx3DqNOg6I2Xs9DH$pVwGye*P^tpFD;Y(IeYTmvU+bXYHUI{}x;{=sIa z;sAD-(fUY29jDT z4&fh|-^rhyI|+A^SZ__{44jQYN$M#TCA_>=?JILevuSC`1j=?of8)L9lj;LCSF-G~ z)=^ySx2TO>s3R)ez1=thzha}XoKuFE(EkX?V%Bg-?x`Ao@Eq~%R1^mxa2vRkr7P^k zsfk&q#6P-+)`C_FVQ`&XzbzOp)O$h)A`*BP65cZgT6M)O6}l(Jjm`{*=8yXN zmJ&u@9}bao7MhlMZ0$Hc%ox@(29djsL&Nluxk3gyFR=SU=;M1V^ySCx*pFR6zz7WH z`v(dxRDUuNyGS~F%FWG9Yx8&kq_2dHguEc_8o-qI?DC^OX5*nG57&_Rs(7}@4$g$O zmc^?e@}zOT9$E-GHl)HwzRBV4@2i9#eRWXn0$MHFjnCB)xld#U@xdj$B5g=n1y_d2 zMUFNHp2K|C3-Cv8b~00v5O+wnl}b0H0pZv;>UME`P+UgiPv6se$9MQh7uJ)_v1~dO zx=2{2slItZj?u&0ox^v0*&y$8M*o@m{4FoHx8PBhEQ-hBRLY|>En=jckFsx6Uy;%z zJrv^!Li1<{?z_)mmXTZaP{_^P=Si-J=F5Z4x}}wYxl?vI)Hf}WWCI3a=3UJ#Ern-n zEc5D!nMaD$sCL!e_;>Nw^~DH=uU%cr)nYU{(lSY2TJlt(v9A+Q1R=_!OZ%xbqGq1Y zw9Db75@3}T_Ss3X1`5;3PxrAwzRG#f@*RS7!4YAT#N+2_*Y5kI$nIje7}~E`5ftD> zdH=P1(bx0S!m_u9(By>O%j?SWm892Qj&tR=^S8^4MkuOlJprDD4Nlo z<?B0S!svScn0W0AMEnKJyctE-^n<5!O+LoclqNvwbP$yfy8D_T|1LmrH!qv?b5viXV@4jyqp^OjaCTb@{ z7bisdJxGu6$hQH}Lw$XHt6QD7&>Ayv$q)|8z=GH{{nEo4>O13miZ52vi%Ok99RaOb6p*tT7fMg@ z7!yGe@W{!!is>{rjVmoUmPC|K$CO8?@%S1%4du2Y>%PPyzljJUMP>o{OKMn-zQ0ns4Lp#E;?BBi^6QLU019fA2)CsM%bPxx*E|?4f zE#3R?-!mcy%mhYdW@1mBJ}vCQNWQxb(pN4B)>)XD*=KCAVflnlgyKNVf5GRbq+@(} zOycJddKr&V;me$&QDCcpd%&>@?tcv$48^vU9GAW_6_^g2wtg+=FrIZB|*S&S=3(5tHA@#A}I5%&EhPoyJJ24%7@?6f_Kk7i0QF zTXek+w@jJfvnq(p#iP6IBfPuiMT|pW9WFQ^-c);_CUXBJz&ifNRnppE@2T-yAwq!n z2nKJFXMl`GG^5c*#f^iVUe|h!5d2p*1TWL{(pJJ#e;89{0(z*q0W}5N`jtsSy~#<- zXbtH@IVf0;!jMf{2{vvA*s~Pj1kj(MF;ySH2Jp$0(JSFY*9r!FVKAfL^@Qm@EHFxn zIwAngsuLN^ruPWSxG4c#V>|Zj0izQBW>~-qS_C&wRKUSV4W}yscH3fS1W3mw_~sUd z^_(Yn5-^L&4}y%Tc_Y4 z8zm&>(qlZTgvS>IVKH~7GZ@H(ta_NL)?8Z!aPVdb+a4%zh~vw|M05tQy)=D^`;xM_ zR!jHpTt}%nvyAyVT!0D|;d^lHY4cOpamx_Gff;zn&8;96W4t2J2|!G+?3=x^TM0zf z%dV^kMFF^!8cX9@C|I?fF?N9JdbOLy(54gkl%GLLP#12khxT>rXc?>#OkGY;kK%_* zEnH|RvW0+oE*RGdcijm!HqB!};YdDVCJQTh)G4AHCC_f93Xv`;1M0S)e7H7kb(DZVA-^ zY*9pNJ4;fQfoZHMsu#uTinbBqZv)f)@tOnJXL*IM+2NhuYr+!`LEvBDNb(Z`S8=mY zT&y5-JRg-Ejr_k?QwjAxVOQief+gi)s6^3Kc#IuVG9(TRU@@Em(SRZ|SML=$1ZNnF z!G{a5QJ7q^cS@+hJ4v(s^|j@b4rEa*xl}?+(VDbbg+;OAN(F*1Fk(#WfIR5qOn0y_ zy%lom^8I?~RlJ;v@7D0;G|}`+piaX6R#Q{cGh}iVeS{>roEEX#M9e79)<||(TDnCY zQ0#+gd$13RQ-U^OMIa<1uh}H=tcu597_4>o=F4BEh~7C`$%MFi)*yBmmDIRkvkH+} zP|p-4*VUMxTlJ9vwm&n}Z^Q~#!Jd_~s>5qIM-0NLV2;1uK$_zQSim9j?QK87kmWRV zldIC}nwv88Nfe4n*-UfpkZ46nM8y%uQhtqS5hCOQA4qs3-GR|{m6@Mx?7wA4c1D{3 zx9fpJ<2 z36Wi3pFEAY)Nf)-*V`cT5yH}C`{fX)(YujPJOzeD6L zSO!TOnp#}Y^y${EjfcCQ^uQVPr$=6D!>zf|!0wqYVU&S)(4=efw*(%i#m0>r#WHjb z)2U;06Yx-biK4D1-w-&y;6)+<#2jh0Z9}tNQ+JR@G z+_IWb4sB+DfS+wlX7;b|JUj=+>ZXARwc>D?{o^h)JIz~@lvf(V{KEi`Ka#D!gKmy} zpd}~fdBRP`=gWU^0Te7iQuX1(iUE_$0ZdsU<_~UsisR7Y*q=xWU@`-Qs$F=xZ42-y zE<6iIl#Jw8!+`ig7i!*-6~XBYCDq>Eyzg2x6tQWMQ0@lpq47|EzxIta| zi(VGOt^KCQp?NEzzh$4&2mqdo`fheQ&|$iz#?c8_L#fkGO9}twMQzT(flO0ra&0pF z=05Gx{&+?+XC7WlL%;#XU1!|>x8na_t@uBoN%)7kkB5$nh zVQkF0DM;S5uDQOWei5Z;>Dw5!9uC9^86E_Qd_U|_gnP>E6K0COQEvkf zJPZ`)i)*10XP-}`QIn@{^3P2Gk9?QMYb5*Fcm+zz5HSH>HVWc~`mC!K9PR=}->w}i zcy7g-2@f_xXaIj8j5JYX1~%H%Q-H&37B}QCM<^vwjNafG@|>t|9unaH(JgKqrpG0oghniQU&If@ zLZv*V4~O+pS$y8)aX{=fxuxq5waj|JYX2fuFnFltNcoRVr6nrSLdm}yGu zgE_|4h5L4`B8PJo&VbcO%sk-(?5MZorVmoX=MHuDwT890MvIu;#`9$+Y}C~u9ag|_ zew~Mlv3Jkm+4eGD*<4QH&zt+i{tQli(ubWT!8O@#=@T*08>~MClAy!8)Pt||IO%a^ z>sh4&b966#Qcr*$*s&&emc335KM} z9UGowJ062p>`nGsDwRT^q}uhcw1L*6|6Zf^<(IgJI}3Q+(l=(Vb?b!AGh1*Lq*-)M zQXf%!%l)BYePqoQoD^0>?T>ncOK32b4Vvd22Tw8}Bw2A!k&8pmYAZ%YPtA%&ojx4m zfjdVs4p-v`k@G-4kV*zJaOLwK9g~;g=jgKfys#%hUXng=3hz9C^$RgjR#s-8f`N>= zV|rO3P%l$AI+tSyFk}03l9lv_IslQV`d_u{e?N>jng82Yb@bBgJZb3 zcd*5T4^^i8Q627`5KZI<0Sl`ebJRzQhFsx#xf_M|HD#@7g+AHc<1a$u^@yu&D!V8#!fOEdz~`YI#O8q8Rb?tEEmEqL7X%Fw>cGNC9e|G*F<@mD!PtpY|IL zz6huQTRc7x7_w6dYRq(+4C${LP;PmD`QmK(QZM`AQ&h@1id7_!*S}i&yq-PWi|Ag|Fq&fP_W8-dvvP zc=?W80hHuEkUL%3JQ4m43%edmhQ< zypjM~ckizQhYnYUTAw^5H>h4}zH2(OtWP``n(#@xJ_=2Ten}CcdOaNPt-60Q@6Pde zj3gL5eL~}>x||qaWTRH@?|*i+!_{Di5I93wFzDf=DlhMSdiAm330ma~%tVNETmv(K7eT?m;r zbp|R?{Rb*2p49yNo$!is!j^!Y_3-!)zbGPt$fpnKucWyP4T0w~g@s=48dICPbZ+e0 z-_trXUEW_ZeZeM?wV)*e$&MYJw z+&fchX%#l!g=~&rcs+B-oX&)n#eZj>x?^~;@~JKLR&|Bp1H%VT5k(62@JsOo4xXI(Z3kd9MG+~!aE8Y@JnMC9 zq<9aDVTZDdznVAwv3KyFB=nHR9GEYFX#^~;1g_^WK+t{q82T>?hNi!jyx+&feV zOF)7BlMO_`xS7vIgR&USf_GIGeudVG{Z{--SaNH&4Ln{6MUK2?wGWJ3pKsFV>w;@G z@;u>pTBQ9!yD9QJL+XYgvcYRx2v3>- zF1|@q`5gwc4Lob+2}$=W}|_qjy{b?`RJ1_<8H? zhYF~<{51y}R9&C%=fUTbxc=Gf9Grj;x$e-Au|A-I9{*2jOGJejsF`+`_p;dri>>A{a4Q`bOM@NTQ$I@ysx!(a1k+%1qy$)wz@2s=e_bEsT-0V(U zcT(UgEj+*ZuaE&Sl(=rjlIxC1`28>C&f0b8eP zQxh3_v*ItCV)zKeTUS=;!E>k1_;fG>E*5F~s!>{KrCz-^0C(!&d&;|sIUrOGv08k-|OCg`h~j++PrUfM}-FrYqPj0aE< z3*r`*4eN9r7mV&$1_~SJZ~M0UcY1W~JQ3@B9>{kso!iAd+q( zbfIrL*F!b-yHn=x-%wod){W~y#E+jY? zF8p50!n1$gBJGZYb!SXf^)Ul)I6lyNY6u4X*O04PF8j!)Uv+AK-68$amJQT|W45W$ zaRw;PTdK%aMgfv=gT-^qpMF|&Y`S@{4u>$_HSPwsVK^Ax)h^DxTC{FlhGSJ!yj%e& z&KkzED0g7zFoX~?^r>}2^aCq3vmR#KA5JumG-(6^+NlO&2Z#_YGlIno^p7fmlCLZA|g(>}CG*>x%S>R0*V9@JI$MWpJlA|s_L0E#G zrO2zW3gQ%f&Fz7_e7ci@gP}Zr$R?KaVg+=fN%&mzeCW0+x<8RHWz$U{0SRwY@KGtm z`CsUC>#m?_%R6@AQonKIavJJ|N*L5%qU{4jy_!o(H#0LcB`VjT`EqAh}mfE!MlUQ>s^v1DGI?F3Ap(UH?3u$;R> z8~9cBz+P`SlD1bB!ORS1#k=Ue7>r^6j~iU~D?Sta7v^{fuO$E=qVrKEUY2Zl3@p_) zbv%XVRZA>2b*??(6dNJGkWP3j+ia*PO-o>+ao0N0^kMi z%O0ns*xL*{0I8=3x(45dml^Ok zsfTI88n(00g38ptyFdJbD!4%)bs6nLxQ0yb_a53`K|7#U0qlSoMN-A9;Y8UaIv>Kq z-x)<`_uZ_+g&(ue+ws3k_gho`|6RI&`>C^p#tkfis>n9?M|*VY-CBP^(FdQ-0*SB& z+M_CHq8%k{yaoB;oBGdFAC5*`4d!#2`eX%wBnsH@NPE5MY3gg0YFcPDCJ;WhwgQ0AY(n4dt$Cjt1K4#vO!3jvBu@Ebes zNMZi`fPU%{0>N4CPy1WHIEEBhRf)8+qFypDH~0nB064f#`%qJHC-U4UKpA@1zFtccS<9iR006E+)^y#r=7RV5_3PFhHl zDwrIoS4Nh{of>yH(?(Qylzrwl2Gj_Sf}7BE*Ag1)E}y#hdxFF3)$CWdM^|0plGf9f zqZ$|&*b--7G+4FKqO0xmZk0tiv{3U~yOm^Vk;60+Y$IxC8;GRn_Hjr-Hm5bPJ;i)y z2w@)khlxyRLR>a})$v(hb)=A4$S|v7;>C)Ht!jN!y8m zInX}`TxBnm(1LJ@m0Avtip6hI-oIopJGG*qpaZgIQvf72N#;o{^#W~bqg1+r-u^e> z$50Fr;M}JrKyL}byLvbrKMc(KMIO3E(a8`7c%e-hIW%Oef!T2`pq#do;ueX-EFfE& z>!gdr3)g`n+!*@*&u@um^%NMvy<)tu_H(gc6{SM&Tj4uBUYc}Nq zN9cF-6W>vYd@%Vf2N7j7qBSwI#btc)`6{a4pz15atUN^o9YIS*Dh~}k;t$sdHuYb(5 z0V8?#5IlL?-R6yA>WDn9nfEjhAG^H-ng()q*y(QrkfGN=L;^x~U`0KE{m~U6^kWWQvR81rwEI0kh&S zL0MCY%%faCxB$m@Z=lS8x1r6;SZOh^jU5=Y0Pr`jcKzx+fH%zjvq(0O8f=_Uhk+(d zmQTm>f1fm^8BAtU-oM+@N*C)VmpJ2v!x2xvDa;wnzzx~`JPP^>M&N2X1$w!|-cZci zJPKmeas`rRBm`(bgRx4Cx!h|*mK~#qeUr_&tMTklTeZOnVzbvkQhJ$;!5WN_xurLwI8y-Z!9<$)~cpJ^^+J;AGc2~MH)Z}WSRlZVPgTbji8u70snO@7C}{Qv zdLNKnb8u{xvO)E-R%nbKA(SS|F$$U60fkD7FVng_b5Y6^qi{&5%>vDCavv z#hn|NTt7bLC-k=;82O?+P($|EoW)A1>23Nr3T+)TM^5<4#Th%}y@f#PYHA7zB5PLX zJ6wc#ZSPM#eEb4A}>dpc^jOGn$%t;x>zV{ z`kSOquAs@K(>zaRKOlDI`f9GynW3zD{iG1?@y4joFZWWX2K9oIvZmbphcM^T;@nLx zTOQ6goU=|lN^KUR>#f6095RFfQ>A%tw9k?!M@;+;l5NIj7{hXxZXbt1vMrMtM2PFZ zFps`5A~dc3c&b$cWJ;s@ZGK>7={S@GM%h{PU9>fdNQbq7R+8 zuLJd5TZtZ=457$fZ-C@`w@d~vKp^Qy7AQfd6*Cj0@rEZUt07iuRiF#3i$tO5Q5hxt z;Dh{qF?G18nI`QeRwAds)@~^Cfbyw)j6q7&QiecWttu`dq0Xg*1>uoW_Prz_H(#Ht zOeeWMHlH2$tWGoMll_>n_+(s{CBwo&~^hPi#GlzlL{2fvA# zNB+SeH8c^s4J;$Gi+rKGP@wXTe z6d+*ACGG&v4CRGh^3ucQCFj)Pk0c2d9Jhk}1{$Q(mxAu$QW5BT-?h^fz_| zKyVh%5YNpMEJ3rs6C|c)%NM<;+g|x?hmlg^P1fJwHtJ(y<50m3j?#{d4CW*)W?Ulgw0U<4g)FN-JrFy^hvIR@ankAJt5@| zBgfM%p*6Wy?Q4b$-fDlS4`X`3^a=UT8<2>mOyZ?O4kI+PhTO;?>%CZTi@hdVQCaz% z59*7;0{Pyqcck#pQo9woj&0Yv6{KE4iv$6i<-DG0Np`Y-5_$ak){Nt208qu-2PVWOcb`M$b8!O1( zpOOY8yL|Lvdtg57-;yqW-?d2S6XaFsqsAGct1js*s<;l9v%!4ur@BCwm*v7uXc_U) zU+&q;%$$*S`N@Tu^Bz9h(r|x-Qncm9Gjq~Z`OoP&&p!&d&SYH~nD!{mqH;fJs-0(X zs;a*60q8(B(-#}?jFm5zJ%Al;-PrEpa_a$g`g)V$v`?vU^3Uc?ga6uX4cra&(xF|` zdvl~NlFG;n-Pt*5=bVrI@vwdX9&1w9b zN99umqBGZaUswLAPC2AqRh83FqI`);Y^4`^DwCXTe-yDvl;t-6tNfF*P(0~>!d&8GX zrLoelsg%%2);l|wYNf%H$iActo3A0$Nq5g78{u7$STIWg1_#Hs3zMi3R={DnG*$`w4l$MNkx)bqxyB8+wz zgYAGY5Kl7C?Bsw;9`&ucTQacHttmm-^#W%^fR3KDB-q&{Pmo>I;6-HbG8C{W;ghsm;(P(@o!~Hb zQyRbud6u{V#G#T?HX?{yB;g2;+JwY-4;*r(ZvY6Xl<>!WdjTf@N!4UMfSvYwI7M}b z*+(QQ+|lI!*}Z}){;K^+Qys81TxODW8*JdGNK9kps9yo!UyA=kxc8|ZdA1K7(jDJ8 zvaat}M~ULah1nRh zu9hrJZ=GS9cHFJaVUQvCX0lJ%Z60hS`al+X$=n0u|M9Bi+i)l_YtZsKGai50I76*0 zYn~fi32KhjCGOYyS~wg=et!u6a6!VL0UFxGCr=JxfcliVEKEZKARlg>ex1P5zOEGm z%;Sj60ATH4PAc*M9ZkOF;`Je!Gk`hm5p?;;`n(iEFIcxnW3e5m;^WS~~HzI|I63!bkW-j?vz4FHlvmiOK;6f0EkY0EL*Zd>|DAh6hdD?DlTTij>C z`=C`etQp{=^N{;jko1u6Uxu%Wr7-h=I~yErZJ}OIwKkSK0Czo~w)lKJ3>74Mndlmj zv?3X|Pz+VT{ky*Wh$7!4bOb7eHiGHJ0DX97VmGdQ!P`v?_*jRVOW_Z0G8s_!mGj$p zeP*#5zv?N}!(F_h`>y3O3j2r|&e=XhUAHzn>NUG3I`Qh}N3vTV2^jMyTqnIukn?t* zG%1JlOO8^W5IM%IUF)Mvdr#(S8nix-mEOY?K?T3Tl)C0qX>lCE%{{FW+cydO1Se}q zLX##s)vBBmaq~YLM%3ZnZg=o6hYJ}~0$)K`&DD@~7= z2eI2yl=j=TWJkcnQrtVvV)v)M$e4|rHpRqW!Hw+D4{l9c16Ta8ZBCr5hlCuzMoxj# zyGN<(hNuC#;LCE?wTTmYDEtY>akc~Ma)Vi)c9_U_+yN_y8`p|AGn(DJYtyd)yq+HI z|C1Hdhrz6J%2{x5Q`gk_ebarB4W-^5hjm`cw6i8CKywrYlr~1DUDF}Sv`3~loF^Ns z#Xc{9d|OWd3D%#wAHFd6HF|w)2Xr2MObo4bY+tyTi>_A~#7<|b@i;gw5spj|;ixTt zA^{3xXMz8$SIPHY8~HrBr@}yN{q@!BD{~nPbgt@kz1CIBuLd` z%7?pfuCP3=8bthUkP!h-7XhU!p~@Ffpnziy72IML8w}vWTe6hlQntV zG*EFPJa?z=)hI;Q;ilaSb793f66<9H-4$$1=qgqxm|zn1dlNU%Jy_=?P9U-LvP61$ zU6+AT@2%jV9u~dTWOKRnM+cl4u*FXyxh_V|6U!`^;h0}lg$T(nPr(QG>9^uKi{*GP z)BYlH#vqq>1T<#setK$L6(O@CP>k=6>=Qo)Eu0*waE`AxR;L!9VS~lP8T-X+3&G}< zOfC@?54VXgU$h2l;tR6it74fArLdni44-llN6koM*}d=~lC`PWfUbevC zRh;UG&XXGBP?O?!P-T^}PR_@j%x0B3?M&4Vo6Mn*79JY31aNZ=Xr8YOHng}IEEQ6( zeBST5{U~sWL7703bbKp3v@#OS&hJ21a~k^VD)bMfCw3%0nh=OTa~rwtB`lL}qauO` zP+70Twf%-r)3|iN^}&Gm8XTkv=M5RROr+BjJNkqn-9=beUw><>sq0l_&Ma+cIm~c_ zO*biPm|UWL{AFz06XTy3Kzt(b1WtarmvfXWi0tAOdB^@2KlAfXfB#n^$d)np>3*8`C_2zL z4Kp=$6(`r|0WW4{pb)u82{N9AfVTVcvHOwE-p{WT61Og$EddbaATYlOaO>_dAjn~mcpoT31QC*AkUGEfu`2>!OeGp}cw5A)36I41m!SR|f zd9#E}emM_mYo`NYZc~Fox}dmqY_oGp;tmA7wM3)@x>ruzS%du*#{$6@;HJDUrKzRG z>%l6MTo7N(YWXTSL(&UTq>>8sngiWn{)|>*xbWeJlU1#(4|YS^cf@58%0WNiH>)lw zCDw!ebFBZuG^$0AQes1r(2K;vs5gJeW&XLsk@lIo1FFU?kuzj=T-QnbqE+oXur2se zs$_xZ-^)(b!RNo^p{RneQIK}%?qo-?YqIX@m9*RGn#xO%vjU{h?aJF{=f%6r`WXw# zm;n3VpH+S#OakdV?A=aBeo?BpmmH=jSI`7HbW*BesYj=DGBCd+ig;zt9;zlm?{dt zTeRsvYCiU}_6|;DaWU|O#CGiQg$_L!R{6u!p|aERKWYc|6UPT=NwqIvGmk!Wb1?G% zv3KV2RPOuRuN5U4G@ywzNRd=3AwwEblzFBBk<4?ZRcWBPBoQexWk?~jG?+3ZLuM)S z7!gXI>${}d`|M+%bM`sE=lMOa^UvPIvev!Uec#{D_w%`~_f_aQUqyM?17~IDq2)wtA0Mj}iV61mhKq&*aZF=+7RiEXRPEv{l{0Gm25YMNx&>+5)j@LBR;{S|durys_WiUjEdtJ$>e z4$ND4kd0y9+?znvYuYz>_5c=~r^|A~M(Yk>1BjnmhAe6Cwuqv|6m7;3aUTvu4-qWw zA$Lz%e+!Us!t?Szt171vV3ph)5$tZBWsk9E+b4j!pQO z%lF-%{G&AaqiR879l24l{d|-*Iz~Mf#v9PN{P~Z+|B8<0Eo8)T3Iha}xO1%RkY?R?AROGBY&7JTFtM)2J}_nx_tGDg z(r+u8@2_be)PXFvKMs;PL;`RdjK-DjJk!_s{pbpmWu~N}2%SEBp z5Si3j6yrD31Lwd2=^YM=E^k#(ZnyfVE@HURe0SNH7J#!Z%5~^jGLh?|Z9v2%%UmT^ z&@!AbY~8i>#=sFiV;28y%{7U{Y^1a5Nk<@*drQf@9O#NgY^cTwCj| z0=Bd$XTLg8s{YHGSokkORcv0!G4oj8BmH+ms|)h${A&O6jz=>RZ4w4&>4$ZC6Wla8 zr(-HNVm~RmSgRWQNiIWYcEXJeWhS^ZGkvveSx_wRX2vo+M*kS@CUygYxg3L?-rb7Y zWb*bK66q6hs57QfS(&>PCEOyv4MmLzJBYUUn5L@rtO3Jgeo8BE;Co2*W*Uk-?Qr`a zQnzN8F^P4jPl|!P>1u|`5_kvSzMC8eDKB;Uh6WpS+34PXD#nT{f6aWWG!9_ZQ_7ax zg-Wj5_+q&Jy0#Xr`s8f+3}B{Cq;UCG&m#lvLqT|U<(rmTrwWxKGfnk+2_s7c-@$72 zx^z(h@3HGI*|6t__IM(iP>e@zvKZstqPNp@mzauIDlJiD2Gry9vo~&_#F~0*y(iif zgkH*QMm`GIy`})-v63~>-L^=509BNKZ-2s3w1woNdTOR>DVbz35^QAsjCKEsaez9L z)(f9Ctf`m9V3a^I}FI>av2d=J6ctZ&M zjI%CSVpTx6ok4atDjo5r4$HFtIN9}kDHk|Z>jeXkV;`~H#vIPRs;l+(=5f5NDxY(C z7qRpf=Ns_BpXZyDr$rht9s2mrB!7o3P6{iJTN;-NJ%u!sXUO4*pv5=Xg+}lG_Y3Hx zF;!JcRN^w2ofx*gpfi?qwiF@=G=-(kd=+9paWNm6_xOaX0R*FRrRI^t8=3iVD!QWog*YCx{{PfZc*z6~}tkYObJM@7=2?y#=T zr@}&;i%h0Dgd8)b0&wj0slATdrwoEbqmLgxbbx`BSbz-j##dQ*Ok1#F<@vo2J+9KT z@~JNe#3>nErW6|Ga|5=vkB0&R@sC^b^n5)evMIng_aIa;o87i*KTQXm4m4@QBmdzC zdu|JFd~o5Rk3NN<4L`M)E8O4Xed7FkN^2UQ(b1zj+`hnzeaD)LT+3`F6)i3#P|<_( z^aKg6cg4LDfN->YkX{O`B{rwPSzjUdC(Nvj2?&v>H4%_02g%41f{f1JSXGmHO965- zB5pPj411V#=we9iR46>hij{xhD{0yoXAbwD`^taTDK2=-i`(OuJiq z{F^P6BvcS=rCQ8kshU-9)813g%wWG-;M8eJB#sG)s%0MqJ&~vb(gjL&Oy~?!n@Qb` zI!PO$mO#?+(xkvp+tH-J@Y0)PiC==BQ5tffif$#0QbOZUxTBI%;l>+0WAdn@U zk)g7Vxq*xn4klkr2jw+1c!9*|w_|&(9V&s3mkcgRjJdQ|y#qL`OU+=2YEEP0u&bL$ z8dYo8FYj&*kD`G#NX+j%CzB>K6`Ig_>&eO4fJC+YV$l9Q<*9h_>C}q8we$*6>yITeo5dTW^z8o~fJ?W<*$<0WXt#VG#GgSze zWJi&3P8uU9*a$M}m2i`rd`c?-C|kB)Mq&K=VU+%_w_~hTlzyDL;ps}2C-RrhD@9#A z%Ih1XTlAnqIFL~zR5W}-Ih0shre5F1FRwPB3NE6{UO)EC5-TZ&+Y}88pr_5bogp^f zgQ;K9;L7Q0FNgGOv>j9^$?0tI20);NPR9_;eOEi!7P^j|a*x#0oSnkcv^6vqrr5}_ zXZL>B4iY|Dvy{r1sB&)`pIXd^kf?>{w`rMod{7UQeOLD0F9`;ePoe6q8_yzf;|BQo zyM~j2zg~~j>lGd!+UAzjl<=~?*Dfh54$$Tg@iW;7Lc+O-;@S~pO8!CL-I*4L!Q?5KP{u`hWeyk*CQjSeVqo*1qrIKu8bs%V;k4!$x1!g^T~bnFA}DRku$dET zNI`FLmsISi3aBPWmhg`D-yRF0|MmdEpp>mZ?Gl&S^1=R7cLaT3H~xzyX1YGmWEBeQ zAhqS0BHWmv zA4jj{FWT5$^Pu48R^U3|Av!-iHdq9KFfU^3g&2ZvW&y@Rzb( zzBReHJFHiFrx5C1y*k@f2|%LQor{DuQXH)3cIWhl(|e-buIsXp#}GJ9>4WuwjOhF; zxn>4&;Wo*0ZdEfZ0Q90Y_hAV5s~pbg`HAvRm-RVp?JGMNmBl+v%d^K}>&AI3JKZmB zkUJ$^s!$eR>NDiv=#1dEd%@~2mV`imA?Q%#>5y_~=;*_Hcstc?N%#gZC^^XVwN{MR zHO)VPHc?J)phwp=0{SsM1gxX+%BG~raFG@0bofCY(TOeVzsQ66fhyRvO~rh(l+&`M zGo)F>xPZdqaeU#oKoX%XezHLq<p^887aR;m3T9}*B^t?#~F2SQq)lemzvyVd7i>sg&CAt&}4 z>hQl+?ubkEYZsrN@BTU9gvy*1dyZ5PS_|}99uBv4HRKZA3-*_BM|p@|-TAcU{4rzT z2ei3If}Maq`gik?eiX&&(C(^k@K~r2z{|2mq=I)oU))uDAPu}PalV;MKq>wn^=KKc zYuqCU=bM5vw>u=^$Zr%VoFT8SRnPBf}KE5Ljff6tts@QkXaeBb#B zYTy2I-E@Lb1=J~fNrSA(@3_euUdHP7Vr{eq+trd(VHNXGm>Le%+JU?`FR*Qf6wC%D zIp|2kjo>G|DyIXj8g#H(Q8=!z`CEYcpXnunh#%%wXu@yY?ZglS&$^)G*!wz5K&-a}$*V9@#^c_!_Z zEXI3N8aId@n_1+$JwnjoVEy7-*L=-{T-F*mt0kq0ifs{iwdIR_srvDb*jf?8km%1t z&Sh;$)G3Y6YLaYop>Z-DW8hmBh;j$Z-o6TK&8=1GVGNvg5fb1q63aP?uJ#U&@|%k( z=+6-RYA&3l9{{oIKBUmT)PM?rW{&tsuQ-_(T9CcT*`;PfpA78*rrqHb*@(C!38Yhf z1zfa6JmL8rp0(95EV?NXIvZyxDKJ9^a#%TS0o9@5Jk>`+!K z1x}-6v(Q*j!@da^P+tYsiCS982el*E~1CnbXL zI?kY=p!~sPNa%sCDywrzSfu0l(Jf@8ucK0>_*?PfB3L-M;DpF+u*e_3@RhhjJjcim z_^|_EqQX>1U)$8Gz)rGe_KPAj>X8t5t8b<0GmD*z!?*oe^LFKSv{{xoXnKrIzU@|; z!975nD6o-NWpit;vcMFt#?E+La{unjxGw3Ydno^C$iAVxn-d`GFUEd-0cur(#U}%9 zf;P&@ktY6oP>}@&%vtg)z$ofXcy}#0qwMouWcO?q*OVC^KxbVKW8J5pk5wo3g~`2< ze;Nj-$VOA4ErMUZ)Pjmy*P_&#t@19h^=^IrK_Q1vA(|jKZM9onbxqv>Yb|h?Yp30E zJ3cikuc73mksO2%_cd`Y%j@XWCP(4i(B3cDu5kNu%9K8*cSjd#Jn|^I)N=e(-;dWn zwsZT6%L}4+rwHP;gS;2$`TXkoa`1Z%~HpyU(F89n1-3F2eqnL$jBp zE$@)vownGmtrO8mFL*~X>Ruy{Z9BbxjLyuP!-3&z2Ldy6q29h>Hq+=(>lZNR?LbEp zDC>ejpP7THK&dRe4+2!*H*HKM*xcu*EZq>)UjzS5W1B#k!X{qj2baxE!y<>wS>DPo zS!ey&+6iWaghS&W%t2PjYkDX2@VR^)Fef0=WP|_@0;7N{*fkybmWKvOVlFh~iIb`e zDHMj~Qo7jg^jt7?+y(^x-IR`Sx5)L+_D7`D@C(cf@>>&hVw-o_;VJiGPAYmY+~3Bp z5x1IQNo@b)P)%+An`%)JNJ#TxKjD7j7JH#lN8kC5KA-s%h1f?OSG#jE!@Y^$6<&ms z-IZWe+$*$*oI)XU{e>n^wvv>DnKsW@HRob)gpKGLIC!leiaPX2=z`<8)$R-ETs^vi z#!D7Y?0a5JW*i)V&^fMYx^)U@ui93DaEBcJGnJGPOlcQvSvLsxmic#K;F4{pvnI{l z!l|dHH^XWhllfFKxfwVfg|~t~k~PG`wTyxR4|cyg_TQ>c^Nnc%&`)U~0*bQZ7c4DX zy9!Eb`TRGVFC8G{SJxqXGa!p|krVRamqt061oZS+BsdPnL|iS#l|G5m%Cx;zNf}@U zfoNeFXe|mTt^E0bb{e#aQax2GH`lt4`7`pR^>Jy=Lj`;9UJ zV60urqn0GApI!AO*6Ce1b0x;&+;X9*&s3J}q)(|(h&w%VF~=4y8TMmt#TjKBr=yq^ zo8nn13Zh}l9Ai|A#oi0+IB9plx4KBkVmrvd>?#Y3FG%TvQ$l1NLU!G{d)W7t+7jnj z%1}RsQmLk%!!MTKaqbdEtW-B!(xR5R^T6Mp%fgb4oQ0yPm#=Dta}R_Syl+)%Cfg(+ zOEC%9b@qA3y4SatQCg=~VaEhwN5k%2k7u2cfRX;hKJy(rb}VWLJ?HwFG~y9q)fmrd zm-g=FrjTzB;c9cn)m*269{l8K^EkPdv2f%=8X~k)(Xrr6E@BI0&#haDaS7ORm?-0R8Xlqn`nBDPr zYZ8OmpCmCPvz!&N^2}|cuRJcSi~`i?n3?y+65bonf)$*QynO}T5}C$pLB)Nonc~P= zsWa5Pufu{$1q;DB=J4C##7Akex+X@ zs^314C<120yCr?6R`qQNhO^px$@0Ep9_z!Y+Hxt+L^acJNkT%p>k>y^N(e{swWy3T zrm!}FlWHAW{)6ui42M_m*{{PNBB^p_=3*1)+W}!glFF@{;q&Z{7&7hiy7!KEW=Xtv z+47c`*g^yvwsd(CdVq4WJP|sb8c%cS49#WFp^I)ra~VK1mzAiH|5S5n$IEQnEdBJf zoRz#zw{qqa^Y@Vqvsq>*%D1^a4K+J^z%>lFS(RcFXrn<|mN7I8^%Zjx-mG<71WX-x zAZMJ|^R8|3GtN@T=m-f1i#W?y)qd^uItp)V_RigCRf5HyQz8z03SC2`qtM7b{R}&- zT!xB3*tZg~m}8Y~nX!w(H2Fb_SO7MJ^!TKR$V)ghM_;2)qO%g+O+bp+4$UUZ4&D)v zA{u^>BD~_U7AOCP6v4TlvSORcxf9*doYk7{&v!poh0OHx2CV}8GHs?5OPIgk9KQnBjhS4mlkpr{sDwnB@0B#eZ+yeyZnfh zJ4ukde?L-g)Pg$E6xXr6h=mp5yk}0&Qh=Q0;E8z68-<>F-IN><8DQ^J;Ks*lz0B158C1

    +NIqm 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�q9)R1EbXq!$jjtHo?@ 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, + "revision" : , + "severity" : , + "enable" : , + "message" : + } + ] +} +``` +Event Profiles only contains declarations of events and their characteristics. There has to be an application to raise these events using eventnotify API. + +The framework maintains default event profile at /etc/evprofile/default.json. +Operator can download default event profile to a remote host. +This downloaded file can be modified by changing the severity or enable flag of event(s). +This modified file can then be uploaded to the device to /etc/evprofile/. +Operator can select any of these custom event profiles to change default properties of events. +The selected profile is persistent across reboots and will be in effect until operator selects either default or another custom profile. + +In addition to storing events in DB, framework forwards log messages corresponding to all the events to syslog. +Syslog message displays the type (ALARM or EVENT), action (RAISE, CLEAR, ACKNOWLEDGE or UNACKNOWLEDGE) - when the message corresponds to an event of an alarm, name of the event and detailed message. + +gNMI clients can subscribe to receive events as they are raised. Subscribing through REST is being evaluated. + +CLI and REST/gNMI clients can query either table with filters - based on severity, delta based on timestamp, sequence-id etc., + +Application owners need to identify various conditions that would be of interest to the operator and use the framework to raise events/alarms. + +## 1.1 Requirements + + +### 1.1.1 Functional Requirements + +| ID | Requirement | Comment | +| :--- | :---- | :--- | +| 1 | Provide API via library for apps to publish events | | +| 2 | Provide API via library for apps to publish alarms | | +| 3 | Event Infra to write formatted syslog messages corresponding to all events to Syslog. | | +| 4 | Event Infra to persist all events and alarms in DB. | | +| 5 | Event Infra to read Event profile ( severity and enable/disable flag ) from a json file. | | +| 6 | Event Infra to read Event table parameters (size and # of days) from a config file. | | +| 7 | NBI interface (gNMI and REST) and CLI | | +| 7.1 | Events | | +| 7.1.1 | Openconfig interface to pull event information. | | +| 7.1.2 | Openconfig interface to pull event summary information. | | +| | Event summary information to contain cumulative counters for: | | +| | - Raised-count (events) | | +| 7.1.3 | Openconfig interface to pull events using following filters | | +| | - ALL ( pull all events) | | +| | - Severity. | | +| | - Recent records (eg., last 5 minutes, one hour, one day). | | +| | - Records between two timestamps, one timestamp and end, and beginning and a timestamp. | | +| | - All records between two Sequence Numbers (incl begin and end) | | +| 7.2 | Alarms | | +| 7.2.1 | Openconfig interface to pull alarm information. | | +| 7.2.2 | Openconfig interface to pull alarm summary information. | | +| | Counters for Total, Critical, Major, Minor, Warning, Acknowledged | | +| 7.2.3 | Openconfig interface to pull alarms using following filters | | +| | - All (pull all events) | | +| | - Severity. | | +| | - Recent alarms (eg., last 5 minutes, one hour, one day). | | +| | - Records between two timestamps, one timestamp and end, and beginning and a timestamp. | | +| | - All records between two Sequence Numbers (incl end and begin) | | +| 7.2.4 | Openconfig interface to acknowledge an alarm. | | +| 8 | CLI commands | | +| 8.1 | show alarm [ detail \| summary \| severity \| timestamp \| recent <5min\|1hr\|1day> \| sequence-number \| all] | | +| 8.2 | show event [ detail \| summary \| severity \| timestamp \| recent <5min\|1hr\|1day> \| sequence-number ] | | +| 8.3 | show event profile | | +| 8.4 | alarm acknowledge | | +| 8.5 | logging server [ log \| event ] | default is 'log' | +| 8.6 | event profile [ default \| name-of-file ] | | +| 9 | gNMI subscription | | +| 9.1 | Subscribe to openconfig Event container and Alarm container. All events and alarms published to gNMI subscribed clients. | | +| 10 | Clear all events | | +| 11 | Any change in open source should be aligned and upstream. | | + +## 1.2 Design Overview + +![Block Diagram](event-alarm-framework-blockdiag.png) + +### 1.2.1 Basic Approach +The feature involves new development. +Applications act as producers by writing to a table with the help of event notify library. +Eventd reads new record in the table and processes it: +It saves the entry in event table; if the event has an action and if it is *RAISE*, record gets added to alarm table, severity counter in ALARM_STATS is increased. +If the received event action is *CLEAR*, record in the ALARM table is removed and severity counter in ALARM_STATS of that alarm is reduced by 1. +If eventd receives an event with action *ACKNOWLEDGE* from mgmt-framework, severity counter in ALARM_STATS is reduced by 1. +If eventd receives an event with action *UNACKNOWLEDGE* from mgmt-framework, severity counter in ALARM_STATS is increased by 1. +Eventd then informs logging API to format the log message and send the message to syslog. + +Any application like pmon can subscribe to tables like ALARM_STATS to act accordingly. + +### 1.2.2 Container +A new container by name, eventd, is created to hold event consumer logic. + +# 2 Functionality +## 2.1 Target Deployment Use Cases + +The framework assigns an unique sequence number to each of the events sent by applications. + +In addition, the framework provides the following key management services: + +- Push model: Event/Alarm information to remote syslog hosts and subscribed gNMI clients +- Pull model: Event/Alarm information from CLI, REST/gNMI interfaces +- Ability to change severity of events, turn off a particular event +- Ability to acknowledge an alarm + +## 2.2 Functional Description +Event Management Framework allows applications to store "state" of the system for user to query through various north bound interfaces. + +# 3 Design +## 3.1 Overview +There are three players in the event framework. Producers, which raises events; a consumer to receive and process them as they are raised and a set of receivers one for each NBI type. + +Applications act as producers of events. + +Event consumer class in eventd container receives and processes the received event. +Event consumer manages received events, updates event table, alarm table, event_stats table and alarm_stats tables and invokes logging API, which constructs message and sends it over to syslog. + +Operator can chose to change properties of events with the help of event profile. Default +event profile is available at */etc/evprofile/default.json*. User can download the default event profile, +modify and upload it back to the switch to apply it. + +Through event profile, user can change severity of any event and also can enable/disable a event. + +Through CLI, REST or gNMI, event table and alarm table can be retrieved using various filters. + +### 3.1.1 Event Producers +Application that need to raise an event, need to use event notifiy API ( LOG_EVENT ). +This API is part of *libeventnotify* library that applications need to link. + +For one-shot events, applications need to provide event-id (name of the event), source, dynamic message, and event action set to NOTIFY. + +For alarms, applications need to provide event-id (name of the event), source, dynamic message, and event action (RAISE_ALARM / CLEAR_ALARM / ACK_ALARM /UNACK_ALARM). +The ACK_ALARM/UNACK_ALARM action types are used only by mgmt-framework to provide the functionality to acknowledge/unacknowledge the alarms through NBI. + +Eventd maintains a json file of events and alarms at sonic-eventd/etc/evprofile/default.json. This is the default event profile that gets installed on the device at /etc/evprofile/default.json. +Developers of new events or alarms need to update this file by declaring name and other characteristics - severity, enable flag and static message that gets appended with dynamic message. + +``` +{ + "__README__" : "This is default map of events that eventd uses. Developer can modify this file and send + SIGINT to eventd to make it read and use the updated file. Alternatively developer can test + the new event by adding it to a custom event profile and use 'event profile ' command + to apply that profile without sending SIGINT to eventd. Developer need to commit default.json file + with the new event after testing it out. + Supported severities are: CRITICAL, MAJOR, MINOR, WARNING and INFORMATIONAL. + Supported enable flag values are: true and false.", + "events":[ + { + "name" : "CUSTOM_EVPROFILE_CHANGE", + "revision" : 0, + "severity" : "INFORMATIONAL", + "enable" : "true", + "message" : "Custom Event Profile is applied." + }, + { + "name": "TEMPERATURE_EXCEEDED", + "revision" : 0, + "severity": "CRITICAL", + "enable": "true" + "message" : "Temperature threshold is 75 degrees." + } + ] +} +``` +The format of event notify API is: + +definition: +``` + LOG_EVENT(name, source, action, MSG, ...) +``` +- name is name of the event +- source is the object that is generating this event +- action is either NOTIFY, RAISE_ALARM, CLEAR_ALARM, ACK_ALARM or UNACK_ALARM +- MSG can be json string. If json string, it is rendered as is in the syslog. + + +Usage: +For one-shot events: +``` + LOG_EVENT(CUSTOM_EVPROFILE_CHANGE, profile_name.c_str(), NOTIFY, "New event profile is %s", profile_name.c_str()); +``` + +For alarms: +``` + if (temperature >= THRESHOLD) { + LOG_EVENT(TEMPERATURE_EXCEEDED, sensor_name_p, RAISE_ALARM, "Temperature for sensor %s is %d degrees", sensor_name_p, current_temp); + } else { + LOG_EVENT(TEMPERATURE_EXCEEDED, sensor_name_p, CLEAR_ALARM, "Temperature for the sensor %s is %d degrees ", sensor_name_p, current_temp); + } +``` +#### 3.1.1.2 Development Process + +Here is a typical developement process to link eventnotify library to a component and be able to send new events/alarms: + +a. Update buildimage/rules/*app*.mk + + Add $(LIBEVENTNOTIFY_DEV) to compile dependency. + + Add $(LIBEVENTNOTIFY) to runtime dependency. + +``` + Ex: For rules/tam.mk, + + $(SONIC_TAM)_DEPENDS += $(LIBEVENTNOTIFY_DEV) + $(SONIC_TAM)_RDEPENDS += $(LIBEVENTNOTIFY) +``` + +b. Update Makefile.am of the app to link to event notify library. +``` + Ex: To let tammgr use event notify API, update src/sonic-tam/tammgr/Makefile.am as below: + + tammgrd_LDADD += -leventnotify +``` +c. Declare the name of new event/alarm along with revision, severity, enable flag and static message in sonic-eventd/etc/evprofile/default.json + +d. In the source file where event is to be raised, include eventnotify.h and invoke LOG_EVENT with action as NOTIFY/RAISE_ALARM/CLEAR_ALARM (ACK_ALARM/UNACK_ALARM are used by mgmt-framework to allow users to acknowledge/unacknowledge alarms). + +The event notifier takes the event properties, packs a field value tuple and writes to a table, by name, EVENTPUBSUB. + +The EVENTPUBSUB table uses event-id and a sequence-id generated locally by event notifier as the key so that there wont be any conflicts across multiple applications trying to write to this table. + +### 3.1.2 Event Consumer +The event consumer is a class in sonic-eventd container that processes the incoming record. + +On intitialization, event consumer reads */etc/evprofile/default.json* and builds an internal map of events, called *static_event_map*. +It then verifies if there was a custom event profile configured and merges its contents to static_event_map built from default event profile. +It then reads from EVENTPUBSUB table. This table contains records that are published by applications and waiting to be read by eventd. +Whenever there is a new record, event consumer reads the record, processes and deletes it. + +On reading the field value tuple, using the event-id in the record, event consumer fetches static information from *static_event_map*. +As mentioned above, static information contains severity, static message and event enable flag. +If the enable flag is set to false, event consumer ignores the event by logging a debug message. +If the flag is set to true, it continues to process the event as follows: +- Generate new sequence-id for the event +- Write the event to Event Table +- It verifies if the event corresponds to an alarm - by checking the *action* field. If so, alarm consumer API is invoked for the event for further processing. + - If action is RAISE_ALARM, add the record to ALARM table + - If action is CLEAR_ALARM, remove the entry from ALARM table + - If action is ACK_ALARM, update *acknowledged* flag of the corresponding raised entry to true in ALARM table and stores timestamp to *acknowledge_time*. + - If action is UNACK_ALARM, update *acknowledged* flag of the corresponding raised entry to false in ALARM table and stores timestamp to *acknowledge_time*. + - Event and Alarm Statistics tables are updated +- Invoke logging API to send a formatted message to syslog + +#### 3.1.2.1 Severity +Supported event severities: CRITICAL, MAJOR, MINOR, WARNING and INFORMATIONAL as defined opeconfig alarm yang. +The corresponding syslog severities are: log-alert, log-crit, log-error, log-warning and log-notice respectively. +Severity INFORMATIONAL is not applicable to alarms. + +#### 3.1.2.2 Sequence-ID +Every new event should have a unique sequential ID. The sequence-id is of the format <32 bit time_t><5 digit running sequence 00000 to 99999>. These semantics allows applications to layout the logs chronologically. + +#### 3.1.2.3 Revision +Every event/alarm defined in the profile must have a revision specified as a numerical. If not given, the default revision '0' is assigned to the event/alarm. This revision is to be incremented if the alarm parameters are updated. +For e.g., if TEMPERATURE_EXCEEDED alarm threshold is changed from 65 from original 70, the revision is updated in default.json keeping the name unchanged. +This will allow to redefine the event on an image upgrade. Clients can distinguish events from different sources running different releases. + +### 3.1.3 Alarm Consumer +The alarm consume method on receiving the event record, verifies the event action. If it is RAISE_ALARM, it adds the record to Alarm Table. +The counter in ALARM_STATS corresponding to the severity of the incoming alarm is increased by 1. + +Eventd maintains a lookup map of *sequence-id* and pair of *event-id* and *resource* fields. +An entry for the newly received event is added to this look up map. + +- If the action is CLEAR_ALARM, it removes the previous record of the raised alarm using above lookup map. + The counter in ALARM_STATS corresponding to the severity of the updated alarm is reduced by 1. + +- If the action is ACK_ALARM, alarm consumer finds the raised record of the alarm in the ALARM table using the above lookup map and updates *acknowledged* flag to true. The *acknowledge-time* is updated with the timestamp of ack event. + ALARM_STATS is updated by reducing the corresponding severity counter by 1. + +- If the action is UNACK_ALARM, alarm consumer finds the raised record of the alarm in the ALARM table using the above lookup map and updates *acknowledged* flag to false. The *acknowledge-time* is updated with the timestamp of unack event. + ALARM_STATS is updated by increasing the corresponding severity counter by 1. + +pmon can use ALARM_STATS to update system LED based on severities of outstanding alarms: +``` + Red if any outstanding critical/major alarms, else Yellow if any minor/warning alarms, else Green. +``` +An outstanding alarm is an alarm that is either not cleared or not acknowledged by the user yet. + +The following illustrates how ALARM table is updated as alarms goes through their life cycle and how can an application use it. +Example here is pmon using ALARM_STATS table to control system LED. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:-------------:| +| | | | +| | | | + +Alarm table is empty. All counters in ALARM_STATS is 0. System LED is Green. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-1 | CRITICAL | | +| ALM-2 | MINOR | | + +Alarm table now has two alarms. One with *CRITICAL* and other with *MINOR*. ALARM_STATS is updated as: Critical as 1 and Minor as 1. As There is atleast one alarm with *critical/major* severity, system LED is Red. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-2 | MINOR | | + +The *CRITICAL* alarm is cleared by the application, so alarm consumer removes it from ALARM table, ALARM_STATS is updated as: Critical as 0 and Minor as 1. As there is at least one *minor/warning* alarms in the table, system LED is Amber. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-2 | MINOR | | +| ALM-9 | MAJOR | | + +Now there is an alarm with *MAJOR* severity. ALARM_STATS now reads as: Major as 1 and Minor as 1. So, system LED is Red. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-2 | MINOR | | +| ALM-9 | MAJOR | true | + +The *MAJOR* alarm is acknowledged by user, alarm consumer sets *acknolwedged* flag to true and reduces Major counter in ALARM_STATS by 1, ALARM_STATS now reads as: Major 0 and Minor 1. This way, acknowledged major alarm has no effect on system LED. There are no other *CRITICAL/MAJOR* alarms. There however, exists an alarm with *MINOR/WARNING* severity. System LED is Amber. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-2 | MINOR | true | +| ALM-9 | MAJOR | true | + +The *MINOR* alarm is also acknowledged by user. ALARM_STATS reads: Major as 0, Minor as 0. So it is also taken out of consideration for system LED. System LED is Green. + +| alarm | severity | acknowledged | +|:-----:|:----------:|:------------:| +| ALM-2 | MINOR | true | +| ALM-9 | MAJOR | false | + +The *MAJOR* alarm is also unacknowledged by user. ALARM_STATS reads: Major as 1, Minor as 0. So it is now considered for system LED. System LED becomes Red. + +### 3.1.4 Event Receivers +Supported NBIs are: syslog, REST and gNMI. + +#### 3.1.4.1 syslog +Logging API contains logic to take the event record, augment it with any static information, format the message and +send it to syslog. +``` + if (ev_act.empty()) { + const char LOG_FORMAT[] = "[%s], %%%s %s. %s"; + // event Type + // Event Name + // Static Desc + // Dynamic Desc + + // raise a syslog message + syslog(LOG_MAKEPRI(ev_sev, SYSLOG_FACILITY), LOG_FORMAT, + ev_type.c_str(), + ev_id.c_str(), ev_msg.c_str(), ev_static_msg.c_str()); + } else { + const char LOG_FORMAT[] = "[%s] (%s), %%%s %s. %s"; + // event Type + // event action + // Event Name + // Static Desc + // Dynamic Desc + // raise a syslog message + syslog(LOG_MAKEPRI(ev_sev, SYSLOG_FACILITY), LOG_FORMAT, + ev_type.c_str(), ev_act.c_str(), + ev_id.c_str(), ev_msg.c_str(), ev_static_msg.c_str()); + } +``` +An example of syslog message generated for an event raised when user selects a custom event profile. +``` +May 19 21:22:07.122786 2021 sonic WARNING eventd#eventd[2419]: [EVENT], %CUSTOM_EVPROFILE_CHANGE : handle_custom_evprofile: Custom Event Profile myprofile.json is applied.. Custom Event Profile is selected by user. +``` +Syslog message for an alarm raised by a sensor: +``` +May 19 21:42:14.373410 2021 sonic ALERT eventd#eventd[2453]: [ALARM] (RAISE), %TEMPERATURE_EXCEEDED : temperatureCrossedThreshold: Current temperature of sensor/2 is 76 degrees. Temperature threshold is 75 degrees. +``` +Syslog message when alarm is cleared is as follows: +``` +May 19 21:46:34.373693 2021 sonic ALERT eventd#eventd[2453]: [ALARM] (CLEAR), %TEMPERATURE_EXCEEDED : temperatureCrossedThreshold: Current temperature of sensor/2 is 70 degrees. Temperature threshold is 75 degrees. +``` +Syslog message when alarm with id=4 is acknowledged is as follows: +``` +May 19 21:48:05.870530 2021 sonic ALERT eventd#eventd[2453]: [ALARM] (ACKNOWLEDGE), Alarm id 4 ACKNOWLEDGE. +``` + +Syslog message when alarm with id=4 is unacknowledged is as follows: +``` +May 19 21:53:24.490545 2021 sonic ALERT eventd#eventd[2453]: [ALARM] (UNACKNOWLEDGE), Alarm id 4 UNACKNOWLEDGE. +``` +Operator can configure specifc syslog host to receive either syslog messages corresponding to events or general log messages. +Through CLI, operator can chose 'logging server [log|event]' command. +When operator configures a host with 'event' type, it receives *only* log messages corresponding to events. +Support for VRF/source-interface/UDP port are all are applicable for 'event' type. + +#### 3.1.4.2 REST +Subcribing through REST to receive event notifications is currently being evaluated. + +#### 3.1.4.3 gNMI +gNMI clients can subscribe to receive event notifications. Subscribed gNMI clients receive event fields as in the DB and +there is no customization of these fileds similar to syslog messages. + +TODO: add definitions of protobuf spec + +#### 3.1.4.4 System LED +The original requirement was to change LED based on severities of the events. But on most of the platforms the system/power/fan LEDs are managed by the BMC. +BMC (baseboard management controller) is an embedded system that manages various platform elements like fan, PSU, temperature sensors. +There is an API that can be invoked to control LED, but not all platforms will support that API if they are fully controlled by the BMC. +So, on certain platforms, system LED could not represent events on the system. + +Another issue is: Currently pmon controls LED, and as eventd now tries to change the very same LED, which leads to conflicts. +A mechanism must exist for one of these to be master, which, in this case, is pmon. + +The proposed solution is to have pmon use ALAMR_STATS counters in conjunction with existing logic to update system LED. + +#### 3.1.4.5 Event/Alarm flooding +There are scenarios when system enters a loop of a fault condition that makes application trigger events continuously. To avoid such +instances flood the EVENT or ALARM tables, eventd maintains a cache of last event/alarm. Every new event/alarm is compared against this cache entry +to make sure it is not a flood. If it is found to be same event/alarm, the newly raised entry will be silently discarded. + +#### 3.1.4.6 Eventd continuous restart +Under the scenarios when eventd runs into an issue and restarts continuously, applications might keep writing to the eventpubsub table. As consumer - eventd - is not able to remove events from the pusbsub table, eventpusbub table could grow forever as applications keep rising events/alarms. +One way to fix is to have the system monitor daemon to periodically (very high polling interval) to check the number of keys in the table and if it exceeds a number, delete all the entries. When system monitor daemon does this, it logs a syslog message. + +### 3.1.5 Event Profile +The Event profile contains mapping between event-id and severity of the event, enable flag. +Through event profile, operator can change severity of a particular event. And can also enable/disable +a particular event. + +The default profile exists at */etc/evprofile/default.json* +By default, every event is enabled. +The severity of event is decided by developer while adding the event. +``` +{ + "__README__" : "This is default map of events that eventd uses. Developer can modify this file and send + SIGINT to eventd to make it read and use the updated file. Alternatively developer can test + the new event by adding it to a custom event profile and use 'event profile ' command + to apply that profile without sending SIGINT to eventd. Developer need to commit default.json file + with the new event after testing it out. + Supported severities are: CRITICAL, MAJOR, MINOR, WARNING and INFORMATIONAL. + Supported enable flag values are: true and false.", + "events":[ + { + "name" : "CUSTOM_EVPROFILE_CHANGE", + "revision" : 0, + "severity" : "INFORMATIONAL", + "enable" : "true", + "message" : "Custom Event Profile is applied." + }, + { + "name": "TEMPERATURE_EXCEEDED", + "revision" : 0, + "severity": "CRITICAL", + "enable": "true" + "message" : "Temperature threshold is 75 degrees." + } + ] +} +``` +User can download the default event profile to a remote host. User can modify characteristics of +some/all events in the profile and can upload it back to the switch and place the file at /etc/evprofile/. + +The uploaded profile will be called custom event profile. + +An example of custom event profile is as below. +With this particular custom event profile, user wants to +- change severity of CUSTOM_EVPROFILE_CHANGE event (severity changed from INFORMATIONAL to MAJOR) +- suppress the TEMPERATURE_EXCEEDED alarm (enable flag is changed from true to false) +- introduce new alarm by name DUMMY_ALARM (there should be an application to raise/clear this new alarm). +``` +{ + "events": [ + { + "name" : "CUSTOM_EVPROFILE_CHANGE", + "revision" : 0, + "severity" : "MAJOR", + "enable" : "true", + }, + { + "name": "TEMPERATURE_EXCEEDED", + "revision" : 0, + "severity": "CRITICAL", + "enable": "false" + }, + { + "name" : "DUMMY_ALARM", + "revision": 0 + "severity" : "WARNING", + "enable" : "true", + } + ] +} +``` + +User can have multiple custom profiles and can select any of the profiles under /etc/evprofile/ using 'event profile' command. + +The framework will sanity check the user selected profile and merges it map of events *static_event_map* maintained by eventd. + +After a successful sanity check, the framework generates an event indicating that a new profile is in effect. + +If there are any outstanding alarms in the alarm table, the framework removes those records for which enable is set to false in the new profile. +Severity counters in ALARM_STATS are reduced accordingly. + +Eventd starts using the merged map of characteristics for the all the newly generated events. A CUSTOM_EVPROFILE_CHANGE event is generated. + +The event profile is upgrade and downgrade compatible by accepting only those attributes that are *known* to eventd. +All the other attributes will remain to their default values. + +Sanity check rejects the profile if attributes contains values that are not known to eventd. + +Config Migration hooks will be used to persist the current active profile across an upgrade. + +The profile can also be applied through ztp. + +### 3.1.6 CLI +The show CLI require many filters with range specifiers. +Various filters are supported using RPC. + +e.g. +``` +rpc getEventBySeqeuenceId{ +input { + from sequence-id; + to sequence-id; + } +output { + list event-table-entries; +} +``` + +The rpc callback needs to access DB with the given set of sequence ids. + +The gNMI server (gnoi_client.go, gnoi.go, sonic_proto, transl_utils.go) need to be extended to support the RPC to support similar operations for gNMI. + +### 3.1.7 Event Table and Alarm Table +The Event Table (EVENT) and Alarm List Table (ALARM) stored in EVENT_DB. +The size of Event Table is 40k records or 30 days worth of events which ever hits earlier. +A manifest file will be created with parameters to specify the number and number of days limits for +eventd to read and enforce them. + + +``` +root@sonic:/etc# cat eventd.json +{ + "config" : { + "no-of-records": 40000, + "no-of-days": 30 + } +} +``` +'no-of-records' indicates maximum number of records EVENT table can hold. The range is 1-40000. +'no-of-days' indicates maximum number of days an event can exist in the EVENT table. The range is 1-30. + +When either of the limit is reached, the framework wraps around the table by discarding older records. + +User can send SIGINT to eventd process to force read and apply the manifest limits. + +The EVENTPUBSUB table will be periodically monitored and flushed based of a pre-defined table limit. Based on discussions this can be plugged into existing system jobs. + +An example of an event in EVENT table. +``` +EVENT Table: +============================== + +Key : id + +id : Unique sequential ID generated by the system for every event {uint64} +type-id : Name of the event generated {string} +text : Dynamic message describing the cause for the event {string} +time-created : Time stamp at which the event is generated {uint64} +action : Indicates action of the event; for one-shot events, it is empty. For alarms it could be raise, clear or acknowledge {enum} +resource : Object which generated the event {string} +severity : Severity of the event {string} +revision : Revision of the event {uint64} + + +127.0.0.1:6379[6]> hgetall "EVENT|1" + 1) "text" + 2) "handle_custom_evprofile: Custom Event Profile x.json is applied." + 3) "type-id" + 4) "CUSTOM_EVPROFILE_CHANGE" + 5) "id" + 6) "1" + 7) "time-created" + 8) "1621459327118629520" + 9) "resource" +10) "/etc/evprofile/x.json" +11) "severity" +12) "WARNING" +13) "Revision" +14)"0" +``` + +Schema for EVENT_STATS table is as follows: +``` +EVENT_STATS Table: +============================== + +Key : id + +id : key {state} +events : Total events raised {uint64} +raised : Total alarms raised {uint64} +cleared : Total alarms cleared {uint64} +acked : Total alarms acknowledged {uint64} + +127.0.0.1:6379[6]> hgetall "EVENT_STATS|state" +1) "events" +2) "1" +3) "raised" +4) "0" +5) "cleared" +6) "0" +7) "acked" +8) "0" +127.0.0.1:6379[6]> +``` +Alarm Table will not have any limits as it only contains the snapshot of the alarms during the current run. + +Contents of an alarm record. In this case, the alarm was raised temperature crossed a threshold. +``` +ALARM Table: +============================== + +Key : id + +id : Unique sequential ID generated by the system for every event {uint64} +revision : Revision of the alarm {uint64} +type-id : Name of the event generated {string} +text : Dynamic message describing the cause for the event {string} +time-created : Time stamp at which the event is generated {uint64} +acknowledged : Indicates if alarm has been acknowledged {boolean} +resource : Object which generated the event {string} +severity : Severity of the event {string} +acknowledged : Indicates when alarm has been acknowledged/unacknowledged {uint64} + + +127.0.0.1:6379[6]> hgetall "ALARM|2" + 1) "type-id" + 2) "TEMPERATURE_EXCEEDED" + 3) "text" + 4) "temperatureCrossedThreshold: Current temperature for sensor/2 is 76 degrees" + 5) "action" + 6) "RAISE" + 7) "resource" + 8) "sensor/2" + 9) "time-created" +10) "1621460371062299951" +11) "severity" +12) "CRITICAL" +13) "id" +14) "2" +15) "acknowledged" +16) "false" +17) "revision" +18) "0" +``` + +Schema for ALARM_STATS table is as below. When an alarm of particular severity is cleared, +the corresponding severity counter is decremented. +``` +ALARM_STATS Table: +============================== + +Key : id + +id : key {state} +alarms : Number of active alarms {uint64} +critical : Number of alarms of severity 'critical' {uint64} +major : Number of alarms of severity 'major' {uint64} +minor : Number of alarms of severity 'minor' {uint64} +warning : Number of alarms of severity 'warning' {uint64} +informational : Number of alarms of severity 'informational' {uint64} + +127.0.0.1:6379[6]> hgetall "ALARM_STATS|state" + 1) "alarms" + 2) "1" + 3) "critical" + 4) "1" + 5) "major" + 6) "0" + 7) "minor" + 8) "0" + 9) "warning" +10) "0" + +``` +### 3.1.8 Pull Model +All NBIs - CLI, REST and gNMI - can pull contents of alarm table and event table. +The following filters are supported: +- ALL ( pulls all alarms) +- Severity. +- Recent alarms (eg., last 5 minutes, one hour, one day). +- Records between two timestamps, one timestamp and end, and beginning and a timestamp. +- All records between two Sequence Numbers (incl end and begin) + +### 3.1.9 Supporting third party containers +To support third party components ( e.g. FRR, teamd, DHCP Relay, LLDPd, ntpd etc ) which can not be modified to raise events, the following options are considered +and are being evaluated. +1. Patch the components + Create a patch for these components by adding libeventnotify library and invoke the API. This however, requires these patches need to be maintained in the code forever. + +2. Listen to syslog messages + As many of these components raises syslog messages on an important event, a listener can be implemented to read incoming syslog messages and raise + events based on the message. + This however is heavy on performance due to the fact that listener has to parse each syslog message. Also listener need to maintain a map of messages to + event-id and need to be aware of resource and other specific details. It need to be aware of nuances of alarm raising/clearing if the component follows + any specific logic. + +Approach 1 is preferred. + +## 3.2 DB Changes +### 3.2.1 EVENT DB +A new instance, redis4, is created and EVENT DB uses the new instance. +The following tables uses Event DB. +Table EVENTPUBSUB is used for applications to write events and for eventd to access and process them. +Event Table (EVENT) and Alarm Table (ALARM) are used to house events and alarms respectively. +To maintain various statistics of events, these two tables are used : EVENT_STATS and ALARM_STATS. + +EVPROFILE table is used by mgmt-framework to communicate name of the custom event profile when configured through NBI. +Eventd reads the file name from this table and merges it with its static_event_map. + +## 3.3 User Interface +### 3.3.1 Data Models + +The following is SONiC yang for events. +``` +module: sonic-event + +--rw sonic-event + +--rw EVENT + | +--rw EVENT_LIST* [id] + | +--rw id uint64 + | +--rw revision uint64 + | +--rw resource? string + | +--rw text? string + | +--rw time-created? timeticks64 + | +--rw type-id? string + | +--rw severity? severity-type + | +--rw action? action-type + +--rw EVENT_STATS + +--rw EVENT_STATS_LIST* [id] + +--rw id enumeration + +--rw events? uint64 + +--rw raised? uint64 + +--rw acked? uint64 + +--rw cleared? uint64 + + rpcs: + +---x show-events + +---w input + | +---w (option)? + | +--:(time) + | | +---w time + | | +---w begin? yang-types:date-and-time + | | +---w end? yang-types:date-and-time + | +--:(last-interval) + | | +---w interval? enumeration + | +--:(severity) + | | +---w severity? severity-type + | +--:(id) + | +---w id + | +---w begin? string + | +---w end? string + +--ro output + +--ro status? int32 + +--ro status-detail? string + +--ro EVENT + +--ro EVENT_LIST* [id] + +--ro id uint64 + +--ro revision uint64 + +--ro resource? string + +--ro text? string + +--ro time-created? timeticks64 + +--ro type-id? string + +--ro severity? severity-type + +--ro action? action-type +``` + +The following is SONiC yang for alarms. +``` +module: sonic-alarm + +--rw sonic-alarm + +--rw ALARM + | +--rw ALARM_LIST* [id] + | +--rw id uint64 + | +--rw revision uint64 + | +--rw resource? string + | +--rw text? string + | +--rw time-created? event:timeticks64 + | +--rw type-id? string + | +--rw severity? event:severity-type + | +--rw acknowledged? boolean + | +--rw acknowledge-time? event:timeticks64 + +--rw ALARM_STATS + +--rw ALARM_STATS_LIST* [id] + +--rw id enumeration + +--rw alarms? uint64 + +--rw critical? uint64 + +--rw major? uint64 + +--rw minor? uint64 + +--rw warning? uint64 + +--rw acknowledged? uint64 + + rpcs: + +---x acknowledge-alarms + | +---w input + | | +---w id* string + | +--ro output + | +--ro status? int32 + | +--ro status-detail? string + +---x unacknowledge-alarms + | +---w input + | | +---w id* string + | +--ro output + | +--ro status? int32 + | +--ro status-detail? string + +---x show-alarms + +---w input + | +---w (option)? + | +--:(time) + | | +---w time + | | +---w begin? yang-types:date-and-time + | | +---w end? yang-types:date-and-time + | +--:(last-interval) + | | +---w interval? enumeration + | +--:(severity) + | | +---w severity? event:severity-type + | +--:(id) + | +---w id + | +---w begin? string + | +---w end? string + +--ro output + +--ro status? int32 + +--ro status-detail? string + +--ro ALARM + +--ro ALARM_LIST* [id] + +--ro id uint64 + +--ro revision uint64 + +--ro resource? string + +--ro text? string + +--ro time-created? event:timeticks64 + +--ro type-id? string + +--ro severity? event:severity-type + +--ro acknowledged? boolean + +--ro acknowledge-time? event:timeticks64 +``` + +Following is for sonic yang to support event profiles. +``` +module: sonic-evprofile + + rpcs: + +---x get-evprofile + | +--ro output + | +--ro file-name? string + | +--ro file-list* string + +---x set-evprofile + +---w input + | +---w file-name? string + +--ro output + +--ro status? string +``` + +openconfig alarms yang is defined at [here](https://github.com/openconfig/public/blob/master/release/models/system/openconfig-alarms.yang) + +### 3.3.2 CLI +#### 3.3.2.1 Exec Commands +``` +sonic# alarm acknowledge +``` +An operator can acknolwedge a raised alarm. This indicates that the operator is aware of the fault condition and considers the condition not catastrophic. +Acknowledging an alarm updates alarm statistics and thereby applications like pmon can remove the particular alarm from status consideration. + +The alarm record in the ALARM table is marked with acknowledged field set to true. There is acknowledge-time field that indicates when that alarm is acknowledged. + +``` +sonic# alarm unacknowledge +``` +An operator can un-acknolwedge a previously acknowledged raised alarm. +Un-acknowledging an alarm updates alarm statistics and thereby applications like pmon can take the particular alarm into status consideration. + +The alarm record in the ALARM table is marked with acknowledged field set to false. +There is acknowledge-time field that indicates when that alarm is un-acknowledged. + +``` +sonic# event profile +``` +The command takes name of specified file, validates it for its syntax and values; merges it with its internal static map of events *static_event_map*. + +``` +sonic# clear event +``` +This command clears all the records in the event table. All the event stats are cleared. +The command will not affect alarm table or alarm statistics. +Eventd generates an event informing that event table is cleared. + +#### 3.3.2.2 Configuration Commands +``` +sonic(config)# logging server [log|event] +``` +Note: The 'logging server' command is an existing, already supported command. +It is only enhanced to take either 'log' or 'event' to indicate either native syslog messages or syslog messages corresponding to events alone are sent to the remote host. +Support with VRF/source-interface and configuring remote-port are all backward comaptible and will be applicable to either 'log' or 'event' options. + +#### 3.3.2.3 Show Commands +``` +sonic# show event profile +-------------------------- +Active Event Profile +-------------------------- +myProfile.json +-------------------------- +Available Event Profiles +-------------------------- +default.json +myProfile.json +userProfile.json + +sonic# show event [ details | summary | severity | start end | recent <5min|60min|24hr> | id | from to ] + +'show event' commands would display all the records in EVENT table. + +sonic# show event +---------------------------------------------------------------------------------------------------------------------------- +Id Action Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +1 - WARNING CUSTOM_EVPROFILE_CHANGE 2021-05-19T21:38:27.455Z handle_custom_evprofile: Custom Event Profile x.json is applied. +2 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:39:31.622Z signalHandler: Raising simulated alarm +3 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:42:34.371Z signalHandler: Clearing simulated alarm +4 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:46:14.371Z signalHandler: Raising simulated alarm +5 ACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:48:05.845Z Alarm id 4 ACKNOWLEDGE. +6 UNACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:53:24.484Z Alarm id 4 UNACKNOWLEDGE. +7 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:55:54.977Z signalHandler: Clearing simulated alarm + +sonic# show event details +---------------------------------------------- +Event Details - 1 +---------------------------------------------- +Id: 1 +Revision: 0 +Action: - +Severity: WARNING +Type: CUSTOM_EVPROFILE_CHANGE +Timestamp 2021-05-19T21:38:27.455Z +Description: handle_custom_evprofile: Custom Event Profile x.json is applied. +Source: /etc/evprofile/x.json + +---------------------------------------------- +Event Details - 2 +---------------------------------------------- +Id: 2 +Revision: 1 +Action: RAISE +Severity: CRITICAL +Type: DUMMY_ALARM +Timestamp 2021-05-19T21:39:31.622Z +Description: signalHandler: Raising simulated alarm +Source: simulation + +---------------------------------------------- +Event Details - 3 +---------------------------------------------- +Id: 3 +Revision: 0 +Action: CLEAR +Severity: CRITICAL +Type: DUMMY_ALARM +Timestamp 2021-05-19T21:42:34.371Z +Description: signalHandler: Clearing simulated alarm +Source: simulation + +sonic# show event summary +Event summary +--------------------------------- +Total: 14 +Raised: 4 +Acknowledged: 1 +Cleared: 3 +---------------------------------- + +sonic# show event severity critical +---------------------------------------------------------------------------------------------------------------------------- +Id Action Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +2 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:39:31.622Z signalHandler: Raising simulated alarm +3 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:42:34.371Z signalHandler: Clearing simulated alarm +4 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:46:14.371Z signalHandler: Raising simulated alarm +5 ACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:48:05.845Z Alarm id 4 ACKNOWLEDGE. +6 UNACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:53:24.484Z Alarm id 4 UNACKNOWLEDGE. +7 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:55:54.977Z signalHandler: Clearing simulated alarm + +sonic# show event recent 24hr +---------------------------------------------------------------------------------------------------------------------------- +Id Action Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +2 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:39:31.622Z signalHandler: Raising simulated alarm +3 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:42:34.371Z signalHandler: Clearing simulated alarm +4 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:46:14.371Z signalHandler: Raising simulated alarm +5 ACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:48:05.845Z Alarm id 4 ACKNOWLEDGE. +6 UNACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:53:24.484Z Alarm id 4 UNACKNOWLEDGE. +7 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:55:54.977Z signalHandler: Clearing simulated alarm + +sonic# show event id 2 +---------------------------------------------- +Event Details - 2 +---------------------------------------------- +Id: 2 +Revision: 1 +Action: RAISE +Severity: CRITICAL +Type: DUMMY_ALARM +Timestamp 2021-05-19T21:39:31.622Z +Description: signalHandler: Raising simulated alarm +Source: simulation + +sonic# show event from 2 to 5 +---------------------------------------------------------------------------------------------------------------------------- +Id Action Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +2 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:39:31.622Z signalHandler: Raising simulated alarm +3 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:42:34.371Z signalHandler: Clearing simulated alarm +4 RAISE CRITICAL DUMMY_ALARM 2021-05-19T21:46:14.371Z signalHandler: Raising simulated alarm +5 ACKNOWLEDGE CRITICAL DUMMY_ALARM 2021-05-19T21:48:05.845Z Alarm id 4 ACKNOWLEDGE. + +sonic# show event start 2021-05-19T21:39:31.622Z end 2021-05-19T21:46:14.371Z +---------------------------------------------------------------------------------------------------------------------------- +Id Action Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +3 CLEAR CRITICAL DUMMY_ALARM 2021-05-19T21:42:34.371Z signalHandler: Clearing simulated alarm + +sonic# show alarm [ acknowledged | all | detail | summary | severity | id | start end | recent <5min|1hr|1day> | from to ] + +'show alarm' command would display all the *active* alarm records in ALARM table. Acknowledged alarms wont be shown here. + +sonic# show alarm +---------------------------------------------------------------------------------------------------------------------------- +Id Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +14 WARNING TEMPERATURE_EXCEEDED 2021-05-20T00:47:52.992Z temperatureCrossedThreshold: Current temperature of sensor/2 is 76 degrees +16 WARNING PSU_FAULT 2021-05-20T02:16:42.611Z :- /psu/2 has experienced a fault + +sonic# show alarm all +---------------------------------------------------------------------------------------------------------------------------- +Id Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +14 WARNING TEMPERATURE_EXCEEDED 2021-05-20T00:47:52.992Z temperatureCrossedThreshold: Current temperature of sensor/2 is 76 degrees +15 WARNING DUMMY_ALARM 2021-05-20T02:16:41.637Z signalHandler: Raising simulated alarm +16 WARNING PSU_FAULT 2021-05-20T02:16:42.611Z /psu/2 has experienced a fault + + +sonic# show alarm detail + +alarm details - 14 +------------------------------------------- +Id: 14 +Revision: 0 +Severity: CRITICAL +Source: /sensor/2 +Name: TEMPERATURE_EXCEEDED +Description: temperatureCrossedThreshold: Current temperature of sensor/2 is 76 degrees +Raise-time: Wed Feb 10 18:08:24 2021 +Ack-time: +New: true +Acknowledged: false + +sonic# show alarm from 14 to 16 +---------------------------------------------------------------------------------------------------------------------------- +Id Severity Name Timestamp Description +---------------------------------------------------------------------------------------------------------------------------- +14 WARNING TEMPERATURE_EXCEEDED 2021-05-20T00:47:52.992Z temperatureCrossedThreshold: Current temperature of sensor/2 is 76 degrees +15 WARNING DUMMY_ALARM 2021-05-20T02:16:41.637Z signalHandler: Raising simulated alarm +16 WARNING PSU_FAULT 2021-05-20T02:16:42.611Z /psu/2 has experienced a fault + +sonic# show alarm summary +Alarm summary +--------------------------------- +Total: 3 +Critical: 0 +Major: 0 +Minor: 0 +Warning: 3 +Acnowledged: 2 +---------------------------------- +``` + +### 3.3.3 REST API Support + +sonic REST links: +* /restconf/data/sonic-event:sonic-event/EVENT/EVENT_LIST +* /restconf/data/sonic-event:sonic-event/EVENT_STATS/EVENT_STATS_LIST +* /restconf/data/sonic-alarm:sonic-alarm/ALARM/ALARM_LIST +* /restconf/data/sonic-alarm:sonic-alarm/ALARM_STATS/ALARM_STATS_LIST +* /restconf/operations/sonic-evprofile:get-evprofile +* /restconf/operations/sonic-evprofile:set-evprofile +* /restconf/operations/sonic-alarm:acknowledge-alarms +* /restconf/operations/sonic-alarm:unacknowledge-alarms + +openconfig REST links: +* /restconf/data/openconfig-system:system/openconfig-events:events +* /restconf/data/openconfig-system:system/openconfig-events:event-stats +* /restconf/data/openconfig-system:system/alarms +* /restconf/data/openconfig-system:system/openconfig-alarms-ext:alarm-stats + +# 4 Flow Diagrams +![Sequence Diagram](event-alarm-framework-seqdiag.png) + +# 5 Warm Boot Support +## 5.1 Application warm boot +Applications confirming to the warm boot, should have stored their state and compare current values against previous values. +Such compliant application also "remembers" that it raised an event before for a specific condition. +They would +* not raise alarms/events for the same condition that it raised pre warm boot +* clear those alarms once current state of a particular condition is recovered (by comparing against the stored state). + +## 5.2 eventd warm boot +Records from applications are stored in a table, called EVENTPUBSUB. +Records that are being written will be queued when the consumer (eventd) is down. + +During normal operation, eventd reads, processes whenever a new record is added to the table. + +When eventd is restarted, events and alarms raised by applications will be waiting in a queue while eventd is coming up. +When eventd eventually comes back up, it reads those records in the queue. + +# 6 Scalability +In this feature, scalability applies to Event Table (EVENT). As it is persistent and it records every event generated on the system, to protect +against it growing indefinitely, user can limit its size through a manifest file. +By default, the size of Event Table is set to 40k events or events for 30 days - after which, older records are discarded to make way for new records. + +# 7 Showtech support +The techsupport bundle is upgraded to include output of "show event recent 60min†and “show alarm allâ€. +The first command displays all the events that were sent by applications for the last one hour. +The second command displays all the alarms that are waiting to be cleared by applications (this includes alarms that were acknowledged by operator as well). + +# 8 Unit Test +- Raise an event and verify the fields in EVENT table and EVENT_STATS table +- Raise an alarm and verify the fields in ALARM table and ALARM_STATS table +- Clear an alarm and verify that record is removed from ALARM and ALARM_STATS tables are udpated +- Ack an alarm and verify that acknowledged flag is set to true in ALARM table and acknowledge-time is set +- Un-Ack an alarm and verify that acknowledged flag is set to false in ALARM table and acknowledge-time is set +- Verify wrap around for EVENT table ( change manifest file to a lower range and trigger that many events ) +- Verify sequence-id for events is persistent by restarting +- Verify counters by raising various alarms with different severities +- Change severity of an event through custom event profile and verify it is logged at specified severity +- Change enable/disable of an event through custom event profile and verify it is suppressed +- Verify custom event profile with an invalid severity is rejected +- Verify custom event profile with an invalid enable/disable flag is rejected +- Verify custom event profile is persisted after a reboot +- Verify various show commands +- Verify 'logging-server event' command forwards only event log messages to the host From 67e7e73af21bac324f328c8ecfa54d53a58695eb Mon Sep 17 00:00:00 2001 From: EdenGri <63317673+EdenGri@users.noreply.github.com> Date: Tue, 30 Aug 2022 18:17:18 +0300 Subject: [PATCH 05/18] Persistent loglevel HLD (#1041) * Add HLD for persistent logger --- .../persistent-logger-flow.png | Bin 0 -> 145549 bytes .../persistent_logger/persistent_loglevel.md | 491 ++++++++++++++++++ 2 files changed, 491 insertions(+) create mode 100644 doc/logging/persistent_logger/persistent-logger-flow.png create mode 100644 doc/logging/persistent_logger/persistent_loglevel.md diff --git a/doc/logging/persistent_logger/persistent-logger-flow.png b/doc/logging/persistent_logger/persistent-logger-flow.png new file mode 100644 index 0000000000000000000000000000000000000000..308093d926296fb64bdc8584b1dffaf309084513 GIT binary patch literal 145549 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 G4g5c=jg~_I literal 0 HcmV?d00001 diff --git a/doc/logging/persistent_logger/persistent_loglevel.md b/doc/logging/persistent_logger/persistent_loglevel.md new file mode 100644 index 0000000000..3ac80032a9 --- /dev/null +++ b/doc/logging/persistent_logger/persistent_loglevel.md @@ -0,0 +1,491 @@ +# Persistent log level HLD + +# High Level Design Document + +#### Rev 0.1 + +# Table of Contents +- [Persistent log level HLD](#persistent-log-level-hld) +- [High Level Design Document](#high-level-design-document) + - [Rev 0.1](#rev-01) +- [Table of Contents](#table-of-contents) +- [List of Tables](#list-of-tables) +- [List of Figures](#list-of-figures) +- [Revision](#revision) +- [Scope](#scope) +- [Motivation](#motivation) +- [Definitions/Abbreviation](#definitionsabbreviation) +- [1 Background](#1-background) + - [1.1 "swssloglevel" usage](#11-"swssloglevel"-usage) + - [1.2 LOGLEVEL DB schema](#12-loglevel-db-schema) +- [2 Requirements Overview](#2-requirements-overview) +- [3 Persistent log level design](#3-persistent-log-level-design) + - [3.1 High-level design](#31-high-level-design) + - [3.1.1 Move Logger's tables which store in LOGLEVEL DB to CONFIG DB](#311-move-logger's-tables-which-store-in-loglevel-db-to-config-db) + - [3.1.2 Update "swssloglevel" script](#312-update-"swssloglevel"-script) + - [3.1.3 Make the log level persistent using the "config save" CLI command](#313-make-the-log-level-persistent-using-the-"config-save"-cli-command) + - [3.1.4 Listener thread tables](#314-listener-thread-tables) + - [3.1.5 Removing LOGLEVEL DB - phase 2](#315-removing-loglevel-db-phase-2) + - [3.2 Persistent Logger flow](#32-persistent-logger-flow) +- [4 Flows](#4-flows) + - [4.1 System init flow](#41-system-init-flow) +- [5 Cold and Fast Reboot Support](#5-cold-and-fast-reboot-support) +- [6 Warm Reboot Support](#6-warm-reboot-support) + - [6.1 Support warm upgrade](#61-support-warm-upgrade) +- [7 Support downgrade](#7-support-warm-downgrade) +- [8 Yang model](#8-yang-model) +- [9 Testing](#8-testing) + - [9.1 Unit Testing](#91-unit-testing) + - [9.2 Manual Testing](#92-manual-testing) + + + +# List of Tables +* [Table 1: Abbreviations](#definitionsabbreviation) + + +# List of Figures +* [persistent logger flow](#321-return-to-default-log-level) + + + +# Revision +| Rev | Date | Author | Change Description | +|:---:|:--------:|:---------------:|-----------------------------------| +| 0.1 | 07/20/22 | Eden Grisaro | Initial version | + +# Scope +This document provides high level design for SWSS Logger - log level persistent for SWSS, Syncd, and SAI components. + +# Motivation +Log level verbosity is part of the configuration of the OS. Today, the log level is not persistent and gets a default value after reboot. It is required to add the ability to make the loglevel persistent. + +# Definitions/Abbreviation +| Abbreviation | Description | +|---------------|-------------------------------------------| +| SONiC | Software for open networking in the cloud | +| SAI | Switch Abstraction Interface | +| CONFIG DB | Configuration Database | + + +# 1 Background +Today, the user can configure the log level verbosity to each component in SWSS, Syncd, and SAI. In order to configure the log level in runtime, the user uses the **"swssloglevel" script**. The script updates the **LOGLEVEL DB** with the new verbosity. After a cold/fast reboot, the LOGLEVEL DB flushes, and the log level value of all components returns to default. For warm reboot, the log level will remain (as it is in today's implementation). + +## 1.1 "swssloglevel" usage + +The "swssloglevel" options: + +``` +admin@sonic:~$ swssloglevel -h +Usage: swssloglevel [OPTIONS] +SONiC logging severity level setting. + +Options: + -h print this message + -l loglevel value + -c component name in DB for which loglevel is applied (provided with -l) + -a apply loglevel to all components (provided with -l) + -s apply loglevel for SAI api component (equivalent to adding prefix "SAI_API_" to component) + -p print components registered in DB for which setting can be applied + +Examples: + swssloglevel -l NOTICE -c orchagent # set orchagent severity level to NOTICE + swssloglevel -l SAI_LOG_LEVEL_ERROR -s -c SWITCH # set SAI_API_SWITCH severity to ERROR + swssloglevel -l SAI_LOG_LEVEL_DEBUG -s -a # set all SAI_API_* severity to DEBUG + +``` + +## 1.2 LOGLEVEL DB schema + +The LOGLEVEL DB is database #3. It contains a table for each component. +Here is an example of the orchagent component table: + +``` +admin@sonic:~$ redis-cli -n 3 HGETALL "orchagent:orchagent" + +1) “LOGLEVEL†+ +2) “INFO†+ +3) “LOGOUTPUT†+ +4) “SYSLOG†+``` + + +# 2 Requirements Overview + +The persistent Logger should meet the following high-level functional requirement: +- The user will be able to save the configuration of the loglevel and make it persistent after reboot. +- Warm/Fast reboot won't be impacted following this change. + +# 3 Persistent log level design +## 3.1 High-level design + +To make the loglevel persistent to reboot, we will move the Logger's tables in LOGLEVEL DB to CONFIG DB. Since the Config DB is already persistent, the log level will also be persistent to reboot. The log level will be saved using the "config save" CLI command. + +We will split this design into two phases to keep the pr with a small content: + +Phase 1: make the loglevel persistent by moving it to the CONFIG DB. + +Phase 2: Removing LOGLEVEL DB and the jinja2 cache. + +### 3.1.1 Move Logger's tables which store in LOGLEVEL DB to CONFIG DB + +#### Current LOGLEVEL DB schema: + + ```json +{ + "orchagent": { + "orchagent": { + "LOGLEVEL": "INFO", + "LOGOUTPUT": "SYSLOG" + } + }, + + "SAI_API_BUFFER": { + "SAI_API_BUFFER": { + "LOGLEVEL": "SAI_LOG_LEVEL_NOTICE", + "LOGOUTPUT": "SYSLOG" + } + }, + + "JINJA2_CACHE": { + + } +} +``` + +#### New CONFIG DB schema: + + - A new "LOGGER" table will be added to the CONFIG DB. + - There will be a minor change in the table keys(instead of "{componentName}:{componentName}" the key will be the "Logger:{componentName}"). + - The filed logoutput that indicates to which file to print the logs will also be persistent. + +```json +{ + "LOGGER": { + "orchagent": { + "LOGLEVEL": "INFO", + "LOGOUTPUT": "SYSLOG" + }, + + "SAI_API_BUFFER": { + "LOGLEVEL": "INSAI_LOG_LEVEL_NOTICEFO", + "LOGOUTPUT": "SYSLOG" + } + } +} +``` + +### 3.1.2 Update "swssloglevel" script + +In the current implementation, the "swssloglevel" script sets the log level in the LOGLEVEL DB. +- We will update the script so that the log level will be saved in the CONFIG DB. +- To allow the user to set the default log level value for all the components, we will add a -d flag to the "swssloglevel" script. + The default log levels are: SWSS_NOTICE, SAI_LOG_LEVEL_NOTICE. + +``` +admin@sonic:~$ swssloglevel -h + +Usage: swssloglevel [OPTIONS] +SONiC logging severity level setting. + +Options: + -h print this message + -l loglevel value + -c component name in DB for which loglevel is applied (provided with -l) + -a apply loglevel to all components (provided with -l) + -s apply loglevel for SAI api component (equivalent to adding prefix "SAI_API_" to component) + -p print components registered in DB for which setting can be applied + -d return all components to default loglevel + +Examples: + swssloglevel -l NOTICE -c orchagent # set orchagent severity level to NOTICE + swssloglevel -l SAI_LOG_LEVEL_ERROR -s -c SWITCH # set SAI_API_SWITCH severity to ERROR + swssloglevel -l SAI_LOG_LEVEL_DEBUG -s -a # set all SAI_API_* severity to DEBUG + swssloglevel -d # return all components to default loglevel +``` +The change is the file: /sonic-swss-common/common/loglevel.cpp + +### 3.1.3 Make the log level persistent using the "config save" CLI command + +The content of the CONFIG DB will load to the config_db.json. This is our behavior today, and it remains as it is. If the user configures loglevel for some component and runs "config save" the loglevel will be persistent. + +### 3.1.4 Listener thread tables + +In the current implementation, each component has a listener thread that registers to the LOGLEVEL DB table. Each change in the LOGLEVEL DB table is caught by the thread and trigger handler that change the component's Logger configuration. We will keep the same behavior on the CONFIG DB by changing the "settingThread" function. +This change will impact the following components: + +buffermgrd +coppmgrd +fdbsyncd +fpmsyncd +gearsyncd +intfmgrd +portsyncd +syncd +teammgrd +teamsyncd +tlm_teamd +tunnelmgrd +vlanmgrd +vrfmgrd +vxlanmgrd +wjhd +nbrmgrd +neighsyncd +orchagent +portmgrd + +The change is the file: /sonic-swss-common/common/logger.cpp + + +### 3.1.5 Removing LOGLEVEL DB + + - After moving the Logger's table from LOGLEVEL DB, the leftover in LOGLEVEL DB will be the JINJA2_CACHE key. + - JINJA2_CACHE key is a bytecode cache for jinja2 template that stores bytecode in Redis. The JINJA2 cache was created to optimize the warm reboot performance. + - After the jinja2 cache was created, we added other optimizations for the warm reboot and raised the concern that the jinja2 cache does not improve the warm reboot performance anymore. After we checked the warm reboot performance with and without the jinja2 cache and saw no difference between them, we recommend removing the jinja2 cache and the LOGLEVEL DB. + +#### Removing LOGLEVEL DB from schema.h + + - Removing the LOGLEVEL DB from the dbies list. + ``` + /***** DATABASE *****/ + +#define APPL_DB 0 +#define ASIC_DB 1 +#define COUNTERS_DB 2 +#define LOGLEVEL_DB 3 +#define CONFIG_DB 4 +#define PFC_WD_DB 5 +#define FLEX_COUNTER_DB 5 +#define STATE_DB 6 +#define SNMP_OVERLAY_DB 7 +#define RESTAPI_DB 8 +#define GB_ASIC_DB 9 +#define GB_COUNTERS_DB 10 +#define GB_FLEX_COUNTER_DB 11 +#define CHASSIS_APP_DB 12 +#define CHASSIS_STATE_DB 13 +#define APPL_STATE_DB 14 + +``` + +#### Removing jinja2_cache + + - Removing /sonic-config-engine/build/lib/redis_bcc.py file. + +#### Removing LOGLEVEL DB from dbies list + +There are files (about 50 files) that contain the LOGLEVEL DB as part of a list of all the dbies. We will remove the LOGLEVEL DB from these files. + +for example /sonic-swss-common/common/table.cpp: + +``` + const TableNameSeparatorMap TableBase::tableNameSeparatorMap = { + { APPL_DB, TABLE_NAME_SEPARATOR_COLON }, + { ASIC_DB, TABLE_NAME_SEPARATOR_COLON }, + { COUNTERS_DB, TABLE_NAME_SEPARATOR_COLON }, + { LOGLEVEL_DB, TABLE_NAME_SEPARATOR_COLON }, + { CONFIG_DB, TABLE_NAME_SEPARATOR_VBAR }, + { PFC_WD_DB, TABLE_NAME_SEPARATOR_COLON }, + { FLEX_COUNTER_DB, TABLE_NAME_SEPARATOR_COLON }, + { STATE_DB, TABLE_NAME_SEPARATOR_VBAR }, + { APPL_STATE_DB, TABLE_NAME_SEPARATOR_COLON } +}; +``` + + - In addition we will remove the LOGLEVEL DB connector from /sonic-swss/fdbsyncd/fdbsyncd.cpp that not in use. + +## 3.2 Persistent Logger flow + +- Each component has a singleton Logger object with a log level property and listener thread. +- When a component writes a log message, the Logger writes the message only if the loglevel of the message is above the current loglevel property. +- When the user wants to set a new log level to a component, he uses the "swssloglevel" script. The "swssloglevel" script sets the new verbosity to the CONFIG DB (database #4). +- The CONFIG DB change triggers an event, which is caught by the listener thread. +- The listener thread changes the loglevel property of the Logger. +- The user can use the "config save" command to save the current loglevel and make it persistent. It will copy the CONFIG DB content to the config_db.json. + +In addition to the log level, the CONFIG DB contains the log output file. After "config save" the log output will be persistent to reboot too. + + + + + + + +![persistent logger flow](/doc/logging/persistent_logger/persistent-logger-flow.png) + + + + + + + +# 4 Flows + +## 4.1 System init flow + +When the system startup and the Database container initialize, and the config_db.json loads to CONFIG DB. + + - There is a concern about the log level of messages written before the database container is initialized (if it exists). From my understanding, the RSYSLOG-CONFIG is up only after the DATABASE container, so there won't be logs before the config_db.json loads to the CONFIG DB. In case there are messages before the loading, the messages will be in the default log level. + + +# 5 Cold and Fast Reboot Support + + The current implementation support cold and fast reboot. Since in the cold and fast reboot, the CONFIG DB content is deleted, the user needs to run "config save" to make the log level persistent to cold and fast reboot. + +# 6 Warm Reboot Support + + With the current implementation, we don't flush the CONFIG DB before warm-reboot, which means that if the user configures some loglevel (for example, debug), after warm-reboot, the system startup with the same configurable loglevel (debug). + +## 6.1 Support warm upgrade + + Since we are not flushing the LOGLEVEL DB when we perform a warm upgrade, we need to update the db migrator. + - Add LOGLEVEL DB connector in the db migrator. + - In case of a warm upgrade, move Logger tables from LOGLEVEL DB to CONFIG DB (with a minor change in the key) and delete LOGLEVEL DB. + - Exposing the "del" function from the swss-common/sonicv2-connector.h to the db migrator. + +# 7 Support downgrade + +In the current implementation, after a cold/fast reboot, the CONFIG DB and the LOGLEVEL DB flush, and the config_db.json loads into the CONFIG DB. +In addition, in the current implementation, after a warm reboot, the CONFIG DB and the LOGLEVEL DB are not flush, and the config_db.json does not load into the CONFIG DB. +This current state leads us not fully support the downgrade. + +Here are some scenarios to notice: +Scenario 1: + 1. We have the image with the feature. + The CONFIG DB will contain the Logger tables, and the LOGLEVEL DB will be empty. + 2. We perform a downgrade. + The CONFIG DB will not contain the Logger tables. In addition, new Logger tables with default values will be added to the LOGLEVEL DB. After the downgrade, the user will be able to change the loglevel. + 3. We perform warm-upgrade: + The Logger tables that were created in the LOGLEVEL DB from step 1 will move to the CONFIG DB. + +Scenario 2: + 1. We have the image with the feature. + The CONFIG DB will contain the Logger tables, and the LOGLEVEL DB will be empty. + 2. We perform a downgrade. + The CONFIG DB will not contain the Logger tables. In addition, new Logger tables with default values will be added to the LOGLEVEL DB. After the downgrade, the user will be able to change the loglevel. + 3. We perform a upgrade: + New Logger tables with default values will be added to the CONFIG DB. + +Scenario 3: + 1. We have the image with the feature, and the user changes the loglevel of some components. For example, the user changes the orchagent loglevel to DEBUG. + 2. running "config save". The Logger tables are saved to the config_db.json and are persistent. + 3. We perform a downgrade. + The CONFIG DB will contain the Logger tables from the config_db.json. In addition, new Logger tables with default values will be added to the LOGLEVEL DB. After the downgrade, the user will be able to change the loglevel. + 4. We perform warm-upgrade: + The Logger tables from the LOGLEVEL DB will override the unused Logger tables of the CONFIG DB. + + +# 8 Yang model + + The following YANG model will be added in order to provide support for the Logger: + - sonic-logger.yang + + ``` + + description "Logger Table yang Module for SONiC"; + + typedef swss_loglevel { + type enumeration { + enum EMERG; + enum ALERT; + enum CRIT; + enum ERROR; + enum WARN; + enum NOTICE; + enum INFO; + enum DEBUG; + } + } + + typedef sai_loglevel { + type enumeration { + enum SAI_LOG_LEVEL_CRITICAL; + enum SAI_LOG_LEVEL_ERROR; + enum SAI_LOG_LEVEL_WARN; + enum SAI_LOG_LEVEL_NOTICE; + enum SAI_LOG_LEVEL_INFO; + enum SAI_LOG_LEVEL_DEBUG; + } + } + + container sonic-logger { + + container LOGGER { + + description "Logger table in config_db.json"; + + list LOGGER_LIST { + + key "name"; + + leaf name { + description "Component name in LOGGER table (example for component: orchagent, Syncd, SAI components)."; + type string; + } + + leaf LOGLEVEL { + description "The log verbosity for the component"; + mandatory true; + type union { + type swss_loglevel; + type sai_loglevel; + } + } + + leaf LOGOUTPUT { + type enumeration { + enum SYSLOG; + enum STDOUT; + enum STDERR; + } + default SYSLOG; + } + } + /* end of list LOGGER_LIST */ + } + /* end of LOGGER container */ + } + /* end of sonic-logger container */ + + + ``` + + +# 9 Testing + +## 9.1 Unit Testing + + - Update the existing test that uses the LOGLEVEL DB: + /sonic-swss-common/tests/logger_ut.cpp + + - Verify the log levels of all components returns to default after running "swssloglevel -d": + - Change the log level for some components from Notice to Info. + - Run "swssloglevel -d". + - Verify all components return to the default log level. + + - Yang model tests: + - Logger table with a wrong loglevel, or with a wrong logoutput + - Logger table without loglevel or logoutput fileds + - Logger table with valid values + +## 9.2 Manual Testing + + - Verify the log level is persistent to cold/fast/warm reboot after the user runs "config save": + - Change the log level for some component from Notice to Info. + - Run "config save". + - Verify the loglevel.json file was created. + - Reboot. + - Verify the log level is "Info". + - Verify the log level is not persistent to cold/fast reboot if the user didn't run "config save": + - Change the log level for some components from Notice to Info. + - Reboot. + - Verify the log level is "Notice". + - Verify that we able change the log level for all the components. + - Verify the LOGLEVEL DB does not contain the Logger tables after a warm upgrade. + - Verify the CONFIG DB contains the Logger tables after a warm upgrade. + + From 515864b2984e61a1420ce6921fb787c64917e1a7 Mon Sep 17 00:00:00 2001 From: maipbui Date: Wed, 7 Sep 2022 04:04:06 +0000 Subject: [PATCH 06/18] Update URLs from Azure to sonic-net Signed-off-by: maipbui --- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- CONTRIBUTING.md | 2 +- MoM.html | 60 ++++++------ contact.html | 4 +- doc/SONiC 201904 Release Notes.md | 12 +-- doc/SONiC-User-Manual.md | 44 ++++----- doc/SONiC_201911_Release_Notes.md | 68 ++++++------- doc/SONiC_202006_Release_Notes.md | 50 +++++----- doc/SONiC_202012_Release_Notes.md | 70 ++++++------- doc/SONiC_202106_Release_Notes.md | 64 ++++++------ doc/SONiC_202111_Release_Notes.md | 98 +++++++++---------- doc/Sonic BSL Test plan.md | 18 ++-- doc/aaa/TACACS+ Design.md | 6 +- doc/aaa/TACACS+ Test Plan.md | 2 +- doc/aaa/radius_authentication.md | 2 +- doc/acl/ACL-High-Level-Design.md | 12 +-- doc/acl/ACL-Ingress-Egress-test-plan.md | 2 +- doc/acl/Everflow-test-plan.md | 6 +- doc/acl/egress-acl-bug-fix-description.md | 2 +- doc/arp/Proxy Arp.md | 4 +- doc/asic_thermal_monitoring_hld.md | 4 +- doc/auto_techsupport_and_coredump_mgmt.md | 4 +- doc/barefoot_dtel/Dtel-SONiC.md | 2 +- doc/bfd/BFD HW Offload HLD.md | 6 +- doc/buffer-watermark/watermarks_HLD.md | 10 +- doc/cbf/cbf_hld.md | 4 +- .../cli_auto_generation.md | 14 +-- .../Json_Change_Application_Design.md | 2 +- ...Patch_Ordering_using_YANG_Models_Design.md | 18 ++-- ...neric_Config_Update_and_Rollback_Design.md | 32 +++--- .../SONiC-Console-Switch-High-Level-Design.md | 4 +- doc/copp/CoPP Config and Management.md | 10 +- ...l-Resource-Monitoring-High-Level-Design.md | 8 +- doc/dualtor/active_active_hld.md | 2 +- .../sonic-dynamic-port-breakout-HLD.md | 8 +- doc/ecmp/fine_grained_next_hop_hld.md | 2 +- .../error_handling_design_spec.md | 2 +- .../Fast-reboot_Flow_Improvements_HLD.md | 8 +- doc/flow_counters/routes_flow_counters.md | 4 +- doc/kubernetes/Kubernetes-support.md | 4 +- .../LACP Fallback Feature for SONiC_v0.5.md | 8 +- doc/lag/LACP Fallback Test Plan.md | 10 +- doc/macsec/MACsec_hld.md | 4 +- doc/mclag/MCLAG_Enhancements_HLD.md | 2 +- doc/mclag/Sonic-mclag-hld.md | 16 +-- doc/mgmt/Management Framework.md | 14 +-- ...nagement Framework Show Techsupport HLD.md | 2 +- doc/mgmt/SONiC_YANG_Model_Guidelines.md | 12 +-- doc/mgmt/sonic-acl.yang | 2 +- .../sonic_stretch_management_vrf_design.md | 14 +-- doc/multi_asic/SONiC_multi_asic_hld.md | 4 +- doc/nat/nat_design_spec.md | 2 +- doc/nvgre_tunnel/nvgre_tunnel.md | 12 +-- doc/passw_hardening/hld_password_hardening.md | 2 +- doc/passw_hardening/sonic-passwh.yang | 2 +- doc/pbh/pbh-design.md | 4 +- doc/pcie-mon/pcie-monitoring-services-hld.md | 6 +- doc/pfc_asym/PFC_Asymmetric_Test_HLD.md | 8 +- doc/pins/Packet_io.md | 2 +- doc/pins/pins_hld.md | 6 +- doc/platform/pde.md | 2 +- doc/platform_api/new_platform_api.md | 2 +- doc/pmon/pmon-chassis-design.md | 2 +- doc/pmon/pmon-enhancement-design.md | 6 +- doc/pmon/pmon_multiasic_design.md | 4 +- doc/pmon/sonic_platform_test_plan.md | 2 +- doc/pmon/sonic_thermal_control_test_plan.md | 2 +- .../dynamic_port_add_del_hld.md | 24 ++--- .../port-config-refactor-design.md | 18 ++-- .../port-auto-negotiation-design.md | 6 +- .../sonic_port_buffer_drop_counters.md | 4 +- .../port-link-training-design.md | 6 +- doc/psud/PSU_daemon_design.md | 4 +- doc/qos/dynamically-headroom-calculation.md | 6 +- doc/qos/tunnel_dscp_remapping.md | 8 +- doc/recirculation-port/recirculation_port.md | 4 +- doc/sflow/Sflow_test_plan.md | 2 +- .../Interface-Link-bring-up-sequence.md | 4 +- doc/snmp/extension-to-physical-entity-mib.md | 8 +- doc/snmp/snmp-configdb-migration-hld.md | 2 +- .../img/docker-infra-concepts.svg | 8 +- .../img/packages-json.svg | 8 +- .../sonic-application-extension-guide.md | 6 +- .../sonic-application-extention-hld.md | 24 ++--- doc/sonic-build-system/build-enhancements.md | 4 +- .../build_system_improvements.md | 2 +- ...ontrol-sonic-behaviors-with-sonic-flags.md | 4 +- doc/ssdhealth_design.md | 2 +- doc/subport/sonic-sub-port-intf-hld.md | 14 +-- doc/synchronous-mode/synchronous-mode-cfg.md | 2 +- doc/syslog/syslog-design.md | 2 +- doc/system-telemetry/grpc_telemetry.md | 2 +- doc/tpid/SonicTPIDSettingHLD1.md | 2 +- doc/voq/bgp_voq_chassis.md | 2 +- doc/voq/everflow.md | 2 +- doc/voq/fabric.md | 2 +- doc/voq/voq_hld.md | 2 +- doc/vrf/sonic-vrf-hld.md | 4 +- doc/vxlan/EVPN/EVPN_VXLAN_HLD.md | 2 +- doc/vxlan/Overlay ECMP with BFD.md | 8 +- doc/vxlan/Vxlan_hld.md | 14 +-- doc/warm-reboot/code_implementation.md | 10 +- doc/warm-reboot/open_issues.md | 6 +- doc/warm-reboot/system-warmboot.md | 6 +- doc/xrcvd/OIDsforSensorandTransciver.MD | 2 +- doc/xrcvd/transceiver-monitor-hld.md | 6 +- generate_sonic_image_links.sh | 26 ++--- index.html | 44 ++++----- menu.html | 36 +++---- pdf/newsletters/SONiC_newsletter_2019_10.html | 16 +-- pdf/newsletters/SONiC_newsletter_2019_12.html | 10 +- pdf/newsletters/SONiC_newsletter_2020_06.html | 40 ++++---- pdf/newsletters/SONiC_newsletter_2020_09.html | 32 +++--- pdf/newsletters/SONiC_newsletter_2020_12.html | 20 ++-- pdf/newsletters/SONiC_newsletter_2021_03.html | 22 ++--- pdf/newsletters/SONiC_newsletter_2021_06.html | 14 +-- pdf/newsletters/SONiC_newsletter_2021_12.html | 18 ++-- previous_presentations.html | 8 +- sonic-acl.yang | 2 +- thermal-control-design.md | 2 +- 120 files changed, 680 insertions(+), 680 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 36cd108f9d..46eb6e2ac7 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -7,4 +7,4 @@ assignees: '' --- -**We do not triage issue for this repo. All issues are triaged in Azure/sonic-buildimage repo** +**We do not triage issue for this repo. All issues are triaged in sonic-net/sonic-buildimage repo** diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0350e9959b..d9358ee8cd 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -34,7 +34,7 @@ For example: * Use issues to keep track of what is going on ##Expectations for pull requests -Pull requests should be free of any known bugs and be accompanied by tests and appropriate documentation. Test coverage may include unit tests, integration tests such as [PTF tests](https://github.com/Azure/SONiC/wiki/HOWTO-write-a-PTF-Test) defined in the [sonic-mgmt repo](https://github.com/Azure/sonic-mgmt/tree/master/ansible/roles/test/tasks). +Pull requests should be free of any known bugs and be accompanied by tests and appropriate documentation. Test coverage may include unit tests, integration tests such as [PTF tests](https://github.com/sonic-net/SONiC/wiki/HOWTO-write-a-PTF-Test) defined in the [sonic-mgmt repo](https://github.com/sonic-net/sonic-mgmt/tree/master/ansible/roles/test/tasks). ## Commiting new test When commiting a new feature with a new test, please complete a [test plan from the template](doc/SONiC%20Test%20Plan%20Template.md) diff --git a/MoM.html b/MoM.html index 88c8870acb..066eb50377 100755 --- a/MoM.html +++ b/MoM.html @@ -151,7 +151,7 @@

    SONiC community meeting minutes

      Mar 29 2022    - DSCP/TC Remapping for Tunnel traffic HLD + DSCP/TC Remapping for Tunnel traffic HLD MoM @@ -171,12 +171,12 @@

    SONiC community meeting minutes

      Mar 01 2022    - Build-Enhancements + Build-Enhancements MoM   Feb 22 2022    - auto-techsupport + auto-techsupport MoM @@ -191,17 +191,17 @@

    SONiC community meeting minutes

      Feb 01 2022    - Counter delay via config_db + Counter delay via config_db MoM   Jan 25 2021    - Add VLAN Stacking + Add VLAN Stacking MoM   Jan 18 2021    - Deterministic approach in SONiC for Interface Link bring-up sequence + Deterministic approach in SONiC for Interface Link bring-up sequence MoM @@ -236,7 +236,7 @@

    SONiC community meeting minutes

      Nov 30 2021    - 202111 Release Tracking + 202111 Release Tracking MoM @@ -291,7 +291,7 @@

    SONiC community meeting minutes

      Sep 14 2021    - ECMP Overlay BFD support + ECMP Overlay BFD support MoM @@ -301,12 +301,12 @@

    SONiC community meeting minutes

      Aug 31 2021    - Show Running Command Enhancement + Show Running Command Enhancement MoM   Aug 24 2021    - SAG - Static Anycast Gateway + SAG - Static Anycast Gateway MoM @@ -316,12 +316,12 @@

    SONiC community meeting minutes

      Aug 10 2021    - SONiC_SFP_refactoring HLD + SONiC_SFP_refactoring HLD MoM   Aug 03 2021    - Class Based Forwarding HLD + Class Based Forwarding HLD MoM @@ -331,7 +331,7 @@

    SONiC community meeting minutes

      Jul 20 2021    - DHCPv6 Relay agent + DHCPv6 Relay agent MoM @@ -351,12 +351,12 @@

    SONiC community meeting minutes

      Jun 22 2021    - 202106 release updates + 202106 release updates MoM   Jun 15 2021    - C-CMIS Support in SONiC + C-CMIS Support in SONiC MoM @@ -366,7 +366,7 @@

    SONiC community meeting minutes

      Jun 01 2021    - SAI Failure Handling + SAI Failure Handling MoM @@ -376,7 +376,7 @@

    SONiC community meeting minutes

      May 18 2021    - Debug dump utility HLD + Debug dump utility HLD MoM @@ -391,17 +391,17 @@

    SONiC community meeting minutes

      April 27 2021    - Generalizing config.bcm support for BRCM silicons + Generalizing config.bcm support for BRCM silicons MoM   April 20 2021    - Event & Alarm Framework HLD + Event & Alarm Framework HLD MoM   April 13 2021    - Policy Based Hashing HLD + Policy Based Hashing HLD MoM @@ -416,32 +416,32 @@

    SONiC community meeting minutes

      March 23 2021    - SONiC Generic Update and Rollback HLD + SONiC Generic Update and Rollback HLD MoM   March 16 2021    - Inband Mgmt via mgmt VRF + Inband Mgmt via mgmt VRF MoM   March 09 2021    - MPLS HLD initial revision + MPLS HLD initial revision MoM   March 02 2021    - Weighted ECMP HLD + Weighted ECMP HLD MoM   Febuary 23 2021    - SONiC Yang Model and related libraries + SONiC Yang Model and related libraries MoM   Febuary 16 2021    - cpu queue stats + cpu queue stats MoM @@ -451,7 +451,7 @@

    SONiC community meeting minutes

      Febuary 02 2021    - Next hop group split HLD + Next hop group split HLD MoM @@ -461,7 +461,7 @@

    SONiC community meeting minutes

      January 19 2021    - Port auto negotiation HLD + Port auto negotiation HLD MoM @@ -491,7 +491,7 @@

    SONiC community meeting minutes

      December 08 2020    - PMON enhancements for Chassis HLD + PMON enhancements for Chassis HLD MoM @@ -501,7 +501,7 @@

    SONiC community meeting minutes

      November 24 2020    - SONiC Application Extension HLD + SONiC Application Extension HLD MoM diff --git a/contact.html b/contact.html index b1024c516f..5516ebaa88 100644 --- a/contact.html +++ b/contact.html @@ -90,7 +90,7 @@

    Contact

    Send questions, bugs, comments and ideas to sonicproject@googlegroups.com

    Join the mailing list

    Join the Slack discussion group

    -

    Report issues here and provide the following:

    +

    Report issues here and provide the following:

    -show version output

    -SONiC support file generated by the sudo generate_dump command

    @@ -143,4 +143,4 @@

    Contact

    - \ No newline at end of file + diff --git a/doc/SONiC 201904 Release Notes.md b/doc/SONiC 201904 Release Notes.md index 307a53f77c..49516ebbe0 100644 --- a/doc/SONiC 201904 Release Notes.md +++ b/doc/SONiC 201904 Release Notes.md @@ -2,7 +2,7 @@ # SONiC 201904 Release Notes # Branch Location -https://github.com/Azure/sonic-buildimage/tree/201904 +https://github.com/sonic-net/sonic-buildimage/tree/201904 # Dependency Version @@ -27,11 +27,11 @@ https://github.com/Azure/sonic-buildimage/tree/201904 | 1 | [FRR as default routing stack](http://docs.frrouting.org/en/latest/) | | | 2 | Upgrade each docker to stretch version | SNMPD, LLDPD, Teamd | | 3 | Upgrade docker engine to 18.09 | | -| 4 | [Everflow enhancement](https://github.com/Azure/SONiC/blob/bb4f4a3a85935a38ec7f9625ef62cbe58c0998b4/doc/SONiC_EVERFLOW_IPv6.pdf) | | -| 5 | [Egress ACL bug fix and ACL CLI enhancement](https://github.com/Azure/SONiC/blob/dfa7e58292deb4d7b10d1e0ca73f296cd206e9d2/doc/acl/egress-acl-bug-fix-description.md) | | -| 6 | [L3 RIF counter support](https://github.com/Azure/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/Azure/SONiC/pull/310) | | -| 7 | [PMon Refactoring](https://github.com/Azure/SONiC/tree/master/doc/pmon) | | -| 8 | BGP-EVPN support (type 5) (related HLD [Fpmsyncd](https://github.com/Azure/SONiC/pull/375), [vxlanmgr](https://github.com/Azure/SONiC/pull/369), [template](https://github.com/Azure/sonic-buildimage/pull/2838/files) ) | | +| 4 | [Everflow enhancement](https://github.com/sonic-net/SONiC/blob/bb4f4a3a85935a38ec7f9625ef62cbe58c0998b4/doc/SONiC_EVERFLOW_IPv6.pdf) | | +| 5 | [Egress ACL bug fix and ACL CLI enhancement](https://github.com/sonic-net/SONiC/blob/dfa7e58292deb4d7b10d1e0ca73f296cd206e9d2/doc/acl/egress-acl-bug-fix-description.md) | | +| 6 | [L3 RIF counter support](https://github.com/sonic-net/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/sonic-net/SONiC/pull/310) | | +| 7 | [PMon Refactoring](https://github.com/sonic-net/SONiC/tree/master/doc/pmon) | | +| 8 | BGP-EVPN support (type 5) (related HLD [Fpmsyncd](https://github.com/sonic-net/SONiC/pull/375), [vxlanmgr](https://github.com/sonic-net/SONiC/pull/369), [template](https://github.com/sonic-net/sonic-buildimage/pull/2838/files) ) | | # Security Updates diff --git a/doc/SONiC-User-Manual.md b/doc/SONiC-User-Manual.md index 68b2ac6f71..63ea9b77d4 100644 --- a/doc/SONiC-User-Manual.md +++ b/doc/SONiC-User-Manual.md @@ -43,15 +43,15 @@ Table of Contents # Introduction SONiC is an open source network operating system based on Linux that runs on switches from multiple vendors and ASICs. SONiC offers a full-suite of network functionality, like BGP and RDMA, that has been production-hardened in the data centers of some of the largest cloud-service providers. It offers teams the flexibility to create the network solutions they need while leveraging the collective strength of a large ecosystem and community. -SONiC software shall be loaded in these [supported devices](https://github.com/Azure/SONiC/wiki/Supported-Devices-and-Platforms) and this User guide explains the basic steps for using the SONiC in those platforms. +SONiC software shall be loaded in these [supported devices](https://github.com/sonic-net/SONiC/wiki/Supported-Devices-and-Platforms) and this User guide explains the basic steps for using the SONiC in those platforms. -Connect the console port of the device and use the 9600 baud rate to access the device. Follow the [Quick Start Guide](https://github.com/Azure/SONiC/wiki/Quick-Start) to boot the device in ONIE mode and install the SONiC software using the steps specified in the document and reboot the device. In some devices that are pre-loaded with SONiC software, this step can be skipped. +Connect the console port of the device and use the 9600 baud rate to access the device. Follow the [Quick Start Guide](https://github.com/sonic-net/SONiC/wiki/Quick-Start) to boot the device in ONIE mode and install the SONiC software using the steps specified in the document and reboot the device. In some devices that are pre-loaded with SONiC software, this step can be skipped. Users shall use the default username/password "admin/YourPaSsWoRd" to login to the device through the console port. After logging into the device, SONiC software can be configured in following three methods. - 1) [Command Line Interface](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md) - 2) [config_db.json](https://github.com/Azure/SONiC/wiki/Configuration) - 3) [minigraph.xml](https://github.com/Azure/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) + 1) [Command Line Interface](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md) + 2) [config_db.json](https://github.com/sonic-net/SONiC/wiki/Configuration) + 3) [minigraph.xml](https://github.com/sonic-net/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) Users can use all of the above methods or choose either one method to configure and to view the status of the device. This user manual explains the common commands & related configuration/show examples on how to use the SONiC device. Refer the above documents for more detailed information. @@ -78,9 +78,9 @@ This guide details the steps to install a SONiC image on your supported switch. ## 1.1 Download Image -We have one SONiC Image per ASIC vendor. You can download SONiC Image [here](https://github.com/Azure/SONiC/wiki/Supported-Devices-and-Platforms) +We have one SONiC Image per ASIC vendor. You can download SONiC Image [here](https://github.com/sonic-net/SONiC/wiki/Supported-Devices-and-Platforms) -You can also build SONiC from source and the instructions can be found [here](https://github.com/Azure/sonic-buildimage). +You can also build SONiC from source and the instructions can be found [here](https://github.com/sonic-net/sonic-buildimage). Once the image is available in your local machine, the image can be installed either by installing using a USB thumb drive or over the network as given in following sub-sections. In case if the device is already preloaded with SONiC image, the device can be booted without the installation process. @@ -241,19 +241,19 @@ This TSG gives the instruction of how to reset a SONiC switch password. 1. Edit Grub boot menu options 1.1 First you need to get into grub menu options. This menu is displayed right at the beginning of the boot. You should get something similar to this, but not the exactly the same. Choose the choice Start with SONiC-: - ![image.png](https://github.com/Azure/SONiC/blob/master/images/PW-1.png) + ![image.png](https://github.com/sonic-net/SONiC/blob/master/images/PW-1.png) 1.2 Now we attempt to edit grub's boot option. Press "e" to edit the first grub menu option and navigate to kernel line: - ![image.png](https://github.com/Azure/SONiC/blob/master/images/PW-2.png) + ![image.png](https://github.com/sonic-net/SONiC/blob/master/images/PW-2.png) 1.3 Remove quiet and add init=/bin/bash - ![image.png](https://github.com/Azure/SONiC/blob/master/images/PW-3.png) + ![image.png](https://github.com/sonic-net/SONiC/blob/master/images/PW-3.png) 1.4 Press Ctrl-x to boot 2. Remount / and /proc 2.1 After successfully boot you will be presented with bash command prompt: - ![image.png](https://github.com/Azure/SONiC/blob/master/images/PW-4.png) + ![image.png](https://github.com/sonic-net/SONiC/blob/master/images/PW-4.png) ``` mount -o remount,rw / @@ -264,7 +264,7 @@ mount -o remount,rw /proc 3.1 To reset an actual password is now simple as typing : `passwd admin` - ![image.png](https://github.com/Azure/SONiC/blob/master/images/PW-5.png) + ![image.png](https://github.com/sonic-net/SONiC/blob/master/images/PW-5.png) ``` sync @@ -279,13 +279,13 @@ sudo reboot -f SONiC is managing configuration in a single source of truth - a redisDB instance that we refer as ConfigDB. Applications subscribe to ConfigDB and generate their running configuration correspondingly. -Details about ConfigDB and schema design, please find it [here](https://github.com/Azure/SONiC/wiki/Configuration) +Details about ConfigDB and schema design, please find it [here](https://github.com/sonic-net/SONiC/wiki/Configuration) -Before Sep 2017, we were using an XML file named minigraph.xml to configure SONiC devices. For historical documentation, please refer to [Configuration with Minigraph](https://github.com/Azure/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) +Before Sep 2017, we were using an XML file named minigraph.xml to configure SONiC devices. For historical documentation, please refer to [Configuration with Minigraph](https://github.com/sonic-net/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) SONiC includes commands that allow user to show platform, transceivers, L2, IP, BGP status, etc. -- [Command Reference](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md) +- [Command Reference](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md) Note that all the configuration commands need root privileges to execute them and the commands are case-sensitive. Show commands can be executed by all users without the root privileges. @@ -305,7 +305,7 @@ SONiC does not provide a CLI to configure the static IP for the management inter ``` Note that SONiC does not support management VRF and hence it is not possible to differentiate data traffic and management traffic. Work is in progress to support the mgmtVRF in Aug2019 release. - 2) use config_db.json and configure the MGMT_INTERFACE key with the appropriate values. Refer [here](https://github.com/Azure/SONiC/wiki/Configuration#Management-Interface) + 2) use config_db.json and configure the MGMT_INTERFACE key with the appropriate values. Refer [here](https://github.com/sonic-net/SONiC/wiki/Configuration#Management-Interface) Add the following example configuration in a file (ex: mgmt_ip.json) and load it as follows. @@ -331,7 +331,7 @@ Note that SONiC does not support management VRF and hence it is not possible to After removing the key, users can load the new configuration using "config load mgmt_ip.json" command and then do "systemctl restart interfaces-config" to make it effective. Users shall verify the configured management interface IP address value using "ifconfig" linux command. - 3) use minigraph.xml and configure "ManagementIPInterfaces" tag inside "DpgDesc" tag as given at the [page](https://github.com/Azure/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) + 3) use minigraph.xml and configure "ManagementIPInterfaces" tag inside "DpgDesc" tag as given at the [page](https://github.com/sonic-net/SONiC/wiki/Configuration-with-Minigraph-(~Sep-2017)) Once the IP address is configured, the same can be verified using "/sbin/ifconfig eth0" linux command. Users can SSH login to this management interface IP address from their management network. @@ -403,7 +403,7 @@ Go Back To [Beginning of the document](#SONiC-COMMAND-LINE-INTERFACE-GUIDE) or [ ## 3.2.2 Check features available in this version -[SONiC roadmap planning](https://github.com/Azure/SONiC/wiki/Sonic-Roadmap-Planning) explains the various features that are added in every software release. +[SONiC roadmap planning](https://github.com/sonic-net/SONiC/wiki/Sonic-Roadmap-Planning) explains the various features that are added in every software release. TBD: Is this enough? Need information from Xin. @@ -579,11 +579,11 @@ Basic cable connectivity shall be verified by configuring the IP address for the | # | Module | CLI Link | ConfigDB Link | Remarks | | --- | --- | --- | --- | --- | -| 1 | Interface |[Interface CLI](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md#Interface-Configuration-And-Show-Commands) | [Interface ConfigDB](Configuration.md)| To view the details about the interface | -| 2 | BGP |[BGP CLI](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md#BGP-Configuration-And-Show-Commands) | [BGP ConfigDB](Configuration.md)| To view the details about the BGP | -| 3 | ACL |[ACL CLI](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md#ACL-Configuration-And-Show) | [ACL ConfigDB](Configuration.md)| To view the details about the ACL | +| 1 | Interface |[Interface CLI](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md#Interface-Configuration-And-Show-Commands) | [Interface ConfigDB](Configuration.md)| To view the details about the interface | +| 2 | BGP |[BGP CLI](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md#BGP-Configuration-And-Show-Commands) | [BGP ConfigDB](Configuration.md)| To view the details about the BGP | +| 3 | ACL |[ACL CLI](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md#ACL-Configuration-And-Show) | [ACL ConfigDB](Configuration.md)| To view the details about the ACL | | 4 | COPP |COPP CLI Not Available | [COPP ConfigDB](Configuration.md)| To view the details about the COPP | -| 5 | Mirroring |[Mirroring CLI](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md#mirroring-configuration-and-show) | [Mirroring ConfigDB](Configuration.md)| To view the details about the Mirroring | +| 5 | Mirroring |[Mirroring CLI](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md#mirroring-configuration-and-show) | [Mirroring ConfigDB](Configuration.md)| To view the details about the Mirroring | diff --git a/doc/SONiC_201911_Release_Notes.md b/doc/SONiC_201911_Release_Notes.md index 86440444b1..7e9b075667 100644 --- a/doc/SONiC_201911_Release_Notes.md +++ b/doc/SONiC_201911_Release_Notes.md @@ -16,7 +16,7 @@ This document captures the new features added and enhancements done on existing # Branch and Image Location -Branch : https://github.com/Azure/sonic-buildimage/tree/201911
    +Branch : https://github.com/sonic-net/sonic-buildimage/tree/201911
    Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for Broadcom based platforms is [here]( https://sonic-jenkins.westus2.cloudapp.azure.com/job/broadcom/job/buildimage-brcm-201911/lastSuccessfulBuild/artifact/target/)) # Dependency Version @@ -33,7 +33,7 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for | syncd | 1.0.0 | | swss | 1.0.0 | | radvd | 2.17-2~bpo9+1 | -| isc-dhcp | 4.3.5-2 ([PR2946](https://github.com/Azure/sonic-buildimage/pull/2946) ) | +| isc-dhcp | 4.3.5-2 ([PR2946](https://github.com/sonic-net/sonic-buildimage/pull/2946) ) | | sonic-telemetry | 0.1 | | redis-server/ redis-tools | 5.0.3-3~bpo9+2 | @@ -49,94 +49,94 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### Build time improvements This document describes few options to improve SONiC build time. To split the work we will consider that SONiC has two stages: 1. debian/python packages compilation <- relatively fast 2. docker images build <- slower espessially when several users are building in parallel. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-build-system/build_system_improvements.md) and below mentioned PR's for more details. -
    **Pull Requests** : [911](https://github.com/Azure/sonic-swss/pull/911) ,[280](https://github.com/Azure/sonic-swss-common/pull/280) , [461](https://github.com/Azure/sonic-sairedis/pull/461) , [3048](https://github.com/Azure/sonic-buildimage/pull/3048) , [3049](https://github.com/Azure/sonic-buildimage/pull/3049) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/build_system_improvements.md) and below mentioned PR's for more details. +
    **Pull Requests** : [911](https://github.com/sonic-net/sonic-swss/pull/911) ,[280](https://github.com/sonic-net/sonic-swss-common/pull/280) , [461](https://github.com/sonic-net/sonic-sairedis/pull/461) , [3048](https://github.com/sonic-net/sonic-buildimage/pull/3048) , [3049](https://github.com/sonic-net/sonic-buildimage/pull/3049) #### Configurable drop counters This feature is to provides better packet drop visibility in SONiC by providing a mechanism to count and classify packet drops that occur due to different reasons.This is done by adding support for SAI debug counters to SONiC. Supported counters are PORT_INGRESS_DROPS , PORT_EGRESS_DROPS, SWITCH_INGRESS_DROP & SWITCH_EGRESS_DROPS. A CLI tool will be provided for users to manage and configure their own drop counters. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/drop_counters/drop_counters_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [308](https://github.com/Azure/sonic-swss-common/pull/308) , [520](https://github.com/Azure/sonic-sairedis/pull/520) , [1075](https://github.com/Azure/sonic-swss/pull/1075) , [1093](https://github.com/Azure/sonic-swss/pull/1093) , [688](https://github.com/Azure/sonic-utilities/pull/688) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/drop_counters/drop_counters_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [308](https://github.com/sonic-net/sonic-swss-common/pull/308) , [520](https://github.com/sonic-net/sonic-sairedis/pull/520) , [1075](https://github.com/sonic-net/sonic-swss/pull/1075) , [1093](https://github.com/sonic-net/sonic-swss/pull/1093) , [688](https://github.com/sonic-net/sonic-utilities/pull/688) #### Egress mirroring support and ACL action capability check Added support for egress mirror action. To query ACL action list supported by ASIC per stage and put this information in STATE DB SWITCH_CAPABILITY table and to perform secondary query for ACL action attributes which parameters are enum values (e.g. for PACKET_ACTION - DROP,FORWARD). -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/acl/acl_stage_capability.md) and below mentioned PR's for more details. -
    **Pull Requests** : [963](https://github.com/Azure/sonic-swss/pull/963) , [1019](https://github.com/Azure/sonic-swss/pull/1019) , [575](https://github.com/Azure/sonic-utilities/pull/575) , [481](https://github.com/Azure/sonic-sairedis/pull/481) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/acl/acl_stage_capability.md) and below mentioned PR's for more details. +
    **Pull Requests** : [963](https://github.com/sonic-net/sonic-swss/pull/963) , [1019](https://github.com/sonic-net/sonic-swss/pull/1019) , [575](https://github.com/sonic-net/sonic-utilities/pull/575) , [481](https://github.com/sonic-net/sonic-sairedis/pull/481) #### HW resource monitor This document describes the high level design of verification the hardware resources consumed by a device. The hardware resources which are currently verified are CPU, RAM and HDD. This implementation will be integrated in test cases written on Pytest framework. -
    Refer[HLD document](https://github.com/Azure/SONiC/blob/master/doc/DUT_monitor_HLD.md) and below mentioned PR for more details. -
    **Pull Request** : [1121](https://github.com/Azure/sonic-mgmt/pull/1121) +
    Refer[HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/DUT_monitor_HLD.md) and below mentioned PR for more details. +
    **Pull Request** : [1121](https://github.com/sonic-net/sonic-mgmt/pull/1121) #### L3 performance and scaling enhancements When sending a lot of ARP/ND requests in a burst, ARP entries are getting purged from the kernel while the later set of ARP entries was still getting added. The sequence of add/remove is in such a way that we were never able to cross ~2400 entries. Currently the max rate for ARP/ND is 600 packets, we will be increasing it to higher number(8000) in CoPP file to improve the learning time. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/89abd4938d792215b75d801e87b47ccf2c22f111/doc/L3_performance_and_scaling_enchancements_HLD.md) and below mentioned PR's for more details. -
    **Pull Request** : [1048](https://github.com/Azure/sonic-swss/pull/1048) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/89abd4938d792215b75d801e87b47ccf2c22f111/doc/L3_performance_and_scaling_enchancements_HLD.md) and below mentioned PR's for more details. +
    **Pull Request** : [1048](https://github.com/sonic-net/sonic-swss/pull/1048) #### Log analyzer to pytest In the root conftest there is implemented "loganalyzer" pytest fixture, which starts automatically for all test cases.If loganalyzer find specified messages which corresponds to defined regular expressions, it will display found messages and pytest will generate 'error'. Refer [Loganalyzer API usage example](https://github.com/yvolynets-mlnx/sonic-mgmt/blob/78a71ebccdc44bd62e81ff4b12dd84cb2c0ea34d/tests/loganalyzer/README.md) for more details. -
    **Pull Request** : [1048](https://github.com/Azure/sonic-mgmt/pull/1048) +
    **Pull Request** : [1048](https://github.com/sonic-net/sonic-mgmt/pull/1048) #### Management Framework -Management framework is a SONiC application which is responsible for providing various common North Bound Interfaces (NBIs) for the purposes of managing configuration and status on SONiC switches. The application manages coordination of NBI’s to provide a coherent way to validate, apply and show configuration. Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/mgmt/Management%20Framework.md) -
    **Pull Requests** : [18](https://github.com/Azure/sonic-mgmt-framework/pull/18) , [23](https://github.com/Azure/sonic-telemetry/pull/23) , [3488](https://github.com/Azure/sonic-buildimage/pull/3488) , [659](https://github.com/Azure/sonic-utilities/pull/659) +Management framework is a SONiC application which is responsible for providing various common North Bound Interfaces (NBIs) for the purposes of managing configuration and status on SONiC switches. The application manages coordination of NBI’s to provide a coherent way to validate, apply and show configuration. Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/Management%20Framework.md) +
    **Pull Requests** : [18](https://github.com/sonic-net/sonic-mgmt-framework/pull/18) , [23](https://github.com/sonic-net/sonic-telemetry/pull/23) , [3488](https://github.com/sonic-net/sonic-buildimage/pull/3488) , [659](https://github.com/sonic-net/sonic-utilities/pull/659) #### Management VRF Management VRF (mvrf) feature provides a separation between the management network traffic and the data plane network traffic using the linux CGROUPS based on l3mdev. Management interface (eth0) shall be enslaved in l3mdev. Management applications like SSH shall use the enslaved eth0 and corresponding mvrf routing table for management traffic.
    Refer below PR's for more details. -
    **Pull Requests** : [2585](https://github.com/Azure/sonic-buildimage/pull/2585) , [2608](https://github.com/Azure/sonic-buildimage/pull/2608) , [3204](https://github.com/Azure/sonic-buildimage/pull/3204) , [463](https://github.com/Azure/sonic-utilities/pull/463) , [472](https://github.com/Azure/sonic-utilities/pull/472) , [627](https://github.com/Azure/sonic-utilities/pull/627) , [3586](https://github.com/Azure/sonic-buildimage/pull/3586) +
    **Pull Requests** : [2585](https://github.com/sonic-net/sonic-buildimage/pull/2585) , [2608](https://github.com/sonic-net/sonic-buildimage/pull/2608) , [3204](https://github.com/sonic-net/sonic-buildimage/pull/3204) , [463](https://github.com/sonic-net/sonic-utilities/pull/463) , [472](https://github.com/sonic-net/sonic-utilities/pull/472) , [627](https://github.com/sonic-net/sonic-utilities/pull/627) , [3586](https://github.com/sonic-net/sonic-buildimage/pull/3586) #### Multi-DB optimization Creating multiple database instances help us to separate the databases based on their operation frequency or their role in the whole SONiC system, for example, like state database and loglevel database are not key features, we can avoid them affecting read and write APPL_DB or ASIC_DB via multiple database instances. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/ed69d427dcf358299b2c1b812e59a1e26a4ef4a5/doc/database/multi_database_instances.md) for more details. -
    **Pull Request** : [52](https://github.com/Azure/sonic-py-swsssdk/pull/52) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/ed69d427dcf358299b2c1b812e59a1e26a4ef4a5/doc/database/multi_database_instances.md) for more details. +
    **Pull Request** : [52](https://github.com/sonic-net/sonic-py-swsssdk/pull/52) #### NAT Network Address Translation (NAT) router enables private IP networks to communicate to the public networks (internet) by translating the private IP address to globally unique IP address. It also provides security by hiding the identity of the host in private network. This feature supports Source NAT, Destination NAT ,Static NAT/NAPT, Dynamic NAT/NAPT, NAT zones, Twice NAT/NAPT nd support of VRF.
    For more details refer [HLD Document](https://github.com/kirankella/SONiC/blob/nat_doc_changes/doc/nat/nat_design_spec.md). -
    **Pull Requests** : [3494](https://github.com/Azure/sonic-buildimage/pull/3494) , [1059](https://github.com/Azure/sonic-swss/pull/1059) , [645](https://github.com/Azure/sonic-utilities/pull/645) , [100 ](https://github.com/Azure/sonic-linux-kernel/pull/100) , [304](https://github.com/Azure/sonic-swss-common/pull/304) , [519](https://github.com/Azure/sonic-sairedis/pull/519) +
    **Pull Requests** : [3494](https://github.com/sonic-net/sonic-buildimage/pull/3494) , [1059](https://github.com/sonic-net/sonic-swss/pull/1059) , [645](https://github.com/sonic-net/sonic-utilities/pull/645) , [100 ](https://github.com/sonic-net/sonic-linux-kernel/pull/100) , [304](https://github.com/sonic-net/sonic-swss-common/pull/304) , [519](https://github.com/sonic-net/sonic-sairedis/pull/519) #### Platform test This test plan is to check the functionalities of platform related software components. These software components are for managing platform hardware, including FANs, thermal sensors, SFP, transceivers, pmon, etc.The software components for managing platform hardware on Mellanox platform is the hw-management package. -
    Refer [Platform testplan](https://github.com/Azure/SONiC/blob/master/doc/pmon/sonic_platform_test_plan.md) for more details. -
    **Pull Requests** : [915](https://github.com/Azure/sonic-mgmt/pull/915) , [980](https://github.com/Azure/sonic-mgmt/pull/980) , [1079](https://github.com/Azure/sonic-mgmt/pull/1079) +
    Refer [Platform testplan](https://github.com/sonic-net/SONiC/blob/master/doc/pmon/sonic_platform_test_plan.md) for more details. +
    **Pull Requests** : [915](https://github.com/sonic-net/sonic-mgmt/pull/915) , [980](https://github.com/sonic-net/sonic-mgmt/pull/980) , [1079](https://github.com/sonic-net/sonic-mgmt/pull/1079) #### Proxy ARP When an interface is enabled with "proxy_arp", the same is enabled in the kernel. ASIC ARP packet action is also updated to trap these packets to CPU in those interfaces. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/arp/Proxy%20Arp.md) for more details. -
    **Pull Requests** : [617](https://github.com/Azure/SONiC/pull/617) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/arp/Proxy%20Arp.md) for more details. +
    **Pull Requests** : [617](https://github.com/sonic-net/SONiC/pull/617) #### sFlow The CLI is enhanced to provide configuring and display of sFlow parameters including sflow collectors, agent IP, sampling rate for interfaces. The CLI configurations currently only interact with the CONFIG_DB. The newly introduced sflow container consists of an instantiation of the InMon's hsflowd daemon. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/sflow/sflow_hld.md) for more details. -
    **Pull Requests** : [94](https://github.com/Azure/sonic-linux-kernel/pull/94) , [299](https://github.com/Azure/sonic-swss-common/pull/299) , [498](https://github.com/Azure/sonic-sairedis/pull/498) , [1012](https://github.com/Azure/sonic-swss/pull/1012) , [1011](https://github.com/Azure/sonic-swss/pull/1011) , [3251](https://github.com/Azure/sonic-buildimage/pull/3251) , [592 ](https://github.com/Azure/sonic-utilities/pull/592) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/sflow/sflow_hld.md) for more details. +
    **Pull Requests** : [94](https://github.com/sonic-net/sonic-linux-kernel/pull/94) , [299](https://github.com/sonic-net/sonic-swss-common/pull/299) , [498](https://github.com/sonic-net/sonic-sairedis/pull/498) , [1012](https://github.com/sonic-net/sonic-swss/pull/1012) , [1011](https://github.com/sonic-net/sonic-swss/pull/1011) , [3251](https://github.com/sonic-net/sonic-buildimage/pull/3251) , [592 ](https://github.com/sonic-net/sonic-utilities/pull/592) #### SSD diagnostic tolling Add to SONiC an ability to check storage health state. Basic functionality will be implemented as a CLI command. Optionally pmon daemon could be added for constant disk state monitoring. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/ssdhealth_design.md) for more details. -
    **Pull Requests** : [587](https://github.com/Azure/sonic-utilities/pull/587) , [47](https://github.com/Azure/sonic-buildimage/pull/47) , [3218](https://github.com/Azure/sonic-buildimage/pull/3218) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/ssdhealth_design.md) for more details. +
    **Pull Requests** : [587](https://github.com/sonic-net/sonic-utilities/pull/587) , [47](https://github.com/sonic-net/sonic-buildimage/pull/47) , [3218](https://github.com/sonic-net/sonic-buildimage/pull/3218) #### Sub-port support A sub port interface is a logical interface that can be created on a physical port or a port channel.A sub port interface serves as an interface to either a .1D bridge or a VRF, but not both. This design focuses on the use case of creating a sub port interface on a physical port or a port channel and using it as a router interface to a VRF.
    Refer [HLD Document](https://github.com/wendani/SONiC/blob/a3e669e6778c272fc571a8bf3bd78e7eb75a8ec7/doc/sonic-sub-port-intf-hld.md) for more details. -
    **Pull Requests** : [998](https://github.com/opencomputeproject/SAI/pull/998) , [284](https://github.com/Azure/sonic-swss-common/pull/284) , [969](https://github.com/Azure/sonic-swss/pull/969) , [871](https://github.com/Azure/sonic-swss/pull/871) , [3412](https://github.com/Azure/sonic-buildimage/pull/3412) , [3422](https://github.com/Azure/sonic-buildimage/pull/3422) , [3413](https://github.com/Azure/sonic-buildimage/pull/3413) , [638](https://github.com/Azure/sonic-utilities/pull/638) , [642](https://github.com/Azure/sonic-utilities/pull/642) , [651](https://github.com/Azure/sonic-utilities/pull/651) | +
    **Pull Requests** : [998](https://github.com/opencomputeproject/SAI/pull/998) , [284](https://github.com/sonic-net/sonic-swss-common/pull/284) , [969](https://github.com/sonic-net/sonic-swss/pull/969) , [871](https://github.com/sonic-net/sonic-swss/pull/871) , [3412](https://github.com/sonic-net/sonic-buildimage/pull/3412) , [3422](https://github.com/sonic-net/sonic-buildimage/pull/3422) , [3413](https://github.com/sonic-net/sonic-buildimage/pull/3413) , [638](https://github.com/sonic-net/sonic-utilities/pull/638) , [642](https://github.com/sonic-net/sonic-utilities/pull/642) , [651](https://github.com/sonic-net/sonic-utilities/pull/651) | #### Thermal control Thermal control daemon has been added to monitor the temperature of devices (CPU, ASIC, optical modules, etc) and the running status of fan. It retrieves the switch device temperatures via platform APIs and raises alarms when the high/low thresholds are hit.It also stores temperature values fetched from sensors and thermal device running status to the DB. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/thermal-control-design.md) for more details. -
    **Pull Requests** : [73](https://github.com/Azure/sonic-platform-common/pull/73), [777](https://github.com/Azure/sonic-utilities/pull/777), [49](https://github.com/Azure/sonic-platform-daemons/pull/49), [3949](https://github.com/Azure/sonic-buildimage/pull/3949),[832](https://github.com/Azure/sonic-utilities/pull/832) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/thermal-control-design.md) for more details. +
    **Pull Requests** : [73](https://github.com/sonic-net/sonic-platform-common/pull/73), [777](https://github.com/sonic-net/sonic-utilities/pull/777), [49](https://github.com/sonic-net/sonic-platform-daemons/pull/49), [3949](https://github.com/sonic-net/sonic-buildimage/pull/3949),[832](https://github.com/sonic-net/sonic-utilities/pull/832) #### VRF Sonic supports multiple loopback interfaces. Each loopback interfaces can belong to different VRF instances. In this feature we also support BGP and VRF support for FRR config template. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/vrf/sonic-vrf-hld.md) for more details. -
    **Pull Requests** : [3952](https://github.com/Azure/sonic-buildimage/pull/3952) , [943](https://github.com/Azure/sonic-swss/pull/943) , [1065](https://github.com/Azure/sonic-mgmt/pull/1065) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/vrf/sonic-vrf-hld.md) for more details. +
    **Pull Requests** : [3952](https://github.com/sonic-net/sonic-buildimage/pull/3952) , [943](https://github.com/sonic-net/sonic-swss/pull/943) , [1065](https://github.com/sonic-net/sonic-mgmt/pull/1065) #### ZTP Zero Touch Provisioning (ZTP) service can be used by users to configure a fleet of switches using common configuration templates. Switches booting from factory default state should be able to communicate with remote provisioning server and download relevant configuration files and scripts to kick start more complex configuration steps. ZTP service takes user input in JSON format. Some of the supported features are - Dynamically generate DHCP client configuration based on current ZTP state and Added support to request and process hostname when using DHCPv6. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/ztp/ztp.md) for more details. -
    **Pull Requests** : [3227](https://github.com/Azure/sonic-buildimage/pull/3227) , [3298](https://github.com/Azure/sonic-buildimage/pull/3298) , [1000](https://github.com/Azure/sonic-swss/pull/1000) , [3299](https://github.com/Azure/sonic-buildimage/pull/3299) , [12](https://github.com/Azure/sonic-ztp/pull/12), [599](https://github.com/Azure/sonic-utilities/pull/599) ,[715](https://github.com/Azure/sonic-utilities/pull/715) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/ztp/ztp.md) for more details. +
    **Pull Requests** : [3227](https://github.com/sonic-net/sonic-buildimage/pull/3227) , [3298](https://github.com/sonic-net/sonic-buildimage/pull/3298) , [1000](https://github.com/sonic-net/sonic-swss/pull/1000) , [3299](https://github.com/sonic-net/sonic-buildimage/pull/3299) , [12](https://github.com/sonic-net/sonic-ztp/pull/12), [599](https://github.com/sonic-net/sonic-utilities/pull/599) ,[715](https://github.com/sonic-net/sonic-utilities/pull/715)
    diff --git a/doc/SONiC_202006_Release_Notes.md b/doc/SONiC_202006_Release_Notes.md index 6c22102412..e11fa3b06c 100644 --- a/doc/SONiC_202006_Release_Notes.md +++ b/doc/SONiC_202006_Release_Notes.md @@ -16,7 +16,7 @@ This document captures the new features added and enhancements done on existing # Branch and Image Location -Branch : https://github.com/Azure/sonic-buildimage/tree/202006
    +Branch : https://github.com/sonic-net/sonic-buildimage/tree/202006
    Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for Broadcom based platforms is [here]( https://sonic-jenkins.westus2.cloudapp.azure.com/job/broadcom/job/buildimage-brcm-202006/lastSuccessfulBuild/artifact/target/)) # Dependency Version @@ -33,7 +33,7 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for | syncd | 1.0.0 | | swss | 1.0.0 | | radvd | 2.17-2~bpo9+1 | -| isc-dhcp | 4.3.5-2 ([PR2946](https://github.com/Azure/sonic-buildimage/pull/2946) ) | +| isc-dhcp | 4.3.5-2 ([PR2946](https://github.com/sonic-net/sonic-buildimage/pull/2946) ) | | sonic-telemetry | 0.1 | | redis-server/ redis-tools | 5.0.3-3~bpo9+2 | @@ -49,72 +49,72 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### Build Improvements DPKG caching framework provides the infrastructure to cache the sonic module/target .deb files into a local cache by tracking the target dependency files.SONIC build infrastructure is designed as a plugin framework where any new source code can be easily integrated into sonic as a module and that generates output as a .deb file.This provides a huge improvement in build time and also supports the true incremental build by tracking the dependency files. -
    **Pull Requests** : [3292](https://github.com/Azure/sonic-buildimage/pull/3292), [4117](https://github.com/Azure/sonic-buildimage/pull/4117), [4425](https://github.com/Azure/sonic-buildimage/pull/4425) +
    **Pull Requests** : [3292](https://github.com/sonic-net/sonic-buildimage/pull/3292), [4117](https://github.com/sonic-net/sonic-buildimage/pull/4117), [4425](https://github.com/sonic-net/sonic-buildimage/pull/4425) #### Bulk API for route This feature provides bulk routes and next hop group members as coded in the PR mentioned below. -
    **Pull Requests** : [1238](https://github.com/Azure/sonic-swss/pull/1238) +
    **Pull Requests** : [1238](https://github.com/sonic-net/sonic-swss/pull/1238) #### D-Bus to Host Communications This document describes a means (framework) for an application executed inside a container to securely request the execution of an operation ("action") by the host OS.This framework is intended to be used by the SONiC management and telemetry containers, but can be extended for other application containers as well. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/mgmt/Docker%20to%20Host%20communication.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4840](https://github.com/Azure/sonic-buildimage/pull/4840) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/Docker%20to%20Host%20communication.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4840](https://github.com/sonic-net/sonic-buildimage/pull/4840) #### Debian 10 upgrade, base image,driver This feature provides change in kernel version. By changing the kernel ABI from version 6 to version 6-2, this will allow to disable the kernel ABI check which Debian performs at the very end of the kernel build. -
    **Pull Requests** : [145](https://github.com/Azure/sonic-linux-kernel/pull/145), [4711](https://github.com/Azure/sonic-buildimage/pull/4711) +
    **Pull Requests** : [145](https://github.com/sonic-net/sonic-linux-kernel/pull/145), [4711](https://github.com/sonic-net/sonic-buildimage/pull/4711) #### Dynamic port breakout Ports can be broken out to different speeds with various lanes in most HW today. However, on SONiC, before this release, the port breakout modes are hard-coded in the profiles and only loaded at initial time. In case we need to have a new port breakout mode, we would potentially need a new image or at least need to restart services which would impact the traffic of the box on irrelevant ports. The feature is to address the above issues. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4235](https://github.com/Azure/sonic-buildimage/pull/4235), [3910](https://github.com/Azure/sonic-buildimage/pull/3910), [1242](https://github.com/Azure/sonic-swss/pull/1242), [1219](https://github.com/Azure/sonic-swss/pull/1219), [1151](https://github.com/Azure/sonic-swss/pull/1151), [1150](https://github.com/Azure/sonic-swss/pull/1150), [1148](https://github.com/Azure/sonic-swss/pull/1148), [1112](https://github.com/Azure/sonic-swss/pull/1112), [1085](https://github.com/Azure/sonic-swss/pull/1085), [766](https://github.com/Azure/sonic-utilities/pull/766), [72](https://github.com/Azure/sonic-platform-common/pull/72), [859](https://github.com/Azure/sonic-utilities/pull/859), [767](https://github.com/Azure/sonic-utilities/pull/767), [765](https://github.com/Azure/sonic-utilities/pull/765), [3912](https://github.com/Azure/sonic-buildimage/pull/3912), [3911](https://github.com/Azure/sonic-buildimage/pull/3911), [3909](https://github.com/Azure/sonic-buildimage/pull/3909), [3907](https://github.com/Azure/sonic-buildimage/pull/3907), [3891](https://github.com/Azure/sonic-buildimage/pull/3891), [3874](https://github.com/Azure/sonic-buildimage/pull/3874), [3861](https://github.com/Azure/sonic-buildimage/pull/3861), [3730](https://github.com/Azure/sonic-buildimage/pull/3730) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4235](https://github.com/sonic-net/sonic-buildimage/pull/4235), [3910](https://github.com/sonic-net/sonic-buildimage/pull/3910), [1242](https://github.com/sonic-net/sonic-swss/pull/1242), [1219](https://github.com/sonic-net/sonic-swss/pull/1219), [1151](https://github.com/sonic-net/sonic-swss/pull/1151), [1150](https://github.com/sonic-net/sonic-swss/pull/1150), [1148](https://github.com/sonic-net/sonic-swss/pull/1148), [1112](https://github.com/sonic-net/sonic-swss/pull/1112), [1085](https://github.com/sonic-net/sonic-swss/pull/1085), [766](https://github.com/sonic-net/sonic-utilities/pull/766), [72](https://github.com/sonic-net/sonic-platform-common/pull/72), [859](https://github.com/sonic-net/sonic-utilities/pull/859), [767](https://github.com/sonic-net/sonic-utilities/pull/767), [765](https://github.com/sonic-net/sonic-utilities/pull/765), [3912](https://github.com/sonic-net/sonic-buildimage/pull/3912), [3911](https://github.com/sonic-net/sonic-buildimage/pull/3911), [3909](https://github.com/sonic-net/sonic-buildimage/pull/3909), [3907](https://github.com/sonic-net/sonic-buildimage/pull/3907), [3891](https://github.com/sonic-net/sonic-buildimage/pull/3891), [3874](https://github.com/sonic-net/sonic-buildimage/pull/3874), [3861](https://github.com/sonic-net/sonic-buildimage/pull/3861), [3730](https://github.com/sonic-net/sonic-buildimage/pull/3730) #### Egress shaping (port, queue) Quality of Service (QoS) scheduling and shaping features enable better service to certain traffic flows.Queue scheduling provides preferential treatment of traffic classes mapped to specific egress queues. SONiC supports SP, WRR, and DWRR scheduling disciplines.Queue shaping provides control of minimum and maximum bandwidth requirements per egress queue for more effective bandwidth utilization. Egress queues that exceed an average transmission rate beyond the shaper max bandwidth will stop being serviced. Additional ingress traffic will continue to be stored on the egress queue until the queue size is exceeded which results in tail drop. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/41e55d2762e9267454a4910b42a1eb7ad07acda8/doc/qos/scheduler/SONiC_QoS_Scheduler_Shaper.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1296](https://github.com/Azure/sonic-swss/pull/1296), [991](https://github.com/Azure/sonic-swss/pull/991) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/41e55d2762e9267454a4910b42a1eb7ad07acda8/doc/qos/scheduler/SONiC_QoS_Scheduler_Shaper.md) and below mentioned PR's for more details. +
    **Pull Requests** : [1296](https://github.com/sonic-net/sonic-swss/pull/1296), [991](https://github.com/sonic-net/sonic-swss/pull/991) #### FW utils extension A modern network switch is a sophisticated equipment which consists of many auxiliary components which are responsible for managing different subsystems (e.g., PSU/FAN/QSFP/EEPROM/THERMAL) and providing necessary interfaces (e.g., I2C/SPI/JTAG).Basically these components are complex programmable logic devices with it's own HW architecture and software. It is very important to always have the latest recommended software version to improve device stability, security and performance. In order to make software update as simple as possible and to provide a nice user frindly interface for various maintenance operations (e.g., install a new FW or query current version) we might need a dedicated FW utility. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/fwutil/fwutil.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4764](https://github.com/Azure/sonic-buildimage/pull/4764), [4758](https://github.com/Azure/sonic-buildimage/pull/4758), [941](https://github.com/Azure/sonic-utilities/pull/941), [942](https://github.com/Azure/sonic-utilities/pull/942), [87](https://github.com/Azure/sonic-platform-common/pull/87), [82](https://github.com/Azure/sonic-platform-common/pull/82) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/fwutil/fwutil.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4764](https://github.com/sonic-net/sonic-buildimage/pull/4764), [4758](https://github.com/sonic-net/sonic-buildimage/pull/4758), [941](https://github.com/sonic-net/sonic-utilities/pull/941), [942](https://github.com/sonic-net/sonic-utilities/pull/942), [87](https://github.com/sonic-net/sonic-platform-common/pull/87), [82](https://github.com/sonic-net/sonic-platform-common/pull/82) #### Getting docker ready for Debian 10 This change adds support to build dockers using buster as base.sonic-mgmt-framework docker is updated to build using buster as base. -
    **Pull Requests** : [4671](https://github.com/Azure/sonic-buildimage/pull/4671), [4727](https://github.com/Azure/sonic-buildimage/pull/4727), [4726](https://github.com/Azure/sonic-buildimage/pull/4726), [4665](https://github.com/Azure/sonic-buildimage/pull/4665), [4515](https://github.com/Azure/sonic-buildimage/pull/4515), [4598](https://github.com/Azure/sonic-buildimage/pull/4598), [4529](https://github.com/Azure/sonic-buildimage/pull/4529), [4480](https://github.com/Azure/sonic-buildimage/pull/4480) +
    **Pull Requests** : [4671](https://github.com/sonic-net/sonic-buildimage/pull/4671), [4727](https://github.com/sonic-net/sonic-buildimage/pull/4727), [4726](https://github.com/sonic-net/sonic-buildimage/pull/4726), [4665](https://github.com/sonic-net/sonic-buildimage/pull/4665), [4515](https://github.com/sonic-net/sonic-buildimage/pull/4515), [4598](https://github.com/sonic-net/sonic-buildimage/pull/4598), [4529](https://github.com/sonic-net/sonic-buildimage/pull/4529), [4480](https://github.com/sonic-net/sonic-buildimage/pull/4480) #### Port Mirroring This feature describes the high level design details on Port/Port-channel mirroring support, dynamic session management, ACL rules can continue to use port/ERSPAN sessions as the action, Configuration CLI for mirror session. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/e8c86d1b3a03d6320727ff148966081869461e4a/doc/SONiC_Port_Mirroring_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1314](https://github.com/Azure/sonic-swss/pull/1314), [936](https://github.com/Azure/sonic-utilities/pull/936) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/e8c86d1b3a03d6320727ff148966081869461e4a/doc/SONiC_Port_Mirroring_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [1314](https://github.com/sonic-net/sonic-swss/pull/1314), [936](https://github.com/sonic-net/sonic-utilities/pull/936) #### Proxy ARP When an interface is enabled with "proxy_arp", the same is enabled in the kernel. ASIC ARP packet action is also updated to trap these packets to CPU in those interfaces. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/doc/arp/Proxy%20Arp.md) for more details. -
    **Pull Requests** : [617](https://github.com/Azure/SONiC/pull/617) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/arp/Proxy%20Arp.md) for more details. +
    **Pull Requests** : [617](https://github.com/sonic-net/SONiC/pull/617) #### Pytest 100% moved from ansible to Pytest #### SPytest This is an initial version of spytest framework and first set of test scripts for 202006 release. -
    Refer [HLD Document](https://github.com/Azure/sonic-mgmt/blob/master/spytest/Doc/intro.md) for more details. -
    **Pull Requests** : [1533](https://github.com/Azure/sonic-mgmt/pull/1533) +
    Refer [HLD Document](https://github.com/sonic-net/sonic-mgmt/blob/master/spytest/Doc/intro.md) for more details. +
    **Pull Requests** : [1533](https://github.com/sonic-net/sonic-mgmt/pull/1533) #### Thermal control Thermal control daemon has been added to monitor the temperature of devices (CPU, ASIC, optical modules, etc) and the running status of fan. It retrieves the switch device temperatures via platform APIs and raises alarms when the high/low thresholds are hit.It also stores temperature values fetched from sensors and thermal device running status to the DB.In addition it provides the policy based thermal control and fan speed tuning in configuration, and we are able to customize and/or add the platform specific policies as needed. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/thermal-control-design.md) for more details. -
    **Pull Requests** : [73](https://github.com/Azure/sonic-platform-common/pull/73), [777](https://github.com/Azure/sonic-utilities/pull/777), [49](https://github.com/Azure/sonic-platform-daemons/pull/49), [3949](https://github.com/Azure/sonic-buildimage/pull/3949),[832](https://github.com/Azure/sonic-utilities/pull/832) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/thermal-control-design.md) for more details. +
    **Pull Requests** : [73](https://github.com/sonic-net/sonic-platform-common/pull/73), [777](https://github.com/sonic-net/sonic-utilities/pull/777), [49](https://github.com/sonic-net/sonic-platform-daemons/pull/49), [3949](https://github.com/sonic-net/sonic-buildimage/pull/3949),[832](https://github.com/sonic-net/sonic-utilities/pull/832) #### PSU and FAN LED management The PSU and FAN LED on switch will be set according to PSU and FAN presence and running status, for example if there is a failure happening to PSU or FAN, the corresponding LED will be set to red. -
    Refer [HLD Document](https://github.com/Azure/SONiC/blob/master/thermal-control-design.md) and [HLD Document](https://github.com/Azure/SONiC/pull/591) for more details. -
    **Pull Requests** : [4437](https://github.com/Azure/sonic-buildimage/pull/4437);[1580](https://github.com/Azure/sonic-mgmt/pull/1580);[881](https://github.com/Azure/sonic-utilities/pull/881);[54](https://github.com/Azure/sonic-platform-daemons/pull/54);[83](https://github.com/Azure/sonic-platform-common/pull/83) +
    Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/thermal-control-design.md) and [HLD Document](https://github.com/sonic-net/SONiC/pull/591) for more details. +
    **Pull Requests** : [4437](https://github.com/sonic-net/sonic-buildimage/pull/4437);[1580](https://github.com/sonic-net/sonic-mgmt/pull/1580);[881](https://github.com/sonic-net/sonic-utilities/pull/881);[54](https://github.com/sonic-net/sonic-platform-daemons/pull/54);[83](https://github.com/sonic-net/sonic-platform-common/pull/83) #### PSU, thermal and FAN plugin extension On new plugins for fan, thermal and PSU the PSU plugin was extended with voltage, current and power supported, and the fan and thermal plugins were introduced. -
    **Pull Requests** : [4041](https://github.com/Azure/sonic-buildimage/pull/4041) +
    **Pull Requests** : [4041](https://github.com/sonic-net/sonic-buildimage/pull/4041) diff --git a/doc/SONiC_202012_Release_Notes.md b/doc/SONiC_202012_Release_Notes.md index 9eb3aa306e..92ceae2ec7 100644 --- a/doc/SONiC_202012_Release_Notes.md +++ b/doc/SONiC_202012_Release_Notes.md @@ -16,7 +16,7 @@ This document captures the new features added and enhancements done on existing # Branch and Image Location -Branch : https://github.com/Azure/sonic-buildimage/tree/202012
    +Branch : https://github.com/sonic-net/sonic-buildimage/tree/202012
    Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for Broadcom based platforms is [here]( https://sonic-jenkins.westus2.cloudapp.azure.com/job/broadcom/job/buildimage-brcm-202012/lastSuccessfulBuild/artifact/target/)) # Dependency Version @@ -50,56 +50,56 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### Consistent ECMP support (fine grain ECMP) This feature is to modify the behavior of ECMP to achieve fine grained handling of ECMP for a specifically identified prefix and associated next-hops in configuration.
    Refer [HLD document](https://github.com/anish-n/SONiC/blob/e5cdb3d9337026a98d6be5d558126926a4e959e4/doc/ecmp/fine_grained_next_hop_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1315](https://github.com/Azure/sonic-swss/pull/1315), [623](https://github.com/Azure/SONiC/pull/623), [1788](https://github.com/Azure/sonic-mgmt/pull/1788), [4985](https://github.com/Azure/sonic-buildimage/pull/4985), [374](https://github.com/Azure/sonic-swss-common/pull/374), [659](https://github.com/Azure/SONiC/pull/659), [1056](https://github.com/Azure/sonic-utilities/pull/1056), [5518](https://github.com/Azure/sonic-buildimage/pull/5518), [5198](https://github.com/Azure/sonic-buildimage/pull/5198), [693](https://github.com/Azure/SONiC/pull/693). +
    **Pull Requests** : [1315](https://github.com/sonic-net/sonic-swss/pull/1315), [623](https://github.com/sonic-net/SONiC/pull/623), [1788](https://github.com/sonic-net/sonic-mgmt/pull/1788), [4985](https://github.com/sonic-net/sonic-buildimage/pull/4985), [374](https://github.com/sonic-net/sonic-swss-common/pull/374), [659](https://github.com/sonic-net/SONiC/pull/659), [1056](https://github.com/sonic-net/sonic-utilities/pull/1056), [5518](https://github.com/sonic-net/sonic-buildimage/pull/5518), [5198](https://github.com/sonic-net/sonic-buildimage/pull/5198), [693](https://github.com/sonic-net/SONiC/pull/693). #### Container warm restart (BGP/TeamD/SWSS/SyncD) The goal of SONiC warm reboot is to be able restart and upgrade SONiC software without impacting the data plane. Warm restart of each individual process/docker is also part of the goal. Except for syncd and database docker, it is desired for all other network applications and dockers to support un-planned warm restart. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/0c177995044316b898fc355456d9b6e8df72b522/doc/warm-reboot/SONiC_Warmboot.md) and below mentioned PR's for more details. -
    **Pull Requests** : [3992](https://github.com/Azure/sonic-buildimage/pull/3992), [5233](https://github.com/Azure/sonic-buildimage/pull/5233),[5163](https://github.com/Azure/sonic-buildimage/pull/5163/files), [5108](https://github.com/Azure/sonic-buildimage/pull/5108/files) & [1036](https://github.com/Azure/sonic-utilities/pull/1036/files). +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/0c177995044316b898fc355456d9b6e8df72b522/doc/warm-reboot/SONiC_Warmboot.md) and below mentioned PR's for more details. +
    **Pull Requests** : [3992](https://github.com/sonic-net/sonic-buildimage/pull/3992), [5233](https://github.com/sonic-net/sonic-buildimage/pull/5233),[5163](https://github.com/sonic-net/sonic-buildimage/pull/5163/files), [5108](https://github.com/sonic-net/sonic-buildimage/pull/5108/files) & [1036](https://github.com/sonic-net/sonic-utilities/pull/1036/files). #### CoPP Config/Management During SWSS start, the prebuilt copp.json file is loaded as part of start script swssconfig.sh and written to APP_DB. CoppOrch then translates it to Host trap/policer tables and programmed to SAI. With this enhancement, the CoPP tables shall be loaded to Config_DB instead of APP_DB. The default CoPP json file shall be prebuilt to the image and loaded during initialization. Any Config_DB entries present shall be configured overwriting the default CoPP tables. This also ensures backward compatibility. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/fdc7cff16b7f42f1a1b01dd506279e3e9f9269cb/doc/copp/CoPP%20Config%20and%20Management.md) and below mentioned PR's for more details. -
    **Pull Requests** : [358](https://github.com/Azure/sonic-swss-common/pull/358), [1333](https://github.com/Azure/sonic-swss/pull/1333), [4861](https://github.com/Azure/sonic-buildimage/pull/4861) & [1004](https://github.com/Azure/sonic-utilities/pull/1004) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/fdc7cff16b7f42f1a1b01dd506279e3e9f9269cb/doc/copp/CoPP%20Config%20and%20Management.md) and below mentioned PR's for more details. +
    **Pull Requests** : [358](https://github.com/sonic-net/sonic-swss-common/pull/358), [1333](https://github.com/sonic-net/sonic-swss/pull/1333), [4861](https://github.com/sonic-net/sonic-buildimage/pull/4861) & [1004](https://github.com/sonic-net/sonic-utilities/pull/1004) #### Console Support for SONiC (Hardware) This is a feature to support SONiC for hardware console. -
    **Pull Requests** :[5571](https://github.com/Azure/sonic-buildimage/pull/5571) & [1155](https://github.com/Azure/sonic-utilities/pull/1155) +
    **Pull Requests** :[5571](https://github.com/sonic-net/sonic-buildimage/pull/5571) & [1155](https://github.com/sonic-net/sonic-utilities/pull/1155) #### Console Support for SONiC (SSH forwarding) This feature describes the persistent console configurations to control how to view/connect to a device via serial link. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/126a4f7af8cadd8451b22bd80227c07c11452a63/doc/console/SONiC-Console-Switch-High-Level-Design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [664](https://github.com/Azure/SONiC/pull/664), [673](https://github.com/Azure/SONiC/pull/673) ,[1117](https://github.com/Azure/sonic-utilities/pull/1117) , [1120](https://github.com/Azure/sonic-utilities/pull/1120), [1130](https://github.com/Azure/sonic-utilities/pull/1130) ,[1136](https://github.com/Azure/sonic-utilities/pull/1136) , [1166](https://github.com/Azure/sonic-utilities/pull/1166) , [1173](https://github.com/Azure/sonic-utilities/pull/1173), [1176](https://github.com/Azure/sonic-utilities/pull/1176) , [5438](https://github.com/Azure/sonic-buildimage/pull/5438) & [5717](https://github.com/Azure/sonic-buildimage/pull/5717). +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/126a4f7af8cadd8451b22bd80227c07c11452a63/doc/console/SONiC-Console-Switch-High-Level-Design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [664](https://github.com/sonic-net/SONiC/pull/664), [673](https://github.com/sonic-net/SONiC/pull/673) ,[1117](https://github.com/sonic-net/sonic-utilities/pull/1117) , [1120](https://github.com/sonic-net/sonic-utilities/pull/1120), [1130](https://github.com/sonic-net/sonic-utilities/pull/1130) ,[1136](https://github.com/sonic-net/sonic-utilities/pull/1136) , [1166](https://github.com/sonic-net/sonic-utilities/pull/1166) , [1173](https://github.com/sonic-net/sonic-utilities/pull/1173), [1176](https://github.com/sonic-net/sonic-utilities/pull/1176) , [5438](https://github.com/sonic-net/sonic-buildimage/pull/5438) & [5717](https://github.com/sonic-net/sonic-buildimage/pull/5717). #### Dynamic headroom calculation This feature defines the solution on how the headroom is calculated by the well known formula based upon with the cable length and speed as input. Arbitrary cable length will be supported. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/415f19931bccd900ac528b100aafffa6000e82e9/doc/qos/dynamically-headroom-calculation.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1338](https://github.com/Azure/sonic-swss/pull/1338), [973](https://github.com/Azure/sonic-utilities/pull/973), [4881](https://github.com/Azure/sonic-buildimage/pull/4881), [1971](https://github.com/Azure/sonic-mgmt/pull/1971), [361](https://github.com/Azure/sonic-swss-common/pull/361) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/415f19931bccd900ac528b100aafffa6000e82e9/doc/qos/dynamically-headroom-calculation.md) and below mentioned PR's for more details. +
    **Pull Requests** : [1338](https://github.com/sonic-net/sonic-swss/pull/1338), [973](https://github.com/sonic-net/sonic-utilities/pull/973), [4881](https://github.com/sonic-net/sonic-buildimage/pull/4881), [1971](https://github.com/sonic-net/sonic-mgmt/pull/1971), [361](https://github.com/sonic-net/sonic-swss-common/pull/361) #### Enable synchronous SAI APIs (error handling) This feature enables the synchronous mode for a closed-loop execution, if SAI APIs are called from the orchagent. In contrast to the previous asynchronous mode which cannot properly handle SAI API failures, the synchronous mode can gracefully handle SAI API failures by conducting the proper actions in orchagent. Therefore, the synchronous mode can substantially improve the reliability of SONiC.
    Refer [HLD document](https://github.com/shi-su/SONiC/blob/61762c8e709ead5f8ee7df83facea6ceee9de6f5/doc/synchronous-mode/synchronous-mode-cfg.md) and below mentioned PR's for more details. -
    **Pull Requests** : [5237](https://github.com/Azure/sonic-buildimage/pull/5237) , [650](https://github.com/Azure/sonic-buildimage/pull/650) , [652](https://github.com/Azure/sonic-buildimage/pull/652) , [653](https://github.com/Azure/sonic-buildimage/pull/653), [1094](https://github.com/Azure/sonic-utilities/pull/1094) & [5308](https://github.com/Azure/sonic-buildimage/pull/5308). +
    **Pull Requests** : [5237](https://github.com/sonic-net/sonic-buildimage/pull/5237) , [650](https://github.com/sonic-net/sonic-buildimage/pull/650) , [652](https://github.com/sonic-net/sonic-buildimage/pull/652) , [653](https://github.com/sonic-net/sonic-buildimage/pull/653), [1094](https://github.com/sonic-net/sonic-utilities/pull/1094) & [5308](https://github.com/sonic-net/sonic-buildimage/pull/5308). #### EVPN/VXLAN This feature provides information about the EVPN VXLAN feature implementation based on RFC 7432 BGP EVPN solution over VXLAN tunnels for SONiC, including support for L2 and L3 VPN services, auto discovery of remote VTEPs, auto provisioning of tunnels and VLANs over VXLAN tunnels, control plane MAC learning and ARP suppression for reduced flooding, and support for VM mobility. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/7fbda34ee3315960c164a0c202f39c2ec515cfc3/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [339](https://github.com/Azure/sonic-swss-common/pull/339) ,[350](https://github.com/Azure/sonic-swss-common/pull/350) , [1264](https://github.com/Azure/sonic-swss/pull/1264) , [1266](https://github.com/Azure/sonic-swss/pull/1266) , [1318](https://github.com/Azure/sonic-swss/pull/1318) , [1267](https://github.com/Azure/sonic-swss/pull/1267) & [870](https://github.com/Azure/sonic-utilities/pull/870). +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/7fbda34ee3315960c164a0c202f39c2ec515cfc3/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [339](https://github.com/sonic-net/sonic-swss-common/pull/339) ,[350](https://github.com/sonic-net/sonic-swss-common/pull/350) , [1264](https://github.com/sonic-net/sonic-swss/pull/1264) , [1266](https://github.com/sonic-net/sonic-swss/pull/1266) , [1318](https://github.com/sonic-net/sonic-swss/pull/1318) , [1267](https://github.com/sonic-net/sonic-swss/pull/1267) & [870](https://github.com/sonic-net/sonic-utilities/pull/870). #### SONiC entity MIB extensions The Entity MIB contains several groups of MIB objects: entityPhysical group, entityLogical group and so on. Previously, SONiC only implemented part of the entityPhysical group following RFC2737. Since entityPhysical group is most commonly used, this extension will focus on entityPhysical group and leave other groups for future implementation. The group entityPhysical contains a single table called "entPhysicalTable" to identify the physical components of the system. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/0e53548a8f1023d1be2a1dffd62737c7a1b18a2e/doc/snmp/extension-to-physical-entity-mib.md) and below mentioned PR's for more details. -
    **Pull Requests** : [134](https://github.com/Azure/sonic-platform-common/pull/134), [102](https://github.com/Azure/sonic-platform-daemons/pull/102), [5645](https://github.com/Azure/sonic-buildimage/pull/5645), [168](https://github.com/Azure/sonic-snmpagent/pull/168) & [2379](https://github.com/Azure/sonic-mgmt/pull/2379) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/0e53548a8f1023d1be2a1dffd62737c7a1b18a2e/doc/snmp/extension-to-physical-entity-mib.md) and below mentioned PR's for more details. +
    **Pull Requests** : [134](https://github.com/sonic-net/sonic-platform-common/pull/134), [102](https://github.com/sonic-net/sonic-platform-daemons/pull/102), [5645](https://github.com/sonic-net/sonic-buildimage/pull/5645), [168](https://github.com/sonic-net/sonic-snmpagent/pull/168) & [2379](https://github.com/sonic-net/sonic-mgmt/pull/2379) #### FRR BGP NBI This feature extends and provides unified configuration and management capability for FRR-BGP features used in SONiC.This enhancement is to load any BGP/route-map configurations from config-DB as well independent of mgmt-framework NBI, the main change here is to add CONFIB_DB entries for FRR management into SONiC, and the ability to apply this config to FRR. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/48e9012c548528b6528745bda9d75b4164e785eb/doc/mgmt/SONiC_Design_Doc_Unified_FRR_Mgmt_Interface.md) and below mentioned PR's for more details. -
    **Pull Requests** : [5142](https://github.com/Azure/sonic-buildimage/pull/5142) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/48e9012c548528b6528745bda9d75b4164e785eb/doc/mgmt/SONiC_Design_Doc_Unified_FRR_Mgmt_Interface.md) and below mentioned PR's for more details. +
    **Pull Requests** : [5142](https://github.com/sonic-net/sonic-buildimage/pull/5142) #### Gearbox This feature is a design change that allows the PHY drivers to be separated from the Switch driver (SAI) by introducing a new driver API for PHYs. This allows diverse, multi-vendor hardware to be more easily supported. This change adds usage capability of this new interface to SONiC. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/gearbox/gearbox_mgr_design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [347](https://github.com/Azure/sonic-swss-common/pull/347), [931](https://github.com/Azure/sonic-utilities/pull/931), [1321](https://github.com/Azure/sonic-swss/pull/1321), [624](https://github.com/Azure/sonic-sairedis/pull/624) & [4851](https://github.com/Azure/sonic-buildimage/pull/4851). +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/gearbox/gearbox_mgr_design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [347](https://github.com/sonic-net/sonic-swss-common/pull/347), [931](https://github.com/sonic-net/sonic-utilities/pull/931), [1321](https://github.com/sonic-net/sonic-swss/pull/1321), [624](https://github.com/sonic-net/sonic-sairedis/pull/624) & [4851](https://github.com/sonic-net/sonic-buildimage/pull/4851). #### Kubernetes (docker to be controlled by Kubernetes) This feature deals in depth with kubernetes-support. With this feature, an image could be downloaded from external repositaries and kubernetes does the deployment. The external Kubernetes masters could be used to deploy container image updates at a massive scale, through manifests. This new mode is referred as "kubernetes mode". @@ -113,13 +113,13 @@ What we implement in this release: - The cli commands config & show are provided to manage the support If you have an infrastructure that runs kubernetes master cluster, then you could -- You could have your build pipeline push docker images to your registry or ACR (Azure Container Registry) +- You could have your build pipeline push docker images to your registry or ACR (sonic-net Container Registry) - For intended updates, publish manifests - With node selector labels (optionally) - With image pull secrets provided - You may create secret to access your repo and make it default across all
    Refer [HLD document](https://github.com/renukamanavalan/SONiC/blob/kube_systemd/doc/kubernetes/Kubernetes-support.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4825](https://github.com/Azure/sonic-buildimage/pull/4825), [4895](https://github.com/Azure/sonic-buildimage/pull/4895), [4926](https://github.com/Azure/sonic-buildimage/pull/4926), [4932](https://github.com/Azure/sonic-buildimage/pull/4932), [4959](https://github.com/Azure/sonic-buildimage/pull/4959), [4973](https://github.com/Azure/sonic-buildimage/pull/4973), [5022](https://github.com/Azure/sonic-buildimage/pull/5022), [5113](https://github.com/Azure/sonic-buildimage/pull/5113), [5121](https://github.com/Azure/sonic-buildimage/pull/5121), [5122](https://github.com/Azure/sonic-buildimage/pull/5122), [5202](https://github.com/Azure/sonic-buildimage/pull/5202), [5221](https://github.com/Azure/sonic-buildimage/pull/5221), [5224](https://github.com/Azure/sonic-buildimage/pull/5224), [5235](https://github.com/Azure/sonic-buildimage/pull/5235), [5316](https://github.com/Azure/sonic-buildimage/pull/5316), [5329](https://github.com/Azure/sonic-buildimage/pull/5329), [5357](https://github.com/Azure/sonic-buildimage/pull/5357), [5358](https://github.com/Azure/sonic-buildimage/pull/5358), [5364](https://github.com/Azure/sonic-buildimage/pull/5364),[5418](https://github.com/Azure/sonic-buildimage/pull/5418), [5420](https://github.com/Azure/sonic-buildimage/pull/5420), [5436](https://github.com/Azure/sonic-buildimage/pull/5436), [5437](https://github.com/Azure/sonic-buildimage/pull/5437), [5446](https://github.com/Azure/sonic-buildimage/pull/5446), [5460](https://github.com/Azure/sonic-buildimage/pull/5460), [5479](https://github.com/Azure/sonic-buildimage/pull/5479), [5503](https://github.com/Azure/sonic-buildimage/pull/5503), [5548](https://github.com/Azure/sonic-buildimage/pull/5548), [87](https://github.com/Azure/sonic-platform-daemons/pull/87), [81](https://github.com/Azure/sonic-py-swsssdk/pull/81), [138](https://github.com/Azure/sonic-snmpagent/pull/138), [140](https://github.com/Azure/sonic-snmpagent/pull/140), [141](https://github.com/Azure/sonic-snmpagent/pull/141), [145](https://github.com/Azure/sonic-snmpagent/pull/145), [154](https://github.com/Azure/sonic-snmpagent/pull/154), [155](https://github.com/Azure/sonic-snmpagent/pull/155), [158](https://github.com/Azure/sonic-snmpagent/pull/158), [161](https://github.com/Azure/sonic-snmpagent/pull/161), [166](https://github.com/Azure/sonic-snmpagent/pull/166), [376](https://github.com/Azure/sonic-swss-common/pull/376), [856](https://github.com/Azure/sonic-utilities/pull/856), [917](https://github.com/Azure/sonic-utilities/pull/917), [978](https://github.com/Azure/sonic-utilities/pull/978), [999](https://github.com/Azure/sonic-utilities/pull/999), [1005](https://github.com/Azure/sonic-utilities/pull/1005), [1006](https://github.com/Azure/sonic-utilities/pull/1006), [1013](https://github.com/Azure/sonic-utilities/pull/1013), [1057](https://github.com/Azure/sonic-utilities/pull/1057), [1064](https://github.com/Azure/sonic-utilities/pull/1064), [1079](https://github.com/Azure/sonic-utilities/pull/1079), [1080](https://github.com/Azure/sonic-utilities/pull/1080), [1081](https://github.com/Azure/sonic-utilities/pull/1081), [1123](https://github.com/Azure/sonic-utilities/pull/1123) & [1137](https://github.com/Azure/sonic-utilities/pull/1137) [1127](https://github.com/Azure/sonic-utilities/pull/1127) +
    **Pull Requests** : [4825](https://github.com/sonic-net/sonic-buildimage/pull/4825), [4895](https://github.com/sonic-net/sonic-buildimage/pull/4895), [4926](https://github.com/sonic-net/sonic-buildimage/pull/4926), [4932](https://github.com/sonic-net/sonic-buildimage/pull/4932), [4959](https://github.com/sonic-net/sonic-buildimage/pull/4959), [4973](https://github.com/sonic-net/sonic-buildimage/pull/4973), [5022](https://github.com/sonic-net/sonic-buildimage/pull/5022), [5113](https://github.com/sonic-net/sonic-buildimage/pull/5113), [5121](https://github.com/sonic-net/sonic-buildimage/pull/5121), [5122](https://github.com/sonic-net/sonic-buildimage/pull/5122), [5202](https://github.com/sonic-net/sonic-buildimage/pull/5202), [5221](https://github.com/sonic-net/sonic-buildimage/pull/5221), [5224](https://github.com/sonic-net/sonic-buildimage/pull/5224), [5235](https://github.com/sonic-net/sonic-buildimage/pull/5235), [5316](https://github.com/sonic-net/sonic-buildimage/pull/5316), [5329](https://github.com/sonic-net/sonic-buildimage/pull/5329), [5357](https://github.com/sonic-net/sonic-buildimage/pull/5357), [5358](https://github.com/sonic-net/sonic-buildimage/pull/5358), [5364](https://github.com/sonic-net/sonic-buildimage/pull/5364),[5418](https://github.com/sonic-net/sonic-buildimage/pull/5418), [5420](https://github.com/sonic-net/sonic-buildimage/pull/5420), [5436](https://github.com/sonic-net/sonic-buildimage/pull/5436), [5437](https://github.com/sonic-net/sonic-buildimage/pull/5437), [5446](https://github.com/sonic-net/sonic-buildimage/pull/5446), [5460](https://github.com/sonic-net/sonic-buildimage/pull/5460), [5479](https://github.com/sonic-net/sonic-buildimage/pull/5479), [5503](https://github.com/sonic-net/sonic-buildimage/pull/5503), [5548](https://github.com/sonic-net/sonic-buildimage/pull/5548), [87](https://github.com/sonic-net/sonic-platform-daemons/pull/87), [81](https://github.com/sonic-net/sonic-py-swsssdk/pull/81), [138](https://github.com/sonic-net/sonic-snmpagent/pull/138), [140](https://github.com/sonic-net/sonic-snmpagent/pull/140), [141](https://github.com/sonic-net/sonic-snmpagent/pull/141), [145](https://github.com/sonic-net/sonic-snmpagent/pull/145), [154](https://github.com/sonic-net/sonic-snmpagent/pull/154), [155](https://github.com/sonic-net/sonic-snmpagent/pull/155), [158](https://github.com/sonic-net/sonic-snmpagent/pull/158), [161](https://github.com/sonic-net/sonic-snmpagent/pull/161), [166](https://github.com/sonic-net/sonic-snmpagent/pull/166), [376](https://github.com/sonic-net/sonic-swss-common/pull/376), [856](https://github.com/sonic-net/sonic-utilities/pull/856), [917](https://github.com/sonic-net/sonic-utilities/pull/917), [978](https://github.com/sonic-net/sonic-utilities/pull/978), [999](https://github.com/sonic-net/sonic-utilities/pull/999), [1005](https://github.com/sonic-net/sonic-utilities/pull/1005), [1006](https://github.com/sonic-net/sonic-utilities/pull/1006), [1013](https://github.com/sonic-net/sonic-utilities/pull/1013), [1057](https://github.com/sonic-net/sonic-utilities/pull/1057), [1064](https://github.com/sonic-net/sonic-utilities/pull/1064), [1079](https://github.com/sonic-net/sonic-utilities/pull/1079), [1080](https://github.com/sonic-net/sonic-utilities/pull/1080), [1081](https://github.com/sonic-net/sonic-utilities/pull/1081), [1123](https://github.com/sonic-net/sonic-utilities/pull/1123) & [1137](https://github.com/sonic-net/sonic-utilities/pull/1137) [1127](https://github.com/sonic-net/sonic-utilities/pull/1127) #### Management Framework (Phase 2) The SONiC Management Framework provides a unified UI stack, enabling SONiC to be managed through an Industry-standard CLI, RESTCONF and gNMI (using OpenConfig data models). It also offers a rapid development environment for these user-interfaces, based upon automatic code generation from YANG models. @@ -134,45 +134,45 @@ This set of enhancements extends the framework, including (but not limited to) t - Advance to Python 3.7 - Use of DBus for communication into the host - Build enhancements -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/34cac1aabdc865fc41cbe064a2ab2442645524b1/doc/mgmt/Management%20Framework.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4799](https://github.com/Azure/sonic-buildimage/pull/4799),[4765](https://github.com/Azure/sonic-buildimage/pull/4765),[4840](https://github.com/Azure/sonic-buildimage/pull/4840),[35](https://github.com/Azure/sonic-telemetry/pull/35), [38](https://github.com/Azure/sonic-telemetry/pull/38),[126](https://github.com/Azure/sonic-build-tools/pull/126), [170](https://github.com/Azure/sonic-build-tools/pull/170), [10](https://github.com/Azure/sonic-mgmt-common/pull/10),[11](https://github.com/Azure/sonic-mgmt-common/pull/11), [12](https://github.com/Azure/sonic-mgmt-common/pull/12), [13](https://github.com/Azure/sonic-mgmt-common/pull/13), [15](https://github.com/Azure/sonic-mgmt-common/pull/15), [16](https://github.com/Azure/sonic-mgmt-common/pull/16), [18](https://github.com/Azure/sonic-mgmt-common/pull/18), [19](https://github.com/Azure/sonic-mgmt-common/pull/19), [20](https://github.com/Azure/sonic-mgmt-common/pull/20), [21](https://github.com/Azure/sonic-mgmt-common/pull/21), [22](https://github.com/Azure/sonic-mgmt-common/pull/22), [23](https://github.com/Azure/sonic-mgmt-common/pull/23), [26](https://github.com/Azure/sonic-mgmt-common/pull/26), [27](https://github.com/Azure/sonic-mgmt-common/pull/27), [28](https://github.com/Azure/sonic-mgmt-common/pull/28), [31](https://github.com/Azure/sonic-mgmt-common/pull/31), [32](https://github.com/Azure/sonic-mgmt-common/pull/32), [34](https://github.com/Azure/sonic-mgmt-common/pull/34), [35](https://github.com/Azure/sonic-mgmt-common/pull/35), [50](https://github.com/Azure/sonic-mgmt-framework/pull/50), [51](https://github.com/Azure/sonic-mgmt-framework/pull/51),[52](https://github.com/Azure/sonic-mgmt-framework/pull/52), [53](https://github.com/Azure/sonic-mgmt-framework/pull/65), [57](https://github.com/Azure/sonic-mgmt-framework/pull/57), [60](https://github.com/Azure/sonic-mgmt-framework/pull/60),[65](https://github.com/Azure/sonic-mgmt-framework/pull/65), [66](https://github.com/Azure/sonic-mgmt-framework/pull/66), [67](https://github.com/Azure/sonic-mgmt-framework/pull/67), [68](https://github.com/Azure/sonic-mgmt-framework/pull/68), [69](https://github.com/Azure/sonic-mgmt-framework/pull/69),[71](https://github.com/Azure/sonic-mgmt-framework/pull/71), [5810](https://github.com/Azure/sonic-buildimage/pull/5810),[5920](https://github.com/Azure/sonic-buildimage/pull/5920),[72](https://github.com/Azure/sonic-mgmt-framework/pull/72), [73](https://github.com/Azure/sonic-mgmt-framework/pull/73), [5714](https://github.com/Azure/sonic-buildimage/pull/5714),[61](https://github.com/Azure/sonic-telemetry/pull/61) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/34cac1aabdc865fc41cbe064a2ab2442645524b1/doc/mgmt/Management%20Framework.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4799](https://github.com/sonic-net/sonic-buildimage/pull/4799),[4765](https://github.com/sonic-net/sonic-buildimage/pull/4765),[4840](https://github.com/sonic-net/sonic-buildimage/pull/4840),[35](https://github.com/sonic-net/sonic-telemetry/pull/35), [38](https://github.com/sonic-net/sonic-telemetry/pull/38),[126](https://github.com/sonic-net/sonic-build-tools/pull/126), [170](https://github.com/sonic-net/sonic-build-tools/pull/170), [10](https://github.com/sonic-net/sonic-mgmt-common/pull/10),[11](https://github.com/sonic-net/sonic-mgmt-common/pull/11), [12](https://github.com/sonic-net/sonic-mgmt-common/pull/12), [13](https://github.com/sonic-net/sonic-mgmt-common/pull/13), [15](https://github.com/sonic-net/sonic-mgmt-common/pull/15), [16](https://github.com/sonic-net/sonic-mgmt-common/pull/16), [18](https://github.com/sonic-net/sonic-mgmt-common/pull/18), [19](https://github.com/sonic-net/sonic-mgmt-common/pull/19), [20](https://github.com/sonic-net/sonic-mgmt-common/pull/20), [21](https://github.com/sonic-net/sonic-mgmt-common/pull/21), [22](https://github.com/sonic-net/sonic-mgmt-common/pull/22), [23](https://github.com/sonic-net/sonic-mgmt-common/pull/23), [26](https://github.com/sonic-net/sonic-mgmt-common/pull/26), [27](https://github.com/sonic-net/sonic-mgmt-common/pull/27), [28](https://github.com/sonic-net/sonic-mgmt-common/pull/28), [31](https://github.com/sonic-net/sonic-mgmt-common/pull/31), [32](https://github.com/sonic-net/sonic-mgmt-common/pull/32), [34](https://github.com/sonic-net/sonic-mgmt-common/pull/34), [35](https://github.com/sonic-net/sonic-mgmt-common/pull/35), [50](https://github.com/sonic-net/sonic-mgmt-framework/pull/50), [51](https://github.com/sonic-net/sonic-mgmt-framework/pull/51),[52](https://github.com/sonic-net/sonic-mgmt-framework/pull/52), [53](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [57](https://github.com/sonic-net/sonic-mgmt-framework/pull/57), [60](https://github.com/sonic-net/sonic-mgmt-framework/pull/60),[65](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [66](https://github.com/sonic-net/sonic-mgmt-framework/pull/66), [67](https://github.com/sonic-net/sonic-mgmt-framework/pull/67), [68](https://github.com/sonic-net/sonic-mgmt-framework/pull/68), [69](https://github.com/sonic-net/sonic-mgmt-framework/pull/69),[71](https://github.com/sonic-net/sonic-mgmt-framework/pull/71), [5810](https://github.com/sonic-net/sonic-buildimage/pull/5810),[5920](https://github.com/sonic-net/sonic-buildimage/pull/5920),[72](https://github.com/sonic-net/sonic-mgmt-framework/pull/72), [73](https://github.com/sonic-net/sonic-mgmt-framework/pull/73), [5714](https://github.com/sonic-net/sonic-buildimage/pull/5714),[61](https://github.com/sonic-net/sonic-telemetry/pull/61) #### Merge common lib for C++ and python (SWSS common lib) This is a fix for common lib and associated files. -
    **Pull Requests** : [378](https://github.com/Azure/sonic-swss-common/pull/378) +
    **Pull Requests** : [378](https://github.com/sonic-net/sonic-swss-common/pull/378) #### Move from Python2->python3 This is inline as part of moving all SONiC code from Python 2 (no longer supported) to Python 3. -
    **Pull Requests** : [5886](https://github.com/Azure/sonic-buildimage/pull/5886), [6038](https://github.com/Azure/sonic-buildimage/pull/6038), [6162](https://github.com/Azure/sonic-buildimage/pull/6162), [6176](https://github.com/Azure/sonic-buildimage/pull/6176), [1542](https://github.com/Azure/sonic-swss/pull/1542) +
    **Pull Requests** : [5886](https://github.com/sonic-net/sonic-buildimage/pull/5886), [6038](https://github.com/sonic-net/sonic-buildimage/pull/6038), [6162](https://github.com/sonic-net/sonic-buildimage/pull/6162), [6176](https://github.com/sonic-net/sonic-buildimage/pull/6176), [1542](https://github.com/sonic-net/sonic-swss/pull/1542) #### Multi-ASIC 202006 This feature is for a platform with more than one ASIC present on it, which is defined as a multi ASIC platform. SONiC so far supports platforms with single ASIC, we are enhancing SONiC to support multiple ASIC platforms. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/ebe4f4b695af5d2dbd23756d3cff03aef0a0c880/doc/multi_asic/SONiC_multi_asic_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4825](https://github.com/Azure/sonic-buildimage/pull/4825), [4895](https://github.com/Azure/sonic-buildimage/pull/4895), [4926](https://github.com/Azure/sonic-buildimage/pull/4926), [4932](https://github.com/Azure/sonic-buildimage/pull/4932), [4959](https://github.com/Azure/sonic-buildimage/pull/4959), [4973](https://github.com/Azure/sonic-buildimage/pull/4973), [5022](https://github.com/Azure/sonic-buildimage/pull/5022), [5113](https://github.com/Azure/sonic-buildimage/pull/5113), [5121](https://github.com/Azure/sonic-buildimage/pull/5121), [5122](https://github.com/Azure/sonic-buildimage/pull/5122), [5202](https://github.com/Azure/sonic-buildimage/pull/5202), [5221](https://github.com/Azure/sonic-buildimage/pull/5221), [5224](https://github.com/Azure/sonic-buildimage/pull/5224), [5235](https://github.com/Azure/sonic-buildimage/pull/5235), [5316](https://github.com/Azure/sonic-buildimage/pull/5316), [5329](https://github.com/Azure/sonic-buildimage/pull/5329), [5357](https://github.com/Azure/sonic-buildimage/pull/5357), [5358](https://github.com/Azure/sonic-buildimage/pull/5358), [5364](https://github.com/Azure/sonic-buildimage/pull/5364), [5418](https://github.com/Azure/sonic-buildimage/pull/5418), [5420](https://github.com/Azure/sonic-buildimage/pull/5420), [5436](https://github.com/Azure/sonic-buildimage/pull/5436), [5437](https://github.com/Azure/sonic-buildimage/pull/5437), [5446](https://github.com/Azure/sonic-buildimage/pull/5446), [5460](https://github.com/Azure/sonic-buildimage/pull/5460), [5479](https://github.com/Azure/sonic-buildimage/pull/5479), [5503](https://github.com/Azure/sonic-buildimage/pull/5503), [5548](https://github.com/Azure/sonic-buildimage/pull/5548), [87](https://github.com/Azure/sonic-platform-daemons/pull/87), [81](https://github.com/Azure/sonic-py-swsssdk/pull/81), [138](https://github.com/Azure/sonic-snmpagent/pull/138), [140](https://github.com/Azure/sonic-snmpagent/pull/140), [141](https://github.com/Azure/sonic-snmpagent/pull/141), [145](https://github.com/Azure/sonic-snmpagent/pull/145), [154](https://github.com/Azure/sonic-snmpagent/pull/154), [155](https://github.com/Azure/sonic-snmpagent/pull/155), [158](https://github.com/Azure/sonic-snmpagent/pull/158), [161](https://github.com/Azure/sonic-snmpagent/pull/161), [166](https://github.com/Azure/sonic-snmpagent/pull/166), [376](https://github.com/Azure/sonic-swss-common/pull/376), [856](https://github.com/Azure/sonic-utilities/pull/856), [917](https://github.com/Azure/sonic-utilities/pull/917), [978](https://github.com/Azure/sonic-utilities/pull/978), [999](https://github.com/Azure/sonic-utilities/pull/999), [1005](https://github.com/Azure/sonic-utilities/pull/1005), [1006](https://github.com/Azure/sonic-utilities/pull/1006), [1013](https://github.com/Azure/sonic-utilities/pull/1013), [1057](https://github.com/Azure/sonic-utilities/pull/1057), [1064](https://github.com/Azure/sonic-utilities/pull/1064), [1079](https://github.com/Azure/sonic-utilities/pull/1079), [1080](https://github.com/Azure/sonic-utilities/pull/1080), [1081](https://github.com/Azure/sonic-utilities/pull/1081), [1123](https://github.com/Azure/sonic-utilities/pull/1123), [1137](https://github.com/Azure/sonic-utilities/pull/1137) & [1127](https://github.com/Azure/sonic-utilities/pull/1127) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/ebe4f4b695af5d2dbd23756d3cff03aef0a0c880/doc/multi_asic/SONiC_multi_asic_hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4825](https://github.com/sonic-net/sonic-buildimage/pull/4825), [4895](https://github.com/sonic-net/sonic-buildimage/pull/4895), [4926](https://github.com/sonic-net/sonic-buildimage/pull/4926), [4932](https://github.com/sonic-net/sonic-buildimage/pull/4932), [4959](https://github.com/sonic-net/sonic-buildimage/pull/4959), [4973](https://github.com/sonic-net/sonic-buildimage/pull/4973), [5022](https://github.com/sonic-net/sonic-buildimage/pull/5022), [5113](https://github.com/sonic-net/sonic-buildimage/pull/5113), [5121](https://github.com/sonic-net/sonic-buildimage/pull/5121), [5122](https://github.com/sonic-net/sonic-buildimage/pull/5122), [5202](https://github.com/sonic-net/sonic-buildimage/pull/5202), [5221](https://github.com/sonic-net/sonic-buildimage/pull/5221), [5224](https://github.com/sonic-net/sonic-buildimage/pull/5224), [5235](https://github.com/sonic-net/sonic-buildimage/pull/5235), [5316](https://github.com/sonic-net/sonic-buildimage/pull/5316), [5329](https://github.com/sonic-net/sonic-buildimage/pull/5329), [5357](https://github.com/sonic-net/sonic-buildimage/pull/5357), [5358](https://github.com/sonic-net/sonic-buildimage/pull/5358), [5364](https://github.com/sonic-net/sonic-buildimage/pull/5364), [5418](https://github.com/sonic-net/sonic-buildimage/pull/5418), [5420](https://github.com/sonic-net/sonic-buildimage/pull/5420), [5436](https://github.com/sonic-net/sonic-buildimage/pull/5436), [5437](https://github.com/sonic-net/sonic-buildimage/pull/5437), [5446](https://github.com/sonic-net/sonic-buildimage/pull/5446), [5460](https://github.com/sonic-net/sonic-buildimage/pull/5460), [5479](https://github.com/sonic-net/sonic-buildimage/pull/5479), [5503](https://github.com/sonic-net/sonic-buildimage/pull/5503), [5548](https://github.com/sonic-net/sonic-buildimage/pull/5548), [87](https://github.com/sonic-net/sonic-platform-daemons/pull/87), [81](https://github.com/sonic-net/sonic-py-swsssdk/pull/81), [138](https://github.com/sonic-net/sonic-snmpagent/pull/138), [140](https://github.com/sonic-net/sonic-snmpagent/pull/140), [141](https://github.com/sonic-net/sonic-snmpagent/pull/141), [145](https://github.com/sonic-net/sonic-snmpagent/pull/145), [154](https://github.com/sonic-net/sonic-snmpagent/pull/154), [155](https://github.com/sonic-net/sonic-snmpagent/pull/155), [158](https://github.com/sonic-net/sonic-snmpagent/pull/158), [161](https://github.com/sonic-net/sonic-snmpagent/pull/161), [166](https://github.com/sonic-net/sonic-snmpagent/pull/166), [376](https://github.com/sonic-net/sonic-swss-common/pull/376), [856](https://github.com/sonic-net/sonic-utilities/pull/856), [917](https://github.com/sonic-net/sonic-utilities/pull/917), [978](https://github.com/sonic-net/sonic-utilities/pull/978), [999](https://github.com/sonic-net/sonic-utilities/pull/999), [1005](https://github.com/sonic-net/sonic-utilities/pull/1005), [1006](https://github.com/sonic-net/sonic-utilities/pull/1006), [1013](https://github.com/sonic-net/sonic-utilities/pull/1013), [1057](https://github.com/sonic-net/sonic-utilities/pull/1057), [1064](https://github.com/sonic-net/sonic-utilities/pull/1064), [1079](https://github.com/sonic-net/sonic-utilities/pull/1079), [1080](https://github.com/sonic-net/sonic-utilities/pull/1080), [1081](https://github.com/sonic-net/sonic-utilities/pull/1081), [1123](https://github.com/sonic-net/sonic-utilities/pull/1123), [1137](https://github.com/sonic-net/sonic-utilities/pull/1137) & [1127](https://github.com/sonic-net/sonic-utilities/pull/1127) #### Multi-DB enhancement-Part 2 This feature is for restoring each database with all data before warmboot and then flush unused data in each instance.Restore needs to be done in database docker since we need to know the database_config.json in new version. Need to copy all data rdb file into each instance restoration location and then flush unused database. All other logic remains the same as before. -
    **Pull Requests** : [5773](https://github.com/Azure/sonic-buildimage/pull/5773) & [1205](https://github.com/Azure/sonic-utilities/pull/1205) +
    **Pull Requests** : [5773](https://github.com/sonic-net/sonic-buildimage/pull/5773) & [1205](https://github.com/sonic-net/sonic-utilities/pull/1205) #### ONIE FW tools SONiC FW utility uses platform API to interact with the various platform components. SONiC FW utility extends to support for the automatic firmware update based on "platform_components.json" under platform directory and next reboot option which is passed as a option for fwutil update all fw command. SONiC FW utility also extends to support for the automatic firmware update with a custom firmware package that can include any firmware update tool and the firmware update tool will be used for the firmware update if it's specified in the "platform_components.json".
    Refer [HLD document](https://github.com/sujinmkang/SONiC/blob/357485991d768a9fa78873bb083e3979fbc5cf71/doc/fwutil/fwutil.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1165](https://github.com/Azure/sonic-utilities/pull/1165), [106](https://github.com/Azure/sonic-platform-common/pull/106) +
    **Pull Requests** : [1165](https://github.com/sonic-net/sonic-utilities/pull/1165), [106](https://github.com/sonic-net/sonic-platform-common/pull/106) #### PDDF advance to SONiC Platform 2.0, BMC PDDF is a rapid platform development environment for SONiC, enabling new platforms to be quickly integrated into the SONiC eco-system by automating much of the routine development using simple description files. It supports both the SONiC Platform 1.0 and 2.0 designs (though 2.0 is preferred). Also supports BMC. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/platform/brcm_pdk_pddf.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4756](https://github.com/Azure/sonic-buildimage/pull/4756), [940](https://github.com/Azure/sonic-utilities/pull/940), [92](https://github.com/Azure/sonic-platform-common/pull/92), [3387](https://github.com/Azure/sonic-buildimage/pull/3387), [624](https://github.com/Azure/sonic-utilities/pull/624), [62](https://github.com/Azure/sonic-platform-common/pull/62) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/platform/brcm_pdk_pddf.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4756](https://github.com/sonic-net/sonic-buildimage/pull/4756), [940](https://github.com/sonic-net/sonic-utilities/pull/940), [92](https://github.com/sonic-net/sonic-platform-common/pull/92), [3387](https://github.com/sonic-net/sonic-buildimage/pull/3387), [624](https://github.com/sonic-net/sonic-utilities/pull/624), [62](https://github.com/sonic-net/sonic-platform-common/pull/62) #### Support hardware reboot/reload reason (Streaming Telemetry) This feature enables SONiC streaming telemetry agent to send Reboot-cause information. During the boot, the determine-reboot-cause service ( previously process-reboot-cause) determines the last reboot-cause, based on the hardware reboot-cause. And the software reboot-cause information and determine-reboot-cause service will save the JSON-formatted last previous reboot cause. Information is "/host/reboot-cause/history/" by adding timestamp at the end of file name.
    Refer [HLD document](https://github.com/sujinmkang/SONiC/blob/6ed19e88c6f7aac74640d3d343210d840af70a23/doc/system-telemetry/reboot-cause.md) and below mentioned PR's for more details. -
    **Pull Requests** : [5562](https://github.com/Azure/sonic-buildimage/pull/5562), [1154](https://github.com/Azure/sonic-utilities/pull/1154), [5933](https://github.com/Azure/sonic-buildimage/pull/5933) & [1210](https://github.com/Azure/sonic-utilities/pull/1210) +
    **Pull Requests** : [5562](https://github.com/sonic-net/sonic-buildimage/pull/5562), [1154](https://github.com/sonic-net/sonic-utilities/pull/1154), [5933](https://github.com/sonic-net/sonic-buildimage/pull/5933) & [1210](https://github.com/sonic-net/sonic-utilities/pull/1210) #### System health and system LED System health monitor is intended to monitor both critical services and peripheral device status and leverage system log, system status LED to and CLI command output to indicate the system status.In current SONiC implementation, we already have Monit which is monitoring the critical services status and also have a set of daemons.System health monitoring service will not monitor the critical services or devices directly, it will reuse the result of Monit and PMON daemons to summarize the current status and decide the color of the system health LED. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/system_health_monitoring/system-health-HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4835](https://github.com/Azure/sonic-buildimage/pull/4835) & [4829](https://github.com/Azure/sonic-buildimage/pull/4829) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/system_health_monitoring/system-health-HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4835](https://github.com/sonic-net/sonic-buildimage/pull/4835) & [4829](https://github.com/sonic-net/sonic-buildimage/pull/4829) # SAI APIs diff --git a/doc/SONiC_202106_Release_Notes.md b/doc/SONiC_202106_Release_Notes.md index c86ca3e1d3..fa30205c2b 100644 --- a/doc/SONiC_202106_Release_Notes.md +++ b/doc/SONiC_202106_Release_Notes.md @@ -1,6 +1,6 @@ # SONiC 202106 Release Notes -This document captures the new features added and enhancements done on existing features/sub-features for the SONiC [202106](https://github.com/Azure/SONiC/wiki/Release-Progress-Tracking-202106) release. +This document captures the new features added and enhancements done on existing features/sub-features for the SONiC [202106](https://github.com/sonic-net/SONiC/wiki/Release-Progress-Tracking-202106) release. @@ -16,7 +16,7 @@ This document captures the new features added and enhancements done on existing # Branch and Image Location -Branch : https://github.com/Azure/sonic-buildimage/tree/202106
    +Branch : https://github.com/sonic-net/sonic-buildimage/tree/202106
    Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for Broadcom based platforms is [here]( https://sonic-jenkins.westus2.cloudapp.azure.com/job/broadcom/job/buildimage-brcm-202106/lastSuccessfulBuild/artifact/target/)) # Dependency Version @@ -50,8 +50,8 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### 1. Telemetry for Multi-ASIC This feature is an enhancement on sonic_db_config package for multi-asic to read different namespace redis configuration. And enhanced V2R Lookup for multi-asic, enhanced gNMI Server to initiate redis connection, enhanced gNMI Server Get and enhanced the parsing of target in gNMI Request.
    -
    Refer [HLD document](https://github.com/Azure/sonic-telemetry/pull/77) and below mentioned PR's for more details. -
    **Pull Requests** : [77](https://github.com/Azure/sonic-telemetry/pull/77) +
    Refer [HLD document](https://github.com/sonic-net/sonic-telemetry/pull/77) and below mentioned PR's for more details. +
    **Pull Requests** : [77](https://github.com/sonic-net/sonic-telemetry/pull/77) #### 2. Add FRR running configuration to tech support @@ -63,25 +63,25 @@ This implementation is an enhancement on tech support as mentioned below. * Sometimes syncd docker is down and bcmshell is unavailable. In such cases all the bcmcmd commands would timeout and result in tremendous increase in the total techsupport collection time. We provided an option to skip rest of the bcmcmd commands once one command times out. * Added show services, show reboot-cause and various BGP, BFD, bcm shell and other commands -Refer [HLD document](https://github.com/Azure/sonic-utilities/pull/1249) and below mentioned PR's for more details. -
    **Pull Requests** : [5067](https://github.com/Azure/sonic-buildimage/issues/5067) , [1193](https://github.com/Azure/sonic-utilities/pull/1193) +Refer [HLD document](https://github.com/sonic-net/sonic-utilities/pull/1249) and below mentioned PR's for more details. +
    **Pull Requests** : [5067](https://github.com/sonic-net/sonic-buildimage/issues/5067) , [1193](https://github.com/sonic-net/sonic-utilities/pull/1193) #### 3. App extension with warmboot awareness SONiC Application Extension Infrastructure is a SONiC infrastructure and framework for managing SONiC Application Packages which in this scope are SONiC compatible Docker images distributed individually from one another and from the base SONiC image. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [682](https://github.com/Azure/SONiC/pull/682), [6398](https://github.com/Azure/sonic-buildimage/issues/6398) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [682](https://github.com/sonic-net/SONiC/pull/682), [6398](https://github.com/sonic-net/sonic-buildimage/issues/6398) #### 4. Enable/Disable auto negotiation and speed setting with number of lanes This feature introduces a few new CLI commands which will fit in sonic-utilities. And this feature also requires to change the configuration flow for port auto negotiation attributes which will be covered in orchagent.
    -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/9b58ef06ab49b489e3aed287659100ce7be8c76a/doc/port_auto_neg/port-auto-negotiation-design.md#cli-enhancements) and below mentioned PR's for more details. -
    **Pull Requests** : [732](https://github.com/Azure/SONiC/pull/732), [6948](https://github.com/Azure/sonic-buildimage/pull/6948), [1568](https://github.com/Azure/sonic-utilities/pull/1568), [1714](https://github.com/Azure/sonic-swss/pull/1714), [3376](https://github.com/Azure/sonic-mgmt/pull/3376) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/9b58ef06ab49b489e3aed287659100ce7be8c76a/doc/port_auto_neg/port-auto-negotiation-design.md#cli-enhancements) and below mentioned PR's for more details. +
    **Pull Requests** : [732](https://github.com/sonic-net/SONiC/pull/732), [6948](https://github.com/sonic-net/sonic-buildimage/pull/6948), [1568](https://github.com/sonic-net/sonic-utilities/pull/1568), [1714](https://github.com/sonic-net/sonic-swss/pull/1714), [3376](https://github.com/sonic-net/sonic-mgmt/pull/3376) #### 5. TPID config support Currently SONiC Testbed setup uses fanout switches to connect to the testbed server and running the PTF test cases. The fanout switch ports connecting to the DUT are configured as access ports. The fanout switch is configured with 802.1Q tunnel on the DUT facing ports side so that tagged packets are not to be used for service delimiting purpose. With this TPID configuration capability, these fanout switches can be converted to run in SONiC.

    Refer [HLD document](https://github.com/gechiang/SONiC/blob/3f57d0304bda22222b01f2b90098e4d4d3b88f68/doc/tpid/SonicTPIDSettingHLD1.md) and below mentioned PR's for more details. -
    **Pull Requests** : [681](https://github.com/Azure/SONiC/pull/681), [7630](https://github.com/Azure/sonic-buildimage/pull/7630), [1747](https://github.com/Azure/sonic-swss/pull/1747), [1618](https://github.com/Azure/sonic-utilities/pull/1618) +
    **Pull Requests** : [681](https://github.com/sonic-net/SONiC/pull/681), [7630](https://github.com/sonic-net/sonic-buildimage/pull/7630), [1747](https://github.com/sonic-net/sonic-swss/pull/1747), [1618](https://github.com/sonic-net/sonic-utilities/pull/1618) #### 6. Error handling (swss) @@ -92,32 +92,32 @@ This feature impliments the orchagent in handling SAI failures. below are the fa * Adapt handling logic based on SAI API type and SAI status. * Escalate the failure to upper layers when the failure cannot be handled in orchagent. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/SAI_failure_handling/SAI_failure_handling.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1596](https://github.com/Azure/sonic-swss/pull/1596), [1815](https://github.com/Azure/sonic-swss/pull/1815), [1768](https://github.com/Azure/sonic-swss/pull/1768), [1786](https://github.com/Azure/sonic-swss/pull/1786), [1665](https://github.com/Azure/sonic-swss/pull/1665) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/SAI_failure_handling/SAI_failure_handling.md) and below mentioned PR's for more details. +
    **Pull Requests** : [1596](https://github.com/sonic-net/sonic-swss/pull/1596), [1815](https://github.com/sonic-net/sonic-swss/pull/1815), [1768](https://github.com/sonic-net/sonic-swss/pull/1768), [1786](https://github.com/sonic-net/sonic-swss/pull/1786), [1665](https://github.com/sonic-net/sonic-swss/pull/1665) #### 7.Inband mgmt VRF This feature design is intended to have a generic approach for in-band management via mgmt VRF feature. A user can set an attribute "in_band_mgmt_enabled" to the config_db for MGMT_VRF_CONFIG table entry. The default value if not specified would be "false"

    Refer [HLD document](https://github.com/venkatmahalingam/SONiC/blob/7781c097a92d9fbac3fc2fe2f8c6ce175839f473/doc/vrf/SONiC_in_band_mgmt_via_mgmt_Vrf_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1726](https://github.com/Azure/sonic-swss/pull/1726) +
    **Pull Requests** : [1726](https://github.com/sonic-net/sonic-swss/pull/1726) #### 8.SONiC for MPLS Dataplane This feature provides general information about the initial support for MPLS in SONiC infrastructure. The focus of this initial MPLS support is to expand existing SONiC infrastructure for IPv4/IPv6 routing to include equivalent MPLS functionality. The expected use case for this initial MPLS support is static LSP routing.
    -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/364fcae0438ed583270b56319dcfcb91e20b918a/doc/mpls/MPLS_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [1537](https://github.com/Azure/sonic-utilities/pull/1537), [469](https://github.com/Azure/sonic-swss-common/pull/469), [824](https://github.com/Azure/sonic-sairedis/pull/824), [7195](https://github.com/Azure/sonic-buildimage/pull/7195), [1686](https://github.com/Azure/sonic-swss/pull/1686) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/364fcae0438ed583270b56319dcfcb91e20b918a/doc/mpls/MPLS_hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [1537](https://github.com/sonic-net/sonic-utilities/pull/1537), [469](https://github.com/sonic-net/sonic-swss-common/pull/469), [824](https://github.com/sonic-net/sonic-sairedis/pull/824), [7195](https://github.com/sonic-net/sonic-buildimage/pull/7195), [1686](https://github.com/sonic-net/sonic-swss/pull/1686) #### 9.IPv6 Link Local and BGP Unnumbered This feature provides the implementation of IPv6 link-local enhancements in SONiC.
    Refer [HLD document](https://github.com/kirankella/SONiC/blob/d17a977f88ed623c8367eaac747040796d7a7c3f/doc/ipv6/ipv6_link_local.md) and below mentioned PR's for more details. -
    **Pull Requests** : [5584](https://github.com/Azure/sonic-buildimage/pull/5584), [1463](https://github.com/Azure/sonic-swss/pull/1463), [1159](https://github.com/Azure/sonic-utilities/pull/1159) +
    **Pull Requests** : [5584](https://github.com/sonic-net/sonic-buildimage/pull/5584), [1463](https://github.com/sonic-net/sonic-swss/pull/1463), [1159](https://github.com/sonic-net/sonic-utilities/pull/1159) #### 10. MC-LAG (L2) This feature is an enhancements of SONiC ICCP MCLAG. This includes MCLAG configuration support, data structure changes, MAC event handling optimizations for scaling performance, support of static MAC address over MCLAG, support bridge-port isolation group for BUM control to MCLAG, and traffic recovery sequencing for traffic loop prevention. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/mclag/MCLAG_Enhancements_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [596](https://github.com/Azure/SONiC/pull/596), [885](https://github.com/Azure/sonic-swss/pull/885), [4819](https://github.com/Azure/sonic-buildimage/pull/4819), [1331](https://github.com/Azure/sonic-swss/pull/1331), [1349](https://github.com/Azure/sonic-swss/pull/1349), [529](https://github.com/Azure/sonic-utilities/pull/529), [405](https://github.com/Azure/sonic-swss-common/pull/405), [59](https://github.com/Azure/sonic-mgmt-framework/pull/59), [25](https://github.com/Azure/sonic-mgmt-common/pull/25) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/mclag/MCLAG_Enhancements_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [596](https://github.com/sonic-net/SONiC/pull/596), [885](https://github.com/sonic-net/sonic-swss/pull/885), [4819](https://github.com/sonic-net/sonic-buildimage/pull/4819), [1331](https://github.com/sonic-net/sonic-swss/pull/1331), [1349](https://github.com/sonic-net/sonic-swss/pull/1349), [529](https://github.com/sonic-net/sonic-utilities/pull/529), [405](https://github.com/sonic-net/sonic-swss-common/pull/405), [59](https://github.com/sonic-net/sonic-mgmt-framework/pull/59), [25](https://github.com/sonic-net/sonic-mgmt-common/pull/25) #### 11. DHCP relay IPv6 support This DHCP Relay for IPv6 feature in SONiC impliments the following functionalities, @@ -126,49 +126,49 @@ This DHCP Relay for IPv6 feature in SONiC impliments the following functionaliti * To provide the functionality as a seperate process running on dhcp-relay docker container. * To relay messages to multiple unicast and multicast addresses. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/DHCPv6_Relay/DHCPv6_Relay_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [7772](https://github.com/Azure/sonic-buildimage/pull/7772), [6531](https://github.com/Azure/sonic-buildimage/pull/6531), [7789](https://github.com/Azure/sonic-buildimage/pull/7789), [3565](https://github.com/Azure/sonic-mgmt/pull/3565) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/DHCPv6_Relay/DHCPv6_Relay_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [7772](https://github.com/sonic-net/sonic-buildimage/pull/7772), [6531](https://github.com/sonic-net/sonic-buildimage/pull/6531), [7789](https://github.com/sonic-net/sonic-buildimage/pull/7789), [3565](https://github.com/sonic-net/sonic-mgmt/pull/3565) #### 12. RADIUS AAA This implementation describes the high level design of RADIUS management user authentication feature in SONiC.

    Refer [HLD document](https://github.com/a-barboza/SONiC/blob/8d31c4014e27f422f4c522d2891fa9d9a4fff606/doc/aaa/radius_authentication.md) and below mentioned PR's for more details. -
    **Pull Requests** : [500](https://github.com/Azure/SONiC/pull/500), [1521](https://github.com/Azure/sonic-utilities/pull/1521), [7284](https://github.com/Azure/sonic-buildimage/pull/7284), [4220](https://github.com/Azure/sonic-buildimage/pull/4220) +
    **Pull Requests** : [500](https://github.com/sonic-net/SONiC/pull/500), [1521](https://github.com/sonic-net/sonic-utilities/pull/1521), [7284](https://github.com/sonic-net/sonic-buildimage/pull/7284), [4220](https://github.com/sonic-net/sonic-buildimage/pull/4220) #### 13. PDK - Platform Development Environment The SONiC PDE is part of the SONiC Platform Development Kit (PDK) which optimizes platform development. The SONiC PDK consists of PDDF (Platform Driver Development Framework) and PDE (Platform Development Environment) -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/platform/pde.md) and below mentioned PR's for more details. -
    **Pull Requests** : [3778](https://github.com/Azure/sonic-buildimage/pull/3778) [28](https://github.com/Azure/sonic-platform-pdk-pde/pull/28), [107](https://github.com/Azure/sonic-build-tools/pull/107). +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/platform/pde.md) and below mentioned PR's for more details. +
    **Pull Requests** : [3778](https://github.com/sonic-net/sonic-buildimage/pull/3778) [28](https://github.com/sonic-net/sonic-platform-pdk-pde/pull/28), [107](https://github.com/sonic-net/sonic-build-tools/pull/107). #### 14. Broadcom silicon common config This feature supports the per-switching silicon common config.bcm file to assist with silicon-wide application configuration settings for all affected Broadcom platforms. The infrastructure saves development time by allowing applications to refactor common settings in a single location, and allows for platform-specific overrides.

    Refer [HLD document](https://github.com/geans-pin/SONiC/blob/ff5ad50dfd770242d4fdac97f2e4c803b2425dde/doc/platform/common_config.md) and below mentioned PR's for more details. -
    **Pull Requests** : [693](https://github.com/Azure/sonic-sairedis/pull/693), [699](https://github.com/Azure/SONiC/pull/699), [5818](https://github.com/Azure/sonic-buildimage/pull/5818), [7493](https://github.com/Azure/sonic-buildimage/pull/7493) +
    **Pull Requests** : [693](https://github.com/sonic-net/sonic-sairedis/pull/693), [699](https://github.com/sonic-net/SONiC/pull/699), [5818](https://github.com/sonic-net/sonic-buildimage/pull/5818), [7493](https://github.com/sonic-net/sonic-buildimage/pull/7493) #### 15. PCIe Monitoring This feature is intended to give the idea of how to monitor the platform PCIe devices and alert of any problems on PCIe buses and devices on SONiC using pcie-check service and pcied on PMON container.New PCIe Monitor service is designed to use the PcieUtil utility to check the current status of PCIe devices and buses and alert if there is any missing devices or any error while communicating on the PCIe buses.PCIe device monitoring will be done in two separate services, pcie-check.service which is a systemd service, will check the PCIe device during the boot time and pcied which is a daemon in PMON container will monitor during the runtime.

    Refer [HLD document](https://github.com/sujinmkang/SONiC/blob/4e93b8b30609ffc698ac801cd12740c35d2ea284/doc/pcie-mon/pcie-monitoring-services-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [60](https://github.com/Azure/sonic-platform-daemons/pull/60), [100](https://github.com/Azure/sonic-platform-daemons/pull/100), [144](https://github.com/Azure/sonic-platform-common/pull/144), [634](https://github.com/Azure/SONiC/pull/634), [678](https://github.com/Azure/SONiC/pull/678), [1169](https://github.com/Azure/sonic-utilities/pull/1169), [5000](https://github.com/Azure/sonic-buildimage/pull/5000) +
    **Pull Requests** : [60](https://github.com/sonic-net/sonic-platform-daemons/pull/60), [100](https://github.com/sonic-net/sonic-platform-daemons/pull/100), [144](https://github.com/sonic-net/sonic-platform-common/pull/144), [634](https://github.com/sonic-net/SONiC/pull/634), [678](https://github.com/sonic-net/SONiC/pull/678), [1169](https://github.com/sonic-net/sonic-utilities/pull/1169), [5000](https://github.com/sonic-net/sonic-buildimage/pull/5000) #### 16. Enhanced xcrvd SFP error flow HLD This feature reflects the current implementation of xcvrd to the HLD.Added new SFP error event handling procedure and added a CLI to retrieve the SFP error status.
    -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/f8893cf5d7492c92e9e613c1eb525778ab60f6cb/doc/xrcvd/transceiver-monitor-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [184](https://github.com/Azure/sonic-platform-daemons/pull/184), [194](https://github.com/Azure/sonic-platform-common/pull/194), [586](https://github.com/Azure/SONiC/pull/586), [1658](https://github.com/Azure/sonic-utilities/pull/1658), [3648](https://github.com/Azure/sonic-mgmt/pull/3648), [7605](https://github.com/Azure/sonic-buildimage/pull/7605) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/f8893cf5d7492c92e9e613c1eb525778ab60f6cb/doc/xrcvd/transceiver-monitor-hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [184](https://github.com/sonic-net/sonic-platform-daemons/pull/184), [194](https://github.com/sonic-net/sonic-platform-common/pull/194), [586](https://github.com/sonic-net/SONiC/pull/586), [1658](https://github.com/sonic-net/sonic-utilities/pull/1658), [3648](https://github.com/sonic-net/sonic-mgmt/pull/3648), [7605](https://github.com/sonic-net/sonic-buildimage/pull/7605) #### 17. Entity sensor MIB extension The Entity MIB contains several groups of MIB objects: entityPhysical group, entityLogical group and so on. Currently SONiC only implemented part of the entityPhysical group following RFC2737. Since entityPhysical group is mostly common used, this extension will focus on entityPhysical group and leave other groups for future implementation.
    -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/90731187a760b604870a2f3fc6868530f5427937/doc/snmp/extension-to-physical-entity-mib.md) and below mentioned PR's for more details. -
    **Pull Requests** : [211](https://github.com/Azure/sonic-snmpagent/pull/211), [766](https://github.com/Azure/SONiC/pull/766), [3357](https://github.com/Azure/sonic-mgmt/pull/3357) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/90731187a760b604870a2f3fc6868530f5427937/doc/snmp/extension-to-physical-entity-mib.md) and below mentioned PR's for more details. +
    **Pull Requests** : [211](https://github.com/sonic-net/sonic-snmpagent/pull/211), [766](https://github.com/sonic-net/SONiC/pull/766), [3357](https://github.com/sonic-net/sonic-mgmt/pull/3357) #### 18. Enable/Disable auto negotiation and speed setting with number of lanes Add new CLIs to enable/disable auto negotiation per interface as well as setting the number of lanes per requested speed
    -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/9b58ef06ab49b489e3aed287659100ce7be8c76a/doc/port_auto_neg/port-auto-negotiation-design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [732] (https://github.com/Azure/SONiC/pull/732) +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/9b58ef06ab49b489e3aed287659100ce7be8c76a/doc/port_auto_neg/port-auto-negotiation-design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [732] (https://github.com/sonic-net/SONiC/pull/732) # SAI APIs diff --git a/doc/SONiC_202111_Release_Notes.md b/doc/SONiC_202111_Release_Notes.md index 8f9eb55947..dcf90c339b 100644 --- a/doc/SONiC_202111_Release_Notes.md +++ b/doc/SONiC_202111_Release_Notes.md @@ -1,6 +1,6 @@ # SONiC 202111 Release Notes -This document captures the new features added and enhancements done on existing features/sub-features for the SONiC [202111](https://github.com/Azure/SONiC/wiki/Release-Progress-Tracking-202111) release. +This document captures the new features added and enhancements done on existing features/sub-features for the SONiC [202111](https://github.com/sonic-net/SONiC/wiki/Release-Progress-Tracking-202111) release. @@ -16,7 +16,7 @@ This document captures the new features added and enhancements done on existing # Branch and Image Location -Branch : https://github.com/Azure/sonic-buildimage/tree/202111
    +Branch : https://github.com/sonic-net/sonic-buildimage/tree/202111
    Image : https://sonic-build.azurewebsites.net/ui/sonic/pipelines (Example - Image for Broadcom based platforms is [here](https://sonic-build.azurewebsites.net/ui/sonic/pipelines/138/builds/51255/artifacts/98637?branchName=master&artifactName=sonic-buildimage.broadcom)) # Dependency Version @@ -52,32 +52,32 @@ Image : https://sonic-build.azurewebsites.net/ui/sonic/pipelines (Example - Im #### ACL orch redesign This feature covers ACL rule counters support and enhancements in that area. The current design of ACL rule counters implements polling at orchagent side at a constant hardcoded interval of 10 seconds. While it is a simpler approach comparing to Flex Counters infrastructure it comes at a cost of scalability and performance issues.Flex counters infrastructure on another hand already used for port, PG, queue, watermark counters solves this issue by delegating counter polling to a separate thread in syncd and allowing to configure polling interval as well. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/acl/ACL-Flex-Counters.md) and below mentioned PR's for more details. -
    **Pull Requests** : [533](https://github.com/Azure/sonic-swss-common/pull/533), [953](https://github.com/Azure/sonic-sairedis/pull/953), [1943](https://github.com/Azure/sonic-swss/pull/1943), [1858](https://github.com/Azure/sonic-utilities/pull/1858), [8908](https://github.com/Azure/sonic-buildimage/pull/8908) & [8909](https://github.com/Azure/sonic-buildimage/pull/8909) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/acl/ACL-Flex-Counters.md) and below mentioned PR's for more details. +
    **Pull Requests** : [533](https://github.com/sonic-net/sonic-swss-common/pull/533), [953](https://github.com/sonic-net/sonic-sairedis/pull/953), [1943](https://github.com/sonic-net/sonic-swss/pull/1943), [1858](https://github.com/sonic-net/sonic-utilities/pull/1858), [8908](https://github.com/sonic-net/sonic-buildimage/pull/8908) & [8909](https://github.com/sonic-net/sonic-buildimage/pull/8909) #### App extension CLI generation tool The SONiC CLI Auto-generation tool - is a utility for generating the command-line interface for third-party features, called application extensions, that provide their functionality as separate docker containers. The YANG model will be used to describe the CONFIG DB schema and CLI will be generated according to CONFIG DB schema. The YANG model will serve as an input parameter for the SONiC Auto-generation utility. The CLI should be a part of SONiC utilities and support - show, config operations. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [780](https://github.com/Azure/SONiC/pull/780), [1644](https://github.com/Azure/sonic-utilities/pull/1644) & [1650](https://github.com/Azure/sonic-utilities/pull/1650) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [780](https://github.com/sonic-net/SONiC/pull/780), [1644](https://github.com/sonic-net/sonic-utilities/pull/1644) & [1650](https://github.com/sonic-net/sonic-utilities/pull/1650) #### Automatic techsupport and core dump creation Currently, techsupport is run by invoking show techsupport either by orchestration tools like Jenkins or manually. The techsupport dump also collects any core dump files available in the /var/core/ directory. However if the techsupport invocation can be made event-driven based on core dump generation, that would definitely improve the debuggability. -Refer [HLD document](https://github.com/Azure/SONiC/blob/61a07b416d0ecab85833337944928dca5d64150e/doc/auto_techsupport_and_coredump_mgmt.md) and below mentioned PR's for more details. -
    **Pull Requests** : [818](https://github.com/Azure/SONiC/pull/818), [8670](https://github.com/Azure/sonic-buildimage/pull/8670) & [1796](https://github.com/Azure/sonic-utilities/pull/1796) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/61a07b416d0ecab85833337944928dca5d64150e/doc/auto_techsupport_and_coredump_mgmt.md) and below mentioned PR's for more details. +
    **Pull Requests** : [818](https://github.com/sonic-net/SONiC/pull/818), [8670](https://github.com/sonic-net/sonic-buildimage/pull/8670) & [1796](https://github.com/sonic-net/sonic-utilities/pull/1796) #### Better route scalability with multiple next-hops Currently the route table within APP_DB contains all next hop information for a route embedded in that route's entry in the table. At high scale (particularly when handling millions of routes all routed over multiple next hops) this is inefficient both in terms of performance and occupancy. A more efficient system would involve managing the next hop groups in use by the route table separately, and simply have the route table specify a reference to which next hop group to use. Since at scale many routes will use the same next hop groups, this requires much smaller occupancy per route, and so more efficient building, transmission and parsing of per-route information. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/ip/next_hop_group_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [712](https://github.com/Azure/SONiC/pull/712), [475](https://github.com/Azure/sonic-swss-common/pull/475) & [1702](https://github.com/Azure/sonic-swss/pull/1702) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/ip/next_hop_group_hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [712](https://github.com/sonic-net/SONiC/pull/712), [475](https://github.com/sonic-net/sonic-swss-common/pull/475) & [1702](https://github.com/sonic-net/sonic-swss/pull/1702) #### Class-Based Forwarding Class Based Forwarding which allows traffic to be steered through the network by policy, adding a layer of traffic engineering based on a Forwarding Class value which allows custom paths to be configured for a destination based on this value. -Refer [HLD document](https://github.com/Azure/SONiC/blob/e65d05a32761ea1c50c170008b22410879dce300/doc/cbf/cbf_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [796](https://github.com/Azure/SONiC/pull/796), [525](https://github.com/Azure/sonic-swss-common/pull/525), [909](https://github.com/Azure/sonic-sairedis/pull/909), [1963](https://github.com/Azure/sonic-swss/pull/1963), [8689](https://github.com/Azure/sonic-buildimage/pull/8689) & [1799](https://github.com/Azure/sonic-utilities/pull/1799) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/e65d05a32761ea1c50c170008b22410879dce300/doc/cbf/cbf_hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [796](https://github.com/sonic-net/SONiC/pull/796), [525](https://github.com/sonic-net/sonic-swss-common/pull/525), [909](https://github.com/sonic-net/sonic-sairedis/pull/909), [1963](https://github.com/sonic-net/sonic-swss/pull/1963), [8689](https://github.com/sonic-net/sonic-buildimage/pull/8689) & [1799](https://github.com/sonic-net/sonic-utilities/pull/1799) #### CLI level authorization This feature is based on TACACS+ Authentication, and provides a detailed description for improved TACACS+ support. @@ -95,121 +95,121 @@ SONiC currently supported TACACS+ features: * User command authorization with TACACS+ server. * User command accounting with TACACS+ server. -Refer [HLD document](https://github.com/Azure/SONiC/blob/4d1660cc88002aff64e6228b63b5f2d6b59d6031/doc/aaa/TACACS%2B%20Design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [813](https://github.com/Azure/SONiC/pull/813), [8660](https://github.com/Azure/sonic-buildimage/pull/8660), [8659](https://github.com/Azure/sonic-buildimage/pull/8659), [8715](https://github.com/Azure/sonic-buildimage/pull/8715), [9029](https://github.com/Azure/sonic-buildimage/pull/9029), [1889](https://github.com/Azure/sonic-utilities/pull/1889), [4605](https://github.com/Azure/sonic-mgmt/pull/4605) & [8750](https://github.com/Azure/sonic-buildimage/pull/8750) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/4d1660cc88002aff64e6228b63b5f2d6b59d6031/doc/aaa/TACACS%2B%20Design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [813](https://github.com/sonic-net/SONiC/pull/813), [8660](https://github.com/sonic-net/sonic-buildimage/pull/8660), [8659](https://github.com/sonic-net/sonic-buildimage/pull/8659), [8715](https://github.com/sonic-net/sonic-buildimage/pull/8715), [9029](https://github.com/sonic-net/sonic-buildimage/pull/9029), [1889](https://github.com/sonic-net/sonic-utilities/pull/1889), [4605](https://github.com/sonic-net/sonic-mgmt/pull/4605) & [8750](https://github.com/sonic-net/sonic-buildimage/pull/8750) #### DHCP support IPv6 SONiC currently supports DHCPv4 Relay via the use of open source ISC DHCP package. However, DHCPv6 specification does not define a way to communicate client link-layer address to the DHCP server where DHCP server is not connected to the same network link as DHCP client. DHCPv6 requires all clients prepare and send a DUID as the client identifier in all DHCPv6 message exchanges. -Refer [HLD document](https://github.com/Azure/SONiC/blob/92acec6cc29165382e0b40d1ff528a6f409de572/doc/DHCPv6_relay/DHCPv6-relay-agent-High-Level-Design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [787](https://github.com/Azure/SONiC/pull/787) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/92acec6cc29165382e0b40d1ff528a6f409de572/doc/DHCPv6_relay/DHCPv6-relay-agent-High-Level-Design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [787](https://github.com/sonic-net/SONiC/pull/787) #### Dynamic Policy Based Hashing This feature will support policy based hashing for NVGRE/VxLAN packets based on inner 5-tuple (IP proto, L4 dst/src port, IPv4/IPv6 dst/src) -Refer [HLD document](https://github.com/Azure/SONiC/blob/91eee7f952b4ad4679ada1b5b5f3b95ad39e2431/doc/pbh/pbh-design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [773](https://github.com/Azure/SONiC/pull/773), [7461](https://github.com/Azure/sonic-buildimage/pull/7461), [495](https://github.com/Azure/sonic-swss-common/pull/495), [1782](https://github.com/Azure/sonic-swss/pull/1782) & [1701](https://github.com/Azure/sonic-utilities/pull/1701) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/91eee7f952b4ad4679ada1b5b5f3b95ad39e2431/doc/pbh/pbh-design.md) and below mentioned PR's for more details. +
    **Pull Requests** : [773](https://github.com/sonic-net/SONiC/pull/773), [7461](https://github.com/sonic-net/sonic-buildimage/pull/7461), [495](https://github.com/sonic-net/sonic-swss-common/pull/495), [1782](https://github.com/sonic-net/sonic-swss/pull/1782) & [1701](https://github.com/sonic-net/sonic-utilities/pull/1701) #### Dynamic port breakout This feature is to support port breakout dynamically. We should be able to change port breakout mode at run time without affecting the unrelated port activities. Configuration dependencies on the ports to be changed with breakout mode should be reported or removed automatically. Run time dependencies and resources should be cleared on the ports to be changed with breakout mode. Optionally, we provide a way to automatically add the configuration back to the port if operators can specify in advance. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4235](https://github.com/Azure/sonic-buildimage/pull/4235), [3910](https://github.com/Azure/sonic-buildimage/pull/3910), [1242](https://github.com/Azure/sonic-swss/pull/1242), [1219](https://github.com/Azure/sonic-swss/pull/1219), [1148](https://github.com/Azure/sonic-swss/pull/1148), [1112](https://github.com/Azure/sonic-swss/pull/1112), [766](https://github.com/Azure/sonic-utilities/pull/766), [72](https://github.com/Azure/sonic-platform-common/pull/72), [859](https://github.com/Azure/sonic-utilities/pull/859), [767](https://github.com/Azure/sonic-utilities/pull/767), [765](https://github.com/Azure/sonic-utilities/pull/765), [3912](https://github.com/Azure/sonic-buildimage/pull/3912), [3911](https://github.com/Azure/sonic-buildimage/pull/3911), [3909](https://github.com/Azure/sonic-buildimage/pull/3909), [3861](https://github.com/Azure/sonic-buildimage/pull/3861), [3730](https://github.com/Azure/sonic-buildimage/pull/3730), [3907](https://github.com/Azure/sonic-buildimage/pull/3907), [3891](https://github.com/Azure/sonic-buildimage/pull/3891), [3874](https://github.com/Azure/sonic-buildimage/pull/3874), [1085](https://github.com/Azure/sonic-swss/pull/1085), [1151](https://github.com/Azure/sonic-swss/pull/1151) & [1150](https://github.com/Azure/sonic-swss/pull/1150) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [4235](https://github.com/sonic-net/sonic-buildimage/pull/4235), [3910](https://github.com/sonic-net/sonic-buildimage/pull/3910), [1242](https://github.com/sonic-net/sonic-swss/pull/1242), [1219](https://github.com/sonic-net/sonic-swss/pull/1219), [1148](https://github.com/sonic-net/sonic-swss/pull/1148), [1112](https://github.com/sonic-net/sonic-swss/pull/1112), [766](https://github.com/sonic-net/sonic-utilities/pull/766), [72](https://github.com/sonic-net/sonic-platform-common/pull/72), [859](https://github.com/sonic-net/sonic-utilities/pull/859), [767](https://github.com/sonic-net/sonic-utilities/pull/767), [765](https://github.com/sonic-net/sonic-utilities/pull/765), [3912](https://github.com/sonic-net/sonic-buildimage/pull/3912), [3911](https://github.com/sonic-net/sonic-buildimage/pull/3911), [3909](https://github.com/sonic-net/sonic-buildimage/pull/3909), [3861](https://github.com/sonic-net/sonic-buildimage/pull/3861), [3730](https://github.com/sonic-net/sonic-buildimage/pull/3730), [3907](https://github.com/sonic-net/sonic-buildimage/pull/3907), [3891](https://github.com/sonic-net/sonic-buildimage/pull/3891), [3874](https://github.com/sonic-net/sonic-buildimage/pull/3874), [1085](https://github.com/sonic-net/sonic-swss/pull/1085), [1151](https://github.com/sonic-net/sonic-swss/pull/1151) & [1150](https://github.com/sonic-net/sonic-swss/pull/1150) #### EXP to TC QoS maps This feature extends SONiC to support MPLS TC to TC mappings. This new enhancement adds support to SONiC for MPLS TC to TC map which allows QoS to work on MPLS packets. User can configure MPLS TC to TC map at start-of-day via configuration file. CLI support will exist to offer the same amount of support as for DSCP to TC map. -Refer [HLD document](https://github.com/Azure/SONiC/blob/bb476c589a6ac5a7e3ea66a0a84caab6264dc7a9/doc/qos/mpls_tc_to_tc_map.md) and below mentioned PR's for more details. -
    **Pull Requests** : [844](https://github.com/Azure/SONiC/pull/844), [537](https://github.com/Azure/sonic-swss-common/pull/537), [1954](https://github.com/Azure/sonic-swss/pull/1954) & [1875](https://github.com/Azure/sonic-utilities/pull/1875) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/bb476c589a6ac5a7e3ea66a0a84caab6264dc7a9/doc/qos/mpls_tc_to_tc_map.md) and below mentioned PR's for more details. +
    **Pull Requests** : [844](https://github.com/sonic-net/SONiC/pull/844), [537](https://github.com/sonic-net/sonic-swss-common/pull/537), [1954](https://github.com/sonic-net/sonic-swss/pull/1954) & [1875](https://github.com/sonic-net/sonic-utilities/pull/1875) #### EVPN VXLAN for platforms using P2MP tunnel based L2 forwarding The EVPN VXLAN feature implementation is based on RFC 7432 and 8365 in SONiC. This feature is incremental to the SONiC.201911 release. -Refer [HLD document](https://github.com/Azure/SONiC/blob/17583e3eae8e06cf9e15df9806ab97ab4db76082/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [806](https://github.com/Azure/SONiC/pull/806), [1858](https://github.com/Azure/sonic-swss/pull/1858), [8685](https://github.com/Azure/sonic-buildimage/pull/8685), [920](https://github.com/Azure/sonic-sairedis/pull/920), [1859](https://github.com/Azure/sonic-swss/pull/1859), [886](https://github.com/Azure/sonic-sairedis/pull/886), [519](https://github.com/Azure/sonic-swss-common/pull/519), [1748](https://github.com/Azure/sonic-utilities/pull/1748) & [8369](https://github.com/Azure/sonic-buildimage/pull/8369) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/17583e3eae8e06cf9e15df9806ab97ab4db76082/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [806](https://github.com/sonic-net/SONiC/pull/806), [1858](https://github.com/sonic-net/sonic-swss/pull/1858), [8685](https://github.com/sonic-net/sonic-buildimage/pull/8685), [920](https://github.com/sonic-net/sonic-sairedis/pull/920), [1859](https://github.com/sonic-net/sonic-swss/pull/1859), [886](https://github.com/sonic-net/sonic-sairedis/pull/886), [519](https://github.com/sonic-net/sonic-swss-common/pull/519), [1748](https://github.com/sonic-net/sonic-utilities/pull/1748) & [8369](https://github.com/sonic-net/sonic-buildimage/pull/8369) #### Handle port config change on fly in xcvrd The current xcvrd assumes that port mapping information is never changed, so it always read static port mapping information from platform.json/port_config.ini and save it to a global data structure. However, things changed since dynamic port breakout feature introduced. Port can be added/created on the fly, xcvrd cannot update transceiver information, DOM information and transceiver status information without knowing the ports change. This implementation introduces a way to handle port configuration change on fly in xcvrd. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/xrcvd/transceiver-monitor-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [839](https://github.com/Azure/SONiC/pull/839) & [212](https://github.com/Azure/sonic-platform-daemons/pull/212) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/xrcvd/transceiver-monitor-hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [839](https://github.com/sonic-net/SONiC/pull/839) & [212](https://github.com/sonic-net/sonic-platform-daemons/pull/212) #### Host interface trap counter Flow counters are usually used for debugging, troubleshooting and performance enhancement processes. Flow counters could cover cases like, Host interface traps (number of received traps per Trap ID), Routes matching the configured prefix pattern (number of hits and number of bytes), FDB entries matching the configured VXLAN tunnel or using the VLAN ID as pattern, Next-Hop/Next-Hop Group/Next-Hop Group Member, & This document focus on host interface traps counter. -Refer [HLD document](https://github.com/Azure/SONiC/blob/434a5fcc8a5c7f0fe13e163d89ee9af61a06dbd1/doc/flow_counters/flow_counters.md) and below mentioned PR's for more details. -
    **Pull Requests** : [858](https://github.com/Azure/SONiC/pull/858), [8940](https://github.com/Azure/sonic-buildimage/pull/8940), [1951](https://github.com/Azure/sonic-swss/pull/1951), [4456](https://github.com/Azure/sonic-mgmt/pull/4456), [1868](https://github.com/Azure/sonic-utilities/pull/1868), [954](https://github.com/Azure/sonic-sairedis/pull/954), [534](https://github.com/Azure/sonic-swss-common/pull/534), [1876](https://github.com/Azure/sonic-utilities/pull/1876) & [9353](https://github.com/Azure/sonic-buildimage/pull/9353) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/434a5fcc8a5c7f0fe13e163d89ee9af61a06dbd1/doc/flow_counters/flow_counters.md) and below mentioned PR's for more details. +
    **Pull Requests** : [858](https://github.com/sonic-net/SONiC/pull/858), [8940](https://github.com/sonic-net/sonic-buildimage/pull/8940), [1951](https://github.com/sonic-net/sonic-swss/pull/1951), [4456](https://github.com/sonic-net/sonic-mgmt/pull/4456), [1868](https://github.com/sonic-net/sonic-utilities/pull/1868), [954](https://github.com/sonic-net/sonic-sairedis/pull/954), [534](https://github.com/sonic-net/sonic-swss-common/pull/534), [1876](https://github.com/sonic-net/sonic-utilities/pull/1876) & [9353](https://github.com/sonic-net/sonic-buildimage/pull/9353) #### L2 functional and performance enhancements This implentation provides enhancements in SONiC layer 2 forwarding for FDB flush, MAC move, FDB aging time configuration, Static FDB configuration and VLAN Range configuration. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/layer2-forwarding-enhancements/SONiC%20Layer%202%20Forwarding%20Enhancements%20HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [379](https://github.com/Azure/SONiC/pull/379), [510](https://github.com/Azure/sonic-sairedis/pull/510), [303](https://github.com/Azure/sonic-swss-common/pull/303), [529](https://github.com/Azure/sonic-utilities/pull/529) & [1716](https://github.com/Azure/sonic-swss/pull/1716) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/layer2-forwarding-enhancements/SONiC%20Layer%202%20Forwarding%20Enhancements%20HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [379](https://github.com/sonic-net/SONiC/pull/379), [510](https://github.com/sonic-net/sonic-sairedis/pull/510), [303](https://github.com/sonic-net/sonic-swss-common/pull/303), [529](https://github.com/sonic-net/sonic-utilities/pull/529) & [1716](https://github.com/sonic-net/sonic-swss/pull/1716) #### New branch creation for Debian11 In preparation for Debian Bullseye, upgrade SONiC's base system to be based on Bullseye, which was released in August 2021.Kernel is now based on 5.10.x (currently, official Debian Bullseye is publishing the 5.10.70 kernel) Most Python 2 packages (as well as pip2.7) have been removed from Bullseye. The Python 2 interpreter is still available. The kernel has been upgraded to 5.10.46, and the base system is now based on Bullseye. Containers are still based on Buster. -Refer [PR#8191](https://github.com/Azure/sonic-buildimage/pull/8191) for more details. +Refer [PR#8191](https://github.com/sonic-net/sonic-buildimage/pull/8191) for more details. #### One line command to extract multiple DBs info of a SONiC component In SONiC, there usually exists a set of tables related/relevant to a particular module. All of these have to be looked at to confirm whether any configuration update is properly applied and propagated.The task of debugging quickly becomes tedious because currently, there is no utility which does print a unified view of the redis-state. This is the problem which is addressed by this dump utility.This utility provides the base infrastructure and guidelines to make is easy for the developers to extend and support the utility for different modules. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/Dump-Utility.md) and below mentioned PR's for more details. -
    **Pull Requests** : [789](https://github.com/Azure/SONiC/pull/789), [1666](https://github.com/Azure/sonic-utilities/pull/1666), [1667](https://github.com/Azure/sonic-utilities/pull/1667), [1668](https://github.com/Azure/sonic-utilities/pull/1668), [1669](https://github.com/Azure/sonic-utilities/pull/1669), [1670](https://github.com/Azure/sonic-utilities/pull/1670), [1853](https://github.com/Azure/sonic-utilities/pull/1853), [1877](https://github.com/Azure/sonic-utilities/pull/1877), [1913](https://github.com/Azure/sonic-utilities/pull/1913) & [1892](https://github.com/Azure/sonic-utilities/pull/1892) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/Dump-Utility.md) and below mentioned PR's for more details. +
    **Pull Requests** : [789](https://github.com/sonic-net/SONiC/pull/789), [1666](https://github.com/sonic-net/sonic-utilities/pull/1666), [1667](https://github.com/sonic-net/sonic-utilities/pull/1667), [1668](https://github.com/sonic-net/sonic-utilities/pull/1668), [1669](https://github.com/sonic-net/sonic-utilities/pull/1669), [1670](https://github.com/sonic-net/sonic-utilities/pull/1670), [1853](https://github.com/sonic-net/sonic-utilities/pull/1853), [1877](https://github.com/sonic-net/sonic-utilities/pull/1877), [1913](https://github.com/sonic-net/sonic-utilities/pull/1913) & [1892](https://github.com/sonic-net/sonic-utilities/pull/1892) #### Overlay ECMP This feature provides Vxlan Overlay ECMP feature implementation in SONiC with BFD support. This is an extension to the existing VNET Vxlan support as defined in the Vxlan HLD. -Refer [HLD document](https://github.com/Azure/SONiC/blob/b9f1e94235553c825de67d244c9e8836f369b965/doc/vxlan/Overlay%20ECMP%20with%20BFD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [861](https://github.com/Azure/SONiC/pull/861), [1960](https://github.com/Azure/sonic-swss/pull/1960), [9197](https://github.com/Azure/sonic-uildimage/pull/9197), [96](https://github.com/Azure/sonic-restapi/pull/96), [1955](https://github.com/Azure/sonic-swss/pull/1955)[903](https://github.com/Azure/sonic-sairedis/pull/903), [1883](https://github.com/Azure/sonic-swss/pull/1883) & [1942](https://github.com/Azure/sonic-utilities/pull/1942) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/b9f1e94235553c825de67d244c9e8836f369b965/doc/vxlan/Overlay%20ECMP%20with%20BFD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [861](https://github.com/sonic-net/SONiC/pull/861), [1960](https://github.com/sonic-net/sonic-swss/pull/1960), [9197](https://github.com/sonic-net/sonic-uildimage/pull/9197), [96](https://github.com/sonic-net/sonic-restapi/pull/96), [1955](https://github.com/sonic-net/sonic-swss/pull/1955)[903](https://github.com/sonic-net/sonic-sairedis/pull/903), [1883](https://github.com/sonic-net/sonic-swss/pull/1883) & [1942](https://github.com/sonic-net/sonic-utilities/pull/1942) #### PDK - Platform Development Environment SONiC OS is portable across different network devices with supported ASIC via Switch Abstraction Interface (SAI). These devices primarily differ in the way various device specific hardware components are accessed, and thus require custom device drivers and python plugins. Each platform vendor implements these custom device drivers and plugins. The feature requirement is to support a SONiC platform driver development framework to enable rapid development of custom device drivers and plugins. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/platform/brcm_pdk_pddf.md) and below mentioned PR's for more details. -
    **Pull Requests** : [3387](https://github.com/Azure/sonic-buildimage/pull/3387), [624](https://github.com/Azure/sonic-utilities/pull/624), [62](https://github.com/Azure/sonic-platform-common/pull/62) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/platform/brcm_pdk_pddf.md) and below mentioned PR's for more details. +
    **Pull Requests** : [3387](https://github.com/sonic-net/sonic-buildimage/pull/3387), [624](https://github.com/sonic-net/sonic-utilities/pull/624), [62](https://github.com/sonic-net/sonic-platform-common/pull/62) #### PINS (P4 Integrated Network Stack) This feature describes PINS (P4 Integrated Network Stack), a P4RT based SDN interface for SONiC. P4RT for SONiC is opt-in, has familiar interfaces, enables rapid innovation, provides automated validation, and serves as unambiguous documentation. A canonical family of P4 programs documents the packet forwarding pipeline of SAI. Remote SDN controllers will use these P4 programs to control the switch forwarding behavior over the P4RT API. Refer [HLD document](https://github.com/pins/SONiC/blob/pins-hld/doc/pins/pins_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [841](https://github.com/Azure/SONiC/issues/841), [809](https://github.com/Azure/SONiC/pull/809), [826](https://github.com/Azure/SONiC/pull/826), [825](https://github.com/Azure/SONiC/pull/825), [840](https://github.com/Azure/SONiC/pull/840), [852](https://github.com/Azure/SONiC/pull/852), [846](https://github.com/Azure/SONiC/pull/846), [850](https://github.com/Azure/SONiC/pull/850) & [836](https://github.com/Azure/SONiC/pull/836) +
    **Pull Requests** : [841](https://github.com/sonic-net/SONiC/issues/841), [809](https://github.com/sonic-net/SONiC/pull/809), [826](https://github.com/sonic-net/SONiC/pull/826), [825](https://github.com/sonic-net/SONiC/pull/825), [840](https://github.com/sonic-net/SONiC/pull/840), [852](https://github.com/sonic-net/SONiC/pull/852), [846](https://github.com/sonic-net/SONiC/pull/846), [850](https://github.com/sonic-net/SONiC/pull/850) & [836](https://github.com/sonic-net/SONiC/pull/836) #### Reclaim reserved buffer for unused ports Originally, the reserved buffer is reclaimed by removing buffer objects of the unused ports. However, this introduces inconsistency. To resolve this zero buffer profiles are introduced to indicate 0 reserved size of a buffer object. Removing a buffer object indicates setting the buffer object to SDK default value. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/qos/reclaim-reserved-buffer-images/reclaim-reserved-buffer-sequence-flow.md) and below mentioned PR's for more details. -
    **Pull Requests** : [831](https://github.com/Azure/SONiC/pull/831) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/qos/reclaim-reserved-buffer-images/reclaim-reserved-buffer-sequence-flow.md) and below mentioned PR's for more details. +
    **Pull Requests** : [831](https://github.com/sonic-net/SONiC/pull/831) #### Routed sub-interface naming convention A sub port interface is a logical interface that can be created on a physical port or a port channel. A sub port interface serves as an interface to either a .1D bridge or a VRF, but not both. This feature design focuses on the use case of creating a sub port interface on a physical port or a port channel and using it as a router interface to a VRF. -Refer [HLD document](https://github.com/Azure/SONiC/blob/d1b715a9cc762eff084d953581633e2a94115bac/doc/subport/sonic-sub-port-intf-hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [833](https://github.com/Azure/SONiC/pull/833), [2017](https://github.com/Azure/sonic-swss/pull/2017), [1907](https://github.com/Azure/sonic-swss/pull/1907), [8761](https://github.com/Azure/sonic-buildimage/pull/8761) & [1821](https://github.com/Azure/sonic-utilities/pull/1821) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/d1b715a9cc762eff084d953581633e2a94115bac/doc/subport/sonic-sub-port-intf-hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [833](https://github.com/sonic-net/SONiC/pull/833), [2017](https://github.com/sonic-net/sonic-swss/pull/2017), [1907](https://github.com/sonic-net/sonic-swss/pull/1907), [8761](https://github.com/sonic-net/sonic-buildimage/pull/8761) & [1821](https://github.com/sonic-net/sonic-utilities/pull/1821) #### SONiC for MPLS Dataplane This implementation is about the initial support for MPLS in SONiC infrastructure. The focus of this initial MPLS support is to expand existing SONiC infrastructure for IPv4/IPv6 routing to include equivalent MPLS functionality. The expected use case for this initial MPLS support is static LSP routing. -Refer [HLD document](https://github.com/Azure/SONiC/blob/dc4a7ae5be75e8e376f9e95692e678aee0fb5dac/doc/mpls/MPLS_hld.md) and below mentioned PR's for more details. -
    **Pull Requests** : [706](https://github.com/Azure/SONiC/pull/706), [1181](https://github.com/opencomputeproject/SAI/pull/1181), [815](https://github.com/Azure/sonic-sairedis/pull/815), [824](https://github.com/Azure/sonic-sairedis/pull/824), [469](https://github.com/Azure/sonic-swss-common/pull/469), [7195](https://github.com/Azure/sonic-buildimage/pull/7195), [1686](https://github.com/Azure/sonic-swss/pull/1686), [1537](https://github.com/Azure/sonic-utilities/pull/1537), [1871](https://github.com/Azure/sonic-swss/pull/1871), [7881](https://github.com/Azure/sonic-buildimage/pull/7881) & [3483](https://github.com/Azure/sonic-mgmt/pull/3483) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/dc4a7ae5be75e8e376f9e95692e678aee0fb5dac/doc/mpls/MPLS_hld.md) and below mentioned PR's for more details. +
    **Pull Requests** : [706](https://github.com/sonic-net/SONiC/pull/706), [1181](https://github.com/opencomputeproject/SAI/pull/1181), [815](https://github.com/sonic-net/sonic-sairedis/pull/815), [824](https://github.com/sonic-net/sonic-sairedis/pull/824), [469](https://github.com/sonic-net/sonic-swss-common/pull/469), [7195](https://github.com/sonic-net/sonic-buildimage/pull/7195), [1686](https://github.com/sonic-net/sonic-swss/pull/1686), [1537](https://github.com/sonic-net/sonic-utilities/pull/1537), [1871](https://github.com/sonic-net/sonic-swss/pull/1871), [7881](https://github.com/sonic-net/sonic-buildimage/pull/7881) & [3483](https://github.com/sonic-net/sonic-mgmt/pull/3483) #### SONiC Generic Update and Rollback The SONiC Generic Update and Rollback feature is to standardize the way to do partial updates, to take checkpoints and finally to rollback the configurations for SONiC. Refer [HLD document](https://github.com/ghooo/SONiC/blob/c1f3f3b5427d0cafb3defd93df8b906a26fcee8a/doc/config-generic-update-rollback/SONiC_Generic_Config_Update_and_Rollback_Design.md) and below mentioned PR's for more details. -
    **Pull Requests** : [736](https://github.com/Azure/SONiC/pull/736), [1536](https://github.com/Azure/sonic-utilities/pull/1536), [1599](https://github.com/Azure/sonic-utilities/pull/1599), [1762](https://github.com/Azure/sonic-utilities/pull/1762), [1794](https://github.com/Azure/sonic-utilities/pull/1794), [1831](https://github.com/Azure/sonic-utilities/pull/1831), [1856](https://github.com/Azure/sonic-utilities/pull/1856), [1864](https://github.com/Azure/sonic-utilities/pull/1864), [1885](https://github.com/Azure/sonic-utilities/pull/1885), [1901](https://github.com/Azure/sonic-utilities/pull/1901), [1919](https://github.com/Azure/sonic-utilities/pull/1919), [1923](https://github.com/Azure/sonic-utilities/pull/1923), [1929](https://github.com/Azure/sonic-utilities/pull/1929), [1934](https://github.com/Azure/sonic-utilities/pull/1934), [1969](https://github.com/Azure/sonic-utilities/pull/1969), [1973](https://github.com/Azure/sonic-utilities/pull/1973), [1977](https://github.com/Azure/sonic-utilities/pull/1977), [1981](https://github.com/Azure/sonic-utilities/pll/1981), [1983](https://github.com/Azure/sonic-utilities/pull/1983), [1987](https://github.com/Azure/sonic-utilities/pull/1987), [1988](https://github.com/Azure/sonic-utilities/pull/1988), [2003](https://github.com/Azure/sonic-utilities/pull/2003), [2006](https://github.com/Azure/sonic-utilities/pull/2006), [2008](https://github.com/Azure/sonic-utilities/pull/2008), [2015](https://github.com/Azure/sonic-utilities/pull/2015), [2020](https://github.com/Azure/sonic-utilities/pull/2020) & [2028](https://github.com/Azure/sonic-utilities/pull/2028) +
    **Pull Requests** : [736](https://github.com/sonic-net/SONiC/pull/736), [1536](https://github.com/sonic-net/sonic-utilities/pull/1536), [1599](https://github.com/sonic-net/sonic-utilities/pull/1599), [1762](https://github.com/sonic-net/sonic-utilities/pull/1762), [1794](https://github.com/sonic-net/sonic-utilities/pull/1794), [1831](https://github.com/sonic-net/sonic-utilities/pull/1831), [1856](https://github.com/sonic-net/sonic-utilities/pull/1856), [1864](https://github.com/sonic-net/sonic-utilities/pull/1864), [1885](https://github.com/sonic-net/sonic-utilities/pull/1885), [1901](https://github.com/sonic-net/sonic-utilities/pull/1901), [1919](https://github.com/sonic-net/sonic-utilities/pull/1919), [1923](https://github.com/sonic-net/sonic-utilities/pull/1923), [1929](https://github.com/sonic-net/sonic-utilities/pull/1929), [1934](https://github.com/sonic-net/sonic-utilities/pull/1934), [1969](https://github.com/sonic-net/sonic-utilities/pull/1969), [1973](https://github.com/sonic-net/sonic-utilities/pull/1973), [1977](https://github.com/sonic-net/sonic-utilities/pull/1977), [1981](https://github.com/sonic-net/sonic-utilities/pll/1981), [1983](https://github.com/sonic-net/sonic-utilities/pull/1983), [1987](https://github.com/sonic-net/sonic-utilities/pull/1987), [1988](https://github.com/sonic-net/sonic-utilities/pull/1988), [2003](https://github.com/sonic-net/sonic-utilities/pull/2003), [2006](https://github.com/sonic-net/sonic-utilities/pull/2006), [2008](https://github.com/sonic-net/sonic-utilities/pull/2008), [2015](https://github.com/sonic-net/sonic-utilities/pull/2015), [2020](https://github.com/sonic-net/sonic-utilities/pull/2020) & [2028](https://github.com/sonic-net/sonic-utilities/pull/2028) #### SRv6 support (Cntd) SRv6 has been widely adopted as an IPv6 based SDN solution, which provides programming ability, TE capabilities, and deployment simplicity to network administrators. With current support from a rich ecosystem, including major ASIC manufactures, networking vendors and open source communities, the deployment of SRv6 is accelerating. This implentation adds SRv6 into SONIC to benefit users in DC as well as beyond DC. -Refer [HLD document](https://github.com/Azure/SONiC/blob/faa432df6185f7c04d896285db61ac86300161c9/doc/srv6/srv6-hld-v19.md) and below mentioned PR's for more details. -
    **Pull Requests** : [795](https://github.com/Azure/SONiC/pull/795), [9238](https://github.com/Azure/sonic-buildimage/pull/9238), [538](https://github.com/Azure/sonic-swss-common/pull/538), [1964](https://github.com/Azure/sonic-swss/pull/1964) & [1883](https://github.com/Azure/sonic-utilities/pull/1883) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/faa432df6185f7c04d896285db61ac86300161c9/doc/srv6/srv6-hld-v19.md) and below mentioned PR's for more details. +
    **Pull Requests** : [795](https://github.com/sonic-net/SONiC/pull/795), [9238](https://github.com/sonic-net/sonic-buildimage/pull/9238), [538](https://github.com/sonic-net/sonic-swss-common/pull/538), [1964](https://github.com/sonic-net/sonic-swss/pull/1964) & [1883](https://github.com/sonic-net/sonic-utilities/pull/1883) #### Upgrade SONiC init flow This implentation is to introduce a new API for query statistics capabilities of counters in a faster and more efficient way. Currently on SONiC, in order to get the counters capabilities, SONiC is iterating all port stats one by one, to understand the supported capabilities. This operation is time consuming and the new API can reduce the time for this operation in one call. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/Query_Stats_Capability/Query_Stats_Capability_HLD.md) and below mentioned PR's for more details. -
    **Pull Requests** : [871](https://github.com/Azure/SONiC/pull/871) & [952](https://github.com/Azure/sonic-sairedis/pull/952) +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/Query_Stats_Capability/Query_Stats_Capability_HLD.md) and below mentioned PR's for more details. +
    **Pull Requests** : [871](https://github.com/sonic-net/SONiC/pull/871) & [952](https://github.com/sonic-net/sonic-sairedis/pull/952) # SAI APIs diff --git a/doc/Sonic BSL Test plan.md b/doc/Sonic BSL Test plan.md index 8c10a3854f..b8910c8f9a 100644 --- a/doc/Sonic BSL Test plan.md +++ b/doc/Sonic BSL Test plan.md @@ -2,7 +2,7 @@ ## Overview -This document outlines the Sonic BSL test plan. In BSL mode, Sonic device is brought up as an L2 switch. This test plan validates the functionality by running the tests as described in below sections. More details on BSL can be found in this [document](https://github.com/Azure/SONiC/wiki/L2-Switch-mode#3-generate-a-configuration-for-l2-switch-mode). This must be followed to configure a Sonic device in L2 switch and verify the associated commands before running the below test cases. +This document outlines the Sonic BSL test plan. In BSL mode, Sonic device is brought up as an L2 switch. This test plan validates the functionality by running the tests as described in below sections. More details on BSL can be found in this [document](https://github.com/sonic-net/SONiC/wiki/L2-Switch-mode#3-generate-a-configuration-for-l2-switch-mode). This must be followed to configure a Sonic device in L2 switch and verify the associated commands before running the below test cases. ### Scope --------- @@ -18,7 +18,7 @@ L2 configuration on a T0 topology ### Configuration scripts ------------------------- -Configuration is created from https://github.com/Azure/SONiC/wiki/L2-Switch-mode#3-generate-a-configuration-for-l2-switch-mode. After applying configuration, this also has basic verifications of interfaces and oper status. +Configuration is created from https://github.com/sonic-net/SONiC/wiki/L2-Switch-mode#3-generate-a-configuration-for-l2-switch-mode. After applying configuration, this also has basic verifications of interfaces and oper status. The following is an example script to create config file for Mellanox platform ``` @@ -38,7 +38,7 @@ Verify basic sanity. This checks if the orchagent and syncd processes are runnin Triggered before and after each test case #### Test description -Run sanity check - https://github.com/Azure/sonic-mgmt/blob/master/tests/common/sanity_check.py +Run sanity check - https://github.com/sonic-net/sonic-mgmt/blob/master/tests/common/sanity_check.py ### Test case \#2 @@ -46,7 +46,7 @@ Run sanity check - https://github.com/Azure/sonic-mgmt/blob/master/tests/common/ Verify FDB learning happens on all ports. #### Test description -Run fdb test - https://github.com/Azure/sonic-mgmt/blob/master/tests/fdb/test_fdb.py +Run fdb test - https://github.com/sonic-net/sonic-mgmt/blob/master/tests/fdb/test_fdb.py ### Test case \#3 @@ -56,14 +56,14 @@ Verify Vlan configurations, ARP and PING. The current vlan test (vlantb) has two This test covers Vlan, ARP and PING tests. #### Test description -Run fdb test - https://github.com/Azure/sonic-mgmt/blob/master/tests/vlan/test_vlan.py +Run fdb test - https://github.com/sonic-net/sonic-mgmt/blob/master/tests/vlan/test_vlan.py ### Test case \#4 #### Test objective -Verify SNMP. This [document](https://github.com/Azure/SONiC/wiki/How-to-Check-SNMP-Configuration) can be referred for basic SNMP verification and configuring public community string +Verify SNMP. This [document](https://github.com/sonic-net/SONiC/wiki/How-to-Check-SNMP-Configuration) can be referred for basic SNMP verification and configuring public community string The BSL test can cover to get 1. MAC table @@ -73,9 +73,9 @@ Verify SNMP. This [document](https://github.com/Azure/SONiC/wiki/How-to-Check-SN #### Test description Run SNMP tests: - - https://github.com/Azure/sonic-mgmt/tree/master/tests/snmp/test_snmp_interfaces.py - - https://github.com/Azure/sonic-mgmt/tree/master/tests/snmp/test_snmp_cpu.py - - https://github.com/Azure/sonic-mgmt/tree/master/tests/snmp/test_snmp_psu.py + - https://github.com/sonic-net/sonic-mgmt/tree/master/tests/snmp/test_snmp_interfaces.py + - https://github.com/sonic-net/sonic-mgmt/tree/master/tests/snmp/test_snmp_cpu.py + - https://github.com/sonic-net/sonic-mgmt/tree/master/tests/snmp/test_snmp_psu.py | **\#** | **Test Description** | **Expected Result** | |--------|----------------------|---------------------| diff --git a/doc/aaa/TACACS+ Design.md b/doc/aaa/TACACS+ Design.md index 6d4cbabf52..6ab382b048 100644 --- a/doc/aaa/TACACS+ Design.md +++ b/doc/aaa/TACACS+ Design.md @@ -307,7 +307,7 @@ The following figure show how Auditd config an TACACS+ config update by ConfigDB ## 4.3 ConfigDB Schema - - Existing tables, for more detail please check [TACACS+ Authentication](https://github.com/Azure/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md#aaa-table-schema) + - Existing tables, for more detail please check [TACACS+ Authentication](https://github.com/sonic-net/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md#aaa-table-schema) - TACPLUS Table - TACPLUS_SERVER Table. - AAA Table (updated). @@ -319,7 +319,7 @@ login = LIST(1*32VCHAR) ; AAA protocol, now only support (local fallback = "True" / "False" ; fallback mechanism for pam modules failthrough = "True" / "False" ; failthrough mechanism for pam modules ``` -* According to [TACACS+ Authentication](https://github.com/Azure/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md#aaa-table-schema), the 'login' attribute should be 'protocol' attribute , But in current SONiC [yang model](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-system-aaa.yang), this attribute name is 'login'. Because change the attribute name may break backward compatibility, so keep will use 'login' as attribute name. +* According to [TACACS+ Authentication](https://github.com/sonic-net/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md#aaa-table-schema), the 'login' attribute should be 'protocol' attribute , But in current SONiC [yang model](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-system-aaa.yang), this attribute name is 'login'. Because change the attribute name may break backward compatibility, so keep will use 'login' as attribute name. ## 4.4 CLI - The existing TACACS+ server config command will not change. @@ -547,7 +547,7 @@ Schema in [TACACS+ Authentication](#TACPLUS-Authentication)). ## RFC8907 https://datatracker.ietf.org/doc/html/rfc8907 ## TACACS+ Authentication -https://github.com/Azure/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md +https://github.com/sonic-net/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md ## Bash https://www.gnu.org/software/bash/html ## pam_tacplus diff --git a/doc/aaa/TACACS+ Test Plan.md b/doc/aaa/TACACS+ Test Plan.md index 25c311fac3..a2b3ea0f4b 100644 --- a/doc/aaa/TACACS+ Test Plan.md +++ b/doc/aaa/TACACS+ Test Plan.md @@ -4,7 +4,7 @@ Related documents | **Document Name** | **Link** | |-------------------|----------| -| AAA_with_SONiC_v2 | [https://github.com/Azure/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx](https://github.com/Azure/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx) | +| AAA_with_SONiC_v2 | [https://github.com/sonic-net/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx) | | pam_tacplus | [https://github.com/jeroennijhof/pam_tacplus/blob/master/README.md](https://github.com/jeroennijhof/pam_tacplus/blob/master/README.md) | | tacacs+ daemon | [http://manpages.ubuntu.com/manpages/xenial/man8/tac_plus.8.html](http://manpages.ubuntu.com/manpages/xenial/man8/tac_plus.8.html) | diff --git a/doc/aaa/radius_authentication.md b/doc/aaa/radius_authentication.md index 20ed646603..02970a0d0b 100644 --- a/doc/aaa/radius_authentication.md +++ b/doc/aaa/radius_authentication.md @@ -857,7 +857,7 @@ http://man7.org/linux/man-pages/man5/nsswitch.conf.5.html ## TACPLUS Authentication -https://github.com/Azure/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md +https://github.com/sonic-net/SONiC/blob/master/doc/aaa/TACACS%2B%20Authentication.md ## pam_radius diff --git a/doc/acl/ACL-High-Level-Design.md b/doc/acl/ACL-High-Level-Design.md index 74ff25c25e..8c1afa22f5 100644 --- a/doc/acl/ACL-High-Level-Design.md +++ b/doc/acl/ACL-High-Level-Design.md @@ -548,18 +548,18 @@ for egress ACL rule. Add possibility to receive updates about mirror sessions state change and perform mirroring rules state change accordingly. # 4 Flows ## 4.1 Creating of ACL Objects -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/acl_create.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/acl_create.png) ## 4.2 Deleting of ACL Objects -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/acl_delete.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/acl_delete.png) ## 4.3 Updating of ACL Objects Depending on the number of changed properties in the updated ACL object, update may include one or more extra delete/create calls to the SAI Redis. -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/acl_update.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/acl_update.png) ## 4.4 Creating of ACL Mirror rules -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/acl_mirror_rule_flow.svg) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/acl_mirror_rule_flow.svg) ## 4.5 Deleting of ACL Mirror rules -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/mirror_delete.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/mirror_delete.png) ## 4.6 Mirror state change handling -![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/mirror_state_change.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/mirror_state_change.png) # 5 swssconfig input file format and restrictions - Valid json file. The file should be in the format swssconfig can process. This assumes lists surrounded by square brackets, dictionaries with curly brackets (braces), tuples inside dictionary separated with semicolon and enumerated elements separated with the comma. - Logical consistency. The configuration provided should be complete. Rules should not refer non-existing tables, etc. diff --git a/doc/acl/ACL-Ingress-Egress-test-plan.md b/doc/acl/ACL-Ingress-Egress-test-plan.md index de0009c4db..903679ad28 100644 --- a/doc/acl/ACL-Ingress-Egress-test-plan.md +++ b/doc/acl/ACL-Ingress-Egress-test-plan.md @@ -14,7 +14,7 @@ ## The existing test plan and scripts -The existing test plan: https://github.com/Azure/SONiC/wiki/ACL-test-plan +The existing test plan: https://github.com/sonic-net/SONiC/wiki/ACL-test-plan The existing acl test scripts covered ingress ACL on SONiC switch. Supported topo: t1, t1-lag, t1-64-lag diff --git a/doc/acl/Everflow-test-plan.md b/doc/acl/Everflow-test-plan.md index b465acea69..76d0a064a3 100644 --- a/doc/acl/Everflow-test-plan.md +++ b/doc/acl/Everflow-test-plan.md @@ -52,7 +52,7 @@ ## Overview -This document is an updated version of the existing everflow test plan: https://github.com/Azure/SONiC/wiki/Everflow-test-plan +This document is an updated version of the existing everflow test plan: https://github.com/sonic-net/SONiC/wiki/Everflow-test-plan The purpose is to test functionality of Everflow on the SONIC switch DUT with and without LAGs configured, closely resembling production environment. The test assumes all necessary configuration, including Everflow session and ACL rules, LAG configuration and BGP routes, are already pre-configured on the SONIC switch before test runs. @@ -277,10 +277,10 @@ Existing test cases: #### What new enhancements need to be covered? ##### Egress ACL table -In Jan 2019, egress ACL table support is added (https://github.com/Azure/SONiC/pull/322, https://github.com/Azure/sonic-swss/pull/741) to SONiC. Then ACL table can have an extra field `stage` indicting on which stage will the ACL rules be checked against packets. If the `stage` is ignored or is set to 'ingress', the behavior is same as before, ingress packets will be checked against ACL rules. If the `stage` field is set to 'egress', then on ports bound to ACL table, egress packets will be checked against the ACL rules and will be handled according to the action configured for the ACL rules. The action could be `PACKET_ACTION` or `MIRROR_ACTION`. +In Jan 2019, egress ACL table support is added (https://github.com/sonic-net/SONiC/pull/322, https://github.com/sonic-net/sonic-swss/pull/741) to SONiC. Then ACL table can have an extra field `stage` indicting on which stage will the ACL rules be checked against packets. If the `stage` is ignored or is set to 'ingress', the behavior is same as before, ingress packets will be checked against ACL rules. If the `stage` field is set to 'egress', then on ports bound to ACL table, egress packets will be checked against the ACL rules and will be handled according to the action configured for the ACL rules. The action could be `PACKET_ACTION` or `MIRROR_ACTION`. ##### Egress mirroring -Besides the egress ACL table support, a recent enhancement (Design: https://github.com/Azure/SONiC/pull/411 Implementations: https://github.com/Azure/sonic-swss/pull/963 https://github.com/Azure/sonic-utilities/pull/575) added egress mirroring support. This enhancement added two ACL rule action types based on the existing mirroring action `MIRROR_ACTION`: +Besides the egress ACL table support, a recent enhancement (Design: https://github.com/sonic-net/SONiC/pull/411 Implementations: https://github.com/sonic-net/sonic-swss/pull/963 https://github.com/sonic-net/sonic-utilities/pull/575) added egress mirroring support. This enhancement added two ACL rule action types based on the existing mirroring action `MIRROR_ACTION`: * MIRROR_INGRESS_ACTION * MIRROR_EGRESS_ACTION diff --git a/doc/acl/egress-acl-bug-fix-description.md b/doc/acl/egress-acl-bug-fix-description.md index 667111de12..2d9e415d38 100644 --- a/doc/acl/egress-acl-bug-fix-description.md +++ b/doc/acl/egress-acl-bug-fix-description.md @@ -68,7 +68,7 @@ To have both mirror action supported, we need to extend AclRuleMirror and the cr - flow chart after add the new flow - ![](https://github.com/Azure/SONiC/blob/master/images/acl_hld/acl_mirror_rule_flow.svg) + ![](https://github.com/sonic-net/SONiC/blob/master/images/acl_hld/acl_mirror_rule_flow.svg) ### 3. New SWSS virtual test Added to cover the egress ACL support diff --git a/doc/arp/Proxy Arp.md b/doc/arp/Proxy Arp.md index 5ea3f6c40b..6b9e9dc0f0 100644 --- a/doc/arp/Proxy Arp.md +++ b/doc/arp/Proxy Arp.md @@ -57,14 +57,14 @@ The following flow diagram captures two example, one for user configuration and ## Kernel config -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/proxy_arp_kernel.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/proxy_arp_kernel.png) ## SAI config For requirement #2, the proposal is to disable flooding for the specific Vlan so that ARP packets shall not get flooded in hardware. By default in Sonic, it is a copy action for ARP packets which means, packets gets flooded in hardware. In the event of enabling proxy-arp, flooding must be disabled. This enables the switch to respond to ARP requests within this subnet to be responded with its SVI mac. ```Intforch``` must invoke "Vlan flood" disable during the RIF creation based on "prxoy_arp" attribute. -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/proxy_arp_flood.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/proxy_arp_flood.png) # Additional Notes 1. The flooding is disabled only for those interfaces that has proxy_arp setting. The implementation shall not modify the existing behavior and shall be backward compatible. diff --git a/doc/asic_thermal_monitoring_hld.md b/doc/asic_thermal_monitoring_hld.md index cd7be570a9..57a4af17f1 100644 --- a/doc/asic_thermal_monitoring_hld.md +++ b/doc/asic_thermal_monitoring_hld.md @@ -43,7 +43,7 @@ A configurable ASIC sensors poller is introduced that periodically retrieves the * There should be a way to enable/disable the poller * The polling interval should be configurable (from 5 to 300 secs) 2. The retrieved values should be written to the STATE DB (of each ASIC's DB instance in a multi ASIC platform). -3. The ASIC internal sensor values retrieved should be useable by the Thermal Control infrastructure (https://github.com/Azure/SONiC/blob/master/thermal-control-design.md). +3. The ASIC internal sensor values retrieved should be useable by the Thermal Control infrastructure (https://github.com/sonic-net/SONiC/blob/master/thermal-control-design.md). ### 5.2 CLI requirements @@ -103,7 +103,7 @@ In the timer callback, the following actions are performed: ### 6.3 Platform changes to support ASIC Thermals -Platform owners typically provide the implementation for Thermals (https://github.com/Azure/sonic-platform-common/blob/master/sonic_platform_base/thermal_base.py). While there is no change in existing Platform API definitions, apart from external/CPU sensors, platform vendors should also include ASIC internal sensors in the _thermal_list[] of the Chassis / Module implementations. +Platform owners typically provide the implementation for Thermals (https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/thermal_base.py). While there is no change in existing Platform API definitions, apart from external/CPU sensors, platform vendors should also include ASIC internal sensors in the _thermal_list[] of the Chassis / Module implementations. Assuming a Multi ASIC Chassis with 3 ASICs, the thermal names could be: ASIC0 Internal 0, ... ASIC0 Internal N0, ASIC1 Internal 0, ... ASIC1 Internal N1, ASIC2 Internal 0, ... ASIC2 Internal N2 diff --git a/doc/auto_techsupport_and_coredump_mgmt.md b/doc/auto_techsupport_and_coredump_mgmt.md index 2341abbd95..9adf58a7b8 100644 --- a/doc/auto_techsupport_and_coredump_mgmt.md +++ b/doc/auto_techsupport_and_coredump_mgmt.md @@ -168,7 +168,7 @@ module sonic-auto_techsupport { yang-version 1.1; - namespace "http://github.com/Azure/sonic-auto_techsupport"; + namespace "http://github.com/sonic-net/sonic-auto_techsupport"; prefix auto_techsupport; import sonic-types { @@ -482,7 +482,7 @@ The configuration in the init_cfg.json is loaded to the running config i.e. CONF ### 10 App Extension Considerations -Detailed Info related to Appliation Extension can be found here: https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extension/sonic-application-extention-hld.md +Detailed Info related to Appliation Extension can be found here: https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extension/sonic-application-extention-hld.md A new AUTO_TECHSUPPORT_FEATURE register/deregister option will be introduced. The existing FeatureRegistry class will be enahcned to also add/delete configuration related to AUTO_TECHSUPPORT_FEATURE table. diff --git a/doc/barefoot_dtel/Dtel-SONiC.md b/doc/barefoot_dtel/Dtel-SONiC.md index eab7b900b8..faa16ecb95 100644 --- a/doc/barefoot_dtel/Dtel-SONiC.md +++ b/doc/barefoot_dtel/Dtel-SONiC.md @@ -372,7 +372,7 @@ Following is the minimum configuration for each DTel feature to detect intended 1. Reporting enabled on at least one queue with some threshold (latency or depth) set or tail drop enabled. ## Application to configure DTel via SONiC -Since currently there is no SONiC CLI, users can configure DTel by interacting with ConfigDB. This can be done either directly, through the Redis CLI, or through the use of configuration tools, such as the [Python SwSS SDK](https://github.com/Azure/sonic-py-swsssdk). +Since currently there is no SONiC CLI, users can configure DTel by interacting with ConfigDB. This can be done either directly, through the Redis CLI, or through the use of configuration tools, such as the [Python SwSS SDK](https://github.com/sonic-net/sonic-py-swsssdk). ## euclid diff --git a/doc/bfd/BFD HW Offload HLD.md b/doc/bfd/BFD HW Offload HLD.md index 4c109cf9c0..29fb4a1484 100644 --- a/doc/bfd/BFD HW Offload HLD.md +++ b/doc/bfd/BFD HW Offload HLD.md @@ -104,7 +104,7 @@ BFD_SESSION:{{vrf}}:{{ifname}}:{{ipaddr}} An example state transition diagram is as below -![](https://github.com/Azure/SONiC/blob/master/images/bfd/BFD_States.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/bfd/BFD_States.png) ## 2.4 Orchestration Agent @@ -113,7 +113,7 @@ Following orchagents shall be introduced/modified. ### BfdOrch Sonic shall offload the BFD session handling to hardware that has BFD capabilities. A new module, BfdOrch shall be introduced to handle BFD session to monitoring endpoints and check the health of remote endpoints. BfdOrch shall offload the session initiation/sustenance to hardware via SAI APIs and gets the notifications of session state from SAI. The session state shall be updated in STATE_DB and to any other observer orchestration agents. -![](https://github.com/Azure/SONiC/blob/master/images/bfd/BFD_FlowDiagram.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/bfd/BFD_FlowDiagram.png) #### SAI Attributes @@ -135,7 +135,7 @@ In the multihop session, for bfd packet forwarding, this design expects that the The flow of BfdOrch is presented in the following figure. BfdOrch subscribes to the BFD_SESSION_TABLE of APPL_DB and send the corresponding request to program the BFD sessions to syncd accordingly. The BfdOrch also creates the STATE_DB entry of the BFD session which includes the BFD parameters and an initial state. Upon receiving bfd session state change notifications from syncd, BfdOrch update the STATE_DB field to update the BFD session state. -![](https://github.com/Azure/SONiC/blob/master/images/bfd/BFD_Notification.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/bfd/BFD_Notification.png) ## 2.5 Control plane BFD diff --git a/doc/buffer-watermark/watermarks_HLD.md b/doc/buffer-watermark/watermarks_HLD.md index 0ce3993f46..c7600e27e8 100644 --- a/doc/buffer-watermark/watermarks_HLD.md +++ b/doc/buffer-watermark/watermarks_HLD.md @@ -67,7 +67,7 @@ This document describes the high level design of the watermark feature. ## 1.1 System Chart Following diagram describes a top level overview of the architecture: -![](https://github.com/Azure/SONiC/blob/master/images/watermark_HLD/SystemOverview.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/watermark_HLD/SystemOverview.png) ## 1.2 Modules description ### 1.2.1 gRPC @@ -102,7 +102,7 @@ Regular user is able to query the persistent watermark. Regular user is able to When one regular user and the streaming telemetry coexist, they do not interfere with each other. Their behaviors stay the same as described above. So the software should be able to handle the following situations and return the correct watermark values to each user: -![](https://github.com/Azure/SONiC/blob/master/images/watermark_HLD/timeline.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/watermark_HLD/timeline.png) t0 - clear user watermark event @@ -337,7 +337,7 @@ Examples of virtual paths: #### 4.1 Watermark general flow -![](https://github.com/Azure/SONiC/blob/master/images/watermark_HLD/WM_general.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/watermark_HLD/WM_general.png) The core components are the flex counter, watermark orch, DB, CLI. @@ -353,13 +353,13 @@ The Cli reads the watermarks from the tables, formats and outputs it. #### 4.2 Resetting the telemetry period flow -![](https://github.com/Azure/SONiC/blob/master/images/watermark_HLD/WM_period.PNG) +![](https://github.com/sonic-net/SONiC/blob/master/images/watermark_HLD/WM_period.PNG) The watermark orch handles notifications on changes in WATERMARK_TABLE in config DB. The new interval will be assigned to the timer during the timer handling, so the orch will reset the interval only when the current timer expires. #### 4.3 Cli flow -![](https://github.com/Azure/SONiC/blob/master/images/watermark_HLD/WM_cli.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/watermark_HLD/WM_cli.png) ### 5 Open questions diff --git a/doc/cbf/cbf_hld.md b/doc/cbf/cbf_hld.md index eed24e0a35..17e6c730ea 100644 --- a/doc/cbf/cbf_hld.md +++ b/doc/cbf/cbf_hld.md @@ -87,7 +87,7 @@ This design directly changes CONFIG_DB, APPL_DB, orchagent and sairedis. ## 3.2 DB Changes ### 3.2.1 APPL DB -Based on the next hop group split (https://github.com/Azure/SONiC/pull/712) on which this HLD is based on, a new CLASS_BASED_NEXT_HOP_GROUP table will be added to the APPL_DB with the following format: +Based on the next hop group split (https://github.com/sonic-net/SONiC/pull/712) on which this HLD is based on, a new CLASS_BASED_NEXT_HOP_GROUP table will be added to the APPL_DB with the following format: A new table is added to store the NHG maps. ``` @@ -203,7 +203,7 @@ For a new entry in CLASS_BASED_NEXT_HOP_GROUP_TABLE, the orchestration agent wil If the dataplane doesn't have any more room for a new next hop group object, the task will remain in the process queue for the event of space being freed. -There is a special scenario for creating the class based next hop groups, and that is when it references temporary next hop groups (as described in https://github.com/Azure/SONiC/pull/712), as these may be updated at some point which in turn will change their SAI ID. For this scenario, the class based next hop groups will keep a list of their temporary members and periodically check if it's SAI ID has been updated. If so, the SAI_NEXT_HOP_GROUP_MEMBER_ATTR_NEXT_HOP_ID attribute of the class based next hop group member will be updated to the match the new value and if the next hop group was updated to a proper (;-temporary) next hop group object, it will be erased from the specified list. When all the temporary next hop groups have been updated to proper next hop groups, the class based one will stop checking periodically for the updates. +There is a special scenario for creating the class based next hop groups, and that is when it references temporary next hop groups (as described in https://github.com/sonic-net/SONiC/pull/712), as these may be updated at some point which in turn will change their SAI ID. For this scenario, the class based next hop groups will keep a list of their temporary members and periodically check if it's SAI ID has been updated. If so, the SAI_NEXT_HOP_GROUP_MEMBER_ATTR_NEXT_HOP_ID attribute of the class based next hop group member will be updated to the match the new value and if the next hop group was updated to a proper (;-temporary) next hop group object, it will be erased from the specified list. When all the temporary next hop groups have been updated to proper next hop groups, the class based one will stop checking periodically for the updates. For an updated entry in CLASS_BASED_NEXT_HOP_GROUP_TABLE, the orchestration agent will remove the group's previous members and add the updated ones. We do this due to the limitation of the SAI_NEXT_HOP_GROUP_MEMBER_ATTR_INDEX attribute which is CREATE_ONLY and so can't be updated. Instead of accounting for all the possibilities for the index of a member to be updated (by moving it to a different position in the list, removing a member that comes before it or adding a new one before it) which would be exhaustive to handle, we prefer this simpler and more robust solution. The selection map will also be updated in ASIC_DB if necessary. diff --git a/doc/cli_auto_generation/cli_auto_generation.md b/doc/cli_auto_generation/cli_auto_generation.md index c30f98211a..0d2c6689ba 100644 --- a/doc/cli_auto_generation/cli_auto_generation.md +++ b/doc/cli_auto_generation/cli_auto_generation.md @@ -52,7 +52,7 @@ The SONiC CLI Auto-generation tool - is a utility for generating the command-lin To make SONiC NOS more flexible for developers [SONiC Application Extension infrastructure](https://github.com/stepanblyschak/SONiC/blob/sonic-app-ext-3/doc/sonic-application-extention/sonic-application-extention-hld.md) was introduced. -If someone wants to extend the SONiC NOS functionality - the SAE infrastructure should be used. Some of the third-party features that will be integrated into the SONiC - may require the command-line interface. To avoid spending time on the investigation of how to develop and add a new CLI to [sonic-utilities](https://github.com/Azure/sonic-utilities/tree/master) - the CLI Auto-generation utility was introduced. The command line interface that would be generated will be intuitive for people familiar with the SONiC NOS and CONFIG DB schema. +If someone wants to extend the SONiC NOS functionality - the SAE infrastructure should be used. Some of the third-party features that will be integrated into the SONiC - may require the command-line interface. To avoid spending time on the investigation of how to develop and add a new CLI to [sonic-utilities](https://github.com/sonic-net/sonic-utilities/tree/master) - the CLI Auto-generation utility was introduced. The command line interface that would be generated will be intuitive for people familiar with the SONiC NOS and CONFIG DB schema. ## Requirements @@ -70,7 +70,7 @@ A current SONiC NOS architecture does not require changes, because the SONiC CLI There are three main entities: -`YANG model` - YANG model file which contains a description of CONFIG DB schema. Should be written strictly according to [SONiC Yang Model Guidelines](https://github.com/Azure/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) +`YANG model` - YANG model file which contains a description of CONFIG DB schema. Should be written strictly according to [SONiC Yang Model Guidelines](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) `SONiC CLI Auto-generation tool` - a utility that reads the YANG model and produces the Auto-generated CLI plugin. @@ -227,7 +227,7 @@ admin@sonic:~$ config feature-a sub-command-1 add ... __2. For every `container`, that goes after `top-level container`, (top-level container goes after `module`) will be generated dedicated sub-command for `show` and `config` command groups AND in case if `container` is without `list`, for every `leaf` will be generated dedicated sub-command:__ -For instance let's take a PART of existing [sonic-device_metadata.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-device_metadata.yang) +For instance let's take a PART of existing [sonic-device_metadata.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-device_metadata.yang) ###### sonic-device_metadata YANG model ```yang @@ -296,7 +296,7 @@ ACS-MSN2100 UP r-sonic-switch x86_64-mlnx_msn2100-r0 ``` __3. For every `list` element will be generated `add/del/update` commands:__ -For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) +For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) ###### sonic-vlan YANG model ```yang @@ -383,7 +383,7 @@ Vlan11 11 128 up __In case if the YANG models have more than 1 `list` entity inside `container`:__ -For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) +For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) ###### YANG model with 2 lists ```yang @@ -422,7 +422,7 @@ admin@sonic:~$ config vlan-interface add ... __4. For every `leaf-list` element will be generated dedicated `add/del/update` commands, also the user can use a comma-separated list when creating a new list element to fill `leaf-list`. Also will be added dedicated command `clear` to delete all the elements from `leaf-list`:__ -For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) +For instance let's take a PART of existing [sonic-vlan.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) ###### sonic-vlan YANG model ```yang @@ -625,7 +625,7 @@ No impact for warmboot/fastboot flows. ## Restrictions Limitations -1. The YANG models for Application extension MUST have unique names for constructs - __module__, __container__, that are located on the same nested level in comparison to [existing YANG models](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-yang-models/yang-models). This needed to avoid an intersection with the existing CLI on the switch. The below [sonic-vlan.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) has a __module__ name - "sonic-vlan", so the developer can NOT use this "sonic-vlan" name for another module in another YANG mode. +1. The YANG models for Application extension MUST have unique names for constructs - __module__, __container__, that are located on the same nested level in comparison to [existing YANG models](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-yang-models/yang-models). This needed to avoid an intersection with the existing CLI on the switch. The below [sonic-vlan.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-vlan.yang) has a __module__ name - "sonic-vlan", so the developer can NOT use this "sonic-vlan" name for another module in another YANG mode. ```yang module sonic-vlan { diff --git a/doc/config-generic-update-rollback/Json_Change_Application_Design.md b/doc/config-generic-update-rollback/Json_Change_Application_Design.md index 9a247c0e82..f5a914a2ff 100644 --- a/doc/config-generic-update-rollback/Json_Change_Application_Design.md +++ b/doc/config-generic-update-rollback/Json_Change_Application_Design.md @@ -319,7 +319,7 @@ The 3 dots (`...`) in `ValidateService(services, validationCommand, ...)` indica ### 3.1.5 ConfigDB SONiC is managing configuration in a single source of truth - a redisDB instance that we refer as ConfigDB. Applications subscribe to ConfigDB and generate their running configuration correspondingly. -For further details on the ConfigDB, check [SONiC Configuration Database Manual](https://github.com/Azure/SONiC/wiki/Configuration). +For further details on the ConfigDB, check [SONiC Configuration Database Manual](https://github.com/sonic-net/SONiC/wiki/Configuration). ## 3.2 User Interface N/A diff --git a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md index 969863c107..926d06725d 100644 --- a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md +++ b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md @@ -76,7 +76,7 @@ This document describes the algorithm of patch ordering described in [SONiC Gene # 1 Feature Overview Please make sure you have reviewed SONiC Generic Configuration Update and Rollback design document especially [Patch Orderer](SONiC_Generic_Config_Update_and_Rollback_Design.md#3114-patch-orderer). -In this design document, we are going to explore using YANG models to order a given JsonPatch of updates. The idea is to make sure the transitions applied to the configurations all result in valid configs according to [SONiC YANG models](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-yang-models). +In this design document, we are going to explore using YANG models to order a given JsonPatch of updates. The idea is to make sure the transitions applied to the configurations all result in valid configs according to [SONiC YANG models](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-yang-models). YANG models has multiple constrains that can affect ordering (check [YANG 1.1 (RFC7950)](https://tools.ietf.org/html/rfc7950)): * leafref built-in type @@ -333,7 +333,7 @@ Next we recursively go up the tree, this includes at the level of `/ACL_RULE` ta - There can be other moves as the quality of the moves will determine if there is a path to get to the Target Config from the Current Config. ### 2.2.4 Validating config and move -- Validates result config after applying the move against [SONiC YANG models](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-yang-models). +- Validates result config after applying the move against [SONiC YANG models](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-yang-models). - Validates the operation itself - If we don't validate the operation, then we can always just replace the whole current_config with the whole target_config in one operation. This will always produce a valid result config. - Validating the operation makes sure it does not contain 2 changes that have dependency as JsonChange appliers do not take of ordering. @@ -383,13 +383,13 @@ SONiC YANG models are going to be used for the following: - Host flags/configs for move validation ### 3.1.1 Using YANG Models to Validate Config State -This is a straightforward task and can be done using [SONiC Libynag wrapper](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-mgmt/sonic_yang.py), specifically `validate_data_tree`. +This is a straightforward task and can be done using [SONiC Libynag wrapper](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-mgmt/sonic_yang.py), specifically `validate_data_tree`. ### 3.1.2 Using YANG models to Generate Other Moves Check [2.2.3 Generating all possible moves](#223-generating-all-possible-moves) to learn more about what are the possible moves. YANG models can help with: -- Lines getting removed which have references, can be substituted by deleting their references first as it is required anyway (check [2.2.3.3 Generating Other Moves](#2233-generating-other-moves) for details). Getting the dependency of some data can be done using [SONiC Libynag wrapper](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-mgmt/sonic_yang.py), specifically `find_data_dependencies`. +- Lines getting removed which have references, can be substituted by deleting their references first as it is required anyway (check [2.2.3.3 Generating Other Moves](#2233-generating-other-moves) for details). Getting the dependency of some data can be done using [SONiC Libynag wrapper](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-mgmt/sonic_yang.py), specifically `find_data_dependencies`. - Any other moves should be generated using YANG models, if YANG models data are not enough an extension to YANG models can be added to help with generating new moves. ### 3.1.3 Using YANG models to Host Flags for Move Validation @@ -405,7 +405,7 @@ Some fields are not allowed to be modified and can only be created, such as `/PO SAI_PORT_ATTR_HW_LANE_LIST, ``` -The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): +The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): ``` extension create-only { description "During apply-patch operation the field can only be created (i.e. added) or re-created (i.e. removed then added) but cannot be modified (i.e. replaced)."; @@ -431,7 +431,7 @@ Let's take the example [A.2 Dynamic Port Breakout 1 to 4](#a2-dynamic-port-break ``` But the field `lanes` is `create-only` and cannot be modified i.e. replaced. The only way to update the `lanes` field is through deleting then adding its parent the `/PORT/Ethernet0`. -In [port YANG model](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-port.yang), let's mark `lanes` with `create-only`: +In [port YANG model](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-port.yang), let's mark `lanes` with `create-only`: ```diff leaf lanes { mandatory true; @@ -522,9 +522,9 @@ N/A | 11 | Remove 2 items that depends on each other in the same table e.g. /INTERFACE/INTERFACE_LIST and /INTERFACE/INTERFACE_PREFIX_LIST. | | 12 | Add 2 items that depends on each other in the same table e.g. /INTERFACE/INTERFACE_LIST and /INTERFACE/INTERFACE_PREFIX_LIST. | | 13 | Replace a mandatory item e.g. type under ACL_TABLE. | -| 14 | Dynamic port breakout as described [here](https://github.com/Azure/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md).| +| 14 | Dynamic port breakout as described [here](https://github.com/sonic-net/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md).| | 15 | Remove an item that has a default value. | -| 16 | Modifying items that rely depends on each other based on a `must` condition rather than direct connection such as `leafref` e.g. /CRM/acl_counter_high_threshold (check [here](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-crm.yang)). | +| 16 | Modifying items that rely depends on each other based on a `must` condition rather than direct connection such as `leafref` e.g. /CRM/acl_counter_high_threshold (check [here](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-crm.yang)). |
    @@ -695,4 +695,4 @@ N/A [{"op": "add", "path": "/VLAN_MEMBER/Vlan100|Ethernet3", "value": {"tagging_mode": "untagged"}}], [{"op": "add", "path": "/VLAN_MEMBER/Vlan100|Ethernet0", "value": {"tagging_mode": "untagged"}}], ] -``` \ No newline at end of file +``` diff --git a/doc/config-generic-update-rollback/SONiC_Generic_Config_Update_and_Rollback_Design.md b/doc/config-generic-update-rollback/SONiC_Generic_Config_Update_and_Rollback_Design.md index 246b204d6b..2f803fbc4d 100644 --- a/doc/config-generic-update-rollback/SONiC_Generic_Config_Update_and_Rollback_Design.md +++ b/doc/config-generic-update-rollback/SONiC_Generic_Config_Update_and_Rollback_Design.md @@ -137,7 +137,7 @@ Updating SONiC partial configurations **systematically** has been a challenge fo - Executing `sudo sonic-cfggen -j /tmp/dhcp.json --write-to-db` - Restart `dhcp_relay` service -We have explored [SONiC CLI commands](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md) to make configuration changes. These CLI commands result in updates to the ConfigDB which are corresponding to the CLI command executed. For example, the config `vlan add 10` will create a new row in the VLAN table of the ConfigDB. But relying on the CLI commands to do partial update is also not feasible as there is no standard way of showing the config after the update. Setting up a different update mechanism for each part of the config is very time consuming and inefficient. +We have explored [SONiC CLI commands](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md) to make configuration changes. These CLI commands result in updates to the ConfigDB which are corresponding to the CLI command executed. For example, the config `vlan add 10` will create a new row in the VLAN table of the ConfigDB. But relying on the CLI commands to do partial update is also not feasible as there is no standard way of showing the config after the update. Setting up a different update mechanism for each part of the config is very time consuming and inefficient. The other challenge to updating a switch is recoverability via rollback. Rollback needs to be with minimum-disruption e.g. if reverting ACL updates DHCP should not be affected. Currently SONiC has a couple of operations that can be candidates for rollback `config load` and `config reload`. @@ -309,7 +309,7 @@ The `apply-patch` method should help with automating partial config updates, as The `checkpoint` and `rollback` commands should help improve recoverability, can also be used by external systems to help revert failures during `apply-patch` operation. -Human operators can also leverage the `checkpoint` and `rollback` functionalities while doing updates through the CLI using [SONiC CLI commands](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md). +Human operators can also leverage the `checkpoint` and `rollback` functionalities while doing updates through the CLI using [SONiC CLI commands](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md). ## 2.2 Functional Description @@ -317,7 +317,7 @@ Human operators can also leverage the `checkpoint` and `rollback` functionalitie The SONiC `apply-patch` command can broadly classified into the following steps #### Stage-1 JSON Patch Verification -Using [YANG SONiC models](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-yang-models), but the format of the JSON patch is not what YANG SONiC models is built to verify. We will verify using the following steps: +Using [YANG SONiC models](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-yang-models), but the format of the JSON patch is not what YANG SONiC models is built to verify. We will verify using the following steps: 1. Get current running config from ConfigDB as JSON 2. Simulate the patch application on the current config JSON object 3. Verify the the simulated output using YANG SONiC models @@ -540,14 +540,14 @@ All the configuration update operations executed and the output displayed by the The user of the system, can simply be a human operator or a service that can talk to SONiC CLI. The user can only apply-patch if they have an admin permission. Users without admin permissions can only execute dry-run of the operations where they will be able to see the exact changes going to affect the device, without executing these changes. #### 3.1.1.2 SONiC CLI -These are the CLI of SONiC switch to which makes it easy for the users to interact with the system. The CLI commands we are interested in are `config ...` and `show ...`, check [SONiC Command Line Interface Guide](https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md) to learn more about SONiC CLI. +These are the CLI of SONiC switch to which makes it easy for the users to interact with the system. The CLI commands we are interested in are `config ...` and `show ...`, check [SONiC Command Line Interface Guide](https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md) to learn more about SONiC CLI. For further details on the CLI setup, Check [3.2.2 CLI](#322-cli) #### 3.1.1.3 YANG models YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. For further details check [The YANG 1.1 Data Modeling Language](https://tools.ietf.org/html/rfc7950) -SONiC is currently getting on-boarded to YANG data models to help verify and generate the configurations. We will leverage these YANG models to help verify the result of simulating the JsonPatch on ConfigDb, to make sure final outcome adheres to all the constrains defined in the YANG models. For further details check [YANG SONiC models](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-yang-models). +SONiC is currently getting on-boarded to YANG data models to help verify and generate the configurations. We will leverage these YANG models to help verify the result of simulating the JsonPatch on ConfigDb, to make sure final outcome adheres to all the constrains defined in the YANG models. For further details check [YANG SONiC models](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-yang-models). #### 3.1.1.4 Patch Orderer This component is going to solve the problems discussed in [Stage-2 JSON Patch Ordering](#stage-2-json-patch-ordering). This component is going to help provide an order of execution to the JsonPatch, in such a way when the config is updated in this order, there will be no errors generated on the device. The exact implementation details of this component will not be included in this design document, but we are going to explain in details the contract for any implementation. @@ -675,7 +675,7 @@ Since the order of executing the operation does not matter, the implementor of t #### 3.1.1.6 ConfigDB SONiC is managing configuration in a single source of truth - a redisDB instance that we refer as ConfigDB. Applications subscribe to ConfigDB and generate their running configuration correspondingly. -For further details on the ConfigDB, check [SONiC Configuration Database Manual](https://github.com/Azure/SONiC/wiki/Configuration). +For further details on the ConfigDB, check [SONiC Configuration Database Manual](https://github.com/sonic-net/SONiC/wiki/Configuration). ### 3.1.2 Checkpoint checkpoint-design @@ -905,22 +905,22 @@ N/A | 11 | Remove 2 items that depends on each other in the same table e.g. /INTERFACE/INTERFACE_LIST and /INTERFACE/INTERFACE_PREFIX_LIST. | | 12 | Add 2 items that depends on each other in the same table e.g. /INTERFACE/INTERFACE_LIST and /INTERFACE/INTERFACE_PREFIX_LIST. | | 13 | Replace a mandatory item e.g. type under ACL_TABLE. | -| 14 | Dynamic port breakout as described [here](https://github.com/Azure/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md).| +| 14 | Dynamic port breakout as described [here](https://github.com/sonic-net/SONiC/blob/master/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md).| | 15 | Remove an item that has a default value. | -| 16 | Modifying items that rely depends on each other based on a `must` condition rather than direct connection such as `leafref` e.g. /CRM/acl_counter_high_threshold (check [here](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-crm.yang)). | -| 17 | [Updating Syslog configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_syslog.py) | -| 18 | [Updating AAA configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_aaa.py) | -| 19 | [Updating DHCP configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_dhcp_relay.py) | +| 16 | Modifying items that rely depends on each other based on a `must` condition rather than direct connection such as `leafref` e.g. /CRM/acl_counter_high_threshold (check [here](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-crm.yang)). | +| 17 | [Updating Syslog configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_syslog.py) | +| 18 | [Updating AAA configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_aaa.py) | +| 19 | [Updating DHCP configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_dhcp_relay.py) | | 20 | Updating IPv6 configs. | | 21 | Updating monitor configs (EverflowAlaysOn). | | 22 | Updating BGP speaker configs. | -| 23 | [Updating BGP listener configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_bgpl.py) | +| 23 | [Updating BGP listener configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_bgpl.py) | | 24 | ~~Updating Bounce Back Routing configs.~~ | -| 25 | [Updating control-plane ACLs (NTP, SNMP, SSH) configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_cacl.py) | +| 25 | [Updating control-plane ACLs (NTP, SNMP, SSH) configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_cacl.py) | | 26 | Updating Ethernet interfaces configs. | -| 27 | [Updating VLAN interfaces configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_vlan_interface.py) | -| 28 | [Updating port-channel interfaces configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_portchannel_interface.py) | -| 29 | [Updating loopback interfaces configs.](https://github.com/Azure/sonic-mgmt/blob/master/tests/generic_config_updater/test_lo_interface.py) | +| 27 | [Updating VLAN interfaces configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_vlan_interface.py) | +| 28 | [Updating port-channel interfaces configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_portchannel_interface.py) | +| 29 | [Updating loopback interfaces configs.](https://github.com/sonic-net/sonic-mgmt/blob/master/tests/generic_config_updater/test_lo_interface.py) | | 30 | Updating BGP prefix hijack configs. | | 31 | Updating QoS headroom pool and buffer pool size. | | 32 | Add/Remove Rack. | diff --git a/doc/console/SONiC-Console-Switch-High-Level-Design.md b/doc/console/SONiC-Console-Switch-High-Level-Design.md index 0aef1c9a0e..179b02471c 100644 --- a/doc/console/SONiC-Console-Switch-High-Level-Design.md +++ b/doc/console/SONiC-Console-Switch-High-Level-Design.md @@ -291,7 +291,7 @@ Below is an example, we can look into the inner topology of a console device: The console device have 4 com ports at front panel with product port numbers from 1 to 4. After we connected the console device to SONiC switch, the SONiC OS will detect 4 tty device and put them under `/dev` directory. -From SONiC aspect, it is hard for us to know how the tty device mapped to physical console port because its depends on the external hardware design and OS kernel behavior. Then we need to create alias for all tty devices by using some rule. Here[[1]](https://github.com/Azure/SONiC/blob/master/doc/udev-terminalserver/udev%20rules%20for%20Terminal%20Server.md) is an design for resolving USB terminal server's port mapping problem by leveraging udev rule, it use the usb hardware metadata which are immutable to determine the relationship between underlying tty devices and front panel ports. +From SONiC aspect, it is hard for us to know how the tty device mapped to physical console port because its depends on the external hardware design and OS kernel behavior. Then we need to create alias for all tty devices by using some rule. Here[[1]](https://github.com/sonic-net/SONiC/blob/master/doc/udev-terminalserver/udev%20rules%20for%20Terminal%20Server.md) is an design for resolving USB terminal server's port mapping problem by leveraging udev rule, it use the usb hardware metadata which are immutable to determine the relationship between underlying tty devices and front panel ports. Regardless of the console device type, the rule is required. We define below function `device_name_mapping()` for determining the alias name for a console port: @@ -769,4 +769,4 @@ If use USB, then the maximum number of add-on console device is specific to the # 9 Reference -1. udev rules design for terminal server. Sandy Li. https://github.com/Azure/SONiC/blob/master/doc/udev-terminalserver/udev%20rules%20for%20Terminal%20Server.md \ No newline at end of file +1. udev rules design for terminal server. Sandy Li. https://github.com/sonic-net/SONiC/blob/master/doc/udev-terminalserver/udev%20rules%20for%20Terminal%20Server.md diff --git a/doc/copp/CoPP Config and Management.md b/doc/copp/CoPP Config and Management.md index 897bbca5c7..82f9e5d13c 100644 --- a/doc/copp/CoPP Config and Management.md +++ b/doc/copp/CoPP Config and Management.md @@ -15,7 +15,7 @@ The following are the high level requirements for CoPP/TRAP managment ## Current behaviour -During SWSS start, the prebuilt [copp.json](https://github.com/Azure/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/Azure/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/Azure/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. +During SWSS start, the prebuilt [copp.json](https://github.com/sonic-net/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/sonic-net/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/sonic-net/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. ## Proposed behaviour @@ -63,7 +63,7 @@ state = "ok" ``` ### coppmgr -Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/Azure/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. +Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. Trap name added to copp_cfg.json file has to match a feature name exist in FEATURE table in Config DB. In order to handle traps which has no associated feature (such as arp, ip2me), a new field called "always_enabled" will be added to COPP_TRAP table in Config DB. @@ -118,7 +118,7 @@ For this design, considering the limitations, proposal is to go ahead with secon It is desirable to have warmboot functionality from previous release versions of Sonic. Since the existing schema has COPP Group name/key with protocol names (e.g `"COPP_TABLE:trap.group.bgp.lacp"`, there is a limitation in adding any new protocol or trap to an existing CoPP group and seamlessly migrate. However, with this proposal, the following options are considered: 1. The implementation is to do a migration of APP DB entries to new schema. -2. Let ```db_migrator``` remove all previously saved APP_DB entries and let syncd reconcile and remove the TRAP entries during warmboot. Later, ```coppmgr``` can reapply the traps afresh. Also remove COPP_TABLES from being saved in [backup_database](https://github.com/Azure/sonic-utilities/blob/master/scripts/fast-reboot#L234). This may require additional tests to confirm system behaviour during warmboot. +2. Let ```db_migrator``` remove all previously saved APP_DB entries and let syncd reconcile and remove the TRAP entries during warmboot. Later, ```coppmgr``` can reapply the traps afresh. Also remove COPP_TABLES from being saved in [backup_database](https://github.com/sonic-net/sonic-utilities/blob/master/scripts/fast-reboot#L234). This may require additional tests to confirm system behaviour during warmboot. 3. Remove '00-copp.config.json' from being included for checksum calculation in ```files/build_scripts/generate_asic_config_checksum.py``` In addition, the implementation must ensure that backward compatibility is maintained. If the system is boot-up with an *old* config file, the default CoPP tables are to be loaded from ```copp_cfg.json``` and expected to work seamlessly. @@ -146,13 +146,13 @@ The following flow diagram captures the control flow. The following flow captures scenarios for ```boot-up``` sequence and ```config reload```. Default CoPP Tables shall be present in ```copp_cfg.json``` and if the same entry is present in ```config_db.json```, it is expected to be overwritten by ```config_db``` entry. This model ensures user-configuration gets priority over default configuration. -![](https://github.com/Azure/SONiC/blob/master/images/copp/CoppInit_1.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/copp/CoppInit_1.png) ## Copp Manager flow The following flow captures CoPP manager functionality. -![](https://github.com/Azure/SONiC/blob/master/images/copp/CoppManager_1.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/copp/CoppManager_1.png) # Examples diff --git a/doc/crm/Critical-Resource-Monitoring-High-Level-Design.md b/doc/crm/Critical-Resource-Monitoring-High-Level-Design.md index 8aca334897..41c4d077f5 100644 --- a/doc/crm/Critical-Resource-Monitoring-High-Level-Design.md +++ b/doc/crm/Critical-Resource-Monitoring-High-Level-Design.md @@ -64,7 +64,7 @@ This document describes the high level design of the Critical Resource Monitorin | SAI | Swich Abstraction Interface | # 1 Subsystem Requirements Overview ## 1.1 Functional requirements -Detailed description of the Critical Resource Monitoring feature requirements is here: [CRM Requirements](https://github.com/Azure/SONiC/blob/gh-pages/doc/crm/CRM_requirements.md). +Detailed description of the Critical Resource Monitoring feature requirements is here: [CRM Requirements](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/crm/CRM_requirements.md). This section describes the SONiC requirements for Critical Resource Monitoring (CRM) feature. CRM should monitor utilization of ASIC resources by polling SAI attributes. @@ -304,9 +304,9 @@ Commands: ``` # 3 Flows ## 3.1 CRM monitoring -![](https://github.com/Azure/SONiC/blob/gh-pages/images/crm_hld/crm_monitoring_flow.png) +![](https://github.com/sonic-net/SONiC/blob/gh-pages/images/crm_hld/crm_monitoring_flow.png) ## 3.2 CRM CLI config -![](https://github.com/Azure/SONiC/blob/gh-pages/images/crm_hld/crm_cli_config_flow.png) +![](https://github.com/sonic-net/SONiC/blob/gh-pages/images/crm_hld/crm_cli_config_flow.png) ## 3.3 CRM CLI show -![](https://github.com/Azure/SONiC/blob/gh-pages/images/crm_hld/crm_cli_show_flow.png) +![](https://github.com/sonic-net/SONiC/blob/gh-pages/images/crm_hld/crm_cli_show_flow.png) # 4 Open Questions diff --git a/doc/dualtor/active_active_hld.md b/doc/dualtor/active_active_hld.md index 92144a61a0..7928254bb1 100644 --- a/doc/dualtor/active_active_hld.md +++ b/doc/dualtor/active_active_hld.md @@ -314,7 +314,7 @@ Linkmgrd will provide the determination of a ToR / link's readiness for use. ![grpc_failure](./image/gRPC_failure.png) #### 3.3.5 Default route to T1 - If default route to T1 is missing, dual ToR system can suffer from northbound packet loss, hence linkmgrd also monitors defaul route state. If default route is missing, linkmgrd will stop sending ICMP probing request and fake an unhealthy status. This functionality can be disabled as well, the details is included in [default_route](https://github.com/Azure/sonic-linkmgrd/blob/master/doc/default_route.md). + If default route to T1 is missing, dual ToR system can suffer from northbound packet loss, hence linkmgrd also monitors defaul route state. If default route is missing, linkmgrd will stop sending ICMP probing request and fake an unhealthy status. This functionality can be disabled as well, the details is included in [default_route](https://github.com/sonic-net/sonic-linkmgrd/blob/master/doc/default_route.md). To summarize the state transition decision we talk about, and the corresponding gRPC action to take, we have this decision table below: diff --git a/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md b/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md index 137f9d6f8c..304c21c133 100644 --- a/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md +++ b/doc/dynamic-port-breakout/sonic-dynamic-port-breakout-HLD.md @@ -1061,7 +1061,7 @@ There are some special cases where queue, scheduler group and priority group obj If they are not at default state, that means user has configured them, sai-redis will fail the delete port action. This means, user should remove the configured objects before deleting the port. I,E, User should bring queues/ingress priority groups/scheduler groups that belong to the port to default state (will remove all assigned objects like buffer profile etc). PR in Sairedis and Syncd is available already: -https://github.com/Azure/sonic-sairedis/pull/500 +https://github.com/sonic-net/sonic-sairedis/pull/500 ### Syncd changes @@ -1075,12 +1075,12 @@ However, due to the consumer tables for different objects with batch size, this We will ignore some dependencies check to avoid the crash in syncd, and also add retry logic in syncd to avoid above timing issue. PRs: -https://github.com/Azure/sonic-sairedis/pull/464 -https://github.com/Azure/sonic-sairedis/pull/483 +https://github.com/sonic-net/sonic-sairedis/pull/464 +https://github.com/sonic-net/sonic-sairedis/pull/483 Another issue with syncd today is to support dynamic port breakout feature with warm-reboot. We need dynamically update the port map in syncd for comparison logic to support warm-reboot. PR is available as below: -https://github.com/Azure/sonic-sairedis/pull/515 +https://github.com/sonic-net/sonic-sairedis/pull/515 ## libSAI requirements We need the HW to initialize with the profile that is breakout capable. diff --git a/doc/ecmp/fine_grained_next_hop_hld.md b/doc/ecmp/fine_grained_next_hop_hld.md index 6e111bf4e8..ce66699589 100644 --- a/doc/ecmp/fine_grained_next_hop_hld.md +++ b/doc/ecmp/fine_grained_next_hop_hld.md @@ -156,7 +156,7 @@ BANK = DIGITS LINK = link_name ; Link associated with next-hop-ip, if configured, enables next-hop withdrawal/addition per link's operational state changes ``` -Please refer to the [schema](https://github.com/Azure/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. +Please refer to the [schema](https://github.com/sonic-net/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. ## 2.2 State DB diff --git a/doc/error-handling/error_handling_design_spec.md b/doc/error-handling/error_handling_design_spec.md index 65308e2f4d..fdc28b5d32 100755 --- a/doc/error-handling/error_handling_design_spec.md +++ b/doc/error-handling/error_handling_design_spec.md @@ -262,7 +262,7 @@ family = "IPv4" / "IPv6" ; address family rc = SWSS code ; status code for each neighbour ``` -Please refer to the [schema](https://github.com/Azure/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. +Please refer to the [schema](https://github.com/sonic-net/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. ## 3.5 CLI diff --git a/doc/fast-reboot/Fast-reboot_Flow_Improvements_HLD.md b/doc/fast-reboot/Fast-reboot_Flow_Improvements_HLD.md index f7b044b82e..280a9b6336 100644 --- a/doc/fast-reboot/Fast-reboot_Flow_Improvements_HLD.md +++ b/doc/fast-reboot/Fast-reboot_Flow_Improvements_HLD.md @@ -42,9 +42,9 @@ This new flag can be used later on for any functionality, we want to start only This is to prevent interference in the fast-reboot reconciliation process and impair the performance, for example enablement of flex counters. References: -https://github.com/Azure/SONiC/blob/master/doc/fast-reboot/fastreboot.pdf -https://github.com/Azure/sonic-swss/blob/master/neighsyncd/restore_neighbors.py -https://github.com/Azure/sonic-buildimage/blob/master/dockers/docker-orchagent/enable_counters.py +https://github.com/sonic-net/SONiC/blob/master/doc/fast-reboot/fastreboot.pdf +https://github.com/sonic-net/sonic-swss/blob/master/neighsyncd/restore_neighbors.py +https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/enable_counters.py # 2 Functional Requirements @@ -226,4 +226,4 @@ reboot-finalizer.sh (warm-finalizer.sh) script must also be templatized and upda This chapter it taken from SONiC Application Extension Infrastructure HLD: -https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extension/sonic-application-extention-hld.md#warmboot-and-fastboot-design-impact +https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extension/sonic-application-extention-hld.md#warmboot-and-fastboot-design-impact diff --git a/doc/flow_counters/routes_flow_counters.md b/doc/flow_counters/routes_flow_counters.md index e52fd1e821..d9d8da6c5b 100644 --- a/doc/flow_counters/routes_flow_counters.md +++ b/doc/flow_counters/routes_flow_counters.md @@ -46,7 +46,7 @@ This document focus on route counter. Flow counter shall utilize the following existing infrastructure: - Generic Counters API - defined in https://github.com/opencomputeproject/SAI/blob/master/doc/SAI-Proposal-Generic-Counters.md and already supported by the SAI layer. This feature shall support binding/unbinding of these Generic counters to/from relevant SONIC objects -- Flex Counters framework - used for background polling and pushing the statistic information to COUNTER DB for later use (e.g. by CLI). A introduction to flex counter can be found at: https://github.com/Azure/SONiC/pull/858. +- Flex Counters framework - used for background polling and pushing the statistic information to COUNTER DB for later use (e.g. by CLI). A introduction to flex counter can be found at: https://github.com/sonic-net/SONiC/pull/858. ![architecture](/doc/flow_counters/route_flow_counter_architecture.png). @@ -409,7 +409,7 @@ As this is a debugging feature, basically, user should not enable this counter d However, if user did it by mistake: -- For fastboot, there is already a mechanism that delays flex counter, nothing needs to be done here. See PR https://github.com/Azure/sonic-swss/pull/1877. +- For fastboot, there is already a mechanism that delays flex counter, nothing needs to be done here. See PR https://github.com/sonic-net/sonic-swss/pull/1877. - For warmboot, routeorch does not handle any DB change except the "resync" during warmboot, it means that route flow counter will not be enabled until warmboot finish. So, no change is required in this feature. Based on the above, this feature shall not introduce any delay in fastboot or warmboot, and this shall be verified by test. diff --git a/doc/kubernetes/Kubernetes-support.md b/doc/kubernetes/Kubernetes-support.md index fdd09272ee..b1665c46b5 100644 --- a/doc/kubernetes/Kubernetes-support.md +++ b/doc/kubernetes/Kubernetes-support.md @@ -444,7 +444,7 @@ Note: SystemState == Up does not really mean the feature is running, as in case # Reboot support ## Warm-reboot support - This [warm-reboot](https://github.com/Azure/SONiC/blob/master/doc/warm-reboot/SONiC_Warmboot.md) support is for updating/restarting with no data-plane disruption. The `/usr/bin/warm_reboot` script is a complex script that does many pre-requisites, kill the containers and eventually call a specific command for reboot. The individual service level support for warm-start lies within its code/implementation-logic. When configured for warm start, upon start-up, the service should be able to acquire its i/p data from all its channels as ever, but instead of pushing it in entirety to the consumer/DB, read the pre-boot data (which is made available in APP-DB), find the diffs as stale/new/update and only push the diffs. With every app doing it and, with some additional complex steps for critical processes like orchagent & syncd, the data plane traffic goes unaffected, except for the changes pushed into ASIC, which is a normal runtime experience of consuming changes as it happens. + This [warm-reboot](https://github.com/sonic-net/SONiC/blob/master/doc/warm-reboot/SONiC_Warmboot.md) support is for updating/restarting with no data-plane disruption. The `/usr/bin/warm_reboot` script is a complex script that does many pre-requisites, kill the containers and eventually call a specific command for reboot. The individual service level support for warm-start lies within its code/implementation-logic. When configured for warm start, upon start-up, the service should be able to acquire its i/p data from all its channels as ever, but instead of pushing it in entirety to the consumer/DB, read the pre-boot data (which is made available in APP-DB), find the diffs as stale/new/update and only push the diffs. With every app doing it and, with some additional complex steps for critical processes like orchagent & syncd, the data plane traffic goes unaffected, except for the changes pushed into ASIC, which is a normal runtime experience of consuming changes as it happens. In short if a service supports warmboot, it would continue to support in both local & kube modes transparently.
    The warm_reboot script needs few updates as below.
    @@ -467,7 +467,7 @@ Note: SystemState == Up does not really mean the feature is running, as in case For new features that are not known to warm-reboot script, some hooks could be allowed for registration of feature-custom scripts. This could help with some preparation steps before reboot, like caching some data, setting some DB values, ... ## Fast-reboot - This [fast-reboot](https://github.com/Azure/SONiC/wiki/Fast-Reboot) support aims to help image-udpate and restart, with minimal data-plane traffic disruption. The implementation is similar to warm-reboot, that logic is embedded in the fast-boot script, additional utilities and some tweaks inside the code/logic of individual services that supports. Here again any service level support lies within the internal code/logic. + This [fast-reboot](https://github.com/sonic-net/SONiC/wiki/Fast-Reboot) support aims to help image-udpate and restart, with minimal data-plane traffic disruption. The implementation is similar to warm-reboot, that logic is embedded in the fast-boot script, additional utilities and some tweaks inside the code/logic of individual services that supports. Here again any service level support lies within the internal code/logic. In short, the summary and the required changes, including hooks for new features, are the same as in warm-reboot support, just that here use fast-reboot script. diff --git a/doc/lag/LACP Fallback Feature for SONiC_v0.5.md b/doc/lag/LACP Fallback Feature for SONiC_v0.5.md index 1eab42c948..995f69bd22 100644 --- a/doc/lag/LACP Fallback Feature for SONiC_v0.5.md +++ b/doc/lag/LACP Fallback Feature for SONiC_v0.5.md @@ -17,7 +17,7 @@ problem because packets sourced from the MAC address of NIC-1 can be returned to the port on which NIC-2 is attached, which will cause NIC-2 to drop the packets (due to MAC mismatch). -![lag.png](https://github.com/Azure/SONiC/blob/gh-pages/images/lacp_fallback_hld/lag.png) +![lag.png](https://github.com/sonic-net/SONiC/blob/gh-pages/images/lacp_fallback_hld/lag.png) With the LACP fallback feature, the switch allows the server to bring up the LAG (before receiving any LACP PDUs from the server) and keeps a single port @@ -70,7 +70,7 @@ Rxm\_expired states with two timeout: Short timeout (3s) and Long timeout (180s) depending on the value of the Actor's Operational Status LACP\_Timeout, as transmitted in LACPDUs. -![Current_LACP_State_Machine.png](https://github.com/Azure/SONiC/blob/gh-pages/images/lacp_fallback_hld/Current_LACP_State_Machine.png) +![Current_LACP_State_Machine.png](https://github.com/sonic-net/SONiC/blob/gh-pages/images/lacp_fallback_hld/Current_LACP_State_Machine.png) ## Receive Machine Events The following events can occur: @@ -86,7 +86,7 @@ have become non-operational. The received LACPDU event only occurs if both physical transmission and reception are operational, so far as the actor is aware. -![rxm.png](https://github.com/Azure/SONiC/blob/gh-pages/images/lacp_fallback_hld/rxm.png) +![rxm.png](https://github.com/sonic-net/SONiC/blob/gh-pages/images/lacp_fallback_hld/rxm.png) # LACP Fallback Design @@ -99,7 +99,7 @@ In order to support LACP fallback feature, we need to make the port selectable in defaulted state if fallback is enabled. Hence we'd like to introduce the fallback mode in defaulted state. -![LACP_Defaulted.png](https://github.com/Azure/SONiC/blob/gh-pages/images/lacp_fallback_hld/LACP_Defaulted.png) +![LACP_Defaulted.png](https://github.com/sonic-net/SONiC/blob/gh-pages/images/lacp_fallback_hld/LACP_Defaulted.png) - Fallback Mode: diff --git a/doc/lag/LACP Fallback Test Plan.md b/doc/lag/LACP Fallback Test Plan.md index a9f7e309ec..6c31b2c099 100644 --- a/doc/lag/LACP Fallback Test Plan.md +++ b/doc/lag/LACP Fallback Test Plan.md @@ -15,7 +15,7 @@ **Related documents** -[LACP Fallback Design Document](https://github.com/Azure/SONiC/blob/gh-pages/doc/LACP%20Fallback%20Feature%20for%20SONiC_v0.3.docx) +[LACP Fallback Design Document](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/LACP%20Fallback%20Feature%20for%20SONiC_v0.3.docx) # Overview This feature test suite is targeting on testing LACP fallback feature on SONiC. In our testbed, 't0' and 't1-lag' have LAG configurations. Each test covers a basic functionality of LACP fallback feature and ensures the switch works as expected under production scenarios. @@ -41,8 +41,8 @@ sai_remove_lag_member DUT configuration is done via minigraph. See more information below # Setup configuration -![LACP_fallback_testbed.png](https://github.com/Azure/SONiC/blob/gh-pages/images/LACP_fallback_testbed.png) -https://github.com/Azure/SONiC/blob/gh-pages/images/LACP_fallback_testbed.png +![LACP_fallback_testbed.png](https://github.com/sonic-net/SONiC/blob/gh-pages/images/LACP_fallback_testbed.png) +https://github.com/sonic-net/SONiC/blob/gh-pages/images/LACP_fallback_testbed.png * 8 LAGs per switch from the DUT to 8 vEOS devices. * Each of the LAG contains 2 members. @@ -57,7 +57,7 @@ https://github.com/Azure/SONiC/blob/gh-pages/images/LACP_fallback_testbed.png sonic-mgmt uses minigraph files to described VM set (Arista vEOS devices) and the DUT switch. We will need to create a new minigraph file, describing VMs and the switch, with LAGs. -The switch file will be named switch-lacp-fallback.yml, and located at [https://github.com/Azure/sonic-mgmt/blob/master/ansible/minigraph](https://github.com/Azure/sonic-mgmt/blob/master/ansible/minigraph). +The switch file will be named switch-lacp-fallback.yml, and located at [https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/minigraph](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/minigraph). ### LAG related minigraph data @@ -82,7 +82,7 @@ Sample: ``` -This information will be consumed by teamd.j2 template introduced in [LAG testbed Pull Reqeust](https://github.com/Azure/sonic-mgmt/pull/69) (see port_channel variable) to produce LAG json configuration for teamd. +This information will be consumed by teamd.j2 template introduced in [LAG testbed Pull Reqeust](https://github.com/sonic-net/sonic-mgmt/pull/69) (see port_channel variable) to produce LAG json configuration for teamd. see [Setup of DUT switch](#setup-of-dut-switch) for details on teamd json. ### LAG route information file diff --git a/doc/macsec/MACsec_hld.md b/doc/macsec/MACsec_hld.md index 11d00af5d9..8b06bfa9a1 100644 --- a/doc/macsec/MACsec_hld.md +++ b/doc/macsec/MACsec_hld.md @@ -102,8 +102,8 @@ At a high level the following should be supported: #### Phase I -- MACsec can be enabled at a specified [port](https://github.com/Azure/SONiC/wiki/Configuration#port) -- MACsec can co-work with the [port channel](https://github.com/Azure/SONiC/wiki/Configuration#port-channel) +- MACsec can be enabled at a specified [port](https://github.com/sonic-net/SONiC/wiki/Configuration#port) +- MACsec can co-work with the [port channel](https://github.com/sonic-net/SONiC/wiki/Configuration#port-channel) - Support Cipher: GCM-AES-128 and GCM-AES-256 - Secure Association Key(SAK) can be replaced without service outage diff --git a/doc/mclag/MCLAG_Enhancements_HLD.md b/doc/mclag/MCLAG_Enhancements_HLD.md index 7530fadeae..ded353c352 100644 --- a/doc/mclag/MCLAG_Enhancements_HLD.md +++ b/doc/mclag/MCLAG_Enhancements_HLD.md @@ -105,7 +105,7 @@ Rev 0.1 | 0.2 | 10/22/2019 | Tapash Das | L3 Protocol support enhancement | # About this Manual -This document provides general information about SONiC MCLAG feature enhancements. The original MCLAG feature is described at https://github.com/Azure/SONiC/blob/f478fe7cbc03c144f3b147e9638f460f764ce4b7/doc/Sonic-mclag-hld.md +This document provides general information about SONiC MCLAG feature enhancements. The original MCLAG feature is described at https://github.com/sonic-net/SONiC/blob/f478fe7cbc03c144f3b147e9638f460f764ce4b7/doc/Sonic-mclag-hld.md # Definition/Abbreviation diff --git a/doc/mclag/Sonic-mclag-hld.md b/doc/mclag/Sonic-mclag-hld.md index 37047bdf3a..dcfaebb473 100644 --- a/doc/mclag/Sonic-mclag-hld.md +++ b/doc/mclag/Sonic-mclag-hld.md @@ -430,7 +430,7 @@ Flow 8: After configure/update APP_DB, OrchAgent monitors and procesess the rela Jason definition is exactly the same as acl_table and acl_rule_table in config-db. MCLAG uses acl to isolate peer-link from mclag-enabled port-channel. so We add acl_table and acl_rule_table in app-db. Other apps which need to configure acl dynamically can reuse this mechanism. -The acl hld has defined app_acl_table and app_acl_rule_table but did not implement it. Please refer [acl_hld](https://github.com/Azure/SONiC/blob/master/doc/acl/ACL-High-Level-Design.md#31211-acl-tables-table) for detail. +The acl hld has defined app_acl_table and app_acl_rule_table but did not implement it. Please refer [acl_hld](https://github.com/sonic-net/SONiC/blob/master/doc/acl/ACL-High-Level-Design.md#31211-acl-tables-table) for detail. ```jason "ACL_TABLE": { @@ -582,7 +582,7 @@ Config loglevel success! ## 9.4. aclorch changes -Adding the following logic:([PR#810](https://github.com/Azure/sonic-swss/pull/810)) +Adding the following logic:([PR#810](https://github.com/sonic-net/sonic-swss/pull/810)) - ACL table can be matched with OUT_PORTS. - Aclorch as the consumer to monitor the events of APP_ACL_TABLE_NAME and APP_ACL_RULE_TABLE_NAME tables in APP_DB . The definition of APP_ACL_TABLE_NAME and APP_ACL_RULE_TABLE_NAME are in sonic-swss-common/common/schema.h. @@ -598,8 +598,8 @@ Adding the following logics: Adding the following logics: -- Listening new APP_DB events, enable or disable to learn interface MACs. If ‘learn_mode’ attribute of one port is set to ‘disabled’, the MAC learning of this port is disbled.([PR#809](https://github.com/Azure/sonic-swss/pull/809)) -- Add LAG name map to counter table, so that ‘show mac’ can display the MACs learned from LAG ports. ([PR#808](https://github.com/Azure/sonic-swss/pull/808)) +- Listening new APP_DB events, enable or disable to learn interface MACs. If ‘learn_mode’ attribute of one port is set to ‘disabled’, the MAC learning of this port is disbled.([PR#809](https://github.com/sonic-net/sonic-swss/pull/809)) +- Add LAG name map to counter table, so that ‘show mac’ can display the MACs learned from LAG ports. ([PR#808](https://github.com/sonic-net/sonic-swss/pull/808)) ## 9.7. intfmgr changes @@ -611,14 +611,14 @@ Adding the following logics: Adding the following logics: -- Listening MAC modification of L3 interfaces, updating it to ASIC.([PR#814](https://github.com/Azure/sonic-swss/pull/814)) -- Removing the function of adding/delete direct connected network FIB update triggered by creation of L3 interface in orchAgent. (Such direct connected network FIB does not respond to the state change, which is wrong, it only responds to the ip address addition or deletion）[PR#878](https://github.com/Azure/sonic-swss/pull/878)) +- Listening MAC modification of L3 interfaces, updating it to ASIC.([PR#814](https://github.com/sonic-net/sonic-swss/pull/814)) +- Removing the function of adding/delete direct connected network FIB update triggered by creation of L3 interface in orchAgent. (Such direct connected network FIB does not respond to the state change, which is wrong, it only responds to the ip address addition or deletion）[PR#878](https://github.com/sonic-net/sonic-swss/pull/878)) ## 9.9. routeorch changes Adding the following logics: -- For the creation of the directly connected network, the code is moved from intfsorch to routeorch. Like other types of route, the direct connect network is informed by Zebra. This is to fix a common issue, not only for MC-LAG support.([PR#878](https://github.com/Azure/sonic-swss/pull/878)) +- For the creation of the directly connected network, the code is moved from intfsorch to routeorch. Like other types of route, the direct connect network is informed by Zebra. This is to fix a common issue, not only for MC-LAG support.([PR#878](https://github.com/sonic-net/sonic-swss/pull/878)) ## 9.10. fdborch changes @@ -626,7 +626,7 @@ Adding the following logics: - If the FDB entry is already exist when the event is ADD, remove the entry first, then add the entry. - FDB MAC can be learnt from or set to VXLAN tunnel in ASIC. -([PR#877](https://github.com/Azure/sonic-swss/pull/877)) +([PR#877](https://github.com/sonic-net/sonic-swss/pull/877)) ## 9.11. vxlanmgr changes diff --git a/doc/mgmt/Management Framework.md b/doc/mgmt/Management Framework.md index 4fe6f88830..2d7384d78e 100644 --- a/doc/mgmt/Management Framework.md +++ b/doc/mgmt/Management Framework.md @@ -172,7 +172,7 @@ Management framework is a SONiC application which is responsible for providing v * Must provide support for: 1. Standard [YANG](https://tools.ietf.org/html/rfc7950) models (e.g. OpenConfig, IETF, IEEE) - 2. Custom YANG models ([SONiC YANG](https://github.com/Azure/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md)) + 2. Custom YANG models ([SONiC YANG](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md)) 3. Industry-standard CLI / Cisco like CLI * Must provide support for [OpenAPI spec](http://spec.openapis.org/oas/v3.0.3) to generate REST server side code @@ -1843,19 +1843,19 @@ module openconfig-acl-annot { ##### 3.2.2.8 Config Validation Library (CVL) -Config Validation Library (CVL) is an independent library to validate ABNF schema based SONiC (Redis) configuration. This library can be used by component like [Cfg-gen](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-config-engine/sonic-cfggen), Translib, [ZTP](https://github.com/Azure/SONiC/blob/master/doc/ztp/ztp.md) etc. to validate SONiC configuration data before it is written to Redis DB. Ideally, any component importing config_db.json file into Redis DB can invoke CVL API to validate the configuration. +Config Validation Library (CVL) is an independent library to validate ABNF schema based SONiC (Redis) configuration. This library can be used by component like [Cfg-gen](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-config-engine/sonic-cfggen), Translib, [ZTP](https://github.com/sonic-net/SONiC/blob/master/doc/ztp/ztp.md) etc. to validate SONiC configuration data before it is written to Redis DB. Ideally, any component importing config_db.json file into Redis DB can invoke CVL API to validate the configuration. CVL uses SONiC YANG models written based on ABNF schema along with various constraints. These native YANG models are simple and have a very close mapping to the associated ABNF schema. Custom YANG extensions (annotations) are used for custom validation purpose. Specific YANG extensions (rather metadata) are used to translate ABNF data to YANG data. In the context of CVL these YANG models are called CVL YANG models and generated from SONiC YANG during build time. Opensource [libyang](https://github.com/CESNET/libyang) library is used to perform YANG data validation. SONiC YANG can be used as Northbound YANG for management interface by adding other data definitions such as state data (read only data), RPC or Notification as needed.Such YANG models are called SONiC NBI YANG models. Since CVL validates configuration data only, these data definition statements are ignored by CVL. During build time CVL YANG is actually generated from SONiC NBI YANG models with the help of CVL specific pyang plugin. -CVL supports multiple user-defined Redis database instances based on the [Multi DB instance HLD](https://github.com/Azure/SONiC/blob/master/doc/database/multi_database_instances.md) specification. During CVL initialization time, the DB configuration file is read from the predefined location and details are stored in internal data structure. CVL implements internal API for connecting to a Redis DB instance using the details stored in its internal data structure. +CVL supports multiple user-defined Redis database instances based on the [Multi DB instance HLD](https://github.com/sonic-net/SONiC/blob/master/doc/database/multi_database_instances.md) specification. During CVL initialization time, the DB configuration file is read from the predefined location and details are stored in internal data structure. CVL implements internal API for connecting to a Redis DB instance using the details stored in its internal data structure. ###### 3.2.2.8.1 Architecture ![CVL architecture](images/CVL_Arch.jpg) -1. During build time, developer writes SONiC YANG schema based on ABNF schema following [SONiC YANG Guidelines](https://github.com/Azure/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) and adds metadata and constraints as needed. Custom YANG extensions are defined for this purpose. +1. During build time, developer writes SONiC YANG schema based on ABNF schema following [SONiC YANG Guidelines](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) and adds metadata and constraints as needed. Custom YANG extensions are defined for this purpose. 2. The YANG models are compiled using Pyang compiler. CVL specific YIN schema files are derived from SONiC YANG with the help of CVL specific pyang plugin. Finally, generated YIN files are packaged in the build. 3. During boot up/initialization sequence, YIN schemas generated from SONiC YANG models are parsed and schema tree is build using libyang API. 4. Application calls CVL APIs to validate the configuration. In case of Translib library DB Access layer calls appropriate CVL APIs to validate the configuration. @@ -2219,7 +2219,7 @@ Redis schema needs to be expressed in SONiC proprietary YANG model with all data Custom validation code needs to be written if some of the constraints cannot be expressed in YANG syntax. -Please refer to [SONiC YANG Guidelines](https://github.com/Azure/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) for detiailed guidelines on writing SONiC YANG. +Please refer to [SONiC YANG Guidelines](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) for detiailed guidelines on writing SONiC YANG. #### 5.1.2 Generation of REST server stubs and Client SDKs for YANG based APIs @@ -2284,7 +2284,7 @@ Redis schema needs to be expressed in SONiC YANG model with all data types and c Custom validation code needs to be written if some of the constraints cannot be expressed in YANG syntax. -Please refer to [SONiC YANG Guidelines](https://github.com/Azure/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) for detiailed guidelines on writing SONiC YANG. +Please refer to [SONiC YANG Guidelines](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/SONiC_YANG_Model_Guidelines.md) for detiailed guidelines on writing SONiC YANG. #### 5.2.4 Generation of REST server stubs and Client SDKs for YANG based APIs @@ -2552,7 +2552,7 @@ Following are the list of Open source tools used in Management framework ## 12 Appendix B Following are the list of Open source libraries used in telemetry container. -Always refer to the [Makefile](https://github.com/Azure/sonic-telemetry/blob/master/Makefile) for the sonic-telemetry container for current package list. +Always refer to the [Makefile](https://github.com/sonic-net/sonic-telemetry/blob/master/Makefile) for the sonic-telemetry container for current package list. 1. [GRPC](https://google.golang.org/grpc) diff --git a/doc/mgmt/SONiC Management Framework Show Techsupport HLD.md b/doc/mgmt/SONiC Management Framework Show Techsupport HLD.md index f2b3061ddf..2a375a1122 100644 --- a/doc/mgmt/SONiC Management Framework Show Techsupport HLD.md +++ b/doc/mgmt/SONiC Management Framework Show Techsupport HLD.md @@ -79,7 +79,7 @@ Provide Management Framework functionality to process the "show techsupport" com NOTE: The underlying feature for which this Management Framework feature provides "front end" client interfaces is unchanged by the addition of these interfaces. (The "since " option available through these interfaces, however, is restricted to the IETF/YANG date/time format.) Please refer to the following document for a description of the "show techsupport" base feature: -https://github.com/Azure/sonic-utilities/blob/master/doc/Command-Reference.md#troubleshooting-commands +https://github.com/sonic-net/sonic-utilities/blob/master/doc/Command-Reference.md#troubleshooting-commands DEPENDENCY ON SONIC-HOSTSERVICES: diff --git a/doc/mgmt/SONiC_YANG_Model_Guidelines.md b/doc/mgmt/SONiC_YANG_Model_Guidelines.md index 8f7057ec0f..6b9147b4a7 100644 --- a/doc/mgmt/SONiC_YANG_Model_Guidelines.md +++ b/doc/mgmt/SONiC_YANG_Model_Guidelines.md @@ -13,7 +13,7 @@ | References | Date/Version | Link | |:-------------------------:|:-------------------:|:-----------------------------------:| | RFC 7950 | August 2016 | https://tools.ietf.org/html/rfc7950 | -| Management Framework | 0.9 | https://github.com/Azure/SONiC/pull/436 | +| Management Framework | 0.9 | https://github.com/sonic-net/SONiC/pull/436 | ## Terminology and Acronyms | Acronyms | Description/Expansion | @@ -24,9 +24,9 @@ ## Overview - This document lists the guidelines, which will be used to write YANG Modules for SONiC. These YANG Modules (called SONiC YANG models) will be primarily based on or represent the ABNF.json of SONiC, and the syntax of YANG models must follow RFC 7950 ([https://tools.ietf.org/html/rfc7950](https://tools.ietf.org/html/rfc7950)). Details of config in format of ABNF.json can be found at https://github.com/Azure/SONiC/wiki/Configuration. + This document lists the guidelines, which will be used to write YANG Modules for SONiC. These YANG Modules (called SONiC YANG models) will be primarily based on or represent the ABNF.json of SONiC, and the syntax of YANG models must follow RFC 7950 ([https://tools.ietf.org/html/rfc7950](https://tools.ietf.org/html/rfc7950)). Details of config in format of ABNF.json can be found at https://github.com/sonic-net/SONiC/wiki/Configuration. -These YANG models will be used to verify the configuration for SONiC switches, so a library which supports validation of configuration on SONiC Switch must use these YANG Models. List of such Libraries are: 1.) Configuration Validation Library. (CVL). YANG models, which are written using these guidelines can also be used as User End YANG Models, i.e North Bound configuration tools or CLI can provide config data in sync with these YANG models. For example [SONiC Management Framework](https://github.com/Azure/SONiC/pull/436) uses SONiC YANG models as Northbound Management YANG and for configuration validation purpose also. +These YANG models will be used to verify the configuration for SONiC switches, so a library which supports validation of configuration on SONiC Switch must use these YANG Models. List of such Libraries are: 1.) Configuration Validation Library. (CVL). YANG models, which are written using these guidelines can also be used as User End YANG Models, i.e North Bound configuration tools or CLI can provide config data in sync with these YANG models. For example [SONiC Management Framework](https://github.com/sonic-net/SONiC/pull/436) uses SONiC YANG models as Northbound Management YANG and for configuration validation purpose also. ## Guidelines @@ -53,13 +53,13 @@ module sonic-acl { } ``` -### 3. Define namespace as "http://github.com/Azure/{model-name}". +### 3. Define namespace as "http://github.com/sonic-net/{model-name}". Example : #### YANG ``` module sonic-acl { - namespace "http://github.com/Azure/sonic-acl"; + namespace "http://github.com/sonic-net/sonic-acl"; ..... ..... } @@ -633,7 +633,7 @@ module sonic-port { ``` module sonic-acl { - namespace "http://github.com/Azure/sonic-acl"; + namespace "http://github.com/sonic-net/sonic-acl"; prefix sacl; yang-version 1.1; diff --git a/doc/mgmt/sonic-acl.yang b/doc/mgmt/sonic-acl.yang index 4081d1d8ad..084efd7b95 100644 --- a/doc/mgmt/sonic-acl.yang +++ b/doc/mgmt/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/Azure/sonic-acl"; + namespace "http://github.com/sonic-net/sonic-acl"; prefix sacl; yang-version 1.1; diff --git a/doc/mgmt/sonic_stretch_management_vrf_design.md b/doc/mgmt/sonic_stretch_management_vrf_design.md index 811f6bca6a..31c0834fad 100644 --- a/doc/mgmt/sonic_stretch_management_vrf_design.md +++ b/doc/mgmt/sonic_stretch_management_vrf_design.md @@ -172,7 +172,7 @@ iface eth0 inet static If a default route was already present in management VRF, it is added to the "default" routing table which is part of default VRF. This is done when the eth0 interface comes up. When networking service is restarted, it will first bring down all existing interfaces. As part of "lo" down, previously created interface "lo-m" that was used as part of management VRF will be deleted. -These management VRF changes are implemented in the pull request [PR2585](https://github.com/Azure/sonic-buildimage/pull/2585) +These management VRF changes are implemented in the pull request [PR2585](https://github.com/sonic-net/sonic-buildimage/pull/2585) #### Config Commands @@ -236,7 +236,7 @@ Management NetWork Default Gateway = 10.16.210.254 root@sonic:/etc/init.d# ``` -These CLI commands are implemented as part of the pull request [PR463](https://github.com/Azure/sonic-utilities/pull/463) +These CLI commands are implemented as part of the pull request [PR463](https://github.com/sonic-net/sonic-utilities/pull/463) ### IP Application Design This section explains the behavior of each application on the default VRF and management VRF. Application functionality differs based on whether the application is used to connect to the application daemons running in the device or the application is triggered from the device. @@ -291,7 +291,7 @@ cgexec -g l3mdev:mgmt ssh 10.1.2.3 ##### TACACS TACACS is a library function that is used by applications like SSHD to authenticate the users. When users connect to the device using SSH and if the "aaa" authentication is configured to use the tacacs+, it is expected that device shall connect to the tacacs+ server via management port and authenticate the user. TACACS implementation contains two sub-modules, viz, NSS and PAM. These module codes is enhanced to support an additional parameter "--use-mgmt-vrf" while configuring the tacacs+ server IP address. When user specifies the --use-mgmt-vrf as part of "config tacacs add --use-mgmt-vrf " command, this is passed as an additional parameter to the config_db's TACPLUS_SERVER tag. This additional parameter is read using the files/image_config/hostcfgd/common-auth-sonic.j2 & files/image_config/hostcfgd/tacplus_nss.conf.j2 and the information is added to the tacplus configuration files /etc/tacplus_nss.conf and /etc/pam.d/common-auth-sonic. When SSHD uses the tacacs+ authentication using the API "pam_authenticate", enhanced tacacs+ code shall read the additional configuration related to vrfname "mgmt" associated with the tacac+ server and then it uses SO_BINDTODEVICE to attach the socket to the "mgmt" interface. Once if the socket is attached to "mgmt" interface, all tacacs+ traffic shall be routed via the management interface. -Code changes required in PAM & NSS are completed. [PR2217](https://github.com/Azure/sonic-buildimage/pull/2217) & [PR346](https://github.com/Azure/sonic-utilities/pull/346) address the same. +Code changes required in PAM & NSS are completed. [PR2217](https://github.com/sonic-net/sonic-buildimage/pull/2217) & [PR346](https://github.com/sonic-net/sonic-utilities/pull/346) address the same. As explained in the PR, tacacs PAM & NSS module had been enhanced to parse and process the "vrfname" and to setsockopt using SO_BINDTODEVICE for "mgmt" interface. Added an optional parameter "-m" (or --use-mgmt-vrf) for the "tacacs" command. The optional parameter "-m" used while configuring tacacs server results in configuring the DB with vrfname as "mgmt". Files "files/image_config/hostcfgd/common-auth-sonic.j2" and "files/image_config/hostcfgd/tacplus_nss_conf.j2" are modified to read this optional parameter and update the PAM & NSS configuration files "/etc/pam.d/common-auth" and "/etc/tacplus_nss.conf" respectively with the vrfname. After enhancing the code for NSS in the file nss_tacplus.c for parsing the vrfname and passing it to the connect library function "tac_connect_single", git patch "0003-management-vrf-support.patch" was generated and checked in. @@ -324,7 +324,7 @@ TACPLUS_SERVER address 10.11.55.41 2. cURL from device: Works for default VRF as usual. For cURL via management interface, use "cgexec -g l3mdev:mgmt" as prefix. #### SNMP -1. snmp to the device: SNMP being an UDP application, Linux netsmp 5.7.3 patch for VRF support is patched with SONiC sources. [PR2608](https://github.com/Azure/sonic-buildimage/pull/2608) and [PR472](https://github.com/Azure/sonic-utilities/pull/472) contains the changes done for SNMP. +1. snmp to the device: SNMP being an UDP application, Linux netsmp 5.7.3 patch for VRF support is patched with SONiC sources. [PR2608](https://github.com/sonic-net/sonic-buildimage/pull/2608) and [PR472](https://github.com/sonic-net/sonic-utilities/pull/472) contains the changes done for SNMP. 2. snmp traps from device: netsnmp 5.7.3 Linux patch has VRF support for traps. Conifuguration file needs to specify VRF name. Above mentioned PRs handle the required changes. #### NTP @@ -342,9 +342,9 @@ Since this file "/etc/init.d/ntp" is part of the default NTP package from debian In addtion to this change, NTP has got linux commands like "ntpq" which communicates with "ntpd" using the loopback IP address 127.0.0.1. Hence, a dummy interface "lo-m" is created and enslaved into "mgmt" and configured with the IP address 127.0.0.1 -These NTP changes are done as part of the pull request [PR3204](https://github.com/Azure/sonic-buildimage/pull/3204) +These NTP changes are done as part of the pull request [PR3204](https://github.com/sonic-net/sonic-buildimage/pull/3204) -Similarly, the "show ntp" command is also enhanced to use "cgexec -g l3mdev:mgmt" as explained in the [PR627](https://github.com/Azure/sonic-utilities/pull/627) +Similarly, the "show ntp" command is also enhanced to use "cgexec -g l3mdev:mgmt" as explained in the [PR627](https://github.com/sonic-net/sonic-utilities/pull/627) #### DHCP Client DHCP client gets the IP address for the management ports from the DHCP server, since it is enabled on a per interface the IP address is received automatically. @@ -352,7 +352,7 @@ DHCP Client had already been enhanced to execute a "vrf" script as part of exit- This script does "no-op" when management VRF is not enabled (i.e. when eth0 is not in management vrf). With the script, eth0 is placed in a vrf and on startup it will get an IP address via dhcp. IP address changes or gateway changes are correctly reflected. -[PR2348](https://github.com/Azure/sonic-buildimage/pull/2348) handles these changes. +[PR2348](https://github.com/sonic-net/sonic-buildimage/pull/2348) handles these changes. #### DHCP Relay DHCP relay is expected to work via the default VRF. diff --git a/doc/multi_asic/SONiC_multi_asic_hld.md b/doc/multi_asic/SONiC_multi_asic_hld.md index 56b4ca6770..7587c57620 100644 --- a/doc/multi_asic/SONiC_multi_asic_hld.md +++ b/doc/multi_asic/SONiC_multi_asic_hld.md @@ -228,7 +228,7 @@ For multi asic platform, the bgp, lldp, teamd, swss, syncd and database dockers Systemd allows starting of multiple instances of a systemd service using service template. If foo@.service is a template service, we can start N number of foo service by starting foo@0.service, foo@1.service etc. The instance number is passed to service template itself as a parameter %i which is used to identify the instance number that is being passed. -Example: `https://github.com/Azure/sonic-buildimage/blob/master/files/build_templates/per_namespace/teamd.service.j2 ` +Example: `https://github.com/sonic-net/sonic-buildimage/blob/master/files/build_templates/per_namespace/teamd.service.j2 ` Each service file uses a start up script to start/stop corresponding docker. This script is updated to use the instance number. The changes are done so that the number of asics do not need to be defined during build-time and is identified during run-time. Systemd-generator binary runs during boot-up, before systemd runs and identifies the number of asics by reading /usr/share/sonic/device//asic.conf file. @@ -453,7 +453,7 @@ A new template file database_global.json.j2 is introduced which is used to gener #### 2.4.4.1. Infrastructure changes The dbconnector classes present in the sonic-py-swsssdk submodule viz. SoncV2Connector, ConfigDBConnector is enhanced to accept the namespace parameter to connect to the DB in a particular namesapce. The dbconnector in the sonic-swsscommon submodule viz DBConnector too will be enhanced to accept the namespace parameter. -Please refer [multi namespace db instance implementation document](https://github.com/Azure/SONiC/blob/master/doc/database/multi_namespace_db_instances.md) for more details. +Please refer [multi namespace db instance implementation document](https://github.com/sonic-net/SONiC/blob/master/doc/database/multi_namespace_db_instances.md) for more details. ### 2.4.5. Configuration CLIs diff --git a/doc/nat/nat_design_spec.md b/doc/nat/nat_design_spec.md index b012659ab3..fa53b76bdd 100644 --- a/doc/nat/nat_design_spec.md +++ b/doc/nat/nat_design_spec.md @@ -450,7 +450,7 @@ key = LOOPBACK_INTERFACE:loopback-name NAT_ZONE = 1*1DIGIT ; a number in the range 0-3 ``` -Please refer to the [schema](https://github.com/Azure/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. +Please refer to the [schema](https://github.com/sonic-net/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. ### 3.2.3 APP DB New tables are introduced to specify NAT translation entries. diff --git a/doc/nvgre_tunnel/nvgre_tunnel.md b/doc/nvgre_tunnel/nvgre_tunnel.md index 3bcabdc947..2a940584fe 100755 --- a/doc/nvgre_tunnel/nvgre_tunnel.md +++ b/doc/nvgre_tunnel/nvgre_tunnel.md @@ -56,7 +56,7 @@ At a high level the following should be supported: - User should be able to create VLAN to VSID mapper entries for the NVGRE tunnel - Both VLAN and Bridge to VSID mappers should be supported by the NVGRE tunnel - Only the decapsulation mappers supported -- YANG model should be created in order to auto-generate CLI by using the [SONiC CLI Auto-generation tool](https://github.com/Azure/SONiC/blob/master/doc/cli_auto_generation/cli_auto_generation.md). +- YANG model should be created in order to auto-generate CLI by using the [SONiC CLI Auto-generation tool](https://github.com/sonic-net/SONiC/blob/master/doc/cli_auto_generation/cli_auto_generation.md). - CLI for NVGRE tunnel Counters for NVGRE Tunnel are out of scope of this design document. @@ -132,9 +132,9 @@ The following orchestration agents will be added or modified. The flow diagrams ### High-Level Design The following sub-modules will be modified: -* [sonic-swss](https://github.com/Azure/sonic-swss) - will be extended with the new orchestration agent for NVGRE. -* [sonic-swss-common](https://github.com/Azure/sonic-swss-common) - will be extended with the new tables for ConfigDB. -* [sonic-utilities](https://github.com/Azure/sonic-utilities) - will be extened with the new CLI. +* [sonic-swss](https://github.com/sonic-net/sonic-swss) - will be extended with the new orchestration agent for NVGRE. +* [sonic-swss-common](https://github.com/sonic-net/sonic-swss-common) - will be extended with the new tables for ConfigDB. +* [sonic-utilities](https://github.com/sonic-net/sonic-utilities) - will be extened with the new CLI. #### Sequence diagrams @@ -197,7 +197,7 @@ module sonic-nvgre-tunnel { yang-version 1.1; - namespace "http://github.com/Azure/sonic-nvgre-tunnel"; + namespace "http://github.com/sonic-net/sonic-nvgre-tunnel"; prefix nvgre; import ietf-inet-types { @@ -417,7 +417,7 @@ The number of the tunnels are not limited by SONiC, but if ASIC vendor reach the ### Testing Requirements/Design -The tests will be implemented under the VS environment and will be placed - [sonic-swss/tests](https://github.com/Azure/sonic-swss/tree/master/tests) sub-module. +The tests will be implemented under the VS environment and will be placed - [sonic-swss/tests](https://github.com/sonic-net/sonic-swss/tree/master/tests) sub-module. #### Unit Test cases diff --git a/doc/passw_hardening/hld_password_hardening.md b/doc/passw_hardening/hld_password_hardening.md index 477f9e271b..5d9eded896 100644 --- a/doc/passw_hardening/hld_password_hardening.md +++ b/doc/passw_hardening/hld_password_hardening.md @@ -313,7 +313,7 @@ SPECIAL_CLASS = "True" / "False" //filename: sonic-passw.yang module sonic-passwh { yang-version 1.1; - namespace "http://github.com/Azure/sonic-passwh"; + namespace "http://github.com/sonic-net/sonic-passwh"; prefix passwh; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/doc/passw_hardening/sonic-passwh.yang b/doc/passw_hardening/sonic-passwh.yang index 120c98c51a..be1141b52f 100644 --- a/doc/passw_hardening/sonic-passwh.yang +++ b/doc/passw_hardening/sonic-passwh.yang @@ -1,6 +1,6 @@ module sonic-passwh { yang-version 1.1; - namespace "http://github.com/Azure/sonic-passwh"; + namespace "http://github.com/sonic-net/sonic-passwh"; prefix password; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/doc/pbh/pbh-design.md b/doc/pbh/pbh-design.md index 548de5c744..80018b8518 100644 --- a/doc/pbh/pbh-design.md +++ b/doc/pbh/pbh-design.md @@ -1052,7 +1052,7 @@ module sonic-pbh { yang-version 1.1; - namespace "http://github.com/Azure/sonic-pbh"; + namespace "http://github.com/sonic-net/sonic-pbh"; prefix pbh; import ietf-inet-types { @@ -1217,4 +1217,4 @@ PBH extended configuration test: ## 3.2 Data plane tests via PTF PBH will reuse and extend the existing test plan: -[Inner packet hashing test plan #759](https://github.com/Azure/SONiC/pull/759) +[Inner packet hashing test plan #759](https://github.com/sonic-net/SONiC/pull/759) diff --git a/doc/pcie-mon/pcie-monitoring-services-hld.md b/doc/pcie-mon/pcie-monitoring-services-hld.md index bb3dd62fb9..7ad736c435 100644 --- a/doc/pcie-mon/pcie-monitoring-services-hld.md +++ b/doc/pcie-mon/pcie-monitoring-services-hld.md @@ -40,7 +40,7 @@ For the convenience of implementation and reduce the time consuming, pcie-check. 2. `PcieUtil` will provide APIs `load_config_file`, `get_pcie_device` and `get_pcie_check` to get the expected PCIe device list and informations, to get the current PCIe device information, and check if any PCIe device is missing or if there is any PCIe bus error. -![pcieinfo_design](https://github.com/Azure/SONiC/blob/master/doc/pcieinfo_design.md) +![pcieinfo_design](https://github.com/sonic-net/SONiC/blob/master/doc/pcieinfo_design.md) ### 1.2 PCIe device configuration file ### @@ -96,7 +96,7 @@ PcieUtil calls this API to check the PCIe device status, following example code pcie-check.service will be started by systemd during boot up and it will spawn a thread to check PCIe device status and perform the rescan pci devices if there is any missing devices after rc.local.service is completed and it will update the state db with pcie device satus after the `pcieutil pcie-chek` call so that the dependent services/container or kernel driver can be started or stopped based on the status. Detailed flow as showed in below chart: -![](https://github.com/Azure/SONiC/blob/70a152f1b98e145c9f0771e7cda7a951d98a978e/images/pcie-check.svg) +![](https://github.com/sonic-net/SONiC/blob/70a152f1b98e145c9f0771e7cda7a951d98a978e/images/pcie-check.svg) ### 1.5 PCIe daemon `pcied` flow ### @@ -104,7 +104,7 @@ Detailed flow as showed in below chart: pcied will be started by PMON container will continue monitoring the PCIe device status during run time and it will check the PCIe device status periodically every 1 minute and update the state db when the status is checked. Detailed flow as showed in below chart: -![](https://github.com/Azure/SONiC/blob/70a152f1b98e145c9f0771e7cda7a951d98a978e/images/pcied.svg) +![](https://github.com/sonic-net/SONiC/blob/70a152f1b98e145c9f0771e7cda7a951d98a978e/images/pcied.svg) ### 1.6 STATE_DB keys and value ### diff --git a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md index 01922c48dc..7cd2a02456 100644 --- a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md +++ b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md @@ -22,7 +22,7 @@ The purpose is to test functionality of Asymmetric PFC on the SONIC based DUT, closely resembling production environment. ### Scope -The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. +The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. ### Testbed The test will run on the following testbeds: @@ -39,20 +39,20 @@ There is already existed PFC asymmetric test cases which use PTF to send traffic Test suite location -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py It requires several updates: 1. Packets sending speed can be increased by using multiprocessing instead of multithreading library. -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 Replace ```threading.Thread``` to use ```multiprocessing.Process``` instead. 2. Looks like there is a redundancy in generating configuration file for ARP responder. -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 Fix the loop to store file only once diff --git a/doc/pins/Packet_io.md b/doc/pins/Packet_io.md index cfd22220de..52707bd10d 100644 --- a/doc/pins/Packet_io.md +++ b/doc/pins/Packet_io.md @@ -156,7 +156,7 @@ The netdev port attributes are specified as below in the [copp_cfg.j2](https://g ``` -[Copporch.cpp](https://github.com/Azure/sonic-swss/blob/fb06c32b2e25e6057514e9455e997ff7edcb7340/orchagent/copporch.cpp) will parse the above fields and add the netdev port attributes for the CPU port and invoke the SAI hostif create API to create the netdev port for the new submit_to_ingress interface. +[Copporch.cpp](https://github.com/sonic-net/sonic-swss/blob/fb06c32b2e25e6057514e9455e997ff7edcb7340/orchagent/copporch.cpp) will parse the above fields and add the netdev port attributes for the CPU port and invoke the SAI hostif create API to create the netdev port for the new submit_to_ingress interface. P4Runtime will create a socket for the “submit_to_ingress†netdev port and write into this socket for packets marked to send to “submit_to_ingressâ€. Packets egressing out of the socket end up as incoming packets on the CPU port of the switch. The packets now follow the regular switch pipeline to get forwarded out. diff --git a/doc/pins/pins_hld.md b/doc/pins/pins_hld.md index a7588f8f7e..dad98fb5e0 100644 --- a/doc/pins/pins_hld.md +++ b/doc/pins/pins_hld.md @@ -284,10 +284,10 @@ Here is the full list of supplementary HLD docs: [packet-hld]: in_progress.md -[buildimage-repo]: https://github.com/Azure/sonic-buildimage +[buildimage-repo]: https://github.com/sonic-net/sonic-buildimage [p4c-repo]: https://github.com/p4lang/p4c -[swss-repo]: https://github.com/Azure/sonic-swss -[swss-common-repo]: https://github.com/Azure/sonic-swss-common +[swss-repo]: https://github.com/sonic-net/sonic-swss +[swss-common-repo]: https://github.com/sonic-net/sonic-swss-common [p4rt-spec-ref]: https://p4lang.github.io/p4runtime/spec/main/P4Runtime-Spec.html diff --git a/doc/platform/pde.md b/doc/platform/pde.md index a6a5735bbc..dd01bab7df 100644 --- a/doc/platform/pde.md +++ b/doc/platform/pde.md @@ -58,7 +58,7 @@ The requirements for the SONiC PDE are: 8. All platform drivers and device files will reside in their original SONiC locations as part of the PDE build process. 9. The PDE uses the base SONiC build generated Linux kernel, Debian bootstrap image, SAI, root filesystem, and other pre-compiled binaries necessary for booting the PDE ONIE image. 10. All PDE makefiles and associated supporting files reside in the base SONiC repository as part of the "sonic-buildimage" repository and will not interfere or execute as part of the normal SONiC build process. -11. The PDE supports the existing SONiC porting guide for adding new platform support. Please refer to [link](https://github.com/Azure/SONiC/wiki/Porting-Guide) for more information. +11. The PDE supports the existing SONiC porting guide for adding new platform support. Please refer to [link](https://github.com/sonic-net/SONiC/wiki/Porting-Guide) for more information. As the PDE New platform changes added in the PDE are seamlessly integrated into the SONiC base repository. diff --git a/doc/platform_api/new_platform_api.md b/doc/platform_api/new_platform_api.md index 42000a8000..08e3c8a59b 100644 --- a/doc/platform_api/new_platform_api.md +++ b/doc/platform_api/new_platform_api.md @@ -196,4 +196,4 @@ print("PSU 1 presence: {}".format(presence)) ### New Platform API Framework location -https://github.com/Azure/sonic-platform-common/tree/master/sonic_platform_base +https://github.com/sonic-net/sonic-platform-common/tree/master/sonic_platform_base diff --git a/doc/pmon/pmon-chassis-design.md b/doc/pmon/pmon-chassis-design.md index 304b8d0737..e2f751c8cc 100644 --- a/doc/pmon/pmon-chassis-design.md +++ b/doc/pmon/pmon-chassis-design.md @@ -422,7 +422,7 @@ Thermal 5 59 68 0 N/A N/A * Update per namespace port status - The pmon processes will need to run per-asic specific functinality ina a separate thread. Two approaches were discussed as part of the design: -* Approach-1 - Existing process and threads will connect/subscribe to all databases across per-asic namespace. This is the preferred approach and has been documented in https://github.com/Azure/SONiC/blob/master/doc/pmon/pmon_multiasic_design.md. +* Approach-1 - Existing process and threads will connect/subscribe to all databases across per-asic namespace. This is the preferred approach and has been documented in https://github.com/sonic-net/SONiC/blob/master/doc/pmon/pmon_multiasic_design.md. * Approach-2 - Create separate threads per-asic and that thread will connect/subscribe to databases in per-asic namespace. Approach-2 is outlined below for the sake of completeness. However, it is not the preferred approach. The maximum number of ports seen in a multi-asic environment for fixed platform or for line-cards in a chassis would not be greater than 64. Monitoring and subscribing for events for these ports can easily be accommodated by Approach-1. Additional management of per-asic threads will also add to the complexity of the design. #### Database Connections diff --git a/doc/pmon/pmon-enhancement-design.md b/doc/pmon/pmon-enhancement-design.md index 9845b97d89..bab0e5c212 100644 --- a/doc/pmon/pmon-enhancement-design.md +++ b/doc/pmon/pmon-enhancement-design.md @@ -138,7 +138,7 @@ All the peripheral devices data will be stored in state DB. #### 1.5.6 Transceiver Table -We have a transceiver related information DB schema defined in the [Xcvrd daemon design doc](https://github.com/Azure/SONiC/blob/master/doc/xrcvd/transceiver-monitor-hld.md#11-state-db-schema). +We have a transceiver related information DB schema defined in the [Xcvrd daemon design doc](https://github.com/sonic-net/SONiC/blob/master/doc/xrcvd/transceiver-monitor-hld.md#11-state-db-schema). To align with the output of the current show interface transceiver we need to extend Transceiver info Table with more information, as below: @@ -267,7 +267,7 @@ Currently Transceiver related CLI is fetching information by directly access the ### 2.6 PSU SNMP Agent re-factoring -After PSU status data post to state DB, SNMP agent will get PSU data from state DB instead of directly call platform psu plugin, related code in class [PowerStatusHandler](https://github.com/Azure/sonic-snmpagent/blob/master/src/sonic_ax_impl/mibs/vendor/cisco/ciscoEntityFruControlMIB.py#L13) will be changed accordingly. [PhysicalTableMIBUpdater](https://github.com/Azure/sonic-snmpagent/blob/master/src/sonic_ax_impl/mibs/ietf/rfc2737.py#L113) is a good example for updating MIB from state DB. +After PSU status data post to state DB, SNMP agent will get PSU data from state DB instead of directly call platform psu plugin, related code in class [PowerStatusHandler](https://github.com/sonic-net/sonic-snmpagent/blob/master/src/sonic_ax_impl/mibs/vendor/cisco/ciscoEntityFruControlMIB.py#L13) will be changed accordingly. [PhysicalTableMIBUpdater](https://github.com/sonic-net/sonic-snmpagent/blob/master/src/sonic_ax_impl/mibs/ietf/rfc2737.py#L113) is a good example for updating MIB from state DB. ### 2.7 Utilities for real-time data @@ -285,7 +285,7 @@ New base APIs were added for platform, chassis, watchdog, FAN and PSU. SFP and e Previously we have an issue with the old implementation, when adding a new platform API to the base class, have to implement it in all the platform plugins, or at least add a dummy stub to them, or it will fail on the platform that doesn't have it. This will be addressed in the new platform API design, not part of the work here. -Design doc for new platform API [design doc](https://github.com/Azure/SONiC/pull/285) and [code implementation PR](https://github.com/Azure/sonic-platform-common/pull/13) are available now. +Design doc for new platform API [design doc](https://github.com/sonic-net/SONiC/pull/285) and [code implementation PR](https://github.com/sonic-net/sonic-platform-common/pull/13) are available now. ## 4. Pmon daemons dynamically loading We have multi pmon daemons for different peripheral devices, like xcvrd for transceivers, ledd for front panel LEDs, etc. Later on we may add more for PSU, fan. diff --git a/doc/pmon/pmon_multiasic_design.md b/doc/pmon/pmon_multiasic_design.md index dc3106d9e0..118ec4a499 100644 --- a/doc/pmon/pmon_multiasic_design.md +++ b/doc/pmon/pmon_multiasic_design.md @@ -184,7 +184,7 @@ Here are the pros and cons of both the approaches, The swss-common::DBconnector class needs to be enhanced to use the **"namespace"** context information to connect to the DB instance in that namespace. The DB connector classes will have capability to parse the new "database\_global.json" file and retrieve the namespaces present in the platform and the database instances in each namespace. -Please refer [multi_namespace_db_instances design document](https://github.com/Azure/SONiC/blob/master/doc/database/multi_namespace_db_instances.md) for more details. +Please refer [multi_namespace_db_instances design document](https://github.com/sonic-net/SONiC/blob/master/doc/database/multi_namespace_db_instances.md) for more details. ## @@ -213,4 +213,4 @@ The snmp agent needs to connect to the STATE\_DB in different namespaces dependi 1. Which daemon in Sonic takes care of the **system/unit** LED's? -- It is being planned [https://github.com/Azure/sonic-buildimage/pull/4835](https://github.com/Azure/sonic-buildimage/pull/4835) +- It is being planned [https://github.com/sonic-net/sonic-buildimage/pull/4835](https://github.com/sonic-net/sonic-buildimage/pull/4835) diff --git a/doc/pmon/sonic_platform_test_plan.md b/doc/pmon/sonic_platform_test_plan.md index fbcc29560a..cf12a919ec 100644 --- a/doc/pmon/sonic_platform_test_plan.md +++ b/doc/pmon/sonic_platform_test_plan.md @@ -766,7 +766,7 @@ New automation required # Automation Design -This section outlines the design of scripts automating the SONiC platform test cases. The new pytest-ansible framework will be used. Sample code can be found [here](https://github.com/Azure/sonic-mgmt/tree/master/tests). +This section outlines the design of scripts automating the SONiC platform test cases. The new pytest-ansible framework will be used. Sample code can be found [here](https://github.com/sonic-net/sonic-mgmt/tree/master/tests). ## Folder Structure and Script Files The pytest framwork supports flexible test discovery. The plan is to put all platform related scripts under `tests/platform`. Command like `pytest tests/platform` would be able to discover all `test_*.py` and `*_test.py` under `tests/platform`. No entry script is required. diff --git a/doc/pmon/sonic_thermal_control_test_plan.md b/doc/pmon/sonic_thermal_control_test_plan.md index 66c0d5be50..feb974fff0 100644 --- a/doc/pmon/sonic_thermal_control_test_plan.md +++ b/doc/pmon/sonic_thermal_control_test_plan.md @@ -38,7 +38,7 @@ Since this feature is not related to traffic and network topology, all current t ### Ansible and Pytest -This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/Azure/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/Azure/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. +This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/sonic-net/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/sonic-net/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. #### Valid policy file diff --git a/doc/port-add-del-dynamically/dynamic_port_add_del_hld.md b/doc/port-add-del-dynamically/dynamic_port_add_del_hld.md index 076df35da4..90f729ec49 100644 --- a/doc/port-add-del-dynamically/dynamic_port_add_del_hld.md +++ b/doc/port-add-del-dynamically/dynamic_port_add_del_hld.md @@ -29,11 +29,11 @@ This document provides general information about ports creation or removal in SO This document describes the high level design of orchagent and the impact of creating/removing ports dynamically on other services. The design describes the current implementaion and suggestion to changes that needs to be implemented in order to fully support the dynamic create/remove of ports. ## Relevant PRs -[PR #7999 Allow cfggen to work on system without ports](https://github.com/Azure/sonic-buildimage/pull/7999)
    -[PR #1860 Remove buffer drop counter when port is deleted](https://github.com/Azure/sonic-swss/pull/1860)
    -[PR #1808 [swss]: Allow portsyncd to run on system without ports](https://github.com/Azure/sonic-swss/pull/1808)
    -[PR #2019 [orchagent] add & remove port counters dynamically each time port was added or removed](https://github.com/Azure/sonic-swss/pull/2019)
    -[PR #2022 Dynamic port configuration - add port buffer cfg to the port ref counter](https://github.com/Azure/sonic-swss/pull/2022)
    +[PR #7999 Allow cfggen to work on system without ports](https://github.com/sonic-net/sonic-buildimage/pull/7999)
    +[PR #1860 Remove buffer drop counter when port is deleted](https://github.com/sonic-net/sonic-swss/pull/1860)
    +[PR #1808 [swss]: Allow portsyncd to run on system without ports](https://github.com/sonic-net/sonic-swss/pull/1808)
    +[PR #2019 [orchagent] add & remove port counters dynamically each time port was added or removed](https://github.com/sonic-net/sonic-swss/pull/2019)
    +[PR #2022 Dynamic port configuration - add port buffer cfg to the port ref counter](https://github.com/sonic-net/sonic-swss/pull/2022)
    ## Design @@ -68,9 +68,9 @@ The Dynamic port add/remove configuration will be supported for all types of ini **Note:** This is a new type of init that was never tested and will be supported.
    The zero-port system is a special case of this feature.
    Few PRs were already added in order to support zero ports init:
    -[PR #7999 Allow cfggen to work on system without ports](https://github.com/Azure/sonic-buildimage/pull/7999)
    -[PR #1860 Remove buffer drop counter when port is deleted](https://github.com/Azure/sonic-swss/pull/1860)
    -[PR #1808 [swss]: Allow portsyncd to run on system without ports](https://github.com/Azure/sonic-swss/pull/1808)
    +[PR #7999 Allow cfggen to work on system without ports](https://github.com/sonic-net/sonic-buildimage/pull/7999)
    +[PR #1860 Remove buffer drop counter when port is deleted](https://github.com/sonic-net/sonic-swss/pull/1860)
    +[PR #1808 [swss]: Allow portsyncd to run on system without ports](https://github.com/sonic-net/sonic-swss/pull/1808)
    after init stage we can add/remove ports dynamically through redis call to add/remove entry to/from port table on config db ("PORT") @@ -156,7 +156,7 @@ In the current implementation these counters were created for all ports only aft ** Counters PR: **
    -[https://github.com/Azure/sonic-swss/pull/2019](https://github.com/Azure/sonic-swss/pull/2019) +[https://github.com/sonic-net/sonic-swss/pull/2019](https://github.com/sonic-net/sonic-swss/pull/2019) @@ -201,8 +201,8 @@ each time the snmpagent needs information from ports (oper_state, mtu, speed..) Listen to events on cfg port table and update transeiver information
    implemented on those PRs: -https://github.com/Azure/sonic-buildimage/pull/8422
    -https://github.com/Azure/sonic-platform-daemons/pull/212 +https://github.com/sonic-net/sonic-buildimage/pull/8422
    +https://github.com/sonic-net/sonic-platform-daemons/pull/212 ## Buffermgrd: @@ -253,7 +253,7 @@ Need to add to orchagent the ability to add the buffer configuration of a port a If we will not use this mechanism we will get a lot of SAI error and with this ref counter method we will receive only one warning. Also we wanted the buffer configuration to be the same as ACL/VLAN/INTERFACE configuration, which uses the ref counter for the dependencies, and before removing a port we check this ref counter. ** Buffer changes PR: **
    -[https://github.com/Azure/sonic-swss/pull/2022](https://github.com/Azure/sonic-swss/pull/2022) +[https://github.com/sonic-net/sonic-swss/pull/2022](https://github.com/sonic-net/sonic-swss/pull/2022) diff --git a/doc/port-config-refactor/port-config-refactor-design.md b/doc/port-config-refactor/port-config-refactor-design.md index 75a2193926..6dba5baece 100644 --- a/doc/port-config-refactor/port-config-refactor-design.md +++ b/doc/port-config-refactor/port-config-refactor-design.md @@ -10,27 +10,27 @@ ## 1. Overview -The file "port_config.ini" defines port name, index and other information. In current SONiC code, there is a module [portconfig.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py) to parse and collect all information in this file. However, there are also other places have code to parse "port_config.ini". To keep code clean, it would be better to make all those parse logic reuse [portconfig.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py). +The file "port_config.ini" defines port name, index and other information. In current SONiC code, there is a module [portconfig.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py) to parse and collect all information in this file. However, there are also other places have code to parse "port_config.ini". To keep code clean, it would be better to make all those parse logic reuse [portconfig.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py). -There are also open PRs to begin transitioning from the "port_config.ini" file to a new "platform.json" file. So if we keep all parse logic in [portconfig.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py), it will be easy to keep backward compatible. +There are also open PRs to begin transitioning from the "port_config.ini" file to a new "platform.json" file. So if we keep all parse logic in [portconfig.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py), it will be easy to keep backward compatible. ## 2. Changes in portconfig module -1. [portconfig.parse_port_config_file](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L28) return value should always contain the index of all ports even if "index" is not defined in "port_config.ini" because port index is used in other module. If there is no "index" defined, a 1-based auto-increment default value should be there. For now, there are still a few SKUs provided port_config.ini file with 0-based port index, all those port_config.ini files should be changed to 1-based. +1. [portconfig.parse_port_config_file](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L28) return value should always contain the index of all ports even if "index" is not defined in "port_config.ini" because port index is used in other module. If there is no "index" defined, a 1-based auto-increment default value should be there. For now, there are still a few SKUs provided port_config.ini file with 0-based port index, all those port_config.ini files should be changed to 1-based. ## 3. Files that contain "port_config.ini" related logic -1. [daemon_base.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). -2. [sfputilbase.py](https://github.com/Azure/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilbase.py) in [sonic-platform-common](https://github.com/Azure/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Currently sfptutilbase.py keeps 3 dictionaries and 1 list to store information gets from port_config.ini file. We will keep the current data structure of sfputilbase.py to avoid introduce too much changes which means that we need transform the output of portconfig.py to the existing data structure. -3. [sfputilhelper.py](https://github.com/Azure/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilhelper.py) in [sonic-platform-common](https://github.com/Azure/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Since the current logic in sfputilhelper.py and sfputilbase.py are very similar, it is suggested to put the logic in a common place and reuse it. -4. [main.py](https://github.com/Azure/sonic-utilities/blob/master/sfputil/main.py) in [sonic-utilities](https://github.com/Azure/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). -5. [util_base.py](https://github.com/Azure/sonic-utilities/blob/master/utilities_common/util_base.py) in [sonic-utilities](https://github.com/Azure/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/Azure/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). +1. [daemon_base.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). +2. [sfputilbase.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilbase.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Currently sfptutilbase.py keeps 3 dictionaries and 1 list to store information gets from port_config.ini file. We will keep the current data structure of sfputilbase.py to avoid introduce too much changes which means that we need transform the output of portconfig.py to the existing data structure. +3. [sfputilhelper.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilhelper.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Since the current logic in sfputilhelper.py and sfputilbase.py are very similar, it is suggested to put the logic in a common place and reuse it. +4. [main.py](https://github.com/sonic-net/sonic-utilities/blob/master/sfputil/main.py) in [sonic-utilities](https://github.com/sonic-net/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). +5. [util_base.py](https://github.com/sonic-net/sonic-utilities/blob/master/utilities_common/util_base.py) in [sonic-utilities](https://github.com/sonic-net/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). There are also some vendor specified code contains "port_config.ini" related logic, those code should be refactored by each vendor. ## 4. Dependency -[portconfig.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py) is defined in [sonic-config-engine](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-config-engine). In order to reuse this module: +[portconfig.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-config-engine/portconfig.py) is defined in [sonic-config-engine](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-config-engine). In order to reuse this module: 1. For those modules who have build-time unit test, they may declare sonic-config-engine as a build-time dependency in make rules. 2. For those modules who are installed in a docker, we must make sure sonic-config-engine is also installed in that docker, for example, pmon docker need reuse portconfig.py and it has sonic-config-engine installed. diff --git a/doc/port_auto_neg/port-auto-negotiation-design.md b/doc/port_auto_neg/port-auto-negotiation-design.md index 65f9e00064..d762e38fa1 100644 --- a/doc/port_auto_neg/port-auto-negotiation-design.md +++ b/doc/port_auto_neg/port-auto-negotiation-design.md @@ -678,10 +678,10 @@ Dynamic port breakout feature also introduces a hwsku.json file to describe the #### PMON xcvrd Consideration -While it is possible to use CLI/CONFIG_DB for setting the port auto negotiation attributes, this feature is also available via [media_settings.json](https://github.com/Azure/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) +While it is possible to use CLI/CONFIG_DB for setting the port auto negotiation attributes, this feature is also available via [media_settings.json](https://github.com/sonic-net/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) - **Interface Type** - Unfortunately, it's not straightforward for users to identify which interface type is most appropriate to the attached transceivers, and the link will not get up unless the connected devices are both advertising the same interface type. This requires domain knowledge, correct EERPOM information and the individual hardware datasheet review process. Hence it's recommended to use [media_settings.json](https://github.com/Azure/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) to automate the while process. A interface type update request from [media_settings.json](https://github.com/Azure/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) is triggered by the transceiver detection of pmon#xcvrd, which leverages **APPL_DB** instead of **CONFIG_DB**, hence the requests will not be blocked by **portsyncd**. If the interface type update request arrives when autoneg is enabled, it should alter the advertisement and restart the autoneg. That said, if the user has interface type configured in both CONFIG_DB and media_settings.json, it wouldn't be possible to predict which would take precedence as there is no logic giving one priority over other. Hence please be sure to use either CLI/CONFIG_DB or media_settings.json at a time, never have both of them activated. + Unfortunately, it's not straightforward for users to identify which interface type is most appropriate to the attached transceivers, and the link will not get up unless the connected devices are both advertising the same interface type. This requires domain knowledge, correct EERPOM information and the individual hardware datasheet review process. Hence it's recommended to use [media_settings.json](https://github.com/sonic-net/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) to automate the while process. A interface type update request from [media_settings.json](https://github.com/sonic-net/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) is triggered by the transceiver detection of pmon#xcvrd, which leverages **APPL_DB** instead of **CONFIG_DB**, hence the requests will not be blocked by **portsyncd**. If the interface type update request arrives when autoneg is enabled, it should alter the advertisement and restart the autoneg. That said, if the user has interface type configured in both CONFIG_DB and media_settings.json, it wouldn't be possible to predict which would take precedence as there is no logic giving one priority over other. Hence please be sure to use either CLI/CONFIG_DB or media_settings.json at a time, never have both of them activated. - **Pre-Emphasis** Typically, prior to some process, such as transmission over cable, or recording to phonograph record or tape, the input frequency range most susceptible to noise is boosted. This is referred to as "pre-emphasis" - before the process the signal will undergo. While this is rarely necessay to the native RJ45 ports, it's important to SFP/QSFP/QSFPDD ports. For optical arrangements (e.g. SR/LR/DR transceivers), the loss is miniscule. The loss budget allocated for the host PCB board is small, which implies the pre-emphasis calibrated is supposed to work regardless of the fiber cable attached. On the other hand, on passive media, there is a significant amount of frequency dependent loss and the channel loss can range up to the CR/KR loss spec. It is therefore important and useful to activate Link-Training to "train" the TX FIR in both directions to help equalize that loss. IEEE 802.3 Clause 72, Clause 73 and Clause 93 define the auto-negotiation and link-training support for CR/KR transceivers, while the support of opticals (e.g. SR/LR/DR) are never in the scope. On the other hand, when autoneg is enabled, the link-training will also be activated, and the link-training handshake will only get started after negotiation if autoneg is enabled. Furtherly, link-training is to dynamically tune hardware signals at runtime, as a result, the static pre-emphasis parameters in media_setting.json is not necessary and will not be taken into autoneg process. @@ -705,7 +705,7 @@ For sonic-utilities, we will leverage the existing unit test framework to test. 3. Test command `config interface type `. Verify the command return error if given invalid interface name or interface type. 4. Test command `config interface advertised-types `. Verify the command return error if given invalid interface name or interface type list. -For sonic-swss, there is an existing test case [test_port_an](https://github.com/Azure/sonic-swss/blob/master/tests/test_port_an.py). The existing test case covers autoneg and speed attributes on both direct and warm-reboot scenario. So new unit test cases need cover the newly supported attributes: +For sonic-swss, there is an existing test case [test_port_an](https://github.com/sonic-net/sonic-swss/blob/master/tests/test_port_an.py). The existing test case covers autoneg and speed attributes on both direct and warm-reboot scenario. So new unit test cases need cover the newly supported attributes: 1. Test attribute adv_speeds on both direct and warm-reboot scenario. Verify SAI_PORT_ATTR_ADVERTISED_SPEED is in ASIC_DB and has correct value. 2. Test attribute interface_type on both direct and warm-reboot scenario. Verify SAI_PORT_ATTR_INTERFACE_TYPE is in ASIC_DB and has correct value. diff --git a/doc/port_buffer_drop_counters/sonic_port_buffer_drop_counters.md b/doc/port_buffer_drop_counters/sonic_port_buffer_drop_counters.md index 4db44ab288..32c177564e 100644 --- a/doc/port_buffer_drop_counters/sonic_port_buffer_drop_counters.md +++ b/doc/port_buffer_drop_counters/sonic_port_buffer_drop_counters.md @@ -40,7 +40,7 @@ This document describes the motivation for port buffer drop counters and the cha # 1 Overview The main goal of this feature is to poll port level buffer drop counters in a safe way. -According to https://github.com/Azure/sonic-swss/pull/1308, +According to https://github.com/sonic-net/sonic-swss/pull/1308, > These counters are causing widespread issues in the master branch, so we're backing them out for now to be revisited in a later PR. They will likely need to be polled separately from the other counters, and on a longer interval, to avoid performance issues and conflicts. @@ -109,4 +109,4 @@ admin@sonic:~$ counterpoll port-buffer-drop disable ### 3.1.3 Setting new polling interval ``` admin@sonic:~$ counterpoll port-buffer-drop interval 30000 -``` \ No newline at end of file +``` diff --git a/doc/port_link_training/port-link-training-design.md b/doc/port_link_training/port-link-training-design.md index 18db296b67..e82369471f 100644 --- a/doc/port_link_training/port-link-training-design.md +++ b/doc/port_link_training/port-link-training-design.md @@ -52,7 +52,7 @@ The link-training hardware controls in this document is SAI specific, while the Link training is a process by which the transmitter and receiver on a high-speed serial link communicate with each other in order to tune their equalization settings. In theory, link training enables automatic tuning of the FIR filter for each channel in an ASIC to achieve the desired bit error rate (BER) -In current SONiC implementation, user can leverage the platform-specific [media_settings.json](https://github.com/Azure/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) to statically update the TX FIR per attached transceiver to improve BER. However, the ODM vendors rarely provide the pre-calibrated pre-emphasis for the CR/KR transceivers, which could result in the link reliability issues. +In current SONiC implementation, user can leverage the platform-specific [media_settings.json](https://github.com/sonic-net/SONiC/blob/master/doc/media-settings/Media-based-Port-settings.md) to statically update the TX FIR per attached transceiver to improve BER. However, the ODM vendors rarely provide the pre-calibrated pre-emphasis for the CR/KR transceivers, which could result in the link reliability issues. The IEEE 802.3 standard defines a set of link training protocols for various mediums, and the feature in this document is to focus on IEEE clause 72 and 93 to dynamically improve the link quality over the SFP coppers and backplanes. @@ -316,11 +316,11 @@ N/A #### Unit Test cases -For **sonic-swss**, we will leverage the existing [test_port.py](https://github.com/Azure/sonic-swss/blob/master/tests/test_port.py) for this. A few new test cases will be added: +For **sonic-swss**, we will leverage the existing [test_port.py](https://github.com/sonic-net/sonic-swss/blob/master/tests/test_port.py) for this. A few new test cases will be added: 1. Test attribute **link_training** on both direct and warm-reboot scenario. Verify SAI_PORT_ATTR_LINK_TRAINING_ENABLE is in ASIC_DB and has correct value. -For **sonic-utilities**, we will leverage the existing [unit test framework](https://github.com/Azure/sonic-utilities/tree/master/tests) for this. A few new test cases will be added: +For **sonic-utilities**, we will leverage the existing [unit test framework](https://github.com/sonic-net/sonic-utilities/tree/master/tests) for this. A few new test cases will be added: 1. Test command `config interface link-training `. Verify the command return error if given invalid interface_name or mode. diff --git a/doc/psud/PSU_daemon_design.md b/doc/psud/PSU_daemon_design.md index f3e9006263..9ec6551c0a 100644 --- a/doc/psud/PSU_daemon_design.md +++ b/doc/psud/PSU_daemon_design.md @@ -35,7 +35,7 @@ Now psud collects PSU data via platform API, and it also support platform plugin ## 3. DB schema for PSU -PSU number is stored in chassis table. Please refer to this [document](https://github.com/Azure/SONiC/blob/master/doc/pmon/pmon-enhancement-design.md), section 1.5.2. +PSU number is stored in chassis table. Please refer to this [document](https://github.com/sonic-net/SONiC/blob/master/doc/pmon/pmon-enhancement-design.md), section 1.5.2. PSU information is stored in PSU table: @@ -138,7 +138,7 @@ We define a few abnormal PSU events here. When any PSU event happens, syslog sho ### 5.2 Platform API change -Some abstract member methods need to be added to [psu_base.py](https://github.com/Azure/sonic-platform-common/blob/master/sonic_platform_base/psu_base.py) and vendor should implement these methods. +Some abstract member methods need to be added to [psu_base.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/psu_base.py) and vendor should implement these methods. ```python diff --git a/doc/qos/dynamically-headroom-calculation.md b/doc/qos/dynamically-headroom-calculation.md index 7145c0d4a7..c1b85a6ea1 100644 --- a/doc/qos/dynamically-headroom-calculation.md +++ b/doc/qos/dynamically-headroom-calculation.md @@ -131,7 +131,7 @@ Backward compatibility is supported in the following ways: In this section we will introduce the ways it is achieved. -Currently, the SONiC system starts buffer manager from swss docker by the `supervisor` according to the following settings in [`/etc/supervisor/conf.d/supervisord.conf`](https://github.com/Azure/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) in `swss` docker. For the traditional mode, the argument is `-l /usr/share/sonic/hwsku/pg_profile_lookup.ini` which means to load the pg lookup file. +Currently, the SONiC system starts buffer manager from swss docker by the `supervisor` according to the following settings in [`/etc/supervisor/conf.d/supervisord.conf`](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) in `swss` docker. For the traditional mode, the argument is `-l /usr/share/sonic/hwsku/pg_profile_lookup.ini` which means to load the pg lookup file. ```shell [program:buffermgrd] @@ -1431,7 +1431,7 @@ In APPL_DB there should be: Status: Open. - Decision: Should be. But there is issues in SONiC ["dynamic_th" parameter for lossless buffer profile can't be change on the fly.](https://github.com/Azure/sonic-buildimage/issues/3971) + Decision: Should be. But there is issues in SONiC ["dynamic_th" parameter for lossless buffer profile can't be change on the fly.](https://github.com/sonic-net/sonic-buildimage/issues/3971) 6. There are default headrooms for lossy traffic which are determined by SDK and SONiC isn't aware. Do they affect shared buffer calculation? Status: Closed. @@ -1442,7 +1442,7 @@ In APPL_DB there should be: Status: Closed. Decision: There should be a maxinum value of the accumulate PGs for port. This can be fetched from ASIC_DB. -8. Originally buffer configuration had been stored in APPL_DB but were moved to CONFIG_DB later. Why? [doc](https://github.com/Azure/SONiC/wiki/Converting-old-or-creating-new-buffers-config) for reference. +8. Originally buffer configuration had been stored in APPL_DB but were moved to CONFIG_DB later. Why? [doc](https://github.com/sonic-net/SONiC/wiki/Converting-old-or-creating-new-buffers-config) for reference. 9. In theory, when system starts, as `BUFFER_PROFILE` and `BUFFER_PG` tables are stored in config database which survives system reboot, the `Buffer Orch` can receive items of the tables ahead of they being recalculated by `Buffer Manager` based on the current algorithm and `cable length` and `speed`. If the headroom size calculated differs before and after reboot, it can cause the items in the tables be deployed twice in which the first deployment will be overwritten quickly by the second one. 10. For chassis systems the gearbox in variant line-cards can differ, which means a mapping from port/line-card to gearbox model is required to get the correct gearbox model for a port. This requires additional field defined in `PORT` table or some newly introduced table. As this part hasn't been defined in community, we will not discuss this case for now. diff --git a/doc/qos/tunnel_dscp_remapping.md b/doc/qos/tunnel_dscp_remapping.md index d20fc108cd..1ef2c35996 100644 --- a/doc/qos/tunnel_dscp_remapping.md +++ b/doc/qos/tunnel_dscp_remapping.md @@ -61,10 +61,10 @@ This design proposes a method to remapping DSCP and TC for tunnel traffic. ### 5.1 SWSS Schema #### 5.1.1 Define new table for mapping -Update [qos_config.j2](https://github.com/Azure/sonic-buildimage/blob/master/files/build_templates/qos_config.j2) to generate 4 tables for remapping. Currently, the remapping is required in `dual-tor` scenario. So the tables are rendered into `config_db` only when `DEVICE_METADATA['localhost']['subtype'] = 'DualToR`. +Update [qos_config.j2](https://github.com/sonic-net/sonic-buildimage/blob/master/files/build_templates/qos_config.j2) to generate 4 tables for remapping. Currently, the remapping is required in `dual-tor` scenario. So the tables are rendered into `config_db` only when `DEVICE_METADATA['localhost']['subtype'] = 'DualToR`. Please be noted that below config is to remap traffic in queue 3 to queue 2, and traffic in queue 4 to queue 6. -Before remapping to queue 2 and 6, both queues are required to be cleared. Hence the current `DSCP_TO_TC_MAP|AZURE` in [qos_config.j2](https://github.com/Azure/sonic-buildimage/blob/master/files/build_templates/qos_config.j2) is required to be updated. +Before remapping to queue 2 and 6, both queues are required to be cleared. Hence the current `DSCP_TO_TC_MAP|AZURE` in [qos_config.j2](https://github.com/sonic-net/sonic-buildimage/blob/master/files/build_templates/qos_config.j2) is required to be updated. * Table for decap DSCP_TO_TC_MAP for mapping DSCP to TC @@ -232,7 +232,7 @@ In current version, PFC watchdog will read `pfc_enable` to determine PFCWD is en } ``` -To support new field `pfc_wd_sw_enable`, [sonic-port-qos-map.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-port-qos-map.yang) is required to be updated. +To support new field `pfc_wd_sw_enable`, [sonic-port-qos-map.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-port-qos-map.yang) is required to be updated. ### 5.2 SAI attribute @@ -321,4 +321,4 @@ All changes are to be covered by system test. ## 7 Open Questions - \ No newline at end of file + diff --git a/doc/recirculation-port/recirculation_port.md b/doc/recirculation-port/recirculation_port.md index 26ab8b4205..a050b1e6dc 100644 --- a/doc/recirculation-port/recirculation_port.md +++ b/doc/recirculation-port/recirculation_port.md @@ -64,7 +64,7 @@ The support of explicit recycle ports requires the minimal changes to SAI as lon Recirculation ports are configured in port_config.ini or platform.json just like front panel ports. In order to distinguish recirculation from front panel ports, the appropriate port role must be set for recirculation ports. The port role must indicate the intended use of a recirculation port. SONiC can discover all configured recirculation ports, based on their port roles, and use them appropriately. -As of now, there are two use cases of recirculation ports: inband port [here](https://github.com/Azure/SONiC/blob/master/doc/voq/architecture.md), or features like Everflow that needs to recycle encapsulated packets to be routed to the egress ASIC [here](https://github.com/Azure/SONiC/pull/716/files). In order to ensure the right recirculation ports are used, we introduce two port roles, Inb and Rec, for the two use cases respectively. +As of now, there are two use cases of recirculation ports: inband port [here](https://github.com/sonic-net/SONiC/blob/master/doc/voq/architecture.md), or features like Everflow that needs to recycle encapsulated packets to be routed to the egress ASIC [here](https://github.com/sonic-net/SONiC/pull/716/files). In order to ensure the right recirculation ports are used, we introduce two port roles, Inb and Rec, for the two use cases respectively. Two recirculation ports, Ethernet-Rec0 and Ethernet-IB0, are configured in the example port_config.ini below. Ethernet-Rec0 is used by Everflow, which has port role Rec. Ethernet-IB0 is used as an inband port and thus its port role is set to Inb. The recirculation port's lanes, used to discover the corresponding SAI ports, must be provided in port_config.ini as well. @@ -113,4 +113,4 @@ The process of recirculation ports in SWSS container is similar to front panel p ## 1.4 SAI -ASIC vendoers may implement recirculation ports in different ways. If recirculation ports are implemented just like front panel ports, then no SAI change is required because recirculation ports can be initialized and configured by using existing SAI port API. \ No newline at end of file +ASIC vendoers may implement recirculation ports in different ways. If recirculation ports are implemented just like front panel ports, then no SAI change is required because recirculation ports can be initialized and configured by using existing SAI port API. diff --git a/doc/sflow/Sflow_test_plan.md b/doc/sflow/Sflow_test_plan.md index 7eb48dae55..8f55850935 100644 --- a/doc/sflow/Sflow_test_plan.md +++ b/doc/sflow/Sflow_test_plan.md @@ -14,7 +14,7 @@ The test is targeting a running SONIC system with fully functioning configuratio The test will run on the t0 testbed: -![testbed-t0.png](https://github.com/Azure/sonic-mgmt/blob/master/ansible/doc/img/testbed-t0.png?raw=true) +![testbed-t0.png](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/doc/img/testbed-t0.png?raw=true) - 1 port from each port channel is used for traffic. Sflow is enabled on these 4 ports - 2 ports from Vlan1000 are removed and used to reach sflow collector in ptf docker . diff --git a/doc/sfp-cmis/Interface-Link-bring-up-sequence.md b/doc/sfp-cmis/Interface-Link-bring-up-sequence.md index 227c0d4176..9a993ad6cc 100644 --- a/doc/sfp-cmis/Interface-Link-bring-up-sequence.md +++ b/doc/sfp-cmis/Interface-Link-bring-up-sequence.md @@ -194,10 +194,10 @@ Following items are not in the scope of this document. They would be taken up se - Cleanup scenario - Check if the host_tx_ready field in STATE-DB need to be updated to “False†for any use-case, either in going down or coming up path - Discuss further on the possible use-cases 3. CMIS API feature is not part of this design and the APIs will be used in this design. For CMIS HLD, Please refer to: - https://github.com/Azure/SONiC/blob/9d480087243fd1158e785e3c2f4d35b73c6d1317/doc/sfp-cmis/cmis-init.md + https://github.com/sonic-net/SONiC/blob/9d480087243fd1158e785e3c2f4d35b73c6d1317/doc/sfp-cmis/cmis-init.md 4. Error handling of SAI attributes a) At present, If there is a set attribute failure, orch agent will exit. - Refer the error handling API : https://github.com/Azure/sonic-swss/blob/master/orchagent/orch.cpp#L885 + Refer the error handling API : https://github.com/sonic-net/sonic-swss/blob/master/orchagent/orch.cpp#L885 b) Error handling for SET_ADMIN_STATUS attribute will be added in future. c) A propabale way to handle the failure is to set a error handling attribute to respective container syncd/GBsyncd with attribute that is failed. The platform layer knows the error better and it will try to recover. diff --git a/doc/snmp/extension-to-physical-entity-mib.md b/doc/snmp/extension-to-physical-entity-mib.md index 92cc2665b0..4453606ece 100644 --- a/doc/snmp/extension-to-physical-entity-mib.md +++ b/doc/snmp/extension-to-physical-entity-mib.md @@ -364,7 +364,7 @@ Port Sensor Type describes below: #### 1.5.1 Unit test -SNMP unit test for sensors (https://github.com/Azure/sonic-snmpagent/blob/master/tests/test_sensor.py) will be extended to cover all the new added MIB objects and physical components. +SNMP unit test for sensors (https://github.com/sonic-net/sonic-snmpagent/blob/master/tests/test_sensor.py) will be extended to cover all the new added MIB objects and physical components. #### 1.5.2 Community regression test @@ -374,7 +374,7 @@ New test cases will be added to cover the new MIB entries: 2. Get fan MIB info and cross-check with the FAN_INFO table. 3. Get PSU related MIB info and cross-check with PSU_INFO and related tables 4. Remove/Add DB entries from related tables to see whether MIB info can be correctly updated. -5. Currently, each platform API is tested by sonic-mgmt, see [here](https://github.com/Azure/sonic-mgmt/tree/master/tests/platform_tests/api). We will add regression test case for each newly added platform API to verify them. +5. Currently, each platform API is tested by sonic-mgmt, see [here](https://github.com/sonic-net/sonic-mgmt/tree/master/tests/platform_tests/api). We will add regression test case for each newly added platform API to verify them. ## 2. Entity Sensor MIB Extension @@ -435,8 +435,8 @@ PSU Power Sensor: #### 2.3.1 Unit test -SNMP unit test for sensors (https://github.com/Azure/sonic-snmpagent/blob/master/tests/test_sensor.py) will be extended to cover all the new added sensors MIB objects. +SNMP unit test for sensors (https://github.com/sonic-net/sonic-snmpagent/blob/master/tests/test_sensor.py) will be extended to cover all the new added sensors MIB objects. #### 2.3.2 Community regression test -SNMP Entity community regression test (https://github.com/Azure/sonic-mgmt/blob/master/tests/snmp/test_snmp_phy_entity.py) will be extended to cover all the new added sensors. +SNMP Entity community regression test (https://github.com/sonic-net/sonic-mgmt/blob/master/tests/snmp/test_snmp_phy_entity.py) will be extended to cover all the new added sensors. diff --git a/doc/snmp/snmp-configdb-migration-hld.md b/doc/snmp/snmp-configdb-migration-hld.md index 942f748d21..07a09bfaaa 100644 --- a/doc/snmp/snmp-configdb-migration-hld.md +++ b/doc/snmp/snmp-configdb-migration-hld.md @@ -18,7 +18,7 @@ The goal of this update is to move away from the snmp.yml file and move towards # Config DB ## SNMP SCHEMA Some new "SNMP" tables should be added to ConfigDB in order to store SNMP related configuration. -https://github.com/Azure/SONiC/blob/master/doc/snmp/snmp-schema-addition.md +https://github.com/sonic-net/SONiC/blob/master/doc/snmp/snmp-schema-addition.md The new SNMP tables are: SNMP diff --git a/doc/sonic-application-extension/img/docker-infra-concepts.svg b/doc/sonic-application-extension/img/docker-infra-concepts.svg index 2f6c3af628..b29967c7b7 100644 --- a/doc/sonic-application-extension/img/docker-infra-concepts.svg +++ b/doc/sonic-application-extension/img/docker-infra-concepts.svg @@ -54,7 +54,7 @@ Sheet.13 Rounded Rectangle.2 - Azure/sonic-dhcp-relay + sonic-net/sonic-dhcp-relay @@ -78,10 +78,10 @@ - Azure/sonic-dhcp-relay + sonic-net/sonic-dhcp-relay

    n;{P2FB#@zD1;}8g^JYC? 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%0AsO&VM$P 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 literal 0 HcmV?d00001 diff --git a/doc/event-alarm-framework/event-alarm-framework-blockdiag.png b/doc/event-alarm-framework/event-alarm-framework-blockdiag.png new file mode 100644 index 0000000000000000000000000000000000000000..d735f9b1b352b4dea25f267a6701b07e444c60ee GIT binary patch literal 193926 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

     Rounded Rectangle.3 - Azure/sonic-snmp + sonic-net/sonic-snmp @@ -105,7 +105,7 @@ - Azure/sonic-snmp + sonic-net/sonic-snmp Sheet.8 diff --git a/doc/sonic-application-extension/img/packages-json.svg b/doc/sonic-application-extension/img/packages-json.svg index 73fdbd3a5a..1ca92f5b24 100644 --- a/doc/sonic-application-extension/img/packages-json.svg +++ b/doc/sonic-application-extension/img/packages-json.svg @@ -86,7 +86,7 @@ Sheet.24 Rounded Rectangle.2 - Azure/sonic-dhcp-relay + sonic-net/sonic-dhcp-relay @@ -110,10 +110,10 @@ - Azure/sonic-dhcp-relay + sonic-net/sonic-dhcp-relay Rounded Rectangle.3 - Azure/sonic-snmp + sonic-net/sonic-snmp @@ -137,7 +137,7 @@ - Azure/sonic-snmp + sonic-net/sonic-snmp Sheet.27 diff --git a/doc/sonic-application-extension/sonic-application-extension-guide.md b/doc/sonic-application-extension/sonic-application-extension-guide.md index 0f22ff5eb9..4f6f2f5f57 100644 --- a/doc/sonic-application-extension/sonic-application-extension-guide.md +++ b/doc/sonic-application-extension/sonic-application-extension-guide.md @@ -30,7 +30,7 @@ It is recommended to get acquainted with [HLD](sonic-application-extention-hld.m It is possible to port existing SONiC docker image and make it an Application Extension. -An example of porting DHCP relay - https://github.com/Azure/sonic-buildimage/commit/b3b6938fda9244607fb00bfd36a74bccab0c38a9. +An example of porting DHCP relay - https://github.com/sonic-net/sonic-buildimage/commit/b3b6938fda9244607fb00bfd36a74bccab0c38a9. 1. Add a new build time flag to SONiC build system to control whether to include new Docker Image *XXX*: @@ -63,7 +63,7 @@ $(DOCKER_XXX)_CONTAINER_VOLUMES += /usr/share/sonic/scripts:/usr/share/sonic/scr $(DOCKER_XXX)_CONTAINER_TMPFS += /tmp/ ```` -These variables are used to generate manifest for docker at build time (see generate_manifest function in https://github.com/Azure/sonic-buildimage/blob/master/rules/functions): +These variables are used to generate manifest for docker at build time (see generate_manifest function in https://github.com/sonic-net/sonic-buildimage/blob/master/rules/functions): 4. For extensions that provide CLI commands a CLI plugin is needed. @@ -124,7 +124,7 @@ Modify files/build_templates/packages.json.j2 to include new package. Example fo ### Building SONiC image with 3rd party application To build SONiC image with 3rd party application pre-installed use SONIC_PACKAGES target group. -See https://github.com/Azure/sonic-buildimage/blob/master/rules/sonic-packages.mk. +See https://github.com/sonic-net/sonic-buildimage/blob/master/rules/sonic-packages.mk. Create a file under rules/ called rules/cpu-report.mk with the following content: ```makefile diff --git a/doc/sonic-application-extension/sonic-application-extention-hld.md b/doc/sonic-application-extension/sonic-application-extention-hld.md index 50dbfb10eb..7288308f0d 100644 --- a/doc/sonic-application-extension/sonic-application-extention-hld.md +++ b/doc/sonic-application-extension/sonic-application-extention-hld.md @@ -156,14 +156,14 @@ Basic definitions: There are three notions: *package*, *repository* and *registry*. A repository is a Docker registry (private or open like Docker Hub) repository with tagged images for specific package. -In the above figure *Azure/sonic-dhcp-relay* and *Azure/sonic-snmp* are repositories with a set of images. +In the above figure *sonic-net/sonic-dhcp-relay* and *sonic-net/sonic-snmp* are repositories with a set of images. ### SONiC Package SONiC Packages must meet few requirements in order to be a SONiC compatible Docker image. - A package must provide a manifest as part of the Docker image. -- Requirement on the container state recording by [Kubernetes HLD](https://github.com/Azure/SONiC/blob/698e8d7991c0ca3d21b4488cf336efcfe891ef9a/doc/kubernetes/Kuberenetes-support.md)). +- Requirement on the container state recording by [Kubernetes HLD](https://github.com/sonic-net/SONiC/blob/698e8d7991c0ca3d21b4488cf336efcfe891ef9a/doc/kubernetes/Kuberenetes-support.md)). ###### Figure 2. High Level Overview of SONiC Package integration @@ -254,13 +254,13 @@ A sample of the content in JSON format: "installed-version": "1.0.0" }, "dhcp-relay": { - "repository": "Azure/sonic-dhcp-relay", + "repository": "sonic-net/sonic-dhcp-relay", "description": "DHCP relay feature", "default-reference": "sha256:5d41c289942008211c2964bca72800f5c9d5ea5aa4057528da617fb36463d4ab", "status": "not-installed" }, "snmp": { - "repository": "Azure/sonic-snmp", + "repository": "sonic-net/sonic-snmp", "description": "Simple Network Monitoring Protocol", "default-reference": "1.0.0", "status": "installed", @@ -945,7 +945,7 @@ be auto-generated as well. To avoid re-generating *swss.sh* script we will put d The file path is chosen to be */etc/sonic/\_dependent* for single instance services and */etc/sonic/\_dependent_multi_inst_dependent* for multi instance services. -Example of required code change for swss is given below [swss.sh](https://github.com/Azure/sonic-buildimage/blob/master/files/scripts/swss.sh): +Example of required code change for swss is given below [swss.sh](https://github.com/sonic-net/sonic-buildimage/blob/master/files/scripts/swss.sh): ```bash DEPENDENT="radv dhcp_relay" @@ -961,9 +961,9 @@ The infrastructure is not deciding whether this script is needed for a particula container lifetime hooks provided by a feature, instead this script is always generated and if no specific actions descirbed above are needed it becomes a simple wrapper around a script under /usr/bin/. -Examples are [swss.sh](https://github.com/Azure/sonic-buildimage/blob/master/files/scripts/swss.sh), -[syncd.sh](https://github.com/Azure/sonic-buildimage/blob/master/files/scripts/syncd.sh), -[bgp.sh](https://github.com/Azure/sonic-buildimage/blob/master/files/scripts/bgp.sh). These scripts +Examples are [swss.sh](https://github.com/sonic-net/sonic-buildimage/blob/master/files/scripts/swss.sh), +[syncd.sh](https://github.com/sonic-net/sonic-buildimage/blob/master/files/scripts/syncd.sh), +[bgp.sh](https://github.com/sonic-net/sonic-buildimage/blob/master/files/scripts/bgp.sh). These scripts share a good amount of code, thus making it possible to templatize into a single script that can be parametrized during generation according to feature needs - place lifecycle action hooks and dependent service management. @@ -984,7 +984,7 @@ after installation all the service scripts under */usr/local/bin/* are re-genera ##### /usr/bin/*feature*.sh The script under /usr/bin/ starts, stops or waits for container exit. This script is auto-generated during build time from -[docker_image_ctl.j2](https://github.com/Azure/sonic-buildimage/blob/4006ce711fa6545b0870186ffa05d4df24edb8b7/files/build_templates/docker_image_ctl.j2). +[docker_image_ctl.j2](https://github.com/sonic-net/sonic-buildimage/blob/4006ce711fa6545b0870186ffa05d4df24edb8b7/files/build_templates/docker_image_ctl.j2). To allow a runtime package installation, it is required to have this file as part of SONiC image and put it in */usr/share/sonic/templates/docker_image_ctl.j2*. The Jinja2 template will accept three arguments, *docker_container_name*, *docker_image_name* and *docker_run_options*, which derive from the */container/* node from manifest. Besides of options @@ -1136,7 +1136,7 @@ ave to be also auto-generated from YANG in the future. ### SONiC Processes and Docker Statistics Telemetry Support -[Processes And Docker Stats Telemetry HLD](https://github.com/Azure/SONiC/blob/master/doc/system-telemetry/process-docker-stats.md) +[Processes And Docker Stats Telemetry HLD](https://github.com/sonic-net/SONiC/blob/master/doc/system-telemetry/process-docker-stats.md) This feature should be supported by SONiC Application Extension without any changes to existing feature implementation. @@ -1146,7 +1146,7 @@ SONiC controls optional feature (aka services) via FEATURE table in CONFIG DB. O it must be treated in the same way as any optional SONiC feature. The SONiC package installation process will register new feature in CONFIG DB. -[Optional Feature HLD Reference](https://github.com/Azure/SONiC/blob/master/doc/Optional-Feature-Control.md) +[Optional Feature HLD Reference](https://github.com/sonic-net/SONiC/blob/master/doc/Optional-Feature-Control.md) Features are configured in *FEATURE* table in *CONFIG DB* and backend - *hostcfgd* daemon - enables, disables features according to the configuration. Default desired state for a SONiC Application Extension is "disabled". After installation, user can enable the feature: @@ -1308,7 +1308,7 @@ admin@sonic:~$ sudo sonic-installer install -y sonic.bin --no-package-migration ### Kubernetes & SONiC Application Extension -[Kubernetes HLD](https://github.com/Azure/SONiC/blob/be12cc665c316348352b868f515714f202861f63/doc/kubernetes/Kubernetes-support.md) +[Kubernetes HLD](https://github.com/sonic-net/SONiC/blob/be12cc665c316348352b868f515714f202861f63/doc/kubernetes/Kubernetes-support.md) This section is WIP and describes the approach in very high level and needs more deep investigation. diff --git a/doc/sonic-build-system/build-enhancements.md b/doc/sonic-build-system/build-enhancements.md index a86ae53750..e7e34a931e 100644 --- a/doc/sonic-build-system/build-enhancements.md +++ b/doc/sonic-build-system/build-enhancements.md @@ -80,7 +80,7 @@ This feature provides improvements in three essential areas. Reference: - Version caching feature is enhanced on top of DPKG caching and Versioning framework. Ref: - - https://github.com/Azure/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt + - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt - https://github.com/xumia/SONiC/blob/repd3/doc/sonic-build-system/SONiC-Reproduceable-Build.md # Feature Requirements @@ -557,5 +557,5 @@ files/build/versions/ ## References - Ref: - - https://github.com/Azure/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt + - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt - https://github.com/xumia/SONiC/blob/repd3/doc/sonic-build-system/SONiC-Reproduceable-Build.md diff --git a/doc/sonic-build-system/build_system_improvements.md b/doc/sonic-build-system/build_system_improvements.md index 99342ab3cf..122bdf1d7e 100644 --- a/doc/sonic-build-system/build_system_improvements.md +++ b/doc/sonic-build-system/build_system_improvements.md @@ -155,7 +155,7 @@ If your package can be built in parallel, please either use compat 10 or pass -- ## Seperate sairedis RPC from non-RPC build -Some work is done on that but no PR (https://github.com/Azure/sonic-sairedis/issues/333) +Some work is done on that but no PR (https://github.com/sonic-net/sonic-sairedis/issues/333) sairedis is a dependency for a lot of targets (usually I see sairedis compilation takes a lot of time blocking other targets to start) diff --git a/doc/sonic-flags/control-sonic-behaviors-with-sonic-flags.md b/doc/sonic-flags/control-sonic-behaviors-with-sonic-flags.md index 51015a5fe8..a7787a2860 100644 --- a/doc/sonic-flags/control-sonic-behaviors-with-sonic-flags.md +++ b/doc/sonic-flags/control-sonic-behaviors-with-sonic-flags.md @@ -83,7 +83,7 @@ Below is a sample of `SYSTEM_DEFAULTS` table #### 5.2.1 Set default value with `init_cfg.json` The default value of flags in `SYSTEM_DEFAULTS` table can be set in `init_cfg.json` and loaded into db at system startup. These flags are usually set at image being build, and are unlikely to change at runtime. -If the values in `config_db.json` is changed by user, it will not be rewritten back by `init_cfg.json` as `config_db.json` is loaded after `init_cfg.json` in [docker_image_ctl.j2](https://github.com/Azure/sonic-buildimage/blob/master/files/build_templates/docker_image_ctl.j2) +If the values in `config_db.json` is changed by user, it will not be rewritten back by `init_cfg.json` as `config_db.json` is loaded after `init_cfg.json` in [docker_image_ctl.j2](https://github.com/sonic-net/sonic-buildimage/blob/master/files/build_templates/docker_image_ctl.j2) ``` if [ -r /etc/sonic/config_db$DEV.json ]; then @@ -128,7 +128,7 @@ The `SYSTEM_DEFAULTS` table can be subscribed by components that are interested 2. Templates that depend on `DEVICE_METADATA|localhost` table are required to be updated. ### 6.2 Yang model update -A new Yang model is to be added to restrict the valid flags in `SYSTEM_DEFAULTS` table. The existing entries for flags in current [sonic-device_metadata.yang](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-device_metadata.yang) are to be removed. +A new Yang model is to be added to restrict the valid flags in `SYSTEM_DEFAULTS` table. The existing entries for flags in current [sonic-device_metadata.yang](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-device_metadata.yang) are to be removed. ### 6.3 Code change 1. Update `db_migrator.py` to migrate flags from `DEVICE_METADATA|localhost` table to `SYSTEM_DEFAULTS` table. Current flags include diff --git a/doc/ssdhealth_design.md b/doc/ssdhealth_design.md index 886ba826db..4d111cc84c 100644 --- a/doc/ssdhealth_design.md +++ b/doc/ssdhealth_design.md @@ -136,7 +136,7 @@ Location: `sonic-buildimage/device/{{vendor}}/platform/plugins/ssdutil.py` ## Utilities and packages #### smartctl Part of smartmontools package (1.9M) -PR: [https://github.com/Azure/sonic-buildimage/pull/2703](https://github.com/Azure/sonic-buildimage/pull/2703) +PR: [https://github.com/sonic-net/sonic-buildimage/pull/2703](https://github.com/sonic-net/sonic-buildimage/pull/2703) #### iSmart Utility for InnoDisk Corp. SSDs (<120K) diff --git a/doc/subport/sonic-sub-port-intf-hld.md b/doc/subport/sonic-sub-port-intf-hld.md index cf5db32ec9..e126396765 100644 --- a/doc/subport/sonic-sub-port-intf-hld.md +++ b/doc/subport/sonic-sub-port-intf-hld.md @@ -750,16 +750,16 @@ Wenda would like to thank his colleagues with Microsoft SONiC team, Shuotian, Pr [2] Remove the need to create an object id for vlan in creating a sub port router interface https://github.com/opencomputeproject/SAI/pull/998 -[3] Sub port interface schema https://github.com/Azure/sonic-swss-common/pull/284 +[3] Sub port interface schema https://github.com/sonic-net/sonic-swss-common/pull/284 -[4] Sub port interface implementation https://github.com/Azure/sonic-swss/pull/969 +[4] Sub port interface implementation https://github.com/sonic-net/sonic-swss/pull/969 -[5] Use dot1p in packet 802.1q tag to map a packet to traffic class (TC) inside a switch pipeline https://github.com/Azure/sonic-swss/pull/871; https://github.com/Azure/sonic-buildimage/pull/3412; https://github.com/Azure/sonic-buildimage/pull/3422 +[5] Use dot1p in packet 802.1q tag to map a packet to traffic class (TC) inside a switch pipeline https://github.com/sonic-net/sonic-swss/pull/871; https://github.com/sonic-net/sonic-buildimage/pull/3412; https://github.com/sonic-net/sonic-buildimage/pull/3422 -[6] Generate a CONFIG_DB with sub port interface config from minigraph https://github.com/Azure/sonic-buildimage/pull/3413 +[6] Generate a CONFIG_DB with sub port interface config from minigraph https://github.com/sonic-net/sonic-buildimage/pull/3413 -[7] CLI to support sub port interface admin status change https://github.com/Azure/sonic-utilities/pull/638 +[7] CLI to support sub port interface admin status change https://github.com/sonic-net/sonic-utilities/pull/638 -[8] CLI to show subinterfaces status https://github.com/Azure/sonic-utilities/pull/642 +[8] CLI to show subinterfaces status https://github.com/sonic-net/sonic-utilities/pull/642 -[8] CLI to add/del ip address on a sub port interface https://github.com/Azure/sonic-utilities/pull/651 +[8] CLI to add/del ip address on a sub port interface https://github.com/sonic-net/sonic-utilities/pull/651 diff --git a/doc/synchronous-mode/synchronous-mode-cfg.md b/doc/synchronous-mode/synchronous-mode-cfg.md index a4926bbf03..2a7a26257e 100644 --- a/doc/synchronous-mode/synchronous-mode-cfg.md +++ b/doc/synchronous-mode/synchronous-mode-cfg.md @@ -48,4 +48,4 @@ When the synchronous mode configuration exists in configDB, the configuration in The minigraph parser would explicitly write either "disable" or "enable" into `DEVICE_METADATA|localhost|synchronous_mode` in config_DB as the ground-truth configuration. And the configuration will be applied after swss restarts. Such a design complies with requirement 4 in Section 3.1. ### 3.6 Configuration with L2 switch mode -When configuring a device to [L2 Switch mode](https://github.com/Azure/SONiC/wiki/L2-Switch-mode), the configuration of synchronous mode in config_DB will be removed. In the scenario that there is no user-specified configuration for the synchronous mode in configDB before configuring to L2 Switch mode, the device will keep using the same default mode specified by the image after configuring to L2 switch mode. If the user would like to use a specific configuration for the synchronous mode, the user needs to specify the configuration with the CLI in Section 3.3 to explicitly wite the configuration into config_DB after configuring the switch to L2 switch mode. +When configuring a device to [L2 Switch mode](https://github.com/sonic-net/SONiC/wiki/L2-Switch-mode), the configuration of synchronous mode in config_DB will be removed. In the scenario that there is no user-specified configuration for the synchronous mode in configDB before configuring to L2 Switch mode, the device will keep using the same default mode specified by the image after configuring to L2 switch mode. If the user would like to use a specific configuration for the synchronous mode, the user needs to specify the configuration with the CLI in Section 3.3 to explicitly wite the configuration into config_DB after configuring the switch to L2 switch mode. diff --git a/doc/syslog/syslog-design.md b/doc/syslog/syslog-design.md index 702c3a8bd7..6fbb5efc14 100644 --- a/doc/syslog/syslog-design.md +++ b/doc/syslog/syslog-design.md @@ -466,7 +466,7 @@ module sonic-syslog { yang-version 1.1; - namespace "http://github.com/Azure/sonic-system-syslog"; + namespace "http://github.com/sonic-net/sonic-system-syslog"; prefix syslog; import ietf-inet-types { diff --git a/doc/system-telemetry/grpc_telemetry.md b/doc/system-telemetry/grpc_telemetry.md index c7ade6b325..78049fd23c 100644 --- a/doc/system-telemetry/grpc_telemetry.md +++ b/doc/system-telemetry/grpc_telemetry.md @@ -61,7 +61,7 @@ Within each DB, the data usually is organized in hierarchy of Table, key, field ``` Some data like COUNTERS table in COUNTERS_DB doesn't have key, but field and value are stored directly under COUNTERS table. -Refer to [SONiC data schema](https://github.com/Azure/sonic-swss-common/blob/master/common/schema.h) for more info about DB and table. +Refer to [SONiC data schema](https://github.com/sonic-net/sonic-swss-common/blob/master/common/schema.h) for more info about DB and table. For data not available in DBs, Target name "OTHERS" is designated for that category of data, paths like platform/cpu or proc/loadavg under "OTHERS" target may be used get/subscribe the data. diff --git a/doc/tpid/SonicTPIDSettingHLD1.md b/doc/tpid/SonicTPIDSettingHLD1.md index 7fd348bc99..54262abc97 100644 --- a/doc/tpid/SonicTPIDSettingHLD1.md +++ b/doc/tpid/SonicTPIDSettingHLD1.md @@ -381,6 +381,6 @@ The following test cases are to be run manually (eventually as part of the pytes ============== a) SONiC Configuration Management -b) +b) c) diff --git a/doc/voq/bgp_voq_chassis.md b/doc/voq/bgp_voq_chassis.md index e078f49cec..d904a76d95 100644 --- a/doc/voq/bgp_voq_chassis.md +++ b/doc/voq/bgp_voq_chassis.md @@ -89,7 +89,7 @@ nexthop of 10.0.1.2 would be recursively resolvable on ASIC2 over the 10.0.1.2/32 route created from the global neighbor table. (For more discussion on the creation of these host routes and how the recursively-resolved nexthops contribute to forwarding, see the -[VOQ HLD](https://github.com/Azure/SONiC/blob/master/doc/voq/voq_hld.md#251-inband-recycle-port-option).) +[VOQ HLD](https://github.com/sonic-net/SONiC/blob/master/doc/voq/voq_hld.md#251-inband-recycle-port-option).) The BGP sessions between ASIC Instances use IPv4. To get IPv6 routes distributed to all ASIC Instances, each iBGP peer will also be activated in diff --git a/doc/voq/everflow.md b/doc/voq/everflow.md index 74efa148a8..4ceecb4342 100644 --- a/doc/voq/everflow.md +++ b/doc/voq/everflow.md @@ -31,7 +31,7 @@ This document provides an overview of the SONiC support for everflow configurati # Scope -This document builds on top of the VOQ chassis architecture discussed [here](https://github.com/Azure/SONiC/blob/master/doc/voq/architecture.md) and the Everflow design discussed [here](https://github.com/Azure/SONiC/wiki/Everflow-High-Level-Design#3138-mirror-api). The goal of this document is to describe the configuration and design for everflow mirroring sessions for a VOQ-based chassis. +This document builds on top of the VOQ chassis architecture discussed [here](https://github.com/sonic-net/SONiC/blob/master/doc/voq/architecture.md) and the Everflow design discussed [here](https://github.com/sonic-net/SONiC/wiki/Everflow-High-Level-Design#3138-mirror-api). The goal of this document is to describe the configuration and design for everflow mirroring sessions for a VOQ-based chassis. # Definitions/Abbreviations diff --git a/doc/voq/fabric.md b/doc/voq/fabric.md index 2dc52fb286..b3360f01f3 100644 --- a/doc/voq/fabric.md +++ b/doc/voq/fabric.md @@ -39,7 +39,7 @@ This document covers: - Bring up of fabric ports in a VOQ chassis. - Monitoring the fabric ports in forwarding and fabric chips. -This document builds on top of the VOQ chassis architecture discussed [here](https://github.com/Azure/SONiC/blob/master/doc/voq/architecture.md) and the multi-ASIC architecture discussed [here](https://github.com/Azure/SONiC/blob/2f320430c8199132c686c06b5431ab93a86fb98f/doc/multi_asic/SONiC_multi_asic_hld.md). +This document builds on top of the VOQ chassis architecture discussed [here](https://github.com/sonic-net/SONiC/blob/master/doc/voq/architecture.md) and the multi-ASIC architecture discussed [here](https://github.com/sonic-net/SONiC/blob/2f320430c8199132c686c06b5431ab93a86fb98f/doc/multi_asic/SONiC_multi_asic_hld.md). # Definitions/Abbreviations diff --git a/doc/voq/voq_hld.md b/doc/voq/voq_hld.md index 6f81498d0e..3ab6be8a84 100644 --- a/doc/voq/voq_hld.md +++ b/doc/voq/voq_hld.md @@ -314,7 +314,7 @@ No changes in the schema of other CONFIG_DB tables. The name of the system ports For router interface and address configurations for the system ports, the existing INTERFACE table in CONFIG_DB is used. -Please refer to the [schema](https://github.com/Azure/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. +Please refer to the [schema](https://github.com/sonic-net/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. ## 2.4 Orchestration agent ### VOQ Switch Creation diff --git a/doc/vrf/sonic-vrf-hld.md b/doc/vrf/sonic-vrf-hld.md index fbfe077dbc..e3f355cedf 100644 --- a/doc/vrf/sonic-vrf-hld.md +++ b/doc/vrf/sonic-vrf-hld.md @@ -223,7 +223,7 @@ Here are the new flags we propose to add in the SAI interface: ## SONiC system diagram for VRF The following is high level diagram of modules with VRF support. -![](https://github.com/Azure/SONiC/blob/f2ebba476b4ef364b13b7980c2fe01e8929c71e6/images/vrf_hld/VRF_HIGH_LEVEL_DIAGRAM.png) +![](https://github.com/sonic-net/SONiC/blob/f2ebba476b4ef364b13b7980c2fe01e8929c71e6/images/vrf_hld/VRF_HIGH_LEVEL_DIAGRAM.png) ## The schema changes @@ -666,7 +666,7 @@ sai_remove_virtual_router_fn defined in saivirtualrouter.h to track (VR, VRF) cr - When app-intf-prefix-table change - add ip address event: wait until route interface is created ,then set ip address on existing router interface. - del ip address event: unset ip address on existing router interface. -- Move add/del subnet-route code to routeorch. In existing implementation when route interface is down, subnet routes associated with the interface still exist. It could result in a stale state and correct route configured from fpmsyncd will be rejected by routeorch. It makes sense that fpmsyncd/routeorch handles all route configurations except ip2me route. Nephos has submit this PR to swss community(). To support vrf these code will be refined to support vrf feature. +- Move add/del subnet-route code to routeorch. In existing implementation when route interface is down, subnet routes associated with the interface still exist. It could result in a stale state and correct route configured from fpmsyncd will be rejected by routeorch. It makes sense that fpmsyncd/routeorch handles all route configurations except ip2me route. Nephos has submit this PR to swss community(). To support vrf these code will be refined to support vrf feature. This change is necessary for vrf route-leak scenarios too. For example, interface Ethernet1 currently belongs to Vrf_blue , its ip address is 10.1.1.1/24. Another vrf domain Vrf_red imports all Vrf_blue route. Then there is a route like "Vrf_red:10.1.1.0/24 Ethernet1" in BGP route. When fpmsyncd pushes this route to routeorch, routeorch will drop it silently. diff --git a/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md b/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md index 3074b03a28..2775017e46 100644 --- a/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md +++ b/doc/vxlan/EVPN/EVPN_VXLAN_HLD.md @@ -1501,6 +1501,6 @@ To support warm boot, all the sai_objects must be uniquely identifiable based on ## 9 References -- [SONiC VXLAN HLD](https://github.com/Azure/SONiC/blob/master/doc/vxlan/Vxlan_hld.md) +- [SONiC VXLAN HLD](https://github.com/sonic-net/SONiC/blob/master/doc/vxlan/Vxlan_hld.md) - [RFC 7432](https://tools.ietf.org/html/rfc7432) - [RFC 8365](https://tools.ietf.org/html/rfc8365) diff --git a/doc/vxlan/Overlay ECMP with BFD.md b/doc/vxlan/Overlay ECMP with BFD.md index 28ab66ba75..073abe9bc3 100644 --- a/doc/vxlan/Overlay ECMP with BFD.md +++ b/doc/vxlan/Overlay ECMP with BFD.md @@ -41,7 +41,7 @@ | 1.6 | 04/23/2022 | Storm Liang | Update 2.6 BGP secion & add Test plan for BGP | # About this Manual -This document provides general information about the Vxlan Overlay ECMP feature implementation in SONiC with BFD support. This is an extension to the existing VNET Vxlan support as defined in the [Vxlan HLD](https://github.com/Azure/SONiC/blob/master/doc/vxlan/Vxlan_hld.md) +This document provides general information about the Vxlan Overlay ECMP feature implementation in SONiC with BFD support. This is an extension to the existing VNET Vxlan support as defined in the [Vxlan HLD](https://github.com/sonic-net/SONiC/blob/master/doc/vxlan/Vxlan_hld.md) # Definitions/Abbreviation @@ -61,7 +61,7 @@ This document provides general information about the Vxlan Overlay ECMP feature Below diagram captures the use-case. In this, ToR is a Tier0 device and Leaf is a Tier1 device. Vxlan tunnel is established from Leaf (Tier1) to a VTEP endpoint. ToR (Tier0), Spine (Tier3) are transit devices. -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/OverlayEcmp_UseCase.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/OverlayEcmp_UseCase.png) ### Packet flow @@ -172,7 +172,7 @@ PROFILE = STRING ; profile name to be applie Overlay routes can be programmed via RestAPI or gNMI/gRPC interface which is not described in this document. A highlevel module interaction is shown below -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/OverlayEcmp_ModuleInteraction.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/OverlayEcmp_ModuleInteraction.png) ## 2.4 Orchestration Agent Following orchagents shall be modified. @@ -215,7 +215,7 @@ VNET_ROUTE_TUNNEL_TABLE can provide monitoring endpoint IPs which can be differe ### Bfd HW offload -This design requires endpoint health monitoring by setting BFD sessions via HW offload. Details of BFD orchagent and HW offloading is captured in this [document](https://github.com/Azure/SONiC/blob/master/doc/bfd/BFD%20HW%20Offload%20HLD.md) +This design requires endpoint health monitoring by setting BFD sessions via HW offload. Details of BFD orchagent and HW offloading is captured in this [document](https://github.com/sonic-net/SONiC/blob/master/doc/bfd/BFD%20HW%20Offload%20HLD.md) ## 2.5 Monitoring and Health diff --git a/doc/vxlan/Vxlan_hld.md b/doc/vxlan/Vxlan_hld.md index a1942c3c3d..508ae43545 100644 --- a/doc/vxlan/Vxlan_hld.md +++ b/doc/vxlan/Vxlan_hld.md @@ -222,7 +222,7 @@ key = NEIGH_TABLE:name:ip_address ; Vnet nei family = IPv4/IPv6 ; Address family ``` -Please refer to the [schema](https://github.com/Azure/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. +Please refer to the [schema](https://github.com/sonic-net/sonic-swss/blob/master/doc/swss-schema.md) document for details on value annotations. ## 2.2 APP DB Two new tables would be introduced to specify routes and tunnel end points in VNet domain. @@ -300,7 +300,7 @@ PEER_LIST = \*vnet_name ; vnet nam Following orchagents shall be modified. Flow diagrams are captured in a later section. -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_orch.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_orch.png) ### VxlanOrch This is the major subsystem for Vxlan that handles configuration request. Vxlanorch creates the tunnel and attaches encap and decap mappers. Seperate tunnels are created for L2 Vxlan and L3 Vxlan and can attach different VLAN/VNI or VRF/VNI to respective tunnel. @@ -327,7 +327,7 @@ Following orchagents shall be modified. Flow diagrams are captured in a later se The overall data flow diagram is captured below for all TABLE updates. - ![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_data_flow.png) + ![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_data_flow.png) ## 2.4 SAI @@ -404,13 +404,13 @@ Commands: # 3 Flows ## 3.1 Vxlan VNet peering -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_cntrl_flow_1.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_cntrl_flow_1.png) -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_cntrl_flow_2.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_cntrl_flow_2.png) -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_route_delete.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_route_delete.png) -![](https://github.com/Azure/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_vnet_delete.png) +![](https://github.com/sonic-net/SONiC/blob/master/images/vxlan_hld/vnet_vxlan_vnet_delete.png) ## Layer 2 Vxlan TBD diff --git a/doc/warm-reboot/code_implementation.md b/doc/warm-reboot/code_implementation.md index 4bd451d284..f1e3ed2689 100644 --- a/doc/warm-reboot/code_implementation.md +++ b/doc/warm-reboot/code_implementation.md @@ -203,19 +203,19 @@ jipan@sonic-build:~/igbpatch/vs/sonic-buildimage/src/sonic-swss/tests$ ``` # Separate syncd and swss services, and warm start configDB support -https://github.com/Azure/sonic-buildimage/compare/master...jipanyang:warm-reboot +https://github.com/sonic-net/sonic-buildimage/compare/master...jipanyang:warm-reboot # swss-flushdb script support -https://github.com/Azure/sonic-utilities/compare/master...jipanyang:swss-warm-restart +https://github.com/sonic-net/sonic-utilities/compare/master...jipanyang:swss-warm-restart # swss data restore -https://github.com/Azure/sonic-swss/compare/master...jipanyang:idempotent +https://github.com/sonic-net/sonic-swss/compare/master...jipanyang:idempotent # RedisClient hmset and hgetallordered library support. -https://github.com/Azure/sonic-swss-common/compare/master...jipanyang:idempotent +https://github.com/sonic-net/sonic-swss-common/compare/master...jipanyang:idempotent # libsari redis API idempotency support -https://github.com/Azure/sonic-sairedis/compare/master...jipanyang:idempotent +https://github.com/sonic-net/sonic-sairedis/compare/master...jipanyang:idempotent diff --git a/doc/warm-reboot/open_issues.md b/doc/warm-reboot/open_issues.md index f5452ea5e3..21cb7c946e 100644 --- a/doc/warm-reboot/open_issues.md +++ b/doc/warm-reboot/open_issues.md @@ -92,9 +92,9 @@ Both approaches have been under development and testing. Current status: ## Idempotent libsairedis API ### Design doc: -[SONiC libsairedis API idempotence support](https://github.com/Azure/SONiC/blob/master/doc/warm-reboot/sai_redis_api_idempotence.md) +[SONiC libsairedis API idempotence support](https://github.com/sonic-net/SONiC/blob/master/doc/warm-reboot/sai_redis_api_idempotence.md) ### Draft code changes: -[libsairedis code changes](https://github.com/Azure/sonic-sairedis/compare/master...jipanyang:idempotent) +[libsairedis code changes](https://github.com/sonic-net/sonic-sairedis/compare/master...jipanyang:idempotent) ### Current status: A series of virtual switch test cases have been implemented, and end to end integration testing as to swss docker warm restart/upgrade have been done based on this solution. @@ -107,7 +107,7 @@ It is desired to be able to switch the feature on and off with one simple comman ### Code change: This file contains major part of the implementation (not complete): -[syncd_applyview.cpp](https://github.com/Azure/sonic-sairedis/blob/d54977f297301f972e2839d526d8130a5f66e893/syncd/syncd_applyview.cpp) +[syncd_applyview.cpp](https://github.com/sonic-net/sonic-sairedis/blob/d54977f297301f972e2839d526d8130a5f66e893/syncd/syncd_applyview.cpp) ### Design doc: Not available yet. diff --git a/doc/warm-reboot/system-warmboot.md b/doc/warm-reboot/system-warmboot.md index ef4ed76b9f..c401b637f6 100644 --- a/doc/warm-reboot/system-warmboot.md +++ b/doc/warm-reboot/system-warmboot.md @@ -74,13 +74,13 @@ Assumptions: 2. Focus on whole system reboot, in future will extend it to container level warm restart 3. Focus on one image warm reboot, and version upgrading warm reboot. No version downgrading warm reboot. -Structure of testbed: [design doc](https://github.com/Azure/sonic-mgmt/blob/master/docs/testbed/README.testbed.Overview.md#sonic-testbed-overview) +Structure of testbed: [design doc](https://github.com/sonic-net/sonic-mgmt/blob/master/docs/testbed/README.testbed.Overview.md#sonic-testbed-overview) ![Physical topology](img/testbed.png) ![Testbed server](img/testbed-server.png) Architect: - - Both warm-reboot and fast-reboot are written in ansible playbook [advanced-reboot.yml](https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/tasks/advanced-reboot.yml) - - The playbook will deploy a master python script [advanced-reboot.py](https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/ptftests/advanced-reboot.py) to PTF docker container and all the steps are running there + - Both warm-reboot and fast-reboot are written in ansible playbook [advanced-reboot.yml](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/tasks/advanced-reboot.yml) + - The playbook will deploy a master python script [advanced-reboot.py](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/ptftests/advanced-reboot.py) to PTF docker container and all the steps are running there - The master python script will - ssh into DUT to execute reboot command - ssh into Arist EOS VM to observe and operate port, port channel and BGP sessions diff --git a/doc/xrcvd/OIDsforSensorandTransciver.MD b/doc/xrcvd/OIDsforSensorandTransciver.MD index 224ecec678..c7773f8cf6 100644 --- a/doc/xrcvd/OIDsforSensorandTransciver.MD +++ b/doc/xrcvd/OIDsforSensorandTransciver.MD @@ -58,7 +58,7 @@ As shown in the following diagram, we need to collect sensor and transceiver inf | 1.3.6.1.2.1.47.1.1.1.1.12.index | entPhysicalMfgName | Vendor Name in CLI or sfputil | FINISAR CORP | | 1.3.6.1.2.1.47.1.1.1.1.13.index | entPhysicalModelName | Vendor PN in CLI or sfputil| FCBN410QD3C02 | -ifindex is the ifindex in https://github.com/Azure/sonic-py-swsssdk/blob/master/src/swsssdk/port_util.py#L19 +ifindex is the ifindex in https://github.com/sonic-net/sonic-py-swsssdk/blob/master/src/swsssdk/port_util.py#L19 | Interface | Proposed index to use | | --- | --- | diff --git a/doc/xrcvd/transceiver-monitor-hld.md b/doc/xrcvd/transceiver-monitor-hld.md index b5ea73097f..d35d28aa6c 100644 --- a/doc/xrcvd/transceiver-monitor-hld.md +++ b/doc/xrcvd/transceiver-monitor-hld.md @@ -11,7 +11,7 @@ ## About This Manual ## This document is intend to provide general information about the Transceiver and Sensor Monitoring implementation. -The requirement is described in [Sensor and Transceiver Info Monitoring Requirement.](https://github.com/Azure/SONiC/blob/master/doc/xrcvd/OIDsforSensorandTransciver.MD) +The requirement is described in [Sensor and Transceiver Info Monitoring Requirement.](https://github.com/sonic-net/SONiC/blob/master/doc/xrcvd/OIDsforSensorandTransciver.MD) ## 1. Xcvrd design ## @@ -237,7 +237,7 @@ A thread will be started to periodically refresh the DOM sensor information. Detailed flow as showed in below chart: -![](https://github.com/Azure/SONiC/blob/d1159ca728112f10319fa47de4df89c445a27efc/images/transceiver_monitoring_hld/xcvrd_flow.svg) +![](https://github.com/sonic-net/SONiC/blob/d1159ca728112f10319fa47de4df89c445a27efc/images/transceiver_monitoring_hld/xcvrd_flow.svg) #### 1.4.1 State machine of sfp\_state\_update\_task process #### @@ -368,7 +368,7 @@ Another entPhySensorTable which is defined in [Entity Sensor MIB(RFC3433)](https | 1.3.6.1.2.1.99.1.1.1.4.index | entPhySensorValue | Same as above | 7998 | | 1.3.6.1.2.1.47.1.1.1.1.2.index | entPhysicalDescr | Show interfaces alias | DOM RX Power Sensor for DOM RX Power Sensor for Ethernet29/1 | -More detailed information about new table and new OIDs are described in [Sensor and Transceiver Info Monitoring Requirement](https://github.com/Azure/SONiC/blob/master/doc/xrcvd/OIDsforSensorandTransciver.MD#transceiver-requirements-entity-mib). +More detailed information about new table and new OIDs are described in [Sensor and Transceiver Info Monitoring Requirement](https://github.com/sonic-net/SONiC/blob/master/doc/xrcvd/OIDsforSensorandTransciver.MD#transceiver-requirements-entity-mib). ## 3. CLI change ## diff --git a/generate_sonic_image_links.sh b/generate_sonic_image_links.sh index 106d32bdfa..e43f4663f6 100644 --- a/generate_sonic_image_links.sh +++ b/generate_sonic_image_links.sh @@ -97,91 +97,91 @@ do echo "\"sonic-broadcom.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_BRCM}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-broadcom.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_BRCM}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_BRCM_2}"..."${COMMIT_BRCM_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_BRCM_2}"..."${COMMIT_BRCM_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_BRCM}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_BRCM_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-aboot-broadcom.swi\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_BRCM}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-aboot-broadcom.swi/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_BRCM}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_BRCM_2}"..."${COMMIT_BRCM_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_BRCM_2}"..."${COMMIT_BRCM_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_BRCM}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_BRCM_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-mellanox.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_MLNX}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-mellanox.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_MLNX}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_MLNX_2}"..."${COMMIT_MLNX_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_MLNX_2}"..."${COMMIT_MLNX_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_MLNX}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_MLNX_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-vs.img.gz\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_VS}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-vs.img.gz/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_VS}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_VS_2}"..."${COMMIT_VS_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_VS_2}"..."${COMMIT_VS_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_VS}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_VS_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-innovium.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_INNO}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-innovium.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_INNO}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_INNO_2}"..."${COMMIT_INNO_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_INNO_2}"..."${COMMIT_INNO_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_INNO}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_INNO_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-innovium-dbg.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_INNO}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-innovium-dbg.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_INNO}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_INNO_2}"..."${COMMIT_INNO_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_INNO_2}"..."${COMMIT_INNO_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_INNO}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_INNO_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-barefoot.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_BFT}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-barefoot.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_BFT}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_BFT_2}"..."${COMMIT_BFT_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_BFT_2}"..."${COMMIT_BFT_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_BFT}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_BFT_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-centec.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_CTC}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-centec.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_CTC}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_CTC_2}"..."${COMMIT_CTC_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_CTC_2}"..."${COMMIT_CTC_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_CTC}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_CTC_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-centec-arm64.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_CTC64}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-centec-arm64.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_CTC64}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_CTC64_2}"..."${COMMIT_CTC64_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_CTC64_2}"..."${COMMIT_CTC64_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_CTC64}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_CTC64_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-generic.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_GRC}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-generic.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_GRC}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_GRC_2}"..."${COMMIT_GRC_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_GRC_2}"..."${COMMIT_GRC_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_GRC}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_GRC_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-generic-dbg.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_GRC}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-generic-dbg.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_GRC}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_GRC_2}"..."${COMMIT_GRC_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_GRC_2}"..."${COMMIT_GRC_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_GRC}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_GRC_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-marvell-armhf.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_MRV}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-marvell-armhf.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_MRV}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_MRV_2}"..."${COMMIT_MRV_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_MRV_2}"..."${COMMIT_MRV_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_MRV}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_MRV_TS}\"" >> sonic_image_links.json echo " }," >> sonic_image_links.json echo "\"sonic-nephos.bin\": {" >> sonic_image_links.json echo " \"url\": \"$(echo "${ARTF_NPH}" | sed 's/format=zip/format=file\&subpath=\/target\/sonic-nephos.bin/')\"," >> sonic_image_links.json echo " \"build-url\": \"https://dev.azure.com/mssonic/build/_build/results?buildId=${BUILD_NPH}&view=results\"," >> sonic_image_links.json - echo " \"diff\": \"https://github.com/Azure/sonic-buildimage/compare/"${COMMIT_NPH_2}"..."${COMMIT_NPH_1}"\"," >> sonic_image_links.json + echo " \"diff\": \"https://github.com/sonic-net/sonic-buildimage/compare/"${COMMIT_NPH_2}"..."${COMMIT_NPH_1}"\"," >> sonic_image_links.json echo " \"build\": \"${BUILD_NPH}\"," >> sonic_image_links.json echo " \"date\": \"${BUILD_NPH_TS}\"" >> sonic_image_links.json echo " }" >> sonic_image_links.json diff --git a/index.html b/index.html index 2c088d2205..12dbee902a 100644 --- a/index.html +++ b/index.html @@ -70,31 +70,31 @@
  • SONiC
  • Users
  • Developers
    • @@ -105,11 +105,11 @@
  • Community Meeting Videos
  • Community Meeting Minutes
  • Workgroups
    • -
  • How To Contribute
    • -
  • Governance
    • -
  • SONiC Foundation Technical Charter
    • -
  • Security Process
    • -
  • License & Logo
    • +
  • How To Contribute
    • +
  • Governance
    • +
  • SONiC Foundation Technical Charter
    • +
  • Security Process
    • +
  • License & Logo

    • @@ -146,12 +146,12 @@

    SONiC

    Software for Open Networking in the Cloud

    - +

    - Wiki + Wiki        - GitHub + GitHub        Linux Foundation

    @@ -272,7 +272,7 @@

    Rapidly Growing Ecosystem

    Presentations & Demos

    Software for Open Networking in the Cloud (SONiC) Moves to the Linux Foundation

    -

    SONiC Community Meetings

    +

    SONiC Community Meetings

    More Presentations

    OCP Virtual Summit 2020 SONiC Demos

    diff --git a/menu.html b/menu.html index 36dfeb92c8..86e0213412 100644 --- a/menu.html +++ b/menu.html @@ -20,31 +20,31 @@
  • SONiC
  • Users
  • Developers
  • @@ -54,11 +54,11 @@
  • Community Meeting Videos
  • Community Meeting Minutes
  • Workgroups
    • -
  • How To Contribute
    • -
  • Governance
    • -
  • SONiC Foundation Technical Charter
    • -
  • Security Process
    • -
  • License & Logo
    • +
  • How To Contribute
    • +
  • Governance
    • +
  • SONiC Foundation Technical Charter
    • +
  • Security Process
    • +
  • License & Logo
    • diff --git a/pdf/newsletters/SONiC_newsletter_2019_10.html b/pdf/newsletters/SONiC_newsletter_2019_10.html index 17f0361c18..3afd7d7e32 100644 --- a/pdf/newsletters/SONiC_newsletter_2019_10.html +++ b/pdf/newsletters/SONiC_newsletter_2019_10.html @@ -296,7 +296,7 @@

    - + @@ -313,7 +313,7 @@

    - + @@ -330,7 +330,7 @@

    - + @@ -346,7 +346,7 @@

    - + @@ -362,7 +362,7 @@

    - + @@ -379,7 +379,7 @@

    - + @@ -395,7 +395,7 @@

    - + @@ -412,7 +412,7 @@

    - + diff --git a/pdf/newsletters/SONiC_newsletter_2019_12.html b/pdf/newsletters/SONiC_newsletter_2019_12.html index 838063db63..a27901e815 100644 --- a/pdf/newsletters/SONiC_newsletter_2019_12.html +++ b/pdf/newsletters/SONiC_newsletter_2019_12.html @@ -139,7 +139,7 @@ Features Merged - Build time improvements, Configurable drop counters, Egress mirroring and ACL action support check via SAI, HW resource monitor,L3 perf enhancement, Log analyzer to pytest, Management Framework, Management VRF, Platform test, sFlow, SSD diagnostic tolling and Sub-port support have been merged.
    Pending Features - MLAG,VRF and ZTP.

    -

    For current status of all features

    +

    For current status of all features

    @@ -165,7 +165,7 @@ 05 NOV 2019

    - +    Support for DPKG local caching   

    @@ -175,7 +175,7 @@ 12 NOV 2019

    - +   DPKG Caching Framework - BRCM     @@ -186,7 +186,7 @@ 19 NOV 2019

    - +   Thermal control design   @@ -208,7 +208,7 @@ 03 DEC 2019

    - +   Release tracking status      diff --git a/pdf/newsletters/SONiC_newsletter_2020_06.html b/pdf/newsletters/SONiC_newsletter_2020_06.html index 6e1c8454a6..65973e2529 100644 --- a/pdf/newsletters/SONiC_newsletter_2020_06.html +++ b/pdf/newsletters/SONiC_newsletter_2020_06.html @@ -110,7 +110,7 @@ Industry Demo Collection

    - + @@ -165,11 +165,11 @@

    -

    SONiC 202006 Release:

    Community has been working hard to complete the features planned in the     Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2020 with the completed features and the incomplete features shall catch the next train. +

    SONiC 202006 Release:

    Community has been working hard to complete the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2020 with the completed features and the incomplete features shall catch the next train.

    Features Planned - BFD SW 100ms interval from FRR, Build Improvements, Consistent ECMP support, Container warm restart, CoPP config/management, D-Bus to Host Communications, Debian 10 upgrade - base image, driver & dockers, Dynamic headroom calculation, Dynamic port breakout, Egress shaping, EVPN/VXLAN, FRR BGP NBI, Fw utils extension, Gearbox, L2 functional and performance enhancements, Management framework (Phase 2), Media enhancements, PDDF advance to SONiC Platform 2.0, BMC, PDK - Platform development environment, & driver development framework, Port mirroring, Pytest 100% moved from ansible to Pytest, RADIUS AAA, SPytest, System health & system LED, etc.,

    -

    SONiC 201911 Release:

    Special thanks to all community members who contributed to the Previous Release 201911. +

    SONiC 201911 Release:

    Special thanks to all community members who contributed to the Previous Release 201911.

    @@ -202,7 +202,7 @@ 28 Jan 2020

    - + DBUS HLD

    @@ -212,7 +212,7 @@ 04 Feb 2020

    - + Debian 10 buster HLD

    @@ -221,7 +221,7 @@ 11 Feb 2020

    - + SONiC Line card Hot Swap HLD

    @@ -239,7 +239,7 @@ 10 Mar 2020

    - + Monitoring, Auto-Mitigating Unhealthy Containers

    @@ -248,7 +248,7 @@ 17 Mar 2020

    - + Add QoS Scheduler and Shaper HLD

    @@ -257,7 +257,7 @@ 24 Mar 2020

    - + SONiC Port mirroring HLD

    @@ -266,7 +266,7 @@ 31 Mar 2020

    - + System Health and System LED Monitoring

    @@ -275,7 +275,7 @@ 07 Apr 2020

    - + AAA HLD

    @@ -284,7 +284,7 @@ 14 Apr 2020

    - + D-Bus Host to Container Communications HLD

    @@ -293,7 +293,7 @@ 21 Apr 2020

    - + Management Framework-Phase II HLD

    @@ -302,7 +302,7 @@ 28 Apr 2020

    - + Fine grained ECMP HLD

    @@ -311,7 +311,7 @@ 05 May 2020

    - + MCLAG Enhancements HLD

    @@ -320,7 +320,7 @@ 12 May 2020

    - + SONiC Configuration Replace HLD

    @@ -329,7 +329,7 @@ 19 May 2020

    - + Dynamic buffer calculation HLD

    @@ -338,7 +338,7 @@ 26 May 2020

    - + EVPN VXLAN HLD

    @@ -347,7 +347,7 @@ 02 June 2020

    - + BGP Unnumbered HLD

    @@ -386,4 +386,4 @@ - \ No newline at end of file + diff --git a/pdf/newsletters/SONiC_newsletter_2020_09.html b/pdf/newsletters/SONiC_newsletter_2020_09.html index 019a9698c2..efc3601e26 100644 --- a/pdf/newsletters/SONiC_newsletter_2020_09.html +++ b/pdf/newsletters/SONiC_newsletter_2020_09.html @@ -135,11 +135,11 @@

    -

    SONiC 202012 Release:
    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of December 2020 with the completed features. +

    SONiC 202012 Release:
    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of December 2020 with the completed features.

    Features Planned - AAA improvement,ACL enhancements: Policing, DHCP/PCP remark,BFD SW 100ms interval from FRR,Consistent ECMP support,Console Support for SONiC (Hardware,SSH forwarding),Container warm restart,CoPP Config/Management, Uniform Firmware upgrade Tool,Distributed VoQ Forwarding,Dynamic headroom calculation,Synchornous SAI APIs,Extending Entphysicaltable MIB table,Extend FW debug info in sysdump,EVPN/VXLAN,Flow-based Services,FRR BGP NBI,Gearbox,IPv6 Link Local and BGP Unnumbered,Kubernetes,L2 Dot1Q tunneling support,L2 functional and performance enhancements,MACSec support in Chassis,Management Framework (Phase 2),MC-LAG (L2),Media Enhancements,Python2->python3,Multi-ASIC,Multi-DB enhancement-Part 2,ONIE FW tools,PDDF advance to SONiC Platform 2.0, BMC,PDK - Platform Development Environment,PDK - Platform Driver Development Framework,RADIUS AAA,SONiC app extension,Support hardware reboot/reload reason (Streaming Telemetry),System health and system LED,Telemetry support for Multi-ASIC,VoQ Chassis Support in SONiC,VXLAN diff tool,VXLAN ping tool. etc.,

    -

    SONiC 202006 Release:
    Special thanks to all community members who contributed to the Previous Release 202006. +

    SONiC 202006 Release:
    Special thanks to all community members who contributed to the Previous Release 202006.

    @@ -164,12 +164,12 @@ - Members are requested to follow the New Design Document Template for all design documents + Members are requested to follow the New Design Document Template for all design documents 07 Jul 2020

    - + 202006 Release update & 202012 Release planning

    @@ -178,7 +178,7 @@ 14 Jul 2020

    - + 202006 CLI configuration guide updates

    @@ -187,7 +187,7 @@ 21 Jul 2020

    - + Multi-ASIC HLD

    @@ -196,7 +196,7 @@ 28 Jul 2020

    - + Code Coverage Rate HLD

    @@ -205,7 +205,7 @@ 04 Aug 2020

    - + 202012 Release Planning

    @@ -214,7 +214,7 @@ 11 Aug 2020

    - + SONiC Entity MIB Extension HLD

    @@ -223,7 +223,7 @@ 18 Aug 2020

    - + Distributed forwarding in a VOQ architecture HLD

    @@ -232,7 +232,7 @@ 25 Aug 2020

    - + Code refactoring to improve service container warm resart

    @@ -241,7 +241,7 @@ 01 Sep 2020

    - + SONiC-Console-Switch-High-Level-Design

    @@ -250,7 +250,7 @@ 08 Sep 2020

    - + VoQ HLD

    @@ -259,7 +259,7 @@ 22 Sep 2020

    - + Kubernetes-Support for SONiC

    @@ -268,7 +268,7 @@ 29 Sep 2020

    - + SONiC FW utility HLD

    @@ -283,4 +283,4 @@ - \ No newline at end of file + diff --git a/pdf/newsletters/SONiC_newsletter_2020_12.html b/pdf/newsletters/SONiC_newsletter_2020_12.html index e95be8e304..e89f100edf 100644 --- a/pdf/newsletters/SONiC_newsletter_2020_12.html +++ b/pdf/newsletters/SONiC_newsletter_2020_12.html @@ -110,7 +110,7 @@

    It has been a new normal year 2020 for us ! Appreciate all the community members for the excellent achievement for making two releases in the year amidst the pandemic.

    Contributions from the community has doubled in the year 2020, when compared to 2019. 50+ new features have been added in the year 2020 against 27 new features in 2019. Similarly number of Pull Request increased from 2480 to 4000+ PRs from 250+ active contributors in the current year. 10 new platforms have been added in the year to the SONiC portfolio. 13 new partners have joined hands with the SONiC community in this year.

    -

    Successfully participated in the OCP Virtual Submit, NetDev Virtual Conference, SONiC Eco-system Conference, OCP Tech Week and OCP China Day. Have demonstrated the SONiC capabilities to the world through an Industry Demo. +

    Successfully participated in the OCP Virtual Submit, NetDev Virtual Conference, SONiC Eco-system Conference, OCP Tech Week and OCP China Day. Have demonstrated the SONiC capabilities to the world through an Industry Demo.

    Created 5 new workgroups to have a focused feature specific community discussions and contributions, recent being Kubernetes & MPLS Workgroup!

    Wishing all our community members a wonderful New year 2021 & looking forward for another successful year ahead !

    More Community News: @@ -133,7 +133,7 @@

    -

    SONiC 202012 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled in couple of days with the completed features. +

    SONiC 202012 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled in couple of days with the completed features.

    Features Planned - Consistent ECMP support(fine grain ECMP), Container warm restart (BGP/TeamD/SWSS/SyncD), CoPP Config/Management, Console support for SONiC(Hardware), Console support for SONiC(ssh forwarding), Dynamic headroom calculation,Enable synchronous SAI APIs for error handling, EVPN/VXLAN, SONiC entity MIB extensions, FRR BGP NBI, Gearbox, Kubernetes (docker to be controlled by Kubernetes), MACSec support in chassis, Management Framework (Phase 2), MC-LAG (L2), Merge common lib for C++ and python (SWSS common lib), Move from Python2->python3, Multi-ASIC 202006, Multi-DB enhancement-Part 2, ONIE FW tools(Incl. CPLD, BIOS, SSD, Firmware upgrade[Uniform Tool]), PDDF advance to SONiC Platform 2.0, BMC, PDK - Platform Development Environment, RADIUS AAA, SONiC app extension(w/o orchagent), Support hardware reboot/reload reason (Streaming Telemetry), System health and system LED, PCIe Monitoring, Distributed forwarding in a VOQ architecture, Distributed VOQ architecture HLD, Platform Monitoring for Chassis systems, Routing/BGP for Chassis, Fabric Port support for SONiC, LAG Support for Chassis, Chassis infrastructure, T2 topologies and sample Testcases converted, Inband port support for Chassis, Everflow Support etc.,

    @@ -165,7 +165,7 @@ 06 Oct 2020

    - + SONiC TPID Configuration Support

    @@ -183,7 +183,7 @@ 20 Oct 2020

    - + Release 202012 Discussion

    @@ -192,7 +192,7 @@ 27 Oct 2020

    - + MACSEC Design

    @@ -201,7 +201,7 @@ 03 Nov 2020

    - + SONiC Application Extension

    @@ -219,7 +219,7 @@ 24 Nov 2020

    - + SONiC Application Extension

    @@ -228,7 +228,7 @@ 08 Dec 2020

    - + PMON enhancements for Chassis HLD

    @@ -237,7 +237,7 @@ 15 Dec 2020

    - + Release 202012 Discussion

    @@ -249,4 +249,4 @@ - \ No newline at end of file + diff --git a/pdf/newsletters/SONiC_newsletter_2021_03.html b/pdf/newsletters/SONiC_newsletter_2021_03.html index f589341bf2..1386164317 100644 --- a/pdf/newsletters/SONiC_newsletter_2021_03.html +++ b/pdf/newsletters/SONiC_newsletter_2021_03.html @@ -99,7 +99,7 @@

    It has been a good start for the year 2021 to all of us ! Appreciate all the community members for their ongoing contribution towards the current release.
    -

    Community was able to come up with release notes for 202012 release and SAI version 1.7.1

    +

    Community was able to come up with release notes for 202012 release and SAI version 1.7.1

    Created SONiC Yang Subgroup to have a focused specific community discussions and contributions.

    Wishing all our community members yet another successful release ahead !

    More Community News: @@ -120,7 +120,7 @@

    -

    SONiC 202106 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2021 with the completed features. +

    SONiC 202106 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2021 with the completed features.

    Features Planned - Telemetry for Multi-ASIC, Dynamic policy based hashing, DHCP IPv6 relay, App extension with Orchagent/SWSS,CLI generation tool & warmboot awareness, FRR running configuration to tech support, Enable/Disable auto negotiation & speed setting with number of lanes, TPID config support, Kubernetes enhancements, Deprecating Python2 platform daemons, MACSec support in Chassis, MACSEC enhancement: primary & fallback case, Error handling (swss), 100% SONiC YANG model, Debian11 branch, (Test) Upgrade to Python3 compliance, (Test) Ansible 2.10 upgrade, (Test) Testbed v2, Testcase/Testbed Infrastructure, SONiC fanout support, Link Training, Inband mgmt VRF, Sample Rate on mirror, Sflow with remote collector, V4/V6 L3 ACL optimization, SRv6 support, SONiC for MPLS Dataplane, Route scalability with multiple next-hops, IS-IS in the dataplane, Class-based forwarding, IPv6 Link Local and BGP Unnumbered, MC-LAG (L2), RPVST+, Storm Control , RADIUS AAA, Kernel programming performance enhancement, Static Anycast Gateway, BFD (SW - 100ms interval from FRR), STP/PVST, L2 functional and performance enhancements, Thresholds (statistics), PDK - Platform Development Environment, UI Content (UMF client), Broadcom silicon common config, DPB Reconcile, Dynamic CoPP reconcile, Mgmt FW Phase 3, Routed sub-interface reconcile, MultiDB reconcile, CPU Queues, ACL enhancements: Policing, DHCP/PCP remark, L2 ARP Refresh, Gearbox part 2, libebpf support & usage, PCIe Monitoring etc.,
    @@ -162,7 +162,7 @@ 19 Jan 2021

    - + Port auto negotiation HLD

    @@ -171,7 +171,7 @@ 02 Feb 2021

    - + Next hop group split HLD

    @@ -189,7 +189,7 @@ 16 Feb 2021

    - + cpu queue stats

    @@ -198,7 +198,7 @@ 23 Feb 2021

    - + SONiC Yang Model and related libraries

    @@ -207,7 +207,7 @@ 02 Mar 2021

    - + Weighted ECMP HLD

    @@ -216,7 +216,7 @@ 09 Mar 2021

    - + MPLS HLD initial revision

    @@ -225,7 +225,7 @@ 16 Mar 2021

    - + Inband Mgmt via mgmt VRF

    @@ -234,7 +234,7 @@ 23 Mar 2021

    - + Rollback for SONiC

    @@ -255,4 +255,4 @@ -

    -

    SONiC 202106 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2021 with the completed features and the incomplete features shall catch the next train. +

    SONiC 202106 Release:

    Community is currently occupied with the features planned in the Roadmap which is being tracked in Release Tracking. A branch will be pulled by end of June 2021 with the completed features and the incomplete features shall catch the next train.

    Features Planned - Telemetry for Multi-ASIC, Dynamic port breakout, Dynamic policy based hashing, DHCP relay IPv6 support, App extension CLI generation tool, App extension with warmboot awareness, Add FRR running configuration to tech support, Enable/Disable auto negotiation and speed setting with number of lanes, TPID config support, Error handling (swss), SONiC YANG model, Testcase/Testbed Infrastructure, SONiC fanout support, Inband mgmt VRF, SRv6 support, SONiC for MPLS Dataplane, Better route scalability with multiple next-hops, IPv6 Link Local and BGP Unnumbered, MC-LAG (L2), RADIUS AAA, PDK - Platform Development Environment, Broadcom silicon common config, PCIe Monitoring, Event-mgmt infra, Klish CLI for show-tech support, Debug dump utility, Enhanced xcrvd SFP error flow, Entity sensor MIB extension. etc.,
    @@ -155,7 +155,7 @@ 13 Apr 2021

    - + Policy Based Hashing HLD

    @@ -164,7 +164,7 @@ 20 Apr 2021

    - + Event and Alarm Framework HLD

    @@ -173,7 +173,7 @@ 27 Apr 2021

    - + Generalizing config.bcm support for BRCM silicons

    @@ -191,7 +191,7 @@ 18 May 2021

    - + Debug dump utility HLD

    @@ -200,7 +200,7 @@ 01 Jun 2021

    - + SAI Failure Handling

    @@ -231,4 +231,4 @@ -

    -

    SONiC 202111 Release:
    Thanks to all the contributors in making one more successful release 202111. A branch has been created with the completed features given below.
    ACL orch redesign, App extension CLI generation tool, Automatic tech support & core dump creation, Better route scalability with multiple next-hops, Class-Based Forwarding, CLI level authorization, DHCP support IPv6, Dynamic Policy Based Hashing, Dynamic port breakout, EXP to TC QoS maps, EVPN VXLAN for platforms using P2MP tunnel, Handle port config change on fly, Host interface trap counter, L2 functional & performance enhancements, Debian11, Debug dump utility, Overlay ECMP, PDK - Platform Development Environment, PINS (P4 Integrated Network Stack), Reclaim reserved buffer for unused ports, Routed sub-interface naming convention, SONiC for MPLS Dataplane, SRv6 support (Cntd), Support for passing IS-IS, LDP & MicroBFD packets to CPU, Upgrade SONiC init flow & VXLAN src port configuration. The list of features and the related pull requests are tracked in the Release Tracking page. +

    SONiC 202111 Release:
    Thanks to all the contributors in making one more successful release 202111. A branch has been created with the completed features given below.
    ACL orch redesign, App extension CLI generation tool, Automatic tech support & core dump creation, Better route scalability with multiple next-hops, Class-Based Forwarding, CLI level authorization, DHCP support IPv6, Dynamic Policy Based Hashing, Dynamic port breakout, EXP to TC QoS maps, EVPN VXLAN for platforms using P2MP tunnel, Handle port config change on fly, Host interface trap counter, L2 functional & performance enhancements, Debian11, Debug dump utility, Overlay ECMP, PDK - Platform Development Environment, PINS (P4 Integrated Network Stack), Reclaim reserved buffer for unused ports, Routed sub-interface naming convention, SONiC for MPLS Dataplane, SRv6 support (Cntd), Support for passing IS-IS, LDP & MicroBFD packets to CPU, Upgrade SONiC init flow & VXLAN src port configuration. The list of features and the related pull requests are tracked in the Release Tracking page.

    -

    SONiC 202205 Release:
    Roadmap page contains the list of features that are planned for the 202205 release. Welcoming more and more contributors for design meetings and for reviewing the design and code for yet another sucessful release ! +

    SONiC 202205 Release:
    Roadmap page contains the list of features that are planned for the 202205 release. Welcoming more and more contributors for design meetings and for reviewing the design and code for yet another sucessful release !

    @@ -186,7 +186,7 @@ 20 July

    - + DHCPv6 Relay agent

    @@ -204,7 +204,7 @@ 03 Aug

    - + Class Based Forwarding HLD

    @@ -213,7 +213,7 @@ 10 Aug

    - + SONiC_SFP_refactoring HLD

    @@ -231,7 +231,7 @@ 24 Aug

    - + SAG - Static Anycast Gateway

    @@ -240,7 +240,7 @@ 31 Aug

    - + Show Running Command Enhancement

    @@ -258,7 +258,7 @@ 14 Sep

    - + ECMP Overlay BFD support

    @@ -352,4 +352,4 @@ - \ No newline at end of file + diff --git a/previous_presentations.html b/previous_presentations.html index 2a1b136675..762eb65146 100644 --- a/previous_presentations.html +++ b/previous_presentations.html @@ -91,10 +91,10 @@

    PREVIOUS PRESENTATIONS

    OCP China 2019 Summit - SONiC Enable Fast Evolution Of Cloud Networking (Microsoft Video)

    OCP China 2019 Summit - Network Innovation - Collaboration With SONiC (Alibaba Video in Chinese)

    OCP Summit 2018 - SONiC Programmability, Extensibility and Beyond

    -

    SONiC Workshop in Beijing 2018 October

    +

    SONiC Workshop in Beijing 2018 October

    SONiC - Enabling Fast Evolution in the Networks

    -

    OCP Summit 2018 and SONiC/SAI Workshop Slides

    -

    OCP Summit 2016 SONiC Presentation Slides

    +

    OCP Summit 2018 and SONiC/SAI Workshop Slides

    +

    OCP Summit 2016 SONiC Presentation Slides

    OCP 2020 Virtual Summit - Panel Discussion - Open Networking and SONiC

    SONiC Video From OCP Summit 2019

    OCP Amsterdam 2019 Regional Summit - Going SONiC Together

    @@ -152,4 +152,4 @@

    PREVIOUS PRESENTATIONS

    - \ No newline at end of file + diff --git a/sonic-acl.yang b/sonic-acl.yang index 4081d1d8ad..084efd7b95 100644 --- a/sonic-acl.yang +++ b/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/Azure/sonic-acl"; + namespace "http://github.com/sonic-net/sonic-acl"; prefix sacl; yang-version 1.1; diff --git a/thermal-control-design.md b/thermal-control-design.md index 31018218d8..f0ca891d9c 100644 --- a/thermal-control-design.md +++ b/thermal-control-design.md @@ -52,7 +52,7 @@ In most case fan is the device to cool down the switch when the temperature is r Fan target speed and speed tolerance was defined, by examining them we can know whether the fan reached at the desired speed. -same as the temperature info, a [table for fan](https://github.com/Azure/SONiC/blob/master/doc/pmon/pmon-enhancement-design.md#153-fan-table) also defined as below: +same as the temperature info, a [table for fan](https://github.com/sonic-net/SONiC/blob/master/doc/pmon/pmon-enhancement-design.md#153-fan-table) also defined as below: ; Defines information for a fan key = FAN_INFO|fan_name ; information for the fan From 1d3e4f9e5a5119bdfa9539c221caaaccdecb2c93 Mon Sep 17 00:00:00 2001 From: kannankvs Date: Wed, 7 Sep 2022 18:42:52 +0530 Subject: [PATCH 07/18] Updated MoM file Updated MoM file until Aug 2022 --- MoM.html | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/MoM.html b/MoM.html index 88c8870acb..c39ffe3305 100755 --- a/MoM.html +++ b/MoM.html @@ -104,6 +104,71 @@

    SONiC community meeting minutes

    Links To Meeting Agenda Links To Minutes Of The meeting + +   Aug 30 2022    + HLD for changing teamd expiry timer + MoM + + +   Aug 23 2022    + S3IP sysfs specification & framework HLD + MoM + + +   Aug 16 2022    + Syslog rate limit design + MoM + + +   Aug 09 2022    + Persistent loglevel HLD + MoM + + +   Aug 02 2022    + OpenPoE + MoM + + +   Jul 26 2022    + Secure Boot & Secure upgrade + MoM + + +   Jul 19 2022    + SRv6_uSID + MoM + + +   Jul 12 2022    + No Meeting + MoM + + +   Jul 05 2022    + SONiC Bulk Counter Design + MoM + + +   Jun 28 2022    + SONiC gNMI server interface design + MoM + + +   Jun 21 2022    + Packet_I/O Update + MoM + + +   Jun 14 2022    + SONiC 202205 release update + MoM + + +   Jun 07 2022    + PIT & Yang schema based event stream via gNMI + MoM +   May 31 2022    Platform_Integration_Testing From 1d926477643dbb9765d013b2c21dc84de5adef7e Mon Sep 17 00:00:00 2001 From: maipbui Date: Wed, 7 Sep 2022 15:03:43 +0000 Subject: [PATCH 08/18] Change from sonic-telemetry to sonic-gnmi Signed-off-by: maipbui --- doc/SONiC_201911_Release_Notes.md | 2 +- doc/SONiC_202012_Release_Notes.md | 4 ++-- doc/SONiC_202106_Release_Notes.md | 4 ++-- doc/mgmt/Management Framework.md | 6 +++--- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/SONiC_201911_Release_Notes.md b/doc/SONiC_201911_Release_Notes.md index 7e9b075667..8f93e3ad15 100644 --- a/doc/SONiC_201911_Release_Notes.md +++ b/doc/SONiC_201911_Release_Notes.md @@ -79,7 +79,7 @@ Refer [Loganalyzer API usage example](https://github.com/yvolynets-mlnx/sonic-mg #### Management Framework Management framework is a SONiC application which is responsible for providing various common North Bound Interfaces (NBIs) for the purposes of managing configuration and status on SONiC switches. The application manages coordination of NBI’s to provide a coherent way to validate, apply and show configuration. Refer [HLD Document](https://github.com/sonic-net/SONiC/blob/master/doc/mgmt/Management%20Framework.md) -
    **Pull Requests** : [18](https://github.com/sonic-net/sonic-mgmt-framework/pull/18) , [23](https://github.com/sonic-net/sonic-telemetry/pull/23) , [3488](https://github.com/sonic-net/sonic-buildimage/pull/3488) , [659](https://github.com/sonic-net/sonic-utilities/pull/659) +
    **Pull Requests** : [18](https://github.com/sonic-net/sonic-mgmt-framework/pull/18) , [23](https://github.com/sonic-net/sonic-gnmi/pull/23) , [3488](https://github.com/sonic-net/sonic-buildimage/pull/3488) , [659](https://github.com/sonic-net/sonic-utilities/pull/659) #### Management VRF Management VRF (mvrf) feature provides a separation between the management network traffic and the data plane network traffic using the linux CGROUPS based on l3mdev. Management interface (eth0) shall be enslaved in l3mdev. Management applications like SSH shall use the enslaved eth0 and corresponding mvrf routing table for management traffic. diff --git a/doc/SONiC_202012_Release_Notes.md b/doc/SONiC_202012_Release_Notes.md index 92ceae2ec7..a3004a98d7 100644 --- a/doc/SONiC_202012_Release_Notes.md +++ b/doc/SONiC_202012_Release_Notes.md @@ -127,7 +127,7 @@ The SONiC Management Framework provides a unified UI stack, enabling SONiC to be This set of enhancements extends the framework, including (but not limited to) the following additions: - - CLI: Usability enhancements, performance enhancements, User-document generation -- Translib Infrastructure: Much of the UI infrastructure is separated out into a new repo (sonic-mgmt-common), de-coupling it from the UI code (which remains in the sonic-mgmt-framework repo). This allows the sonic-telemetry container (which also uses the infra) to be built and used independently from sonic-mgmt-framework. Other enhancements include support for RPC, YANG versioning, bulk calls (e.g. from gNMI), Authorization, and other code optimizations +- Translib Infrastructure: Much of the UI infrastructure is separated out into a new repo (sonic-mgmt-common), de-coupling it from the UI code (which remains in the sonic-mgmt-framework repo). This allows the sonic-gnmi container (which also uses the infra) to be built and used independently from sonic-mgmt-framework. Other enhancements include support for RPC, YANG versioning, bulk calls (e.g. from gNMI), Authorization, and other code optimizations - CVL: This is an infrastructure component to perform UI validations. It is enhanced here to support Dynamic Port Breakout configuration dependency and for improved performance. - Transformer: This is an infrastructure component to perform YANG tree to configuration object translations. Enhancements include support for more overloading functions, cascaded operations (for dynamic port breakout) and aliasing - REST Server: Enhancements include RBAC, RESTCONF, YANG module discovery, statistics and other optimizations @@ -135,7 +135,7 @@ This set of enhancements extends the framework, including (but not limited to) t - Use of DBus for communication into the host - Build enhancements
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/34cac1aabdc865fc41cbe064a2ab2442645524b1/doc/mgmt/Management%20Framework.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4799](https://github.com/sonic-net/sonic-buildimage/pull/4799),[4765](https://github.com/sonic-net/sonic-buildimage/pull/4765),[4840](https://github.com/sonic-net/sonic-buildimage/pull/4840),[35](https://github.com/sonic-net/sonic-telemetry/pull/35), [38](https://github.com/sonic-net/sonic-telemetry/pull/38),[126](https://github.com/sonic-net/sonic-build-tools/pull/126), [170](https://github.com/sonic-net/sonic-build-tools/pull/170), [10](https://github.com/sonic-net/sonic-mgmt-common/pull/10),[11](https://github.com/sonic-net/sonic-mgmt-common/pull/11), [12](https://github.com/sonic-net/sonic-mgmt-common/pull/12), [13](https://github.com/sonic-net/sonic-mgmt-common/pull/13), [15](https://github.com/sonic-net/sonic-mgmt-common/pull/15), [16](https://github.com/sonic-net/sonic-mgmt-common/pull/16), [18](https://github.com/sonic-net/sonic-mgmt-common/pull/18), [19](https://github.com/sonic-net/sonic-mgmt-common/pull/19), [20](https://github.com/sonic-net/sonic-mgmt-common/pull/20), [21](https://github.com/sonic-net/sonic-mgmt-common/pull/21), [22](https://github.com/sonic-net/sonic-mgmt-common/pull/22), [23](https://github.com/sonic-net/sonic-mgmt-common/pull/23), [26](https://github.com/sonic-net/sonic-mgmt-common/pull/26), [27](https://github.com/sonic-net/sonic-mgmt-common/pull/27), [28](https://github.com/sonic-net/sonic-mgmt-common/pull/28), [31](https://github.com/sonic-net/sonic-mgmt-common/pull/31), [32](https://github.com/sonic-net/sonic-mgmt-common/pull/32), [34](https://github.com/sonic-net/sonic-mgmt-common/pull/34), [35](https://github.com/sonic-net/sonic-mgmt-common/pull/35), [50](https://github.com/sonic-net/sonic-mgmt-framework/pull/50), [51](https://github.com/sonic-net/sonic-mgmt-framework/pull/51),[52](https://github.com/sonic-net/sonic-mgmt-framework/pull/52), [53](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [57](https://github.com/sonic-net/sonic-mgmt-framework/pull/57), [60](https://github.com/sonic-net/sonic-mgmt-framework/pull/60),[65](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [66](https://github.com/sonic-net/sonic-mgmt-framework/pull/66), [67](https://github.com/sonic-net/sonic-mgmt-framework/pull/67), [68](https://github.com/sonic-net/sonic-mgmt-framework/pull/68), [69](https://github.com/sonic-net/sonic-mgmt-framework/pull/69),[71](https://github.com/sonic-net/sonic-mgmt-framework/pull/71), [5810](https://github.com/sonic-net/sonic-buildimage/pull/5810),[5920](https://github.com/sonic-net/sonic-buildimage/pull/5920),[72](https://github.com/sonic-net/sonic-mgmt-framework/pull/72), [73](https://github.com/sonic-net/sonic-mgmt-framework/pull/73), [5714](https://github.com/sonic-net/sonic-buildimage/pull/5714),[61](https://github.com/sonic-net/sonic-telemetry/pull/61) +
    **Pull Requests** : [4799](https://github.com/sonic-net/sonic-buildimage/pull/4799),[4765](https://github.com/sonic-net/sonic-buildimage/pull/4765),[4840](https://github.com/sonic-net/sonic-buildimage/pull/4840),[35](https://github.com/sonic-net/sonic-gnmi/pull/35), [38](https://github.com/sonic-net/sonic-gnmi/pull/38),[126](https://github.com/sonic-net/sonic-build-tools/pull/126), [170](https://github.com/sonic-net/sonic-build-tools/pull/170), [10](https://github.com/sonic-net/sonic-mgmt-common/pull/10),[11](https://github.com/sonic-net/sonic-mgmt-common/pull/11), [12](https://github.com/sonic-net/sonic-mgmt-common/pull/12), [13](https://github.com/sonic-net/sonic-mgmt-common/pull/13), [15](https://github.com/sonic-net/sonic-mgmt-common/pull/15), [16](https://github.com/sonic-net/sonic-mgmt-common/pull/16), [18](https://github.com/sonic-net/sonic-mgmt-common/pull/18), [19](https://github.com/sonic-net/sonic-mgmt-common/pull/19), [20](https://github.com/sonic-net/sonic-mgmt-common/pull/20), [21](https://github.com/sonic-net/sonic-mgmt-common/pull/21), [22](https://github.com/sonic-net/sonic-mgmt-common/pull/22), [23](https://github.com/sonic-net/sonic-mgmt-common/pull/23), [26](https://github.com/sonic-net/sonic-mgmt-common/pull/26), [27](https://github.com/sonic-net/sonic-mgmt-common/pull/27), [28](https://github.com/sonic-net/sonic-mgmt-common/pull/28), [31](https://github.com/sonic-net/sonic-mgmt-common/pull/31), [32](https://github.com/sonic-net/sonic-mgmt-common/pull/32), [34](https://github.com/sonic-net/sonic-mgmt-common/pull/34), [35](https://github.com/sonic-net/sonic-mgmt-common/pull/35), [50](https://github.com/sonic-net/sonic-mgmt-framework/pull/50), [51](https://github.com/sonic-net/sonic-mgmt-framework/pull/51),[52](https://github.com/sonic-net/sonic-mgmt-framework/pull/52), [53](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [57](https://github.com/sonic-net/sonic-mgmt-framework/pull/57), [60](https://github.com/sonic-net/sonic-mgmt-framework/pull/60),[65](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [66](https://github.com/sonic-net/sonic-mgmt-framework/pull/66), [67](https://github.com/sonic-net/sonic-mgmt-framework/pull/67), [68](https://github.com/sonic-net/sonic-mgmt-framework/pull/68), [69](https://github.com/sonic-net/sonic-mgmt-framework/pull/69),[71](https://github.com/sonic-net/sonic-mgmt-framework/pull/71), [5810](https://github.com/sonic-net/sonic-buildimage/pull/5810),[5920](https://github.com/sonic-net/sonic-buildimage/pull/5920),[72](https://github.com/sonic-net/sonic-mgmt-framework/pull/72), [73](https://github.com/sonic-net/sonic-mgmt-framework/pull/73), [5714](https://github.com/sonic-net/sonic-buildimage/pull/5714),[61](https://github.com/sonic-net/sonic-gnmi/pull/61) #### Merge common lib for C++ and python (SWSS common lib) This is a fix for common lib and associated files. diff --git a/doc/SONiC_202106_Release_Notes.md b/doc/SONiC_202106_Release_Notes.md index fa30205c2b..cca3ca0613 100644 --- a/doc/SONiC_202106_Release_Notes.md +++ b/doc/SONiC_202106_Release_Notes.md @@ -50,8 +50,8 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### 1. Telemetry for Multi-ASIC This feature is an enhancement on sonic_db_config package for multi-asic to read different namespace redis configuration. And enhanced V2R Lookup for multi-asic, enhanced gNMI Server to initiate redis connection, enhanced gNMI Server Get and enhanced the parsing of target in gNMI Request.
    -
    Refer [HLD document](https://github.com/sonic-net/sonic-telemetry/pull/77) and below mentioned PR's for more details. -
    **Pull Requests** : [77](https://github.com/sonic-net/sonic-telemetry/pull/77) +
    Refer [HLD document](https://github.com/sonic-net/sonic-gnmi/pull/77) and below mentioned PR's for more details. +
    **Pull Requests** : [77](https://github.com/sonic-net/sonic-gnmi/pull/77) #### 2. Add FRR running configuration to tech support diff --git a/doc/mgmt/Management Framework.md b/doc/mgmt/Management Framework.md index 2d7384d78e..bd08798c23 100644 --- a/doc/mgmt/Management Framework.md +++ b/doc/mgmt/Management Framework.md @@ -216,8 +216,8 @@ Management framework makes use of the translation library (Translib) written in #### 1.2.2 Container The management framework is designed to run in a single container named “sonic-mgmt-frameworkâ€. The container includes the REST server linked with Translib, and CLI process. -The gNMI support requires the gNMI server which is provided as a part of sonic-telemetry container. We would like to rename this container as the sonic-gnmi container as now it can perform configurations as well through the gNMI server. -Will introduce a new container sonic-mgmt-common to host the common code that is used both in the mgmt-framework and sonic-telemetry container. This new repo will compile into static libraries that will be used in the other two repos. This way sonic-telemetry repo can be compiled without the mgmt-framework being present in the code base. +The gNMI support requires the gNMI server which is provided as a part of sonic-gnmi container. We would like to rename this container as the sonic-gnmi container as now it can perform configurations as well through the gNMI server. +Will introduce a new container sonic-mgmt-common to host the common code that is used both in the mgmt-framework and sonic-gnmi container. This new repo will compile into static libraries that will be used in the other two repos. This way sonic-gnmi repo can be compiled without the mgmt-framework being present in the code base. ## 2 Functionality @@ -2552,7 +2552,7 @@ Following are the list of Open source tools used in Management framework ## 12 Appendix B Following are the list of Open source libraries used in telemetry container. -Always refer to the [Makefile](https://github.com/sonic-net/sonic-telemetry/blob/master/Makefile) for the sonic-telemetry container for current package list. +Always refer to the [Makefile](https://github.com/sonic-net/sonic-gnmi/blob/master/Makefile) for the sonic-gnmi container for current package list. 1. [GRPC](https://google.golang.org/grpc) From 6a9655c79dc81b187fefbde1b82aea3e98b6d1ad Mon Sep 17 00:00:00 2001 From: maipbui Date: Wed, 7 Sep 2022 17:22:46 +0000 Subject: [PATCH 09/18] Keep Azure sonic-build-tools unchanged Signed-off-by: maipbui --- doc/SONiC_202012_Release_Notes.md | 4 ++-- doc/SONiC_202106_Release_Notes.md | 2 +- doc/aaa/TACACS+ Test Plan.md | 2 +- doc/lag/LACP Fallback Test Plan.md | 2 +- doc/qos/dynamically-headroom-calculation.md | 2 +- doc/sflow/Sflow_test_plan.md | 2 +- doc/sonic-build-system/build-enhancements.md | 2 +- index.html | 2 +- menu.html | 2 +- 9 files changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/SONiC_202012_Release_Notes.md b/doc/SONiC_202012_Release_Notes.md index a3004a98d7..6c4f4e61aa 100644 --- a/doc/SONiC_202012_Release_Notes.md +++ b/doc/SONiC_202012_Release_Notes.md @@ -113,7 +113,7 @@ What we implement in this release: - The cli commands config & show are provided to manage the support If you have an infrastructure that runs kubernetes master cluster, then you could -- You could have your build pipeline push docker images to your registry or ACR (sonic-net Container Registry) +- You could have your build pipeline push docker images to your registry or ACR (Azure Container Registry) - For intended updates, publish manifests - With node selector labels (optionally) - With image pull secrets provided @@ -135,7 +135,7 @@ This set of enhancements extends the framework, including (but not limited to) t - Use of DBus for communication into the host - Build enhancements
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/34cac1aabdc865fc41cbe064a2ab2442645524b1/doc/mgmt/Management%20Framework.md) and below mentioned PR's for more details. -
    **Pull Requests** : [4799](https://github.com/sonic-net/sonic-buildimage/pull/4799),[4765](https://github.com/sonic-net/sonic-buildimage/pull/4765),[4840](https://github.com/sonic-net/sonic-buildimage/pull/4840),[35](https://github.com/sonic-net/sonic-gnmi/pull/35), [38](https://github.com/sonic-net/sonic-gnmi/pull/38),[126](https://github.com/sonic-net/sonic-build-tools/pull/126), [170](https://github.com/sonic-net/sonic-build-tools/pull/170), [10](https://github.com/sonic-net/sonic-mgmt-common/pull/10),[11](https://github.com/sonic-net/sonic-mgmt-common/pull/11), [12](https://github.com/sonic-net/sonic-mgmt-common/pull/12), [13](https://github.com/sonic-net/sonic-mgmt-common/pull/13), [15](https://github.com/sonic-net/sonic-mgmt-common/pull/15), [16](https://github.com/sonic-net/sonic-mgmt-common/pull/16), [18](https://github.com/sonic-net/sonic-mgmt-common/pull/18), [19](https://github.com/sonic-net/sonic-mgmt-common/pull/19), [20](https://github.com/sonic-net/sonic-mgmt-common/pull/20), [21](https://github.com/sonic-net/sonic-mgmt-common/pull/21), [22](https://github.com/sonic-net/sonic-mgmt-common/pull/22), [23](https://github.com/sonic-net/sonic-mgmt-common/pull/23), [26](https://github.com/sonic-net/sonic-mgmt-common/pull/26), [27](https://github.com/sonic-net/sonic-mgmt-common/pull/27), [28](https://github.com/sonic-net/sonic-mgmt-common/pull/28), [31](https://github.com/sonic-net/sonic-mgmt-common/pull/31), [32](https://github.com/sonic-net/sonic-mgmt-common/pull/32), [34](https://github.com/sonic-net/sonic-mgmt-common/pull/34), [35](https://github.com/sonic-net/sonic-mgmt-common/pull/35), [50](https://github.com/sonic-net/sonic-mgmt-framework/pull/50), [51](https://github.com/sonic-net/sonic-mgmt-framework/pull/51),[52](https://github.com/sonic-net/sonic-mgmt-framework/pull/52), [53](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [57](https://github.com/sonic-net/sonic-mgmt-framework/pull/57), [60](https://github.com/sonic-net/sonic-mgmt-framework/pull/60),[65](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [66](https://github.com/sonic-net/sonic-mgmt-framework/pull/66), [67](https://github.com/sonic-net/sonic-mgmt-framework/pull/67), [68](https://github.com/sonic-net/sonic-mgmt-framework/pull/68), [69](https://github.com/sonic-net/sonic-mgmt-framework/pull/69),[71](https://github.com/sonic-net/sonic-mgmt-framework/pull/71), [5810](https://github.com/sonic-net/sonic-buildimage/pull/5810),[5920](https://github.com/sonic-net/sonic-buildimage/pull/5920),[72](https://github.com/sonic-net/sonic-mgmt-framework/pull/72), [73](https://github.com/sonic-net/sonic-mgmt-framework/pull/73), [5714](https://github.com/sonic-net/sonic-buildimage/pull/5714),[61](https://github.com/sonic-net/sonic-gnmi/pull/61) +
    **Pull Requests** : [4799](https://github.com/sonic-net/sonic-buildimage/pull/4799),[4765](https://github.com/sonic-net/sonic-buildimage/pull/4765),[4840](https://github.com/sonic-net/sonic-buildimage/pull/4840),[35](https://github.com/sonic-net/sonic-gnmi/pull/35), [38](https://github.com/sonic-net/sonic-gnmi/pull/38),[126](https://github.com/Azure/sonic-build-tools/pull/126), [170](https://github.com/Azure/sonic-build-tools/pull/170), [10](https://github.com/sonic-net/sonic-mgmt-common/pull/10),[11](https://github.com/sonic-net/sonic-mgmt-common/pull/11), [12](https://github.com/sonic-net/sonic-mgmt-common/pull/12), [13](https://github.com/sonic-net/sonic-mgmt-common/pull/13), [15](https://github.com/sonic-net/sonic-mgmt-common/pull/15), [16](https://github.com/sonic-net/sonic-mgmt-common/pull/16), [18](https://github.com/sonic-net/sonic-mgmt-common/pull/18), [19](https://github.com/sonic-net/sonic-mgmt-common/pull/19), [20](https://github.com/sonic-net/sonic-mgmt-common/pull/20), [21](https://github.com/sonic-net/sonic-mgmt-common/pull/21), [22](https://github.com/sonic-net/sonic-mgmt-common/pull/22), [23](https://github.com/sonic-net/sonic-mgmt-common/pull/23), [26](https://github.com/sonic-net/sonic-mgmt-common/pull/26), [27](https://github.com/sonic-net/sonic-mgmt-common/pull/27), [28](https://github.com/sonic-net/sonic-mgmt-common/pull/28), [31](https://github.com/sonic-net/sonic-mgmt-common/pull/31), [32](https://github.com/sonic-net/sonic-mgmt-common/pull/32), [34](https://github.com/sonic-net/sonic-mgmt-common/pull/34), [35](https://github.com/sonic-net/sonic-mgmt-common/pull/35), [50](https://github.com/sonic-net/sonic-mgmt-framework/pull/50), [51](https://github.com/sonic-net/sonic-mgmt-framework/pull/51),[52](https://github.com/sonic-net/sonic-mgmt-framework/pull/52), [53](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [57](https://github.com/sonic-net/sonic-mgmt-framework/pull/57), [60](https://github.com/sonic-net/sonic-mgmt-framework/pull/60),[65](https://github.com/sonic-net/sonic-mgmt-framework/pull/65), [66](https://github.com/sonic-net/sonic-mgmt-framework/pull/66), [67](https://github.com/sonic-net/sonic-mgmt-framework/pull/67), [68](https://github.com/sonic-net/sonic-mgmt-framework/pull/68), [69](https://github.com/sonic-net/sonic-mgmt-framework/pull/69),[71](https://github.com/sonic-net/sonic-mgmt-framework/pull/71), [5810](https://github.com/sonic-net/sonic-buildimage/pull/5810),[5920](https://github.com/sonic-net/sonic-buildimage/pull/5920),[72](https://github.com/sonic-net/sonic-mgmt-framework/pull/72), [73](https://github.com/sonic-net/sonic-mgmt-framework/pull/73), [5714](https://github.com/sonic-net/sonic-buildimage/pull/5714),[61](https://github.com/sonic-net/sonic-gnmi/pull/61) #### Merge common lib for C++ and python (SWSS common lib) This is a fix for common lib and associated files. diff --git a/doc/SONiC_202106_Release_Notes.md b/doc/SONiC_202106_Release_Notes.md index cca3ca0613..5d35eb14cc 100644 --- a/doc/SONiC_202106_Release_Notes.md +++ b/doc/SONiC_202106_Release_Notes.md @@ -138,7 +138,7 @@ This implementation describes the high level design of RADIUS management user au #### 13. PDK - Platform Development Environment The SONiC PDE is part of the SONiC Platform Development Kit (PDK) which optimizes platform development. The SONiC PDK consists of PDDF (Platform Driver Development Framework) and PDE (Platform Development Environment)
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/platform/pde.md) and below mentioned PR's for more details. -
    **Pull Requests** : [3778](https://github.com/sonic-net/sonic-buildimage/pull/3778) [28](https://github.com/sonic-net/sonic-platform-pdk-pde/pull/28), [107](https://github.com/sonic-net/sonic-build-tools/pull/107). +
    **Pull Requests** : [3778](https://github.com/sonic-net/sonic-buildimage/pull/3778) [28](https://github.com/sonic-net/sonic-platform-pdk-pde/pull/28), [107](https://github.com/Azure/sonic-build-tools/pull/107). #### 14. Broadcom silicon common config diff --git a/doc/aaa/TACACS+ Test Plan.md b/doc/aaa/TACACS+ Test Plan.md index a2b3ea0f4b..6f79ff33f0 100644 --- a/doc/aaa/TACACS+ Test Plan.md +++ b/doc/aaa/TACACS+ Test Plan.md @@ -4,7 +4,7 @@ Related documents | **Document Name** | **Link** | |-------------------|----------| -| AAA_with_SONiC_v2 | [https://github.com/sonic-net/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/AAA_with_SONiC_v2.docx) | +| AAA_with_SONiC_v2 | [https://github.com/sonic-net/SONiC/blob/gh-pages/doc/aaa/AAA_with_SONiC_v2.docx](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/aaa/AAA_with_SONiC_v2.docx) | | pam_tacplus | [https://github.com/jeroennijhof/pam_tacplus/blob/master/README.md](https://github.com/jeroennijhof/pam_tacplus/blob/master/README.md) | | tacacs+ daemon | [http://manpages.ubuntu.com/manpages/xenial/man8/tac_plus.8.html](http://manpages.ubuntu.com/manpages/xenial/man8/tac_plus.8.html) | diff --git a/doc/lag/LACP Fallback Test Plan.md b/doc/lag/LACP Fallback Test Plan.md index 6c31b2c099..81052a0e82 100644 --- a/doc/lag/LACP Fallback Test Plan.md +++ b/doc/lag/LACP Fallback Test Plan.md @@ -15,7 +15,7 @@ **Related documents** -[LACP Fallback Design Document](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/LACP%20Fallback%20Feature%20for%20SONiC_v0.3.docx) +[LACP Fallback Design Document](https://github.com/sonic-net/SONiC/blob/gh-pages/doc/lag/LACP%20Fallback%20Feature%20for%20SONiC_v0.5.md) # Overview This feature test suite is targeting on testing LACP fallback feature on SONiC. In our testbed, 't0' and 't1-lag' have LAG configurations. Each test covers a basic functionality of LACP fallback feature and ensures the switch works as expected under production scenarios. diff --git a/doc/qos/dynamically-headroom-calculation.md b/doc/qos/dynamically-headroom-calculation.md index c1b85a6ea1..e71f7fa0af 100644 --- a/doc/qos/dynamically-headroom-calculation.md +++ b/doc/qos/dynamically-headroom-calculation.md @@ -131,7 +131,7 @@ Backward compatibility is supported in the following ways: In this section we will introduce the ways it is achieved. -Currently, the SONiC system starts buffer manager from swss docker by the `supervisor` according to the following settings in [`/etc/supervisor/conf.d/supervisord.conf`](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) in `swss` docker. For the traditional mode, the argument is `-l /usr/share/sonic/hwsku/pg_profile_lookup.ini` which means to load the pg lookup file. +Currently, the SONiC system starts buffer manager from swss docker by the `supervisor` according to the following settings in [`/etc/supervisor/conf.d/supervisord.conf.j2`](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf.j2) in `swss` docker. For the traditional mode, the argument is `-l /usr/share/sonic/hwsku/pg_profile_lookup.ini` which means to load the pg lookup file. ```shell [program:buffermgrd] diff --git a/doc/sflow/Sflow_test_plan.md b/doc/sflow/Sflow_test_plan.md index 8f55850935..71b5eaa519 100644 --- a/doc/sflow/Sflow_test_plan.md +++ b/doc/sflow/Sflow_test_plan.md @@ -14,7 +14,7 @@ The test is targeting a running SONIC system with fully functioning configuratio The test will run on the t0 testbed: -![testbed-t0.png](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/doc/img/testbed-t0.png?raw=true) +![testbed-t0.png](https://github.com/sonic-net/sonic-mgmt/blob/master/docs/testbed/img/testbed-t0.png?raw=true) - 1 port from each port channel is used for traffic. Sflow is enabled on these 4 ports - 2 ports from Vlan1000 are removed and used to reach sflow collector in ptf docker . diff --git a/doc/sonic-build-system/build-enhancements.md b/doc/sonic-build-system/build-enhancements.md index e7e34a931e..31e8d3cc54 100644 --- a/doc/sonic-build-system/build-enhancements.md +++ b/doc/sonic-build-system/build-enhancements.md @@ -80,7 +80,7 @@ This feature provides improvements in three essential areas. Reference: - Version caching feature is enhanced on top of DPKG caching and Versioning framework. Ref: - - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt + - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.pptx - https://github.com/xumia/SONiC/blob/repd3/doc/sonic-build-system/SONiC-Reproduceable-Build.md # Feature Requirements diff --git a/index.html b/index.html index 12dbee902a..69277eabc4 100644 --- a/index.html +++ b/index.html @@ -108,7 +108,7 @@
  • How To Contribute
  • Governance
  • SONiC Foundation Technical Charter
    • -
  • Security Process
    • +
  • Security Process
  • License & Logo
    • diff --git a/menu.html b/menu.html index 86e0213412..8669c64ee1 100644 --- a/menu.html +++ b/menu.html @@ -57,7 +57,7 @@
  • How To Contribute
  • Governance
  • SONiC Foundation Technical Charter
    • -
  • Security Process
    • +
  • Security Process
  • License & Logo
    • From 7fe676c54e0f7d303773762c81bc1d87d7a7a3d5 Mon Sep 17 00:00:00 2001 From: maipbui Date: Wed, 7 Sep 2022 21:52:32 +0000 Subject: [PATCH 10/18] Keep broken URLs unchanged Signed-off-by: maipbui --- index.html | 2 +- menu.html | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 69277eabc4..7eb0115741 100644 --- a/index.html +++ b/index.html @@ -70,7 +70,7 @@
  • SONiC From fe9d63a084a945c19c40ef2a25a31369d524bc65 Mon Sep 17 00:00:00 2001 From: maipbui Date: Thu, 8 Sep 2022 01:25:22 +0000 Subject: [PATCH 11/18] Fix URLs only, not fix text Signed-off-by: maipbui --- doc/SONiC_202012_Release_Notes.md | 2 +- doc/auto_techsupport_and_coredump_mgmt.md | 2 +- doc/mgmt/Management Framework.md | 4 ++-- doc/mgmt/SONiC_YANG_Model_Guidelines.md | 6 +++--- doc/mgmt/sonic-acl.yang | 2 +- doc/nvgre_tunnel/nvgre_tunnel.md | 2 +- doc/passw_hardening/hld_password_hardening.md | 2 +- doc/pbh/pbh-design.md | 2 +- .../img/docker-infra-concepts.svg | 8 ++++---- doc/sonic-application-extension/img/packages-json.svg | 8 ++++---- .../sonic-application-extention-hld.md | 6 +++--- doc/syslog/syslog-design.md | 2 +- 12 files changed, 23 insertions(+), 23 deletions(-) diff --git a/doc/SONiC_202012_Release_Notes.md b/doc/SONiC_202012_Release_Notes.md index 6c4f4e61aa..053c1c6d23 100644 --- a/doc/SONiC_202012_Release_Notes.md +++ b/doc/SONiC_202012_Release_Notes.md @@ -127,7 +127,7 @@ The SONiC Management Framework provides a unified UI stack, enabling SONiC to be This set of enhancements extends the framework, including (but not limited to) the following additions: - - CLI: Usability enhancements, performance enhancements, User-document generation -- Translib Infrastructure: Much of the UI infrastructure is separated out into a new repo (sonic-mgmt-common), de-coupling it from the UI code (which remains in the sonic-mgmt-framework repo). This allows the sonic-gnmi container (which also uses the infra) to be built and used independently from sonic-mgmt-framework. Other enhancements include support for RPC, YANG versioning, bulk calls (e.g. from gNMI), Authorization, and other code optimizations +- Translib Infrastructure: Much of the UI infrastructure is separated out into a new repo (sonic-mgmt-common), de-coupling it from the UI code (which remains in the sonic-mgmt-framework repo). This allows the sonic-telemetry container (which also uses the infra) to be built and used independently from sonic-mgmt-framework. Other enhancements include support for RPC, YANG versioning, bulk calls (e.g. from gNMI), Authorization, and other code optimizations - CVL: This is an infrastructure component to perform UI validations. It is enhanced here to support Dynamic Port Breakout configuration dependency and for improved performance. - Transformer: This is an infrastructure component to perform YANG tree to configuration object translations. Enhancements include support for more overloading functions, cascaded operations (for dynamic port breakout) and aliasing - REST Server: Enhancements include RBAC, RESTCONF, YANG module discovery, statistics and other optimizations diff --git a/doc/auto_techsupport_and_coredump_mgmt.md b/doc/auto_techsupport_and_coredump_mgmt.md index 9adf58a7b8..97704af41b 100644 --- a/doc/auto_techsupport_and_coredump_mgmt.md +++ b/doc/auto_techsupport_and_coredump_mgmt.md @@ -168,7 +168,7 @@ module sonic-auto_techsupport { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-auto_techsupport"; + namespace "http://github.com/Azure/sonic-auto_techsupport"; prefix auto_techsupport; import sonic-types { diff --git a/doc/mgmt/Management Framework.md b/doc/mgmt/Management Framework.md index bd08798c23..6938e557bf 100644 --- a/doc/mgmt/Management Framework.md +++ b/doc/mgmt/Management Framework.md @@ -216,8 +216,8 @@ Management framework makes use of the translation library (Translib) written in #### 1.2.2 Container The management framework is designed to run in a single container named “sonic-mgmt-frameworkâ€. The container includes the REST server linked with Translib, and CLI process. -The gNMI support requires the gNMI server which is provided as a part of sonic-gnmi container. We would like to rename this container as the sonic-gnmi container as now it can perform configurations as well through the gNMI server. -Will introduce a new container sonic-mgmt-common to host the common code that is used both in the mgmt-framework and sonic-gnmi container. This new repo will compile into static libraries that will be used in the other two repos. This way sonic-gnmi repo can be compiled without the mgmt-framework being present in the code base. +The gNMI support requires the gNMI server which is provided as a part of sonic-telemetry container. We would like to rename this container as the sonic-telemetry container as now it can perform configurations as well through the gNMI server. +Will introduce a new container sonic-mgmt-common to host the common code that is used both in the mgmt-framework and sonic-telemetry container. This new repo will compile into static libraries that will be used in the other two repos. This way sonic-telemetry repo can be compiled without the mgmt-framework being present in the code base. ## 2 Functionality diff --git a/doc/mgmt/SONiC_YANG_Model_Guidelines.md b/doc/mgmt/SONiC_YANG_Model_Guidelines.md index 6b9147b4a7..a2d7127dad 100644 --- a/doc/mgmt/SONiC_YANG_Model_Guidelines.md +++ b/doc/mgmt/SONiC_YANG_Model_Guidelines.md @@ -53,13 +53,13 @@ module sonic-acl { } ``` -### 3. Define namespace as "http://github.com/sonic-net/{model-name}". +### 3. Define namespace as "http://github.com/Azure/{model-name}". Example : #### YANG ``` module sonic-acl { - namespace "http://github.com/sonic-net/sonic-acl"; + namespace "http://github.com/Azure/sonic-acl"; ..... ..... } @@ -633,7 +633,7 @@ module sonic-port { ``` module sonic-acl { - namespace "http://github.com/sonic-net/sonic-acl"; + namespace "http://github.com/Azure/sonic-acl"; prefix sacl; yang-version 1.1; diff --git a/doc/mgmt/sonic-acl.yang b/doc/mgmt/sonic-acl.yang index 084efd7b95..4081d1d8ad 100644 --- a/doc/mgmt/sonic-acl.yang +++ b/doc/mgmt/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/sonic-net/sonic-acl"; + namespace "http://github.com/Azure/sonic-acl"; prefix sacl; yang-version 1.1; diff --git a/doc/nvgre_tunnel/nvgre_tunnel.md b/doc/nvgre_tunnel/nvgre_tunnel.md index 2a940584fe..390845b88a 100755 --- a/doc/nvgre_tunnel/nvgre_tunnel.md +++ b/doc/nvgre_tunnel/nvgre_tunnel.md @@ -197,7 +197,7 @@ module sonic-nvgre-tunnel { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-nvgre-tunnel"; + namespace "http://github.com/Azure/sonic-nvgre-tunnel"; prefix nvgre; import ietf-inet-types { diff --git a/doc/passw_hardening/hld_password_hardening.md b/doc/passw_hardening/hld_password_hardening.md index 5d9eded896..477f9e271b 100644 --- a/doc/passw_hardening/hld_password_hardening.md +++ b/doc/passw_hardening/hld_password_hardening.md @@ -313,7 +313,7 @@ SPECIAL_CLASS = "True" / "False" //filename: sonic-passw.yang module sonic-passwh { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-passwh"; + namespace "http://github.com/Azure/sonic-passwh"; prefix passwh; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/doc/pbh/pbh-design.md b/doc/pbh/pbh-design.md index 80018b8518..47ec2df3cd 100644 --- a/doc/pbh/pbh-design.md +++ b/doc/pbh/pbh-design.md @@ -1052,7 +1052,7 @@ module sonic-pbh { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-pbh"; + namespace "http://github.com/Azure/sonic-pbh"; prefix pbh; import ietf-inet-types { diff --git a/doc/sonic-application-extension/img/docker-infra-concepts.svg b/doc/sonic-application-extension/img/docker-infra-concepts.svg index b29967c7b7..2f6c3af628 100644 --- a/doc/sonic-application-extension/img/docker-infra-concepts.svg +++ b/doc/sonic-application-extension/img/docker-infra-concepts.svg @@ -54,7 +54,7 @@ Sheet.13 Rounded Rectangle.2 - sonic-net/sonic-dhcp-relay + Azure/sonic-dhcp-relay @@ -78,10 +78,10 @@ - sonic-net/sonic-dhcp-relay + Azure/sonic-dhcp-relay Rounded Rectangle.3 - sonic-net/sonic-snmp + Azure/sonic-snmp @@ -105,7 +105,7 @@ - sonic-net/sonic-snmp + Azure/sonic-snmp Sheet.8 diff --git a/doc/sonic-application-extension/img/packages-json.svg b/doc/sonic-application-extension/img/packages-json.svg index 1ca92f5b24..73fdbd3a5a 100644 --- a/doc/sonic-application-extension/img/packages-json.svg +++ b/doc/sonic-application-extension/img/packages-json.svg @@ -86,7 +86,7 @@ Sheet.24 Rounded Rectangle.2 - sonic-net/sonic-dhcp-relay + Azure/sonic-dhcp-relay @@ -110,10 +110,10 @@ - sonic-net/sonic-dhcp-relay + Azure/sonic-dhcp-relay Rounded Rectangle.3 - sonic-net/sonic-snmp + Azure/sonic-snmp @@ -137,7 +137,7 @@ - sonic-net/sonic-snmp + Azure/sonic-snmp Sheet.27 diff --git a/doc/sonic-application-extension/sonic-application-extention-hld.md b/doc/sonic-application-extension/sonic-application-extention-hld.md index 7288308f0d..905bf518d4 100644 --- a/doc/sonic-application-extension/sonic-application-extention-hld.md +++ b/doc/sonic-application-extension/sonic-application-extention-hld.md @@ -156,7 +156,7 @@ Basic definitions: There are three notions: *package*, *repository* and *registry*. A repository is a Docker registry (private or open like Docker Hub) repository with tagged images for specific package. -In the above figure *sonic-net/sonic-dhcp-relay* and *sonic-net/sonic-snmp* are repositories with a set of images. +In the above figure *Azure/sonic-dhcp-relay* and *Azure/sonic-snmp* are repositories with a set of images. ### SONiC Package @@ -254,13 +254,13 @@ A sample of the content in JSON format: "installed-version": "1.0.0" }, "dhcp-relay": { - "repository": "sonic-net/sonic-dhcp-relay", + "repository": "Azure/sonic-dhcp-relay", "description": "DHCP relay feature", "default-reference": "sha256:5d41c289942008211c2964bca72800f5c9d5ea5aa4057528da617fb36463d4ab", "status": "not-installed" }, "snmp": { - "repository": "sonic-net/sonic-snmp", + "repository": "Azure/sonic-snmp", "description": "Simple Network Monitoring Protocol", "default-reference": "1.0.0", "status": "installed", diff --git a/doc/syslog/syslog-design.md b/doc/syslog/syslog-design.md index 6fbb5efc14..702c3a8bd7 100644 --- a/doc/syslog/syslog-design.md +++ b/doc/syslog/syslog-design.md @@ -466,7 +466,7 @@ module sonic-syslog { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-system-syslog"; + namespace "http://github.com/Azure/sonic-system-syslog"; prefix syslog; import ietf-inet-types { From ef251b14e0d7f6c8475e8947b16c7a2a9c5d73d0 Mon Sep 17 00:00:00 2001 From: maipbui Date: Thu, 8 Sep 2022 16:33:55 +0000 Subject: [PATCH 12/18] Fix plain text Signed-off-by: maipbui --- doc/mgmt/Management Framework.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/mgmt/Management Framework.md b/doc/mgmt/Management Framework.md index 6938e557bf..b7728bbcd2 100644 --- a/doc/mgmt/Management Framework.md +++ b/doc/mgmt/Management Framework.md @@ -216,7 +216,7 @@ Management framework makes use of the translation library (Translib) written in #### 1.2.2 Container The management framework is designed to run in a single container named “sonic-mgmt-frameworkâ€. The container includes the REST server linked with Translib, and CLI process. -The gNMI support requires the gNMI server which is provided as a part of sonic-telemetry container. We would like to rename this container as the sonic-telemetry container as now it can perform configurations as well through the gNMI server. +The gNMI support requires the gNMI server which is provided as a part of sonic-telemetry container. We would like to rename this container as the sonic-gnmi container as now it can perform configurations as well through the gNMI server. Will introduce a new container sonic-mgmt-common to host the common code that is used both in the mgmt-framework and sonic-telemetry container. This new repo will compile into static libraries that will be used in the other two repos. This way sonic-telemetry repo can be compiled without the mgmt-framework being present in the code base. ## 2 Functionality From e3613f64e0a7696766bea68117259950543753af Mon Sep 17 00:00:00 2001 From: Muhammad Haris Azaz Khan <77955039+haris-khan1596@users.noreply.github.com> Date: Fri, 9 Sep 2022 08:09:56 +0500 Subject: [PATCH 13/18] Update VRF unbind command in sonic-vrf-hld.md (#1070) *Updated VRF unbind command to remove additional argument. --- doc/vrf/sonic-vrf-hld.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/vrf/sonic-vrf-hld.md b/doc/vrf/sonic-vrf-hld.md index fbfe077dbc..e93c3c32f4 100644 --- a/doc/vrf/sonic-vrf-hld.md +++ b/doc/vrf/sonic-vrf-hld.md @@ -715,7 +715,7 @@ $ config vrf del $ config interface vrf bind //unbind an interface from a VRF -$ config interface vrf unbind +$ config interface vrf unbind // create loopback device $ config loopback add Loopback<0-999> @@ -824,7 +824,7 @@ This command will do the following: To unbind an interface from VRF: ```bash -$ config interface unbind Ethernet0 Vrf-blue +$ config interface unbind Ethernet0 ``` This command will do the following: From ebde65acf4528bb268cb10102b68f166d6392aa8 Mon Sep 17 00:00:00 2001 From: ganglv <88995770+ganglyu@users.noreply.github.com> Date: Sat, 10 Sep 2022 05:04:48 +0800 Subject: [PATCH 14/18] [HLD] SONiC GNMI Server Interface Design (#996) --- doc/mgmt/gnmi/README.md | 0 .../SONiC_GNMI_Server_Interface_Design.md | 568 ++++++ doc/mgmt/gnmi/images/cli.svg | 506 +++++ doc/mgmt/gnmi/images/data_flow.svg | 1442 ++++++++++++++ doc/mgmt/gnmi/images/data_flow_get.svg | 659 +++++++ doc/mgmt/gnmi/images/full_rpc.svg | 438 +++++ doc/mgmt/gnmi/images/full_rpc_gnoi.svg | 472 +++++ doc/mgmt/gnmi/images/get_lock.svg | 808 ++++++++ doc/mgmt/gnmi/images/gnmi.svg | 1089 +++++++++++ doc/mgmt/gnmi/images/heartbeat.svg | 608 ++++++ doc/mgmt/gnmi/images/incremental_rpc.svg | 397 ++++ doc/mgmt/gnmi/images/message_example.svg | 1686 +++++++++++++++++ doc/mgmt/gnmi/images/mixed requests.svg | 153 ++ doc/mgmt/gnmi/images/restapi.svg | 373 ++++ doc/mgmt/gnmi/images/set_lock.svg | 744 ++++++++ doc/mgmt/gnmi/images/telemetry.png | Bin 0 -> 101081 bytes 16 files changed, 9943 insertions(+) create mode 100644 doc/mgmt/gnmi/README.md create mode 100644 doc/mgmt/gnmi/SONiC_GNMI_Server_Interface_Design.md create mode 100644 doc/mgmt/gnmi/images/cli.svg create mode 100644 doc/mgmt/gnmi/images/data_flow.svg create mode 100644 doc/mgmt/gnmi/images/data_flow_get.svg create mode 100644 doc/mgmt/gnmi/images/full_rpc.svg create mode 100644 doc/mgmt/gnmi/images/full_rpc_gnoi.svg create mode 100644 doc/mgmt/gnmi/images/get_lock.svg create mode 100644 doc/mgmt/gnmi/images/gnmi.svg create mode 100644 doc/mgmt/gnmi/images/heartbeat.svg create mode 100644 doc/mgmt/gnmi/images/incremental_rpc.svg create mode 100644 doc/mgmt/gnmi/images/message_example.svg create mode 100644 doc/mgmt/gnmi/images/mixed requests.svg create mode 100644 doc/mgmt/gnmi/images/restapi.svg create mode 100644 doc/mgmt/gnmi/images/set_lock.svg create mode 100644 doc/mgmt/gnmi/images/telemetry.png diff --git a/doc/mgmt/gnmi/README.md b/doc/mgmt/gnmi/README.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/doc/mgmt/gnmi/SONiC_GNMI_Server_Interface_Design.md b/doc/mgmt/gnmi/SONiC_GNMI_Server_Interface_Design.md new file mode 100644 index 0000000000..d97234ba3a --- /dev/null +++ b/doc/mgmt/gnmi/SONiC_GNMI_Server_Interface_Design.md @@ -0,0 +1,568 @@ +# SONiC GNMI Server Interface Design + +# High Level Design Document + +#### Rev 0.1 + +# Table of Contents +- [Table of Contents](#table-of-contents) +- [List of Tables](#list-of-tables) +- [Revision](#revision) +- [About this Document](#about-this-document) +- [Scope](#scope) +- [Definition/Abbreviation](#definitionabbreviation) +- [1 Feature Overview](#1-feature-overview) + * [1.1 Requirements](#11-requirements) + * [1.2 Design Overview](#12-design-overview) +- [2 Error Handling](#2-error-handling) +- [3 Serviceability and Debug](#3-serviceability-and-debug) +- [4 Unit Tests](#4-unit-tests) + * [4.1 Unit Tests for Capabilities RPC](#41-unit-tests-for-capabilities-rpc) + * [4.2 Unit Tests for Get RPC](#42-unit-tests-for-get-rpc) + * [4.3 Unit Tests for Set RPC](#43-unit-tests-for-set-rpc) + +# List of Tables +[Table 1: Abbreviations](#table-1-abbreviations) + +[Table 2: Mapping Operations](#table-2-mapping-operations) + +[Table 3: Translate Example](#table-3-translate-example) + +# Revision + +| Rev | Date | Author | Change Description | +|:---:|:-----------:|:------------------:|---------------------| +| 0.1 | 05/05/2022 | Gang Lv | Initial version | + +# About this Document +This document provides a detailed description on the strategy to implement the SONiC GNMI Server Interface. + +# Scope +This document describes the high level design of SONiC GNMI Server Interface. + +This document provides minor implementation details about the proposed solutions. + +# Definition/Abbreviation + +### Table 1: Abbreviations +| **Term** | **Meaning** | +| -------- | -------------------------- | +| gRPC | A modern open-source high performance Remote Procedure Call (RPC) framework that can run in any environment | +| gNMI | gRPC Network Management Interface, used to retrieve or manipulate the state of a device via telemetry or configuration data | +| gNOI | gRPC Network Operations Interface | +| JSON | JavaScript Object Notation | +| Yang | Yet Another Next Generation, it is a modular language representing data structures in an XML tree format | +| Generic Config Updater | SONiC configuration generic update and rollback feature | +| ConfigDB | Configuration Database | +| ApplDB | Application Database | + +# 1 Feature Overview + +SONiC should provide a gNMI/gNOI server interface where the client can communicate with SONiC (server) through the interface using their respective gRPC libraries based on ConfigDB/ApplDB/StateDB/CountersDB schema or SONiC Yang schema. + +To understand the requirements, we need to go over current SONiC management components: + +* SONIC CLI commands + +cli + +1. Users could use SONiC CLI command "show runningconfig all" to read current configuration. + - The blue arrow indicates this process. +2. User could use SONiC CLI command "config apply-patch" to incrementally update configurations systematically and validate target configuration using SONiC Yang models. With generic_config_updater, all operations in a 'config apply-patch' command are processed in a single transaction that will either succeed or fail as a whole. + - "config apply-patch" supports ConfigDB, and Yang models. + - The green arrow indicates this process, and dotted arrow indicates Yang validation. +3. SONiC CLI commands can use "config reload" to erase original and fully reload configurations from a file and validate target configuration using SONiC Yang models. + - "config reload" already support input in ConfigDB schema or in yang models schema. + - The yellow arrow indicates this process, and dotted arrow indicates Yang validation. + +And we have the possibility to improve generic_config_updater performance. + +* SONIC Restapi + +restapi + +sonic-restapi is a docker container running in SONiC, which exposes HTTPS endpoints to perform dynamic configuration including config VNET routes. +One challenge of sonic-restapi is to provide a general config schema. Currently its API is designed case by case. + +sonic-restapi will be replaced by gNMI interface in the future. + +* SONiC system telemetry services + +telemetry + +sonic-telemetry provides gNMI/gNOI server interface. And sonic-telemetry provides only telemetry via gRPC, and the gap is configuration. + +We will update sonic-telemetry to support configuration. + +## 1.1 Requirements + +### 1.1.1 Phase 1 Requirements +* Set and get RPCs must be supported. Customer will use get RPC to retrieve configurations including FRR and VNET route, and use set RPC to apply new configurations. +* SetRequest message must support to incrementally update configuration and fully update configurations. +* Data models can be SONiC Yang models or CONFIG_DB schema. +* Ability to read different DBs - ApplDB, ConfigDB, StateDB, CountersDB etc. +* Ability to write different DBs - ApplDB, ConfigDB. +* Configurations must be verified using YANG models even it is in CONFIG_DB schema. +* Need to configure huge VNET route entries to ApplDB, with high speed. +* Configurations for ConfigDB must be persisted after a device restart. +* Need to support multi-ASIC platform. +* Ability to support bulk set-get operations. +* Must follow gnmi-specification. + * All changes to the state of the target that are included in an individual SetRequest message are considered part of a transaction. + * Within an individual transaction (SetRequest) the order of operations is 'delete', 'replace', 'update'. + * If a single path is in multiple operations in one SetRequest (i.e., within 'update' or 'replace'), then the state of the target MUST reflect the application of all the operations in order, even if they overwrite each other. + * The session between the client and server MUST be encrypted using TLS. + * New connections are mutually authenticated. + +### 1.1.2 Phase 2 Requirements +* Support authentication and authorization with TACACS+ server. +* Upgrade operation will be provided with GNOI. + +## 1.2 Design Overview + +gnmi-server + +We will update sonic-telemetry to support configuration in the same container. + +And there will be a config files for disable/enable telemetry/new-gnmi feature. + +### 1.2.1 Basic Approach + +#### 1.2.1.1 Transaction + +* Rollback + +Generic_config_updater provides rollback mechanism, and we can use it to implement transaction for CONIFG_DB. + +Currently we do not support rollback for ApplDB, therefore VNET route will be an exception for rollback. Client could make decision based on SetResponse and use more SetRequest(s) to achieve rollback behavior. + +* Set + +Since a single SetRequest will be treated as a transaction, gNMI server does not support parallel write operations. We will put the SetRequests in a queue and serve them with a single worker. + +set + +* Get + +Every set RPC will create a checkpoint of running configuration before any modification and remove this checkpoint after all the modifications. + +Get RPC during write period should use checkpoint, and normally Get RPC will directly fetch ConfigDB. + +get + +#### 1.2.1.2 Yang Validation + +For ConfigDB, and input is SONiC Yang models schema, sonic-config-engine and generic_config_updater will run Yang validation. + +For ConfigDB, and input is ConfigDB schema, generic_config_updater will run Yang validation. And sonic-config-engine does not run Yang validation today if input is in config_db schema, and it will run Yang validation in future release. + +For ApplDB, we will create Yang models based on requirement. Today we only need to config VNET routes in ApplDB. We will leverage Yang validation or implement specialized validation logic for optimal performance. + +#### 1.2.1.3 Data Schema + +The ultimate goal is to use SONiC Yang models for configuration, and we also need to support ConfigDB schema and ApplDB schema: + +* We will follow OpenConfig specification to use origin field to support mixed schema. + +* And we use the first element to specify the target database. + +A single request cannot have both SONiC YANG paths and ConfigDB/ApplDB schema paths. + +message-example + +1. Stage 1: SONiC DB Schema + +At stage 1, we will only support SONiC DB schema. + +- If origin is ‘sonic_db’ or NULL, and target is ‘CONFIG_DB’, SetRequest and GetRequest will use CONFIG_DB schema, and sonic_config_engine or generic_config_engine will be invoked. +- If origin is ‘sonic_db’ or NULL, and target is ‘APPL_DB’, and table name is "VNET_ROUTE_TABLE", SetRequest and GetRequest will be used to access VNET route entry, and special_config_updater will be invoked. + +2. Stage 2: SONiC Yang Schema + +At stage 2, we will support SONiC Yang schema. + +* If origin is ‘sonic_yang’ and target is ‘APPL_DB’, request will use SONiC Yang models schema, and special_config_updater will be invoked. +* If origin is ‘sonic_yang’ and target is 'CONFIG_DB' or NULL, request will use SONiC Yang models schema, and sonic_config_engine or generic_config_engine will be invoked. + +set-flow + +get-flow + +Assume running-config to be: + + { + "DEVICE_NEIGHBOR": { + "Ethernet8": { + "name": "Servers1", + "port": "eth0" + }, + "Ethernet96": { + "name": "Servers23", + "port": "eth0" + }, + }, + } + +And then perform the actions below: +* replace port under Ethernet8 with eth1 +* remove Ethernet96 + +The steps would be: +1. Get the running configuration + +With CONFIG_DB schema: + + ++++++++ Sending get request: ++++++++ + path { + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} + } + encoding: JSON_IETF + ++++++++ Recevied get response: ++++++++ + notification { + update { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet8"} + } + val { + json_ietf_val: "{\"name\": \"Servers1\",\"port\": \"eth0\"}" + } + } + update { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet96"} + } + val { + json_ietf_val: "{\"name\": \"Servers23\",\"port\": \"eth0\"}" + } + } + } + +With CONFIG_YANG schema: + + ++++++++ Sending get request: ++++++++ + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} + } + encoding: JSON_IETF + ++++++++ Recevied get response: ++++++++ + notification { + update { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet8"}} + } + val { + json_ietf_val: "{\"name\": \"Servers1\",\"port\": \"eth0\"}" + } + } + update { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet96"}} + } + val { + json_ietf_val: "{\"name\": \"Servers23\",\"port\": \"eth0\"}" + } + } + } + +2. Apply the new configuration + +With CONFIG_DB schema: + + ++++++++ Sending set request: ++++++++ + replace { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet96"} + } + } + replace { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet8"} elem {name: "port"} + } + val { + json_ietf_val: "eth1" + } + } + ++++++++ Recevied set response: ++++++++ + response { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet96"} + } + op: REPLACE + } + response { + path { + origin: "sonic_db" + elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet8"} elem {name: "port"} + } + op: REPLACE + } + +With CONFIG_YANG schema: + + ++++++++ Sending set request: ++++++++ + replace { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet96"}} + } + } + replace { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet8"}} elem {name: "port"} + } + val { + json_ietf_val: "eth1" + } + } + ++++++++ Recevied set response: ++++++++ + response { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet96"}} + } + op: REPLACE + } + response { + path { + origin: "sonic_yang" + elem {name: "CONFIG_DB"} elem {name: "sonic-device_neighbor:sonic-device_neighbor"} elem {name: "sonic-device_neighbor:DEVICE_NEIGHBOR"} elem {name: "DEVICE_NEIGHBOR_LIST" key {key: "name" value: "Ethernet8"}} elem {name: "port"} + } + op: REPLACE + } + +#### 1.2.1.4 Incremental Configurations + +For incremental configurations, SetRequest can use all kinds of operations, for example, 'replace' operations, 'update' operations and 'delete' operations. And generic_config_updater can guarantee the outcome is correct. + +Generic_config_updater is used for incrementally update configurations, and it has two related API: +1. replace, input format is ConfigDB schema. +2. apply-patch, input format is JsonPatch. + +SetRequest syntax is not the same as JsonPatch. For example, 'replace' operation can be used to delete a node and update a node, please refer to gnmi specification. + +We can translate most of the SetRequest operations directly: + +### Table 2: Mapping Operations +| SetRequest Operation | Description | JsonPatch Operation | +| ---- | ---- | ---- | +| Delete | Where a path is contained within the delete field of the SetRequest message, it should be removed from the target's data tree. | Remove | +| Update | If a particular path-value is specified in the client-supplied data, it is replaced with the client-specified value.
    If the path specified does not exist, the target MUST create the data tree element and populate it with the data in the Update message. | Add | +| Replace (delete) | If a particular path-value is NOT specified in the client-supplied data and the path does not have a specified default value in the corresponding schema, it should be deleted. | Remove | +| Replace (update) | If a particular path-value is specified in the client-supplied data, it is replaced with the client-specified value.
    If the path specified does not exist, the target MUST create the data tree element and populate it with the data in the Update message. | Add | + +Below table provides an example to translate from SetRequest to JsonPatch. + +### Table 3: Translate Example +| SetRequest Format | JsonPatch Format | +| ---- | ---- | +| replace {
     path {
      elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet96"}
     }
    }
    replace {
     path {
      elem {name: "CONFIG_DB"} elem {name: "DEVICE_NEIGHBOR"} elem {name: "Ethernet8"} elem {name: "port"}
     }
     val { json_ietf_val: "eth1" }
    } | [
     {
      "op": "remove", "path": "/DEVICE_NEIGHBOR/Ethernet96"},
      { "op": "add", "path": "/DEVICE_NEIGHBOR/Ethernet8/port", "value": "eth1"}
    ] | + +#### 1.2.1.5 Full Configurations + +For full configurations, SetRequest will use one 'delete' operation and one 'update' operation with the root node, and sonic-config-engine is used for fully update configurations. + +SetRequest message will be: + + ++++++++ Sending set request: ++++++++ + delete { + path { origin: "sonic_db" } + } + update { + path { origin: "sonic_db" } + val { + json_ietf_val: "{\"DEVICE_NEIGHBOR/Ethernet8/name\":\"Servers1\", \"DEVICE_NEIGHBOR/Ethernet8/port\":\"eth0\", \"DEVICE_NEIGHBOR/Ethernet96/name\":\"Servers23\", \"DEVICE_NEIGHBOR/Ethernet96/port\":\"eth0\", ...}" + } + } + ++++++++ Recevied set response: ++++++++ + response { + path { origin: "sonic_db" } + op: DELETE + } + response { + path { origin: "sonic_db" } + op: UPDATE + } + +#### 1.2.1.6 Configuration Persistence + +All successful changes for ConfigDB made through the gNMI SET RPC will be saved to /etc/sonic/config_db.json. + +If the target database is not ConfigDB, we can't guarantee persisitence. + +#### 1.2.1.7 Heartbeat and Reprogram + +For full system reboot, client has to reprogram ApplDB. If the gnmi container restarts, client doesn't need to reprogram. + +We propose to use Capabilities RPC as heartbeat to detect reboot, and we will expose reset status. + +After reboot, client should check reset status to decide if needs to reprogram. + +heartbeat + +#### 1.2.1.8 Authentication +sonic-telemetry provides three authentication mechanisms, and we will keep the same mechanism: +* Password: Like HTTP Basic auth, you pass the username and password in the gRPC metadata +* JWT: JSON Web Tokens standard. First you authenticate with username/password and then receive a JWT token. After you send the token in the gRPC metadata. +* User Certificate: Use a valid client certificate with the username embedded in the CN field. The certificate is for authentication, the username is for authorization. + +sonic-restapi uses one authentication mechanism: +* In the authentication of client certificate, after the certificate chain is validated by TLS, it will further check if the common name of the end-entity certificate is in the trusted common name list of the server config. + +#### 1.2.1.9 ACL +The new GNMI server interface will use CONFIG_DB schema and SONiC Yang Models for ACL configuration. + +#### 1.2.1.10 Data Protection + +For ApplDB, gNMI clients can write table directly. We need to specify which table can be changed, which one can not. + +We will create new Yang models for ApplDB, if gNMI set request modifies a table without Yang models, this set request should be rejected. And we can also use "config false" tag, please refer to [link](https://datatracker.ietf.org/doc/html/rfc7950#section-4.2.3). + +#### 1.2.1.11 Docker to Host communication +'config apply-patch' and 'config reload' are designed to run on host, and it's difficult to support them in container: +1. These commands will update redis database and restart container, when they restart gnmi, bgp, syncd and swss, the ongoing gnmi operation will be broken. +2. 'config reload' will stop service at first, run some other operations, and then restart service. If we run this command in container, it will be broken at the stop service step. +3. These commands will execute some host scripts and use systemctl to restart service, it will be dangerous to support these operations in container. +The solution is to add host services for 'config apply-patch' and 'config reload' on host, and gNMI server uses dbus method to invoke these services to update configuration + +##### 1.2.1.11.1 Incremental Configurations + +For incremental configuration, 'config apply-patch' should not restart gNMI, bgp, synd and swss. + +incremental + +##### 1.2.1.11.2 Full Configurations + +For full configuration, there’re 2 possible solutions: +* gNMI server needs to send response at first, and then invoke 'config reload'. + +full-gnmi + +* Use gNMI request and gNOI request together to implement full configuration update. + +full-gnmi-gnoi + +The full configuration request will be overwritten by subsequent full configuration request or incremental configuration request. + +overwritten-config + +#### 1.2.1.12 Backward Compatibility + +SONiC telemetry is using prefix target to identify target database, and we will add a new target to support mixed schema. + + enum Target { + option allow_alias = true; + APPL_DB = 0; + ASIC_DB = 1; + COUNTERS_DB = 2; + LOGLEVEL_DB = 3; + CONFIG_DB = 4; + // PFC_WD_DB shares the the same db number with FLEX_COUNTER_DB + PFC_WD_DB = 5; + FLEX_COUNTER_DB = 5; + STATE_DB = 6; + // For none-DB data + OTHERS = 100; + // For mixed schema + MIXED_SCHEMA = 101; + } + + +### 1.2.2 Container + +All the introduced features will be part of the sonic-telemetry package installed in sonic-telemetry container. + +# 2 Error Handling +supervisord will autorestart gnmi service if it exits after it has successfully started up. + +# 3 Serviceability and Debug +All requests logs are stored in syslog. + +# 4 Unit Tests + +## 4.1 Unit Tests for Capabilities RPC + +| Test Case | Description | +| ---- | ---- | +| 1 | Get capability. | + +## 4.2 Unit Tests for Get RPC + +| Test Case | Description | +| ---- | ---- | +| 1 | Get from CONFIG_DB with SONiC DB schema. | +| 2 | Get from APPL_DB with SONiC DB schema. | +| 3 | Get from CONFIG_DB with SONiC Yang schema. | +| 4 | Get from APPL_DB with SONiC Yang schema. | + +## 4.3 Unit Tests for Set RPC + +| Test Case | Description | +| ---- | ---- | +| 1 | Delete operation with SONiC DB schema to remove table in CONFIG_DB. | +| 2 | Delete operation with SONiC DB schema to remove table in APPL_DB. | +| 3 | Update operation with SONiC DB schema to create table in CONFIG_DB. | +| 4 | Update operation with SONiC DB schema to create table in APPL_DB. | +| 5 | Update operation with SONiC DB schema to update table in CONFIG_DB. | +| 6 | Update operation with SONiC DB schema to update table in APPL_DB. | +| 7 | Replace operation with SONiC DB schema to remove table in CONFIG_DB. | +| 8 | Replace operation with SONiC DB schema to remove table in APPL_DB. | +| 9 | Replace operation with SONiC DB schema to create table in CONFIG_DB. | +| 10 | Replace operation with SONiC DB schema to create table in APPL_DB. | +| 11 | Replace operation with SONiC DB schema to update table in CONFIG_DB. | +| 12 | Replace operation with SONiC DB schema to update table in APPL_DB. | +| 13 | Verify invalid path with SONiC DB schema in CONFIG_DB. | +| 14 | Verify invalid path with SONiC DB schema in APPL_DB. | +| 15 | Verify full configuration update with SONIC DB schema. | +| 16 | Delete operation with SONiC Yang schema to remove table in CONFIG_DB. | +| 17 | Delete operation with SONiC Yang schema to remove table in APPL_DB. | +| 18 | Update operation with SONiC Yang schema to create table in CONFIG_DB. | +| 19 | Update operation with SONiC Yang schema to create table in APPL_DB. | +| 20 | Update operation with SONiC Yang schema to update table in CONFIG_DB. | +| 21 | Update operation with SONiC Yang schema to update table in APPL_DB. | +| 22 | Replace operation with SONiC Yang schema to remove table in CONFIG_DB. | +| 23 | Replace operation with SONiC Yang schema to remove table in APPL_DB. | +| 24 | Replace operation with SONiC Yang schema to create table in CONFIG_DB. | +| 25 | Replace operation with SONiC Yang schema to create table in APPL_DB. | +| 26 | Replace operation with SONiC Yang schema to update table in CONFIG_DB. | +| 27 | Replace operation with SONiC Yang schema to update table in APPL_DB. | +| 28 | Verify invalid path with SONiC Yang schema in CONFIG_DB. | +| 29 | Verify invalid path with SONiC Yang schema in APPL_DB. | +| 30 | Verify full configuration update with SONIC Yang schema. | + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/mgmt/gnmi/images/cli.svg b/doc/mgmt/gnmi/images/cli.svg new file mode 100644 index 0000000000..e017036ef4 --- /dev/null +++ b/doc/mgmt/gnmi/images/cli.svg @@ -0,0 +1,506 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + Process + + + + + + + + + + + + + + + + + + + Sheet.31 + SONiC utilities + + + + SONiC utilities + + Process.35 + User + + + + + + + + + + + + + + + + + + + User + + Process.32 + show + + + + + + + + + + + + + + + + + + + show + + Process.34 + generic_config_updater + + + + + + + + + + + + + + + + + + + generic_config_updater + + 1-D single + + + + + + + Dynamic connector + + + + Sheet.73 + show runningconfig all + + + + show runningconfig all + + Sheet.74 + config apply-patch + + + + config apply-patch + + Document + Sonic Yang models + + + + + + + + + + + + + + + + + + + Sonic Yang models + + Sheet.86 + + Side brace + + + + + + + + + + + + + + + + Sheet.85 + + Sheet.78 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector.77 + + + + + Sheet.79 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector.77 + + + + + Sheet.82 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector.77 + + + + + + + Dynamic connector.87 + + + + Dynamic connector.89 + + + + Process.90 + config + + + + + + + + + + + + + + + + + + + config + + 1-D single.91 + + + + + + + Sheet.92 + config reload + + + + config reload + + Dynamic connector.93 + + + + Dynamic connector.94 + + + + 1-D single.95 + + + + + + + diff --git a/doc/mgmt/gnmi/images/data_flow.svg b/doc/mgmt/gnmi/images/data_flow.svg new file mode 100644 index 0000000000..bb2d59b9cc --- /dev/null +++ b/doc/mgmt/gnmi/images/data_flow.svg @@ -0,0 +1,1442 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CFF Container + + Sheet.21 + + + + + + + + + + + + + + Sheet.22 + SetRequest Flow chart + + + + + + + + + + + + + + + + + + + + + + SetRequest Flow chart + + + Swimlane List + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Swimlane (vertical) + + Sheet.18 + + + + + + + + + + + + + + Sheet.19 + gNMI server + + + + + + + + + + + + + + + + + + + + + + gNMI server + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Swimlane (vertical).28 + + Sheet.29 + + + + + + + + + + + + + + Sheet.30 + Sonic_config_engine + + + + + + + + + + + + + + + + + + + + + + Sonic_config_engine + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Swimlane (vertical).31 + + Sheet.32 + + + + + + + + + + + + + + Sheet.33 + Generic_config_updater + + + + + + + + + + + + + + + + + + + + + + Generic_config_updater + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Swimlane (vertical).34 + + Sheet.35 + + + + + + + + + + + + + + Sheet.36 + Special_config_updater + + + + + + + + + + + + + + + + + + + + + + Special_config_updater + + + Phase List + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Separator (vertical) + + Sheet.26 + + + + + + + + Sheet.27 + + + + + + + + + + + + + + + + + + + + Start/End + Start + + + + + + + + + + + + + + + + + + + + + + + + Start + + Dynamic connector + + + + + + + Process.234 + Iterate request paths + + + + + + + + + + + + + + + + + + + + + + + + Iterate request paths + + Dynamic connector.235 + + + + + + + Decision.236 + Different origin? + + + + + + + + + + + + + + + + + + + + + + + + Different origin? + + Dynamic connector.237 + No + + + + + + + + No + + Start/End.254 + Invalid request + + + + + + + + + + + + + + + + + + + + + + + + Invalid request + + Dynamic connector.255 + Yes + + + + + + + + Yes + + Decision.256 + Origin is sonic_db + + + + + + + + + + + + + + + + + + + + + + + + Origin is sonic_db + + Dynamic connector.257 + No + + + + + + + + No + + Process.258 + Run Yang validation and write to ConfigDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to ConfigDB + + Dynamic connector.259 + Yes + + + + + + + + Yes + + Decision.260 + Incremental configurations? + + + + + + + + + + + + + + + + + + + + + + + + Incremental configurations? + + Dynamic connector.261 + Yes + + + + + + + + Yes + + Process.262 + Run Yang validation and write to ConfigDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to ConfigDB + + Dynamic connector.263 + No + + + + + + + + No + + Process.266 + Run Yang validation and write to APPlDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to APPlDB + + Dynamic connector.267 + No + + + + + + + + No + + Decision.268 + Origin is sonic_yang + + + + + + + + + + + + + + + + + + + + + + + + Origin is sonic_yang + + Dynamic connector.269 + No + + + + + + + + No + + Decision.270 + target is CONFIG_DB? + + + + + + + + + + + + + + + + + + + + + + + + target is CONFIG_DB? + + Dynamic connector.271 + Yes + + + + + + + + Yes + + Decision.272 + Incremental configurations? + + + + + + + + + + + + + + + + + + + + + + + + Incremental configurations? + + Dynamic connector.273 + Yes + + + + + + + + Yes + + Process.274 + Run Yang validation and write to ConfigDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to ConfigDB + + Dynamic connector.275 + Yes + + + + + + + + Yes + + Process.276 + Run Yang validation and write to ConfigDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to ConfigDB + + Dynamic connector.277 + No + + + + + + + + No + + Dynamic connector.279 + No + + + + + + + + No + + Process.280 + Run Yang validation and write to APPlDB + + + + + + + + + + + + + + + + + + + + + + + + Run Yang validation and write to APPlDB + + Decision.1000 + target is CONFIG_DB + + + + + + + + + + + + + + + + + + + + + + + + target is CONFIG_DB + + Dynamic connector.1001 + Yes + + + + + + + + Yes + + Start/End.1002 + Invalid request + + + + + + + + + + + + + + + + + + + + + + + + Invalid request + + diff --git a/doc/mgmt/gnmi/images/data_flow_get.svg b/doc/mgmt/gnmi/images/data_flow_get.svg new file mode 100644 index 0000000000..26fcf7a86b --- /dev/null +++ b/doc/mgmt/gnmi/images/data_flow_get.svg @@ -0,0 +1,659 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + Start/End + Start + + + + + + + + + + + + + + + + + + + + + + + Start + + Dynamic connector + + + + + + + Process.234 + Iterate request paths + + + + + + + + + + + + + + + + + + + + + + + Iterate request paths + + Dynamic connector.235 + + + + + + + Decision.236 + Different origin? + + + + + + + + + + + + + + + + + + + + + + + Different origin? + + Dynamic connector.237 + No + + + + + + + + No + + Start/End.254 + Invalid request + + + + + + + + + + + + + + + + + + + + + + + Invalid request + + Dynamic connector.255 + Yes + + + + + + + + Yes + + Decision.256 + Origin is sonic_db + + + + + + + + + + + + + + + + + + + + + + + Origin is sonic_db + + Dynamic connector.257 + No + + + + + + + + No + + Decision.268 + Origin is sonic_yang + + + + + + + + + + + + + + + + + + + + + + + Origin is sonic_yang + + Dynamic connector.269 + No + + + + + + + + No + + Decision.270 + target is CONFIG_DB? + + + + + + + + + + + + + + + + + + + + + + + target is CONFIG_DB? + + Dynamic connector.271 + Yes + + + + + + + + Yes + + Dynamic connector.273 + Yes + + + + + + + + Yes + + Dynamic connector.279 + No + + + + + + + + No + + Start/End.288 + Invalid request + + + + + + + + + + + + + + + + + + + + + + + Invalid request + + Process.44 + Read from ConfigDB + + + + + + + + + + + + + + + + + + + + + + + Read from ConfigDB + + Dynamic connector.45 + Yes + + + + + + + + Yes + + Process.46 + Read from ApplDB + + + + + + + + + + + + + + + + + + + + + + + Read from ApplDB + + Dynamic connector.47 + No + + + + + + + + No + + Process.48 + Read from ConfigDB and translate to Yang models + + + + + + + + + + + + + + + + + + + + + + + Read from ConfigDB and translate to Yang models + + Process.49 + Read from ApplDB and translate to Yang models + + + + + + + + + + + + + + + + + + + + + + + Read from ApplDB and translate to Yang models + + Decision.1000 + target is CONFIG_DB? + + + + + + + + + + + + + + + + + + + + + + + target is CONFIG_DB? + + Dynamic connector.1001 + Yes + + + + + + + + Yes + + diff --git a/doc/mgmt/gnmi/images/full_rpc.svg b/doc/mgmt/gnmi/images/full_rpc.svg new file mode 100644 index 0000000000..db99731921 --- /dev/null +++ b/doc/mgmt/gnmi/images/full_rpc.svg @@ -0,0 +1,438 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI client + + + + + + + + Object lifeline.6 + GNMI server + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI server + + + Activation + + + + + + + Message + SetRequest + + + + + + + + + + + SetRequest + + Return Message + SetResponse + + + + + + + + + + + SetResponse + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + + + + + + Object lifeline.30 + Host service + + Sheet.31 + + + + Sheet.32 + + + + Sheet.33 + + + Sheet.34 + + + + + + + Host service + + + + + + + + + Script.35 + + Sheet.36 + + + + Sheet.37 + + + + Sheet.38 + + + + Sheet.39 + + + + Sheet.40 + + + + Sheet.41 + + + + Sheet.42 + + + + Sheet.43 + + + + Sheet.44 + + + + + Activation.45 + + + + + + + Message.46 + + + + + + + + + + Sheet.49 + Config reload + + + + Config reload + + Self Message.50 + + + + + + + + + + Sheet.51 + Config load or run yang validation + + + + Config load or run yang validation + + Self Message.52 + + + + + + + + + + Activation.55 + + + + + + + Self Message.56 + + + + + + + + + + Sheet.57 + Config reload + + + + Config reload + + Sheet.53 + + Sheet.54 + + + + + diff --git a/doc/mgmt/gnmi/images/full_rpc_gnoi.svg b/doc/mgmt/gnmi/images/full_rpc_gnoi.svg new file mode 100644 index 0000000000..568efa538a --- /dev/null +++ b/doc/mgmt/gnmi/images/full_rpc_gnoi.svg @@ -0,0 +1,472 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI/GNOI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI/GNOI client + + + + + + + + Object lifeline.6 + GNMI/GNOI server + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI/GNOI server + + + Activation + + + + + + + Message + GNMI SetRequest + + + + + + + + + + + GNMI SetRequest + + Return Message + GNMI SetResponse + + + + + + + + + + + GNMI SetResponse + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + + + + + + Object lifeline.30 + Host service + + Sheet.31 + + + + Sheet.32 + + + + Sheet.33 + + + Sheet.34 + + + + + + + Host service + + + + + + + + + Script.35 + + Sheet.36 + + + + Sheet.37 + + + + Sheet.38 + + + + Sheet.39 + + + + Sheet.40 + + + + Sheet.41 + + + + Sheet.42 + + + + Sheet.43 + + + + Sheet.44 + + + + + Activation.45 + + + + + + + Message.46 + + + + + + + + + + Sheet.49 + Config reload with previous configuration + + + + Config reload with previous configuration + + Self Message.50 + + + + + + + + + + Sheet.51 + Run yang validation and store the configuration + + + + Run yang validation and store the configuration + + Self Message.52 + + + + + + + + + + Message.53 + GNOI RebootRequest + + + + + + + + + + + GNOI RebootRequest + + Return Message.54 + GNOI RebootResponse + + + + + + + + + + + GNOI RebootResponse + + Message.55 + GNOI RebootStatusRequest + + + + + + + + + + + GNOI RebootStatusRequest + + Return Message.56 + GNOI RebootStatusResponse + + + + + + + + + + + GNOI RebootStatusResponse + + Activation.57 + + + + + + + diff --git a/doc/mgmt/gnmi/images/get_lock.svg b/doc/mgmt/gnmi/images/get_lock.svg new file mode 100644 index 0000000000..1bf062a598 --- /dev/null +++ b/doc/mgmt/gnmi/images/get_lock.svg @@ -0,0 +1,808 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI client + + + + + + + + Object lifeline.6 + GNMI write thread + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI write thread + + + Activation + + + + + + + Message + SetRequest + + + + + + + + + + + SetRequest + + Return Message + SetResponse + + + + + + + + + + + SetResponse + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + + + + + + Object lifeline.30 + GNMI read thread + + Sheet.31 + + + + Sheet.32 + + + + Sheet.33 + + + Sheet.34 + + + + + + + GNMI read thread + + + + + + + + + Script.35 + + Sheet.36 + + + + Sheet.37 + + + + Sheet.38 + + + + Sheet.39 + + + + Sheet.40 + + + + Sheet.41 + + + + Sheet.42 + + + + Sheet.43 + + + + Sheet.44 + + + + + + + + + + Object lifeline.51 + checkpoint + + Sheet.52 + + + + Sheet.53 + + + + Sheet.54 + + + Sheet.55 + + + + + + + checkpoint + + + + + + + + Object lifeline.76 + Database + + Sheet.77 + + + + Sheet.78 + + + + Sheet.79 + + + Sheet.80 + + + + + + + Database + + + + + + + + + Database + + Sheet.98 + + Sheet.99 + + + + Sheet.100 + + + + Sheet.101 + + + + Sheet.102 + + + + + + Message.162 + Write Database + + + + + + + + + + + Write Database + + Activation.165 + + + + + + + Return Message.166 + + + + + + + + + + + + + + + + Document + + Sheet.174 + + + + Sheet.175 + + + + Sheet.176 + + + + Sheet.177 + + + + Sheet.178 + + + + Sheet.179 + + + + + Message.180 + Remove checkpoint + + + + + + + + + + + Remove checkpoint + + Activation.183 + + + + + + + Activation.185 + + + + + + + Message.186 + GetRequest + + + + + + + + + + + GetRequest + + Activation.187 + + + + + + + Message.188 + Read from database + + + + + + + + + + + Read from database + + Return Message.189 + + + + + + + + + + Return Message.190 + + + + + + + + + + Activation.191 + + + + + + + Message.192 + SetRequest + + + + + + + + + + + SetRequest + + Activation.193 + + + + + + + Message.194 + Write Database + + + + + + + + + + + Write Database + + Return Message.195 + + + + + + + + + + Activation.201 + + + + + + + Message.202 + + + + + + + + + + Sheet.203 + GetRequest + + + + GetRequest + + Sheet.204 + GetResponse + + + + GetResponse + + Activation.206 + + + + + + + Message.207 + Read from checkpoint + + + + + + + + + + + Read from checkpoint + + Return Message.208 + + + + + + + + + + Return Message.209 + GetResponse + + + + + + + + + + + GetResponse + + Return Message.210 + SetResponse + + + + + + + + + + + SetResponse + + Message.211 + Create checkpoint + + + + + + + + + + + Create checkpoint + + Activation.212 + + + + + + + Message.213 + Create checkpoint + + + + + + + + + + + Create checkpoint + + Activation.214 + + + + + + + Message.215 + Remove checkpoint + + + + + + + + + + + Remove checkpoint + + Activation.216 + + + + + + + diff --git a/doc/mgmt/gnmi/images/gnmi.svg b/doc/mgmt/gnmi/images/gnmi.svg new file mode 100644 index 0000000000..9a2f5aab90 --- /dev/null +++ b/doc/mgmt/gnmi/images/gnmi.svg @@ -0,0 +1,1089 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + Process + + + + + + + + + + + + + + + + + + + Sheet.31 + SONiC Gnmi Server + + + + SONiC Gnmi Server + + Process.35 + GNMI client + + + + + + + + + + + + + + + + + + + GNMI client + + Process.34 + generic_config_updater + + + + + + + + + + + + + + + + + + + generic_config_updater + + Side brace + + + + + + + + + + + + + + + + Sheet.73 + Get + + + + Get + + Process.75 + GNMI server + + + + + + + + + + + + + + + + + + + GNMI server + + Document + SONiC Yang Models + + + + + + + + + + + + + + + + + + + SONiC Yang Models + + 1-D single.81 + + + + + + + Sheet.82 + Set + + + + Set + + Sheet.84 + + + + Process.91 + Sonic-config-engine + + + + + + + + + + + + + + + + + + + Sonic-config-engine + + Dynamic connector.92 + + + + Dynamic connector.97 + + + + Sheet.100 + + Datastore + ApplDB + + + + + + + + + + + + + + + + + + + + + + ApplDB + + Dynamic connector.41 + + + + + Sheet.101 + + Datastore + StateDB + + + + + + + + + + + + + + + + + + + + + + StateDB + + Dynamic connector.41 + + + + + Sheet.104 + + Datastore + CountersDB + + + + + + + + + + + + + + + + + + + + + + CountersDB + + Dynamic connector.41 + + + + + Sheet.110 + + Datastore + ConfigDB + + + + + + + + + + + + + + + + + + + + + + ConfigDB + + Dynamic connector.41 + + + + + Sheet.114 + + Datastore + ... + + + + + + + + + + + + + + + + + + + + + + ... + + Dynamic connector.41 + + + + + Cloud.34 + + + + + + + Process.139 + special_config_updater + + + + + + + + + + + + + + + + + + + special_config_updater + + 1-D single.140 + + + + + + + Dynamic connector + + + + Decision.1000 + Target Database? + + + + + + + + + + + + + + + + + + + Target Database? + + Dynamic connector.1001 + ApplDB + + + + + ApplDB + + Decision.1002 + Incremental or full config? + + + + + + + + + + + + + + + + + + + Incremental or full config? + + Dynamic connector.1003 + + + + Sheet.1004 + ConfigDB + + + + ConfigDB + + Dynamic connector.1005 + + + + Dynamic connector.1006 + + + + Sheet.1007 + Incremental + + + + Incremental + + Sheet.1008 + Full + + + + Full + + Process.1009 + System Telemetry Data collectors + + + + + + + + + + + + + + + + + + + System Telemetry Data collectors + + 1-D single.1010 + + + + + + + Sheet.1011 + Get + + + + Get + + 1-D single.1012 + + + + + + + Sheet.1013 + Subscribe + + + + Subscribe + + Process.1014 + GNMI diaout client + + + + + + + + + + + + + + + + + + + GNMI diaout client + + 1-D single.1015 + + + + + + + Sheet.1016 + Publish + + + + Publish + + Dynamic connector.1017 + + + + Cloud.1018 + + + + + + + Decision.1019 + Target is DB? + + + + + + + + + + + + + + + + + + + Target is DB? + + Process.1020 + DB client + + + + + + + + + + + + + + + + + + + DB client + + Process.1021 + Non-DB client + + + + + + + + + + + + + + + + + + + Non-DB client + + Dynamic connector.1022 + Yes + + + + + Yes + + Dynamic connector.1023 + No + + + + + No + + Dynamic connector.1024 + + + + Dynamic connector.1025 + + + + Dynamic connector.1026 + + + + Document.1027 + Platform data + + + + + + + + + + + + + + + + + + + Platform data + + Document.1028 + Proc data + + + + + + + + + + + + + + + + + + + Proc data + + Document.1029 + ASIC data + + + + + + + + + + + + + + + + + + + ASIC data + + Dynamic connector.1030 + + + + Dynamic connector.1031 + + + + Dynamic connector.1032 + + + + diff --git a/doc/mgmt/gnmi/images/heartbeat.svg b/doc/mgmt/gnmi/images/heartbeat.svg new file mode 100644 index 0000000000..aee2106107 --- /dev/null +++ b/doc/mgmt/gnmi/images/heartbeat.svg @@ -0,0 +1,608 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI client + + + + + + + + Object lifeline.6 + GNMI server + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI server + + + Activation + + + + + + + Message + SetRequest + + + + + + + + + + + SetRequest + + Return Message + SetResponse + + + + + + + + + + + SetResponse + + Self Message + + + + + + + + + + Sheet.15 + Full system reload or gnmi container reload + + + + Full system reload or gnmi container reload + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + Sheet.36 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Activation.31 + + + + + + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + + Sheet.41 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Activation.31 + + + + + + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + + Sheet.45 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Activation.31 + + + + + + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + + Activation.31 + + + + + + + Sheet.62 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + Sheet.60 + + Sheet.61 + + + + + + Sheet.63 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + Sheet.66 + + Sheet.67 + + + + + + Sheet.68 + + Message.30 + CapabilitiesRequest + + + + + + + + + + + CapabilitiesRequest + + Return Message.32 + CapabilitiesResponse + + + + + + + + + + + CapabilitiesResponse + + Sheet.71 + + Sheet.72 + + + + + + Activation.73 + + + + + + + Activation.74 + + + + + + + Message.75 + GetRequest + + + + + + + + + + + GetRequest + + Return Message.76 + GetResponse + + + + + + + + + + + GetResponse + + Self Message.77 + + + + + + + + + + Sheet.78 + Compare ApplDB Configuration + + + + Compare ApplDB Configuration + + diff --git a/doc/mgmt/gnmi/images/incremental_rpc.svg b/doc/mgmt/gnmi/images/incremental_rpc.svg new file mode 100644 index 0000000000..0de42da0fd --- /dev/null +++ b/doc/mgmt/gnmi/images/incremental_rpc.svg @@ -0,0 +1,397 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI client + + + + + + + + Object lifeline.6 + GNMI server + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI server + + + Activation + + + + + + + Message + SetRequest + + + + + + + + + + + SetRequest + + Return Message + SetResponse + + + + + + + + + + + SetResponse + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + + + + + + Object lifeline.30 + Host service + + Sheet.31 + + + + Sheet.32 + + + + Sheet.33 + + + Sheet.34 + + + + + + + Host service + + + + + + + + + Script.35 + + Sheet.36 + + + + Sheet.37 + + + + Sheet.38 + + + + Sheet.39 + + + + Sheet.40 + + + + Sheet.41 + + + + Sheet.42 + + + + Sheet.43 + + + + Sheet.44 + + + + + Activation.45 + + + + + + + Message.46 + + + + + + + + + + Return Message.47 + + + + + + + + + + Sheet.49 + Config apply-patch + + + + Config apply-patch + + Self Message.50 + + + + + + + + + + diff --git a/doc/mgmt/gnmi/images/message_example.svg b/doc/mgmt/gnmi/images/message_example.svg new file mode 100644 index 0000000000..36ad96e9c8 --- /dev/null +++ b/doc/mgmt/gnmi/images/message_example.svg @@ -0,0 +1,1686 @@ + + + + + + + + + + + + + + Page-1 + + + + Sheet.1 + + + + + + + + + + + + + + + + + + + + + + + + + SetRequest Message + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + delete { + + + + + + + + + + + + + + + + + + path { + + + + + + + + + + + + + + + + + + origin: " + + + + + + sonic_db + + + + + + " + + + + + + + + + + + + + + + + + + elem {name: “ + + + + + + CONFIG_DB + + + + + + â€} + + + + + + elem {name: + + + + + + “ + + + + + + DEVICE_NEIGHBOR + + + + + + †+ + + + + + } elem {name: + + + + + + “ + + + + + + Ethernet95 + + + + + + †+ + + + + + } + + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + } + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + replace { + + + + + + + + + + + + + + + + + + path { + + + + + + + + + + + + + + + + + + origin: " + + + + + + sonic + + + + + + _db" + + + + + + + + + + + + + + + + + + elem {name: “ + + + + + + CONFIG_DB + + + + + + â€} + + + + + + elem {name: + + + + + + “ + + + + + + DEVICE_NEIGHBOR + + + + + + †+ + + + + + } + + + + + + elem {name: + + + + + + “ + + + + + + Ethernet96 + + + + + + †+ + + + + + } + + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + } + + + + + + + + + + + + replace { + + + + + + + + + + + + + + + + + + path { + + + + + + + + + + + + + + + + + + origin: + + + + + + “sonic + + + + + + _db" + + + + + + + + + + + + + + + + + + elem {name: “ + + + + + + CONFIG_DB + + + + + + â€} + + + + + + elem {name: + + + + + + “ + + + + + + DEVICE_NEIGHBOR + + + + + + †+ + + + + + } + + + + + + elem {name: + + + + + + “ + + + + + + Ethernet8 + + + + + + †+ + + + + + } elem {name: + + + + + + “ + + + + + + port + + + + + + †+ + + + + + } + + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + + + + + + + val { + + + + + + + + + + + + + + + + + + json_ietf_val: + + + + + + “e + + + + + + th1 + + + + + + †+ + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + } + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + update + + + + + + + + + + + + { + + + + + + + + + + + + + + + + + + path { + + + + + + + + + + + + + + + + + + origin: " + + + + + + sonic_db + + + + + + " + + + + + + + + + + + + + + + + + + elem {name: “ + + + + + + CONFIG_DB + + + + + + â€} + + + + + + elem {name: + + + + + + “ + + + + + + DEVICE_NEIGHBOR + + + + + + †+ + + + + + } + + + + + + + + + + + + elem {name: + + + + + + “ + + + + + + Ethernet + + + + + + 9 + + + + + + †+ + + + + + } elem {name: + + + + + + “ + + + + + + port + + + + + + †+ + + + + + } + + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + + + + + + + val { + + + + + + + + + + + + + + + + + + json_ietf_val: + + + + + + “ + + + + + + eth + + + + + + 2 + + + + + + †+ + + + + + + + + + + + + + + + + + } + + + + + + + + + + + + } + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/mgmt/gnmi/images/mixed requests.svg b/doc/mgmt/gnmi/images/mixed requests.svg new file mode 100644 index 0000000000..75336ca8f0 --- /dev/null +++ b/doc/mgmt/gnmi/images/mixed requests.svg @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + Process.1000 + GNMI Set Request Full Configuration + + + + + + + + + + + + + + + + + + + GNMI Set RequestFull Configuration + + Process.1001 + GNMI Set Request Full Configuration/ Incremental Configuration + + + + + + + + + + + + + + + + + + + GNMI Set RequestFull Configuration/Incremental Configuration + + Process.1002 + GNOI Reboot Request + + + + + + + + + + + + + + + + + + + GNOI Reboot Request + + Dynamic connector.1003 + + + + Dynamic connector.1004 + + + + Sheet.1005 + + Sheet.1006 + + + + + diff --git a/doc/mgmt/gnmi/images/restapi.svg b/doc/mgmt/gnmi/images/restapi.svg new file mode 100644 index 0000000000..ed8cecd1a0 --- /dev/null +++ b/doc/mgmt/gnmi/images/restapi.svg @@ -0,0 +1,373 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + Process + + + + + + + + + + + + + + + + + + + Sheet.31 + SONiC restapi + + + + SONiC restapi + + Process.35 + Http client + + + + + + + + + + + + + + + + + + + Http client + + Process.34 + Http server + + + + + + + + + + + + + + + + + + + Http server + + Side brace + + + + + + + + + + + + + + + + Sheet.48 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector + + + + + Sheet.49 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector + + + + + Sheet.59 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector + + + + + Sheet.62 + + Datastore + SONiC Redis DB + + + + + + + + + + + + + + + + + + + + + + SONiC Redis DB + + Dynamic connector + + + + + 1-D double.22 + + + + + + + Dynamic connector.72 + + + + Sheet.74 + post patch get delete + + + + postpatchgetdelete + + diff --git a/doc/mgmt/gnmi/images/set_lock.svg b/doc/mgmt/gnmi/images/set_lock.svg new file mode 100644 index 0000000000..862d507d4a --- /dev/null +++ b/doc/mgmt/gnmi/images/set_lock.svg @@ -0,0 +1,744 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Page-1 + + + + + + + + + + Object lifeline + GNMI client + + Sheet.2 + + + + Sheet.3 + + + + Sheet.4 + + + Sheet.5 + + + + + + + GNMI client + + + + + + + + Object lifeline.6 + GNMI Server + + Sheet.7 + + + + Sheet.8 + + + + Sheet.9 + + + Sheet.10 + + + + + + + GNMI Server + + + Activation + + + + + + + Message + SetRequest 1 + + + + + + + + + + + SetRequest 1 + + + + + + + + User + + Sheet.17 + + Sheet.18 + + + + Sheet.19 + + + + + + + + + + + + Script + + Sheet.21 + + + + Sheet.22 + + + + Sheet.23 + + + + Sheet.24 + + + + Sheet.25 + + + + Sheet.26 + + + + Sheet.27 + + + + Sheet.28 + + + + Sheet.29 + + + + + + + + + + Object lifeline.76 + Database + + Sheet.77 + + + + Sheet.78 + + + + Sheet.79 + + + Sheet.80 + + + + + + + Database + + + + + + + + + Database + + Sheet.98 + + Sheet.99 + + + + Sheet.100 + + + + Sheet.101 + + + + Sheet.102 + + + + + + + + + + + Object lifeline.169 + GNMI Write Thread + + Sheet.170 + + + + Sheet.171 + + + + Sheet.172 + + + Sheet.173 + + + + + + + GNMI Write Thread + + + + + + + + + Script.174 + + Sheet.175 + + + + Sheet.176 + + + + Sheet.177 + + + + Sheet.178 + + + + Sheet.179 + + + + Sheet.180 + + + + Sheet.181 + + + + Sheet.182 + + + + Sheet.183 + + + + + Message.184 + Enqueue + + + + + + + + + + + Enqueue + + Activation.195 + + + + + + + Message.196 + SetRequest 2 + + + + + + + + + + + SetRequest 2 + + Message.197 + Enqueue + + + + + + + + + + + Enqueue + + Activation.198 + + + + + + + Message.199 + SetRequest 3 + + + + + + + + + + + SetRequest 3 + + Message.200 + Enqueue + + + + + + + + + + + Enqueue + + Activation.147 + + + + + + + Message.192 + Write database + + + + + + + + + + + Write database + + Return Message.202 + SetResponse 1 + + + + + + + + + + + SetResponse 1 + + + + + + + Object lifeline.225 + GNMI Write Qeue + + Sheet.226 + + + + Sheet.227 + + + + Sheet.228 + + + Sheet.229 + + + + + + + GNMI Write Qeue + + + + + + + + + Script.230 + + Sheet.231 + + + + Sheet.232 + + + + Sheet.233 + + + + Sheet.234 + + + + Sheet.235 + + + + Sheet.236 + + + + Sheet.237 + + + + Sheet.238 + + + + Sheet.239 + + + + + Message.240 + Deque + + + + + + + + + + + Deque + + Return Message.241 + + + + + + + + + + Activation.242 + + + + + + + Message.243 + Deque + + + + + + + + + + + Deque + + Return Message.244 + + + + + + + + + + Message.245 + Write database + + + + + + + + + + + Write database + + Return Message.246 + SetResponse 2 + + + + + + + + + + + SetResponse 2 + + Activation.247 + + + + + + + Message.248 + Deque + + + + + + + + + + + Deque + + Return Message.249 + + + + + + + + + + Message.250 + Write database + + + + + + + + + + + Write database + + Return Message.251 + SetResponse 3 + + + + + + + + + + + SetResponse 3 + + diff --git a/doc/mgmt/gnmi/images/telemetry.png b/doc/mgmt/gnmi/images/telemetry.png new file mode 100644 index 0000000000000000000000000000000000000000..8148cf72e9ffaad2b96e7a7f45ad7e4caa64df9e GIT binary patch literal 101081 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≤a?r$ zikwYMm~>d>wth26akt|zpX60<3H!i@?mN@({@J2c? zc;z37NeZFg{YPGI`#lJfmjaWi9$`PY;I-LuT0-1!GMff>gCo`CCAZwR@rww;5wP)* zSl?J&f1mJ8O4!&xlmL8#+W8b%Zkd%Z{_2mZ)W-3PyKtyAI_6dhMr?}8jO4#O;`SAU z>I$P>sTsT4 zW9DECL?&Do>XjuTEzXr0ykc#fu|+tkVK5Kt2{~N(9-#9yhUh?8kjbwu6}|eSz!FyJ zBZF@z3>w^eR82$Vz8pv7k(>PnfS&C_RI++TTzZ z+mOfsa|=6pbFV!x(4TcQ?zI!%%b!#EKK+GLzbEMtH6O>_J8l9WLBNL8;J{9o&2m<| z4(vEAqi2^7RWb*QZqq4;yT{V20j|uRZ=$gFE>5{M5`|nHcx`7V__))@=w5o}+`;@V z0fyQfGR<1>>};F8V8{~^wTKQfxZ7T08Tob%_Cu`MIKRhk{=C?J#cDS@*n$2C$eq

    Muv0V5b;V9d0n&XfLt&| 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 z zYW?CJSJOp}A5&5ZQ`%E@H2h~rn~`scGD1Moiy=p~BFMZ55W!_}g_Ol_}C6CoVXY_ABD|e)s_R zOt$C+!D)9xqi0z=T{{QqP|6&5FHbq$za}b00;s-;l9A3Q!5Mbp?7Vb@#XN{c0F$9jK()CnkMV}mEF z8)?I<&K|6{mBR;7UWOfw;r=+k9UzIXeWT}F*N#FYn)>_ zq?l$_X$&15cPU^=OUVM`UXQtd4iW*L0E&#u`YK_4ZNr(Tvx*b=w5$bc7-w zg;L|FAJSH>A;0pB^*E_)#OY(`pg`2A{`U4#T`^}Zb&+KS?re+N`HaT!oLqMaoa71g z3A{3&^-gr~va&S$Fan?PvO?ku7>WOaSV z`wMSmYspxWXVEp6bynUlZsh7R)De5CA4R=5!EE(b^wxd{=2#SftesB!up0PV_i1~R z&48y`FKckzF{(@e)x0&RJJ2&kE*;_jL`WuSg)Q)on|!MAEpCy0^m($<(N?}5QZvCs zlQxCO7Y)yyZ38pU6UQnJ8W2#8AfHCFo?eo|vabO>3a!9B8YaBW$+MElP!VP(N$HmyFkhs3R)?k-Jo?MwW zp0SLp#}b*_*47#oW>M>oXWKQw=%RyCm_DEAXeAD2kP?1aniTdT59R57L>1eoIld7r zd#A{RjfbsF@wM2v8J!xu+4QSjE^;{8V~39w#og_vk0rY6PFCENPV^b@Ar@aRzgyEg zjvb{gBrm8|SZY_4D;2LhTkZyUE+)_8oN%g0O5N@(_aPe!>DF%?5TfIhCfca%M8y=y zesDXw*hcVDp*}%nh>jAEF#toWO-CcT5%K!^<#JqrL=(t)L&=RLx;g$ibl>;k{dHGG z$)TDRE>*WPxF?C2lGOr#@J1koAS2=Q$09*a^I*1JpXW>7eT5qt zcwkF);Xp)8t4**%cDs1f>DO?2$xb=fD%1uPs5z5*a}q1^OFPxB3r681-GpkB@YN{Q z?-l+|2DA7=M}zE}`tP$P6!$egsGb0L78+_>NyMr}QI(5xdv)$X0?trK*n|-!TkUKq z_W(MMDI6O5lH(%6DPnmnxgCuPk>+&SVdU;g6s$N@jzH1o(Ny{f^3v!~VlD+rUSBc= zRZlU${mj_3;pNoJp4_nM;GPhRm5KGy=n&imgcTf-?`r+o2Wc2p>%2+N<>^(7@R=~C z0@fA2(%;;^)-<0QbtMI&7Ws@XQETluBM6{aq#J|I$D-uBJ7A5498g1wvnLKvj`<%u zwER5H^ea{(nH~wU?Q~w6V|VR}=N}ZjVVkTfR&4fKy)po}$sL5OegUypNbWhmk`o>K z)^nhWf(X18K@pnEaI_0QRb1Qmp}9O%r31Kc5hy0~-YhK?pZ&V9JaUX=09X7J+qJ{G9~yq~NQzXGPkd>~ zLpCK95y_+_b&!tsHdf(}Gg#H3;pK-F;0n@e+w7s~ zFyb2njSWTG&3%;~R&x`M-6P0Tw zpX~V5n{v)sbJj7*ovuHaeyv_fTo{VO#`3P(LqyjfC9)uB7xINZfE}eCgWL(2tPU;o-!P|a}*C3E?^z`v=$qb1u!AM`V5~Z?4D-!_{?j3YKmx&UfJjNaBA8 zHjC)SG9PaqUfRP)J3%u8Wi1^qmPg2^SCG^CUYqvpWO>%!(#o58PbR0=+*1f@jkFFT zul`uNgYH**)3ESU3`r(7SieL${_hw@raGwLLNzg6t4h}1|JcIHG@d zzm=MOzWe6HXN@-YK=}PwmV)=MF*OzeevtUSFB;ySOAz#y*-4so=Q872IZYxCNXAmW z9ApGZpV7+~CBGNjM~C{gbKpVe6^Ijbnq)^6?WgI}oBR$ojuKY_HEW6sOEas4$d<4q zr9(M~z4B_rarr^j%L0MYd>|_=fht!`hNQy<^<`6tT64-s@0m|XV z!7Zzn#LPIQ9RN)zwKpmVfp_y+E9n!(F|X0_EEx3`z<5(A+w zwXO>1RMkpLdil<3EAvo*#b_W26?--wy);<_OvE)dJxP>V-4t;|OBUY=eefx{?F56% zeCD3yOmxa>%XD9n>Iwx31BsG;)2*%fI!B-_VE%n|QQgv=Hw|~%;)?`f*Cz+`2&5tR zqzE4Rs85q-yz)qO-qr(dFON?tB(OMDMa)R_oDyLXm(fWq-dI3f;inx{%HBHLzJ?Yn zmvWxhhbTXxEm-lP;cq;d(m_46| zFF%V8o+_Zm`uTZ0jQ8Vzl#pP|%dIU)YjK`v<@BCPi6B>u2=`PXDLKW|M;I`U} z!4rS=X2elROGB9QqUidWy<#FWz58f|M9kCsdKLTnBEtGg!!4>yFY_+HP5Pzzm^Bcc z#2x-DQ!~Bw%YKyLDGK+*TCMi=-v0O`c7&&(zgt9Q8FdFk!jQVU-Od6bG)&k>TUM)% zEwAQhKW>XF*T>=g!(mI_Lcy`_YrCgqc(obgZue^G55%JKasW8M z*KfL5$6q6I-|c3rx1*q>E!R~}6Z;}Eg&pB73BnVqA1??)5F=D!HF}x|yyxN}6Wjof_sv$`7Rx5Uc9~`booiEN^nW-hy^Q?`%mM8+N zLzt2o&$07-5}7h zDs=cb+vf5kzQFY8eL_jQm+m$3(|QX+mE#y{9lG&6RhTjDeG;$n?$^&t_m-Oxr3)@W zuduaSS{(g%v+1$A>x2S2WApHJizG$iN#wDi3}TDjx3+vhMBavP8y%aFqLY6<;#3?# z=1}6D!f`U%jU~RwUHWobdSfBGc4s+tG*q^63uN*Fy)QD6|3P@Lw#nytwqK#E5o6ei z!V$U)DR?{`5I5USKsKpwGbqq#fTT;rFvdVmQbUEeE-d`V4yuQ~#V3+df;AbSL}e+* zb<5Hm(BE}6ruPJ}YaN6LIv66h^pSDO_s`7nYt&_hMTO-n*4j+w&(emVg=iSrEVRVB z1H+Yu;0_5UP{p4fVHN0`Zy7PR7FoBSv0t)c--M%5PC4yuWpI==MFGJ^I!AwwnNG+Y4=;aPdy)fALuiM$WP49S;ML|o7q=-PbTYFby27UL9IaHb-~ zlRmKwSg~fT0v0;-`3bI)OWb+RB+d5yOD*XUe&LWd(-|`U}p$hB1Pi*^6YP#oR z_dHZ=%@zR_&(bCn$h)Iw*dAdqYEmIvTO?%_mFV2JPfroLCUZFE6H>OHirB9D;!$^T z47xk|WC*#K;z54)J_!?@A!JWPTK_r~(ZUxFH^P;te>SSmpBSojdwza<^l^m=H&`vO zb~oXqr~VX2+exiH9qrAQpKW9r0m<3d#)Mol4Fe4mIFNV8mrw{*UWY_gbi$vgChDtQBJiHS4ek(^QXL`4596Ul!phPRFKy>9`Fsp2Pg{kB)e~j-8mzH)&M^jp z3*U*8^J%$-hnim#20t`l8-{je(s5iMb<#hfp*iY)%S!@M*nIFFl)exZ*-|>0FXmcHMHJfbBQnmL1IBk!w9CO-{pki%MwIE0%n`+-{ zC}d417bIA+6s}6+{$V$1)QAciN}lfNeDM%29}&eA?!>Lw+;XDI-_OFUy{8O(%j=cc z(ug1D91#hid{g#PadtvR8sFpJ-;<)%>-q^TQf+5{qKrjE6AqT|syz)dP_(qwZqiqx z3e$6rJE-JW@%j?2=EMKTN9ONbedRE&ewpM0>y@l3)EH z5ab;kU^NMTDhj)Rw(uoVkdp^yXP45Udi@eHkp2uS!lsY3WfPe!IG9LuD9p@+Fc0O@ zY;_E6*hY|~(!)fufGVizY@G?9ep7R4JxH8U;+eyXIDCSBhD$BmLD*r988Zn@I6_3e zWgni$=-wyKjPGQ}Wtgmo_m2*a?@6B{$V+-VEP)DIjP%<0%TOw1I#qd4?CG zrp?dk>2n@_?mKJJL7dB9-szbUoIeVQkxC#WB3j(8n5gzRFp*Imo=i* zY&zQ8ISGcZ2c=ntxv7AZO2Fw|?Mv3|k7P99(q-DH*obFN?6%Y#roIiH;pEk7Dy%ie zK($p|wBfH!@R}K?dsC$5Mj`@Hvo{yvIa#d!9=SLcOKbs4cqnEetruJPXZ6q$cD^6y ztHlg3dxHTwR3nrHbIa;DbU5u}nXZjE4Sdh02^qiA9Vf_>yV|N0+qs4qF~qkL<`+%+ zrxxgE%Jtg98rgz`62O{5~#TZcb@3^G-$4TP% zTIiF9L|MnI zX_<$XVYR3aZ(SoeUc%*BvR~AeVP3kfJso;IjVFf@p2R3Wgd5>!jfA|5m2Zt8@-MBz zKDvtn>cEP`xz13#GTg}E7`D(9$(Jn32*7}vwRA!t>k?Bi477{mhRzC8YGMaHN*fSa zVQoDVP>PF?ROWdij`TgC?*_Gg2^GwvL~=%!KM|)=-Xw{KT;jsgR5jQRahF~`aJd;H zD`&hsBa@8o+u<X?Vs2%jRpxE(lwg6ZiZ6D?My^qEy;Ujk?x=*|cI%b!w*{foLE zm1mjjFYR3*0$*QYaU#1rL9F}Y+bi`6$-q%+b@w7>C7WmX?hl4#^?-g~bwKP8t zIla)RK`d|fg@gr<|6bTUju+=fH=}8$W;~u)GAi$QZ#oQPjWWSQbnU^GbJcNDJR_;% zNf^n$JH1Z=?@n^dWZQO=r8H%`la+k&RDu=dYXAkiFw1VhToeTji=oJqIq-OMaz~Nc zhoc@L{O@%rEz6L`e*h~VFDRha@hc*$@Y(o@4wV{6-~7P^l91+^R*kOKUnEaRut5b< z!cHq6k_mIF^-XKGf&0;PzR#KV?v)}w$Wo;b$LN@;+`Zt7hC5u3pJ(7oiWfGxIR?>A z`VgOpeIZXc#3ULkrU+hJr=C{Z^AqzOsH`vn#{~c6Ndg_w?}9Zzdnt6Zc^hGRAQCr9 zPGALN&$p;IOc5PD;mhm3iD8zpP;{S`1qL~Th{?PooqV%ir(%wQpKUj(wjTCMEADSq zwYoeYMloZW+U?#l)pWyzID##hl7#0NGSZ5SA?f7x>Us;l8&4FEoh&sfaT{Pn00i$p zpa@C)$6EFA@q%1vkqOe2oL5>Obj!+U$?S+rr5Fo(Ryn>$131TQbR&O?$EOhPZ%C1j;K!UCj{mmc`nT6%2Ev>XH~%I^7C?%p zrZ81a=|kyDf%oJ_?YycxVl;19nH6SHfSX|DPm{Hz2ff8wI_~nHwgq zCyrvNHZR_$Yt-!Xv_0>CA1J<^x8IN}Bv6h6cC!G|xvz?BCQ3^{0GMXSyU+->Iy)>i z-rqzEA9|#TFffQfi~nVA{A74#LE+0|6evQfHl64<7%=Z z9Q*Ip(TMF#!+^D(ywKvr1d6oe2DktBC;rZUs1qsr{E-#AI_RpMApew*h;?~s{8s{7 zve?E}m1pvNXQ&xa|BG>d7rPCTI{!~GHy|oIp#^fQu0&F%qaeJ$=j8i9M?mm;V8STN zW#NRrgNDc87s2=wy`>fGoFK}n?IaK#Q-=Fr4um#{20GecZZ(%>_&FUY^FMkjKG~14 zYcyVNcM~v=+qq9${|f^DFB+@?axwX-{In9xeHtKTjy&>N30PqMVcqdpfI8)&O_nMr z#inZ)&y%{HHUm`OmLNJasgQ%6x~ra^zmw-52c>%-h>3&O(ecUz-?s03owNpo?*{)n zkt*HhARM7<0RrlZRP@sEeBwnzGXc{iQitIk_y@Jrh*H7o!qmA<5BwzBe5n6|)Rv$C zVSUD=M=GG%WdeT6)bLzsH%)&|^u6>UGRstxr#=oH* z-gPk#Bl>ek!7*p!hr~l7%O9!ehg2&rF`Zrm(HI*FyOa#I!~^HceydGvDqMl7`5s;) z0NC(Bij@j*=E@f66(x-TZc*UIHtGDIT;X4HR6d~m^qN!wFmzA4I@8@xrY98AE16(&EFL-UJ|TeA52zJyV_O z@(x`;T|&YcqM+#F$VbuOQpi4zLD#PM*>NSxk1&?QPmp_;8k$#rZaz#UoGF(Pp2p1t zx&t<%n(BY>rZ?(v$k`|NegDVI1u7DS_LFjcYa@)24TssYPA^ST+{!LJqf|)8L=k@C z%J_-EJOhF6s=_ikeU(`T<-Sh9U@*w`kf=*Fjuj67k$g$<}a5^c_WJ~9T3uQUF;j(b z1l^&SU>~+rDFS79IgY#JT3;l(Uc)}XLt6v*D+k3ZcfVFi+qzBb=N?&7xyoP8I| z_Va0aNsa#!Qo^BXcU`a(!mY*jzXcUk>gAM0$IJJs_`GXCL2QV1LQ0zjze8=k3&EeJ^*?4Y{q(94+sQz4TOEQF?B$ z65bTX)1KE=Ao(pIJ{ZK=`VJ}sK5iY;#tA{uVpQD1(&p_-m&IK}h>O69bWH*Q4od0M zQl%M&nkEkX;QulDl(2y7wGxRQv_4blftf*Qy2GW$lzMOw5I*5O112)A?+1sfw zo6&b$a$_0%ix*gSdHh8Pjt=bACDj?#M3eVU2r)tNvTgfkfZL0lrs;cfNKj$azFo!$ zQWF}6kkXp}B#a#91T32tkw1N%OIE2ddWZi7C$fbB!?0A71NHDd#CC+1MOQm~gg%S19R*%+~eQYsVK;#W7iK z5y^MYZEx!2lWaOulMl|!U@Y#;Mz?=MjvK-t)H-UPf$k5!T?DJHp8lTGdGjHv%=7Ir zBr_{K5!82w1mbT`iY5^fI#RT+OqGN4E$~gXBsw9W76_UOTkR73 z74B~##h5j^pV^%MUTu%M)a1sT%wQNSBIcd%uzn02^kq4+6}Z|HhJXT|jGlAWyNwbt z=r-uO?E;QsKsv~*IGM&sP&o;Ap}n;=S2hXd_GlHis*34>uc4tC9NZ^jB#FmB-It#q z8X_Vi0&|Ts%~S+s$<={W)q#3jea;V%kBPN}M>K&Z+(5DxugNjMvgW39WKcd2Aku6yNnv-<)9 z*SB}o&@Q?kFz-(VfBpgh1K0{#-jd=xPiy^nymlD&C-w4j5tz zMe-0S(`T~%N}O_?LuCBG}9icfdc`3ZFxquyZuMtuG; z@B;gy1-Vl&m5CB+D0rKp;Llu(fo^cN1;~%opY+m`+1_@maT$~>+{5813G>sb_-%|G zPirI}(B7Uw7u$s!$yv^Awsh%t+~$#^xOJa-f6n`@-jXTTp%d?zui4STp~{J@Jo@lZ zo6`HThc$}$0W3a2ZR_yxJKJ6zS*a(AlWK9vt)!$R)Wi_MVCx}y!zJ3SMSBr=ZqkXB zbgR?UC+enw-buy}XXOZeq3kzKjNADR*0-;cJLVO9PyBRG3li%ASWfOv^NTW)e-=u4 z3gS)Q1BLu67t^5wv9v!|!PX&ggjrkg=?WTL0SeT{J=YVx1alARZAR4wNXWyx6q;|g zm3#g<@QQH7!zzyvIfcnU#MGyPx`&?d?rR7KWKwiGq^SY+g32?pw&x z^=?Ql`R#QmZZbfdxXW*YM=T<4sz^Uy^0^Fhq(Bd|Q}ajQVG)sxZ{K z@sNbUX%bq^sH&56Yuia5wc56M!Q{suCO_9|=uN`-aXscbg}&U7F#XCDJ`1p*Q6cLO z^@smG^Y;XLNcDhrze~*Z`lk;?l|U}Ku&iQ7vK@Tw34GH+*ru543x1dg;i;M zgoVCg`(?5xqtZ+_rkh>lb1C?;DfgqA>m|-Keos%1;`&h-kWyTHsvyxO>`bzCycPJZ zK@V8y!eS_>xG=7PLEudj51L?Mn9pc6xR7C$YtvzU;H+h88jYC)bFOy0&L1}``5^to zUPxxh8G}(1Qqv29`sas6ON;*xeyg_nB7c0D2SiOR!YVsC=?*r zJ~{tD%nhA*6`5De$VNOk?tI>5t&GwQ;C)U+inCnpA3hZCos36m&X(|pd@S?eM{;-(bn zRO5!^=MeZ^HcEYzL*2oX?>W~`Sr4;dzjA;WelJCoO=ntS8dfutfPnC~X*I^_X;dYe zS-#m1;o79fgXx5dTY*l2v6ykzbj2KjNCe=kL7}&Kb~L3km1Do)}Jxy%Au1Q^Fugn4hx%>o$n#{Yf%1NgYwUcok?mc z-;RzbbbXuQp9HZ~Rr%JWw|lSnA4i9~zPUJWD@nPyUAepEqAR#spd3|v${YBF@nSx- z3CD9qTtSKOmI^>uY;$uAgS^oyTf)iCKKDF6>V0(E7dlP^y)XcMGc_g#oak?2OHPKF z+^3UHZA?rPOYILV*?!j==8dR0hq1*uxIuhw<@BsomJ%bsi;dL$A6;Ier_Dm?A29p< zC>&QImMFSqLaLUrXaRf_eZB6ym$fxgRSuI_%5%LFu#KY}67#Aix6cdOxS40rlsS-& z9k*QjZ>&a}Ba4&J@A%IM*L#q%jkNM@M@X%EH{E+HU1u&h|Cm5+7DgAN=V?knqXA)9y)lFVsbDY z4Q$mJp_uKKL&ataeD`h3vF>jhhpEyA>m>y+A|>EQj;4?~v(xD|3b|a;Wc#^t>{n+7 zLq(tHow8SBj=A1NxE-!ll4lMBRpU`w^uQN<(4+SsAq>RQ;kVP%$@p^yV=enK85JpY8NRIo7p_Y9uv zmhn=Dy&O2Azk2-oEb()ls|jLzd_LErmuB}YDCybF5srgo&2os(eCvECKn&Zg)=CSa z4B9JCt@8uKk85-FV!9;{CMbSIsXSXNl0H$N-!pq$ny1}CAF)jv9QM>;K9f6LS+MQI zI~I5c;Gdqs`SoYp_dKije7Qi?jqtmlan4?FrR9TM+)*{THj@OCaqG5uI$#d^oG&9- zJV!r=Tquy$bIuHZf2@c#z1KhTl|*1kt)1b={BRQ;;XL951FaK+~}_D-r&W309HS^K@9SMBIux?CKI> zQg*0@@AmNsQ7EgyMFd=OqKw*Nb6L5<%79PsrbK#AHnkhtp=GNHIDEX>)=kNWeJCAHf=#FwQV|xNWNS zql71ms|`^{vBo7h3EHyy=SYM2251hKs5wd0PvuUVj(=v-m!vF1c?T>3`=<))3}3;!~j% zD9HkHl(j^{yNf(oPJr{pJoCMbCThwa%4&#CRjJ_@Z0H}Um)BND_j(w;egF6s`52QR zRMf7M#bS*{fYpj(B9jlgIzBt~ZG6)6sPSOh!Q2*OU|_)XCjGi#SlVRkI>d+UC zi%c_g!Q?zfWJlz_^3v0XZ>gT+Y!s0#8A!;1NJ@9Hug7)q-OwuuArfISwy0867nw_y zA?s3aE8bv?wuzF@9*ZP&f|&0=zy~-&65XW=Wc{q9*qn!twCfJgu%c`gps$mZS%tE* zv)$gDd5yTgK|UK#B*QPcyzm9dwQk3bAKV#K@w#f{Tu5S3HjX4?K!#<1|IC0YEjzC2 zTH_MH$XB5<9hU$ZhEEGcc;?nMMl``E5k^U*KOu`)EbnF8M9`4e1L#)EjdJ7Z#DPjik^7;!6^prA|Ya+MMhf2F>BnJPl` z8X7%!ljBA>MjbdV$LaRkz?TZg<)+q^l4_%R8Co8$idFH9_d;(-shpT#9BZ&yL>D|*M(0ZCmZIpg3@%*i8{<+ z<#9g!nLb-fK6JFl{-BR3zl=o!DN2$MP+Wf3#KIZpDZ6O$)$friH=^GNs5{l05wXX zIu@V}$C57c?rdrs=NCOn9YB{rZb}1DYFIa<;5+Yj<0G1o=Ufm+fXL zNt_^7{&!~Q5rf;}9+^#|JQI6Jlpq_xE#BM9m#UnfT>>aOx{KE^GKQD4 zQvbqi?Ot+xk(uK@fBVi_9(2I2Y76gbZ){L(8}G9D;8t!UAMfYEEn_*_W_gM4#gU&v zIT;JydH~(dPopdgA!*w`rT=&nAPw^4Lwjy!%t~yXVME}9qkP0w(5gN|arCF5{#3qK zbcs+#9*ZCR!!@X4w?BEX2Fl;LRdi_VfR2$ay;iHWja?foU(Qb<3kj^|8bIA4Mz>Cn zzR(?(#8$`VEg1mlH7ccFvp84Xd&_t~Cv8<8^Grx2tk~B$%zGpFdza{V_4m!qsmpsl z83;VTsCmXQsPlY!n5nlyT><;zmlZjbGu(=d6a-vuCN|kT|9JT7gdE94_b?JN#stXgc<;E8&g*9=fh7oU2?_Tn9BXW+fO9z9w)27i zM9X6$FG{C6c68UmRZrg)1zUp>3X?LvqMB-Q)w7fV6|R1&+nZtHPP$jnO-ShG&uqQR%g>*15+Ov3J(0i}3=c#;D%Us? zGV(ij>k!ySH2>72iE`n8-&7_iH>-ns0(n8&FBRXe#}ky9gnz2*vU4cYNMxzXciAS7 zK7?Tci9|2LQ_Cq1>Ehpt=M}AQRi|$uJ3YOppvM8;UbI)V#X{IWbJtmC{D6&Q3Vdev zKMpgt&DfPvI>aP6O)kh{=zplkYhBTAcQIgQ#wAr=gH7FB*CoZ&vfMSA(`@k_Kfk)`jnOYAXLp3Uw_C=QPvDq~cISI6 zO8}`YuL=;^n^46GS1R0MmXXK_D6%qz6zOz1|GDJUOg9)RnTm<)HtN0gVGxb>;sji? z4$_Oi+{}~{7o?Z|Kqep$J{3ZD7WF5(p*OTIAEIa{&~11S)adT(fq4O~MwOHmIZUGWPHw@z z&3f!yiIbws>w9s1{SL$M-aFkkv53sya$0jLjrzYdsZ`F}y8Sz4y{%1;XZ!mN|}z_1I}D6%yP3wlub0Ll+w4)5Uu5fl5Fhf0tI6CZln(s0F7SNneF=Bf|rS z7#UHmirOa=@VNPa%Xp@#ibuuFC!36ShpM1S3_UTVj53WslIiz6Oas`ddvW8#iUJR> zV;kh0)&0DfmSKDn*NDDao=V`a+7Zi4qfHBqr;w{nbU@QXJE;+mQX}32N>7Lu6;NTH z;={xbJt>oeOHU7UaALF=X{3x?%(ZVXa-A#Ze>F*}%0I++iR<`hXJH_Mf1%x?fIha{ zY>np2zOAP0&U5cf$D-!m2fUjIH%le)Lk(q5#rq3e*AEqN6(wjc#c#!?`O|X4DhPJx zjAB>!LGq~->N&2{GK8Kf5eY>T)BHG!P=HsdS47lsd+brEXO&%BTmRj*$JoDb+>E4H ztdy;CCDkyJK&_Z?om<%ETI^m?!YU7Yr6aZL!mFoQG~Ml$Jkwc6qbDdm_>y|LL7yD@ zyH-DPx$m6`gvLII8sD#c%-?Fk4uG6q&@^=#)Bc)1wlt3J6&nxHY^{z zYl#EHu;D8MiF8-Uhs0sSV)@p#&t={Q~|S1#<*nyPAlN; z*8#S6p`aS&bj)L&RR?8K2tO%Q53fPJ`7MAp5bpEY2cucllh!VR1n{?=0WAC%^T_Z` z7)HYeyytr&NscryEf}WAuGh9)7l1K?K^>OKoo(=Vx>Rg>z*TjOXcAqoNAxzELn7$u;-9G-`VQV%Ne_Fh%0c}0!o1P`NPR)43!gkG!in~u=9W-sUX zFivvF56GbcC4^s=7ydH-^eY8&u`wfcrl96JOYL8Uy58^T#hiV!mE5-zM9GdG-kTIw zukI{2w@cqY#VFUYu__!{^LZ!>LM34mR3PxW??Ldn+gsAv+^2sG3JqNx-18{fS~coY zX0UkW!7r9}X7f#U@Z+@6QlpNuBhkD&UhJj5@D=G5N5;*f*p+f%=;CinvP>Df)}H8gLe^83dW&1#KtY1V?_3_oDfwTcA(f&-bCP)iFR zzRqgu$Y>)Ao5)Xmkk$JQ}QQd(N4;QB?shRl2iKZlfyi%Do){4W4a0&y)IP|2dIHoGM$ z)k8(4icoQunYUxt(Buz z%e=yI7}SK=Zn~V0iNku$D#q%Yoy2(2aSx_DfAQ@d|B0>1aakrJtTgrUt=t>89nBr+ zRjV2toG*Cy`(2s)C#uE7qd{v~V$JOMs^ASfHRTg1Z=wq5pk9Dk1|7ORWX(>Sdcg5& zO+%ob6x(W!ofSH-OS9}3?2TLb6@r$l$zd%N&-`R}(&&9*a-JmtAKoy9OKH{%`Kt>I zl+Xh4$980i%Ij^8N#%~G5ef=w%5qYKG%GW_4Iv{TBLo5<3suxt>^nNHU*<0JaTE{{ z_WUsG524GldaVj^?d?BRQw?cgNRW9L=~tTfp| zDJgk4v9v4Td+fYC$kz zfs{&=Z^LTTwDe$12hnvVvNAH1^q zYFore;OY4B@bDb2+m4NAyfb!+CNmOc6KxfEHhzwQWjBSwgH8rGpZ!k%Ra3bjr2-^) zn~;3+Xr)<432uFuSns0=PjIa2Qq&5N{ipdh0FC(=`!Y@(>#X5?cyHej? z?Fjf>!5eKf2CXB0y)RP>(Wsd_^tb5mo|qJ5w!^gJiNk$?ipplL{wPYLu*8rI3h2E0? zy!3nQ?>Hq=dhSkCyi^@NBr9wu<4c$1X50mwX~pbE5!>?>}?cLl#)=pBdy>?ZXFTxY%>GjjW7^(i_$ ztaRds`8gVJ)MimrvJ}%zaPPBvCh$^13jA zUrDDLbaC-jwjg&FVg<*7?4s0+7x-U__q@Lds%9l|RGmckxo z_uPCtV%AoqJO6FHzdq8po>$UKtD&jq*{hF-^Pq_6ei!E>*cO}6KmlX$)!Pd>ut0NM zPUdJG&B?6}nmw5U;#*HJdCyRH*UO0X*vk_LpWUIrL>W(sxjPZc%}D0uTH>C#81ra5--g=t_#&0ah#$bc=_hhW z|DPqzHHHz7t9ybP)GRZsx9N4&miOMCm1i>Okaw0F!L3|UZH+@Q*wdJ3Ffh?4=Jz20 z6ERm0nCZhY`h@`wDe))N;=ts^-&U5}gL@CcRCUHSe87gt9jB)?xSWrxwy)thFN}@A z?K*p-Ko(%WD9P{DaIRy%(aM1MkcajIznja42Q^tF!JwF3s~T`IIkj%@j0z@Kl?TL| zJd?&Aqvqeo!ATULSgkHP&WQ6ieRcEa%PY5#q^VCn-*SOXG~MC!1L^B9Lv;rW7`dci=y7A&(NOy$f*v7W zwtD`Z$Nequ*yBF7+mV!18nWk4M=n4J)o9LQmEjP1C-KlP-*Uvr=n-rX;xttEYv;-` z6mNKMPB6n53`^XwEy!c@5oOjdExp?C;dD(YIZ^9s$JXq6Uh$iK0%*s#(?CgymFs7Y zx0HZ(Jbydd<9VrM3DF^B6W0%Q7Kl_zcJrn&?RXR#ItXxCKJtp7V&G0kCAB*-tGdIb zHzy#}+R$uUqLv3FD)#ptA3yaEm|b3Z{jd1?Sy*TSg5(ZoI?b~A47#i^yPjR3u*UVu zQgWV$1TJA2GK>8068Mq;pqLBLd!pmvmy~wdkt;_^2@e```8a1HZ=?S|2U`r#0kkeguCOW+ybhG z28vbx!mw+^d`gZ_#nRjXHDj?!ZnK%LV;P zm@s65kdHcN8da()Mi%MTva%mQjSJJb(l7`cSuY^EFO{ zbijJPc-@B-D>wP*oUXflz?V6ya|d{LB2<5(WtH*o^tqyo@;at`VS8=1tIgM*{sJmU zzS?}+w`4g)e}X9n2|t-L>i-T<^34fN%jtT?EXctr#}LuwjeXiF(VFAqphTdL09iLx z=gVE|(21%t37{+zV!seqRjXRg&}41vt3Gz--2@pU5>i1C%#4%Op+)F7bJ^XgKyqC* zkk6?p(_^8pj;1yP!gFhqL?)pCb6R;yl2jxh8Rbikf}0RDTH7WB4EilWIkkFU$#ae` zf292nBsd2(7Oc6J+~DxNJK|{6A$~so;_3bfk0XKa#~8v5*I$ZWJRka&b|7gr2%HS; z2bwue4khBl51FL%?s^~)vf}uU1ErV~)b{fX4K8;Z(qzA3qL1rxseIXPk>B0)LA8}8 zy#y{bU#`C7^xSRAKM@i8Tp^K>ld(2z!o0LQgQ>==C4%pUToq^t@i(7IN&}1=&X({t z{h!F&?hg|S9i_zcsjT2U1E9&nXax7Hu*mQKf(`#=nCEw%bKw`EI5 zkO=Bj7!(n}*97eY=kd$Vz9_{E8p&B~Yo0RxjJLIfUBP#HMzrNd%^`j4j@wl!w4vm% zj&pn2PseXM2e%W^SU?!$ZxP9#0ussC2tC@FZ~as043NMCC=4R`rz*Aw?- z(N6tb@D4wet`&dLfh0Q-=jL6%L|@@8t^PxWKpM}HhPlp{mqVEv(O>$T9m#co;6(jT zbqyeUvmz-V6<7NtE5QpC)={>CAd_jWeK+j@2?mOPZW0PeW*a}nlz(r@Hvi;Q{kqYD z6%x?Hw%o?+aoPTX_QMC^4>IB+>i0n|xTW&==iZ-Hwn0^4DQ;F)cQ4oHaE;|)XE6v= ziFz^Vjn~T%zel%*fPy!4Awi{?g|;z(UO2e^0cU<9T)`ivZWJUeG#?JE{W6z6S&WSq zSjD(ag(PAzu5c7Yzf$!VNj}+N?DnU{Fd`#X+j4b5=`|pn@dvGa2GY>S$nt7uISo}v z8$*iF46=Bc?y*$pb@o~boCU2j864iSTBtU9W4g4%Dr>C0t;bU5i|hgqZxHZWY=fAg1t?qh4{4c zDR15(jqs`574Y6}mCb9}9&5pj2Q?IZZ!(#)V_8l`uLl!*zK7vypN&ZLnlv^mQZfBg zIsbqdV_OKaD$4DPcP6v*Hn|oj&a3PcOC_+p#z)-HtXi_IPFUjYtH8-EaC@6ocRO=! zg=EBDI!#DDrBwJO-fvuEcCbBgpiJlXqu@|HH`DDPrPC7q`K2t%ojyue$JN*hw&Wd} z`OQ4xyiD!DowMD_i{a7HgcyoN+JN)5>ET2An;)eH)mVZV_oxdOI^o4qLV3DVX@*#4 zN<26Nk=K{E!n$Q%<<1tjlM%~*Ky<>4yPjU(FpbU7v#iX_AIZrM9CA${)1ZC$F^z!{ zD0KT>_48Upw3v^62OQ9AR}w?;<%Q5Uip~Ss!}nS6^{eSoA3*k;O(%lG4y~$s7Xezx zTq4nAq}0(}uMNK_^i^(y3kKl~!=e$s78g57;sUvTC4&SV`;S)v6WB+If}RulZO=84 z(fkFf-pP`(;LlDafVCR=CdVDm>L^A5{+c=cGnrWwyiT!h1R2|pzT18_#!i8&YBj1^ z$onJUw{Ia?t9#2#?MBhjyCH70;<$IZ#t+xCWn9NjHdrYn!v35{e@=Uwt90%+A)gy| zi?_SrI0QY(OBv?suGe@~q?)gg#dwY7W*=KkIjlE+?8gOFW;B_>=y*GgeLq>OD%ZyK zv5DBv@3ZGI1|=k9C*Cs;rbrGC&f}VczeJBLMTkazayH&19axK+UNkD+b<-j3zcH3e z(si>rJV9V57@J=$rr7ZG5D<`tt^I>gkBQYN#YFZ-gy-!0gei`HrGt-1=SW5-92bmQ z)8)CUJz4o;!b8=bs7_*=?qT$d(n)lltx%*pPUm{jOz&Q?^t~N3EE8w}kk6W02^Etz zgwZAh1DU~|Ei30L(V7qH!{0*w80VUzBwVD3tFhv{hfh2lw$g?81E7krsZnY3?~A zyHQSC;tzYDd5?V@0nw}oLmQIhO@CmrgP;wOz;_2i;FF5VZn~iNQ)QUr@j+R_a3()D zAdsf9+(_5=`tI0Zu~n{sb_IBpxXg3VK| zs`3K954i|Dw#oM0<*HJB{d{P`C|TZK3d`?*fX>oK&e zck+3fNhFFQL1g}9KsJbTMOeAA#bq3sTYhA~QWL$W0My#~X5mjy3_PTpo1+V=FBl1`+4iu@dXy*^gj_VjtAmgNhlhB`xb zGlKuv3p`Qw`N&ETqow3*TnBkrv`Vj%j!yrB)$y$o26c2b*XvvGv+>IfdX4)K+pAAQ zYcvr*n$lF}LdByJq)V3U8spt~v{Ibh*eLoh8-r0xR;tV0Is?zT3^yWly&%7<>kECE ze`4;36!=#w_KsLnCnq@ii@;0cNr5H?P;D>fx9_l%xAc!O_BBH?vj-+;iPZBWJ7}}D zuT~r}nVk|AQ*DD><-3toX&F?u27>Pi6Ypg=@liJoxXxqOvI-Qom{|y;wH;N2*f#dQ z0`-Oj`o%qM`c=nX2=m>}t1g9Zj{aV2H(CjEk7ckA!$vPg7TKfa(~~h(f?~9(u54*_ zuDxcL+?DpPWqjyv=l+XVsbgJH2l3eFQzaT!Na`2rp!ea7Z=kP z#*%(aHg860f|=gW8+H~mBu=q))3x+5g>SF&OyYR^8g$TKm#!DF-OIJDhHc!P4)Z0|V0; zc5g~&L|*7=Y1G0i_y%ug?%VtHHesc2HHCc1++*xYXVFY4?;?(_yhnR2rBz053SNq! z>ymS7_d4k2hwC{ggIOP4TsLK3@_vn9gxUj5z0ES^X1IC;ayGS&_H)$G6|&7A?Y}t4 zs5#ZFjbtr;K@Th1GVUFRcHF0{rsdIg+8jO=K~vzL!XVK1V#chx<*zmcH8mmA~d#w>6u*EXS&ZIlAcrAcB+p(PXD)RUTfQVgFwY{oj}w{q**3F zeJXm5CID)a3#3-YvUyrkg+l9m{uzul;v`w}_qNblza~eSwwf&JOvrpbQDMF$rMNP& zu`-)_r*+(yb4p8hRhoZ!<#;U+Y=$DsVJEc(^heOx7XXZ_+0#H3U38Jn8w5_Md8#R^ zn2!|wk;<;e+^M`2G@lV}zvTHf3YI2vx3W9Z=R^?UsE_mw92wP!h zwMXb8YaFiN#hTDeE@&0);>Qem_0QFsSby{~=(f?ND7iDE*=#reFiu*oxJYbpqxvY< zIAU`pJ>;TaaxvOcS;}##9=kQ>*V2uaT2BRD3#$`I)A>odR-}q{p5C(rSP^%fy=$EQ z5`|MV+4ZE{IT#x&Cw#JraP1o0~h-)(VH>xzV;ya5Xw#FhPlL$GlDdsyJF z=0(o_@cfCou&8Hw7%BWonFwcM&grAIwgc^Z?w-QXqJ4{JfjH+anhX{z^iX9Ya1t%TfV>j*c7tF6llR08qOnmSDH$j&}lT=ddV|+H>>l26O*R) z7Vgl?t6^D=KWB*TNTwGO5=1oacE!M;Zb`qeWB$3kM)`-)A{*mISjc%DrtOt@orX5e z)J~Fi$%LjI4sr;6<0H1=PtToH{Fj?JBe_(&VCBG8%aF~TjILqsMa>broPgGY{(CJ( z`Udf>VtlQy5o<?^BrvseBj{c zmm}Ia76!Y2YntTcnp^lF{`mxPU9V0fowg(!mv}%vX_<`i?fbGUdr0V&!Wd|J*rIac zD^=m_Vm{Dw^_6=SXnvw5JBQ(dl>`Q~qVPE9Ecojd^;v%!>5)bU|iu z5H*VS4DJi%Fc1br(I>62k(sMJ4e7@)c0H)Yaq3Y~v@2BR7q`UASsl54mP}C+`mMy~ zTaclr=XH~ePg;r%z95#XG}_}s%TQ@)&ZhR~==Qu)8-tP)V28bKGP>TS%_07sXPRS( z$4aZt5lWSen4&#$Q;(T&x?dYd626dZLZB<`k^*QL?C&N<+Wvs5D1V6hS0u*6IDbt5 zDij$h3&~%{iDiMe3qn);{*DJBrqiT75lHt#)e?f|>6B8_X<1|9|J?q+@C$Nw&#pl~ z@k=fwM?MV?9L!Hw5LzdEMcOkG?Tfw3j(tiBstVI`M^I2ek)=-Z-@wgaR*zZMi5??3 ze|c8x@Bp?Vo{cJ5%0E*C^mu>a=)ZAr&>LZA(m&6d?I6)F{&Js%K+u{QAclG+E!$oI zA7`YWT@++Uoway=Y!$`_5KyN7Z9o=|&0%z;^j`!0cVlDGtph;&mG~kQRpElOH9K5P zegHoyfD7xqGp2rVrv`9{sUIyPzGAQHBHcz09^<+qg6qi5QH>iAjGBFD(9N-yb#_t4 zYz;zg|DOT=dDDts!)($SL$tvECE_X`$vsu9P+Tzezy^x*UyPI;Ug zxA;?tFc;aib`zgtxBlyE|2rgO**^(69c%F1P|!nb#?2UdGQRjpV!TGpWQ_#-qyL{j zI(q%-p?DX1svOj)i{v+fa-x|7hHE;|lgDR0i{&)KUeds$3_Cz2tBho72(!3)z-*?Y zpU3?P3yP~efDVl4(fAFO@@jk-pGIU0RW*)$~v-G}_9yK1I zC?eY_0&uqSE%&dEqsFlg7mZ(xa^7eJ>RrfP%#{8&r2e00dTDcECc40LNFo94*j`p1 zEJZv`PwqVNaPZhxRQ(Y|x6!ZVvtoVpK;y|}t42Y8RdpYh79z>_2K?sy2vPcKy3X6$_4!Z;ME%MCoP64f@W!UVGk3ho+JjgM}9;yh#Jf{KrJEKgKQ#$B{7HBi$CSZ4kj!vkoH3RUV}pX zvuN{I#H*H5?gtE7$%Hs~Qe_Aj2yg!2Zi@feT{H~fiZS=nGVO?#z(f#`6#d`1Tc%Ez zk+1w*?tPNTsx~j}4{XWPT2iW1m$jvtOXGW*rg%%fh2T0~+OpBoy|pO}0-z!cl)Oyu zKAt?fb2QOk7SS(Vs?%vM4yp#S2u?437H!IWsA*ZUZH#1Ednsm_DFv~(vr>m<^mo)| zda(!*heba>597DsWklhUY-c8F61V4dWXHNKREz+ zzeC5Po=1QLPQ~n}5NunJM7Vc%cl~xqxU{?+O2xvVeUM&v(ZQrCiAIaEGRF`-A67+1 zd&fnT(}Y<4P#O)ntD7M4i_)jz5(Z6X+c-$QMMQ6eo-Z&@6vW0 z`^+fvURbo*J3H%fnBlxNU1LlE5u`f=rIo=X(?$zNJu?V1JjkFz9X1Jw}eIonpTqF$OUOb#=16y^tvmR4NED z1|@1;6oTFq80f%-UngIXXmrl>>_q9bz2fxXm;f=O(=xKHy>%5d;gl&k2*6nMp|iuq zmX5k#Ft_f5adNd~Yq$7=?1NkTy;i!77(N1-(ofq+O&>t$qFr z2RAsn^@z8xO6iX*@5Mj>VrTc1;PSJs_UQJj`-!)Y9BOlaNElB4JkW5)<3>55E?)K5 zGW#EO0T&>=S`)G4%K&Ew0EGv%(ZT#I9;WI?Cu@G@OOcTBVt!d9rt?N0-Hif?kGP>b z-4GmTD0BLV1HX-E=lc7yYSzSVw2W^|uHdpaHigPL;9f2}X2uyBcLgm3%awG=sw^t! z2kRnk+hS7VE~b&O)U+|7CVXhl@c-e5WfH-`iv!rQMhPk{OgYhtTB5-pS;OHtdp+Ape+L z(-(A7RLK{D9Quu}@EeGeh$JaQBMTG2e}(sbB@|r~Op2 z#GFj1b+^*2Cu5!3aY&&r5}^l`9DwChWi6;@a3~OKb$r2t#sG=q-H*!Cy7Ux@tp$X13 z+oeOgEIz5SF~ogl?Cj7MOaTr7h_C^<;Niz_^S%?CdMV%i!bP8aolrE{ze1~oHQG3u z588}12H^1AguOx;NTz+?+olXfm(Oj?%@^bY4AiJzT~UymDFwPJ+h$S-}m_hGJ>D>q{5;R7g0l@nnu*+DkUOVo8e zU8xoNlFy-lqNF(Hnan;5KggN16L3Nze(MqpD+DFo{y&yT%_s2tdv_fE+(Ncje~({a z3@e@@6})yATzcyfOE$qd5`I+6j3GHHewvh+_TX_U&M>$10uLu&3(eR?Bu5`Tx8(Q6 zzXC|l{vPvIG#HwrZ&L`!ltW(sL90k0BEZ48ULCay2>gH^*oHt;Y`nQku`Id`7$m1K zB| z!qq}&0BtXtxuHPypFkB&4Sd_g%=KI19(#xo1vlJ$s?)XEYd>*y&7vj{!+s=YEH4yx z#Af)~7@eM?`71}i>o$q&SX#UP8sfUOT&IcRIP4JzOU@7m2b9q;Ps_J|-WJ-Qf*z#^ z%ZA2aiVaelN2%I^bX-W8%wv1o`%&Na68kcPG@{0%Qj`8~RO_#(T&4Wu1^7f}64>=u z*T`9YxX+4}^_e;NiF(SCq0_D@7qQ|wl7N~A{RWk%*ESw^O4K28bYlVd-D&wED?_gO zkGp=ZT0k}sE#LqDA1$B6feLbstp2xrw5GXAC??_RaQ^Pxytr%S3AANce&yFrf&|f# zXwN~~3IXL*XP%J+*zLPRy-ODljhi^feOMN93(EiYlSF$20^Pn&=Kc(W?<$QZ z%}{k>x%jrH-jdKB!C9=y`C9w-oAVWIWsxa(lvRf2;3QNs$v0_rq^>jN?#_+gv%tXK zzvV}e<#Q=bg;1Goh918!bRsP6S>UYJu5%XnN9XiTKnHNH>kffA5_zBamsD(Mo-?M9 z9e>*Mv`9y&(c2<~=@L{23LJL%hs)7>dJC3~5XV{zs} z$!dAyF*FL>s|tXZq)?&`a&yRYu5Dw7AM9d+r(gz&tQp4<`$33uBDidV1e ziQWMfo2JiyhND`^^wD<{QLMuR%U56zLfQaxrh$!CxHQYb_C&8* zD~o#vHT;#WFgPS7&TrE@y>#u8tiQ@7ax7=_z516{&a4Uro2sgOCz15&-UKw(vyC!t z?D<@B0!y5*%7n~Lpe0tk8nT_Ny7&qCkx^Fy$tw3OOzh5L^zab=v{hIInyDgoW?Ep) zR`&%VI-ZFCuy8c_np8-*2vJ56j#?c$?tbGZ8ya?ei+uU9eqqKi8L^(HHrA1gEyXWG zj|W>La9lp!L;US9Sq3%8nGspJ5QDlR3M`N#fjEr+CFusq&H{8ikJK_yuv+5C0uT(hi{G1h3}084kxO=h1IIHhEI`Yv~VBLWQ=Y!6&!Jq1^MwRiDpFw6aQQ()fj-4V-&rk=)X)hQ)#Ny?u(ZQnM z`o}wzjfmxWK;mnrrd22c&h2?xU43G13!FT<;cv6aoC1EGy1;n_lmaJqE~O#^U2f-J zWy%T)fM z2dT~pXdQGrcTn2&fzI}((h_T;#K?4pq7nNf)PQ&f{zhJx);Sqan+n%5u$Az{l^&hc zTmbxxQV5uVWTB`{vJ%Wofe7P>pn>%-c8t=zuIsf-Kg6lDf*u?066&Ygd@PK z+$_1WE@vvoQ>jbaM=Gb$aa>wEEHAFE#l#a?dJoxDbjoGfT;H%KKlMAMV1MNfnI*5| zYrz!NEW~gbH?_leWt?`(ZM|c~+>yDS)xgdIj5S#a44Ef&?g4mFhGhX~uzEKgqV|mf zN?+V!{Q_A^Rj5^m5qN8WU&wdi_nI_&6LrVI7ww(-3BzgG>weNR?V#eixcrzH9pQ2-_;(PJ9LEaskH#a{N+p^O|pclP}fP?(!2{hIH zt3-41b0Mki3%5~^Glr9--Z1#)`bRV)lK-CdmMQ3S zoq~C_%Aej~=xDYfTmY$}>L4v^{P|((nKuM6@R9F46Y14vbVJ z9X?zR^?avoJC)M9!Bfi(?=iM4%6_1UdLv}U>5^0&?tK8|#a}kcS4|R?k`R${!sd^jzkj8GpA z6;oXV_$)}vh<+!q7-2Y>X46gvPw1Q@y<0yC;Wf?s1ar7|^q(kt;G&%BL4ywlL3*_< zW1r?F47q;C7{4S#XwrlouR-NhlSjA;uF0p47{RCD$g^7j#ZGn#f%f`;J@XgMD{%b5IULfls{|?%o+Dw3Z z<>pa6n+3aD0PquPbe||YP`E^S44%<}iwydzuJ32T3nI;<-gNb$Gq-0%bC(s>sQKHh zoDK@Nd4_Tz%*hWyQ_43XM84CB*7~6K+68wGRFrvZA|6Izb@xR`ICoA?mnQaH@FIPt zkTAz`fKEQbuReg2#{54!4+8X85gqFydIT0^-~DoZPDwRcegliQYGQ;$O#5gXwCX@tK4HsEVif@`%MEZKV3H6~~p)n7Phw{$Ety3QXDKzo2D z>Zev998N6)!{4pyGlG`oV4-1IkQ|K%ZkAHj!p`obq{n7%vpG{8a>xI)dPD#5{kbi|Br zsly@p;G>5BAd-KA=RU5GrB3PHe&M1csv5S%qcm*vTA^Kg#i4`}NHks&h6jJC=$|73 zU)Ujh<6`}^`{OnCRJM-qm1-PEwJVe;l(%)S`=+nG@b{Jx;eR95`I@3?`wXgygEPl# zHVc~P21GEigMo)|Ry}sjXgnR;)uq!3cA>`3|5T&8 zX02+uUrB}h-;|1w)7Rg)Vr`)p7ki>W=0*aShDrr&c(+#LgTrFdlB~2be?+VOmja{` zMa85}cT^<5^wnq=$!9Zb%)mAP zK5rRs^s01q`HHaOu?2Bc&~FDN4#55O@4vBt^5RX5!jw&vj110nqk43vIlpw3TL0RD z^icTtUQ!zPB*Ul8vwHR#eWsQa^j|~$eI%63ki8mRT{D#;{kdV0qS?z3IDcF-{mTq~ zBh1H-GB7aEiT_Y@jixwqPJLqpp9B1Ot0tEGFP5W5;``ZsZ0)g^v)uOJmTOnvx+@zc zt<8wHB%UGQ?d*`5@CDVsalNwy2G|_y3*KtE{9xCdZH3pb$ypo7b2(5zmvC>%&1;e5 zw~6QZ=fM6nB422+tc8{$ld{sdYqagaw}L#sK^cEz7T9Zbn!#vAigy-`V-eFc_L}W@ z@RC!*A)%Fc#Epr1moeNR2f|`D{}~Yar^ft(8;Hex;@?+#bl@F#Q)5UrqW5SL!yyU2 zk8^f(5)wzoYGv|-Qd|5piua!b-t8$nv_=od>S4;t(bWAzpxX0&5xwY>qWh;0?QATOags{G-O~PXRXSHgze%8cnv*S zC``x3`Q5JvlAHcdBsFWFR zPQcmAq+90Kw(bq88fyhX0BIDBHhvcDK`L=Jq13I|-ALlkbWrg_s)F1xH2dq8q%Dpg zdf_CR0$9R1Vo~SrV5-1RcNgY;FjIw9wyaof4Z*Q5)bAARk85*-0L14=yXS2dtsM z!%w3fO6%}=>#uthCfonwgSmc8JA}~)=k?t1VWB8t6mMCZ`<+HDkw@!On4HCO3xRy~ zymGR?KZ)OKnrtJ(%Yp`~VyZkTK&XK+vahb#OgVwo&F-Lyk3iGFzH#Nd0usSLObZdk z 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�=8*$o_}E&>I*VA)6wBf4&IV z0WpIc@)%{VQ2&QMF_`=RCzk(V%hdmg<^QbZ->l^YIs`{)(|5q`BLw&(E-WKdA@IfT F{{a_Z0<-`C literal 0 HcmV?d00001 From 1171a52d62160b6b9e98d13d792a4cfc8acc38d3 Mon Sep 17 00:00:00 2001 From: maipbui Date: Mon, 12 Sep 2022 02:16:47 +0000 Subject: [PATCH 15/18] Keep broken URLs unchanged Signed-off-by: maipbui --- doc/SONiC 201904 Release Notes.md | 2 +- doc/SONiC_202106_Release_Notes.md | 6 +++--- doc/SONiC_202111_Release_Notes.md | 2 +- doc/Sonic BSL Test plan.md | 2 +- .../Json_Patch_Ordering_using_YANG_Models_Design.md | 2 +- doc/copp/CoPP Config and Management.md | 4 ++-- doc/passw_hardening/sonic-passwh.yang | 2 +- doc/pfc_asym/PFC_Asymmetric_Test_HLD.md | 8 ++++---- doc/pmon/sonic_thermal_control_test_plan.md | 2 +- doc/port-config-refactor/port-config-refactor-design.md | 2 +- doc/sonic-build-system/build-enhancements.md | 2 +- sonic-acl.yang | 2 +- 12 files changed, 18 insertions(+), 18 deletions(-) diff --git a/doc/SONiC 201904 Release Notes.md b/doc/SONiC 201904 Release Notes.md index 49516ebbe0..c501473079 100644 --- a/doc/SONiC 201904 Release Notes.md +++ b/doc/SONiC 201904 Release Notes.md @@ -29,7 +29,7 @@ https://github.com/sonic-net/sonic-buildimage/tree/201904 | 3 | Upgrade docker engine to 18.09 | | | 4 | [Everflow enhancement](https://github.com/sonic-net/SONiC/blob/bb4f4a3a85935a38ec7f9625ef62cbe58c0998b4/doc/SONiC_EVERFLOW_IPv6.pdf) | | | 5 | [Egress ACL bug fix and ACL CLI enhancement](https://github.com/sonic-net/SONiC/blob/dfa7e58292deb4d7b10d1e0ca73f296cd206e9d2/doc/acl/egress-acl-bug-fix-description.md) | | -| 6 | [L3 RIF counter support](https://github.com/sonic-net/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/sonic-net/SONiC/pull/310) | | +| 6 | [L3 RIF counter support](https://github.com/Azure/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/sonic-net/SONiC/pull/310) | | | 7 | [PMon Refactoring](https://github.com/sonic-net/SONiC/tree/master/doc/pmon) | | | 8 | BGP-EVPN support (type 5) (related HLD [Fpmsyncd](https://github.com/sonic-net/SONiC/pull/375), [vxlanmgr](https://github.com/sonic-net/SONiC/pull/369), [template](https://github.com/sonic-net/sonic-buildimage/pull/2838/files) ) | | diff --git a/doc/SONiC_202106_Release_Notes.md b/doc/SONiC_202106_Release_Notes.md index 5d35eb14cc..8b61892aed 100644 --- a/doc/SONiC_202106_Release_Notes.md +++ b/doc/SONiC_202106_Release_Notes.md @@ -50,8 +50,8 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### 1. Telemetry for Multi-ASIC This feature is an enhancement on sonic_db_config package for multi-asic to read different namespace redis configuration. And enhanced V2R Lookup for multi-asic, enhanced gNMI Server to initiate redis connection, enhanced gNMI Server Get and enhanced the parsing of target in gNMI Request.
    -
    Refer [HLD document](https://github.com/sonic-net/sonic-gnmi/pull/77) and below mentioned PR's for more details. -
    **Pull Requests** : [77](https://github.com/sonic-net/sonic-gnmi/pull/77) +
    Refer [HLD document](https://github.com/Azure/sonic-telemetry/pull/77) and below mentioned PR's for more details. +
    **Pull Requests** : [77](https://github.com/Azure/sonic-telemetry/pull/77) #### 2. Add FRR running configuration to tech support @@ -69,7 +69,7 @@ Refer [HLD document](https://github.com/sonic-net/sonic-utilities/pull/1249) and #### 3. App extension with warmboot awareness SONiC Application Extension Infrastructure is a SONiC infrastructure and framework for managing SONiC Application Packages which in this scope are SONiC compatible Docker images distributed individually from one another and from the base SONiC image. -
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details.
    **Pull Requests** : [682](https://github.com/sonic-net/SONiC/pull/682), [6398](https://github.com/sonic-net/sonic-buildimage/issues/6398) #### 4. Enable/Disable auto negotiation and speed setting with number of lanes diff --git a/doc/SONiC_202111_Release_Notes.md b/doc/SONiC_202111_Release_Notes.md index dcf90c339b..48f5e05964 100644 --- a/doc/SONiC_202111_Release_Notes.md +++ b/doc/SONiC_202111_Release_Notes.md @@ -58,7 +58,7 @@ Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/acl/ACL- #### App extension CLI generation tool The SONiC CLI Auto-generation tool - is a utility for generating the command-line interface for third-party features, called application extensions, that provide their functionality as separate docker containers. The YANG model will be used to describe the CONFIG DB schema and CLI will be generated according to CONFIG DB schema. The YANG model will serve as an input parameter for the SONiC Auto-generation utility. The CLI should be a part of SONiC utilities and support - show, config operations. -Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details.
    **Pull Requests** : [780](https://github.com/sonic-net/SONiC/pull/780), [1644](https://github.com/sonic-net/sonic-utilities/pull/1644) & [1650](https://github.com/sonic-net/sonic-utilities/pull/1650) #### Automatic techsupport and core dump creation diff --git a/doc/Sonic BSL Test plan.md b/doc/Sonic BSL Test plan.md index b8910c8f9a..1cfc989e67 100644 --- a/doc/Sonic BSL Test plan.md +++ b/doc/Sonic BSL Test plan.md @@ -38,7 +38,7 @@ Verify basic sanity. This checks if the orchagent and syncd processes are runnin Triggered before and after each test case #### Test description -Run sanity check - https://github.com/sonic-net/sonic-mgmt/blob/master/tests/common/sanity_check.py +Run sanity check - https://github.com/Azure/sonic-mgmt/blob/master/tests/common/sanity_check.py ### Test case \#2 diff --git a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md index 926d06725d..fd864d9260 100644 --- a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md +++ b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md @@ -405,7 +405,7 @@ Some fields are not allowed to be modified and can only be created, such as `/PO SAI_PORT_ATTR_HW_LANE_LIST, ``` -The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): +The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): ``` extension create-only { description "During apply-patch operation the field can only be created (i.e. added) or re-created (i.e. removed then added) but cannot be modified (i.e. replaced)."; diff --git a/doc/copp/CoPP Config and Management.md b/doc/copp/CoPP Config and Management.md index 82f9e5d13c..4ea0c6d197 100644 --- a/doc/copp/CoPP Config and Management.md +++ b/doc/copp/CoPP Config and Management.md @@ -15,7 +15,7 @@ The following are the high level requirements for CoPP/TRAP managment ## Current behaviour -During SWSS start, the prebuilt [copp.json](https://github.com/sonic-net/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/sonic-net/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/sonic-net/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. +During SWSS start, the prebuilt [copp.json](https://github.com/Azure/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/sonic-net/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/sonic-net/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. ## Proposed behaviour @@ -63,7 +63,7 @@ state = "ok" ``` ### coppmgr -Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. +Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/Azure/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. Trap name added to copp_cfg.json file has to match a feature name exist in FEATURE table in Config DB. In order to handle traps which has no associated feature (such as arp, ip2me), a new field called "always_enabled" will be added to COPP_TRAP table in Config DB. diff --git a/doc/passw_hardening/sonic-passwh.yang b/doc/passw_hardening/sonic-passwh.yang index be1141b52f..120c98c51a 100644 --- a/doc/passw_hardening/sonic-passwh.yang +++ b/doc/passw_hardening/sonic-passwh.yang @@ -1,6 +1,6 @@ module sonic-passwh { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-passwh"; + namespace "http://github.com/Azure/sonic-passwh"; prefix password; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md index 7cd2a02456..01922c48dc 100644 --- a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md +++ b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md @@ -22,7 +22,7 @@ The purpose is to test functionality of Asymmetric PFC on the SONIC based DUT, closely resembling production environment. ### Scope -The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. +The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. ### Testbed The test will run on the following testbeds: @@ -39,20 +39,20 @@ There is already existed PFC asymmetric test cases which use PTF to send traffic Test suite location -https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py +https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py It requires several updates: 1. Packets sending speed can be increased by using multiprocessing instead of multithreading library. -https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 +https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 Replace ```threading.Thread``` to use ```multiprocessing.Process``` instead. 2. Looks like there is a redundancy in generating configuration file for ARP responder. -https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 +https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 Fix the loop to store file only once diff --git a/doc/pmon/sonic_thermal_control_test_plan.md b/doc/pmon/sonic_thermal_control_test_plan.md index feb974fff0..66c0d5be50 100644 --- a/doc/pmon/sonic_thermal_control_test_plan.md +++ b/doc/pmon/sonic_thermal_control_test_plan.md @@ -38,7 +38,7 @@ Since this feature is not related to traffic and network topology, all current t ### Ansible and Pytest -This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/sonic-net/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/sonic-net/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. +This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/Azure/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/Azure/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. #### Valid policy file diff --git a/doc/port-config-refactor/port-config-refactor-design.md b/doc/port-config-refactor/port-config-refactor-design.md index 6dba5baece..da99e51f2e 100644 --- a/doc/port-config-refactor/port-config-refactor-design.md +++ b/doc/port-config-refactor/port-config-refactor-design.md @@ -20,7 +20,7 @@ There are also open PRs to begin transitioning from the "port_config.ini" file t ## 3. Files that contain "port_config.ini" related logic -1. [daemon_base.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). +1. [daemon_base.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). 2. [sfputilbase.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilbase.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Currently sfptutilbase.py keeps 3 dictionaries and 1 list to store information gets from port_config.ini file. We will keep the current data structure of sfputilbase.py to avoid introduce too much changes which means that we need transform the output of portconfig.py to the existing data structure. 3. [sfputilhelper.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilhelper.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Since the current logic in sfputilhelper.py and sfputilbase.py are very similar, it is suggested to put the logic in a common place and reuse it. 4. [main.py](https://github.com/sonic-net/sonic-utilities/blob/master/sfputil/main.py) in [sonic-utilities](https://github.com/sonic-net/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). diff --git a/doc/sonic-build-system/build-enhancements.md b/doc/sonic-build-system/build-enhancements.md index 31e8d3cc54..2bb0b87981 100644 --- a/doc/sonic-build-system/build-enhancements.md +++ b/doc/sonic-build-system/build-enhancements.md @@ -557,5 +557,5 @@ files/build/versions/ ## References - Ref: - - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.ppt + - https://github.com/sonic-net/SONiC/blob/master/doc/sonic-build-system/DPKG%20caching%20framework%20.pptx - https://github.com/xumia/SONiC/blob/repd3/doc/sonic-build-system/SONiC-Reproduceable-Build.md diff --git a/sonic-acl.yang b/sonic-acl.yang index 084efd7b95..4081d1d8ad 100644 --- a/sonic-acl.yang +++ b/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/sonic-net/sonic-acl"; + namespace "http://github.com/Azure/sonic-acl"; prefix sacl; yang-version 1.1; From 74d7f061dd86da31def5ebfce8e01d2cf1ed2825 Mon Sep 17 00:00:00 2001 From: maipbui Date: Mon, 12 Sep 2022 19:13:39 +0000 Subject: [PATCH 16/18] Revert URLs to sonic-net if both links are broken Signed-off-by: maipbui --- doc/SONiC 201904 Release Notes.md | 2 +- doc/SONiC_202106_Release_Notes.md | 6 +++--- doc/SONiC_202111_Release_Notes.md | 2 +- doc/Sonic BSL Test plan.md | 2 +- .../Json_Patch_Ordering_using_YANG_Models_Design.md | 2 +- doc/copp/CoPP Config and Management.md | 4 ++-- doc/passw_hardening/sonic-passwh.yang | 2 +- doc/pfc_asym/PFC_Asymmetric_Test_HLD.md | 8 ++++---- doc/pmon/sonic_thermal_control_test_plan.md | 2 +- doc/port-config-refactor/port-config-refactor-design.md | 2 +- sonic-acl.yang | 2 +- 11 files changed, 17 insertions(+), 17 deletions(-) diff --git a/doc/SONiC 201904 Release Notes.md b/doc/SONiC 201904 Release Notes.md index c501473079..49516ebbe0 100644 --- a/doc/SONiC 201904 Release Notes.md +++ b/doc/SONiC 201904 Release Notes.md @@ -29,7 +29,7 @@ https://github.com/sonic-net/sonic-buildimage/tree/201904 | 3 | Upgrade docker engine to 18.09 | | | 4 | [Everflow enhancement](https://github.com/sonic-net/SONiC/blob/bb4f4a3a85935a38ec7f9625ef62cbe58c0998b4/doc/SONiC_EVERFLOW_IPv6.pdf) | | | 5 | [Egress ACL bug fix and ACL CLI enhancement](https://github.com/sonic-net/SONiC/blob/dfa7e58292deb4d7b10d1e0ca73f296cd206e9d2/doc/acl/egress-acl-bug-fix-description.md) | | -| 6 | [L3 RIF counter support](https://github.com/Azure/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/sonic-net/SONiC/pull/310) | | +| 6 | [L3 RIF counter support](https://github.com/sonic-net/SONiC/blob/master/doc/RIF_counters.md) [PR](https://github.com/sonic-net/SONiC/pull/310) | | | 7 | [PMon Refactoring](https://github.com/sonic-net/SONiC/tree/master/doc/pmon) | | | 8 | BGP-EVPN support (type 5) (related HLD [Fpmsyncd](https://github.com/sonic-net/SONiC/pull/375), [vxlanmgr](https://github.com/sonic-net/SONiC/pull/369), [template](https://github.com/sonic-net/sonic-buildimage/pull/2838/files) ) | | diff --git a/doc/SONiC_202106_Release_Notes.md b/doc/SONiC_202106_Release_Notes.md index 8b61892aed..895cb1f2cd 100644 --- a/doc/SONiC_202106_Release_Notes.md +++ b/doc/SONiC_202106_Release_Notes.md @@ -50,8 +50,8 @@ Image : https://sonic-jenkins.westus2.cloudapp.azure.com/ (Example - Image for #### 1. Telemetry for Multi-ASIC This feature is an enhancement on sonic_db_config package for multi-asic to read different namespace redis configuration. And enhanced V2R Lookup for multi-asic, enhanced gNMI Server to initiate redis connection, enhanced gNMI Server Get and enhanced the parsing of target in gNMI Request.
    -
    Refer [HLD document](https://github.com/Azure/sonic-telemetry/pull/77) and below mentioned PR's for more details. -
    **Pull Requests** : [77](https://github.com/Azure/sonic-telemetry/pull/77) +
    Refer [HLD document](https://github.com/sonic-net/sonic-telemetry/pull/77) and below mentioned PR's for more details. +
    **Pull Requests** : [77](https://github.com/sonic-net/sonic-telemetry/pull/77) #### 2. Add FRR running configuration to tech support @@ -69,7 +69,7 @@ Refer [HLD document](https://github.com/sonic-net/sonic-utilities/pull/1249) and #### 3. App extension with warmboot awareness SONiC Application Extension Infrastructure is a SONiC infrastructure and framework for managing SONiC Application Packages which in this scope are SONiC compatible Docker images distributed individually from one another and from the base SONiC image. -
    Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +
    Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details.
    **Pull Requests** : [682](https://github.com/sonic-net/SONiC/pull/682), [6398](https://github.com/sonic-net/sonic-buildimage/issues/6398) #### 4. Enable/Disable auto negotiation and speed setting with number of lanes diff --git a/doc/SONiC_202111_Release_Notes.md b/doc/SONiC_202111_Release_Notes.md index 48f5e05964..dcf90c339b 100644 --- a/doc/SONiC_202111_Release_Notes.md +++ b/doc/SONiC_202111_Release_Notes.md @@ -58,7 +58,7 @@ Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/acl/ACL- #### App extension CLI generation tool The SONiC CLI Auto-generation tool - is a utility for generating the command-line interface for third-party features, called application extensions, that provide their functionality as separate docker containers. The YANG model will be used to describe the CONFIG DB schema and CLI will be generated according to CONFIG DB schema. The YANG model will serve as an input parameter for the SONiC Auto-generation utility. The CLI should be a part of SONiC utilities and support - show, config operations. -Refer [HLD document](https://github.com/Azure/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details. +Refer [HLD document](https://github.com/sonic-net/SONiC/blob/master/doc/sonic-application-extention/sonic-application-extention-hld.md) and below mentioned PR's for more details.
    **Pull Requests** : [780](https://github.com/sonic-net/SONiC/pull/780), [1644](https://github.com/sonic-net/sonic-utilities/pull/1644) & [1650](https://github.com/sonic-net/sonic-utilities/pull/1650) #### Automatic techsupport and core dump creation diff --git a/doc/Sonic BSL Test plan.md b/doc/Sonic BSL Test plan.md index 1cfc989e67..b8910c8f9a 100644 --- a/doc/Sonic BSL Test plan.md +++ b/doc/Sonic BSL Test plan.md @@ -38,7 +38,7 @@ Verify basic sanity. This checks if the orchagent and syncd processes are runnin Triggered before and after each test case #### Test description -Run sanity check - https://github.com/Azure/sonic-mgmt/blob/master/tests/common/sanity_check.py +Run sanity check - https://github.com/sonic-net/sonic-mgmt/blob/master/tests/common/sanity_check.py ### Test case \#2 diff --git a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md index fd864d9260..926d06725d 100644 --- a/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md +++ b/doc/config-generic-update-rollback/Json_Patch_Ordering_using_YANG_Models_Design.md @@ -405,7 +405,7 @@ Some fields are not allowed to be modified and can only be created, such as `/PO SAI_PORT_ATTR_HW_LANE_LIST, ``` -The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): +The new extension `create-only` will be added to [YANG models SONiC extensions](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-extension.yang): ``` extension create-only { description "During apply-patch operation the field can only be created (i.e. added) or re-created (i.e. removed then added) but cannot be modified (i.e. replaced)."; diff --git a/doc/copp/CoPP Config and Management.md b/doc/copp/CoPP Config and Management.md index 4ea0c6d197..82f9e5d13c 100644 --- a/doc/copp/CoPP Config and Management.md +++ b/doc/copp/CoPP Config and Management.md @@ -15,7 +15,7 @@ The following are the high level requirements for CoPP/TRAP managment ## Current behaviour -During SWSS start, the prebuilt [copp.json](https://github.com/Azure/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/sonic-net/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/sonic-net/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. +During SWSS start, the prebuilt [copp.json](https://github.com/sonic-net/sonic-swss/blob/201911/swssconfig/sample/00-copp.config.json) file is loaded as part of start script [swssconfig.sh](https://github.com/sonic-net/sonic-buildimage/blob/201911/dockers/docker-orchagent/swssconfig.sh) and written to APP DB. [CoppOrch](https://github.com/sonic-net/sonic-swss/blob/201911/orchagent/copporch.cpp) then translates it to Host trap/policer tables and programmed to SAI. ## Proposed behaviour @@ -63,7 +63,7 @@ state = "ok" ``` ### coppmgr -Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/Azure/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. +Introduce a *new* CoPP manager, that subscribes for the Config DB CoPP Tables and Feature Tables. Based on the feature enablement, ```coppmgr``` handles the logic to resolve whether a CoPP table shall be written to APP DB for orchagent consumption. Inorder to reduce changes to copporch and for backward compatibility during warmboot, ```coppmgr``` shall use the existing APP_DB schema and implement internal logic to convert the proposed ConfigDB entries to APP DB entries. Similar to existing swss managers, an entry with state "ok" shall be added to STATE_DB. `coppmgrd` must be started by [supervisord.conf](https://github.com/sonic-net/sonic-buildimage/blob/master/dockers/docker-orchagent/supervisord.conf) first, before any other process is started in swss. During init, ```coppmgr``` shall read the ```copp_cfg.json``` file and apply the default configuration. The default shall not be part of Config_DB entries. ```coppmgr``` shall also read from the config_db during init and apply the logic to merge if there are same entries within the ```copp_cfg.json``` file. Trap name added to copp_cfg.json file has to match a feature name exist in FEATURE table in Config DB. In order to handle traps which has no associated feature (such as arp, ip2me), a new field called "always_enabled" will be added to COPP_TRAP table in Config DB. diff --git a/doc/passw_hardening/sonic-passwh.yang b/doc/passw_hardening/sonic-passwh.yang index 120c98c51a..be1141b52f 100644 --- a/doc/passw_hardening/sonic-passwh.yang +++ b/doc/passw_hardening/sonic-passwh.yang @@ -1,6 +1,6 @@ module sonic-passwh { yang-version 1.1; - namespace "http://github.com/Azure/sonic-passwh"; + namespace "http://github.com/sonic-net/sonic-passwh"; prefix password; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md index 01922c48dc..7cd2a02456 100644 --- a/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md +++ b/doc/pfc_asym/PFC_Asymmetric_Test_HLD.md @@ -22,7 +22,7 @@ The purpose is to test functionality of Asymmetric PFC on the SONIC based DUT, closely resembling production environment. ### Scope -The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. +The test is targeting a running SONIC system with fully functioning configuration. The purpose of the test is to perform functional testing of Asymmetric PFC on SONIC system. There will be reused existed PTF test suite for PFC Asymmetric which is located at https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py. ### Testbed The test will run on the following testbeds: @@ -39,20 +39,20 @@ There is already existed PFC asymmetric test cases which use PTF to send traffic Test suite location -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py It requires several updates: 1. Packets sending speed can be increased by using multiprocessing instead of multithreading library. -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L83 Replace ```threading.Thread``` to use ```multiprocessing.Process``` instead. 2. Looks like there is a redundancy in generating configuration file for ARP responder. -https://github.com/Azure/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 +https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/roles/test/files/saitests/pfc_asym.py#L56 Fix the loop to store file only once diff --git a/doc/pmon/sonic_thermal_control_test_plan.md b/doc/pmon/sonic_thermal_control_test_plan.md index 66c0d5be50..feb974fff0 100644 --- a/doc/pmon/sonic_thermal_control_test_plan.md +++ b/doc/pmon/sonic_thermal_control_test_plan.md @@ -38,7 +38,7 @@ Since this feature is not related to traffic and network topology, all current t ### Ansible and Pytest -This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/Azure/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/Azure/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. +This test plan is based on platform test infrastructure as additional cases. The test will reuse current [platform test](https://github.com/sonic-net/SONiC-mgmt/tree/master/tests/platform) in SONiC-mgmt. New pytest test cases will be added to [test_platform_info.py](https://github.com/sonic-net/SONiC-mgmt/blob/master/tests/platform/test_platform_info.py). In addition, valid_policy.json, invalid_format_policy.json and invalid_value_policy.json will be added as thermal policy configuration file for test purpose. #### Valid policy file diff --git a/doc/port-config-refactor/port-config-refactor-design.md b/doc/port-config-refactor/port-config-refactor-design.md index da99e51f2e..6dba5baece 100644 --- a/doc/port-config-refactor/port-config-refactor-design.md +++ b/doc/port-config-refactor/port-config-refactor-design.md @@ -20,7 +20,7 @@ There are also open PRs to begin transitioning from the "port_config.ini" file t ## 3. Files that contain "port_config.ini" related logic -1. [daemon_base.py](https://github.com/Azure/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/Azure/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). +1. [daemon_base.py](https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-daemon-base/sonic_daemon_base/daemon_base.py) in [sonic-daemon-base](https://github.com/sonic-net/sonic-buildimage/tree/master/src/sonic-daemon-base) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). 2. [sfputilbase.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilbase.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Currently sfptutilbase.py keeps 3 dictionaries and 1 list to store information gets from port_config.ini file. We will keep the current data structure of sfputilbase.py to avoid introduce too much changes which means that we need transform the output of portconfig.py to the existing data structure. 3. [sfputilhelper.py](https://github.com/sonic-net/sonic-platform-common/blob/master/sonic_platform_base/sonic_sfp/sfputilhelper.py) in [sonic-platform-common](https://github.com/sonic-net/sonic-platform-common) contains logic to parse "port_config.ini", it should be replaced by [portconfig.get_port_config](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L20). Since the current logic in sfputilhelper.py and sfputilbase.py are very similar, it is suggested to put the logic in a common place and reuse it. 4. [main.py](https://github.com/sonic-net/sonic-utilities/blob/master/sfputil/main.py) in [sonic-utilities](https://github.com/sonic-net/sonic-utilities) contains logic to get file path of "port_config.ini", it should be replaced by [portconfig.get_port_config_file_name](https://github.com/sonic-net/sonic-buildimage/blob/142d45ce98008aac6437070a3a941083494b52a8/src/sonic-config-engine/portconfig.py#L6). diff --git a/sonic-acl.yang b/sonic-acl.yang index 4081d1d8ad..084efd7b95 100644 --- a/sonic-acl.yang +++ b/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/Azure/sonic-acl"; + namespace "http://github.com/sonic-net/sonic-acl"; prefix sacl; yang-version 1.1; From b4bcc50dbefe051b10618891dd40e252ca18fd14 Mon Sep 17 00:00:00 2001 From: maipbui Date: Mon, 12 Sep 2022 20:50:56 +0000 Subject: [PATCH 17/18] No fix namespace Signed-off-by: maipbui --- doc/barefoot_dtel/Dtel-test-plan.md | 2 +- doc/passw_hardening/sonic-passwh.yang | 2 +- sonic-acl.yang | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/barefoot_dtel/Dtel-test-plan.md b/doc/barefoot_dtel/Dtel-test-plan.md index 88ced99d7e..ffb89c30d0 100644 --- a/doc/barefoot_dtel/Dtel-test-plan.md +++ b/doc/barefoot_dtel/Dtel-test-plan.md @@ -53,7 +53,7 @@ As an example, setting/getting DSCP attribute for a DTel event object is done us ## Testbed DTel tests will run on __ptf32__ topology described in: -[SONiC test topologies](https://github.com/Azure/sonic-mgmt/blob/master/ansible/doc/README.testbed.Topology.md) +[SONiC test topologies](https://github.com/sonic-net/sonic-mgmt/blob/master/ansible/doc/README.testbed.Topology.md) diff --git a/doc/passw_hardening/sonic-passwh.yang b/doc/passw_hardening/sonic-passwh.yang index be1141b52f..120c98c51a 100644 --- a/doc/passw_hardening/sonic-passwh.yang +++ b/doc/passw_hardening/sonic-passwh.yang @@ -1,6 +1,6 @@ module sonic-passwh { yang-version 1.1; - namespace "http://github.com/sonic-net/sonic-passwh"; + namespace "http://github.com/Azure/sonic-passwh"; prefix password; description "PASSWORD HARDENING YANG Module for SONiC OS"; diff --git a/sonic-acl.yang b/sonic-acl.yang index 084efd7b95..4081d1d8ad 100644 --- a/sonic-acl.yang +++ b/sonic-acl.yang @@ -1,5 +1,5 @@ module sonic-acl { - namespace "http://github.com/sonic-net/sonic-acl"; + namespace "http://github.com/Azure/sonic-acl"; prefix sacl; yang-version 1.1; From 4b84c3286bcd2b48e41d4e6371f696bf58371016 Mon Sep 17 00:00:00 2001 From: kannankvs Date: Wed, 14 Sep 2022 10:18:46 +0530 Subject: [PATCH 18/18] Updated the Supported Devices and Platform for Intel (#1083) Updated the Supported Devices and Platform for Intel as asic vendor and its images --- Supported-Devices-and-Platforms.html | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Supported-Devices-and-Platforms.html b/Supported-Devices-and-Platforms.html index 55a3fcaa63..5d8ccfee8a 100644 --- a/Supported-Devices-and-Platforms.html +++ b/Supported-Devices-and-Platforms.html @@ -1169,10 +1169,12 @@