raft_test.go 126 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272
  1. // Copyright 2015 The etcd Authors
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. package raft
  15. import (
  16. "bytes"
  17. "fmt"
  18. "math"
  19. "math/rand"
  20. "reflect"
  21. "strings"
  22. "testing"
  23. pb "go.etcd.io/etcd/raft/raftpb"
  24. "go.etcd.io/etcd/raft/tracker"
  25. )
  26. // nextEnts returns the appliable entries and updates the applied index
  27. func nextEnts(r *raft, s *MemoryStorage) (ents []pb.Entry) {
  28. // Transfer all unstable entries to "stable" storage.
  29. s.Append(r.raftLog.unstableEntries())
  30. r.raftLog.stableTo(r.raftLog.lastIndex(), r.raftLog.lastTerm())
  31. ents = r.raftLog.nextEnts()
  32. r.raftLog.appliedTo(r.raftLog.committed)
  33. return ents
  34. }
  35. func mustAppendEntry(r *raft, ents ...pb.Entry) {
  36. if !r.appendEntry(ents...) {
  37. panic("entry unexpectedly dropped")
  38. }
  39. }
  40. type stateMachine interface {
  41. Step(m pb.Message) error
  42. readMessages() []pb.Message
  43. }
  44. func (r *raft) readMessages() []pb.Message {
  45. msgs := r.msgs
  46. r.msgs = make([]pb.Message, 0)
  47. return msgs
  48. }
  49. func TestProgressLeader(t *testing.T) {
  50. r := newTestRaft(1, []uint64{1, 2}, 5, 1, NewMemoryStorage())
  51. r.becomeCandidate()
  52. r.becomeLeader()
  53. r.prs.Progress[2].BecomeReplicate()
  54. // Send proposals to r1. The first 5 entries should be appended to the log.
  55. propMsg := pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("foo")}}}
  56. for i := 0; i < 5; i++ {
  57. if pr := r.prs.Progress[r.id]; pr.State != tracker.StateReplicate || pr.Match != uint64(i+1) || pr.Next != pr.Match+1 {
  58. t.Errorf("unexpected progress %v", pr)
  59. }
  60. if err := r.Step(propMsg); err != nil {
  61. t.Fatalf("proposal resulted in error: %v", err)
  62. }
  63. }
  64. }
  65. // TestProgressResumeByHeartbeatResp ensures raft.heartbeat reset progress.paused by heartbeat response.
  66. func TestProgressResumeByHeartbeatResp(t *testing.T) {
  67. r := newTestRaft(1, []uint64{1, 2}, 5, 1, NewMemoryStorage())
  68. r.becomeCandidate()
  69. r.becomeLeader()
  70. r.prs.Progress[2].ProbeSent = true
  71. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  72. if !r.prs.Progress[2].ProbeSent {
  73. t.Errorf("paused = %v, want true", r.prs.Progress[2].ProbeSent)
  74. }
  75. r.prs.Progress[2].BecomeReplicate()
  76. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgHeartbeatResp})
  77. if r.prs.Progress[2].ProbeSent {
  78. t.Errorf("paused = %v, want false", r.prs.Progress[2].ProbeSent)
  79. }
  80. }
  81. func TestProgressPaused(t *testing.T) {
  82. r := newTestRaft(1, []uint64{1, 2}, 5, 1, NewMemoryStorage())
  83. r.becomeCandidate()
  84. r.becomeLeader()
  85. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  86. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  87. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  88. ms := r.readMessages()
  89. if len(ms) != 1 {
  90. t.Errorf("len(ms) = %d, want 1", len(ms))
  91. }
  92. }
  93. func TestProgressFlowControl(t *testing.T) {
  94. cfg := newTestConfig(1, []uint64{1, 2}, 5, 1, NewMemoryStorage())
  95. cfg.MaxInflightMsgs = 3
  96. cfg.MaxSizePerMsg = 2048
  97. r := newRaft(cfg)
  98. r.becomeCandidate()
  99. r.becomeLeader()
  100. // Throw away all the messages relating to the initial election.
  101. r.readMessages()
  102. // While node 2 is in probe state, propose a bunch of entries.
  103. r.prs.Progress[2].BecomeProbe()
  104. blob := []byte(strings.Repeat("a", 1000))
  105. for i := 0; i < 10; i++ {
  106. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: blob}}})
  107. }
  108. ms := r.readMessages()
  109. // First append has two entries: the empty entry to confirm the
  110. // election, and the first proposal (only one proposal gets sent
  111. // because we're in probe state).
  112. if len(ms) != 1 || ms[0].Type != pb.MsgApp {
  113. t.Fatalf("expected 1 MsgApp, got %v", ms)
  114. }
  115. if len(ms[0].Entries) != 2 {
  116. t.Fatalf("expected 2 entries, got %d", len(ms[0].Entries))
  117. }
  118. if len(ms[0].Entries[0].Data) != 0 || len(ms[0].Entries[1].Data) != 1000 {
  119. t.Fatalf("unexpected entry sizes: %v", ms[0].Entries)
  120. }
  121. // When this append is acked, we change to replicate state and can
  122. // send multiple messages at once.
  123. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgAppResp, Index: ms[0].Entries[1].Index})
  124. ms = r.readMessages()
  125. if len(ms) != 3 {
  126. t.Fatalf("expected 3 messages, got %d", len(ms))
  127. }
  128. for i, m := range ms {
  129. if m.Type != pb.MsgApp {
  130. t.Errorf("%d: expected MsgApp, got %s", i, m.Type)
  131. }
  132. if len(m.Entries) != 2 {
  133. t.Errorf("%d: expected 2 entries, got %d", i, len(m.Entries))
  134. }
  135. }
  136. // Ack all three of those messages together and get the last two
  137. // messages (containing three entries).
  138. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgAppResp, Index: ms[2].Entries[1].Index})
  139. ms = r.readMessages()
  140. if len(ms) != 2 {
  141. t.Fatalf("expected 2 messages, got %d", len(ms))
  142. }
  143. for i, m := range ms {
  144. if m.Type != pb.MsgApp {
  145. t.Errorf("%d: expected MsgApp, got %s", i, m.Type)
  146. }
  147. }
  148. if len(ms[0].Entries) != 2 {
  149. t.Errorf("%d: expected 2 entries, got %d", 0, len(ms[0].Entries))
  150. }
  151. if len(ms[1].Entries) != 1 {
  152. t.Errorf("%d: expected 1 entry, got %d", 1, len(ms[1].Entries))
  153. }
  154. }
  155. func TestUncommittedEntryLimit(t *testing.T) {
  156. // Use a relatively large number of entries here to prevent regression of a
  157. // bug which computed the size before it was fixed. This test would fail
  158. // with the bug, either because we'd get dropped proposals earlier than we
  159. // expect them, or because the final tally ends up nonzero. (At the time of
  160. // writing, the former).
  161. const maxEntries = 1024
  162. testEntry := pb.Entry{Data: []byte("testdata")}
  163. maxEntrySize := maxEntries * PayloadSize(testEntry)
  164. cfg := newTestConfig(1, []uint64{1, 2, 3}, 5, 1, NewMemoryStorage())
  165. cfg.MaxUncommittedEntriesSize = uint64(maxEntrySize)
  166. cfg.MaxInflightMsgs = 2 * 1024 // avoid interference
  167. r := newRaft(cfg)
  168. r.becomeCandidate()
  169. r.becomeLeader()
  170. if n := r.uncommittedSize; n != 0 {
  171. t.Fatalf("expected zero uncommitted size, got %d bytes", n)
  172. }
  173. // Set the two followers to the replicate state. Commit to tail of log.
  174. const numFollowers = 2
  175. r.prs.Progress[2].BecomeReplicate()
  176. r.prs.Progress[3].BecomeReplicate()
  177. r.uncommittedSize = 0
  178. // Send proposals to r1. The first 5 entries should be appended to the log.
  179. propMsg := pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{testEntry}}
  180. propEnts := make([]pb.Entry, maxEntries)
  181. for i := 0; i < maxEntries; i++ {
  182. if err := r.Step(propMsg); err != nil {
  183. t.Fatalf("proposal resulted in error: %v", err)
  184. }
  185. propEnts[i] = testEntry
  186. }
  187. // Send one more proposal to r1. It should be rejected.
  188. if err := r.Step(propMsg); err != ErrProposalDropped {
  189. t.Fatalf("proposal not dropped: %v", err)
  190. }
  191. // Read messages and reduce the uncommitted size as if we had committed
  192. // these entries.
  193. ms := r.readMessages()
  194. if e := maxEntries * numFollowers; len(ms) != e {
  195. t.Fatalf("expected %d messages, got %d", e, len(ms))
  196. }
  197. r.reduceUncommittedSize(propEnts)
  198. if r.uncommittedSize != 0 {
  199. t.Fatalf("committed everything, but still tracking %d", r.uncommittedSize)
  200. }
  201. // Send a single large proposal to r1. Should be accepted even though it
  202. // pushes us above the limit because we were beneath it before the proposal.
  203. propEnts = make([]pb.Entry, 2*maxEntries)
  204. for i := range propEnts {
  205. propEnts[i] = testEntry
  206. }
  207. propMsgLarge := pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: propEnts}
  208. if err := r.Step(propMsgLarge); err != nil {
  209. t.Fatalf("proposal resulted in error: %v", err)
  210. }
  211. // Send one more proposal to r1. It should be rejected, again.
  212. if err := r.Step(propMsg); err != ErrProposalDropped {
  213. t.Fatalf("proposal not dropped: %v", err)
  214. }
  215. // Read messages and reduce the uncommitted size as if we had committed
  216. // these entries.
  217. ms = r.readMessages()
  218. if e := 1 * numFollowers; len(ms) != e {
  219. t.Fatalf("expected %d messages, got %d", e, len(ms))
  220. }
  221. r.reduceUncommittedSize(propEnts)
  222. if n := r.uncommittedSize; n != 0 {
  223. t.Fatalf("expected zero uncommitted size, got %d", n)
  224. }
  225. }
  226. func TestLeaderElection(t *testing.T) {
  227. testLeaderElection(t, false)
  228. }
  229. func TestLeaderElectionPreVote(t *testing.T) {
  230. testLeaderElection(t, true)
  231. }
  232. func testLeaderElection(t *testing.T, preVote bool) {
  233. var cfg func(*Config)
  234. candState := StateCandidate
  235. candTerm := uint64(1)
  236. if preVote {
  237. cfg = preVoteConfig
  238. // In pre-vote mode, an election that fails to complete
  239. // leaves the node in pre-candidate state without advancing
  240. // the term.
  241. candState = StatePreCandidate
  242. candTerm = 0
  243. }
  244. tests := []struct {
  245. *network
  246. state StateType
  247. expTerm uint64
  248. }{
  249. {newNetworkWithConfig(cfg, nil, nil, nil), StateLeader, 1},
  250. {newNetworkWithConfig(cfg, nil, nil, nopStepper), StateLeader, 1},
  251. {newNetworkWithConfig(cfg, nil, nopStepper, nopStepper), candState, candTerm},
  252. {newNetworkWithConfig(cfg, nil, nopStepper, nopStepper, nil), candState, candTerm},
  253. {newNetworkWithConfig(cfg, nil, nopStepper, nopStepper, nil, nil), StateLeader, 1},
  254. // three logs further along than 0, but in the same term so rejections
  255. // are returned instead of the votes being ignored.
  256. {newNetworkWithConfig(cfg,
  257. nil, entsWithConfig(cfg, 1), entsWithConfig(cfg, 1), entsWithConfig(cfg, 1, 1), nil),
  258. StateFollower, 1},
  259. }
  260. for i, tt := range tests {
  261. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  262. sm := tt.network.peers[1].(*raft)
  263. if sm.state != tt.state {
  264. t.Errorf("#%d: state = %s, want %s", i, sm.state, tt.state)
  265. }
  266. if g := sm.Term; g != tt.expTerm {
  267. t.Errorf("#%d: term = %d, want %d", i, g, tt.expTerm)
  268. }
  269. }
  270. }
  271. // TestLearnerElectionTimeout verfies that the leader should not start election even
  272. // when times out.
  273. func TestLearnerElectionTimeout(t *testing.T) {
  274. n1 := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  275. n2 := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  276. n1.becomeFollower(1, None)
  277. n2.becomeFollower(1, None)
  278. // n2 is learner. Learner should not start election even when times out.
  279. setRandomizedElectionTimeout(n2, n2.electionTimeout)
  280. for i := 0; i < n2.electionTimeout; i++ {
  281. n2.tick()
  282. }
  283. if n2.state != StateFollower {
  284. t.Errorf("peer 2 state: %s, want %s", n2.state, StateFollower)
  285. }
  286. }
  287. // TestLearnerPromotion verifies that the learner should not election until
  288. // it is promoted to a normal peer.
  289. func TestLearnerPromotion(t *testing.T) {
  290. n1 := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  291. n2 := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  292. n1.becomeFollower(1, None)
  293. n2.becomeFollower(1, None)
  294. nt := newNetwork(n1, n2)
  295. if n1.state == StateLeader {
  296. t.Error("peer 1 state is leader, want not", n1.state)
  297. }
  298. // n1 should become leader
  299. setRandomizedElectionTimeout(n1, n1.electionTimeout)
  300. for i := 0; i < n1.electionTimeout; i++ {
  301. n1.tick()
  302. }
  303. if n1.state != StateLeader {
  304. t.Errorf("peer 1 state: %s, want %s", n1.state, StateLeader)
  305. }
  306. if n2.state != StateFollower {
  307. t.Errorf("peer 2 state: %s, want %s", n2.state, StateFollower)
  308. }
  309. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  310. n1.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddNode})
  311. n2.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddNode})
  312. if n2.isLearner {
  313. t.Error("peer 2 is learner, want not")
  314. }
  315. // n2 start election, should become leader
  316. setRandomizedElectionTimeout(n2, n2.electionTimeout)
  317. for i := 0; i < n2.electionTimeout; i++ {
  318. n2.tick()
  319. }
  320. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgBeat})
  321. if n1.state != StateFollower {
  322. t.Errorf("peer 1 state: %s, want %s", n1.state, StateFollower)
  323. }
  324. if n2.state != StateLeader {
  325. t.Errorf("peer 2 state: %s, want %s", n2.state, StateLeader)
  326. }
  327. }
  328. // TestLearnerCannotVote checks that a learner can't vote even it receives a valid Vote request.
  329. func TestLearnerCannotVote(t *testing.T) {
  330. n2 := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  331. n2.becomeFollower(1, None)
  332. n2.Step(pb.Message{From: 1, To: 2, Term: 2, Type: pb.MsgVote, LogTerm: 11, Index: 11})
  333. if len(n2.msgs) != 0 {
  334. t.Errorf("expect learner not to vote, but received %v messages", n2.msgs)
  335. }
  336. }
  337. func TestLeaderCycle(t *testing.T) {
  338. testLeaderCycle(t, false)
  339. }
  340. func TestLeaderCyclePreVote(t *testing.T) {
  341. testLeaderCycle(t, true)
  342. }
  343. // testLeaderCycle verifies that each node in a cluster can campaign
  344. // and be elected in turn. This ensures that elections (including
  345. // pre-vote) work when not starting from a clean slate (as they do in
  346. // TestLeaderElection)
  347. func testLeaderCycle(t *testing.T, preVote bool) {
  348. var cfg func(*Config)
  349. if preVote {
  350. cfg = preVoteConfig
  351. }
  352. n := newNetworkWithConfig(cfg, nil, nil, nil)
  353. for campaignerID := uint64(1); campaignerID <= 3; campaignerID++ {
  354. n.send(pb.Message{From: campaignerID, To: campaignerID, Type: pb.MsgHup})
  355. for _, peer := range n.peers {
  356. sm := peer.(*raft)
  357. if sm.id == campaignerID && sm.state != StateLeader {
  358. t.Errorf("preVote=%v: campaigning node %d state = %v, want StateLeader",
  359. preVote, sm.id, sm.state)
  360. } else if sm.id != campaignerID && sm.state != StateFollower {
  361. t.Errorf("preVote=%v: after campaign of node %d, "+
  362. "node %d had state = %v, want StateFollower",
  363. preVote, campaignerID, sm.id, sm.state)
  364. }
  365. }
  366. }
  367. }
  368. // TestLeaderElectionOverwriteNewerLogs tests a scenario in which a
  369. // newly-elected leader does *not* have the newest (i.e. highest term)
  370. // log entries, and must overwrite higher-term log entries with
  371. // lower-term ones.
  372. func TestLeaderElectionOverwriteNewerLogs(t *testing.T) {
  373. testLeaderElectionOverwriteNewerLogs(t, false)
  374. }
  375. func TestLeaderElectionOverwriteNewerLogsPreVote(t *testing.T) {
  376. testLeaderElectionOverwriteNewerLogs(t, true)
  377. }
  378. func testLeaderElectionOverwriteNewerLogs(t *testing.T, preVote bool) {
  379. var cfg func(*Config)
  380. if preVote {
  381. cfg = preVoteConfig
  382. }
  383. // This network represents the results of the following sequence of
  384. // events:
  385. // - Node 1 won the election in term 1.
  386. // - Node 1 replicated a log entry to node 2 but died before sending
  387. // it to other nodes.
  388. // - Node 3 won the second election in term 2.
  389. // - Node 3 wrote an entry to its logs but died without sending it
  390. // to any other nodes.
  391. //
  392. // At this point, nodes 1, 2, and 3 all have uncommitted entries in
  393. // their logs and could win an election at term 3. The winner's log
  394. // entry overwrites the losers'. (TestLeaderSyncFollowerLog tests
  395. // the case where older log entries are overwritten, so this test
  396. // focuses on the case where the newer entries are lost).
  397. n := newNetworkWithConfig(cfg,
  398. entsWithConfig(cfg, 1), // Node 1: Won first election
  399. entsWithConfig(cfg, 1), // Node 2: Got logs from node 1
  400. entsWithConfig(cfg, 2), // Node 3: Won second election
  401. votedWithConfig(cfg, 3, 2), // Node 4: Voted but didn't get logs
  402. votedWithConfig(cfg, 3, 2)) // Node 5: Voted but didn't get logs
  403. // Node 1 campaigns. The election fails because a quorum of nodes
  404. // know about the election that already happened at term 2. Node 1's
  405. // term is pushed ahead to 2.
  406. n.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  407. sm1 := n.peers[1].(*raft)
  408. if sm1.state != StateFollower {
  409. t.Errorf("state = %s, want StateFollower", sm1.state)
  410. }
  411. if sm1.Term != 2 {
  412. t.Errorf("term = %d, want 2", sm1.Term)
  413. }
  414. // Node 1 campaigns again with a higher term. This time it succeeds.
  415. n.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  416. if sm1.state != StateLeader {
  417. t.Errorf("state = %s, want StateLeader", sm1.state)
  418. }
  419. if sm1.Term != 3 {
  420. t.Errorf("term = %d, want 3", sm1.Term)
  421. }
  422. // Now all nodes agree on a log entry with term 1 at index 1 (and
  423. // term 3 at index 2).
  424. for i := range n.peers {
  425. sm := n.peers[i].(*raft)
  426. entries := sm.raftLog.allEntries()
  427. if len(entries) != 2 {
  428. t.Fatalf("node %d: len(entries) == %d, want 2", i, len(entries))
  429. }
  430. if entries[0].Term != 1 {
  431. t.Errorf("node %d: term at index 1 == %d, want 1", i, entries[0].Term)
  432. }
  433. if entries[1].Term != 3 {
  434. t.Errorf("node %d: term at index 2 == %d, want 3", i, entries[1].Term)
  435. }
  436. }
  437. }
  438. func TestVoteFromAnyState(t *testing.T) {
  439. testVoteFromAnyState(t, pb.MsgVote)
  440. }
  441. func TestPreVoteFromAnyState(t *testing.T) {
  442. testVoteFromAnyState(t, pb.MsgPreVote)
  443. }
  444. func testVoteFromAnyState(t *testing.T, vt pb.MessageType) {
  445. for st := StateType(0); st < numStates; st++ {
  446. r := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  447. r.Term = 1
  448. switch st {
  449. case StateFollower:
  450. r.becomeFollower(r.Term, 3)
  451. case StatePreCandidate:
  452. r.becomePreCandidate()
  453. case StateCandidate:
  454. r.becomeCandidate()
  455. case StateLeader:
  456. r.becomeCandidate()
  457. r.becomeLeader()
  458. }
  459. // Note that setting our state above may have advanced r.Term
  460. // past its initial value.
  461. origTerm := r.Term
  462. newTerm := r.Term + 1
  463. msg := pb.Message{
  464. From: 2,
  465. To: 1,
  466. Type: vt,
  467. Term: newTerm,
  468. LogTerm: newTerm,
  469. Index: 42,
  470. }
  471. if err := r.Step(msg); err != nil {
  472. t.Errorf("%s,%s: Step failed: %s", vt, st, err)
  473. }
  474. if len(r.msgs) != 1 {
  475. t.Errorf("%s,%s: %d response messages, want 1: %+v", vt, st, len(r.msgs), r.msgs)
  476. } else {
  477. resp := r.msgs[0]
  478. if resp.Type != voteRespMsgType(vt) {
  479. t.Errorf("%s,%s: response message is %s, want %s",
  480. vt, st, resp.Type, voteRespMsgType(vt))
  481. }
  482. if resp.Reject {
  483. t.Errorf("%s,%s: unexpected rejection", vt, st)
  484. }
  485. }
  486. // If this was a real vote, we reset our state and term.
  487. if vt == pb.MsgVote {
  488. if r.state != StateFollower {
  489. t.Errorf("%s,%s: state %s, want %s", vt, st, r.state, StateFollower)
  490. }
  491. if r.Term != newTerm {
  492. t.Errorf("%s,%s: term %d, want %d", vt, st, r.Term, newTerm)
  493. }
  494. if r.Vote != 2 {
  495. t.Errorf("%s,%s: vote %d, want 2", vt, st, r.Vote)
  496. }
  497. } else {
  498. // In a prevote, nothing changes.
  499. if r.state != st {
  500. t.Errorf("%s,%s: state %s, want %s", vt, st, r.state, st)
  501. }
  502. if r.Term != origTerm {
  503. t.Errorf("%s,%s: term %d, want %d", vt, st, r.Term, origTerm)
  504. }
  505. // if st == StateFollower or StatePreCandidate, r hasn't voted yet.
  506. // In StateCandidate or StateLeader, it's voted for itself.
  507. if r.Vote != None && r.Vote != 1 {
  508. t.Errorf("%s,%s: vote %d, want %d or 1", vt, st, r.Vote, None)
  509. }
  510. }
  511. }
  512. }
  513. func TestLogReplication(t *testing.T) {
  514. tests := []struct {
  515. *network
  516. msgs []pb.Message
  517. wcommitted uint64
  518. }{
  519. {
  520. newNetwork(nil, nil, nil),
  521. []pb.Message{
  522. {From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  523. },
  524. 2,
  525. },
  526. {
  527. newNetwork(nil, nil, nil),
  528. []pb.Message{
  529. {From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  530. {From: 1, To: 2, Type: pb.MsgHup},
  531. {From: 1, To: 2, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}},
  532. },
  533. 4,
  534. },
  535. }
  536. for i, tt := range tests {
  537. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  538. for _, m := range tt.msgs {
  539. tt.send(m)
  540. }
  541. for j, x := range tt.network.peers {
  542. sm := x.(*raft)
  543. if sm.raftLog.committed != tt.wcommitted {
  544. t.Errorf("#%d.%d: committed = %d, want %d", i, j, sm.raftLog.committed, tt.wcommitted)
  545. }
  546. ents := []pb.Entry{}
  547. for _, e := range nextEnts(sm, tt.network.storage[j]) {
  548. if e.Data != nil {
  549. ents = append(ents, e)
  550. }
  551. }
  552. props := []pb.Message{}
  553. for _, m := range tt.msgs {
  554. if m.Type == pb.MsgProp {
  555. props = append(props, m)
  556. }
  557. }
  558. for k, m := range props {
  559. if !bytes.Equal(ents[k].Data, m.Entries[0].Data) {
  560. t.Errorf("#%d.%d: data = %d, want %d", i, j, ents[k].Data, m.Entries[0].Data)
  561. }
  562. }
  563. }
  564. }
  565. }
  566. // TestLearnerLogReplication tests that a learner can receive entries from the leader.
  567. func TestLearnerLogReplication(t *testing.T) {
  568. n1 := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  569. n2 := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  570. nt := newNetwork(n1, n2)
  571. n1.becomeFollower(1, None)
  572. n2.becomeFollower(1, None)
  573. setRandomizedElectionTimeout(n1, n1.electionTimeout)
  574. for i := 0; i < n1.electionTimeout; i++ {
  575. n1.tick()
  576. }
  577. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  578. // n1 is leader and n2 is learner
  579. if n1.state != StateLeader {
  580. t.Errorf("peer 1 state: %s, want %s", n1.state, StateLeader)
  581. }
  582. if !n2.isLearner {
  583. t.Error("peer 2 state: not learner, want yes")
  584. }
  585. nextCommitted := n1.raftLog.committed + 1
  586. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  587. if n1.raftLog.committed != nextCommitted {
  588. t.Errorf("peer 1 wants committed to %d, but still %d", nextCommitted, n1.raftLog.committed)
  589. }
  590. if n1.raftLog.committed != n2.raftLog.committed {
  591. t.Errorf("peer 2 wants committed to %d, but still %d", n1.raftLog.committed, n2.raftLog.committed)
  592. }
  593. match := n1.prs.Progress[2].Match
  594. if match != n2.raftLog.committed {
  595. t.Errorf("progress 2 of leader 1 wants match %d, but got %d", n2.raftLog.committed, match)
  596. }
  597. }
  598. func TestSingleNodeCommit(t *testing.T) {
  599. tt := newNetwork(nil)
  600. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  601. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  602. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  603. sm := tt.peers[1].(*raft)
  604. if sm.raftLog.committed != 3 {
  605. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 3)
  606. }
  607. }
  608. // TestCannotCommitWithoutNewTermEntry tests the entries cannot be committed
  609. // when leader changes, no new proposal comes in and ChangeTerm proposal is
  610. // filtered.
  611. func TestCannotCommitWithoutNewTermEntry(t *testing.T) {
  612. tt := newNetwork(nil, nil, nil, nil, nil)
  613. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  614. // 0 cannot reach 2,3,4
  615. tt.cut(1, 3)
  616. tt.cut(1, 4)
  617. tt.cut(1, 5)
  618. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  619. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  620. sm := tt.peers[1].(*raft)
  621. if sm.raftLog.committed != 1 {
  622. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  623. }
  624. // network recovery
  625. tt.recover()
  626. // avoid committing ChangeTerm proposal
  627. tt.ignore(pb.MsgApp)
  628. // elect 2 as the new leader with term 2
  629. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  630. // no log entries from previous term should be committed
  631. sm = tt.peers[2].(*raft)
  632. if sm.raftLog.committed != 1 {
  633. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  634. }
  635. tt.recover()
  636. // send heartbeat; reset wait
  637. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgBeat})
  638. // append an entry at current term
  639. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  640. // expect the committed to be advanced
  641. if sm.raftLog.committed != 5 {
  642. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 5)
  643. }
  644. }
  645. // TestCommitWithoutNewTermEntry tests the entries could be committed
  646. // when leader changes, no new proposal comes in.
  647. func TestCommitWithoutNewTermEntry(t *testing.T) {
  648. tt := newNetwork(nil, nil, nil, nil, nil)
  649. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  650. // 0 cannot reach 2,3,4
  651. tt.cut(1, 3)
  652. tt.cut(1, 4)
  653. tt.cut(1, 5)
  654. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  655. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  656. sm := tt.peers[1].(*raft)
  657. if sm.raftLog.committed != 1 {
  658. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 1)
  659. }
  660. // network recovery
  661. tt.recover()
  662. // elect 2 as the new leader with term 2
  663. // after append a ChangeTerm entry from the current term, all entries
  664. // should be committed
  665. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  666. if sm.raftLog.committed != 4 {
  667. t.Errorf("committed = %d, want %d", sm.raftLog.committed, 4)
  668. }
  669. }
  670. func TestDuelingCandidates(t *testing.T) {
  671. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  672. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  673. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  674. nt := newNetwork(a, b, c)
  675. nt.cut(1, 3)
  676. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  677. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  678. // 1 becomes leader since it receives votes from 1 and 2
  679. sm := nt.peers[1].(*raft)
  680. if sm.state != StateLeader {
  681. t.Errorf("state = %s, want %s", sm.state, StateLeader)
  682. }
  683. // 3 stays as candidate since it receives a vote from 3 and a rejection from 2
  684. sm = nt.peers[3].(*raft)
  685. if sm.state != StateCandidate {
  686. t.Errorf("state = %s, want %s", sm.state, StateCandidate)
  687. }
  688. nt.recover()
  689. // candidate 3 now increases its term and tries to vote again
  690. // we expect it to disrupt the leader 1 since it has a higher term
  691. // 3 will be follower again since both 1 and 2 rejects its vote request since 3 does not have a long enough log
  692. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  693. wlog := &raftLog{
  694. storage: &MemoryStorage{ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}}},
  695. committed: 1,
  696. unstable: unstable{offset: 2},
  697. }
  698. tests := []struct {
  699. sm *raft
  700. state StateType
  701. term uint64
  702. raftLog *raftLog
  703. }{
  704. {a, StateFollower, 2, wlog},
  705. {b, StateFollower, 2, wlog},
  706. {c, StateFollower, 2, newLog(NewMemoryStorage(), raftLogger)},
  707. }
  708. for i, tt := range tests {
  709. if g := tt.sm.state; g != tt.state {
  710. t.Errorf("#%d: state = %s, want %s", i, g, tt.state)
  711. }
  712. if g := tt.sm.Term; g != tt.term {
  713. t.Errorf("#%d: term = %d, want %d", i, g, tt.term)
  714. }
  715. base := ltoa(tt.raftLog)
  716. if sm, ok := nt.peers[1+uint64(i)].(*raft); ok {
  717. l := ltoa(sm.raftLog)
  718. if g := diffu(base, l); g != "" {
  719. t.Errorf("#%d: diff:\n%s", i, g)
  720. }
  721. } else {
  722. t.Logf("#%d: empty log", i)
  723. }
  724. }
  725. }
  726. func TestDuelingPreCandidates(t *testing.T) {
  727. cfgA := newTestConfig(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  728. cfgB := newTestConfig(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  729. cfgC := newTestConfig(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  730. cfgA.PreVote = true
  731. cfgB.PreVote = true
  732. cfgC.PreVote = true
  733. a := newRaft(cfgA)
  734. b := newRaft(cfgB)
  735. c := newRaft(cfgC)
  736. nt := newNetwork(a, b, c)
  737. nt.cut(1, 3)
  738. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  739. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  740. // 1 becomes leader since it receives votes from 1 and 2
  741. sm := nt.peers[1].(*raft)
  742. if sm.state != StateLeader {
  743. t.Errorf("state = %s, want %s", sm.state, StateLeader)
  744. }
  745. // 3 campaigns then reverts to follower when its PreVote is rejected
  746. sm = nt.peers[3].(*raft)
  747. if sm.state != StateFollower {
  748. t.Errorf("state = %s, want %s", sm.state, StateFollower)
  749. }
  750. nt.recover()
  751. // Candidate 3 now increases its term and tries to vote again.
  752. // With PreVote, it does not disrupt the leader.
  753. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  754. wlog := &raftLog{
  755. storage: &MemoryStorage{ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}}},
  756. committed: 1,
  757. unstable: unstable{offset: 2},
  758. }
  759. tests := []struct {
  760. sm *raft
  761. state StateType
  762. term uint64
  763. raftLog *raftLog
  764. }{
  765. {a, StateLeader, 1, wlog},
  766. {b, StateFollower, 1, wlog},
  767. {c, StateFollower, 1, newLog(NewMemoryStorage(), raftLogger)},
  768. }
  769. for i, tt := range tests {
  770. if g := tt.sm.state; g != tt.state {
  771. t.Errorf("#%d: state = %s, want %s", i, g, tt.state)
  772. }
  773. if g := tt.sm.Term; g != tt.term {
  774. t.Errorf("#%d: term = %d, want %d", i, g, tt.term)
  775. }
  776. base := ltoa(tt.raftLog)
  777. if sm, ok := nt.peers[1+uint64(i)].(*raft); ok {
  778. l := ltoa(sm.raftLog)
  779. if g := diffu(base, l); g != "" {
  780. t.Errorf("#%d: diff:\n%s", i, g)
  781. }
  782. } else {
  783. t.Logf("#%d: empty log", i)
  784. }
  785. }
  786. }
  787. func TestCandidateConcede(t *testing.T) {
  788. tt := newNetwork(nil, nil, nil)
  789. tt.isolate(1)
  790. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  791. tt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  792. // heal the partition
  793. tt.recover()
  794. // send heartbeat; reset wait
  795. tt.send(pb.Message{From: 3, To: 3, Type: pb.MsgBeat})
  796. data := []byte("force follower")
  797. // send a proposal to 3 to flush out a MsgApp to 1
  798. tt.send(pb.Message{From: 3, To: 3, Type: pb.MsgProp, Entries: []pb.Entry{{Data: data}}})
  799. // send heartbeat; flush out commit
  800. tt.send(pb.Message{From: 3, To: 3, Type: pb.MsgBeat})
  801. a := tt.peers[1].(*raft)
  802. if g := a.state; g != StateFollower {
  803. t.Errorf("state = %s, want %s", g, StateFollower)
  804. }
  805. if g := a.Term; g != 1 {
  806. t.Errorf("term = %d, want %d", g, 1)
  807. }
  808. wantLog := ltoa(&raftLog{
  809. storage: &MemoryStorage{
  810. ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Index: 2, Data: data}},
  811. },
  812. unstable: unstable{offset: 3},
  813. committed: 2,
  814. })
  815. for i, p := range tt.peers {
  816. if sm, ok := p.(*raft); ok {
  817. l := ltoa(sm.raftLog)
  818. if g := diffu(wantLog, l); g != "" {
  819. t.Errorf("#%d: diff:\n%s", i, g)
  820. }
  821. } else {
  822. t.Logf("#%d: empty log", i)
  823. }
  824. }
  825. }
  826. func TestSingleNodeCandidate(t *testing.T) {
  827. tt := newNetwork(nil)
  828. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  829. sm := tt.peers[1].(*raft)
  830. if sm.state != StateLeader {
  831. t.Errorf("state = %d, want %d", sm.state, StateLeader)
  832. }
  833. }
  834. func TestSingleNodePreCandidate(t *testing.T) {
  835. tt := newNetworkWithConfig(preVoteConfig, nil)
  836. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  837. sm := tt.peers[1].(*raft)
  838. if sm.state != StateLeader {
  839. t.Errorf("state = %d, want %d", sm.state, StateLeader)
  840. }
  841. }
  842. func TestOldMessages(t *testing.T) {
  843. tt := newNetwork(nil, nil, nil)
  844. // make 0 leader @ term 3
  845. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  846. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  847. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  848. // pretend we're an old leader trying to make progress; this entry is expected to be ignored.
  849. tt.send(pb.Message{From: 2, To: 1, Type: pb.MsgApp, Term: 2, Entries: []pb.Entry{{Index: 3, Term: 2}}})
  850. // commit a new entry
  851. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  852. ilog := &raftLog{
  853. storage: &MemoryStorage{
  854. ents: []pb.Entry{
  855. {}, {Data: nil, Term: 1, Index: 1},
  856. {Data: nil, Term: 2, Index: 2}, {Data: nil, Term: 3, Index: 3},
  857. {Data: []byte("somedata"), Term: 3, Index: 4},
  858. },
  859. },
  860. unstable: unstable{offset: 5},
  861. committed: 4,
  862. }
  863. base := ltoa(ilog)
  864. for i, p := range tt.peers {
  865. if sm, ok := p.(*raft); ok {
  866. l := ltoa(sm.raftLog)
  867. if g := diffu(base, l); g != "" {
  868. t.Errorf("#%d: diff:\n%s", i, g)
  869. }
  870. } else {
  871. t.Logf("#%d: empty log", i)
  872. }
  873. }
  874. }
  875. // TestOldMessagesReply - optimization - reply with new term.
  876. func TestProposal(t *testing.T) {
  877. tests := []struct {
  878. *network
  879. success bool
  880. }{
  881. {newNetwork(nil, nil, nil), true},
  882. {newNetwork(nil, nil, nopStepper), true},
  883. {newNetwork(nil, nopStepper, nopStepper), false},
  884. {newNetwork(nil, nopStepper, nopStepper, nil), false},
  885. {newNetwork(nil, nopStepper, nopStepper, nil, nil), true},
  886. }
  887. for j, tt := range tests {
  888. send := func(m pb.Message) {
  889. defer func() {
  890. // only recover if we expect it to panic (success==false)
  891. if !tt.success {
  892. e := recover()
  893. if e != nil {
  894. t.Logf("#%d: err: %s", j, e)
  895. }
  896. }
  897. }()
  898. tt.send(m)
  899. }
  900. data := []byte("somedata")
  901. // promote 1 to become leader
  902. send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  903. send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: data}}})
  904. wantLog := newLog(NewMemoryStorage(), raftLogger)
  905. if tt.success {
  906. wantLog = &raftLog{
  907. storage: &MemoryStorage{
  908. ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Index: 2, Data: data}},
  909. },
  910. unstable: unstable{offset: 3},
  911. committed: 2}
  912. }
  913. base := ltoa(wantLog)
  914. for i, p := range tt.peers {
  915. if sm, ok := p.(*raft); ok {
  916. l := ltoa(sm.raftLog)
  917. if g := diffu(base, l); g != "" {
  918. t.Errorf("#%d: diff:\n%s", i, g)
  919. }
  920. } else {
  921. t.Logf("#%d: empty log", i)
  922. }
  923. }
  924. sm := tt.network.peers[1].(*raft)
  925. if g := sm.Term; g != 1 {
  926. t.Errorf("#%d: term = %d, want %d", j, g, 1)
  927. }
  928. }
  929. }
  930. func TestProposalByProxy(t *testing.T) {
  931. data := []byte("somedata")
  932. tests := []*network{
  933. newNetwork(nil, nil, nil),
  934. newNetwork(nil, nil, nopStepper),
  935. }
  936. for j, tt := range tests {
  937. // promote 0 the leader
  938. tt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  939. // propose via follower
  940. tt.send(pb.Message{From: 2, To: 2, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  941. wantLog := &raftLog{
  942. storage: &MemoryStorage{
  943. ents: []pb.Entry{{}, {Data: nil, Term: 1, Index: 1}, {Term: 1, Data: data, Index: 2}},
  944. },
  945. unstable: unstable{offset: 3},
  946. committed: 2}
  947. base := ltoa(wantLog)
  948. for i, p := range tt.peers {
  949. if sm, ok := p.(*raft); ok {
  950. l := ltoa(sm.raftLog)
  951. if g := diffu(base, l); g != "" {
  952. t.Errorf("#%d: diff:\n%s", i, g)
  953. }
  954. } else {
  955. t.Logf("#%d: empty log", i)
  956. }
  957. }
  958. sm := tt.peers[1].(*raft)
  959. if g := sm.Term; g != 1 {
  960. t.Errorf("#%d: term = %d, want %d", j, g, 1)
  961. }
  962. }
  963. }
  964. func TestCommit(t *testing.T) {
  965. tests := []struct {
  966. matches []uint64
  967. logs []pb.Entry
  968. smTerm uint64
  969. w uint64
  970. }{
  971. // single
  972. {[]uint64{1}, []pb.Entry{{Index: 1, Term: 1}}, 1, 1},
  973. {[]uint64{1}, []pb.Entry{{Index: 1, Term: 1}}, 2, 0},
  974. {[]uint64{2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 2, 2},
  975. {[]uint64{1}, []pb.Entry{{Index: 1, Term: 2}}, 2, 1},
  976. // odd
  977. {[]uint64{2, 1, 1}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 1, 1},
  978. {[]uint64{2, 1, 1}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}}, 2, 0},
  979. {[]uint64{2, 1, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 2, 2},
  980. {[]uint64{2, 1, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}}, 2, 0},
  981. // even
  982. {[]uint64{2, 1, 1, 1}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 1, 1},
  983. {[]uint64{2, 1, 1, 1}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}}, 2, 0},
  984. {[]uint64{2, 1, 1, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 1, 1},
  985. {[]uint64{2, 1, 1, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}}, 2, 0},
  986. {[]uint64{2, 1, 2, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}}, 2, 2},
  987. {[]uint64{2, 1, 2, 2}, []pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}}, 2, 0},
  988. }
  989. for i, tt := range tests {
  990. storage := NewMemoryStorage()
  991. storage.Append(tt.logs)
  992. storage.hardState = pb.HardState{Term: tt.smTerm}
  993. sm := newTestRaft(1, []uint64{1}, 10, 2, storage)
  994. sm.prs.RemoveAny(1)
  995. for j := 0; j < len(tt.matches); j++ {
  996. sm.prs.InitProgress(uint64(j)+1, tt.matches[j], tt.matches[j]+1, false)
  997. }
  998. sm.maybeCommit()
  999. if g := sm.raftLog.committed; g != tt.w {
  1000. t.Errorf("#%d: committed = %d, want %d", i, g, tt.w)
  1001. }
  1002. }
  1003. }
  1004. func TestPastElectionTimeout(t *testing.T) {
  1005. tests := []struct {
  1006. elapse int
  1007. wprobability float64
  1008. round bool
  1009. }{
  1010. {5, 0, false},
  1011. {10, 0.1, true},
  1012. {13, 0.4, true},
  1013. {15, 0.6, true},
  1014. {18, 0.9, true},
  1015. {20, 1, false},
  1016. }
  1017. for i, tt := range tests {
  1018. sm := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  1019. sm.electionElapsed = tt.elapse
  1020. c := 0
  1021. for j := 0; j < 10000; j++ {
  1022. sm.resetRandomizedElectionTimeout()
  1023. if sm.pastElectionTimeout() {
  1024. c++
  1025. }
  1026. }
  1027. got := float64(c) / 10000.0
  1028. if tt.round {
  1029. got = math.Floor(got*10+0.5) / 10.0
  1030. }
  1031. if got != tt.wprobability {
  1032. t.Errorf("#%d: probability = %v, want %v", i, got, tt.wprobability)
  1033. }
  1034. }
  1035. }
  1036. // ensure that the Step function ignores the message from old term and does not pass it to the
  1037. // actual stepX function.
  1038. func TestStepIgnoreOldTermMsg(t *testing.T) {
  1039. called := false
  1040. fakeStep := func(r *raft, m pb.Message) error {
  1041. called = true
  1042. return nil
  1043. }
  1044. sm := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  1045. sm.step = fakeStep
  1046. sm.Term = 2
  1047. sm.Step(pb.Message{Type: pb.MsgApp, Term: sm.Term - 1})
  1048. if called {
  1049. t.Errorf("stepFunc called = %v , want %v", called, false)
  1050. }
  1051. }
  1052. // TestHandleMsgApp ensures:
  1053. // 1. Reply false if log doesn’t contain an entry at prevLogIndex whose term matches prevLogTerm.
  1054. // 2. If an existing entry conflicts with a new one (same index but different terms),
  1055. // delete the existing entry and all that follow it; append any new entries not already in the log.
  1056. // 3. If leaderCommit > commitIndex, set commitIndex = min(leaderCommit, index of last new entry).
  1057. func TestHandleMsgApp(t *testing.T) {
  1058. tests := []struct {
  1059. m pb.Message
  1060. wIndex uint64
  1061. wCommit uint64
  1062. wReject bool
  1063. }{
  1064. // Ensure 1
  1065. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 3, Index: 2, Commit: 3}, 2, 0, true}, // previous log mismatch
  1066. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 3, Index: 3, Commit: 3}, 2, 0, true}, // previous log non-exist
  1067. // Ensure 2
  1068. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 1, Index: 1, Commit: 1}, 2, 1, false},
  1069. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 0, Index: 0, Commit: 1, Entries: []pb.Entry{{Index: 1, Term: 2}}}, 1, 1, false},
  1070. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 3, Entries: []pb.Entry{{Index: 3, Term: 2}, {Index: 4, Term: 2}}}, 4, 3, false},
  1071. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 4, Entries: []pb.Entry{{Index: 3, Term: 2}}}, 3, 3, false},
  1072. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 1, Index: 1, Commit: 4, Entries: []pb.Entry{{Index: 2, Term: 2}}}, 2, 2, false},
  1073. // Ensure 3
  1074. {pb.Message{Type: pb.MsgApp, Term: 1, LogTerm: 1, Index: 1, Commit: 3}, 2, 1, false}, // match entry 1, commit up to last new entry 1
  1075. {pb.Message{Type: pb.MsgApp, Term: 1, LogTerm: 1, Index: 1, Commit: 3, Entries: []pb.Entry{{Index: 2, Term: 2}}}, 2, 2, false}, // match entry 1, commit up to last new entry 2
  1076. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 3}, 2, 2, false}, // match entry 2, commit up to last new entry 2
  1077. {pb.Message{Type: pb.MsgApp, Term: 2, LogTerm: 2, Index: 2, Commit: 4}, 2, 2, false}, // commit up to log.last()
  1078. }
  1079. for i, tt := range tests {
  1080. storage := NewMemoryStorage()
  1081. storage.Append([]pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}})
  1082. sm := newTestRaft(1, []uint64{1}, 10, 1, storage)
  1083. sm.becomeFollower(2, None)
  1084. sm.handleAppendEntries(tt.m)
  1085. if sm.raftLog.lastIndex() != tt.wIndex {
  1086. t.Errorf("#%d: lastIndex = %d, want %d", i, sm.raftLog.lastIndex(), tt.wIndex)
  1087. }
  1088. if sm.raftLog.committed != tt.wCommit {
  1089. t.Errorf("#%d: committed = %d, want %d", i, sm.raftLog.committed, tt.wCommit)
  1090. }
  1091. m := sm.readMessages()
  1092. if len(m) != 1 {
  1093. t.Fatalf("#%d: msg = nil, want 1", i)
  1094. }
  1095. if m[0].Reject != tt.wReject {
  1096. t.Errorf("#%d: reject = %v, want %v", i, m[0].Reject, tt.wReject)
  1097. }
  1098. }
  1099. }
  1100. // TestHandleHeartbeat ensures that the follower commits to the commit in the message.
  1101. func TestHandleHeartbeat(t *testing.T) {
  1102. commit := uint64(2)
  1103. tests := []struct {
  1104. m pb.Message
  1105. wCommit uint64
  1106. }{
  1107. {pb.Message{From: 2, To: 1, Type: pb.MsgHeartbeat, Term: 2, Commit: commit + 1}, commit + 1},
  1108. {pb.Message{From: 2, To: 1, Type: pb.MsgHeartbeat, Term: 2, Commit: commit - 1}, commit}, // do not decrease commit
  1109. }
  1110. for i, tt := range tests {
  1111. storage := NewMemoryStorage()
  1112. storage.Append([]pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}, {Index: 3, Term: 3}})
  1113. sm := newTestRaft(1, []uint64{1, 2}, 5, 1, storage)
  1114. sm.becomeFollower(2, 2)
  1115. sm.raftLog.commitTo(commit)
  1116. sm.handleHeartbeat(tt.m)
  1117. if sm.raftLog.committed != tt.wCommit {
  1118. t.Errorf("#%d: committed = %d, want %d", i, sm.raftLog.committed, tt.wCommit)
  1119. }
  1120. m := sm.readMessages()
  1121. if len(m) != 1 {
  1122. t.Fatalf("#%d: msg = nil, want 1", i)
  1123. }
  1124. if m[0].Type != pb.MsgHeartbeatResp {
  1125. t.Errorf("#%d: type = %v, want MsgHeartbeatResp", i, m[0].Type)
  1126. }
  1127. }
  1128. }
  1129. // TestHandleHeartbeatResp ensures that we re-send log entries when we get a heartbeat response.
  1130. func TestHandleHeartbeatResp(t *testing.T) {
  1131. storage := NewMemoryStorage()
  1132. storage.Append([]pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 2}, {Index: 3, Term: 3}})
  1133. sm := newTestRaft(1, []uint64{1, 2}, 5, 1, storage)
  1134. sm.becomeCandidate()
  1135. sm.becomeLeader()
  1136. sm.raftLog.commitTo(sm.raftLog.lastIndex())
  1137. // A heartbeat response from a node that is behind; re-send MsgApp
  1138. sm.Step(pb.Message{From: 2, Type: pb.MsgHeartbeatResp})
  1139. msgs := sm.readMessages()
  1140. if len(msgs) != 1 {
  1141. t.Fatalf("len(msgs) = %d, want 1", len(msgs))
  1142. }
  1143. if msgs[0].Type != pb.MsgApp {
  1144. t.Errorf("type = %v, want MsgApp", msgs[0].Type)
  1145. }
  1146. // A second heartbeat response generates another MsgApp re-send
  1147. sm.Step(pb.Message{From: 2, Type: pb.MsgHeartbeatResp})
  1148. msgs = sm.readMessages()
  1149. if len(msgs) != 1 {
  1150. t.Fatalf("len(msgs) = %d, want 1", len(msgs))
  1151. }
  1152. if msgs[0].Type != pb.MsgApp {
  1153. t.Errorf("type = %v, want MsgApp", msgs[0].Type)
  1154. }
  1155. // Once we have an MsgAppResp, heartbeats no longer send MsgApp.
  1156. sm.Step(pb.Message{
  1157. From: 2,
  1158. Type: pb.MsgAppResp,
  1159. Index: msgs[0].Index + uint64(len(msgs[0].Entries)),
  1160. })
  1161. // Consume the message sent in response to MsgAppResp
  1162. sm.readMessages()
  1163. sm.Step(pb.Message{From: 2, Type: pb.MsgHeartbeatResp})
  1164. msgs = sm.readMessages()
  1165. if len(msgs) != 0 {
  1166. t.Fatalf("len(msgs) = %d, want 0: %+v", len(msgs), msgs)
  1167. }
  1168. }
  1169. // TestRaftFreesReadOnlyMem ensures raft will free read request from
  1170. // readOnly readIndexQueue and pendingReadIndex map.
  1171. // related issue: https://github.com/etcd-io/etcd/issues/7571
  1172. func TestRaftFreesReadOnlyMem(t *testing.T) {
  1173. sm := newTestRaft(1, []uint64{1, 2}, 5, 1, NewMemoryStorage())
  1174. sm.becomeCandidate()
  1175. sm.becomeLeader()
  1176. sm.raftLog.commitTo(sm.raftLog.lastIndex())
  1177. ctx := []byte("ctx")
  1178. // leader starts linearizable read request.
  1179. // more info: raft dissertation 6.4, step 2.
  1180. sm.Step(pb.Message{From: 2, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: ctx}}})
  1181. msgs := sm.readMessages()
  1182. if len(msgs) != 1 {
  1183. t.Fatalf("len(msgs) = %d, want 1", len(msgs))
  1184. }
  1185. if msgs[0].Type != pb.MsgHeartbeat {
  1186. t.Fatalf("type = %v, want MsgHeartbeat", msgs[0].Type)
  1187. }
  1188. if !bytes.Equal(msgs[0].Context, ctx) {
  1189. t.Fatalf("Context = %v, want %v", msgs[0].Context, ctx)
  1190. }
  1191. if len(sm.readOnly.readIndexQueue) != 1 {
  1192. t.Fatalf("len(readIndexQueue) = %v, want 1", len(sm.readOnly.readIndexQueue))
  1193. }
  1194. if len(sm.readOnly.pendingReadIndex) != 1 {
  1195. t.Fatalf("len(pendingReadIndex) = %v, want 1", len(sm.readOnly.pendingReadIndex))
  1196. }
  1197. if _, ok := sm.readOnly.pendingReadIndex[string(ctx)]; !ok {
  1198. t.Fatalf("can't find context %v in pendingReadIndex ", ctx)
  1199. }
  1200. // heartbeat responses from majority of followers (1 in this case)
  1201. // acknowledge the authority of the leader.
  1202. // more info: raft dissertation 6.4, step 3.
  1203. sm.Step(pb.Message{From: 2, Type: pb.MsgHeartbeatResp, Context: ctx})
  1204. if len(sm.readOnly.readIndexQueue) != 0 {
  1205. t.Fatalf("len(readIndexQueue) = %v, want 0", len(sm.readOnly.readIndexQueue))
  1206. }
  1207. if len(sm.readOnly.pendingReadIndex) != 0 {
  1208. t.Fatalf("len(pendingReadIndex) = %v, want 0", len(sm.readOnly.pendingReadIndex))
  1209. }
  1210. if _, ok := sm.readOnly.pendingReadIndex[string(ctx)]; ok {
  1211. t.Fatalf("found context %v in pendingReadIndex, want none", ctx)
  1212. }
  1213. }
  1214. // TestMsgAppRespWaitReset verifies the resume behavior of a leader
  1215. // MsgAppResp.
  1216. func TestMsgAppRespWaitReset(t *testing.T) {
  1217. sm := newTestRaft(1, []uint64{1, 2, 3}, 5, 1, NewMemoryStorage())
  1218. sm.becomeCandidate()
  1219. sm.becomeLeader()
  1220. // The new leader has just emitted a new Term 4 entry; consume those messages
  1221. // from the outgoing queue.
  1222. sm.bcastAppend()
  1223. sm.readMessages()
  1224. // Node 2 acks the first entry, making it committed.
  1225. sm.Step(pb.Message{
  1226. From: 2,
  1227. Type: pb.MsgAppResp,
  1228. Index: 1,
  1229. })
  1230. if sm.raftLog.committed != 1 {
  1231. t.Fatalf("expected committed to be 1, got %d", sm.raftLog.committed)
  1232. }
  1233. // Also consume the MsgApp messages that update Commit on the followers.
  1234. sm.readMessages()
  1235. // A new command is now proposed on node 1.
  1236. sm.Step(pb.Message{
  1237. From: 1,
  1238. Type: pb.MsgProp,
  1239. Entries: []pb.Entry{{}},
  1240. })
  1241. // The command is broadcast to all nodes not in the wait state.
  1242. // Node 2 left the wait state due to its MsgAppResp, but node 3 is still waiting.
  1243. msgs := sm.readMessages()
  1244. if len(msgs) != 1 {
  1245. t.Fatalf("expected 1 message, got %d: %+v", len(msgs), msgs)
  1246. }
  1247. if msgs[0].Type != pb.MsgApp || msgs[0].To != 2 {
  1248. t.Errorf("expected MsgApp to node 2, got %v to %d", msgs[0].Type, msgs[0].To)
  1249. }
  1250. if len(msgs[0].Entries) != 1 || msgs[0].Entries[0].Index != 2 {
  1251. t.Errorf("expected to send entry 2, but got %v", msgs[0].Entries)
  1252. }
  1253. // Now Node 3 acks the first entry. This releases the wait and entry 2 is sent.
  1254. sm.Step(pb.Message{
  1255. From: 3,
  1256. Type: pb.MsgAppResp,
  1257. Index: 1,
  1258. })
  1259. msgs = sm.readMessages()
  1260. if len(msgs) != 1 {
  1261. t.Fatalf("expected 1 message, got %d: %+v", len(msgs), msgs)
  1262. }
  1263. if msgs[0].Type != pb.MsgApp || msgs[0].To != 3 {
  1264. t.Errorf("expected MsgApp to node 3, got %v to %d", msgs[0].Type, msgs[0].To)
  1265. }
  1266. if len(msgs[0].Entries) != 1 || msgs[0].Entries[0].Index != 2 {
  1267. t.Errorf("expected to send entry 2, but got %v", msgs[0].Entries)
  1268. }
  1269. }
  1270. func TestRecvMsgVote(t *testing.T) {
  1271. testRecvMsgVote(t, pb.MsgVote)
  1272. }
  1273. func TestRecvMsgPreVote(t *testing.T) {
  1274. testRecvMsgVote(t, pb.MsgPreVote)
  1275. }
  1276. func testRecvMsgVote(t *testing.T, msgType pb.MessageType) {
  1277. tests := []struct {
  1278. state StateType
  1279. index, logTerm uint64
  1280. voteFor uint64
  1281. wreject bool
  1282. }{
  1283. {StateFollower, 0, 0, None, true},
  1284. {StateFollower, 0, 1, None, true},
  1285. {StateFollower, 0, 2, None, true},
  1286. {StateFollower, 0, 3, None, false},
  1287. {StateFollower, 1, 0, None, true},
  1288. {StateFollower, 1, 1, None, true},
  1289. {StateFollower, 1, 2, None, true},
  1290. {StateFollower, 1, 3, None, false},
  1291. {StateFollower, 2, 0, None, true},
  1292. {StateFollower, 2, 1, None, true},
  1293. {StateFollower, 2, 2, None, false},
  1294. {StateFollower, 2, 3, None, false},
  1295. {StateFollower, 3, 0, None, true},
  1296. {StateFollower, 3, 1, None, true},
  1297. {StateFollower, 3, 2, None, false},
  1298. {StateFollower, 3, 3, None, false},
  1299. {StateFollower, 3, 2, 2, false},
  1300. {StateFollower, 3, 2, 1, true},
  1301. {StateLeader, 3, 3, 1, true},
  1302. {StatePreCandidate, 3, 3, 1, true},
  1303. {StateCandidate, 3, 3, 1, true},
  1304. }
  1305. max := func(a, b uint64) uint64 {
  1306. if a > b {
  1307. return a
  1308. }
  1309. return b
  1310. }
  1311. for i, tt := range tests {
  1312. sm := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  1313. sm.state = tt.state
  1314. switch tt.state {
  1315. case StateFollower:
  1316. sm.step = stepFollower
  1317. case StateCandidate, StatePreCandidate:
  1318. sm.step = stepCandidate
  1319. case StateLeader:
  1320. sm.step = stepLeader
  1321. }
  1322. sm.Vote = tt.voteFor
  1323. sm.raftLog = &raftLog{
  1324. storage: &MemoryStorage{ents: []pb.Entry{{}, {Index: 1, Term: 2}, {Index: 2, Term: 2}}},
  1325. unstable: unstable{offset: 3},
  1326. }
  1327. // raft.Term is greater than or equal to raft.raftLog.lastTerm. In this
  1328. // test we're only testing MsgVote responses when the campaigning node
  1329. // has a different raft log compared to the recipient node.
  1330. // Additionally we're verifying behaviour when the recipient node has
  1331. // already given out its vote for its current term. We're not testing
  1332. // what the recipient node does when receiving a message with a
  1333. // different term number, so we simply initialize both term numbers to
  1334. // be the same.
  1335. term := max(sm.raftLog.lastTerm(), tt.logTerm)
  1336. sm.Term = term
  1337. sm.Step(pb.Message{Type: msgType, Term: term, From: 2, Index: tt.index, LogTerm: tt.logTerm})
  1338. msgs := sm.readMessages()
  1339. if g := len(msgs); g != 1 {
  1340. t.Fatalf("#%d: len(msgs) = %d, want 1", i, g)
  1341. continue
  1342. }
  1343. if g := msgs[0].Type; g != voteRespMsgType(msgType) {
  1344. t.Errorf("#%d, m.Type = %v, want %v", i, g, voteRespMsgType(msgType))
  1345. }
  1346. if g := msgs[0].Reject; g != tt.wreject {
  1347. t.Errorf("#%d, m.Reject = %v, want %v", i, g, tt.wreject)
  1348. }
  1349. }
  1350. }
  1351. func TestStateTransition(t *testing.T) {
  1352. tests := []struct {
  1353. from StateType
  1354. to StateType
  1355. wallow bool
  1356. wterm uint64
  1357. wlead uint64
  1358. }{
  1359. {StateFollower, StateFollower, true, 1, None},
  1360. {StateFollower, StatePreCandidate, true, 0, None},
  1361. {StateFollower, StateCandidate, true, 1, None},
  1362. {StateFollower, StateLeader, false, 0, None},
  1363. {StatePreCandidate, StateFollower, true, 0, None},
  1364. {StatePreCandidate, StatePreCandidate, true, 0, None},
  1365. {StatePreCandidate, StateCandidate, true, 1, None},
  1366. {StatePreCandidate, StateLeader, true, 0, 1},
  1367. {StateCandidate, StateFollower, true, 0, None},
  1368. {StateCandidate, StatePreCandidate, true, 0, None},
  1369. {StateCandidate, StateCandidate, true, 1, None},
  1370. {StateCandidate, StateLeader, true, 0, 1},
  1371. {StateLeader, StateFollower, true, 1, None},
  1372. {StateLeader, StatePreCandidate, false, 0, None},
  1373. {StateLeader, StateCandidate, false, 1, None},
  1374. {StateLeader, StateLeader, true, 0, 1},
  1375. }
  1376. for i, tt := range tests {
  1377. func() {
  1378. defer func() {
  1379. if r := recover(); r != nil {
  1380. if tt.wallow {
  1381. t.Errorf("%d: allow = %v, want %v", i, false, true)
  1382. }
  1383. }
  1384. }()
  1385. sm := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  1386. sm.state = tt.from
  1387. switch tt.to {
  1388. case StateFollower:
  1389. sm.becomeFollower(tt.wterm, tt.wlead)
  1390. case StatePreCandidate:
  1391. sm.becomePreCandidate()
  1392. case StateCandidate:
  1393. sm.becomeCandidate()
  1394. case StateLeader:
  1395. sm.becomeLeader()
  1396. }
  1397. if sm.Term != tt.wterm {
  1398. t.Errorf("%d: term = %d, want %d", i, sm.Term, tt.wterm)
  1399. }
  1400. if sm.lead != tt.wlead {
  1401. t.Errorf("%d: lead = %d, want %d", i, sm.lead, tt.wlead)
  1402. }
  1403. }()
  1404. }
  1405. }
  1406. func TestAllServerStepdown(t *testing.T) {
  1407. tests := []struct {
  1408. state StateType
  1409. wstate StateType
  1410. wterm uint64
  1411. windex uint64
  1412. }{
  1413. {StateFollower, StateFollower, 3, 0},
  1414. {StatePreCandidate, StateFollower, 3, 0},
  1415. {StateCandidate, StateFollower, 3, 0},
  1416. {StateLeader, StateFollower, 3, 1},
  1417. }
  1418. tmsgTypes := [...]pb.MessageType{pb.MsgVote, pb.MsgApp}
  1419. tterm := uint64(3)
  1420. for i, tt := range tests {
  1421. sm := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1422. switch tt.state {
  1423. case StateFollower:
  1424. sm.becomeFollower(1, None)
  1425. case StatePreCandidate:
  1426. sm.becomePreCandidate()
  1427. case StateCandidate:
  1428. sm.becomeCandidate()
  1429. case StateLeader:
  1430. sm.becomeCandidate()
  1431. sm.becomeLeader()
  1432. }
  1433. for j, msgType := range tmsgTypes {
  1434. sm.Step(pb.Message{From: 2, Type: msgType, Term: tterm, LogTerm: tterm})
  1435. if sm.state != tt.wstate {
  1436. t.Errorf("#%d.%d state = %v , want %v", i, j, sm.state, tt.wstate)
  1437. }
  1438. if sm.Term != tt.wterm {
  1439. t.Errorf("#%d.%d term = %v , want %v", i, j, sm.Term, tt.wterm)
  1440. }
  1441. if sm.raftLog.lastIndex() != tt.windex {
  1442. t.Errorf("#%d.%d index = %v , want %v", i, j, sm.raftLog.lastIndex(), tt.windex)
  1443. }
  1444. if uint64(len(sm.raftLog.allEntries())) != tt.windex {
  1445. t.Errorf("#%d.%d len(ents) = %v , want %v", i, j, len(sm.raftLog.allEntries()), tt.windex)
  1446. }
  1447. wlead := uint64(2)
  1448. if msgType == pb.MsgVote {
  1449. wlead = None
  1450. }
  1451. if sm.lead != wlead {
  1452. t.Errorf("#%d, sm.lead = %d, want %d", i, sm.lead, None)
  1453. }
  1454. }
  1455. }
  1456. }
  1457. func TestCandidateResetTermMsgHeartbeat(t *testing.T) {
  1458. testCandidateResetTerm(t, pb.MsgHeartbeat)
  1459. }
  1460. func TestCandidateResetTermMsgApp(t *testing.T) {
  1461. testCandidateResetTerm(t, pb.MsgApp)
  1462. }
  1463. // testCandidateResetTerm tests when a candidate receives a
  1464. // MsgHeartbeat or MsgApp from leader, "Step" resets the term
  1465. // with leader's and reverts back to follower.
  1466. func testCandidateResetTerm(t *testing.T, mt pb.MessageType) {
  1467. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1468. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1469. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1470. nt := newNetwork(a, b, c)
  1471. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1472. if a.state != StateLeader {
  1473. t.Errorf("state = %s, want %s", a.state, StateLeader)
  1474. }
  1475. if b.state != StateFollower {
  1476. t.Errorf("state = %s, want %s", b.state, StateFollower)
  1477. }
  1478. if c.state != StateFollower {
  1479. t.Errorf("state = %s, want %s", c.state, StateFollower)
  1480. }
  1481. // isolate 3 and increase term in rest
  1482. nt.isolate(3)
  1483. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  1484. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1485. if a.state != StateLeader {
  1486. t.Errorf("state = %s, want %s", a.state, StateLeader)
  1487. }
  1488. if b.state != StateFollower {
  1489. t.Errorf("state = %s, want %s", b.state, StateFollower)
  1490. }
  1491. // trigger campaign in isolated c
  1492. c.resetRandomizedElectionTimeout()
  1493. for i := 0; i < c.randomizedElectionTimeout; i++ {
  1494. c.tick()
  1495. }
  1496. if c.state != StateCandidate {
  1497. t.Errorf("state = %s, want %s", c.state, StateCandidate)
  1498. }
  1499. nt.recover()
  1500. // leader sends to isolated candidate
  1501. // and expects candidate to revert to follower
  1502. nt.send(pb.Message{From: 1, To: 3, Term: a.Term, Type: mt})
  1503. if c.state != StateFollower {
  1504. t.Errorf("state = %s, want %s", c.state, StateFollower)
  1505. }
  1506. // follower c term is reset with leader's
  1507. if a.Term != c.Term {
  1508. t.Errorf("follower term expected same term as leader's %d, got %d", a.Term, c.Term)
  1509. }
  1510. }
  1511. func TestLeaderStepdownWhenQuorumActive(t *testing.T) {
  1512. sm := newTestRaft(1, []uint64{1, 2, 3}, 5, 1, NewMemoryStorage())
  1513. sm.checkQuorum = true
  1514. sm.becomeCandidate()
  1515. sm.becomeLeader()
  1516. for i := 0; i < sm.electionTimeout+1; i++ {
  1517. sm.Step(pb.Message{From: 2, Type: pb.MsgHeartbeatResp, Term: sm.Term})
  1518. sm.tick()
  1519. }
  1520. if sm.state != StateLeader {
  1521. t.Errorf("state = %v, want %v", sm.state, StateLeader)
  1522. }
  1523. }
  1524. func TestLeaderStepdownWhenQuorumLost(t *testing.T) {
  1525. sm := newTestRaft(1, []uint64{1, 2, 3}, 5, 1, NewMemoryStorage())
  1526. sm.checkQuorum = true
  1527. sm.becomeCandidate()
  1528. sm.becomeLeader()
  1529. for i := 0; i < sm.electionTimeout+1; i++ {
  1530. sm.tick()
  1531. }
  1532. if sm.state != StateFollower {
  1533. t.Errorf("state = %v, want %v", sm.state, StateFollower)
  1534. }
  1535. }
  1536. func TestLeaderSupersedingWithCheckQuorum(t *testing.T) {
  1537. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1538. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1539. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1540. a.checkQuorum = true
  1541. b.checkQuorum = true
  1542. c.checkQuorum = true
  1543. nt := newNetwork(a, b, c)
  1544. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1545. for i := 0; i < b.electionTimeout; i++ {
  1546. b.tick()
  1547. }
  1548. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1549. if a.state != StateLeader {
  1550. t.Errorf("state = %s, want %s", a.state, StateLeader)
  1551. }
  1552. if c.state != StateFollower {
  1553. t.Errorf("state = %s, want %s", c.state, StateFollower)
  1554. }
  1555. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1556. // Peer b rejected c's vote since its electionElapsed had not reached to electionTimeout
  1557. if c.state != StateCandidate {
  1558. t.Errorf("state = %s, want %s", c.state, StateCandidate)
  1559. }
  1560. // Letting b's electionElapsed reach to electionTimeout
  1561. for i := 0; i < b.electionTimeout; i++ {
  1562. b.tick()
  1563. }
  1564. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1565. if c.state != StateLeader {
  1566. t.Errorf("state = %s, want %s", c.state, StateLeader)
  1567. }
  1568. }
  1569. func TestLeaderElectionWithCheckQuorum(t *testing.T) {
  1570. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1571. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1572. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1573. a.checkQuorum = true
  1574. b.checkQuorum = true
  1575. c.checkQuorum = true
  1576. nt := newNetwork(a, b, c)
  1577. setRandomizedElectionTimeout(a, a.electionTimeout+1)
  1578. setRandomizedElectionTimeout(b, b.electionTimeout+2)
  1579. // Immediately after creation, votes are cast regardless of the
  1580. // election timeout.
  1581. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1582. if a.state != StateLeader {
  1583. t.Errorf("state = %s, want %s", a.state, StateLeader)
  1584. }
  1585. if c.state != StateFollower {
  1586. t.Errorf("state = %s, want %s", c.state, StateFollower)
  1587. }
  1588. // need to reset randomizedElectionTimeout larger than electionTimeout again,
  1589. // because the value might be reset to electionTimeout since the last state changes
  1590. setRandomizedElectionTimeout(a, a.electionTimeout+1)
  1591. setRandomizedElectionTimeout(b, b.electionTimeout+2)
  1592. for i := 0; i < a.electionTimeout; i++ {
  1593. a.tick()
  1594. }
  1595. for i := 0; i < b.electionTimeout; i++ {
  1596. b.tick()
  1597. }
  1598. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1599. if a.state != StateFollower {
  1600. t.Errorf("state = %s, want %s", a.state, StateFollower)
  1601. }
  1602. if c.state != StateLeader {
  1603. t.Errorf("state = %s, want %s", c.state, StateLeader)
  1604. }
  1605. }
  1606. // TestFreeStuckCandidateWithCheckQuorum ensures that a candidate with a higher term
  1607. // can disrupt the leader even if the leader still "officially" holds the lease, The
  1608. // leader is expected to step down and adopt the candidate's term
  1609. func TestFreeStuckCandidateWithCheckQuorum(t *testing.T) {
  1610. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1611. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1612. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1613. a.checkQuorum = true
  1614. b.checkQuorum = true
  1615. c.checkQuorum = true
  1616. nt := newNetwork(a, b, c)
  1617. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1618. for i := 0; i < b.electionTimeout; i++ {
  1619. b.tick()
  1620. }
  1621. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1622. nt.isolate(1)
  1623. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1624. if b.state != StateFollower {
  1625. t.Errorf("state = %s, want %s", b.state, StateFollower)
  1626. }
  1627. if c.state != StateCandidate {
  1628. t.Errorf("state = %s, want %s", c.state, StateCandidate)
  1629. }
  1630. if c.Term != b.Term+1 {
  1631. t.Errorf("term = %d, want %d", c.Term, b.Term+1)
  1632. }
  1633. // Vote again for safety
  1634. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1635. if b.state != StateFollower {
  1636. t.Errorf("state = %s, want %s", b.state, StateFollower)
  1637. }
  1638. if c.state != StateCandidate {
  1639. t.Errorf("state = %s, want %s", c.state, StateCandidate)
  1640. }
  1641. if c.Term != b.Term+2 {
  1642. t.Errorf("term = %d, want %d", c.Term, b.Term+2)
  1643. }
  1644. nt.recover()
  1645. nt.send(pb.Message{From: 1, To: 3, Type: pb.MsgHeartbeat, Term: a.Term})
  1646. // Disrupt the leader so that the stuck peer is freed
  1647. if a.state != StateFollower {
  1648. t.Errorf("state = %s, want %s", a.state, StateFollower)
  1649. }
  1650. if c.Term != a.Term {
  1651. t.Errorf("term = %d, want %d", c.Term, a.Term)
  1652. }
  1653. // Vote again, should become leader this time
  1654. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1655. if c.state != StateLeader {
  1656. t.Errorf("peer 3 state: %s, want %s", c.state, StateLeader)
  1657. }
  1658. }
  1659. func TestNonPromotableVoterWithCheckQuorum(t *testing.T) {
  1660. a := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  1661. b := newTestRaft(2, []uint64{1}, 10, 1, NewMemoryStorage())
  1662. a.checkQuorum = true
  1663. b.checkQuorum = true
  1664. nt := newNetwork(a, b)
  1665. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1666. // Need to remove 2 again to make it a non-promotable node since newNetwork overwritten some internal states
  1667. b.prs.RemoveAny(2)
  1668. if b.promotable() {
  1669. t.Fatalf("promotable = %v, want false", b.promotable())
  1670. }
  1671. for i := 0; i < b.electionTimeout; i++ {
  1672. b.tick()
  1673. }
  1674. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1675. if a.state != StateLeader {
  1676. t.Errorf("state = %s, want %s", a.state, StateLeader)
  1677. }
  1678. if b.state != StateFollower {
  1679. t.Errorf("state = %s, want %s", b.state, StateFollower)
  1680. }
  1681. if b.lead != 1 {
  1682. t.Errorf("lead = %d, want 1", b.lead)
  1683. }
  1684. }
  1685. // TestDisruptiveFollower tests isolated follower,
  1686. // with slow network incoming from leader, election times out
  1687. // to become a candidate with an increased term. Then, the
  1688. // candiate's response to late leader heartbeat forces the leader
  1689. // to step down.
  1690. func TestDisruptiveFollower(t *testing.T) {
  1691. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1692. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1693. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1694. n1.checkQuorum = true
  1695. n2.checkQuorum = true
  1696. n3.checkQuorum = true
  1697. n1.becomeFollower(1, None)
  1698. n2.becomeFollower(1, None)
  1699. n3.becomeFollower(1, None)
  1700. nt := newNetwork(n1, n2, n3)
  1701. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1702. // check state
  1703. // n1.state == StateLeader
  1704. // n2.state == StateFollower
  1705. // n3.state == StateFollower
  1706. if n1.state != StateLeader {
  1707. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  1708. }
  1709. if n2.state != StateFollower {
  1710. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  1711. }
  1712. if n3.state != StateFollower {
  1713. t.Fatalf("node 3 state: %s, want %s", n3.state, StateFollower)
  1714. }
  1715. // etcd server "advanceTicksForElection" on restart;
  1716. // this is to expedite campaign trigger when given larger
  1717. // election timeouts (e.g. multi-datacenter deploy)
  1718. // Or leader messages are being delayed while ticks elapse
  1719. setRandomizedElectionTimeout(n3, n3.electionTimeout+2)
  1720. for i := 0; i < n3.randomizedElectionTimeout-1; i++ {
  1721. n3.tick()
  1722. }
  1723. // ideally, before last election tick elapses,
  1724. // the follower n3 receives "pb.MsgApp" or "pb.MsgHeartbeat"
  1725. // from leader n1, and then resets its "electionElapsed"
  1726. // however, last tick may elapse before receiving any
  1727. // messages from leader, thus triggering campaign
  1728. n3.tick()
  1729. // n1 is still leader yet
  1730. // while its heartbeat to candidate n3 is being delayed
  1731. // check state
  1732. // n1.state == StateLeader
  1733. // n2.state == StateFollower
  1734. // n3.state == StateCandidate
  1735. if n1.state != StateLeader {
  1736. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  1737. }
  1738. if n2.state != StateFollower {
  1739. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  1740. }
  1741. if n3.state != StateCandidate {
  1742. t.Fatalf("node 3 state: %s, want %s", n3.state, StateCandidate)
  1743. }
  1744. // check term
  1745. // n1.Term == 2
  1746. // n2.Term == 2
  1747. // n3.Term == 3
  1748. if n1.Term != 2 {
  1749. t.Fatalf("node 1 term: %d, want %d", n1.Term, 2)
  1750. }
  1751. if n2.Term != 2 {
  1752. t.Fatalf("node 2 term: %d, want %d", n2.Term, 2)
  1753. }
  1754. if n3.Term != 3 {
  1755. t.Fatalf("node 3 term: %d, want %d", n3.Term, 3)
  1756. }
  1757. // while outgoing vote requests are still queued in n3,
  1758. // leader heartbeat finally arrives at candidate n3
  1759. // however, due to delayed network from leader, leader
  1760. // heartbeat was sent with lower term than candidate's
  1761. nt.send(pb.Message{From: 1, To: 3, Term: n1.Term, Type: pb.MsgHeartbeat})
  1762. // then candidate n3 responds with "pb.MsgAppResp" of higher term
  1763. // and leader steps down from a message with higher term
  1764. // this is to disrupt the current leader, so that candidate
  1765. // with higher term can be freed with following election
  1766. // check state
  1767. // n1.state == StateFollower
  1768. // n2.state == StateFollower
  1769. // n3.state == StateCandidate
  1770. if n1.state != StateFollower {
  1771. t.Fatalf("node 1 state: %s, want %s", n1.state, StateFollower)
  1772. }
  1773. if n2.state != StateFollower {
  1774. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  1775. }
  1776. if n3.state != StateCandidate {
  1777. t.Fatalf("node 3 state: %s, want %s", n3.state, StateCandidate)
  1778. }
  1779. // check term
  1780. // n1.Term == 3
  1781. // n2.Term == 2
  1782. // n3.Term == 3
  1783. if n1.Term != 3 {
  1784. t.Fatalf("node 1 term: %d, want %d", n1.Term, 3)
  1785. }
  1786. if n2.Term != 2 {
  1787. t.Fatalf("node 2 term: %d, want %d", n2.Term, 2)
  1788. }
  1789. if n3.Term != 3 {
  1790. t.Fatalf("node 3 term: %d, want %d", n3.Term, 3)
  1791. }
  1792. }
  1793. // TestDisruptiveFollowerPreVote tests isolated follower,
  1794. // with slow network incoming from leader, election times out
  1795. // to become a pre-candidate with less log than current leader.
  1796. // Then pre-vote phase prevents this isolated node from forcing
  1797. // current leader to step down, thus less disruptions.
  1798. func TestDisruptiveFollowerPreVote(t *testing.T) {
  1799. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1800. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1801. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1802. n1.checkQuorum = true
  1803. n2.checkQuorum = true
  1804. n3.checkQuorum = true
  1805. n1.becomeFollower(1, None)
  1806. n2.becomeFollower(1, None)
  1807. n3.becomeFollower(1, None)
  1808. nt := newNetwork(n1, n2, n3)
  1809. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1810. // check state
  1811. // n1.state == StateLeader
  1812. // n2.state == StateFollower
  1813. // n3.state == StateFollower
  1814. if n1.state != StateLeader {
  1815. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  1816. }
  1817. if n2.state != StateFollower {
  1818. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  1819. }
  1820. if n3.state != StateFollower {
  1821. t.Fatalf("node 3 state: %s, want %s", n3.state, StateFollower)
  1822. }
  1823. nt.isolate(3)
  1824. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  1825. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  1826. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  1827. n1.preVote = true
  1828. n2.preVote = true
  1829. n3.preVote = true
  1830. nt.recover()
  1831. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  1832. // check state
  1833. // n1.state == StateLeader
  1834. // n2.state == StateFollower
  1835. // n3.state == StatePreCandidate
  1836. if n1.state != StateLeader {
  1837. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  1838. }
  1839. if n2.state != StateFollower {
  1840. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  1841. }
  1842. if n3.state != StatePreCandidate {
  1843. t.Fatalf("node 3 state: %s, want %s", n3.state, StatePreCandidate)
  1844. }
  1845. // check term
  1846. // n1.Term == 2
  1847. // n2.Term == 2
  1848. // n3.Term == 2
  1849. if n1.Term != 2 {
  1850. t.Fatalf("node 1 term: %d, want %d", n1.Term, 2)
  1851. }
  1852. if n2.Term != 2 {
  1853. t.Fatalf("node 2 term: %d, want %d", n2.Term, 2)
  1854. }
  1855. if n3.Term != 2 {
  1856. t.Fatalf("node 2 term: %d, want %d", n3.Term, 2)
  1857. }
  1858. // delayed leader heartbeat does not force current leader to step down
  1859. nt.send(pb.Message{From: 1, To: 3, Term: n1.Term, Type: pb.MsgHeartbeat})
  1860. if n1.state != StateLeader {
  1861. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  1862. }
  1863. }
  1864. func TestReadOnlyOptionSafe(t *testing.T) {
  1865. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1866. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1867. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1868. nt := newNetwork(a, b, c)
  1869. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1870. for i := 0; i < b.electionTimeout; i++ {
  1871. b.tick()
  1872. }
  1873. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1874. if a.state != StateLeader {
  1875. t.Fatalf("state = %s, want %s", a.state, StateLeader)
  1876. }
  1877. tests := []struct {
  1878. sm *raft
  1879. proposals int
  1880. wri uint64
  1881. wctx []byte
  1882. }{
  1883. {a, 10, 11, []byte("ctx1")},
  1884. {b, 10, 21, []byte("ctx2")},
  1885. {c, 10, 31, []byte("ctx3")},
  1886. {a, 10, 41, []byte("ctx4")},
  1887. {b, 10, 51, []byte("ctx5")},
  1888. {c, 10, 61, []byte("ctx6")},
  1889. }
  1890. for i, tt := range tests {
  1891. for j := 0; j < tt.proposals; j++ {
  1892. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  1893. }
  1894. nt.send(pb.Message{From: tt.sm.id, To: tt.sm.id, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: tt.wctx}}})
  1895. r := tt.sm
  1896. if len(r.readStates) == 0 {
  1897. t.Errorf("#%d: len(readStates) = 0, want non-zero", i)
  1898. }
  1899. rs := r.readStates[0]
  1900. if rs.Index != tt.wri {
  1901. t.Errorf("#%d: readIndex = %d, want %d", i, rs.Index, tt.wri)
  1902. }
  1903. if !bytes.Equal(rs.RequestCtx, tt.wctx) {
  1904. t.Errorf("#%d: requestCtx = %v, want %v", i, rs.RequestCtx, tt.wctx)
  1905. }
  1906. r.readStates = nil
  1907. }
  1908. }
  1909. func TestReadOnlyWithLearner(t *testing.T) {
  1910. a := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  1911. b := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  1912. nt := newNetwork(a, b)
  1913. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1914. for i := 0; i < b.electionTimeout; i++ {
  1915. b.tick()
  1916. }
  1917. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1918. if a.state != StateLeader {
  1919. t.Fatalf("state = %s, want %s", a.state, StateLeader)
  1920. }
  1921. tests := []struct {
  1922. sm *raft
  1923. proposals int
  1924. wri uint64
  1925. wctx []byte
  1926. }{
  1927. {a, 10, 11, []byte("ctx1")},
  1928. {b, 10, 21, []byte("ctx2")},
  1929. {a, 10, 31, []byte("ctx3")},
  1930. {b, 10, 41, []byte("ctx4")},
  1931. }
  1932. for i, tt := range tests {
  1933. for j := 0; j < tt.proposals; j++ {
  1934. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  1935. }
  1936. nt.send(pb.Message{From: tt.sm.id, To: tt.sm.id, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: tt.wctx}}})
  1937. r := tt.sm
  1938. if len(r.readStates) == 0 {
  1939. t.Fatalf("#%d: len(readStates) = 0, want non-zero", i)
  1940. }
  1941. rs := r.readStates[0]
  1942. if rs.Index != tt.wri {
  1943. t.Errorf("#%d: readIndex = %d, want %d", i, rs.Index, tt.wri)
  1944. }
  1945. if !bytes.Equal(rs.RequestCtx, tt.wctx) {
  1946. t.Errorf("#%d: requestCtx = %v, want %v", i, rs.RequestCtx, tt.wctx)
  1947. }
  1948. r.readStates = nil
  1949. }
  1950. }
  1951. func TestReadOnlyOptionLease(t *testing.T) {
  1952. a := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1953. b := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1954. c := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  1955. a.readOnly.option = ReadOnlyLeaseBased
  1956. b.readOnly.option = ReadOnlyLeaseBased
  1957. c.readOnly.option = ReadOnlyLeaseBased
  1958. a.checkQuorum = true
  1959. b.checkQuorum = true
  1960. c.checkQuorum = true
  1961. nt := newNetwork(a, b, c)
  1962. setRandomizedElectionTimeout(b, b.electionTimeout+1)
  1963. for i := 0; i < b.electionTimeout; i++ {
  1964. b.tick()
  1965. }
  1966. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  1967. if a.state != StateLeader {
  1968. t.Fatalf("state = %s, want %s", a.state, StateLeader)
  1969. }
  1970. tests := []struct {
  1971. sm *raft
  1972. proposals int
  1973. wri uint64
  1974. wctx []byte
  1975. }{
  1976. {a, 10, 11, []byte("ctx1")},
  1977. {b, 10, 21, []byte("ctx2")},
  1978. {c, 10, 31, []byte("ctx3")},
  1979. {a, 10, 41, []byte("ctx4")},
  1980. {b, 10, 51, []byte("ctx5")},
  1981. {c, 10, 61, []byte("ctx6")},
  1982. }
  1983. for i, tt := range tests {
  1984. for j := 0; j < tt.proposals; j++ {
  1985. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  1986. }
  1987. nt.send(pb.Message{From: tt.sm.id, To: tt.sm.id, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: tt.wctx}}})
  1988. r := tt.sm
  1989. rs := r.readStates[0]
  1990. if rs.Index != tt.wri {
  1991. t.Errorf("#%d: readIndex = %d, want %d", i, rs.Index, tt.wri)
  1992. }
  1993. if !bytes.Equal(rs.RequestCtx, tt.wctx) {
  1994. t.Errorf("#%d: requestCtx = %v, want %v", i, rs.RequestCtx, tt.wctx)
  1995. }
  1996. r.readStates = nil
  1997. }
  1998. }
  1999. // TestReadOnlyForNewLeader ensures that a leader only accepts MsgReadIndex message
  2000. // when it commits at least one log entry at it term.
  2001. func TestReadOnlyForNewLeader(t *testing.T) {
  2002. nodeConfigs := []struct {
  2003. id uint64
  2004. committed uint64
  2005. applied uint64
  2006. compactIndex uint64
  2007. }{
  2008. {1, 1, 1, 0},
  2009. {2, 2, 2, 2},
  2010. {3, 2, 2, 2},
  2011. }
  2012. peers := make([]stateMachine, 0)
  2013. for _, c := range nodeConfigs {
  2014. storage := NewMemoryStorage()
  2015. storage.Append([]pb.Entry{{Index: 1, Term: 1}, {Index: 2, Term: 1}})
  2016. storage.SetHardState(pb.HardState{Term: 1, Commit: c.committed})
  2017. if c.compactIndex != 0 {
  2018. storage.Compact(c.compactIndex)
  2019. }
  2020. cfg := newTestConfig(c.id, []uint64{1, 2, 3}, 10, 1, storage)
  2021. cfg.Applied = c.applied
  2022. raft := newRaft(cfg)
  2023. peers = append(peers, raft)
  2024. }
  2025. nt := newNetwork(peers...)
  2026. // Drop MsgApp to forbid peer a to commit any log entry at its term after it becomes leader.
  2027. nt.ignore(pb.MsgApp)
  2028. // Force peer a to become leader.
  2029. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2030. sm := nt.peers[1].(*raft)
  2031. if sm.state != StateLeader {
  2032. t.Fatalf("state = %s, want %s", sm.state, StateLeader)
  2033. }
  2034. // Ensure peer a drops read only request.
  2035. var windex uint64 = 4
  2036. wctx := []byte("ctx")
  2037. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: wctx}}})
  2038. if len(sm.readStates) != 0 {
  2039. t.Fatalf("len(readStates) = %d, want zero", len(sm.readStates))
  2040. }
  2041. nt.recover()
  2042. // Force peer a to commit a log entry at its term
  2043. for i := 0; i < sm.heartbeatTimeout; i++ {
  2044. sm.tick()
  2045. }
  2046. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2047. if sm.raftLog.committed != 4 {
  2048. t.Fatalf("committed = %d, want 4", sm.raftLog.committed)
  2049. }
  2050. lastLogTerm := sm.raftLog.zeroTermOnErrCompacted(sm.raftLog.term(sm.raftLog.committed))
  2051. if lastLogTerm != sm.Term {
  2052. t.Fatalf("last log term = %d, want %d", lastLogTerm, sm.Term)
  2053. }
  2054. // Ensure peer a accepts read only request after it commits a entry at its term.
  2055. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgReadIndex, Entries: []pb.Entry{{Data: wctx}}})
  2056. if len(sm.readStates) != 1 {
  2057. t.Fatalf("len(readStates) = %d, want 1", len(sm.readStates))
  2058. }
  2059. rs := sm.readStates[0]
  2060. if rs.Index != windex {
  2061. t.Fatalf("readIndex = %d, want %d", rs.Index, windex)
  2062. }
  2063. if !bytes.Equal(rs.RequestCtx, wctx) {
  2064. t.Fatalf("requestCtx = %v, want %v", rs.RequestCtx, wctx)
  2065. }
  2066. }
  2067. func TestLeaderAppResp(t *testing.T) {
  2068. // initial progress: match = 0; next = 3
  2069. tests := []struct {
  2070. index uint64
  2071. reject bool
  2072. // progress
  2073. wmatch uint64
  2074. wnext uint64
  2075. // message
  2076. wmsgNum int
  2077. windex uint64
  2078. wcommitted uint64
  2079. }{
  2080. {3, true, 0, 3, 0, 0, 0}, // stale resp; no replies
  2081. {2, true, 0, 2, 1, 1, 0}, // denied resp; leader does not commit; decrease next and send probing msg
  2082. {2, false, 2, 4, 2, 2, 2}, // accept resp; leader commits; broadcast with commit index
  2083. {0, false, 0, 3, 0, 0, 0}, // ignore heartbeat replies
  2084. }
  2085. for i, tt := range tests {
  2086. // sm term is 1 after it becomes the leader.
  2087. // thus the last log term must be 1 to be committed.
  2088. sm := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  2089. sm.raftLog = &raftLog{
  2090. storage: &MemoryStorage{ents: []pb.Entry{{}, {Index: 1, Term: 0}, {Index: 2, Term: 1}}},
  2091. unstable: unstable{offset: 3},
  2092. }
  2093. sm.becomeCandidate()
  2094. sm.becomeLeader()
  2095. sm.readMessages()
  2096. sm.Step(pb.Message{From: 2, Type: pb.MsgAppResp, Index: tt.index, Term: sm.Term, Reject: tt.reject, RejectHint: tt.index})
  2097. p := sm.prs.Progress[2]
  2098. if p.Match != tt.wmatch {
  2099. t.Errorf("#%d match = %d, want %d", i, p.Match, tt.wmatch)
  2100. }
  2101. if p.Next != tt.wnext {
  2102. t.Errorf("#%d next = %d, want %d", i, p.Next, tt.wnext)
  2103. }
  2104. msgs := sm.readMessages()
  2105. if len(msgs) != tt.wmsgNum {
  2106. t.Errorf("#%d msgNum = %d, want %d", i, len(msgs), tt.wmsgNum)
  2107. }
  2108. for j, msg := range msgs {
  2109. if msg.Index != tt.windex {
  2110. t.Errorf("#%d.%d index = %d, want %d", i, j, msg.Index, tt.windex)
  2111. }
  2112. if msg.Commit != tt.wcommitted {
  2113. t.Errorf("#%d.%d commit = %d, want %d", i, j, msg.Commit, tt.wcommitted)
  2114. }
  2115. }
  2116. }
  2117. }
  2118. // When the leader receives a heartbeat tick, it should
  2119. // send a MsgHeartbeat with m.Index = 0, m.LogTerm=0 and empty entries.
  2120. func TestBcastBeat(t *testing.T) {
  2121. offset := uint64(1000)
  2122. // make a state machine with log.offset = 1000
  2123. s := pb.Snapshot{
  2124. Metadata: pb.SnapshotMetadata{
  2125. Index: offset,
  2126. Term: 1,
  2127. ConfState: pb.ConfState{Nodes: []uint64{1, 2, 3}},
  2128. },
  2129. }
  2130. storage := NewMemoryStorage()
  2131. storage.ApplySnapshot(s)
  2132. sm := newTestRaft(1, nil, 10, 1, storage)
  2133. sm.Term = 1
  2134. sm.becomeCandidate()
  2135. sm.becomeLeader()
  2136. for i := 0; i < 10; i++ {
  2137. mustAppendEntry(sm, pb.Entry{Index: uint64(i) + 1})
  2138. }
  2139. // slow follower
  2140. sm.prs.Progress[2].Match, sm.prs.Progress[2].Next = 5, 6
  2141. // normal follower
  2142. sm.prs.Progress[3].Match, sm.prs.Progress[3].Next = sm.raftLog.lastIndex(), sm.raftLog.lastIndex()+1
  2143. sm.Step(pb.Message{Type: pb.MsgBeat})
  2144. msgs := sm.readMessages()
  2145. if len(msgs) != 2 {
  2146. t.Fatalf("len(msgs) = %v, want 2", len(msgs))
  2147. }
  2148. wantCommitMap := map[uint64]uint64{
  2149. 2: min(sm.raftLog.committed, sm.prs.Progress[2].Match),
  2150. 3: min(sm.raftLog.committed, sm.prs.Progress[3].Match),
  2151. }
  2152. for i, m := range msgs {
  2153. if m.Type != pb.MsgHeartbeat {
  2154. t.Fatalf("#%d: type = %v, want = %v", i, m.Type, pb.MsgHeartbeat)
  2155. }
  2156. if m.Index != 0 {
  2157. t.Fatalf("#%d: prevIndex = %d, want %d", i, m.Index, 0)
  2158. }
  2159. if m.LogTerm != 0 {
  2160. t.Fatalf("#%d: prevTerm = %d, want %d", i, m.LogTerm, 0)
  2161. }
  2162. if wantCommitMap[m.To] == 0 {
  2163. t.Fatalf("#%d: unexpected to %d", i, m.To)
  2164. } else {
  2165. if m.Commit != wantCommitMap[m.To] {
  2166. t.Fatalf("#%d: commit = %d, want %d", i, m.Commit, wantCommitMap[m.To])
  2167. }
  2168. delete(wantCommitMap, m.To)
  2169. }
  2170. if len(m.Entries) != 0 {
  2171. t.Fatalf("#%d: len(entries) = %d, want 0", i, len(m.Entries))
  2172. }
  2173. }
  2174. }
  2175. // tests the output of the state machine when receiving MsgBeat
  2176. func TestRecvMsgBeat(t *testing.T) {
  2177. tests := []struct {
  2178. state StateType
  2179. wMsg int
  2180. }{
  2181. {StateLeader, 2},
  2182. // candidate and follower should ignore MsgBeat
  2183. {StateCandidate, 0},
  2184. {StateFollower, 0},
  2185. }
  2186. for i, tt := range tests {
  2187. sm := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  2188. sm.raftLog = &raftLog{storage: &MemoryStorage{ents: []pb.Entry{{}, {Index: 1, Term: 0}, {Index: 2, Term: 1}}}}
  2189. sm.Term = 1
  2190. sm.state = tt.state
  2191. switch tt.state {
  2192. case StateFollower:
  2193. sm.step = stepFollower
  2194. case StateCandidate:
  2195. sm.step = stepCandidate
  2196. case StateLeader:
  2197. sm.step = stepLeader
  2198. }
  2199. sm.Step(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  2200. msgs := sm.readMessages()
  2201. if len(msgs) != tt.wMsg {
  2202. t.Errorf("%d: len(msgs) = %d, want %d", i, len(msgs), tt.wMsg)
  2203. }
  2204. for _, m := range msgs {
  2205. if m.Type != pb.MsgHeartbeat {
  2206. t.Errorf("%d: msg.type = %v, want %v", i, m.Type, pb.MsgHeartbeat)
  2207. }
  2208. }
  2209. }
  2210. }
  2211. func TestLeaderIncreaseNext(t *testing.T) {
  2212. previousEnts := []pb.Entry{{Term: 1, Index: 1}, {Term: 1, Index: 2}, {Term: 1, Index: 3}}
  2213. tests := []struct {
  2214. // progress
  2215. state tracker.StateType
  2216. next uint64
  2217. wnext uint64
  2218. }{
  2219. // state replicate, optimistically increase next
  2220. // previous entries + noop entry + propose + 1
  2221. {tracker.StateReplicate, 2, uint64(len(previousEnts) + 1 + 1 + 1)},
  2222. // state probe, not optimistically increase next
  2223. {tracker.StateProbe, 2, 2},
  2224. }
  2225. for i, tt := range tests {
  2226. sm := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2227. sm.raftLog.append(previousEnts...)
  2228. sm.becomeCandidate()
  2229. sm.becomeLeader()
  2230. sm.prs.Progress[2].State = tt.state
  2231. sm.prs.Progress[2].Next = tt.next
  2232. sm.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  2233. p := sm.prs.Progress[2]
  2234. if p.Next != tt.wnext {
  2235. t.Errorf("#%d next = %d, want %d", i, p.Next, tt.wnext)
  2236. }
  2237. }
  2238. }
  2239. func TestSendAppendForProgressProbe(t *testing.T) {
  2240. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2241. r.becomeCandidate()
  2242. r.becomeLeader()
  2243. r.readMessages()
  2244. r.prs.Progress[2].BecomeProbe()
  2245. // each round is a heartbeat
  2246. for i := 0; i < 3; i++ {
  2247. if i == 0 {
  2248. // we expect that raft will only send out one msgAPP on the first
  2249. // loop. After that, the follower is paused until a heartbeat response is
  2250. // received.
  2251. mustAppendEntry(r, pb.Entry{Data: []byte("somedata")})
  2252. r.sendAppend(2)
  2253. msg := r.readMessages()
  2254. if len(msg) != 1 {
  2255. t.Errorf("len(msg) = %d, want %d", len(msg), 1)
  2256. }
  2257. if msg[0].Index != 0 {
  2258. t.Errorf("index = %d, want %d", msg[0].Index, 0)
  2259. }
  2260. }
  2261. if !r.prs.Progress[2].ProbeSent {
  2262. t.Errorf("paused = %v, want true", r.prs.Progress[2].ProbeSent)
  2263. }
  2264. for j := 0; j < 10; j++ {
  2265. mustAppendEntry(r, pb.Entry{Data: []byte("somedata")})
  2266. r.sendAppend(2)
  2267. if l := len(r.readMessages()); l != 0 {
  2268. t.Errorf("len(msg) = %d, want %d", l, 0)
  2269. }
  2270. }
  2271. // do a heartbeat
  2272. for j := 0; j < r.heartbeatTimeout; j++ {
  2273. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  2274. }
  2275. if !r.prs.Progress[2].ProbeSent {
  2276. t.Errorf("paused = %v, want true", r.prs.Progress[2].ProbeSent)
  2277. }
  2278. // consume the heartbeat
  2279. msg := r.readMessages()
  2280. if len(msg) != 1 {
  2281. t.Errorf("len(msg) = %d, want %d", len(msg), 1)
  2282. }
  2283. if msg[0].Type != pb.MsgHeartbeat {
  2284. t.Errorf("type = %v, want %v", msg[0].Type, pb.MsgHeartbeat)
  2285. }
  2286. }
  2287. // a heartbeat response will allow another message to be sent
  2288. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgHeartbeatResp})
  2289. msg := r.readMessages()
  2290. if len(msg) != 1 {
  2291. t.Errorf("len(msg) = %d, want %d", len(msg), 1)
  2292. }
  2293. if msg[0].Index != 0 {
  2294. t.Errorf("index = %d, want %d", msg[0].Index, 0)
  2295. }
  2296. if !r.prs.Progress[2].ProbeSent {
  2297. t.Errorf("paused = %v, want true", r.prs.Progress[2].ProbeSent)
  2298. }
  2299. }
  2300. func TestSendAppendForProgressReplicate(t *testing.T) {
  2301. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2302. r.becomeCandidate()
  2303. r.becomeLeader()
  2304. r.readMessages()
  2305. r.prs.Progress[2].BecomeReplicate()
  2306. for i := 0; i < 10; i++ {
  2307. mustAppendEntry(r, pb.Entry{Data: []byte("somedata")})
  2308. r.sendAppend(2)
  2309. msgs := r.readMessages()
  2310. if len(msgs) != 1 {
  2311. t.Errorf("len(msg) = %d, want %d", len(msgs), 1)
  2312. }
  2313. }
  2314. }
  2315. func TestSendAppendForProgressSnapshot(t *testing.T) {
  2316. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2317. r.becomeCandidate()
  2318. r.becomeLeader()
  2319. r.readMessages()
  2320. r.prs.Progress[2].BecomeSnapshot(10)
  2321. for i := 0; i < 10; i++ {
  2322. mustAppendEntry(r, pb.Entry{Data: []byte("somedata")})
  2323. r.sendAppend(2)
  2324. msgs := r.readMessages()
  2325. if len(msgs) != 0 {
  2326. t.Errorf("len(msg) = %d, want %d", len(msgs), 0)
  2327. }
  2328. }
  2329. }
  2330. func TestRecvMsgUnreachable(t *testing.T) {
  2331. previousEnts := []pb.Entry{{Term: 1, Index: 1}, {Term: 1, Index: 2}, {Term: 1, Index: 3}}
  2332. s := NewMemoryStorage()
  2333. s.Append(previousEnts)
  2334. r := newTestRaft(1, []uint64{1, 2}, 10, 1, s)
  2335. r.becomeCandidate()
  2336. r.becomeLeader()
  2337. r.readMessages()
  2338. // set node 2 to state replicate
  2339. r.prs.Progress[2].Match = 3
  2340. r.prs.Progress[2].BecomeReplicate()
  2341. r.prs.Progress[2].OptimisticUpdate(5)
  2342. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgUnreachable})
  2343. if r.prs.Progress[2].State != tracker.StateProbe {
  2344. t.Errorf("state = %s, want %s", r.prs.Progress[2].State, tracker.StateProbe)
  2345. }
  2346. if wnext := r.prs.Progress[2].Match + 1; r.prs.Progress[2].Next != wnext {
  2347. t.Errorf("next = %d, want %d", r.prs.Progress[2].Next, wnext)
  2348. }
  2349. }
  2350. func TestRestore(t *testing.T) {
  2351. s := pb.Snapshot{
  2352. Metadata: pb.SnapshotMetadata{
  2353. Index: 11, // magic number
  2354. Term: 11, // magic number
  2355. ConfState: pb.ConfState{Nodes: []uint64{1, 2, 3}},
  2356. },
  2357. }
  2358. storage := NewMemoryStorage()
  2359. sm := newTestRaft(1, []uint64{1, 2}, 10, 1, storage)
  2360. if ok := sm.restore(s); !ok {
  2361. t.Fatal("restore fail, want succeed")
  2362. }
  2363. if sm.raftLog.lastIndex() != s.Metadata.Index {
  2364. t.Errorf("log.lastIndex = %d, want %d", sm.raftLog.lastIndex(), s.Metadata.Index)
  2365. }
  2366. if mustTerm(sm.raftLog.term(s.Metadata.Index)) != s.Metadata.Term {
  2367. t.Errorf("log.lastTerm = %d, want %d", mustTerm(sm.raftLog.term(s.Metadata.Index)), s.Metadata.Term)
  2368. }
  2369. sg := sm.prs.VoterNodes()
  2370. if !reflect.DeepEqual(sg, s.Metadata.ConfState.Nodes) {
  2371. t.Errorf("sm.Nodes = %+v, want %+v", sg, s.Metadata.ConfState.Nodes)
  2372. }
  2373. if ok := sm.restore(s); ok {
  2374. t.Fatal("restore succeed, want fail")
  2375. }
  2376. }
  2377. // TestRestoreWithLearner restores a snapshot which contains learners.
  2378. func TestRestoreWithLearner(t *testing.T) {
  2379. s := pb.Snapshot{
  2380. Metadata: pb.SnapshotMetadata{
  2381. Index: 11, // magic number
  2382. Term: 11, // magic number
  2383. ConfState: pb.ConfState{Nodes: []uint64{1, 2}, Learners: []uint64{3}},
  2384. },
  2385. }
  2386. storage := NewMemoryStorage()
  2387. sm := newTestLearnerRaft(3, []uint64{1, 2}, []uint64{3}, 8, 2, storage)
  2388. if ok := sm.restore(s); !ok {
  2389. t.Error("restore fail, want succeed")
  2390. }
  2391. if sm.raftLog.lastIndex() != s.Metadata.Index {
  2392. t.Errorf("log.lastIndex = %d, want %d", sm.raftLog.lastIndex(), s.Metadata.Index)
  2393. }
  2394. if mustTerm(sm.raftLog.term(s.Metadata.Index)) != s.Metadata.Term {
  2395. t.Errorf("log.lastTerm = %d, want %d", mustTerm(sm.raftLog.term(s.Metadata.Index)), s.Metadata.Term)
  2396. }
  2397. sg := sm.prs.VoterNodes()
  2398. if len(sg) != len(s.Metadata.ConfState.Nodes) {
  2399. t.Errorf("sm.Nodes = %+v, length not equal with %+v", sg, s.Metadata.ConfState.Nodes)
  2400. }
  2401. lns := sm.prs.LearnerNodes()
  2402. if len(lns) != len(s.Metadata.ConfState.Learners) {
  2403. t.Errorf("sm.LearnerNodes = %+v, length not equal with %+v", sg, s.Metadata.ConfState.Learners)
  2404. }
  2405. for _, n := range s.Metadata.ConfState.Nodes {
  2406. if sm.prs.Progress[n].IsLearner {
  2407. t.Errorf("sm.Node %x isLearner = %s, want %t", n, sm.prs.Progress[n], false)
  2408. }
  2409. }
  2410. for _, n := range s.Metadata.ConfState.Learners {
  2411. if !sm.prs.Progress[n].IsLearner {
  2412. t.Errorf("sm.Node %x isLearner = %s, want %t", n, sm.prs.Progress[n], true)
  2413. }
  2414. }
  2415. if ok := sm.restore(s); ok {
  2416. t.Error("restore succeed, want fail")
  2417. }
  2418. }
  2419. // TestRestoreVoterToLearner verifies that a normal peer can be downgraded to a
  2420. // learner through a snapshot. At the time of writing, we don't allow
  2421. // configuration changes to do this directly, but note that the snapshot may
  2422. // compress multiple changes to the configuration into one: the voter could have
  2423. // been removed, then readded as a learner and the snapshot reflects both
  2424. // changes. In that case, a voter receives a snapshot telling it that it is now
  2425. // a learner. In fact, the node has to accept that snapshot, or it is
  2426. // permanently cut off from the Raft log.
  2427. func TestRestoreVoterToLearner(t *testing.T) {
  2428. s := pb.Snapshot{
  2429. Metadata: pb.SnapshotMetadata{
  2430. Index: 11, // magic number
  2431. Term: 11, // magic number
  2432. ConfState: pb.ConfState{Nodes: []uint64{1, 2}, Learners: []uint64{3}},
  2433. },
  2434. }
  2435. storage := NewMemoryStorage()
  2436. sm := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, storage)
  2437. if sm.isLearner {
  2438. t.Errorf("%x is learner, want not", sm.id)
  2439. }
  2440. if ok := sm.restore(s); !ok {
  2441. t.Error("restore failed unexpectedly")
  2442. }
  2443. }
  2444. // TestRestoreLearnerPromotion checks that a learner can become to a follower after
  2445. // restoring snapshot.
  2446. func TestRestoreLearnerPromotion(t *testing.T) {
  2447. s := pb.Snapshot{
  2448. Metadata: pb.SnapshotMetadata{
  2449. Index: 11, // magic number
  2450. Term: 11, // magic number
  2451. ConfState: pb.ConfState{Nodes: []uint64{1, 2, 3}},
  2452. },
  2453. }
  2454. storage := NewMemoryStorage()
  2455. sm := newTestLearnerRaft(3, []uint64{1, 2}, []uint64{3}, 10, 1, storage)
  2456. if !sm.isLearner {
  2457. t.Errorf("%x is not learner, want yes", sm.id)
  2458. }
  2459. if ok := sm.restore(s); !ok {
  2460. t.Error("restore fail, want succeed")
  2461. }
  2462. if sm.isLearner {
  2463. t.Errorf("%x is learner, want not", sm.id)
  2464. }
  2465. }
  2466. // TestLearnerReceiveSnapshot tests that a learner can receive a snpahost from leader
  2467. func TestLearnerReceiveSnapshot(t *testing.T) {
  2468. // restore the state machine from a snapshot so it has a compacted log and a snapshot
  2469. s := pb.Snapshot{
  2470. Metadata: pb.SnapshotMetadata{
  2471. Index: 11, // magic number
  2472. Term: 11, // magic number
  2473. ConfState: pb.ConfState{Nodes: []uint64{1}, Learners: []uint64{2}},
  2474. },
  2475. }
  2476. n1 := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  2477. n2 := newTestLearnerRaft(2, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  2478. n1.restore(s)
  2479. // Force set n1 appplied index.
  2480. n1.raftLog.appliedTo(n1.raftLog.committed)
  2481. nt := newNetwork(n1, n2)
  2482. setRandomizedElectionTimeout(n1, n1.electionTimeout)
  2483. for i := 0; i < n1.electionTimeout; i++ {
  2484. n1.tick()
  2485. }
  2486. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  2487. if n2.raftLog.committed != n1.raftLog.committed {
  2488. t.Errorf("peer 2 must commit to %d, but %d", n1.raftLog.committed, n2.raftLog.committed)
  2489. }
  2490. }
  2491. func TestRestoreIgnoreSnapshot(t *testing.T) {
  2492. previousEnts := []pb.Entry{{Term: 1, Index: 1}, {Term: 1, Index: 2}, {Term: 1, Index: 3}}
  2493. commit := uint64(1)
  2494. storage := NewMemoryStorage()
  2495. sm := newTestRaft(1, []uint64{1, 2}, 10, 1, storage)
  2496. sm.raftLog.append(previousEnts...)
  2497. sm.raftLog.commitTo(commit)
  2498. s := pb.Snapshot{
  2499. Metadata: pb.SnapshotMetadata{
  2500. Index: commit,
  2501. Term: 1,
  2502. ConfState: pb.ConfState{Nodes: []uint64{1, 2}},
  2503. },
  2504. }
  2505. // ignore snapshot
  2506. if ok := sm.restore(s); ok {
  2507. t.Errorf("restore = %t, want %t", ok, false)
  2508. }
  2509. if sm.raftLog.committed != commit {
  2510. t.Errorf("commit = %d, want %d", sm.raftLog.committed, commit)
  2511. }
  2512. // ignore snapshot and fast forward commit
  2513. s.Metadata.Index = commit + 1
  2514. if ok := sm.restore(s); ok {
  2515. t.Errorf("restore = %t, want %t", ok, false)
  2516. }
  2517. if sm.raftLog.committed != commit+1 {
  2518. t.Errorf("commit = %d, want %d", sm.raftLog.committed, commit+1)
  2519. }
  2520. }
  2521. func TestProvideSnap(t *testing.T) {
  2522. // restore the state machine from a snapshot so it has a compacted log and a snapshot
  2523. s := pb.Snapshot{
  2524. Metadata: pb.SnapshotMetadata{
  2525. Index: 11, // magic number
  2526. Term: 11, // magic number
  2527. ConfState: pb.ConfState{Nodes: []uint64{1, 2}},
  2528. },
  2529. }
  2530. storage := NewMemoryStorage()
  2531. sm := newTestRaft(1, []uint64{1}, 10, 1, storage)
  2532. sm.restore(s)
  2533. sm.becomeCandidate()
  2534. sm.becomeLeader()
  2535. // force set the next of node 2, so that node 2 needs a snapshot
  2536. sm.prs.Progress[2].Next = sm.raftLog.firstIndex()
  2537. sm.Step(pb.Message{From: 2, To: 1, Type: pb.MsgAppResp, Index: sm.prs.Progress[2].Next - 1, Reject: true})
  2538. msgs := sm.readMessages()
  2539. if len(msgs) != 1 {
  2540. t.Fatalf("len(msgs) = %d, want 1", len(msgs))
  2541. }
  2542. m := msgs[0]
  2543. if m.Type != pb.MsgSnap {
  2544. t.Errorf("m.Type = %v, want %v", m.Type, pb.MsgSnap)
  2545. }
  2546. }
  2547. func TestIgnoreProvidingSnap(t *testing.T) {
  2548. // restore the state machine from a snapshot so it has a compacted log and a snapshot
  2549. s := pb.Snapshot{
  2550. Metadata: pb.SnapshotMetadata{
  2551. Index: 11, // magic number
  2552. Term: 11, // magic number
  2553. ConfState: pb.ConfState{Nodes: []uint64{1, 2}},
  2554. },
  2555. }
  2556. storage := NewMemoryStorage()
  2557. sm := newTestRaft(1, []uint64{1}, 10, 1, storage)
  2558. sm.restore(s)
  2559. sm.becomeCandidate()
  2560. sm.becomeLeader()
  2561. // force set the next of node 2, so that node 2 needs a snapshot
  2562. // change node 2 to be inactive, expect node 1 ignore sending snapshot to 2
  2563. sm.prs.Progress[2].Next = sm.raftLog.firstIndex() - 1
  2564. sm.prs.Progress[2].RecentActive = false
  2565. sm.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("somedata")}}})
  2566. msgs := sm.readMessages()
  2567. if len(msgs) != 0 {
  2568. t.Errorf("len(msgs) = %d, want 0", len(msgs))
  2569. }
  2570. }
  2571. func TestRestoreFromSnapMsg(t *testing.T) {
  2572. s := pb.Snapshot{
  2573. Metadata: pb.SnapshotMetadata{
  2574. Index: 11, // magic number
  2575. Term: 11, // magic number
  2576. ConfState: pb.ConfState{Nodes: []uint64{1, 2}},
  2577. },
  2578. }
  2579. m := pb.Message{Type: pb.MsgSnap, From: 1, Term: 2, Snapshot: s}
  2580. sm := newTestRaft(2, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2581. sm.Step(m)
  2582. if sm.lead != uint64(1) {
  2583. t.Errorf("sm.lead = %d, want 1", sm.lead)
  2584. }
  2585. // TODO(bdarnell): what should this test?
  2586. }
  2587. func TestSlowNodeRestore(t *testing.T) {
  2588. nt := newNetwork(nil, nil, nil)
  2589. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2590. nt.isolate(3)
  2591. for j := 0; j <= 100; j++ {
  2592. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2593. }
  2594. lead := nt.peers[1].(*raft)
  2595. nextEnts(lead, nt.storage[1])
  2596. nt.storage[1].CreateSnapshot(lead.raftLog.applied, &pb.ConfState{Nodes: lead.prs.VoterNodes()}, nil)
  2597. nt.storage[1].Compact(lead.raftLog.applied)
  2598. nt.recover()
  2599. // send heartbeats so that the leader can learn everyone is active.
  2600. // node 3 will only be considered as active when node 1 receives a reply from it.
  2601. for {
  2602. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgBeat})
  2603. if lead.prs.Progress[3].RecentActive {
  2604. break
  2605. }
  2606. }
  2607. // trigger a snapshot
  2608. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2609. follower := nt.peers[3].(*raft)
  2610. // trigger a commit
  2611. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2612. if follower.raftLog.committed != lead.raftLog.committed {
  2613. t.Errorf("follower.committed = %d, want %d", follower.raftLog.committed, lead.raftLog.committed)
  2614. }
  2615. }
  2616. // TestStepConfig tests that when raft step msgProp in EntryConfChange type,
  2617. // it appends the entry to log and sets pendingConf to be true.
  2618. func TestStepConfig(t *testing.T) {
  2619. // a raft that cannot make progress
  2620. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2621. r.becomeCandidate()
  2622. r.becomeLeader()
  2623. index := r.raftLog.lastIndex()
  2624. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  2625. if g := r.raftLog.lastIndex(); g != index+1 {
  2626. t.Errorf("index = %d, want %d", g, index+1)
  2627. }
  2628. if r.pendingConfIndex != index+1 {
  2629. t.Errorf("pendingConfIndex = %d, want %d", r.pendingConfIndex, index+1)
  2630. }
  2631. }
  2632. // TestStepIgnoreConfig tests that if raft step the second msgProp in
  2633. // EntryConfChange type when the first one is uncommitted, the node will set
  2634. // the proposal to noop and keep its original state.
  2635. func TestStepIgnoreConfig(t *testing.T) {
  2636. // a raft that cannot make progress
  2637. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2638. r.becomeCandidate()
  2639. r.becomeLeader()
  2640. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  2641. index := r.raftLog.lastIndex()
  2642. pendingConfIndex := r.pendingConfIndex
  2643. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Type: pb.EntryConfChange}}})
  2644. wents := []pb.Entry{{Type: pb.EntryNormal, Term: 1, Index: 3, Data: nil}}
  2645. ents, err := r.raftLog.entries(index+1, noLimit)
  2646. if err != nil {
  2647. t.Fatalf("unexpected error %v", err)
  2648. }
  2649. if !reflect.DeepEqual(ents, wents) {
  2650. t.Errorf("ents = %+v, want %+v", ents, wents)
  2651. }
  2652. if r.pendingConfIndex != pendingConfIndex {
  2653. t.Errorf("pendingConfIndex = %d, want %d", r.pendingConfIndex, pendingConfIndex)
  2654. }
  2655. }
  2656. // TestNewLeaderPendingConfig tests that new leader sets its pendingConfigIndex
  2657. // based on uncommitted entries.
  2658. func TestNewLeaderPendingConfig(t *testing.T) {
  2659. tests := []struct {
  2660. addEntry bool
  2661. wpendingIndex uint64
  2662. }{
  2663. {false, 0},
  2664. {true, 1},
  2665. }
  2666. for i, tt := range tests {
  2667. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2668. if tt.addEntry {
  2669. mustAppendEntry(r, pb.Entry{Type: pb.EntryNormal})
  2670. }
  2671. r.becomeCandidate()
  2672. r.becomeLeader()
  2673. if r.pendingConfIndex != tt.wpendingIndex {
  2674. t.Errorf("#%d: pendingConfIndex = %d, want %d",
  2675. i, r.pendingConfIndex, tt.wpendingIndex)
  2676. }
  2677. }
  2678. }
  2679. // TestAddNode tests that addNode could update nodes correctly.
  2680. func TestAddNode(t *testing.T) {
  2681. r := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  2682. r.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddNode})
  2683. nodes := r.prs.VoterNodes()
  2684. wnodes := []uint64{1, 2}
  2685. if !reflect.DeepEqual(nodes, wnodes) {
  2686. t.Errorf("nodes = %v, want %v", nodes, wnodes)
  2687. }
  2688. }
  2689. // TestAddLearner tests that addLearner could update nodes correctly.
  2690. func TestAddLearner(t *testing.T) {
  2691. r := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  2692. r.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddLearnerNode})
  2693. nodes := r.prs.LearnerNodes()
  2694. wnodes := []uint64{2}
  2695. if !reflect.DeepEqual(nodes, wnodes) {
  2696. t.Errorf("nodes = %v, want %v", nodes, wnodes)
  2697. }
  2698. if !r.prs.Progress[2].IsLearner {
  2699. t.Errorf("node 2 is learner %t, want %t", r.prs.Progress[2].IsLearner, true)
  2700. }
  2701. }
  2702. // TestAddNodeCheckQuorum tests that addNode does not trigger a leader election
  2703. // immediately when checkQuorum is set.
  2704. func TestAddNodeCheckQuorum(t *testing.T) {
  2705. r := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  2706. r.checkQuorum = true
  2707. r.becomeCandidate()
  2708. r.becomeLeader()
  2709. for i := 0; i < r.electionTimeout-1; i++ {
  2710. r.tick()
  2711. }
  2712. r.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddNode})
  2713. // This tick will reach electionTimeout, which triggers a quorum check.
  2714. r.tick()
  2715. // Node 1 should still be the leader after a single tick.
  2716. if r.state != StateLeader {
  2717. t.Errorf("state = %v, want %v", r.state, StateLeader)
  2718. }
  2719. // After another electionTimeout ticks without hearing from node 2,
  2720. // node 1 should step down.
  2721. for i := 0; i < r.electionTimeout; i++ {
  2722. r.tick()
  2723. }
  2724. if r.state != StateFollower {
  2725. t.Errorf("state = %v, want %v", r.state, StateFollower)
  2726. }
  2727. }
  2728. // TestRemoveNode tests that removeNode could update nodes and
  2729. // and removed list correctly.
  2730. func TestRemoveNode(t *testing.T) {
  2731. r := newTestRaft(1, []uint64{1, 2}, 10, 1, NewMemoryStorage())
  2732. r.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeRemoveNode})
  2733. w := []uint64{1}
  2734. if g := r.prs.VoterNodes(); !reflect.DeepEqual(g, w) {
  2735. t.Errorf("nodes = %v, want %v", g, w)
  2736. }
  2737. // remove all nodes from cluster
  2738. r.applyConfChange(pb.ConfChange{NodeID: 1, Type: pb.ConfChangeRemoveNode})
  2739. w = []uint64{}
  2740. if g := r.prs.VoterNodes(); !reflect.DeepEqual(g, w) {
  2741. t.Errorf("nodes = %v, want %v", g, w)
  2742. }
  2743. }
  2744. // TestRemoveLearner tests that removeNode could update nodes and
  2745. // and removed list correctly.
  2746. func TestRemoveLearner(t *testing.T) {
  2747. r := newTestLearnerRaft(1, []uint64{1}, []uint64{2}, 10, 1, NewMemoryStorage())
  2748. r.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeRemoveNode})
  2749. w := []uint64{1}
  2750. if g := r.prs.VoterNodes(); !reflect.DeepEqual(g, w) {
  2751. t.Errorf("nodes = %v, want %v", g, w)
  2752. }
  2753. w = []uint64{}
  2754. if g := r.prs.LearnerNodes(); !reflect.DeepEqual(g, w) {
  2755. t.Errorf("nodes = %v, want %v", g, w)
  2756. }
  2757. // remove all nodes from cluster
  2758. r.applyConfChange(pb.ConfChange{NodeID: 1, Type: pb.ConfChangeRemoveNode})
  2759. if g := r.prs.VoterNodes(); !reflect.DeepEqual(g, w) {
  2760. t.Errorf("nodes = %v, want %v", g, w)
  2761. }
  2762. }
  2763. func TestPromotable(t *testing.T) {
  2764. id := uint64(1)
  2765. tests := []struct {
  2766. peers []uint64
  2767. wp bool
  2768. }{
  2769. {[]uint64{1}, true},
  2770. {[]uint64{1, 2, 3}, true},
  2771. {[]uint64{}, false},
  2772. {[]uint64{2, 3}, false},
  2773. }
  2774. for i, tt := range tests {
  2775. r := newTestRaft(id, tt.peers, 5, 1, NewMemoryStorage())
  2776. if g := r.promotable(); g != tt.wp {
  2777. t.Errorf("#%d: promotable = %v, want %v", i, g, tt.wp)
  2778. }
  2779. }
  2780. }
  2781. func TestRaftNodes(t *testing.T) {
  2782. tests := []struct {
  2783. ids []uint64
  2784. wids []uint64
  2785. }{
  2786. {
  2787. []uint64{1, 2, 3},
  2788. []uint64{1, 2, 3},
  2789. },
  2790. {
  2791. []uint64{3, 2, 1},
  2792. []uint64{1, 2, 3},
  2793. },
  2794. }
  2795. for i, tt := range tests {
  2796. r := newTestRaft(1, tt.ids, 10, 1, NewMemoryStorage())
  2797. if !reflect.DeepEqual(r.prs.VoterNodes(), tt.wids) {
  2798. t.Errorf("#%d: nodes = %+v, want %+v", i, r.prs.VoterNodes(), tt.wids)
  2799. }
  2800. }
  2801. }
  2802. func TestCampaignWhileLeader(t *testing.T) {
  2803. testCampaignWhileLeader(t, false)
  2804. }
  2805. func TestPreCampaignWhileLeader(t *testing.T) {
  2806. testCampaignWhileLeader(t, true)
  2807. }
  2808. func testCampaignWhileLeader(t *testing.T, preVote bool) {
  2809. cfg := newTestConfig(1, []uint64{1}, 5, 1, NewMemoryStorage())
  2810. cfg.PreVote = preVote
  2811. r := newRaft(cfg)
  2812. if r.state != StateFollower {
  2813. t.Errorf("expected new node to be follower but got %s", r.state)
  2814. }
  2815. // We don't call campaign() directly because it comes after the check
  2816. // for our current state.
  2817. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2818. if r.state != StateLeader {
  2819. t.Errorf("expected single-node election to become leader but got %s", r.state)
  2820. }
  2821. term := r.Term
  2822. r.Step(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2823. if r.state != StateLeader {
  2824. t.Errorf("expected to remain leader but got %s", r.state)
  2825. }
  2826. if r.Term != term {
  2827. t.Errorf("expected to remain in term %v but got %v", term, r.Term)
  2828. }
  2829. }
  2830. // TestCommitAfterRemoveNode verifies that pending commands can become
  2831. // committed when a config change reduces the quorum requirements.
  2832. func TestCommitAfterRemoveNode(t *testing.T) {
  2833. // Create a cluster with two nodes.
  2834. s := NewMemoryStorage()
  2835. r := newTestRaft(1, []uint64{1, 2}, 5, 1, s)
  2836. r.becomeCandidate()
  2837. r.becomeLeader()
  2838. // Begin to remove the second node.
  2839. cc := pb.ConfChange{
  2840. Type: pb.ConfChangeRemoveNode,
  2841. NodeID: 2,
  2842. }
  2843. ccData, err := cc.Marshal()
  2844. if err != nil {
  2845. t.Fatal(err)
  2846. }
  2847. r.Step(pb.Message{
  2848. Type: pb.MsgProp,
  2849. Entries: []pb.Entry{
  2850. {Type: pb.EntryConfChange, Data: ccData},
  2851. },
  2852. })
  2853. // Stabilize the log and make sure nothing is committed yet.
  2854. if ents := nextEnts(r, s); len(ents) > 0 {
  2855. t.Fatalf("unexpected committed entries: %v", ents)
  2856. }
  2857. ccIndex := r.raftLog.lastIndex()
  2858. // While the config change is pending, make another proposal.
  2859. r.Step(pb.Message{
  2860. Type: pb.MsgProp,
  2861. Entries: []pb.Entry{
  2862. {Type: pb.EntryNormal, Data: []byte("hello")},
  2863. },
  2864. })
  2865. // Node 2 acknowledges the config change, committing it.
  2866. r.Step(pb.Message{
  2867. Type: pb.MsgAppResp,
  2868. From: 2,
  2869. Index: ccIndex,
  2870. })
  2871. ents := nextEnts(r, s)
  2872. if len(ents) != 2 {
  2873. t.Fatalf("expected two committed entries, got %v", ents)
  2874. }
  2875. if ents[0].Type != pb.EntryNormal || ents[0].Data != nil {
  2876. t.Fatalf("expected ents[0] to be empty, but got %v", ents[0])
  2877. }
  2878. if ents[1].Type != pb.EntryConfChange {
  2879. t.Fatalf("expected ents[1] to be EntryConfChange, got %v", ents[1])
  2880. }
  2881. // Apply the config change. This reduces quorum requirements so the
  2882. // pending command can now commit.
  2883. r.applyConfChange(cc)
  2884. ents = nextEnts(r, s)
  2885. if len(ents) != 1 || ents[0].Type != pb.EntryNormal ||
  2886. string(ents[0].Data) != "hello" {
  2887. t.Fatalf("expected one committed EntryNormal, got %v", ents)
  2888. }
  2889. }
  2890. // TestLeaderTransferToUpToDateNode verifies transferring should succeed
  2891. // if the transferee has the most up-to-date log entries when transfer starts.
  2892. func TestLeaderTransferToUpToDateNode(t *testing.T) {
  2893. nt := newNetwork(nil, nil, nil)
  2894. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2895. lead := nt.peers[1].(*raft)
  2896. if lead.lead != 1 {
  2897. t.Fatalf("after election leader is %x, want 1", lead.lead)
  2898. }
  2899. // Transfer leadership to 2.
  2900. nt.send(pb.Message{From: 2, To: 1, Type: pb.MsgTransferLeader})
  2901. checkLeaderTransferState(t, lead, StateFollower, 2)
  2902. // After some log replication, transfer leadership back to 1.
  2903. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2904. nt.send(pb.Message{From: 1, To: 2, Type: pb.MsgTransferLeader})
  2905. checkLeaderTransferState(t, lead, StateLeader, 1)
  2906. }
  2907. // TestLeaderTransferToUpToDateNodeFromFollower verifies transferring should succeed
  2908. // if the transferee has the most up-to-date log entries when transfer starts.
  2909. // Not like TestLeaderTransferToUpToDateNode, where the leader transfer message
  2910. // is sent to the leader, in this test case every leader transfer message is sent
  2911. // to the follower.
  2912. func TestLeaderTransferToUpToDateNodeFromFollower(t *testing.T) {
  2913. nt := newNetwork(nil, nil, nil)
  2914. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2915. lead := nt.peers[1].(*raft)
  2916. if lead.lead != 1 {
  2917. t.Fatalf("after election leader is %x, want 1", lead.lead)
  2918. }
  2919. // Transfer leadership to 2.
  2920. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgTransferLeader})
  2921. checkLeaderTransferState(t, lead, StateFollower, 2)
  2922. // After some log replication, transfer leadership back to 1.
  2923. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2924. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgTransferLeader})
  2925. checkLeaderTransferState(t, lead, StateLeader, 1)
  2926. }
  2927. // TestLeaderTransferWithCheckQuorum ensures transferring leader still works
  2928. // even the current leader is still under its leader lease
  2929. func TestLeaderTransferWithCheckQuorum(t *testing.T) {
  2930. nt := newNetwork(nil, nil, nil)
  2931. for i := 1; i < 4; i++ {
  2932. r := nt.peers[uint64(i)].(*raft)
  2933. r.checkQuorum = true
  2934. setRandomizedElectionTimeout(r, r.electionTimeout+i)
  2935. }
  2936. // Letting peer 2 electionElapsed reach to timeout so that it can vote for peer 1
  2937. f := nt.peers[2].(*raft)
  2938. for i := 0; i < f.electionTimeout; i++ {
  2939. f.tick()
  2940. }
  2941. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2942. lead := nt.peers[1].(*raft)
  2943. if lead.lead != 1 {
  2944. t.Fatalf("after election leader is %x, want 1", lead.lead)
  2945. }
  2946. // Transfer leadership to 2.
  2947. nt.send(pb.Message{From: 2, To: 1, Type: pb.MsgTransferLeader})
  2948. checkLeaderTransferState(t, lead, StateFollower, 2)
  2949. // After some log replication, transfer leadership back to 1.
  2950. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2951. nt.send(pb.Message{From: 1, To: 2, Type: pb.MsgTransferLeader})
  2952. checkLeaderTransferState(t, lead, StateLeader, 1)
  2953. }
  2954. func TestLeaderTransferToSlowFollower(t *testing.T) {
  2955. defaultLogger.EnableDebug()
  2956. nt := newNetwork(nil, nil, nil)
  2957. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2958. nt.isolate(3)
  2959. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2960. nt.recover()
  2961. lead := nt.peers[1].(*raft)
  2962. if lead.prs.Progress[3].Match != 1 {
  2963. t.Fatalf("node 1 has match %x for node 3, want %x", lead.prs.Progress[3].Match, 1)
  2964. }
  2965. // Transfer leadership to 3 when node 3 is lack of log.
  2966. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  2967. checkLeaderTransferState(t, lead, StateFollower, 3)
  2968. }
  2969. func TestLeaderTransferAfterSnapshot(t *testing.T) {
  2970. nt := newNetwork(nil, nil, nil)
  2971. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2972. nt.isolate(3)
  2973. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  2974. lead := nt.peers[1].(*raft)
  2975. nextEnts(lead, nt.storage[1])
  2976. nt.storage[1].CreateSnapshot(lead.raftLog.applied, &pb.ConfState{Nodes: lead.prs.VoterNodes()}, nil)
  2977. nt.storage[1].Compact(lead.raftLog.applied)
  2978. nt.recover()
  2979. if lead.prs.Progress[3].Match != 1 {
  2980. t.Fatalf("node 1 has match %x for node 3, want %x", lead.prs.Progress[3].Match, 1)
  2981. }
  2982. // Transfer leadership to 3 when node 3 is lack of snapshot.
  2983. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  2984. // Send pb.MsgHeartbeatResp to leader to trigger a snapshot for node 3.
  2985. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgHeartbeatResp})
  2986. checkLeaderTransferState(t, lead, StateFollower, 3)
  2987. }
  2988. func TestLeaderTransferToSelf(t *testing.T) {
  2989. nt := newNetwork(nil, nil, nil)
  2990. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2991. lead := nt.peers[1].(*raft)
  2992. // Transfer leadership to self, there will be noop.
  2993. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgTransferLeader})
  2994. checkLeaderTransferState(t, lead, StateLeader, 1)
  2995. }
  2996. func TestLeaderTransferToNonExistingNode(t *testing.T) {
  2997. nt := newNetwork(nil, nil, nil)
  2998. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  2999. lead := nt.peers[1].(*raft)
  3000. // Transfer leadership to non-existing node, there will be noop.
  3001. nt.send(pb.Message{From: 4, To: 1, Type: pb.MsgTransferLeader})
  3002. checkLeaderTransferState(t, lead, StateLeader, 1)
  3003. }
  3004. func TestLeaderTransferTimeout(t *testing.T) {
  3005. nt := newNetwork(nil, nil, nil)
  3006. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3007. nt.isolate(3)
  3008. lead := nt.peers[1].(*raft)
  3009. // Transfer leadership to isolated node, wait for timeout.
  3010. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3011. if lead.leadTransferee != 3 {
  3012. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3013. }
  3014. for i := 0; i < lead.heartbeatTimeout; i++ {
  3015. lead.tick()
  3016. }
  3017. if lead.leadTransferee != 3 {
  3018. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3019. }
  3020. for i := 0; i < lead.electionTimeout-lead.heartbeatTimeout; i++ {
  3021. lead.tick()
  3022. }
  3023. checkLeaderTransferState(t, lead, StateLeader, 1)
  3024. }
  3025. func TestLeaderTransferIgnoreProposal(t *testing.T) {
  3026. nt := newNetwork(nil, nil, nil)
  3027. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3028. nt.isolate(3)
  3029. lead := nt.peers[1].(*raft)
  3030. // Transfer leadership to isolated node to let transfer pending, then send proposal.
  3031. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3032. if lead.leadTransferee != 3 {
  3033. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3034. }
  3035. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  3036. err := lead.Step(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{}}})
  3037. if err != ErrProposalDropped {
  3038. t.Fatalf("should return drop proposal error while transferring")
  3039. }
  3040. if lead.prs.Progress[1].Match != 1 {
  3041. t.Fatalf("node 1 has match %x, want %x", lead.prs.Progress[1].Match, 1)
  3042. }
  3043. }
  3044. func TestLeaderTransferReceiveHigherTermVote(t *testing.T) {
  3045. nt := newNetwork(nil, nil, nil)
  3046. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3047. nt.isolate(3)
  3048. lead := nt.peers[1].(*raft)
  3049. // Transfer leadership to isolated node to let transfer pending.
  3050. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3051. if lead.leadTransferee != 3 {
  3052. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3053. }
  3054. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup, Index: 1, Term: 2})
  3055. checkLeaderTransferState(t, lead, StateFollower, 2)
  3056. }
  3057. func TestLeaderTransferRemoveNode(t *testing.T) {
  3058. nt := newNetwork(nil, nil, nil)
  3059. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3060. nt.ignore(pb.MsgTimeoutNow)
  3061. lead := nt.peers[1].(*raft)
  3062. // The leadTransferee is removed when leadship transferring.
  3063. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3064. if lead.leadTransferee != 3 {
  3065. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3066. }
  3067. lead.applyConfChange(pb.ConfChange{NodeID: 3, Type: pb.ConfChangeRemoveNode})
  3068. checkLeaderTransferState(t, lead, StateLeader, 1)
  3069. }
  3070. // TestLeaderTransferBack verifies leadership can transfer back to self when last transfer is pending.
  3071. func TestLeaderTransferBack(t *testing.T) {
  3072. nt := newNetwork(nil, nil, nil)
  3073. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3074. nt.isolate(3)
  3075. lead := nt.peers[1].(*raft)
  3076. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3077. if lead.leadTransferee != 3 {
  3078. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3079. }
  3080. // Transfer leadership back to self.
  3081. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgTransferLeader})
  3082. checkLeaderTransferState(t, lead, StateLeader, 1)
  3083. }
  3084. // TestLeaderTransferSecondTransferToAnotherNode verifies leader can transfer to another node
  3085. // when last transfer is pending.
  3086. func TestLeaderTransferSecondTransferToAnotherNode(t *testing.T) {
  3087. nt := newNetwork(nil, nil, nil)
  3088. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3089. nt.isolate(3)
  3090. lead := nt.peers[1].(*raft)
  3091. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3092. if lead.leadTransferee != 3 {
  3093. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3094. }
  3095. // Transfer leadership to another node.
  3096. nt.send(pb.Message{From: 2, To: 1, Type: pb.MsgTransferLeader})
  3097. checkLeaderTransferState(t, lead, StateFollower, 2)
  3098. }
  3099. // TestLeaderTransferSecondTransferToSameNode verifies second transfer leader request
  3100. // to the same node should not extend the timeout while the first one is pending.
  3101. func TestLeaderTransferSecondTransferToSameNode(t *testing.T) {
  3102. nt := newNetwork(nil, nil, nil)
  3103. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3104. nt.isolate(3)
  3105. lead := nt.peers[1].(*raft)
  3106. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3107. if lead.leadTransferee != 3 {
  3108. t.Fatalf("wait transferring, leadTransferee = %v, want %v", lead.leadTransferee, 3)
  3109. }
  3110. for i := 0; i < lead.heartbeatTimeout; i++ {
  3111. lead.tick()
  3112. }
  3113. // Second transfer leadership request to the same node.
  3114. nt.send(pb.Message{From: 3, To: 1, Type: pb.MsgTransferLeader})
  3115. for i := 0; i < lead.electionTimeout-lead.heartbeatTimeout; i++ {
  3116. lead.tick()
  3117. }
  3118. checkLeaderTransferState(t, lead, StateLeader, 1)
  3119. }
  3120. func checkLeaderTransferState(t *testing.T, r *raft, state StateType, lead uint64) {
  3121. if r.state != state || r.lead != lead {
  3122. t.Fatalf("after transferring, node has state %v lead %v, want state %v lead %v", r.state, r.lead, state, lead)
  3123. }
  3124. if r.leadTransferee != None {
  3125. t.Fatalf("after transferring, node has leadTransferee %v, want leadTransferee %v", r.leadTransferee, None)
  3126. }
  3127. }
  3128. // TestTransferNonMember verifies that when a MsgTimeoutNow arrives at
  3129. // a node that has been removed from the group, nothing happens.
  3130. // (previously, if the node also got votes, it would panic as it
  3131. // transitioned to StateLeader)
  3132. func TestTransferNonMember(t *testing.T) {
  3133. r := newTestRaft(1, []uint64{2, 3, 4}, 5, 1, NewMemoryStorage())
  3134. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgTimeoutNow})
  3135. r.Step(pb.Message{From: 2, To: 1, Type: pb.MsgVoteResp})
  3136. r.Step(pb.Message{From: 3, To: 1, Type: pb.MsgVoteResp})
  3137. if r.state != StateFollower {
  3138. t.Fatalf("state is %s, want StateFollower", r.state)
  3139. }
  3140. }
  3141. // TestNodeWithSmallerTermCanCompleteElection tests the scenario where a node
  3142. // that has been partitioned away (and fallen behind) rejoins the cluster at
  3143. // about the same time the leader node gets partitioned away.
  3144. // Previously the cluster would come to a standstill when run with PreVote
  3145. // enabled.
  3146. func TestNodeWithSmallerTermCanCompleteElection(t *testing.T) {
  3147. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3148. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3149. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3150. n1.becomeFollower(1, None)
  3151. n2.becomeFollower(1, None)
  3152. n3.becomeFollower(1, None)
  3153. n1.preVote = true
  3154. n2.preVote = true
  3155. n3.preVote = true
  3156. // cause a network partition to isolate node 3
  3157. nt := newNetwork(n1, n2, n3)
  3158. nt.cut(1, 3)
  3159. nt.cut(2, 3)
  3160. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3161. sm := nt.peers[1].(*raft)
  3162. if sm.state != StateLeader {
  3163. t.Errorf("peer 1 state: %s, want %s", sm.state, StateLeader)
  3164. }
  3165. sm = nt.peers[2].(*raft)
  3166. if sm.state != StateFollower {
  3167. t.Errorf("peer 2 state: %s, want %s", sm.state, StateFollower)
  3168. }
  3169. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3170. sm = nt.peers[3].(*raft)
  3171. if sm.state != StatePreCandidate {
  3172. t.Errorf("peer 3 state: %s, want %s", sm.state, StatePreCandidate)
  3173. }
  3174. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3175. // check whether the term values are expected
  3176. // a.Term == 3
  3177. // b.Term == 3
  3178. // c.Term == 1
  3179. sm = nt.peers[1].(*raft)
  3180. if sm.Term != 3 {
  3181. t.Errorf("peer 1 term: %d, want %d", sm.Term, 3)
  3182. }
  3183. sm = nt.peers[2].(*raft)
  3184. if sm.Term != 3 {
  3185. t.Errorf("peer 2 term: %d, want %d", sm.Term, 3)
  3186. }
  3187. sm = nt.peers[3].(*raft)
  3188. if sm.Term != 1 {
  3189. t.Errorf("peer 3 term: %d, want %d", sm.Term, 1)
  3190. }
  3191. // check state
  3192. // a == follower
  3193. // b == leader
  3194. // c == pre-candidate
  3195. sm = nt.peers[1].(*raft)
  3196. if sm.state != StateFollower {
  3197. t.Errorf("peer 1 state: %s, want %s", sm.state, StateFollower)
  3198. }
  3199. sm = nt.peers[2].(*raft)
  3200. if sm.state != StateLeader {
  3201. t.Errorf("peer 2 state: %s, want %s", sm.state, StateLeader)
  3202. }
  3203. sm = nt.peers[3].(*raft)
  3204. if sm.state != StatePreCandidate {
  3205. t.Errorf("peer 3 state: %s, want %s", sm.state, StatePreCandidate)
  3206. }
  3207. sm.logger.Infof("going to bring back peer 3 and kill peer 2")
  3208. // recover the network then immediately isolate b which is currently
  3209. // the leader, this is to emulate the crash of b.
  3210. nt.recover()
  3211. nt.cut(2, 1)
  3212. nt.cut(2, 3)
  3213. // call for election
  3214. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3215. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3216. // do we have a leader?
  3217. sma := nt.peers[1].(*raft)
  3218. smb := nt.peers[3].(*raft)
  3219. if sma.state != StateLeader && smb.state != StateLeader {
  3220. t.Errorf("no leader")
  3221. }
  3222. }
  3223. // TestPreVoteWithSplitVote verifies that after split vote, cluster can complete
  3224. // election in next round.
  3225. func TestPreVoteWithSplitVote(t *testing.T) {
  3226. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3227. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3228. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3229. n1.becomeFollower(1, None)
  3230. n2.becomeFollower(1, None)
  3231. n3.becomeFollower(1, None)
  3232. n1.preVote = true
  3233. n2.preVote = true
  3234. n3.preVote = true
  3235. nt := newNetwork(n1, n2, n3)
  3236. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3237. // simulate leader down. followers start split vote.
  3238. nt.isolate(1)
  3239. nt.send([]pb.Message{
  3240. {From: 2, To: 2, Type: pb.MsgHup},
  3241. {From: 3, To: 3, Type: pb.MsgHup},
  3242. }...)
  3243. // check whether the term values are expected
  3244. // n2.Term == 3
  3245. // n3.Term == 3
  3246. sm := nt.peers[2].(*raft)
  3247. if sm.Term != 3 {
  3248. t.Errorf("peer 2 term: %d, want %d", sm.Term, 3)
  3249. }
  3250. sm = nt.peers[3].(*raft)
  3251. if sm.Term != 3 {
  3252. t.Errorf("peer 3 term: %d, want %d", sm.Term, 3)
  3253. }
  3254. // check state
  3255. // n2 == candidate
  3256. // n3 == candidate
  3257. sm = nt.peers[2].(*raft)
  3258. if sm.state != StateCandidate {
  3259. t.Errorf("peer 2 state: %s, want %s", sm.state, StateCandidate)
  3260. }
  3261. sm = nt.peers[3].(*raft)
  3262. if sm.state != StateCandidate {
  3263. t.Errorf("peer 3 state: %s, want %s", sm.state, StateCandidate)
  3264. }
  3265. // node 2 election timeout first
  3266. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3267. // check whether the term values are expected
  3268. // n2.Term == 4
  3269. // n3.Term == 4
  3270. sm = nt.peers[2].(*raft)
  3271. if sm.Term != 4 {
  3272. t.Errorf("peer 2 term: %d, want %d", sm.Term, 4)
  3273. }
  3274. sm = nt.peers[3].(*raft)
  3275. if sm.Term != 4 {
  3276. t.Errorf("peer 3 term: %d, want %d", sm.Term, 4)
  3277. }
  3278. // check state
  3279. // n2 == leader
  3280. // n3 == follower
  3281. sm = nt.peers[2].(*raft)
  3282. if sm.state != StateLeader {
  3283. t.Errorf("peer 2 state: %s, want %s", sm.state, StateLeader)
  3284. }
  3285. sm = nt.peers[3].(*raft)
  3286. if sm.state != StateFollower {
  3287. t.Errorf("peer 3 state: %s, want %s", sm.state, StateFollower)
  3288. }
  3289. }
  3290. // TestPreVoteWithCheckQuorum ensures that after a node become pre-candidate,
  3291. // it will checkQuorum correctly.
  3292. func TestPreVoteWithCheckQuorum(t *testing.T) {
  3293. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3294. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3295. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3296. n1.becomeFollower(1, None)
  3297. n2.becomeFollower(1, None)
  3298. n3.becomeFollower(1, None)
  3299. n1.preVote = true
  3300. n2.preVote = true
  3301. n3.preVote = true
  3302. n1.checkQuorum = true
  3303. n2.checkQuorum = true
  3304. n3.checkQuorum = true
  3305. nt := newNetwork(n1, n2, n3)
  3306. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3307. // isolate node 1. node 2 and node 3 have leader info
  3308. nt.isolate(1)
  3309. // check state
  3310. sm := nt.peers[1].(*raft)
  3311. if sm.state != StateLeader {
  3312. t.Fatalf("peer 1 state: %s, want %s", sm.state, StateLeader)
  3313. }
  3314. sm = nt.peers[2].(*raft)
  3315. if sm.state != StateFollower {
  3316. t.Fatalf("peer 2 state: %s, want %s", sm.state, StateFollower)
  3317. }
  3318. sm = nt.peers[3].(*raft)
  3319. if sm.state != StateFollower {
  3320. t.Fatalf("peer 3 state: %s, want %s", sm.state, StateFollower)
  3321. }
  3322. // node 2 will ignore node 3's PreVote
  3323. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3324. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3325. // Do we have a leader?
  3326. if n2.state != StateLeader && n3.state != StateFollower {
  3327. t.Errorf("no leader")
  3328. }
  3329. }
  3330. // TestLearnerCampaign verifies that a learner won't campaign even if it receives
  3331. // a MsgHup or MsgTimeoutNow.
  3332. func TestLearnerCampaign(t *testing.T) {
  3333. n1 := newTestRaft(1, []uint64{1}, 10, 1, NewMemoryStorage())
  3334. n1.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddLearnerNode})
  3335. n2 := newTestRaft(2, []uint64{1}, 10, 1, NewMemoryStorage())
  3336. n2.applyConfChange(pb.ConfChange{NodeID: 2, Type: pb.ConfChangeAddLearnerNode})
  3337. nt := newNetwork(n1, n2)
  3338. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3339. if !n2.isLearner {
  3340. t.Fatalf("failed to make n2 a learner")
  3341. }
  3342. if n2.state != StateFollower {
  3343. t.Fatalf("n2 campaigned despite being learner")
  3344. }
  3345. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3346. if n1.state != StateLeader || n1.lead != 1 {
  3347. t.Fatalf("n1 did not become leader")
  3348. }
  3349. // NB: TransferLeader already checks that the recipient is not a learner, but
  3350. // the check could have happened by the time the recipient becomes a learner,
  3351. // in which case it will receive MsgTimeoutNow as in this test case and we
  3352. // verify that it's ignored.
  3353. nt.send(pb.Message{From: 1, To: 2, Type: pb.MsgTimeoutNow})
  3354. if n2.state != StateFollower {
  3355. t.Fatalf("n2 accepted leadership transfer despite being learner")
  3356. }
  3357. }
  3358. // simulate rolling update a cluster for Pre-Vote. cluster has 3 nodes [n1, n2, n3].
  3359. // n1 is leader with term 2
  3360. // n2 is follower with term 2
  3361. // n3 is partitioned, with term 4 and less log, state is candidate
  3362. func newPreVoteMigrationCluster(t *testing.T) *network {
  3363. n1 := newTestRaft(1, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3364. n2 := newTestRaft(2, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3365. n3 := newTestRaft(3, []uint64{1, 2, 3}, 10, 1, NewMemoryStorage())
  3366. n1.becomeFollower(1, None)
  3367. n2.becomeFollower(1, None)
  3368. n3.becomeFollower(1, None)
  3369. n1.preVote = true
  3370. n2.preVote = true
  3371. // We intentionally do not enable PreVote for n3, this is done so in order
  3372. // to simulate a rolling restart process where it's possible to have a mixed
  3373. // version cluster with replicas with PreVote enabled, and replicas without.
  3374. nt := newNetwork(n1, n2, n3)
  3375. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgHup})
  3376. // Cause a network partition to isolate n3.
  3377. nt.isolate(3)
  3378. nt.send(pb.Message{From: 1, To: 1, Type: pb.MsgProp, Entries: []pb.Entry{{Data: []byte("some data")}}})
  3379. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3380. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3381. // check state
  3382. // n1.state == StateLeader
  3383. // n2.state == StateFollower
  3384. // n3.state == StateCandidate
  3385. if n1.state != StateLeader {
  3386. t.Fatalf("node 1 state: %s, want %s", n1.state, StateLeader)
  3387. }
  3388. if n2.state != StateFollower {
  3389. t.Fatalf("node 2 state: %s, want %s", n2.state, StateFollower)
  3390. }
  3391. if n3.state != StateCandidate {
  3392. t.Fatalf("node 3 state: %s, want %s", n3.state, StateCandidate)
  3393. }
  3394. // check term
  3395. // n1.Term == 2
  3396. // n2.Term == 2
  3397. // n3.Term == 4
  3398. if n1.Term != 2 {
  3399. t.Fatalf("node 1 term: %d, want %d", n1.Term, 2)
  3400. }
  3401. if n2.Term != 2 {
  3402. t.Fatalf("node 2 term: %d, want %d", n2.Term, 2)
  3403. }
  3404. if n3.Term != 4 {
  3405. t.Fatalf("node 3 term: %d, want %d", n3.Term, 4)
  3406. }
  3407. // Enable prevote on n3, then recover the network
  3408. n3.preVote = true
  3409. nt.recover()
  3410. return nt
  3411. }
  3412. func TestPreVoteMigrationCanCompleteElection(t *testing.T) {
  3413. nt := newPreVoteMigrationCluster(t)
  3414. // n1 is leader with term 2
  3415. // n2 is follower with term 2
  3416. // n3 is pre-candidate with term 4, and less log
  3417. n2 := nt.peers[2].(*raft)
  3418. n3 := nt.peers[3].(*raft)
  3419. // simulate leader down
  3420. nt.isolate(1)
  3421. // Call for elections from both n2 and n3.
  3422. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3423. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3424. // check state
  3425. // n2.state == Follower
  3426. // n3.state == PreCandidate
  3427. if n2.state != StateFollower {
  3428. t.Errorf("node 2 state: %s, want %s", n2.state, StateFollower)
  3429. }
  3430. if n3.state != StatePreCandidate {
  3431. t.Errorf("node 3 state: %s, want %s", n3.state, StatePreCandidate)
  3432. }
  3433. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3434. nt.send(pb.Message{From: 2, To: 2, Type: pb.MsgHup})
  3435. // Do we have a leader?
  3436. if n2.state != StateLeader && n3.state != StateFollower {
  3437. t.Errorf("no leader")
  3438. }
  3439. }
  3440. func TestPreVoteMigrationWithFreeStuckPreCandidate(t *testing.T) {
  3441. nt := newPreVoteMigrationCluster(t)
  3442. // n1 is leader with term 2
  3443. // n2 is follower with term 2
  3444. // n3 is pre-candidate with term 4, and less log
  3445. n1 := nt.peers[1].(*raft)
  3446. n2 := nt.peers[2].(*raft)
  3447. n3 := nt.peers[3].(*raft)
  3448. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3449. if n1.state != StateLeader {
  3450. t.Errorf("node 1 state: %s, want %s", n1.state, StateLeader)
  3451. }
  3452. if n2.state != StateFollower {
  3453. t.Errorf("node 2 state: %s, want %s", n2.state, StateFollower)
  3454. }
  3455. if n3.state != StatePreCandidate {
  3456. t.Errorf("node 3 state: %s, want %s", n3.state, StatePreCandidate)
  3457. }
  3458. // Pre-Vote again for safety
  3459. nt.send(pb.Message{From: 3, To: 3, Type: pb.MsgHup})
  3460. if n1.state != StateLeader {
  3461. t.Errorf("node 1 state: %s, want %s", n1.state, StateLeader)
  3462. }
  3463. if n2.state != StateFollower {
  3464. t.Errorf("node 2 state: %s, want %s", n2.state, StateFollower)
  3465. }
  3466. if n3.state != StatePreCandidate {
  3467. t.Errorf("node 3 state: %s, want %s", n3.state, StatePreCandidate)
  3468. }
  3469. nt.send(pb.Message{From: 1, To: 3, Type: pb.MsgHeartbeat, Term: n1.Term})
  3470. // Disrupt the leader so that the stuck peer is freed
  3471. if n1.state != StateFollower {
  3472. t.Errorf("state = %s, want %s", n1.state, StateFollower)
  3473. }
  3474. if n3.Term != n1.Term {
  3475. t.Errorf("term = %d, want %d", n3.Term, n1.Term)
  3476. }
  3477. }
  3478. func entsWithConfig(configFunc func(*Config), terms ...uint64) *raft {
  3479. storage := NewMemoryStorage()
  3480. for i, term := range terms {
  3481. storage.Append([]pb.Entry{{Index: uint64(i + 1), Term: term}})
  3482. }
  3483. cfg := newTestConfig(1, []uint64{}, 5, 1, storage)
  3484. if configFunc != nil {
  3485. configFunc(cfg)
  3486. }
  3487. sm := newRaft(cfg)
  3488. sm.reset(terms[len(terms)-1])
  3489. return sm
  3490. }
  3491. // votedWithConfig creates a raft state machine with Vote and Term set
  3492. // to the given value but no log entries (indicating that it voted in
  3493. // the given term but has not received any logs).
  3494. func votedWithConfig(configFunc func(*Config), vote, term uint64) *raft {
  3495. storage := NewMemoryStorage()
  3496. storage.SetHardState(pb.HardState{Vote: vote, Term: term})
  3497. cfg := newTestConfig(1, []uint64{}, 5, 1, storage)
  3498. if configFunc != nil {
  3499. configFunc(cfg)
  3500. }
  3501. sm := newRaft(cfg)
  3502. sm.reset(term)
  3503. return sm
  3504. }
  3505. type network struct {
  3506. peers map[uint64]stateMachine
  3507. storage map[uint64]*MemoryStorage
  3508. dropm map[connem]float64
  3509. ignorem map[pb.MessageType]bool
  3510. // msgHook is called for each message sent. It may inspect the
  3511. // message and return true to send it or false to drop it.
  3512. msgHook func(pb.Message) bool
  3513. }
  3514. // newNetwork initializes a network from peers.
  3515. // A nil node will be replaced with a new *stateMachine.
  3516. // A *stateMachine will get its k, id.
  3517. // When using stateMachine, the address list is always [1, n].
  3518. func newNetwork(peers ...stateMachine) *network {
  3519. return newNetworkWithConfig(nil, peers...)
  3520. }
  3521. // newNetworkWithConfig is like newNetwork but calls the given func to
  3522. // modify the configuration of any state machines it creates.
  3523. func newNetworkWithConfig(configFunc func(*Config), peers ...stateMachine) *network {
  3524. size := len(peers)
  3525. peerAddrs := idsBySize(size)
  3526. npeers := make(map[uint64]stateMachine, size)
  3527. nstorage := make(map[uint64]*MemoryStorage, size)
  3528. for j, p := range peers {
  3529. id := peerAddrs[j]
  3530. switch v := p.(type) {
  3531. case nil:
  3532. nstorage[id] = NewMemoryStorage()
  3533. cfg := newTestConfig(id, peerAddrs, 10, 1, nstorage[id])
  3534. if configFunc != nil {
  3535. configFunc(cfg)
  3536. }
  3537. sm := newRaft(cfg)
  3538. npeers[id] = sm
  3539. case *raft:
  3540. learners := make(map[uint64]bool, len(v.prs.Learners))
  3541. for i := range v.prs.Learners {
  3542. learners[i] = true
  3543. }
  3544. v.id = id
  3545. v.prs = tracker.MakeProgressTracker(v.prs.MaxInflight)
  3546. for i := 0; i < size; i++ {
  3547. pr := &tracker.Progress{}
  3548. if _, ok := learners[peerAddrs[i]]; ok {
  3549. pr.IsLearner = true
  3550. v.prs.Learners[peerAddrs[i]] = struct{}{}
  3551. } else {
  3552. v.prs.Voters[0][peerAddrs[i]] = struct{}{}
  3553. }
  3554. v.prs.Progress[peerAddrs[i]] = pr
  3555. }
  3556. v.reset(v.Term)
  3557. npeers[id] = v
  3558. case *blackHole:
  3559. npeers[id] = v
  3560. default:
  3561. panic(fmt.Sprintf("unexpected state machine type: %T", p))
  3562. }
  3563. }
  3564. return &network{
  3565. peers: npeers,
  3566. storage: nstorage,
  3567. dropm: make(map[connem]float64),
  3568. ignorem: make(map[pb.MessageType]bool),
  3569. }
  3570. }
  3571. func preVoteConfig(c *Config) {
  3572. c.PreVote = true
  3573. }
  3574. func (nw *network) send(msgs ...pb.Message) {
  3575. for len(msgs) > 0 {
  3576. m := msgs[0]
  3577. p := nw.peers[m.To]
  3578. p.Step(m)
  3579. msgs = append(msgs[1:], nw.filter(p.readMessages())...)
  3580. }
  3581. }
  3582. func (nw *network) drop(from, to uint64, perc float64) {
  3583. nw.dropm[connem{from, to}] = perc
  3584. }
  3585. func (nw *network) cut(one, other uint64) {
  3586. nw.drop(one, other, 2.0) // always drop
  3587. nw.drop(other, one, 2.0) // always drop
  3588. }
  3589. func (nw *network) isolate(id uint64) {
  3590. for i := 0; i < len(nw.peers); i++ {
  3591. nid := uint64(i) + 1
  3592. if nid != id {
  3593. nw.drop(id, nid, 1.0) // always drop
  3594. nw.drop(nid, id, 1.0) // always drop
  3595. }
  3596. }
  3597. }
  3598. func (nw *network) ignore(t pb.MessageType) {
  3599. nw.ignorem[t] = true
  3600. }
  3601. func (nw *network) recover() {
  3602. nw.dropm = make(map[connem]float64)
  3603. nw.ignorem = make(map[pb.MessageType]bool)
  3604. }
  3605. func (nw *network) filter(msgs []pb.Message) []pb.Message {
  3606. mm := []pb.Message{}
  3607. for _, m := range msgs {
  3608. if nw.ignorem[m.Type] {
  3609. continue
  3610. }
  3611. switch m.Type {
  3612. case pb.MsgHup:
  3613. // hups never go over the network, so don't drop them but panic
  3614. panic("unexpected msgHup")
  3615. default:
  3616. perc := nw.dropm[connem{m.From, m.To}]
  3617. if n := rand.Float64(); n < perc {
  3618. continue
  3619. }
  3620. }
  3621. if nw.msgHook != nil {
  3622. if !nw.msgHook(m) {
  3623. continue
  3624. }
  3625. }
  3626. mm = append(mm, m)
  3627. }
  3628. return mm
  3629. }
  3630. type connem struct {
  3631. from, to uint64
  3632. }
  3633. type blackHole struct{}
  3634. func (blackHole) Step(pb.Message) error { return nil }
  3635. func (blackHole) readMessages() []pb.Message { return nil }
  3636. var nopStepper = &blackHole{}
  3637. func idsBySize(size int) []uint64 {
  3638. ids := make([]uint64, size)
  3639. for i := 0; i < size; i++ {
  3640. ids[i] = 1 + uint64(i)
  3641. }
  3642. return ids
  3643. }
  3644. // setRandomizedElectionTimeout set up the value by caller instead of choosing
  3645. // by system, in some test scenario we need to fill in some expected value to
  3646. // ensure the certainty
  3647. func setRandomizedElectionTimeout(r *raft, v int) {
  3648. r.randomizedElectionTimeout = v
  3649. }
  3650. func newTestConfig(id uint64, peers []uint64, election, heartbeat int, storage Storage) *Config {
  3651. return &Config{
  3652. ID: id,
  3653. peers: peers,
  3654. ElectionTick: election,
  3655. HeartbeatTick: heartbeat,
  3656. Storage: storage,
  3657. MaxSizePerMsg: noLimit,
  3658. MaxInflightMsgs: 256,
  3659. }
  3660. }
  3661. func newTestRaft(id uint64, peers []uint64, election, heartbeat int, storage Storage) *raft {
  3662. return newRaft(newTestConfig(id, peers, election, heartbeat, storage))
  3663. }
  3664. func newTestLearnerRaft(id uint64, peers []uint64, learners []uint64, election, heartbeat int, storage Storage) *raft {
  3665. cfg := newTestConfig(id, peers, election, heartbeat, storage)
  3666. cfg.learners = learners
  3667. return newRaft(cfg)
  3668. }