Move and fix up lifecycle start/stop/check docs

manage-data/lifecycle/index-lifecycle-management.md

@@ -70,7 +70,6 @@ You can create and manage index lifecycle policies through {{kib}}'s [Index Mana
 * [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md)
 * [View the lifecycle status of an index or datastream](/manage-data/lifecycle/index-lifecycle-management/policy-view-status.md)
 * [Update or switch a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/policy-updates.md)
-* [Start and stop index lifecycle management](/manage-data/lifecycle/index-lifecycle-management/start-stop-index-lifecycle-management.md)
 * [Restore a managed data stream or index](/manage-data/lifecycle/index-lifecycle-management/restore-managed-data-stream-index.md)
 * [Customize built-in policies](/manage-data/lifecycle/index-lifecycle-management/tutorial-customize-built-in-policies.md)
 
@@ -82,6 +81,10 @@ Default {{ilm}} policies are created automatically when you install an [Elastic
 To automatically back up your indices and manage snapshots, use [snapshot lifecycle policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm).
 ::::
 
+## Troubleshooting {{ilm-init}}
+
+In the event of any issues running {{ilm-init}}, refer to [Troubleshoot index lifecycle management](/troubleshoot/elasticsearch/start-ilm.md) for the steps to start and stop {{ilm-init}}, and to check the lifecycle status. For detailed troubleshooting steps, refer to [Fix index lifecycle management errors](/troubleshoot/elasticsearch/index-lifecycle-management-errors.md).
+
 ## Migrate to {{ilm-init}}
 
 For existing hot-warm deployments that are currently using index curation, migrating to ILM gives you more fine-grained control over the lifecycle of each index. Read more in:

manage-data/toc.yml

@@ -129,7 +129,6 @@ toc:
           - file: lifecycle/index-lifecycle-management/policy-view-status.md
           - file: lifecycle/index-lifecycle-management/manage-lifecycle-integrations-data.md
           - file: lifecycle/index-lifecycle-management/policy-updates.md
-          - file: lifecycle/index-lifecycle-management/start-stop-index-lifecycle-management.md
           - file: lifecycle/index-lifecycle-management/restore-managed-data-stream-index.md
           - file: lifecycle/index-lifecycle-management/tutorial-customize-built-in-policies.md
           - hidden: lifecycle/index-lifecycle-management/index-management-in-kibana.md

redirects.yml

@@ -322,6 +322,9 @@ redirects:
   'explore-analyze/query-filter/languages/esql-troubleshooting.md': 'elasticsearch://reference/query-languages/esql/esql-troubleshooting.md'
   'solutions/search/esql-search-tutorial.md': 'elasticsearch://reference/query-languages/esql/esql-search-tutorial.md'
 
+# Related to https://github.com/elastic/docs-content/pull/2569
+  'manage-data/lifecycle/index-lifecycle-management/start-stop-index-lifecycle-management.md': 'troubleshoot/elasticsearch/start-ilm.md'
+
 # Related to https://github.com/elastic/docs-content/pull/2639
   'deploy-manage/monitor/autoops/ec-autoops-dismiss-event.md': 'deploy-manage/monitor/autoops/ec-autoops-events.md'
 
@@ -332,4 +335,5 @@ redirects:
   'solutions/search/querydsl-full-text-filter-tutorial.md': 'elasticsearch://reference/query-languages/query-dsl/full-text-filter-tutorial.md'
 
 # Related to https://github.com/elastic/docs-content/pull/2719
-  'solutions/search/api-quickstarts.md': 'solutions/search/get-started/quickstarts.md'
+  'solutions/search/api-quickstarts.md': 'solutions/search/get-started/quickstarts.md'
+

troubleshoot/elasticsearch/start-ilm.md

@@ -14,30 +14,11 @@ products:
   - id: elasticsearch
 ---
 
-% TODO reframe how-to stuff as troubleshooting content
-% TODO link to proper how-to content
-% TODO dropdowns?
-% TODO where does this belong? section w/ 1 page...?
-
-
 # Troubleshoot index and snapshot lifecycle management
 
-If the automatic {{ilm}} or {{slm}} service is not working, you might need to start the service.
-
-% see also fix-watermark-errors.md
-
-## Start index lifecycle management [start-ilm]
-
-Automatic index lifecycle and data retention management is currently disabled.
-
-In order to start the automatic {{ilm}} service, follow these steps:
+If the automatic [{{ilm}}](/manage-data/lifecycle/index-lifecycle-management.md) ({{ilm-init}}) or [{{slm}}](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) ({{slm-init}}) service is not working, you might need to check the lifecycle status, stop, or restart the service. You may also want to halt services during routine maintenance.
 
-:::::::{tab-set}
-
-::::::{tab-item} {{ech}}
-In order to start {{ilm}} we need to go to Kibana and execute the [start command](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-start).
-
-**Use {{kib}}**
+All of the procedures on this page use the {{es}} APIs. To run these steps using {{kib}}:
 
 1. Log in to the [{{ecloud}} console](https://cloud.elastic.co?page=docs&placement=docs-body).
 2. On the **Hosted deployments** panel, click the name of your deployment.
@@ -53,37 +34,79 @@ In order to start {{ilm}} we need to go to Kibana and execute the [start command
     :screenshot:
     :::
 
-4. [Start](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-start) {{ilm}}:
+4. Use the Dev Tools Console to run the API requests as described.
 
-    ```console
-    POST _ilm/start
-    ```
+## Check status, stop, and restart {{ilm-init}} [check-stop-start-ilm]
 
-    The response will look like this:
+Follow these steps to check the current {{ilm-init}} status, and to stop or restart it as needed.
 
-    ```console-result
-    {
-      "acknowledged": true
-    }
-    ```
+### Get {{ilm-init}} status 
 
-5. Verify {{ilm}} is now running:
+To see the current status of the {{ilm-init}} service, use the [{{ilm-init}} status API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-get-status):
 
-    ```console
-    GET _ilm/status
-    ```
+```console
+GET _ilm/status
+```
 
-    The response will look like this:
+Under normal operation, the response shows {{ilm-init}} is `RUNNING`:
 
-    ```console-result
-    {
-      "operation_mode": "RUNNING"
-    }
-    ```
-::::::
+```console-result
+{
+  "operation_mode": "RUNNING"
+}
+```
+
+### Stop {{ilm-init}} 
+
+You can stop {{ilm}} to suspend management operations for all indices. For example, you might stop {{ilm}} when performing scheduled maintenance or making changes to the cluster that could impact the execution of {{ilm-init}} actions.
 
-::::::{tab-item} Self-managed
-[Start](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-start) {{ilm}}:
+To stop the {{ilm-init}} service and pause execution of all lifecycle policies, use the [{{ilm-init}} stop API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-stop):
+
+```console
+POST _ilm/stop
+```
+
+The response will look like this:
+
+```console-result
+{
+  "acknowledged": true
+}
+```
+
+The {{ilm-init}} service runs all policies to a point where it is safe to stop. 
+
+While the {{ilm-init}} service is shutting down, run the status API to verify that {{ilm-init}} is stopping:
+
+```console
+GET _ilm/status
+```
+
+The response will look like this:
+
+```console-result
+{
+  "operation_mode": "STOPPING"
+}
+```
+
+Once all policies are at a safe stopping point, {{ilm-init}} moves into the `STOPPED` mode:
+
+```console-result
+{
+  "operation_mode": "STOPPED"
+}
+```
+
+::::{important}
+When you stop {{ilm-init}}, [{{slm-init}}](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) operations are also suspended. No snapshots will be taken as scheduled until you restart {{ilm-init}}. In-progress snapshots are not affected.
+::::
+
+### Start {{ilm-init}} [start-ilm]
+
+If the automatic {{ilm}} or {{slm}} service is not working, you might need to restart the service.
+
+To restart {{ilm-init}} and resume executing policies, use the [{{ilm-init}} start API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-start). This puts the  {{ilm-init}} service in the `RUNNING` state and {{ilm-init}} begins executing policies from where it left off.
 
 ```console
 POST _ilm/start
@@ -97,7 +120,7 @@ The response will look like this:
 }
 ```
 
-Verify {{ilm}} is now running:
+Verify that {{ilm}} is now running:
 
 ```console
 GET _ilm/status
@@ -110,68 +133,67 @@ The response will look like this:
   "operation_mode": "RUNNING"
 }
 ```
-::::::
 
-:::::::
+## Check status, stop, and restart {{slm-init}} [check-stop-start-slm]
 
-## Start snapshot lifecycle management [start-slm]
+Follow these steps to check the current {{slm-init}} status, and to stop or restart it as needed.
 
-Automatic snapshot lifecycle management is currently disabled. New backup snapshots will not be created automatically.
+### Get {{slm-init}} status 
 
-In order to start the snapshot lifecycle management service, follow these steps:
+To see the current status of the {{slm-init}} service, use the [{{slm-init}} status API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-get-status):
 
-:::::::{tab-set}
+```console
+GET _slm/status
+```
 
-::::::{tab-item} {{ech}}
-In order to start {{slm}} we need to go to Kibana and execute the [start command](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-start).
+Under normal operation, the response shows {{slm-init}} is `RUNNING`:
 
-**Use {{kib}}**
+```console-result
+{
+  "operation_mode": "RUNNING"
+}
+```
 
-1. Log in to the [{{ecloud}} console](https://cloud.elastic.co?page=docs&placement=docs-body).
-2. On the **Hosted deployments** panel, click the name of your deployment.
+### Stop {{slm-init}} 
 
-    ::::{note}
-    If the name of your deployment is disabled your {{kib}} instances might be unhealthy, in which case contact [Elastic Support](https://support.elastic.co). If your deployment doesn’t include {{kib}}, all you need to do is [enable it first](../../deploy-manage/deploy/elastic-cloud/access-kibana.md).
-    ::::
+You can stop {{slm}} to suspend management operations for all snapshots. For example, you might stop {{slm-init}} to prevent it from taking scheduled snapshots during maintenance or when making cluster changes that could be impacted by snapshot operations.
 
-3. Open your deployment’s side navigation menu (placed under the Elastic logo in the upper left corner) and go to **Dev Tools > Console**.
 
-    :::{image} /troubleshoot/images/elasticsearch-reference-kibana-console.png
-    :alt: {{kib}} Console
-    :screenshot:
-    :::
+To stop the {{slm-init}} service and pause execution of all lifecycle policies, use the [{{slm-init}} stop API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-stop):
+
+```console
+POST _slm/stop
+```
 
-4. [Start](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-start) {{slm}}:
+Stopping {{slm-init}} does not stop any snapshots that are in progress. You can manually trigger snapshots with the run snapshot lifecycle policy API even if {{slm-init}} is stopped.
 
-    ```console
-    POST _slm/start
-    ```
+The response will look like this:
+
+```console-result
+{
+  "acknowledged": true
+}
+```
 
-    The response will look like this:
+Verify that {{slm}} has stopped:
 
-    ```console-result
-    {
-      "acknowledged": true
-    }
-    ```
+```console
+GET _slm/status
+```
 
-5. Verify {{slm}} is now running:
+The response will look like this:
 
-    ```console
-    GET _slm/status
-    ```
+```console-result
+{
+  "operation_mode": "STOPPED"
+}
+```
 
-    The response will look like this:
+### Start {{slm}} [start-slm]
 
-    ```console-result
-    {
-      "operation_mode": "RUNNING"
-    }
-    ```
-::::::
+In the event that automatic {{slm}} is disabled, new backup snapshots will not be created automatically.
 
-::::::{tab-item} Self-managed
-[Start](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-start) {{slm}}:
+To restart the {{slm-init}} service, use the [{{slm-init}} start API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-slm-start).
 
 ```console
 POST _slm/start
@@ -198,6 +220,3 @@ The response will look like this:
   "operation_mode": "RUNNING"
 }
 ```
-::::::
-
-:::::::