You are here: Utilities > Using the Exchange Failover (EFO) utility

Using the Exchange Failover (EFO) utility

There are several options available in the Exchange Failover utility for configuring Exchange for failover and failback. These options and the full command syntax are described in the following table.

Exchange Failover Utility Command Syntax

Command

exchfailover

Description

Used in script files to failover Exchange data

Syntax

EXCHFAILOVER {-FAILOVER , -FAILBACK} -s <source> -t <target>
[-l <log_filename>] [-norus] [-nospn] [-nooab] [-noRM] [-noRGconnectors] [-noexchangeab] [-noADreplication] [-nopublicfolders] [-onlypublicfolders] [-movehostspn] [-o <options_filename>] [-r [<source_group>] [,<source_mail_store>][:[<target_group>] [,<target_mail_store>]]] [-setup] [-maxRepWait <wait time>] [-test] [-noupdatepatchmdb] [-u <username>:<password>] [-virtual <new ip>] [-dc <DC name:ip>] [-?[?]]

Options

FAILOVER—The Exchange data will be moved from the source to the target during failover

FAILBACK—The Exchange data will be moved from the target to the source during failback

s source—The name of the original source server

t target—The name of the original target server

l log_filename—(Optional) The name of the log file. By default, the log file is ExchFailover.log and is stored in the directory containing the exchfailover.exe file. If this name is changed, the DTInfo utility will not be able to locate this file which could impede assistance through Technical Support.

norus—(Optional) Do not change the Recipient Update Service

nospn—(Optional) Do not change the Service Principal Name

nooab—(Optional) Do not change the siteFolderServer for the offline address book

noRM—(Optional) Do not change the Routing Master

noRGconnectors—(Optional) Do not change the Routing Group connectors

noexchangeab—(Optional) Do not fail back the ExchangeAB SPNs for Small Business Server

noADreplication—(Optional) Do not force Active Directory replication of changes

nopublicfolders—(Optional) Do not move the public folders

onlypublicfolders—(Optional) Only move the public folders

movehostspn—(Optional) Move the HOST SPN to/from the target instead of removing/adding it on the source

o options_filename—(Optional) Allows you to pass in a file containing the options for the Exchange Failover utility

r—(Optional) By itself, this option creates a one-to-one mapping of the groups and mail stores from the source to the target

r source_group:target_group—(Optional) The r option with the group names will direct the source group name specified to the target group name specified

r source_group

r source_mail_store:target_group, source_mail_store—(Optional) The r option with all of the r options will direct the source group name and mail store specified to the target group name and mail store specified

setup—(Optional) Allows you to set the overwrite database on restore flag without completing user moves or RUS and folder updates. If the -setup switch is not supplied, the utility still sets the overwrite database on restore flag, but the other work is also performed.

maxRepWait wait time—(Optional) Maximum number of minutes to wait for Active Directory replication to complete before continuing on with the failover/back process. The default value is 30 minutes.

NOTE: if -noAdReplication is enabled, the maxRepWait option will be ignored.

test—(Optional) Test mode that does not change the Exchange configuration in Active Directory

noupdatepatchmdb—(Optional) If specified, ExchFailover does not set the overwrite database on restore flag on databases during a failover/failback

u username:password—(Optional) User with Active Directory permissions

virtual new ip—(Optional) Update the addresses stored for HTTP, IMAP, and other virtual protocols to point to the target sever (applies to like-named cluster failover)

dc DC name:ip—(Optional) Specifies name or IP address of the domain controller to update

?—Displays the syntax of the Exchange Failover utility

??—Displays the syntax of the Exchange Failover utility along with brief descriptions of each option

Examples

exchfailover -failover -s Indy -t ExchSrvr_Bkup

exchfailover -failover -s Indy -t ExchSrvr_Bkup -r

exchfailover -failover -s Indy -t ExchSrvr_Bkup -r Sales:Indy_Sales

exchfailover -failover -s Indy -t ExchSrvr_Bkup -r Sales, Inside:Indy_Sales, Inside -r Sales, Outside:Indy_Sales, Outside

exchfailover -failover -s Indy -t ExchSrvr_Bkup -r Sales:Indy_Sales -norus -u administrator:password

exchfailover -failover -s Indy -t ExchSrvr_Bkup -o options_file.txt

Notes

When using the -failback option, the source-related options pertain to your original source or what will become the new source, if the original source had to be replaced. The target-related options pertain to the target that is currently standing in for the source.

The password specified with the -u option is the only case-sensitive option in this command.