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
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/cache-administration.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,21 +3,21 @@ title: How to administer Azure Cache for Redis
3
3
description: Learn how to perform administration tasks such as reboot and schedule updates for Azure Cache for Redis
4
4
5
5
ms.topic: conceptual
6
-
ms.date: 05/29/2024
6
+
ms.date: 04/30/2025
7
7
appliesto:
8
8
- ✅ Azure Cache for Redis
9
9
10
10
---
11
11
# How to administer Azure Cache for Redis
12
12
13
-
This article describes how to do administration tasks such as [rebooting](#reboot) and [Update channel and Schedule updates](#update-channel-and-schedule-updates) for your Azure Cache for Redis instances.
13
+
This article describes how to do administration tasks such as [rebooting](#reboot), [flushing](#flush-data) a cache, and [Update channel and Schedule updates](#update-channel-and-schedule-updates) for your Azure Cache for Redis instances.
14
14
15
15
## Reboot
16
16
17
-
On the left, **Reboot**allows you to reboot one or more nodes of your cache. This reboot capability enables you to test your application for resiliency if there's a failure of a cache node.
17
+
When using the Basic, Standard, or Premium tiers of Azure Cache for Redis, you see **Reboot**on the resource menu. Use the **Reboot**to restart one or more nodes of your cache. Rebooting enables you to test your application for resiliency if there's a failure of a cache node.
18
18
19
19
> [!IMPORTANT]
20
-
> Reboot is not yet available for the Enterprise tier. Reboot is available for all other tiers.
20
+
> Reboot isn't yet available for the Enterprise tier. Reboot is available for all other tiers.
21
21
>
22
22
23
23
:::image type="content" source="media/cache-administration/cache-administration-reboot-2.png" alt-text="Screenshot that highlights the Reboot menu option":::
@@ -39,57 +39,57 @@ The effect on your client applications varies depending on which nodes you reboo
39
39
***Both primary and replica** - When both cache nodes are rebooted, Azure Cache for Redis attempts to gracefully reboot both nodes, waiting for one to finish before rebooting the other. Typically, data loss doesn't occur. However, data loss can still occur do to unexpected maintenance events or failures. Rebooting your cache many times in a row increases the odds of data loss.
40
40
***Nodes of a premium cache with clustering enabled** - When you reboot one or more nodes of a premium cache with clustering enabled, the behavior for the selected nodes is the same as when you reboot the corresponding node or nodes of a nonclustered cache.
41
41
42
-
## Reboot FAQ
42
+
###Reboot FAQ
43
43
44
44
*[Which node should I reboot to test my application?](#which-node-should-i-reboot-to-test-my-application)
45
45
*[Can I reboot the cache to clear client connections?](#can-i-reboot-the-cache-to-clear-client-connections)
46
46
*[Will I lose data from my cache if I do a reboot?](#will-i-lose-data-from-my-cache-if-i-do-a-reboot)
47
47
*[Can I reboot my cache using PowerShell, CLI, or other management tools?](#can-i-reboot-my-cache-using-powershell-cli-or-other-management-tools)
48
48
*[Can I reboot my Enterprise cache?](#can-i-reboot-my-enterprise-cache)
49
49
50
-
### Which node should I reboot to test my application?
50
+
####Which node should I reboot to test my application?
51
51
52
52
To test the resiliency of your application against failure of the primary node of your cache, reboot the **Primary** node. To test the resiliency of your application against failure of the replica node, reboot the **Replica** node.
53
53
54
-
### Can I reboot the cache to clear client connections?
54
+
####Can I reboot the cache to clear client connections?
55
55
56
56
Yes, if you reboot the cache, all client connections are cleared. Rebooting can be useful in the case where all client connections are used because of a logic error or a bug in the client application. Each pricing tier has different [client connection limits](cache-configure.md#default-redis-server-configuration) for the various sizes, and once these limits are reached, no more client connections are accepted. Rebooting the cache provides a way to clear all client connections.
57
57
58
58
> [!IMPORTANT]
59
-
> If you reboot your cache to clear client connections, StackExchange.Redis automatically reconnects once the Redis node is back online. If the underlying issue is not resolved, the client connections may continue to be used up.
59
+
> If you reboot your cache to clear client connections, StackExchange.Redis automatically reconnects once the Redis node is back online. If the underlying issue isn't resolved, the client connections might remain used up.
60
60
>
61
61
>
62
62
63
-
### Will I lose data from my cache if I do a reboot?
63
+
####Will I lose data from my cache if I do a reboot?
64
64
65
65
If you reboot both the **Primary** and **Replica** nodes, all data in the cache, or all data in that shard when you're using a premium cache with clustering enabled should be safe. However, the data can be lost in some cases. Rebooting both nodes should be taken with caution.
66
66
67
67
If you reboot just one of the nodes, data isn't typically lost, but it still might be. For example if the primary node is rebooted, and a cache write is in progress, the data from the cache write is lost. Another scenario for data loss would be if you reboot one node, and the other node happens to go down because of a failure at the same time.
68
68
69
69
You should also know that rebooting both nodes doesn't result in data flush. If you want to clear data, use the [flush procedure](#flush-data) from portal console.
70
70
71
-
### Can I reboot my cache using PowerShell, CLI, or other management tools?
71
+
####Can I reboot my cache using PowerShell, CLI, or other management tools?
72
72
73
73
Yes, for PowerShell instructions see [To reboot an Azure Cache for Redis](../redis/how-to-manage-redis-cache-powershell.md#to-reboot-an-azure-cache-for-redis).
74
74
75
-
### Can I reboot my Enterprise cache?
75
+
####Can I reboot my Enterprise cache?
76
76
77
77
No. Reboot isn't available for the Enterprise tier yet. Reboot is available for Basic, Standard, and Premium tiers. The settings that you see on the Resource menu under **Administration** depend on the tier of your cache. You don't see **Reboot** when using a cache from the Enterprise tier.
78
78
79
79
## Flush data
80
80
81
-
When using the Basic, Standard, or Premium tiers of Azure Cache for Redis, you see **Flush data** on the resource menu. The**Flush data**operation allows you to delete or _flush_ all data in your cache. This _flush_ operation can be used before scaling operations to potentially reduce the time required to complete the scaling operation on your cache. You can also configure to run the _flush_ operation periodically on your dev/test caches to keep memory usage in check.
81
+
When using the Basic, Standard, or Premium tiers of Azure Cache for Redis, you see **Flush data** on the resource menu. Use**Flush data**to delete or _flush_ all data in your cache. Flushing can be used before scaling operations to potentially reduce the time required to complete the scaling operation on your cache. You can also configure to run the _flush_ operation periodically on your dev/test caches to keep memory usage in check.
82
82
83
83
The _flush_ operation, when executed on a clustered cache, clears data from all shards at the same time.
84
84
85
85
> [!IMPORTANT]
86
-
> Previously, the _flush_ operation was only available for geo-replicated Enterprise tier caches. Now, it is available in Basic, Standard and Premium tiers.
86
+
> Previously, the _flush_ operation was only available for geo-replicated Enterprise tier caches. Now, it's available in Basic, Standard, and Premium tiers.
87
87
>
88
88
:::image type="content" source="media/cache-administration/cache-flush.png" alt-text="Screenshot showing flush data selected in the resource menu of a cache instance. ":::
89
89
90
-
## Update channel and Schedule updates
90
+
## Update channel and schedule updates
91
91
92
-
On the left, **Schedule updates**allows you to choose an update channel and a maintenance window for your cache instance.
92
+
When using the Basic, Standard, or Premium tiers of Azure Cache for Redis, you see **Schedule updates**on the resource menu. Use schedule updates to choose an update channel and a maintenance window for your cache instance.
93
93
94
94
Any cache instance using the **Stable** update channel receives updates a few weeks later than cache instances using **Preview** update channel. We recommend choosing the **Preview** update channel for your nonproduction and less critical workloads. Choose the **Stable** update channel for your most critical, production workloads. All caches default to the **Stable** update channel by default.
95
95
@@ -100,7 +100,7 @@ Any cache instance using the **Stable** update channel receives updates a few we
100
100
A maintenance window allows you to control the days and times of a week during which the VMs hosting your cache can be updated. Azure Cache for Redis makes a best effort to start and finish updating Redis server software within the specified time window you define.
101
101
102
102
> [!IMPORTANT]
103
-
> The update channel and maintenance window applies to Redis server updates and updates to the Operating System of the VMs hosting the cache. The update channel and maintenance window does not apply to Host OS updates to the Hosts hosting the cache VMs or other Azure Networking components. In rare cases, where caches are hosted on older models the maintenance window won't apply to Guest OS updates either. You can tell if your cache is on an older model if the DNS name of the cache resolves to a suffix of `cloudapp.net`, `chinacloudapp.cn`, `usgovcloudapi.net` or `cloudapi.de`.
103
+
> The update channel and maintenance window apply to Redis server updates and updates to the Operating System of the VMs hosting the cache. The update channel and maintenance window doesn't apply to Host OS updates to the Hosts hosting the cache VMs or other Azure Networking components. In rare cases where caches are hosted on older models, the maintenance window doesn't apply to Guest OS updates either. You can tell if your cache is on an older model if the DNS name of the cache resolves to a suffix of `cloudapp.net`, `chinacloudapp.cn`, `usgovcloudapi.net`, or `cloudapi.de`.
104
104
>
105
105
Currently, no option is available to configure an update channel or scheduled updates for an Enterprise tier cache.
0 commit comments