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

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.

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]

--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]

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"

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.

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.

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

--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.

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.

Other manuals for BACKUP AND RECOVERY 10 SERVER FOR LINUX - COMMAND LINE REFERENCE UPDATE...

This manual suits for next models

Table of contents

Other ACRONIS Software manuals

ACRONIS

ACRONIS DISK DIRECTOR 11 ADVANCED SERVER - User manual

ACRONIS

ACRONIS TRUE IMAGE ECHO - FOR LINUX User manual

ACRONIS

ACRONIS TRUE IMAGE 9.1 - ENTERPRISE SERVER User manual

ACRONIS

ACRONIS TRUE IMAGE - VIRTUAL EDITION User manual

ACRONIS

ACRONIS BACKUP RECOVERY 10 ADVANCED SERVER - User manual

ACRONIS

ACRONIS SNAP DEPLOY 2.0 - User manual

ACRONIS

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

ACRONIS

ACRONIS TRUE IMAGE 9.1 - ENTERPRISE SERVER User manual

ACRONIS

ACRONIS TRUE IMAGE CORPORATE WORKSTATION 9.1 User manual

ACRONIS

ACRONIS UPGRADING TO ADVANCED EDITIONS OF BACKUP RECOVERY 10... User manual

ACRONIS

ACRONIS DISK DIRECTOR 11 ADVANCED SERVER - User manual

ACRONIS

ACRONIS PRIVACY EXPERT CORPORATE - User manual

ACRONIS

ACRONIS DISK DIRECTOR SUITE 10.0 User manual

ACRONIS

ACRONIS RECOVERY - FOR MS SQL SERVER User manual

ACRONIS

ACRONIS BACKUP AND RECOVERY 10 ADVANCED SERVER VIRTUAL EDITION - INSTALLATION UPDATE... User manual

ACRONIS

ACRONIS BACKUP AND RECOVERY 10 ADVANCED SERVER VIRTUAL EDITION - COMMAND LINE REFERENCE UPDATE... Instruction Manual

ACRONIS

ACRONIS BACKUP AND RECOVERY 10 ONLINE STAND-ALONE User manual

ACRONIS

ACRONIS BACKUP RECOVERY 10 ADVANCED SERVER VIRTUAL... User manual

ACRONIS

ACRONIS BACKUP AND RECOVERY 10 ADVANCED WORKSTATION - COMMAND LINE REFERENCE UPDATE... Instruction Manual

ACRONIS

ACRONIS TRUE IMAGE 8.0 User manual

ACRONIS

ACRONIS PRIVACY EXPERT CORPORATE - User manual

ACRONIS

ACRONIS DISK DIRECTOR SERVER 10 User manual

ACRONIS

ACRONIS TRUE IMAGE ECHO - FOR LINUX User manual

ACRONIS

ACRONIS DISK DIRECTOR SERVER 10.0 User manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual