Windows operating systemsLinux operating systems

Vmmaxparallel

The vmmaxparallel option is used to configure optimized backups of several virtual machines by using a single instance of the backup-archive client. This option specifies the maximum number of virtual machines that can be backed up to the IBM Spectrum Protect server at any one time.

An optimized backup operation is one in which parallel backup capability is enabled at the VM, virtual disk, or subdisk level.

The vmmaxparallel option works with the vmmaxbackupsessions, vmlimitperhost, and vmlimitperdatastore options to optimize backup operations and to help control the amount of resources that the backup can create on a host in the vSphere infrastructure. Adjust the values of these options to find the values that provide optimal performance for the backups that are in your environment.

Data moverThis feature is available only if the client operates as a data mover for IBM Spectrum Protect for Virtual Environments.

Supported clients

Linux operating systemsThis option can be used with supported x86_64 Linux clients.

Windows operating systemsThis option can be used with supported Windows clients.

Options file

Linux operating systemsThis option is valid in the client system options file (dsm.sys) or on the command line for the Backup VM command. It can also be included on the server in a client options set. It cannot be set in the Preferences Editor.

Windows operating systemsThis option is valid in the client options file (dsm.opt) or on the command line for the Backup VM command. It can also be included on the server in a client options set. It cannot be set in the Preferences Editor.

Syntax

Read syntax diagramSkip visual syntax diagram VMMAXParallel 4integer

Parameters

integer
Specifies the maximum number of virtual machines that can be backed up at any one time during an optimized backup operation.
The default is 4. The maximum is 50.
Tip: When you use client-side data deduplication, a data deduplication session is started for each VM. This data deduplication session is not counted as one of the vmmaxparallel sessions.
Review the following information for using the vmmaxparallel option in conjunction with the vmmaxbackupsessions option or the maxnummp server parameter:
vmmaxbackupsessions
For Data Protection for VMware, the vmmaxbackupsessions specifies the maximum number of sessions that move virtual machine data to the server that can be included in an optimized backup operation. The value of the vmmaxbackupsessions option must be equal to or greater than the value of the vmmaxparallel option.
maxnummp
The maxnummp server parameter specifies the maximum number of mount points a node is allowed to use on the server when the copy destination of the storage pool is FILE or TAPE. The maxnummp parameter must be equal to or greater than the vmmaxparallel and vmmaxbackupsessions option settings. When multiple instances of the client are backing up files, or when a single client performs parallel backup operations, more mount points might be required.
If the values for vmmaxparallel or vmmaxbackupsessions exceed the value for maxnummp, ANS0266I and other messages are displayed. Depending on the message, the client reduces the value of the vmmaxparallel option to match the number that is specified by maxnummp parameter or prohibits additional sessions from being opened for the specified VM. In either situation, the backup operation continues.
If additional ANS0266I errors are detected, the client reduces the vmmaxparallel value by 1 and attempts to continue the backup. If vmmaxparallel is decremented to 1 and the client receives more ANS0266I errors, the client ends the backup and issues the following error:
ANS5228E A backup VM operation failed because VMMAXPARALLEL was reduced to 1 and the client still cannot obtain a server mount point.
Contact your server administrator if you want the value that is currently set for maxnummp increased so that a node can support additional parallel backup sessions.

Examples

Options file
VMMAXP 10
Windows operating systemsCommand line:
Windows operating systems dsmc backup vm -VMMAXP=10