Rapid Recovery 6.1.3

The startexport command forces a one-time export of data from a protected machine to a virtual server. You can export to an ESXi, VMware Workstation, Hyper-V, or VirtualBox virtual machine. If exporting to ESXi, you must specify thick or thin disk provisioning.

Usage

The usage for the command is as follows:

/startexport -exporttype [esxi | vm | hyperv | vb] -core [host name] -user [user name] -password [password] -protectedserver [name | IP address] -volumes [volume names] -rpn [recovery point number | numbers] | -time [time string] -vmname [virtual machine name] -hostname [virtual host name] -hostport [virtual hostport number] -hostusername [virtual host user name] -hostpassword [virtual host password] [-ram [total megabytes] | -usesourceram] -diskprovisioning [thin | thick] -diskmapping [automatic | manual | withvm] -targetpath [location] -pathusername [user name] -pathpassword [password] [-uselocalmachine]

Command Options

The following table describes the options available for the startexport command:

Table 224. StartExport command options

Option

Description

Display this help message.

-exporttype

Perform export of data from protected server to an ESXi server ('esxi'), VMware Workstation server ('vm'), Hyper-V server ('hyperv'), or VirtualBox server ('vb').

-core

Optional. Remote Core host machine IP address (with an optional port number). By default, the connection is made to the Core installed on the local machine.

-user

Optional. User name for the remote Core host machine. If you specify a user name, you must also provide a password. If none is provided, then the credentials for the logged-on user are used.

-password

Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a user name. If none is provided, then the credentials for the logged-on user are used.

-protectedserver

Protected machine with recovery points to be exported.

-volumes

Optional. List of volume names to be exported. If not specified, all volumes will be exported. Values must be enclosed in double quotes and separated with spaces; for example: “c:” “d:”. Do not use trailing slashes in volume names.

-rpn

Optional. The sequential number of a recovery point to be exported (use Get-RecoveryPoints command to get the numbers). If neither the ‘time’ nor the ‘rpn’ option is specified, then the most recent recovery point is exported.

-time

Optional. Determines the recovery point or points to be selected for export. You need to specify the exact time in the format "mm/dd/yyyy hh:mm tt" (for example, "2/24/2012 09:00 AM"). Be sure to specify the date time values of the time zone set on your PC. Note: if neither the 'time' nor the 'rpn' option is specified, then the most recent recovery point is exported.

-vmname

The Windows name of the virtual machine.

-hostname

For ESXi and Hyper-V virtual exports only. The virtual server host name.

-linuxhostname

For VirtualBox exports only. The virtual server host name.

-hostport

For ESXi and Hyper-V virtual exports only. The virtual server port number.

-hostusername

For ESXi and Hyper-V virtual exports only. The user name for the virtual server host.

-hostpassword

For ESXi and Hyper-V virtual exports only. The password for the virtual server host.

-ram

Use this option to allocate a specific amount of RAM on the virtual server.

-usesourceram

Optional. Use this option to allocate the same amount of RAM on the virtual server that the source machine contains.

-diskprovisioning

Use this option for ESXi exports only. Optional. The amount of disk space that you want to allocate on the virtual machine. Use one of the two following specifications:

•

Thick - This specification makes the virtual disk as large as the original drive on the protected machine.

•

Thin - This specification allocates the amount of actual disk space occupied on the original drive with a few additional megabytes.

The default specification is "thin."

-diskmapping

Use this option for ESXi exports only. Optional. This option determines how to map the disks from the protected machine to the virtual machine. Use one of the following values:

•

auto - This value automatically maps the disks.

•

manual - This value lets you map the disks manually.

•

withvm - This value stores the virtual disks in a datastore that you select.

The default value is "auto."

-targetpath

For VMware Workstation and VirtualBox exports only. This option specifies the local or network path—or Linux path, for VirtualBox only—to the folder where you want to store the virtual machine files

-pathusername

For VMware Workstation exports only. It is the user name for the network machine. It is only required when you specify a network path in the -targetpath option.

-pathpassword

For VMware Workstation exports only. It is the password for the network machine. It is only required when you specify a network path in the -targetpath option.

-uselocalmachine

For Hyper-V exports only. Optional. Use this command to connect to the local Hyper-V server. This option ignores the -hostname, -hostport, -hostusername, and -hostpassword options.

Examples:

Export data to an ESXi virtual machine with a specific name and the same amount of RAM and disk size as the source protected server:

>cmdutil /startexport -exporttype esxi -core 10.10.10.10 -user administrator -password 23WE@#$sdd -protectedserver 10.10.5.22 -vmname Win2008-Smith -hostname 10.10.10.23 -hostport 443 -hostusername root -hostpassword 12QWsdxc@# -usesourceram -diskprovisioning thick

Create a VMware Workstation machine file on the local drive with protected data from recovery point #4:

>cmdutil /startexport -exporttype vmstation -core 10.10.10.10 -user administrator -password 23WE@#$sdd -protectedserver 10.10.5.22 -rpn 4 -vmname Win2008-Smith -targetpath c:\virtualmachines -ram 4096

Create a Hyper-V machine files to be stored on a remote machine:

>cmdutil /startexport -exporttype hyperv -core 10.10.10.10 -user administrator -password 23WE@#$sdd -protectedserver 10.10.5.22 -vmlocation \\WIN7-Bobby\virtualmachines -hostname 10.10.10.23 -hostport 443 -hostusername root -hostpassword 12QWsdxc@# -ram 4096

UpdateRepository

The updaterepository command adds a new storage location to an existing DVM repository.

Usage

The usage for the command is as follows:

/updaterepository -name [repository name] -size [size of the repository] [-datapath [data path] -metadatapath [metadata path] | [-uncpath [UNC path] -shareusername [share user name] -sharepassword [share password] -core [host name] -user [user name] -password [password]

Command Options

The following table describes the options available for the updaterepository command:

Table 225. UpdateRepository command options
Option	Description
-?	Display this help message.
-name	Repository name.
-size	Size of repository storage location. Available units are b, Kb, Mb, Gb, Tb, and Pb.
-datapath	For local location only. Determines data path of repository storage location.
-metadatapath	For local location only. Determines metadata path of repository storage location.
-uncpath	For share location only. Determines data and metadata paths of repository storage location.
-shareusername	For share location only. Determines user name to share location.
-sharepassword	For share location only. Determines password to share location.
-core	Optional. Remote Core host machine IP address (with an optional port number). By default, the connection is made to the Core installed on the local machine.
-user	Optional. User name for the remote Core host machine. If you specify a user name, you must also provide a password. If none is provided, then the credentials for the logged-on user are used.
-password	Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a user name. If none is provided, then the credentials for the logged-on user are used.

Examples:

Create a new storage location in a local DVM repository:

>cmdutil /updaterepository -name “Repository 1” -size 200Gb -datapath d:\repository -metadatapath d:\repository -core 10.10.10.10:8006 -username administrator -password 23WE@#$sdd

Create a storage location for a DVM repository at a shared location:

>cmdutil /updaterepository -name “Repository 1” -size 200Gb -uncpath \\share\repository -shareusername login -sharepassword 23WE@#$sdd -core 10.10.10.10:8006 -username administrator -password 23WE@#$sdd

Version

The version command displays information about the version of the Rapid Recovery software installed on the specified server. If you do not specify a core or protected server, the information returned applies to the Core on which you are currently working.

Usage

The usage for the command is as follows:

/[version | ver] -protectedserver [name | IP address]

Command Options

The following table describes the options available for the version command:

Table 226. Version command options
Option	Description
-?	Display this help message.
-core	Optional. Remote Core host machine IP address (with an optional port number). By default, the connection is made to the Core installed on the local machine.
-user	Optional. User name for the remote Core host machine. If you specify a user name, you must also provide a password. If none is provided, then the credentials for the logged-on user are used.
-password	Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a user name. If none is provided, then the credentials for the logged-on user are used.
-protectedserver	Optional. The protected machine for which you want to view version information. If you do not specify a protect machine, the return is information about the Core machine on which you are working.