home

Supported platforms

Vyatta documentation

Learn how to install, configure, and operate the Vyatta Network Operating System (Vyatta NOS) and Orchestrator, which help drive our virtual networking and physical platforms portfolio.

clone system image

Creates a copy of a system image that is installed on the local system or a remote system.

clone system image [ user@host: ] source-image-name new-image-name [ clean ]
user
Username on a remote host. A username is required for remote host access through SCP and is not required for cloning a local system image.
host
Host name or IP address of a remote host. The host name or IP address is required for remote access through SCP and is not required for cloning a local system image.
source-image-name
Name of a system image to be copied. The source image can exist on the local system or a remote system.
new-image-name
Name of the new (copied) system image. An image with this name must not exist on the system.
clean
Creates an empty read/write directory tree for the new image, which is a new image that is functionally equivalent to the source image as it existed when it was originally installed.

Operational mode

Use this command to create a copy of a system image that is installed on the local system or a remote system.

If user@host is specified, the image is fetched from the named host by using the Secure Copy Protocol (SCP). If user@host is omitted, source-image-name is the name of an image that exists on the system, and new-image-name is the image name that the system uses for the clone. No image that is named source-image-name can exist on the system.

Command completion is performed for local image names if user@host is not specified. No command completion is performed on remote image names if user@host is specified.

If the clean argument is omitted, the command copies the squashfs file that is being used by the image named source-image-name and the read/write directory tree of source-image-name. If the clean argument is given, the read/write directory tree of source-image-name is not copied. Instead, an empty read/write directory tree is created for the new image, which creates a new image that is functionally equivalent to the source image as it existed when it was initially installed.

Images created by this command behave the same as images that are installed by install image or add system image.

Both the HTTPS and SSH services must be enabled on the remote system for clone system image to work properly. The HTTPS service is enabled by using the set service https command in configuration mode. The SSH service is enabled by using the set service ssh command in configuration mode.