From 6f6848dff80abd5d5c20ff3b39d3c2707d24dbbd Mon Sep 17 00:00:00 2001 From: Heather Halter Date: Mon, 15 May 2023 14:59:57 -0700 Subject: [PATCH] More redirect updates (#4077) * more redirects Signed-off-by: Heather Halter * fixlinks Signed-off-by: Heather Halter * fixedlinks Signed-off-by: Heather Halter --------- Signed-off-by: Heather Halter --- _api-reference/cat/cat-indices.md | 6 +++--- _api-reference/cat/cat-recovery.md | 2 +- _api-reference/cat/cat-segments.md | 2 +- _api-reference/cat/cat-shards.md | 2 +- _api-reference/explain.md | 2 ++ _api-reference/index-apis/create-index.md | 5 +++-- _api-reference/multi-search.md | 16 +++++++++------- _api-reference/remote-info.md | 2 ++ .../install-dashboards/index.md | 9 +++------ _tools/index.md | 18 ++++++++++-------- _upgrade-to/upgrade-to.md | 2 +- index.md | 4 ++-- 12 files changed, 38 insertions(+), 32 deletions(-) diff --git a/_api-reference/cat/cat-indices.md b/_api-reference/cat/cat-indices.md index cbd75c627a..06da384986 100644 --- a/_api-reference/cat/cat-indices.md +++ b/_api-reference/cat/cat-indices.md @@ -28,7 +28,7 @@ GET _cat/indices/?v ``` {% include copy-curl.html %} -If you want to get information for more than one index, separate the indices with commas: +If you want to get information for more than one index, separate the indexes with commas: ```json GET _cat/indices/index1,index2,index3 @@ -51,12 +51,12 @@ In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-refe Parameter | Type | Description :--- | :--- | :--- bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). -health | String | Limit indices based on their health status. Supported values are `green`, `yellow`, and `red`. +health | String | Limit indexes based on their health status. Supported values are `green`, `yellow`, and `red`. include_unloaded_segments | Boolean | Whether to include information from segments not loaded into memory. Default is false. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds. pri | Boolean | Whether to return information only from the primary shards. Default is false. time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). -expand_wildcards | Enum | Expands wildcard expressions to concrete indices. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`. +expand_wildcards | Enum | Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`. ## Response diff --git a/_api-reference/cat/cat-recovery.md b/_api-reference/cat/cat-recovery.md index ed8ab43ee0..5fe83f9268 100644 --- a/_api-reference/cat/cat-recovery.md +++ b/_api-reference/cat/cat-recovery.md @@ -29,7 +29,7 @@ GET _cat/recovery/?v ``` {% include copy-curl.html %} -If you want to get information for more than one index, separate the indices with commas: +If you want to get information for more than one index, separate the indexes with commas: ```json GET _cat/recovery/index1,index2,index3 diff --git a/_api-reference/cat/cat-segments.md b/_api-reference/cat/cat-segments.md index 6d7cf8036c..0fb56d7e26 100644 --- a/_api-reference/cat/cat-segments.md +++ b/_api-reference/cat/cat-segments.md @@ -29,7 +29,7 @@ GET _cat/segments/?v ``` {% include copy-curl.html %} -If you want to get information for more than one index, separate the indices with commas: +If you want to get information for more than one index, separate the indexes with commas: ``` GET _cat/segments/index1,index2,index3 diff --git a/_api-reference/cat/cat-shards.md b/_api-reference/cat/cat-shards.md index f7cd507c29..5caf07f7af 100644 --- a/_api-reference/cat/cat-shards.md +++ b/_api-reference/cat/cat-shards.md @@ -29,7 +29,7 @@ GET _cat/shards/?v ``` {% include copy-curl.html %} -If you want to get information for more than one index, separate the indices with commas: +If you want to get information for more than one index, separate the indexes with commas: ``` GET _cat/shards/index1,index2,index3 diff --git a/_api-reference/explain.md b/_api-reference/explain.md index f7b2d6f7cd..97f5f622de 100644 --- a/_api-reference/explain.md +++ b/_api-reference/explain.md @@ -2,6 +2,8 @@ layout: default title: Explain nav_order: 30 +redirect_from: + - /opensearch/rest-api/explain/ --- # Explain diff --git a/_api-reference/index-apis/create-index.md b/_api-reference/index-apis/create-index.md index 57ebf33098..635e7484f7 100644 --- a/_api-reference/index-apis/create-index.md +++ b/_api-reference/index-apis/create-index.md @@ -5,13 +5,14 @@ parent: Index APIs nav_order: 1 redirect_from: - /opensearch/rest-api/index-apis/create-index/ + - opensearch/rest-api/create-index/ --- # Create index Introduced 1.0 {: .label .label-purple } -While you can create an index by using a document as a base, you can also create an empty index for use later. +While you can create an index by using a document as a base, you can also create an empty index for later use. ## Example @@ -85,7 +86,7 @@ index.codec | The compression type to use to compress stored data. Available val index.routing_partition_size | The number of shards a custom routing value can go to. Routing helps an imbalanced cluster by relocating values to a subset of shards rather than just a single shard. To enable, set this value to greater than 1 but less than `index.number_of_shards`. Default is 1. index.soft_deletes.retention_lease.period | The maximum amount of time to retain a shard's history of operations. Default is `12h`. index.load_fixed_bitset_filters_eagerly | Whether OpenSearch should pre-load cached filters. Available options are `true` and `false`. Default is `true`. -index.hidden | Whether the index should be hidden. Hidden indices are not returned as part of queries that have wildcards. Available options are `true` and `false`. Default is `false`. +index.hidden | Whether the index should be hidden. Hidden indexes are not returned as part of queries that have wildcards. Available options are `true` and `false`. Default is `false`. #### Dynamic index Settings diff --git a/_api-reference/multi-search.md b/_api-reference/multi-search.md index b895f0c5f0..9d6625e1fe 100644 --- a/_api-reference/multi-search.md +++ b/_api-reference/multi-search.md @@ -2,6 +2,8 @@ layout: default title: Multi-search nav_order: 45 +redirect_from: + - /opensearch/rest-api/multi-search/ --- # Multi-search @@ -46,7 +48,7 @@ Query\n ``` -- Metadata lines include options, such as which indices to search and the type of search. +- Metadata lines include options, such as which indexes to search and the type of search. - Query lines use the [query DSL]({{site.url}}{{site.baseurl}}/opensearch/query-dsl/). Just like the [bulk]({{site.url}}{{site.baseurl}}/api-reference/document-apis/bulk/) operation, the JSON doesn't need to be minified---spaces are fine---but it does need to be on a single line. OpenSearch uses newline characters to parse multi-search requests and requires that the request body end with a newline character. @@ -58,11 +60,11 @@ All multi-search URL parameters are optional. Some can also be applied per-searc Parameter | Type | Description | Supported in metadata line :--- | :--- | :--- -allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indices. Default is `true`. | Yes +allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indexes. Default is `true`. | Yes cancel_after_time_interval | Time | The time after which the search request will be canceled. Supported at both parent and child request levels. The order of precedence is:
1. Child-level parameter
2. Parent-level parameter
3. [Cluster setting]({{site.url}}{{site.baseurl}}/api-reference/cluster-settings).
Default is -1. | Yes css_minimize_roundtrips | Boolean | Whether OpenSearch should try to minimize the number of network round trips between the coordinating node and remote clusters (only applicable to cross-cluster search requests). Default is `true`. | No -expand_wildcards | Enum | Expands wildcard expressions to concrete indices. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`. | Yes -ignore_unavailable | Boolean | If an index from the indices list doesn’t exist, whether to ignore it rather than fail the query. Default is `false`. | Yes +expand_wildcards | Enum | Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`. | Yes +ignore_unavailable | Boolean | If an index from the indexes list doesn’t exist, whether to ignore it rather than fail the query. Default is `false`. | Yes max_concurrent_searches | Integer | The maximum number of concurrent searches. The default depends on your node count and search thread pool size. Higher values can improve performance, but risk overloading the cluster. | No max_concurrent_shard_requests | Integer | Maximum number of concurrent shard requests that each search executes per node. Default is 5. Higher values can improve performance, but risk overloading the cluster. | No pre_filter_shard_size | Integer | Default is 128. | No @@ -81,10 +83,10 @@ Some options can't be applied as URL parameters to the entire request. Instead, Option | Type | Description :--- | :--- | :--- -index | String, string array | If you don't specify an index or multiple indices as part of the URL (or want to override the URL value for an individual search), you can include it here. Examples include `"logs-*"` and `["my-store", "sample_data_ecommerce"]`. +index | String, string array | If you don't specify an index or multiple indexes as part of the URL (or want to override the URL value for an individual search), you can include it here. Examples include `"logs-*"` and `["my-store", "sample_data_ecommerce"]`. preference | String | The nodes or shards that you'd like to perform the search. This setting can be useful for testing, but in most situations, the default behavior provides the best search latencies. Options include `_local`, `_only_local`, `_prefer_nodes`, `_only_nodes`, and `_shards`. These last three options accept a list of nodes or shards. Examples include `"_only_nodes:data-node1,data-node2"` and `"_shards:0,1`. -request_cache | Boolean | Whether to cache results, which can improve latency for repeat searches. Default is to use the `index.requests.cache.enable` setting for the index (which defaults to `true` for new indices). -routing | String | Comma-separated custom routing values (e.g. `"routing": "value1,value2,value3"`. +request_cache | Boolean | Whether to cache results, which can improve latency for repeat searches. Default is to use the `index.requests.cache.enable` setting for the index (which defaults to `true` for new indexes). +routing | String | Comma-separated custom routing values, for example, `"routing": "value1,value2,value3"`. ## Response diff --git a/_api-reference/remote-info.md b/_api-reference/remote-info.md index 9f2e702923..88fd8e8766 100644 --- a/_api-reference/remote-info.md +++ b/_api-reference/remote-info.md @@ -2,6 +2,8 @@ layout: default title: Remote cluster information nav_order: 67 +redirect_from: + - /opensearch/rest-api/remote-info/ --- # Remote cluster information diff --git a/_install-and-configure/install-dashboards/index.md b/_install-and-configure/install-dashboards/index.md index c9cb4469a5..5dc9cb00b0 100644 --- a/_install-and-configure/install-dashboards/index.md +++ b/_install-and-configure/install-dashboards/index.md @@ -4,17 +4,14 @@ title: Installing OpenSearch Dashboards nav_order: 3 has_children: true redirect_from: - - /dashboards/install/ + - /dashboards/install/index/ - /dashboards/compatibility/ + - /install-and-configure/install-dashboards/index/ --- # Installing OpenSearch Dashboards -This section details how to install and configure OpenSearch Dashboards. - -## Installation options - -OpenSearch Dashboards has the following installation options: +OpenSearch Dashboards provides a fully integrated solution for visually exploring, discovering, and querying your observability data. You can install OpenSearch Dashboards with any of the following options: - [Docker]({{site.url}}{{site.baseurl}}/install-and-configure/install-dashboards/docker/) - [Tarball]({{site.url}}{{site.baseurl}}/install-and-configure/install-dashboards/tar/) diff --git a/_tools/index.md b/_tools/index.md index 552c43c76a..517d2b35f5 100644 --- a/_tools/index.md +++ b/_tools/index.md @@ -5,7 +5,7 @@ nav_order: 50 has_children: false nav_exclude: true redirect_from: - - /clients/agents-and-ingestion-tools/ + - /clients/agents-and-ingestion-tools/index/ --- # OpenSearch tools @@ -16,6 +16,8 @@ This section provides documentation for OpenSearch-supported tools, including: - [OpenSearch CLI](#opensearch-cli) - [OpenSearch Kubernetes operator](#opensearch-kubernetes-operator) +For information about Data Prepper, the server-side data collector for filtering, enriching, transforming, normalizing, and aggregating data for downstream analytics and visualization, see [Data Prepper]({{site.url}}{{site.baseurl}}/data-prepper/index/). + ## Agents and ingestion tools Historically, many multiple popular agents and ingestion tools have worked with Elasticsearch OSS, such as Beats, Logstash, Fluentd, FluentBit, and OpenTelemetry. OpenSearch aims to continue to support a broad set of agents and ingestion tools, but not all have been tested or have explicitly added OpenSearch compatibility. @@ -51,7 +53,7 @@ ecs_compatibility => disabled You can download the OpenSearch output plugin for Logstash from [OpenSearch downloads](https://opensearch.org/downloads.html). The Logstash output plugin is compatible with OpenSearch and Elasticsearch OSS (7.10.2 or lower). -These are the latest versions of Beats OSS with OpenSearch compatibility. For more information, see the [compatibility matrices](#compatibility-matrices). +These are the latest versions of Beats OSS with OpenSearch compatibility. For more information, see the Compatibility matrices section, below. - [Filebeat OSS 7.12.1](https://www.elastic.co/downloads/past-releases/filebeat-oss-7-12-1) - [Metricbeat OSS 7.12.1](https://www.elastic.co/downloads/past-releases/metricbeat-oss-7-12-1) @@ -64,12 +66,12 @@ Some users report compatibility issues with ingest pipelines on these versions o {: .note } -## Compatibility Matrices +## Compatibility matrices *Italicized* cells are untested, but indicate what a value theoretically should be based on existing information. -### Compatibility Matrix for Logstash +### Compatibility matrix for Logstash | | Logstash OSS 7.0.0 to 7.11.x | Logstash OSS 7.12.x\* | Logstash 7.13.x-7.16.x without OpenSearch output plugin | Logstash 7.13.x-7.16.x with OpenSearch output plugin | Logstash 8.x+ with OpenSearch output plugin | :---| :--- | :--- | :--- | :--- | :--- | @@ -82,7 +84,7 @@ Some users report compatibility issues with ingest pipelines on these versions o \* Most current compatible version with Elasticsearch OSS. -### Compatibility Matrix for Beats +### Compatibility matrix for Beats | | Beats OSS 7.0.0 to 7.11.x\*\* | Beats OSS 7.12.x\* | Beats 7.13.x | | :--- | :--- | :--- | :--- | @@ -97,15 +99,15 @@ Some users report compatibility issues with ingest pipelines on these versions o \* Most current compatible version with Elasticsearch OSS. -\*\* Beats OSS includes all Apache 2.0 Beats agents (i.e. Filebeat, Metricbeat, Auditbeat, Heartbeat, Winlogbeat, Packetbeat). +\*\* Beats OSS includes all Apache 2.0 Beats agents (that is, Filebeat, Metricbeat, Auditbeat, Heartbeat, Winlogbeat, and Packetbeat). Beats versions newer than 7.12.x are not supported by OpenSearch. If you must update the Beats agent(s) in your environment to a newer version, you can work around the incompatibility by directing traffic from Beats to Logstash and using the Logstash Output plugin to ingest the data to OpenSearch. {: .warning } ## OpenSearch CLI -The OpenSearch CLI command line interface (opensearch-cli) lets you manage your OpenSearch cluster from the command line and automate tasks. For more information on OpenSearch CLI, see [OpenSearch CLI]({{site.url}}{{site.baseurl}}/tools/cli/). +The OpenSearch CLI command line interface (opensearch-cli) lets you manage your OpenSearch cluster from the command line and automate tasks. For more information about OpenSearch CLI, see [OpenSearch CLI]({{site.url}}{{site.baseurl}}/tools/cli/). ## OpenSearch Kubernetes operator -The OpenSearch Kubernetes (K8s) Operator is an open-source kubernetes operator that helps automate the deployment and provisioning of OpenSearch and OpenSearch Dashboards in a containerized environment. For information on how to use the K8s operator, see [OpenSearch Kubernetes operator]({{site.url}}{{site.baseurl}}/tools/k8s-operator/) \ No newline at end of file +The OpenSearch Kubernetes (K8s) Operator is an open-source kubernetes operator that helps automate the deployment and provisioning of OpenSearch and OpenSearch Dashboards in a containerized environment. For information about how to use the K8s operator, see [OpenSearch Kubernetes operator]({{site.url}}{{site.baseurl}}/tools/k8s-operator/) \ No newline at end of file diff --git a/_upgrade-to/upgrade-to.md b/_upgrade-to/upgrade-to.md index 16af1fb938..fc82528c53 100644 --- a/_upgrade-to/upgrade-to.md +++ b/_upgrade-to/upgrade-to.md @@ -144,7 +144,7 @@ If you are migrating an Open Distro for Elasticsearch cluster, we recommend firs 1. Port your settings from `elasticsearch.yml` to `opensearch.yml`. Most settings use the same names. At a minimum, specify `cluster.name`, `node.name`, `discovery.seed_hosts`, and `cluster.initial_cluster_manager_nodes`. - 1. (Optional) If you're actively connecting to the cluster with legacy clients that check for a particular version number, such as Logstash OSS, add a [compatibility setting]({{site.url}}{{site.baseurl}}/clients/agents-and-ingestion-tools/) to `opensearch.yml`: + 1. (Optional) If you're actively connecting to the cluster with legacy clients that check for a particular version number, such as Logstash OSS, add a [compatibility setting]({{site.url}}{{site.baseurl}}/tools/index/) to `opensearch.yml`: ```yml compatibility.override_main_response_version: true diff --git a/index.md b/index.md index 8b1ab0b96e..6091e8c7ea 100755 --- a/index.md +++ b/index.md @@ -12,8 +12,8 @@ permalink: / - [About OpenSearch]({{site.url}}{{site.baseurl}}/opensearch/) - [Quickstart]({{site.url}}{{site.baseurl}}/quickstart/) -- [Install OpenSearch]({{site.url}}{{site.baseurl}}/opensearch/install/) -- [Install OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/install/) +- [Install OpenSearch]({{site.url}}{{site.baseurl}}/install-and-configure/install-opensearch/index/) +- [Install OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/install-and-configure/install-dashboards/index/) - [See the FAQ](https://opensearch.org/faq) ## Why use OpenSearch?