background image

46 

Copyright © Acronis, Inc., 2000-2010 

 

 

When restoring a partition on unallocated space, the program extracts the partition type from the 
image. For the primary partition, the type will be set as follows: 

 

if the target disk is the 1st according to BIOS and it has no other primary partitions, the restored 
partition will be set active 

 

if the target disk is the 1st according to BIOS and there are other primary partitions on it, the 
restored partition will be set logical 

 

if the target disk is not the 1st, the restored partition will be set logical. 

 

preserve_mbr 

When restoring a partition over an existing one, the target partition is deleted from the disk along 
with its entry in the target disk MBR. Then, with the 

preserve_mbr

 option, the restored partition's 

entry will occupy the upper empty position in the target disk MBR. Thus, the target disk MBR is 
preserved. If not specified, the restored partition's entry will occupy the same position as in the 
source disk MBR saved in the image. If the position is not empty, the existing entry will be moved to 
another position. 

 

2.1.3.4

 

filerestore 

target_folder:[target folder] 

Specifies a folder where folders/files will be restored (a target folder). If not specified, the original 
path is re-created from the archive. 

 

overwrite:[older | never | always] 

This option allows you to keep useful data changes made since the backup being restored was done. 
Choose what to do if the target folder contains a file with the same name as in the archive: 

 

older 

– this will give priority to the most recent file modification, whether it be in the archive or 

on the disk. 

 

never 

– this will give the file on the hard disk unconditional priority over the archived file. 

 

always 

– this will give the archived file unconditional priority over the file on the hard disk. 

If not specified, the files on the disk will always be replaced with the archived files. 

 

restore_security:[on | off] 

Specifies whether to restore files’ security attributes (default) or whether the files will inherit the 
security settings of the folder where they will be restored. 

 

original_date:[on | off] 

Specifies whether to restore files’ original date and time from the archive or whether to assign the 
current date and time to the restored files. If not specified, the current date is assigned. 

 

include:[names] 

Specifies the files and folders to restore from the file backup (comma separated).   

For example: 

Summary of Contents for BACKUP AND RECOVERY 10 ADVANCED SERVER - COMMAND LINE REFERENCE UPDATE 3

Page 1: ...Update 3 Acronis Backup Recovery 10 Advanced Server Command Line Reference...

Page 2: ...31 1 2 4 Exporting vaults and importing multiple archives 33 1 3 Scripting 33 1 3 1 Script execution parameters 33 1 3 2 Script structure 34 1 3 3 Script usage examples 35 2 Console mode in Linux 36...

Page 3: ...is somewhat more limited than the GUI mode You will not be able to perform recovery of a system volume operations that require a user interaction such as inserting removable media CD DVD or tape The...

Page 4: ...ult path arc archive name arc_id archive id filename file name password password crypt AES128 AES192 AES256 asz number of archive net_user username net_password password ftp_user username ftp_password...

Page 5: ...ber target_harddisk disk number filerestore Restores files and folders from a file archive vault path arc archive name arc_id archive id filename file name password password asz number of archive inde...

Page 6: ...sword password progress on off log file name log_net_user remote user log_net_password password silent net_src_user username net_src_password password ftp_src_user username ftp_src_password password t...

Page 7: ...ed as a virtual drive letter X letter all asz_create Creates the Acronis Secure Zone on the selected drive password password oss_numbers reboot later log file name log_net_user remote user log_net_pas...

Page 8: ...ows usage ls_check Checks if there are licenses for the local machine on the license server 1 1 2 Common options 1 1 2 1 Access to archives vault path Specifies a path to the location that contains th...

Page 9: ...ASZ b Archive name when restoring or deleting files from ASZ Can be obtained with asz_files If the vault option is specified the filename option is ignored password password a Password for the archive...

Page 10: ...p 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 defau...

Page 11: ...ne will be rebooted automatically To postpone the operation until a user reboots the system manually add the later option With this option the operation will be performed after the user initiates a re...

Page 12: ...he hard disks to include into the image file The list of available hard disks is provided by the list command An image may contain data of more than one hard disk In that case separate disk numbers by...

Page 13: ...hides the progress information percent completed It is shown by default exclude_names names Files and folders to be excluded from the backup comma separated For example exclude_names E MyProject 111 d...

Page 14: ...to select files to be excluded from the backup Use the common Windows masking rules For example to exclude all files with extension exe add exe My exe will exclude all exe files with names consisting...

Page 15: ...es the basic hard disks to restore partition partition number Specifies the partitions to restore Dynamic volumes are specified with the prefix DYN e g partition DYN1 target_harddisk disk number Speci...

Page 16: ...it has no other primary partitions the restored partition will be set active if the target disk is the 1st according to BIOS and there are other primary partitions on it the restored partition will be...

Page 17: ...specified the original path is re created from the archive overwrite older never always This option allows you to keep useful data changes made since the backup being restored was done Choose what to...

Page 18: ...h the folder_name p 18 option Prohibits verification of archives stored in the subfolders of the specified folder For example folder_name D MyBackups no_subdir If the option not specified all archives...

Page 19: ...are supported Local folders e g target_vault C Test or vault C Test 1 Network folders e g target_vault ServerA Share Managed vaults for advanced product editions only e g target_vault bsp StorageNode...

Page 20: ...esulting virtual disk is supposed to be bootable With this key the program will add drivers necessary for the virtual machine type selected with the vm_type key to the resulting virtual disk If the im...

Page 21: ...path specified as a local path e g vault F 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 folde...

Page 22: ...free space on all partitions selected with the partition option and minimal about 35MB values Either way the program will first use the unallocated space If there is not enough unallocated space the s...

Page 23: ...with password qwerty split into 640 MB parts and contain all cluster data Image compression level is 5 The server will be rebooted after the operation is completed The following command will create a...

Page 24: ...asz 2 index 3 password pswd The following command will restore the MBR from the image of hard disk 1 to hard disk 2 The image is contained in the arc tib file located on the FTP server trueimagecmd d...

Page 25: ...ed in D Backups to the new archive Archive 2 on the FTP server Server22 Vault3 trueimagecmd export vault D Backups arc Archive 1 include_pits 2 4 5 target_vault ftp Server22 Vault3 target_arc Archive...

Page 26: ...and contents trueimagecmd asz_content Assume that the contents of Acronis Secure Zone are as follows C Program Files Acronis BackupAndRecovery trueimagecmd asz_content ASZ size 34 439 GB ASZ free spa...

Page 27: ...hree archives Archive AAA2 2 stands for the number of backups in the archive consists of full base image backup created on 2 16 2009 at 3 43 incremental backup created on 4 25 2009 at 11 44 Archive FA...

Page 28: ...Clone The following command will clone hard disk 2 to hard disk 3 trueimagecmd clone harddisk 2 target_harddisk 3 1 1 4 14 Explore image The following command will connect all images stored in file my...

Page 29: ...alized managed vault vault Folder_Name Either arc Archive_Name or arc id Archive_UUID target_vault Managed_Vault password Password credentials User_Name Password target_credentials User_Name Password...

Page 30: ...bsp My Node My Vault Without this option the utility exports the entire archive For details on how backups are exported see the Exporting archives and backups section in the User s Guide 1 2 2 4 log...

Page 31: ...lt where you want to place the imported archive The vault has to be managed by the local storage node The vault name is given as a Uniform Resource Identifier URI for example target_vault bsp My Stora...

Page 32: ...hive is specified here by its Universally Unique Identifier UUID instead of its name see the output in the previous example StorageNodeCmd list vault bsp My Node My Vault arc_id 183DE307 BC97 45CE 9AF...

Page 33: ...and the local or network folder where to export them to cscript exe VaultExport js source_vault bsp My Node My Vault target_vault C Archives To import all archives from a folder to a managed vault 1 G...

Page 34: ...and switch TrueImageTerminal to a background operation You can terminate the backup operation executed by TrueImageTerminal by pressing Ctrl B 1 3 2 Script structure Scripts are written in the XML lan...

Page 35: ...ded in bytes kilobytes megabytes etc Password adds password protection to an image file 1 3 3 Script usage examples The following example illustrates the usage of a script to back up two partitions lo...

Page 36: ...re 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 Anot...

Page 37: ...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...

Page 38: ...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_...

Page 39: ...up 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...

Page 40: ...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 speci...

Page 41: ...p 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...

Page 42: ...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 protec...

Page 43: ...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 com...

Page 44: ...ATIESsafe iso home bot MyProject Old 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 extensio...

Page 45: ...start start sector Sets the start sector for restoring a partition to the hard disk unallocated space fat16_32 Enables the file system conversion from FAT16 to FAT32 if the partition size after recove...

Page 46: ...re target_folder target folder Specifies a folder where folders files will be restored a target folder If not specified the original path is re created from the archive overwrite older never always Th...

Page 47: ...specified folder For example folder_name home bot MyProject no_subdir If the option is not specified all archives stored in the parent folder and its subfolders will be verified 2 1 3 6 deploy_mbr har...

Page 48: ...ons 2 3 and 2 5 they will be listed as 2 1 and 2 2 If the deploy partition command cannot find a partition in the image by its physical number use the partition number in the image target_partition ph...

Page 49: ...number Specifies partitions from which free space will be taken for Acronis Secure Zone size ASZ size in sectors unallocated Sets the Acronis Secure Zone size in sectors If not specified the size is...

Page 50: ...will create an incremental image of the above partition trueimagecmd partition 1 1 filename backup tib create incremental The following command will create an image of partition 1 1 in the Acronis Se...

Page 51: ...to the hard disk 1 trueimagecmd deploy_mbr filename usr backups D1 tib harddisk 1 The following command will export the archive1 archive from the root folder to the new archive named archive2 in the...

Page 52: ...ath of the image The second executable file is needed to initiate daily creation of incremental images bin bash usr sbin trueimagecmd create incremental partition 2 1 filename mnt backups my_host back...

Page 53: ...the f filename option containing a valid Linux filesystem as if it were an Acronis Backup Recovery 10 archive The command may be used for example to estimate an image compression level by comparing th...

Page 54: ...rite mode the program assumes that the image will be modified and creates an incremental archive file to capture the changes The option enables you to list the forthcoming changes in the comment to th...

Reviews: