cm config-sync

cm config-sync(1)				  BIG-IP TMSH Manual				    cm config-sync(1)

NAME
       config-sync - Manually synchronizes the configuration between devices.

MODULE
       cm

SYNTAX
       Run the config-sync program within the cm module using the syntax in the following section.

   MODIFY
	run config-sync
	  options:
	    from-group 
	    recover-sync
	    to-group 
	    force-full-load-push

DESCRIPTION
       This command starts a configuration synchronization job. One of the from-group, to-group, or recover-sync
       options must be used to specify the direction of the synchronization.

EXAMPLES
       run config-sync from-group my_dg

       Updates the configuration on the local device with the configuration from the remote device in the device
       group /Common/my_dg with the newest configuration. If the local device already has the newest configuration,
       then the configuration synchronization does nothing.

       run config-sync to-group my_dg

       Updates the configurations on the remote devices in the device group /Common/my_dg with the configuration on
       the local device. If the local device does not have the newest configuration, then the configuration
       synchronization does nothing.

       run config-sync recover-sync

       Resets the local device configuration and restores the trust domain, device, and device-group information to
       default settings.

OPTIONS
       from-group
	    Updates the configuration of the local device with the configuration of the remote device in the
	    specified device group that has the newest configuration. If the local device already has the newest
	    configuration, then the configuration synchronization does nothing. This option is mutually exclusive of
	    the to-group and recover-sync options.

       recover-sync
	    WARNING: If you have any local-only configuration, do not use this option.

	    This option will delete all configuration except for that which is necessary to remain in your device
	    groups. At this point, you can sync from those groups to this device in order to restore your
	    configuration.

	    Resets the local device configuration and restores the trust domain, device, and device-group information
	    to default settings. After this recovery, you can sync the local device with its peers by running config-
	    sync on a peer device and specifying the device group in which the local device is a member. This option
	    is mutually exclusive of the from-group and to-group options.

       to-group
	    Updates the configurations of the remote devices in the specified device group with the configuration of
	    the local device. If the local device does not have the newest configuration, then the configuration
	    synchronization does nothing. This option is mutually exclusive of the from-group and recover-sync
	    options.

       force-full-load-push
	    This option may only be used if to-group has also been specified. It forces all other devices to pull all
	    synchronizable configuration from this device, even if those devices have the same or newer
	    configuration. It will always send the entire configuration, rather than just the changes, regardless of
	    the device group's full-load-on-sync setting.

	    You may lose configuration by using this option. This happens if you force a push even when another
	    device in the device group has newer configuration.

SEE ALSO
       run, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or by any means, electronic or
       mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose
       other than the purchaser's personal use, without the express written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2009-2011, 2013, 2015. All rights reserved.

BIG-IP						      2017-10-09				    cm config-sync(1)