Skip to content

Commit 552b20b

Browse files
Update configure-distributed-availability-groups.md
SQL Server Distributed AG uses "forwarder", not "global forwarder". This change aligns documentation with official SQL Server terminology and improves consistency across documents.
1 parent 03e61c3 commit 552b20b

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

docs/database-engine/availability-groups/windows/configure-distributed-availability-groups.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -380,7 +380,7 @@ On [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] and later you can co
380380

381381
To ensure there's no data loss, you must first configure the distributed availability group to support no data loss by following these steps:
382382

383-
1. To prepare for failover, verify the global primary *and* global forwarder are in `SYNCHRONOUS_COMMIT` mode. If not, set them to `SYNCHRONOUS_COMMIT` through [ALTER AVAILABILITY GROUP](../../../t-sql/statements/alter-availability-group-transact-sql.md).
383+
1. To prepare for failover, verify the global primary *and* forwarder are in `SYNCHRONOUS_COMMIT` mode. If not, set them to `SYNCHRONOUS_COMMIT` through [ALTER AVAILABILITY GROUP](../../../t-sql/statements/alter-availability-group-transact-sql.md).
384384
1. Set the distributed availability group to synchronous commit on *both* the global primary and the forwarder.
385385
1. Wait until the distributed availability group is synchronized.
386386
1. On the global primary, set the distributed availability group `REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT` setting to 1 by using [ALTER AVAILABILITY GROUP](../../../t-sql/statements/alter-availability-group-transact-sql.md).
@@ -392,9 +392,9 @@ To ensure there's no data loss, you must first configure the distributed availab
392392

393393
#### T-SQL example
394394

395-
This section provides the steps in a detailed example to fail over the distributed availability group named `distributedAG` by using Transact-SQL. The example environment has a total of 4 nodes for the distributed availability group. The global primary **N1** and **N2** host availability group `ag1` while the global forwarder **N3** and **N4** host availability group `ag2`. The distributed availability group `distributedAG` pushes changes from `ag1` to `ag2`.
395+
This section provides the steps in a detailed example to fail over the distributed availability group named `distributedAG` by using Transact-SQL. The example environment has a total of 4 nodes for the distributed availability group. The global primary **N1** and **N2** host availability group `ag1` while the forwarder **N3** and **N4** host availability group `ag2`. The distributed availability group `distributedAG` pushes changes from `ag1` to `ag2`.
396396

397-
1. Query to verify `SYNCHRONOUS_COMMIT` on the primaries of the local availability groups that form the distributed availability group. Run the following T-SQL directly on the global forwarder *and* global primary:
397+
1. Query to verify `SYNCHRONOUS_COMMIT` on the primaries of the local availability groups that form the distributed availability group. Run the following T-SQL directly on the forwarder *and* global primary:
398398

399399
```sql
400400
SELECT DISTINCT ag.name AS [Availability Group],
@@ -489,7 +489,7 @@ This section provides the steps in a detailed example to fail over the distribut
489489

490490
After this step:
491491
- The global primary transitions from `N1` to `N3`.
492-
- The global forwarder transitions from `N3` to `N1`.
492+
- The forwarder transitions from `N3` to `N1`.
493493
- The distributed availability group is available.
494494

495495
1. On the new forwarder (previous global primary, `N1`), clear the distributed availability group property `REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT` by setting it to 0:
@@ -516,7 +516,7 @@ The instructions in this section apply if `REQUIRED_SYNCHRONIZED_SECONDARIES_TO_
516516
To ensure there's no data loss, follow these steps:
517517
518518
1. Stop all transactions running on the global primary availability group database(s).
519-
1. Verify the global primary and global forwarder are in `SYNCHRONOUS_COMMIT` mode. If not, set them to `SYNCHRONOUS_COMMIT` through [ALTER AVAILABILITY GROUP](../../../t-sql/statements/alter-availability-group-transact-sql.md).
519+
1. Verify the global primary and forwarder are in `SYNCHRONOUS_COMMIT` mode. If not, set them to `SYNCHRONOUS_COMMIT` through [ALTER AVAILABILITY GROUP](../../../t-sql/statements/alter-availability-group-transact-sql.md).
520520
1. Set the distributed availability group to synchronous commit on the global primary and the forwarder.
521521
1. Wait until the distributed availability group is synchronized and has the same **last_hardened_lsn** per database. Wait until the **last_hardened_lsn** per database matches between replicas.
522522
1. On the global primary replica, set the distributed availability group role to `SECONDARY`, which makes the distributed availability group unavailable.
@@ -526,11 +526,11 @@ To ensure there's no data loss, follow these steps:
526526

527527
#### T-SQL example
528528

529-
This section provides the steps in a detailed example to fail over the distributed availability group named `distributedAG` by using Transact-SQL. The example environment has a total of 4 nodes for the distributed availability group. The global primary **N1** and **N2** host availability group `ag1` while the global forwarder **N3** and **N4** host availability group `ag2`. The distributed availability group `distributedAG` pushes changes from `ag1` to `ag2`.
529+
This section provides the steps in a detailed example to fail over the distributed availability group named `distributedAG` by using Transact-SQL. The example environment has a total of 4 nodes for the distributed availability group. The global primary **N1** and **N2** host availability group `ag1` while the forwarder **N3** and **N4** host availability group `ag2`. The distributed availability group `distributedAG` pushes changes from `ag1` to `ag2`.
530530

531531
1. To ensure that no data is lost, stop all transactions on the global primary databases (that is, databases of the primary availability group).
532532

533-
1. Query to verify `SYNCHRONOUS_COMMIT` on the primaries of the local availability groups that compose the distributed availability group. Run directly on the global forwarder and global primary:
533+
1. Query to verify `SYNCHRONOUS_COMMIT` on the primaries of the local availability groups that compose the distributed availability group. Run directly on the forwarder and global primary:
534534

535535
```sql
536536
SELECT ag.name AS [Availability Group],
@@ -619,7 +619,7 @@ This section provides the steps in a detailed example to fail over the distribut
619619
620620
- If the **last_hardened_lsns** match from the **SELECT** query, fail over from the primary availability group to the secondary availability group. Run the **ALTER AVAILABILITY GROUP** command on the forwarder, the SQL Server that hosts the primary replica of the secondary availability group.
621621
622-
- If the **last_hardened_lsns** **do not** match from the **SELECT** query after some time, fail the distributed AG back over to the original global forwarder (N1) by running the failover command against the global primary. Then start the process again from the first step.
622+
- If the **last_hardened_lsns** **do not** match from the **SELECT** query after some time, fail the distributed AG back over to the original forwarder (N1) by running the failover command against the global primary. Then start the process again from the first step.
623623
624624
```sql
625625
-- If the last_hardened_lsns match, you can run the failover query below against the forwarder

0 commit comments

Comments
 (0)