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-migration-guide.md
+10-13Lines changed: 10 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,23 +14,20 @@ appliesto:
14
14
---
15
15
# Migrate to or between Azure Cache for Redis instances
16
16
17
-
This article describes several Azure Cache for Redis migration scenarios.
17
+
This article describes several Azure Cache for Redis migration scenarios. You can migrate Redis caches running in private data centers, on cloud virtual machines (VMs), or in another cloud to Azure Cache for Redis.
18
18
19
-
- Migrate Redis caches running in private data centers, on cloud virtual machines (VMs), or in another cloud to Azure Cache for Redis.
20
-
- Migrate one Azure Cache for Redis instance to another instance.
21
-
22
-
If you only need to move an Azure Redis cache from one Azure region to another, see [Move Azure Cache for Redis instances to different regions](cache-moving-resources.md) article.
19
+
You can also migrate one Azure Cache for Redis instance to another instance. If you only need to move an Azure Redis cache from one Azure region to another, see [Move Azure Cache for Redis instances to different regions](cache-moving-resources.md).
23
20
24
21
Open-source Redis can run in many compute environments, such as private on-premises data centers or cloud-hosted virtual machines (VMs). Other hosting platforms like Amazon Web Services (AWS) host Redis cache services like AWS ElastiCache. You can usually migrate these Redis caches to Azure Cache for Redis with minimal interruption or downtime.
25
22
26
23
## Migration options
27
24
28
-
How you migrate from one cache to another depends on where your cache exists and how your application interacts with it. The following table lists the frequently used migration strategies.
25
+
How you migrate from one cache to another depends on where your cache exists and how your application interacts with it. The following table lists frequently used migration strategies.
29
26
30
27
| Option | Advantages | Disadvantages |
31
28
| ------------ | ---------- | ------------- |
32
29
| Create a new cache | Simplest to implement. | Must repopulate data to the new cache, which might not work with some applications. |
33
-
| Export and import data via read-only database (RDB) file. |Usually compatible with any Redis cache. | Data written to the existing cache after the RDB file is generated could be lost. |
30
+
| Export and import data via read-only database (RDB) file. |Compatible with any Redis cache. | Data written to the existing cache after the RDB file is generated could be lost. |
34
31
| Dual-write data to two caches. | No data loss or downtime, uninterrupted cache operations, and easier testing. | Needs two caches for an extended time period. |
35
32
| Migrate data programmatically. | Full control over how data is moved. | Requires custom code. |
36
33
@@ -46,7 +43,7 @@ General steps to implement this option are:
46
43
47
44
### Export data to an RDB file and import it into Azure Cache for Redis
48
45
49
-
Open-source Redis defines a standard mechanism to take a snapshot of a cache's in-memory dataset and save it to an RDB file that any Redis cache can read. Azure Cache for Redis [Premium tier](cache-overview.md#service-tiers) supports importing data into a cache instance via RDB file. You can use an RDB file to transfer data from an existing cache to Azure Cache for Redis.
46
+
Open-source Redis defines a standard mechanism to take a snapshot of a cache's in-memory dataset and save it to an RDB file that any Redis cache can read. Azure Cache for Redis [Premium tier](cache-overview.md#service-tiers) supports importing data into a cache instance via RDB file. You can use the RDB file to transfer data from an existing cache to Azure Cache for Redis.
50
47
51
48
> [!IMPORTANT]
52
49
> RDB file format can change between Redis versions and might not maintain backward compatibility. The Redis version of the cache you export should be equal to or lower than the version that Azure Cache for Redis provides.
@@ -56,17 +53,17 @@ General steps to implement this option are:
56
53
1. Save a snapshot of the existing Redis cache. You can [configure Redis to save snapshots](https://redis.io/topics/persistence) periodically, or save manually using the [SAVE](https://redis.io/commands/save) or [BGSAVE](https://redis.io/commands/bgsave) commands. The RDB file is named *dump.rdb* by default and is located at the path specified in the *redis.conf* configuration file.
57
54
1. Create a new Premium-tier Azure Cache for Redis instance that's at least as large as the existing cache.
58
55
1. Copy the RDB file to an Azure storage account in the region where your new cache is located. You can use `AzCopy` for this task.
59
-
1.[Import the RDB file into the new cache](cache-how-to-import-export-data.md). You can also use the [PowerShell Import cmdlet](/powershell/module/az.rediscache/import-azrediscache).
56
+
1.[Import](cache-how-to-import-export-data.md#import) the RDB file into the new cache. You can also use the PowerShell [Import-AzRedisCache](/powershell/module/az.rediscache/import-azrediscache) cmdlet.
60
57
1. Update your application to use the new cache instance.
61
58
62
59
> [!NOTE]
63
-
> To migrate data from another Azure Redis instance, first [export the RDB file](cache-how-to-import-export-data.md)from that instance, or use the [PowerShell Export cmdlet](/powershell/module/az.rediscache/export-azrediscache).
60
+
> To migrate data from another Azure Redis instance, first [export](cache-how-to-import-export-data.md#export) the RDB file from that instance, or use the PowerShell [Export](/powershell/module/az.rediscache/export-azrediscache) cmdlet.
64
61
65
62
### Write to two Redis caches during migration
66
63
67
64
Rather than moving data between caches, you can temporarily set your application to write data to both an existing cache and a new one. The application reads data from the existing cache initially. When the new cache has enough data, you switch the application to that cache and retire the old one.
68
65
69
-
For example, suppose you use Redis as a session store and the application sessions expire after seven days. After writing to both caches for seven days, you know the new cache contains all nonexpired session information and you can safely rely on it from that point onward.
66
+
For example, suppose you use Redis as a session store and the application sessions expire after seven days. After writing to both caches for seven days, you know the new cache contains all nonexpired session information and you can safely rely on it from that point on.
70
67
71
68
General steps to implement this option are:
72
69
@@ -78,7 +75,7 @@ General steps to implement this option are:
78
75
79
76
### Migrate programmatically
80
77
81
-
You can create a custom migration process by programmatically reading data from an existing cache and writing it into Azure Cache for Redis. For example, you can use this open-source [redis-copy](https://github.com/deepakverma/redis-copy) tool to copy data from one Azure Redis instance to another.
78
+
You can create a custom migration by programmatically reading data from an existing cache and writing it into Azure Cache for Redis. For example, you can use the open-source [redis-copy](https://github.com/deepakverma/redis-copy) tool to copy data from one Azure Redis instance to another.
82
79
83
80
The source code can be a useful guide for writing your own migration tool. A [compiled version](https://github.com/deepakverma/redis-copy/releases/download/alpha/Release.zip) is also available.
84
81
@@ -89,7 +86,7 @@ General steps to implement this option are:
89
86
90
87
1. Create an Azure virtual machine (VM) in the same region as the existing cache. If your dataset is large, choose a powerful VM to reduce copying time.
91
88
1. Create a new Azure Cache for Redis instance and make sure that it's empty. The `redis-copy` tool doesn't overwrite any existing keys in the target cache.
92
-
4. Use an application such as `redis-copy` to automate copying the data from the source cache to the target cache. The copy process could take awhile depending on the size of your dataset.
89
+
4. Use an application such as `redis-copy` to automate copying the data from the source cache to the target cache. The copy process could take a while depending on the size of your dataset.
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/cache-reserved-pricing.md
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ appliesto:
17
17
18
18
Reservations in Azure Cache for Redis can help you save money compared to pay-as-you-go prices by prepaying for compute resources. With reservations, you make an upfront commitment on a cache for one or three years to get a significant discount on the compute costs.
19
19
20
-
You purchase Azure Cache for Redis reservations for a specific Azure region, Azure Cache for Redis tier, and term. You don't need to assign the reservation to specific cache instances. Existing and new caches automatically get the benefit of reserved pricing, up to the reserved cache size.
20
+
You purchase an Azure Cache for Redis reservation for a specific Azure region, Azure Redis tier, term, and node quantity. You don't need to assign the reservation to specific cache instances. Existing and new caches automatically get the benefit of reserved pricing, up to the total reservation size.
21
21
22
22
When you purchase a reservation, you prepay for compute costs for one or three years. As soon as you buy the reservation, the compute charges that match the reservation attributes no longer use the pay-as-you go rates.
23
23
@@ -43,13 +43,13 @@ Reservations are sold in increments of nodes. Premium-tier and Enterprise-tier A
43
43
44
44
The Enterprise Flash tier contains three nodes by default, so for Enterprise Flash tiers you need to buy three reservation units.
45
45
46
-
To calculate number of nodes, see **View Cost Calculation** in the [Pricing calculator](https://azure.microsoft.com/pricing/calculator/).
46
+
To calculate number of nodes, see the [Pricing calculator](https://azure.microsoft.com/pricing/calculator/).
47
47
48
48
### Reservation size determination
49
49
50
50
Base your reservation size on the total amount of memory size that the existing or soon-to-be-deployed caches use within the specific region and tier.
51
51
52
-
For example, suppose you run two caches, one at 13 GB and the other at 26 GB. You need both caches for at least one year. You plan to scale the existing 13GB cache to 26 GB for a month to meet your seasonal demand, and then scale back.
52
+
For example, suppose you run two caches, one at 13 GB and the other at 26 GB. You need both caches for at least one year. You plan to scale the existing 13-GB cache to 26 GB for a month to meet your seasonal demand, and then scale back.
53
53
54
54
In this case, you could purchase either one P2-cache and one P3-cache or three P2-caches on a one-year reservation to maximize savings. You receive a discount on the total amount of cache memory you reserve, independent of how that memory is allocated across your caches.
55
55
@@ -70,10 +70,12 @@ To buy reservations using the Azure portal:
70
70
1. In the **Select the product you want to purchase** pane, select the **Scope** and **Subscription** you want to use for the reservation.
71
71
1. Select the values you want from the dropdown lists for **Region**, **Term**, and **Billing frequency**.
72
72
73
+
:::image type="content" source="media/cache-reserved-pricing/cache-reserved-price.png" alt-text="Screenshot showing an overview of reserved pricing.":::
74
+
73
75
The following table describes the form fields in detail.
74
76
75
77
| Field | Description |
76
-
|:------------ |:------- |
78
+
| ------------ | ------- |
77
79
| Subscription | The subscription used to pay for the reservation. The subscription type must be EA, offer numbers MS-AZR-0017P or MS-AZR-0148P, or an individual agreement with pay-as-you-go pricing, offer numbers MS-AZR-0003P or MS-AZR-0023P. For an EA subscription, the charges are deducted from the enrollment's Azure Prepayment balance or charged as overage. For pay-as-you-go, the charges are billed to the subscription's credit card or invoice.|
78
80
| Scope | The reservation's scope. <br>**Shared** applies the reservation discount to cache instances in any subscriptions in your billing context. For EA, the shared scope is the enrollment and includes all subscriptions within the enrollment. For pay-as-you-go, the shared scope is all pay-as-you-go subscriptions created by the account administrator. <br>**Single subscription** applies the reservation discount to cache instances in this subscription. <br>**Single resource group** applies the reservation discount to instances in the selected resource group within the subscription. <br>**Management group** applies the reservation discount to matching resources in subscriptions that are a part of both the management group and billing scope.|
79
81
| Region | The Azure region for the reservation.|
@@ -83,16 +85,15 @@ To buy reservations using the Azure portal:
83
85
84
86
Existing or new caches that match the attributes you select get the reservation discount. The actual number of instances that get the discount depends on the scope and quantity you select.
85
87
86
-
:::image type="content" source="media/cache-reserved-pricing/cache-reserved-price.png" alt-text="Screenshot showing an overview of reserved pricing.":::
87
-
88
88
1. Select the reservation you want, and note the **Monthly price per node** and estimated savings calculated at lower right.
89
89
1. Select **Add to cart** and then select **View cart** to close the product list pane.
90
90
1. On the **Purchase reservations** page, review the reservation details.
91
-
1.**Auto-renew** automatically renews your reservation at the end of the term and is set to **On** by default. You can set it to **Off** now or any time before the end of the term.
91
+
1.**Auto-renew**is **On** by default to automatically renew your reservation at the end of the term. You can set it to **Off** now or any time before the end of the term.
92
92
1. Select **Next: Review + buy**.
93
93
1. Review the details, **Additional notes**, **Today's charge**, and **Total cost**, and then select **Buy now**.
94
94
95
95
- You can update the scope of the reservation through the Azure portal, PowerShell, Azure CLI, or the API.
96
+
96
97
- You can cancel, exchange, or refund reservations with certain limitations. For more information, see [Self-service exchanges and refunds for Azure Reservations](/azure/cost-management-billing/reservations/exchange-and-refund-azure-reservations).
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/cache-retired-features.md
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,16 +15,21 @@ appliesto:
15
15
16
16
# Redis version 4 retirement in Azure Cache for Redis
17
17
18
-
On June 30, 2023, Redis version 4 was retired for Azure Cache for Redis instances. All new Azure Redis instances are version 6. To check the Redis version of your cache instance, select **Properties** from the left navigation menu of your cache page in the Azure portal.
18
+
On June 30, 2023, Redis version 4 was retired for Azure Cache for Redis instances. All new Azure Redis instances are version 6.
19
19
20
-
All existing Azure Redis instances were upgraded automatically to version 6 in 2023. Caches that had a maintenance window scheduled were upgraded during the maintenance window. Redis version 6 is compatible with version 4 and applications continued to function seamlessly after the version upgrade.
20
+
21
+
All existing Azure Redis instances were upgraded automatically to version 6. Redis version 6 is compatible with version 4 and applications continued to function seamlessly after the version upgrade.
21
22
22
23
During the upgrade process, the replica node of the cache was first upgraded to run Redis version 6. The upgrade replica node then took over as the primary cache node while the former primary node rebooted to take on the role of replica. This process was exactly like the patching process described in [How does patching occur?](cache-failover.md#how-does-patching-occur)
23
24
24
-
Standard and Premium caches were fully functional and available during the upgrade process. Applications saw a connection blip for a few seconds. Basic caches were unavailable during the upgrade and all data was lost.
25
+
- Caches that had a maintenance window scheduled were upgraded during the maintenance window.
26
+
27
+
- Standard and Premium caches were fully functional and available during the upgrade process. Applications saw a connection blip for a few seconds. Basic caches were unavailable during the upgrade and all data was lost.
25
28
26
-
Cache instances that had geo-replication enabled had to unlink the caches before upgrade, upgrade both caches, and relink them after the upgrade.
29
+
-Cache instances that had geo-replication enabled had to unlink the caches before upgrade, upgrade both caches, and relink them after the upgrade.
27
30
28
-
Cache instances that were affected by Cloud Service retirement couldn't upgrade to Redis 6 until after they migrated to a cache built on Virtual Machine Scale Set. Otherwise the automatic migration required around 30 minutes of downtime and full data loss on the cache. For more information, see [Caches with a dependency on Cloud Services (classic)](../redis/faq.yml).
31
+
-Cache instances that were affected by Cloud Service retirement couldn't upgrade to Redis 6 until after they migrated to a cache built on Virtual Machine Scale Set. Otherwise the automatic migration required around 30 minutes of downtime and full data loss on the cache.
29
32
30
33
For more information about upgrading Redis versions in Azure Cache for Redis, see [How to upgrade the version of your Redis instance](cache-how-to-upgrade.md). The upgrade process can be triggered through REST API, Azure CLI, or PowerShell command. Also see [Best practices for connection resilience](cache-best-practices-connection.md).
34
+
35
+
To check the Redis version of your cache instance, select **Properties** from the left navigation menu of your cache page in the Azure portal.
0 commit comments