February, 2011



ctys-cloneVM - Copy and configure VMs



   [-d <debug-level>]
   [-H <help-options>]
   -t <session-type>


ctys-cloneVM provides the automated duplication of present virtual machines. Therefore first the VM is copied to a defined target and second the configuration parameters are altered to new values. The duplicated new VM is executable without any further required modification. The conversion between different hypevisors - a.k.a. session types - is provided by the tool ctys-convertVM(1).

The current version of ctys-cloneVM could be applied by batch processing mode to offline-VMs, where basic values could be consistently altered for the new VM. Local targets are supported only, thus a remote VM target requires the remote copy by OS means.

Additional fine grained configuration parameters could be set by ctys-createConfVM(1). The target VM could be stored locally or to a remote location by secure connections via 'scp' from the OpenSSH package. The full scope of authorisation for remote connections by OpenSSH could be applied, this comprises particularly SSH-Keys and Kerberos.

The current version provides the following features:

The following table shows a sumup of available features for the current version. The sessiontypes requirering specific tools for their repositories has to be executed on a platform with installed tools and probably with running and enabled hypervisor including helper processes. In cases with specific storage addressing the appropriate mapping functions are required.

Hypervisor/Emulator VM-Copy VM-Config VM-Registration GuestOS-Config
QEMU/KVM x x ctys ffs. 3.)
VBOX x x ctys + OEM 1.) ffs. 3.)
VMW x x ctys + OEM 2.) ffs. 3.)
VMWE - VMware ESX(TM) ffs. ffs. ffs. ffs. 3.)
VMWEi - VMware ESXi(TM) ffs. ffs. ffs. ffs. 3.)
XEN x x ctys ffs. 3.)
XENS - XenServer(TM) ffs. ffs. ffs. ffs. 3.)

Clone Automation

ctys Ctys database by ctys-vdbgen and ctys-vhosts.
OEM Registration within the native inventory of the OEM.
1.) Requires additional registration in runtime database by VirtualBox-Gui.
2.) Requires for some versions additional registration in runtime database
by VMware-Gui. Registration for VMware-Server-2.x could be performed
implicitly when providing User and non-crypted Password at the commandline,
which should be avoided.
3.) Requires the native configuration, which depends on the OS. E.g. a
MS-Widows(TM) workstation may require the reconfiguration of system parameters
for networking and in addition the new reqistration in it's ADS domain.

The available call options are partly set by the commandline options, but could the majority of the values are used by pre-assigned environment variables. This is similar to the call of ctys-createConfVM(1), the variables are the same. The modification of the configuratrion parameters is accomplished by ctys-createConfVM. Therefore the values are just passed through to ctys-createConfVM.



-d <debug-level>

Same as ctys.


Parent directory for storage of cloned VM. The actually created directory path is '<directory>/<label>'. The value of '<directory>' is required to be absolute.


Filename of pre-stored default values for copied VM, the creation could be performed by usage of ctys-createConfVM.


Force the processing when the target directory is present.


Print help, refer to "-H" for additional information.

-H <help-option>

The extended help option is based on system interfaces for display of manpages, PDF and HTML documents. This comprises the man pages and installed manuals.

For additional help refer to the documents or type ctys -H help.


The label - the name - for the target VM to be created.


The label - the name - for the source VM to be cloned.


List of current options to be set by environment variables. For additional information refer to ctys-createConfVM(1).


Suppresses the copy of the virtual file image.


The state to be set for the target machine. For additional information on values refer to ctys-states(1).


Suppresses the copy of the external runtime kernels. External runtime kernels are frequently requiered for paraviretualized DomU of Xen and in some cases of QEMU.

-t <session-type>

The session type the VM has to be created for. Currently QEMU (for QEMU and KVM on x86), VMW , VBOX , and XEN are supported. Each defines a common set of parameters with additional specific variations.










For examples refer to ctys-cloning-vms(7).

  2. VBOX
  3. VMW
  4. XEN



0: OK:
Result is valid.

1: NOK:
Erroneous parameters.

2: NOK:
Missing an environment element like files or databases.


ctys executables
ctys-attribute(1) , ctys-createConfVM(1) , ctys-convertVM(1)

ctys plugins

KVM(1) , ctys-QEMU(1) , ctys-VBOX(1) , ctys-VMW(1) , ctys-XEN(1)

ctys-CLI(1) , ctys-RDP(1) , ctys-VNC(1) , ctys-X11(1)


Written and maintained by Arno-Can Uestuensoez:

Maintenance: <<acue_sf1 (a) users sourceforge net>>
Homepage: <http://www.UnifiedSessionsManager.org>
Sourceforge.net: <http://sourceforge.net/projects/ctys>
Berlios.de: <http://ctys.berlios.de>
Commercial: <http://www.i4p.com>


Copyright (C) 2008, 2009, 2010, 2011 Ingenieurbuero Arno-Can Uestuensoez

For BASE package following licenses apply,

This document is part of the DOC package,

For additional information refer to enclosed Releasenotes and License files.