System Administration Commands                     virt-clone(1M)



NAME
     virt-clone - clone virtual machine images

SYNOPSIS
     /usr/bin/virt-clone  [option]


DESCRIPTION
     The virt-clone utility is a command line  tool  for  cloning
     existing  virtual  machine  images.  virt-clone  copies disk
     images of an existing virtual  machine  and  defines  a  new
     guest with an identical virtual hardware configuration. Ele-
     ments that require uniqueness are updated to avoid  a  clash
     between old and new guests.


     With appropriate command-line arguments, virt-clone can  run
     completely unattended, with the guest automatically starting
     itself as well. This allows for  easy  automation  of  guest
     installs.


     If you do not specify options  to  virt-clone,  the  command
     runs interactively, prompting for input as required.


     To run virt-clone, you must become superuser or  assume  the
     Primary Administrator role.

OPTIONS
     The following options are supported:

     --connect=URI

         Connect to the hypervisor at URI.


     -d, --debug

         Display debugging information when running  the  install
         process.


     -f diskimage, --file=diskimage

         Path to the file, disk partition, or logical  volume  to
         use  as  the backing store for the guest's virtual disk.
         If the original guest has multiple disks, this parameter
         must  be  repeated  multiple times, once per disk in the
         original virtual  machine.





SunOS 5.11          Last change: 23 Jun 2008                    1






System Administration Commands                     virt-clone(1M)



     -h, --help

         Display the help message and exit.


     -m macaddr, --mac=macaddr

         Fixed MAC address for the guest. If the  keyword  random
         is specified, a random address will be used.


     -n name, --name=name

         Name of the new guest  virtual  machine  instance.  This
         must  be unique among all guests known to the hypervisor
         on this machine, including those not  currently  active.
         To redefine an existing guest, use the virsh(1M) tool to
         shut it down and delete it prior to running  virt-clone.
         This  parameter  will  be prompted for if omitted on the
         command line.


     -o originalguest, -original=originalguest

         Name or UID for the original guest to be  cloned.  This
         guest  must  be  shut  down  since it is not possible to
         safely clone active guests.


     -u UID, -uuid=UID

         UID for the guest; if none is specified, a random  UID
         is  generated. If you specify UID, use a 32-digit hexa-
         decimal number. Keep in mind that UIDs are intended  to
         be unique across the entire data center, and indeed, the
         world.


EXAMPLES
     Example 1 Cloning a Guest with a Single Disk


     The following command clones a guest named demo, which has a
     single disk to copy.


       # virt-clone \
            --original demo \
            --name newdemo \
            --file /var/lib/xen/images/newdemo.img





SunOS 5.11          Last change: 23 Jun 2008                    2






System Administration Commands                     virt-clone(1M)



     Example 2 Cloning a Guest with Multiple Disks


     The following command clones a guest named  demo,  with  has
     multiple disks to copy.


       # virt-clone \
            --original demo \
            --name newdemo \
            --file /var/lib/xen/images/newdemo.img \
            --file /var/lib/xen/images/newdata.img



     Example 3 Cloning to a Device with Comparable Disk Space


     The following command clones a guest to  a  physical  device
     that  has  at  least  as much disk space as had the original
     guest. . If the destination device is has  more  space,  the
     new guest can do a file system resize when it boots.


       # virt-clone \
            --name demo \
            --file /dev/HostVG/DemoVM \
            --mac 00:16:3e:34:11:54



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWxvmu                    
    
     Interface Stability          Volatile                    
    


SEE ALSO
     virsh(1M), virt-install(1M), xm(1M), xVM(5),  attributes(5),
     xVM(5)






SunOS 5.11          Last change: 23 Jun 2008                    3