You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: 'Quickstart: Create a Redis Enterprise cache'
3
-
description: In this quickstart, learn how to create an instance of Azure Cache for Redis in use the Enterprise tier.
3
+
description: Learn how to create an instance of Azure Cache for Redis to use in the Enterprise tier.
4
4
5
5
6
6
@@ -9,92 +9,92 @@ ms.topic: quickstart
9
9
ms.date: 04/10/2023
10
10
#Customer intent: As a Redis Enterprise developer who is new to Azure Cache for Redis, I want to create a new cache in the Enterprise tier of Azure Cache for Redis.
11
11
---
12
+
12
13
# Quickstart: Create a Redis Enterprise cache
13
14
14
-
The Azure Cache for Redis Enterprise tiers provide fully integrated and managed [Redis Enterprise](https://redislabs.com/redis-enterprise/) on Azure. These tiers are:
15
+
The Enterprise tiers for Azure Cache for Redis provide fully integrated and managed [Redis Enterprise](https://redislabs.com/redis-enterprise/) on Azure.
16
+
17
+
The Enterprise tiers include two tier options:
15
18
16
-
- Enterprise, which uses volatile memory (DRAM) on a virtual machine to store data
17
-
- Enterprise Flash, which uses both volatile and nonvolatile memory (NVMe or SSD) to store data.
19
+
-**Enterprise**: This tier uses volatile memory (dynamic random access memory (DRAM)) on a virtual machine to store data.
20
+
-**Enterprise Flash**: This tier uses both volatile and nonvolatile memory (NVM Express (NVMe) or solid-state drive (SSD)) to store data.
18
21
19
22
Both Enterprise and Enterprise Flash support open-source Redis 6 and some new features that aren't yet available in the Basic, Standard, or Premium tiers. The supported features include some Redis modules that enable other features like search, bloom filters, and time series.
20
23
21
24
## Prerequisites
22
25
23
-
-You need an Azure subscription before you begin. If you don't have one, create an [account](https://azure.microsoft.com/). For more information, see [special considerations for Enterprise tiers](cache-overview.md#special-considerations-for-enterprise-tiers).
26
+
-An Azure subscription. [Create one for free](https://azure.microsoft.com/free/). For more information, see [Special considerations for Enterprise tiers](cache-overview.md#special-considerations-for-enterprise-tiers).
24
27
25
28
### Availability by region
26
29
27
-
Azure Cache for Redis is continually expanding into new regions. To check the availability by region for all tiers, see [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=redis-cache®ions=all).
30
+
Azure Cache for Redis continually expands to new regions in Azure. To check the availability by region for all tiers, see [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=redis-cache®ions=all).
28
31
29
32
## Create a cache
30
33
31
-
1. To create a cache, sign in to the Azure portal and select **Create a resource**.
34
+
1. To create a cache, sign in to the [Azure portal](https://portal.azure.com). On the portal menu, select **Create a resource**.
32
35
33
-
1. On the **New**page, select **Databases** and then select **Azure Cache for Redis**.
36
+
1. On the **New**pane, select **Databases**. In the search results, select **Azure Cache for Redis**.
34
37
35
-
:::image type="content" source="media/cache-create/new-cache-menu.png" alt-text="Select Azure Cache for Redis":::
38
+
:::image type="content" source="media/cache-create/new-cache-menu.png" alt-text="Screenshot that highlights Azure Cache for Redis in search results on the New pane to create a new Azure resource.":::
36
39
37
-
1. On the **New Redis Cache**page, configure the settings for your new cache.
40
+
1. On the **New Redis Cache**pane, on the **Basics** tab, configure the following settings for your cache:
|**Subscription**|Drop down and select your subscription. | The subscription under which to create this new Azure Cache for Redis instance. |
42
-
|**Resource group**|Drop down and select a resource group, or select **Create new** and enter a new resource group name. |Name for the resource group in which to create your cache and other resources. By putting all your app resources in one resource group, you can easily manage or delete them together. |
43
-
|**DNS name**| Enter a name that is unique in the region. | The cache name must be a string between 1 and 63 characters when _combined with the cache's region name_that contain only numbers, letters, or hyphens. (If the cache name is fewer than 45 characters long it should work in all currently available regions.) The name must start and end with a number or letter, and can't contain consecutive hyphens. Your cache instance's _host name_ is `\<DNS name\>.\<Azure region\>.redisenterprise.cache.azure.net`. |
44
-
|**Location**|Drop down and select a location. | Enterprise tiers are available in selected Azure regions. |
45
-
|**Cache type**|Drop down and select an _Enterprise_or _Enterprise Flash_ tier and a size. | The tier determines the size, performance, and features that are available for the cache. |
44
+
|**Subscription**|Select your Azure subscription. | The subscription to use to create the new instance of Azure Cache for Redis. |
45
+
|**Resource group**|Select a resource group, or select **Create new** and enter a new resource group name. |A name for the resource group in which to create your cache and other resources. By putting all your app resources in one resource group, you can easily manage or delete them together. |
46
+
|**DNS name**| Enter a name that is unique in the Azure region. | The cache name must be a string of 1 to 63 characters that contains only numbers, letters, and hyphens. (If the cache name is fewer than 45 characters long, it should work in all currently available regions.) The name must start and end with a number or letter, and it can't contain consecutive hyphens. Your cache instance's _host name_ is`\<DNS name\>.\<Azure region\>.redisenterprise.cache.azure.net`. |
47
+
|**Location**|Select a location. | An [Azure region](https://azure.microsoft.com/regions/) that is near other services that use your cache. Enterprise tiers are available in selected Azure regions. |
48
+
|**Cache type**|Select **Enterprise**or **Enterprise Flash** tier and a cache size. | The tier determines the size, performance, and features that are available for your cache. |
:::image type="content" source="media/cache-create/enterprise-tier-basics.png" alt-text="Screenshot that shows the Enterprise tier Basics tab on the New Redis Cache pane.":::
48
51
49
52
> [!IMPORTANT]
50
-
> Be sure to select **Terms** before you proceed.
53
+
> Be sure to select the checkbox for **Terms** before you proceed.
51
54
>
52
55
53
56
1. Select **Next: Networking** and skip.
54
57
55
58
1. Select **Next: Advanced**.
56
59
57
-
Enable **Non-TLS access only** if you plan to connect to the new cache without using TLS. Disabling TLS is **not**recommended, however.
60
+
1. On the **Advanced**tab, configure these settings:
58
61
59
-
Set **Clustering policy** to **Enterprise** for a nonclustered cache, or to **OSS** for a clustered cache. For more information on choosing **Clustering policy**, see [Clustering on Enterprise](cache-best-practices-enterprise-tiers.md#clustering-on-enterprise).
62
+
1. Select the **Non-TLS access only** checkbox _only_ if you plan to connect to the new cache without using Transport Layer Security (TLS). We recommend that you don't disable TLS.
60
63
61
-
64
+
1. For **Clustering Policy**, for a nonclustered cache, select **Enterprise**. For a clustered cache, select **OSS**.
62
65
63
-
:::image type="content" source="media/cache-create/cache-clustering-policy.png" alt-text="Screenshot that shows the Enterprise tier Advanced tab.":::
66
+
For more information about choosing the clusteringpolicy to use for your cache, see [Clustering on Enterprise](cache-best-practices-enterprise-tiers.md#clustering-on-enterprise).
64
67
65
-
> [!NOTE]
66
-
> Enterprise and Enterprise Flash tiers are inherently clustered, in contrast to the Basic, Standard, and Premium tiers. Redis Enterprise supports two clustering policies.
67
-
>- Use the **Enterprise** policy to access your cache using the Redis API.
68
-
>- Use **OSS** to use the OSS Cluster API.
69
-
> For more information, see [Clustering on Enterprise](cache-best-practices-enterprise-tiers.md#clustering-on-enterprise).
70
-
>
68
+
:::image type="content" source="media/cache-create/cache-clustering-policy.png" alt-text="Screenshot that shows the Enterprise tier Advanced tab on the New Redis Cache pane.":::
71
69
72
70
> [!IMPORTANT]
73
-
> You can't change the clustering policy of an Enterprise cache instance after you create it. If you're using [RediSearch](cache-redis-modules.md#redisearch), the Enterprise cluster policy is required, and `NoEviction` is the only eviction policy supported.
71
+
> - The Enterprise tier and the Enterprise Flash tier are inherently clustered, in contrast to the Basic, Standard, and Premium tiers. Redis Enterprise offers two clustering policies:
74
72
>
75
-
76
-
> [!IMPORTANT]
77
-
> If you're using this cache instance in a geo-replication group, eviction policies cannot be changed after the instance is created. Be sure to know the eviction policies of your primary nodes before you create the cache. For more information on active geo-replication, see [Active geo-replication prerequisites](cache-how-to-active-geo-replication.md#active-geo-replication-prerequisites).
73
+
> - Use the **Enterprise** clustering policy to access your cache by using the Redis API.
74
+
> - Use the **OSS** clustering policy to use the OSS Cluster API.
78
75
>
79
-
80
-
> [!IMPORTANT]
81
-
> You can't change modules after you create a cache instance. Modules must be enabled at the time you create an Azure Cache for Redis instance. There is no option to enable the configuration of a module after you create a cache.
76
+
> For more information, see [Clustering on Enterprise](cache-best-practices-enterprise-tiers.md#clustering-on-enterprise).
77
+
>
78
+
> - You can't change the clustering policy of an Enterprise cache after you create it. If you use [RediSearch](cache-redis-modules.md#redisearch), the Enterprise clustering policy is required, and `NoEviction` is the only supported eviction policy.
79
+
>
80
+
> - If you use this cache in a geo-replication group, you can't change eviction policies after you create the cache. Be sure to know the eviction policies of your primary nodes before you create the cache.
81
+
>
82
+
> For more information about active geo-replication, see [Active geo-replication prerequisites](cache-how-to-active-geo-replication.md#active-geo-replication-prerequisites).
83
+
>
84
+
> - You can't change modules after you create a cache. Modules must be enabled at the time you create your instance of Azure Cache for Redis. There is no option to enable the configuration of a module after you create a cache.
:::image type="content" source="media/cache-create/enterprise-tier-summary.png" alt-text="Screenshot that shows the Enterprise tier Review + Create tab on the New Redis Cache pane.":::
89
92
90
-
1. Review the settings and select **Create**.
91
-
92
-
It takes some time for the cache to create. You can monitor progress on the Azure Cache for Redis **Overview** page. When **Status** shows as **Running**, the cache is ready to use.
93
-
93
+
1. On the **Review + create** tab, review the settings, and then select **Create**.
94
94
95
+
It takes some time for the cache deployment to finish. You can monitor progress on the Azure Cache for Redis Overview pane. When **Status** displays **Running**, the cache is ready to use.
96
+
95
97
## Related content
96
98
97
-
In this quickstart, you learned how to create an Enterprise tier instance of Azure Cache for Redis.
98
-
99
-
-[Create an ASP.NET web app that uses an Azure Cache for Redis](cache-web-app-aspnet-core-howto.md)
99
+
-[Create an ASP.NET web app that uses Azure Cache for Redis](cache-web-app-aspnet-core-howto.md)
100
100
-[Best practices for the Enterprise tiers](cache-best-practices-enterprise-tiers.md)
0 commit comments