ACRONIS Backup & Recovery 10 Advanced Workstation, Cli Reference Manual

Page 1: ...Command Line Reference Acronis Backup Recovery 10 Advanced Workstation ...

Page 2: ...ons 8 1 1 3 Specific options 11 1 1 4 trueimagecmd exe usage examples 21 1 2 Storage node command line utility 26 1 2 1 Supported commands 26 1 2 2 Options 27 1 2 3 Examples 29 1 2 4 Exporting vaults and importing multiple archives 31 1 3 Scripting 31 1 3 1 Script execution parameters 31 1 3 2 Script structure 32 1 3 3 Script usage examples 33 2 Index 34 ...

Page 3: ...e You will not be able to perform operations that require the reboot of the system such as restore a system volume or clone a system disk a user interaction such as inserting removable media CD DVD or tape the operation fails if there is no media in the drive or the inserted media is full These operations only can be done through the GUI Scripting is intended only for backup 1 1 Agent for Windows ...

Page 4: ...rd password ftp_user username ftp_password password incremental differential compression 0 9 split size in MB reboot log file name log_net_user remote user log_net_password password include names exclude_names names exclude_masks masks exclude_system exclude_hidden before pre data capture command after post data capture command use_vss deploy Restores disks and partitions except for the MBR from a...

Page 5: ... index N net_user username net_password password ftp_user username ftp_password password reboot log file name log_net_user remote user log_net_password password target_folder target folder overwrite older never always restore_security on off original_date on off verify Verifies the archive data integrity vault path arc archive name arc_id archive id filename file name password password asz number ...

Page 6: ..._user username net_password password convert Converts an image to virtual disk format for using with a virtual machine filename file name password password asz number of archive index N net_user username net_password password ftp_user username ftp_password password log file name log_net_user remote user log_net_password password target_filename file name harddisk disk number vm_type vmware esx mic...

Page 7: ... 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_files Deletes the most recent backup in the archive located in the Acronis Secure Zone filename file name password password log file name log_net_user remote user log_net_pass...

Page 8: ...TP e g vault ftp ServerA Folder1 CD DVD with the 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 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 specif...

Page 9: ...ement 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 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 The 0 value means the last backup in...

Page 10: ...at numbers of partitions in the partition option are adjusted for the MBR partition table rather than just as ascending numbers This means that primary partitions have numbers 1 1 1 2 1 3 1 4 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 rebo...

Page 11: ...ified with the prefix DYN e g partition DYN1 DYN2 Both basic partitions and dynamic volumes can be specified by their letters for example partition C Mixed notation is also acceptable for example partition 1 1 D file_partition partition letter Specifies the partition where the image file will be stored by letter or number This option is used with filename file_name In that case the file name must ...

Page 12: ...g of the backup procedure For example before net stop MSSQLSERVER after post data capture command Enables to define the command to be automatically executed after data capture at the beginning of the backup procedure For example after net start MSSQLSERVER use_vss Notifies the VSS aware applications that the backup is about to start This ensures the consistent state of all data used by the applica...

Page 13: ... at the beginning of the backup procedure For example after net start MSSQLSERVER use_vss Notifies the VSS aware applications that the backup is about to start This ensures the consistent state of all data used by the applications in particular completion of all database transactions at the moment of taking the data snapshot The data consistency in turn ensures that the application will be recover...

Page 14: ... new partition size in sectors fat16_32 Enables the file system conversion from FAT16 to FAT32 if the partition size after recovery is likely to exceed 2 GB Without this option the recovered partition will inherit the file system from the image type active primary logical Sets the restored partition active primary or logical if possible for example there cannot be more than four primary partitions...

Page 15: ...rsal Restore add on to Acronis Backup Recovery 10 ur_path path Specifies using Acronis Universal Restore and the path to the drivers storage ur_username username Specifies using Acronis Universal Restore and a user name When getting access to a place located on the remote computer the username depends on the service which is used to get access to the remote resource E g if the remote resource is a...

Page 16: ...les 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 ...

Page 17: ... 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 VaultName FTP and SFTP e g target_vault ftp ServerA Folder1 CD DVD with the path specified as a local path e g target_vault F Acronis Secure Zone e g target_vault atis asz Tapes e g target_vault atis tape 0 Unmanaged vaults are specified by their path...

Page 18: ... vm_type key to the resulting virtual disk If the image was taken from a virtual machine of the same type normally the key is not needed Drivers for the virtual machine reside in the storage defined by the registry key HKEY_LOCAL_MACHINE SOFTWARE Acronis UniversalRestore DriversPackPath In case the storage has been moved please change the key or use the command ur_path path ur_path path The same a...

Page 19: ...der 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...

Page 20: ...ay the program will first use the unallocated space If there is not enough unallocated space the selected partitions will be decreased Resizing of locked partitions requires a reboot With unallocated the zone will use all unallocated space on the disk Partitions will be moved if necessary but not resized Moving of locked partitions requires a reboot The partition option is ignored 1 1 3 13 asz_del...

Page 21: ...ill create an image of partition 2 1 named arc tib in the shared folder server1 folder trueimagecmd create partition 2 1 filename server1 folder arc tib net_user user1 net_password pw1 log server2 dir log1 log log_net_user user2 log_net_password pw2 The operation log file log1 log will be saved on another share server2 dir Credentials for both shares are provided The following command will create ...

Page 22: ...ained in the arc tib file located on the FTP server trueimagecmd deploy_mbr harddisk 1 target_harddisk 2 filename ftp server folder arc tib ftp_user fuser ftp_password fpswd 1 1 4 3 Back up files The following command will back up files from the MyProject folder residing in D Workarea except for files in the Old subfolder and hidden files to the Myproject tib file and save this file in the E Backu...

Page 23: ...ted 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 2 ftp_user user ftp_password password progress on The following command will export 2 backups pits from the archive Archive 1 located in managed vault Vault1 to the new archive Archive 2 on the netwo...

Page 24: ...e 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 space 34 409 GB ARCHIVE number 1 index 1 type file base creation time 4 2 2009 3 52 PM ARCHIVE number 2 index 1 type file base creation time 4 2 2009 4 04 PM index 2 type file incremental creation time ...

Page 25: ...three archives Archive AAA2 2 stands for the number of backups in the archive consists of full base image backup created on incremental backup created on 2 16 2009 at 3 43 4 25 2009 at 11 44 Archive FAAA F means that this is a file level archive contains one base file level backup Archive FAAB2 B means that this is the second file level archive in the zone consists of full base file level backup c...

Page 26: ... 1 1 4 14 Explore image The following command will connect all images stored in file mybackup tib on the network drive as virtual drives trueimagecmd explore filename myserver backup mybackup tib net_user john net_password qwerty 1 2 Storage node command line utility The StorageNodeCmd command line utility provides tools to view and export the archives stored in centralized managed vaults and to i...

Page 27: ...User_Name Password progress on off log Log_File_Name log_net_user User_Name log_net_password Password help Shows usage information None None 1 2 2 Options This section lists the options used by the StorageNodeCmd command line utility 1 2 2 1 arc and arc_id The arc option specifies the name of the archive for example arc My Archive If the vault contains more than one archive with this name the util...

Page 28: ...backups section in the User s Guide 1 2 2 4 log Specifies the name of the file where to save the log of the current operation for example log Server Share Exporting Log txt If you want to create the file on a network share use the log_net_user and log_net_password options to specify access credentials to it Without the log option the log is not created 1 2 2 5 log_net_password Specifies the passwo...

Page 29: ...My Storage Node MyVault 1 2 2 12 vault When used with the list command specifies the centralized managed vault whose archives or the contents of an individual archive you want to list When used with the export command specifies the centralized managed vault that contains the archive to export In either of these cases the vault has to be managed by the local storage node The vault name is given as ...

Page 30: ...age kind full date 6 27 2009 11 39 10 AM Pit number 2 type image kind incremental date 6 27 2009 11 43 13 AM Pit number 5 type image kind incremental date 6 28 2009 11 12 19 AM The pit number identifies a backup within the archive By using pit numbers you can export individual backups of an archive instead of exporting it as a whole Exporting an archive The following command exports the My Archive...

Page 31: ...r from which you want to import the archives and the managed vault where to import them to cscript exe VaultImport js source_folder C Archives target_vault bsp My Node My Vault Script options The options of the VaultExport js script are source_vault source_credentials target_vault and target_credentials The options of the VaultImport js script are source_folder source_credentials target_vault and ...

Page 32: ...correspond to their system numbers To create images of several partitions or disks use the SOURCE tag for each of them e g source letter C source letter D source disk 1 source disk 2 1 3 2 2 Target Specifies the name and the location of an image file e g target file E Mybackup2 tib username username password password username and password parameters are optional They are used to access networked r...

Page 33: ...emental image file High compression level is selected and the image will be split into 650 MB parts for recording to CD R RW media Password protection will also be added The entire script must be located between the backup and backup tags xml version 1 0 encoding utf 8 backup source letter c source letter f target file e mybackup2 tib options compression high incremental true description this is m...

Page 34: ...nses 24 clone 20 Clone 26 Command line mode and scripting in Windows 3 Common options 8 compression 0 9 10 consolidate 16 Consolidate backups 22 convert 18 Convert an image to virtual disk 23 create 11 credentials 28 D deploy 13 deploy_mbr 15 differential 10 E Examples 29 exclude_hidden 12 13 exclude_masks masks 12 13 exclude_names names 12 exclude_system 13 explore 19 Explore image 26 export 17 E...

Page 35: ...rd 9 16 17 net_src_password password 16 17 net_src_user username 16 17 net_user username 9 16 17 O Options 27 32 Options specific for Universal Restore 15 original_date on off 16 oss_numbers 10 overwrite older never always 16 P partition partition number 11 14 19 20 password 28 password 9 preserve_mbr 15 progress 28 on off 12 R raw 11 reboot 10 Restore disks and partitions 21 Restore files 22 rest...

Page 36: ...dentials 29 target_filename file name 16 18 target_folder target folder 16 target_harddisk disk number 14 15 20 target_partition partition number 14 target_vault 29 target path 17 trueimagecmd exe usage examples 21 type active primary logical 14 U unplug 20 ur 18 ur_driver inf filename 15 ur_password pwd 15 ur_path path 15 18 ur_username username 15 use_vss 12 13 V vault 29 path 8 19 vm_type vmwar...