2 * Copyright (c) 2015, 2017 Brocade Communications Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.controller.cluster.datastore;
10 import static org.awaitility.Awaitility.await;
11 import static org.hamcrest.CoreMatchers.instanceOf;
12 import static org.hamcrest.MatcherAssert.assertThat;
13 import static org.hamcrest.Matchers.equalTo;
14 import static org.junit.Assert.assertEquals;
15 import static org.junit.Assert.assertNotNull;
16 import static org.junit.Assert.assertThrows;
17 import static org.junit.Assert.assertTrue;
18 import static org.junit.Assume.assumeTrue;
19 import static org.mockito.ArgumentMatchers.any;
20 import static org.mockito.ArgumentMatchers.anyString;
21 import static org.mockito.ArgumentMatchers.eq;
22 import static org.mockito.Mockito.doAnswer;
23 import static org.mockito.Mockito.mock;
24 import static org.mockito.Mockito.timeout;
25 import static org.mockito.Mockito.verify;
27 import akka.actor.ActorRef;
28 import akka.actor.ActorSelection;
29 import akka.actor.ActorSystem;
30 import akka.actor.Address;
31 import akka.actor.AddressFromURIString;
32 import akka.cluster.Cluster;
33 import akka.cluster.Member;
34 import akka.dispatch.Futures;
35 import akka.pattern.Patterns;
36 import akka.testkit.javadsl.TestKit;
37 import com.google.common.base.Stopwatch;
38 import com.google.common.base.Throwables;
39 import com.google.common.collect.ImmutableMap;
40 import com.google.common.util.concurrent.ListenableFuture;
41 import com.google.common.util.concurrent.MoreExecutors;
42 import com.google.common.util.concurrent.Uninterruptibles;
43 import com.typesafe.config.ConfigFactory;
44 import java.util.Arrays;
45 import java.util.Collection;
46 import java.util.Collections;
47 import java.util.LinkedList;
48 import java.util.List;
49 import java.util.Optional;
50 import java.util.concurrent.ExecutionException;
51 import java.util.concurrent.ExecutorService;
52 import java.util.concurrent.Executors;
53 import java.util.concurrent.TimeUnit;
54 import java.util.concurrent.atomic.AtomicBoolean;
55 import java.util.concurrent.atomic.AtomicLong;
56 import org.junit.After;
57 import org.junit.Before;
58 import org.junit.Test;
59 import org.junit.runner.RunWith;
60 import org.junit.runners.Parameterized;
61 import org.junit.runners.Parameterized.Parameter;
62 import org.junit.runners.Parameterized.Parameters;
63 import org.mockito.stubbing.Answer;
64 import org.opendaylight.controller.cluster.access.client.RequestTimeoutException;
65 import org.opendaylight.controller.cluster.access.concepts.TransactionIdentifier;
66 import org.opendaylight.controller.cluster.databroker.ClientBackedDataStore;
67 import org.opendaylight.controller.cluster.databroker.ConcurrentDOMDataBroker;
68 import org.opendaylight.controller.cluster.databroker.TestClientBackedDataStore;
69 import org.opendaylight.controller.cluster.datastore.DatastoreContext.Builder;
70 import org.opendaylight.controller.cluster.datastore.TestShard.RequestFrontendMetadata;
71 import org.opendaylight.controller.cluster.datastore.TestShard.StartDropMessages;
72 import org.opendaylight.controller.cluster.datastore.TestShard.StopDropMessages;
73 import org.opendaylight.controller.cluster.datastore.exceptions.NoShardLeaderException;
74 import org.opendaylight.controller.cluster.datastore.exceptions.ShardLeaderNotRespondingException;
75 import org.opendaylight.controller.cluster.datastore.messages.CommitTransactionReply;
76 import org.opendaylight.controller.cluster.datastore.messages.ForwardedReadyTransaction;
77 import org.opendaylight.controller.cluster.datastore.messages.GetShardDataTree;
78 import org.opendaylight.controller.cluster.datastore.messages.ReadyLocalTransaction;
79 import org.opendaylight.controller.cluster.datastore.messages.ReadyTransactionReply;
80 import org.opendaylight.controller.cluster.datastore.modification.MergeModification;
81 import org.opendaylight.controller.cluster.datastore.modification.WriteModification;
82 import org.opendaylight.controller.cluster.datastore.persisted.FrontendClientMetadata;
83 import org.opendaylight.controller.cluster.datastore.persisted.FrontendShardDataTreeSnapshotMetadata;
84 import org.opendaylight.controller.cluster.datastore.persisted.MetadataShardDataTreeSnapshot;
85 import org.opendaylight.controller.cluster.datastore.persisted.ShardSnapshotState;
86 import org.opendaylight.controller.cluster.datastore.utils.UnsignedLongBitmap;
87 import org.opendaylight.controller.cluster.raft.base.messages.TimeoutNow;
88 import org.opendaylight.controller.cluster.raft.client.messages.GetOnDemandRaftState;
89 import org.opendaylight.controller.cluster.raft.client.messages.OnDemandRaftState;
90 import org.opendaylight.controller.cluster.raft.client.messages.Shutdown;
91 import org.opendaylight.controller.cluster.raft.messages.AppendEntries;
92 import org.opendaylight.controller.cluster.raft.messages.RequestVote;
93 import org.opendaylight.controller.cluster.raft.persisted.ApplyJournalEntries;
94 import org.opendaylight.controller.cluster.raft.persisted.Snapshot;
95 import org.opendaylight.controller.cluster.raft.policy.DisableElectionsRaftPolicy;
96 import org.opendaylight.controller.cluster.raft.utils.InMemoryJournal;
97 import org.opendaylight.controller.cluster.raft.utils.InMemorySnapshotStore;
98 import org.opendaylight.controller.md.cluster.datastore.model.CarsModel;
99 import org.opendaylight.controller.md.cluster.datastore.model.PeopleModel;
100 import org.opendaylight.controller.md.cluster.datastore.model.SchemaContextHelper;
101 import org.opendaylight.controller.md.cluster.datastore.model.TestModel;
102 import org.opendaylight.mdsal.common.api.LogicalDatastoreType;
103 import org.opendaylight.mdsal.common.api.TransactionCommitFailedException;
104 import org.opendaylight.mdsal.dom.api.DOMDataTreeWriteTransaction;
105 import org.opendaylight.mdsal.dom.api.DOMTransactionChain;
106 import org.opendaylight.mdsal.dom.api.DOMTransactionChainListener;
107 import org.opendaylight.mdsal.dom.spi.store.DOMStore;
108 import org.opendaylight.mdsal.dom.spi.store.DOMStoreReadTransaction;
109 import org.opendaylight.mdsal.dom.spi.store.DOMStoreReadWriteTransaction;
110 import org.opendaylight.mdsal.dom.spi.store.DOMStoreThreePhaseCommitCohort;
111 import org.opendaylight.mdsal.dom.spi.store.DOMStoreTransactionChain;
112 import org.opendaylight.mdsal.dom.spi.store.DOMStoreWriteTransaction;
113 import org.opendaylight.yangtools.yang.common.Uint64;
114 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
115 import org.opendaylight.yangtools.yang.data.api.schema.ContainerNode;
116 import org.opendaylight.yangtools.yang.data.api.schema.MapEntryNode;
117 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
118 import org.opendaylight.yangtools.yang.data.api.schema.SystemMapNode;
119 import org.opendaylight.yangtools.yang.data.api.schema.builder.CollectionNodeBuilder;
120 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTree;
121 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeConfiguration;
122 import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeModification;
123 import org.opendaylight.yangtools.yang.data.impl.schema.ImmutableNodes;
124 import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableContainerNodeBuilder;
125 import org.opendaylight.yangtools.yang.data.impl.schema.tree.InMemoryDataTreeFactory;
126 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
127 import scala.collection.Set;
128 import scala.concurrent.Await;
129 import scala.concurrent.Future;
130 import scala.concurrent.duration.FiniteDuration;
133 * End-to-end distributed data store tests that exercise remote shards and transactions.
135 * @author Thomas Pantelis
137 @RunWith(Parameterized.class)
138 public class DistributedDataStoreRemotingIntegrationTest extends AbstractTest {
140 @Parameters(name = "{0}")
141 public static Collection<Object[]> data() {
142 return Arrays.asList(new Object[][] {
143 { TestDistributedDataStore.class, 7}, { TestClientBackedDataStore.class, 12 }
148 public Class<? extends AbstractDataStore> testParameter;
150 public int commitTimeout;
152 private static final String[] CARS_AND_PEOPLE = {"cars", "people"};
153 private static final String[] CARS = {"cars"};
155 private static final Address MEMBER_1_ADDRESS = AddressFromURIString.parse(
156 "akka://cluster-test@127.0.0.1:2558");
157 private static final Address MEMBER_2_ADDRESS = AddressFromURIString.parse(
158 "akka://cluster-test@127.0.0.1:2559");
160 private static final String MODULE_SHARDS_CARS_ONLY_1_2 = "module-shards-cars-member-1-and-2.conf";
161 private static final String MODULE_SHARDS_CARS_PEOPLE_1_2 = "module-shards-member1-and-2.conf";
162 private static final String MODULE_SHARDS_CARS_PEOPLE_1_2_3 = "module-shards-member1-and-2-and-3.conf";
163 private static final String MODULE_SHARDS_CARS_1_2_3 = "module-shards-cars-member-1-and-2-and-3.conf";
165 private ActorSystem leaderSystem;
166 private ActorSystem followerSystem;
167 private ActorSystem follower2System;
169 private final DatastoreContext.Builder leaderDatastoreContextBuilder =
170 DatastoreContext.newBuilder().shardHeartbeatIntervalInMillis(100).shardElectionTimeoutFactor(2);
172 private final DatastoreContext.Builder followerDatastoreContextBuilder =
173 DatastoreContext.newBuilder().shardHeartbeatIntervalInMillis(100).shardElectionTimeoutFactor(5)
174 .customRaftPolicyImplementation(DisableElectionsRaftPolicy.class.getName());
175 private final TransactionIdentifier tx1 = nextTransactionId();
176 private final TransactionIdentifier tx2 = nextTransactionId();
178 private AbstractDataStore followerDistributedDataStore;
179 private AbstractDataStore leaderDistributedDataStore;
180 private IntegrationTestKit followerTestKit;
181 private IntegrationTestKit leaderTestKit;
184 public void setUp() {
185 InMemoryJournal.clear();
186 InMemorySnapshotStore.clear();
188 leaderSystem = ActorSystem.create("cluster-test", ConfigFactory.load().getConfig("Member1"));
189 Cluster.get(leaderSystem).join(MEMBER_1_ADDRESS);
191 followerSystem = ActorSystem.create("cluster-test", ConfigFactory.load().getConfig("Member2"));
192 Cluster.get(followerSystem).join(MEMBER_1_ADDRESS);
194 follower2System = ActorSystem.create("cluster-test", ConfigFactory.load().getConfig("Member3"));
195 Cluster.get(follower2System).join(MEMBER_1_ADDRESS);
199 public void tearDown() {
200 if (followerDistributedDataStore != null) {
201 leaderDistributedDataStore.close();
203 if (leaderDistributedDataStore != null) {
204 leaderDistributedDataStore.close();
207 TestKit.shutdownActorSystem(leaderSystem, true);
208 TestKit.shutdownActorSystem(followerSystem, true);
209 TestKit.shutdownActorSystem(follower2System,true);
211 InMemoryJournal.clear();
212 InMemorySnapshotStore.clear();
215 private void initDatastoresWithCars(final String type) throws Exception {
216 initDatastores(type, MODULE_SHARDS_CARS_ONLY_1_2, CARS);
219 private void initDatastoresWithCarsAndPeople(final String type) throws Exception {
220 initDatastores(type, MODULE_SHARDS_CARS_PEOPLE_1_2, CARS_AND_PEOPLE);
223 private void initDatastores(final String type, final String moduleShardsConfig, final String[] shards)
225 initDatastores(type, moduleShardsConfig, shards, leaderDatastoreContextBuilder,
226 followerDatastoreContextBuilder);
229 private void initDatastores(final String type, final String moduleShardsConfig, final String[] shards,
230 final DatastoreContext.Builder leaderBuilder, final DatastoreContext.Builder followerBuilder)
232 leaderTestKit = new IntegrationTestKit(leaderSystem, leaderBuilder, commitTimeout);
234 leaderDistributedDataStore = leaderTestKit.setupAbstractDataStore(
235 testParameter, type, moduleShardsConfig, false, shards);
237 followerTestKit = new IntegrationTestKit(followerSystem, followerBuilder, commitTimeout);
238 followerDistributedDataStore = followerTestKit.setupAbstractDataStore(
239 testParameter, type, moduleShardsConfig, false, shards);
241 leaderTestKit.waitUntilLeader(leaderDistributedDataStore.getActorUtils(), shards);
243 leaderTestKit.waitForMembersUp("member-2");
244 followerTestKit.waitForMembersUp("member-1");
247 private static void verifyCars(final DOMStoreReadTransaction readTx, final MapEntryNode... entries)
249 final Optional<NormalizedNode> optional = readTx.read(CarsModel.CAR_LIST_PATH).get(5, TimeUnit.SECONDS);
250 assertTrue("isPresent", optional.isPresent());
252 final CollectionNodeBuilder<MapEntryNode, SystemMapNode> listBuilder = ImmutableNodes.mapNodeBuilder(
253 CarsModel.CAR_QNAME);
254 for (final NormalizedNode entry: entries) {
255 listBuilder.withChild((MapEntryNode) entry);
258 assertEquals("Car list node", listBuilder.build(), optional.get());
261 private static void verifyNode(final DOMStoreReadTransaction readTx, final YangInstanceIdentifier path,
262 final NormalizedNode expNode) throws Exception {
263 assertEquals(Optional.of(expNode), readTx.read(path).get(5, TimeUnit.SECONDS));
266 private static void verifyExists(final DOMStoreReadTransaction readTx, final YangInstanceIdentifier path)
268 assertEquals("exists", Boolean.TRUE, readTx.exists(path).get(5, TimeUnit.SECONDS));
272 public void testWriteTransactionWithSingleShard() throws Exception {
273 final String testName = "testWriteTransactionWithSingleShard";
274 initDatastoresWithCars(testName);
276 final String followerCarShardName = "member-2-shard-cars-" + testName;
278 DOMStoreWriteTransaction writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
279 assertNotNull("newWriteOnlyTransaction returned null", writeTx);
281 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
282 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
284 final MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
285 final YangInstanceIdentifier car1Path = CarsModel.newCarPath("optima");
286 writeTx.merge(car1Path, car1);
288 final MapEntryNode car2 = CarsModel.newCarEntry("sportage", Uint64.valueOf(25000));
289 final YangInstanceIdentifier car2Path = CarsModel.newCarPath("sportage");
290 writeTx.merge(car2Path, car2);
292 followerTestKit.doCommit(writeTx.ready());
294 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car1, car2);
296 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car1, car2);
300 writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
302 writeTx.delete(car1Path);
304 followerTestKit.doCommit(writeTx.ready());
306 verifyExists(followerDistributedDataStore.newReadOnlyTransaction(), car2Path);
308 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car2);
310 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car2);
312 // Re-instate the follower member 2 as a single-node to verify replication and recovery.
314 // The following is a bit tricky. Before we reinstate the follower we need to ensure it has persisted and
315 // applied and all the log entries from the leader. Since we've verified the car data above we know that
316 // all the transactions have been applied on the leader so we first read and capture its lastAppliedIndex.
317 final AtomicLong leaderLastAppliedIndex = new AtomicLong();
318 IntegrationTestKit.verifyShardState(leaderDistributedDataStore, CARS[0],
319 state -> leaderLastAppliedIndex.set(state.getLastApplied()));
321 // Now we need to make sure the follower has persisted the leader's lastAppliedIndex via ApplyJournalEntries.
322 // However we don't know exactly how many ApplyJournalEntries messages there will be as it can differ between
323 // the tell-based and ask-based front-ends. For ask-based there will be exactly 2 ApplyJournalEntries but
324 // tell-based persists additional payloads which could be replicated and applied in a batch resulting in
325 // either 2 or 3 ApplyJournalEntries. To handle this we read the follower's persisted ApplyJournalEntries
326 // until we find the one that encompasses the leader's lastAppliedIndex.
327 Stopwatch sw = Stopwatch.createStarted();
328 boolean done = false;
330 final List<ApplyJournalEntries> entries = InMemoryJournal.get(followerCarShardName,
331 ApplyJournalEntries.class);
332 for (ApplyJournalEntries aje: entries) {
333 if (aje.getToIndex() >= leaderLastAppliedIndex.get()) {
339 assertTrue("Follower did not persist ApplyJournalEntries containing leader's lastAppliedIndex "
340 + leaderLastAppliedIndex + ". Entries persisted: " + entries, sw.elapsed(TimeUnit.SECONDS) <= 5);
342 Uninterruptibles.sleepUninterruptibly(50, TimeUnit.MILLISECONDS);
345 TestKit.shutdownActorSystem(leaderSystem, true);
346 TestKit.shutdownActorSystem(followerSystem, true);
348 final ActorSystem newSystem = newActorSystem("reinstated-member2", "Member2");
350 try (AbstractDataStore member2Datastore = new IntegrationTestKit(newSystem, leaderDatastoreContextBuilder,
352 .setupAbstractDataStore(testParameter, testName, "module-shards-member2", true, CARS)) {
353 verifyCars(member2Datastore.newReadOnlyTransaction(), car2);
358 public void testSingleTransactionsWritesInQuickSuccession() throws Exception {
359 initDatastoresWithCars("testSingleTransactionsWritesInQuickSuccession");
361 final DOMStoreTransactionChain txChain = followerDistributedDataStore.createTransactionChain();
363 DOMStoreWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
364 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
365 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
366 followerTestKit.doCommit(writeTx.ready());
369 for (int i = 0; i < numCars; i++) {
370 writeTx = txChain.newWriteOnlyTransaction();
371 writeTx.write(CarsModel.newCarPath("car" + i), CarsModel.newCarEntry("car" + i, Uint64.valueOf(20000)));
372 followerTestKit.doCommit(writeTx.ready());
374 try (var tx = txChain.newReadOnlyTransaction()) {
375 tx.read(CarsModel.BASE_PATH).get();
379 // wait to let the shard catch up with purged
380 await("Range set leak test").atMost(5, TimeUnit.SECONDS)
381 .pollInterval(500, TimeUnit.MILLISECONDS)
382 .untilAsserted(() -> {
383 final var localShard = leaderDistributedDataStore.getActorUtils().findLocalShard("cars")
385 final var frontendMetadata =
386 (FrontendShardDataTreeSnapshotMetadata) leaderDistributedDataStore.getActorUtils()
387 .executeOperation(localShard, new RequestFrontendMetadata());
389 final var clientMeta = frontendMetadata.getClients().get(0);
390 if (leaderDistributedDataStore.getActorUtils().getDatastoreContext().isUseTellBasedProtocol()) {
391 assertTellClientMetadata(clientMeta, numCars * 2);
393 assertAskClientMetadata(clientMeta);
397 try (var tx = txChain.newReadOnlyTransaction()) {
398 final var body = tx.read(CarsModel.CAR_LIST_PATH).get(5, TimeUnit.SECONDS).orElseThrow().body();
399 assertThat(body, instanceOf(Collection.class));
400 assertEquals(numCars, ((Collection<?>) body).size());
404 private void assertAskClientMetadata(final FrontendClientMetadata clientMeta) {
405 // ask based should track no metadata
406 assertEquals(List.of(), clientMeta.getCurrentHistories());
409 private void assertTellClientMetadata(final FrontendClientMetadata clientMeta, final long lastPurged) {
410 final var iterator = clientMeta.getCurrentHistories().iterator();
411 var metadata = iterator.next();
412 while (iterator.hasNext() && metadata.getHistoryId() != 1) {
413 metadata = iterator.next();
416 // FIXME: CONTROLLER-1991: remove this assumption
419 assertEquals(UnsignedLongBitmap.of(), metadata.getClosedTransactions());
420 assertEquals("[[0.." + lastPurged + "]]", metadata.getPurgedTransactions().ranges().toString());
424 public void testCloseTransactionMetadataLeak() throws Exception {
425 // FIXME: CONTROLLER-2016: ask-based frontend triggers this:
427 // java.lang.IllegalStateException: Previous transaction
428 // member-2-datastore-testCloseTransactionMetadataLeak-fe-0-chn-1-txn-1-0 is not ready yet
429 // at org.opendaylight.controller.cluster.datastore.TransactionChainProxy$Allocated.checkReady()
430 // at org.opendaylight.controller.cluster.datastore.TransactionChainProxy.newReadOnlyTransaction()
431 assumeTrue(testParameter.isAssignableFrom(ClientBackedDataStore.class));
433 initDatastoresWithCars("testCloseTransactionMetadataLeak");
435 final DOMStoreTransactionChain txChain = followerDistributedDataStore.createTransactionChain();
437 DOMStoreWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
438 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
439 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
440 followerTestKit.doCommit(writeTx.ready());
443 for (int i = 0; i < numCars; i++) {
444 writeTx = txChain.newWriteOnlyTransaction();
447 try (var tx = txChain.newReadOnlyTransaction()) {
448 tx.read(CarsModel.BASE_PATH).get();
452 writeTx = txChain.newWriteOnlyTransaction();
453 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
454 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
455 followerTestKit.doCommit(writeTx.ready());
457 // wait to let the shard catch up with purged
458 await("Close transaction purge leak test.").atMost(5, TimeUnit.SECONDS)
459 .pollInterval(500, TimeUnit.MILLISECONDS)
460 .untilAsserted(() -> {
461 final var localShard = leaderDistributedDataStore.getActorUtils().findLocalShard("cars")
463 final var frontendMetadata =
464 (FrontendShardDataTreeSnapshotMetadata) leaderDistributedDataStore.getActorUtils()
465 .executeOperation(localShard, new RequestFrontendMetadata());
467 final var clientMeta = frontendMetadata.getClients().get(0);
468 if (leaderDistributedDataStore.getActorUtils().getDatastoreContext().isUseTellBasedProtocol()) {
469 assertTellClientMetadata(clientMeta, numCars * 2 + 1);
471 assertAskClientMetadata(clientMeta);
475 try (var tx = txChain.newReadOnlyTransaction()) {
476 final var body = tx.read(CarsModel.CAR_LIST_PATH).get(5, TimeUnit.SECONDS).orElseThrow().body();
477 assertThat(body, instanceOf(Collection.class));
478 assertEquals(numCars, ((Collection<?>) body).size());
483 public void testReadWriteTransactionWithSingleShard() throws Exception {
484 initDatastoresWithCars("testReadWriteTransactionWithSingleShard");
486 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
487 assertNotNull("newReadWriteTransaction returned null", rwTx);
489 rwTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
490 rwTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
492 final MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
493 rwTx.merge(CarsModel.newCarPath("optima"), car1);
495 verifyCars(rwTx, car1);
497 final MapEntryNode car2 = CarsModel.newCarEntry("sportage", Uint64.valueOf(25000));
498 final YangInstanceIdentifier car2Path = CarsModel.newCarPath("sportage");
499 rwTx.merge(car2Path, car2);
501 verifyExists(rwTx, car2Path);
503 followerTestKit.doCommit(rwTx.ready());
505 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car1, car2);
509 public void testWriteTransactionWithMultipleShards() throws Exception {
510 initDatastoresWithCarsAndPeople("testWriteTransactionWithMultipleShards");
512 final DOMStoreWriteTransaction writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
513 assertNotNull("newWriteOnlyTransaction returned null", writeTx);
515 final YangInstanceIdentifier carsPath = CarsModel.BASE_PATH;
516 final NormalizedNode carsNode = CarsModel.emptyContainer();
517 writeTx.write(carsPath, carsNode);
519 final YangInstanceIdentifier peoplePath = PeopleModel.BASE_PATH;
520 final NormalizedNode peopleNode = PeopleModel.emptyContainer();
521 writeTx.write(peoplePath, peopleNode);
523 followerTestKit.doCommit(writeTx.ready());
525 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
527 verifyNode(readTx, carsPath, carsNode);
528 verifyNode(readTx, peoplePath, peopleNode);
532 public void testReadWriteTransactionWithMultipleShards() throws Exception {
533 initDatastoresWithCarsAndPeople("testReadWriteTransactionWithMultipleShards");
535 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
536 assertNotNull("newReadWriteTransaction returned null", rwTx);
538 final YangInstanceIdentifier carsPath = CarsModel.BASE_PATH;
539 final NormalizedNode carsNode = CarsModel.emptyContainer();
540 rwTx.write(carsPath, carsNode);
542 final YangInstanceIdentifier peoplePath = PeopleModel.BASE_PATH;
543 final NormalizedNode peopleNode = PeopleModel.emptyContainer();
544 rwTx.write(peoplePath, peopleNode);
546 followerTestKit.doCommit(rwTx.ready());
548 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
550 verifyNode(readTx, carsPath, carsNode);
551 verifyNode(readTx, peoplePath, peopleNode);
555 public void testTransactionChainWithSingleShard() throws Exception {
556 initDatastoresWithCars("testTransactionChainWithSingleShard");
558 final DOMStoreTransactionChain txChain = followerDistributedDataStore.createTransactionChain();
560 // Add the top-level cars container with write-only.
562 final DOMStoreWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
563 assertNotNull("newWriteOnlyTransaction returned null", writeTx);
565 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
567 final DOMStoreThreePhaseCommitCohort writeTxReady = writeTx.ready();
569 // Verify the top-level cars container with read-only.
571 verifyNode(txChain.newReadOnlyTransaction(), CarsModel.BASE_PATH, CarsModel.emptyContainer());
573 // Perform car operations with read-write.
575 final DOMStoreReadWriteTransaction rwTx = txChain.newReadWriteTransaction();
577 verifyNode(rwTx, CarsModel.BASE_PATH, CarsModel.emptyContainer());
579 rwTx.merge(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
581 final MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
582 final YangInstanceIdentifier car1Path = CarsModel.newCarPath("optima");
583 rwTx.write(car1Path, car1);
585 verifyExists(rwTx, car1Path);
587 verifyCars(rwTx, car1);
589 final MapEntryNode car2 = CarsModel.newCarEntry("sportage", Uint64.valueOf(25000));
590 rwTx.merge(CarsModel.newCarPath("sportage"), car2);
592 rwTx.delete(car1Path);
594 followerTestKit.doCommit(writeTxReady);
596 followerTestKit.doCommit(rwTx.ready());
600 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car2);
604 public void testTransactionChainWithMultipleShards() throws Exception {
605 initDatastoresWithCarsAndPeople("testTransactionChainWithMultipleShards");
607 final DOMStoreTransactionChain txChain = followerDistributedDataStore.createTransactionChain();
609 DOMStoreWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
610 assertNotNull("newWriteOnlyTransaction returned null", writeTx);
612 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
613 writeTx.write(PeopleModel.BASE_PATH, PeopleModel.emptyContainer());
615 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
616 writeTx.write(PeopleModel.PERSON_LIST_PATH, PeopleModel.newPersonMapNode());
618 followerTestKit.doCommit(writeTx.ready());
620 final DOMStoreReadWriteTransaction readWriteTx = txChain.newReadWriteTransaction();
622 final MapEntryNode car = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
623 final YangInstanceIdentifier carPath = CarsModel.newCarPath("optima");
624 readWriteTx.write(carPath, car);
626 final MapEntryNode person = PeopleModel.newPersonEntry("jack");
627 final YangInstanceIdentifier personPath = PeopleModel.newPersonPath("jack");
628 readWriteTx.merge(personPath, person);
630 assertEquals(Optional.of(car), readWriteTx.read(carPath).get(5, TimeUnit.SECONDS));
631 assertEquals(Optional.of(person), readWriteTx.read(personPath).get(5, TimeUnit.SECONDS));
633 final DOMStoreThreePhaseCommitCohort cohort2 = readWriteTx.ready();
635 writeTx = txChain.newWriteOnlyTransaction();
637 writeTx.delete(personPath);
639 final DOMStoreThreePhaseCommitCohort cohort3 = writeTx.ready();
641 followerTestKit.doCommit(cohort2);
642 followerTestKit.doCommit(cohort3);
646 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
647 verifyCars(readTx, car);
649 assertEquals(Optional.empty(), readTx.read(personPath).get(5, TimeUnit.SECONDS));
653 public void testChainedTransactionFailureWithSingleShard() throws Exception {
654 initDatastoresWithCars("testChainedTransactionFailureWithSingleShard");
656 final ConcurrentDOMDataBroker broker = new ConcurrentDOMDataBroker(
657 ImmutableMap.<LogicalDatastoreType, DOMStore>builder().put(
658 LogicalDatastoreType.CONFIGURATION, followerDistributedDataStore).build(),
659 MoreExecutors.directExecutor());
661 final DOMTransactionChainListener listener = mock(DOMTransactionChainListener.class);
662 final DOMTransactionChain txChain = broker.createTransactionChain(listener);
664 final DOMDataTreeWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
666 final ContainerNode invalidData = ImmutableContainerNodeBuilder.create().withNodeIdentifier(
667 new YangInstanceIdentifier.NodeIdentifier(CarsModel.BASE_QNAME))
668 .withChild(ImmutableNodes.leafNode(TestModel.JUNK_QNAME, "junk")).build();
670 writeTx.merge(LogicalDatastoreType.CONFIGURATION, CarsModel.BASE_PATH, invalidData);
672 final var ex = assertThrows(ExecutionException.class, () -> writeTx.commit().get(5, TimeUnit.SECONDS))
674 assertThat(ex, instanceOf(TransactionCommitFailedException.class));
676 verify(listener, timeout(5000)).onTransactionChainFailed(eq(txChain), eq(writeTx), any(Throwable.class));
683 public void testChainedTransactionFailureWithMultipleShards() throws Exception {
684 initDatastoresWithCarsAndPeople("testChainedTransactionFailureWithMultipleShards");
686 final ConcurrentDOMDataBroker broker = new ConcurrentDOMDataBroker(
687 ImmutableMap.<LogicalDatastoreType, DOMStore>builder().put(
688 LogicalDatastoreType.CONFIGURATION, followerDistributedDataStore).build(),
689 MoreExecutors.directExecutor());
691 final DOMTransactionChainListener listener = mock(DOMTransactionChainListener.class);
692 final DOMTransactionChain txChain = broker.createTransactionChain(listener);
694 final DOMDataTreeWriteTransaction writeTx = txChain.newWriteOnlyTransaction();
696 writeTx.put(LogicalDatastoreType.CONFIGURATION, PeopleModel.BASE_PATH, PeopleModel.emptyContainer());
698 final ContainerNode invalidData = ImmutableContainerNodeBuilder.create().withNodeIdentifier(
699 new YangInstanceIdentifier.NodeIdentifier(CarsModel.BASE_QNAME))
700 .withChild(ImmutableNodes.leafNode(TestModel.JUNK_QNAME, "junk")).build();
702 // Note that merge will validate the data and fail but put succeeds b/c deep validation is not
703 // done for put for performance reasons.
704 writeTx.merge(LogicalDatastoreType.CONFIGURATION, CarsModel.BASE_PATH, invalidData);
706 final var ex = assertThrows(ExecutionException.class, () -> writeTx.commit().get(5, TimeUnit.SECONDS))
708 assertThat(ex, instanceOf(TransactionCommitFailedException.class));
710 verify(listener, timeout(5000)).onTransactionChainFailed(eq(txChain), eq(writeTx), any(Throwable.class));
717 public void testSingleShardTransactionsWithLeaderChanges() throws Exception {
718 followerDatastoreContextBuilder.backendAlivenessTimerIntervalInSeconds(2);
719 final String testName = "testSingleShardTransactionsWithLeaderChanges";
720 initDatastoresWithCars(testName);
722 final String followerCarShardName = "member-2-shard-cars-" + testName;
723 InMemoryJournal.addWriteMessagesCompleteLatch(followerCarShardName, 1, ApplyJournalEntries.class);
725 // Write top-level car container from the follower so it uses a remote Tx.
727 DOMStoreWriteTransaction writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
729 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
730 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
732 followerTestKit.doCommit(writeTx.ready());
734 InMemoryJournal.waitForWriteMessagesComplete(followerCarShardName);
736 // Switch the leader to the follower
738 sendDatastoreContextUpdate(followerDistributedDataStore, followerDatastoreContextBuilder
739 .shardElectionTimeoutFactor(1).customRaftPolicyImplementation(null));
741 TestKit.shutdownActorSystem(leaderSystem, true);
742 Cluster.get(followerSystem).leave(MEMBER_1_ADDRESS);
744 followerTestKit.waitUntilNoLeader(followerDistributedDataStore.getActorUtils(), CARS);
746 leaderSystem = ActorSystem.create("cluster-test", ConfigFactory.load().getConfig("Member1"));
747 Cluster.get(leaderSystem).join(MEMBER_2_ADDRESS);
749 final DatastoreContext.Builder newMember1Builder = DatastoreContext.newBuilder()
750 .shardHeartbeatIntervalInMillis(100).shardElectionTimeoutFactor(5);
751 IntegrationTestKit newMember1TestKit = new IntegrationTestKit(leaderSystem, newMember1Builder, commitTimeout);
753 try (AbstractDataStore ds =
754 newMember1TestKit.setupAbstractDataStore(
755 testParameter, testName, MODULE_SHARDS_CARS_ONLY_1_2, false, CARS)) {
757 followerTestKit.waitUntilLeader(followerDistributedDataStore.getActorUtils(), CARS);
759 // Write a car entry to the new leader - should switch to local Tx
761 writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
763 MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
764 YangInstanceIdentifier car1Path = CarsModel.newCarPath("optima");
765 writeTx.merge(car1Path, car1);
767 followerTestKit.doCommit(writeTx.ready());
769 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car1);
773 @SuppressWarnings("unchecked")
775 public void testReadyLocalTransactionForwardedToLeader() throws Exception {
776 initDatastoresWithCars("testReadyLocalTransactionForwardedToLeader");
777 followerTestKit.waitUntilLeader(followerDistributedDataStore.getActorUtils(), "cars");
779 final Optional<ActorRef> carsFollowerShard =
780 followerDistributedDataStore.getActorUtils().findLocalShard("cars");
781 assertTrue("Cars follower shard found", carsFollowerShard.isPresent());
783 final DataTree dataTree = new InMemoryDataTreeFactory().create(
784 DataTreeConfiguration.DEFAULT_OPERATIONAL, SchemaContextHelper.full());
786 // Send a tx with immediate commit.
788 DataTreeModification modification = dataTree.takeSnapshot().newModification();
789 new WriteModification(CarsModel.BASE_PATH, CarsModel.emptyContainer()).apply(modification);
790 new MergeModification(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode()).apply(modification);
792 final MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
793 new WriteModification(CarsModel.newCarPath("optima"), car1).apply(modification);
794 modification.ready();
796 ReadyLocalTransaction readyLocal = new ReadyLocalTransaction(tx1 , modification, true, Optional.empty());
798 carsFollowerShard.get().tell(readyLocal, followerTestKit.getRef());
799 Object resp = followerTestKit.expectMsgClass(Object.class);
800 if (resp instanceof akka.actor.Status.Failure) {
801 throw new AssertionError("Unexpected failure response", ((akka.actor.Status.Failure)resp).cause());
804 assertEquals("Response type", CommitTransactionReply.class, resp.getClass());
806 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car1);
808 // Send another tx without immediate commit.
810 modification = dataTree.takeSnapshot().newModification();
811 MapEntryNode car2 = CarsModel.newCarEntry("sportage", Uint64.valueOf(30000));
812 new WriteModification(CarsModel.newCarPath("sportage"), car2).apply(modification);
813 modification.ready();
815 readyLocal = new ReadyLocalTransaction(tx2 , modification, false, Optional.empty());
817 carsFollowerShard.get().tell(readyLocal, followerTestKit.getRef());
818 resp = followerTestKit.expectMsgClass(Object.class);
819 if (resp instanceof akka.actor.Status.Failure) {
820 throw new AssertionError("Unexpected failure response", ((akka.actor.Status.Failure)resp).cause());
823 assertEquals("Response type", ReadyTransactionReply.class, resp.getClass());
825 final ActorSelection txActor = leaderDistributedDataStore.getActorUtils().actorSelection(
826 ((ReadyTransactionReply)resp).getCohortPath());
828 ThreePhaseCommitCohortProxy cohort = new ThreePhaseCommitCohortProxy(leaderDistributedDataStore.getActorUtils(),
829 List.of(new ThreePhaseCommitCohortProxy.CohortInfo(Futures.successful(txActor),
830 () -> DataStoreVersions.CURRENT_VERSION)), tx2);
831 cohort.canCommit().get(5, TimeUnit.SECONDS);
832 cohort.preCommit().get(5, TimeUnit.SECONDS);
833 cohort.commit().get(5, TimeUnit.SECONDS);
835 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car1, car2);
838 @SuppressWarnings("unchecked")
840 public void testForwardedReadyTransactionForwardedToLeader() throws Exception {
841 initDatastoresWithCars("testForwardedReadyTransactionForwardedToLeader");
842 followerTestKit.waitUntilLeader(followerDistributedDataStore.getActorUtils(), "cars");
844 final Optional<ActorRef> carsFollowerShard =
845 followerDistributedDataStore.getActorUtils().findLocalShard("cars");
846 assertTrue("Cars follower shard found", carsFollowerShard.isPresent());
848 carsFollowerShard.get().tell(GetShardDataTree.INSTANCE, followerTestKit.getRef());
849 final DataTree dataTree = followerTestKit.expectMsgClass(DataTree.class);
851 // Send a tx with immediate commit.
853 DataTreeModification modification = dataTree.takeSnapshot().newModification();
854 new WriteModification(CarsModel.BASE_PATH, CarsModel.emptyContainer()).apply(modification);
855 new MergeModification(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode()).apply(modification);
857 final MapEntryNode car1 = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
858 new WriteModification(CarsModel.newCarPath("optima"), car1).apply(modification);
860 ForwardedReadyTransaction forwardedReady = new ForwardedReadyTransaction(tx1, DataStoreVersions.CURRENT_VERSION,
861 new ReadWriteShardDataTreeTransaction(mock(ShardDataTreeTransactionParent.class), tx1, modification),
862 true, Optional.empty());
864 carsFollowerShard.get().tell(forwardedReady, followerTestKit.getRef());
865 Object resp = followerTestKit.expectMsgClass(Object.class);
866 if (resp instanceof akka.actor.Status.Failure) {
867 throw new AssertionError("Unexpected failure response", ((akka.actor.Status.Failure)resp).cause());
870 assertEquals("Response type", CommitTransactionReply.class, resp.getClass());
872 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car1);
874 // Send another tx without immediate commit.
876 modification = dataTree.takeSnapshot().newModification();
877 MapEntryNode car2 = CarsModel.newCarEntry("sportage", Uint64.valueOf(30000));
878 new WriteModification(CarsModel.newCarPath("sportage"), car2).apply(modification);
880 forwardedReady = new ForwardedReadyTransaction(tx2, DataStoreVersions.CURRENT_VERSION,
881 new ReadWriteShardDataTreeTransaction(mock(ShardDataTreeTransactionParent.class), tx2, modification),
882 false, Optional.empty());
884 carsFollowerShard.get().tell(forwardedReady, followerTestKit.getRef());
885 resp = followerTestKit.expectMsgClass(Object.class);
886 if (resp instanceof akka.actor.Status.Failure) {
887 throw new AssertionError("Unexpected failure response", ((akka.actor.Status.Failure)resp).cause());
890 assertEquals("Response type", ReadyTransactionReply.class, resp.getClass());
892 ActorSelection txActor = leaderDistributedDataStore.getActorUtils().actorSelection(
893 ((ReadyTransactionReply)resp).getCohortPath());
895 final ThreePhaseCommitCohortProxy cohort = new ThreePhaseCommitCohortProxy(
896 leaderDistributedDataStore.getActorUtils(), List.of(
897 new ThreePhaseCommitCohortProxy.CohortInfo(Futures.successful(txActor),
898 () -> DataStoreVersions.CURRENT_VERSION)), tx2);
899 cohort.canCommit().get(5, TimeUnit.SECONDS);
900 cohort.preCommit().get(5, TimeUnit.SECONDS);
901 cohort.commit().get(5, TimeUnit.SECONDS);
903 verifyCars(leaderDistributedDataStore.newReadOnlyTransaction(), car1, car2);
907 public void testTransactionForwardedToLeaderAfterRetry() throws Exception {
908 // FIXME: remove when test passes also for ClientBackedDataStore
909 assumeTrue(DistributedDataStore.class.isAssignableFrom(testParameter));
911 followerDatastoreContextBuilder.shardBatchedModificationCount(2);
912 leaderDatastoreContextBuilder.shardBatchedModificationCount(2);
913 initDatastoresWithCarsAndPeople("testTransactionForwardedToLeaderAfterRetry");
915 // Do an initial write to get the primary shard info cached.
917 final DOMStoreWriteTransaction initialWriteTx = followerDistributedDataStore.newWriteOnlyTransaction();
918 initialWriteTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
919 initialWriteTx.write(PeopleModel.BASE_PATH, PeopleModel.emptyContainer());
920 followerTestKit.doCommit(initialWriteTx.ready());
922 // Wait for the commit to be replicated to the follower.
924 MemberNode.verifyRaftState(followerDistributedDataStore, "cars",
925 raftState -> assertEquals("getLastApplied", 1, raftState.getLastApplied()));
927 MemberNode.verifyRaftState(followerDistributedDataStore, "people",
928 raftState -> assertEquals("getLastApplied", 1, raftState.getLastApplied()));
930 // Prepare, ready and canCommit a WO tx that writes to 2 shards. This will become the current tx in
933 final DOMStoreWriteTransaction writeTx1 = followerDistributedDataStore.newWriteOnlyTransaction();
934 writeTx1.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
935 writeTx1.write(PeopleModel.BASE_PATH, PeopleModel.emptyContainer());
936 final DOMStoreThreePhaseCommitCohort writeTx1Cohort = writeTx1.ready();
937 final ListenableFuture<Boolean> writeTx1CanCommit = writeTx1Cohort.canCommit();
938 writeTx1CanCommit.get(5, TimeUnit.SECONDS);
940 // Prepare and ready another WO tx that writes to 2 shards but don't canCommit yet. This will be queued
941 // in the leader shard.
943 final DOMStoreWriteTransaction writeTx2 = followerDistributedDataStore.newWriteOnlyTransaction();
944 final LinkedList<MapEntryNode> cars = new LinkedList<>();
946 cars.add(CarsModel.newCarEntry("car" + carIndex, Uint64.valueOf(carIndex)));
947 writeTx2.write(CarsModel.newCarPath("car" + carIndex), cars.getLast());
949 NormalizedNode people = ImmutableNodes.mapNodeBuilder(PeopleModel.PERSON_QNAME)
950 .withChild(PeopleModel.newPersonEntry("Dude")).build();
951 writeTx2.write(PeopleModel.PERSON_LIST_PATH, people);
952 final DOMStoreThreePhaseCommitCohort writeTx2Cohort = writeTx2.ready();
954 // Prepare another WO that writes to a single shard and thus will be directly committed on ready. This
955 // tx writes 5 cars so 2 BatchedModidifications messages will be sent initially and cached in the
956 // leader shard (with shardBatchedModificationCount set to 2). The 3rd BatchedModidifications will be
959 final DOMStoreWriteTransaction writeTx3 = followerDistributedDataStore.newWriteOnlyTransaction();
960 for (int i = 1; i <= 5; i++, carIndex++) {
961 cars.add(CarsModel.newCarEntry("car" + carIndex, Uint64.valueOf(carIndex)));
962 writeTx3.write(CarsModel.newCarPath("car" + carIndex), cars.getLast());
965 // Prepare another WO that writes to a single shard. This will send a single BatchedModidifications
968 final DOMStoreWriteTransaction writeTx4 = followerDistributedDataStore.newWriteOnlyTransaction();
969 cars.add(CarsModel.newCarEntry("car" + carIndex, Uint64.valueOf(carIndex)));
970 writeTx4.write(CarsModel.newCarPath("car" + carIndex), cars.getLast());
973 // Prepare a RW tx that will create a tx actor and send a ForwardedReadyTransaciton message to the
974 // leader shard on ready.
976 final DOMStoreReadWriteTransaction readWriteTx = followerDistributedDataStore.newReadWriteTransaction();
977 cars.add(CarsModel.newCarEntry("car" + carIndex, Uint64.valueOf(carIndex)));
978 readWriteTx.write(CarsModel.newCarPath("car" + carIndex), cars.getLast());
980 IntegrationTestKit.verifyShardStats(leaderDistributedDataStore, "cars",
981 stats -> assertEquals("getReadWriteTransactionCount", 5, stats.getReadWriteTransactionCount()));
983 // Disable elections on the leader so it switches to follower.
985 sendDatastoreContextUpdate(leaderDistributedDataStore, leaderDatastoreContextBuilder
986 .customRaftPolicyImplementation(DisableElectionsRaftPolicy.class.getName())
987 .shardElectionTimeoutFactor(10));
989 leaderTestKit.waitUntilNoLeader(leaderDistributedDataStore.getActorUtils(), "cars");
991 // Submit all tx's - the messages should get queued for retry.
993 final ListenableFuture<Boolean> writeTx2CanCommit = writeTx2Cohort.canCommit();
994 final DOMStoreThreePhaseCommitCohort writeTx3Cohort = writeTx3.ready();
995 final DOMStoreThreePhaseCommitCohort writeTx4Cohort = writeTx4.ready();
996 final DOMStoreThreePhaseCommitCohort rwTxCohort = readWriteTx.ready();
998 // Enable elections on the other follower so it becomes the leader, at which point the
999 // tx's should get forwarded from the previous leader to the new leader to complete the commits.
1001 sendDatastoreContextUpdate(followerDistributedDataStore, followerDatastoreContextBuilder
1002 .customRaftPolicyImplementation(null).shardElectionTimeoutFactor(1));
1003 IntegrationTestKit.findLocalShard(followerDistributedDataStore.getActorUtils(), "cars")
1004 .tell(TimeoutNow.INSTANCE, ActorRef.noSender());
1005 IntegrationTestKit.findLocalShard(followerDistributedDataStore.getActorUtils(), "people")
1006 .tell(TimeoutNow.INSTANCE, ActorRef.noSender());
1008 followerTestKit.doCommit(writeTx1CanCommit, writeTx1Cohort);
1009 followerTestKit.doCommit(writeTx2CanCommit, writeTx2Cohort);
1010 followerTestKit.doCommit(writeTx3Cohort);
1011 followerTestKit.doCommit(writeTx4Cohort);
1012 followerTestKit.doCommit(rwTxCohort);
1014 DOMStoreReadTransaction readTx = leaderDistributedDataStore.newReadOnlyTransaction();
1015 verifyCars(readTx, cars.toArray(new MapEntryNode[cars.size()]));
1016 verifyNode(readTx, PeopleModel.PERSON_LIST_PATH, people);
1020 public void testLeadershipTransferOnShutdown() throws Exception {
1021 // FIXME: remove when test passes also for ClientBackedDataStore
1022 assumeTrue(DistributedDataStore.class.isAssignableFrom(testParameter));
1024 leaderDatastoreContextBuilder.shardBatchedModificationCount(1);
1025 followerDatastoreContextBuilder.shardElectionTimeoutFactor(10).customRaftPolicyImplementation(null);
1026 final String testName = "testLeadershipTransferOnShutdown";
1027 initDatastores(testName, MODULE_SHARDS_CARS_PEOPLE_1_2_3, CARS_AND_PEOPLE);
1029 final IntegrationTestKit follower2TestKit = new IntegrationTestKit(follower2System,
1030 DatastoreContext.newBuilderFrom(followerDatastoreContextBuilder.build()).operationTimeoutInMillis(500),
1032 try (AbstractDataStore follower2DistributedDataStore = follower2TestKit.setupAbstractDataStore(
1033 testParameter, testName, MODULE_SHARDS_CARS_PEOPLE_1_2_3, false)) {
1035 followerTestKit.waitForMembersUp("member-3");
1036 follower2TestKit.waitForMembersUp("member-1", "member-2");
1038 // Create and submit a couple tx's so they're pending.
1040 DOMStoreWriteTransaction writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
1041 writeTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1042 writeTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
1043 writeTx.write(PeopleModel.BASE_PATH, PeopleModel.emptyContainer());
1044 final DOMStoreThreePhaseCommitCohort cohort1 = writeTx.ready();
1046 IntegrationTestKit.verifyShardStats(leaderDistributedDataStore, "cars",
1047 stats -> assertEquals("getTxCohortCacheSize", 1, stats.getTxCohortCacheSize()));
1049 writeTx = followerDistributedDataStore.newWriteOnlyTransaction();
1050 final MapEntryNode car = CarsModel.newCarEntry("optima", Uint64.valueOf(20000));
1051 writeTx.write(CarsModel.newCarPath("optima"), car);
1052 final DOMStoreThreePhaseCommitCohort cohort2 = writeTx.ready();
1054 IntegrationTestKit.verifyShardStats(leaderDistributedDataStore, "cars",
1055 stats -> assertEquals("getTxCohortCacheSize", 2, stats.getTxCohortCacheSize()));
1057 // Gracefully stop the leader via a Shutdown message.
1059 sendDatastoreContextUpdate(leaderDistributedDataStore, leaderDatastoreContextBuilder
1060 .shardElectionTimeoutFactor(100));
1062 final FiniteDuration duration = FiniteDuration.create(5, TimeUnit.SECONDS);
1063 final Future<ActorRef> future = leaderDistributedDataStore.getActorUtils().findLocalShardAsync("cars");
1064 final ActorRef leaderActor = Await.result(future, duration);
1066 final Future<Boolean> stopFuture = Patterns.gracefulStop(leaderActor, duration, Shutdown.INSTANCE);
1068 // Commit the 2 transactions. They should finish and succeed.
1070 followerTestKit.doCommit(cohort1);
1071 followerTestKit.doCommit(cohort2);
1073 // Wait for the leader actor stopped.
1075 final Boolean stopped = Await.result(stopFuture, duration);
1076 assertEquals("Stopped", Boolean.TRUE, stopped);
1078 // Verify leadership was transferred by reading the committed data from the other nodes.
1080 verifyCars(followerDistributedDataStore.newReadOnlyTransaction(), car);
1081 verifyCars(follower2DistributedDataStore.newReadOnlyTransaction(), car);
1086 public void testTransactionWithIsolatedLeader() throws Exception {
1087 // FIXME: remove when test passes also for ClientBackedDataStore
1088 assumeTrue(DistributedDataStore.class.isAssignableFrom(testParameter));
1090 // Set the isolated leader check interval high so we can control the switch to IsolatedLeader.
1091 leaderDatastoreContextBuilder.shardIsolatedLeaderCheckIntervalInMillis(10000000);
1092 final String testName = "testTransactionWithIsolatedLeader";
1093 initDatastoresWithCars(testName);
1095 // Tx that is submitted after the follower is stopped but before the leader transitions to IsolatedLeader.
1096 final DOMStoreWriteTransaction preIsolatedLeaderWriteTx = leaderDistributedDataStore.newWriteOnlyTransaction();
1097 preIsolatedLeaderWriteTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1099 // Tx that is submitted after the leader transitions to IsolatedLeader.
1100 final DOMStoreWriteTransaction noShardLeaderWriteTx = leaderDistributedDataStore.newWriteOnlyTransaction();
1101 noShardLeaderWriteTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1103 // Tx that is submitted after the follower is reinstated.
1104 final DOMStoreWriteTransaction successWriteTx = leaderDistributedDataStore.newWriteOnlyTransaction();
1105 successWriteTx.merge(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1107 // Stop the follower
1108 followerTestKit.watch(followerDistributedDataStore.getActorUtils().getShardManager());
1109 followerDistributedDataStore.close();
1110 followerTestKit.expectTerminated(followerDistributedDataStore.getActorUtils().getShardManager());
1112 // Submit the preIsolatedLeaderWriteTx so it's pending
1113 final DOMStoreThreePhaseCommitCohort preIsolatedLeaderTxCohort = preIsolatedLeaderWriteTx.ready();
1115 // Change the isolated leader check interval low so it changes to IsolatedLeader.
1116 sendDatastoreContextUpdate(leaderDistributedDataStore, leaderDatastoreContextBuilder
1117 .shardIsolatedLeaderCheckIntervalInMillis(200));
1119 MemberNode.verifyRaftState(leaderDistributedDataStore, "cars",
1120 raftState -> assertEquals("getRaftState", "IsolatedLeader", raftState.getRaftState()));
1122 final var ex = assertThrows(ExecutionException.class,
1123 () -> leaderTestKit.doCommit(noShardLeaderWriteTx.ready()));
1124 assertEquals(NoShardLeaderException.class, Throwables.getRootCause(ex).getClass());
1126 sendDatastoreContextUpdate(leaderDistributedDataStore, leaderDatastoreContextBuilder
1127 .shardElectionTimeoutFactor(100));
1129 final DOMStoreThreePhaseCommitCohort successTxCohort = successWriteTx.ready();
1131 followerDistributedDataStore = followerTestKit.setupAbstractDataStore(
1132 testParameter, testName, MODULE_SHARDS_CARS_ONLY_1_2, false, CARS);
1134 leaderTestKit.doCommit(preIsolatedLeaderTxCohort);
1135 leaderTestKit.doCommit(successTxCohort);
1139 public void testTransactionWithShardLeaderNotResponding() throws Exception {
1140 followerDatastoreContextBuilder.frontendRequestTimeoutInSeconds(2);
1141 followerDatastoreContextBuilder.shardElectionTimeoutFactor(50);
1142 initDatastoresWithCars("testTransactionWithShardLeaderNotResponding");
1144 // Do an initial read to get the primary shard info cached.
1146 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
1147 readTx.read(CarsModel.BASE_PATH).get(5, TimeUnit.SECONDS);
1149 // Shutdown the leader and try to create a new tx.
1151 TestKit.shutdownActorSystem(leaderSystem, true);
1153 followerDatastoreContextBuilder.operationTimeoutInMillis(50).shardElectionTimeoutFactor(1);
1154 sendDatastoreContextUpdate(followerDistributedDataStore, followerDatastoreContextBuilder);
1156 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
1158 rwTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1160 final var ex = assertThrows(ExecutionException.class, () -> followerTestKit.doCommit(rwTx.ready()));
1161 final String msg = "Unexpected exception: " + Throwables.getStackTraceAsString(ex.getCause());
1162 if (DistributedDataStore.class.isAssignableFrom(testParameter)) {
1163 assertTrue(msg, Throwables.getRootCause(ex) instanceof NoShardLeaderException
1164 || ex.getCause() instanceof ShardLeaderNotRespondingException);
1166 assertThat(msg, Throwables.getRootCause(ex), instanceOf(RequestTimeoutException.class));
1171 public void testTransactionWithCreateTxFailureDueToNoLeader() throws Exception {
1172 followerDatastoreContextBuilder.frontendRequestTimeoutInSeconds(2);
1173 initDatastoresWithCars("testTransactionWithCreateTxFailureDueToNoLeader");
1175 // Do an initial read to get the primary shard info cached.
1177 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
1178 readTx.read(CarsModel.BASE_PATH).get(5, TimeUnit.SECONDS);
1180 // Shutdown the leader and try to create a new tx.
1182 TestKit.shutdownActorSystem(leaderSystem, true);
1184 Cluster.get(followerSystem).leave(MEMBER_1_ADDRESS);
1186 Uninterruptibles.sleepUninterruptibly(100, TimeUnit.MILLISECONDS);
1188 sendDatastoreContextUpdate(followerDistributedDataStore, followerDatastoreContextBuilder
1189 .operationTimeoutInMillis(10).shardElectionTimeoutFactor(1).customRaftPolicyImplementation(null));
1191 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
1193 rwTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1195 final var ex = assertThrows(ExecutionException.class, () -> followerTestKit.doCommit(rwTx.ready()));
1196 final String msg = "Unexpected exception: " + Throwables.getStackTraceAsString(ex.getCause());
1197 if (DistributedDataStore.class.isAssignableFrom(testParameter)) {
1198 assertThat(msg, Throwables.getRootCause(ex), instanceOf(NoShardLeaderException.class));
1200 assertThat(msg, Throwables.getRootCause(ex), instanceOf(RequestTimeoutException.class));
1205 public void testTransactionRetryWithInitialAskTimeoutExOnCreateTx() throws Exception {
1206 followerDatastoreContextBuilder.backendAlivenessTimerIntervalInSeconds(2);
1207 String testName = "testTransactionRetryWithInitialAskTimeoutExOnCreateTx";
1208 initDatastores(testName, MODULE_SHARDS_CARS_1_2_3, CARS);
1210 final DatastoreContext.Builder follower2DatastoreContextBuilder = DatastoreContext.newBuilder()
1211 .shardHeartbeatIntervalInMillis(100).shardElectionTimeoutFactor(10);
1212 final IntegrationTestKit follower2TestKit = new IntegrationTestKit(
1213 follower2System, follower2DatastoreContextBuilder, commitTimeout);
1215 try (AbstractDataStore ds =
1216 follower2TestKit.setupAbstractDataStore(
1217 testParameter, testName, MODULE_SHARDS_CARS_1_2_3, false, CARS)) {
1219 followerTestKit.waitForMembersUp("member-1", "member-3");
1220 follower2TestKit.waitForMembersUp("member-1", "member-2");
1222 // Do an initial read to get the primary shard info cached.
1224 final DOMStoreReadTransaction readTx = followerDistributedDataStore.newReadOnlyTransaction();
1225 readTx.read(CarsModel.BASE_PATH).get(5, TimeUnit.SECONDS);
1227 // Shutdown the leader and try to create a new tx.
1229 TestKit.shutdownActorSystem(leaderSystem, true);
1231 Cluster.get(followerSystem).leave(MEMBER_1_ADDRESS);
1233 sendDatastoreContextUpdate(followerDistributedDataStore, followerDatastoreContextBuilder
1234 .operationTimeoutInMillis(500).shardElectionTimeoutFactor(5).customRaftPolicyImplementation(null));
1236 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
1238 rwTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1240 followerTestKit.doCommit(rwTx.ready());
1245 public void testSemiReachableCandidateNotDroppingLeader() throws Exception {
1246 final String testName = "testSemiReachableCandidateNotDroppingLeader";
1247 initDatastores(testName, MODULE_SHARDS_CARS_1_2_3, CARS);
1249 final DatastoreContext.Builder follower2DatastoreContextBuilder = DatastoreContext.newBuilder()
1250 .shardHeartbeatIntervalInMillis(100).shardElectionTimeoutFactor(10);
1251 final IntegrationTestKit follower2TestKit = new IntegrationTestKit(
1252 follower2System, follower2DatastoreContextBuilder, commitTimeout);
1254 final AbstractDataStore ds2 =
1255 follower2TestKit.setupAbstractDataStore(
1256 testParameter, testName, MODULE_SHARDS_CARS_1_2_3, false, CARS);
1258 followerTestKit.waitForMembersUp("member-1", "member-3");
1259 follower2TestKit.waitForMembersUp("member-1", "member-2");
1261 // behavior is controlled by akka.coordinated-shutdown.run-by-actor-system-terminate configuration option
1262 TestKit.shutdownActorSystem(follower2System, true);
1264 ActorRef cars = leaderDistributedDataStore.getActorUtils().findLocalShard("cars").get();
1265 final OnDemandRaftState initialState = (OnDemandRaftState) leaderDistributedDataStore.getActorUtils()
1266 .executeOperation(cars, GetOnDemandRaftState.INSTANCE);
1268 Cluster leaderCluster = Cluster.get(leaderSystem);
1269 Cluster followerCluster = Cluster.get(followerSystem);
1270 Cluster follower2Cluster = Cluster.get(follower2System);
1272 Member follower2Member = follower2Cluster.readView().self();
1274 await().atMost(10, TimeUnit.SECONDS)
1275 .until(() -> containsUnreachable(leaderCluster, follower2Member));
1276 await().atMost(10, TimeUnit.SECONDS)
1277 .until(() -> containsUnreachable(followerCluster, follower2Member));
1279 ActorRef followerCars = followerDistributedDataStore.getActorUtils().findLocalShard("cars").get();
1281 // to simulate a follower not being able to receive messages, but still being able to send messages and becoming
1282 // candidate, we can just send a couple of RequestVotes to both leader and follower.
1283 cars.tell(new RequestVote(initialState.getCurrentTerm() + 1, "member-3-shard-cars", -1, -1), null);
1284 followerCars.tell(new RequestVote(initialState.getCurrentTerm() + 1, "member-3-shard-cars", -1, -1), null);
1285 cars.tell(new RequestVote(initialState.getCurrentTerm() + 3, "member-3-shard-cars", -1, -1), null);
1286 followerCars.tell(new RequestVote(initialState.getCurrentTerm() + 3, "member-3-shard-cars", -1, -1), null);
1288 OnDemandRaftState stateAfter = (OnDemandRaftState) leaderDistributedDataStore.getActorUtils()
1289 .executeOperation(cars, GetOnDemandRaftState.INSTANCE);
1290 OnDemandRaftState followerState = (OnDemandRaftState) followerDistributedDataStore.getActorUtils()
1291 .executeOperation(cars, GetOnDemandRaftState.INSTANCE);
1293 assertEquals(initialState.getCurrentTerm(), stateAfter.getCurrentTerm());
1294 assertEquals(initialState.getCurrentTerm(), followerState.getCurrentTerm());
1299 private static Boolean containsUnreachable(final Cluster cluster, final Member member) {
1300 // unreachableMembers() returns scala.collection.immutable.Set, but we are using scala.collection.Set to fix JDT
1301 // see https://bugs.eclipse.org/bugs/show_bug.cgi?id=468276#c32
1302 final Set<Member> members = cluster.readView().unreachableMembers();
1303 return members.contains(member);
1307 public void testInstallSnapshot() throws Exception {
1308 final String testName = "testInstallSnapshot";
1309 final String leaderCarShardName = "member-1-shard-cars-" + testName;
1310 final String followerCarShardName = "member-2-shard-cars-" + testName;
1312 // Setup a saved snapshot on the leader. The follower will startup with no data and the leader should
1313 // install a snapshot to sync the follower.
1315 DataTree tree = new InMemoryDataTreeFactory().create(DataTreeConfiguration.DEFAULT_CONFIGURATION,
1316 SchemaContextHelper.full());
1318 final ContainerNode carsNode = CarsModel.newCarsNode(
1319 CarsModel.newCarsMapNode(CarsModel.newCarEntry("optima", Uint64.valueOf(20000))));
1320 AbstractShardTest.writeToStore(tree, CarsModel.BASE_PATH, carsNode);
1322 final NormalizedNode snapshotRoot = AbstractShardTest.readStore(tree, YangInstanceIdentifier.empty());
1323 final Snapshot initialSnapshot = Snapshot.create(
1324 new ShardSnapshotState(new MetadataShardDataTreeSnapshot(snapshotRoot)),
1325 Collections.emptyList(), 5, 1, 5, 1, 1, null, null);
1326 InMemorySnapshotStore.addSnapshot(leaderCarShardName, initialSnapshot);
1328 InMemorySnapshotStore.addSnapshotSavedLatch(leaderCarShardName);
1329 InMemorySnapshotStore.addSnapshotSavedLatch(followerCarShardName);
1331 initDatastoresWithCars(testName);
1333 assertEquals(Optional.of(carsNode), leaderDistributedDataStore.newReadOnlyTransaction().read(
1334 CarsModel.BASE_PATH).get(5, TimeUnit.SECONDS));
1336 verifySnapshot(InMemorySnapshotStore.waitForSavedSnapshot(leaderCarShardName, Snapshot.class),
1337 initialSnapshot, snapshotRoot);
1339 verifySnapshot(InMemorySnapshotStore.waitForSavedSnapshot(followerCarShardName, Snapshot.class),
1340 initialSnapshot, snapshotRoot);
1344 public void testReadWriteMessageSlicing() throws Exception {
1345 // The slicing is only implemented for tell-based protocol
1346 assumeTrue(ClientBackedDataStore.class.isAssignableFrom(testParameter));
1348 leaderDatastoreContextBuilder.maximumMessageSliceSize(100);
1349 followerDatastoreContextBuilder.maximumMessageSliceSize(100);
1350 initDatastoresWithCars("testLargeReadReplySlicing");
1352 final DOMStoreReadWriteTransaction rwTx = followerDistributedDataStore.newReadWriteTransaction();
1354 final NormalizedNode carsNode = CarsModel.create();
1355 rwTx.write(CarsModel.BASE_PATH, carsNode);
1357 verifyNode(rwTx, CarsModel.BASE_PATH, carsNode);
1360 @SuppressWarnings("IllegalCatch")
1362 public void testRaftCallbackDuringLeadershipDrop() throws Exception {
1363 final String testName = "testRaftCallbackDuringLeadershipDrop";
1364 initDatastores(testName, MODULE_SHARDS_CARS_1_2_3, CARS);
1366 final ExecutorService executor = Executors.newSingleThreadExecutor();
1368 final IntegrationTestKit follower2TestKit = new IntegrationTestKit(follower2System,
1369 DatastoreContext.newBuilderFrom(followerDatastoreContextBuilder.build()).operationTimeoutInMillis(500)
1370 .shardLeaderElectionTimeoutInSeconds(3600),
1373 final DOMStoreWriteTransaction initialWriteTx = leaderDistributedDataStore.newWriteOnlyTransaction();
1374 initialWriteTx.write(CarsModel.BASE_PATH, CarsModel.emptyContainer());
1375 leaderTestKit.doCommit(initialWriteTx.ready());
1377 try (AbstractDataStore follower2DistributedDataStore = follower2TestKit.setupAbstractDataStore(
1378 testParameter, testName, MODULE_SHARDS_CARS_1_2_3, false)) {
1380 final ActorRef member3Cars = ((LocalShardStore) follower2DistributedDataStore).getLocalShards()
1381 .getLocalShards().get("cars").getActor();
1382 final ActorRef member2Cars = ((LocalShardStore)followerDistributedDataStore).getLocalShards()
1383 .getLocalShards().get("cars").getActor();
1384 member2Cars.tell(new StartDropMessages(AppendEntries.class), null);
1385 member3Cars.tell(new StartDropMessages(AppendEntries.class), null);
1387 final DOMStoreWriteTransaction newTx = leaderDistributedDataStore.newWriteOnlyTransaction();
1388 newTx.write(CarsModel.CAR_LIST_PATH, CarsModel.newCarMapNode());
1389 final AtomicBoolean submitDone = new AtomicBoolean(false);
1390 executor.submit(() -> {
1392 leaderTestKit.doCommit(newTx.ready());
1393 submitDone.set(true);
1394 } catch (Exception e) {
1395 throw new RuntimeException(e);
1398 final ActorRef leaderCars = ((LocalShardStore) leaderDistributedDataStore).getLocalShards()
1399 .getLocalShards().get("cars").getActor();
1400 await().atMost(10, TimeUnit.SECONDS)
1401 .until(() -> ((OnDemandRaftState) leaderDistributedDataStore.getActorUtils()
1402 .executeOperation(leaderCars, GetOnDemandRaftState.INSTANCE)).getLastIndex() >= 1);
1404 final OnDemandRaftState raftState = (OnDemandRaftState)leaderDistributedDataStore.getActorUtils()
1405 .executeOperation(leaderCars, GetOnDemandRaftState.INSTANCE);
1407 // Simulate a follower not receiving heartbeats but still being able to send messages ie RequestVote with
1408 // new term(switching to candidate after election timeout)
1409 leaderCars.tell(new RequestVote(raftState.getCurrentTerm() + 1,
1410 "member-3-shard-cars-testRaftCallbackDuringLeadershipDrop", -1,
1413 member2Cars.tell(new StopDropMessages(AppendEntries.class), null);
1414 member3Cars.tell(new StopDropMessages(AppendEntries.class), null);
1416 await("Is tx stuck in COMMIT_PENDING")
1417 .atMost(10, TimeUnit.SECONDS).untilAtomic(submitDone, equalTo(true));
1421 executor.shutdownNow();
1425 public void testSnapshotOnRootOverwrite() throws Exception {
1426 // FIXME: ClientBackedDatastore does not have stable indexes/term, the snapshot index seems to fluctuate
1427 assumeTrue(DistributedDataStore.class.isAssignableFrom(testParameter));
1429 final String testName = "testSnapshotOnRootOverwrite";
1430 final String[] shards = {"cars", "default"};
1431 initDatastores(testName, "module-shards-default-cars-member1-and-2.conf", shards,
1432 leaderDatastoreContextBuilder.snapshotOnRootOverwrite(true),
1433 followerDatastoreContextBuilder.snapshotOnRootOverwrite(true));
1435 leaderTestKit.waitForMembersUp("member-2");
1436 final ContainerNode rootNode = ImmutableContainerNodeBuilder.create()
1437 .withNodeIdentifier(YangInstanceIdentifier.NodeIdentifier.create(SchemaContext.NAME))
1438 .withChild(CarsModel.create())
1441 leaderTestKit.testWriteTransaction(leaderDistributedDataStore, YangInstanceIdentifier.empty(), rootNode);
1443 IntegrationTestKit.verifyShardState(leaderDistributedDataStore, "cars",
1444 state -> assertEquals(1, state.getSnapshotIndex()));
1446 IntegrationTestKit.verifyShardState(followerDistributedDataStore, "cars",
1447 state -> assertEquals(1, state.getSnapshotIndex()));
1449 verifySnapshot("member-1-shard-cars-testSnapshotOnRootOverwrite", 1);
1450 verifySnapshot("member-2-shard-cars-testSnapshotOnRootOverwrite", 1);
1452 for (int i = 0; i < 10; i++) {
1453 leaderTestKit.testWriteTransaction(leaderDistributedDataStore, CarsModel.newCarPath("car " + i),
1454 CarsModel.newCarEntry("car " + i, Uint64.ONE));
1457 // fake snapshot causes the snapshotIndex to move
1458 IntegrationTestKit.verifyShardState(leaderDistributedDataStore, "cars",
1459 state -> assertEquals(10, state.getSnapshotIndex()));
1460 IntegrationTestKit.verifyShardState(followerDistributedDataStore, "cars",
1461 state -> assertEquals(10, state.getSnapshotIndex()));
1463 // however the real snapshot still has not changed and was taken at index 1
1464 verifySnapshot("member-1-shard-cars-testSnapshotOnRootOverwrite", 1);
1465 verifySnapshot("member-2-shard-cars-testSnapshotOnRootOverwrite", 1);
1467 // root overwrite so expect a snapshot
1468 leaderTestKit.testWriteTransaction(leaderDistributedDataStore, YangInstanceIdentifier.empty(), rootNode);
1470 // this was a real snapshot so everything should be in it(1(DisableTrackingPayload) + 1 + 10 + 1)
1471 IntegrationTestKit.verifyShardState(leaderDistributedDataStore, "cars",
1472 state -> assertEquals(12, state.getSnapshotIndex()));
1473 IntegrationTestKit.verifyShardState(followerDistributedDataStore, "cars",
1474 state -> assertEquals(12, state.getSnapshotIndex()));
1476 verifySnapshot("member-1-shard-cars-testSnapshotOnRootOverwrite", 12);
1477 verifySnapshot("member-2-shard-cars-testSnapshotOnRootOverwrite", 12);
1480 private void verifySnapshot(final String persistenceId, final long lastAppliedIndex) {
1481 await().atMost(5, TimeUnit.SECONDS).untilAsserted(() -> {
1482 List<Snapshot> snap = InMemorySnapshotStore.getSnapshots(persistenceId, Snapshot.class);
1483 assertEquals(1, snap.size());
1484 assertEquals(lastAppliedIndex, snap.get(0).getLastAppliedIndex());
1489 private static void verifySnapshot(final Snapshot actual, final Snapshot expected,
1490 final NormalizedNode expRoot) {
1491 assertEquals("Snapshot getLastAppliedTerm", expected.getLastAppliedTerm(), actual.getLastAppliedTerm());
1492 assertEquals("Snapshot getLastAppliedIndex", expected.getLastAppliedIndex(), actual.getLastAppliedIndex());
1493 assertEquals("Snapshot getLastTerm", expected.getLastTerm(), actual.getLastTerm());
1494 assertEquals("Snapshot getLastIndex", expected.getLastIndex(), actual.getLastIndex());
1495 assertEquals("Snapshot state type", ShardSnapshotState.class, actual.getState().getClass());
1496 MetadataShardDataTreeSnapshot shardSnapshot =
1497 (MetadataShardDataTreeSnapshot) ((ShardSnapshotState)actual.getState()).getSnapshot();
1498 assertEquals("Snapshot root node", expRoot, shardSnapshot.getRootNode().get());
1501 private static void sendDatastoreContextUpdate(final AbstractDataStore dataStore, final Builder builder) {
1502 final Builder newBuilder = DatastoreContext.newBuilderFrom(builder.build());
1503 final DatastoreContextFactory mockContextFactory = mock(DatastoreContextFactory.class);
1504 final Answer<DatastoreContext> answer = invocation -> newBuilder.build();
1505 doAnswer(answer).when(mockContextFactory).getBaseDatastoreContext();
1506 doAnswer(answer).when(mockContextFactory).getShardDatastoreContext(anyString());
1507 dataStore.onDatastoreContextUpdated(mockContextFactory);