Skip to main content
ONTAP MetroCluster

Configuring the Tiebreaker software

Contributors NetAppZacharyWambold netapp-folivia netapp-thomi netapp-martyh

After installation of the Tiebreaker software, you can add or modify MetroCluster configurations, or remove them from the Tiebreaker software.

Launching the Tiebreaker software CLI

After installing the Tiebreaker software, you must launch its CLI to configure the software.

  1. Launch the CLI from the prompt of the host on which you installed the software:

    netapp-metrocluster-tiebreaker-software-cli

  2. After installation and during the first startup, enter the password for the Tiebreaker user to access the database. This is the password that you specified for the database user during installation.

Adding MetroCluster configurations

After installing the NetApp MetroCluster Tiebreaker software, you can add more MetroCluster configurations, one at a time.

You must have installed the MetroCluster configuration in an ONTAP environment and enabled the settings in the software.

  1. Use the Tiebreaker command-line interface (CLI) monitor add command to add MetroCluster configurations.

    If you are using the host name, it must be the fully qualified domain name (FQDN).

    The following example shows the configuration of cluster_A:

    NetApp MetroCluster Tiebreaker :> monitor add wizard
    Enter monitor Name: cluster_A
    Enter Cluster IP Address: 10.222.196.130
    Enter Cluster Username: admin
    Enter Cluster Password:
    Enter Peer Cluster IP Address: 10.222.196.40
    Enter Peer Cluster Username: admin
    Enter Peer Cluster Password:
    Successfully added monitor to NetApp MetroCluster Tiebreaker software.
  2. Confirm that the MetroCluster configuration was added properly by using the Tiebreaker CLI monitor show -status command.

    NetApp MetroCluster Tiebreaker :> monitor show -status
  3. Disable the observer mode for the Tiebreaker software to automatically initiate a switchover after it detects a site failure:

    monitor modify -monitor-name monitor_name -observer-mode false

    NetApp MetroCluster Tiebreaker :> monitor modify -monitor-name 8pack -observer-mode false
    Warning: If you are turning observer-mode to false, make sure to review the 'risks and limitations'
    as described in the MetroCluster Tiebreaker installation and configuration.
    Are you sure you want to enable automatic switchover capability for monitor "8pack"? [Y/N]: y

Commands for modifying MetroCluster Tiebreaker configurations

You can modify the MetroCluster configuration whenever you need to change the settings.

The Tiebreaker CLI monitor modify command can be used with any of the following options. You can confirm your changes with the monitor show -status command.

Option

Description

-monitor-name

Name of the MetroCluster configuration

-enable-monitor

Enables and disables monitoring of the MetroCluster configuration

-silent-period

Period in seconds for which the MetroCluster Tiebreaker software waits to confirm a site failure after detection

-observer-mode

Observer mode (true) provides monitoring only, and does not trigger a switchover if a site disaster occurs. Online mode (false) triggers a switchover if a site disaster occurs.

The following example changes the silent period for the configuration.

NetApp MetroCluster Tiebreaker :> monitor modify -monitor-name cluster_A -silent-period 15
Successfully modified monitor in NetApp MetroCluster Tiebreaker
software.

The Tiebreaker CLI debug command can be used to change the logging mode.

Command

Description

debug status

Displays the status of the debug mode

debug enable

Enables the debug mode for logging

debug disable

Disables the debug mode for logging

In systems running Tiebreaker 1.4 and earlier, the Tiebreaker CLI update-mcctb-password command can be used to update the user password. This command is deprecated in Tiebreaker 1.5 and later.

Command

Description

update-mcctb-password

The user password is successfully updated

Removing MetroCluster configurations

You can remove the MetroCluster configuration that is being monitored by the Tiebreaker software when you no longer want to monitor a MetroCluster configuration.

  1. Use the Tiebreaker CLI monitor remove command to remove the MetroCluster configuration.

    In the following example, “cluster_A” is removed from the software:

    NetApp MetroCluster Tiebreaker :> monitor remove -monitor-name cluster_A
    Successfully removed monitor from NetApp MetroCluster Tiebreaker
    software.
  2. Confirm that the MetroCluster configuration is removed properly by using the Tiebreaker CLI monitor show -status command.

    NetApp MetroCluster Tiebreaker :> monitor show -status