Acronis BACKUP RECOVERY 10 Command Line Reference
Acronis® Backup & Recovery™ 10
Server for Linux
Command Line Reference
Table of contents
1 Console mode in Linux ............................................................................................................. 3
1.1 Backup, restore and other operations (trueimagecmd) ............................................................ 3
1.1.1 Supported commands .................................................................................................................................. 3
1.1.2 Common options .......................................................................................................................................... 6
1.1.3 Specific options ............................................................................................................................................. 9
1.1.4 trueimagecmd usage examples .................................................................................................................15
1.2 Automatic image creation using cron service .........................................................................16
1.3 Restoring files with trueimagemnt ..........................................................................................17
1.3.1 Supported commands ................................................................................................................................17
1.3.2 Trueimagemnt usage examples .................................................................................................................19
2 Index ..................................................................................................................................... 20
1 Con sole mode in Li nux
Console is a natural part of Linux OS. Acronis Backup & Recovery 10 supports it through the
trueimagecmd command line tool. It provides a way to initiate data backup and recovery operations.
trueimagecmd also enables you to automate backup with the ‘cron’ service.
The trueimagecmd functionality is somewhat limited as compared to the GUI mode. trueimagecmd
does not support operations that require:
reboot of the system, such as restore a system partition or clone system drive.
a user interaction, such as inserting second media like CD, DVD, or tape when the first one is full.
Likewise, if there is no media inserted in the drive at all, the operation fails.
Therefore, under complex conditions, we recommend that you use the more powerful
acronis_console operating mode under X Window System.
Another useful tool, trueimagemnt, allows you to extract files or directories from images by
mounting images as if they were Linux kernel block devices. See also man trueimagecmd or man
trueimagemnt.
These utilities are also available when operating under the Linux-based bootable media.
1.1 Backup, re store a nd ot her ope rations (trueimagecmd)
1.1.1 Supported commands
trueimagecmd has the following format:
trueimagecmd --command --option1 --option2…
Commands may be accompanied with options. Some options are common for most trueimagecmd
commands, while others are specific for individual commands. Below is a list of supported commands
and compatible options.
Command Common Options Specific Options
create
Creates an image of specified
disks and partitions
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--incremental
--differential
--compression:[0…9]
--split:[size in MB]
--oss_numbers
--log:[filename]
--harddisk:[disk number]
--partition:[partition number]
--raw
--progress:[on|off]
--exclude_names:[names]
--exclude_masks:[masks]
--exclude_hidden
--before:[pre-data capture command]
--after:[post-data capture command]
filebackup
Backs up specified files and
folders
Copyright © Acronis, Inc., 2000-2010 3
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--include:[names]
--exclude_names:[names]
--exclude_masks:[masks]
--exclude_hidden
--before:[pre-data capture command]
--incremental
--after:[post-data capture command]
restore
Restores disks and partitions
from an image
filerestore
Restores files and folders
from a file archive
deploy_mbr
Restores the MBR from a
disk or partition image
--differential
--compression:[0…9]
--split:[size in MB]
--log:[filename]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--oss_numbers
--log:[filename]
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--log:[filename]
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--oss_numbers
--log:[filename]
--progress:[on | off]
--harddisk:[disk number]
--partition:[partition number]
--target_harddisk:[disk number]
--target_partition:[partition number]
--start:[start sector]
--fat16_32
--size:[partition size in sectors]
--type:[active|primary|logical]
--preserve_mbr
--target_folder:[target folder]
--overwrite:[older|never|always]
--restore_security:[on|off]
--original_date:[on|off]
--harddisk:[disk number]
--target_harddisk:[disk number]
verify
Verifies the archive data
integrity
pit_info
Displays the numbered list of
backups, contained in the
specified archive
consolidate
Creates a consistent copy of
the archive which will
contain only the specified
backups
export
Creates a copy of an archive
or a self-sufficient part copy
of an archive in the location
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--log:[filename]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--include_pits:[pits numbers]
--filename:[filename]
--password:[password]
--log:[filename]
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--include_pits:[pits numbers]
--password:[password]
--target_filename:[file name]
--target_vault:[target path]
--target_arc:[target archive name]
4 Copyright © Acronis, Inc., 2000-2010
you specify
--progress:[on | off]
--log:[filename]
--net_user:[username]
--net_password:[password]
--ftp_user:[username]
--ftp_password:[password]
list
Lists available drives and
partitions. When used with
the filename option, it lists
the image contents.
When used with the vault
option, it lists archives
located in the specified
location. When the arc, or
the arc_id option is added, it
lists all backups contained in
the archive.
asz_create
Creates the Acronis Secure
Zone on the selected drive
asz_content
Displays the Acronis Secure
Zone size, free space and
contents
asz_files
--password:[password]
--index:N
--asz:[number of archive]
--password:[password]
--oss_numbers
--log:[filename]
--password:[password]
--password:[password]
--filename:[file name]
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--harddisk:X
--partition:[partition number]
--size:[ASZ size in sectors]
Displays the Acronis Secure
Zone size, free space and
contents using the generated
file names
asz_delete
Deletes the Acronis Secure
Zone
asrm_activate
Activates the Acronis Startup
Recovery Manager
asrm_deactivate
Deactivates the Acronis
Startup Recovery Manager
clone
Clones a hard disk
help
Shows usage
ls_check
--password:[password]
--oss_numbers
--log:[filename]
--partition:[partition number]
--harddisk:[disk number]
--target_harddisk:[disk number]
Checks if there are licenses
for the local machine on the
Copyright © Acronis, Inc., 2000-2010 5
license server
dumpraidinfo
Saves information about MD
devices and LVM volumes to
the /etc/Acronis directory
1.1.2 Common options
1.1.2.1 Access to archives
vault:[path]
Specifies a path to the location that contains the archive. Used in combination with the arc, or the
arc_id option.
The following locations are supported:
Local folders, e.g.: --vault:/folder, or --vault:"/Folder 1"
Network folders, e.g.: --vault:smb://Server/Share/
Managed vaults (for advanced product editions only), e.g.: --
vault:bsp://StorageNode/VaultName
FTP and SFTP, e.g.: --vault:ftp://ServerA/Folder1
CD, DVD – with the path specified as a local path, e.g.: --vault:/mnt/cdrom
Acronis Secure Zone, e.g.: --vault:atis:///asz
Tapes, e.g.: --vault:atis:///tape?0
Unmanaged vaults are specified by their path. For example, if a vault is located in a folder,
specify the path to that folder.
If the vault option is specified the filename option is ignored.
arc:[archive name]
The name of the archive. If not specified, the arc_id option is used. If both the arc and arc_id options
are specified, the arc_id option is used.
arc_id:[archive id]
Specifies the Universally Unique Identifier (UUID) of the archive, e.g.:
--arc_id:183DE307-BC97-45CE-9AF7-60945A568BE8
If not specified, the arc option is used. If both the arc and arc_id options are specified, the arc_id
option is used.
filename:[filename]
Archive name, if the archive location is other than ASZ.
To get Samba network access, specify the backup file name and the log file name as follows:
--filename:smb://username:password@hostname/sharename/filename
--log:smb://username:password@hostname/sharename/logfilename
6 Copyright © Acronis, Inc., 2000-2010
or:
--filename:smb://hostname/sharename/filename –-net_user:username \ -–
net_password:password
--log:smb://hostname/sharename/logfilename –-log_net_user:username \ -–
log_net_password:password
Only the last two options can be used if the user name or password contains the @ or / symbols.
To access an NFS network drive, specify the backup file name as follows:
nfs://hostname/share name:/remote filename
For example:
trueimagecmd --list --filename:nfs://dhcp6-
223.acronis.com/sdb3/nfs_root:/mike/md1.tib
shows contents of /mike/md1.tib archive. /mike/md1.tib is located on dhcp6-223.acronis.com
node in /sdb3/nfs_root directory exported by NFS.
If the vault option is specified the filename option is ignored.
password:[password]
a) Password for the archive, if the archive location is other than ASZ.
b) Password for the ASZ, if archive location is ASZ.
asz:[number of archive]
Addresses to the ASZ and selects the archive (a full backup with or without increments).
To get the archive number, use asz_content.
index:N
N = Number of the backup in an archive:
1 = basic full backup
2 = 1st increment… and so on
0 (default) = latest increment
Selects a backup in a sequence of incremental backups inside the archive.
To get a backup index from the ASZ, use asz_content.
ftp_user:[username]
Specify a user name for access to an FTP server.
ftp_password:[password]
Specify a password for access to an FTP server.
net_user:[username]
Specifies the user name for logon to the network share to save the resulting archive.
Copyright © Acronis, Inc., 2000-2010 7
Loading...