Name
mc_arb - Start, stop, and display the status of the Mirroring Controller arbitration process
mc_arb - Start, stop, and display the status of the Mirroring Controller arbitration process, or register and unregister it as a Windows service
Overview
mc_arb start [-M mcdir] [-w| -W]mc_arb stop [-M mcdir] [-e]mc_arb status [-M mcdir]
Description
mc_arb starts, stops, and displays the status of the Mirroring Controller arbitration process.
mc_arb starts, stops, and displays the status of the Mirroring Controller arbitration process, or registers and unregisters it as a Windows service.
The start mode starts the Mirroring Controller arbitration process.
The stop mode stops the Mirroring Controller arbitration process.
The status mode displays the connection status of the Mirroring Controller arbitration process with the Mirroring Controller processes of the primary server and standby server.
The register mode registers the Mirroring Controller arbitration process as a Windows service. The -w and -W options can be used to start/stop the Mirroring Controller arbitration process through the Windows service, and when it executes the mc_arb command, the specified option will take effect.
The unregister mode unregisters the Mirroring Controller arbitration process as a Windows service.
If the Mirroring Controller arbitration process has not been started on the server executing the command, stop mode and status mode will terminate with an error.
Additionally, if Mirroring Controller is forcibly stopped on the database server, it may take a few moments until the status mode displays the status of the server connection as offline.
This command can be executed by any user.
Execute this command as a user with administrator privileges (operating system user that belongs to the "Administrators" group).
Options
Specify this option to forcibly stop the Mirroring Controller arbitration process on the active server.
Specify this option to stop the Mirroring Controller arbitration process but keep Mirroring Controller running (to stop both, first stop Mirroring Controller of the database server, and then the Mirroring Controller arbitration process). This option can also be specified to halt the arbitration process (by stopping the Mirroring Controller arbitration process) when the fencing command called by the arbitration process becomes unresponsive.
Specify the Mirroring Controller arbitration process management directory.
ASCII characters can be specified in the directory path.
If this option is omitted, the value of the environment variable ARBCONTROLDIR is used.
-P passwordFor the register mode, specify the password for the user who executed the command.
-S a[uto] | d[emand]Specify the start type for the Windows service to be registered. You can choose auto or demand as the start type by specifying the entire word or just its first letter. The default is auto.
Waits for operations to finish.
This option is the default of start mode.
This option is the default of start mode and register mode.
Does not wait for operations to finish.
Environment
Specify the Mirroring Controller arbitration process management directory.
ASCII characters can be specified in the directory path.
You can specify the -M option to override this value.
Diagnostics
0: Normal end
Other than 0: Abnormal end
Notes
If the Mirroring Controller arbitration process is forcibly stopped or communication between the command and the Mirroring Controller arbitration process is interrupted while the Mirroring Controller arbitration process is being stopped, a message that the command is being executed may be output and stopping may terminate in error, even though no other instances of the mc_arb command are being executed.
To solve this issue, ensure that other instances of the mc_arb command are not being executed before forcibly stopping the Mirroring Controller arbitration process.
Use the start mode and stop mode to start and stop the Windows service. Before being able to use these modes, use the register mode to register the Mirroring Controller arbitration process as a Windows service.
The mc_arb command must be executed from "Administrator: Command Prompt". Right-click [Command Prompt], and then select [Run as administrator] from the context menu to display the [Administrator: Command Prompt] window.
Example
Start the Mirroring Controller arbitration process.
$ mc_arb start -M /mcarb_dir/arbiter1
Start the Mirroring Controller arbitration process.
> mc_arb start -M D:\mcarb_dir\arbiter1
server_id host status
(1) (2) (3)(1) Server identifier
(2) Host name or IP address
(3) Server connection status
online : Connected
offline : Disconnected