Skip to content

Commit 9352bd4

Browse files
committed
fix TOC, links and acrolinx
1 parent ee02b32 commit 9352bd4

File tree

2 files changed

+18
-20
lines changed

2 files changed

+18
-20
lines changed

articles/azure-cache-for-redis/TOC.yml

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -182,10 +182,8 @@
182182
href: cache-how-to-import-export-data.md
183183
- name: Configure disk encryption
184184
href: cache-how-to-encryption.md
185-
- name: Reboot
186-
href: cache-administration.md#reboot
187-
- name: Update channel and schedule updates
188-
href: cache-administration.md#update-channel-and-schedule-updates
185+
- name: Reboot, flush, and schedule updates
186+
href: cache-administration.md
189187
- name: Configure redis-cli access
190188
href: cache-how-to-redis-cli-tool.md
191189
- name: Move between regions

articles/azure-cache-for-redis/cache-administration.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,21 @@ title: How to administer Azure Cache for Redis
33
description: Learn how to perform administration tasks such as reboot and schedule updates for Azure Cache for Redis
44

55
ms.topic: conceptual
6-
ms.date: 05/29/2024
6+
ms.date: 04/30/2025
77
appliesto:
88
- ✅ Azure Cache for Redis
99

1010
---
1111
# How to administer Azure Cache for Redis
1212

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.
1414

1515
## Reboot
1616

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.
1818

1919
> [!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.
2121
>
2222
2323
:::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
3939
* **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.
4040
* **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.
4141

42-
## Reboot FAQ
42+
### Reboot FAQ
4343

4444
* [Which node should I reboot to test my application?](#which-node-should-i-reboot-to-test-my-application)
4545
* [Can I reboot the cache to clear client connections?](#can-i-reboot-the-cache-to-clear-client-connections)
4646
* [Will I lose data from my cache if I do a reboot?](#will-i-lose-data-from-my-cache-if-i-do-a-reboot)
4747
* [Can I reboot my cache using PowerShell, CLI, or other management tools?](#can-i-reboot-my-cache-using-powershell-cli-or-other-management-tools)
4848
* [Can I reboot my Enterprise cache?](#can-i-reboot-my-enterprise-cache)
4949

50-
### Which node should I reboot to test my application?
50+
#### Which node should I reboot to test my application?
5151

5252
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.
5353

54-
### Can I reboot the cache to clear client connections?
54+
#### Can I reboot the cache to clear client connections?
5555

5656
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.
5757

5858
> [!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.
6060
>
6161
>
6262
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?
6464

6565
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.
6666

6767
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.
6868

6969
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.
7070

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?
7272

7373
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).
7474

75-
### Can I reboot my Enterprise cache?
75+
#### Can I reboot my Enterprise cache?
7676

7777
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.
7878

7979
## Flush data
8080

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.
8282

8383
The _flush_ operation, when executed on a clustered cache, clears data from all shards at the same time.
8484

8585
> [!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.
8787
>
8888
:::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. ":::
8989

90-
## Update channel and Schedule updates
90+
## Update channel and schedule updates
9191

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.
9393

9494
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.
9595

@@ -100,7 +100,7 @@ Any cache instance using the **Stable** update channel receives updates a few we
100100
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.
101101

102102
> [!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`.
104104
>
105105
Currently, no option is available to configure an update channel or scheduled updates for an Enterprise tier cache.
106106

0 commit comments

Comments
 (0)