Fix test issues with DNS resolution
Add docs to show users how to fix the same issue themselves
diff --git a/README.md b/README.md
index 0405511..94e3eb9 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,7 @@
- The released helm charts and their instructions should be used for all safe and stable deployments.
The charts found in `helm/` are not guaranteed to be compatible with the last stable release, and should only be used for development purposes.
- [Running the Solr Operator](https://apache.github.io/solr-operator/docs/running-the-operator)
+- [Known Issues](https://apache.github.io/solr-operator/docs/known-issues)
- Available Solr Resources
- [Solr Clouds](https://apache.github.io/solr-operator/docs/solr-cloud)
- [Solr Backups](https://apache.github.io/solr-operator/docs/solr-backup)
diff --git a/docs/README.md b/docs/README.md
index 04580d7..980fca1 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -21,6 +21,7 @@
- [Local Tutorial](local_tutorial.md)
- [Upgrade Notes](upgrade-notes.md)
+- [Known Issues](known-issues.md)
- [Running the Solr Operator](running-the-operator.md)
- Available Solr Resources
- [Solr Clouds](solr-cloud)
diff --git a/docs/known-issues.md b/docs/known-issues.md
new file mode 100644
index 0000000..3fc527c
--- /dev/null
+++ b/docs/known-issues.md
@@ -0,0 +1,35 @@
+<!--
+ 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.
+ -->
+
+# Known Issues
+
+## Solr Cloud
+
+- You may be seeing timeouts in your Solr logs after a rolling update.
+ This can be caused by DNS caching in CoreDNS (the default DNS for Kubernetes).
+ This can be fixed by reducing the kubernetes cache TTL to 5-10 seconds.
+ Please refer to this ticket for more information: https://github.com/kubernetes/kubernetes/issues/92559
+ \
+ Fix: In the `kube-system` namespace, there will be a `ConfigMap` with name `coredns`. It will contain a section:
+ ```
+ kubernetes cluster.local in-addr.arpa ip6.arpa {
+ ...
+ ttl 30
+ ...
+ }
+ ```
+ Edit the `ttl` value to be `5`, CoreDNS will automatically see a change in the configMap and reload it.
\ No newline at end of file
diff --git a/tests/scripts/manage_e2e_tests.sh b/tests/scripts/manage_e2e_tests.sh
index 56257dc..cc00142 100755
--- a/tests/scripts/manage_e2e_tests.sh
+++ b/tests/scripts/manage_e2e_tests.sh
@@ -183,6 +183,11 @@
kubectl create -f "${REPO_DIR}/config/dependencies/" 2>/dev/null || kubectl replace -f "${REPO_DIR}/config/dependencies/"
echo ""
+
+ printf "Edit the TTL of CoreDNS kubernetes so that statefulSet endpoints are refreshed more often\n"
+ kubectl get configmap coredns -n kube-system -o yaml | sed 's/\(.*\)ttl 30\(.*\)/\1ttl 5\2/' | kubectl replace -n kube-system -f -
+ echo ""
+
printf "Installing Cert Manager\n"
helm repo add cert-manager https://charts.jetstack.io --force-update
helm upgrade -i -n cert-manager --create-namespace cert-manager cert-manager/cert-manager --version "${CERT_MANAGER_VERSION}" --set installCRDs=true
