Vmmaxrestoreparallelvms

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


                               .-2-----------.   
>>-VMMAXRESTOREPARALLELVms-- --+-+---------+-+-----------------><
                                 '-integer-'

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 Spectrum 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 Spectrum 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