Applies To:

Show Versions Show Versions

sol13887: Forcing a BIG-IP device group member to initiate a ConfigSync operation
How-ToHow-To

Original Publication Date: 09/21/2012
Updated Date: 08/29/2016

Topic

Note: Starting in BIG-IP 11.2.1, you can use the Configuration utility to force synchronization from a device with an older configuration to devices with a newer configuration. For more information, refer to SOL13920: Performing a ConfigSync using the Configuration utility.

Purpose

You should consider using this procedure under the following condition:

  • You want to force a specific device group member to initiate a configuration synchronization (ConfigSync). For example, this procedure may be useful to force a device group member with an older configuration to synchronize its configuration to devices with a newer configuration.

Prerequisites

You must meet the following prerequisites to use this procedure:

  • You can access the Traffic Management Shell (tmsh).
  • You have one or more device groups configured

Description

The BIG-IP system uses time stamps as recorded by the mcpd process to determine which device group member has the latest configuration and is eligible to initiate a ConfigSync operation. Device group functionality is designed so that you can initiate a ConfigSync operation from the device group member with the newest configuration change. This behavior is intended to prevent a device with an older configuration from overwriting the configuration of devices with a newer configuration.

For example, if the device group contains four members (BIGIP-1, BIGIP-2, BIGIP-3, and BIGIP-4) and you make a configuration change on BIGIP-1, you can initiate a ConfigSync operation from member BIGIP-1. In BIG-IP 11.1.0 through 11.2.0, ConfigSync functionality does not permit you to initiate a ConfigSync operation from devices BIGIP-2, BIGIP-3, or BIGIP-4.

However, in some cases you might need to initiate a synchronization from a device with an older configuration to a device or devices with a newer configuration. For example, if you made a configuration change to BIGIP-1 and want to overwrite the change by initiating a ConfigSync from another device group member with an older configuration, such as BIGIP-2, you can temporarily set BIGIP-2 as the sync-leader and initiate a ConfigSync operation from that device. The set-sync-leader command temporarily designates a specific device group member as the synchronization leader and forces the device to initiate a one-time ConfigSync operation.

Beginning in BIG-IP 12.1.0, a new force-full-load-push command option sets the current device as synchronization leader and initiates the ConfigSync operation to the group. By using this single command option, you are able to force the current device to initiate a ConfigSync operation as a synchronization leader of the group. For more information, refer SOL63470472: The force-full-load-push command option to initiate a ConfigSync operation.

To use the set-sync-leader command option, perform the following procedure.

Note: The set-sync-leader command may delete packet filter exemptions. For more information, refer to SOL14160: The set-sync-leader tmsh command option will delete configured packet filter exemptions.

Procedures

Forcing a current device to initiate a one-time ConfigSync operation (12.1.0 and later)

To force the current device to initiate a ConfigSync operation to the group, perform the following procedure:

Impact of procedure: The  force-full-load-push command option forces the device to initiate a one-time ConfigSync operation to the device group. You may lose configuration on other devices after the ConfigSync operation. The command is not persistent and you must re-run it upon every attempt to initiate the ConfigSync process from a device with an older configuration.

  1. Log in to the Traffic Management Shell (tmsh) utility by typing the following command:

    tmsh

  2. Set the device as the synchronization leader of the device group and force the device to initiate the ConfigSync process using the following command syntax:

    run cm config-sync force-full-load-push to-group <group name>

    For example, to force a full-load ConfigSync operation from the current device to the MyDeviceGroup device group, type the following command:

    run cm config-sync force-full-load-push to-group MyDeviceGroup

Forcing a specific device group member to initiate a one-time ConfigSync operation (11.x through 12.0.0)

To temporarily designate a specific device group member as the synchronization leader and force the device to initiate a ConfigSync operation, perform the following procedure:

Impact of procedure: The set-sync-leader command option forces the device to initiate a one-time ConfigSync operation. The command is not persistent and must be re-run upon every attempt to initiate the ConfigSync process from a device with an older configuration.
  1. Log in to the tmsh utility by typing the following command:

    tmsh

  2. Set the device as the synchronization leader of the device group and force the device to initiate the ConfigSync process using the following command syntax:

    modify cm device-group <dg name> devices modify { <device name> { set-sync-leader } }

Supplemental Information

Was this resource helpful in solving your issue?




NOTE: Please do not provide personal information.



Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)