Skip to content

Commit 260e2a7

Browse files
authored
Merge pull request #106627 from HeidiSteen/heidist-master
[Azure Cognitive Search] Moving service part 2
2 parents fd8f3da + 39fa213 commit 260e2a7

File tree

1 file changed

+26
-9
lines changed

1 file changed

+26
-9
lines changed

articles/search/search-howto-move-across-regions.md

Lines changed: 26 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,31 +4,48 @@ titleSuffix: Azure Cognitive Search
44
description: This article will show you how to move your Azure Cognitive Search resources from one region to another in the Azure cloud.
55

66
manager: nitinme
7-
author: tchristiani
8-
ms.author: terrychr
7+
author: HeidiSteen
8+
ms.author: heidist
99
ms.service: cognitive-search
1010
ms.topic: how-to
1111
ms.custom: subject-moving-resources
12-
ms.date: 03/05/2020
12+
ms.date: 03/06/2020
1313
---
1414

1515
# Move your Azure Cognitive Search service to another Azure region
1616

17-
Currently, moving a search service to another region is not supported, in that there is no automation or tooling to help you with the task end-to-end.
17+
Occasionally, customers inquire about moving an existing search service to another region. Currently, there are no built-in mechanisms or tooling to help you with that task. It remains a manual process, outlined below in this article.
1818

19-
In the portal, the **Export template** command produces a basic definition of a service (name, location, tier, replica, and partition count), but does not recognize the content of your service, nor does it carry over keys, roles, or logs.
19+
> [!NOTE]
20+
> In the Azure portal, all services have an **Export template** command. In the case of Azure Cognitive Search, this command produces a basic definition of a service (name, location, tier, replica, and partition count), but does not recognize the content of your service, nor does it carry over keys, roles, or logs. Although the command exists, we don't recommend using it for moving a search service.
2021
21-
When moving search from one region to another, we recommend the following approach:
22+
## Steps for moving a service
2223

23-
1. Inventory your existing service for a full list of objects on the service. If you enabled logging, create and archive reports you might need for future comparison.
24+
If you need to move a search service to different region, your approach should look similar to the steps below:
2425

25-
1. Create a service in the new region and republish from source code any existing indexes, indexers, data sources, skillsets, and synonym maps. Service names must be unique so you cannot reuse the existing name.
26+
1. Identify related services to understand the full impact of relocating a service. You might be using Azure Storage for logging, knowledge store, or as an external data source. You might be using Cognitive Services for AI enrichment. Accessing services in other regions is common, but comes with additional bandwidth charges. Cognitive Services and Azure Cognitive Search are required to be in the same region if you are using AI enrichment.
27+
28+
1. Inventory your existing service for a full list of objects on the service. If you enabled logging, create and archive any reports you might need for a historical record.
29+
30+
1. Check pricing and availability in the new region to ensure availability of Azure Cognitive Search plus any related services that you might want to create in the same region. Check for feature parity. Some preview features have restricted availability.
31+
32+
1. Create a service in the new region and republish from source code any existing indexes, indexers, data sources, skillsets, knowledge stores, and synonym maps. Service names must be unique so you cannot reuse the existing name.
33+
34+
1. Reload indexes and knowledge stores, if applicable. You'll either use application code to push JSON data into an index, or rerun indexers to pull documents in from external sources.
2635

2736
1. Enable logging, and if you are using them, re-create security roles.
2837

2938
1. Update client applications and test suites to use the new service name and API keys, and test all applications.
3039

31-
1. Delete the old service once the new service is fully operational.
40+
1. Delete the old service once the new service is fully tested and operational.
41+
42+
## Next steps
43+
44+
+ [Choose a tier](search-sku-tier.md)
45+
+ [Create a search service](search-create-service-portal.md)
46+
+ [Load search documents](search-what-is-data-import.md)
47+
+ [Enable logging](search-monitor-logs.md)
48+
3249

3350
<!-- To move your Azure Cognitive Service account from one region to another, you will create an export template to move your subscription(s). After moving your subscription, you will need to move your data and recreate your service.
3451

0 commit comments

Comments
 (0)