ACRONIS BACKUP AND RECOVERY 10 SERVER FOR LINUX - COMMAND LINE REFERENCE UPDATE... Instruction Manual

Update 3
Acronis® Backup & Recovery ™ 10
Server for Linux
Command Line Reference

Table of contents
1Console 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.......................................................................................................................................10
1.1.4 trueimagecmd usage examples..............................................................................................................17
1.2 Automatic image creation using cron service ......................................................................18
1.3 Restoring files with trueimagemnt ......................................................................................19
1.3.1 Supported commands............................................................................................................................19
1.3.2 Trueimagemnt usage examples..............................................................................................................21

3 Copyright © Acronis, Inc., 2000-2010
1Console mode in Linux
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, restore and other operations
(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.

4 Copyright © Acronis, Inc., 2000-2010
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]
--crypt:[AES128|AES192|AES256]
--incremental
--differential
--compression:*0…9+
--split:[size in MB]
--oss_numbers
--log:[filename]
--silent
--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
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--crypt:[AES128|AES192|AES256]
--incremental
--differential
--compression:*0…9+
--split:[size in MB]
--log:[filename]
--silent
--include:[names]
--exclude_names:[names]
--exclude_masks:[masks]
--exclude_hidden
--before:[pre-data capture command]
--after:[post-data capture command]
--progress:[on | off]
restore
Restores disks and partitions
from an image
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--oss_numbers
--log:[filename]
--silent
--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
filerestore
Restores files and folders
from a file archive
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--log:[filename]
--silent
--target_folder:[target folder]
--overwrite:[older|never|always]
--restore_security:[on|off]
--original_date:[on|off]
--include:[names]
deploy_mbr
Restores the MBR from a
disk or partition image
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--index:N
--oss_numbers
--harddisk:[disk number]
--target_harddisk:[disk number]

5 Copyright © Acronis, Inc., 2000-2010
--log:[filename]
--silent
verify
Verifies the archive data
integrity
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--filename:[filename]
--password:[password]
--asz:[number of archive]
--log:[filename]
--silent
--folder_name:[path]
--no_subdir
pit_info
Displays the numbered list of
backups, contained in the
specified archive
--filename:[filename]
--password:[password]
--asz:[number of archive]
consolidate
Creates a consistent copy of
the archive which will
contain only the specified
backups
--include_pits:[pits numbers]
--filename:[filename]
--password:[password]
--log:[filename]
--silent
--target_filename:[file name]
export
Creates a copy of an archive
or a self-sufficient part copy
of an archive in the location
you specify
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
--include_pits:[pits numbers]
--password:[password]
--progress:[on | off]
--log:[filename]
--net_user:[username]
--net_password:[password]
--ftp_user:[username]
--ftp_password:[password]
--silent
--target_vault:[target path]
--target_arc:[target archive name]
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.
--password:[password]
--index:N
--asz:[number of archive]
--filename:[file name]
--vault:[path]
--arc:[archive name]
--arc_id:[archive id]
asz_create
Creates the Acronis Secure
Zone on the selected drive
--password:[password]
--oss_numbers
--log:[filename]
--silent
--harddisk:X
--partition:[partition number]
--size:[ASZ size in sectors]

6 Copyright © Acronis, Inc., 2000-2010
asz_content
Displays the Acronis Secure
Zone size, free space and
contents
--password:[password]
asz_files
Displays the Acronis Secure
Zone size, free space and
contents using the generated
file names
--password:[password]
asz_delete
Deletes the Acronis Secure
Zone
--password:[password]
--oss_numbers
--log:[filename]
--silent
--partition:[partition number]
asrm_activate
Activates the Acronis Startup
Recovery Manager
asrm_deactivate
Deactivates the Acronis
Startup Recovery Manager
clone
Clones a hard disk
--harddisk:[disk number]
--target_harddisk:[disk number]
help
Shows usage
ls_check
Checks if there are licenses
for the local machine on the
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"

7 Copyright © Acronis, Inc., 2000-2010
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
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.

8 Copyright © Acronis, Inc., 2000-2010
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.
net_password:[password]
Specifies the password for logon to the network share to save the resulting archive.
include_pits:[pits numbers]
Specifies the backups (pits) to be included in the archive copy. To get the numbers of pits, use
pit_info. Separate multiple values with a comma, for example:
--include_pits:2,4,5
1.1.2.2 Backup options
incremental
Set the backup type to incremental.
If not specified or there is no basic full backup, a full backup will be created.

9 Copyright © Acronis, Inc., 2000-2010
differential
Set the backup type to differential.
If not specified or there is no basic full backup, a full backup will be created.
compression:[0…9]
Specify the data compression level.
It ranges from 0 to 9 and is set to 3 by default.
crypt:[AES128|AES192|AES256]
Specifies the key size for the AES algorithm encryption of the password-protected archive. The option
is used together with the --password (p. 8) option. For example:
--password:QWerTY123 --crypt:AES256
The randomly generated encryption key is then encrypted with AES-256 using a SHA-256 hash of the
password as a key. The password itself is not stored anywhere on the disk or in the backup file; the
password hash is used for verification purposes. With this two-level security, the backup data is
protected from any unauthorized access, but recovering a lost password is not possible.
If the /crypt option is not specified, the password-protected archive will be not encrypted.
split:[size in MB]
Split the backup into parts of the specified size, if the archive location is other than ASZ.
1.1.2.3 General options
oss_numbers
Declares that numbers of partitions in the partition option are adjusted for the MBR partition table
rather than be simple ascending numbers. This means that primary partitions have numbers 1-1, 1-2,
1-3, 1-4 and logical partitions numbers start with 1-5. For example, if the disk has one primary and
two logical partitions, their numbers can appear as follows:
--partition:1-1,1-2,1-3
or
--oss_numbers --partition:1-1,1-5,1-6
log:[file name]
Create a log file of the current operation with the specified file name.
silent
Suppresses the command's output.

10 Copyright © Acronis, Inc., 2000-2010
1.1.3 Specific options
1.1.3.1 create
harddisk:[disk number]
Specifies the numbers of the hard disks to be imaged (comma separated). For example:
--harddisk:1,3
You can obtain the list of available hard disks using the --list command.
partition:[partition number]
Specifies the partitions to include into the image file by numbers. The list of available partitions is
provided by the --list command. Partition numbers are specified as <disk number>-<partition
number>, e.g.:
--partition:1-1,1-2,3-1
To specify a logical volume (also called LVM volume) or an MD device (also called Linux Software
RAID), use the DYN prefix. For example:
--partition:dyn1
raw
Use this option to create an image of a disk (partition) with an unrecognized or unsupported file
system. This will copy all disk/partition contents sector-by-sector. Without this option only the
sectors containing useful system and user data are imaged (for the supported file systems).
progress:[on | off]
Shows/hides the progress information (percent completed). It is shown by default.
exclude_names:[names]
Specifies files and folders to be excluded from the backup (comma separated). Object names have to
be specified relative to the objects' partitions root entry.
For example, if "boot" partition is mounted to the /boot directory and it is necessary to exclude the
"grub" directory from a backup, then it must be specified as /grub/. If this directory is located on a
root partition, then /boot/grub/ should be specified to exclude it from the backup.
exclude_masks:[masks]
Applies masks to select files to be excluded from the backup. Use the common Linux masking rules.
For example, to exclude all files with extension .sh, add *.sh. My???.sh will exclude all .sh files with
names consisting of five symbols and starting with "my".
exclude_hidden
Excludes all hidden files from the backup.