Skip to content

Commit 4dbc5ee

Browse files
committed
variable, remove duplicate migration processes
1 parent a584372 commit 4dbc5ee

File tree

9 files changed

+25
-40
lines changed

9 files changed

+25
-40
lines changed

deploy-manage/deploy/elastic-cloud/heroku-getting-started-accessing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ applies_to:
1111
You use the console to manage your cluster from a web browser. Tasks that are available from the console include upgrading versions, configuring security features, working with custom plugins, and more.
1212

1313
:::{image} ../../../images/cloud-heroku-ech-console.png
14-
:alt: [Elasticsearch Add-On for Heroku console](https://cloud.elastic.co?page=docs&placement=docs-body)
14+
:alt: [{{heroku}} console](https://cloud.elastic.co?page=docs&placement=docs-body)
1515
:::
1616

1717
To access the console in a browser from the Heroku CLI:
@@ -21,7 +21,7 @@ heroku addons:open foundelasticsearch --app MY_APP
2121
Opening https://addons-sso.heroku.com/apps/e286f875-cbdb-47a9-b445-e94bnnnnnnnn/addons/9b883e93-3db3-4491-b620-c3dfnnnnnnnn...
2222
```
2323

24-
Alternatively, you can access the console by visiting the [Heroku Dashboard](https://dashboard.heroku.com/), selecting your app, and opening the Elasticsearch link.
24+
Alternatively, you can access the console by visiting the [Heroku Dashboard](https://dashboard.heroku.com/), selecting your app, and opening the {{es}} link.
2525

2626

2727
To learn how to access {{kib}}, refer to [](/deploy-manage/deploy/elastic-cloud/access-kibana.md).

deploy-manage/deploy/elastic-cloud/heroku-getting-started-installing.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,14 @@ applies_to:
99

1010
# Install the add-on [ech-getting-started-installing]
1111

12-
These steps walk you through installing the Elasticsearch Add-On for Heroku from the Heroku CLI. You can either install the latest default version of the add-on or you can install a specific version and include plugins at the same time.
12+
These steps walk you through installing the {{heroku}} from the Heroku CLI. You can either install the latest default version of the add-on or you can install a specific version and include plugins at the same time.
1313

1414

1515
## Before you begin [echbefore_you_begin]
1616

17-
The installation steps in this section assume that you have a basic working knowledge of the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli) and are familiar with using the command line. To work with the Elasticsearch Add-On for Heroku from the command line, you need to have the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli) already installed.
17+
The installation steps in this section assume that you have a basic working knowledge of the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli) and are familiar with using the command line. To work with the {{heroku}} from the command line, you need to have the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli) already installed.
1818

19-
If you prefer to install the add-on through your web browser, go to the [Elasticsearch add-on](https://elements.heroku.com/addons/foundelasticsearch) page in the Elements Marketplace, select **Install Elasticsearch**, pick the add-on plan you want, and select **Provision add-on**.
19+
If you prefer to install the add-on through your web browser, go to the [{{es}} add-on](https://elements.heroku.com/addons/foundelasticsearch) page in the Elements Marketplace, select **Install Elasticsearch**, pick the add-on plan you want, and select **Provision add-on**.
2020

2121

2222
## Steps [echsteps]
@@ -27,7 +27,7 @@ To install the latest add-on for `MY_APP` using the Heroku CLI:
2727
heroku addons:create foundelasticsearch --app MY_APP
2828
```
2929

30-
After the Elasticsearch Add-On for Heroku gets added, you can find the canonical URL you use to access your newly provisioned cluster in the configuration for the app. Look for the `FOUNDELASTICSEARCH_URL` setting when you grep on the output of the `heroku config` command:
30+
After the {{heroku}} gets added, you can find the canonical URL you use to access your newly provisioned cluster in the configuration for the app. Look for the `FOUNDELASTICSEARCH_URL` setting when you grep on the output of the `heroku config` command:
3131

3232
```bash
3333
heroku config --app MY_APP | grep FOUNDELASTICSEARCH_URL
@@ -38,7 +38,7 @@ FOUNDELASTICSEARCH_URL: https://74f176887fdef36bb51e6e37nnnnnnnn.us-east-1.aws.f
3838

3939
If you want your add-on to run a specific version of Elasticsearch, use the `--elasticsearch-version` parameter. We also provide many of the plugins that are available for Elasticsearch. You use the `--plugins` parameter to specify a comma-separated list of plugins that you want installed.
4040

41-
To find which Elasticsearch versions and plugins are currently available, you can omit the version to default to the latest one and add plugins later on from the [Elasticsearch Add-On for Heroku console](https://cloud.elastic.co?page=docs&placement=docs-body). To use your own custom plugins, you can upload and select these plugins in the console as well.
41+
To find which {{es}} versions and plugins are currently available, you can omit the version to default to the latest one and add plugins later on from the [{{heroku}} console](https://cloud.elastic.co?page=docs&placement=docs-body). To use your own custom plugins, you can upload and select these plugins in the console as well.
4242

4343
For example: Install the add-on version {{stack-version}} and include the phonetic analysis plugin for MY_APP:
4444

deploy-manage/deploy/elastic-cloud/heroku-migrating.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ applies_to:
88

99
# Migrate between plans [ech-migrating]
1010

11-
Plans for the Elasticsearch Add-On for Heroku differ based on:
11+
Plans for the {{heroku}} differ based on:
1212

1313
* How much memory and disk space are available
1414
* How many data centers your cluster is replicated across to achieve high availability
1515

16-
Available memory is an important factor for performance when sizing your Elasticsearch cluster, and replicating across multiple data centers is important for the resilience of production applications.
16+
Available memory is an important factor for performance when sizing your {{es}} cluster, and replicating across multiple data centers is important for the resilience of production applications.
1717

18-
To learn more about what plans are available for Heroku users, check the [Elasticsearch add-on](https://elements.heroku.com/addons/foundelasticsearch) in the Elements Marketplace.
18+
To learn more about what plans are available for Heroku users, check the [{{es}} add-on](https://elements.heroku.com/addons/foundelasticsearch) in the Elements Marketplace.
1919

2020
You should time the migration to a new plan to ensure proper application function during the migration process. A cluster that is already overwhelmed with requests will take much longer to migrate to a larger capacity; if your workload warrants a plan change to increase capacity, migrate to a larger plan early.
2121

deploy-manage/deploy/elastic-cloud/heroku-reference-hardware.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,18 @@ applies_to:
99
ess:
1010
---
1111

12-
# Elasticsearch Add-On for Heroku hardware [ech-reference-hardware]
12+
# {{heroku}} hardware [ech-reference-hardware]
1313

1414
{{ech}} deployments use a range of virtualized hardware resources from a cloud provider, such as Amazon EC2 (AWS). Instance configurations enable the products and features of the {{stack}} to run on suitable resources that support their intended purpose. For example, if you have a logging use case that benefits from large amounts of slower but more cost-efficient storage space, you can use large spindle drives rather than more expensive SSD storage. Each instance configuration provides a combination of CPU resources, memory, and storage, all of which you can scale from small to very large.
1515

1616
::::{note}
1717
All instances are set to UTC timezone.
1818
::::
1919

20-
The Elasticsearch Add-On for Heroku runs exclusively on AWS. To understand the available hardware, refer to the following resources:
20+
The {{heroku}} runs exclusively on AWS. To understand the available hardware, refer to the following resources:
2121

2222
* [The {{ech}} hardware overview](cloud://reference/cloud-hosted/hardware.md)
2323
* [AWS hardware](cloud://reference/cloud-hosted/aws.md)
2424
* [AWS default hardware](cloud://reference/cloud-hosted/aws-default.md)
2525

26-
Some hardware profiles might not be available in your region. To learn about regions used by the Elasticsearch Add-On for Heroku, refer to [](/deploy-manage/deploy/elastic-cloud/heroku-reference-regions.md).
26+
Some hardware profiles might not be available in your region. To learn about regions used by the {{heroku}}, refer to [](/deploy-manage/deploy/elastic-cloud/heroku-reference-regions.md).

deploy-manage/deploy/elastic-cloud/heroku-reference-regions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ applies_to:
77
ess:
88
---
99

10-
# Elasticsearch Add-On for Heroku regions [ech-reference-regions]
10+
# {{heroku}} regions [ech-reference-regions]
1111

12-
A region is the geographic area where the data center of the cloud provider that hosts your deployment is located. Use the information listed here to decide which Elasticsearch Add-On for Heroku region to use. Your choice should be based on:
12+
A region is the geographic area where the data center of the cloud provider that hosts your deployment is located. Use the information listed here to decide which {{heroku}} region to use. Your choice should be based on:
1313

1414
* Your geographic proximity to the region. Picking a region that is closer to you typically reduces latency for indexing and search requests.
1515
* The features that we support for the region. Not all regions support the same set of features.
1616

17-
Elasticsearch Add-On for Heroku handles all hosting details for you, no additional accounts with the underlying cloud provider required. The region you select cannot be changed after you create a deployment. If you want to use a different region later on, you can create a new deployment and reindex your data into it.
17+
{{heroku}} handles all hosting details for you, no additional accounts with the underlying cloud provider required. The region you select cannot be changed after you create a deployment. If you want to use a different region later on, you can create a new deployment and reindex your data into it.
1818

1919
::::{tip}
2020
If you are not sure what to pick, choose a region that is geographically close to you to reduce latency. You should always use HTTPS to connect to the {{stack}} components of your deployment.

deploy-manage/deploy/elastic-cloud/heroku.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The {{es}} Add-on for Heroku has several limitations that do not apply to [other
2626

2727
Not all features of {{ecloud}} are available to Heroku users. Specifically, you cannot create additional deployments or use different deployment templates.
2828

29-
Generally, if a feature is shown as available in the [Elasticsearch Add-On for Heroku console](https://cloud.elastic.co?page=docs&placement=docs-body), you can use it.
29+
Generally, if a feature is shown as available in the [{{heroku}} console](https://cloud.elastic.co?page=docs&placement=docs-body), you can use it.
3030

3131
[{{es}} Machine Learning](https://www.elastic.co/guide/en/machine-learning/current/index.html), [Elastic APM](/solutions/observability/apps/application-performance-monitoring-apm.md) and [Elastic Fleet Server](https://www.elastic.co/guide/en/fleet/current/fleet-overview.html) are not supported by the {{es}} Add-On for Heroku.
3232

@@ -63,15 +63,15 @@ Find more information about {{ech}} on the following pages. This information is
6363

6464
## Next steps [next-steps]
6565

66-
After have provisioned your first deployment, you’re ready to index data into the deployment and explore the advanced capabilities of Elasticsearch Add-On for Heroku.
66+
After have provisioned your first deployment, you’re ready to index data into the deployment and explore the advanced capabilities of {{heroku}}.
6767

6868
### Index data [ech-ingest-data]
6969

7070
There are several ways to ingest data into the deployment:
7171

7272
* Use the sample data available from the {{kib}} home page without loading your own data. There are multiple data sets available and you can add them with one click.
7373
* Ingest your own data. [Learn more](/manage-data/ingest.md).
74-
* Have existing Elasticsearch data? Consider your [migration options](../../../manage-data/migrate.md).
74+
* Have existing {{es}} data? Consider your [migration options](../../../manage-data/migrate.md).
7575

7676

7777
### Increase security [ech-increase-security]

docset.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -421,4 +421,5 @@ subs:
421421
eck_version: "3.0.0"
422422
apm_server_version: "9.0.0"
423423
version: "9.0.0"
424-
release-date: "2-April-2025"
424+
release-date: "2-April-2025"
425+
heroku: "Elasticsearch Add-on for Heroku"

manage-data/migrate.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ applies_to:
1414

1515
# Migrate your {{es}} data
1616

17-
You might have switched to {{ech}}, {{ece}}, or Elasticsearch Add-On for Heroku for any number of reasons, and you’re likely wondering how to get your existing {{es}} data into your new infrastructure. Along with easily creating as many new deployments with {{es}} clusters that you need, you have several options for moving your data over. Choose the option that works best for you:
17+
You might have switched to {{ech}} or {{ece}} for any number of reasons, and you’re likely wondering how to get your existing {{es}} data into your new infrastructure. Along with easily creating as many new deployments with {{es}} clusters that you need, you have several options for moving your data over. Choose the option that works best for you:
1818

1919
* Index your data from the original source, which is the simplest method and provides the greatest flexibility for the {{es}} version and ingestion method.
2020
* Reindex from a remote cluster, which rebuilds the index from scratch.
@@ -36,7 +36,7 @@ Restore from a snapshot
3636
: The new cluster must be the same size as your old one, or larger, to accommodate the data. The new cluster must also be an Elasticsearch version that is compatible with the old cluster (check [Elasticsearch snapshot version compatibility](/deploy-manage/tools/snapshot-and-restore.md#snapshot-restore-version-compatibility) for details). If you have not already done so, you will need to [set up snapshots for your old cluster](/deploy-manage/tools/snapshot-and-restore/self-managed.md) using a repository that can be accessed from the new cluster.
3737

3838
Migrating internal {{es}} indices
39-
: For {{ech}} and Elasticsearch Add-On for Heroku, if you are migrating internal {{es}} indices from another cluster, specifically the `.kibana` index or the `.security` index, there are two options:
39+
: For {{ech}}, if you are migrating internal {{es}} indices from another cluster, specifically the `.kibana` index or the `.security` index, there are two options:
4040

4141
* Use the steps on this page to reindex the internal indices from a remote cluster. The steps for reindexing internal indices and regular, data indices are the same.
4242
* Check [Migrating internal indices](migrate/migrate-internal-indices.md) to restore the internal {{es}} indices from a snapshot.
@@ -55,7 +55,7 @@ If the original source isn’t available or has other issues that make it non-vi
5555

5656
Through the {{es}} reindex API, you can connect your new {{es}} Service deployment remotely to your old {{es}} cluster. This pulls the data from your old cluster and indexes it into your new one. Reindexing essentially rebuilds the index from scratch and it can be more resource intensive to run.
5757

58-
1. Log in to {{ech}}, {{ece}}, or Elasticsearch Add-On for Heroku.
58+
1. Log in to {{ech}} or {{ece}}.
5959
2. Select a deployment or create one.
6060
3. If the old {{es}} cluster is on a remote host (any type of host accessible over the internet), you need to make sure that the host can be accessed. Access is determined by the {{es}} `reindex.remote.whitelist` user setting.
6161

@@ -147,7 +147,7 @@ For {{ece}} users, while it is most common to have Amazon S3 buckets, you should
147147

148148
::::{tab-set}
149149

150-
:::{tab-item} {{ech}} and Elasticsearch Add-On for Heroku
150+
:::{tab-item} {{ech}}
151151

152152
From the [console](https://cloud.elastic.co?page=docs&placement=docs-body) of the **new** {{es}} cluster, add the snapshot repository.
153153

manage-data/migrate/migrate-internal-indices.md

Lines changed: 0 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -51,28 +51,12 @@ To restore internal indices from a snapshot, the procedure is a bit different fr
5151
5252
3. To restore internal {{es}} indices, you need to register the snapshot repository in `read-only` mode.
5353
54-
::::{tab-set}
55-
56-
:::{tab-item} {{ech}}
5754
First, add the authentication information for the repository to the {{ech}} keystore, following the steps for your cloud provider:
5855
* [AWS S3](../../deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md#ec-snapshot-secrets-keystore)
5956
* [Google Cloud Storage](../../deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md#ec-configure-gcs-keystore)
6057
* [Azure Blog storage](../../deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md#ec-configure-azure-keystore)
6158
6259
Next, register a read-only repository. Open an {{es}} [API console](../../explore-analyze/query-filter/tools/console.md) and run the [Read-only URL repository](../../deploy-manage/tools/snapshot-and-restore/read-only-url-repository.md) API call.
63-
:::
64-
65-
:::{tab-item} Elasticsearch Add-On for Heroku
66-
First, add the authentication information for the repository to the Elasticsearch Add-On for Heroku keystore, following the steps for your cloud provider:
67-
* [AWS S3](../../deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md)
68-
* [Google Cloud Storage](../../deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md)
69-
* [Azure Blog storage](../../deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md)
70-
71-
Next, register a read-only repository. Open an {{es}} [API console](../../explore-analyze/query-filter/tools/console.md) and run the [Read-only URL repository](../../deploy-manage/tools/snapshot-and-restore/read-only-url-repository.md) API call.
72-
73-
:::
74-
75-
::::
7660
7761
4. Once the repository has been registered and verified, you are ready to restore the internal indices to your new cluster, either all at once or individually.
7862

0 commit comments

Comments
 (0)