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)