Acronis® Backup & Recovery ™ 10 Server for Linux Update 3 Command Line Reference
Table of contents 1 Console mode in Linux................................................................................................................ 3 1.1 Backup, restore and other operations (trueimagecmd) ......................................................... 3 1.1.1 1.1.2 1.1.3 1.1.4 Supported commands .............................................................................................................................. 3 Common options .................................................
1 Console 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.
Command Common Options create Specific Options --vault:[path] --arc:[archive name] Creates an image of specified --arc_id:[archive id] disks and partitions --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
--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 --filename:[filename] --password:[password] Displays the numbered list of --asz:[number of archive] backups, contained in the specified archive consolidate Creates a consistent copy of the archive which will contain only the specified backups
asz_content --password:[password] Displays the Acronis Secure Zone size, free space and contents asz_files --password:[password] Displays the Acronis Secure Zone size, free space and contents using the generated file names 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
Network folders, e.g.: --vault:smb://Server/Share/ FTP and SFTP, e.g.: --vault:ftp://ServerA/Folder1 Managed vaults (for advanced product editions only), e.g.: --vault:bsp://StorageNode/VaultName 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.
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.
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.
1.1.3 1.1.3.1 Specific options 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 -, e.g.
In Linux, a file is considered hidden if the first symbol in the file name is a dot. before:[pre-data capture command] Enables to define the command to be automatically executed before data capture. after:[post-data capture command] Enables to define the command to be automatically executed after data capture. 1.1.3.2 filebackup include:[names] Files and folders to be included in the backup (comma separated). For example: --include:'/home/bot/ATIESsafe.iso,/home/bot/ATIW.
1.1.3.3 restore harddisk:[disk number] Specifies the hard disks to restore by numbers. partition:[partition number] Specifies the partitions to restore by numbers. For example: --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 To list the partitions stored in the backup, use the --list command. For example: trueimagecmd --list --filename:backup.
When restoring a partition on unallocated space, the program extracts the partition type from the image.
--include:'/home/bot/file1.i686,/home/bot/MyProject' If not specified, all contents of the file backup are restored. 1.1.3.5 deploy_mbr harddisk:[disk number] Specifies the basic hard disk to restore the MBR from. target_harddisk:[disk number] Specifies the target hard disk where the MBR will be deployed to. 1.1.3.6 verify folder_name:[path] Specifies a path to the local folder that contains archives to verify.
Managed vaults (for advanced product editions only), e.g.: --vault:bsp://StorageNode/VaultName Network folders, e.g.: --vault:smb://Server/Share/ 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] Used in combination with the vault option. Lists all backups contained in 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] Used in combination with the vault option. Lists all backups of the selected archive. If not specified, the arc option is used.
1.1.3.12 clone harddisk:[disk number] Specifies a source hard disk which will be cloned to the new hard disk. target_harddisk:[disk number] Specifies the target hard disk number where the source hard disk will be cloned. 1.1.4 trueimagecmd usage examples The following command will list available partitions: trueimagecmd --list The following command will list the partitions (and their indices) saved in backup.tib: trueimagecmd --list --filename:backup.
The following command will list backups, contained in the archive /usr/backups/backups.tib, with their pit numbers. This command is designed to obtain pit numbers for consolidation: trueimagecmd --pit_info --filename:/usr/backups/backups.
Disk 1: 1-1 hda1 Pri,Act Table hda5 hda6 hda7 hda8 1-2 1-3 1-4 1-5 Disk 2: 2-1 (/1) hdd1 Pri,Act Table 2-2 hdd5 2-3 hdd6 31.35 MB 26.67 MB 980.5 4.887 9.767 3.462 MB GB GB GB 135.9 MB 1.751 GB 1.3 GB 4.806 GB 4.627 GB 3 GB 3.906 GB 1.319 GB FAT16 Table Linux Swap Ext2 Ext2 Ext2 Ext3 Table Ext3 Ext3 You need to back up partition 2-1. Let’s suppose a complete image has to be created weekly, supported by incremental images created daily. To do this, place the respective executable files (e.g.
-l|--list Lists already mounted user mode block devices. -m|--mount mountpoint Mounts the archive image specified by the -f|--filename option into the folder specified by the mountpoint option. The partition index should be specified by the -i|--index option. Image file contents (partitions and their indices) may be listed by the trueimagecmd --list --filename:filename command. To mount an incremental image, you must have all previous incremental images and the initial full image.
Specifies the password to explore password protected images. -t|--fstype filesystem type Specifies the explicit filesytem type to be passed to the standard "mount" command. This option is useful if the standard "mount" command can't guess the filesystem type for some reason. -i|--index partition index Index of the partition. -w|--read-write Opens the image in read-write mode. After umount, all changed data will be saved into the archive with a new index.
