Detailed instructions for use are in the User's Guide.
[. . . ] Acronis® Backup & Recovery TM 10 Advanced Server
Update 3
Command Line Reference
Table of contents
1 Command-line mode and scripting in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. 1 Agent for Windows command-line utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Supported commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Common options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] 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 FAAA (F means that this is a file-level archive) contains one base file-level backup. The next execution of the same command will delete the base FAAB backup. By continuing with the FAAA and AAA names, you can clear the Acronis Secure Zone except for the last remaining base backup that cannot be deleted.
1. 1. 4. 13
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 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 import archives to such vaults. This utility runs only on a machine where a storage node is installed, and works only with the centralized vaults managed by that storage node--called the local storage node in this section. Unlike the trueimagecmd utility, which provides similar functionality, the StorageNodeCmd utility does not require the agent to be installed on the machine.
1. 2. 1
Supported commands
The StorageNodeCmd utility has the following format:
StorageNodeCmd /command /option1 /option2 . . .
Commands may be accompanied with options.
28
Copyright © Acronis, Inc. , 2000-2010
Command list Lists the contents of a centralized managed vault or of an archive stored in it export Exports an archive (or one or more backups stored in it) from a centralized managed vault to a local or network folder
Mandatory options /vault:Managed_Vault
Other options Either /arc:Archive_Name or /arc id:Archive_UUID /password:Password /credentials:User_Name:Password
/vault:Managed_Vault
/include_pits:Backup_Numbers_List
Either /arc:Archive_Name or /arc /password:Password id:Archive_UUID /credentials:User_Name:Password /target_vault:Folder_Name /target_arc:Archive_Name /target_credentials:User_Name:Password /progress:{on|off} /log:Log_File_Name /log_net_user:User_Name /log_net_password:Password
import
/vault:Folder_Name
/password:Password
Imports an archive Either /arc:Archive_Name or /arc /credentials:User_Name:Password from a local or network id:Archive_UUID /target_credentials:User_Name:Password folder to a centralized /target_vault:Managed_Vault /progress:{on|off} managed vault /log:Log_File_Name /log_net_user:User_Name /log_net_password:Password help Shows usage information None None
1. 2. 2
1. 2. 2. 1
Options
arc and arc_id
This section lists the options used by the StorageNodeCmd command-line utility.
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 utility uses the first such archive it finds--not necessarily the oldest or newest one. When there are several archives with the same name, consider using the arc_id option instead. The arc_id option specifies the Universally Unique Identifier (UUID) of the archive--for example: /arc_id:183DE307-BC97-45CE-9AF7-60945A568BE8 To view the UUIDs of the archives stored in a managed vault, use the list command--for example:
29 Copyright © Acronis, Inc. , 2000-2010
StorageNodeCmd /list /vault:"bsp://My Storage Node/MyVault"
Specify only one of these options. If both are specified, the arc_id option is used.
1. 2. 2. 2
credentials
Specifies the user name and password to access the location (a managed vault or a folder) whose name is given by the vault option--for example: /credentials:"MyDomain\User A":"My PassWd123"
1. 2. 2. 3
include_pits
For the archive whose name is given by the arc or arc_id option, specifies the list of backups (sometimes called pits) that you want to export--for example: /include_pits:0, 4, 5 The number 0 identifies the newest backup in the archive. To view the list of backup numbers for an archive, use the list command--for example:
StorageNodeCmd /list /arc:"My Archive" /vault:"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
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 password for the user whose name is given by the log_net_user option--for example: /log_net_password:"My PassWd123"
1. 2. 2. 6
log_net_user
Specifies access credentials to the file whose name is given by log--for example: /log_net_user:"User A"
1. 2. 2. 7
password
Specifies the password for a password-protected archive whose name is given by arc or arc_id--for example: /password:"My PassWd123" This option is ignored if the archive is not password-protected.
30
Copyright © Acronis, Inc. , 2000-2010
1. 2. 2. 8
progress
Specifies whether to show (/progress:on) or hide (/progress:off) the progress of an exporting or importing operation. Without this option, the progress is shown.
1. 2. 2. 9
target_arc
Specifies the name of the exported archive--for example: /target_arc:"Exported Archive" Without this option, the exported archive will have the same name as the original archive.
1. 2. 2. 10
target_credentials
Specifies the user name and password to access the location (a managed vault or a folder) whose name is given by the target_vault option--for example: /target_credentials:"MyDomain\User A":"My PassWd123"
1. 2. 2. 11
target_vault
When used with the export command, specifies the local or network folder where you want to export the archive--for example: /target_vault:\\Server\Share When used with the import command, specifies the centralized managed vault where you want to place the imported archive. The vault name is given as a Uniform Resource Identifier (URI)--for example: /target_vault:"bsp://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 a Uniform Resource Identifier (URI)--for example: /vault:"bsp://My Storage Node/MyVault" When used with the import command, specifies the local or network folder that contains the archive to import--for example: /vault:\\Server\Share
1. 2. 3
Examples
These examples assume the following: You are running the StorageNodeCmd utility on a machine where a storage node is installed. The storage node manages a centralized vault whose name is My Vault.
31
Copyright © Acronis, Inc. , 2000-2010
Listing the vault's archives
The following command shows the list of archives that are stored in the vault.
StorageNodeCmd /list /vault:"bsp://My Node/My Vault"
The output will look similar to this:
Archive name: My Archive type: image; owner: domain/sample_user; machine: sample-comp; date: 6/27/2009 11:39:10 AM; used_space: 1000000000; id: 183DE307-BC97-45CE-9AF7-60945A568BE8 Archive name: My new Archive type: file; owner: domain/sample_user; machine: sample-comp; date: 6/27/2009 11:50:10 AM; used_space: 2000000000; id: 283DE307-BC97-45CE-9AF7-60945A568BE8 Archive name: The last Archive type: image; owner: domain/sample_user; machine: sample-comp; date: 6/29/2009 11:20:10 AM; used_space: 3000000000; id: 383DE307-BC97-45CE-9AF7-60945A568BE8
Listing the backups of an archive
The following command shows the list of backups that are contained in the My Archive archive. The archive 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-9AF7-60945A568BE8
The output will look similar to this:
Pit number: 1 type: image; 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 archive to the C:\Archives folder.
StorageNodeCmd /export /vault:"bsp://My Node/My Vault" /arc:"My Archive" /target_vault:"C:\Archives"
Exporting the newest backup of an archive
The following command exports the newest backup of the My Archive archive. Such backup is identified by the pit number 0 in addition to its own pit number. The exported backup is saved in the C:\Archives folder in the Exported Archive archive.
32 Copyright © Acronis, Inc. , 2000-2010
StorageNodeCmd /export /vault:"bsp://My Node/My Vault" /arc:"My Archive" /include_pits:0 /target_vault:"C:\Archives" /target_arc:"Exported Archive"
Importing an archive
The following command imports the Archive 1 archive from the C:\Archives folder to the vault.
StorageNodeCmd /import /vault:"C:\Archives" /arc:"Archive 1" /target_vault:"bsp://My Node/My Vault"
1. 2. 4
Exporting vaults and importing multiple archives
To export all archives stored in a managed vault or to import all archives from a folder to a managed vault, you can use the scripts that are provided with Acronis Backup & Recovery 10 Storage Node. The scripts are located in the folder where the storage node is installed--by default, C:\Program Files\Acronis\StorageNode. [. . . ] The program implements the user level part of the user mode block device service of Acronis Backup & Recovery 10. The majority of the functionality is handled by the snumbd kernel module. SYNOPSIS
trueimagemnt [-h|--help] [-l|--list] [-m|--mount mountpoint] [-u|--umount mountpoint] [-s|--stop pid] [-o|--loop] [-f|--filename archive filename] [-p|-password password] [-t|--fstype filesystem type] [-i|--index partition index] [-w|--read-write] [-d|--description archive description] [-k|--keepdev]
2. 3. 1
-h|--help
Supported commands
trueimagemnt supports the following commands:
Shows usage.
52 Copyright © Acronis, Inc. , 2000-2010
-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. [. . . ]