Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
clonehdd(8)		Tools for system administration		   clonehdd(8)

NAME
       clonedd -- Tool for clone HDD on	FreeBSD

SYNOPSIS
       clonehdd	 -src=device  -dst=device -swap=size [-safe] [-freespace=size]
       [-fstab=device] [-force]

DESCRIPTION
       Tool for	copy partitions	to another HDD.	FreeBSD	 stores	 its  data  on
       partitions,  which  incapsulated	 in  slices.  Soft,  such as Partition
       Magic, Acronis, etc. detect only	slice, not  real  partitions  on  that
       slice.	CloneHDD  correctly  understand	size diference between two HDD
       and change size of each partition  proportionally  for  filling	entire
       HDD.

OPTIONS
       -src=device (REQUIRED)
	      Name  of	device (HDD) which contains original data. Eg. if path
	      to device	is /dev/ad0, then you type only	"ad0".	CloneHDD  will
	      keep SRC partition unchanged.

       -dst=device (REQUIRED)
	      Name of device (HDD) which will contain your backup data.	Eg. if
	      path  to	device	is /dev/ad2, then you type only	"ad2".
	      WARNING! ALL DATA	ON THIS	DEVICE WILL BE DESTROYED!

       -swap=size (REQUIRED)
	      Size of new swap partition in MBytes.

       -safe  If defined, use safe-mode	copying	data. If there is minimum  50%
	      free  space  on  partition,  CloneHDD tries to copy data in safe
	      mode, even if "-safe" flag  is  unset.  If  free	space  is  not
	      enough,  CloneHDD	 copy data in unsafe mode. Also	you will see a
	      warning message.	If "safe" flag is set, CloneHDD	will copy data
	      only in safe mode. If free space is not  enough,	CloneHDD  will
	      skip copying this	partition.  See	details	below.

       -freespace=size
	      Space  in	 MBytes,  reserved  as free on SRC partition. Clonehdd
	      checks, if SRC partition have enough free	 space	the  following
	      way: (Data size) * 2 + (Freespace) < (Partition size).  Default:
	      100MB.

       -fstab=device
	      This  value will be written in /etc/fstab	file on	DST partition.
	      Default: value from -src parameter.

       -force Do not ask questions, such as  "Are  you	sure?".	 Useful,  when
	      CloneHDD start with crontab(1)

       When safe mode is defined, CloneHDD makes image of partition, then
       store it	on the same partition in ".snap" directory and write it	on DST
       HDD. If non safe-mode defined, CloneHDD will copy data on the fly. See
	      dump(8) ,	flag "-L" for details.

DETAILS
       First, CloneHDD checks if SRC and DST devices are present in system, if
       you  have  enough free space. After theese checks, it drops all data on
       DST HDD with dd(1), make	 filesystem  with  fdisk(8),  bsdlabel(8)  and
       newfs(8).  Then,	 CloneHDD  mount each partition	to /mnt/clone and copy
       data. All data on SRC HDD  will	be  untouched.	Then  CloneHDD	modify
       /etc/fstab file on /dev/DST HDD and set device names to value in	-fstab
       parameter.    On	  DST	HDD,  root  partition  will  be	 created  file
       "backup-mode". WARNING! All partitions on SRC  HDD  that	 you  wish  to
       clone  must  be mounted.	 If you	wish not to clone some partitions, un-
       mount them.

USING BACKUP HDD
       If something wrong with your SRC	HDD in future, you can take  out  cor-
       rupted  SRC  HDD	 and put reserve DST HDD on that place.	Note, that you
       must set	correct	value to -fstab	parameter to boot  FreeBSD  correctly.
       If  you	forget to turn off starting CloneHDD from crontab, script will
       not run,	because	there is a  file  "/backup-mode"  in  root  folder  of
       filesystem  on cloned partition.	 Remove	this file if you want to clone
       such HDD	as SRC partition.

CRONTAB
       Tool works fine from crontab(1).	Put line

       clonehdd	[parameters] -force >/dev/null

       to /etc/crontab.	All error messages will	be sent	to STDERR and you  re-
       ceive  mail from	cron daemon with this information. All normal messages
       will be sent to STDOUT and then dropped on /dev/null device.

RETURN VALUES
       If CloneHDD failed to do	something, it will exit	with exit code 1. Oth-
       erwise, exit code will be zero. In version  2.0.2,  CloneHDD  does  not
       control	if error occured in dump(8), restore(8)	and rest external com-
       mands.

EXAMPLES
       clonehdd	-src=ad0 -dst=ad2 -swap=1024
	      All data from /dev/ad0 will be copied to /dev/ad2.  Each	parti-
	      tions  size  will	 be increased or decreased proportionally, ac-
	      cording to difference between 2 HDD. Only	swap size will be 1024
	      MBytes. Theese are minimum parameters, that are required.

SEE ALSO
       dump(8),	restore(8), crontab(1)

AUTHOR
       Anton Lysenok, bart@tapolsky.net.ua

       https://sourceforge.net/projects/clonehdd/

version	2.0.3		       15 September 2007		   clonehdd(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=clonehdd&sektion=8&manpath=FreeBSD+Ports+15.0>

home | help