GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CLONEHDD (8)

NAME

clonedd -- Tool for clone HDD on FreeBSD

CONTENTS

Synopsis
Description
Options
Details
Using Backup Hdd
Crontab
Return Values
Examples
See Also
Author

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, unmount them.

USING BACKUP HDD

If something wrong with your SRC HDD in future, you can take out corrupted 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 receive 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. Otherwise, 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 commands.

EXAMPLES

clonehdd -src=ad0 -dst=ad2 -swap=1024
  All data from /dev/ad0 will be copied to /dev/ad2. Each partitions size will be increased or decreased proportionally, according 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/

Search for    or go to Top of page |  Section 8 |  Main Index


version 2.0.3 CLONEHDD (8) 15 September 2007

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.