The vmmaxrestoreparallelvms option controls the number of
virtual machines (VMs) that can be restored at the same time.
Use this option to help improve the performance of restore operations by increasing the number of
VMs to restore in parallel.
You can specify the number of VMs to be restored simultaneously, up to a maximum of 10. The
default value is 2.
Supported clients
This option can be used with supported Windows clients.
Options file
This option is valid in the data mover options file (dsm.opt) or on the
command line for the restore vm command. It can also be included on the server in
a client option set.
Syntax
Parameters
integer
Specifies the maximum number of VMs that can be restored simultaneously. The default is 2. The
maximum is 10.
If you are using the vmmaxrestoresessions option to limit the
number of restore sessions, the number of sessions must be greater than or equal to the number of
VMs. This setting ensures that at least one session is available per VM.
If you are using
the vmmaxparalleldisks option to restore multiple virtual disks at the same time,
the number of virtual disks must be less than or equal to the number of sessions.
Examples
Task
Set a maximum of five simultaneous restore operations for VMs VM1, VM2, VM3, VM4, and
VM5:
dsmc restore vm vm=VM1,VM2,VM3,VM4,VM5 -VMMAXRESTOREPARALLELVms=5
-VMMAXRESTORESessions=10 -VMMAXRESTOREPARALLELDisks=2
-asnode=kingston23_HV_TGT -optfile=dsm.KINGSTON23_HV_DM.opt -replace=yes
This command assigns up to 5 VM restore operations in parallel, and each VM can restore up to
one virtual disk in parallel per VM at a time and assign 2 restore sessions per disk.
Command output:
IBM Storage Protect
Command Line Backup-Archive Client Interface
Client Version 8, Release 1, Level 7.4
Client date/time: 10/05/2018 15:01:01
(c) Copyright by IBM Corporation and other(s) 1990, 2019. All Rights
Reserved.
Node Name: KINGSTON23_HV_DM
Session established with server ASANA2: Linux/x86_64
Server Version 7, Release 1, Level 9.000
Server date/time: 10/05/2018 14:59:09 Last access: 10/05/2018 14:58:18
Accessing as node: KINGSTON23_HV_TGT
Restore function invoked.
Restore VM command started. Total number of virtual machines to process: 5
Restore of Virtual Machine 'VM1' started
Restore of Virtual Machine 'VM2' started
Restore of Virtual Machine 'VM3' started
Restore of Virtual Machine 'VM4' started
Restore of Virtual Machine 'VM5' started
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM1' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM1'
Restoring virtual disks for virtual machine 'VM1'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 2
Using 2 session(s) to restore virtual machine 'VM1' Disk 1 .
Restoring 'VM1' Hard Disk 1
Type : IFINCR
Timestamp : 10/05/2018 14:59:23
Bytes to restore : 1,073,741,824
< 670.25 MB> [ - ]
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM2' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM2'
Restoring 1,073,741,824 'VM1' e:\Hyper-V\VM1\VM1\Virtual Machines\1G.vhdx
[Done]
Restoring virtual disks for virtual machine 'VM2'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 2
Using 2 session(s) to restore virtual machine 'VM2' Disk 1 .
Restoring 'VM2' Hard Disk 1
Type : IFFULL
Timestamp : 10/05/2018 14:59:24
Bytes to restore : 1,073,741,824
Restoring 0 VM1 [Done]
< 1.69 GB> [ -]
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM3' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM3'
Successful Full VM restore of Virtual Machine 'VM1'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM1' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM4' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring 1,073,741,824 'VM2' e:\Hyper-V\VM2\Virtual Hard Disks\1G.vhdx
[Done]
Restoring VM configuration information for 'VM4'
Restoring virtual disks for virtual machine 'VM3'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 2
Using 2 session(s) to restore virtual machine 'VM3' Disk 1 .
Restoring 'VM3' Hard Disk 1
Type : IFFULL
Timestamp : 10/05/2018 14:59:27
Bytes to restore : 1,073,741,824
Restoring virtual disks for virtual machine 'VM4'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 2
Restoring 0 VM2 [Done]
Using 2 session(s) to restore virtual machine 'VM4' Disk 1 .
Restoring 'VM4' Hard Disk 1
Type : IFFULL
Timestamp : 10/05/2018 14:59:32
Bytes to restore : 1,073,741,824
Successful Full VM restore of Virtual Machine 'VM2'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM2' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM5' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM5'
Restoring 1,073,741,824 'VM3' e:\Hyper-V\VM3\Virtual Hard Disks\1G.vhdx
[Done]
Restoring virtual disks for virtual machine 'VM5'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 2
Using 2 session(s) to restore virtual machine 'VM5' Disk 1 .
Restoring 'VM5' Hard Disk 1
Type : IFFULL
Timestamp : 10/05/2018 14:59:51
Bytes to restore : 1,073,741,824
Restoring 1,073,741,824 'VM4' e:\Hyper-V\VM4\Virtual Hard Disks\1G.vhdx
[Done]
Restoring 0 VM3 [Done]
Restoring 0 VM4 [Done]
Successful Full VM restore of Virtual Machine 'VM3'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM3' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Successful Full VM restore of Virtual Machine 'VM4'
Restore processing finished.
Restoring 1,073,741,824 'VM5' e:\Hyper-V\VM5\Virtual Hard Disks\1G.vhdx
[Done]
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM4' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring 0 VM5 [Done]
Successful Full VM restore of Virtual Machine 'VM5'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM5' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Total number of objects restored: 5
Total number of objects failed: 0
Total number of bytes transferred: 5.00 GB
Data transfer time: 66.95 sec
Network data transfer rate: 78,307.54 KB/sec
Aggregate data transfer rate: 72,000.19 KB/sec
Elapsed processing time: 00:01:12
Task
Set a maximum of 2 simultaneous VM restore operations for VMs VM1 and
VM2:
dsmc restore vm vm=VM1,VM2 -VMMAXRESTOREPARALLELVms=2
-VMMAXRESTORESessions=10 -VMMAXRESTOREPARALLELDisks=1
-asnode=kingston23_HV_TGT -optfile=dsm.KINGSTON23_HV_DM.opt
-replace=yes
This command assigns two simultaneous VM restore operations with 4 sessions per disk per VM,
assuming that the VM contains only one disk.
Tip: If you set
-VMMAXRESTORESessions=50, there will still be only 4 sessions per disk, as there is
only one disk in the VM.
Command output:
IBM Storage Protect
Command Line Backup-Archive Client Interface
Client Version 8, Release 1, Level 7.4
Client date/time: 10/05/2018 15:21:36
(c) Copyright by IBM Corporation and other(s) 1990, 2019. All Rights
Reserved.
Node Name: KINGSTON23_HV_DM
Session established with server ASANA2: Linux/x86_64
Server Version 7, Release 1, Level 9.000
Server date/time: 10/05/2018 15:19:44 Last access: 10/05/2018 15:00:10
Accessing as node: KINGSTON23_HV_TGT
Restore function invoked.
Restore VM command started. Total number of virtual machines to process: 2
Restore of Virtual Machine 'VM1' started
Restore of Virtual Machine 'VM2' started
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM1' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM1'
Restoring virtual disks for virtual machine 'VM1'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 4
Using 4 session(s) to restore virtual machine 'VM1' Disk 1 .
Restoring 'VM1' Hard Disk 1
Type : IFINCR
Timestamp : 10/05/2018 14:59:23
Bytes to restore : 1,073,741,824
< 909.25 MB> [ - ]
Starting Full VM restore of 'Hyper-V' Virtual Machine 'VM2' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring VM configuration information for 'VM2'
Restoring 1,073,741,824 'VM1' e:\Hyper-V\VM1\VM1\Virtual Machines\1G.vhdx
[Done]
Restoring virtual disks for virtual machine 'VM2'
Total disks to restore : 1
Disks to restore concurrently : 1
Maximum Sessions per disk : 4
Using 4 session(s) to restore virtual machine 'VM2' Disk 1 .
Restoring 'VM2' Hard Disk 1
Type : IFFULL
Timestamp : 10/05/2018 14:59:24
Bytes to restore : 1,073,741,824
Restoring 0 VM1 [Done]
Successful Full VM restore of Virtual Machine 'VM1'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM1' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Restoring 1,073,741,824 'VM2' e:\Hyper-V\VM2\Virtual Hard Disks\1G.vhdx
[Done]
Restoring 0 VM2 [Done]
Successful Full VM restore of Virtual Machine 'VM2'
Restore processing finished.
Successful Full VM restore of 'Hyper-V' Virtual Machine 'VM2' target node
name='KINGSTON23_HV_TGT', data mover node name='KINGSTON23_HV_DM'
Total number of objects restored: 2
Total number of objects failed: 0
Total number of bytes transferred: 2.00 GB
Data transfer time: 30.08 sec
Network data transfer rate: 69,703.69 KB/sec
Aggregate data transfer rate: 45,697.11 KB/sec
Elapsed processing time: 00:00:45
