More tweaks

marciw · marciw · commit 4d99c1839dc1 · 2025-02-11T18:37:05.000-05:00
diff --git a/troubleshoot/elasticsearch/add-tier.md b/troubleshoot/elasticsearch/add-tier.md
@@ -1,5 +1,5 @@
 ---
-navigation_title: Index allocation data tier
+navigation_title: Preferred data tier
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/add-tier.html
 ---
diff --git a/troubleshoot/elasticsearch/clusters.md b/troubleshoot/elasticsearch/clusters.md
@@ -0,0 +1,7 @@
+---
+navigation_title: Clusters
+---
+
+# Troubleshoot Elasticsearch clusters
+
+% What needs to be done: Write from scratch
diff --git a/troubleshoot/elasticsearch/fix-common-cluster-issues.md b/troubleshoot/elasticsearch/fix-common-cluster-issues.md
@@ -1,5 +1,5 @@
 ---
-navigation_title: Clusters
+navigation_title: Common cluster issues
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/fix-common-cluster-issues.html
 ---
diff --git a/troubleshoot/elasticsearch/security/security-trb-extraargs.md b/troubleshoot/elasticsearch/security/security-trb-extraargs.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: "Users command error: extra arguments" 
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/security-trb-extraargs.html
 ---
 
-# Users command fails due to extra arguments [security-trb-extraargs]
+# Error: Extra arguments were provided [security-trb-extraargs]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/security/security-trb-settings.md b/troubleshoot/elasticsearch/security/security-trb-settings.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: Nodes info API response
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/security-trb-settings.html
 ---
 
-# Some settings are not returned via the nodes settings API [security-trb-settings]
+# Troubleshoot a nodes info API response [security-trb-settings]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/security/trb-security-internalserver.md b/troubleshoot/elasticsearch/security/trb-security-internalserver.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: Kibana internal server error
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-internalserver.html
 ---
 
-# Internal Server Error in Kibana [trb-security-internalserver]
+# Internal server error in Kibana [trb-security-internalserver]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/security/trb-security-kerberos.md b/troubleshoot/elasticsearch/security/trb-security-kerberos.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: Kerberos
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-kerberos.html
 ---
diff --git a/troubleshoot/elasticsearch/security/trb-security-maccurl.md b/troubleshoot/elasticsearch/security/trb-security-maccurl.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: Certificate verification with curl on Mac
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-maccurl.html
 ---
 
-# Certificate verification fails for curl on Mac [trb-security-maccurl]
+# Troubleshoot failed certificate verification with curl on Mac [trb-security-maccurl]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/security/trb-security-path.md b/troubleshoot/elasticsearch/security/trb-security-path.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: Configuration file relocation
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-path.html
 ---
diff --git a/troubleshoot/elasticsearch/security/trb-security-saml.md b/troubleshoot/elasticsearch/security/trb-security-saml.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: SAML
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-saml.html
 ---
diff --git a/troubleshoot/elasticsearch/security/trb-security-setup.md b/troubleshoot/elasticsearch/security/trb-security-setup.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: Password setup connection failures
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-setup.html
 ---
 
-# Setup-passwords command fails due to connection failure [trb-security-setup]
+# Troubleshoot connection failures with elasticsearch-setup-passwords [trb-security-setup]
 
 The [elasticsearch-setup-passwords command](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-passwords.html) sets passwords for the built-in users by sending user management API requests. If your cluster uses SSL/TLS for the HTTP (REST) interface, the command attempts to establish a connection with the HTTPS protocol. If the connection attempt fails, the command fails.
 
diff --git a/troubleshoot/elasticsearch/security/trb-security-ssl.md b/troubleshoot/elasticsearch/security/trb-security-ssl.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: SSL/TLS exceptions
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-ssl.html
 ---
diff --git a/troubleshoot/elasticsearch/security/trb-security-sslhandshake.md b/troubleshoot/elasticsearch/security/trb-security-sslhandshake.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: SSLHandshakeException
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-sslhandshake.html
 ---
 
-# SSLHandshakeException causes connections to fail [trb-security-sslhandshake]
+# Troubleshoot SSLHandshakeException and failed node connections [trb-security-sslhandshake]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/security/trouble-shoot-active-directory.md b/troubleshoot/elasticsearch/security/trouble-shoot-active-directory.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: Active Directory
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/trouble-shoot-active-directory.html
 ---
 
-# Users are frequently locked out of Active Directory [trouble-shoot-active-directory]
+# Troubleshoot Active Directory lockouts [trouble-shoot-active-directory]
 
 **Symptoms:**
 
diff --git a/troubleshoot/elasticsearch/snapshot-and-restore.md b/troubleshoot/elasticsearch/snapshot-and-restore.md
@@ -2,6 +2,6 @@
 navigation_title: Snapshot and restore
 ---
 
-# Troubleshoot issues with snapshots and restoring
+# Troubleshoot snapshot and restore
 
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/toc.yml b/troubleshoot/toc.yml
@@ -3,27 +3,29 @@ toc:
   - file: troubleshoot/index.md
   - file: elasticsearch/elasticsearch-reference.md
     children:
-      - file: elasticsearch/fix-common-cluster-issues.md
+      - file: elasticsearch/clusters.md
         children:
+          - file: elasticsearch/fix-common-cluster-issues.md
+            children:
+              - file: elasticsearch/fix-watermark-errors.md
+              - file: elasticsearch/circuit-breaker-errors.md
+              - file: elasticsearch/high-cpu-usage.md
+              - file: elasticsearch/high-jvm-memory-pressure.md
+              - file: elasticsearch/red-yellow-cluster-status.md
+              - file: elasticsearch/rejected-requests.md
+              - file: elasticsearch/task-queue-backlog.md
+              - file: elasticsearch/mapping-explosion.md
+              - file: elasticsearch/hotspotting.md
           - file: elasticsearch/troubleshooting-unstable-cluster.md
           - file: elasticsearch/troubleshooting-unbalanced-cluster.md
           - file: elasticsearch/elasticsearch-reference/remote-clusters.md
           - file: elasticsearch/diagnose-unassigned-shards.md
           - file: elasticsearch/troubleshooting-shards-capacity-issues.md
-          - file: elasticsearch/fix-watermark-errors.md
-          - file: elasticsearch/circuit-breaker-errors.md
-          - file: elasticsearch/high-cpu-usage.md
-          - file: elasticsearch/high-jvm-memory-pressure.md
-          - file: elasticsearch/red-yellow-cluster-status.md
-          - file: elasticsearch/rejected-requests.md
-          - file: elasticsearch/task-queue-backlog.md
-          - file: elasticsearch/mapping-explosion.md
-          - file: elasticsearch/hotspotting.md
       - file: elasticsearch/data.md
         children:
-          - file: elasticsearch/add-tier.md
           - file: elasticsearch/allow-all-cluster-allocation.md
           - file: elasticsearch/allow-all-index-allocation.md
+          - file: elasticsearch/add-tier.md
           - file: elasticsearch/troubleshoot-migrate-to-tiers.md
           - file: elasticsearch/increase-tier-capacity.md
           - file: elasticsearch/increase-shard-limit.md

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: Kerberos`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-kerberos.html`
`4`	`5`	`---`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: Configuration file relocation`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-path.html`
`4`	`5`	`---`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: SAML`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/elasticsearch/reference/current/trb-security-saml.html`
`4`	`5`	`---`