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)