Skip to content

Commit 68554e5

Browse files
authored
Merge pull request #210072 from pauljewellmsft/pauljewell-ha-apps
Update tutorial for v12
2 parents 5135943 + 308face commit 68554e5

File tree

4 files changed

+95
-44
lines changed

4 files changed

+95
-44
lines changed
15.3 KB
Loading
55.9 KB
Loading

articles/storage/blobs/simulate-primary-region-failure.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,23 +3,23 @@ title: Tutorial - Simulate a failure in reading data from the primary region
33
titleSuffix: Azure Storage
44
description: Simulate an error in reading data from the primary region when the storage account is configured for read-access geo-zone-redundant storage (RA-GZRS).
55
services: storage
6-
author: tamram
6+
author: pauljewellmsft
77

88
ms.service: storage
99
ms.subservice: blobs
1010
ms.topic: tutorial
11-
ms.date: 04/16/2020
12-
ms.author: tamram
11+
ms.date: 09/06/2022
12+
ms.author: pauljewell
1313
ms.reviewer: artek
1414
ms.devlang: javascript
1515
ms.custom: devx-track-js
1616
---
1717

1818
# Tutorial: Simulate a failure in reading data from the primary region
1919

20-
This tutorial is part two of a series. In it, you learn about the benefits of [read-access geo-zone-redundant storage](../common/storage-redundancy.md) (RA-GZRS) by simulating a failure.
20+
This tutorial is part two of a series. In it, you'll learn about the benefits of [read-access geo-zone-redundant storage](../common/storage-redundancy.md) (RA-GZRS) by simulating a failure.
2121

22-
In order to simulate a failure, you can use either [static routing](#simulate-a-failure-with-an-invalid-static-route) or [Fiddler](#simulate-a-failure-with-fiddler). Both methods will allow you to simulate failure for requests to the primary endpoint of your [read-access geo-redundant](../common/storage-redundancy.md) (RA-GZRS) storage account, leading the application to read from the secondary endpoint instead.
22+
In order to simulate a failure, you can use either [static routing](#simulate-a-failure-with-an-invalid-static-route) or [Fiddler](#simulate-a-failure-with-fiddler). Both methods will allow you to simulate failure for requests to the primary endpoint of your RA-GZRS storage account, leading the application to read from the secondary endpoint instead.
2323

2424
If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
2525

@@ -34,13 +34,13 @@ In part two of the series, you learn how to:
3434

3535
Before you begin this tutorial, complete the previous tutorial: [Make your application data highly available with Azure storage][previous-tutorial].
3636

37-
To simulate a failure with static routing, you will use an elevated command prompt.
37+
To simulate a failure with static routing, you'll use an elevated command prompt.
3838

3939
To simulate a failure using Fiddler, download and [install Fiddler](https://www.telerik.com/download/fiddler)
4040

4141
## Simulate a failure with an invalid static route
4242

43-
You can create an invalid static route for all requests to the primary endpoint of your [read-access geo-redundant](../common/storage-redundancy.md) (RA-GZRS) storage account. In this tutorial, the local host is used as the gateway for routing requests to the storage account. Using the local host as the gateway causes all requests to your storage account primary endpoint to loop back inside the host, which subsequently leads to failure. Follow the following steps to simulate a failure, and primary endpoint restoration with an invalid static route.
43+
You can create an invalid static route for all requests to the primary endpoint of your RA-GZRS storage account. In this tutorial, the local host is used as the gateway for routing requests to the storage account. Using the local host as the gateway causes all requests to your storage account primary endpoint to loop back inside the host, which results in a failed request. Follow the following steps to simulate a failure, and primary endpoint restoration with an invalid static route.
4444

4545
### Start and pause the application
4646

@@ -108,7 +108,7 @@ Open Fiddler, select **Rules** and **Customize Rules**.
108108

109109
The Fiddler ScriptEditor launches and displays the **SampleRules.js** file. This file is used to customize Fiddler.
110110

111-
Paste the following code sample in the `OnBeforeResponse` function, replacing `STORAGEACCOUNTNAME` with the name of your storage account. Depending on the sample, you may also need to replace `HelloWorld` with the name of the test file (or a prefix such as `sampleFile`) being downloaded. The new code is commented out to ensure that it doesn't run immediately.
111+
Paste the following code sample in the `OnBeforeResponse` function, replacing `STORAGEACCOUNTNAME` with the name of your storage account. Depending on the sample, you may also need to replace `HelloWorld` with the name of the test file being downloaded, or remove that part of the condition if it doesn't apply. The new code is commented out to ensure that it doesn't run immediately.
112112

113113
Once complete, select **File** and **Save** to save your changes. Leave the ScriptEditor window open for use in the following steps.
114114

@@ -122,6 +122,7 @@ Once complete, select **File** and **Save** to save your changes. Leave the Scri
122122
// and save the changes.
123123
124124
if ((oSession.hostname == "STORAGEACCOUNTNAME.blob.core.windows.net")
125+
// depending on the sample, you may need to modify or remove the line below
125126
&& (oSession.PathAndQuery.Contains("HelloWorld"))) {
126127
oSession.responseCode = 503;
127128
}
@@ -148,11 +149,8 @@ In the window with the running sample, resume the application or press the appro
148149

149150
## Next steps
150151

151-
In part two of the series, you learned about simulating a failure to test read access geo-redundant storage.
152+
In part two of the series, you learned about simulating a failure to test read-access geo-redundant storage.
152153

153-
To learn more about how RA-GZRS storage works, as well as its associated risks, read the following article:
154-
155-
> [!div class="nextstepaction"]
156-
> [Designing HA apps with RA-GZRS](../common/geo-redundant-design.md)
154+
To learn more about how RA-GZRS storage works, and its associated risks, see [Designing HA apps with RA-GZRS](../common/geo-redundant-design.md).
157155

158156
[previous-tutorial]: storage-create-geo-redundant-storage.md

0 commit comments

Comments
 (0)