Skip to content

change-the-failover-mode-of-an-availability-replica-sql-server.md

Latest commit

 

History

History
116 lines (75 loc) · 6.56 KB

change-the-failover-mode-of-an-availability-replica-sql-server.md

File metadata and controls

116 lines (75 loc) · 6.56 KB
title Change the Failover Mode of an Availability Replica (SQL Server) | Microsoft Docs
ms.custom
ms.date 06/13/2017
ms.prod sql-server-2014
ms.reviewer
ms.technology high-availability
ms.topic conceptual
helpviewer_keywords
failover modes [SQL Server]
Availability Groups [SQL Server], deploying
Availability Groups [SQL Server], failover modes
Availability Groups [SQL Server], configuring
ms.assetid 619a826f-8e65-48eb-8c34-39497d238279
author MashaMSFT
ms.author mathoma
manager craigg

Change the Failover Mode of an Availability Replica (SQL Server)

This topic describes how to change the failover mode of an availability replica in an AlwaysOn availability group in [!INCLUDEssCurrent] by using [!INCLUDEssManStudioFull], [!INCLUDEtsql], or PowerShell. The failover mode is a replica property that determines the failover mode for replicas that run under synchronous-commit availability mode. For more information, see Failover and Failover Modes (AlwaysOn Availability Groups) and Availability Modes (AlwaysOn Availability Groups).

Before You Begin

Prerequisites and Restrictions

  • This task is supported only on primary replicas. You must be connected to the server instance that hosts the primary replica.

  • SQL Server Failover Cluster Instances (FCIs) do not support automatic failover by availability groups, so any availability replica that is hosted by an FCI can only be configured for manual failover.

Security

Permissions

Requires ALTER AVAILABILITY GROUP permission on the availability group, CONTROL AVAILABILITY GROUP permission, ALTER ANY AVAILABILITY GROUP permission, or CONTROL SERVER permission.

Using SQL Server Management Studio

To change the failover mode of an availability replica

  1. In Object Explorer, connect to the server instance that hosts the primary replica, and expand the server tree.

  2. Expand the AlwaysOn High Availability node and the Availability Groups node.

  3. Click the availability group whose replica you want to change.

  4. Right-click the replica, and click Properties.

  5. In the Availability Replica Properties dialog box, use the Failover mode drop list to change the failover mode of this replica.

Using Transact-SQL

To change the failover mode of an availability replica

  1. Connect to the server instance that hosts the primary replica.

  2. Use the ALTER AVAILABILITY GROUP statement, as follows:

    ALTER AVAILABILITY GROUP group_name MODIFY REPLICA ON 'server_name'

    WITH ( {

    AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT }

    | FAILOVER_MODE = { AUTOMATIC | MANUAL }

    } )

    where

    • group_name is the name of the availability group.

    • { 'system_name[\instance_name]' | 'FCI_network_name[\instance_name]' }

      Specifies the address of the instance of [!INCLUDEssNoVersion] that hosts the availability replica to be altered. The components of this address are as follows:

      system_name
      Is the NetBIOS name of the computer system on which a stand-alone server instance resides.

      FCI_network_name
      Is the network name that is used to access a [!INCLUDEssNoVersion] failover cluster in which a target server instance is a [!INCLUDEssNoVersion] failover partner (an FCI).

      instance_name
      Is the name of the instance of [!INCLUDEssNoVersion] that hosts the target availability replica. For a default server instance, instance_name is optional.

    For more information about these parameters, see ALTER AVAILABILITY GROUP (Transact-SQL).

    The following example, entered on the primary replica of the MyAG availability group, changes the failover mode to automatic failover on the availability replica that is located on the default server instance on a computer named COMPUTER01.

    ALTER AVAILABILITY GROUP MyAG MODIFY REPLICA ON 'COMPUTER01' WITH  
   (FAILOVER_MODE = AUTOMATIC);

Using PowerShell

To change the failover mode of an availability replica

  1. Change directory (cd) to the server instance that hosts the primary replica.

  2. Use the Set-SqlAvailabilityReplica cmdlet with the FailoverMode parameter. When setting a replica to automatic failover, you might need to use the AvailabilityMode parameter to change the replica to synchronous-commit availability mode.

    For example, the following command modifies the replica MyReplica in the availability group MyAg to use synchronous-commit availability mode and to support automatic failover.

    Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode "Automatic" `
 -Path SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MyAg\Replicas\MyReplica

    [!NOTE]
    To view the syntax of a cmdlet, use the Get-Help cmdlet in the [!INCLUDEssNoVersion] PowerShell environment. For more information, see Get Help SQL Server PowerShell.

To set up and use the SQL Server PowerShell provider, see SQL Server PowerShell Provider.

See Also

Overview of AlwaysOn Availability Groups (SQL Server)
Availability Modes (AlwaysOn Availability Groups)
Failover and Failover Modes (AlwaysOn Availability Groups)