sys ucs

sys ucs(1)		      BIG-IP TMSH Manual		    sys ucs(1)



NAME
       ucs - Loads or saves a UCS (.ucs) file.

MODULE
       sys

SYNTAX
       Configure the ucs component within the sys module using the syntax in
       the following sections.

   MODIFY
	save ucs [file name]
	  options:
	    no-private-key
	    passphrase

	load ucs [file name]
	  options:
	    include-chassis-level-config
	    no-license
	    no-platform-check
	    passphrase
	    platform-migrate
	    reset-trust

	delete ucs [ file name ]

   DISPLAY
	list ucs
	show ucs [file name]

DESCRIPTION
       You can use the ucs component to save the running configuration of the
       system into a UCS file. Additionally, you can modify the running
       configuration of the system by loading an existing UCS file.

       When you save a UCS file, the file is saved to the default directory,
       /var/local/ucs.

       When you load a UCS file in shell mode, the system searches for the
       file using the relative path to the default directory (/var/local/ucs).
       When you load a UCS file in bash mode, the system searches the current
       directory first. If the file is not found in the current directory, the
       default directory is then searched.

EXAMPLES
       save ucs myucs

       Saves the running configuration of the system into the file myucs.ucs.

       load ucs myucs

       Modifies the running configuration of the system by loading the
       configuration contained in the myucs.ucs file.

       delete ucs myucs

       Delete myucs.ucs in the default directory, /var/local/ucs/.

       list ucs

       Displays existing UCS files in the default directory, /var/local/ucs/.

OPTIONS
       include-chassis-level-config
	    During restore of the UCS file, include chassis level
	    configuration that is shared among boot volume sets. For example,
	    cluster default configuration.

       no-license
	    Performs a full restore of the UCS file and all the files it
	    contains, with the exception of the license file. The option must
	    be used to restore a UCS on RMA devices (Returned Materials
	    Authorization).

       no-platform-check
	    Bypasses the platform check and allows a UCS that was created
	    using a different platform to be installed. By default (without
	    this option), a UCS created from a different platform is not
	    allowed to be installed.

       no-private-key
	    Indicates that the UCS file can be saved without private key
	    information.

       passphrase
	    Specifies the passphrase that is necessary to load the specified
	    UCS file.

       platform-migrate
	    Ignore the configuration items specific to a particular platform.
	    The platform-specific objects already present on the device are
	    not removed or modified. The ones included in the UCS archive are
	    not loaded.

	    This option is not valid for UCS archives from systems provisioned
	    with modules other than LTM and GTM. If the UCS comes from a
	    system running any release of TMOS version 10, only LTM (not GTM)
	    is supported.

	    This option implies no-license and no-platform-check.

       reset-trust
	    When specified, the device and trust domain certs and keys are not
	    loaded from the UCS. Instead, a new set is regenerated.

SEE ALSO
       load, list, save, show, 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-2014, 2016. All rights
       reserved.



BIG-IP				  2016-03-31			    sys ucs(1)