| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (the "License"); you may not use this file except in compliance with |
| * the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package org.apache.solr.cloud.autoscaling.sim; |
| |
| import java.io.IOException; |
| import java.lang.invoke.MethodHandles; |
| import java.util.ArrayList; |
| import java.util.Arrays; |
| import java.util.Collections; |
| import java.util.HashMap; |
| import java.util.HashSet; |
| import java.util.List; |
| import java.util.Map; |
| import java.util.Set; |
| import java.util.concurrent.TimeUnit; |
| import java.util.function.Predicate; |
| import java.util.regex.Pattern; |
| import java.util.stream.Collectors; |
| |
| import org.apache.solr.SolrTestCaseJ4; |
| import org.apache.solr.client.solrj.cloud.autoscaling.AutoScalingConfig; |
| import org.apache.solr.client.solrj.cloud.autoscaling.ReplicaInfo; |
| import org.apache.solr.cloud.CloudTestUtils; |
| import org.apache.solr.common.cloud.ClusterState; |
| import org.apache.solr.common.cloud.DocCollection; |
| import org.apache.solr.common.cloud.Replica; |
| import org.apache.solr.common.cloud.Slice; |
| import org.apache.solr.common.util.TimeSource; |
| import org.apache.solr.util.TimeOut; |
| import org.junit.After; |
| import org.junit.AfterClass; |
| import org.slf4j.Logger; |
| import org.slf4j.LoggerFactory; |
| |
| /** |
| * Base class for simulated test cases. Tests that use this class should configure the simulated cluster |
| * in <code>@BeforeClass</code> like this: |
| * <pre> |
| * @BeforeClass |
| * public static void setupCluster() throws Exception { |
| * cluster = configureCluster(5, TimeSource.get("simTime:50")); |
| * } |
| * </pre> |
| */ |
| public class SimSolrCloudTestCase extends SolrTestCaseJ4 { |
| private static final Logger log = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass()); |
| |
| /** The cluster. */ |
| protected static SimCloudManager cluster; |
| protected static int clusterNodeCount = 0; |
| |
| protected static void configureCluster(int nodeCount, TimeSource timeSource) throws Exception { |
| cluster = SimCloudManager.createCluster(nodeCount, timeSource); |
| clusterNodeCount = nodeCount; |
| } |
| |
| @After |
| private void checkBackgroundTaskFailureCount() { |
| if (cluster != null) { |
| assertBackgroundTaskFailureCount(cluster); |
| } |
| } |
| |
| protected static void assertBackgroundTaskFailureCount(SimCloudManager c) { |
| assert null != c; |
| assertEquals("Cluster had background tasks submitted which failed", |
| 0, c.getBackgroundTaskFailureCount()); |
| } |
| |
| @AfterClass |
| public static void shutdownCluster() throws Exception { |
| if (cluster != null) { |
| try { |
| cluster.close(); |
| assertBackgroundTaskFailureCount(cluster); |
| } finally { |
| cluster = null; |
| } |
| } |
| } |
| |
| protected static void assertAutoscalingUpdateComplete() throws Exception { |
| (new TimeOut(30, TimeUnit.SECONDS, cluster.getTimeSource())) |
| .waitFor("OverseerTriggerThread never caught up to the latest znodeVersion", () -> { |
| try { |
| AutoScalingConfig autoscalingConfig = cluster.getDistribStateManager().getAutoScalingConfig(); |
| return autoscalingConfig.getZkVersion() == cluster.getOverseerTriggerThread().getProcessedZnodeVersion(); |
| } catch (Exception e) { |
| throw new RuntimeException("FAILED", e); |
| } |
| }); |
| } |
| |
| @Override |
| public void tearDown() throws Exception { |
| super.tearDown(); |
| if (cluster != null) { |
| if (log.isInfoEnabled()) { |
| log.info(cluster.dumpClusterState(false)); |
| } |
| } |
| } |
| |
| @Override |
| public void setUp() throws Exception { |
| super.setUp(); |
| } |
| |
| /* Cluster helper methods ************************************/ |
| |
| /** |
| * Get the collection state for a particular collection |
| */ |
| protected DocCollection getCollectionState(String collectionName) throws IOException { |
| return cluster.getClusterStateProvider().getClusterState().getCollection(collectionName); |
| } |
| |
| /** |
| * Get a (reproducibly) random shard from a {@link DocCollection} |
| */ |
| protected static Slice getRandomShard(DocCollection collection) { |
| List<Slice> shards = new ArrayList<>(collection.getActiveSlices()); |
| if (shards.size() == 0) |
| fail("Couldn't get random shard for collection as it has no shards!\n" + collection.toString()); |
| Collections.shuffle(shards, random()); |
| return shards.get(0); |
| } |
| |
| /** |
| * Get a (reproducibly) random replica from a {@link Slice} |
| */ |
| protected static Replica getRandomReplica(Slice slice) { |
| List<Replica> replicas = new ArrayList<>(slice.getReplicas()); |
| if (replicas.size() == 0) |
| fail("Couldn't get random replica from shard as it has no replicas!\n" + slice.toString()); |
| Collections.shuffle(replicas, random()); |
| return replicas.get(0); |
| } |
| |
| /** |
| * Get a (reproducibly) random replica from a {@link Slice} matching a predicate |
| */ |
| protected static Replica getRandomReplica(Slice slice, Predicate<Replica> matchPredicate) { |
| List<Replica> replicas = new ArrayList<>(slice.getReplicas()); |
| if (replicas.size() == 0) |
| fail("Couldn't get random replica from shard as it has no replicas!\n" + slice.toString()); |
| Collections.shuffle(replicas, random()); |
| for (Replica replica : replicas) { |
| if (matchPredicate.test(replica)) |
| return replica; |
| } |
| fail("Couldn't get random replica that matched conditions\n" + slice.toString()); |
| return null; // just to keep the compiler happy - fail will always throw an Exception |
| } |
| |
| /** |
| * Creates & executes an autoscaling request against the current cluster, asserting that |
| * the result is a success |
| * |
| * @param json The request to send |
| * @see CloudTestUtils#assertAutoScalingRequest |
| */ |
| public void assertAutoScalingRequest(final String json) throws IOException { |
| CloudTestUtils.assertAutoScalingRequest(cluster, json); |
| } |
| |
| /** |
| * Compare two ClusterState-s, filtering out simulation framework artifacts. |
| */ |
| public static void assertClusterStateEquals(ClusterState one, ClusterState two) { |
| assertEquals(one.getLiveNodes(), two.getLiveNodes()); |
| assertEquals(one.getCollectionsMap().keySet(), two.getCollectionsMap().keySet()); |
| one.forEachCollection(oneColl -> { |
| DocCollection twoColl = two.getCollection(oneColl.getName()); |
| Map<String, Slice> oneSlices = oneColl.getSlicesMap(); |
| Map<String, Slice> twoSlices = twoColl.getSlicesMap(); |
| assertEquals(oneSlices.keySet(), twoSlices.keySet()); |
| oneSlices.forEach((s, slice) -> { |
| Slice sTwo = twoSlices.get(s); |
| for (Replica oneReplica : slice.getReplicas()) { |
| Replica twoReplica = sTwo.getReplica(oneReplica.getName()); |
| assertNotNull(twoReplica); |
| assertReplicaEquals(oneReplica, twoReplica); |
| } |
| }); |
| }); |
| } |
| |
| // ignore these because SimCloudManager always modifies them |
| private static final Set<Pattern> IGNORE_REPLICA_PATTERNS = new HashSet<>(Arrays.asList( |
| Pattern.compile("QUERY\\..*"), |
| Pattern.compile("INDEX\\..*"), |
| Pattern.compile("UPDATE\\..*"), |
| Pattern.compile("SEARCHER\\..*") |
| )); |
| |
| private static final Predicate<Map.Entry<String, Object>> REPLICA_FILTER_FUN = p -> { |
| for (Pattern pattern : IGNORE_REPLICA_PATTERNS) { |
| if (pattern.matcher(p.getKey()).matches()) { |
| return false; |
| } |
| } |
| return true; |
| }; |
| |
| public static void assertReplicaEquals(Replica one, Replica two) { |
| assertEquals(one.getName(), two.getName()); |
| assertEquals(one.getNodeName(), two.getNodeName()); |
| assertEquals(one.getState(), two.getState()); |
| assertEquals(one.getType(), two.getType()); |
| assertReplicaPropsEquals(one.getProperties(), two.getProperties()); |
| } |
| |
| @SuppressWarnings({"unchecked"}) |
| public static void assertReplicaInfoEquals(ReplicaInfo one, ReplicaInfo two) { |
| assertEquals(one.getName(), two.getName()); |
| assertEquals(one.getNode(), two.getNode()); |
| assertEquals(one.getState(), two.getState()); |
| assertEquals(one.getType(), two.getType()); |
| assertEquals(one.getCore(), two.getCore()); |
| assertEquals(one.getCollection(), two.getCollection()); |
| assertEquals(one.getShard(), two.getShard()); |
| assertEquals(one.isLeader, two.isLeader); |
| Map<String, Object> oneMap = new HashMap<>(); |
| Map<String, Object> twoMap = new HashMap<>(); |
| one.toMap(oneMap); |
| two.toMap(twoMap); |
| assertReplicaPropsEquals( |
| (Map<String, Object>)oneMap.get(one.getName()), |
| (Map<String, Object>)twoMap.get(two.getName())); |
| } |
| |
| public static void assertReplicaPropsEquals(Map<String, Object> propsOne, Map<String, Object> propsTwo) { |
| Map<String, Object> filteredPropsOne = propsOne.entrySet().stream() |
| .filter(REPLICA_FILTER_FUN) |
| .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue)); |
| Map<String, Object> filteredPropsTwo = propsTwo.entrySet().stream() |
| .filter(REPLICA_FILTER_FUN) |
| .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue)); |
| assertEquals(filteredPropsOne, filteredPropsTwo); |
| } |
| } |