Storage Settings

This section describes settings for backup files stored on the backup target.

Parent Tag

Parameter

Description

StorageInfo

Parent tag encapsulating information about storage settings.

 

BlockSize

Size of data blocks that Veeam Agent for Microsoft Windows uses to process data. Possible values:

  • 0 — Veeam Agent for Microsoft Windows uses data block size of 256 KB. This block size is recommended if you plan to back up data offsite over WAN.
  • 1 — Veeam Agent for Microsoft Windows uses data block size of 512 KB. This block size is recommended for onsite backup to NAS over 1 GB Ethernet.
  • 3 — Veeam Agent for Microsoft Windows uses data block size of 1024 KB. This block size is recommended for backup to SAN, DAS or local storage.
  • 5 —  Veeam Agent for Microsoft Windows uses data block size of 4 MB. This block size is recommended for backup files over 16 TB.

 

CompressionLevel

Compression level for the resulting backup file. Possible values:

  • 0 — compression is disabled.
  • 4 — dedupe-friendly compression. Recommended for deduplicating storage appliances and external WAN accelerators.
  • 5 — optimal compression. Provides the best compression to performance ratio and lowest CPU usage.
  • 6 — high compression. Provides additional 10% compression ratio over optimal, at the cost of 10x higher CPU usage.
  • 9 — extreme compression. Provides additional 3% compression ratio over high, at the cost of 2x higher CPU usage.

Encryption

Parent tag that encapsulates information about backup encryption settings.

 

Enabled

Parameter specifies if Veeam Agent for Microsoft Windows must encrypt the resulting backup file. Possible values:

  • True — backup is encrypted.
  • False — backup is not encrypted.

Key

This tag is used if you select to encrypt the resulting backup file.

Parent tag that encapsulates information about the encryption password and hint.

 

Password

This parameter is used if you select to encrypt the resulting backup file.

Password that is used to encrypt the resulting backup file. The password must be encoded in the Base64 format.

 

Hint

This parameter is used if you select to encrypt the resulting backup file.

Hint for the password used to encrypt the resulting backup file. The hint must be encoded in the Base64 format.

IMPORTANT! The Hint parameter is required.

Example

You want to use dedupe-friendly compression, and encrypt the resulting backup file with the following password:

  • Password: Password
  • Hint: Standard password

The input XML file will contain the following parameters:

<ExecutionResult>
 <JobInfo ConfigId="f5bb9cd2-9b7d-4bb3-9c72-435cec24420c" JobName="Backup Job" CryptType="10">
   <StorageInfo BlockSize="3" CompressionLevel="4">
     <Encryption Enabled="True">
       <Key Password="UGFzc3dvcmQ=" Hint="U3RhbmRhcmQgcGFzc3dvcmQ="/>
     </Encryption>
   </StorageInfo>
 </JobInfo>
</ExecutionResult>

 

Page updated 9/6/2023

Page content applies to build 6.2.0.121