Veeam Backup 12 Agent Management Guide
Veeam Backup 12 Agent Management Guide
Version 12
Veeam Agent Management Guide
November, 2024
© 2024 Veeam Software.
All rights reserved. All trademarks are the property of their respective owners.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or
translated into any language in any form by any means, without written permission from Veeam Software
(Veeam). The information contained in this document represents the current view of Veeam on the issue
discussed as of the date of publication and is subject to change without notice. Veeam shall not be liable for
technical or editorial errors or omissions contained herein. Veeam makes no warranties, express or implied, in
this document. Veeam may have patents, patent applications, trademark, copyright, or other intelle ctual
property rights covering the subject matter of this document. All other trademarks mentioned herein are the
property of their respective owners. Except as expressly provided in any written license agreement from Veeam,
the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other
intellectual property.
NOTE
Read the End User Software License Agreement before using the accompanying software programs. Using
any part of the software indicates that you accept the terms of the End User Software License Agreement.
Customer Support
Should you have a technical concern, suggestion or question, visit the Veeam Customer Support Portal to open a
case, search our knowledge base, reference documentation, manage your license or obtain the latest product
release.
Company Contacts
For the most up-to-date information about company contacts and office locations, visit the Veeam Contacts
Webpage.
Online Support
If you have any questions about Veeam products, you can use the following resources:
Intended Audience
The guide is designed for anyone who wants to use Veeam Backup & Replication to automate data protection
tasks performed on Veeam Agent computers. It is primarily aimed at backup administrators and other IT
professionals managing Veeam Backup & Replication but can also be helpful for Veeam Agent computer users.
The document assumes that you are familiar with basic concepts and operations that can be performed in Veeam
Backup & Replication and Veeam Agents you need.
Related Documentation
The document should be regarded as a supplement to existing technical documentation for the following
products:
You do not need to install, set up and operate Veeam Agent on every computer whose data you want to protect.
Instead, you can perform the whole set of deployment, administration, data protection and disaster recovery
tasks on Veeam Agent computers remotely from the Veeam Backup & Replication console.
Veeam Backup & Replication offers the following Veeam Agent management capabilities:
• Automated deployment and management of Veeam Agents. You can set up Veeam Backup & Replication
to automatically discover computers that you want to protect with Veeam Agent for Microsoft Windows
and Veeam Agent for Linux and Unix machines that you want to protect with Veeam Agent for Oracle
Solaris and Veeam Agent for IBM AIX. You can also manually deploy all supported Veeam Agents on
computers you want to protect. Once Veeam Agent is deployed on protected computers, you can use the
Veeam Backup & Replication console to manage Veeam Agents on multiple computers.
• Centralized configuration a nd management of Veeam Agent backup jobs on protected computers. You can
use the Veeam Backup & Replication console to create and manage Veeam Agent backup jobs on
computers in your infrastructure whose data you want to protect.
• Centralized management of backups created by Veeam Agent backup jobs. If you choose to create Veeam
Agent backups on a backup repository managed by the Veeam backup server, you can use the Veeam
Backup & Replication console to restore data from these backups.
• Distribution server
• Distribution repository
To learn more, see the Deployment section in the Veeam Backup & Replication User Guide.
Veeam Backup & Replication lets you manage Veeam Agent on computers of the following types:
• Workstations, servers, failover clusters, and cloud machines running a Microsoft Windows OS
If you want to manage Veeam Agents installed on protected computers in Veeam Backup & Replication, you
must set Veeam Agents in the managed mode. In this mode, all data protection and administration tasks are
performed by a backup administrator in Veeam Backup & Replication. In some scenarios, a user can also perform
a limited set of backup and disaster recovery tasks directly on a protected computer.
• Veeam Agents deployed on remote computers and cloud machines by Veeam Backup & Replication
automatically
Veeam Agents Deployed on Remote Computers and Cloud Machines by Veeam Backup
& Replication Automatically
Veeam Backup & Replication can automatically discover computers added to the inventory and deploy Veeam
Agents on these computers. Veeam Agent for Mac can be deployed manually only. To learn more about
automatic deployment of Veeam Agents, see Protected Computers Discovery and Veeam Agent Deployment.
• On Microsoft Windows computers, Veeam Backup & Replication deploys Veeam Installer Service. Veeam
Installer Service, in turn, deploys Veeam Transport Service that performs the necessary operations on the
computer.
• On Linux computers, Veeam Backup & Replication connects to the Linux computer using SSH credentia ls
and installs Veeam Deployer Service. After that, Veeam Deployer Service installs Veeam Transport Service
that performs necessary operations on the computer.
NOTE
You can manually pre-install Veeam Deployer Service on a Linux computer. In this case, Veeam
Backup & Replication will make the initial connection to the Linux computer using a single -use
certificate. For more information on this deployment option, see Deploying Veeam Agent for Linux
Using Pre-Installed Veeam Deployer Service.
Keep in mind that Veeam Backup & Replication requires an SSH connection with the Linux computer in the
following cases:
o To communicate with the Linux computer for the first time if you use credentials to connect to the
Linux computer. To learn more, see Specifying Computers.
After Veeam Backup & Replication computer is discovered and Veeam Agent is deployed, Veeam
Backup & Replication uses Veeam Deployer and Transport Services to connect to the Veeam Agent
computer instead of the SSH connection.
o To communicate with the Linux computer after Veeam Deployer and Transport Services failed to
establish a connection. In this case Veeam Backup & Replication fails over to the SSH connection.
o To communicate with the Linux computer running a 32-bit OS. Veeam Backup & Replication does not
deploy Veeam Deployer Service on Linux computers with 32-bit OSes as a connection with Veeam
Deployer Service is not supported for these OSes.
To establish the SSH connection, the Linux computer must be added to the list of trusted hosts. To learn
more, see Configuring Security Settings.
• On Unix computers, Veeam Backup & Replication connects to the Unix computer using SSH credentials and
deploys Veeam Installer Service. After that, Veeam Installer Service installs Veeam Agent packages on the
machine. The same rules for failover to SSH on Linux computers apply to Unix computers.
Distribution Server
The distribution server is an architecture component in the Veeam Agent management infrastructure used for
automated deployment of Veeam Agent setup files to protected computers. When you instruct Veeam Backup &
Replication to install Veeam Agent on a protected computer, the Veeam backup server communicates to the
distribution server, and Veeam Backup & Replication uploads Veeam Agent setup file from the distribution
server to the target computer.
By default, the role of the distribution server is assigned to the backup server itself. However, you can deploy a
dedicated distribution server to reduce workload on the backup server. To deploy a distribution server, you need
to add a Windows-based server to Veeam Backup & Replication. To learn more, see the Adding Microsoft
Windows Servers section in the Veeam Backup & Replication User Guide. After you assigned the role of
distribution server, you need to select this server in the properties of a protection group. To learn more, see
Step 4. Specify Discovery and Deployment Options.
A machine performing the role of the distribution server must meet the following requirements:
• The role of the distribution server can be assigned to a physical or virtual machine.
• You must add the machine to the Veeam Backup & Replication console as a managed server.
TIP
To learn how to use protection groups to automatically deploy Veeam plug -ins for enterprise
applications, see the Veeam Plug-ins for Enterprise Applications Guide.
Keep in mind that Veeam Backup & Replication does not support automated deployment of Veeam Agent for
Mac and nosnap Veeam Agent for Linux (including Veeam Agent for Linux on Power). You must deploy Veeam
Agent for Mac on protected computers using setup files generated by Veeam Backup & Replication. To learn
more, see Deploying Veeam Agents Using Generated Setup Files.
If you have several Microsoft Windows and Linux computers and Unix machines with Veeam Agent
installations managed by Veeam Backup & Replication, you can centrally deploy a hotfix on all managed
Veeam Agent computers. To learn more, see Deploying Hotfix on Protected Computers.
Distribution Repository
The distribution repository is an architecture component in the Veeam Agent management infrastructure used
for automated deployment of Veeam Agent setup files to cloud machines. W hen you instruct Veeam Backup &
Replication to deploy Veeam Agent on a cloud machine, the Veeam backup server communicates to the
distribution repository, and Veeam Backup & Replication uploads Veeam Agent setup file from the distribution
repository to the target cloud machine using signed URLs. To learn how Veeam Backup & Replication
communicates with Veeam Agents installed on cloud machines, see Backup of Cloud Machines.
The role of the distribution repository must be assigned to a dedicated object storage repository. To do this, you
need to add a Microsoft Azure blob storage or Amazon S3 storage to your infrastructure depending on the type
of cloud machines you plan to protect. To learn more, see the Adding Azure Blob Storage or Adding Amazon S3
Storage sections in the Veeam Backup & Replication User Guide.
• You can store backups of cloud machines only in the object repository located on the same external cloud
storage as the cloud machines you want to back up.
• [For Azure Blob Storage] If you plan to use the Azure Blob Storage repository as a distribution repository,
you must add this repository using a general-purpose v2 storage account. Other account types are not
supported.
• [For Azure Blob Storage] You cannot add a repository using the Microsoft Entra ID account.
• [For Amazon S3 Storage] If you plan to use the Amazon S3 repository in the China region as a distribution
repository, make sure that you have the ICP license. This license is required to create signed URLs for
Amazon S3 repositories in the China region. For more information, see AWS Documentation.
To deploy Veeam Agents, Veeam Backup & Replication needs to discover computers whose data you want to
back up. To enable discovery, you organize your computers into one or more protection groups. Protection
group settings define what Veeam Agent computers Veeam Backup & Replication will discover and how the
discovery process will run. To learn more, see Protection Groups.
You can also disable automated Veeam Agent installation when configuring a protection group. In this case, you
will need to use the Veeam Backup & Replication console to install Veeam Agent on every computer included in
the protection group. To learn more, see Installing Veeam Agent.
To deploy Veeam Agents using external tools, you need to perform the following operations:
1. Create a protection group for pre-installed Veeam Agents using Veeam Backup & Replication. To learn
more about this type of protection groups, see Protection Group Types.
After a new protection group is created, Veeam Backup & Replication generates a set of setup files
required for the Veeam Agent deployment. This set of setup files includes an XML configuration fil e with a
TLS certificate. This certificate is used to secure the first communication between Veeam Backup &
Replication and Veeam Agents. It helps Veeam Agents identify themselves and make sure that computers
connecting to the Veeam backup server are really the ones that they claim to be.
To learn how to check information about the currently used certificate, see Configuring Security Settings.
IMP ORTANT
Veeam Backup & Replication generates the same TLS certificate for the first communication between
Veeam Backup & Replication and all computers you want to include in protection groups for pre -
installed Veeam Agents. So, it is strongly recommended that you securely store and share Veeam
Agent setup files. Otherwise, any computer that has this certificate can connect to the Veeam
backup server.
Once you connect Veeam Agent to the Veeam backup server, Veeam Backup & Replication discoveries the
computer and replaces the TLS certificate for all Veeam Agent computers with another TLS certificate that
is unique for each computer. After that, you can find the connected computer in the Veeam Backup &
Replication console displayed as a member of the protection group.
To start managing Veeam Agents in Veeam Backup & Replication, you need to create a protection group in the
inventory and specify computers that you want to protect with Veeam Agents in the protection group settings.
You can create one or more protection groups depending on the size and complexity of your infrastructure.
Protection groups appear under the P hy sical Infrastructure node in the Inventory view of the Veeam Backup &
Replication console.
NOTE
• The P hy sical Infrastructure node is not available if the Veeam Cloud Connect service provider license
is installed on the backup server.
• If you want to manage only a small number of Veeam Agent computers in Veeam Backup &
Replication and do not want to create protection groups, you can add the necessary computers
directly to a Veeam Agent backup job. Veeam Backup & Replication will automatically include such
computers to the Manually Added protection group. To learn more, see Predefined Protection
Groups.
Protection groups allow you to automate deployment and management of Veeam Agents on computers in your
infrastructure. When you configure a protection group, you can specify scheduling options for protected
computers discovery and Veeam Agent deployment. You do not need to perform administrative tasks
individually for every computer that you want to protect with Veeam Agent — Veeam Backup & Replication will
perform the specified operations automatically upon the defined schedule.
Veeam Backup & Replication connects to discovered computers using a connection method specified in the
protection group settings. If you use credentials to connect to discovered computers, you can specify a master
account that Veeam Backup & Replication will use to connect to all computers added to the protection group or
specify separate accounts to connect to specific computers in the protection group.
After you create a protection group, Veeam Backup & Replication starts the rescan job session to connect to
computers added to the protection group and perform the required operations on these computers. To learn
more, see Rescan Job.
IMP ORTANT
Keep in mind that protection groups for pre-installed Veeam Agents do not allow you to perform
deployment and management tasks. To learn more about protection groups for pre -installed Veeam
Agents, see Protection Group Types.
You can organize individual computers into a protection group by specifying the necessary computers in
the protection group settings. This option is recommended for smaller environments that do not have
Microsoft Active Directory deployed. Veeam Backup & Replication connects to discovered computers with
credentials or a single-use certificate.
You can create protection groups that include one or more Microsoft Active Directory objects: entire
domain, container, organizational unit, group, computer, or failover cluster. This allows you to manage
Veeam Agents on computers being part of an Active Directory domain. Protection groups that include
Active Directory domain, containers, groups or organizational units are dynamic in their nature. For
example, if a new computer is added to a container, Veeam Backup & Replication will automatically
discover this computer and start managing this computer as specified in the protection group settings.
You can specify a protection scope based on Active Directory objects in one of the following ways:
o You can select individual Active Directory objects that you want to include in a protection group, for
example, selected organizational units or computers.
o You can include in the protection group an entire domain or other Active Directory object (such a s a
container or organizational unit) and exclude specific child objects being part of this object, for
example, selected organizational units or computers.
You can add multiple computers to a protection group by importing a list of computers from a CSV or TXT
file. Protection groups that include computers listed in a CSV file are also dynamic. If a new computer
appears in the file after the protection group is created, during the next protection group rescan session,
Veeam Backup & Replication will automatically update the protection group settings to include the added
computer.
You can create protection groups for pre-installed Veeam Agents. Protection groups for pre-installed
Veeam Agents are empty just after they are created. You must deploy Veeam Agents on computers and
configure Veeam Agents to connect to the Veeam backup server. After deployment and configuration,
computers become members of the protection group.
This option is recommended if you do not have the full list of computers that you want to protect when
you create the protection group. This option also provides a convenient way to install agents using third -
party software distribution solutions, when deploying them from the Veeam backup server is not possible
due to security and network connectivity restrictions.
• Cloud machines
You can create protection groups to manage Veeam Agents installed on Amazon EC2 instances or
Microsoft Azure virtual machines (both objects can be also referred to as cloud machines). This protection
group allows you to discover cloud machines and deploy Veeam Agents using cloud native API instead of
the connection over network. Cloud machines that run Microsoft Windows or Linux OSes are supported.
This option is useful if you have cloud machines that run VSS-aware applications in your infrastructure and
you want to create transactionally consistent backups of applications on these cloud machines.
The current guide does not cover subjects related to protection groups that include applications. To learn
about this protection group type, see the Protection Group Types section in the Veeam Plug-ins for
Enterprise Applications Guide.
Manually Added
The Manually Added protection group contains individual computers added to Veeam Agent backup jobs
configured in Veeam Backup & Replication. This protection group is aimed for scenarios when you want to
manage a single Veeam Agent computer or a small number of Veeam Agent computers and do not want to
create additional protection groups. Veeam Backup & Replication automatically adds a computer to the
Manually Added protection group when you add this computer to a Veeam Agent backup job. To learn more, see
Working with Veeam Agent Backup Jobs and Policies.
• For the Manually Added protection group, you can change only a limited number of setting s:
o You can change discovery and deployment options. (Except for changing the distribution server. For
the Manually Added protection group, the role of the distribution server is always assigned to the
backup server.)
o You can remove computers from this protection group. For example, you may want to remove a
computer from a Manually Added protection group if you do not want to back up data of this
computer any longer, and you have removed this computer from a Veeam Agent backup job.
o You cannot change other settings, such as the name and type of this protection group.
• You cannot add the entire Manually Added protection group to a Veeam Agent backup job.
Unmanaged
The Unmanaged protection group acts as a filter to display unmanaged Veeam Agent computers, that is,
computers that meet the following conditions:
1. Have Veeam Agent deployed and configured directly from a Veeam Agent computer or with Veeam
Service Provider Console.
2. Run a Veeam Agent backup job targeted at a backup repository managed by Veeam Backup & Replication.
You cannot perform any operations with the Unmanaged protection group, as well as add computers included in
this group to a Veeam Agent backup job. However, you can move such computers to a protection group that you
created. To learn more, see Moving Unmanaged Computer to Protection Group.
After you move an unmanaged computer to a protection group, Veeam Backup & Replication will start managing
Veeam Agent running on this computer according to discovery settings specified in the properties of the
protection group. If the protection group is added to a Veeam Agent backup job, Veeam Backup & Replication
will add the new computer to the job, too. You will no longer be able to manage Veeam Agent directly on the
Veeam Agent computer or from Veeam Service Provider Console.
Out of Date
The Out of Date protection group is displayed when Veeam Backup & Replication discovers protected computers
on which an outdated version of Veeam Agent is installed. For example, this may happen in a situation where
you configure a protection group with Veeam Agent deployment options disabled, and Veeam Backup &
Replication detects a newer version of Veeam Agent during discovery.
The Out of Date protection group lets you update Veeam Agent on multiple computers at once. To learn more,
see Upgrading Veeam Agent on Multiple Computers.
Offline
The Offline protection group acts as a filter to display computers to which Veeam Backup & Replication could
not connect during the latest rescan session.
Untrusted
The Untrusted protection group acts as a filter to display Linux-based computers whose fingerprints were not
verified in Veeam Backup & Replication. For computers included in this protection group, you need to check and
validate SSH fingerprints. To learn more, see Validating SSH Fingerprints.
The rescan job itself is not displayed in the Veeam Backup & Replication console. However, you can start rescan
job sessions manually for a specific protection group or individual computer in the inventory. This may be
helpful, for example, if new computers appeared in your infrastructure, and you want to discover these
computers without waiting for the next scheduled rescan job session start. To learn more, see Rescanning
Protection Group and Rescanning Protected Computer.
You can view statistics for currently running and already performed rescan job sessions. To learn more, see
Viewing Rescan Job Statistics.
• Automatic installation of nonsnap Veeam Agent for Linux during rescan is not available. If you want to add
a computer with nonsnap Veeam Agent for Linux to a protection group, you must deploy Veeam Agent on
the protected computer first. For more information on standalone installation of nonsnap Veeam Agent
for Linux, see the Installation and Configuration section of the Veeam Agent for Linux User Guide.
• Automatic upgrade of nosnap Veeam Agent for Linux during rescan is not available. You must upgrade
such Veeam Agents on the protected computer side, manually or using third -party tools.
• Rescan is available for all protection groups except protection groups for pre-installed Veeam Agents and
their individual members. Veeam Agents installed on computers included in protection groups for pre -
installed Veeam Agents synchronize with Veeam Backup & Replication every 6 hours and provide
information about the Veeam Agent computer. If necessary, you can synchronize Veeam Agent with
Veeam Backup & Replication running a command from the Veeam Agent computer. To learn more, see
Backup Policy Application Methods.
How It Works
When the rescan job is started — either automatically upon schedule or manually — Veeam Backup & Replication
performs the following operations:
1. Obtains settings specified for the protection group from the configuration database. The settings include a
list of computers to scan, a method for connecting to these computers, and so on.
2. Connects to each computer in the list using a connection method specified in the protection group
settings.
3. Deploys Veeam components on each newly discovered computer: On Windows -based computers, Veeam
Backup & Replication deploys Veeam Installer Service. After that, Veeam Installer Service deploys Veeam
Transport Service.
o On Windows-based computers, Veeam Backup & Replication deploys Veeam Installer Service. After
that, Veeam Installer Service deploys Veeam Transport Service.
o On Linux-based computers, Veeam Backup & Replication deploys Veeam Deployer Service. After that,
Veeam Deployer Service deploys Veeam Transport Service.
You can manually pre-install Veeam Deployer Service on a Linux computer. In this case, Veeam
Backup & Replication will make the initial connection to the Linux computer using a single -use
certificate. For more information on this deployment option, see Deploying Veeam Agent for
Linux Using Pre-Installed Veeam Deployer Service.
o On Unix-based computers, Veeam Backup & Replication deploys Veeam Installer Service.
o On Amazon EC2 instances or Microsoft Azure virtual machines (both objects can be also referred to as
cloud machines), Veeam Backup & Replication deploys Veeam Transport Service and Veeam Cloud
Message Service.
4. If the automatic Veeam Agent deployment option is enabled in the protection group settings, Veeam
components also deploy Veeam Agent on discovered computers. As a part of this process, Veeam Backup
& Replication performs the following operations:
a. Veeam components running on the computer collects information about the computer and sends it to
Veeam Backup & Replication. The collected data includes details on the computer type, platform, host
name, guest OS, IP address, BIOS UUID, and information about Veeam Agent (its presence on the
computer, product version and license installed).
b. Veeam Backup & Replication uploads the Veeam Agent setup files:
▪ On Amazon EC2 instances or Microsoft Azure virtual machines, Veeam Backup & Replication
uploads files from the distribution repository to the discovered instances and virtual machines.
▪ On Windows-based computers, Veeam Installer Service installs Veeam Agent on the target
computer.
▪ On Linux-based computers, Veeam Deployer Service installs Veeam Agent on the target
computer.
▪ On Unix-based computers, Veeam Installer Service installs Veeam Agent on the target
computer.
• Ba ckup job
The backup job that processes Veeam Agent computers runs on the backup server in the s imilar way as a
regular job for VM data backup. The backup job is intended for protected computers that have permanent
connection to the backup server, such as standalone servers and failover clusters. You can use the backup
job to create Veeam Agent backups in a backup repository or cloud repository.
In Veeam Backup & Replication, the backup job of this type is also referred to as the Veeam Agent backup
job managed by the backup server .
To learn more, see Backup Job.
• Ba ckup policy
The backup policy describes configuration of individual Veeam Agent backup jobs that run on protected
computers. Veeam Backup & Replication uses the backup policy as a saved template and applies settings
from the backup policy to Veeam Agents that run on computers specified in the backup policy. The backup
policy is intended for protected computers that may have limited connection to the backup server, such as
workstations, laptops and so on. You can choose to create Veeam Agent backups in a backup repository,
cloud repository, network shared folder or on a local storage of a protected computer.
Veeam Agent computers that are members of a protection group for pre-installed Veeam Agents can be
processed only by backup policies. To learn more about protection group for pre-installed Veeam Agents,
see Protection Group Types.
In Veeam Backup & Replication, the backup policy is also referred to as the Veeam Agent backup job
managed by Veeam Agent.
To learn more, see Backup Policy.
• Backup jobs and policies that process Microsoft Windows computers. For such Veeam Agent backup jobs,
Veeam Backup & Replication offers settings supported in Veeam Agent for Microsoft Windows.
• Backup jobs and policies that process Linux computers. For such Veeam Agent backup jobs, Veeam Backup
& Replication offers settings supported in Veeam Agent for Linux.
• Backup policies that process Unix computers. For such Veeam Agent backup policies, Veeam Backup &
Replication offers settings supported in Veeam Agent for IBM AIX and Veeam Agent for Oracle Solaris.
• Backup policies that process Mac computers. For such Veeam Agent backup policies, Veeam Backup &
Replication offers settings supported in Veeam Agent for Mac.
If a protection group contains Microsoft Windows computers and Linux computers, you can add this pr otection
group to a Veeam Agent backup job intended for any of these types of protected computers. Veeam Backup &
Replication will automatically exclude computers of another type from the backup job and processes only those
computers that run an OS of the same type.
For example, if you add a protection group that contains Microsoft Windows and Linux computers to a Veeam
Agent backup job intended for Linux computers, Veeam Backup & Replication will exclude Microsoft Windows
computers from this backup job and process only Linux computers within the job.
• You can include a computer of the Server type in more than one backup job managed by the backup server
or more than one backup policy.
• You can include a computer of the Workstation type in one backup policy targeted at a local drive,
network shared folder or Veeam backup repository plus unlimited number of backup policies targeted at a
Veeam Cloud Connect repository.
• You cannot include the same computer in a backup job and backup policy simultaneously.
For a Veeam Agent backup job managed by the backup server, all job management tasks are performed on the
Veeam Backup & Replication side: Veeam Backup & Replication starts the job upon the defined schedule,
allocates backup infrastructure resources, and so on. Veeam Agent running on a protected computer operates
under control from Veeam Backup & Replication and performs data backup operations only, such as creating a
volume snapshot, reading the backed-up data and transferring backed-up data to the target location. To learn
more, see How Veeam Agent Backup Job Works.
To configure a backup job, you must launch the New Agent Backup Job wizard and select the Ma naged by
b a ckup server option at the Job mode step of the wizard. For backup jobs of this type, Veeam Backup &
Replication offers settings similar to settings of a VM backup job, as well as settings specific for Veeam Agents.
To learn more, see Creating Veeam Agent Backup Jobs.
NOTE
• [For Microsoft Windows computers] To manage a Veeam Agent backup job managed by the backup
server, you can use the Veeam Backup & Replication console only. On a computer added to a backup
job of this type, the Veeam Agent user interface is not available, and you cannot perform operations
with Veeam Agent directly on the protected computer.
• The Veeam Agent backup job is the only approach to protect members of a protection group for
cloud machines. To learn more, see Protection Group Types.
1. When you create a Veeam Agent backup job in Veeam Ba ckup & Replication, Veeam Backup & Replication
saves the backup job settings in its database.
2. When a new backup job session starts, Veeam Backup & Replication starts the Veeam Backup Manager
process on the backup server. Veeam Backup Manager reads job s ettings from the configuration database
and creates a list of backup tasks to process. For every protected computer added to the job, Veeam
Backup & Replication creates a new task.
3. Veeam Backup Manager connects to the Veeam Backup Service. The Veeam Backup Service includes a
resource scheduling component that manages all tasks and resources in the backup infrastructure. The
resource scheduler checks what backup infrastructure resources are available, and assigns backup
repository to process job tasks.
4. Veeam Backup Manager connects to Veeam Transport Service on the backup repository. The Veeam
Transport Service, in its turn, starts Veeam Data Mover. A new instance of Veeam Data Mover is started for
every job task.
5. Veeam Backup Manager establishes a connection with Veeam Agent service that runs on the protected
computer and Veeam Data Mover that runs on the backup repository, and sets a number of rules for data
transfer, such as network traffic throttling rules and so on.
6. Veeam Agent service that runs on the protected computer and Veeam Data Mover that runs on the backup
repository establish a connection with each other for data transfer.
8. Veeam Backup & Replication requests Veeam Agent to trigger a VSS snapshot or volume snapshot,
depending on the type of OS running on the Veeam Agent computer. For Windows-based computers,
Veeam Agent for Microsoft Windows leverages Microsoft VSS technology to create a VSS snapshot. For
Linux-based computers, Veeam Agent for Linux uses the Veeam driver to create a volume snapshot.
For Windows-based computers, if the Microsoft VSS technology fails to create a VSS snapshot for some
reason, Veeam Agent for Microsoft Windows resends the request up to 3 times.
9. Veeam Agent service that runs on the protected computer reads the backed -up data from the volume
snapshot and transfers the data to the backup repository. During incremental job sessions, the Veeam
Agent service uses CBT to retrieve only those data blocks that have changed since the previous job
session. If CBT is not available, the Veeam Agent service interacts with the target Veeam Data Mover on
the backup repository to obtain backup metadata, and uses this metadata to detect blocks that have
changed since the previous job session.
While transporting backed-up data, Veeam Agent running on a protected computer performs additional
processing. It filters out zero data blocks, blocks of swap files and blocks of excluded files and folders.
Veeam Agent compresses backed-up data and transports it to the target Veeam Data Mover.
Veeam Backup & Replication stores backed-up data to the backup file in the backup repository.
The backup policy describes configuration of individual Veeam Agent backup jobs that run on protected
computers. You can add one or more protection groups or individual computers to the backup policy and
instruct Veeam Agent to create backups in a Veeam backup repository, in a Veea m Cloud Connect repository, in
a network shared folder or on a local storage of a protected computer. In terms of the Veeam Agent
management scenario, the backup policy is also referred to as the Veeam Agent backup job managed by the
Veeam Agent.
Veeam Backup & Replication uses the backup policy as a saved template and applies settings from the backup
policy to protected computers. The resulting Veeam Agent backup jobs run on protected computers in the
similar way as a regular backup job configured directly in Veeam Agent. All backup job management and data
processing tasks are performed by Veeam Agent itself. This allows Veeam Agent to create backups of your data
even if a connection to the backup server is unavailable. To learn more, see How Backup Policy Works.
To configure a backup policy, you must launch the New Ag ent Backup Job wizard and select the Ma naged by
a g ent option at the Job mode step of the wizard. To learn more, see Creating Veeam Agent Backup Policies.
NOTE
• For computers specified in the backup policy, in addition to managing backup settings and
performing backup tasks from the Veeam backup console, you can also perform selected operations,
including file-level and volume-level restore, directly on a protected computer. In particular, you
can use the Veeam Agent control panel to start the backup job manually. This allows you to create
ad-hoc backups of your data in addition to backups created upon schedule defined in the backup
policy.
• The backup policy is the only approach to protect Mac and Unix computers as Veeam Agent for Mac,
Veeam Agent for IBM AIX and Veeam Agent for Oracle Solaris do not support backup jobs managed
by backup server.
• The backup policy is the only approach to protect members of a protection group for pre-installed
Veeam Agents. To learn more, see Protection Group Types.
Consider that the way how backup policy works for computers included in protection groups for pre -
installed Veeam Agents differs from the standard scenario. To learn more, see How Backup Policy Works
With Computer Included In Protection Group for Pre-Installed Veeam Agents.
In the scenario where you use the backup policy to create Veeam Agent backups, Veeam Backup & Replication
and Veeam Agents interact in the following way:
1. When you create a backup policy, Veeam Backup & Replication saves the backup policy settings in the
following locations on the backup server:
a. Veeam Backup & Replication reads the list of computers and protection groups specified in the backup
policy and starts the discovery process for these computers.
b. During the discovery process, Veeam Backup & Replication connects to each computer in the backup
policy and uploads the XML file with backup policy settings to the target computer.
c. Veeam Backup & Replication uses settings from the backup policy to configure the Veeam Agent
backup job. This process differs depending on what OS and Veeam Agent the protected computer
runs.
▪ On Microsoft Windows computers, Veeam Backup & Replication creates the Veeam Agent
backup job using the Veeam Agent for Microsoft Windows Configurator.
▪ On Linux computers, Veeam Backup & Replication creates the Veeam Agent backup job using the
Veeam Agent for Linux command line interface.
▪ On Unix computers, Veeam Backup & Replication creates the Veeam Agent backup job using the
Veeam Agent command line interface.
Settings of the created backup job are saved to the Veeam Agent database on the protected
computer.
Veeam Backup & Replication regularly applies the backup policy to protected computers during rescan of
protection groups added to the backup policy. To learn more, see Backup Policy Application Methods.
3. The created Veeam Agent backup job runs on the protected computer in the similar way as a regular
Veeam Agent backup job configured directly on the Veeam Agent computer. To learn more, see the
following sections:
o How Backup Works section in the Veeam Agent for Microsoft Windows User Guide.
o How Backup Works section in the Veeam Agent for Linux User Guide.
o How Backup Works section in the Veeam Agent for IBM AIX User Guide.
Every 6 hours, Veeam Agent checks whether job settings obtained from the backup policy are up -to-date
and do not differ from the current backup settings specified in the backup policy. If the settings differ,
Veeam Agent updates backup job settings in its database. To learn more, see Backup Policy Application
Methods.
1. When you create a backup policy, Veeam Backup & Replication saves the backup policy settings in the
following locations on the backup server:
2. Veeam Agent connects to Veeam Backup & Replication and gets the configuration file.
IMP ORTANT
Veeam Agent does not connect to Veeam Backup & Replication immediately after updated backup
policy settings are saved. Veeam Agent checks whether Veeam Backup & Replication has any updates
in the backup policy settings periodically. As a result, a time period between scenario steps 1 and 2
may take up to 6 hours. If necessary, you can synchronize Veeam Agent with Veeam Backup &
Replication running a command from the Veeam Agent computer. To learn more, see Backup Policy
Application Methods.
3. Veeam Agent uses the backup policy settings from the configuration file to create a Veeam Agent backup
job. Settings of the created backup job are saved to the Veeam Agent database on protected computer.
o How Backup Works section in the Veeam Agent for Microsoft Windows User Guide.
o How Backup Works section in the Veeam Agent for Linux User Guide.
o How Backup Works section in the Veeam Agent for Oracle Solaris User Guide.
o How Backup Works section in the Veeam Agent for IBM AIX User Guide.
o How Backup Works section in the Veeam Agent for Mac User Guide.
Every 6 hours, Veeam Agent checks whether job settings obtained from the backup policy are up -to-date
and do not differ from the current backup settings specified in the backup policy. If the settings differ,
Veeam Agent updates backup job settings in its database.
TIP
You can also apply the backup policy to protected computers manually, if needed. To learn more, see
Applying Backup Policy to Protected Computers.
Veeam Backup & Replication applies the backup policy to protected computers at the following events:
o At the time when you start the backup process manually in the Veeam Backup & Replication console.
NOTE
Keep in mind that Veeam Backup & Replication cannot apply backup policy to protection groups for
pre-installed Veeam Agents and their members. For members of such protection groups, the policy
application process can be started only by Veeam Agent.
• By Veeam Agent
The Veeam Agent service running on a protected computer regularly synchronizes with Veeam Backup &
Replication and checks whether job settings obtained from the backup policy are up -to-date and updates
backup job settings, if necessary. Veeam Agent performs the synchronization every 6 hours.
You can also synchronize Veeam Agent with Veeam Backup & Replication immediately running the
following command from the Veeam Agent computer:
o For Veeam Agent for Linux, Veeam Agent for Oracle Solaris, Veeam Agent for IBM AIX and Veeam
Agent for Mac computers:
During the synchronization session, Veeam Agent performs the following operations:
a. Connects to Veeam Backup & Replication and obtains from the Veeam Backup & Replication database
information about backup policies to which the Veeam Agent computer was added.
b. Compares obtained backup policy settings with backup job settings in the Veeam Agent database. If
the settings differ, Veeam Agent performs the following tasks:
▪ If backup policy settings and Veeam Agent backup job settings do not match, Veeam Agent
updates backup job settings in its database.
▪ If the protected computer was added to a new backup policy, Veeam Agent creates a new
backup job on the protected computer.
▪ If the protected computer was removed from the backup policy, Veeam Agent removes the
Veeam Agent backup job on the protected computer.
The backup chain consists of the first full backup file, incremental backup files, metadata files and some
additional files. Full and incremental backup files correspond to restore points of the backed -up Veeam Agent
computers. Restore points let you roll back Veeam Agent computers to the necessary state.
To learn about types of backup files, see the Backup Files section in the Veeam Backup & Replication User Guide.
In This Section
Short-Term Retention Policy
Depending on the selected job mode, restore points are handled by Veeam Backup & Replication or Veeam
Agent. To learn more, see Veeam Agent Backup Jobs and Policies.
To define the short-term retention policy for a backup job, you can select the following units:
• Days. In this case, Veeam Backup & Replication or Veeam Agent retains restore points in the following
way:
o [For Veeam Agent backup jobs managed by the backup server] Veeam Backup & Replication keeps
backup files for the < N>+1 days, where < N> is the number of days that you specified in the backup job
settings.
NOTE
The minimum number of retained restore points is 3, and this number does not depend on the
number of days set in the backup job settings. You can change the minimum number of retained
restore points with a registry value. To learn more, contact Veeam Customer Support.
o [For Veeam Agent backup jobs managed by Veeam Agent] Veeam Agent takes into account only days
on which backup files were successfully created. Veeam Agent ignores restore points created on the
day when the retention policy is applied and keeps restore points for the <N> + 1 days, where <N> is
the number of days that you specified in the backup job settings.
• Restore points. In this case, Veeam Backup & Replication or Veeam Agent retains the specified number of
the latest restore points.
1. During every backup job session Veeam Backup & Replication or Veeam Agent adds a backup file to the
backup chain and checks if there is an obsolete restore point.
a. Rebuilds the full backup file to include in it data of the incremental backup file that follows the full
backup file. To do this, Veeam Backup & Replication or Veeam Agent injects into the full backup file
data blocks from the earliest incremental backup file in the chain. This way, a full backup ‘moves’
forward in the backup chain.
b. Removes the earliest incremental backup file from the chain as redundant: its data has already been
injected into the full backup file, and the full backup file includes data of this incremental backup file.
If the backup chain contains several obsolete restore points, the rebuild procedure is similar. Data from
several restore points is injected to the rebuilt full backup file. This way, Veeam Backup & Replication or
Veeam Agent makes sure that the backup chain is not broken, and you will be able to recover your data to
any restore point.
In the Veeam Agent management scenario, the backup cache works in the similar way a s in Veeam Agent
operating in the standalone mode. To learn more, see the Backup Cache section in the Veeam Agent for
Microsoft Windows User Guide.
In addition to backup cache features and limitations listed in the Veeam Agent for Microsoft Windows User
Guide, the following applies to Veeam Agent operating in the managed mode:
• You can specify backup cache settings in the properties of backup policies targe ted at the following types
of backup location:
o Cloud repository
• The backup cache is supported only for backup policies (backup jobs managed by Veeam Agent).
• To facilitate backup cache configuration on multiple Veeam Agent computers added to the backup policy,
you can instruct Veeam Agent to automatically select location for the backup cache on each computer. To
learn more, see How Automatic Backup Cache Placement Works.
With the Automatic selection option enabled in the backup cache settings, Veeam Agent for Microsoft Windows
creates the backup cache according to the following rules:
1. Veeam Agent selects for the backup cache a non-system volume that has enough free space for the
specified backup cache quota (that is, maximum backup cache size) and has the largest amount of free
space.
2. On the selected volume, Veeam Agent creates the backup cache in the Veeam Backup Cache folder.
• If the volume with the largest amount of free space is a system volume, Veeam Agent selects the volume
that has enough space for the backup cache quota and has the second largest amount of free space.
• If the system volume is the only volume that has enough space for the backup cache quota, Veeam Agent
creates the backup cache on the system volume.
• If no volumes have enough space for the backup cache quota, Veeam Agent selects the volume that has
the largest amount of free space.
For example, the system volume is the only volume that has enough space for the backup cache quota at
the time when you create the backup policy. In this case, Veeam Agent creates the Veeam Backup Cache
folder on the system volume. After disk configuration changes on the computer, a non-system volume
becomes able to fit the backup cache quota. However, Veeam Agent will not move the Veeam Backup
Cache folder to the non-system volume.
• Veeam Agent does not create the backup cache on external, removable or virtual disks.
Note that Veeam Backup & Replication automatically deletes restore points from the backup cache on all
computers added to the backup policy after you perform one of the following operations:
• Change the target location for backup files in the backup policy settings.
• Change the backup mode for the backup policy to the File-level backup .
• Change backup cache location for the backup policy (in case it was specified manually).
You can also delete restore points from the backup cache manually in the Veeam backup console. To learn more,
see Clearing Backup Cache.
• Veeam Backup & Replication to use backup proxy servers to process storage systems.
• Veeam Agent to use hardware Volume Shadow Copy Service (VSS) provider and capabilities of native
snapshots that are created on production storage systems to create backups.
This approach results in much less load on protected servers compa red to the regular backup scenario that uses
software VSS provider.
For general information about backup jobs that use storage snapshots as a data source, see the Storage System
Snapshot Integration section in the Veeam Backup & Replication User Guide.
Getting Started
Before you configure a Veeam Agent backup job that will use a storage system snapshot as a data source, you
must complete the following steps:
1. Configure the backup infrastructure to create backups from native storage snapshots. To learn more, see
the Backup Infrastructure for Storage Integration section in the Veeam Backup & Replication User Guide.
Keep in mind that you must allow your storage to process Veeam Agent backups. To do this, select the
Block storage for M icrosoft Windows servers check box at the Na me step of the New Storage wizard, then
specify options for accessing the storage system at the Ag ent Access step of the wizard. To learn more,
see the Adding Storage Systems section in the Veeam Backup & Replication User Guide.
Veeam Agent for Microsoft Windows allows you to create backups from native snapshots with hardware
VSS provider only. For the list of supported storage systems, see the Veeam Agent Integration section in
the Veeam Backup & Replication User Guide.
2. Add a Microsoft Windows computer to the inventory and deploy Veeam Agent for Microsoft Windows on
this computer using the Veeam Backup & Replication console. To learn more, see Creating Protection
Groups.
• The backup proxy and the Veeam Agent computer must run Microsoft Windows Server OS versions. The
backup proxy cannot run the OS version that is earlier than the Veeam Agent computer OS version.
o The Standard, Enterprise, or Enterprise Plus edition of Veeam Backup & Replication on the backup
server with the backup proxy role.
o The Server edition of Veeam Agent for Microsoft Windows on the Veeam Agent computer.
You can check product editions in the License Information window of the Veeam Backup & Replication
backup console. To learn more, see the Viewing License Information section in the Veeam Backup &
Replication User Guide.
• At least one storage logical unit number (LUN) must be mapped to the Veeam Agent computer.
• You must use iSCSI or Fibre Channel protocol for your storage system:
o You must use iSCSI or Fibre Channel protocol to connect LUNs to Veeam Agent computer and backup
proxy to your storage system.
o If you plan to use the iSCSI Protocol, the backup proxy and the Veeam Agent computer must have a
Microsoft iSCSI Software initiator enabled.
o If you plan to use the Fibre Channel Protocol, the backup proxy and the Veeam Agent computer must
have a Fibre channel adapter installed and must have access to the storage system over Fibre Channel
fabric.
• If a Veeam Agent computer has a storage system with disks that use the GUID Partition Table (GPT) as a
partitioning scheme, each disk must contain a Microsoft Reserved (MSR) partition.
In addition to general limitations listed in the in the Veeam Backup & Replication User Guide, consider the
following limitations for Veeam Agent backups from storage snapshots:
• If the Storage Replica feature is installed on the Veeam Agent computer, you cannot back up this
computer using the hardware VSS provider. If you want to add this computer to the backup scope, you
must allow Veeam Backup & Replication to fail over to the regular backup scenario that uses software VSS
provider. To learn more, see Integration Settings. To learn more about Storage Replica, see Microsoft
documentation.
• The backup proxy and the Veeam Agent computer you want to back up cannot be the same computer.
• You cannot back up the following objects using the hardware VSS provider:
o Storage spaces
With volumes allocated to RDM disks or storage spaces in the backup scope, Veeam Backup & Replication
will fail over to the regular backup scenario even if failover is not allowed in storage integration settings.
• If your Veeam Agent computer has a disk that contains the storage spaces protective partition, you cannot
back up volumes allocated to this disk using the hardware VSS provider. To back up such volumes, you
must allow Veeam Backup & Replication to fail over to the regular backup scenario that uses software VSS
provider. To learn more about failover, see Integration Settings.
• Volumes greater than 64 TB are supported with limitations. To learn more, see Storage Snapshots on
Volumes Greater than 64 TB.
• BitLocker encrypted volumes are supported with limitations. To learn more, see Storage Snapshots on
BitLocker Encrypted Volumes.
1. Veeam Backup & Replication checks that the hardware VSS provider is installed on the Veeam Agent
computer.
If the hardware VSS provider is not installed, Veeam Backup & Replication rescans the Veeam Agent
computer and installs the hardware VSS provider.
The hardware VSS provider aborts the shadow copy creation if the whole process takes longer than 60
seconds or if the provider takes longer than 10 seconds to commit the shadow copy. To meet these time
limits, Veeam Agent expects the storage system to create a snapshot within 9 seconds. In case of a
standalone server, Veeam Agent can extend this period up to 59 seconds. In case of a failover cluster,
Veeam Agent cannot extend the 9-second period. To learn more on how the hardware VSS provider
creates shadow copies, see Microsoft documentation.
If storage system fails to create a native snapshot within the time period allowed by VSS, Veeam Backup &
Replication will behave according to the storage integration settings. Veeam Backup & Replication will
complete the backup job with the Failed status or fail over to the regular backup scenario that uses
software VSS provider.
3. After a snapshot LUN is created, this LUN connects to Veeam Agent computer to finish VSS operations and
record storage metadata.
4. Veeam Backup & Replication mounts the snapshot LUN to the backup proxy.
5. Veeam Backup & Replication reads the snapshot LUN and transfers data from the backup proxy to the
target repository.
Keep in mind that if the snapshot LUN contains a dynamic volume, Veeam Backup & Replication reads all
extents of this volume.
6. Veeam Backup & Replication completes backup operations on the Veeam Agent computer and the backup
proxy.
7. Veeam Backup & Replication removes the snapshot LUN from storage.
After that, you can use backups created from storage snapshots for restore and administration tasks. For such
Veeam Agent backups, Veeam Backup & Replication allows you to perform the same set of operations as for
backups created with regular backup scenario that uses software VSS provider. To learn more, see Restoring
Data from Veeam Agent Backups and Managing Veeam Agent Backups
In addition to considerations and limitations listed in section Storage Snapshots Support, consider the following:
• You can back up volumes that are greater than 64 TB using only hardware VSS provider installed by
Veeam Agent. In case of fail over to the regular backup scenario that uses software VSS provider, the
backup job will fail.
• Your production system storage must support backup of the volume with the size that you plan to back
up.
• We strongly do not recommend to back up Veeam Agent computer volumes (for example, system volume)
together with volumes greater than 64 TB. Otherwise, the software VSS provider may locate the shadow
copy storage area for Veeam Agent computer volumes on the volume greater than 64 TB. In this case, the
backup job will fail and the OS running on the Veeam Agent computer may get a blue screen error.
If volumes you want to back up are protected by Microsoft Windows BitLocker, do the following:
1. On the Veeam Agent computer, set BitLocker to automatically unlock volumes to which LUNs are mapped.
To learn more, see Microsoft documentation.
b. Set BitLocker to automatically unlock connected volumes on the backup proxy. To learn more, see
Microsoft documentation.
c. Disconnect volumes to which LUNs are mapped from the backup proxy.
If you plan to use several backup proxies, repeat step 2 for each backup proxy.
• If automatic unlocking is not set on the Veeam Agent computer, file indexing will not work during the
backup process.
• If automatic unlocking is not set on the backup proxy, only volume-level restore to a new location is
available. File-level restore and volume-level restore to the original location will fail.
Veeam Agent supports data backup and restore for the following types of failover clusters:
Keep in mind that SQL Server Failover Cluster Instances and Always On Availability Groups are
supported only for Microsoft SQL Server 2012 or later. To learn about Always On Availability Groups,
see Backup of Always On Availability Groups.
Microsoft Exchange Database Availability Groups (DAGs) are supported. To learn more, see Backup of
Database Availability Groups.
• Backup of failover clusters is supported in Veeam Agent managed by Veeam Backup & Replication only.
You cannot process a failover cluster by Veeam Agent operating in the standalone mode.
• Backup of CSV (Cluster Shared Volumes) is not supported. Cluster disks used as CSV are automatica lly
excluded from backup.
• Backup of Storage Replica log volumes is not supported. Such volumes are automatically excluded from
backup because of Microsoft VSS limitations. To learn more, see Microsoft documentation.
• Backup of environments consisting of several failover clusters is not supported. For example:
o Always On Availability Groups based on SQL Server Failover Cluster Instances (FCIs). To learn more,
see Microsoft documentation.
• Always On Availability Groups with no underlying failover cluster (Clusterless Availability Groups) are not
supported.
• Backup of SQL Server failover clusters that store databases on a cluster disk is not supported if at least
one of the cluster nodes hosts a local disk with the same mount point.
Veeam Backup & Replication does not support simultaneous processing of Microsoft SQL Server transaction
logs on SQL Server clustered instances with identical names. The limitation applies to clustered instances
of different failover clusters as well.
For example, you configure two backup jobs that process transaction logs of different failover clusters
whose SQL clustered instances have identical names. In case these backup jobs run simultaneously,
transaction logs will be processed only by the backup job that started first. The second backup job will not
process transaction logs.
1. In Veeam Backup & Replication, create a protection group that includes Active Directory objects and add
to this protection group one of the following types of objects:
o Failover cluster account of the failover cluster whose data you want to back up
2. In Veeam Backup & Replication, configure a Veeam Agent backup job for a failover cluster. To add a
failover cluster to the backup job, do the following:
a. At the Job Mode step of the New Ag ent Backup Job wizard, select Fa ilover cluster.
b. At the Comp uters step of the wizard, add to the job the failover cluster account that you added to a
protection group at the step 1. Alternatively, you can add to the job a container or protection group
that includes this failover cluster account.
IMP ORTANT
• If a backup task within a Veeam Agent backup job that processes a failover cluster completes
unsuccessfully or a new node is added to a failover cluster, Veeam Agent will create a full backup of
all shared disks of the failover cluster during the next backup job run.
• You cannot create per-machine backup files with a Veeam Agent backup job that processes failover
clusters because of failover cluster limitations. The backup job with failover clusters in the backup
scope creates a separate backup file for each failover cluster.
• When you restore data of a failover cluster, make sure that the failover cluster is added to the V eeam
Backup & Replication inventory as part of a protection group.
• If you copy a failover cluster backup, the job ignores the Use p er-machine backup files option enabled for
the backup repository and creates a single backup copy file for each failover cluster.
To learn more, see the Backup Chain Formats section in the Veeam Backup & Replication User Guide.
• When you copy Veeam Agent backup jobs that process failover clusters with shared disks, the network
traffic is higher compared to the traffic sent when Veeam Agent backup jobs run. This happens because
Veeam Agent backup copy jobs send data as it is stored in the storage — each node with the cloned data —
unlike Veeam Agent backup jobs that send data of shared disks only with the owner node and then, within
the target storage, clone this data to other nodes.
• Data deduplication is not available when you copy Veeam Agent backup jobs that process failover clusters
with shared disks to an object storage repository.
IMP ORTANT
In this case, you may require additional free space on the target location, because Veeam Backup &
Replication creates in the target location as many copies of the cluster shared disks as there are
nodes in the cluster.
To learn more about backup copy, see the Backup Copy section in the Veeam Backup & Replication User Guide.
• For a regular DAG, the backup job configuration procedure is the same as for any failover cluster. To
process a regular DAG, you must configure a Veeam Agent backup job for a failover cluster. To learn more,
see Backup and Restore of Failover Clusters.
• For an IP Less DAG (a DAG without an Administrative Access Point), the backup job configuration
procedure is similar to the same procedure for standalone servers. To process an IP Less DAG, you must
create a protection group with all nodes of the IP Less DAG and add this protection group to the Vee am
Agent backup job managed by the backup server. To learn more, see Creating Job for Windows
Computers.
How It Works
During backup, Veeam Agent performs the following operations:
Keep in mind that Veeam Agent performs the backup, but all pre-/post-backup operations are performed
by the Exchange VSS Writer that is available on any Microsoft Exchange Server. To learn more about
Exchange VSS Writer, see Microsoft documentation.
2. Veeam Agent detects that server added to the backup scope is a part of a DAG.
o For a regular DAG, Veeam Agent gets the list of all DAG servers and add s these servers to the backup
job.
If a set of servers, that are included in a regular DAG, changes between the job runs, Veeam Agent
changes the backup scope accordingly.
o For an IP less DAG, you must add all servers of an IP less DAG to the backup job manually.
IMP ORTANT
An IP less DAG does not have an Administrative Access Point. As a result, you must add all
servers of an IP less DAG to the protection group manually. If a set of servers included in an IP
less DAG changes between the job runs, you must update the backup s cope manually as well.
Otherwise, Veeam Agent will still back up all database files from all servers included into
backup scope, but Microsoft Exchange Server will detect data inconsistency and skip the
database processing.
3. Veeam Agent processes databases to prepare them for backup: Veeam Agent freezes databases, creates
database snapshots, and returns databases to the initial state.
DAG servers contain active and passive copies of each database. By default, the Exchange VSS Writer
issues VSS freeze commands to passive database copies only. If all passive copies of the database are not
available for some reason, the Exchange VSS Writer issues the VSS freeze command to the active copy of
the database. This approach helps to ensure data consistency.
4. After the database processing is finished, Veeam Agent creates a transactionally consistent backup of all
databases running on DAG servers. The backup will include all database files from all servers included into
backup scope regardless of the database processing success.
NOTE
• The Exchange VSS Writer cannot create a VSS snapshot of all databases at once. That is why
Veeam Agent backs up DAG servers one by one.
• Veeam Agent backs up all active and passive copies of the database on all DAG servers.
Otherwise, Veeam Agent will not be able to ensure data consistency as Microsoft Exchange
transfers data from active copy to passive copies after some time.
5. Veeam Agent notifies the Exchange VSS Writer about successful backup. If required, the Exchange VSS
Writer truncates logs on DAG servers.
Log truncation is applied to all passive and active database copies. Veeam Agent uses the Exchange VSS
Writer to truncate logs. However, you can set Veeam Agent to disable transaction logs or ba ckup
transaction logs with Veeam Agent in the backup job settings. To learn more, see Guest Processing
Settings.
1. In Veeam Backup & Replication, create a protection group that includes Active Directory objects. Add to
this protection group the failover cluster account of the failover cluster whose data you want to back up.
a. At the Job Mode step of the New Ag ent Backup Job wizard, select Fa ilover cluster.
b. At the Comp uters step of the wizard, add to the job the failover cluster account that you added to a
protection group at the step 1. Alternatively, you can add to the job a container or protection group
that includes this failover cluster account.
c. At the Guest Processing step of the wizard, select the E nable application-aware processing option.
Then click Ap p lications. In the P rocessing Settings window, define processing settings. To learn more,
see Application-Aware Processing.
To learn more about the backup job configuration, see Creating Job for Windows Computers.
If you select to process transaction logs with the backup job in the P rocessing Settings window, Veeam Backup
& Replication performs the following operations during an image-level backup:
1. Requests and analyzes information about databases that are included in the Always On Availability
Groups.
2. Depending on the retrieved information, selects the VSS backup type for each computer: full backup
(VSS_BT_FULL) or copy-only backup (VSS_BT_COPY). The copy-only backup is created if the computer
represents a secondary node for at least one Always On Availability Group.
Transaction log backup can be performed only for those databases that were successfully backed up, on the
primary or on the secondary node of Always On Availability Group. At each log processing interval, Veeam
Backup & Replication chooses the Always On Availability Group node for which transaction logs will be backed
up. Logs are backed up from one node of the Always On Availability Group.
To become a subject for a log backup, the node must meet the following criteria:
• The node is not subject to the limitations listed in section Failover Cluster Support.
• The necessary Veeam Backup & Replication components must be installed on this node and the computer
included in Always On Availability Group must be running. For more information on the necessary
components, see the How Microsoft SQL Server Log Backup Works section in the Veeam Backup &
Replication User Guide.
• The database backup preferences settings must allow a backup of the node that you want to process. For
example, if you want to back up the primary node, you must not exclude this node from a backup, or
select the Secondary only option in the database backup preferences settings.
• Databases in the Always On Availability Groups for this node were successfully backed up for the last two
processing intervals.
NOTE
• You cannot check data of backups created by Veeam Agent for Linux, Veeam Agent for Mac, Veeam
Agent for IBM AIX or Veeam Agent for Oracle Solaris.
• [For backups of failover clusters] You can exclude only the whole cluster from the malware
detection scan, you cannot exclude a single cluster node.
To learn how to scan restore points of a specific backup, see Scanning Backup.
• Pre-freeze and post-thaw scripts executed on the Veeam Agent computer (for backup jobs that process
servers)
• Pre-job and post-job scripts executed on the backup server (for backup jobs managed by the backup
server)
• Script settings are enabled at the backup job level. If you want to configure multiple backup jobs, you can
specify individual scripts for each job.
• If you use relative paths in your scripts, during script execution such paths will refer to the root directory.
For example, the script may have an output that must be saved to a new file. If you specify a relative path
to that file or only a file name, the file will be created in the root directory. To specify a different location
for a file, use a full absolute path.
You can specify pre-freeze and post-thaw script settings at the Guest Processing step of the New Agent Backup
Job wizard. To learn more, see Backup Job and Snapshot Scripts.
During the backup job session, Veeam Backup & Replication uploads the scripts to each Veeam Agent computer
added to the backup job and executes them on these comp uters. The scripts run in the same way as in the
standalone version of Veeam Agent. To learn more, see the Backup Job Scripts section in the Veeam Agent for
Linux User Guide.
You can specify backup job script settings at the Guest Processing step of the New Ag ent Backup Job wizard. To
learn more, see Backup Job and Snapshot Scripts.
Keep in mind that scripts of this type are supported for computers that run Veeam Agent for Linux 4.0 and later
only. Earlier versions of Veeam Agent for Linux do not run pre-job and post-job scripts obtained from the
backup server.
You can specify backup job script settings at the Storage step of the New Agent Backup Job wizard. To learn
more, see Script Settings.
During the backup job session, Veeam Backup & Replication executes the scripts on the backup server. The
scripts are executed on the backup server under the account under which the Veeam Backup Service runs (the
local System account or account that has the local Administrator permissions on the backup server).
3. Pre-freeze script
4. Post-thaw script
• Oracle
Veeam Agent processes the Oracle database system using an internal component: oralib .
• PostgreSQL
Veeam Agent processes the PostgreSQL database system using an internal component: pgsqlagent.
To learn how processing of database systems works, see the Backup of Database Systems section in the Veeam
Agent for Linux User Guide.
To learn more about backup of Oracle database archived logs, see the Oracle Log Backup section in the Veeam
Backup & Replication User Guide.
To learn more about backup of PostgreSQL database archived logs, see the PostgreSQL Log Backup section in
the Veeam Backup & Replication User Guide.
• Nosnap Veeam Agent for Linux and nosnap Veeam Agent for Linux on Power do not support application-
aware processing and cannot be used to back up database systems.
• Application-aware processing and database processing options are available if you have selected the
Server option at the Job Mode step of the wizard.
• Application-aware processing and database processing options are available if you have selected the
E ntire computer or Volume level backup option at the Backup Mode step of the wizard.
• Veeam Agent does not support processing of multiple database systems on one Veeam Agent computer.
• Available script settings depend on the options that you have selected at the Job Mode and Backup Mode
steps of the wizard. To learn more, see Backup Job and Snapshot Scripts.
Veeam Agent runs these scripts before the backup job starts and after the backup job completes. You can use
pre-job and post-job scripts, for example, to quiesce an application for the time when the backup job session
runs on the Veeam Agent computer.
You can specify backup job script settings at the Guest Processing step of the New Ag ent Backup Job wizard. To
learn more, see Backup Job Scripts.
During the backup job session, Veeam Backup & Replication uploads the scripts to each Veeam Agent computer
added to the backup job and executes them on these computers. The scripts run in the same way as in the
standalone version of Veeam Agent. To learn more, see the following sections:
• The Backup Job Scripts section in the Veeam Agent for IBM AIX User Guide.
• The Backup Job Scripts section in the Veeam Agent for Oracle Solaris User Guide.
• Script settings are enabled at the backup job level. If you want to configure multiple backup jobs, you can
specify individual scripts for each job.
• If you use relative paths in your scripts, during script execution such paths will refer to the root directory.
For example, the script may have an output that must be saved to a new file. If you specify a relative path
to that file or only a file name, the file will be created in the root directory. To specify a different location
for a file, use a full absolute path.
Keep in mind that you must deploy Veeam Agent for Mac on the Mac computer using setup files generated by
Veeam Backup & Replication. To learn more, see Deploying Veeam Agents Using Generated Setup Files.
Veeam Backup & Replication supports backup of the following cloud machines:
You can back up cloud machines running Microsoft Windows or Linux OSes that are supported by Veeam Agent
and by cloud service provider.
• To learn lists of OSes supported by Veeam Agent, see system requirements for Veeam Agent for Microsoft
Windows or for Veeam Agent for Linux depending on the type of Veeam Agent you plan to use.
• To learn lists of OSes supported by cloud service provider, see AWS documentation or Microsoft
documentation depending on the type of cloud machines you plan to protect.
IMP ORTANT
In case of cloud machines running Microsoft Windows, Windows PowerShell 5.1 must be installed on t he
cloud machine.
Getting Started
To back up cloud machine data, you must complete the following steps:
1. Add a Microsoft Azure blob storage or Amazon S3 storage to your infrastructure depending on the type of
cloud machines you plan to protect. To learn more, see the Adding Azure Blob Storage or Adding Amazon
S3 Storage section in the Veeam Backup & Replication User Guide.
NOTE
Regardless of the connection mode specified in the backup repository settings, Veeam Agent always
performs backup of cloud machines directly to the cloud. Backup data is not sent to Veeam Backup &
Replication. For information about the connection modes, see Backup to Object Storage.
2. Get the cloud user with the required permissions. With this user, Veeam Backup & Replication connects to
the bucket or container on the cloud. To learn more, see Permissions.
3. Configure a protection group for cloud machines. Keep in mind that the protection group of the cloud
machines type is the only applicable protection group to back up data of cloud machines. To learn more,
see Creating Protection Groups.
When you finish configuring a protection group and perform the rescan operation, Veeam Backup &
Replication installs the Veeam components on the cloud machine. For more information, see Setup of
Veeam Components.
4. Configure a backup job. Depending on the OS running on your cloud machine, see one of the following
sections:
• Veeam Agent
When you add a cloud machine to a protection group, it is managed by Amazon EC2 Simple Systems Manager
(SSM) or Azure Run Command depending on the cloud that you use. Unlike working with physical machines,
Veeam Backup & Replication does not send commands to cloud machines directly, but through these services.
For more information about Amazon SSM and Azure Run Command, see AWS documentation and Microsoft
documentation.
To accelerate the communication speed between Veeam Backup & Replication and a cloud machine, Veeam
Backup & Replication installs the Veeam Cloud Message Service on the machine during the rescan operation.
After the Veeam Cloud Message Service is installed, all communication between Veeam Backup & Replication
and the machine is switched from Amazon SSM or Azure Run Command to the Veeam Cloud Message Service.
The Veeam Cloud Message Service uses queue services to send commands to the machine: Amazon Simple
Queue Service (SQS) or Azure Queue Storage. To learn more about these queue services, see AWS
documentation and Microsoft documentation.
To install the Veeam components on the cloud machine, Veeam Backup & Replication uses a distribution
repository. Veeam Backup & Replication uploads installation files to the distribution repository using signed
URLs, and from there the files are downloaded to the cloud machine. The distribution repository is only used to
interchange files between the Veeam Backup & Replication and the machine, not to store backups. For more
information, see Distribution Repository.
IMP ORTANT
If you use the Amazon S3 repository in the China region as a distribution repository, make sure that you
have the ICP license. This license is required to create signed URLs for Amazon S3 repositories in the China
region. For more information, see AWS Documentation.
Veeam Backup & Replication installs the Veeam components on the cloud machine in the follow ing way:
1. Veeam Backup & Replication starts the rescan operation and checks that Amazon SSM or Azure Run
Command can receive and execute commands.
NOTE
Keep in mind that Amazon SSM and Azure Run Command use scripts to execute commands. In some
cases, script execution can be blocked — for example, by a PowerShell execution policy. If this
happens, the Veeam components installation will fail.
2. Veeam Backup & Replication checks that the cloud machine is not managed by another Veeam backup
server.
3. Veeam Backup & Replication creates two queues. Veeam Backup & Replication listens to its queue where a
managed Veeam Agent sends messages. Veeam Agent listens to its queue and Veeam Backup &
Replication sends messages to it.
All managed by Veeam Backup & Replication Veeam Agents send messages to one Veeam Backup &
Replication queue.
5. Veeam Backup & Replication installs Veeam Agent and Veeam Transport Service on the cloud machine.
Communication Scheme
After the installation of Veeam components is completed, Veeam Backup & Replication communicates with the
cloud machine and Veeam Agent in the following way:
1. Veeam Cloud Message Service on Veeam backup server sends a message to the queue service on the
cloud.
2. Veeam Cloud Message Service on the cloud machine with Veeam Agent checks the queue, reads the
message, and performs one of the following operations depending on the message content:
o Runs the command. For example, if your cloud machine runs the Microsoft Windows OS, Veeam Agent
can run the Windows PowerShell command.
o Re-sends the command to another Veeam component. For example, Veeam Agent or Veeam
Transport Service.
3. Veeam Cloud Message Service sends the command result to the queue service.
4. Veeam Backup & Replication reads the queue and receives the command result.
Getting Started
To back up Veeam Agent computer data to a cloud repository, you must complete the following steps:
1. Add the SP in the Veeam backup console. To do this, you must provide credentials of the tenant account
that you obtained from the SP. To learn more, see the Connecting to Service Providers section in the
Veeam Cloud Connect Guide.
2. Create Veeam Agent backup job or policy and specify a cloud repository as a target location for backup
files. To learn more, see Working with Veeam Agent Backup Jobs and Policies.
3. In case some Veeam Agent computer data becomes missing or corrupted, you can restore the necessary
data from the cloud. To learn more, see Restore Tasks with Veeam Agent Backups in Cloud Repository.
NOTE
• In the Veeam Agent management scenario, you do not need to create subtenant accounts to
connect Veeam Agent computers to the Veeam Cloud Connect infrastructure on the SP side. To
learn more, see How It Works.
• If you plan to back up Veeam Agent computer data to the cloud using a backup policy, you must not
connect to the SP using credentials of a vCloud Director tenant account. Veeam Backup &
Replication does not support creating managed subtenant accounts for tenant accounts of this type.
• Veeam Agents must trust the TLS certificate obtained from the SP in the same way as Veeam Backup
& Replication. If you accept the certificate as trusted in Veeam Backup & Replica tion, Veeam Agents
will trust it automatically as well. If you set up the trust relationship on the Veeam backup server,
you must also do this on all Veeam Agent computers that you plan to back up to the cloud
repository.
• Veeam Agents must trust the TLS certificate obtained from the SP. If you accept the certificate as
trusted in Veeam Backup & Replication, Veeam Agents will trust the certificate automatically as
well. IfIf you set up the trust relationship on the Veeam backup server, you must also do this on all
Veeam Agent computers that you plan to back up to the cloud repository.
How It Works
There are 2 scenarios for data backup to the cloud with Veeam Agent operating in the managed mode:
• Scenario 1: backup to the cloud with a backup job managed by the backup server. In this scenario, the
backup process is similar to the same process for VM backup to a cloud repository.
• Scenario 2: backup to the cloud with a backup policy. In this scenario, the backup process is similar to the
same process for Veeam Agent operating in the standalone mode.
1. The tenant adds the SP in the Veeam backup console on the tenant backup server.
2. The tenant creates a Veeam Agent backup job managed by the backup server. The backup job is t argeted
at a cloud repository.
3. The backup job operates in the similar way as in the regular Veeam Cloud Connect Backup scenario. The
difference is that Veeam Backup & Replication processes Veeam Agent computer data instead of VM data.
To learn more about backup to a cloud repository, see the How Cloud Repository Works section in the
Veeam Cloud Connect Guide.
1. The tenant adds the SP in the Veeam backup console on the tenant backup server.
3. For each Veeam Agent computer added to the backup policy, Veeam Backup & Replication automatically
creates a managed subtenant account. To learn more, see the Managed Subtenant Account section in the
Veeam Cloud Connect Guide.
4. Backup jobs that run on Veeam Agent computers added to the backup policy operate in the similar way as
in the standalone version of Veeam Agent. Veeam Agent connects to the SP under the managed subtenant
account and transfers the backed-up data to the cloud repository.
• Restore computer volumes from a Veeam Agent backup (for backups of Microsoft Windows computers
only).
• Restore individual files and folders from a Veeam Agent backup (for backups of Microsoft Windows
computers only).
• Restore application items from a Veeam Agent backup with Veeam Explorers (for backups of Microsoft
Windows and Linux computers only).
• Publish disks from a Veeam Agent backup (for backups of Microsoft Windows computers only).
• Create Veeam Recovery Media from Backup (for backups of Microsoft Windows computers only).
• Export a specific restore point in a Veeam Agent backup to a full backup (VBK) file .
You cannot restore data from a Veeam Agent backup in the cloud repository to a VMware vSphere or Microsoft
Hyper-V VM, Amazon EC2 and Microsoft Azure.
The following Veeam Agents support the object storage as a primary repository for backup jobs, backup policies,
and backup copy jobs:
You can store Veeam Agent backups on the following types of the object storage:
• Amazon S3
• S3 compatible
• IBM Cloud
• Wasabi Cloud
NOTE
Backup to the Veeam Data Cloud Vault storage is supported for the following Veeam Agents:
Veeam Agents communicate with the object storage using one of the following connection modes:
• Connection through a gateway server. With this connection mode, Veeam Agents access object storage
through Veeam Backup & Replication. As a result, Veeam Agent access to object storage is managed by a
proxy component — a gateway server assigned in the Veeam Backup & Replication console. Backup data is
sent from Veeam Agent computer to the gateway server, then it is sent from gateway server to the object
storage.
• Direct connection. With this connection mode, Veeam Agents access object storage directly. Backup data
is sent from Veeam Agent computer to the object storage. Veeam Agent access to object storage is
managed by Application Programming Interface (API) provided by an external cloud service provider. To
learn more, see Access Permissions for Direct Connection to Object Storage.
If you plan to back up to the repository in the object storage in the direct connection mode and a backup
job managed by Veeam Agent, keep in mind that Veeam Agents will still connect to Veeam Backup &
Replication periodically. Using these connections, Veeam Agent will update license and backup job
settings. These connections are not necessary for backup job sessions.
Getting Started
To back up Veeam Agent computer data to an object storage, you must complete the following steps:
1. Add repository in the Veeam backup console. To learn more, see the Adding Object Storage Repositories
section in the Veeam Backup & Replication User Guide.
You can use an object storage in Veeam Backup & Replication as one of the following repositories:
o Backup repository. To learn more, see the Backup Repositories section in the Veeam Backup &
Replication User Guide.
o Scale-out backup repository added as a Veeam backup repository. To learn more, see the Scale-Out
Backup Repositories section in the Veeam Backup & Replication User Guide.
o Cloud repository. To learn more, see the Backup to Object Storage section in the Veeam Cloud
Connect Guide.
2. [For S3 compatible object storage] Set access to the added S3 compatible object storage. To learn more
see the Managing Permissions for S3 Compatible Object Storage section in the Veeam Backup &
Replication User Guide.
3. Create a Veeam Agent backup job or policy and specify the following repository as a targ et location for
backup files:
o If the object storage is configured as a backup repository or a scale-out backup repository in your
infrastructure, specify a Veeam backup repository as a target location for backup files, then select the
repository from the list of available repositories.
o If the object storage is provided to you by Service Provider, specify a Veeam Cloud Connect repository
as a target location for backup files, then select the repository from the list of available repositories.
To learn more, see Working with Veeam Agent Backup Jobs and Policies.
Limitations
Before you configure your backup infrastructure to back up to the object storage, consider the following
limitations:
• You cannot back up data using Veeam Agent backup job or policy to the following storage devices:
o AWS SnowBall
o Azure Databox
• For backups located in object storage repositories, synthetic full backup method is not supported.
• For backups located in object storage repositories, compact full backup file option is not supported.
• For backups located in object storage repositories, data recovery options are not available if you access
the object storage repository using credentials with the read -only access permissions.
• If you plan to add more than one repository in the object storage as a performance tier of a scale-out
backup repository and you plan to back up to these repositories using a direct connection, you can use
only managed by backup server backup jobs. If you want to back up data to a scale-out backup repository
with backup jobs managed by Veeam Agent, you can use only scale-out backup repositories that have only
one repository in the object storage in the direct connection mode as a performance tier.
• [For backup jobs managed by Veeam Agent] If you have a backup job targeted at an object storage added
as an extent of a scale-out backup repository in the direct connection mode and you put this extent to the
Maintenance or Seal mode during the backup job session while there is no connection between Veeam
Backup & Replication and the object storage, the current and subsequent backup job sessions will end
successfully.
To learn about modes you can put extents of scale-out backup repositories to, see the Service Actions with
Scale-Out Backup Repositories section in the Veeam Backup & Replication User Guide.
• [For backup jobs managed by Veeam Agent] You cannot back up data to the Veeam Data Cloud Vault
storage added in the direct connection mode.
• [For backup jobs managed by Veeam Agent for Microsoft Windows or Veeam Agent for Linux] If you back
up data to an object storage added as a Veeam backup repository in the direct connection mode and you
apply backup policy settings after you completed restore to another database from an unencrypted
configuration backup, the application of the settings will fail because in this case temporary credentials to
access the object storage are not stored in the database.
To learn about the configuration backup, see the Veeam Backup & Replication Configuration Database
section in the Veeam Backup & Replication User Guide.
• [For backup jobs managed by backup server] If you back up data to the S3 compatible object storage
added as a Veeam Cloud Connect repository in the direct connection mode, Veeam Agent first transfers
data to Veeam Backup & Replication, and then from Veeam Backup & Replication to the object storage.
• For Microsoft Azure Blob storage, Veeam Agents do not support soft delete for blobs.
• If you plan to back up data to the Microsoft Azure Blob storage using a direct connection, the following
limitations apply:
▪ Backup policies targeted at the object storage added as the Veeam backup repository.
▪ Backup jobs and policies targeted at the object storage added as cloud repository.
To learn more about access tiers for blob data, see Microsoft documentation.
▪ Backup policies targeted at the object storage added as the Veeam backup repository.
To learn more about immutability, see the Immutability for Object Storage Repositories section in the
Veeam Backup & Replication User Guide.
o Veeam Agents do not support direct backup under the general-purpose V1 storage account type.
• Amazon S3
Amazon S3
On the Amazon S3 storage side, Veeam Agent backup is performed with the following steps:
1. Depending on the backup job mode and the way you added the object storage to your infrastructure,
Veeam Backup & Replication performs a certain operation to grant access to the repository in the object
storage:
o For the following job configurations, Veeam Backup & Replication provides Veeam Agents an access
to the repository in the object storage using credentials that were specified during the repository
configuration in the following job configurations:
o For the backup policy targeted at the object storage directly, Veeam Backup & Replication creates a
user in AWS for each Veeam Agent that backs up to AWS.
o For the following job configurations, Veeam Backup & Replication creates a user in AWS for each
tenant:
o For the backup policy targeted at the object storage directly, Veeam Backup & Replication creates a
user in AWS for each subtenant.
To learn more about tenants and subtenants, see the Veeam Cloud Connect Guide.
2. If applicable, Veeam Backup & Replication assigns a policy to each created user. This policy contains access
permissions and allows Veeam Agent access only those backups that were made only by this Veeam
Agent.
• By default, Veeam Backup & Replication assigns an inline policy to the user. All inline policies combined
cannot be greater than 2048 symbols. If you reach this limit, Veeam Backup & Replication starts assigning
managed policies. All managed policies combined cannot be greater than 6144 symbols. If you reach this
limit, refer to the AWS customer support.
• AWS allows to create 1500 managed policies per the AWS account. If you need more policies, refer to the
AWS customer support.
• AWS allows to create 5000 users per the AWS account. If you need more users, use another AWS account.
• Consider that user accounts that you use to connect to the Amazon S3 storage have the required
permissions. To learn more, see Permissions.
1. Depending on the backup job mode and the way you added the object storage to your infrastructure,
Veeam Backup & Replication performs a certain operation to grant access to the repository in the object
storage:
For backup jobs targeted at the Veeam backup repository
o For the following job configurations, Veeam Backup & Replication provides Veeam Agents an access
to the repository in the object storage using credentials that were specified during the repository
configuration:
o For the backup policy targeted at the object storage directly, Veeam Backup & Replication creates a
user for each Veeam Agent that backs up to Google storage.
o For the following job configurations, Veeam Backup & Replication creates a user in Google Cloud for
each tenant:
o For the backup policy targeted at the object storage directly, Veeam Backup & Replication creates a
user in Google Cloud for each subtenant.
To learn more about tenants and subtenants, see the Veeam Cloud Connect Guide.
2. If applicable, Veeam Backup & Replication assigns a policy to each bucket. This policy contains access
permissions and allows Veeam Agent access only those backups that were made only by this Veeam
Agent.
• Policies for buckets have a size limit. If you need to increase the limit, refer to the Google customer
support.
• Keep in mind that Google allows to create 100 users per the Google account. If you need more users, refer
to the Google customer support.
• Consider that user accounts that you use to connect to the Google Cloud storage have the required
permissions. To learn more, see Permissions.
• After you added the S3 compatible object storage, you must configure access permissions manually in the
Veeam Backup & Replication console. If you selected the P rovided by IAM/STS object storage capabilities
option for the object storage, Veeam Backup & Replication will perform the backup operation in the same
way as for the Amazon S3 storage.
To learn more, see the Managing Permissions for S3 Compatible Object Storage section in the Veeam
Backup & Replication User Guide.
• User accounts that you use to connect to the S3 compatible storage have the required permissions. To
learn more, see Permissions.
IMP ORTANT
Backup immutability uses native object storage capabilities. You may incur additional API and storage
charges from the storage provider.
• Amazon S3
NOTE
Veeam Agent does not support backup immutability for the Google Cloud storage.
• [S3 Compatible and Amazon S3 storage] When you create the S3 bucket, you must enable versioning and
the S3 Object Lock feature for the bucket. For more information, see AWS documentation.
• [S3 Compatible and Amazon S3 storage] After you create the S3 bucket with Object Lock enabled, make
sure that the default retention is disabled to avoid unpredictable system behavior and data loss. To
disable the default retention, edit the Object Lock retention settings as described in AWS documentation.
• [Microsoft Azure Blob storage] You must enable blob versioning and version-level immutability support in
the storage account. For more information, see Microsoft documentation.
• The effective immutability period consists of the user-defined immutability period and the block
generation period automatically appended by Veeam Agent. For more information, see How Backup
Immutability Works and Block Generation.
• [S3 Compatible and Amazon S3 storage] Veeam Agent will use the compliance retention mode for each
uploaded object. For more information on retention modes of S3 Object Lock, see AWS documentation.
• [Microsoft Azure Blob storage] Do not enable immutability for already existing containers in the Microsoft
Azure Portal. Otherwise, Veeam Agent will not be able to process these containers properly and it may
result in data loss.
When you create the backup job that is targeted at an object storage, the immutability period must be specified
in the settings of the object storage repository. For more information, see the Adding Object Storage
Repositories section in the Veeam Backup & Replication User Guide.
Veeam Agent will remove the irrelevant restore points per the defined backup retention policy. If the data
associated with the removed restore point is still immutable, such data will remain in the repository until
expiration of the immutability period. After that it will be automatically removed from the storage.
1. Add the object storage repository that contains the necessary data to Veeam Backup & Replication. For
more information, see the Adding Object Storage Repositories section in the Veeam Backup & Replication
User Guide.
2. Roll back to the necessary checkpoint. For more information, see the Immutability section in the Veeam
PowerShell Reference.
3. Remove the repository from the Veeam Backup & Replication infrastructure. For more information, see the
Removing Backup Repositories section in the Veeam Backup & Replication User Guide.
After that, you will be able to use Veeam Agent to restore data from the object repository in a regular manner.
During the effective immutability period, the following operations with backup data in the object storage
repository will be prohibited:
• Removal of data by the technical support department of the object storage provider.
During data transfer, the effective immutability period for the backup is set as follows:
• [For new data blocks in the checkpoint] Immutability is set anew. The user-defined immutability period is
appended with a 10-day block generation period.
• [For data blocks reused from the previous checkpoint] Immutability is extended to the immutability
expiration date set for the new blocks.
• [For data blocks that are not reused in the checkpoint] Immutability is not extended. Such data blocks will
remain in the repository until their immutability period is over. After that Veeam Agent will automatically
remove them from the repository.
Block Generation
When you specify an immutability period for the recent backups, Veeam Agent will automatically add 10 days to
the immutability expiration date. This period is called block generation. The block generation period serves to
reduce the number of requests to the object storage repository, which results in lower traffic and reduced
storage costs. You do not have to configure it, the block generation period is applied automatically.
When the block generation period is appended to the user-defined immutability period, it means there is no
need to extend the immutability period for old data blocks when adding new data blocks to the backup during
that block generation period.
Consider this example. When you create a full backup to start a back up chain, all data blocks transferred to the
object storage repository are new. For these new blocks of data, Veeam Agent will add the block generation
period of 10 days to the specified immutability period. If the immutability period is set by user to the default
period of 30 days, the effective immutability period with the added block generation period will become 40
days. The first full backup starts its generation that will last for 10 days. All new and reused data blocks within
this block generation period will have the same immutability expiration date. For instance, a data block that was
transferred to the target repository on day 9 will have the same immutability expiration date as a data block
transferred on day 1. This mechanism guarantees that the effective immutability period for all the data blocks
within a generation is no less than 30 days.
If a block generation period is over but data blocks from that generation are reused in the newly created
checkpoint, their effective immutability period is automatically extended to ensure that the effective
immutability period for all the data blocks in the new checkpoint is no less than the user -defined immutability
period. For more information, see How Backup Immutability Works.
If you want to use immutability with the deduplicating storage appliances, cons ider the limitations listed in the
following subsections:
If the value of at least one of these periods exceeds the maximum value set for immutability in HPE StoreOnce
Catalyst Store, consider the following:
• If the immutability period specified in the backup repository settings exceeds the maximum value set for
immutability in HPE StoreOnce Catalyst Store, Veeam Backup & Replication applies immutability to the
created backups according to the maximum value set for immutability in HPE StoreOnce Catalyst Store.
• If the long-term retention period configured in backup job settings exceeds the maximum value set for
immutability in HPE StoreOnce Catalyst Store, the immutability period for backups with GFS flags is set
according to the maximum value set for immutability in HPE StoreOnce Catalyst Store. For example, if the
backup is stored for 1 year, but the maximum value for immutability in HPE StoreOnce Catalyst Store is set
to 6 months, the backups will be immutable for 6 months.
To learn more about immutability for the HPE StoreOnce Catalyst repositories, see the HPE StoreOnce and
Immutability section in the Veeam Backup & Replication User Guide.
The minimum and maximum values are included into the range.
• If the immutability period specified in the backup repository settings lies outside the range between the
minimum and maximum retention periods configured in Dell Data Domain, the immutability for backups is
set equal to the nearest range value.
• If the long-term retention period configured in backup job settings lies outside the range between the
minimum and maximum retention periods configured in Dell Data Domain, the immutability period for
backups with GFS flags is set equal to the nearest range value. For example, if the backup is stored for 1
year, but the range for immutability in Dell Data Domain is set to from 2 to 6 months, the backups will be
immutable for 6 months.
To learn more about immutability for the Dell Data Domain backup repositories, s ee the Retention Lock section
in the Veeam Backup & Replication User Guide.
To learn more about the logic behind SureBackup, see the How SureBackup Works section in the Veeam Backup
& Replication User Guide.
Before creating the SureBackup job, check limitations for Veeam Agent backups below. Then learn how to
prepare your backup infrastructure and create a SureBackup job in Using SureBackup Job.
General Limitations
For backups created with Veeam Agent, SureBackup has the following limitations:
• SureBackup is not supported for backup files created by backup copy jobs.
• SureBackup is not supported for backups stored in the Veeam Cloud Connect repository.
• SureBackup is not supported for backups stored in the archive tier of the the scale-out backup repository.
• [For full recoverability testing mode] SureBackup is not supported for backups containing drives greater
than 64 TB.
• [For full recoverability testing mode] If you plan to verify computer recovery with VMware vSphere,
consider the following:
• [For full recoverability testing mode] When Veeam Backup & Replication publishes virtual machines based
on backed-up Veeam Agent computers in the isolated virtual environment, all these virtual machines are
included in the first isolated network added during the virtual lab configuration. To learn more, see the
Create Isolated Networks section in the Veeam Backup & Replication User Guide.
• [For full recoverability testing mode] SureBackup is not supported for file-level backups. You must use
entire machine or volume-level backup of the protected computer. The backup must include the computer
system volume. To learn more about backup types, see the Backup Types section in the Veeam Agent for
Microsoft Windows User Guide.
• [For full recoverability testing mode] SureBackup is not supported if the Microsoft Windows system
partition and boot partition of the backed-up computer are located on different drives.
• [For full recoverability testing mode] If you plan to verify computer recovery with Microsoft Hyper -V,
SureBackup is not supported for application groups with computers connected to different networks.
• [For full recoverability testing mode] If you plan to verify computer recovery with Microsoft Hyper -V,
SureBackup is not supported for EFI-based Veeam Agent computers that run Windows 7, Windows Server
2008 or Windows Server 2008 R2.
• You cannot use SureBackup with backup files created with Veeam Agent for Linux on Power.
• SureBackup job in the Ba ck up verification and content scan only mode is not supported.
• The successful recovery verification is not guaranteed for the following Linux distributions:
o Amazon Linux 2
o openSUSE Tumbleweed
• The successful recovery verification is not guaranteed for backups of Linux -based systems that contain
encrypted devices.
• If you want Veeam Backup & Replication to connect the recovered VM to the virtual network, one of the
following configuration utilities must be installed on the protected computer:
o Netplan
o NetworkManager
o sysconfig
o systemd-networkd
o ifupdown/ifupdown2
• SureBackup is not supported for file-level backups. You must use volume-level backup of the protected
computer. The backup must include the root file system (/) and all partitions specified in the
/etc/fstab file. To learn more about backup types, see the Backup Types section in the Veeam Agent
for Linux User Guide.
• If you have already been using Veeam Agents with Veeam Backup & Replication in the standalone mode,
after you start managing this Veeam Agent with Veeam Backup & Replication, Veeam Agent will start a
new backup chain on a target location. You cannot continue the existing backup chain that was created by
Veeam Agent operating in the standalone mode.
• You cannot map a Veeam Agent backup job or backup policy configured in Veeam Backup & Replication to
a Veeam Agent backup chain created by a standalone Veeam Agent on a backup repository.
NOTE
To learn about system requirements for the Veeam backup server and other Veeam Backup & Replication
components, see the System Requirements section in the Veeam Backup & Replication User Guide.
Sp ecification Requirement
Network: 1 Mbps or faster. High latency and reasonably unstable WAN links
are supported.
File System Microsoft Windows FAT, NTFS, ReFS file systems are supported.
Software The following required 3rd party software is included in the Veeam Agent
for Microsoft Windows Redistributable. During the Veeam Agent
deployment process, Veeam Backup & Replication checks whether all
prerequisite software is available on the target computer. If some of the
required software components are missing, Veeam Backup & Replication
will install missing software automatically.
• Veeam Agent for Microsoft Windows works with only those hard drive types that are supported by the
Microsoft Windows OS. Thus, Veeam Agent supports the 512 bytes and 4 KB sector hard drives only. Other
hard drive types are not supported. To learn more, see this Microsoft article.
• Supported culture settings depend on the version of Microsoft Windows OS installed on your computer.
To learn more, see this Microsoft article.
Veeam kernel module is used for creating system snapshots. The nosnap version of Veeam Agent for Linux
leverages the native snapshot capabilities of the supported file systems. For information on system
requirements for nosnap versions of Veeam Agent for Linux, see System Requirements for Linux Computers
(nosnap Veeam Agent).
NOTE
You can add computers with the nosnap version of Veeam Agent for Linux on Power installed only to the
protection group for pre-installed Veeam Agents.
Sp ecification Requirement
Ha rdware IMP ORTANT! Check considerations and limitations that apply to the list of
supported hardware.
Disk Space: 100–500 MB for product installation. Required disk space varies
depending on the Veeam Agent usage scenario.
OS IMP ORTANT! Check considerations and limitations that apply to the list of
supported OSes.
• RHEL 6
• Oracle Linux 6
File System IMP ORTANT! Check considerations and limitations that apply to the list of
supported file systems.
Veeam Agent for Linux supports consistent snapshot-based data backup for
the following file systems:
The supported file system (except for BTRFS) can reside on a simple volume
or LVM2 volume; volumes protected with encryption software such as dm-
crypt are supported. BTRFS is supported only if it resides directly on a
physical device with no additional abstraction layers (such as LVM, software
RAID, dm-crypt and so on) below or above it.
Other file systems, file systems that are not located on logical volumes, as
well as network file systems like NFS or SMB shares can b e backed up using
the snapshot-less mode only. For details, see the Snapshot-Less File-Level
Backup section in the Veeam Agent for Linux User Guide.
Software IMP ORTANT! Check considerations and limitations that apply to the list of
supported components.
• Only GA versions of the supported distributions that have been released before the current version
of Veeam Agent for Linux are supported.
If a new version of a supported Linux distribution is released after the release of the current version
of Veeam Agent, Veeam Agent may require a patch to support this new OS version. To learn more
about Veeam Agent compatibility with Linux OS versions, see this Veeam KB article. Customers with
a valid contract can request a patch from Veeam Support; for other customers, the support of the
new Linux distribution will be provided with the next release of Veeam Agent.
• To ensure proper functioning of the Veeam kernel module, verify that your system does not have
any of the following modules installed: hcpdriver, snapapi26, snapapi, snapper, dattobd,
dattobd-dkms, dkms-dattobd, cdr or cxbf.
• The Linux OS must be set up to receive software updates from the default repositories enabled in
the OS after installation.
• For cloud-based installations that use customized kernels (such as Linux distributions deployed from
AWS Marketplace or Azure Marketplace that are not in the list of supported OSes), the veeamsnap
kernel module has an experimental support status.
• For backups of cloud machines running Amazon Linux 2 and Amazon Linux 2023, only file-level
restore is supported.
• Automatic Veeam Agent deployment and upgrade from the Veeam backup console is not supported
for the following distributions:
o Fedora
o openSUSE Tumbleweed
You need to install Veeam Agent for Linux directly on a target computer. To learn more, see the
Installing Veeam Agent for Linux section in the Veeam Agent for Linux User Guide.
• Automatic upgrade from Veeam backup console is not supported for manually deployed Veeam
Agents.
• RHEL, CentOS, and Oracle Linux (RHCK) are supported up to certain kernel versions. To learn more,
see this Veeam KB article.
• Ubuntu with Linux kernel for KVM (Kernel-based Virtual Machine) is not supported. For the list of
linux-kvm kernels for Ubuntu, see Ubuntu documentation.
• You must not install Veeam Agent on the server that is used as a hardened repository in the Veeam
Backup & Replication infrastructure.
File System
• Veeam Agent for Linux does not back up volumes that reside on USB devices and SD cards.
o Total size of all file systems must not exceed 216 TiB. This limitation applies to all file systems
where files you plan to back up are located.
Keep in mind that characters that you can use in the file name may be encoded in 2 bytes or
more.
• To store volume snapshots, the blksnap kernel module requires an Ext4, BTRFS or XFS file system.
Snapshot file cannot be stored on multi-device BTRFS.
• Veeam Agent for Linux supports backup of extended attributes with the following limitations:
• Veeam Agent for Linux backs up extended attributes only with the following public namespaces:
system, security, trusted, and user.
• All extended attribute names and values of a file must not exceed 4096 bytes (size of a default
ext4 file system block). Veeam Agent does not back up attributes exceeding the limit.
For the kernel version 4.13 or later, if a value of extended attribute exceeds the limit, Veeam
Agent uses the ea_inodes feature. Backups created using the ea_inodes feature cannot be
mounted on kernel versions up to 4.12.
• Backup of file and directory attributes (for example, a — append only, c — compressed, and so on) is
not supported.
• The veeamsnap module provides RAM-based changed block tracking (CBT) mechanism. Every time
the module is unloaded or Veeam Agent for Linux computer is rebooted, CBT data is reset. As a
result, Veeam Agent reads the entire data added to the backup scope to detect what blocks have
changed since the last job session, and incremental backup requires greater time.
• You cannot back up an entire system image or specific volumes of computers used as cluster nodes.
Only snapshot-less file-level backup of cluster nodes is supported. That includes backup of
computers that use shared disks, clustered file systems, or clustered LVM.
• Certain limitations for Dell PowerPath configuration apply. To learn more, see this Veeam KB article.
• Sparse files are not supported. Veeam Agent for Linux backs up and restores sparse files as regular
files.
• Backup of pseudo file systems, such as /proc, /sys, tmpfs, devfs and others, is not supported.
• Backup of BTRFS volumes and subvolumes with enabled file-system compression is not supported.
Software
IMP ORTANT
Linux user account used to work with Veeam Agent for Linux installed on the protected computer must
have the /bin/bash shell set as the default shell.
• To install Veeam Agent for Linux packages on a target computer, Veeam Backup & Replication uses
the default package manager of the Linux distribution running on this computer. During the
installation process, the package manager checks whether all prerequisite software is available on
the computer. If some of the required software components are missing, the package manager will
attempt to install the missing packages from a software repository configured in the OS.
o dkms
o gcc
o make
o perl
To learn more, see the Installing Veeam Agent for Linux section in the Veeam Agent for Linux User
Guide.
• Version of the following packages varies according to the Linux kernel version that you use:
• For openSUSE and SLES distributions, either of the following packages is required: libncurses5 or
libncurses6.
• The dmidecode package is required for Veeam Agent management — a valid BIOS UUID must be
obtainable either from dmidecode | grep -i uuid or from
/sys/class/dmi/id/product_uuid. Each Veeam Agent that consumes a license installed in
Veeam Backup & Replication must have a unique BIOS UUID. If a valid UUID cannot be obtained,
Veeam will generate it automatically.
• The libmysqlclient package is required to process MySQL database system located on the
Veeam Agent server. Package version varies according to the MySQL database system version that
you use.
• The libpq5 package is required to process PostgreSQL database system located on the Veeam
Agent server.
• The python3 package or another RPM package providing a /usr/bin/python3 binary is required
for CentOS, RHEL 7.0 and later distributions if a pre-built binary kmod-veeamsnap package is to be
installed.
Sp ecification Requirement
Ha rdware [For nosnap Veeam Agent for Linux] CPU: x86 or x64.
[For nosnap Veeam Agent for Linux on Power] CPU: IBM POWER9 or POWER10.
OS Imp ortant! Check considerations and limitations that apply to the list of supported
OSes.
Nosnap Veeam Agent for Linux supports the 64-bit versions of the following
distributions:
Nosnap Veeam Agent supports the 32-bit versions of the following distributions:
• RHEL 6
• Oracle Linux 6
Nosnap Veeam Agent for Linux on P ower supports little endian versions of the
following Linux distributions for IBM Power:
File System Imp ortant! Check considerations and limitations that apply to the list of supported
file systems.
Veeam Agent for Linux supports consistent snapshot-based data backup for the
following file systems:
• All supported file systems that are built on top of LVM logical volumes.
• BTRFS (for OSes that run Linux kernel 3.16 or later)
[For nosnap Veeam Agent for Linux] BTRFS is supported only if it resides
directly on a physical device with no additional abstraction layers (such as
LVM, software RAID, dm-crypt and so on) below or above it.
[For nosnap Veeam Agent for Linux on Power] If BTRFS has additional
abstraction layers (such as LVM, software RAID, dm-crypt and so on) above it,
only file-level restore operations are supported. Instant Recovery, restore
verification (SureBackup), bare metal recovery and volume-level restore are
not supported.
Supported file systems that are not located on logical volumes, other file systems
and network file systems like NFS or SMB shares can be backed up using the
snapshot-less mode only. For details, see the Snapshot-Less File-Level Backup
section in the Veeam Agent for Linux User Guide.
Software Imp ortant! Check considerations and limitations that apply to the list of supported
components.
• libacl
• libattr
• lvm2
• libfuse2 (FUSE libraries for Debian-based and SLES-based systems)
• fuse-libs (FUSE libraries for RedHat-based and Fedora systems)
• dmidecode2
• efibootmgr (for UEFI-based systems) 2
• isolinux (for Debian-based systems) 2
• syslinux (for RedHat-based systems)
• btrfs-progs (for backup of BTRFS file system)
• mksquashfs (for custom Veeam Recovery Media) 2
• unsquashfs (for custom Veeam Recovery Media) 2
• wget (for custom Veeam Recovery Media) 2
• xorriso (for custom Veeam Recovery Media with EFI support) 2
• tar (for file system indexing, log export and rotation)
• gzip (for file system indexing, log export and rotation)
2
Nosnap Veeam Agent for Linux on Power does not require the following packages:
dmidecode, efibootmgr, isolunux, mksquashfs, unsquashfs, wget and xorriso.
• Only GA versions of the supported distributions that have been released before the current version of
Veeam Agent for Linux are supported.
If a new version of a supported Linux distribution is released after the release of the current version of
Veeam Agent, Veeam Agent may require a patch to support this new OS version. For details on Veeam
Agent compatibility with Linux OS versions, see this Veeam KB article. Customers with a valid contract can
request a patch from Veeam Support; for other customers, the support of the new Linux distribution will
be provided with the next release of Veeam Agent.
• The Linux OS must be set up to receive software updates from the default repositories enabled in the OS
after installation.
• You must not install Veeam Agent on the server that is used as a hardened repository in the Veeam Backup
& Replication infrastructure.
File System
• Veeam Agent for Linux does not back up volumes that reside on USB devices and SD cards.
• Total size of all file systems must not exceed 216 TiB. This limitation applies to all file systems where files
you plan to back up are located.
• The amount of space required for LVM snapshots largely depends on the IO intensity. Generally, from 10%
to 20% of the system’s occupied space should be enough for storing an LVM snapshot.
• Veeam Agent supports backup of extended attributes with the following limitations:
o Veeam Agent backs up extended attributes only with the following public namespaces: system,
security, trusted, and user.
o All extended attribute names and values of a file must not exceed 4096 bytes (size of a default ext4
file system block). Veeam Agent does not back up attributes exceeding the limit.
For the kernel version 4.13 or later, if a value of extended attribute exceeds the limit, Veeam Agent
uses the ea_inodes feature. Backups created using the ea_inodes feature cannot be mounted on kernel
versions up to 4.12.
• Backup of file and directory attributes (for example, a — append only, c — compressed, and so on) is not
supported.
• Consider the following about the backup of machines used as cluster nodes:
o To back up data on local LVM volumes, you can use file-level backup or volume-level backup.
• During volume-level backup, data from shared disks, clustered file systems or clustered
LVM will not be backed up.
• To perform volume-level backup, Veeam Agent for Linux will create an LVM snapshot,
which can cause instability of the cluster or cluster software. This can happen due to the
failover conditions configured for the cluster. However, if the cluster instability is caused
by creation of an LVM snapshot only during backup, contact Veeam support for
assistance.
o Backup of clustered file systems using a native file system snapshot is not supported. This includes
snapshots created with the help of custom pre-job or post-job scripts.
• Certain limitations for Dell PowerPath configuration apply. To learn more, see this Veeam KB article.
• Sparse files are not supported. Veeam Agent backs up and restores sparse files as regular files.
• Backup of pseudo file systems, such as /proc, /sys, tmpfs, devfs and others, is not supported.
Software
IMP ORTANT
Linux user account used to work with Veeam Agent for Linux must have the /bin/bash shell set as the
default shell.
• [For nosnap Veeam Agent for Linux] The dmidecode package is required for Veeam Agent management —
a valid BIOS UUID must be obtainable either from dmidecode | grep -i uuid or from
/sys/class/dmi/id/product_uuid. Each Veeam Agent that consumes a license installed in Veeam
Backup & Replication must have a unique BIOS UUID. If a valid UUID cannot be obtained, Veeam will
generate it automatically.
• The libmysqlclient package is required to process MySQL database system located on the Veeam
Agent server. For details, see the MySQL Backup section in the Veeam Agent for Linux User Guide.
Package version varies according to the MySQL database system version that you use.
• The libpq5 package is required to process PostgreSQL database system located on the Veeam Agent
server. For details, see the PostgreSQL Backup section in the Veeam Agent for Linux User Guide.
Sp ecification Requirement
Note:
• IBM AIX 7.3 TL2 is supported starting from Veeam Agent version 4.5.
• Backup of a Virtual I/O Server (VIOS) is not supported.
• Only GA versions of the IBM AIX operating system that have been
released before the Veeam Agent for IBM AIX 4.5 are are supported.
File System All file systems supported by the supported operating systems.
Keep in mind that characters that you can use in the file name may be
encoded in 2 bytes or more.
• Sparse files are not supported. Veeam Agent backs up and restores
sparse files as regular files.
• JFS2 snapshots are not supported.
• Backup of clustered systems (including IBM PowerHA SystemMirror)
is not supported.
Software IMP ORTANT! The user account used to work with Veeam Agent for IBM AIX
installed on the protected computer must have the /bin/bash shell set as
the default shell.
If you upgrade to Veeam Agent for IBM AIX version 12.1 and you have
the mlocate utility provided with one of the previous versions of
Veeam Agent for IBM AIX installed in your system, you must replace
the existing mlocate utility with the mlocate utility provided with
Veeam Agent in the product installation media.
• tar — required for file system indexing, exporting and rotating logs.
It is installed with the product.
• gzip — required for file system indexing, exporting and rotating
logs. It must be installed separately.
• mkisofs — required for creating Veeam recovery Media.
[For IBM AIX 7.3, 7.2 and 7.1 TL1 or higher] This utility is pre-installed
in the OS and does not require separate installation.
[For IBM AIX 7.1 TL0] You must install version 1.13 of the mkisofs
utility.
• [For IBM AIX 7.1] bos.rte.libc version 7.1.5.0 or later must be
installed.
AIX Environment
The LIBPATH AIX environment variable on the Veeam Agent computer must be set to blank (default value). If a
different value is specified for this variable, you must make adjustments to the AIX environment for proper
operation of Veeam Agent. To learn more, see this Veeam KB article.
Sp ecification Requirement
Note: Only GA versions of the Oracle Solaris OS that have been released
before the Veeam Agent for Oracle Solaris version 4.5 are supported.
File System All file systems supported by the supported operating systems.
Keep in mind that characters that you can use in the file name may be
encoded in 2 bytes or more.
• Sparse files are not supported. Veeam Agent backs up and restores
sparse files as regular files.
• Backup of clustered systems is not supported.
Software IMP ORTANT! The user account used to work with Veeam Agent for Oracle
Solaris installed on the protected computer must have the /bin/bash
shell set as the default shell.
For file system indexing, the following utilities are required: tar, mlocate
and gzip.
Sp ecification Requirement
Ha rdware The protected macOS computer must meet the following hardware
requirements:
• 14 Sonoma 2
• 13 Ventura
• 12 Monterey
• 11 Big Sur
• 10.15 Catalina
• 10.14 Mojave
• 10.13.6 High Sierra
2
MacOS 14 Sonoma is supported starting from version 2.1.
File System Veeam Agent supports consistent data backup with snapshot for the APFS
file system.
Keep in mind that characters that you can use in the file name may be
encoded in 2 bytes or more.
• [For Veeam Agent for IBM AIX 4.5 and Veeam Agent for Oracle Solaris 4.5] Veeam Backup & Replication
version 12.1 or later backup repository
• Direct attached storage (DAS), such as USB, eSATA or Firewire external drives, and raw device mapping
(RDM) volumes
IMP ORTANT
[For Veeam Agent for Microsoft Windows] Storage devices with the exFAT file system are not
supported as a backup target.
• Network Attached Storage (NAS) able to represent itself as an SMB (CIFS) share
• Network Attached Storage (NAS) able to represent itself as an NFS share (for backups of Linux and Unix
computers only)
• [For Veeam Agent for Microsoft Windows 6.2, Veeam Agent for Linux 6.2 and Veeam Agent for Mac 2.2]
Veeam Backup & Replication version 12.2 backup repository
• [For Veeam Agent for IBM AIX 4.5 and Veeam Agent for Oracle Solaris 4.5] Veeam Backup & Replication
version 12.1 or later backup repository
IMP ORTANT
Veeam Cloud Connect repository is not supported as a backup and backup copy target for the
following Veeam Agents:
100 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Network
Consider the following about network requirements:
• Veeam Agent must be able to establish a direct IP connection to the Veeam Backup & Replication server.
Thus, Veeam Agent cannot work with Veeam Backup & Replication that is located behind the NAT
gateway.
• For communication between Veeam backup infrastructure and computers you want to back up, one of the
following authentication protocols is required:
o Kerberos
IMP ORTANT
Veeam Agents support the Kerberos authentication protocol and IPv6 addresses starting from
the following versions:
Veeam Backup & Replication 12.2 is not able to use the Kerberos authentication protocol and
IPv6 addresses to communicate with earlier versions of Veeam Agents. To start using these
features, upgrade Veeam Agents. To learn more, see Upgrading Veeam Agent.
To learn more about new features see the following sections of the Veeam Backup & Replication
User Guide:
• Kerberos Authentication
• IPv6 Support
• Domain names of all managed servers added to the Veeam backup infrastructure and computers you want
to back up must be resolvable into IPv4 or IPv6 addresses.
Keep in mind that for Veeam Agent computers that are included in a protection group for pre -installed
Veeam Agents, only Veeam Backup & Replication server must be resolvable into IPv4 or IPv6 address.
101 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Licensing Requirements
The Veeam Agent management functionality is licensed by the number of instances. Instances are units (or
tokens) that you can use to protect your computers (servers and workstations) with Veeam Agents. The number
of instances that you can use depends on the type of license installed in Veeam Backup & Replication:
• Per-instance license. If you use a per-instance license in Veeam Backup & Replication, the number of
servers and workstations that you can process with Veeam Agents depends on the edition of Veeam
Backup & Replication and the number of instances in the license. For more information, see Veeam
Licensing Policy.
• Per-socket license. If you use a per-socket license in Veeam Backup & Replication, the product allows you
to use up to 6 instances to process Veeam Agents. If the number of sockets in your license is less than 6,
you can use the number of instances that equals the number of sockets in the license. For example, if the
number of sockets in the license is 5, you can use 5 instances. If the number of sockets in the license is 7,
you can use 6 instances.
NOTE
Keep in mind that if you want to use Veeam Agent to protect a VM residing on a virtualization host,
Veeam Backup & Replication will use sockets to license such a VM. In this scenario, Veeam Agent will
not consume instances in the license, but if no sockets are available, Veeam Agent will not be able to
perform backup.
• Community edition. If you do not install a license in Veeam Backup & Replication, you can use the
Community edition of the product. The Community edition of Veeam Backup & Replication allows you to
use 10 instances. Functionality available in the Community edition of Veeam Backup & Replication is the
same as in the Standard edition of the product.
Keep in mind that in the Community edition of the product, you cannot use Veeam Agents to protect
computers running on Unix or Linux on Power. To protect such computers, you must use the Enterprise
Plus edition of the product.
For more information on Veeam Backup & Replication licensing, see the Licensing section in the Veeam Backup
& Replication User Guide.
3. On the Instances tab, clear the Allow unlicensed agents to consume instances check box.
102 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. Click Close.
If you do not want to restrict license consumption for all managed Veeam Agents, you can revoke a license from
specific Veeam Agents.
2. In the License Information window, click the Instances tab and click Ma nage.
3. In the Licensed Instances window, select a Veeam Agent and click Remove.
103 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Keep in mind that Veeam Agent will start consuming the license again during the next backup job session.
104 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Permissions
For general requirements for permissions that must be provided to the user account to install and work with
Veeam Backup & Replication, see the Permissions section in the Veeam Backup & Replication User Guide. In
addition to general port requirements, for the Veeam Agent management scenarios the follow ing permissions
must be provided .
Keep in mind that the list of required permissions differs depending on the functionality that you use. Make sure
that user accounts have permissions listed in the following subsections:
NOTE
If you plan to back up data using a direct connection between the Veeam Agent computer and object
storage, consider the access permissions in Access Permissions for Direct Connection to Object Storage.
{
"actions": [
"Microsoft.Compute/virtualMachines/instanceView/read",
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Compute/virtualMachines/runCommand/action",
"Microsoft.Resources/subscriptions/locations/read",
"Microsoft.Storage/storageAccounts/read"
],
"notActions": [],
"dataActions": [],
"notDataActions": []
}
• If you use an existing Microsoft Azure Compute Account, make sure to assign the required permissions.
• If you create a new Microsoft Azure Compute Account with Veeam Backup & Replication, the required
permissions are assigned to the newly created account automatically.
105 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To learn more, see the Microsoft Azure Compute Accounts section in the Veeam Backup & Replication User
Guide.
{
"ec2:AssociateIamInstanceProfile",
"ec2:DescribeIamInstanceProfileAssociations",
"ec2:DescribeInstances",
"iam:AddRoleToInstanceProfile",
"iam:AttachRolePolicy",
"iam:CreateInstanceProfile",
"iam:CreateRole",
"iam:GetRole",
"iam:PassRole",
"iam:SimulatePrincipalPolicy",
"sqs:*",
"ssm:DescribeInstanceInformation",
"ssm:GetCommandInvocation",
"ssm:SendCommand",
"ssm:UpdateManagedInstanceRole"
}
• Amazon S3
Amazon S3
Consider the following:
• Make sure the user account you are using has access to Amazon buckets and fold ers.
• The ListAllMyBuckets permission is not required if you specify the bucket name explicitly at the Buck et
step of the New Ob ject Repository wizard.
• If you plan to use Amazon S3 storage with immutability enabled, see permissions required for immutabi lity
in the Using Object Storage Repositories section in the Veeam Backup & Replication User Guide. To learn
more about immutability, see Backup Immutability.
Make sure that your infrastructure configuration fits the following description:
106 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• You selected direct connection in the object storage settings. To learn more, see the Adding Amazon S3
Object Storage section in the Veeam Backup & Replication User Guide.
If you plan to back up data using such infrastructure configuration, make sure the user account that you use to
connect to the object storage has the following permissions:
{
"iam:AttachUserPolicy",
"iam:CreateAccessKey",
"iam:CreatePolicy",
"iam:CreatePolicyVersion",
"iam:CreateUser",
"iam:DeleteAccessKey",
"iam:DeletePolicy",
"iam:DeletePolicyVersion",
"iam:DeleteUser",
"iam:DeleteUserPolicy",
"iam:DetachUserPolicy",
"iam:GetPolicy",
"iam:GetPolicyVersion",
"iam:GetUser",
"iam:GetUserPolicy",
"iam:ListAccessKeys",
"iam:ListAttachedUserPolicies",
"iam:ListPolicyVersions",
"iam:ListUserPolicies",
"iam:PutUserPolicy",
"iam:SetDefaultPolicyVersion",
"iam:TagUser"
}
• Make sure the user account you are using has access to Amazon buckets and folders.
• The ListAllMyBuckets permission is not required if you specify the bucket name explicitly at the Buck et
step of the New Ob ject Repository wizard.
• If you plan to use Amazon S3 storage with immutability enabled, see permissions required for immutability
in the Using Object Storage Repositories section in the Veeam Backup & Replication User Guide. To learn
more about immutability, see Backup Immutability.
Make sure that your infrastructure configuration fits the following description:
• Direct connection is selected in the object storage settings. To learn more, see the Specify Object Storage
Account section in the Veeam Backup & Replication User Guide.
• The P rovided by IAM/STS object storage capabilities option is selected for the object storage. To learn
more, see the Managing Permissions for S3 Compatible Object Storage section in the Veeam Backup &
Replication User Guide.
107 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
If you plan to back up data using such infrastructure configuration, make sure the user account that you use to
connect to the object storage has the following permissions:
{
"iam:AttachUserPolicy",
"iam:CreateAccessKey",
"iam:CreatePolicy",
"iam:CreatePolicyVersion",
"iam:CreateUser",
"iam:DeleteAccessKey",
"iam:DeletePolicy",
"iam:DeletePolicyVersion",
"iam:DeleteUser",
"iam:DeleteUserPolicy",
"iam:DetachUserPolicy",
"iam:GetPolicy",
"iam:GetPolicyVersion",
"iam:GetUser",
"iam:GetUserPolicy",
"iam:ListAccessKeys",
"iam:ListAttachedUserPolicies",
"iam:ListPolicyVersions",
"iam:ListUserPolicies",
"iam:PutUserPolicy",
"iam:SetDefaultPolicyVersion",
"sts:GetCallerIdentity"
}
• You configured Helper Appliance in the object storage settings. To learn more, see the Configuring Helper
Appliance section in the Veeam Backup & Replication User Guide.
• You selected direct connection in the object storage settings. To learn more, see the Specify Object
Storage Account section in the Veeam Backup & Replication User Guide.
108 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
If you plan to back up data using such infrastructure configuration, make sure the user account that you specify
in the Helper Appliance settings has the following permissions:
{
"iam.serviceAccounts.create",
"iam.serviceAccounts.delete",
"iam.serviceAccounts.get",
"iam.serviceAccounts.list",
"storage.buckets.get",
"storage.buckets.getIamPolicy",
"storage.buckets.list",
"storage.buckets.setIamPolicy",
"storage.buckets.update",
"storage.hmacKeys.create",
"storage.hmacKeys.delete",
"storage.hmacKeys.get",
"storage.hmacKeys.list",
"storage.objects.create",
"storage.objects.delete",
"storage.objects.get",
"storage.objects.list"
}
• For Linux computers, choose a user account with root privileges and with the home directory created.
• If you plan to perform file indexing for Microsoft Windows computers, choose a user account that has
administrator privileges.
• If you plan to use guest processing over network for Microsoft Windows computers without listed
applications, choose a user account that has administrator privileges.
• When using Active Directory accounts, make sure to provide a user account in the DOMAIN\Username
format.
• When using local user accounts, make sure to provide a user account in the Username or HOST\Username
format.
• To process a Domain Controller server, make sure that you are using a user account that is a member of
the DOMAIN\Administrators group.
• To back up a Read-Only Domain controller, a delegated RODC administrator account is sufficient. For more
information, see Microsoft Documentation.
109 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Depending on the application you need to back up, the user must have the permissions listed in the following
table:
Microsoft SQL To back up Microsoft SQL Server data, the user whose account you plan to use must
Server be:
If you need to provide minimal permissions, the user account must be assigned the
following roles and permissions:
Microsoft Active To back up Microsoft Active Directory data, the user account must be a member of the
Directory built-in Administrators group.
Microsoft To back up Microsoft Exchange data, the user account must have the local
E x change Administrator permissions in Microsoft Exchange.
To back up Oracle data on a Microsoft Windows computer, the user account must be
configured as follows:
• The user account must be a member of both the Local Administrators group and
the ORA_DBA group (if OS authentication is used).
• The user account must be granted SYSDBA privileges.
110 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Ap p lication Required P ermission
On Linux computers
To back up Oracle data on a Linux computer, the user account must be configured as
follows:
• The user account must be granted SYSDBA privileges.
• To back up Oracle database archived logs, the user account must have the
primary membership in the Oracle Inventory Group (oinstall) group. To learn
how to configure the Oracle Inventory Group, see Oracle documentation.
Also, consider the following about backup of Oracle data on a Linux computer:
• You can use either the same account that was specified at the Guest Processing
step if such an account is a member of the OSDBA and OINSTALL groups, or you
can use any other account that has SYSDBA privileges. For more information
about specifying a user account, see Application-Aware Processing.
• To perform guest processing for Oracle databases on Linux servers, make sure
that the /tmp directory is mounted with the exec option. Otherwise, you will get
a "Permission denied" error.
Microsoft To back up Microsoft SharePoint server, the user account must have the Farm
Sha rePoint Administrator role.
To back up Microsoft SQL databases of the Microsoft SharePoint Server, the user
account must have the same privileges as for the Microsoft SQL Server.
My SQL To process the MySQL database system, the MySQL user account must have the
following privileges:
• SELECT for all tables. This privilege is required to allow Veeam Agent to access
table metadata. To learn more, see MySQL documentation.
• LOCK TABLES. This privilege is required to allow Veeam Agent to process tables
based on the MyISAM storage engine.
• RELOAD. This privilege is required to allow the MySQL account to perform
FLUSH operations.
P ostgreSQL To back up PostgreSQL instances, the user account must have the superuser privileges
for the PostgreSQL instance. For more information, see PostgreSQL documentation.
111 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Ports
The following tables describe network ports that must be opened to ensure proper communication of
components in the Veeam Agent management infrastructure.
For general requirements for ports that must be opened to ensure proper communication of the backup server
with Veeam Cloud Connect infrastructure components, see the Ports section in the Veeam Cloud Connect Guide.
In addition to general port requirements applicable to a backup server, the following network ports that must
be opened to enable proper communication between Veeam Backup & Replication components.
Veeam Veeam Agent TCP 6184+ Default port used for communication with
Backup Computer the Veeam Agent for Microsoft Windows
Server (Microsoft Service.
Windows)
If port 6184 is already in use, Veeam
Agent for Microsoft Windows Service tries
to use the next port number in the
allocated range (6184 to 6194). Once the
service takes the next available port, it
makes it the default port for all
subsequent connections.
112 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
113 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
114 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
Distribution Veeam Agent TCP 49152 to Dynamic RPC port range. For more
Server Computer 65535 information, see this Microsoft KB article.
(Microsoft
Windows) The port range is required for
communication with the Veeam Installer
Service.
115 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
Veeam Agent Veeam TCP 10005 Default port used by Veeam Agent for
Computer Backup Microsoft Windows operating in the
(Microsoft Server managed mode for communication with
Windows) the Veeam Backup server.
116 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
Veeam Agent Veeam TCP 10002, Default ports used for communication
Computer Backup 10006 with the Veeam Backup server.
(Linux) Server
Data between the Veeam Agent computer
and backup repositories is transferred
directly, bypassing Veeam backup servers.
Veeam Agent Veeam TCP 10006 Default port used for communication with
Computer Backup the Veeam Backup server.
(Unix, Server
macOS) Data between the Veeam Agent computer
and backup repositories is transferred
directly, bypassing Veeam backup servers.
Veeam Agent Veeam Agent TCP 9395+, 6183+ Ports used locally on the Veeam
Computer Computer Agent computer for communication
(Microsoft (Microsoft between Veeam Agent components
Windows) Windows) and Veeam Agent for Microsoft
Windows Service.
Veeam Agent Veeam Agent TCP 2500 to 3300 Default range of ports used locally
Computer Computer for communication between Veeam
(Linux, Unix, (Linux, Unix, Agent components during data
macOS) macOS) transmission. For every TCP
connection that a backup job uses,
one port from this range is assigned.
117 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Communication with Veeam Backup Repositories
The following table describes network ports that must be opened to ensure proper communication between
Veeam Agent and Veeam backup repositories.
Veeam Agent Linux server TCP 2500 to 3300 Default range of ports used as data
Computer performing the transmission channels. For every
role of a backup TCP connection that a job uses,
repository one port from this range is
assigned.
118 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
Gateway Linux TCP 2500 to 3300 Default range of ports used as data
server transmission channels. For every
TCP connection that a job uses,
one port from this range is
assigned.
Veeam Agent Computer Cloud gateway TCP 6180 Port on the cloud gateway
(Microsoft Windows, used to transport Veeam
Linux, macOS) Agent data to the Veeam
Cloud Connect repository.
119 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Communication with Object Storage
The following table describes network ports that must be opened to ensure proper communication with object
storage if you back up data to object storage that Veeam Agent accesses directly. For more information about
object storage connection modes, see Backup to Object Storage.
Gateway Amazon S3 TCP 443 Used to communicate with the Amazon S3 object
server or object storage through the following endpoints:
backup storage
• *.amazonaws.com (for both Global and
server
Government regions)
• *.amazonaws.com.cn (for China region)
120 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
• crl.pki.goog
IBM Cloud TCP Depends on Used to communicate with IBM Cloud object
object device storage.
storage configuration
121 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Communication with Cloud Machines
The following table describes network ports that must be opened to ensure proper communication between
Veeam Backup & Replication and Veeam Agents installed on Amazon EC2 instances or Microsoft Azure virtual
machines (both objects can be also referred to as cloud machines).
TCP 443
122 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
From To P rotocol P ort/Endpoint Notes
123 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
From To P rotocol P ort Notes
124 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Supported Applications
Veeam Agent for Microsoft Windows
You can use Veeam Agent for Microsoft Windows operating in the managed mode to create transactionally
consistent backups of servers running applications that support Microsoft VSS. System requirements for VSS-
aware processing are listed in the following table.
Microsoft Active Directory The following versions of Microsoft Active Directory Domain Services
Doma in Controllers servers (domain controllers) are supported:
• Microsoft Windows Server 2022
• Microsoft Windows Server 2019
• Microsoft Windows Server 2016
• Microsoft Windows Server 2012 R2
• Microsoft Windows Server 2012
• Microsoft Windows Server 2008 R2 SP1
Microsoft SharePoint The following versions of Microsoft SharePoint Server are supported:
• Microsoft SharePoint Server Subscription Edition
• Microsoft SharePoint Server 2019
• Microsoft SharePoint Server 2016
• Microsoft SharePoint Server 2013
125 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Sp ecification Requirements and Limitations
Microsoft SQL Server The following versions of Microsoft SQL Server are supported:
• Microsoft SQL Server 2022
• Microsoft SQL Server 2019
• Microsoft SQL Server 2017
• Microsoft SQL Server 2016 SP2
• Microsoft SQL Server 2014 SP3
• Microsoft SQL Server 2012 SP4
• Microsoft SQL Server 2008 R2 SP3
• Microsoft SQL Server 2008 SP4
Ora cle Oracle Database versions 11g to 21c are supported for the following
operating systems (32-bit and 64-bit architecture):
• Microsoft Windows Server 2022
• Microsoft Windows Server 2019
• Microsoft Windows Server 2016
• Microsoft Windows Server 2012 R2
• Microsoft Windows Server 2012
• Microsoft Windows Server 2008 R2 SP1
IMP ORTANT!
• Automatic Storage Management (ASM) is not supported.
• Oracle Real Application Clusters (RAC) are not supported.
• Oracle Database systems running on Microsoft Windows Failover
Clusters are not supported.
• Oracle servers using Data Guard are not supported .
• Oracle Database Express Edition is supported.
• Configurations with different versions of Oracle Database deployed
on the same server are not supported.
• 32-bit Oracle running on 64-bit operating systems is not supported.
126 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Agent for Linux
You can use Veeam Agent for Linux operating in the managed mode to create transactionally consistent backups
of servers running Oracle, MySQL, and PostgreSQL database systems. For information on the limitations of data
base processing, see Backup of Database Systems. System requirements for database processing are listed in the
following table.
• Oracle Database versions 11g to 21c are supported for all operating
Ora cle
systems supported by Veeam Agent for Linux. To learn more, see
System Requirements.
• Automatic Storage Management (ASM) is not supported.
• Oracle Real Application Clusters (RAC) are not supported.
• Oracle Grid Infrastructure is not supported.
• Oracle Database Express Edition is not supported.
• SAP on Oracle is not supported.
• Oracle Database architectures with Data Guard and passive instances
are not supported.
127 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Supported Veeam Agents
The following table describes what Veeam Agents are supported by the Veeam Backup & Replication depending
on the product usage scenario.
Veeam Agent 4.0 4.0 2.0 2.0 N/A Veeam Backup & Replication 12.2 can
upgrade detect these versions of Veeam
Agent, but does not support backup
operations for them. To start working
with Veeam Backup & Replication
12.2, you must upgrade Veeam
Agents. To learn more, see Upgrading
Veeam Agents.
Veeam Agent 5.0 – 6.2 5.0 – 3.0 – 3.0 – 1.0 – Veeam Backup & Replication 12.2
backup 6.2 4.5 4.5 2.2 supports backup operations for these
Veeam Agent versions.
Automated 6.2 6.2 4.5 4.5 N/A If you set up Veeam Backup &
Veeam Agent Replication 12.2 to deploy or upgrade
deployment Veeam Agents on protected
from Veeam computers included in a protection
Backup & group, these Veeam Agent versions
Replication are deployed. To learn more, see
Protected Computers Discovery and
Veeam Agent Deployment.
128 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Scenario Veeam Veeam Veeam Veeam Veeam Description
Ag ent for Ag ent Ag ent Ag ent Ag ent
Microsoft for for IBM for for
W ind ows Linux AIX Ora cle Ma c
Version Version Version Solaris Version
Version
129 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Getting Started
To start using the Veeam Agent management functionality in Veeam Backup & Replication, you must perform
the following operations:
To learn more, see the Deployment section in the Veeam Backup & Replication User Guide.
By default, Veeam Backup & Replication offers the following settings to establish a secure connection
between the backup server and protected computers:
o To establish a secure connection between parties, Veeam Backup & Replication uses the default self -
signed certificate.
o Veeam Backup & Replication allows all new Linux hosts to establish a connection to the backup
server.
You can use the default security settings or change them if needed. To learn more, see Configuring
Security Settings.
3. Add computers that you want to protect with Veeam Agents to the Veeam Backup & Replication
inventory.
In Veeam Backup & Replication, computers that you want to protect with Veeam Agents are organized into
protection groups. You can use the Veeam Backup & Replication console to create one or more protection
groups that include individual computers, Microsoft Active Directory objects or list of computers imported
from a CSV file. To learn more, see Creating Protection Groups.
Veeam Backup & Replication is set up to automatically discover protected computers and install Veeam
Agent on a discovered computer. By default, these operations are performed immediately after you create
a protection group. You can change Veeam Agent discovery and deployment options in the protection
group settings, if needed. You can also run discovery and deployment operations manually for an entire
protection group, individual Active Directory object in a protection group or individual computer in a
protection group. To learn more, see Working with Protection Groups and Managing Protected Computers.
Make sure to install all available updates for the operating system on the computer you want to p rotect.
Otherwise, the correct functioning of Veeam Agent is not guaranteed.
You can configure one or more Veeam Agent backup jobs and add to these jobs one or more protection
groups, Active Directory objects and individual computers. In Veeam Backup & Replication, you can
configure the following types of Veeam Agent backup jobs:
o Veeam Agent backup job managed by Veeam Agent, or Veeam Agent backup pol icy
To learn more, see Working with Veeam Agent Backup Jobs and Policies.
You can start, stop, enable and disable Veeam Agent backup jobs and policies to administer data
protection operations on protected computers. To learn more, see Working with Veeam Agent Backup
Jobs and Policies.
130 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
7. In case of a disaster, you can restore data from a Veeam Agent backup.
131 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Configuring Security Settings
When you configure the Veeam Agent management infrastructure in Veeam Backup & Replication, you can
specify what security settings Veeam Backup & Replication will use to establish a secure connection between
the backup server and protected computers. By default, Veeam Backup & Replication offers the following
security settings:
• To establish a secure connection between parties, Veeam Backup & Replication uses the default self -
signed TLS certificate.
• Veeam Backup & Replication allows all computers that run a Linux OS, except computers with pre -
installed Veeam Agents, to establish a connection to the backup server using the SSH fingerprint. To learn
more about computers with pre-installed Veeam Agents, see Deploying Veeam Agents Using Generated
Setup Files.
Keep in mind that default security settings are only for testing and evaluation purposes. To prevent potential
security issues, you can change security settings. For example, you can use a custom TLS certificate and
verification of Linux host SSH fingerprints.
3. In the Certificate section, check information about the currently used certificate. By default, Veeam
Backup & Replication uses a self-signed TLS certificate generated during the Veeam Backup & Replication
installation process. If you want to use a custom certificate, click Install and specify a new certificate. To
learn more, see Managing TLS Certificates.
4. In the Linux hosts authentication section, specify how Veeam Backup & Replication will add Linux -based
protected computers to the list of trusted hosts. You can select one of the following options:
o Ad d all discovered hosts to the list automatically — with this option enabled, Veeam Backup &
Replication allows all discovered computers that run a Linux OS to connect to the backup server. This
scenario is recommended for demo environments only.
o Ad d unknown hosts to the list manually (more secure) — with this option enabled, only the following
Linux-based computers can connect to the backup server:
▪ Protected computers that have already established a connection to the backup server and have
their fingerprints stored in the Veeam Backup & Replication database. Veeam Backup &
Replication displays the number of such computers in the Trusted hosts field. You can export
the list of trusted Linux computers to a known_hosts file. To do this, click E x port and specify a
path to the folder to save the file.
▪ Protected computers specified in the known_hosts file imported to Veeam Backup & Replication.
To import a known_hosts file, click Imp ort and specify a path to the folder where the file resides.
When you specify a trusted host in the known_hosts file, it must follow the same format as the
~/.ssh/known_hosts file. It must include the network name hash, the type of key, and the
public key.
132 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Example of a trusted host entry:
|1|y/XiVUB2z/ZBb3vuOYm0x9RUiQA=|9zTpxEaAKbGPe7JyS/OyIWvsTz8= ssh-ed2
5519 AAAAC3NzaC1lZDI1NTE5AAAAIHhO7S1tp0EAgainstjkXSAi4a+JIPKnTUpABC8
BGyWk9
▪ Protected computers added to the list of trusted hosts in the Veeam Backup & Replication
console. To learn more, see Adding Computers to Trusted Hosts List.
Computers that are not in the list of trusted hosts cannot connect to the Veeam backup server and
download Veeam Agent for Linux installation packages during discovery.
5. Click OK.
TIP
To learn more about other security settings available on the Security tab, see the Configuring Security
Settings section in the Veeam Backup & Replication User Guide.
133 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Managing TLS Certificates
When you configure the Veeam Backup & Replication infrastructure, you can specify what TLS certificate must
be used to establish a secure connection from backup infrastructure components to the backup server. Veeam
Backup & Replication offers the following options for TLS certificates:
• Keep the default self-signed TLS certificate generated by Veeam Backup & Replication at the process of
upgrading to a new version of Veeam Backup & Replication.
• Use Veeam Backup & Replication to generate a new self-signed TLS certificate. To learn more, see
Generating Self-Signed Certificates.
• Select an existing TLS certificate from the certificate store. To learn more, see Importing Certificates from
Certificate Store.
• Import a TLS certificate from a file in the PFX format. To learn more, see Importing Certificates from PFX
Files.
If you plan to use a certificate issued by your own Certificate Authority (CA), make sure that the certificate
meets the requirements. For more information, see Using Certificate Signed by Internal CA.
NOTE
• To avoid potential synchronization issues, make sure that Veeam Agents are synchronized with
Veeam Backup & Replication before you change the existing certificate. To learn more, see Rescan
Job.
• [For protection groups for pre-installed Veeam Agents] If you change the existing certificate, you
must export a new package with setup files to deploy Veeam Agents on new computers that you
want to add to the protection group.To learn more, see Specifying Packages.
134 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Generating Self-Signed Certificates
You can use Veeam Backup & Replication to generate a self-signed certificate for authenticating parties in the
Veeam Backup & Replication infrastructure.
To generate TLS certificates, Veeam Backup & Replication employs the RSA Full cryptographic service provider
by Microsoft Windows installed on the backup server. The created TLS certificate is saved to the Shared
certificate store. The following types of users can access the generated TLS certificate:
If you use a self-signed TLS certificate generated by Veeam Backup & Replication, you do not need to take
additional actions to deploy the TLS certificate on a protected computer. When Veeam Backup & Replication
discovers a protected computer, a matching TLS certificate with a public key is installed on the protected
computer automatically. During discovery, Veeam Installer Service deployed on the protected computer
retrieves the TLS certificate with a public key from the backup server and installs a TLS certificate with a public
key on the protected computer.
NOTE
When you generate a self-signed TLS certificate with Veeam Backup & Replication, you cannot include
several aliases to the certificate and specify a custom value in the Subject field. The Subject field value is
taken from the Veeam Backup & Replication license installed on the Veeam backup server.
IMP ORTANT
If you update the TLS certificate used on the backup server, you must also update info about the certificate
on the specific backup infrastructure components as described in section Managing TLS Certificates.
135 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. At the Certificate Type step of the wizard, select Generate new certificate.
5. At the Generate Certificate step of the wizard, specify a friendly name for the created self-signed TLS
certificate.
6. At the Summary step of the wizard, review the certificate properties. Use the Cop y to clipboard link to
copy and save information about the generated TLS certificate. You will be able to use the copied
information to verify the TLS certificate with the certificate thumbprint.
136 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
7. Click Finish. Veeam Backup & Replication will save the generated certificate in the Shared certificate store
on the Veeam backup server.
137 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Importing Certificates from Certificate Store
If the Veeam backup server has been issued a TLS certificate signed by a CA and the TLS certificate is located in
the Microsoft Windows certificate store, you can use this certificate for authenticating parties in the Veeam
Backup & Replication infrastructure.
To select a certificate from the Microsoft Windows certificate store, do the following:
4. At the Certificate Type step of the wizard, choose Select certificate from the Certificate Store.
5. At the P ick Certificate step of the wizard, select a TLS certificate that you want to use. You can select only
certificates that contain both a public key and a private key. Certificates without private keys are not
displayed in the list.
138 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Importing Certificates from PFX Files
You can import a TLS certificate in the following situations:
• Your organization uses a TLS certificate signed by a CA and you have a copy of this certificate in a file of
PFX format.
• You have generated a self-signed TLS certificate in the PFX format with a third-party tool and you want to
import it to Veeam Backup & Replication.
NOTE
• The TLS certificate must pass validation on the Veeam backup server. Otherwise, you will not be
able to import the TLS certificate.
• If a PFX file contains a certificate chain, only the end entity certificate will be imported.
4. At the Certificate Type step of the wizard, choose Imp ort certificate from a file.
5. At the Imp ort Certificate step of the wizard, specify a path to the PFX file.
139 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
6. If the PFX file is protected with a password, specify the password in the P a ssword field.
7. At the Summary step of the wizard, review the certificate properties. Use the Cop y to clipboard link to
copy and save information about the TLS certificate. You can use the copied information on a protected
computer to verify the TLS certificate with the certificate thumbprint.
140 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Using a Certificate Signed by Internal or Public
CA
If you want to use a certificate signed by a public or internal Certification Authority (CA), consider the following:
• Make sure that Veeam Backup & Replication server and Veeam Agents trust the CA. That means that the
Certification Authority certificate must be added to the Trusted Root Certification Authority store on the
Veeam Backup & Replication server. Also, Certificate Revocation List (CRL) must be accessible from the
Veeam Backup & Replication server.
• If you use Windows Server Certification Authority, issue a Veeam Backup & Replication certificate based on
the built-in Subordinate Certification Authority template or templates similar to it. You can manage
templates with the Certificate Templates MMC snap-in.
• [For Linux-based Veeam Agent computers] OpenSSL version 1.0 or later must be installed on the Veeam
Agent computer.
IMP ORTANT
• The certificate subject is equal to the fully qualified domain name of the Veeam Backup & Replication
server. For example: vbrserver.domain.local.
• The Sub ject Alternative Name field contains both the FQDN and the NetBIOS name. You can add multiple
DNS entries in the following format: DNS:vbrserver.domain.local,DNS:vbrserver.
o Digital Signature
o Certificate Signing
141 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Off-line CRL Signing
If you use Windows Server Certification Authority, open the Certificate Templates MMC snap-in and
select the certificate template based on the built-in Subordinate Certification Authority template or
templates similar to it. On the E x tensions tab, enable the Do not a llow subject to issue certificates to
other CAs option.
142 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To start using the signed certificate, you must select it from the certificates store on the Veeam Backup &
Replication server. To learn more, see Importing Certificates from Certificate Store.
143 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Adding Computers to Trusted Hosts List
After you enable the Ad d unknown hosts to the list manually (more secure) option in Veeam Backup &
Replication settings, Linux-based computers whose SSH fingerprints are not stored in the Veeam Backup &
Replication database become unable to communicate to the Veeam backup server. During discovery, Veeam
Backup & Replication puts such computers to the Untrusted protection group. To start managing an untrusted
computer, you must manually validate the SSH fingerprint and add the computer to the list of trusted hosts in
the Veeam Backup & Replication console.
2. In the inventory pane, expand the P hy sical Infrastructure node and click Untrusted.
3. In the working area, Veeam Backup & Replication will display discovered computers that you can add to
the list of trusted hosts. Check SSH fingerprints of the computers and add them to the list of trusted hosts
in one of the following ways:
o To add all computers at once to the list of trusted hosts, select the Untrusted node in the inventory
pane and click Trust All on the ribbon or right-click the Untrusted node and select Trust a ll.
144 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
o To add a specific computer to the list of trusted hosts, select the necessary computer in the working
area and click Trust on the ribbon or right-click the computer and select Trust.
145 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Working with Protection Groups
IMP ORTANT
Protection groups for pre-installed Veeam Agents offer a limited set of operations. To learn more, see
Working with Protection Groups for Pre-Installed Veeam Agents.
In Veeam Backup & Replication, Veeam Agent computers are organized into protection groups. You can perform
the following operations with protection groups:
For protection groups for pre-installed Veeam Agents, you can perform the following operations:
146 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Protection Groups
You must add computers that you plan to protect with Veeam Agents to the inventory in the Veeam Backup &
Replication console. In Veeam Backup & Replication, protected computers are organized into protection groups.
You can create one or more protection groups that contain computers of different types or offer different
discovery and deployment options.
NOTE
• We recommend that you include each computer in one protection group only. For example, if you
have added an Active Directory container to a protection group, it is not recommended to add a
computer that exists in this container to another protection group. Adding computers to multiple
protection groups with different computer discovery and Veeam Agent deployment settings will
result in additional load on the backup server.
You cannot add a computer from a protection group for pre-installed Veeam Agents to any other
protection group.
• Each time you add a Veeam Agent computer to the protection group, Veeam Backup & Replication
considers this Veeam Agent computer as a new object. For example, if you add a Veeam Agent
computer to the protection group, then remove this Veeam Agent computer from the protection
group and add to the same protection group again, Veeam Backup & Replication will consider this
Veeam Agent computer as two different objects. As a result, Veeam Agent will start a new backup
chain each time you add the Veeam Agent computer to the protection group.
IMP ORTANT
The current guide does not cover subjects related to protection groups that include applications. To learn
about this protection group type, see the Creating Protection Group for MongoDB Deployments section in
the Veeam Plug-ins for Enterprise Applications Guide.
• Individual computers — create a protection group for these objects if you want to define a static
protection scope by adding specific computers to the protection group. This option is recommended for
smaller environments that do not have Microsoft Active Directory deployed.
• Microsoft Active Directory objects — create a protection group for these objects if you want to add to the
protection group one or several Active Directory objects: entire domain, container, organizational unit,
group, computer or failover cluster. Protection groups that include Active Directory containers or
organizational units are dynamic in their nature. If a new computer is added to a container or
organizational unit that you have specified in the protection group settings, during the next rescan
session, Veeam Backup & Replication will discover this computer and (optionally) deploy Veeam Agent on
this computer.
NOTE
You can add a failover cluster only to a protection group that includes Microsoft Active Directory
objects.
147 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• Computers from CSV file — create a protection group for these objects if you want to add to the protection
scope computers listed in a CSV or TXT file that resides in a local folder on the backup s erver or in an SMB
network shared folder. As well as protection groups that include Active Directory containers, protection
groups of this type are also dynamic. If a new computer appears in the file after the protection job is
created, within the next rescan session, Veeam Backup & Replication will automatically update the
protection group settings to include the added computer.
• Computers with pre-installed backup agents — create a protection group for these objects if you want to
create a protection group for pre-installed Veeam Agents. This protection group will include any number
of computers that use a certain temporary certificate to connect to the Veeam backup server. A temporary
certificate is a unique identification number generated for each protection group that is available among
other connection settings in a configuration file. You will obtain the configuration file along with Veeam
Agent setup files after the protection group is created. Using these setup files, y ou must deploy Veeam
Agent and apply connection settings from the configuration file on the Veeam Agent computer. After
that, Veeam Agent connects to the Veeam backup and Veeam Backup & Replication includes the Veeam
Agent computer in the protection group.
The Computers with pre-installed backup agents option is the only applicable option for the following
objects: Mac computers with pre-installed Veeam Agent for Mac and Linux computers with pre-installed
Veeam Agent for Linux on Power.
IMP ORTANT
Make sure that the setup and configuration files are stored in a secure place. If a third -party uncovers
the files, they can use any host to connect to the protection group, receive the configuration options,
create backups and perform other actions.
To learn more about Veeam Agents deployment, see Deploying Veeam Agents Using Generated Setup
Files.
• Cloud machines — create a protection group for these objects if you want to add to the protection group
one or several Amazon EC2 instances or Microsoft Azure virtual machines (both objects can be also
referred to as cloud machines). Using this protection group, Veeam Backup & Replication will discover
such cloud machines and deploy Veeam Agent for Microsoft Windows or Veeam Agent for Linux on them
without connection over network. After that, you will be able to create transactionally consistent backups
of cloud machines included in the protection group.
148 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Protection Group for Individual
Computers
Before you create a protection group for individual computers, check prerequisites. Then use the New
P rotection Group wizard to configure a protection group.
3. Specify computers.
6. Review components.
7. Assess results.
• When Veeam Backup & Replication performs discovery of protected computers, Veeam Backup &
Replication connects to every computer added to the protection group. If you instruct Veeam Backup &
Replication to perform discovery immediately after the protection group is created, make sure that all
computers added to the protection group are powered on and may be accessed over the network.
Otherwise, Veeam Backup & Replication will be unable to connect to a protected computer and perform
the required operations on this computer.
• We recommend that you do not add a computer to a protection group by specifying a dynamic IP address
assigned to this computer. If such computer receives another IP address from a DHCP serve r, Veeam
Backup & Replication will be unable to discover the computer and perform on this computer operations
defined in the protection group settings.
• We recommend that you do not add a computer to a protection group by specifying a public IP address
assigned to this computer. If you add such computer to a backup policy targeted at a cloud repository, the
name of the subtenant account created for the computer can contain the public IP address. This IP address
will be visible to the Veeam Cloud Connect service provider who has access to subtenant account settings.
• To deploy Veeam Installer Service and Veeam Agent for Microsoft Windows on a protected computer,
Veeam Backup & Replication uses the administrative share (admin$) of the target computer. An acc ount
that you plan to use to connect to a computer included in the protection group must have access to the
administrative share.
Note that in client Microsoft Windows OSes access to the administrative share is forbidden by default for
local accounts. You can enable this option with a registry key. To learn more, see this Microsoft KB article.
• Veeam Backup & Replication does not support usage of a Linux account for which system settings modify
shell output results to connect to a computer included in the protection group. For example, this includes
Linux accounts with the modified PS1 shell variable.
149 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• To connect to the Linux-based computer where you want to install Veeam Agent for Linux, you must specify
the user account that has a home directory. The specified user account must also have the read and write
permissions for their home directory.
• You must not install Veeam Agent on the server that is used as a hardened repository in the Veeam Backup
& Replication infrastructure.
150 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 1. Launch New Protection Group Wizard
To launch the New P rotection Group wizard, do the following:
1. Open the Add Protection Group window. To open the window, do one of the following:
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Ad d
Group on the ribbon.
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Create
P rotection Group in the working area.
o Open the Inventory view. Right-click the P hy sical Infrastructure node in the inventory pane and select
Ad d protection group.
2. In the Ad d Protection Group window, select the Ind ividual computers option.
151 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 2. Specify Protection Group Name and Description
At the Na me step of the wizard, specify a name and description for the protection group.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who added the protection group, date and time when the protection group
was created.
152 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Computers
At the Comp uters step of the wizard, specify computers that you want to add to the protection group.
1. Click Ad d .
2. In the Ad d Computer window, in the Host name or IP address field, enter a full DNS name, NetBIOS name
or IP address of the computer that you want to add to the protection group.
o Connect using admin credentials. In this case, from the Credentials list, select a user account that has
administrative permissions on the computer that you want to add to the protection group. Veeam
Backup & Replication will use this account to connect to the protected computer and perform the
necessary operations on the computer: upload and install Veeam Agent, and so on.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials.
▪ Stored credentials. Select stored credentials if you want Veeam Backup & Replication to use the
specified user name and password for each connection to Veeam Agent.
▪ [For Linux computers] Single-use credentials. Select single-use credentials if you do not want
Veeam Backup & Replication to store credentials in the configuration database. With this option
selected, Veeam Backup & Replication will use the specified user name and password to deploy
Veeam components. After the components are successfully deployed, Veeam Backup &
Replication will use Veeam Transport Service to communicate with the Veeam Agent computer.
Keep in mind that the username must be specified in the down-level logon name format. For example,
DOMAIN\UserName or HOSTNAME\UserName. Use the full domain or hostname name. Do not replace
them with a dot.
For more information, see the Credentials Manager section in the Veeam Backup & Replication User
Guide.
o [For Linux computers] Connect using certificate-based authentication. Select this option, if you chose
to pre-install Veeam Deployer Service on the Linux computer that you want to ad d to the protection
group. In this case, Veeam Backup & Replication will communicate with the Linux computer using a
certificate. Veeam Backup & Replication will install Transport Service that will be used to perform the
necessary operations on the computer: upload and install Veeam Agent, and so on. To learn more, see
Deploying Veeam Agent for Linux Using Pre-Installed Veeam Deployer Service.
4. Repeat steps 1–3 for every computer that you want to add to the protection group.
5. To check if Veeam Backup & Replication can communicate with computers added to the protection group,
click Test Now. Veeam Backup & Replication will use the specified method to connect to all computers in
the list.
153 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
If you chose to manually add Linux-based computers to the list of trusted hosts in Veeam Backup &
Replication, when you test credentials for an unknown Linux-based computer in the protection group
settings, the test operation will complete with the Failed status. This happens because Veeam Backup &
Replication cannot connect to the untrusted computer before you add this computer to the list of trusted
hosts. To learn more, see Adding Computers to Trusted Hosts List.
154 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 4. Specify Discovery and Deployment Options
At the Op tions step of the wizard, specify settings for protected computers discovery and Veeam Agent
deployment.
Veeam Backup & Replication regularly connects to protected computers according to the schedule define d in
the protection group settings. At this step of the wizard, you can define the discovery schedule and specify
operations that Veeam Backup & Replication must perform on discovered computers. You can also select which
server in your backup infrastructure should act as a distribution server for Veeam Agents.
1. In the Discovery section, define schedule for automatic computer discovery within the scope of the
protection group:
o To run the rescan job at specific time daily, on defined week days or with specific periodicity, select
Da ily at this time. Use the fields on the right to configure the necessary schedule.
o To run the rescan job repeatedly throughout a day with a specific time interval, select P eriodically
every. In the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and
use the time table to define the permitted time window for the rescan job. In the Sta rt time within an
hour field, specify the exact time when the job must start.
o To run the rescan job continuously, select the P eriodically every option and choose Continuously from
the list on the right. A new rescan job session will start as soon as the previous rescan job session
finishes.
NOTE
You cannot create a protection group without defining schedule for automatic discovery. However,
you can disable automatic discovery for a specific protection group, if needed. To learn more, see
Disabling Protection Group.
2. In the Dep loyment section, from the Distribution server list, select a Microsoft Windows server that you
plan to use as a distribution server. Veeam Backup & Replication will use the distribution server to upload
Veeam Agent setup files to computers added to the protection group. By default, Veeam Backup &
Replication assigns the distribution server role to the backup server. To lear n more, see Distribution
Server.
3. If you want to instruct Veeam Backup & Replication to automatically deploy Veeam Agents on all
discovered computers in the protection group, in the Deployment section, make sure that the Install
b a ckup agent check box is selected.
You can also choose to disable automated Veeam Agent installation. In this case, you will need to install
Veeam Agent on every computer included in the protection group and discovered by Veeam Backup &
Replication. To learn more, see Installing Veeam Agent.
Keep in mind that Veeam Backup & Replication installs the Veeam Installer Service or Veeam Deployer
Service and Veeam Transport Service on every computer added to the protection group even if the Install
b a ckup agent check box is not selected in the protection group settings.
IMP ORTANT
Automatic installation of nonsnap Veeam Agent for Linux is not available. If you want to add a
computer with nonsnap Veeam Agent for Linux to a protection group, you must deploy Veeam Agent
on the protected computer first. For more information on standalone installation of nonsnap Veeam
Agent for Linux, see the Installation and Configuration section of the Veeam Agent for Linux User
Guide.
155 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
To learn how to use protection groups to automatically deploy Veeam plug -ins for enterprise
applications, see Veeam Plug-ins for Enterprise Applications Guide.
4. If you want to instruct Veeam Backup & Replication to automatically upgrade Veeam Agent on discovered
computers when a new version of Veeam Agent appears on the Veeam Backup & Replication server, in the
Dep loyment section, make sure that the Auto-update backup agents and plug-ins check box is selected.
IMP ORTANT
Automatic upgrade of nosnap Veeam Agent for Linux is not available. You must upgrade such Veeam
Agents on the protected computer side, manually or using third -party tools.
5. [For protection groups that include Microsoft Windows computers] Select the Install changed b lock
tra cking driver check box if you want to install the advanced changed block tracking (CBT) driver on
computers protected with Veeam Agent for Microsoft Windows.
Keep in mind that Veeam Backup & Replication will install the CBT driver only on those computers that run
supported Microsoft Windows OS versions.
To learn more, see the Veeam Changed Block Tracking Driver section in the Veeam Agent for Microsoft
Windows User Guide.
TIP
Veeam Backup & Replication 12 can install the CBT driver on a wider range of Microsoft Windows OS
versions, but Veeam Backup & Replication will not install drivers automatically after upgrade. To
install drivers in the existing protection group on the comp uters running OS versions that got
support only in Veeam Backup & Replication 12, open the E d it Protection Group wizard, make sure
that the Install changed block tracking driver check box is selected and re-save the protection group.
6. Select the P erform reboot automatically if required check box to allow Veeam Backup & Replication to
reboot a protected computer. In particular, the reboot operation is required as part of the Veeam CBT
driver installation process.
156 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
7. Click Ad vanced to specify advanced settings for the protection group. To learn more, see Specify
Advanced Protection Group Settings.
157 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Specify Advanced Protection Group Settings
In the Ad vanced Settings window, specify advanced settings for the protection group:
• Notification settings
TIP
After you specify necessary settings for the protection group, you can save them as default settings. To do
this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window. When you create a
new protection group, Veeam Backup & Replication will automatically apply the default settings to the
new protection group.
• Network usage settings. You can limit bandwidth consumption and restrict network connections usage for
Veeam Agent for Microsoft Windows backup jobs. Limiting bandwidth consumption prevents jobs from
utilizing the entire bandwidth available in your environment and makes sure that enough traffic is
provided for other network operations. In addition to limiting bandwidth consumption, you can choose
whether to allow backup over metered connections and VPN connections. For Microsoft Windows
workstations that run Veeam Agent, you can also specify one or more wireless networks over which
Veeam Agent is allowed to perform backup or restrict usage over any wireless networks.
To learn more, see the Restricting Network Connections Usage section in the Veeam Agent for Microsoft
Windows User Guide.
IMP ORTANT
Network usage settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
• Ba ckup I/O settings. You can instruct Veeam Agent for Microsoft Windows to throttle its activities during
backup. This option can help you avoid situations when backup tasks performed by Veeam Agent for
Microsoft Windows consume all available hard disk resources and hinder work of other applications and
services on a protected computer. With throttling enabled, Veeam Backup & Replication sets low priority
for Veeam Agent components running on protected computers and eng aged in the backup process. If this
option is not enabled, Veeam Agent components have normal priority.
• Security settings. You can allow user accounts that do not have administrative privileges on a Veeam
Agent computer to perform file-level restore on this computer.
IMP ORTANT
Security settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
Veeam Backup & Replication applies the specified settings to Veeam Agent that runs on a protected computer
added to a backup policy. Veeam Backup & Replication applies the settings during the protection group rescan
process. Settings are saved to the Veeam Agent for Microsoft Windows database on the protected computer.
158 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To specify settings for Veeam Agent for Microsoft Windows:
2. If you want to limit bandwidth consumption for Veeam Agent backup jobs, on the Ag ent for W indows tab,
in the Network section, select the Limit bandwidth consumption to check box. Then specify the maximum
speed for transferring backed-up data from the Veeam Agent computer to the target location.
3. By default, backup over metered connections is disabled for Veeam Agent for Microsoft Windows. Veeam
Agent automatically detects metered connections and does not perform backup when your computer is on
such connection. To enable backup over metered connections, clear the Restrict metered connections
usa ge check box.
NOTE
• Veeam Agent for Microsoft Windows disables backup over metered Internet connections only
on computers that run Microsoft Windows 8 and later. If the computer runs an earlier version
of Microsoft Windows, this option is not applicable.
• You must specify which connections are metered in Microsoft Windows. To learn more, see
this Microsoft webpage.
4. If you want to disable backup over VPN connections, select the Restrict VPN connections usage check box.
Veeam Agent for Microsoft Windows will automatically detect VPN connections and will not perform
backup when the Veeam Agent computer is on such connection.
5. If you want to restrict usage of wireless networks for Veeam Agent running on Microsoft Windows
workstations, do the following:
a. Select the Restrict Wi-Fi usage to these networks only check box and click Ad d .
b. In the Wi-Fi Network window, specify the SSID of the Wi-Fi network over which Veeam Agent will be
allowed to perform backup, and click OK.
Veeam Backup & Replication will add the specified network to the list of allowed Wi-Fi networks. Backup
over other wireless networks will be disabled for Veeam Agent.
TIP
If you want to restrict usage over any wireless networks, select the Restrict Wi-Fi usage to these
networks only check box and do not add any networks to the list.
6. If you want to throttle Veeam Agent activities during backup, in the Ba ckup I/O control section, make sure
that the Throttle agent activity on option is selected. Then select the type of computers on which to
throttle Veeam Agent backup activities: Workstations only , Servers only or All hosts.
If you do not want to throttle backup activities for Veeam Agent, select Do not throttle agent.
7. In the Security section, select the Allow file level recovery without administrative account check box. With
this option enabled, Veeam Agent computer users who work under accounts that do not have
administrative privileges will be able to perform file-level restore on the Veeam Agent computer.
In this case, access rights to files and folders are managed by Veeam Agent computer OS. If user cannot
access the folder in the original location, this user cannot browse or restore the content of this folder as
well.
159 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To learn more, see Restoring Files from Backup without Administrator Privileges.
Notification Settings
You can specify email notification settings for the protection group. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with protection group statistics to a specified email address.
The report contains cumulative statistics for rescan job sessions performed for the protection group within the
last 24-hour period.
NOTE
Email reports with protection group statistics will be sent only if you configure global email notification
settings in Veeam Backup & Replication. For more information, see the Configuring Global Email
Notification Settings section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the protection group, in addition to reports sent according to the
global email notification settings, Veeam Backup & Replication will send reports with the protection group
statistics to email addresses specified in the protection group settings. This allows you to fine-tune email
notifications in Veeam Backup & Replication: while one or more backup administrators receive email
notifications according to the global settings, other backup administrators can receive reports for specific
protection groups only.
If you do not enable global email notification settings in Veeam Backup & Replication, notification settings
for the protection group will not be sent even if you enable them in the protection group settings.
160 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. Select the Send daily agent status report e -mail to the following recipients check box and specify a
recipient’s email address. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the daily
email report for the protection group.
5. You can choose to use global notification settings or specify custom notification settings.
To receive a typical notification for the protection group, select Use global notification settings. In this
case, Veeam Backup & Replication will apply to the protection group global email notification settings
specified for the backup server.
To configure a custom notification for the protection group, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
o In the Sub ject field, specify a notification subject. You can use the following variables in the subject:
▪ %FoundCount% — number of new computers discovered within the last 24-hour period.
▪ %SeenCount% — number of computers in the protection group that were online for the last 24
hours. A computer is considered to be online if Veeam Backup & Replication successfully
connected to this computer during the last rescan session.
o Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the protection group rescan job completes successfully, completes with a warning or
fails.
161 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Review Components
At the Review step of the wizard, review what Veeam Backup & Replication components are already installed on
the distribution server specified for the protection group and what components will be installed.
NOTE
Veeam Agent and Veeam Plug-in components are installed on the distribution server even if the Install
a p plication plug-ins and Install backup agent check boxes are clear at the Options step of the wizard.
162 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Assess Results
At the Ap p ly step of the wizard, Veeam Backup & Replication will create the configured protection group. Wait
for the operation to complete and click Nex t to continue.
163 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Finish Working with Wizard
At the Summary step of the wizard, complete the protection group configuration process.
2. To start the rescan job after you close the wizard, make sure that the Run d iscovery when I click Finish
option is selected.
If you want to perform computer discovery later, you can clear the Run d iscovery when I click Finish check
box. In this case, the rescan job will start automatically upon the defined schedule. You can also start the
rescan job manually at any time you need. To learn more, see Starting Protection Group Discovery.
164 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Protection Group for Microsoft Active
Directory Objects
Before you create a protection group for Microsoft Active Directory objects, check prerequisites. Then use the
New P rotection Group wizard to configure a protection group.
5. Specify credentials.
8. Review components.
9. Assess results.
• When Veeam Backup & Replication performs discovery of protected computers, Veeam Backup &
Replication connects to every computer added to the protection group. If you instruct Veeam Backup &
Replication to perform discovery immediately after the protection group is created, make sure that all
computers added to the protection group are powered on and may be accessed over the network.
Otherwise, Veeam Backup & Replication will be unable to connect to a protected computer and perform
the required operations on this computer.
• A protection group that includes Microsoft Active Directory objects can include objects from one domain
only. To add to the inventory computers that reside in another domain, you need to cr eate a separate
protection group and include in this protection group the necessary objects from that domain.
• Veeam Backup & Replication automatically excludes from the protection scope Active Directory objects of
the Group type that exist in a parent Active Directory object (organizational unit, container or entire
domain) specified in the protection group settings. To instruct Veeam Backup & Replication to process a
group, you must select this group explicitly in the protection group settings.
• You cannot add or exclude universal and domain local groups to/from protection groups that include
Microsoft Active Directory objects. Only global groups are supported.
• When you configure a protection group for a failover cluster, do not exclude nodes of this c luster from a
protection scope. Otherwise, Veeam Backup & Replication will not have complete information about all
clustered servers.
165 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• To deploy Veeam Installer Service and Veeam Agent for Microsoft Windows on a protected computer,
Veeam Backup & Replication uses the administrative share (admin$) of the target computer. An account
that you plan to use to connect to a computer included in the protection group must have access to the
administrative share.
Keep in mind that in client Microsoft Windows OSes access to the administrative share is forbidden by
default for local accounts. You can enable this option with a registry key. To learn more, see this Microsoft
KB article.
166 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Protection Group Wizard
To launch the New P rotection Group wizard, do the following:
1. Open the Add Protection Group window. To open the window, do one of the following:
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Ad d
Group on the ribbon.
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Create
P rotection Group in the working area.
o Open the Inventory view. Right-click the P hy sical Infrastructure node in the inventory pane and select
Ad d protection group.
2. In the Ad d Protection Group window, select the Microsoft Active Directory objects option.
167 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 2. Specify Protection Group Name and Description
At the Na me step of the wizard, specify a name and description for the protection group.
2. In the Description field, provide a description for future reference. The default des cription contains
information about the user who added the protection group, date and time when the protection group
was created.
168 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Active Directory Objects
At the Active Directory step of the wizard, select Active Directory objects that you want to add to the protection
group. You can add to a protection group the following types of Active Directory objects: domain, organizational
unit, container, computer, failover cluster, or group.
1. In the Sea rch for objects in this d omain field, click Cha nge.
2. In the Sp ecify Domain window, specify settings of the domain whose objects you want to include in the
protection group:
a. In the Doma in controller or domain DNS name field, type a name of the domain controller or domain
whose objects you want to include in the protection group.
b. In the P ort field, specify a port number over which Veeam Backup & Replication must communicate
with the domain controller. By default, Veeam Backup & Replication uses port 389.
c. From the Account list, select a user account that is a member of the DOMAIN\Administrators group. If
you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials. For more information, see the Credentials Manager section in the Veeam Backup &
Replication User Guide.
NOTE
If you want to include a large number of computers in the protection group but do not want to use
an account with domain administrator permissions in the protection group settings, consider
configuring a protection group based on a list of computers imported from a CSV file. To learn more,
see Creating Protection Group for Computers from CSV File.
4. In the Ad d Objects window, select the necessary Active Directory object in the tree and click OK. You can
press and hold the [Ctrl] key to select multiple objects at once.
To quickly find the necessary object, you can use the search field at the bottom of the Ad d Objects
window.
a. Click the button to the left of the search field and select the necessary type of object to search for:
Everything , Computer, Failover Cluster , Organizational Unit, Container, or Group .
169 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
c. Click the Sta rt search button on the right or press [Enter].
170 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 4. Exclude Objects from Protection Group
At the E x clusions step of the wizard, you can specify which objects you want to exclude from the protection
group. You can exclude the following types of objects:
• All virtual machines — all VMs residing in the domain. You can select this option, for example, if you do not
want to protect VMs with Veeam Agents and want to back up VM data with Veeam Backup & Replication
instead.
• All computers that have been offline for over 30 days — all computers in the domain that have not logged
on to Active Directory for more than 30 days.
• Specific Active Directory objects: computers, failover clusters, groups, organizational units and containers.
1. In the E x clude section, select the The following objects check box.
2. Click Ad d .
3. In the Ad d Objects window, select the necessary Active Directory object in the tree and click OK. You can
press and hold the [Ctrl] key to select multiple objects at once.
To quickly find the necessary Active Directory object, you can use the search field at the bottom of the Ad d
Ob jects window.
1. Click the button to the left of the search field and select the necessary type of object to search for:
Everything , Computer, Failover cluster, Group, Organizational Unit, or Container.
171 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. Click the Sta rt search button on the right or press [Enter].
172 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Specify Credentials
At the Credentials this step of the wizard, specify credentials to connect to computers included in the protection
group:
1. If you want to use the same credentials for all computers in the protection group, select the necessary
user account from the Ma ster a ccount list. The account must have local administrator permissions on all
computers that you have added to the protection group.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
Select stored credentials if you want Veeam Backup & Replication to use the specified user name and
password for each connection to Veeam Agent.
Keep in mind that the username must be specified in the down-level logon name format. For example,
DOMAIN\UserName or HOSTNAME\UserName. Use the full domain or hostname name. Do not replace
them with a dot.
For more information, see the Credentials Manager section in the Veeam Backup & Replication User Guide.
2. By default, Veeam Backup & Replication uses credentials specified in the Ma ster account field for all
computers in the protection group. If some computer requires a different user account, do the following:
a. Select the Use custom credentials for the following objects check box.
b. Click Ad d next to the list of objects and select the necessary object in the Ad d Objects window:
▪ If you configure a protection group that includes Active Directory objects, objects that you have
added to the protection group at the Active Directory step or the wizard are already displayed in
the Use custom credentials for the following objects list. In the Ad d Objects window, you can
also select child objects for which you want to specify custom credentials. For example, you may
want to specify separate credentials for different organizational units, containers, groups or
individual computers within the entire domain added to the protection group.
c. In the Use custom credentials for the following objects list, select the necessary object, click E d it and
select custom credentials for the object. Credentials must be specified in the following format:
NOTE
• Veeam Backup & Replication supports user account names in the SAM-Account-Name format
(DOMAIN\Username). The User-Principal-Name (UPN) format ( username@domain) is not supported.
If you specify credentials in the UPN format, Veeam Backup & Replication will successfully connect
to computers added to the protection group during the Test Now operation. However, the
subsequent protection group rescan operations will fail.
• If you configure a protection group that includes dynamic Active Directory objects, such as domain,
organizational unit, container or group, the master account or custom account specified for an
object must be a member of the DOMAIN\Administrators group.
• You cannot use an Azure Active Directory account to connect to computers included in the
protection group.
173 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To check if Veeam Backup & Replication can connect to computers added to the protection group, click Test
Now. Veeam Backup & Replication will form a list of computers to connect and use the specified credentials to
connect to computers in the list.
174 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Discovery and Deployment Options
At the Op tions step of the wizard, specify settings for protected computers discovery and Veeam Agent
deployment.
Veeam Backup & Replication regularly connects to protected computers according to the schedule defined in
the protection group settings. At this step of the wizard, you can define the discovery schedule and specify
operations that Veeam Backup & Replication must perform on discovered computers. You can also select which
server in your backup infrastructure should act as a distribution server for Veeam Agents.
1. In the Discovery section, define schedule for automatic computer discovery within the scope of the
protection group:
o To run the rescan job at specific time daily, on defined week days or with specific periodicity, select
Da ily at this time. Use the fields on the right to configure the necessary schedule.
o To run the rescan job repeatedly throughout a day with a specific time interval, select P eriodically
every. In the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and
use the time table to define the permitted time window for the rescan job. In the Sta rt time within an
hour field, specify the exact time when the job must start.
o To run the rescan job continuously, select the P eriodically every option and choose Continuously from
the list on the right. A new rescan job session will start as soon as the previous rescan job session
finishes.
NOTE
You cannot create a protection group without defining schedule for automatic discovery. However,
you can disable automatic discovery for a specific protection group, if needed. To learn more, see
Disabling Protection Group.
2. In the Dep loyment section, from the Distribution server list, select a Microsoft Windows server that you
plan to use as a distribution server. Veeam Backup & Replication will use the distribution server to upload
Veeam Agent setup files to computers added to the protection group. By default, Veeam Backup &
Replication assigns the distribution server role to the backup server. To learn more, see Distribution
Server.
3. If you want to instruct Veeam Backup & Replication to automatically deploy Veeam Agents on all
discovered computers in the protection group, in the Deployment section, make sure that the Install
b a ckup agent check box is selected.
You can also choose to disable automated Veeam Agent installation. In this case, you will need to install
Veeam Agent on every computer included in the protection group and discovered by Veeam Backup &
Replication. To learn more, see Installing Veeam Agent.
Keep in mind that Veeam Backup & Replication installs the Veeam Installer Service or Veeam Deployer
Service and Veeam Transport Service on every computer added to the protection group even if the Install
b a ckup agent check box is not selected in the protection group settings.
TIP
To learn how to use protection groups to automatically deploy Veeam plug-ins for enterprise
applications, see Veeam Plug-ins for Enterprise Applications Guide.
4. If you want to instruct Veeam Backup & Replication to automatically upgrade Veeam Agent on discovered
computers when a new version of Veeam Agent appears on the Veeam Backup & Replication server, in the
Dep loyment section, make sure that the Auto-update backup agents and plug-ins check box is selected.
175 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
5. Select the Install changed block tracking driver check box if you want to install the advanced changed
block tracking (CBT) driver on computers protected with Veeam Agent for Microsoft Windows.
Keep in mind that Veeam Backup & Replication will install the CBT driver only on those computers that run
supported Microsoft Windows OS versions.
To learn more, see the Veeam Changed Block Tracking Driver section in the Veeam Agent for Microsoft
Windows User Guide.
TIP
Veeam Backup & Replication 12 can install the CBT driver on a wider range of Microsoft Windows OS
versions, but Veeam Backup & Replication will not install drivers automatically after upgrade. To
install drivers in the existing protection group on the computers running OS versions that got
support only in Veeam Backup & Replication 12, open the E d it Protection Group wizard, make sure
that the Install changed block tracking driver check box is selected and re-save the protection group.
6. Select the P erform reboot automatically if required check box to allow Veeam Backup & Replication to
reboot a protected computer. In particular, the reboot operation is required as part of the Veeam CBT
driver installation process.
7. Click Ad vanced to specify advanced settings for the protection group. To learn more, see Specify
Advanced Protection Group Settings.
176 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 7. Specify Advanced Protection Group Settings
In the Ad vanced Settings window, specify advanced settings for the protection group:
• Notification settings
TIP
After you specify necessary settings for the protection group, you can save them as default settings. To do
this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window. When you create a
new protection group, Veeam Backup & Replication will automatically apply the default settings to the
new protection group.
• Network usage settings. You can limit bandwidth consumption and restrict network connections usage for
Veeam Agent for Microsoft Windows backup jobs. Limiting bandwidth consumption prevents jobs from
utilizing the entire bandwidth available in your environment and makes sure that enough traffic is
provided for other network operations. In addition to limiting bandwidth consumption, you can choose
whether to allow backup over metered connections and VPN connections. For Microsoft Windows
workstations that run Veeam Agent, you can also specify one or more wireless networks over which
Veeam Agent is allowed to perform backup or restrict usage over any wireless networks.
To learn more, see the Restricting Network Connections Usage section in the Veeam Agent for Microsoft
Windows User Guide.
IMP ORTANT
Network usage settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
• Ba ckup I/O settings. You can instruct Veeam Agent for Microsoft Windows to throttle its activities during
backup. This option can help you avoid situations when backup tasks performed by Veeam Agent for
Microsoft Windows consume all available hard disk resources and hinder work of other applications and
services on a protected computer. With throttling enabled, Veeam Backup & Replication sets low priority
for Veeam Agent components running on protected computers and engaged in the backup process. If this
option is not enabled, Veeam Agent components have normal priority.
• Security settings. You can allow user accounts that do not have administrative privileges on a Veeam
Agent computer to perform file-level restore on this computer.
IMP ORTANT
Security settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
Veeam Backup & Replication applies the specified settings to Veeam Agent that runs on a protected computer
added to a backup policy. Veeam Backup & Replication applies the settings during the protection group rescan
process. Settings are saved to the Veeam Agent for Microsoft Windows database on the protected computer.
177 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To specify settings for Veeam Agent for Microsoft Windows:
2. If you want to limit bandwidth consumption for Veeam Agent backup jobs, on the Ag ent for W indows tab,
in the Network section, select the Limit bandwidth consumption to check box. Then specify the maximum
speed for transferring backed-up data from the Veeam Agent computer to the target location.
3. By default, backup over metered connections is disabled for Veeam Agent for Microsoft Windows. Veeam
Agent automatically detects metered connections and does not perform backup when your computer is on
such connection. To enable backup over metered connections, clear the Restrict metered connections
usa ge check box.
NOTE
• Veeam Agent for Microsoft Windows disables backup over metered Internet connections only
on computers that run Microsoft Windows 8 and later. If the computer runs an earlier version
of Microsoft Windows, this option is not applicable.
• You must specify which connections are metered in Microsoft Windows. To learn more, see
this Microsoft webpage.
4. If you want to disable backup over VPN connections, select the Restrict VPN connections usage check box.
Veeam Agent for Microsoft Windows will automatically detect VPN connections and will not perform
backup when the Veeam Agent computer is on such connection.
5. If you want to restrict usage of wireless networks for Veeam Agent running on Microsoft Windows
workstations, do the following:
a. Select the Restrict Wi-Fi usage to these networks only check box and click Ad d .
b. In the Wi-Fi Network window, specify the SSID of the Wi-Fi network over which Veeam Agent will be
allowed to perform backup, and click OK.
Veeam Backup & Replication will add the specified network to the list of allowed Wi-Fi networks. Backup
over other wireless networks will be disabled for Veeam Agent.
TIP
If you want to restrict usage over any wireless networks, select the Restrict Wi-Fi usage to these
networks only check box and do not add any networks to the list.
6. If you want to throttle Veeam Agent activities during backup, in the Ba ckup I/O control section, make sure
that the Throttle agent activity on option is selected. Then select the type of computers on which to
throttle Veeam Agent backup activities: Workstations only , Servers only or All hosts.
If you do not want to throttle backup activities for Veeam Agent, select Do not throttle agent.
7. In the Security section, select the Allow file level recovery without administrative account check box. With
this option enabled, Veeam Agent computer users who work under accounts that do not have
administrative privileges will be able to perform file-level restore on the Veeam Agent computer.
In this case, access rights to files and folders are managed by Veeam Agent computer OS. If user cannot
access the folder in the original location, this user cannot browse or restore the content of this folder as
well.
178 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To learn more, see Restoring Files from Backup without Administrator Privileges.
Notification Settings
You can specify email notification settings for the protection group. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with protection group statistics to a specified email address.
The report contains cumulative statistics for rescan job sessions performed for the protection group within the
last 24-hour period.
NOTE
Email reports with protection group statistics will be sent only if you configure global email notification
settings in Veeam Backup & Replication. For more information, see the Configuring Global Email
Notification Settings section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the protection group, in addition to reports sent according to the
global email notification settings, Veeam Backup & Replication will send reports with the protection group
statistics to email addresses specified in the protection group settings. This allows you to fine -tune email
notifications in Veeam Backup & Replication: while one or more backup administrators receive email
notifications according to the global settings, other backup administrators can receive reports for specific
protection groups only.
If you do not enable global email notification settings in Veeam Backup & Replication, notification settings
for the protection group will not be sent even if you enable them in the protection group settings.
179 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. Select the Send daily agent status report e -mail to the following recipients check box and specify a
recipient’s email address. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the daily
email report for the protection group.
5. You can choose to use global notification settings or specify custom notification settings.
To receive a typical notification for the protection group, select Use global notification settings. In this
case, Veeam Backup & Replication will apply to the protection group global email notification settings
specified for the backup server.
To configure a custom notification for the protection group, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
o In the Sub ject field, specify a notification subject. You can use the following variables in the subject:
▪ %FoundCount% — number of new computers discovered within the last 24-hour period.
▪ %SeenCount% — number of computers in the protection group that were online for the last 24
hours. A computer is considered to be online if Veeam Backup & Replication successfully
connected to this computer during the last rescan session.
o Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the protection group rescan job completes successfully, completes with a warning or
fails.
180 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 8. Review Components
At the Review step of the wizard, review what Veeam Backup & Replication components are already installed on
the distribution server specified for the protection group and what components will be installed.
NOTE
Veeam Agent and Veeam Plug-in components are installed on the distribution server even if the Install
a p plication plug-ins and Install backup agent check boxes are clear at the Options step of the wizard.
181 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 9. Assess Results
At the Ap p ly step of the wizard, Veeam Backup & Replication will create the configured protection group. Wait
for the operation to complete and click Nex t to continue.
182 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 10. Finish Working with Wizard
At the Summary step of the wizard, complete the protection group configuration process.
2. To start the rescan job after you close the wizard, make sure that the Run d iscovery when I click Finish
option is selected.
If you want to perform computer discovery later, you can clear the Run d iscovery when I click Finish check
box. In this case, the rescan job will start automatically upon the defined schedule. You can also start the
rescan job manually at any time you need. To learn more, see Starting Protection Group Discovery.
183 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Protection Group for Computers from
CSV File
Before you create a protection group for computers from a CSV file, check prerequisites. Then use the New
P rotection Group wizard to configure a protection group.
4. Specify credentials.
7. Review components.
8. Assess results.
• When Veeam Backup & Replication performs discovery of protected computers, Veeam Backup &
Replication connects to every computer added to the protection group. If you instruct Veeam Backup &
Replication to perform discovery immediately after the protection group is created, make sure that all
computers added to the protection group are powered on and may be accessed over the network.
Otherwise, Veeam Backup & Replication will be unable to connect to a protected computer and perform
the required operations on this computer.
• We recommend that you do not add a computer to a protection group by specifying a dynamic IP address
assigned to this computer. If such computer receives another IP address from a DHCP server, Veeam
Backup & Replication will be unable to discover the computer and perform on this computer op erations
defined in the protection group settings.
• We recommend that you do not add a computer to a protection group by specifying a public IP address
assigned to this computer. If you add such computer to a backup policy targeted at a cloud repository, the
name of the subtenant account created for the computer can contain the public IP address. This IP address
will be visible to the Veeam Cloud Connect service provider who has access to subtenant account settings.
• To deploy Veeam Installer Service and Veeam Agent for Microsoft Windows on a protected computer,
Veeam Backup & Replication uses the administrative share (admin$) of the target computer. An account
that you plan to use to connect to a computer included in the protection group must have access to the
administrative share.
Note that in client Microsoft Windows OSes access to the administrative share is forbidden by default for
local accounts. You can enable this option with a registry key. To learn more, see this Microsoft KB article.
• Veeam Backup & Replication does not support usage of a Linux account for which system settings modify
shell output results to connect to a computer included in the protection group. For example, this includes
Linux accounts with the modified PS1 shell variable.
184 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• To connect to the Linux-based computer where you want to install Veeam Agent for Linux , you must specify
the user account that has a home directory. The specified user account must also have the read and write
permissions for their home directory.
• You cannot install Veeam Agent for Linux on the server used as a hardened repository.
185 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Protection Group Wizard
To launch the New P rotection Group wizard, do the following:
1. Open the Add Protection Group window. To open the window, do one of the following:
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Ad d
Group on the ribbon.
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Create
P rotection Group in the working area.
o Open the Inventory view. Right-click the P hy sical Infrastructure node in the inventory pane and select
Ad d protection group.
2. In the Ad d Protection Group window, select the Comp uters from CSV file option.
186 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 2. Specify Protection Group Name and Description
At the Na me step of the wizard, specify a name and description for the protection group.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who added the protection group, date and time when the protection group
was created.
187 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 3. Specify CSV File
At the CSV File step of the wizard, specify a file that defines a list of computers that you want to add to the
protection group. You must specify a list of computers in a file of the CSV or TXT format. The file must be
created beforehand. To learn more, see Preparing CSV File.
1. In the P a th to file field, click Browse and specify a path to a CSV file that contains a list of IP addresses or
domain names of computers that you want to add to the protection group. The CSV file can reside in a
folder on the local drive of the Veeam backup server or in an SMB network shared folder accessible from
the backup server.
If the SMB network shared folder requires authentication, specify credentials to access the folder. Veeam
Backup & Replication will store the credentials in its database.
2. In the Computers field, review the list of IP addresses or domain names imported from the CSV file.
188 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
After you finish configuring the protection group, Veeam Backup & Replication will perform discovery of
computers listed in the CSV file upon schedule defined in the protection group settings. If Veeam Backup &
Replication is unable to read the CSV file (for example, after the file was moved or deleted from the
specified location), the rescan job will use the list of computers imported from the CSV file during the
previous rescan job session.
Delimit IP addresses or domain names in the list with commas (' ,') or semicolons (';'). For example:
172.17.53.16,172.17.53.19,172.17.53.31,172.17.53.40
Alternatively, you can delimit IP addresses or domain names in the list with the newline characters.
For example:
172.17.53.16
172.17.53.19
172.17.53.31
172.17.53.40
189 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
For correct import of the CSV file, make sure to use newline characters of the CR LF type.
190 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 4. Specify Credentials
At the Credentials this step of the wizard, specify credentials to connect to computers included in the protection
group:
1. If you want to use the same credentials for all computers in the protection group, select the necessary
user account from the Ma ster a ccount list. The account must have local administrator permissions on all
computers that you have added to the protection group.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
Veeam Backup & Replication allows to add the following types of credentials:
o Stored credentials. Select stored credentials if you want Veeam Backup & Replication to use the
specified user name and password for each connection to Veeam Agent.
o [For Linux computers] Single-use credentials. Select single-use credentials if you do not want Veeam
Backup & Replication to store credentials in the configuration database. With this option selected,
Veeam Backup & Replication will use the specified user name and password only for the first
connection to Veeam Agent. After that, Veeam Backup & Replication will use Veeam Transport Service
to communicate with the Veeam Agent computer.
Keep in mind that the username must be specified in the down-level logon name format. For example,
DOMAIN\UserName or HOSTNAME\UserName. Use the full domain or hostname name. Do not replace
them with a dot.
For more information, see the Credentials Manager section in the Veeam Backup & Replication User Guide.
2. By default, Veeam Backup & Replication uses credentials specified in the Ma ster account field for all
computers in the protection group. If some computer requires a different user account, do the following:
a. Select the Use custom credentials for the following objects check box.
b. Click Ad d next to the list of objects and select in the Ad d Objects window one or more computers
listed in a CSV file and add them to the Use custom credentials for the following objects list.
c. In the Use custom credentials for the following objects list, select the necessary object, click E d it and
select custom credentials for the object. Credentials must be specified in the following format:
191 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
• Veeam Backup & Replication supports user account names in the SAM-Account-Name format
(DOMAIN\Username). The User-Principal-Name (UPN) format ( username@domain) is not supported.
If you specify credentials in the UPN format, Veeam Backup & Replication will successfully connect
to computers added to the protection group during the Test Now operation. However, the
subsequent protection group rescan operations will fail.
• The user account that you use to connect to a Linux computer must have a home directory, users
without home directories are not supported.
• If you plan to back up Oracle databases that run on Linux computers, the OS account used to
connect to the computer must be a member of the group that owns configuration files of the Oracle
database (for example, the oinstall group).
• You cannot use an Azure Active Directory account to connect to computers included in the
protection group.
To check if Veeam Backup & Replication can connect to computers added to the protection group, click Test
Now. Veeam Backup & Replication will form a list of computers to connect and use the specified credentials to
connect to computers in the list.
192 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Specify Discovery and Deployment Options
At the Op tions step of the wizard, specify settings for protected computers discovery and Veeam Agent
deployment.
Veeam Backup & Replication regularly connects to protected computers according to the schedule defined in
the protection group settings. At this step of the wizard, you can define the discovery schedule and specify
operations that Veeam Backup & Replication must perform on discovered computers. You can also select which
server in your backup infrastructure should act as a distribution server for Veeam Agents.
1. In the Discovery section, define schedule for automatic computer discovery within the scope of the
protection group:
o To run the rescan job at specific time daily, on defined week days or with specific periodicity, select
Da ily at this time. Use the fields on the right to configure the necessary schedule.
o To run the rescan job repeatedly throughout a day with a specific time interval, select P eriodically
every. In the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and
use the time table to define the permitted time window for the rescan job. In the Sta rt time within an
hour field, specify the exact time when the job must start.
o To run the rescan job continuously, select the P eriodically every option and choose Continuously from
the list on the right. A new rescan job session will start as soon as the previous rescan job session
finishes.
NOTE
You cannot create a protection group without defining schedule for automatic discovery. However,
you can disable automatic discovery for a specific protection group, if needed. To learn more, see
Disabling Protection Group.
2. In the Dep loyment section, from the Distribution server list, select a Microsoft Windows server that you
plan to use as a distribution server. Veeam Backup & Replication will use the distribution server to upload
Veeam Agent setup files to computers added to the protection group. By default, Veeam Backup &
Replication assigns the distribution server role to the backup server. To learn more, see Distribution
Server.
3. If you want to instruct Veeam Backup & Replication to automatically deploy Veeam Agents on all
discovered computers in the protection group, in the Deployment section, make sure that the Install
b a ckup agent check box is selected.
You can also choose to disable automated Veeam Agent installation. In this case, you will need to install
Veeam Agent on every computer included in the protection group and discovered by Veeam Backup &
Replication. To learn more, see Installing Veeam Agent.
Keep in mind that Veeam Backup & Replication installs the Veeam Installer Service or Veeam Deployer
Service and Veeam Transport Service on every computer added to the protection group even if the Install
b a ckup agent check box is not selected in the protection group settings.
TIP
To learn how to use protection groups to automatically deploy Veeam plug-ins for enterprise
applications, see Veeam Plug-ins for Enterprise Applications Guide.
4. If you want to instruct Veeam Backup & Replication to automatically upgrade Veeam Agent on discovered
computers when a new version of Veeam Agent appears on the Veeam Backup & Replication server, in the
Dep loyment section, make sure that the Auto-update backup agents and plug-ins check box is selected.
193 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. [For protection groups that include Microsoft Windows computers] Select the Install changed b lock
tra cking driver check box if you want to install the advanced changed block tracking (CBT) driver on
computers protected with Veeam Agent for Microsoft Windows.
Keep in mind that Veeam Backup & Replication will install the CBT driver only on those computers that run
supported Microsoft Windows OS versions.
To learn more, see the Veeam Changed Block Tracking Driver section in the Veeam Agent for Microsoft
Windows User Guide.
TIP
Veeam Backup & Replication 12 can install the CBT driver on a wider range of Microsoft Windows OS
versions, but Veeam Backup & Replication will not install drivers automatically after upgrade. To
install drivers in the existing protection group on the computers running OS versions that got
support only in Veeam Backup & Replication 12, open the E d it Protection Group wizard, make sure
that the Install changed block tracking driver check box is selected and re-save the protection group.
6. Select the P erform reboot automatically if required check box to allow Veeam Backup & Replication to
reboot a protected computer. In particular, the reboot operation is required as part of the Veeam CBT
driver installation process.
7. Click Ad vanced to specify advanced settings for the protection group. To learn more, see Specify
Advanced Protection Group Settings.
194 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Advanced Protection Group Settings
In the Ad vanced Settings window, specify advanced settings for the protection group:
• Notification settings
TIP
After you specify necessary settings for the protection group, you can save them as default settings. To do
this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window. When you create a
new protection group, Veeam Backup & Replication will automatically apply the default settings to the
new protection group.
• Network usage settings. You can limit bandwidth consumption and restrict network connections usage for
Veeam Agent for Microsoft Windows backup jobs. Limiting bandwidth consumption prevents jobs from
utilizing the entire bandwidth available in your environment and makes sure that enough traffic is
provided for other network operations. In addition to limiting bandwidth consumption, you can choose
whether to allow backup over metered connections and VPN connections. For Microsoft Windows
workstations that run Veeam Agent, you can also specify one or more wireless networks over which
Veeam Agent is allowed to perform backup or restrict usage over any wireless networks.
To learn more, see the Restricting Network Connections Usage section in the Veeam Agent for Microsoft
Windows User Guide.
IMP ORTANT
Network usage settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
• Ba ckup I/O settings. You can instruct Veeam Agent for Microsoft Windows to throttle its activities during
backup. This option can help you avoid situations when backup tasks performed by Veeam Agent for
Microsoft Windows consume all available hard disk resources and hinder work of other applications and
services on a protected computer. With throttling enabled, Veeam Backup & Replication sets low priority
for Veeam Agent components running on protected computers and engaged in the backup process. If this
option is not enabled, Veeam Agent components have normal priority.
• Security settings. You can allow user accounts that do not have administrative privileges on a Veeam
Agent computer to perform file-level restore on this computer.
IMP ORTANT
Security settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
Veeam Backup & Replication applies the specified settings to Veeam Agent that runs on a protected computer
added to a backup policy. Veeam Backup & Replication applies the settings during the protection group rescan
process. Settings are saved to the Veeam Agent for Microsoft Windows database on the protected computer.
195 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To specify settings for Veeam Agent for Microsoft Windows:
2. If you want to limit bandwidth consumption for Veeam Agent backup jobs, on the Ag ent for W indows tab,
in the Network section, select the Limit bandwidth consumption to check box. Then specify the maximum
speed for transferring backed-up data from the Veeam Agent computer to the target location.
3. By default, backup over metered connections is disabled for Veeam Agent for Microsoft Windows. Veeam
Agent automatically detects metered connections and does not perform backup when your computer is on
such connection. To enable backup over metered connections, clear the Restrict metered connections
usa ge check box.
NOTE
• Veeam Agent for Microsoft Windows disables backup over metered Internet connections only
on computers that run Microsoft Windows 8 and later. If the computer runs an earlier version
of Microsoft Windows, this option is not applicable.
• You must specify which connections are metered in Microsoft Windows. To learn more, see
this Microsoft webpage.
4. If you want to disable backup over VPN connections, select the Restrict VPN connections usage check box.
Veeam Agent for Microsoft Windows will automatically detect VPN connections and will not perform
backup when the Veeam Agent computer is on such connection.
5. If you want to restrict usage of wireless networks for Veeam Agent running on Microsoft Windows
workstations, do the following:
a. Select the Restrict Wi-Fi usage to these networks only check box and click Ad d .
b. In the Wi-Fi Network window, specify the SSID of the Wi-Fi network over which Veeam Agent will be
allowed to perform backup, and click OK.
Veeam Backup & Replication will add the specified network to the list of allowed Wi-Fi networks. Backup
over other wireless networks will be disabled for Veeam Agent.
TIP
If you want to restrict usage over any wireless networks, select the Restrict Wi-Fi usage to these
networks only check box and do not add any networks to the list.
6. If you want to throttle Veeam Agent activities during backup, in the Ba ckup I/O control section, make sure
that the Throttle agent activity on option is selected. Then select the type of computers on which to
throttle Veeam Agent backup activities: Workstations only , Servers only or All hosts.
If you do not want to throttle backup activities for Veeam Agent, select Do not throttle agent.
7. In the Security section, select the Allow file level recovery without administrative account check box. With
this option enabled, Veeam Agent computer users who work under accounts that do not have
administrative privileges will be able to perform file-level restore on the Veeam Agent computer.
In this case, access rights to files and folders are managed by Veeam Agent computer OS. If user cannot
access the folder in the original location, this user cannot browse or restore the content of this folder as
well.
196 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To learn more, see Restoring Files from Backup without Administrator Privileges.
Notification Settings
You can specify email notification settings for the protection group. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with protection group statistics to a specified email address.
The report contains cumulative statistics for rescan job sessions performed for the protection group within the
last 24-hour period.
NOTE
Email reports with protection group statistics will be sent only if you configure global email notification
settings in Veeam Backup & Replication. For more information, see the Configuring Global Email
Notification Settings section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the protection group, in addition to reports sent according to the
global email notification settings, Veeam Backup & Replication will send reports with the protection group
statistics to email addresses specified in the protection group settings. This allows you to fine -tune email
notifications in Veeam Backup & Replication: while one or more back up administrators receive email
notifications according to the global settings, other backup administrators can receive reports for specific
protection groups only.
If you do not enable global email notification settings in Veeam Backup & Replication, notification settings
for the protection group will not be sent even if you enable them in the protection group settings.
197 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. Select the Send daily agent status report e -mail to the following recipients check box and specify a
recipient’s email address. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the daily
email report for the protection group.
5. You can choose to use global notification settings or specify custom notification settings.
To receive a typical notification for the protection group, select Use global notification settings. In this
case, Veeam Backup & Replication will apply to the protection group global email notification settings
specified for the backup server.
To configure a custom notification for the protection group, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
o In the Sub ject field, specify a notification subject. You can use the following variables in the subject:
▪ %FoundCount% — number of new computers discovered within the last 24-hour period.
▪ %SeenCount% — number of computers in the protection group that were online for the last 24
hours. A computer is considered to be online if Veeam Backup & Replication successfully
connected to this computer during the last rescan session.
o Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the protection group rescan job completes successfully, completes with a warning or
fails.
198 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Review Components
At the Review step of the wizard, review what Veeam Backup & Replication components are already installed on
the distribution server specified for the protection group and what components will be installed.
NOTE
Veeam Agent and Veeam Plug-in components are installed on the distribution server even if the Install
a p plication plug-ins and Install backup agent check boxes are clear at the Options step of the wizard.
199 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Assess Results
At the Ap p ly step of the wizard, Veeam Backup & Replication will create the configured protection group. Wait
for the operation to complete and click Nex t to continue.
200 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 9. Finish Working with Wizard
At the Summary step of the wizard, complete the protection group configuration process.
2. To start the rescan job after you close the wizard, make sure that the Run d iscovery when I click Finish
option is selected.
If you want to perform computer discovery later, you can clear the Run d iscovery when I click Finish check
box. In this case, the rescan job will start automatically upon the defined schedule. You can also start the
rescan job manually at any time you need. To learn more, see Starting Protection Group Discovery.
201 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Protection Group for Computers with
Pre-installed Backup Agents
Before you create a protection group for computers with pre-installed backup agents, check prerequisites. Then
use the New P rotection Group wizard to configure a protection group.
3. Specify packages.
5. Assess results.
• A protection group for pre-installed Veeam Agents offers a limited set of deployment and management
operations. To learn more, see Working with Protection Groups for Pre-Installed Veeam Agents and
Managing Protected Computers Added to Protection Group for Pre-Installed Veeam Agents.
• You can add a protection group of the computers with pre-installed backup agents type only to a Veeam
Agent backup job managed by Veeam Agent. Veeam Agent backup jobs managed by the backup server are
not supported by this type of protection groups. To learn more about backup job types, see Working with
Veeam Agent Backup Jobs and Policies.
• You cannot add a computer from a protection group for pre-installed Veeam Agents to any other
protection group.
• You cannot install Veeam Agent for Linux on the server used as a hardened repository.
• If you want to add new computers to a protection group for pre-installed Veeam Agents after updating
the TLS certificate on the Veeam backup server, you must first recreate the setup files. To learn more, see
Specify Packages.
202 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Protection Group Wizard
To launch the New P rotection Group wizard, do the following:
1. Open the Add Protection Group window. To open the window, do one of the following:
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Ad d
Group on the ribbon.
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Create
P rotection Group in the working area.
o Open the Inventory view. Right-click the P hy sical Infrastructure node in the inventory pane and select
Ad d protection group.
2. In the Ad d Protection Group window, select the Comp uters with pre-installed backup agents option.
203 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Specify Protection Group Name and Description
At the Na me step of the wizard, specify a name and description for the protection group.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who added the protection group, date and time when the protection group
was created.
204 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Packages
At the P a ckage step of the wizard, specify what setup files you want to obtain to deploy Veeam Agents. Veeam
Backup & Replication will export the specified setup files to the specified folder. Then, you must use these setup
files to deploy Veeam Agents on computers you plan to protect. To learn more, see Deploying Veeam Agents
Using Generated Setup Files.
2. In the Select Folder window, specify a path to the folder to which Veeam Backup & Replication will export
Veeam Agent setup files. Setup files can be exported to a folder on the local drive of the Veeam backup
server or to an SMB network shared folder accessible from the backup server.
3. In the Ag ent installation packages to export field, select setup files depending on the type of the OS that
runs on computers you plan to add to the protection group.
a. If you plan to protect Windows computers, select the Microsoft W indows package option.
b. If you plan to protect Mac computers, select the Ap p le Mac package with the d evice profile option.
c. If you plan to protect Unix computers, expand the Unix Packages option and select packages for
specific Unix distributions.
If you select the Unix Packages option, Veeam Backup & Replication will export setup files for all Unix
distributions supported by Veeam Agent for IBM AIX and Veeam Agent for Oracle Solaris.
d. If you plan to protect Linux computers, expand the Linux packages for supported distributions option
and select options depending on the distributions you need.
NOTE
You can also export installation packages of the nosnap version of Veeam Agent for Linux
(including Veeam Agent for Linux on Power) for the supported Linux distributions.
If you select the Linux packages for supported d istributions option, Veeam Backup & Replication will
export setup files for all Linux distributions supported by Veeam Agent for Linux.
4. Click Ad vanced to specify advanced settings for the protection group. To learn more, see Specify
Advanced Protection Group Settings.
205 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
206 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Specify Advanced Protection Group Settings
In the Ad vanced Settings window, specify advanced settings for the protection group:
• Notification settings
TIP
After you specify necessary settings for the protection group, you can save them as default settings. To do
this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window. When you create a
new protection group, Veeam Backup & Replication will automatically apply the default settings to the
new protection group.
• Network usage settings. You can limit bandwidth consumption and restrict network connections usage for
Veeam Agent for Microsoft Windows backup jobs. Limiting bandwidth consumption prevents jobs from
utilizing the entire bandwidth available in your environment and makes sure that enough traffic is
provided for other network operations. In addition to limiting bandwidth consumption, you can choose
whether to allow backup over metered connections and VPN connections. For Microsoft Windows
workstations that run Veeam Agent, you can also specify one or more wireless networks over which
Veeam Agent is allowed to perform backup or restrict usage over any wireless networks.
To learn more, see the Restricting Network Connections Usage section in the Veeam Agent for Microsoft
Windows User Guide.
IMP ORTANT
Network usage settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
• Ba ckup I/O settings. You can instruct Veeam Agent for Microsoft Windows to throttle its activities during
backup. This option can help you avoid situations when backup tasks performed by Veeam Agent for
Microsoft Windows consume all available hard disk resources and hinder work of other applications and
services on a protected computer. With throttling enabled, Veeam Backup & Replication sets l ow priority
for Veeam Agent components running on protected computers and engaged in the backup process. If this
option is not enabled, Veeam Agent components have normal priority.
• Security settings. You can allow user accounts that do not have administrative privileges on a Veeam
Agent computer to perform file-level restore on this computer.
IMP ORTANT
Security settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
Veeam Backup & Replication applies the specified settings to Veeam Agent that runs on a protected computer
added to a backup policy. Veeam Backup & Replication applies the settings during the protection group rescan
process. Settings are saved to the Veeam Agent for Microsoft Windows database on the protected computer.
207 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To specify settings for Veeam Agent for Microsoft Windows:
2. If you want to limit bandwidth consumption for Veeam Agent backup jobs, on the Ag ent for W indows tab,
in the Network section, select the Limit bandwidth consumption to check box. Then specify the maximum
speed for transferring backed-up data from the Veeam Agent computer to the target location.
3. By default, backup over metered connections is disabled for Veeam Agent for Microsoft Windows. Veeam
Agent automatically detects metered connections and does not perform backup when your computer is on
such connection. To enable backup over metered connections, clear the Restrict metered connections
usa ge check box.
NOTE
• Veeam Agent for Microsoft Windows disables backup over metered Internet connections only
on computers that run Microsoft Windows 8 and later. If the computer runs an earlier version
of Microsoft Windows, this option is not applicable.
• You must specify which connections are metered in Microsoft Windows. To learn more, see
this Microsoft webpage.
4. If you want to disable backup over VPN connections, select the Restrict VPN connections usage check box.
Veeam Agent for Microsoft Windows will automatically detect VPN connections and will not perform
backup when the Veeam Agent computer is on such connection.
5. If you want to restrict usage of wireless networks for Veeam Agent running on Microsoft Windows
workstations, do the following:
a. Select the Restrict Wi-Fi usage to these networks only check box and click Ad d .
b. In the Wi-Fi Network window, specify the SSID of the Wi-Fi network over which Veeam Agent will be
allowed to perform backup, and click OK.
Veeam Backup & Replication will add the specified network to the list of allowed Wi-Fi networks. Backup
over other wireless networks will be disabled for Veeam Agent.
TIP
If you want to restrict usage over any wireless networks, select the Restrict Wi-Fi usage to these
networks only check box and do not add any networks to the list.
6. If you want to throttle Veeam Agent activities during backup, in the Ba ckup I/O control section, make sure
that the Throttle agent activity on option is selected. Then select the type of computers on which to
throttle Veeam Agent backup activities: Workstations only , Servers only or All hosts.
If you do not want to throttle backup activities for Veeam Agent, select Do not throttle agent.
7. In the Security section, select the Allow file level recovery without administrative account check box. With
this option enabled, Veeam Agent computer users who work under accounts that do not have
administrative privileges will be able to perform file-level restore on the Veeam Agent computer.
In this case, access rights to files and folders are managed by Veeam Agent computer OS. If user cannot
access the folder in the original location, this user cannot browse or restore the content of this folder as
well.
To learn more, see Restoring Files from Backup without Administrator Privileges.
208 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Notification Settings
You can specify email notification settings for the protection group. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with protection group statistics to a specified email address.
The report contains cumulative statistics for rescan job sessions performed for the protection group within the
last 24-hour period.
NOTE
Email reports with protection group statistics will be sent only if you configure global email notification
settings in Veeam Backup & Replication. For more information, see the Configuring Global Email
Notification Settings section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the protection group, in addition to reports sent according to the
global email notification settings, Veeam Backup & Replication will send reports with the protection group
statistics to email addresses specified in the protection group settings. This allows you to fine-tune email
notifications in Veeam Backup & Replication: while one or more backup administrators receive email
notifications according to the global settings, other backup administrators can rece ive reports for specific
protection groups only.
If you do not enable global email notification settings in Veeam Backup & Replication, notification settings
for the protection group will not be sent even if you enable them in the protection group settings.
3. Select the Send daily agent status report e -mail to the following recipients check box and specify a
recipient’s email address. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the daily
email report for the protection group.
5. You can choose to use global notification settings or specify custom notification settings.
To receive a typical notification for the protection group, select Use global notification settings. In this
case, Veeam Backup & Replication will apply to the protection group global email notification settings
specified for the backup server.
To configure a custom notification for the protection group, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
o In the Sub ject field, specify a notification subject. You can use the following variables in the subject:
▪ %FoundCount% — number of new computers discovered within the last 24-hour period.
▪ %SeenCount% — number of computers in the protection group that were online for the last 24
hours. A computer is considered to be online if Veeam Backup & Replication successfully
connected to this computer during the last rescan session.
209 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the protection group rescan job completes successfully, completes with a warning or
fails.
210 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Assess Results
At the Ap p ly step of the wizard, Veeam Backup & Replication will create the configured protection group. Wait
for the operation to complete and click Nex t to continue.
211 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Finish Working with Wizard
At the Summary step of the wizard, complete the protection group configuration process.
212 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Protection Group for Cloud Machines
Before you create a protection group for cloud machines, check prerequisites. Then use the New P rotection
Group wizard to configure a protection group.
3. Specify account.
6. Specify permissions.
9. Assess results.
• When Veeam Backup & Replication performs discovery of protected machines, Veeam Backup &
Replication connects to every machine added to the protection group. If you instruct Veeam Backup &
Replication to perform discovery immediately after the protection group is created, make sure that all
machines added to the protection group are powered on and may be accessed over the network.
Otherwise, Veeam Backup & Replication will be unable to connect to a protected machine and perform the
required operations.
• You can add a protection group of the cloud machines type only to a Veeam Agent backup job managed by
the backup server. Veeam Agent backup jobs managed by Veeam Agent are not supported by this type of
protection groups. To learn more about backup job types, see Working with Veeam Agent Backup Jobs and
Policies.
• A protection group for cloud machines can include only the following objects:
• A protection group for cloud machines can include objects running only supported Microsoft Windows
and Linux OSes.
• Amazon EC2 instances included in the protection group for cloud machines must meet the following
requirements:
o Instances must have SSM Agent installed and running. To learn more, see this Amazon article.
o Instances must have access to CRL lists and certificates of the AWS internal services necessary to
connect to these internal services.
213 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Microsoft Azure virtual machines included in the protection group for cloud machines must meet the
following requirements:
o Virtual machines must have Microsoft Azure Virtual Machine Agent (Azure VM Agent) installed
and running. To learn more, see this Microsoft article.
o Virtual machines must have access to CRL lists and certificates of the Microsoft Azure internal
services necessary to connect to these internal services.
• You can store backups of cloud machines only in the object repository located on the same
external cloud storage as the cloud machines you want to back up.
• Scale-out backup repositories and Veeam Cloud Connect repositories are not supported as a
backup destination for cloud machines.
214 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 1. Launch New Protection Group Wizard
To launch the New P rotection Group wizard, do the following:
1. Open the Add Protection Group window. To open the window, do one of the following:
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Ad d
Group on the ribbon.
o Open the Inventory view. Click the P hy sical Infrastructure node in the inventory pane and click Create
P rotection Group in the working area.
o Open the Inventory view. Right-click the P hy sical Infrastructure node in the inventory pane and select
Ad d protection group.
215 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 2. Specify Protection Group Name and Description
At the Na me step of the wizard, specify a name and description for the protection group.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who added the protection group, date and time when the protection group
was created.
216 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Account
At the Cloud Account step of the wizard, specify settings for Amazon or Microsoft Azure cloud that you want to
use to deploy Veeam Agents on cloud machines.
NOTE
AWS user that you use to connect to Amazon cloud must have the required permissions. To learn more, see
Permissions.
To specify settings that Veeam Backup & Replication will use to connect to the external cloud:
1. Select the account from the Credentials list. If you have not set up credentials beforehand, click the
Ma nage accounts link or click Ad d on the right to add credentials using Cloud Credentials Manager.
Keep in mind that to deploy Veeam Agents on cloud machines, you can specify only access keys for AWS
User or Microsoft Azure Compute Account. To learn more, see the Access Keys for AWS Users and
Microsoft Azure Compute Accounts sections in the Veeam Backup & Replication User Guide.
NOTE
a. From the AW S region list, select the AWS region in which Veeam Backup & Replication will deploy
Veeam Agents on cloud machines.
b. From the Da ta center list, select the geographic region where Veeam Backup & Replication will deploy
Veeam Agents on cloud machines.
a. From the Sub scription list, select a subscription which resources you want to use. The subscription list
contains all subscriptions associated with the Azure compute or Azure Stack Hub compute accounts
that you have added to Veeam Backup & Replication.
IMP ORTANT
A Microsoft Azure Compute Account must be in the same subscription as the storage account
specified in the settings of the Azure Blob Storage repository used as a distribution repository.
For more information about the distribution repository, see Distribution Repository.
217 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
b. From the Reg ion list, select a geographic region where you want to deploy Veeam Agents on cloud
machines.
218 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 4. Specify Cloud Machines
At the Cloud Machines step of the wizard, specify cloud machines that you want to add to the protection group.
To do this, you can select individual cloud machines, whole datacenters, or specify metadata tags.
2. In the Select Objects window, select the necessary object in the list and click OK. You can press and hold
the [Ctrl] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
2. In the Ta g window:
b. In the Va lue field, specify a value for the tag and click OK.
219 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
220 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 5. Exclude Objects from Protection Group
At the E x clusions step of the wizard, you can specify which objects you want to exclude from the protection
group. You can exclude the following types of objects:
2. In the Select Objects window, select the necessary cloud machine in the list and click OK. You can press
and hold the [Ctrl] key to select multiple machines at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
221 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. In the Ta g window:
IMP ORTANT
222 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Permissions
The Cloud P ermissions step of the wizard is available if you have chosen to define a protection scope that
includes Amazon EC2 virtual machines.
To communicate with Amazon EC2 virtual machines included in the protection group, you need to perform the
following operations:
1. Set the IAM role with the AmazonSSMManagedInstanceCore policy. To learn more, see this Amazon
article.
2. Assign the IAM role to the cloud machine you want to back up.
At this step of the wizard, set roles for Amazon EC2 virtual machines included in the protection group:
1. If you want to instruct Veeam Backup & Replication to automatically set the required role and policy,
select the Assign an IAM role with required permissions automatically check box. If necessary, Veeam
Backup & Replication will set the IAM role with the AmazonSSMManagedInstanceCore policy to all virtual
machines included in the protection group.
Keep in mind that Veeam Backup & Replication will set the IAM role with the
AmazonSSMManagedInstanceCore policy to the virtual machine only if the following conditions are met:
o The user account specified at the Cloud Account step of the wizard has enough access rights to set
the IAM role.
o The virtual machine does not have the IAM role already assigned.
2. To check if Veeam Backup & Replication can communicate with virtual machines added to the protection
group, click Va lidate. Veeam Backup & Replication will try to connect to all virtual machines included in
the protection group.
223 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 7. Specify Discovery and Deployment Options
At the Op tions step of the wizard, specify settings for protected machines discovery and Veeam Agent
deployment.
Veeam Backup & Replication regularly connects to protected machines according to the schedule defined in the
protection group settings. At this step of the wizard, you can define the discovery schedule and specify
operations that Veeam Backup & Replication must perform on discovered machines. You can also select which
server in your backup infrastructure should act as a distribution server for Veeam Agents.
1. In the Discovery section, define schedule for automatic discovery within the scope of the protection
group:
o To run the rescan job at specific time daily, on defined week days or with specific periodicity, select
Da ily at this time. Use the fields on the right to configure the necessary schedule.
o To run the rescan job repeatedly throughout a day with a specific time interval, select P eriodically
every. In the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and
use the time table to define the permitted time window for the rescan job. In the Sta rt time within an
hour field, specify the exact time when the job must start.
o To run the rescan job continuously, select the P eriodically every option and choose Continuously from
the list on the right. A new rescan job session will start as soon as the previous rescan job session
finishes.
NOTE
You cannot create a protection group without defining schedule for automatic discovery. However,
you can disable automatic discovery for a specific protection group, if needed. To learn more, see
Disabling Protection Group.
2. In the Dep loyment section, from the Distribution repository list, select a Microsoft Azure blob storage or
Amazon S3 storage repository that you plan to use as a distribution repository. Veeam Backup &
Replication will use the distribution repository to upload Veeam Agent setup files to cloud machines
added to the protection group.
If you have not added the necessary repository to your infrastructure before, click Ad d to add a new
repository. To learn more, see Adding Azure Blob Storage or Adding Amazon S3 Storage in the Veeam
Backup & Replication User Guide.
I MP ORTANT
If you plan to use the Azure Blob Storage repository as a distribution repository, consider the
following:
• You must add a repository using a general-purpose v2 storage account. Other account types
are not supported.
• A Microsoft Azure Compute Account must be in the same subscription as the storage account
specified in the settings of the Azure Blob Storage repository used as a distribution repository.
• You cannot add a repository using the Microsoft Entra ID account.
224 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. If you want to instruct Veeam Backup & Replication to automatically deploy Veeam Agents on all
discovered machines in the protection group, in the Dep loyment section, make sure that the Install
b a ckup agent check box is selected.
You can also choose to disable automated Veeam Agent installation. In this case, you will need to install
Veeam Agent on every machine included in the protection group and discovered by Veeam Backup &
Replication. To learn more, see Installing Veeam Agent.
Keep in mind that Veeam Backup & Replication installs the Veeam Installer Service or Veeam Deployer
Service and Veeam Transport Service on every machine added to the protection group even if the Install
b a ckup agent check box is not selected in the protection group settings.
TIP
To learn how to use protection groups to automatically deploy Veeam plug -ins for enterprise
applications, see Veeam Plug-ins for Enterprise Applications Guide.
4. If you want to instruct Veeam Backup & Replication to automatically upgrade Veeam Agent on discovered
machines when a new version of Veeam Agent appears on the Veeam Backup & Replication server, in the
Dep loyment section, make sure that the Auto-update backup agents and plug-ins check box is selected.
5. [For protection groups that include Microsoft Windows machines] Select the Install changed block
tra cking driver check box if you want to install the advanced changed block tracking (CBT) driver on
machines protected with Veeam Agent for Microsoft Windows.
Keep in mind that Veeam Backup & Replication will install the CBT driver only on those machines that run
supported Microsoft Windows OS versions.
To learn more, see the Veeam Changed Block Tracking Driver section in the Veeam Agent for Microsoft
Windows User Guide.
TIP
Veeam Backup & Replication 12 can install the CBT driver on a wider range of Microsoft Windows OS
versions, but Veeam Backup & Replication will not install drivers automatically after upgrade. To
install drivers in the existing protection group on the machines running OS versions that got support
only in Veeam Backup & Replication 12, open the E d it Protection Group wizard, make sure that the
Install changed block tracking driver check box is selected and re-save the protection group.
6. Select the P erform reboot automatically if required check box to allow Veeam Backup & Replication to
reboot a protected machine. In particular, the reboot operation is required as part of the Veeam CBT driver
installation process.
225 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
7. Click Ad vanced to specify advanced settings for the protection group. To learn more, see Specify
Advanced Protection Group Settings.
226 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 8. Specify Advanced Protection Group Settings
In the Ad vanced Settings window, specify advanced settings for the protection group:
• Notification settings
TIP
After you specify necessary settings for the protection group, you can save them as default settings. To do
this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window. When you create a
new protection group, Veeam Backup & Replication will automatically apply the default settings to the
new protection group.
• Network usage settings. You can limit bandwidth consumption and restrict network connections usage for
Veeam Agent for Microsoft Windows backup jobs. Limiting bandwidth consumption prevents jobs from
utilizing the entire bandwidth available in your environment and makes sure that enough traffic is
provided for other network operations. In addition to limiting bandwidth consumption, you can choose
whether to allow backup over metered connections and VPN connections. For Microsoft Windows
workstations that run Veeam Agent, you can also specify one or more wireless networks over which
Veeam Agent is allowed to perform backup or restrict usage over any wireless networks.
To learn more, see the Restricting Network Connections Usage section in the Veeam Agent for Microsoft
Windows User Guide.
IMP ORTANT
Network usage settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
• Ba ckup I/O settings. You can instruct Veeam Agent for Microsoft Windows to throttle its activities during
backup. This option can help you avoid situations when backup tasks performed by Veeam Agent for
Microsoft Windows consume all available hard disk resources and hinder work of other applications and
services on a protected computer. With throttling enabled, Veeam Backup & Replication sets low priority
for Veeam Agent components running on protected computers a nd engaged in the backup process. If this
option is not enabled, Veeam Agent components have normal priority.
• Security settings. You can allow user accounts that do not have administrative privileges on a Veeam
Agent computer to perform file-level restore on this computer.
IMP ORTANT
Security settings are not applied to protected computers added to a Veeam Agent backup job
managed by the backup server.
Veeam Backup & Replication applies the specified settings to Veeam Agent that runs on a protected compu ter
added to a backup policy. Veeam Backup & Replication applies the settings during the protection group rescan
process. Settings are saved to the Veeam Agent for Microsoft Windows database on the protected computer.
227 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
To specify settings for Veeam Agent for Microsoft Windows:
2. If you want to limit bandwidth consumption for Veeam Agent backup jobs, on the Ag ent for W indows tab,
in the Network section, select the Limit bandwidth consumption to check box. Then specify the maximum
speed for transferring backed-up data from the Veeam Agent computer to the target location.
3. By default, backup over metered connections is disabled for Veeam Agent for Microsoft Windows. Veeam
Agent automatically detects metered connections and does not perform backup when your computer is on
such connection. To enable backup over metered connections, clear the Restrict metered connections
usa ge check box.
NOTE
• Veeam Agent for Microsoft Windows disables backup over metered Internet connections only
on computers that run Microsoft Windows 8 and later. If the computer runs an earlier version
of Microsoft Windows, this option is not applicable.
• You must specify which connections are metered in Microsoft Windows. To learn more, see
this Microsoft webpage.
4. If you want to disable backup over VPN connections, select the Restrict VPN connections usage check box.
Veeam Agent for Microsoft Windows will automatically detect VPN connections and will not perform
backup when the Veeam Agent computer is on such connection.
5. If you want to restrict usage of wireless networks for Veeam Agent running on Microsoft Windows
workstations, do the following:
a. Select the Restrict Wi-Fi usage to these networks only check box and click Ad d .
b. In the Wi-Fi Network window, specify the SSID of the Wi-Fi network over which Veeam Agent will be
allowed to perform backup, and click OK.
Veeam Backup & Replication will add the specified network to the list of allowed Wi-Fi networks. Backup
over other wireless networks will be disabled for Veeam Agent.
TIP
If you want to restrict usage over any wireless networks, select the Restrict Wi-Fi usage to these
networks only check box and do not add any networks to the list.
6. If you want to throttle Veeam Agent activities during backup, in the Ba ckup I/O control section, make sure
that the Throttle agent activity on option is selected. Then select the type of computers on which to
throttle Veeam Agent backup activities: Workstations only , Servers only or All hosts.
If you do not want to throttle backup activities for Veeam Agent, select Do not throttle agent.
7. In the Security section, select the Allow file level recovery without administrative account check box. With
this option enabled, Veeam Agent computer users who work under accounts that do not have
administrative privileges will be able to perform file-level restore on the Veeam Agent computer.
In this case, access rights to files and folders are managed by Veeam Agent computer OS. If user cannot
access the folder in the original location, this user cannot browse or restore the conte nt of this folder as
well.
228 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
To learn more, see Restoring Files from Backup without Administrator Privileges.
Notification Settings
You can specify email notification settings for the protection group. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with protection group statistics to a specified email address.
The report contains cumulative statistics for rescan job sessions performed for the protection group within the
last 24-hour period.
NOTE
Email reports with protection group statistics will be sent only if you configure global email notification
settings in Veeam Backup & Replication. For more information, see the Configuring Global Email
Notification Settings section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the protection group, in addition to reports sent according to the
global email notification settings, Veeam Backup & Replication will send reports with the protection group
statistics to email addresses specified in the protection group settings. This allows you to fine-tune email
notifications in Veeam Backup & Replication: while one or more backup administrators receive email
notifications according to the global settings, other backup administrators can receive reports for specific
protection groups only.
If you do not enable global email notification settings in Veeam Backup & Replication, notification settings
for the protection group will not be sent even if you enable them in the protection group settings.
229 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. Select the Send daily agent status report e -mail to the following recipients check box and specify a
recipient’s email address. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the daily
email report for the protection group.
5. You can choose to use global notification settings or specify custom notification settings.
To receive a typical notification for the protection group, select Use global notification settings. In this
case, Veeam Backup & Replication will apply to the protection group global email notification settings
specified for the backup server.
To configure a custom notification for the protection group, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
o In the Sub ject field, specify a notification subject. You can use the following variables in the subject:
▪ %FoundCount% — number of new computers discovered within the last 24-hour period.
▪ %SeenCount% — number of computers in the protection group that were online for the last 24
hours. A computer is considered to be online if Veeam Backup & Replication successfully
connected to this computer during the last rescan session.
o Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the protection group rescan job completes successfully, completes with a warning or
fails.
230 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 9. Assess Results
At the Ap p ly step of the wizard, Veeam Backup & Replication will create the configured protection group. Wait
for the operation to complete and click Nex t to continue.
231 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 10. Finish Working with Wizard
At the Summary step of the wizard, complete the protection group configuration process.
2. To start the rescan job after you close the wizard, make sure that the Run d iscovery when I click Finish
option is selected.
If you want to perform computer discovery later, you can clear the Run d iscovery when I click Finish check
box. In this case, the rescan job will start automatically upon the defined schedule. You can also start the
rescan job manually at any time you need. To learn more, see Starting Protection Group Discovery.
232 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Deploying Veeam Agents Using Generated
Setup Files
When you configure the Veeam Agent management infrastructure in Veeam Backup & Replication, you can
create protection groups of the Computers with pre-installed backup agents type. If you selected this protection
group type, you must deploy Veeam Agents on the computers that you plan to protect.
• The deployment operation must take place on the Veeam Agent computer side.
• You must use only those Veeam Agent setup files that are generated by Veeam Backup & Replication after
the protection group for pre-installed Veeam Agents is created. To learn more, see Specifying Packages.
• If any other version of Veeam Agent is already installed on the computer you plan to protect, you must
uninstall it first.
• If you uninstall Veeam Agent for Microsoft Windows added to the protection group of the Computers with
pre-installed backup agents type and then re-install it on the same computer, Veeam Agent will not
connect to the Veeam backup server automatically. To connect Veeam Agent, you must repeat the
configuration step of the Veeam Agent deployment scenario.
• If you migrate from one Veeam backup server to another, you must update Veeam backup server settings
on each computer in the protection group for pre-installed Veeam Agents. To do this:
a. Edit the protection group settings and regenerate setup files. To learn more, see Specifying Packages.
b. Repeat the configuration step of the Veeam Agent deployment scenario using the regenerated
configuration file.
• You must not install Veeam Agent on the server that is used as a hardened repository in the Veeam Backup
& Replication infrastructure.
233 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Deploying Veeam Agent for Microsoft Windows
To deploy Veeam Agent for Microsoft Windows using setup files generated by Veeam Backup & Replication,
perform the following operations:
1. Installation
2. Configuration
TIP
You can also find detailed instructions on the Veeam Agent deployment in the readme.txt file that is
available among the setup files generated by Veeam Backup & Replication.
Installation
To install Veeam Agent for Microsoft Windows and all the required components, do the following:
1. Upload Veeam Agent setup files on the computer you want to protect. Then navigate to the folder where
you have saved setup files.
Keep in mind that you must use Veeam Agent setup files that are generated by Veeam Backup &
Replication after the protection group for pre-installed Veeam Agents is created. To learn more, see
Specifying Packages.
If a later version of the .NET Framework is already installed on the computer, you can skip this step.
3. To install Windows Universal C Runtime (CRT), find and double-click the file depending on your computer
OS architecture and version:
OS
OS
Architectur File Location File Name
Version
e
Window
Windows8-
s 8 or
RT-
Window KB2999226-
s Server x86.msu
2012
234 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
OS
OS
Architectur File Location File Name
Version
e
Window
Windows8.1
s 8.1 or
-
Window KB2999226-
s Server x86.msu
2012 R2
Window
Windows8-
s 8 or
RT-
Window KB2999226-
s Server x64
2012
Window
Windows8.1
s 8.1 or
-
Window
KB2999226-
s Server x64
2012 R2
4. To install Veeam Agent for Microsoft Windows, use one of the following files depending on the
architecture of your computer OS:
Configuration
To configure Veeam Agent for Microsoft Windows, you must apply connection settings from the configuration
file. You obtained this file together with other setup files when the protection group for pre -installed Veeam
Agents was created. To do configure Veeam Agent, execute the following command from the folder where
Veeam Agent setup files are located:
235 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
where <protection_group_name> is a name of the protection group for pre-installed Veeam Agents.
Alternatively, you can specify the full path to the configuration file passed with the /p option.
Consider that the connection between Veeam Backup & Replication and Veeam Agent is not persistent. Veeam
Agent synchronizes with Veeam Backup & Replication every 6 hours. After you apply new backup policy settings
in the Veeam Backup & Replication console, Veeam Agent will get these settings during the next
synchronization.
To synchronize Veeam Agent immediately, run the following command on the Veeam Agent computer:
236 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Deploying Veeam Agent for Linux
To deploy Veeam Agent for Linux using setup files generated by Veeam Backup & Replication, perform the
following operations:
1. Installation
2. Configuration
NOTE
You can also generate setup files for nosnap versions of Veeam Agent for Linux (including Veeam Agent for
Linux on Power).
TIP
You can also find detailed instructions on the Veeam Agent deployment in the readme.txt file that is
available among the setup files generated by Veeam Backup & Replication.
Installation
To install Veeam Agent for Linux and all the required components, do the following:
1. Upload Veeam Agent setup files on the computer you want to protect.
Keep in mind that you must use Veeam Agent setup files that are generated by Veeam Backup &
Replication after the protection group for pre-installed Veeam Agents is created. To learn more, see
Specifying Packages.
2. Navigate to the directory where you have saved setup files and install Veeam Agent. This procedure is
similar to the installation of the Veeam Agent for Linux in the offline mode. To learn more, see the
Installing Veeam Agent for Linux in Offline Mode section in the Veeam Agent for Linux User Guide.
Configuration
To configure Veeam Agent for Linux, you must apply connection settings from the configuration file that you
obtained when the protection group for pre-installed Veeam Agents was created. To do this, run the following
command from the directory where Veeam Agent setup files are located:
where <protection_group_name> is a name of the protection group for pre-installed Veeam Agents.
Alternatively, you can specify the full path to the configuration file passed with the --cfg option.
Consider that the connection between Veeam Backup & Rep lication and Veeam Agent is not persistent. Veeam
Agent synchronizes with Veeam Backup & Replication every 6 hours. After you apply new backup policy settings
in the Veeam Backup & Replication console, Veeam Agent will get these settings during the next
synchronization.
To synchronize Veeam Agent immediately, run the following command on the Veeam Agent computer:
237 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Deploying Veeam Agent for Linux Using Pre-installed Veeam
Deployer Service
You have an option to install Veeam Agent on Linux computers using certificate-based authentication instead of
credentials. To do so, you must install Veeam Deployer Service on the computer and then add the computer to a
protection group of the Individual computers type. In this case, Veeam Backup & Replication does not require
SSH connection to install Veeam Agent for Linux.
IMP ORTANT
You cannot use this deployment method to install and configure a nosnap Veeam Agent for Linux on
Power.
1. On the Veeam Backup & Replication side, start a Veeam PowerShell session. For more information, see the
Starting Veeam PowerShell Sessions in the Veeam PowerShell Reference.
3. Upload the obtained files on the computer that you want to protect.
4. On the Veeam Agent computer side, navigate to the directory where you have saved the files and install
Veeam Deployer Service using a package manager.
6. On the Veeam Backup & Replication side, create a protection group with the following parameters:
b. At the Comp uters step of the wizard, specify a computer and select the Connect using certificate-
b a sed authentication method to connect to the computer.
After you create the protection group, Veeam Backup & Replication will rescan the protection group. During the
rescan operation, Veeam Backup & Replication will replace the Veeam Deployer Service temporary certificate,
connect to the Veeam Deployer Service and install Veeam Agent. To learn more, see Rescan Job.
238 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Deploying Veeam Agent for Unix
To deploy Veeam Agent for IBM AIX or Veeam Agent for Oracle Solaris using setup files generated by Veeam
Backup & Replication, perform the following operations:
1. Installation
2. Configuration
TIP
You can also find detailed instructions on the Veeam Agent deployment in the readme.txt file that is
available among the setup files generated by Veeam Backup & Replication.
Installation
To install Veeam Agent for Unix and all the required components, do the following:
1. Upload the installation archive to a directory that can be accessed from the computer where you want to
install the product and extract setup files from this archive.
Keep in mind that you must use the Veeam Agent installation archive that is generated by Veeam Backup
& Replication after the protection group for pre-installed Veeam Agents is created. To learn more, see
Specifying Packages.
2. Navigate to the directory where you have extracted setup files and install Veeam Agent. This procedure is
similar to the default installation of the Veeam Agent for Unix. To learn more, s ee the following sections:
o For Veeam Agent for Oracle Solaris, see the Installing Veeam Agent section in the Veeam Agent for
Oracle Solaris User Guide.
o For Veeam Agent for IBM AIX, see the Installing Veeam Agent section in the Veeam Agent for IBM AIX
User Guide.
Configuration
To configure Veeam Agent for Unix, you must apply connection settings from the configuration file that you
obtained when the protection group for pre-installed Veeam Agents was created. To do this, run the following
command from the folder where Veeam Agent setup files are located:
where <protection_group_name> is a name of the protection group for pre-installed Veeam Agents.
Alternatively, you can specify the full path to the configuration file passed with the --cfg option.
Consider that the connection between Veeam Backup & Replication and Veeam Agent is not persistent. Veeam
Agent synchronizes with the Veeam backup server every 6 hours. After you apply the connection settings,
Veeam Agent will use them to connect to backup server during the next synchronization.
To synchronize Veeam Agent immediately, run the following command on the Veeam Agent computer:
239 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Deploying Veeam Agent for Mac
To deploy Veeam Agent for Mac using setup files genera ted by Veeam Backup & Replication, perform the
following operations:
1. Installation
2. Configuration
TIP
You can also find detailed instructions on the Veeam Agent deployment in the readme.txt file that is
available among the setup files generated by Veeam Backup & Replication.
Installation
To install Veeam Agent for Mac and all the required components, do the following:
1. Upload Veeam Agent setup files on the computer you want to protect.
Keep in mind that you must use Veeam Agent setup files that are generated by Veeam Backup &
Replication after the protection group for pre-installed Veeam Agents is created. To learn more, see
Specifying Packages.
2. Navigate to the directory where you have saved setup files and install Veeam Agent. This procedure is
similar to the default installation of the Veeam Agent for Mac. To learn more, see the Installing Veeam
Agent section in the Veeam Agent for Mac User Guide.
3. Grant full disk access to Veeam Agent for Mac. To learn more, see the Granting Full Disk Access section in
the Veeam Agent for Mac User Guide.
Alternatively, you use install Veeam Agent and grant full disk access using a Mobile Device Management (MDM)
solution. To learn more, see the Installation and Configuration with MDM Solution section in the Veeam Agent
for Mac User Guide.
Configuration
To configure Veeam Agent for Mac, you must import connection settings from the configuration file that you
obtained when the protection group for pre-installed Veeam Agents was created. To learn more, see the
Importing Configuration from Backup Server section in the Veeam Agent for Mac User Guide.
If you use the MDM solution to install Veeam Agent, you must deploy the configuration file as a device profile.
To learn more, see the Installation and Configuration with MDM Solution in the Veeam Agent for Mac Use Guide.
Keep in mind that you may need one of the following configuration files depending on the solution that you use:
• <protection_group_name>.xml
• <protection_group_name>_escaped.xml
where <protection_group_name> is a name of the protection group for pre-installed Veeam Agents.
Consider that the connection between Veeam Backup & Replication and Veeam Agent is not persistent. Veeam
Agent synchronizes with the Veeam backup server every 6 hours. After you apply the connection settings,
Veeam Agent will use them to connect to backup server during the next synchronization.
240 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To synchronize Veeam Agent immediately, run the following command on the Veeam Agent computer:
241 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Adding Protection Group to Backup Job
You can quickly add an entire protection group to a Veeam Agent backup job configured in Veeam Backup &
Replication.
• You can add a protection group for pre-installed Veeam Agents only to a backup policy (Veeam Agent
backup job managed by Veeam Agent). Veeam Agent backup jobs managed by the backup server are not
supported by this type of protection groups. To learn more a bout backup job types, see Working with
Veeam Agent Backup Jobs and Policies.
• You can add a protection group for pre-installed Veeam Agents to a backup job for Mac computers and
Linux computers with nosnap version of Veeam Agent for Linux (including Veeam Agent for Linux on
Power) installed. To learn more, see Protection Group Types.
• You can add a protection group for cloud machines only to a Veeam Agent backup job managed by the
backup server. Backup policies are not supported by this type of protection group. To learn more about
backup job types, see Working with Veeam Agent Backup Jobs and Policies.
• You cannot add both cloud machines and physical computers to the same backup job.
• If you add a protection group that contains computers running different OSes to a Veeam Agent backup
job for computers running a certain OS, Veeam Backup & Replication will automatically exclude computers
running other OSes from this backup job.
For example, if you add protection group that contains Microsoft Windows, Linux, and Mac computers to a
Veeam Agent backup job for Linux computers, Veeam Backup & Replication will automatically exclude
Microsoft Windows and Mac computers from this backup job.
2. In the inventory pane, expand the P hy sical Infrastructure node and do one of the following:
o In the inventory pane, select the protection group that you want to add to the backup job and click
Ad d to Backup > W indows > name of the job on the ribbon.
o In the inventory pane, right-click the protection group that you want to add to the backup job and
select Ad d to backup job > W indows > name of the job .
For Linux computers
o In the inventory pane, select the protection group that you want to add to the backup job and click
Ad d to Backup > Linux > name of the job on the ribbon.
o In the inventory pane, right-click the protection group that you want to add to the backup job and
select Ad d to backup job > Linux > name of the job .
o In the inventory pane, select the protection group that you want to add to the backup job and click
Ad d to Backup > Unix > name of the job on the ribbon.
242 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o In the inventory pane, right-click the protection group that you want to add to the backup job and
select Ad d to backup job > Unix > name of the job .
[For protection groups for pre-installed Veeam Agents] For Mac computers
o In the inventory pane, select the protection group that you want to add to the backup job and click
Ad d to Backup > Ma c > name of the job on the ribbon.
o In the inventory pane, right-click the protection group that you want to add to the backup job and
select Ad d to backup job > Ma c > name of the job .
243 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Editing Protection Group Settings
You can edit settings of a protection group. This operation may be required, for example, if you want to
add/remove computers to/from a protection group or change settings for protected computers discovery and
Veeam Agent deployment defined in the properties of the protection group.
NOTE
• You cannot change the type of a protection group when editing protection group settings.
• For the Manually Added protection group, you can change only a limited number of settings. In
particular, you can edit protected computers discovery and Veeam Agent deployment options
(except for changing the distribution server for the protection group). You can also remove from this
protection group computers that are no longer included in a Veeam Agent backup job.
• You cannot edit settings of default protection groups that act as filters used to display protected
computers of a specific type: Unmanaged , Out of Date, Offline and Untrusted .
3. In the inventory pane, select the protection group that you want to edit and click E d it Group on the ribbon
or right-click the protection group that you want to edit and select P roperties.
244 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Rescanning Protection Group
You can rescan a protection group configured in the inventory. When you perform protection group rescan, you
manually start the discovery process for the protection group. This operation may be required, for example, if
you want to discover new computers added to the protection group without waiting for the next scheduled start
of the rescan job.
NOTE
You cannot rescan a protection group for pre-installed Veeam Agents. To learn more, see Protection Group
Types.
During the rescan operation, Veeam Backup & Replication starts the rescan job in the same way as in case of
scheduled discovery. The rescan job connects to computers included in the protection group and performs on
these computers operations specified in the protection group settings. For example, if Veeam Backup &
Replication is set up to automatically install Veeam Agent on protected computers during discovery, you can use
the rescan operation to deploy Veeam Agent to computers that have appeared in the protection group after the
previous scheduled rescan job session finished.
3. In the inventory pane, select the necessary protection group and click Rescan on the ribbon or right-click
the protection group and select Rescan.
245 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Assigning Location to Protection Group
You can assign a location to a protection group configured in Veeam Backup & Replication. To assign a location:
3. In the inventory pane, select the necessary protection group and click Location > <Location name> on the
ribbon or right-click the necessary protection group and select Loca tion > <Location name> .
To learn more about locations, see the Locations section in the Veeam Backup & Replication User Guide.
246 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Disabling Protection Group
You can temporary disable a protection group configured in the inventory. When you disable a protection group,
you disable scheduled discovery of protected computers added to this protection group. This may be required,
for example, if a new version of Veeam Agent appears on the Veeam Backup & Replication server, and you do
not want to deploy Veeam Agent to all protected computers at once. Instead, you can disable the protection
group, test the deployment process on a specific computer in this group, and then enable the protection group
to let Veeam Backup & Replication deploy Veeam Agent to remaining computers.
When you disable a protection group, Veeam Backup & Replication does not start the rescan job upon sc hedule
defined in the protection group settings. However, you can start the discovery process manually if needed. To
learn more, see Rescanning Protection Group.
Disabling a protection group does not affect processing of Veeam Agent computers included in this protection
group. If a protected computer is added to a Veeam Agent backup job, and the backup job is scheduled to start
at the time when the protection group is in the disabled state, the backup job will run as usual.
NOTE
You cannot disable default protection groups that act as filters used to display protected computers of a
specific type: Unmanaged , Out of Date, Offline and Untrusted .
3. In the inventory pane, select the necessary protection group and click Disable on the ribbon or right-click
the necessary protection group and select Disable.
3. In the inventory pane, select the necessary protection group and click Disable on the ribbon or right-click
the necessary protection group and select Disable.
247 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
After you disable a protection group for pre-installed Veeam Agents, Veeam Backup & Replication does not
add new members to this protection group. If the Veeam Agent computer user tries to connect to the
Veeam backup server with the configuration file, the user will get an error message. To learn more about
protection group types, see Protection Group Types.
248 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Removing Protection Group
You can remove a protection group that you configured.
When you remove a protection group, you can instruct Veeam Backup & Replication to remove Veeam Agents
from all protected computers included in this protection group, too. The protection group is removed
permanently. You cannot undo this operation.
Backups created for computers that were included in the removed protection group remain intact in the backup
location. You can delete this backup data manually later if needed.
NOTE
• You cannot remove a protection group if the entire protection group or a separate computer
included in this protection group is added to a Veeam Agent backup job.
• You cannot remove default protection groups, such as Manually Added , Unmanaged , and so on.
TIP
You can also remove separate computers from protection groups. To learn more, see Removing Computer
from Protection Group.
3. In the inventory pane, select the protection group that you want to remove and click Remove Group on
the ribbon or right-click the protection group and select Remove.
4. If you want to remove Veeam Agent deployed on protected computers, in the displayed window, select
the Uninstall Agents check box. With this option selected, Veeam Backup & Replication will remove the
protection group from the configuration database and, in addition, uninstall Veeam Agent and Veeam
Installer Service from every computer in the deleted protection group.
249 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. In the displayed window, click Y es .
250 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Working with Veeam Agent Backup Jobs
and Policies
To back up data of your protected computers, you must configure a Veeam Agent backup job in Veeam Backup &
Replication. The Veeam Agent backup job defines what data to back up, how, where and when to back up data.
One Veeam Agent backup job can be used to process one or more protected computers.
In Veeam Backup & Replication, you can create Veeam Agent backup jobs of the following types:
• The backup job that runs on the backup server in the similar way as a regular job for VM data backup. The
backup job is intended for protected computers that have permanent connection to the backup server. To
learn more, see Backup Job.
• The backup policy that describes configuration of individual Veeam Agent backup jobs that run on
protected computers. Veeam Backup & Replication uses the backup policy as a saved template and applies
settings from the backup policy to Veeam Agents that run on computers added to the backup policy. The
backup policy is intended for protected computers that may have limited connection to the backup server.
To learn more, see Backup Policy.
After you configured a Veeam Agent backup job in Veeam Back up & Replication, you can manage it in Veeam
Backup & Replication as well. Operations available for a Veeam Agent backup job depend on the job mode
specified in the job properties:
• For a Veeam Agent backup job managed by the backup server, Veeam Backup & Replication allows you to
perform a set of operations similar to a regular backup job for VM data backup. To learn more, see
Managing Veeam Agent Backup Jobs.
• For a Veeam Agent backup job managed by Veeam Agent, or backup p olicy, Veeam Backup & Replication
allows you to perform a set of operations similar to a regular Veeam Agent backup job configured on a
Veeam Agent computer. To learn more, see Managing Veeam Agent Backup Policies.
One protected computer may be processed with one or more Veeam Agent backup jobs. To learn more, see
Processing One Computer with Multiple Jobs and Policies.
TIP
When Veeam Agent operates under control of Veeam Backup & Replication, all data protection, data
restore and administration tasks can be performed from the Veeam Backup & Replication console. But
some operations are also available on the Veeam Agent computer side. To learn more, see Operations
Available on Veeam Agent Computer.
Related Topics
Veeam Agent Backup Jobs and Policies
Related Tasks
• Creating Agent Backup Job for Windows Computers
251 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Creating Agent Backup Policy for Linux Computers
252 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Veeam Agent Backup Jobs
To create a Veeam Agent backup job managed by the backup server, you must create a backup job with the
Ma naged by backup server option selected in the job settings. You will be able to add one or more individual
computers and protection groups to the job and instruct Veeam Backup & Replication to create Veeam Agent
backups in a Veeam backup repository or Veeam Cloud Connect repository. The Veeam Agent backup job will
run on the backup server in the similar way as a regular job for VM data backup. To learn more, see Backup Job.
Veeam Backup & Replication lets you create backup jobs for the following types of protected computers:
• Microsoft Windows computers protected with Veeam Agent for Microsoft Windows
If you want to protect a computer running Unix or macOS, you must create a backup job managed by Veeam
Agent (backup policy). To learn more, see Creating Policy for Unix Computers and Creating Policy for Mac
Computers.
253 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Job for Windows Computers
To back up data of a computer protected with Veeam Agent for Microsoft Windows, you can configure a Veeam
Agent backup job in Veeam Backup & Replication.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers and
workstations that you plan to add to the Veeam Agent backup job. To learn more, see Licensing
Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the job must be configured in advance.
• [For backup jobs targeted at the cloud repository] The Veeam Cloud Connect service provider must be
added in the Veeam backup console.
• You can store backups created by a Veeam Agent backup job in a Veeam backup repository and Veeam
Cloud Connect repository. If you want to save backups in other target locations, you must configure a
Veeam Agent backup job managed by Veeam Agent (backup policy). To learn more, see Creating Policy for
Windows Computers.
• Veeam Agent for Microsoft Windows does not support file-level backup for backup jobs that include
failover clusters.
• Veeam Agent for Microsoft Windows does not back up data to which symbolic links are targeted. It only
backs up the path information that the symbolic links contain. After restore, identical symbolic links are
created in the restore destination.
• You cannot map a Veeam Agent backup job managed by the backup server to a Veeam Age nt backup chain
created by another type of a Veeam Agent backup job. After you change the mode of a Veeam Agent
computer, Veeam Backup & Replication starts a new backup chain in a target location specified in the
backup job settings.
• The backup cache is not supported for Veeam Agent backup jobs managed by backup server.
• Veeam Agent does not support creating transaction log backups in a cloud repository. You cannot enable
transaction log backup options in the properties of the backup job targeted at a cloud repository.
• You cannot add a Veeam Agent computer protected by a Veeam Agent backup policy to a backup job
managed by the backup server. To add such a computer to a backup job managed by the backup server,
first remove the computer from the Veeam Agent backup policy.
254 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup job managed by the backup server for protected computers that run a
Microsoft Windows OS in one of the following ways:
• Create a new backup job — in this case, Veeam Backup & Replication will launch the New Agent Backup
Job wizard. You will be able to specify protection groups, individual Active Directory objects and Veeam
Agent computers to which the backup job settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup job — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup job. You will also be
able to change the list of Veeam Agent computers to which the backup job settings must apply at the
Computers step of the wizard.
• Add individual computers to a new backup job — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected computers to the backup job. You will also be able to
change the list of Veeam Agent computers to which the backup job settings must apply at the Computers
step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > W indows computer on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > W indows computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup job and select Ad d to backup job > W indows > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup job and click Ad d to Backup > W indows > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
job. You can add other protection groups and individual computers to the job later on, when you pass through
the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup job. In the working area, select one or more computers that you want to
add to the job, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup job. In the working area, select one or more computers that you want to
add to the job and click Ad d to Backup > New job on the ribbon.
255 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
job. You can add other computers and protection groups to the job later on, when you pass through the wizard
steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup job that is already
configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup Job and
Adding Protection Group to Backup Job.
256 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, specify protection settings for the Veeam Agent backup job managed by
the backup server:
1. Select the type of protected computers whose data you want to back up with Veeam Agents .
• Server — select this option if you want to back up data on standalone servers. This option is suitable for
computers that have permanent connection to the backup server.
For backup jobs that process servers, Veeam Backup & Replication offers settings similar to the settings of
the backup job available in the Server edition of Veeam Agent for Microsoft Windows. To learn more, see
the Veeam Agent for Microsoft Windows User Guide.
With this option selected, you can also select the job mode. To learn more, see Selecting Job Mode.
• Fa ilover cluster — select this option if you want to back up data on a failover cluster.
For backup jobs that process failover clusters, Veeam Backup & Replication offers practically the same
backup job settings as for servers.
With this option selected, the backup job will be managed by the Veeam backup server — you do not need
to select the job mode.
NOTE
You cannot select the W ork station option if you want to create a backup job managed by backup server.
If you selected the Fa ilover cluster computer type in the Ty p e field, you do not need to select the job mode in
the Mod e field, the Ma naged by backup server job mode will be selected automatically.
257 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
If you want to create a Veeam Agent backup policy, see Creating Policy for Windows Computers.
258 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 3. Specify Job Name and Description
At the Na me step of the wizard, specify a name and description for the Veeam Agent backup job managed by
the backup server.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the job, date and time when the job was created.
3. Select the Hig h priority check box if you want the resource scheduler of Veeam Backup & Replication to
prioritize this job higher than other similar jobs and to allocate resources to it in the first place. To learn
more, see the Job Priorities section in the Veeam Backup & Replication User Guide.
259 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers whose data you want to
back up with the Veeam Agent backup job managed by the backup server.
You can add to the Veeam Agent backup job managed by the backup server one or more protection groups and
individual computers from the Veeam Backup & Replication inventory. You can al so add to the job computers
that are not added to inventory yet. Veeam Backup & Replication will add such computers to the job and also
add them to the Manually Added protection group.
If Veeam Backup & Replication discovers a new computer in a protection group after the Veeam Agent backup
job is created, Veeam Backup & Replication will automatically update the job settings to include the added
computer.
NOTE
• Veeam Backup & Replication displays protection groups for pre-installed Veeam Agents and their
members only if you selected the Ma naged by agent option at the Job Mode step of the wizard. You
cannot add protection groups for pre-installed Veeam Agents to backup jobs managed by backup
server. To learn more, see Protection Group Types.
• If you used the Ad d to backup job > W indows > New job option to launch the New Agent Backup Job
wizard, the P rotected computers list will already contain computers that you have selected to add
to the job. You can remove some computers from the job or add new computers to the job, if
necessary.
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] or [Shift] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
260 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. Click the Sta rt search button on the right or press [Enter].
2. In the Ad d Computer window, in the Host name or IP address field, enter a full DNS name or IP address of
the computer that you want to add to the job.
261 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. From the Credentials list, select a user account that has administrative permissions on the computer that
you want to add to the job. If you have not set up credentials beforehand, click the Ma nage accounts link
or click Ad d on the right to add credentials. For more information, see the Credentials Manager section in
the Veeam Backup & Replication User Guide.
262 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup.
1. In the Ba ckup mode section, select the backup mode. You can select one of the following options:
o E ntire computer — select this option if you want to create a backup of the entire computer image.
When you restore data from such backup, you will be able to recover the entire computer image as
well as data on specific computer volumes: files, folders, application data and s o on. With this option
selected, you will pass to Storage step of the wizard.
o Volume level backup — select this option if you want to create a backup of specific computer volumes,
for example, all volumes except the system one. When you restore data from such backup, you will be
able to recover data located on these volumes only: files, folders, application data and so on. With
this option selected, you will pass to the Objects step of the wizard.
o File level backup — select this option if you want to create a backup of individual folders on your
computer. With this option selected, you will pass to the Objects step of the wizard.
2. [For entire computer backup] If you want to include in the backup one or more external USB drives, select
the Include external USB drives check box. With this option selected, Veeam Agent will include in the
backup all external USB drives that are connected to the Veeam Agent computer at the time when the
backup job starts. To learn more, see the Backup of External Drives section in the Veeam Agent for
Microsoft Windows User Guide.
263 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
• The File level backup option is not available if you have selected the Fa ilover cluster option at the
Job Mode step of the wizard.
• File-level backup is typically slower than volume-level backup. Depending on the performance
capabilities of your computer and backup environment, the difference between file -level and
volume-level backup job performance may increase significantly. If you plan to back up all folders
with files on a specific volume or back up large amount of data, we recommend that you configure
volume-level backup instead of file-level backup.
264 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you chose to create volume-level or file-level Veeam Agent
backups. Specify backup scope for the Veeam Agent backup job managed by the backup server:
• Specify volumes to back up — if you have selected the Volume level backup option at the Backup Mode
step of the wizard.
• Specify folders to back up — if you have selected the File level backup option at the Backup Mode step of
the wizard.
At this step of the wizard, you must specify the backup scope — define what volumes you want to include in the
backup. The specified backup scope settings will apply to all computers that are added to the backup job. If a
specified volume does not exist on one or more computers in the job, the job will skip such volume on those
computers and back up only existing ones.
To specify the backup scope, you can select the Ba ckup the following volumes only option and add necessary
objects.
Alternatively, you can back up the whole Veeam Agent computer. To do this, select the Ba ckup all volumes
ex cept the following option. With this option selected, you can exclude objects that you do not need from the
backup scope.
• OS volume — data on the OS installed on a protected computer. This object includes the Microsoft
Windows system partition and boot partition of your computer. For GPT disks on Microsoft Windows 8.1,
10, 11, 2012, 2012 R2, 2016, 2019, and 2022, the object additionally includes the recovery partition. To
learn more, see the System State Data Backup section in the Veeam Agent for Microsoft Windows User
Guide.
To include or exclude the OS volume, in the necessary wizard section, click Ad d and select the OS volume
option.
• Individual volumes .
To include or exclude individual volumes:
a. In the necessary wizard section, click Ad d and select the Volume name option.
b. In the Ad d Object window, type the drive letter of a volume that you want to back up, for example,
C:\, and click OK.
c. Repeat steps a–b for all volumes that you want to back up.
a. In the necessary wizard section, click Ad d and select the Volume name option.
b. In the Ad d Object window, type the path to a folder that is an entry point to the mounted volume you
want to back up, for example, C:\Data, and click OK.
c. Repeat steps a–b for all mount points that you want to back up.
265 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a system volume in the volume-level backup, Veeam Agent for Microsoft Windows
automatically includes the System Reserved/UEFI or other system partitions in the backup too.
• You cannot include volumes located on virtual hard disks (VHD or VHDX) in the volume-level
backup.
• Veeam Agent for Microsoft Windows automatically adds to the list of exclusions the following
Microsoft Windows objects for all computer users: temporary files folder, Recycle Bin, Microsoft
Windows pagefile, hibernate file and VSS snapshot files from the System Volume Information folder.
In the file-level backup mode, you can create two types of backups:
• Hybrid backup that contains individual folders and specific volumes of your computer.
At this step of the wizard, you must specify the backup scope by defining what folders with files or entire
volumes you want to include in the backup. The specified backup scope settings will apply to all computers that
are added to the backup job. If a specified object does not exist on one or more computers in the job, the job will
skip such object on those computers and back up existing ones.
266 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
To specify the backup scope, in the Ob jects to backup list, select check boxes next to necessary objects. You can
include the following data in the backup:
• Operating system — data related to the OS installed on a protected computer. To learn more, see the
System State Data Backup section in the Veeam Agent for Microsoft Windows User Guide.
• Personal files — data related to user profiles. With this option enabled, Veeam Backup & Replication will
include in the backup scope settings and data related to Veeam Agent computer user profiles. To learn
more, see the Personal Data Backup section in the Veeam Agent for Microsoft Windows User Guide.
• Individual file system objects — folders, mount points, and volumes of a protected computer.
1. Select the The following file system objects check box and click Ad d .
2. In the Ad d Object window, type the path to a folder, mount point folder, or volume that you want to back
up, for example, D:\Reports or D:\, and click OK.
To specify the backup scope, you can use system environment variables such as %ProgramFiles% or
%WinDir%. This may be useful, for example, in case computers added to the backup job run different
versions of Microsoft Windows OSes, and actual paths to directories that contain data of the same type
differ on these computers.
o You can use only system environment variables — variables defined for the Local System account on
computers added to the backup job. User-dependent environment variables are not supported.
o Environment variables that contain multiple values (such as the %PATH% variable) are not
supported.
o Environment variables that contain other environment variables are not supported.
3. Repeat steps 1–2 for all items that you want to back up.
267 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a system volume in the file-level backup, Veeam Agent does not automatically include
the System Reserved/UEFI or other system partitions in the backup. These volumes are
automatically included in the backup only if you select the Operating system option to specify the
backup scope.
• Veeam Agent automatically adds to the list of exclusions the following Microsoft Windows objects
for all computer users: temporary files folder, Recycle Bin, Microsoft Windows pagefile, hibernate
file and VSS snapshot files from the System Volume Information folder.
• You can exclude Microsoft OneDrive folders from the backup scope in the File Filters window.
Configuring Filters
To include or exclude folders and files of a specific type in/from the file-level backup, you can configure filters.
268 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a specific folder in the file-level backup, Veeam Agent applies filters to files in specific
folders that you include in the backup. Filters are not applied to computer volumes, mount points,
and folders selected for backup. If you plan to create a hybrid backup that will contain volumes,
mount points, and folders, filters will be applied to files in folders only.
• If you include a whole volume in the file-level backup, you cannot apply filters to include or exclude
files of a specific type in/from the backup. You can only exclude specific folders that reside on the
volume.
• You cannot apply filters to files and folders that reside on the mount point.
• If you want to include or exclude files in/from the file-level backup, you can use file names and
masks for file types as filters. You cannot use paths to files.
To configure a filter:
o If you include a specific folder in the file-level backup, in the Include masks field, specify file names
and masks for file types that you want to back up, for example, MyReport.pdf, *filename*,
*.docx. The resulting Veeam Agent backup will contain only selected files. Other files will not be
backed up.
You cannot specify include masks if you add an entire volume in the backup.
o In the E x clude masks field, specify files that you do not want to back up in the following ways:
▪ If you include an entire volume in the file-level backup, in the E x clude masks field, specify paths
to folders that contain files that you do not want to back up. The resulting Veeam Agent backup
will contain all folders that reside on the backed-up volume except the files in the specified
folders.
For example, you include the D:\ volume in the backup and specify the
D:\Reports\OldReports folder in the E x clude masks field. The resulting backup will contain
all folders and files that reside on the volume except files that reside in the
D:\Reports\OldReports folder.
▪ If you include a specific folder in the file-level backup, in the E x clude masks field, specify paths
to folders that contain files that you do not want to back up and file names and masks for fil e
types that you do not want to back up, for example, OldReports.rar, *.temp, *.tmp,
*.back. The resulting Veeam Agent backup will contain all files that reside in the backed -up
folder except files in the specified folders and files whose names match the s pecified names or
masks.
Keep in mind that depending on the backup type, Veeam Agent excludes files and folders from the
backup scope differently:
▪ For the volume-level backup, content of folders you do not want to back up is excluded from
the VSS snapshot with the FilesNotToSnapshot registry key.
269 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
▪ For the file-level backup, folders and files are excluded by Veeam Agent after the VSS snapshot
is created.
As a result, some objects may be excluded or not excluded from the backup scope depending on the
type of the created backup. For example, if you configure a volume-level backup, the objects that you
excluded may stay in the backup scope due to the FilesNotToSnapshot registry key limitations. To
learn more, see this Microsoft article.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
TIP
You can also use system environment variables to specify include and exclude masks. In this case, you must
type the back slash (\) symbol in the beginning of the mask. For example: \%appdata%.
• To specify include and exclude masks, you can use only system environment variables — variables
defined for the Local System account on computers added to the backup job, and cannot use user
environment variables. For example, if you specify the \%appdata% exclude mask, Veeam Agent
will exclude the C:\Windows\system32\config\systemprofile\AppData\Roaming folder
from the backup. Application data directories for other user accounts (for example,
C:\Users\Administrator\AppData\Roaming) will not be excluded from the backup.
• You cannot use environment variables that contain multiple values or other environment variables
to specify include and exclude masks.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
The resulting Veeam Agent backup will contain all files of the PDF format that do not contain draft in their
names.
Additionally, you can specify how Veeam Agent for Microsoft Windows will process Microsoft OneDrive folders.
Select the E x clude Microsoft OneDrive folders option to exclude Microsoft OneDrive folders and their content
from the backup scope.
• Veeam Agent excludes Microsoft OneDrive folders only in file-level backups. If you include an entire
volume in the backup, Veeam Agent will not exclude Microsoft Onedrive folders from this volume.
270 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Due to the OS limitations, the E x clude Microsoft OneDrive folders option behaves properly only on Veeam
Agent computers running Microsoft Windows 10. If your Veeam Agent computers run other OS versions,
we recommend to exclude Microsoft OneDrive folders manually.
271 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Specify Backup Storage Settings
Specify settings for the target backup repository:
1. From the Ba ckup repository list, select a backup repository where you want to store Veeam Agent
backups. You can select from the following types of backup repositories:
o Veeam backup repository configured on the backup server that will manage the created backup job.
o Cloud repository allocated to your tenant account by a Veeam Cloud C onnect service provider.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
NOTE
Keep in mind when you work with cloud machines, Veeam Backup & Replication displays only AWS or
Azure object storage repositories depending on the type of cloud machine you selected to back up.
2. You can map the job to a specific backup stored in the backup repository. Backup job mapping can be
helpful if you have moved backup files to a new backup repository and want to point the job to existing
backups in this new backup repository. You can also use backup job mapping if the configuration database
got corrupted and you need to reconfigure backup jobs.
To map the job to a backup, click the Ma p backup link and select the backup in the backup repository.
Backups can be easily identified by job names. To find the backup, you can also use the search field at the
bottom of the window.
NOTE
You cannot map a Veeam Agent backup job configured in Veeam Backup & Replication to a backup
chain that was created by Veeam Agent operating in the standalone mode.
3. Specify short-term backup retention policy settings in one of the following ways:
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is exceeded, Veeam Backup &
Replication removes the earliest restore points from the backup chain.
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
calendar days, including days when backup files are not created. After this period is over, Veeam
Backup & Replication removes the earliest restore points from the backup chain.
4. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
5. If you want to archive backup files created with the backup job to a secondary destination (backup
repository or tape), select the Configure secondary destinations for this job check box. With this option
enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At the
Secondary Target step of the wizard, you can link the backup job to the backup copy job or backup to tape
backup job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
272 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
6. Click Ad vanced to specify advanced settings for the backup job. To learn more, see Specify Advanced
Backup Settings.
273 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 8. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup job managed by the
backup server:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
TIP
After you specify necessary settings for the Veeam Agent backup job, you can save them as default
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup job, Veeam Backup & Replication will automatically apply the default
settings to the new job.
Backup Settings
To specify settings for a backup chain created with the backup job:
2. If you want to periodically create synthetic full backups, on the Ba ckup tab, select the Create synthetic
full backups p eriodically check box and click Da ys to schedule synthetic full backups on the necessary
week days.
NOTE
Synthetic full backup is not available for backup jobs targeted at an object storage repository.
3. If you want to periodically create active full backups, select the Create active full backups periodically
check box. Click Configure and use the Monthly on or W eekly options to define scheduling settings.
274 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• Before scheduling periodic full backups, you must make sure that you have enough free space on
the target location. For more information about periodic full backups, see the Active Full Backup
and Synthetic Full Backup sections in the Veeam Agent for Microsoft Windows User Guide.
• If you schedule the active full backup and synthetic full backup on the same day, Veeam Agent for
Microsoft Windows will perform only active full backup. Synthetic full backup will be skipped.
Maintenance Settings
You can specify maintenance settings for a backup chain created with the Veeam Agent backup job.
Maintenance operations help make sure that the backup chain remains valid and consistent.
275 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. To periodically perform a health check for the latest restore point in the backup chain, in the Storage-level
corruption guard section, select the P erform backup files health check check box. To specify the schedule
for the health check, click Configure. An automatic health check can help you avoid a situation where a
restore point gets corrupted, making all dependent restore points corrupted, too. If during the health
check Veeam Agent for Microsoft Windows or Veeam Backup & Replication detect corrupted data blocks in
the latest restore point in the backup chain (or the restore point before the latest one if the latest restore
point is incomplete), it will start the health check retry and transport valid data blocks from the Veeam
Agent computer to the target location. The transported data blocks are stored to a new backup file or the
latest backup file in the backup chain, depending on the data corruption scenario.
For Veeam Agent backup jobs managed by the backup server, the health check process is similar to the
one for backup jobs that process VMs. For more information, see the Health Check for Backup Files section
in the Veeam Backup & Replication User Guide.
4. Select the Remove deleted items data after check box and specify the number of days for which you want
to keep the backup created with the backup job in the target location.
For backup jobs managed by the backup server, deleted items retention policy is similar to retention policy
for deleted VMs. After you remove a protection group or individual computer from a Veeam Agent backup
job, Veeam Backup & Replication will keep its data on the backup repository for the period that you have
specified. When this period is over, backup data of this computer will be removed from the backup
repository. For more information, see the Retention Policy for Deleted Items section in the Veeam Backup
& Replication User Guide.
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. In the opposite case, the backup job may work not as expected
and remove data that you still require.
To periodically compact a full backup, select the Defragment and compact full backup file check box. To
specify the schedule for the compact operation, click Configure. During the compact operation, data
blocks from the full backup file are copied to a new empty file. As a result, the full backup file gets
defragmented, and the speed of reading from and writing to the backup file increases.
NOTE
The Defragment and compact full backup file option is not available for backup jobs targeted at
object storage.
For Veeam Agent backup jobs managed by the backup server, the compact operation is similar to the
compact operation performed for VM backup jobs. If the full backup file contains data blocks for deleted
items (protection groups or individual computers that were removed from the backup job), Veeam Backup
& Replication will remove these data blocks. For more information, see the Compact of Full Backup File
section in the Veeam Backup & Replication User Guide.
276 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you want to periodically compact a full backup, you must make sure that you have enough
free space in the target location. For the compact operation, the amount of free space must
be equal to or more that the size of the full backup file.
• In contrast to the compact operation for a VM backup, during compact of a full Veeam Agent
backup file, Veeam Backup & Replication does not perform the data take out operation. If the
full backup file contains data for a computer that has only one restore point and this restore
point is older than 7 days, Veeam Backup & Replication will not extract data for this computer
to a separate full backup file.
Storage Settings
To specify storage settings for the backup job:
3. [For a failover cluster backup job] By default, Veeam Backup & Replication deduplicates failover cluster
data before storing it in the backup repository. Data deduplication provides a smaller size of the backup
file but may reduce the backup job performance. You can disable data deduplication if necessary, for
example, if you use a deduplication storage appliance as a backup repository. To disable data
deduplication, clear the E na ble inline data deduplication check box.
277 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
The E nable inline data deduplication option is unavailable if you selected the Server option at the
Job Mode step of the wizard.
4. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme. To learn more about the compression levels, see the Data Compression section
in the Veeam Agent for Microsoft Windows User Guide.
5. In the Storage optimization section, select what size of data blocks you plan to use: 4 MB, 1 MB, 512 KB,
256 KB. Veeam Agent for Microsoft Windows will use data blocks of the chosen size to optimize the size of
backup files and job performance.
NOTE
If you change the storage optimization settings for the backup job, new settings will not have any
effect on previously created files in the chain. They will be applied to new files created after the
settings were changed.
To apply new storage optimization settings in backup jobs, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Replication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
6. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will d isplay a
warning about it. For more information, see the Decrypting Data Without Password section in the Veeam
Backup & Replication User Guide.
You can select a Key Management System (KMS) server in the P a ssword field. The KMS server must be
added to Veeam Backup & Replication in advance. If you choose to use KMS keys for backup file
encryption at this step of the wizard, Veeam Backup & Replication immediately starts communication with
the KMS server to retrieve the encryption keys. To learn more, see the Key Management System Keys
section in the Veeam Backup & Replication User Guide.
278 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• You must encrypt the backup job if you want to back up data to the Veeam Data Vault
storage.
• Data encryption settings for Veeam Agent backup jobs configured in Veeam Backup & Replication are
stored to the Veeam Backup & Replication database.
• If you enable or disable encryption for an existing Veeam Agent backup, during the next job session
Veeam Agent for Microsoft Windows will create a full backup file. The created full backup file and
subsequent incremental backup files in the backup chain will be encrypted with the specified password.
• Encryption is not retroactive. If you enable encryption for an existing backup job, Veeam Backup &
Replication will encrypt the backup chain starting from the next restore point created with this job.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in the
Veeam Backup & Replication User Guide.
279 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Notification Settings
You can specify notification settings for Veeam Agent backup jobs configured in Veeam Backup & Replicati on.
To specify notification settings:
3. Select the Send SNMP notifications for this job check box if you want to receive SNMP traps when the job
completes successfully.
SNMP traps will be sent if you specify global SNMP settings in Veeam Backup & Replication and configure
software on recipient's machine to receive SNMP traps. For more information, see the Specifying SNMP
Settings section in the Veeam Backup & Replication User Guide.
4. Select the Send e-mail notifications to the following recipients check box if you want to receive
notifications about the job completion status by email. In the field below, specify a recipient’s email
address. You can enter several addresses separated by a semicolon.
Email notifications will be sent if you configure global email notification settings in Veeam Backup &
Replication. For more information, see the Configuring Global Email Notification Settings section in Veeam
Backup & Replication User Guide.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the job, select Use global notification settings. In this case, Veeam
Backup & Replication will apply to the job global email notification settings specified for the backup
server.
o To configure a custom notification for the job, select Use custom notification settings specified
b elow. You can specify the following notification settings:
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the job) and %Issues% (number of machines in the job that have been processed
with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning or Notify on error check boxes to receive email
notification if the job completes successfully, completes with a warning or fails.
280 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
▪ Select the Sup press notifications until the last retry check box to receive a notification about the
final job status. If you do not enable this option, Veeam Backup & Replication will send one
notification per every job retry.
Integration Settings
You can specify storage integration settings for the job managed by backup server.
Keep in mind that storage integration settings are unavailable if you work with protection group for cloud
machines.
3. If you select the E na ble backup from storage snapshots check box, Veeam Backup & Replication will use
native storage snapshots to create Veeam Agent backups. To learn more about storage snapshots support,
see Storage Snapshots Support.
4. To transfer a snapshot from storage to the target repository, Veeam Backup & Replication uses off -host
backup proxies. You can allow Veeam Backup & Replication to use any suitable backup proxies or you can
select specific backup proxies. To learn more, see Selecting Off-Host Backup Proxy.
281 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. If Veeam Backup & Replication fails to create a storage snapshot or backup proxy is unavailable, you can
fail over to the regular backup scenario that uses the software VSS provider . To do this, select the Fa ilover
to on-host backup agent check box.
To learn more about regular backup scenario, see the How Backup Works section in the Veeam Agent for
Microsoft Windows User Guide.
• If you want Veeam Backup & Replication to use any suitable backup proxies, select the Automatic
selection option. In this case, the number of backup proxies that Veeam Backup & Replication uses for
data transfer depends on the backup scope.
IMP ORTANT
If you use the NetApp Element storage system and you have 4 or more backup proxies set in your
Veeam Backup & Replication infrastructure, you cannot use automatic selection. You must manually
select up to 3 backup proxies.
• If you want to select backup proxies manually, select the Use the selected off-host backup proxy servers
only option and select check boxes near backup proxies you plan to use.
282 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Keep in mind that Veeam Backup & Replication displays only those backup proxies that run Microsoft Windows
Server OS. For more information about backup proxy requirements, see Storage Snapshots Support.
Script Settings
You can specify script settings for the job managed by backup server.
3. If you want to execute custom scripts before or after the backup job, select the Before the job or After the
job check boxes and click Browse to choose executable files from a local folder on the backup server. The
scripts are executed on the backup server.
You can select to execute pre- and post-backup actions after a number of backup sessions or on specific
week days.
o If you select the Run scripts every <N> backup session option, specify the number of the backup job
sessions after which the scripts must be executed.
o If you select the Run scripts on the selected days only option, click Da y s and specify week days on
which the scripts must be executed.
283 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
Custom scripts that you define in the advanced job settings relate to the backup job itself, not the OS
quiescence process on protected computers. To add pre-freeze and post-thaw scripts for Veeam Agent
computer OS quiescence, use the Guest Processing step of the wizard.
284 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 9. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the backup job to a backup to tape or backup copy job.
As a result, the backup job will be added as a source to the backup to tape or backup copy job. Backup files
created with the backup job will be archived to tape or copied to the secondary backup repository according to
the secondary jobs schedule. For more information, see the Linking Backup Jobs to Backup Copy Jobs and
Linking Backup Jobs to Backup to Tape Jobs sections in the Veeam Backup & Replication User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup job to these jobs, Veeam Backup & Replication will
automatically update the linked jobs to define the Veeam Agent backup job as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup job. You can link several jobs to the backup job — for example, one backup to tape job and one
backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
285 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 11. Specify Guest Processing Settings
For a Veeam Agent backup job managed by the backup server that protects Windows -based computers, you can
enable the following guest OS processing settings:
• Application-aware processing
• File indexing
Application-Aware Processing
If your computer runs VSS-aware applications, you can enable application-aware processing to create a
transactionally consistent backup. The transactionally consistent backup guarantees proper recovery of
applications without data loss.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
286 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. On the General tab, in the Ap p lications section, make sure that the E na ble application-aware processing
check box is selected.
You can clear this check box, for example, if you want to disable application-aware processing for a
specific computer added to the backup job as a part of a protection group.
[For Microsoft SQL Server] If you disable application-aware processing, Veeam Agent will not include
information about databases in the backup. However, you can use Veeam Explorer f or Microsoft SQL to
locate a database file in the backup and restore the database.
5. [For Microsoft Exchange, Microsoft SQL Server and other applications that rely on VSS] In the Microsoft
VSS settings section, specify if Veeam Agent for Microsoft Windows running on a protected computer
must process transaction logs or copy-only backups must be created.
o Select P rocess transaction logs with this job if you want Veeam Agent for Microsoft Windows to
process transaction logs.
[For Microsoft Exchange] With this option selected, Veeam Agent for Microsoft Windows will wait for
backup to complete successfully, and then trigger truncation of transaction logs. If the backup job
fails, the logs will remain untouched until the next backup job session.
[For Microsoft SQL Server and Oracle] You will have to specify settings for database log handling on
the SQL and Ora cle tabs of the P rocessing Settings window. For more information, see Microsoft SQL
Server Transaction Log Settings and Oracle Archived Log Settings.
o Select P erform copy only if you use another tool to maintain consistency of the database state. Veeam
Agent for Microsoft Windows will create a copy-only backup. The copy-only backup preserves the
chain of full/differential backup files and transaction logs. After a copy -only backup, Veeam Agent
does not trigger truncation of transaction logs. For more information, see this Microsoft article.
287 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
• [For Microsoft Exchange] Veeam Agent for Microsoft Windows performs truncation of Microsoft
Exchange transaction logs only if all disks that contain the Microsoft Exchange database are
included in a volume-level backup job.
• [For Microsoft SQL Server and Oracle] If both Microsoft SQL Server and Oracle Server are installed
on one guest OS, you can enable log backup settings only for one of the installed applications:
Microsoft SQL Server or Oracle Server.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
4. In the Microsoft VSS settings section, select P rocess transaction logs with this job.
288 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
6. To specify a user account that Veeam Agent will use to connect to the Microsoft SQL Server, select from
the Sp ecify Windows account with sysadmin role on SQL Server list a user account that has access
permissions on the database. This account must be a Microsoft Windows user account with roles and
permissions as specified in section Permissions for Guest Processing. Keep in mind that you cannot use
Microsoft SQL Server accounts (for example, the SA account) to connect to the database.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
will connect to the Microsoft SQL Server under the account that you have specified for the protected
computer in the protection group settings.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
7. Specify how transaction logs must be processed. You can select one of the following options:
o Select Truncate logs to truncate transaction logs after successful backup. Veeam Agent will wait for
the backup to complete successfully and then truncate transaction logs. If the backup job fails, the
logs will remain untouched until the next backup job session.
o Select Do not truncate logs to preserve transaction logs. When the backup job completes, Veeam
Agent will not truncate transaction logs.
We recommend that you enable this option only for databases with log truncation managed by a
database administrator and databases that use the Simple recovery model. If you enable this option
for databases that use the Full or Bulk-logged recovery model, transaction logs may grow large and
consume all disk space. In this case, the database administrator must take care of transaction logs.
o Select Ba ckup logs periodically to back up transaction logs with Veeam Agent. Veeam Agent will
periodically copy transaction logs to the backup location and store them together with the image-
level backup. During the backup job session, transaction logs will be truncated.
For more information, see the Microsoft SQL Server and Oracle Logs Backup section in the Veeam
Agent for Microsoft Windows User Guide.
If you have selected to back up transaction logs with Veeam Agent for Microsoft Windows, you must specify
settings for transaction logs backup:
1. In the Ba ckup logs every <N> minutes field, specify the frequency for transaction logs backup. By default,
transaction logs are backed up every 15 minutes. The maximum log backup interval is 480 minutes.
2. In the Retain log backups section, specify retention policy for transaction logs stored in the backup
location.
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
image-level backups and transaction log backups.
289 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Select Keep only last <N> days of log backups to keep transaction logs for a specific number of days.
By default, transaction logs are kept for 15 days. If you select this option, you must make sure that
retention for transaction logs is not greater than retention for the image-level backup. For more
information, see the Retention for Database Log Backups section in the Veeam Agent for Microsoft
Windows User Guide.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
4. In the Microsoft VSS settings section, select P rocess transaction logs with this job.
6. To specify a user account that Veeam Agent for Microsoft Windows will use to connect to the Oracle
database, select from the Sp ecify Oracle account with SYSDBA privileges list a user account that has
SYSDBA rights on the database. If you have not set up credentials beforehand, click the Ma nage accounts
link or click Ad d on the right to add credentials.
By default, the Use guest OS credentials option is selected in the list. With this option selected, Veeam
Agent for Microsoft Windows will connect to the Oracle database under the account that you have
specified for the protected computer in the protection group settings.
290 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
7. In the Archived logs section, specify if Veeam Agent for Microsoft Windows must delete archived redo
logs on the Oracle database:
o Select Do not d elete archived logs if you want Veeam Agent for Microsoft Windows to preserve
archived logs. When the backup job completes, Veeam Agent for Microsoft Windows will not delete
archived logs.
It is recommended that you select this option for databases for which the ARCHIVELOG mode is
turned off. If the ARCHIVELOG mode is turned on, archived logs may grow large and consume all disk
space. In this case, the database administrator must take care of archived logs him-/herself.
o Select Delete logs older than < N> hours or Delete logs over <N> GB if you want Veeam Agent for
Microsoft Windows to delete archived logs that are older than <N> hours or larger than <N> GB.
Veeam Agent for Microsoft Windows will wait for the backup job to complete successfully and then
trigger archived logs deletion from the Oracle Call Interface (OCI) according to the specified settings.
If the backup job fails, the logs will remain untouched until the next successful backup job session.
TIP
If you configure backup job to back up archived logs, Veeam Agent for Microsoft Windows also
triggers archived logs deletion during each interval of the log backup job.
8. To back up Oracle archived logs with Veeam Agent for Microsoft Windows, select the Ba ck up logs every
< N> minutes check box and specify the frequency for archived logs backup. By default, archived logs are
backed up every 15 minutes. The minimum log backup interval is 5 minutes. The maximum log backup
interval is 480 minutes.
9. In the Retain log backups section, specify retention policy for archived logs stored in the backup location:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
Veeam Agent backups and archived log backups.
291 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
o Select Keep only last <N> days of log backups to keep archived logs for a specific number of days. By
default, archived logs are kept for 15 days. If you select this option, you must make sure that
retention for archived logs is not greater than retention for the Veeam Agent backups. For more
information, see the Retention for Database Log Backups section in the Veeam Agent for Microsoft
Windows User Guide.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
292 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
5. From the Sp ecify SharePoint admin account list, select a user account that Veeam Agent for Microsoft
Windows will use to connect to the SharePoint application. If you have not set up credentials beforehand,
click the Ma nage accounts link or click Ad d on the right to add credentials.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
for Microsoft Windows will connect to the SharePoint application under the account that you have
specified for the protected computer in the protection group settings.
1. At the Guest Processing step, make sure that the E na ble application-aware processing check box is
selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
293 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
5. From the Sp ecify admin account for script execution list, select a user account that Veeam Agent for
Microsoft Windows will use to run pre-freeze and post-thaw scripts. If you have not set up credentials
beforehand, click the Ma nage accounts link or click Add on the right to add credentials.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
for Microsoft Windows will run pre-freeze and post-thaw scripts under the account that you have
specified for the protected computer in the protection group settings.
6. In the Script processing mode section, specify the scenario for scripts execution:
o Select Require successful script execution if you want Veeam Agent for Microsoft Windows to stop
the backup process if the script fails.
o Select Ig nore script execution failures if you want to continue the backup process even if script errors
occur.
7. In the Sna pshot scripts section, in the P re-freeze script and P ost-thaw script fields, click Browse to choose
executable files from a local folder on the backup server. During the backup job session, Veeam Backup &
Replication will upload the scripts to Veeam Agent computers added to the job and execute them on these
computers.
Veeam Agent for Microsoft Windows supports the following types of scripts:
You can use scripts of other formats as well, but we cannot guarantee correct processing of such scripts.
294 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
File Indexing
You can instruct the backup job to create an index of files and folders on the protected computer OS during
backup. If you enable the file indexing option, you will be able to search for individual files inside Veeam Agent
backups and perform 1-click restore in Veeam Backup Enterprise Manager.
NOTE
File system indexing is optional. If you do not enable this option in the backup job settings, you will still be
able to perform 1-click restore from the backup created with such backup job. For more information, see
the Preparing for File Browsing and Restore section in the Veeam Backup Enterprise Manager User Guide.
1. At the Guest Processing step of the wizard, select the E nable guest file system indexing and malware
d etection check box .
3. In the displayed list, select a protection group or individual computer and click E d it.
o Select Ind ex everything if you want to index all files within the backup scope that you have specified
at the Backup mode step of the wizard. Veeam Agent for Microsoft Windows will index all files that
reside:
▪ On the volumes that you have specified for backup (for volume-level backup)
▪ In the folders that you have specified for backup (for file-level backup)
o Select Ind ex everything except if you want to index all files on the protected computer OS except
those defined in the list. By default, system folders are excluded from indexing. You can add or delete
folders using the Ad d and Remove buttons on the right. You can also use system environment
variables to form the list, for example: %windir%, %Program Files% and %Temp%.
295 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Select Ind ex only following folders to define folders that you want to index. You can add or d elete
folders to index using the Ad d and Remove buttons on the right. You can also use system
environment variables to form the list, for example: %windir%, %Program Files% and %Temp%.
296 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 12. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup job manually to create backup.
o To run the job at specific time daily, on defined week days or with specific periodicity, select Da ily at
this time. Use the fields on the right to configure the necessary schedule.
o To run the job once a month on specific days, select Monthly at this time. Use the fields on the right
to configure the necessary schedule.
o To run the job repeatedly throughout a day with a specific time interval, select P eriodically every. In
the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and use the
time table to define the permitted time window for the job. In the Sta rt time within an hour field,
specify the exact time when the job must start.
▪ The defined interval always starts at 12:00 AM. For example, if you configure to run a job with a
4-hour interval, the job will start at 12:00 AM, 4:00 AM, 8:00 AM, 12:00 PM, 4:00 PM and so
on.
▪ If you define permitted hours for the job, after the denied interval is over, the job will start
immediately and then run by the defined schedule.
For example, you have configured a job to run with a 2-hour interval and defined permitted hours
from 9:00 AM to 5:00 PM. According to the rules above, the job will first run at 9:00 AM, when the
denied period is over. After that, the job will run at 10:00 AM, 12:00 PM, 2:00 PM and 4:00 PM.
o To run the job continuously, select the P eriodically every option and choose Continuously from the
list on the right. A new backup job session will start as soon as the previous backup job session
finishes.
o To chain jobs, use the After this job field. In the common practice, jobs start one after another: when
job A finishes, job B starts and so on. If you want to create a chain of jobs, you must define the time
schedule for the first job in the chain. For the rest of the jobs in the chain, select the After this job
option and choose the preceding job from the list.
NOTE
The After this job function will automatically start a job if the first job in the chain is started
automatically by schedule. If you start the first job manually, Veeam Backup & Replication will
display a notification. You will be able to choose whether Veeam Backup & Replication must start the
chained job as well.
3. In the Automatic retry section, define whether Veeam Backup & Replication must attempt to run the
backup job again if the job fails for some reason. Enter the number of attempts to run the job a nd define
time intervals between them. If you select continuous backup, Veeam Backup & Replication retries the job
for the defined number of times without any time intervals between the job runs.
297 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
The automatic retry does not start if you run the backup job manually. In this case, you can manually
retry the backup job. To learn more, see Retrying Veeam Agent Backup Job.
4. In the Ba ckup window section, define the time interval within which the backup job must complete. The
backup window prevents the job from overlapping with production hours and ensures that the job does
not impact performance of your server. To set up a backup window for the job:
a. Select the Terminate job if it exceeds allowed backup window check box and click W ind ow.
b. In the Time P eriods window, define the allowed hours and prohibited hours for backup.
If the job exceeds the allowed window, it will be automatically terminated. In this case, data transport
and backup chain transformation processes are stopped. Keep in mind that this behavior differs from a
VM backup job where backup window affects data transport process and health check operations
only.
298 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 13. Review Backup Job Settings
At the Summary step of the wizard, complete the backup job configuration process.
2. Select the Run the job when I click Finish check box if you want to start the job right after you finish
working with the wizard.
299 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Job for Linux Computers
To back up data of a computer protected with Veeam Agent for Linux, you can configure a Veeam Agent backup
job in Veeam Backup & Replication.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers and
workstations that you plan to add to the Veeam Agent backup job. To learn more, see Licensing
Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the job must be configured in advance.
• [For backup jobs targeted at the cloud repository] The Veeam Cloud Connect service provider must be
added in the Veeam backup console.
• If you want to perform a volume-level restore of a machine using Veeam Agent, the BIOS boot partition of
this machine must be associated with a block device. Otherwise, Veeam Agent supports only file -level
restore from the backup of the machine.
• You can create Veeam Agent backups in a Veeam backup repository and Veeam Cloud Connect repository.
If you want to save backups in other target locations, you must configure a Veeam Agent backup job
managed by Veeam Agent (backup policy). To learn more, see Creating Policy for Linux Computers.
• You cannot map a Veeam Agent backup job managed by the backup server to a Veeam Agent backup chain
created by another type of a Veeam Agent backup job. After you change the mode of a Veeam Age nt
computer, Veeam Backup & Replication starts a new backup chain in a target location specified in the
backup job settings.
• Veeam Agent does not support creating transaction log backups in the cloud repository. You cannot
enable transaction log backup options in the properties of the backup job targeted at the cloud repository.
• Veeam Agent does not support backup of bind mount points. In the scope of the backup job, you must
specify the path to the original mount point instead.
• If you plan to create a Veeam Agent backup job for computers with nosnap Veeam Agent installed,
consider the limitations and system requirements listed in section System Requirements for Linux
Computers (nosnap Veeam Agent).
• You cannot add a Veeam Agent computer protected by a Veeam Agent backup policy to a backup job
managed by the backup server. To add such a computer to a backup job managed by the backup server,
first remove the computer from the Veeam Agent backup policy.
300 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup job managed by the backup server for protected computers that run a
Linux OS in one of the following ways:
• Create a new backup job — in this case, Veeam Backup & Replication will launch the New Ag ent Backup
Job wizard. You will be able to specify protection groups and Veeam Agent computers to which the
backup job settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup job — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup job. You will also be
able to change the list of Veeam Agent computers to which the backup job settings must apply at the
Computers step of the wizard.
• Add individual computers to a new backup job — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected computers to the backup job. You will also be able to
change the list of Veeam Agent computers to which the backup job settings must apply at the Computers
step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > Linux computer on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > Linux computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup job and select Ad d to backup job > Linux > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup job and click Ad d to Backup > Linux > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
job. You can add other protection groups and individual computers to the job later on, when you pass through
the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup job. In the working area, select one or more computers that you want to
add to the job, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup job. In the working area, select one or more computers that you want to
add to the job and click Ad d to Backup > New job on the ribbon.
301 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
job. You can add other computers and protection groups to the job later on, when you pass through the wizard
steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup job that is already
configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup Job and
Adding Protection Group to Backup Job.
302 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, specify protection settings for the Veeam Agent backup job managed by
the backup server:
1. Select the type of protected computers whose data you want to back up with Veeam Agents .
NOTE
You cannot select the W ork station option if you want to create a Veeam Agent backup job managed by
backup server.
303 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 3. Specify Job Name and Description
At the Na me step of the wizard, specify a name and description for the Veeam Agent backup job managed by
the backup server.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the job, date and time when the job was created.
3. Select the Hig h priority check box if you want the resource scheduler of Veeam Backup & Replication to
prioritize this job higher than other similar jobs and to allocate resources to it in the first place. To learn
more, see the Job Priorities section in the Veeam Backup & Replication User Guide.
304 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers that you want to back
up with the Veeam Agent backup job managed by the backup server.
You can add to the backup job one or more protection groups and individual computers from the Veeam Backup
& Replication inventory. You can also add to the job computers that are not added to inventory yet. Veeam
Backup & Replication will add such computers to the job and also add them to the Ma nually Added protection
group.
If Veeam Backup & Replication discovers a new computer in a protection group after the Veeam Agent backup
job is created, Veeam Backup & Replication will automatically update the job settings to include the added
computer.
NOTE
• Veeam Backup & Replication displays protection groups for pre-installed Veeam Agents and their
members only if you selected the Ma naged by Agent option at the Job Mode step of the wizard. You
cannot add protection groups for pre-installed Veeam Agents to backup jobs managed by backup
server. To learn more, see Selecting Job Mode.
• If you used the Ad d to backup job > Linux > New job option to launch the New Agent Backup Job
wizard, the P rotected computers list will already contain computers that you have selected to add
to the job. You can remove some computers from the job or add new computers to the job, if
necessary.
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] or [Shift] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
305 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. Click the Sta rt search button on the right or press [Enter].
2. In the Ad d Computer window, in the Host name or IP address field, enter a full DNS name or IP address of
the computer that you want to add to the job.
o Connect using admin credentials. In this case, from the Credentials list, select a user account that has
administrative permissions on the computer that you want to add to the protection group. Veeam
Backup & Replication will use this account to connect to the protected computer and perf orm the
necessary operations on the computer: upload and install Veeam Agent, and so on.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials.
Veeam Backup & Replication allows to add the following types of credentials:
▪ Stored credentials. Select stored credentials if you want Veeam Backup & Replication to use the
specified user name and password for each connection to Veeam Agent.
306 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
▪ Sing le-use credentials. Select single-use credentials if you do not want Veeam Backup &
Replication to store credentials in the configuration database. With this option selected, Veeam
Backup & Replication will use the specified user name and password only for the first connection
to Veeam Agent. After that, Veeam Backup & Replication will use Veeam Transport Service to
communicate with the Veeam Agent computer.
Keep in mind that the username must be specified in the down-level logon name format. For example,
DOMAIN\UserName or HOSTNAME\UserName. Use the full domain or hostname name. Do not replace
them with a dot.
For more information, see the Credentials Manager section in the Veeam Backup & Replication User
Guide.
o Select this option, if you chose to pre-install Veeam Deployer Service on the Linux computer that you
want to add to the backup job. In this case, Veeam Backup & Replication will communicate with the
Linux computer using a certificate. To learn more, see Deploying Veeam Agent for Linux Using Pre-
Installed Veeam Deployer Service
307 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup.
1. In the Ba ckup mode section, select the backup mode. You can select one of the following options:
o E ntire computer — select this option if you want to create a backup of the entire computer image.
When you restore data from such backup, you will be able to recover the entire computer image as
well as data on specific computer volumes: files, directories, application data and so on. With this
option selected, you will pass to the Storage step of the wizard.
o Volume level backup — select this option if you want to create a backup of specific computer volumes,
for example, the system volume. When you restore data from such backup, you will be able to recover
data located on these volumes only: files, directories, application data and so on. With this option
selected, you will pass to the Objects step of the wizard.
o File level backup — select this option if you want to create a backup of individual directories on your
computer. With this option selected, you will pass to the Objects step of the wizard.
2. [For file-level backup] If you want to perform backup in the snapshot-less mode, select the Ba ckup
d irectly from live file system check box. With this option selected, Veeam Agent for Linux will not create a
snapshot of a backed-up volume during backup. This allows Veeam Agent to back up data residing in file
systems that are not supported for snapshot-based backup with Veeam Agent for Linux. To learn more,
see the Snapshot-Less File-Level Backup section in the Veeam Agent for Linux User Guide.
308 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
File-level backup is typically slower than volume-level backup. Depending on the performance capabilities
of your computer and backup environment, the difference between file-level and volume-level backup job
performance may increase significantly. If you plan to back up all folders with files on a specific volume or
back up large amount of data, it is recommended that you configure volume-level backup instead of file-
level backup.
309 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you chose to create volume-level or file-level Veeam Agent
backups. Specify backup scope for the Veeam Agent backup job managed by the backup server:
• Specify volumes to back up — if you have selected the Volume level backup option at the Backup Mode
step of the wizard.
• Specify directories to back up — if you have selected the File level backup option at the Backup Mode step
of the wizard.
At this step of the wizard, you must specify the backup scope — define what volumes you want to include in the
backup. The specified backup scope settings will apply to all computers that are added to the backup job. If a
specified volume does not exist on one or more computers in the job, the job will skip such volumes on those
computers and back up only existing ones.
1. In the Ob jects to backup field, click Ad d and select the type of object that you want to include in the
backup: Device, Mount point, LVM or BTRFS.
2. In the Ad d Object window, specify the object that you want to back up and click OK.
o Block devices . You can include in the backup scope all volumes on a computer disk or individual
volumes of a protected computer:
▪ To include all volumes on a computer disk in the backup, type the path to a block device that
represents the disk whose volumes you want to back up. For example: /dev/ sda .
▪ To include a specific volume of a protected computer in the backup, type the path to a block
device that represents the volume that you want to back up. For example: /dev/sda1.
NOTE
If you include a block device in the backup, and this block device is a physical volume assigned
to an LVM volume group, Veeam Agent will include the whole LVM volume group in the
backup.
o Mount points . You can include in the backup scope individual volumes of a protected computer. Type
the path to a mount point of the volume that you want to back up. For example: / or /home.
IMP ORTANT
Veeam Agent does not support backup of bind mount points. You must specify the path to the
original mount point instead.
o LVM volumes . You can include in the backup scope entire LVM volume groups or individual LVM
logical volumes of a protected computer. Type the path to a mount point or a block device that
represents the volume group or logical volume that you want to back up. For example: /dev/vg or
/dev/vg/lv1.
310 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
o Btrfs subvolumes . You can include in the backup scope all Btrfs subvolumes of a Btrfs storage pool or
specific Btrfs subvolumes.
▪ To include all subvolumes of a Btrfs pool in the backup, type the path to a block device that
represents the Btrfs pool. For example: /dev/sda1.
▪ To include a specific Btrfs subvolume in the backup, type the path to a mount point of this
subvolume. For example: /sub1.
3. Repeat steps 1–2 for all objects that you want to back up.
If you have created several system partitions, for example, a separate partition for the /boot directory, make
sure that you include all of these partitions in the backup. Otherwise, Veeam Agent for Linux does not guarantee
that the OS will boot properly when you attempt to recover from such backup.
At this step of the wizard, you must specify the backup scope by defining what directories with files you want to
include in the backup. The specified backup scope settings will apply to all computers that are added to the
backup job. If a specified directory does not exist on one or more computers in the job, the job will skip such
folder on those computers and back up existing ones.
2. In the Ad d Object window, type the path to a directory that you want to back up, for example,
/home/user01, and click OK.
311 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
IMP ORTANT
Veeam Agent does not support backup of bind mount points. You must sp ecify the path to the
original mount point instead.
3. Repeat steps 1–2 for all directories that you want to back up.
TIP
If you want to back up the root directory and specify ‘/’ in the P a th to a directory field, Veeam Agent will
not automatically include into the backup scope the network file system mount points — for example, NFS
or SMB network shared folders. To include such mount points, you need to specify paths to these mount
points manually.
For example, you have a network file system mounted to the /home/media directory. If you add ‘/’ as an
object to the backup scope, Veeam Agent will not back up the mounted file system. To back up the root
directory and the mounted network file system, add the following objects to the backup scope:
• /
• /home/media
Configuring Filters
To include or exclude files of a specific type in/from the file-level backup, you can configure filters.
312 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To configure a filter:
o In the Include masks field, specify file names and masks for file types that you want to back up, for
example, Report.pdf or *filename*. Veeam Agent for Linux will create a backup only for selected files.
Other files will not be backed up.
o In the E x clude masks field, specify file names and masks for file types that you do not want to back
up, for example, OldReports.tar.gz or *.odt. Veeam Agent for Linux will back up all files except files
of the specified type.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
Veeam Agent for Linux will include in the backup all files of the PDF format that do not contain draft in their
names.
313 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Specify Backup Storage Settings
At the Storage step of the wizard, specify settings for the target backup repository managed by the same
backup server that manages the Veeam Agent backup job:
1. From the Ba ckup repository list, select a backup repository where you want to store Veeam Agent
backups. You can select from the following types of backup repositories:
o Veeam backup repository configured on the backup server that will manage the created backup job.
o Cloud repository allocated to your tenant account by a Veeam Cloud Connect service provider.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
2. You can map the job to a specific backup stored on the backup repository. Backup job mapping can be
helpful if you have moved backup files to a new backup repository and want to point the job to existing
backups on this new backup repository. You can also use backup job mapping if the configuration database
got corrupted and you need to reconfigure backup jobs.
To map the job to a backup, click the Ma p backup link and select the backup on the backup repository.
Backups can be easily identified by job names. To find the backup, you can also use the search field at the
bottom of the window.
NOTE
You cannot map a Veeam Agent backup job configured in Veeam Backup & Replication to a backup
chain that was created on a backup repository by Veeam Agent operating in the standalone mode.
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is exceeded, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
days. After this period is over, Veeam Backup & Replication will remove the earliest restore points
from the backup chain.
4. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
5. If you want to archive backup files created with the backup job to a secondary destination (backup
repository or tape), select the Configure secondary backup destinations for this job check box. With this
option enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At
the Secondary Target step of the wizard, you can link the backup job to the job or backup to tape backup
job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
314 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
6. Click Ad vanced to specify advanced settings for the backup job. To learn more, see Specify Advanced
Backup Settings.
315 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup job managed by the
backup server:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
• Script settings
TIP
After you specify necessary settings for the Veeam Agent backup job, you can save them as default
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup job, Veeam Backup & Replication will automatically apply the default
settings to the new job.
Backup Settings
To specify settings for a backup chain created with the Veeam Agent backup job managed by the backup server:
2. If you want to periodically create synthetic full backups, on the Ba ckup tab, select the Create synthetic
full backups p eriodically check box and click Da ys to schedule synthetic full backups on the necessary
week days.
NOTE
Synthetic full backup is not available for backup jobs targeted at an object storage repository.
3. If you want to periodically create active full backups, select the Create active full backups periodically
check box and click Configure to define scheduling settings.
316 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• Before scheduling periodic full backups, you must make sure that you have enough free space on
the target location.
• If you schedule the active full backup and synthetic full backup on the same day, Veeam Backup &
Replication will perform only active full backup. Synthetic full backup will be skipped.
Maintenance Settings
You can specify maintenance settings for a backup chain created with the Veeam Agent backup job managed by
the backup server. Maintenance operations help make sure that the backup chain remains valid and consistent.
317 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. To periodically perform a health check for the latest restore point in the backup chain, in the Storage-level
corruption guard section select the P erform backup files health check check box and click Configure to
specify the time schedule for the health check.
An automatic health check can help you avoid a situation where a restore point gets corrupted, making all
dependent restore points corrupted, too. If during the health check Veeam Backup & Replication det ects
corrupted data blocks in the latest restore point in the backup chain (or the restore point before the latest
one if the latest restore point is incomplete), it will start the health check retry and transport valid data
blocks from the protected computer to the Veeam backup repository. The transported data blocks are
stored to a new backup file or the latest backup file in the backup chain, depending on the data corruption
scenario. For more information, see the Health Check for Backup Files section in the Veeam Backup &
Replication User Guide.
NOTE
The Defragment and compact full backup file option is not available for backup jobs targeted at
object storage. For object storage, Veeam Agent offers a special health check mechanism as default.
To run the health check for object storage, enable the P erform backup files health check option in
the Storage-level corruption guard section and specify the health check schedule.
You can also switch from the health check for object storage to the standard health check. To do so,
select the Verify content of each object in backup check box in the backup job settings. Keep in mind
that enabling this setting may result in additional charges from your object storage provider.
For more information, see the Health Check for Object Storage section in the Veeam Agent for Linux
User Guide.
4. Select the Remove deleted items data after check box and specify the number of days for which you want
to keep the backup created with the backup job in the target location.
For Veeam Agent backup jobs managed by the backup server, deleted items retention policy is similar to
retention policy for deleted VMs. After you remove a protection group or individual computer from a
Veeam Agent backup job, Veeam Backup & Replication will keep its data on the backup repository for the
period that you have specified. When this period is over, backup data of this computer will be removed
from the backup repository. For more information, see the Retention Policy for Deleted Items section in
the Veeam Backup & Replication User Guide.
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. In the opposite case, the backup job may work not as expected
and remove data that you still require.
5. To periodically compact a full backup, select the Defragment and compact full backup file check box and
click Configure to specify the schedule for the compact operation.
NOTE
The Defragment and compact full backup file option is not available for backup jobs targeted at
object storage.
During the compact operation, Veeam Backup & Replication creates a new empty file and copies to it data
blocks from the full backup file. As a result, the full backup file gets defragmented and the speed of
reading and writing from/to the backup file increases.
If the full backup file contains data blocks for deleted items (protection groups or individual computers),
Veeam Backup & Replication removes these data blocks. For more information, see the Compact of Full
Backup File section in the Veeam Backup & Replication User Guide.
318 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you want to periodically compact a full backup, you must make sure that you have enough
free space in the target location. For the compact operation, the amount of free space must
be equal to or more that the size of the full backup file.
• In contrast to the compact operation for a VM backup, during compact of a full Veeam Agent
backup file, Veeam Backup & Replication does not perform the data take out operation. If the
full backup file contains data for a machine that has only one restore point and this restore
point is older than 7 days, Veeam Backup & Replication will not extract data for this machine
to a separate full backup file.
Storage Settings
To specify storage settings for the Veeam Agent backup job managed by the backup server:
3. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme. To learn more about the compression levels, see the Data Compression section
in the Veeam Agent for Microsoft Windows User Guide.
4. In the Storage optimization section, select what type of backup target you plan to use. Depending on the
chosen storage type, Veeam Agent for Linux will use data blocks of different size to optimize the size of
backup files and job performance: 4 MB, 1 MB, 512 KB or 256 KB.
319 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
If you change the storage optimization settings for the backup job, new settings will not have any
effect on previously created files in the chain. They will be applied to new files created after the
settings were changed.
To apply new storage optimization settings in backup jobs, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Replication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
5. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will display a
warning about it: Loss protection disabled . For more information, see the Decrypting Data Without
Password section in the Veeam Backup & Replication User Guide.
You can select a Key Management System (KMS) server in the Password field. The KMS server must be
added to Veeam Backup & Replication in advance. If you choose to use KMS keys for backup file
encryption at this step of the wizard, Veeam Backup & Replication immediately starts communication with
the KMS server to retrieve the encryption keys. To learn more, see the Key Management System Keys
section in the Veeam Backup & Replication User Guide.
320 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• You must encrypt the backup job if you want to back up data to the Veeam Data Vault
storage.
• If you enable encryption for an existing Veeam Agent backup, during the next job session Veeam Agent for
Linux will create a full backup file. The created full backup file and subsequent incremental backup files in
the backup chain will be encrypted with the specified password.
• Encryption is not retroactive. If you enable encryption for an existing backup job, Veeam Agent for Linux
will encrypt the backup chain starting from the next restore point created with this job.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in the
Veeam Backup & Replication User Guide.
Notification Settings
To specify notification settings for the Veeam Agent backup job managed by the backup server:
321 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. Click the Notifications tab.
3. Select the Send SNMP notifications for this job check box if you want to receive SNMP traps when the job
completes successfully.
SNMP traps will be sent if you specify global SNMP settings in Veeam Backup & Replication and configure
software on recipient's machine to receive SNMP traps. For more information, see the Specifying SNMP
Settings section in the Veeam Backup & Replication User Guide.
4. Select the Send email notifications to the following recipients check box if you want to receive
notifications about the job completion status by email. In the field below, specify a recipient’s email
address. You can enter several addresses separated by a semicolon.
Email notifications will be sent if you configure global email notification settings in Veeam Backup &
Replication. For more information, see the Configuring Global Email Notification Settings section in Veeam
Backup & Replication User Guide.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the job, select Use global notification settings. In this case, Veeam
Backup & Replication will apply to the job global email notification settings specified for the b ackup
server.
o To configure a custom notification for the job, select Use custom notification settings specified
b elow. You can specify the following notification settings:
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the job) and %Issues% (number of machines in the job that have been processed
with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the job completes successfully, completes with a warning or fails.
322 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
▪ Select the Sup press notifications until the last retry check box to receive a notification about the
final job status. If you do not enable this option, Veeam Backup & Replication will send one
notification per every job retry.
Script Settings
You can specify what scripts Veeam Backup & Replication will execute on the backup server before and afte r the
session of the Veeam Agent backup job managed by the backup server.
3. If you want to execute custom scripts before and after the backup job, select the Before the job and After
the job check boxes and click Browse to choose executable files from a local folder on the backup server.
The scripts are executed on the backup server under the account under which the Veeam Backup Service
runs (the local System account or account that has the local Administrator permissions on the backup
server).
You can select to execute pre- and post-backup actions after a number of backup sessions or on specific
week days.
o If you select the Run scripts every <N> backup session option, specify the number of the backup job
sessions after which the scripts must be executed.
o If you select the Run scripts on the selected days only option, click Da y s and specify week days on
which the scripts must be executed.
323 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
TIP
• Custom scripts that you define in the advanced job settings relate to the backup job itself, not the
OS quiescence process on protected computers. To add pre-freeze and post-thaw scripts for Veeam
Agent computer OS quiescence, use the Guest Processing step of the wizard.
• You can also specify what scripts will be executed on a Veeam Agent computer before and after the
backup job session. To learn more, see Backup Job and Snapshot Scripts.
324 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 9. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the Veeam Agent backup job managed by the backup
server to a backup to tape or backup copy job. As a result, the backup job will be added as a source to the
backup to tape or backup copy job. Backup files created with the backup job will be archived to tape or c opied to
the secondary backup repository according to the secondary jobs schedule. For more information, see the
Linking Backup Jobs to Backup Copy Jobs and Linking Backup Jobs to Backup to Tape Jobs sections in the
Veeam Backup & Replication User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup job to these jobs, Veeam Backup & Replication will
automatically update the linked jobs to define the Veeam Agent backup job as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup job. You can link several jobs to the backup job — for example, one backup to tape job and one
backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
325 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 10. Specify Guest Processing Settings
At the Guest Processing step of the wizard, you can enable the following guest OS processing settings for a
Veeam Agent backup job that includes Linux-based computers:
• Application-aware processing
• File indexing
2. Click Ap p lications.
3. In the Ap p lication-Aware Processing Options window, select a protection group or individual computer
and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the Guest OS credentials list, select a user account that Veeam Agent will use for the processing of
applications on the protected computer.
By default, the Use protection group credentials option is selected in the list. With this option selected,
Veeam Agent will do one of the following:
o If you specified stored credentials for this computer in the protection group settings, Veeam Agent
will process applications using the specified account.
o If you specified single-use credentials for this computer in the protection group settings, Veeam
Agent will use the root user.
To learn more about stored and single-use credentials, see Specifying Computers.
If you want to use account that is not available in the Guest OS credentials list, click the Ma nage accounts
link or click Ad d on the right to add credentials.
5. To specify credentials for a particular computer or a protection group, click Credentials on the right to set
up credentials. In the Guest OS Credentials window, select a protection group or individual computer and
click Set User.
If you specify custom credentials for a particular computer or a protection group in the Guest OS
Credentials window, Veeam Agent will use these custom credentials instead of the credentials specified in
the Guest OS credentials list (see Step 4).
Keep in mind that to specify credentials for a particular computer, you must include this computer to the
backup job as a standalone object at the Comp uters step of the wizard. To do this, click Ad d and choose
the computer whose credentials you want to add. Then select the computer in the list and specify the
necessary credentials.
326 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
Veeam Agent uses credentials selected in the Guest OS credentials list for Veeam Transport Service
and database systems processing.
For file system indexing, MySQL processing and scripts execution, Veeam Agent always uses the
root account.
6. Configure the necessary settings for the selected protection group or individ ual computer:
o General Settings
3. In the displayed list, select the protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
327 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
4. Configure file indexing settings for the selected protection group or individual computer. To learn more,
see File Indexing.
Application-Aware Processing
If a computer protected with Veeam Agent for Linux runs an Oracle, MySQL or PostgreSQL database system, you
can enable application-aware processing to create a transactionally consistent backup. The transactionally
consistent backup guarantees proper recovery of databases without data loss.
2. In the Ap p lication-Aware Processing Options window, a necessary protection group or individual computer
is added to the list.
2. In the Ap p lication-Aware Processing Options window, select the necessary object and click E d it.
328 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. On the General tab, in the Ap p lications section, specify the behavior scenario for application-aware
processing:
o Select Require successful processing if you want Veeam Agent for Linux to process database systems.
With this option selected, if an error occurs when processing a database or database instance, Veeam
Agent for Linux will stop the backup process.
If you select this option, you will need to specify database processing settings. For more information,
see Oracle Processing Settings, MySQL Processing Settings and PostgreSQL Processing Settings.
o Select Try application processing, but ignore failures if you want Veeam Agent for Linux to process
database systems. With this option selected, if an error occurs when processing a database or
database instance, Veeam Agent for Linux will not stop the backup process . Instead, Veeam Agent for
Linux will skip this database or database instance and proceed to the next one. Information about the
skipped database or database instance will be displayed in a warning message in the job session
statistics. After the backup process is completed, you will be able to restore data from the backup and
restore databases or database instances that were successfully processed during backup.
If you select this option, you will need to specify database processing settings. For more information,
see Oracle Processing Settings, MySQL Processing Settings and PostgreSQL Processing Settings.
o Select Disable application processing if you do not want Veeam Agent for Linux to process database
systems. If you select this option, the Ora cle, MySQL and P ostgreSQL tabs of the P rocessing Settings
window will become unavailable. You still will be able to specify script settings for the job on the
Scripts tab of the window.
329 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Before You Begin
Before you start working with the Oracle database system, check the following:
1. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
2. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
3. At the Guest Processing step of the wizard, in the Guest OS credentials list, a necessary user account is
selected.
4. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it, then click the
Ora cle tab.
3. On the Ora cle tab, specify a user account that Veeam Agent for Linux will use to connect to the Oracle
database. You can do one of the following:
o Select from the Sp ecify Oracle account with SYSDBA privileges list a database user account that has
SYSDBA rights on the Oracle database.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials. With this option selected, Veeam Agent for Linux will connect to the Oracle
database under the account that you have selected in the Sp ecify Oracle account with SYSDBA
p rivileges list.
With this option selected, Veeam Agent for Linux will do the following:
i. Veeam Agent will check if you specified custom credentials for the computer or protection
group in the Guest OS Credentials window at the Guest Processing step of the wizard.
If you specified custom credentials for the computer or protection group in the Guest OS
Credentials window, Veeam Agent will process the Oracle database under the OS account that
you have specified in this window.
If you have not specified custom credentials for the computer or protection group, Veeam Agent
will do as described in the step ii of this procedure.
ii. Veeam Agent will check what have you selected in the Guest OS credentials list at the Guest
P rocessing step of the wizard.
If you specified credentials in the Guest OS credentials list, Veeam Agent will process the Oracle
database under the account that you have specified in this list.
330 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
If you have not specified credentials in the list and selected the Use protection group credentials
option instead, Veeam Agent will do as described in the step iii of this procedure.
iii. Veeam Agent will check what credentials have you specified for the computer or protection
group at the Comp uters step of the wizard.
If you specified stored credentials for this computer in the protection group settings, Veeam
Agent will process the Oracle database using the specified account.
If you specified single-use credentials for this computer in the protection group settings, Veeam
Agent will process the Oracle database using the root user.
4. In the Archived logs section, specify if Veeam Agent for Linux must delete archived logs on the Oracle
database:
o Select Do not d elete archived logs if you want Veeam Agent for Linux to preserve archived logs. When
the backup job completes, Veeam Agent for Linux will not delete archived logs.
It is recommended that you select this option for databases for which the ARCHIVELOG mode is
turned off. If the ARCHIVELOG mode is turned on, archived logs may grow large and consume all disk
space. In this case, the database administrator must take care of archived logs themselves.
o Select Delete logs older than < N> hours or Delete logs over <N> GB if you want Veeam Agent for
Linux to delete archived logs that are older than <N> hours or larger than <N> GB. Veeam Agent for
Linux will wait for the backup job to complete successfully and then trigger archived logs truncation
through Oracle Call Interface (OCI). If the backup job fails, the logs will remain untouched until the
next successful backup job session.
TIP
If you configure backup job to back up archived logs, Veeam Agent for Linux will not trigge r
archived logs deletion after each log backup job session. To prevent Oracle database logs from
overgrowing, run the backup job for the Veeam Agent computer more often.
5. To back up Oracle archived logs with Veeam Agent for Linux, select the Ba ckup log every < N> minutes
check box and specify the frequency for archived logs backup. By default, archived logs are backed up
every 15 minutes. The minimum log backup interval is 5 minutes. The maximum log backup interval is 480
minutes.
6. In the Retain log backups section, specify retention policy for archived logs stored in the backup location:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
Veeam Agent backups and archived log backups.
331 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
o Select Keep only last <N> days to keep archived logs for a specific number of days. By default,
archived logs are kept for 15 days. If you select this option, you must make sure that retention for
archived logs is not greater than retention for the Veeam Agent backups. The maximum time period
to keep archived logs is 60 days.
1. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
2. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
3. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
332 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To learn more, see Application-Aware Processing.
4. MySQL tables with the MyISAM storage engine must be locked to keep them in a consistent state while
Veeam Agent is creating the system snapshot. To correctly process such tables, make sure tha t the user
account you want to specify in the MySQL processing settings has the following instance -wide privileges:
o SELECT. This privilege enables Veeam Agent to access tables' metadata and select for a lock the
tables that use the MyISAM storage engine. Without this privilege, the processing of the MySQL
database system will run successfully but MyISAM tables will not be locked, which may result in an
inconsistent state of the backed up data.
o LOCK TABLES. This privilege is required for locking the selected MyISAM tables. If some MyISAM
tables are selected but the MySQL account does not have the LOCK TABLES privilege, the processing
of the MySQL database system will fail.
o RELOAD or FLUSH_TABLES. If some MyISAM tables are selected but the MySQL account does not
have either RELOAD or FLUSH_TABLES privilege, the processing of the MySQL database system will
fail.
To obtain information about the privileges that are assigned to an account, use MySQL functionality, for
example, the SHOW GRANTS statement. To learn more, see MySQL documentation.
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it and switch to
the My SQL tab.
3. On the My SQL tab, specify a user account that Veeam Agent for Linux will use to connect to the MySQL
database, from the Sp ecify MySQL account with superuser privileges list, select a user account.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
By default, the User from password file option is selected in the list. With this option selected, Veeam
Agent for Linux will connect to the MySQL database under the account specified in the password file on
the Veeam Agent computer. The default location for the password file is /root/.my.cnf. For
information about the password file format, see the Preparing Password File for MySQL Processing section
in the Veeam Agent for Linux User Guide.
4. If you want to specify a custom path to the password file, specify a full path in the P a ssword file path
field. Specifying relative paths is not supported.
333 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
For information on how Veeam Agent for Linux processes the MySQL database system, see the MySQL Backup
section in the Veeam Agent for Linux User Guide.
a. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
b. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
c. At the Guest Processing step of the wizard, in the Guest OS credentials list, a necessary user account
is selected.
d. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
• Consider the Requirements and Limitations section in the Veeam Backup & Replication User Guide.
334 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Configuring PostgreSQL Processing
NOTE
To explicitly include or exclude specific configuration files from rescan, you can add the following
commands to the VeeamPostgreSQLAgent.xml file:
To specify how Veeam Agent for Linux must process the PostgreSQL database system, perform the following:
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it, then click the
P ostgreSQL tab.
3. On the P ostgreSQL tab, specify a user account that Veeam Agent for Linux will use to connect to the
PostgreSQL database. You can do one of the following:
o Select from the Sp ecify PostgreSQL account with superuser privileges list a user account that has the
required rights for the database.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials. With this option selected, Veeam Agent for Linux will connect to the PostgreSQL
database under the account that you have selected in the Sp ecify PostgreSQL account with superuser
p rivileges list.
Keep in mind that if you plan to select the peer authentication method at the step 4 of this procedure,
you can add a user account in the Credentials Manager without specifying the password for the
account.
With this option selected, Veeam Agent for Linux will do the following:
i. Veeam Agent will check if you have specified custom credentials for the computer or protection
group in the Guest OS Credentials window at the Guest Processing step of the wizard.
If you specify custom credentials for the computer or protection group in the Guest OS
Credentials window, Veeam Agent will process the PostgreSQL database under the account that
you have specified in this window.
If you do not specify custom credentials for the computer or protection group, Veeam Agent will
do as described in the step ii of this procedure.
335 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
ii. Veeam Agent will check what you have selected in the Guest OS credentials list at the Guest
P rocessing step of the wizard.
If you specify credentials in the Guest OS credentials list, Veeam Agent will process the
PostgreSQL database under the account that you specify in this list.
If you do not specify credentials in the list and select the Use p rotection g roup credentials
option instead, Veeam Agent will do as described in the step iii of this procedure.
iii. Veeam Agent will check what credentials you have specified for the computer or pr otection
group at the Comp uters step of the wizard.
If you specify stored credentials for this computer in the protection group settings, Veeam
Agent will process the PostgreSQL database using the specified account.
If you specify single-use credentials for this computer in the protection group settings, Veeam
Agent will process the PostgreSQL database using the root user.
4. In the The specified user is field, specify how Veeam Agent will connect to the PostgreSQL database.
The The specified user is field is connected closely with the Sp ecify PostgreSQL account with superuser
p rivileges list. Veeam Agent will do the following depending on what you specified using these two
controls.
336 | V eeam Backup & Replication | V eeam A gent Management Guide | 12.2.0.334
Control Veeam Agent Behavior
5. To back up PostgreSQL archived logs with Veeam Agent, select the Ba ck up log every <N> minutes check
box and specify the frequency for archived logs backup. By default, archived logs are backed up every 15
minutes. The minimum log backup interval is 5 minutes. The maximum log backup interval is 480 minutes.
6. In the Retain log backups section, specify retention policy for archived logs stored in the backup location:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
Veeam Agent backups and archived log backups.
o Select Keep only last <N> days to keep archived logs for a specific number of days. By default,
archived logs are kept for 15 days. If you select this option, you must make sure that retention for
archived logs is not greater than retention for the Veeam Agent backups. The maximum time period
to keep archived logs is 60 days.
7. In the P a th to stage log backups at field, specify temporary storage location for the archive logs.
During backup, Veeam Agent saves archive logs to a temporary storage, move logs to a Veeam backup
repository and deletes logs from a temporary storage. Keep in mind the following:
o Directory set as a temporary storage location must be locally accessible by the guest OS and have
enough free space.
337 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o If temporary storage location for the archive logs is not specified or Veeam Agent cannot save logs in
the specified directory for some reason, Veeam Agent will not be able to back up logs.
For more information on how Veeam Agent for Linux processes the PostgreSQL database system, see the
PostgreSQL Backup section in the Veeam Agent for Linux User Guide.
• Backup job scripts — pre-job and post-job scripts that run on the Veeam Agent computer before and after
the backup job session.
• Snapshot scripts — pre-freeze and post-thaw scripts that run on the Veeam Agent computer before and
after the volume snapshot is created.
Veeam Backup & Replication offers 2 scenarios for specifying script settings:
You can specify both backup job scripts and snapshot scripts for the backup job if you did not select the
Ba ckup directly from live file system option at the Backup Mode step of the wizard.
338 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
You can also specify custom scripts that will be executed on the backup server before and after the backup
job session. To learn more, see Script Settings.
1. At the Guest Processing step, select the E na ble application-aware processing check box.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. [For an entire computer backup or volume-level backup job] In the P rocessing Settings window, click the
Scripts tab.
NOTE
For a file-level backup job, application-aware processing and database processing options are not
available, and no tabs are displayed in the P rocessing Settings window.
6. In the Job scripts section, specify custom scripts that you want to execute before and after the backup job
session. To do this, in the P re-job script and P ost-job script fields, click Browse and choose executable
files from a local folder on the backup server.
7. In the Sna pshot scripts section, specify custom scripts that you want to execute before Veeam Agent for
Linux creates a snapshot of the backed-up volume and after the snapshot is created. To do this, in the P re-
freeze script and P ost-thaw script fields, click Browse and choose executable files from a local folder on
the backup server.
339 | V eeam Backup & Replication | V eeam A gent Management Guide | 12.2.0.334
Veeam Agent for Linux supports scripts in the SH file format. During the backup job session, Veeam Backup &
Replication will upload the scripts to the /var/lib/veeam/scripts directory on each Veeam Agent
computer added to the backup job and execute them on these computers.
1. At the Guest Processing step, select the E na ble application-aware processing check box.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the P rocessing Settings window, select the E na ble script execution check box.
5. In the P re-job script and P ost-job script fields, click Browse to choose executable files from a local folder
on the backup server.
340 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Agent for Linux supports scripts in the SH file format. During the backup job session, Veeam Backup &
Replication will upload the scripts to the /var/lib/veeam/scripts directory on each Veeam Agent
computer added to the job and execute them on these computers.
File Indexing
You can instruct the Veeam Agent backup job managed by the backup server to create an index of files and
folders on the protected computer OS during backup. If you enable the file indexing option, you will be able to
search for individual files inside Veeam Agent backups and perform 1-click restore in Veeam Backup Enterprise
Manager. For more information on file system indexing, see the File System Indexing topic in the Veeam Agent
for Linux User Guide.
NOTE
File system indexing is optional. If you do not enable this option in the backup job settings, you will still be
able to perform 1-click restore from the backup created with such backup job. For more information, see
the Preparing for File Browsing and Restore section in the Veeam Backup Enterprise Manager User Guide.
1. At the Guest Processing step of the wizard, select the E nable guest file system indexing check box.
3. In the displayed list, select the protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must add the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
341 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. In the Ind exing Settings window, specify the indexing scope:
o Select Ind ex everything if you want to index all files within the backup scope that you have specified
at the Backup mode step of the wizard. Veeam Agent for Linux will index all files that reside:
▪ On the volumes that you have specified for backup (for volume-level backup)
▪ In the directories that you have specified for backup (for file-level backup)
o [For volume-level backup only] Select Ind ex everything except if you want to index all files on your
computer OS except those defined in the list. By default, system directories /cdrom, /dev, /media,
/mnt, /proc, /tmp and /lost+found are excluded from indexing. You can add or delete folders
using the Ad d and Remove buttons on the right.
o [For volume-level backup only] Select Ind ex only following folders to define directories that you
want to index. You can add or delete directories to index using the Ad d and Remove buttons on the
right.
NOTE
You can specify a custom indexing scope only in for a volume-level backup job. For a file-level backup job
that processes Linux-based computers, only the Ind ex everything option is available.
342 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 11. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup job manually to create backup.
o To run the job at specific time daily, on defined week days or with specific periodicity, select Da ily at
this time. Use the fields on the right to configure the necessary schedule.
o To run the job once a month on specific days, select Monthly at this time. Use the fields on the right
to configure the necessary schedule.
o To run the job repeatedly throughout a day with a specific time interval, select P eriodically every. In
the field on the right do one of the following:
▪ Click Schedule and use the time table. In the Sta rt time within an hour field, specify the exact
time when the job must start.
▪ The defined interval always starts at 12:00 AM. For example, if you configure to run a job with a
4-hour interval, the job will start at 12:00 AM, 4:00 AM, 8:00 AM, 12:00 PM, 4:00 PM and so
on.
▪ If you define permitted hours for the job, after the denied interval is over, the job will start
immediately and then run by the defined schedule.
For example, you have configured a job to run with a 2-hour interval and defined permitted hours
from 9:00 AM to 5:00 PM. According to the rules above, the job will first run at 9:00 AM, when the
denied period is over. After that, the job will run at 10:00 AM, 12:00 PM, 2:00 PM and 4:00 PM.
o To run the job continuously, select the P eriodically every option and choose Continuously from the
list on the right. A new backup job session will start as soon as the previous backup job session
finishes.
o To chain jobs, use the After this job field. In the common practice, jobs start one after another: when
job A finishes, job B starts and so on. If you want to create a chain of jobs, you must define the time
schedule for the first job in the chain. For the rest of the jobs in the chain, select the After this job
option and choose the preceding job from the list.
NOTE
The After this job function will automatically start a job if the first job in the chain is started
automatically by schedule. If you start the first job manually, Veeam Backup & Replication will
display a notification. You will be able to choose whether Veeam Backup & Repl ication must
start the chained job as well.
3. In the Automatic retry section, define whether Veeam Backup & Replication or Veeam Agent for Linux
(depending on the selected job mode) must attempt to run the backup job again if the job fails for some
reason. Enter the number of attempts to run the job and define time intervals between them. If you select
continuous backup, Veeam Backup & Replication or Veeam Agent for Linux will retry the job for the
defined number of times without any time intervals between the job runs.
343 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
4. [For backup job managed by backup server] In the Ba ckup window section, define the time interval within
which the backup job must complete. The backup window prevents the job from overlapping with
production hours and ensures that the job does not impact performance of your server. To set up a backup
window for the job:
a. Select the Terminate job if it exceeds allowed backup window check box and click W ind ow.
b. In the Time P eriods window, define the allowed hours and prohibited hours for backup. If the job
exceeds the allowed window, it will be automatically terminated.
344 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 12. Review Backup Job Settings
At the Summary step of the wizard, complete the Veeam Agent backup job configuration process.
2. Select the Run the job when I click Finish check box if you want to start the job right after you finish
working with the wizard.
345 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Veeam Agent Backup Policies
To create a Veeam Agent backup policy, you must create a backup job with the Ma naged by agent option
selected in the job settings. In contrast to a Veeam Agent backup job managed by the backup server that is
similar to a regular backup job for VM backup, a backup policy acts as a template that describes settings of
individual Veeam Agent backup jobs running on protected computers.
Veeam Backup & Replication lets you create backup policies for the following types of protected computers:
• Microsoft Windows computers protected with Veeam Agent for Microsoft Windows
• After you create a Veeam Agent backup policy, Veeam Backup & Replication connects to protected
computers added to the backup policy and applies settings specified in the policy to configure the Veeam
Agent backup job on each computer.
• You must create a Veeam Agent backup policy if you want to protect computers with pre -installed Veeam
Agents. To learn more, see Protection Group Types.
• Veeam Backup & Replication does not connect to the protected computers added to the protection group
for pre-installed Veeam Agents. In case of this protection group, computers connect to the Veeam backup
server and become members of the protection group after Veeam Agent deployment. To learn more, see
Protection Group Types.
• You cannot create a Veeam Agent backup policy if you want to protect cloud machines. In this case, you
must create a Veeam Agent backup job managed by the backup server. To learn more, see Creating Veeam
Agent Backup Jobs
346 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Policy for Windows Computers
To back up data of a computer protected with Veeam Agent for Microsoft Windows, you can configure a Veeam
Agent backup policy in Veeam Backup & Replication.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers and
workstations that you plan to add to the Veeam Agent backup policy. To learn more, see Licensing
Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the policy must be configured in advance.
• [For backup policies targeted at the cloud repository] The Veeam Cloud Connect service provider must be
added in the Veeam backup console.
• Veeam Agent for Microsoft Windows does not back up data to which symbolic links are targeted. It only
backs up the path information that the symbolic links contain. After restore, identical symbolic links are
created in the restore destination.
• You cannot map a Veeam Agent backup policy to a Veeam Agent backup chain created by another type of
a Veeam Agent backup job. After you change the mode of a Veeam Agent computer, Veeam Backup &
Replication starts a new backup chain in a target location specified in the backup policy settings.
• Veeam Agent does not support creating transaction log backups in a cloud repository. You cannot enable
transaction log backup options in the properties of the backup policy targeted at a cloud repository.
• You cannot add a Veeam Agent computer protected by a backup job managed by the backup server to a
Veeam Agent backup policy. To add such a computer to a Veeam Agent backup policy, first remove the
computer from the backup job managed by the backup server.
347 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup policy for protected computers that run a Microsoft Windows OS in one of
the following ways:
• Create a new backup policy — in this case, Veeam Backup & Replication will launch the New Agent Backup
Job wizard. You will be able to specify protection groups, individual Active Directory objects and Veeam
Agent computers to which the backup policy settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup policy — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup policy. You will also
be able to change the list of Veeam Agent computers to which the backup policy settings must apply at
the Computers step of the wizard.
• Add individual computers to a new backup policy — in this case, Veeam Backup & Replication will launch
the New Ag ent Backup Job wizard and add the selected computers to the backup policy. You will also be
able to change the list of Veeam Agent computers to which the backup policy settings must apply at the
Computers step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > W indows computer on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > W indows computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup policy and select Ad d to backup job > W indows > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup policy and click Ad d to Backup > W indows > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
policy. You can add other protection groups and individual computers to the p olicy later on, when you pass
through the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy and click Ad d to Backup > New job on the ribbon.
348 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
policy. You can add other computers and protection groups to the policy later on, when you pass through the
wizard steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup policy that is
already configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup
Job and Adding Protection Group to Backup Job.
349 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, specify the type of protected computers and select the Ma naged by agent
job mode:
1. Select the type of protected computers whose data you want to back up with Veeam Agents.
• W orkstation — select this option if you want to back up data on workstations or laptops. This option is
suitable for computers that reside in a remote location and may have limited connection to the backup
server.
For backup policies that process workstations, Veeam Backup & Replication offers settings similar to the
settings of the backup job available in the Workstation edition of Veeam Agent for Microsoft Windows. To
learn more, see the Veeam Agent for Microsoft Windows User Guide.
With this option selected, the backup job will be managed by Veeam Agent installed on the protected
computer — you do not need to select the job mode.
• Server — select this option if you want to back up data on standalone servers. This option is suitable for
computers that have permanent connection to the backup server.
For backup policies that process servers, Veeam Backup & Replication offers settings similar to the
settings of the backup job available in the Server edition of Veeam Agent for Microsoft Windows. To learn
more, see the Veeam Agent for Microsoft Windows User Guide.
With this option selected, you can also select the job mode. To learn more, see Selecting Job Mode.
NOTE
You cannot select the Fa ilover cluster option if you want to create a backup job managed by Veeam Agent.
350 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
If you selected the Server computer type in the Ty p e field, in the Mod e field, select the Ma naged by agent job
mode to create a Veeam Agent backup policy. If you select the Ma naged by backup server job mode, you will
create a Veeam Agent backup job managed by the backup server.
351 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Job Name and Description
At the Na me step of the wizard, specify a name and description for the backup policy.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the job, date and time when the job was created.
352 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers whose data you want to
back up with Veeam Agent backup policy.
You can add to the Veeam Agent backup policy one or more protection groups and individual computers from
the Veeam Backup & Replication inventory. You can also add to the policy computers that are not added to
inventory yet. Veeam Backup & Replication will add such computers to the policy and also add them to the
Manually Added protection group.
If Veeam Backup & Replication discovers a new computer in a protection group after the Veeam Agent backup
policy is created, Veeam Backup & Replication will automatically update the policy settings to include the added
computer.
NOTE
• If you used the Ad d to backup job > W indows > New job option to launch the New Agent Backup Job
wizard, the Protected computers list will already contain computers that you have selected to add to
the policy. You can remove some computers from the policy or add new computers to the policy, if
necessary.
• You cannot add protection groups for cloud machines to backup policies. Veeam Backup &
Replication displays protection groups for cloud machines and their members only if you selected
the Managed by backup server option at the Job Mode step of the wizard. To learn more, see
Selecting Job Mode.
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] or [Shift] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
353 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
2. Click the Sta rt search button on the right or press [Enter].
2. In the Ad d Computer window, in the Host name or IP address field, enter a full DNS name or IP address of
the computer that you want to add to the policy.
354 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. From the Credentials list, select a user account that has administrative permissions on the computer that
you want to add to the policy. If you have not set up credentials beforehand, click the Ma nage accounts
link or click Ad d on the right to add credentials. For more information, see the Credentials Manager
section in the Veeam Backup & Replication User Guide.
355 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup.
1. In the Ba ckup mode section, select the backup mode. You can select one of the following options:
o E ntire computer — select this option if you want to create a backup of the entire computer image.
When you restore data from such backup, you will be able to recover the entire computer image as
well as data on specific computer volumes: files, folders, application data and so on. With this option
selected, you will pass to the Destination step of the wizard.
o Volume level backup — select this option if you want to create a backup of specific computer volumes,
for example, all volumes except the system one. When you restore data from such backup, you will be
able to recover data located on these volumes only: files, folders, application data and so on. With
this option selected, you will pass to the Objects step of the wizard.
o File level backup — select this option if you want to create a backup of individual folders on your
computer. With this option selected, you will pass to the Objects step of the wizard.
2. [For entire computer backup] If you want to include in the backup one or more external USB drives, select
the Include external USB drives check box. With this option selected, Veeam Agent will include in the
backup all external USB drives that are connected to the Veeam Agent computer at the time when the
backup policy starts. To learn more, see the Backup of External Drives section in the Veeam Agent for
Microsoft Windows User Guide.
356 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
File-level backup is typically slower than volume-level backup. Depending on the performance capabilities
of your computer and backup environment, the difference between file-level and volume-level backup
policy performance may increase significantly. If you plan to back up all folders with files on a specific
volume or back up large amount of data, we recommend that you configure volume-level backup instead
of file-level backup.
357 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you chose to create volume-level or file-level Veeam Agent
backups. Specify backup scope for the Veeam Agent backup policy:
• Specify volumes to back up — if you have selected the Volume level backup option at the Backup Mode
step of the wizard.
• Specify folders to back up — if you have selected the File level backup option at the Backup Mode step of
the wizard.
At this step of the wizard, you must specify the backup scope — define what volumes you want to include in the
backup. The specified backup scope settings will apply to a ll computers that are added to the backup policy. If a
specified volume does not exist on one or more computers in the policy, the policy will skip such volume on
those computers and back up only existing ones.
To specify the backup scope, you can select the Ba ckup the following volumes only option and add necessary
objects.
Alternatively, you can back up the whole Veeam Agent computer. To do this, select the Ba ckup all volumes
ex cept the following option. With this option selected, you can exclude objects that you do not need from the
backup scope.
• OS volume — data on the OS installed on a protected computer. This object includes the Microsoft
Windows system partition and boot partition of your computer. For GPT disks on Microsoft Windows 8.1,
10, 11, 2012, 2012 R2, 2016, 2019, and 2022, the object additionally includes the recovery partition. To
learn more, see the System State Data Backup section in the Veeam Agent for Microsoft Windows User
Guide.
To include or exclude the OS volume, in the necessary wizard section, click Ad d and select the OS volume
option.
• Individual volumes .
To include or exclude individual volumes:
a. In the necessary wizard section, click Ad d and select the Volume name option.
b. In the Ad d Object window, type the drive letter of a volume that you want to back up, for example,
C:\, and click OK.
c. Repeat steps a–b for all volumes that you want to back up.
a. In the necessary wizard section, click Ad d and select the Volume name option.
b. In the Ad d Object window, type the path to a folder that is an entry point to the mounted volume you
want to back up, for example, C:\Data, and click OK.
c. Repeat steps a–b for all mount points that you want to back up.
358 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a system volume in the volume-level backup, Veeam Agent for Microsoft Windows
automatically includes the System Reserved/UEFI or other system partitions in the backup too.
• You cannot include volumes located on virtual hard disks (VHD or VHDX) in the volume -level
backup.
• Veeam Agent for Microsoft Windows automatically adds to the list of exclusions the following
Microsoft Windows objects for all computer users: temporary files folder, Recycle Bin, Microsoft
Windows pagefile, hibernate file and VSS snapshot files from the System Volume Information folder.
In the file-level backup mode, you can create two types of backups:
• Hybrid backup that contains individual folders and specific volumes of your computer.
At this step of the wizard, you must specify the backup scope by defining what folders with files or entire
volumes you want to include in the backup. The specified backup scope settings will apply to all computers that
are added to the backup policy. If a specified object does not exist on one or more computers in the policy, the
policy will skip such object on those computers and back up existing ones.
359 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
To specify the backup scope, in the Ob jects to backup list, select check boxes next to necessary objects. You can
include the following data in the backup:
• Operating system — data related to the OS installed on a protected computer. To learn more, see the
System State Data Backup section in the Veeam Agent for Microsoft Windows User Guide.
• Personal files — data related to user profiles. With this option enabled, Veeam Backup & Replication will
include in the backup scope settings and data related to Veeam Agent computer user profiles. To learn
more, see the Personal Data Backup section in the Veeam Agent for Microsoft Windows User Guide.
• Individual file system objects — folders, mount points, and volumes of a protected computer.
1. Select the The following file system objects check box and click Ad d .
2. In the Ad d Object window, type the path to a folder, mount point folder, or volume that you want to back
up, for example, D:\Reports or D:\, and click OK.
To specify the backup scope, you can use system environment variables such as %ProgramFiles% or
%WinDir%. This may be useful, for example, in case computers added to the backup policy run different
versions of Microsoft Windows OSes, and actual paths to directories that contain data of the same type
differ on these computers.
o You can use only system environment variables — variables defined for the Local System account on
computers added to the backup policy. User-dependent environment variables are not supported.
o Environment variables that contain multiple values (such as the %PATH% variable) are not
supported.
o Environment variables that contain other environment variables are not supported.
3. Repeat steps 1–2 for all items that you want to back up.
360 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a system volume in the file-level backup, Veeam Agent does not automatically include
the System Reserved/UEFI or other system partitions in the backup. These volumes are
automatically included in the backup only if you select the Operating system option to specify the
backup scope.
• Veeam Agent automatically adds to the list of exclusions the following Microsoft Windows objects
for all computer users: temporary files folder, Recycle Bin, Microsoft Windows pagefile, hibernate
file and VSS snapshot files from the System Volume Information folder.
• You can exclude Microsoft OneDrive folders from the backup scope in the File Filters window.
Configuring Filters
To include or exclude folders and files of a specific type in/from the file-level backup, you can configure filters.
361 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you include a specific folder in the file-level backup, Veeam Agent applies filters to files in specific
folders that you include in the backup. Filters are not applied to computer volumes, mount points,
and folders selected for backup. If you plan to create a hybrid backup that will contain volumes,
mount points, and folders, filters will be applied to files in folders only.
• If you include a whole volume in the file-level backup, you cannot apply filters to include or exclude
files of a specific type in/from the backup. You can only exclude specific folders that reside on the
volume.
• You cannot apply filters to files and folders that reside on the mount point.
• If you want to include or exclude files in/from the file-level backup, you can use file names and
masks for file types as filters. You cannot use paths to files.
To configure a filter:
o If you include a specific folder in the file-level backup, in the Include masks field, specify file names
and masks for file types that you want to back up, for example, MyReport.pdf, *filename*,
*.docx. The resulting Veeam Agent backup will contain only selected files. Other files will not be
backed up.
You cannot specify include masks if you add an entire volume in the backup.
o In the E x clude masks field, specify files that you do not want to back up in the following ways:
▪ If you include an entire volume in the file-level backup, in the E x clude masks field, specify paths
to folders that contain files that you do not want to back up. The resulting Veeam Agent backup
will contain all folders that reside on the backed-up volume except the files in the specified
folders.
For example, you include the D:\ volume in the backup and specify the
D:\Reports\OldReports folder in the E x clude masks field. The resulting backup will contain
all folders and files that reside on the volume except files that reside in the
D:\Reports\OldReports folder.
▪ If you include a specific folder in the file-level backup, in the E x clude masks field, specify paths
to folders that contain files that you do not want to back up and file names and masks for file
types that you do not want to back up, for example, OldReports.rar, *.temp, *.tmp,
*.back. The resulting Veeam Agent backup will contain all files that reside in the backed -up
folder except files in the specified folders and files whose names match the specified names or
masks.
Keep in mind that depending on the backup type, Veeam Agent excludes files and folders from the
backup scope differently:
▪ For the volume-level backup, content of folders you do not want to back up is excluded from
the VSS snapshot with the FilesNotToSnapshot registry key.
362 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
▪ For the file-level backup, folders and files are excluded by Veeam Agent after the VSS snapshot
is created.
As a result, some objects may be excluded or not excluded from the backup scope depending on the
type of the created backup. For example, if you configure a volume-level backup, the objects that you
excluded may stay in the backup scope due to the FilesNotToSnapshot registry key limitations. To
learn more, see this Microsoft article.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
TIP
You can also use system environment variables to specify include and exclude masks. In this case, you must
type the back slash (\) symbol in the beginning of the mask. For example: \%appdata%.
• To specify include and exclude masks, you can use only system environment variables — variables
defined for the Local System account on computers added to the backup policy, and cannot use user
environment variables. For example, if you specify the \%appdata% exclude mask, Veeam Agent
will exclude the C:\Windows\system32\config\systemprofile\AppData\Roaming folder
from the backup. Application data directories for other user accounts (for example,
C:\Users\Administrator\AppData\Roaming) will not be excluded from the backup.
• You cannot use environment variables that contain multiple values or other environment variables
to specify include and exclude masks.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
The resulting Veeam Agent backup will contain all files of the PDF format that do not contain draft in their
names.
Additionally, you can specify how Veeam Agent for Microsoft Windows will process Microsoft OneDrive folders.
Select the E x clude Microsoft OneDrive folders option to exclude Microsoft OneDrive folders and their content
from the backup scope.
• Veeam Agent excludes Microsoft OneDrive folders only in file-level backups. If you include an entire
volume in the backup, Veeam Agent will not exclude Microsoft Onedrive folders from this volume.
363 | V eeam Backup & Replication | V eeam A gent Management Guide | 12.2.0.334
• Due to the OS limitations, the E x clude Microsoft OneDrive folders option behaves properly only on Veeam
Agent computers running Microsoft Windows 10. If your Veeam Agent computers run other OS versions,
we recommend to exclude Microsoft OneDrive folders manually.
364 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Select Backup Destination
At the Destination step of the wizard, select a target location for backups created by Veeam Agents installed on
protected computers.
• Loca l storage — select this option if you want to save a backup on a removable storage device attached to
a protected computer or on a local drive of a protected computer. With this option selected, you will pass
to the Local Storage step of the wizard.
IMP ORTANT
• It is strongly recommended that you store backups in the external location like USB storage
device or network shared folder. You can also keep your backup files on the separate non-
system local drive.
• If you select to store the backup in a local folder included in the backup scope, Veeam Agent
for Microsoft Windows will automatically exclude this folder from the backup.
• Sha red folder — select this option if you want to save a backup in an SMB network shared folder. With this
option selected, you will pass to the Shared folder step of the wizard.
• Veeam backup repository — select this option if you want to save a backup in a backup repository
managed by the Veeam backup server of which the Veeam Agent backup policy is configured. With t his
option selected, you will pass to the Backup Server step of the wizard.
• Veeam Cloud Connect repository — select this option if you want to save a backup in a cloud repository
exposed to you by the Veeam Cloud Connect service provider. With this option selected, you will pass to
the Storage step of the wizard.
365 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 8. Specify Backup Storage Settings
Specify backup storage settings for the Veeam Agent backup policy:
• Local storage settings — if you have selected the Loca l storage option at the Destination step of the
wizard.
• Shared folder settings — if you have selected the Sha red folder option at the Destination step of the
wizard.
• Veeam backup repository settings — if you have selected the Veeam backup repository option at the
Destination step of the wizard.
• Cloud repository settings — if you have selected the Veeam Cloud Connect repository option at the
Destination step of the wizard.
1. In the Loca l folder field, type a path to a folder on a protected computer where backup files must be
saved. If the specified folder does not exist in the file system of a protected computer, Veeam Age nt for
Microsoft Windows will create this folder and save the resulting backup file to this folder. If the volume on
which the specified folder must reside does not exist on a protected computer, Veeam Backup &
Replication will not apply the backup policy settings to this computer.
IMP ORTANT
• USB storage devices formatted as FAT32 do not allow storing files larger than 4 GB in size. For
this reason, we recommend that you do not use such USB storage devices as a backup target.
• We do not recommend targeting a backup policy at the storage device with the exFAT file
system. If the protected computer runs Microsoft Windows 10 or Microsoft Windows Server
2019 and later, this configuration may lead to the backup data corruption caused by the
exFAT file system issue.
2. Specify short-term backup retention policy settings in one of the following ways:
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is exceeded, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
days except days when no backup files are created. After this period is over, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
Keep in mind that if you have selected the W orkstation type at the Job Mode step of the wizard, you
can specify retention policy only in days.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
366 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. In the Sha red folder field, type a UNC name of the SMB network shared folder in which you want to store
backup files. Keep in mind that the UNC name always starts with two back slashes ( \\).
2. If the SMB network shared folder requires authentication, select the This share requires access credentials
check box and select from the list a user account that has access permissions on this shared folder. If you
have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to add
credentials. The user name must be specified in the DOMAIN\USERNAME format.
If you do not select the This share requires access credentials check box, Veeam Agent for Microsoft
Windows will connect to the shared folder using the NT AUTHORITY \SYSTEM account of the computer
where the product is installed. You can use this scenario if the Veeam Agent computer is joined to the
Active Directory domain. In this case, you can simply grant Full Control access on the shared folder and
underlying file system to the computer account (DOMAIN\COMPUTERNAME$).
3. Specify short-term backup retention policy settings in one of the following ways:
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is exceeded, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
367 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
days except days when no backup files are created. After this period is over, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
Keep in mind that if you have selected the W orkstation type at the Job Mode step of the wizard, you
can specify retention policy only in days.
4. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. At the Backup Server step of the wizard, specify backup server settings .
2. At the Storage step of the wizard, select the Veeam backup repository .
368 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Specifying Backup Server Settings
The Ba ckup Server step of the wizard is available if you have chosen to store backup files in a Veeam backup
repository.
In the DNS name or external IP address field, make sure that the name or IP address of the Veeam backup
server, on which you configure the Veeam Agent backup policy, is displayed. Do not specify the name or IP
address of another Veeam backup server. The specified DNS name or IP address must be resolvable from Veeam
Agent computers.
NOTE
Veeam Backup & Replication does not automatically update information about the backup server in the
backup policy settings after migration of the configuration database. After you migrate configuration data
to a new location, you must specify the name or IP address of the new backup server in the properties of all
backup policies configured in Veeam Backup & Replication.
1. From the Ba ckup repository list, select a backup repository where you want to store created backups.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
369 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. Specify short-term backup retention policy settings in one of the following ways:
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is excee ded, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
days except days when no backup files are created. After this period is over, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
Keep in mind that if you have selected the W orkstation type at the Job Mode step of the wizard, you
can specify retention policy only in days.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
4. If you want to archive backup files created with the backup job to a secondary destination (backup
repository or tape), select the Configure secondary destinations for this job check box. With this option
enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At the
Secondary Target step of the wizard, you can link the backup job to the backup copy job or backup to tape
backup job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
370 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam backup repository.
Keep in mind that FQDN or IP addresses of Veeam Agent computers that you back up to the cloud
repository will be visible to the Veeam Cloud Connect service provider. To learn more, see Before You
Begin.
At the Storage step of the wizard, specify settings for the cloud repository:
1. From the Ba ckup repository list, select a cloud repository where you want to store created backups. The
Ba ckup repository list displays cloud repositories allocated to your tenant account by the Veeam Cloud
Connect service provider. When you select a cloud repository, Veeam Backup & Replication automatically
checks how much free space is available in the repository.
2. Specify short-term backup retention policy settings in one of the following ways:
o From the Retention p olicy list, select restore points and specify the number of restore points for
which you want to store backup files in the target location. By default, Veeam Backup & Replication
keeps backup files created for 7 latest restore points. After this number is exceeded, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
371 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
o From the Retention p olicy list, select days and specify the number of days for which you want to store
backup files in the target location. By default, Veeam Backup & Replication keeps backup files for 7
days except days when no backup files are created. After this period is over, Veeam Backup &
Replication will remove the earliest restore points from the backup chain.
Keep in mind that if you have selected the W orkstation type at the Job Mode step of the wizard, you
can specify retention policy only in days.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
4. Click Ad vanced to specify advanced settings for the backup job. To learn more, see Specify Advanced
Backup Settings.
IMP ORTANT
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam Cloud Connect repository.
372 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 9. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup policy:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
TIP
After you specify necessary settings for the Veeam Agent backup policy, you can save them as defa ult
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup policy, Veeam Backup & Replication will automatically apply the default
settings to the new policy.
Backup Settings
To specify settings for a backup chain created with the backup policy:
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
o Loca l Storage — if you have selected to save backup files in a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
2. If you want to periodically create synthetic full backups, on the Ba ckup tab, select the Create synthetic
full backups p eriodically check box and click Da ys to schedule synthetic full backups on the necessary
week days.
NOTE
Synthetic full backup is not available for backup policies targeted at an object storage repository.
3. If you want to periodically create active full backups, select the Create active full backups periodically
check box. Click Configure and use the Monthly on or W eekly options to define scheduling settings.
373 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• Before scheduling periodic full backups, you must make sure that you have enough free space on
the target location. For more information about periodic full backups, see the Active Full Backup
and Synthetic Full Backup sections in the Veeam Agent for Microsoft Windows User Guide.
• If you schedule the active full backup and synthetic full backup on the same day, Veeam Agent for
Microsoft Windows will perform only active full backup. Synthetic full backup will be skipped.
Maintenance Settings
To specify maintenance settings for the backup policy:
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
o Loca l Storage — if you have selected to save backup files in a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
374 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. To periodically perform a health check for the latest restore point in the backup chain, in the Storage-level
corruption guard section, select the P erform backup files health check check box. To specify the schedule
for the health check, click Configure.
An automatic health check can help you avoid a situation where a restore point gets corrupted, making all
dependent restore points corrupted, too. If during the health check Veeam Agent for Microsoft Windows
or Veeam Backup & Replication detect corrupted data blocks in the latest restore point in the backup chain
(or the restore point before the latest one if the latest restore point is incomplete), it will start the health
check retry and transport valid data blocks from the Veeam Agent computer to the target location. The
transported data blocks are stored to a new backup file or the latest backup file in the backup chain,
depending on the data corruption scenario.
For Veeam Agent backup policies, the health check process is the same as for Veeam Agent backup jobs
configured directly on a Veeam Agent computer. For more information, see the Health Check for Backup
Files section in the Veeam Agent for Microsoft Windows User Guide.
NOTE
For object storage, Veeam Agent offers a special health check mechanism as default. To run the
health check for object storage, enable the P erform backup files health check option in the Storage-
level corruption guard section and specify the health check schedule.
You can also switch from the health check for object storage to the standard health check. To do so,
select the Verify content of each object in backup check box in the backup policy settings. Keep in
mind that enabling this setting may result in additional charges from your object storage provider.
4. [For backup policies targeted at a Veeam backup repository or cloud repository] Select the Remove
d eleted items data after check box and specify the number of days for which you want to keep the backup
created with the backup policy in the target location.
If Veeam Agent does not create new restore points for the backup, the backup will remain in the target
location for the period that you have specified. When this period is over, the backup will be removed from
the target location. For more information, see the Retention Policy for Outdated Backups section in the
Veeam Agent for Microsoft Windows User Guide.
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. In the opposite case, the backup policy may work not as
expected and remove data that you still require.
NOTE
The Remove deleted items data after option is not available if you configure a backup policy and
have selected the Loca l storage or Sha red folder option at the Destination step of the wizard.
5. To periodically compact a full backup, select the Defragment and compact full backup file check box. To
specify the schedule for the compact operation, click Configure. During the compact operation, data
blocks from the full backup file are copied to a new empty file. As a result, the full backup file gets
defragmented, and the speed of reading from and writing to the backup file increases.
NOTE
The Defragment and compact full backup file option is not available for backup policies targeted at
object storage.
If the full backup file contains data blocks for deleted drives, Veeam Agent for Microsoft Windows will
remove these data blocks. For more information, see the Compact of Full Backup File section in the Veeam
Agent for Microsoft Windows User Guide.
375 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you want to periodically compact a full backup, you must make sure that you have enough
free space in the target location. For the compact operation, the amount of free space must
be equal to or more that the size of the full backup file.
• In contrast to the compact operation for a VM backup, during compact of a full Veeam Agent
backup file, Veeam Backup & Replication does not perform the data take out operation. If the
full backup file contains data for a computer that has only one restore point and this restore
point is older than 7 days, Veeam Backup & Replication will not extract data for this computer
to a separate full backup file.
Storage Settings
To specify storage settings for the backup policy:
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
o Loca l Storage — if you have selected to save backup files in a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
376 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme. To learn more about the compression levels, see the Data Compression section
in the Veeam Agent for Linux User Guide.
4. In the Storage optimization section, select what size of data blocks you plan to use: 4 MB, 1 MB, 512 KB,
256 KB. Veeam Agent for Microsoft Windows will use data blocks of the chosen size to optimize the size of
backup files and job performance.
NOTE
If you change the storage optimization settings for the backup job, new settings will not have any
effect on previously created files in the chain. They will be applied to new files created after the
settings were changed.
To apply new storage optimization settings in backup jobs, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Replication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
5. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will display a
warning about it. For more information, see the Decrypting Data Without Password section in the Veeam
Backup & Replication User Guide.
377 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• You must encrypt the backup job if you want to back up data to the Veeam Data Vault
storage.
• You cannot use Key Management System (KMS) keys for data encryption with a Veeam Agent
backup policy. To be able to use KMS keys, create a backup job managed by the backup server.
To learn more about KMS keys, see the Key Management System Keys section in the Veeam
Backup & Replication User Guide.
• Data encryption settings for Veeam Agent backup policies configured in Veeam Backup & Replication are
stored to the Veeam Backup & Replication database.
For backup policies targeted at a Veeam backup repository, all data encryption operations are performed
in Veeam Backup & Replication. Encryption settings are passed to a Veeam Agent computer only in case
this computer is added to a backup policy targeted at a local drive of a protected computer, at an SMB
network shared folder, or at a cloud repository. Veeam Backup & Replication passes encryption settings
when applying the backup policy to a protected computer.
378 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• If you change a password for data encryption for an existing backup policy targeted at a Veeam backup
repository without changing other backup policy settings, the process of applying the backup policy to a
protected computer completes with a notification informing that the backup policy was not modified. This
happens because data encryption settings for backup policies targeted at a Veeam backup repository are
saved to the Veeam Backup & Replication database and are not passed to a Veeam Agent computer.
• If you enable or disable encryption for an existing Veeam Agent backup, during the next job session
Veeam Agent for Microsoft Windows will create a full backup file. The created full backup file and
subsequent incremental backup files in the backup chain will be encrypted with the specified password.
• Encryption is not retroactive. If you enable encryption for an existing backup policy, Veeam Agent for
Microsoft Windows will encrypt the backup chain starting from the next restore point created with this
policy.
• [For backup policies targeted at a local drive, network shared folder or cloud repository] When you enable
data encryption for a backup policy, Veeam Backup & Replication uses the specified password to encrypt
backups of all Veeam Agent computers added to the backup p olicy. A Veeam Agent computer user can
restore data from the backup of this computer without providing a password to decrypt backup. To restore
data from a backup of another computer in this backup policy, a user must provide a password specified in
the backup policy settings.
This scenario differs from the same scenario in earlier versions of Veeam Backup & Replication where all
backups created for Veeam Agent computers in the backup policy could be accessed from any computer in
the backup policy without providing a password.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in the
Veeam Backup & Replication User Guide.
Notification Settings
You can specify email notification settings for the backup policy. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with backup policy statistics to a specified email address. The
report contains cumulative statistics for backup job sessions performed for the last 24 -hour period on
computers to which the backup policy is applied.
NOTE
Email reports with backup policy statistics will be sent if you configure global email notification settings in
Veeam Backup & Replication. For more information, see the Configuring Global Email Notification Settings
section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the backup policy, Veeam Backup & Replication will send reports
with the backup policy statistics to email addresses specified in global email notification settings and email
addresses specified in the backup policy settings.
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
o Loca l Storage — if you have selected to save backup files in a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
379 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. Select the Send daily e-mail report to the following recipients check box and specify a recipient’s email
address in the field below. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the
email notification for the backup policy. Veeam Backup & Replication will send the report daily at the
specified time.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the backup policy, select Use g lobal notification settings. In this
case, Veeam Backup & Replication will apply to the backup policy global email notification settings
specified for the backup server.
o To configure a custom notification for the backup policy, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the backup policy) and %Issues% (number of machines in the backup policy that
have been processed with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning or Notify on error check boxes to receive email
notification if the policy completes successfully, completes with a warning or fails.
6. In the Ba ckup monitoring section, select the W a rn me if no backups were created in the last <N> days
check box and specify a number of days. In this case, Veeam Backup & Replication will display a warning
message in a backup policy session statistics in case successful backups are not created for a specified
number of days.
380 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 10. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the Veeam Agent backup policy to a backup to tape or
backup copy job. As a result, the backup policy will be added as a source to the backup to tape or backup copy
job. Backup files created with the backup policy will be archived to tape or copied to the secondary backup
repository according to the secondary jobs schedule. For more information, see the Linking Backup Jobs to
Backup Copy Jobs and Linking Backup Jobs to Backup to Tape Jobs sections in the Veeam Backup & Replication
User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup policy to these jobs, Veeam Backup & Replication will
automatically update the linked policies to define the Veeam Agent backup policy as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup policy. You can link several jobs to the backup policy — for example, one backup to tape job and
one backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
381 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 11. Specify Backup Cache Settings
The Ba ckup Cache step of the wizard is available if you selected the Veeam backup repository or Veeam Cloud
Connect repository option at the Destination step of the wizard.
2. In the Ma x imum size field, specify the size for the backup cache.
When defining the size of the backup cache, assume the following:
o Each full backup file may consume about 50% of the backed -up data size.
o Each incremental backup file may consume about 10% of the backed -up data size.
3. In the Loca tion section, specify where Veeam Agent for Microsoft Windows will create the backup cache.
You can select from the following options:
o Automatic selection — select this option if you want to let Veeam Agent pick a location for the backup
cache automatically. On every computer added to the backup policy, Veeam Agent will detect a
volume with the largest amount of free disk space and create the backup cache in the Veeam Backup
Cache folder on this volume. To learn more, see Backup Cache.
o Ma nual selection — select this option if you want to specify a location for the backup cache manually.
If you select this option, in the Fold er field, specify a path to the folder on a protected computer in
which backup files must be stored.
382 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 12. Specify Guest Processing Settings
The Guest Processing step of the wizard is available if you have selected the Server or Fa ilover cluster option at
the Job Mode step of the wizard.
For a Veeam Agent backup policy that includes Windows-based computers, you can enable the following guest
OS processing settings:
• Application-aware processing
• File indexing
Application-Aware Processing
If your computer runs VSS-aware applications, you can enable application-aware processing to create a
transactionally consistent backup. The transactionally consistent backup guarantees proper recovery of
applications without data loss.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
383 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. On the General tab, in the Ap p lications section, make sure that the E na ble application-aware processing
check box is selected.
You can clear this check box, for example, if you want to disable application-aware processing for a
specific computer added to the backup policy as a part of a protection group.
[For Microsoft SQL Server] If you disable application-aware processing, Veeam Agent will not include
information about databases in the backup. However, you can use Veeam Explorer for Microsoft SQL to
locate a database file in the backup and restore the database.
5. [For Microsoft Exchange, Microsoft SQL Server and other a pplications that rely on VSS] In the Microsoft
VSS settings section, specify if Veeam Agent for Microsoft Windows running on a protected computer
must process transaction logs or copy-only backups must be created.
o Select P rocess transaction logs with thi s job if you want Veeam Agent for Microsoft Windows to
process transaction logs.
[For Microsoft Exchange] With this option selected, Veeam Agent for Microsoft Windows will wait for
backup to complete successfully, and then trigger truncation of transaction logs. If the backup policy
fails, the logs will remain untouched until the next backup policy session.
[For Microsoft SQL Server and Oracle] You will have to specify settings for database log handling on
the SQL and Ora cle tabs of the P rocessing Settings window. For more information, see Microsoft SQL
Server Transaction Log Settings and Oracle Archived Log Settings.
o Select P erform copy only if you use another tool to maintain consistency of the database state. Veeam
Agent for Microsoft Windows will create a copy-only backup. The copy-only backup preserves the
chain of full/differential backup files and transaction logs. After a copy -only backup, Veeam Agent
does not trigger truncation of transaction logs. For more information, see this Microsoft article.
384 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
• [For Microsoft Exchange] Veeam Agent for Microsoft Windows performs truncation of Microsoft
Exchange transaction logs only if all disks that contain the Microsoft Exchange database are
included in a volume-level backup policy.
• [For Microsoft SQL Server and Oracle] If both Microsoft SQL Server and Oracle Server are installed
on one guest OS, you can enable log backup settings only for one of the installed applications:
Microsoft SQL Server or Oracle Server.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
4. In the Microsoft VSS settings section, select P rocess transaction logs with this job.
385 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
6. To specify a user account that Veeam Agent will use to connect to the Microsoft SQL Server, select from
the Sp ecify Windows account with sysadmin role on SQL Server list a user account that has access
permissions on the database. This account must be a Microsoft Windows user account with roles and
permissions as specified in section Permissions for Guest Processing. Keep in mind that you cannot use
Microsoft SQL Server accounts (for example, the SA account) to connect to the database.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
will connect to the Microsoft SQL Server under the account that you have s pecified for the protected
computer in the protection group settings.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
7. Specify how transaction logs must be processed. You can select one of the following options:
o Select Truncate logs to truncate transaction logs after successful backup. Veeam Agent will wait for
the backup to complete successfully and then truncate transaction logs. If the backup policy fails, the
logs will remain untouched until the next backup policy session.
o Select Do not truncate logs to preserve transaction logs. When the backup policy completes, Veeam
Agent will not truncate transaction logs.
We recommend that you enable this option only for databases with log truncation managed by a
database administrator and databases that use the Simple recovery model. If you enable this option
for databases that use the Full or Bulk-logged recovery model, transaction logs may grow large and
consume all disk space. In this case, the database administrator must take care of transaction logs.
o Select Ba ckup logs periodically to back up transaction logs with Veeam Agent. Veeam Agent will
periodically copy transaction logs to the backup location and store them together with the image-
level backup. During the backup policy session, transaction logs will be truncated.
NOTE
For more information, see the Microsoft SQL Server and Oracle Logs Backup section in the Veeam
Agent for Microsoft Windows User Guide.
If you have selected to back up transaction logs with Veeam Agent for Microsoft Windows, you must specify
settings for transaction logs backup:
1. In the Ba ckup logs every <N> minutes field, specify the frequency for transaction logs backup. By default,
transaction logs are backed up every 15 minutes. The maximum log backup interval is 480 minutes.
2. In the Retain log backups section, specify retention policy for transaction logs stored in the backup
location.
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
image-level backups and transaction log backups.
386 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Select Keep only last <N> days of log backups to keep transaction logs for a specific number of days.
By default, transaction logs are kept for 15 days. If you select this option, you must make sure that
retention for transaction logs is not greater than retention for the image-level backup. For more
information, see the Retention for Database Log Backups section in the Veeam Agent for Microsoft
Windows User Guide.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
4. In the Microsoft VSS settings section, select P rocess transaction logs with this job.
6. To specify a user account that Veeam Agent for Microsoft Windows will use to connect to the Oracle
database, select from the Sp ecify Oracle account with SYSDBA privileges list a user account that has
SYSDBA rights on the database. If you have not set up cred entials beforehand, click the Ma nage accounts
link or click Ad d on the right to add credentials.
By default, the Use guest OS credentials option is selected in the list. With this option selected, Veeam
Agent for Microsoft Windows will connect to the Oracle database under the account that you have
specified for the protected computer in the protection group settings.
387 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
7. In the Archived logs section, specify if Veeam Agent for Microsoft Windows must delete archived redo
logs on the Oracle database:
o Select Do not d elete archived logs if you want Veeam Agent for Microsoft Windows to preserve
archived logs. When the backup policy completes, Veeam Agent for Microsoft Windows will not
delete archived logs.
It is recommended that you select this option for databases for which the ARCHIVELOG mode is
turned off. If the ARCHIVELOG mode is turned on, archived logs may grow large and consume all disk
space. In this case, the database administrator must take care of archived logs him-/herself.
o Select Delete logs older than < N> hours or Delete logs over <N> GB if you want Veeam Agent for
Microsoft Windows to delete archived logs that are older than <N> hours or larger than <N> GB.
Veeam Agent for Microsoft Windows will wait for the backup policy to complete successfull y and then
trigger archived logs deletion from the Oracle Call Interface (OCI) according to the specified settings.
If the backup policy fails, the logs will remain untouched until the next successful backup policy
session.
TIP
If you configure backup policy to back up archived logs, Veeam Agent for Microsoft Windows
also triggers archived logs deletion after each log backup job session.
8. To back up Oracle archived logs with Veeam Agent for Microsoft Windows, select the Ba ck up logs every
< N> minutes check box and specify the frequency for archived logs backup. By default, archived logs are
backed up every 15 minutes. The minimum log backup interval is 5 minutes. The maximum log backup
interval is 480 minutes.
9. In the Retain log backups section, specify retention policy for archived logs stored in the backup location:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
Veeam Agent backups and archived log backups.
388 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Select Keep only last <N> days of l og backups to keep archived logs for a specific number of days. By
default, archived logs are kept for 15 days. If you select this option, you must make sure that
retention for archived logs is not greater than retention for the Veeam Agent backups. For more
information, see the Retention for Database Log Backups section in the Veeam Agent for Microsoft
Windows User Guide.
1. At the Guest Processing step of the wizard, make sure that the E na ble application-aware processing check
box is selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
389 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
5. From the Sp ecify SharePoint admin account list, select a user account that Veeam Agent for Microsoft
Windows will use to connect to the SharePoint application. If you have not set up credentials beforehand,
click the Ma nage accounts link or click Ad d on the right to add credentials.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
for Microsoft Windows will connect to the SharePoint application under the account that you have
specified for the protected computer in the protection group settings.
1. At the Guest Processing step, make sure that the E na ble application-aware processing check box is
selected.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
390 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
5. From the Sp ecify admin account for script execution list, select a user account that Veeam Agent for
Microsoft Windows will use to run pre-freeze and post-thaw scripts. If you have not set up credentials
beforehand, click the Ma nage accounts link or click Add on the right to add credentials.
By default, the Use guest credentials option is selected in the list. With this option selected, Veeam Agent
for Microsoft Windows will run pre-freeze and post-thaw scripts under the account that you have
specified for the protected computer in the protection group settings.
6. In the Script processing mode section, specify the scenario for scripts execution:
o Select Require successful script execution if you want Veeam Agent for Microsoft Windows to stop
the backup process if the script fails.
o Select Ig nore script execution failures if you want to continue the backup process even if script errors
occur.
7. In the Sna pshot scripts section, in the P re-freeze script and P ost-thaw script fields, click Browse to choose
executable files from a local folder on the backup server. During the backup policy session, Veeam Backup
& Replication will upload the scripts to Veeam Agent computers added to the policy and execute them on
these computers.
Veeam Agent for Microsoft Windows supports the following types of scripts:
You can use scripts of other formats as well, but we cannot guarantee correct processing of such scripts.
391 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
File Indexing
You can instruct the backup policy to create an index of files and folders on the protected computer OS during
backup. If you enable the file indexing option, you will be able to search for individual files inside Veeam Agent
backups and perform 1-click restore in Veeam Backup Enterprise Manager.
NOTE
File system indexing is optional. If you do not enable this option in the backup policy settings, you will still
be able to perform 1-click restore from the backup created with such backup policy. For more information,
see the Preparing for File Browsing and Restore section in the Veeam Backup Enterprise Manager User
Guide.
1. At the Guest Processing step of the wizard, select the E nable guest file system indexing check box.
3. In the displayed list, select a protection group or individual computer and click E d it.
o Select Ind ex everything if you want to index all files within the backup scope that you have specified
at the Backup mode step of the wizard. Veeam Agent for Microsoft Windows will index all files that
reside:
▪ On the volumes that you have specified for backup (for volume-level backup)
▪ In the folders that you have specified for backup (for file-level backup)
o Select Ind ex everything except if you want to index all files on the protected computer OS except
those defined in the list. By default, system folders are excluded from indexing. You can add or delete
folders using the Ad d and Remove buttons on the right. You can also use system environment
variables to form the list, for example: %windir%, %Program Files% and %Temp%.
392 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
o Select Ind ex only following folders to define folders that you want to index. You can add or delete
folders to index using the Ad d and Remove buttons on the right. You can also use system
environment variables to form the list, for example: %windir%, %Program Files% and %Temp%.
393 | V eeam Backup & Replication | V eeam A gent Management Guide | 12.2.0.334
Step 13. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup. At the
Schedule step of the wizard, specify the schedule according to which you want to perform backup. Backup
policy scheduling options differ depending on the computer type that you have selected at the Job Mode step
of the wizard:
NOTE
After you click Ap p ly at the Schedule step of the wizard, Veeam Backup & Replication will immediately
apply the backup policy to protected computers.
1. Select the Da ily at check box and use the fields on the right to specify time and days when the backup
policy must start:
o Everyday — select this option to start the policy at specific time daily.
o On week-days — select this option to start the policy at specific time on week-days.
o On these days — select this option to start the policy at specific time on selected days.
You can leave the Da ily at check box unchecked to configure the backup policy without daily schedule. In
this case, you will be able to use the backup policy to perform backup automatically at specific events.
2. If you have selected the On these days option, click the Da y s button and clear check boxes for the days
when the policy must not start.
3. Select the action that Veeam Agent for Microsoft Windows must perform in case the protected computer
is powered off at the time when the scheduled backup policy must start.
o Backup once powered on — select this option if you want Veeam Agent for Microsoft Windows to start
the scheduled backup policy when the protected computer is powered on.
o Skip backup — select this option if you want Veeam Agent for Microsoft Windows not to start the
scheduled backup policy when the computer is powered on. Veeam Agent for Microsoft Windows will
perform backup at the next scheduled time.
4. If you want Veeam Agent for Microsoft Windows to perform a finalizing action after the backup policy
completes successfully, select the necessary action:
o Keep running — select this option if the computer must keep on working.
o Sleep — select this option if you want Veeam Agent for Microsoft Windows to bring the computer to
the standby mode.
o Shutdown — select this option if you want Veeam Agent for Microsoft Windows to shut down the
computer.
394 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
o Hibernate — select this option if you want Veeam Agent for Microsoft Windows to bring the computer
to the hibernate mode. This option is available if the hibernate mode is enabled on the protected
computer. To learn more, see this Microsoft KB article.
When the backup policy completes, Veeam Agent for Microsoft Windows will prompt a dialog with a
countdown to the selected post-job action. You can select to proceed to the action immediately or to
cancel the action. To learn more, see the Controlling Backup Post-Job Action section in the Veeam Agent
for Microsoft Windows User Guide.
5. In the At the following events section, specify settings for events that trigger the backup policy launch:
o Select the Lock check box if you want to start the backup policy when the user locks the Veeam Agent
computer.
o Select the Log off check box if you want to start the backup policy when the user working with the
computer performs a logout operation.
o Select the W hen backup target is connected check box if you want to start the backup policy when
the backup storage becomes available (for example, when the computer connects to a local network
and the target shared folder is accessible).
o Select the E ject removable storage once backup is completed check box if you want Veeam Agent for
Microsoft Windows to unmount the storage device after the backup policy completes successfully.
With this option selected, backup files on the removable storage will be protected from encrypting
ransomware, such as CryptoLocker.
Veeam Agent applies this setting only to backup policies triggered by the When backup target is
connected event. In case of backup policies triggered by other computer events or started periodically
at specific time, Veeam Agent will ignore this setting, and the storage device will not be unmounted
after the backup policy completes successfully.
IMP ORTANT
The Eject removable storage once backup is completed option does not guarantee a bulletproof
protection against ransomware. To ensure your backups are safe, keep the OS up to date and
regularly scan your backup repository for virus threats using modern antivirus software.
o Use the Ba ck up no more often than every <N> <time units> field to restrict the frequency of backup
policy sessions. Specify a minutely, hourly or daily interval between the backup policy sessions.
The Back up no more often than every <N> <time units> option is applied only to policy sessions
started at specific events. Daily backups are performed according to defined schedule regardless of
the time interval specified for this setting.
395 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
IMP ORTANT
If the power scheme on the Veeam Agent computer does not allow using wake up timers, Veeam Agent for
Microsoft Windows will not be able to wake your computer from sleep for backup. You can manually
change the power scheme settings on the Veeam Agent computer. To do this, navigate to Control Panel >
All Control Panel Items > P ower Options > E dit Plan Settings.
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup policy manually to create backup.
o To run the policy at specific time daily, on defined week days or with specific periodicity, select Da ily
a t this time. Use the fields on the right to configure the necessary schedule.
o To run the policy once a month on specific days, select Monthly at this time. Use the fields on the
right to configure the necessary schedule.
o To run the policy repeatedly throughout a day with a specific time interval, select P eriodically every.
In the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and use the
time table to define the permitted time window for the policy. In the Sta rt time within an hour field,
specify the exact time when the policy must start.
396 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
▪ The defined interval always starts at 12:00 AM. For example, if you configure to run a policy
with a 4-hour interval, the policy will start at 12:00 AM, 4:00 AM, 8:00 AM, 12:00 PM, 4:00 PM
and so on.
▪ If you define permitted hours for the policy, after the denied interval is over, the policy will start
immediately and then run by the defined schedule.
For example, you have configured a policy to run with a 2-hour interval and defined permitted hours
from 9:00 AM to 5:00 PM. According to the rules above, the policy will first run at 9:00 AM, when
the denied period is over. After that, the policy will run at 10:00 AM, 12:00 PM, 2:00 PM and 4:00
PM.
o To run the policy continuously, select the P eriodically every option and choose Continuously from the
list on the right. A new backup policy session will start as soon as the previous backup policy session
finishes.
3. In the Automatic retry section, define whether Veeam Agent for Microsoft Windows must attempt to run
the backup policy again if the policy fails for some reason. Enter the number of attempts to run the policy
and define time intervals between them. If you select continuous backup, Veeam Backup & Replication or
Veeam Agent for Microsoft Windows retries the policy for the defined number of times without any time
intervals between the policy runs.
If a backup policy fails and Veeam Agent retries the session, Veeam Agent does not transfer all the data
again. Instead, Veeam Agent continues data transfer that was started before the backup policy fail. To do
so, Veeam Agent compares hash values for data blocks on source and target. After the hash comparison,
Veeam Agent also transfers only those data blocks that were not transferred before the policy fail. If data
blocks on source were changed before the retry, Veeam Agent transfers these data blocks as well.
NOTE
The automatic retry does not start if you run the backup policy manually. In this case, you can
manually retry the backup policy. To learn more, see Retrying Veeam Agent Backup Job.
4. In the Ba ckup window section, define the time interval within which the backup policy must complete. The
backup window prevents the policy from overlapping with production hours and ensures that the policy
does not impact performance of your server. To set up a backup window for the policy:
a. Select the Terminate job if it exceeds allowed backup window check box and click W ind ow.
b. In the Time P eriods window, define the allowed hours and prohibited hours for backup.
If the policy exceeds the allowed window, it will be automatically terminated. In this case, data
transport and backup chain transformation processes are stopped. Keep in mind that this behavior
differs from a VM backup job where backup window affects data transport process and health che ck
operations only.
397 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
IMP ORTANT
The backup window does not affect the process of uploading backup files from the backup cache to
the target storage. If Veeam Agent creates one or more backup files in the backup cache, and then
the backup target becomes available, Veeam Agent uploads backup files to the target location
immediately, regardless of the specified backup window.
398 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 14. Review Backup Job Settings
At the Summary step of the wizard, complete the backup policy configuration process.
Keep in mind that Veeam Backup & Replication does not immediately apply backup policy to computers included
in protection groups for pre-installed Veeam Agents. Veeam Agents installed on computers that are included in
these groups connect to Veeam Backup & Replication every 6 hours and get updated backup policy settings. If
you targeted a backup policy at the Veeam backup server and scheduled earlier than the next connection to
Veeam Backup & Replication, this backup policy will get updated backup policy settings at the next backup
policy session start. To learn more about protection groups for pre-installed Veeam Agents, see Protection
Group Types.
If you want to apply backup policy immediately, you must synchronize Veeam Agent with Veeam Backup &
Replication from the Veeam Agent computer side manually. To learn more, see Configuration.
399 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Policy for Linux Computers
To back up data of a computer protected with Veeam Agent for Linux, you can configure a Veeam Agent backup
policy in Veeam Backup & Replication.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers and
workstations that you plan to add to the backup policy. To learn more, see Licensing Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the policy must be configured in advance.
• [For backup policies targeted at the cloud repository] The Veeam Cloud Connect service provider must be
added in the Veeam backup console.
• If you want to perform a volume-level restore of a computer using Veeam Agent, the BIOS b oot partition
of this computer must be associated with a block device. Otherwise, Veeam Agent supports only file -level
restore from the backup of the computer.
• You cannot map a Veeam Agent backup policy to a Veeam Agent backup chain created by another t ype of
a Veeam Agent backup job. After you change the mode of a Veeam Agent computer, Veeam Backup &
Replication starts a new backup chain in a target location specified in the backup policy settings.
• Veeam Agent does not support creating transaction log backups in the cloud repository. You cannot
enable transaction log backup options in the properties of the backup policy targeted at the cloud
repository.
• Veeam Agent does not support backup of bind mount points. In the scope of the backup policy, you must
specify the path to the original mount point instead.
• If you plan to create a Veeam Agent backup policy for computers with nosnap Veeam Agent installed,
consider the limitations and system requirements listed in section System Requirements for Linux
Computers (nosnap Veeam Agent).
• You cannot add a Veeam Agent computer protected by a backup job managed by the backup server to a
Veeam Agent backup policy. To add such a computer to a Veeam Agent backup policy, first remov e the
computer from the backup job managed by the backup server.
400 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup policy for protected computers that run a Linux OS in one of the
following ways:
• Create a new backup policy — in this case, Veeam Backup & Replication will launch the New Agent Backup
Job wizard. You will be able to specify protection groups and Veeam Agent computers to which the
backup policy settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup policy — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup policy. You will also
be able to change the list of Veeam Agent computers to which the backup policy settings must apply at
the Computers step of the wizard.
• Add individual computers to a new backup policy — in this case, Veeam Backup & Replication will launch
the New Ag ent Backup Job wizard and add the selected computers to the backup policy. You will also be
able to change the list of Veeam Agent computers to which the backup policy settings must apply at the
Computers step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > Linux computer on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > Linux computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup policy and select Ad d to backup job > Linux > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup policy and click Ad d to Backup > Linux > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
policy. You can add other protection groups and individual computers to the policy later on, when you pass
through the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want t o
add to the policy, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy and click Ad d to Backup > New job on the ribbon.
401 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
policy. You can add other computers and protection groups to the policy later on, when you pass through the
wizard steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup policy that is
already configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup
Job and Adding Protection Group to Backup Job.
402 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, specify protection settings for the Veeam Agent backup policy:
1. Select the type of protected computers whose data you want to back up with Veeam Agents.
• W orkstation — select this option if you want to back up data on Linux-based workstations or laptops. This
option is suitable for computers that reside in a remote location and may have limited connection to the
backup server.
For backup policies that process workstations, Veeam Backup & Replication offers settings similar to the
job settings available in Veeam Agent for Linux operating in the Workstation mode. To learn more, see the
Product Editions section in the Veeam Agent for Linux User Guide.
With this option selected, the backup policy will be managed by Veeam Agent installed on the protected
computer — you do not need to select the job mode.
• Server — select this option if you want to back up data on Linux-based servers. This option is suitable for
computers that have permanent connection to the backup server.
For backup policies that process servers, Veeam Backup & Replication offers settings similar to the job
settings available in Veeam Agent for Linux operating in the Server mode. To learn more, see the Veeam
Agent for Linux User Guide.
With this option selected, you can select the job mode. To learn more, see Selecting Job Mode.
403 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
If you selected the Server option in the Type field, in the Mod e field, select the Ma naged by agent job mode to
create a Veeam Agent backup policy. If you select the Ma naged by backup server job mode, you will create a
Veeam Agent backup job managed by the backup server.
404 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 3. Specify Job Name and Description
At the Na me step of the wizard, specify a name and description for the backup policy.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the policy, date and time when the policy was created.
405 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers that you want to back
up.
You can add to the Veeam Agent backup policy one or more protection groups and individual computers from
the Veeam Backup & Replication inventory. You can also add to the policy computers that are not added to
inventory yet. Veeam Backup & Replication will add such computers to the policy and also add them to the
Ma nually Added protection group.
Policies with protection groups are dynamic in their nature. If Veeam Backup & Replication discovers a new
computer in a protection group after the Veeam Agent backup policy is created, Veeam Backup & Replication
will automatically update the policy settings to include the added computer.
NOTE
If you used the Ad d to backup job > Linux > New job option to launch the New Agent Backup Job wizard,
the P rotected computers list will already contain computers that you have selected to add to the policy.
You can remove some computers from the policy or add new computers to the policy, if necessary.
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] or [Shift] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
406 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. Click the Sta rt search button on the right or press [Enter].
2. In the Ad d Computer window, in the Host name or IP address field, enter a full DNS name or IP address of
the computer that you want to add to the policy.
o Connect using admin credentials. In this case, from the Credentials list, select a user account that has
administrative permissions on the computer that you want to add to the protection group. Veeam
Backup & Replication will use this account to connect to the protected computer and perform the
necessary operations on the computer: upload and install Veeam Agent, and so on.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials.
Veeam Backup & Replication allows to add the following types of credentials:
▪ Stored credentials. Select stored credentials if you want Veeam Backup & Replication to use the
specified user name and password for each connection to Veeam Agent.
407 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
▪ Sing le-use credentials. Select single-use credentials if you do not want Veeam Backup &
Replication to store credentials in the configuration database. With this option selected, Veeam
Backup & Replication will use the specified user name and password only for the f irst connection
to Veeam Agent. After that, Veeam Backup & Replication will use Veeam Transport Service to
communicate with the Veeam Agent computer.
Keep in mind that the username must be specified in the down-level logon name format. For example,
DOMAIN\UserName or HOSTNAME\UserName. Use the full domain or hostname name. Do not replace
them with a dot.
For more information, see the Credentials Manager section in the Veeam Backup & Replication User
Guide.
o Select this option, if you chose to pre-install Veeam Deployer Service on the Linux computer that you
want to add to the backup policy. In this case, Veeam Backup & Replication will communicate with the
Linux computer using a certificate. To learn more, see Deploying Veeam Agent for Linux Using Pre-
Installed Veeam Deployer Service
408 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup.
1. In the Ba ckup mode section, select the backup mode. You can select one of the following options:
o E ntire computer — select this option if you want to create a backup of the entire computer image.
When you restore data from such backup, you will be able to recover the entire computer image as
well as data on specific computer volumes: files, directories, application d ata and so on. With this
option selected, you will pass to the Destination step of the wizard.
o Volume level backup — select this option if you want to create a backup of specific computer volumes,
for example, the system volume. When you restore data from such backup, you will be able to recover
data located on these volumes only: files, directories, application data and so on. With this option
selected, you will pass to the Objects step of the wizard.
o File level backup — select this option if you want to create a backup of individual directories on your
computer. With this option selected, you will pass to the Objects step of the wizard.
2. [For file-level backup] If you want to perform backup in the snapshot-less mode, select the Ba ckup
d irectly from live file system check box. With this option selected, Veeam Agent for Linux will not create a
snapshot of a backed-up volume during backup. This allows Veeam Agent to back up data residing in file
systems that are not supported for snapshot-based backup with Veeam Agent for Linux. To learn more,
see the Snapshot-Less File-Level Backup section in the Veeam Agent for Linux User Guide.
409 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
File-level backup is typically slower than volume-level backup. Depending on the performance capabilities
of your computer and backup environment, the difference between file-level and volume-level backup
policy performance may increase significantly. If you plan to back up all folders with files on a specific
volume or back up large amount of data, it is recommended that you configure volume -level backup
instead of file-level backup.
410 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you chose to create volume-level or file-level Veeam Agent
backups. Specify backup scope for the Veeam Agent backup policy:
• Specify volumes to back up — if you have selected the Volume level backup option at the Backup Mode
step of the wizard.
• Specify directories to back up — if you have selected the File level backup option at the Backup Mode step
of the wizard.
At this step of the wizard, you must specify the backup scope — define what volumes you want to include in the
backup. The specified backup scope settings will apply to all computers that are added to the backup policy. If a
specified volume does not exist on one or more computers in the policy, the policy will skip such volumes on
those computers and back up only existing ones.
1. In the Ob jects to backup field, click Ad d and select the type of object that you want to include in the
backup: Device, Mount point, LVM or BTRFS.
2. In the Ad d Object window, specify the object that you want to back up and click OK.
o Block devices . You can include in the backup scope all volumes on a computer disk or individual
volumes of a protected computer:
▪ To include all volumes on a computer disk in the backup, type the path to a block device that
represents the disk whose volumes you want to back up. For example: /dev/ sda .
▪ To include a specific volume of a protected computer in the backup, type the path to a block
device that represents the volume that you want to back up. For example: /dev/sda1.
NOTE
If you include a block device in the backup, and this block device is a physical volume assigned
to an LVM volume group, Veeam Agent will include the whole LVM volume group in the
backup.
o Mount points . You can include in the backup scope individual volumes of a protected computer. Type
the path to a mount point of the volume that you want to back up. For example: / or /home.
IMP ORTANT
Veeam Agent does not support backup of bind mount points. You must specify the path to the
original mount point instead.
o LVM volumes . You can include in the backup scope entire LVM volume groups or individual LVM
logical volumes of a protected computer. Type the path to a mount point or a block device that
represents the volume group or logical volume that you want to back up. For example: /dev/vg or
/dev/vg/lv1.
411 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
o Btrfs subvolumes . You can include in the backup scope all Btrfs subvolumes of a Btrfs storage p ool or
specific Btrfs subvolumes.
▪ To include all subvolumes of a Btrfs pool in the backup, type the path to a block device that
represents the Btrfs pool. For example: /dev/sda1.
▪ To include a specific Btrfs subvolume in the backup, type the path to a mount point of this
subvolume. For example: /sub1.
3. Repeat steps 1–2 for all objects that you want to back up.
If you have created several system partitions, for example, a separate partition for the /boot directory, make
sure that you include all of these partitions in the backup. Otherwise, Veeam Agent for Linux does not guarantee
that the OS will boot properly when you attempt to recover from such backup.
At this step of the wizard, you must specify the backup scope by defining what directories with files you want to
include in the backup. The specified backup scope settings will apply to all computers that are added to the
backup policy. If a specified directory does not exist on one or more computers in the policy, the policy will skip
such folder on those computers and back up existing ones.
2. In the Ad d Object window, type the path to a directory that you want to back up, for example,
/home/user01, and click OK.
412 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
IMP ORTANT
Veeam Agent does not support backup of bind mount points. You must specify the path to the
original mount point instead.
3. Repeat steps 1–2 for all directories that you want to back up.
TIP
If you want to back up the root directory and specify ‘/’ in the P a th to a directory field, Veeam Agent will
not automatically include into the backup scope the network file system mount points — for example, NFS
or SMB network shared folders. To include such mount points, you need to specify paths to these mount
points manually.
For example, you have a network file system mounted to the /home/media directory. If you add ‘/’ as an
object to the backup scope, Veeam Agent will not back up the mounted file system. To back up the root
directory and the mounted network file system, add the following objects to the backup s cope:
• /
• /home/media
Configuring Filters
To include or exclude files of a specific type in/from the file-level backup, you can configure filters.
413 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To configure a filter:
o In the Include masks field, specify file names and masks for file types that you want to back up, for
example, Report.pdf or *filename*. Veeam Agent for Linux will create a backup only for selected files.
Other files will not be backed up.
o In the E x clude masks field, specify file names and masks for file types that you do not want to back
up, for example, OldReports.tar.gz or *.odt. Veeam Agent for Linux will back up all files except files
of the specified type.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
Veeam Agent for Linux will include in the backup all files of the PDF format that do not contain draft in their
names.
414 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 7. Select Backup Destination
At the Destination step of the wizard, select a target location for backups created by Veeam Agents installed on
protected computers.
• Loca l storage — select this option if you want to save a backup on a removable storage device attached to
a protected computer or on a local drive of a protected computer. With this option selected, you will pass
to the Local Storage step of the wizard.
IMP ORTANT
It is recommended that you store backups in the external location like USB storage device or network
shared folder. You can also keep your backup files on the separate non-system local drive.
• Sha red folder — select this option if you want to save a backup in a network shared folder. With this option
selected, you will pass to the Shared folder step of the wizard.
• Veeam backup repository — select this option if you want to save a backup in a backup repository
managed by the Veeam backup server. With this option selected, you will pass to the Backup Server step
of the wizard.
• Veeam Cloud Connect repository — select this option if you want to save a backup on a cloud repository
exposed to you by the Veeam Cloud Connect service provider. With this option selected, you will pass to
the Storage step of the wizard.
415 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 8. Specify Backup Storage Settings
Specify backup storage settings for the backup policy:
• Local storage settings — if you have selected the Local storage option at the Destination step of the
wizard.
• Shared folder settings — if you have selected the Shared folder option at the Destination step of the
wizard.
• Veeam backup repository settings — if you have selected the Veeam backup repository option at the
Destination step of the wizard.
• Cloud repository settings — if you have selected the Veeam Cloud Connect repository option at the
Destination step of the wizard.
1. In the Loca l folder field, type a path to a folder on a protected computer where backup files must be
saved. If the specified folder does not exist in the file system of a protected computer, Veeam Agent for
Linux will create this folder and save the resulting backup file to this folder. If the volume on which the
specified folder must reside does not exist on a protected computer, Veeam Backup & Replication will not
apply the backup policy settings to this computer.
IMP ORTANT
USB storage devices formatted as FAT32 do not allow storing files larger than 4 GB in size. For this
reason, it is recommended that you do not use such USB storage devices as a backup target.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent for Linux keeps backup files created for
7 latest restore points. After this number is exceeded, Veeam Agent for Linux will remove the earliest
restore points from the backup chain. To learn more, see Short-Term Retention Policy.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
416 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. In the File share type section, select the type of a network shared folder:
o SMB — to connect to a network shared folder using the SMB (CIFS) protocol.
2. In the Sha red folder field, type a name of the network shared folder in which you want to store backup
files.
o [For an NFS shared folder] Specify a name of the network shared folder in the SERVER:/DIRECTORY
format.
o [For an SMB shared folder] Specify a UNC name of the network shared folder. Keep in mind that the
UNC name always starts with two back slashes (\\).
3. [For an SMB shared folder] If the network shared folder requires authentication, select the This share
requires access credentials check box and select from the list a user account that has access permissions
on this shared folder. If you have not set up credentials beforehand, click the Ma nage accounts link or
click Ad d on the right to add credentials. The user name must be specified in the DOMAIN\USERNAME
format.
417 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent for Linux keeps backup files created for
7 latest restore points. After this number is exceeded, Veeam Agent for Linux will remove the earliest
restore points from the backup chain. To learn more, see Short-Term Retention Policy.
5. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
6. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. At the Backup Server step of the wizard, specify backup server settings .
2. At the Backup Repository step of the wizard, select the Veeam backup repository.
418 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
Veeam Backup & Replication does not automatically update information about the backup server in the
backup policy settings after migration of the configuration database. After you migrate configuration data
to a new location, you must specify the name or IP address of the new backup server in the properties of all
backup policies configured in Veeam Backup & Replication.
1. From the Ba ckup repository list, select a backup repository where you want to store created backups.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent for Linux keeps backup files created for
7 latest restore points. After this number is exceeded, Veeam Agent for Linux will remove the earliest
restore points from the backup chain. To learn more, see Short-Term Retention Policy.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
419 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. If you want to archive backup files created with the backup policy to a secondary destination (backup
repository or tape), select the Configure secondary backup destinations for this job check box. With this
option enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At
the Secondary Target step of the wizard, you can link the backup policy to the backup copy job or backup
to tape backup job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
NOTE
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam backup repository.
Keep in mind that FQDN or IP addresses of Veeam Agent computers that you back up to the cloud
repository will be visible to the Veeam Cloud Connect service provider. To learn more, see Before You
Begin.
420 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
At the Storage step of the wizard, specify settings for the cloud repository:
1. From the Ba ckup repository list, select a cloud repository where you want to store created backups. The
Ba ckup repository list displays cloud repositories allocated to your tenant account by the Veeam Cloud
Connect service provider. When you select a cloud repository, Veeam Backup & Replication automatically
checks how much free space is available on the repository.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent for Linux keeps backup files created for
7 latest restore points. After this number is exceeded, Veeam Agent for Linux will remove the earliest
restore points from the backup chain. To learn more, see Short-Term Retention Policy.
3. To use the GFS (Grandfather-Father-Son) retention scheme, select the Keep certain full backups longer
for archival purposes check box and click Configure. In the Configure GFS window, specify how weekly,
monthly and yearly full backups must be retained. To learn more, see the Long-Term Retention Policy
(GFS) section in the Veeam Backup & Replication User Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
IMP ORTANT
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam Cloud Connect repository.
421 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 9. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup policy:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
TIP
After you specify necessary settings for the Veeam Agent backup policy, you can save them as default
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup policy, Veeam Backup & Replication will automatically apply the default
settings to the new policy.
Backup Settings
To specify settings for a backup chain created with the Veeam Agent backup policy:
2. If you want to periodically create active full backups, select the Create active full backups periodically
check box and click Configure to define scheduling settings.
422 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
Before scheduling periodic full backups, you must make sure that you have enough free space on the
target location.
Maintenance Settings
You can specify maintenance settings for a backup chain created with the Veeam Agent backup policy.
Maintenance operations help make sure that the backup chain remains valid and consistent.
423 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. Select the Remove deleted items data after check box and specify the number of days for which you want
to keep the backup created with the backup job in the target location.
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. In the opposite case, the backup job may work not as expected
and remove data that you still require.
Storage Settings
To specify storage settings for the Veeam Agent backup policy:
3. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme. To learn more about the compression levels, see the Data Compression section
in the Veeam Agent for Linux User Guide.
4. In the Storage optimization section, select what type of backup target you plan to use. Depending on the
chosen storage type, Veeam Agent for Linux will use data blocks of different size to optimize the size of
backup files and policy performance: 4 MB, 1 MB, 512 KB or 256 KB.
424 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
If you change the storage optimization settings for the backup policy, new settings will not have any
effect on previously created files in the chain. They will be applied to new files created after the
settings were changed.
To apply new storage optimization settings in backup policies, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Rep lication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
5. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will display a
warning about it: Loss protection disabled . For more information, see the Decrypting Data Without
Password section in the Veeam Backup & Replication User Guide.
425 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
• If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• You must encrypt the backup job if you want to back up data to the Veeam Data Vault
storage.
• You cannot use Key Management System (KMS) keys for data encryption with a Veeam Agent
backup policy. To be able to use KMS keys, create a backup job managed by the backup server.
To learn more about KMS keys, see the Key Management System Keys section in the Veeam
Backup & Replication User Guide.
• If you enable or disable encryption for an existing Veeam Agent backup, during the next job session
Veeam Agent for Linux will create a full backup file. The created full backup file and subsequent
incremental backup files in the backup chain will be encrypted with the specified password.
• Encryption is not retroactive. If you enable encryption for an existing backup job, Veeam Agent for Linux
will encrypt the backup chain starting from the next restore point created with this job.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in the
Veeam Backup & Replication User Guide.
426 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Notification Settings
You can specify email notification settings for the backup policy. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with backup policy statistics to a specified email address. The
report contains cumulative statistics for backup policy sessions performed for the last 24-hour period on
computers to which the backup policy is applied.
NOTE
Email reports with backup policy statistics will be sent if you configure global email notification set tings in
Veeam Backup & Replication. For more information, see the Configuring Global Email Notification Settings
section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the backup policy, Veeam Backup & Replication will send reports
with the backup policy statistics to email addresses specified in global email notification settings and email
addresses specified in the backup policy settings.
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
3. Select the Send daily e-mail report to the following recipients check box and specify a recipient’s email
address in the field below. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the
email notification for the backup policy. Veeam Backup & Replication will sent the report daily at the
specified time.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the backup policy, select Use g lobal notification settings. In this
case, Veeam Backup & Replication will apply to the backup policy global email notification settings
specified for the backup server. Veeam Backup & Replication will send the email report containing
backup policy statistics at 8:00 AM daily.
o To configure a custom notification for the backup policy, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the backup policy) and %Issues% (number of machines in the backup policy that
have been processed with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the policy completes successfully, completes with a warning or fails.
427 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. In the Ba ckup monitoring section, select the W a rn me if no backups were created in the last <N> days
check box and specify a number of days. In this case, Veeam Backup & Replication will display a warning
message in a backup policy session statistics in case successful backups are not created for a specified
number of days.
428 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 10. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the Veeam Agent backup policy to a backup to tape or
backup copy job. As a result, the backup policy will be added as a source to the backup to tape or backup copy
job. Backup files created with the backup policy will be archived to tape or copied to the secondary backup
repository according to the secondary jobs schedule. For more information, see the Linking Backup Jobs to
Backup Copy Jobs and Linking Backup Jobs to Backup to Tape Jobs sections in the Veeam Backup & Replication
User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup policy to these jobs, Veeam Backup & Replication will
automatically update the linked jobs to define the Veeam Agent backup policy as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup policy. You can link several jobs to the backup policy — for example, one backup to tape job and
one backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
429 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 11. Specify Guest Processing Settings
At the Guest Processing step of the wizard, you can enable the following guest OS processing settings for a
Veeam Agent backup policy that protects Linux-based computers:
• Application-aware processing
• File indexing
2. Click Ap p lications.
3. In the Ap p lication-Aware Processing Options window, select a protection group or individual computer
and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the Guest OS credentials list, select a user account that Veeam Agent will use for the processing of
applications on the protected computer.
By default, the Use protection group credentials option is selected in the list. With this option selected,
Veeam Agent will do one of the following:
o If you specified stored credentials for this computer in the protection group settings, Veeam Agent
will process applications using the specified account.
o If you specified single-use credentials for this computer in the protection group settings, Veeam
Agent will use the root user.
To learn more about stored and single-use credentials, see Specifying Computers.
If you want to use account that is not available in the Guest OS credentials list, click the Ma nage accounts
link or click Ad d on the right to add credentials.
5. To specify credentials for a particular computer or a protection group, click Credentials on the right to set
up credentials. In the Guest OS Credentials window, select a protection group or individual computer and
click Set User.
If you specify custom credentials for a particular computer or a protection group in the Guest OS
Credentials window, Veeam Agent will use these custom credentials instead of the credentials specified in
the Guest OS credentials list (see Step 4).
Keep in mind that to specify credentials for a particular computer, you must include this computer to the
backup job as a standalone object at the Comp uters step of the wizard. To do this, click Ad d and choose
the computer whose credentials you want to add. Then select the computer in the list and specify the
necessary credentials.
430 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Veeam Agent uses credentials selected in the Guest OS credentials list for Veeam Transport Service
and database systems processing.
For file system indexing, MySQL processing and scripts execution, Veeam Agent always uses the
root account.
6. Configure the necessary settings for the selected protection group or individual computer:
o [For backup policies that protect servers] Processing settings for Oracle database system
o [For backup policies that protect servers] Processing settings for MySQL database system
o [For backup policies that protect servers] Processing settings for PostgreSQL database system
File Indexing
To configure file indexing setiings:
3. In the displayed list, select the protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
431 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. Configure file indexing settings for the selected protection group or individual computer. To learn more,
see File Indexing.
Application-Aware Processing
If a computer protected with Veeam Agent for Linux runs an Oracle, MySQL or PostgreSQL database system, you
can enable application-aware processing to create a transactionally consistent backup. The transactionally
consistent backup guarantees proper recovery of databases without data loss.
2. In the Ap p lication-Aware Processing Options window, a necessary protection group or individual computer
is added to the list.
2. In the Ap p lication-Aware Processing Options window, select the necessary object and click E d it.
432 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. On the General tab, in the Ap p lications section, specify the behavior scenario for application-aware
processing:
o Select Require successful processing if you want Veeam Agent for Linux to process database systems.
With this option selected, if an error occurs when processing a database or database instance, Veeam
Agent for Linux will stop the backup process.
If you select this option, you will need to specify database processing settings. For more information,
see Oracle Processing Settings, MySQL Processing Settings and PostgreSQL Processing Settings.
o Select Try application processing, but ignore failures if you want Veeam Agent for Linux to process
database systems. With this option selected, if an error occurs when processing a database or
database instance, Veeam Agent for Linux will not stop the backup process. Instead, Veeam Agent for
Linux will skip this database or database instance and proceed to the next one. Information about the
skipped database or database instance will be displayed in a warning message in the policy session
statistics. After the backup process is completed, you will be able to restore data from the backup and
restore databases or database instances that were successfully processed during backup.
If you select this option, you will need to specify database processing settings. For more information,
see Oracle Processing Settings, MySQL Processing Settings and PostgreSQL Processing Settings.
o Select Disable application processing if you do not want Veeam Agent for Linux to process database
systems. If you select this option, the Ora cle, MySQL and P ostgreSQL tabs of the P rocessing Settings
window will become unavailable. You still will be able to specify script settings for the pol icy on the
Scripts tab of the window.
433 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Before You Begin
Before you start working with the Oracle database system, check the following:
1. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
2. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
3. At the Guest Processing step of the wizard, in the Guest OS credentials list, a necessary user account is
selected.
4. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it, then click the
Ora cle tab.
3. On the Ora cle tab, specify a user account that Veeam Agent for Linux will use to connect to the Oracle
database. You can do one of the following:
o Select from the Sp ecify Oracle account with SYSDBA privileges list a database user account that has
SYSDBA rights on the Oracle database.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials. With this option selected, Veeam Agent for Linux will connect to the Oracle
database under the account that you have selected in the Sp ecify Oracle account with SYSDBA
p rivileges list.
With this option selected, Veeam Agent for Linux will do the following:
i. Veeam Agent will check if you specified custom credentials for the computer or protection
group in the Guest OS Credentials window at the Guest Processing step of the wizard.
If you specified custom credentials for the computer or protection group in the Guest OS
Credentials window, Veeam Agent will process the Oracle database under the OS account that
you have specified in this window.
If you have not specified custom credentials for the computer or protection group, Veeam Agent
will do as described in the step ii of this procedure.
ii. Veeam Agent will check what have you selected in the Guest OS credentials list at the Guest
P rocessing step of the wizard.
If you specified credentials in the Guest OS credentials list, Veeam Agent will process the Oracle
database under the account that you have specified in this list.
434 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
If you have not specified credentials in the list and selected the Use protection group credentials
option instead, Veeam Agent will do as described in the step iii of this procedure.
iii. Veeam Agent will check what credentials have you specified for the computer or protection
group at the Comp uters step of the wizard.
If you specified stored credentials for this computer in the protection group settings, Veeam
Agent will process the Oracle database using the specified account.
If you specified single-use credentials for this computer in the protection group settings, Veeam
Agent will process the Oracle database using the root user.
4. In the Archived logs section, specify if Veeam Agent for Linux must delete archived logs on the Oracle
database:
o Select Do not d elete archived logs if you want Veeam Agent for Linux to preserve archived logs. When
the backup policy completes, Veeam Agent for Linux will not delete archived logs.
It is recommended that you select this option for databases for which the ARCHIVELOG mode is
turned off. If the ARCHIVELOG mode is turned on, archived logs may grow large and consume all disk
space. In this case, the database administrator must take care of archived logs themselves.
o Select Delete logs older than < N> hours or Delete logs over <N> GB if you want Veeam Agent for
Linux to delete archived logs that are older than <N> hours or larger than <N> GB. Veeam Agent for
Linux will wait for the backup policy to complete successfully and then trigger archived logs
truncation through Oracle Call Interface (OCI). If the backup policy fails, the logs will remain
untouched until the next successful backup policy session.
435 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
If you configure backup policy to back up archived logs, Veeam Agent for Linux will not trigger
archived logs deletion after each log backup policy session. To prevent Oracle database logs
from overgrowing, run the backup policy for the Veeam Agent computer more often.
1. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
2. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
3. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
436 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To learn more, see Application-Aware Processing.
4. MySQL tables with the MyISAM storage engine must be locked to keep them in a consistent state while
Veeam Agent is creating the system snapshot. To correctly process such tables, make sure that the user
account you want to specify in the MySQL processing settings has the following instance -wide privileges:
o SELECT. This privilege enables Veeam Agent to access tables' metadata and select for a lock the
tables that use the MyISAM storage engine. Without this privilege, the processing of the MySQL
database system will run successfully but MyISAM tables will not be locked, which may result in an
inconsistent state of the backed up data.
o LOCK TABLES. This privilege is required for locking the selected MyISAM tables. If some MyISAM
tables are selected but the MySQL account does not have the LOCK TABLES privilege, the processing
of the MySQL database system will fail.
o RELOAD or FLUSH_TABLES. If some MyISAM tables are selected but the MySQL account does not
have either RELOAD or FLUSH_TABLES privilege, the processing of the MySQL database system will
fail.
To obtain information about the privileges that are assigned to an account, use MySQL functionality, for
example, the SHOW GRANTS statement. To learn more, see MySQL documentation.
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it and switch to
the My SQL tab.
3. On the My SQL tab, specify a user account that Veeam Agent for Linux will use to connect to the MySQL
database, from the Sp ecify MySQL account with superuser privileges list, select a user account.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to
add credentials.
By default, the User from password file option is selected in the list. With this option selected, Veeam
Agent for Linux will connect to the MySQL database under the account specified in the password file on
the Veeam Agent computer. The default location for the password file is /root/.my.cnf. For
information about the password file format, see the Preparing Password File for MySQL Processing section
in the Veeam Agent for Linux User Guide.
4. If you want to specify a custom path to the password file, specify a full path in the P a ssword file path
field. Specifying relative paths is not supported.
437 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
For information on how Veeam Agent for Linux processes the MySQL database system, see the MySQL Backup
section in the Veeam Agent for Linux User Guide.
a. At the Guest Processing step of the wizard, the E na ble application-aware processing check box is
selected.
b. At the Guest Processing step of the wizard, in the Ap p lication-Aware Processing Options window, a
necessary protection group or individual computer is added to the list.
c. At the Guest Processing step of the wizard, in the Guest OS credentials list, a necessary user account
is selected.
d. On the General tab, in the Ap p lications section, Require successful processing or Try application
p rocessing, but ignore failures option is selected.
• Consider the Requirements and Limitations section in the Veeam Backup & Replication User Guide.
438 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Configuring PostgreSQL Processing
NOTE
To explicitly include or exclude specific configuration files from rescan, you can add the following
commands to the VeeamPostgreSQLAgent.xml file:
To specify how Veeam Agent for Linux must process the PostgreSQL database system, perform the following:
2. In the Ap p lication-Aware Processing Options window, select the necessary object, click E d it, then click the
P ostgreSQL tab.
3. On the P ostgreSQL tab, specify a user account that Veeam Agent for Linux will use to connect to the
PostgreSQL database. You can do one of the following:
o Select from the Sp ecify PostgreSQL account with superuser privileges list a user account that has the
required rights for the database.
If you have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right
to add credentials. With this option selected, Veeam Agent for Linux will connect to the PostgreSQL
database under the account that you have selected in the Sp ecify PostgreSQL account with superuser
p rivileges list.
Keep in mind that if you plan to select the peer authentication method at the step 4 of this procedure,
you can add a user account in the Credentials Manager without specifying the password for the
account.
With this option selected, Veeam Agent for Linux will do the following:
i. Veeam Agent will check if you have specified custom credentials for the computer or protection
group in the Guest OS Credentials window at the Guest Processing step of the wizard.
If you specify custom credentials for the computer or protection group in the Guest OS
Credentials window, Veeam Agent will process the PostgreSQL database under the account that
you have specified in this window.
If you do not specify custom credentials for the computer or protection group, Veeam Agent will
do as described in the step ii of this procedure.
439 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
ii. Veeam Agent will check what you have selected in the Guest OS credentials list at the Guest
P rocessing step of the wizard.
If you specify credentials in the Guest OS credentials list, Veeam Agent will process the
PostgreSQL database under the account that you specify in this list.
If you do not specify credentials in the list and select the Use p rotection g roup credentials
option instead, Veeam Agent will do as described in the step iii of this procedure.
iii. Veeam Agent will check what credentials you have specified for the computer or pr otection
group at the Comp uters step of the wizard.
If you specify stored credentials for this computer in the protection group settings, Veeam
Agent will process the PostgreSQL database using the specified account.
If you specify single-use credentials for this computer in the protection group settings, Veeam
Agent will process the PostgreSQL database using the root user.
4. In the The specified user is field, specify how Veeam Agent will connect to the PostgreSQL database.
The The specified user is field is connected closely with the Sp ecify PostgreSQL account with superuser
p rivileges list. Veeam Agent will do the following depending on what you specified using these two
controls.
440 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Control Veeam Agent Behavior
441 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
For more information on how Veeam Agent for Linux processes the PostgreSQL database system, see the
PostgreSQL Backup section in the Veeam Agent for Linux User Guide.
• Backup job scripts — pre-job and post-job scripts that run on the Veeam Agent computer before and after
the backup policy session.
• Snapshot scripts — pre-freeze and post-thaw scripts that run on the Veeam Agent computer before and
after the volume snapshot is created.
Veeam Backup & Replication offers 2 scenarios for specifying script settings:
You can specify only backup policy scripts that will be executed on Linux computers if you selected the
W orkstation computer type at the Job Mode step of the wizard or if you selected the Ba ckup directly from
live file system option at the Backup Mode step of the wizard.
442 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Specifying Backup Job and Snapshot Scripts
To specify custom scripts for the policy:
1. At the Gues t Processing step, select the E na ble application-aware processing check box.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. [For an entire computer backup or volume-level backup policy] In the P rocessing Settings window, click
the Scripts tab.
NOTE
For a file-level backup policy, application-aware processing and database processing options are not
available, and no tabs are displayed in the P rocessing Settings window.
6. In the Job scripts section, specify custom scripts that you want to execute before and after the backup
policy session. To do this, in the P re-job script and P ost-job script fields, click Browse and choose
executable files from a local folder on the backup server.
7. In the Sna pshot scripts section, specify custom scripts that you want to execute before Veeam Agent for
Linux creates a snapshot of the backed-up volume and after the snapshot is created. To do this, in the P re-
freeze script and P ost-thaw script fields, click Browse and choose executable files from a local folder on
the backup server.
443 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Agent for Linux supports scripts in the SH file format. During the backup policy session, Veeam Backup &
Replication will upload the scripts to the /var/lib/veeam/scripts directory on each Veeam Agent
computer added to the backup policy and execute them on these computers.
1. At the Guest Processing step, select the E na ble application-aware processing check box.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the P rocessing Settings window, select the E na ble script execution check box.
5. In the P re-job script and P ost-job script fields, click Browse to choose executable files from a local folder
on the backup server.
444 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Veeam Agent for Linux supports scripts in the SH file format. During the backup policy session, Veeam Backup &
Replication will upload the scripts to the /var/lib/veeam/scripts directory on each Veeam Agent
computer added to the policy and execute them on these computers.
File Indexing
You can instruct the Veeam Agent backup policy to create an index of files and folders on the protected
computer OS during backup. If you enable the file indexing option, you will be able to search for individual files
inside Veeam Agent backups and perform 1-click restore in Veeam Backup Enterprise Manager. For more
information on file system indexing, see the File System Indexing topic in the Veeam Agent for Linux User
Guide.
NOTE
File system indexing is optional. If you do not enable this option in the backup policy settings, you will still
be able to perform 1-click restore from the backup created with such backup policy. For more information,
see the Preparing for File Browsing and Restore section in the Veeam Backup Enterprise Manager User
Guide.
1. At the Guest Processing step of the wizard, select the E nable guest file system indexing check box.
3. In the displayed list, select the protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must add the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
445 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. In the Ind exing Settings window, specify the indexing scope:
o Select Ind ex everything if you want to index all files within the backup scope that you have specified
at the Backup mode step of the wizard. Veeam Agent for Linux will index all files that reside:
▪ On the volumes that you have specified for backup (for volume-level backup)
▪ In the directories that you have specified for backup (for file-level backup)
o [For volume-level backup only] Select Ind ex everything except if you want to index all files on your
computer OS except those defined in the list. By default, system directories /cdrom, /dev, /media,
/mnt, /proc, /tmp and /lost+found are excluded from indexing. You can add or delete folders
using the Ad d and Remove buttons on the right.
o [For volume-level backup only] Select Ind ex only following folders to define directories that you
want to index. You can add or delete directories to index using the Ad d and Remove buttons on the
right.
NOTE
You can specify a custom indexing scope only in for a volume-level backup policy. For a file-level backup
policy that processes Linux-based computers, only the Ind ex everything option is available.
446 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 12. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup policy manually to create backup.
NOTE
Depending on the type of protected computer you selected at the Job Mode step of the wizard,
Veeam Backup & Replication provides the following scheduling options for the backup job:
• [For Workstation] You can set the backup job to run automatically on specific days of the
week or daily.
• [For Server] You can configure daily, monthly and periodic schedules for the backup job.
o To run the policy at specific time daily, on defined week days or with specific periodicity, select Da ily
a t this time. Use the fields on the right to configure the necessary schedule.
o To run the policy once a month on specific days, select Monthly at this time. Use the fields on the
right to configure the necessary schedule.
o To run the policy repeatedly throughout a day with a specific time interval, se lect P eriodically every.
In the field on the right, select the necessary time unit: Hours or Minutes.
o To run the policy continuously, select the P eriodically every option and choose Continuously from the
list on the right. A new backup policy session will start as soon as the previous backup policy session
finishes.
3. In the Automatic retry section, define whether Veeam Agent for Linux must attempt to run the backup
policy again if the policy fails for some reason. Enter the number of attempts to run the policy and define
time intervals between them. If you select continuous backup, Veeam Ag ent for Linux will retry the policy
for the defined number of times without any time intervals between the policy runs.
447 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
NOTE
After you click Ap p ly at the Schedule step of the wizard, Veeam Backup & Replication will immediately
apply the backup policy to protected computers.
448 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 13. Review Backup Job Settings
At the Summary step of the wizard, complete the Veeam Agent policy configuration process.
Keep in mind that Veeam Backup & Replication does not immediately apply backup policy to computers included
in protection groups for pre-installed Veeam Agents. Veeam Agents installed on computers that are included in
these groups connect to Veeam Backup & Replication every 6 hours and get updated backup policy settings. If
you targeted a backup policy at the Veeam backup server and scheduled earlier than the next connection to
Veeam Backup & Replication, this backup policy will get updated backup policy se ttings at the next backup
policy session start. To learn more about protection groups for pre-installed Veeam Agents, see Protection
Group Types.
If you want to apply backup policy immediately, you must synchronize Veeam Agent with Veeam Backup &
Replication from the Veeam Agent computer side manually. To learn more, see Configuration.
449 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Policy for Unix Computers
To back up data of a computer protected with Veeam Agent for Oracle Solaris or Veeam Agent for IBM AIX, you
must configure a Veeam Agent backup policy in Veeam Backup & Replication. This backup policy will be applied
to Veeam Agent computers to create individual backup jobs. Using these jobs, Veeam Agents will perform
backup operations.
Before configuring a backup policy, check prerequisites. Then use the New Agent Backup Job wizard to define
settings for the backup policy.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers
that you plan to add to the Veeam Agent backup policy. To learn more, see Licensing Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the policy must be configured in advance.
• Protection groups that you want to add to the policy must be of the computers with pre -installed backup
agents type.You can also add protection groups of the individual computers and computers from CSV file
type. To learn more, see Protection Group Types.
• After you start managing a Veeam Agent computer with Veeam Backup & Replication, data backup for this
computer is performed by a backup job configured in Veeam Backup & Replication. Veeam Agent running
on the computer starts a new backup chain on a target location specified in the backup policy settings.
You cannot continue the existing backup chain that was created by Veeam Agent operating in the
standalone mode.
450 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• You cannot map a Veeam Agent backup policy configured in Veeam Backup & Replication to a Veeam
Agent backup chain created by a standalone Veeam Agent on a backup repository.
• Veeam Backup & Replication does not immediately apply backup policy to computers included in
protection groups for pre-installed Veeam Agents. Veeam Agents installed on computers that are included
in these groups connect to Veeam Backup & Replication every 6 hours and get updated backup policy
settings. If you targeted a backup policy at the Veeam backup server and scheduled it earlier than the next
connection to Veeam Backup & Replication, this backup policy will be updated on the Veeam Agent
computer at the next start of the backup session. To learn more about protection groups for pre -installed
Veeam Agents, see Protection Group Types.
Keep in mind, that you can immediately update settings of the backup policy from the Veeam Agent
computer. To learn more, see Deploying Veeam Agent for Unix.
451 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup policy for protected computers that run a Unix OS in one of the following
ways:
• Create a new backup policy — in this case, Veeam Backup & Replication will launch the New Agent Backup
Job wizard. You will be able to specify protection groups, individual Active Directory objects and Veeam
Agent computers to which the backup policy settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup policy — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup policy. You will also
be able to change the list of Veeam Agent computers to which the backup policy settings must apply at
the Computers step of the wizard.
• Add individual computers to a new backup policy — in this case, Veeam Backup & Replication will launch
the New Ag ent Backup Job wizard and add the selected computers to the backup policy. You will also be
able to change the list of Veeam Agent computers to which the backup policy settings must apply at the
Computers step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > Unix computers on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > Unix computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup policy and select Ad d to backup job > Unix > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup policy and click Ad d to Backup > Unix > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
policy. You can add other protection groups and individual computers to the policy later on, when you pass
through the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy and click Ad d to Backup > New job on the ribbon.
452 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
policy. You can add other computers and protection groups to the policy later on, when you pass through the
wizard steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup policy that is
already configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup
Job and Adding Protection Group to Backup Job.
453 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, click Nex t.
You do not need to select the job type and mode. Unix computers can be added only as servers and only to
Veeam Agent backup jobs managed by Veeam Agent.
454 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Policy Name and Description
At the Na me step of the wizard, specify a name and description for the backup policy.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the policy, date and time when the policy was created.
455 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers that you want to back
up.
You can add to the Veeam Agent backup policy one or more protection groups and individual computers added
to inventory in the Veeam Backup & Replication console. If Veeam Backup & Replication discovers a new
computer in a protection group after the Veeam Agent backup policy is created, Veeam Backup & Replication
will automatically update the policy settings to include the added computer.
NOTE
If you used the Ad d to backup job > Unix > New job option to launch the New Ag ent Backup Job wizard,
the P rotected computers list will already contain computers that you have selected to add to the policy.
You can remove some computers from the policy or add new computers to the policy, if necess ary.
To add protection groups and individual computers to the Veeam Agent backup policy:
1. Click Ad d .
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
456 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup. You can select
one of the following options:
• E ntire machine — select this option if you want to create a backup of all files and directories available on
the protected Unix computer.
Consider that in the Entire machine mode, Veeam Agent excludes network shared folders from the backup
scope. To back up network shared folders, use the Custom scope mode.
• Custom scope — select this option if you want to create a backup of individual directories on your
computer. With this option selected, you will pass to the Objects step of the wizard.
TIP
If you plan to back up a network shared folder, you must select the Custom scope option and add
this network shared folder as an individual object to the backup scope at the Ob jects step of the
wizard.
457 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you have chosen the Custom scope mode at the Backup Mode step
of the wizard.
At this step of the wizard, you must specify the backup scope — define what directories with files you want to
include in the backup. The specified backup scope settings will apply to all computers that are added to the
backup policy. If a specified directory does not exist on one or more computers in the policy, the policy will skip
such directory on those computers and back up existing ones.
2. In the Ad d Object window, type the path to a directory that you want to back up, for example,
/home/user01, and click OK.
3. Repeat steps 1–2 for all directories that you want to back up.
TIP
If you want to back up the root directory and specify / in the P a th to a directory field, Veeam Agent does
not automatically include remote mount points in the backup scope. To include remote mount points, you
need to specify paths to these mount points manually.
For example, you have a file system mounted to the /Library/Media directory. If you add / as an object
to the backup scope, Veeam Agent will not back up the mounted file system. To back up the root directory
and the mounted file system, add the following objects to the backup scope:
• /
• /Library/Media
458 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Configuring Filters
To include or exclude files of a specific type in/from the file-level backup, you can configure filters.
To configure a filter:
o In the Include masks field, specify file names and masks for file types that you want to back up, for
example, Report.pdf or *filename*. Veeam Agent will create a backup only for selected files.
Other files will not be backed up.
o In the E x clude masks field, specify file names and masks for file types that you do not want to back
up, for example, OldReports.tar.gz or *.odt. Veeam Agent will back up all files except files of
the specified type.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
Veeam Agent will include in the backup all files of the PDF format that do not contain draft in their names.
459 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Select Backup Destination
At the Destination step of the wizard, select a target location for backups created by Veeam Agents installed on
protected computers.
• Loca l storage — select this option if you want to save a backup on a removable storage device attached to
a protected computer or on a local drive of a protected computer. With this option selected, you will pass
to the Local Storage step of the wizard.
IMP ORTANT
It is recommended that you store backups in the external location like USB storage device or network
shared folder. You can also keep your backup files on the separate non-system local drive.
• Veeam backup repository — select this option if you want to save a backup in a backup repository
managed by a Veeam backup server. With this option selected, you will pass to the Backup Server step of
the wizard.
460 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Specify Backup Storage Settings
Specify backup storage settings for the backup policy at one of the following steps of the wizard:
• Local storage settings — if you have selected the Loca l storage option at the Destination step of the
wizard.
• Veeam backup repository settings — if you have selected the Veeam backup repository option at the
Destination step of the wizard.
1. In the Loca l folder field, type a path to a folder on a protected computer where backup files must be
saved. If the specified folder does not exist in the file system of a protected computer, Veeam Agent will
create this folder and save the resulting backup file to this fold er. If the volume on which the specified
folder must reside does not exist on a protected computer, Veeam Backup & Replication will not apply the
backup policy settings to this computer.
IMP ORTANT
USB storage devices formatted as FAT32 do not allow storing files larger than 4 GB in size. For this
reason, it is recommended that you do not use such USB storage devices as a backup target.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earliest restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
3. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
461 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. At the Backup Server step of the wizard, specify backup server settings .
2. At the Storage step of the wizard, select the Veeam backup repository .
In the DNS name or external IP address field, make sure that the name or IP address of the Veeam backup
server, on which you configure the Veeam Agent backup policy, is displayed. Do not specify the name or IP
address of another Veeam backup server. The specified DNS name or IP address must be resolvable from Veeam
Agent computers.
462 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Veeam Backup & Replication does not automatically update information about the backup server in the
backup policy settings after migration of the configuration database. After you migrate configuration data
to a new location, you must specify the name or IP address of the new backup server in the properties of all
backup policies configured in Veeam Backup & Replication.
1. From the Ba ckup repository list, select a backup repository where you want to store created backups.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earliest restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
3. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
463 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. If you want to archive backup files created with the backup job to a secondary destination (backup
repository or tape), select the Configure secondary backup destinations for this job check box. With this
option enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At
the Secondary Target step of the wizard, you can link the backup policy to the backup copy job or backup
to tape backup job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
464 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 9. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup policy:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
TIP
After you specify necessary settings for the Veeam Agent backup policy, you can save them as default
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup policy, Veeam Backup & Replication will automatically apply the default
settings to the new policy.
Backup Settings
To specify settings for a backup chain created with the backup policy:
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Storage — if you have selected to save backup files in a Veeam backup repository.
2. If you want to periodically create active full backups, select the Create active full backups periodically
check box.
3. Click Configure.
4. In the Schedule Settings window, use the Monthly on or W eekly options to define the schedule.
465 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Before scheduling periodic full backups, you must make sure that you have enough free space on the
target location.
Maintenance Settings
You can specify maintenance settings for a backup policy targeted at a Veeam backup repository. Maintenance
operations help make sure that the backup chain remains valid and consistent.
3. Select the Remove deleted items data after check box and specify the number of days for which you want
to keep the backup created with the backup policy in the target location.
If Veeam Agent does not create new restore points for the backup, the backup will remain in the target
location for the period that you have specified. When this period is over, the backup will be removed from
the target location.
466 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. Otherwise, the backup policy may not work as expected and
remove data that you still require.
Storage Settings
To specify storage settings for the backup policy:
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Storage — if you have selected to save backup files in a Veeam backup repository.
3. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme.
4. In the Storage optimization section, select what size of data blocks you plan to use: 4 MB, 1 MB, 512 KB,
256 KB. Veeam Agent will use data blocks of the chosen size to optimize the size of backup files and job
performance.
NOTE
If you change the storage optimization settings for the backup job, new settings will not have any
effect on previously created files in the chain. They will be applied to new files created after the
settings were changed.
To apply new storage optimization settings in backup jobs, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Replication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
467 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will display a
warning about it. For more information, see the Decrypting Data Without Password section in the Veeam
Backup & Replication User Guide.
NOTE
If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• Data encryption settings for Veeam Agent backup policies configured in Veeam Backup & Replication are
stored to the Veeam Backup & Replication database. For backup policies targeted at a Veeam backup
repository, all data encryption operations are performed in Veeam Backup & Replication, too. Encryption
settings are passed to a Veeam Agent computer only in case this computer is added to a backup policy
targeted at a local drive of a protected computer or at a network shared folder. Veeam Backup &
Replication performs this operation when applying the backup policy to a protected computer.
• If you change a password for data encryption for an existing backup policy targeted a t a Veeam backup
repository without changing other backup policy settings, the process of applying the backup policy to a
protected computer completes with a notification informing that the backup policy was not modified. This
happens because data encryption settings for managed Veeam Agents are saved to the Veeam Backup &
Replication database and are not passed to a Veeam Agent computer.
• If you enable or disable encryption for an existing Veeam Agent backup policy, during the next session
Veeam Agent will create a full backup file. The created full backup file and subsequent incremental
backup files in the backup chain will be encrypted with the specified password.
468 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Encryption is not retroactive. If you enable encryption for an existing backup policy, Veeam Agent will
encrypt the backup chain starting from the next restore point created with this policy.
• When you enable data encryption for a backup policy, Veeam Backup & Replication uses the specified
password to encrypt backups of all Veeam Agent computers added to the backup policy. A Veeam Agent
computer user can restore data from the backup of this computer without providing a password to decrypt
backup.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in
the Veeam Backup & Replication User Guide.
Notification Settings
You can specify email notification settings for the backup policy. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with backup policy statistics to a specified email address. The
report contains cumulative statistics for backup policy sessions performed for the last 24 -hour period on
computers to which the backup policy is applied.
NOTE
Email reports with backup policy statistics will be sent if you configure global email notification settings in
Veeam Backup & Replication. For more information, see the Configuring Global Email Notification Settings
section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the backup policy, Veeam Backup & Replication will send reports
with the backup policy statistics to email addresses specified in global email notification settings and email
addresses specified in the backup policy settings.
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Storage — if you have selected to save backup files in a Veeam backup repository.
3. Select the Send daily e-mail report to the following recipients check box and specify a recipient’s email
address in the field below. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the
email notification for the backup policy. Veeam Backup & Replication will send the report daily at the
specified time.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the backup policy, select Use g lobal notification settings. In this
case, Veeam Backup & Replication will apply to the backup policy global email notification settings
specified for the backup server. Veeam Backup & Replication will send the email report containing
backup policy statistics at 8:00 AM daily.
o To configure a custom notification for the backup policy, select Use custom notification settings
sp ecified below. You can specify the following notification settings:
469 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the backup policy) and %Issues% (number of machines in the backup policy that
have been processed with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the policy completes successfully, completes with a warning or fails.
5. In the Ba ckup monitoring section, select the W a rn me if no backups were created in the last <N> days
check box and specify a number of days. In this case, Veeam Backup & Replication will display a warning
message in a backup policy session statistics in case successful backups are not created for a specified
number of days.
470 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 10. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the Veeam Agent backup job to a backup to tape or
backup copy job. As a result, the backup job will be added as a source to the backup to tap e or backup copy job.
Backup files created with the backup job will be archived to tape or copied to the secondary backup repository
according to the secondary jobs schedule. For more information, see the Linking Backup Jobs to Backup Copy
Jobs and Linking Backup Jobs to Backup to Tape Jobs sections in the Veeam Backup & Replication User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup job to these jobs, Veeam Backup & Replication will
automatically update the linked jobs to define the Veeam Agent backup job as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup job. You can link several jobs to the backup job, for example, one backup to tape job and one
backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
471 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 11. Specify Guest Processing Settings
At the Guest Processing step of the wizard, you can enable the following guest OS processing settings for a
Veeam Agent backup job that includes Unix-based computers:
• File indexing
1. At the Guest Processing step, select the E na ble application-aware processing check box.
2. Click Ap p lications.
3. In the displayed list, select a protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the P rocessing Settings window, select the E na ble script execution check box.
5. In the P re-job script and P ost-job script fields, click Browse to choose executable files from a local folder
on the backup server.
472 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Veeam Agent supports scripts in the SH file format. During the backup job session, Veeam Backup & Replication
will upload the scripts to the /var/lib/veeam/scripts directory on each Veeam Agent computer added to
the job and execute them on these computers.
File Indexing
To specify file indexing options:
1. At the Guest Processing step of the wizard, select the E nable guest file system indexing check box.
3. In the displayed list, select the protection group or individual computer and click E d it.
To define custom settings for a computer added as a part of a protection group, you must include the
computer to the list as a standalone object. To do this, click Ad d and choose the computer whose settings
you want to customize. Then select the computer in the list and define the necessary settings.
4. In the Ind exing Settings window, select Ind ex everything if you want to index all files within the backup
scope that you have specified at the Select Backup Mode step of the wizard.
473 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
You cannot specify a custom indexing scope for Unix computers. For a file-level backup job that processes
Unix computers, only the Ind ex everything option is available.
474 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 12. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup job manually to create backup.
o To run the job at specific time daily, on defined week days or with specific periodicity, select Da ily at
this time. Use the fields on the right to configure the necessary schedule.
o To run the job once a month on specific days, select Monthly at this time. Use the fields on the right
to configure the necessary schedule.
o To run the job repeatedly throughout a day with a specific time interval, select P eriodically every. In
the field on the right, select the necessary time unit: Hours or Minutes. Click Schedule and use the
time table to define the permitted time window for the job. In the Sta rt time within an hour field,
specify the exact time when the job must start.
▪ The defined interval always starts at 12:00 AM. For example, if you configure to run a job with a
4-hour interval, the job will start at 12:00 AM, 4:00 AM, 8:00 AM, 12:00 PM, 4:00 PM and so
on.
▪ If you define permitted hours for the job, after the denied interval is over, the job will start
immediately and then run by the defined schedule.
For example, you have configured a job to run with a 2-hour interval and defined permitted hours
from 9:00 AM to 5:00 PM. According to the rules above, the job will first run at 9:00 AM, when the
denied period is over. After that, the job will run at 10:00 AM, 12:00 PM, 2:00 PM and 4:00 PM.
To run the job continuously, select the P eriodically every option and choose Continuously from the
list on the right. A new backup job session will start as soon as the previous backup job session
finishes.
475 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. In the Automatic retry section, define whether Veeam Agent must attempt to run the backup job again if
the job fails for some reason. Enter the number of attempts to run the job and define time intervals
between them. If you select continuous backup, Veeam Agent for Unix will retry the job for the defined
number of times without any time intervals between the job runs.
476 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 13. Review Backup Job Settings
At the Summary step of the wizard, complete the Veeam Agent backup policy configuration process.
Keep in mind that Veeam Backup & Replication does not apply backup policy to Unix computers immediately.
Veeam Agents installed on Unix computers connect to Veeam Backup & Replication every 6 hours and get
updated backup policy settings. If you targeted a backup policy at the Veeam backup server and scheduled it
earlier than the next connection to Veeam Backup & Replication, this backup policy will get updated backup
policy settings at the next backup policy session start.
If you want to apply backup policy immediately, you must synchronize Veeam Agent with Veeam Backup &
Replication from the Veeam Agent computer side manually. To learn more, see Configuration.
477 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating Policy for Mac Computers
To back up data of a computer protected with Veeam Agent for Mac, you must configure a Veeam Agent backup
policy in Veeam Backup & Replication. This backup policy will be applied to Veeam Agent computers to create
individual backup jobs. Using these jobs, Veeam Agents will perform backup operations.
Before configuring a backup policy, check prerequisites. Then use the New Agent Backup Job wizard to define
settings for the backup policy.
• The Veeam Backup & Replication license must have a sufficient number of instances to process servers and
workstations that you plan to add to the Veeam Agent backup policy. To learn more, see Licensing
Requirements.
• The target location where you plan to store backup files must have enough free space.
• Protection groups that you want to add to the policy must be configured in advance.
• Protection groups that you want to add to the job must be of the computers with pre-installed backup
agents type. To learn more, see Protection Group Types.
• [For backup jobs targeted at the cloud repository] The Veeam Cloud Connect service provider must be
added in the Veeam backup console.
• After you start managing a Veeam Agent computer with Veeam Backup & Replication, data backup for this
computer is performed by a backup job configured in Veeam Backup & Replication. Veeam Agent running
on the computer starts a new backup chain on a target location specified in the backup policy settings.
You cannot continue the existing backup chain that was created by Veeam Agent operating in the
standalone mode.
478 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• You cannot map a Veeam Agent backup policy configured in Veeam Backup & Replication to a Veeam
Agent backup chain created by a standalone Veeam Agent on a b ackup repository.
• Veeam Backup & Replication does not immediately apply backup policy to computers included in
protection groups for pre-installed Veeam Agents. Veeam Agents installed on computers that are included
in these groups connect to Veeam Backup & Replication every 6 hours and get updated backup policy
settings. If you targeted a backup policy at the Veeam backup server and scheduled it earlier than the next
connection to Veeam Backup & Replication, this backup policy will be updated on the Veeam Agent
computer at the next start of the backup session. To learn more about protection groups for pre -installed
Veeam Agents, see Protection Group Types.
Keep in mind, that you can immediately update settings of the backup policy from the Veeam Agent
computer. To learn more, see Deploying Veeam Agent for Mac.
479 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch New Agent Backup Job Wizard
You can create a Veeam Agent backup policy for protected computers that run a macOS in one of the following
ways:
• Create a new backup policy — in this case, Veeam Backup & Replication will launch the New Agent Backup
Job wizard. You will be able to specify protection groups, individual Active Directory objects and Veeam
Agent computers to which the backup policy settings must apply at the Computers step of the wizard.
• Add a protection group to a new backup policy — in this case, Veeam Backup & Replication will launch the
New Agent Backup Job wizard and add the selected protection group to the backup policy. You will also
be able to change the list of Veeam Agent computers to which the backup policy settings must apply at
the Computers step of the wizard.
• Add individual computers to a new backup policy — in this case, Veeam Backup & Replication will launch
the New Ag ent Backup Job wizard and add the selected computers to the backup policy. You will also be
able to change the list of Veeam Agent computers to which the backup policy settings must apply at the
Computers step of the wizard.
• Open the Home view. Select the Job s node and click Ba ckup Job > Ma c computer on the ribbon.
• Open the Home view. Right-click the Job s node and select Ba ckup > Ma c computer.
• Open the Inventory view. In the P hy sical Infrastructure node, right-click the protection group that you
want to add to the backup policy and select Ad d to backup job > Ma c > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, select the protection group that you want to
add to the backup policy and click Ad d to Backup > Ma c > New job on the ribbon.
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the protection group to the
policy. You can add other protection groups and individual computers to the policy later on, when you pass
through the wizard steps.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy, right-click the selected computer and select Ad d to backup job > New job.
• Open the Inventory view. In the P hy sical Infrastructure node, click the protection group whose computers
you want to add to the backup policy. In the working area, select one or more computers that you want to
add to the policy and click Ad d to Backup > New job on the ribbon.
480 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Veeam Backup & Replication will start the New Agent Backup Job wizard and add the selected computers to the
policy. You can add other computers and protection groups to the policy later on, when you pass through the
wizard steps.
TIP
• You can press and hold the [Ctrl] key to select multiple computers at once.
• You can add an individual computer or protection group to a Veeam Agent backup policy that is
already configured in Veeam Backup & Replication. To learn more, see Adding Computers to Backup
Job and Adding Protection Group to Backup Job.
481 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 2. Select Job Mode
At the Job Mode step of the wizard, in the Ty p e field, select the type of protected computers whose data you
want to back up with Veeam Agents.
The selected type defines what settings will be available for the configured backup policy. You can select one of
the following computer types:
• W orkstation — select this option if you want to back up data on macOS workstations or laptops. This
option is suitable for computers that reside in a remote location and may have limited connection to the
backup server.
For backup jobs that process workstations, Veeam Backup & Replication offers settings similar to the job
settings available in Veeam Agent operating in the Workstation mode. To learn more, see the Product
Editions section in the Veeam Agent for Mac User Guide.
• Server — select this option if you want to back up data on macOS servers. This option is suitable for
computers that have permanent connection to the backup server.
For backup jobs that process servers, Veeam Backup & Replication offers settings similar to the job
settings available in Veeam Agent operating in the Server mode. To learn more, see the Product Editions
section in the Veeam Agent for Mac User Guide.
You do not need to select the job mode. Mac computers can be added only to Veeam Agent backup jobs
managed by Veeam Agent.
482 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Policy Name and Description
At the Na me step of the wizard, specify a name and description for the backup policy.
2. In the Description field, provide a description for future reference. The default description contains
information about the user who created the policy, date and time when the policy was created.
483 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 4. Select Computers to Back Up
At the Comp uters step of the wizard, select protection groups and individual computers that you want to back
up.
You can add to the Veeam Agent backup policy one or more protection groups and individual computers added
to inventory in the Veeam Backup & Replication console. If Veeam Backup & Replication discovers a new
computer in a protection group after the Veeam Agent backup policy is created, Veeam Backup & Replication
will automatically update the policy settings to include the added computer.
NOTE
If you used the Ad d to backup job > Ma c > New job option to launch the New Agent Backup Job wizard, the
P rotected computers list will already contain computers that you have selected to add to the policy. You
can remove some computers from the policy or add new computers to the policy, if necessary.
To add protection groups and individual computers to the Veeam Agent backup p olicy:
1. Click Ad d .
2. In the Select Objects window, select one or more protection groups and computers in the list and click OK.
You can press and hold the [Ctrl] key to select multiple objects at once.
To quickly find the necessary object, use the search field at the bottom of the Select Objects window.
484 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Select Backup Mode
At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup. You can select
one of the following options:
• User d ata — select this option if you want to create a backup of the Users folder that contains the Home
folders of all users. With this option selected, you will pass to the Destination step of the wizard.
To include user data residing on an external USB drive, select the Include external USB drives check box.
The USB drive must be mounted to a location within the Users folder. You can include user data from one
or more USB drives connected to the Veeam Agent computer at the time when the backup job starts on
the protected computer.
NOTE
When you select User data mode, Veeam Agent excludes network shared folders from the backup
scope. To back up a network shared folder, you must select the Custom scope option and add this
network shared folder as an individual object to the backup scope at the Ob jects step of the wizard.
• Custom scope — select this option if you want to create a backup of individual folders on your computer.
With this option selected, you will pass to the Objects step of the wizard.At the Ba ckup Mode step of the
wizard, select the mode in which you want to create a backup.
485 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 6. Specify Backup Scope Settings
The Ob jects step of the wizard is available if you have chosen the Custom scope mode at the Backup Mode step
of the wizard.
At this step of the wizard, you must specify the backup scope — define what folders with files you want to
include in the backup. The specified backup scope settings will apply to all computers that are added to the
backup policy. If a specified folder does not exist on one or more computers in the policy, the policy will skip
such folder on those computers and back up existing ones.
To specify the backup scope, in the Ob jects to backup list, select check boxes next to necessary objects. You can
include the following data in the backup:
• Include data on external USB drives — data residing on an external USB drive. The USB drive must be
mounted to a location within the Users folder. You can include user data from one or more USB drives
connected to the Veeam Agent computer at the time when the backup job s tarts on the protected
computer.
• Personal files — data related to user profiles. With this option enabled, Veeam Backup & Replication will
include in the backup scope settings and data related to Veeam Agent computer user profiles. To learn
more, see the Protecting User Profiles Data section in the Veeam Agent for Mac User Guide.
• Individual file system objects — directories, mount points, and volumes of a protected computer.
To specify individual folders to back up:
1. Select the The following file system objects check box and click Ad d .
2. In the Ad d Object window, type the path to a folder, mount point folder, or volume that you want to back
up, for example, /Users/Shared/ or /Users/Administrator/Documents/, and click OK.
3. Repeat steps 1–2 for all items that you want to back up.
486 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
If you want to back up the root folder and specify / in the P a th to a directory field, Veeam Agent does not
automatically include remote mount points in the backup scope. To include remote mount points, you need
to specify paths to these mount points manually.
For example, you have a file system mounted to the /Library/Media folder. If you add / as an object to
the backup scope, Veeam Agent will not back up the mounted file system. To back up the root folder and
the mounted file system, add the following objects to the backup scope:
• /
• /Library/Media
Configuring Filters
To include or exclude files of a specific type in/from the file-level backup, you can configure filters.
To configure a filter:
o In the Include masks field, specify file names and masks for file types that you want to back up, for
example, Report.pdf or *filename*. Veeam Agent will create a backup only for selected files.
Other files will not be backed up.
487 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
o In the E x clude masks field, specify file names and masks for file types that you do not want to back
up, for example, OldReports.tar.gz or *.odt. Veeam Agent will back up all files except files of
the specified type.
3. Click Ad d .
4. Repeat steps 2–3 for each mask that you want to add.
You can use a combination of include and exclude masks. Note that exclude masks have a higher priority than
include masks. For example, you can specify masks in the following way:
Veeam Agent will include in the backup all files of the PDF format that do not contain draft in their names.
488 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Select Backup Destination
At the Destination step of the wizard, select a target location for backups created by Veeam Agents installed on
protected computers.
• Loca l storage — select this option if you want to save a backup on a removable storage device attached to
a protected computer or on a local drive of a protected computer. With this option selected, you will pass
to the Local Storage step of the wizard.
IMP ORTANT
It is recommended that you store backups in the external location like USB storage device or network
shared folder. You can also keep your backup files on the separate non-system local drive.
• Sha red folder — select this option if you want to save a backup in an SMB network shared folder. With this
option selected, you will pass to the Shared folder step of the wizard.
• Veeam backup repository — select this option if you want to save a backup in a backup repository
managed by a Veeam backup server. With this option selected, you will pass to the Backup Server step of
the wizard.
• Veeam Cloud Connect repository — select this option if you want to save a backup on a cloud repository
exposed to you by the Veeam Cloud Connect service provider. With this option selected, you will pass to
the Storage step of the wizard.
489 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Specify Backup Storage Settings
Specify backup storage settings for the backup policy at one of the following steps of the wizard:
• Local storage settings — if you have selected the Loca l storage option at the Destination step of the
wizard.
• Shared folder settings — if you have selected the Sha red folder option at the Destination step of the
wizard.
• Veeam backup repository settings — if you have selected the Veeam backup repository option at the
Destination step of the wizard.
• Cloud repository settings — if you have selected the Veeam Cloud Connect repository option at the
Destination step of the wizard.
1. In the Loca l folder field, type a path to a folder on a protected computer where backup files must be
saved. If the specified folder does not exist in the file system of a protected computer, Veeam Agent will
create this folder and save the resulting backup file to this folder. If the volume on which the specified
folder must reside does not exist on a protected computer, Veeam Backup & Replication will not apply the
backup policy settings to this computer.
IMP ORTANT
USB storage devices formatted as FAT32 do not allow storing files larger than 4 GB in size. For this
reason, it is recommended that you do not use such USB storage devices as a backup target.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earliest restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
3. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
490 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. In the Sha red folder field, specify a UNC name of the SMB network shared folder. The UNC name always
starts with two back slashes (\\).
Consider that Veeam Backup & Replication does not support the NFS shares for Mac computers.
2. If the SMB network shared folder requires authentication, select the This share requires access credentials
check box and select from the list a user account that has access permissions on this shared folder. If you
have not set up credentials beforehand, click the Ma nage accounts link or click Ad d on the right to add
credentials. The user name must be specified in the DOMAIN\USERNAME format.
3. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earliest restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
491 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
1. At the Backup Server step of the wizard, specify backup server settings .
2. At the Storage step of the wizard, select the Veeam backup repository .
In the DNS name or external IP address field, make sure that the name or IP address of the Veeam backup
server, on which you configure the Veeam Agent backup policy, is displayed. Do not specify the name or IP
address of another Veeam backup server. The specified DNS name or IP address must be resolvable from Veeam
Agent computers.
492 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Veeam Backup & Replication does not automatically update information about the backup server in the
backup policy settings after migration of the configuration database. After you migrate configuration data
to a new location, you must specify the name or IP address of the new backup server in the properties of all
backup policies configured in Veeam Backup & Replication.
1. From the Ba ckup repository list, select a backup repository where you want to store created backups.
When you select a backup repository, Veeam Backup & Replication automatically checks how much free
space is available on the backup repository.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earlies t restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
3. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
Keep in mind that to use the GFS retention policy, you must set Veeam Agent to create full backups. To
learn more, see Backup Settings.
493 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. If you want to archive backup files created with the backup job to a secondary destination (backup
repository or tape), select the Configure secondary backup destinations for this job check box. With this
option enabled, the New Ag ent Backup Job wizard will include an additional step — Secondary Target. At
the Secondary Target step of the wizard, you can link the backup policy to the backup copy job or backup
to tape backup job.
You can enable this option only if a backup copy job or backup to tape job is already configured on the
backup server.
5. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
NOTE
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam backup repository.
NOTE
Keep in mind that FQDN or IP addresses of Veeam Agent computers that you back up to the cloud
repository will be visible to the Veeam Cloud Connect service provider. To learn more, see Before You
Begin.
494 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Specify settings for the cloud repository:
1. From the Ba ckup repository list, select a cloud repository where you want to store created backups. The
Ba ckup repository list displays cloud repositories allocated to your tenant account by the Veeam Cloud
Connect service provider. When you select a cloud repository, Veeam Backup & Replication automatically
checks how much free space is available on the repository.
2. In the Restore points to keep on disk field, specify the number of restore points for which you want to
store backup files in the target location. By default, Veeam Agent keeps backup files created for 7 latest
restore points. After this number is exceeded, Veeam Agent will remove the earliest restore points from
the backup chain. To learn more, see Short-Term Retention Policy.
3. You can apply GFS (Grandfather-Father-Son) retention scheme to the backup policy. To specify GFS
retention, select the Keep certain full backups longer for archival purposes check box and click Configure.
In the Configure GFS window, specify how weekly, monthly and yearly full backups must be retained. To
learn more, see the Long-Term Retention Policy (GFS) section in the Veeam Backup & Replication User
Guide.
4. Click Ad vanced to specify advanced settings for the backup policy. To learn more, see Specify Advanced
Backup Settings.
IMP ORTANT
You must enable backup file encryption in the backup job storage settings if you back up data to the
Veeam Data Cloud Vault storage added as a Veeam Cloud Connect repository.
495 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 9. Specify Advanced Backup Settings
In the Ad vanced Settings window, specify advanced settings for the Veeam Agent backup policy:
• Backup settings
• Maintenance settings
• Storage settings
• Notification settings
TIP
After you specify necessary settings for the Veeam Agent backup policy, you can save them as default
settings. To do this, click Sa ve as Default at the bottom left corner of the Ad vanced Settings window.
When you create a new backup policy, Veeam Backup & Replication will automatically apply the default
settings to the new policy.
Backup Settings
To specify settings for a backup chain created with the backup policy:
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
2. If you want to periodically create active full backups, select the Create active full backups periodically
check box and click Configure to define scheduling settings.
496 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
Before scheduling periodic full backups, you must make sure that you have enough free space on the
target location.
Maintenance Settings
You can specify maintenance settings for a backup policy targeted at a Veeam backup repository. Maintenance
operations help make sure that the backup chain remains valid and consistent.
3. Select the Remove deleted items data after check box and specify the number of days for which you want
to keep the backup created with the backup policy in the target location.
If Veeam Agent does not create new restore points for the backup, the backup will remain in the target
location for the period that you have specified. When this period is over, the backup will be removed from
the target location.
By default, the deleted items data retention period is 30 days. Do not set the deleted items retention
period to 1 day or a similar short interval. Otherwise, the backup policy may not work as expected and
remove data that you still require.
497 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. If you selected object storage as a target for your backup, Veeam Backup & Replication will display the
setting that allows you to schedule a regular backup health check. To learn more, see Scheduling Health
Check.
3. Use the Monthly on or W eekly on selected days options to define the schedule for the health check of the
backup in the repository.
Storage Settings
To specify storage settings for the backup policy:
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
498 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. Click the Storage tab.
3. From the Compression level list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme.
4. In the Storage optimization section, select what size of data blocks you plan to use: 4 MB, 1 MB, 512 KB,
256 KB. Veeam Agent will use data blocks of the chosen size to optimize the size of backup files and job
performance.
NOTE
If you change the storage optimization settings for the backup job, new settings will not have any
effect on previously created files in the chain. They will be applied to new fil es created after the
settings were changed.
To apply new storage optimization settings in backup jobs, you must create an active full backup
after you change storage optimization settings. Veeam Backup & Replication will use the new block
size for the active full backup and subsequent backup files in the backup chain. To learn about the
active full backup, see Performing Active Full Backup.
5. To encrypt the content of backup files, select the E na ble backup file encryption check box. In the
P a ssword field, select a password that you want to use for encryption. If you have not created the
password beforehand, click Ad d or use the Ma nage passwords link to specify a new password. For more
information, see the Password Manager section in the Veeam Backup & Replication User Guide.
If the backup server is not connected to Veeam Backup Enterprise Manager, you will not be able to restore
data from encrypted backups in case you lose the password. Veeam Backup & Replication will display a
warning about it. For more information, see the Decrypting Data Without Password section in the Veeam
Backup & Replication User Guide.
499 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you plan to encrypt the content of backup files, consider the limitations listed in the Data
Encryption Limitations subsection.
• You must encrypt the backup job if you want to back up data to the Veeam Data Vault
storage.
• Data encryption settings for Veeam Agent backup policies configured in Veeam Backup & Replication are
stored to the Veeam Backup & Replication database. For backup policies targeted at a Veeam backup
repository, all data encryption operations are performed in Veeam Backup & Replication, too. Encryption
settings are passed to a Veeam Agent computer only in case this computer is added to a backup policy
targeted at a local drive of a protected computer or at an SMB network shared folder. Veeam Backup &
Replication performs this operation when applying the backup policy to a protected computer.
• If you change a password for data encryption for an existing backup policy targeted at a Veeam backup
repository without changing other backup policy settings, the process of applying the backup policy to a
protected computer completes with a notification informing that the backup policy was not modified. This
happens because data encryption settings for managed Veeam Agents are saved to the Veeam Backup &
Replication database and are not passed to a Veeam Agent computer.
• If you enable or disable encryption for an existing Veeam Agent backup policy, during the next sessio n
Veeam Agent will create a full backup file. The created full backup file and subsequent incremental
backup files in the backup chain will be encrypted with the specified password.
500 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Encryption is not retroactive. If you enable encryption for an existing backup policy, Veeam Agent will
encrypt the backup chain starting from the next restore point created with this policy.
• When you enable data encryption for a backup policy, Veeam Backup & Replication uses the specified
password to encrypt backups of all Veeam Agent computers added to the backup policy. A Veeam Agent
computer user can restore data from the backup of this computer without providing a password to decrypt
backup. To restore data from a backup of another computer in this backup policy, a user must provide a
password specified in the backup policy settings.
This scenario differs from the same scenario in earlier versions of Veeam Backup & Replication where all
backups created for Veeam Agent computers in the backup policy could be accessed from any computer in
the backup policy without providing a password.
To learn more about data encryption in Veeam Backup & Replication, see the Data Encryption section in the
Veeam Backup & Replication User Guide.
Notification Settings
You can specify email notification settings for the backup policy. If you enable notification settings, Veeam
Backup & Replication will send a daily email report with backup policy statistics to a specified email address. The
report contains cumulative statistics for backup policy sessions performed for the last 24 -hour period on
computers to which the backup policy is applied.
NOTE
Email reports with backup policy statistics will be sent if you configure global email notification settings in
Veeam Backup & Replication. For more information, see the Configuring Global Email Notification Settings
section in the Veeam Backup & Replication User Guide.
After you enable notification settings for the backup policy, Veeam Backup & Replicationwill send reports
with the backup policy statistics to email addresses specified in global email notification settings and email
addresses specified in the backup policy settings.
o Loca l Storage — if you have selected to save backup files on a local storage of a Veeam Agent
computer.
o Sha red Folder — if you have selected to save backup files in a network shared folder.
o Storage — if you have selected to save backup files in a Veeam backup repository or cloud repository.
3. Select the Send daily e-mail report to the following recipients check box and specify a recipient’s email
address in the field below. You can enter several addresses separated by a semicolon.
4. In the Send daily summary at field, specify the time when Veeam Backup & Replication must send the
email notification for the backup policy. Veeam Backup & Replication will sent the report daily at the
specified time.
5. You can choose to use global notification settings or specify custom notification settings.
o To receive a typical notification for the backup policy, select Use g lobal notification settings. In this
case, Veeam Backup & Replication will apply to the backup policy global email notification settings
specified for the backup server. Veeam Backup & Replication will send the email report containing
backup policy statistics at 8:00 AM daily.
501 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
o To configure a custom notification for the backup policy, select Use custom notification s ettings
sp ecified below. You can specify the following notification settings:
▪ In the Sub ject field, specify a notification subject. You can use the following variables in the
subject: %Time% (completion time), %JobName%, %JobResult%, %ObjectCount% (number of
machines in the backup policy) and %Issues% (number of machines in the backup policy that
have been processed with the Warning or Failed status).
▪ Select the Notify on success, Notify on warning and Notify on error check boxes to receive email
notification if the policy completes successfully, completes with a warning or fails.
5. In the Ba ckup monitoring section, select the W a rn me if no backups were created in the last <N> days
check box and specify a number of days. In this case, Veeam Backup & Replication will display a warning
message in a backup policy session statistics in case successful backups are not created for a specified
number of days.
502 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 10. Specify Secondary Target
The Secondary Target step of the wizard is available if you have enabled the Configure secondary d estinations
for this job option at the Storage step of the wizard.
At the Secondary Target step of the wizard, you can link the Veeam Agent backup job to a backup to tape or
backup copy job. As a result, the backup job will be added as a source to the backup to tape or backup copy job.
Backup files created with the backup job will be archived to tape or copied to the secondary backup repository
according to the secondary jobs schedule. For more information, see Linking Backup Jobs to Backup Copy Jobs
and Linking Backup Jobs to Backup to Tape Jobs in the Veeam Backup & Replication User Guide.
The backup to tape job or backup copy job must be configured beforehand. You can create these jobs with an
empty source. When you link the Veeam Agent backup job to these jobs , Veeam Backup & Replication will
automatically update the linked jobs to define the Veeam Agent backup job as a source for these jobs.
To link jobs:
1. Click Ad d .
2. From the jobs list, select a backup to tape or backup copy job that must be linked to the Veeam Agent
backup job. You can link several jobs to the backup job, for example, one backup to tape job and one
backup copy job. To quickly find the job, use the search field at the bottom of the wizard.
503 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 11. Specify Backup Schedule
At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
Backup job scheduling options differ depending on the job mode that you have selected at the Job Mode step of
the wizard:
1. Select the Da ily at check box and use the fields on the right to specify time and days when the backup job
must start:
o Everyday — select this option to start the job at specific time daily.
o On weekdays — select this option to start the job at specific time on weekdays.
o On these days — select this option to start the job at specific time on selected days.
504 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To specify the job schedule:
1. Select the Run the job automatically check box. If this check box is not selected, you will have to start the
backup job manually to create backup.
o To run the job at specific time daily, on defined week days or with specific periodicity, select Da ily at
this time. Use the fields on the right to configure the necessary schedule.
o To run the job once a month on specific days, select Monthly at this time. Use the fields on the right
to configure the necessary schedule.
o To run the job repeatedly throughout a day with a specific time interval, select P eriodically every. In
the field on the right, select the necessary time unit: Hours or Minutes.
3. In the Automatic retry section, define whether Veeam Agent must attempt to run the backup job again if
the job fails for some reason. Enter the number of attempts to run the job and define time intervals
between them. If you select continuous backup, Veeam Agent for Mac will retry the job for the defined
number of times without any time intervals between the job runs.
505 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 12. Review Backup Job Settings
At the Summary step of the wizard, complete the Veeam Agent backup policy configuration process.
Keep in mind that Veeam Backup & Replication does not apply backup policy to Mac computers immediately.
Veeam Agents installed on Mac computers connect to Veeam Backup & Replication every 6 hours and get
updated backup policy settings. If you targeted a backup policy at the Veeam backup server and scheduled it
earlier than the next connection to Veeam Backup & Replication, this backup policy will get updated backup
policy settings at the next backup policy session start.
If you want to apply backup policy immediately, you must synchronize Veeam Agent with Veeam Backup &
Replication from the Veeam Agent computer side manually. To learn more, see Configuration.
506 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Managing Veeam Agent Backup Jobs
You can use the Veeam Backup & Replication console to perform the following operations with a Veeam Agent
backup job managed by the backup server:
507 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Starting and Stopping Veeam Agent Backup Job
You can start a Veeam Agent backup job manually, for example, if you want to create an additional restore point
in the backup chain and do not want to change the job schedule. You can also stop a job, for example, if
processing of a Veeam Agent computer is about to take long, and you do not want the job to produce workload
on the production environment during business hours.
Starting Jobs
To start a job:
3. In the working area, select the Veeam Agent backup job and click Sta rt on the ribbon or right-click the job
and select Sta rt.
Stopping Jobs
You can stop a Veeam Agent backup job in one of the following ways:
• Stop job immediately. In this case, Veeam Backup & Replication will produce a new restore point only for
those computers in the job that have already been processed by the time you stop the job.
• Stop job gracefully. In this case, Veeam Backup & Replication will produce a new restore point only for
those computers in the job that have already been processed and for computers that are b eing processed
at the moment.
3. In the working area, select the Veeam Agent backup job and click Stop on the ribbon or right-click the job
and select Stop . In the displayed window, click Immediately.
508 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. In the working area, right-click the job and select Stop . In the displayed window, click Gra cefully.
509 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Retrying Veeam Agent Backup Job
You can manually retry a Veeam Agent backup job configured in Veeam Backup & Replication if the job failed
during the previous job session. When you retry a Veeam Agent backup job, Veeam Backup & Replication
processes only those computers in the job that were not processed successfully during the previous job session.
To retry a job:
3. In the working area, select the Veeam Agent backup job and click Retry on the ribbon or right-click the job
and select Retry.
TIP
You can also retry a backup job for an individual computer added to this job. To learn more, see Retrying
Job for Individual Computer.
510 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
4. In the bottom part of Veeam Backup & Replication, find the list of computers that are processed by the
selected backup job. In the list, right-click the computer with the Failed status and click Retry.
Keep in mind that you will be able to launch retry for another computer in the same job only after retry
finishes for the selected computer.
511 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Performing Active Full Backup
You can create an ad-hoc full backup — active full backup, and add it to the backup chain on the backup
repository. The active full backup resets the backup chain. All subsequent incremental backups use the active
full backup as a starting point. The previously used full backup will remain on the backup repository until it is
removed from the backup chain according to the retention policy.
3. In the working area, select the Veeam Agent backup job and click Active Full on the ribbon or right-click
the job and select Active Full.
TIP
You can also create a full backup of an individual computer added to the backup job. To learn more, see
Performing Active Full Backup for Individual Computer.
512 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. In the bottom part of Veeam Backup & Replication, find the list of computers that are processed by the
selected backup job. In the list, right-click the computer and click Active full.
o You will be able to create an active full backup for another computer in the same job only after active
full backup is created for the selected computer.
513 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Editing Veeam Agent Backup Job Settings
You can edit Veeam Agent backup jobs configured in Veeam Backup & Replication at any time. For example, you
may want to edit a backup job to change the backup scope, target location or job scheduling settings.
NOTE
• You cannot change the type of protected computers added to the job and the job mode (that is,
change a Veeam Agent backup job to a backup policy and vice versa).
• [For Veeam Agent backup jobs for Linux computers] You cannot change the backup mode from file -
level to volume-level and vice versa.
3. In the working area, select the job and click E d it on the ribbon or right-click the job and select E d it.
4. Complete the steps of the E d it Agent Backup Job wizard to change the job settings as required.
514 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Enabling and Disabling Veeam Agent Backup Job
You can temporary disable Veeam Agent backup jobs configured in Veeam Backup & Replication. When you
disable a job, Veeam Backup & Replication does not start the job by the specified schedule. You can start a
disabled job manually at any time you need. You can also enable a disabled job at any time.
To disable a job:
3. In the working area, select the job and click Disable on the ribbon or right-click the job and select Disable.
To enable a disabled job, select it in the list and click Disable on the ribbon once again.
515 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Cloning Veeam Agent Backup Job
You can clone Veeam Agent backup jobs configured in Veeam Backup & Replication. For example, you may want
to configure a Veeam Agent backup job that will be used as a ‘job template’, and use this job to create multiple
jobs with similar settings.
3. In the working area, select the job and click Clone on the ribbon or right-click the job and select Clone.
4. After a job is cloned, you can edit all its settings, including the job name.
516 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Removing Veeam Agent Backup Job
You can permanently remove a Veeam Agent backup job from Veeam Backup & Replication. When you remove a
job, Veeam Agent backups created by this job remain intact on the backup repository. In the Veeam Backup &
Replication console, such backups are displayed in the Home view, under the Ba ckups > Orphaned node in the
inventory pane.
When you remove a backup job, Veeam Backup & Replication does not delete Veeam Agent from computers
protected by this backup job.
To remove a job:
3. In the working area, select the Veeam Agent backup job and click Delete on the ribbon or right-click the
job and select Delete.
517 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Managing Veeam Agent Backup Policies
You can use the Veeam Backup & Replication console to perform the following operations with a Veeam Agent
backup job managed by Veeam Agent (a Veeam Agent backup policy):
• Start and stop Veeam Agent backup jobs on computers added to the backup policy.
518 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Applying Backup Policy to Protected Computers
To configure individual Veeam Agent backup jobs on protected computers added to a backup policy, Veeam
Backup & Replication applies settings of the backup policy to these computers. This operation is performed
automatically at the time when the backup policy is created and at the process of automatic protection group
rescan. You can also apply backup policy settings manually at any time. This may be required, for example, in
case one or more protected computers could not be accessed over the network at the time when the backup
policy was created.
3. In the working area, select the backup policy and click Ap p ly Configuration on the ribbon or right-click the
policy and select Ap p ly configuration.
Keep in mind that Veeam Backup & Replication does not apply backup policy to protection groups for pre -
installed Veeam Agents and their members immediately. Veeam Agents installed on computers included in
such protection groups connect to Veeam Backup & Replication every 6 hours and get updated backup
policy settings. If a backup policy is targeted at the Veeam backup server and the backup policy session is
scheduled earlier than the next connection to Veeam Backup & Replication, this backup policy will get
updated backup policy settings at the next session start.
TIP
If necessary, you can synchronize Veeam Agent with Veeam Backup & Replication running a
command from the Veeam Agent computer. To learn more, see Backup Policy Application Methods.
519 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Starting and Stopping Backup
You can manually start backup on Veeam Agent computers added to the backup policy, for example, if you want
to create an additional restore point in the backup chain and do not want to change the backup schedule. You
can also stop the backup process, for example, if processing of a Veeam Agent computer is about to take long,
and you do not want the backup process to produce workload on the production environment during business
hours.
When you start the backup process for a backup policy, Veeam Backup & Replication applies the policy to Veeam
Agent computers and sends a command to start backup jobs on these computers.
When you stop the backup process for a backup policy, Veeam Backup & Replication does not apply the policy to
Veeam Agent computers and immediately sends a command to stop backup jobs on these computers.
Veeam Backup & Replication does not check whether connection to Veeam Agent computers is active at the
time when the command is sent. Keep in mind that the start or stop operation will be performed only on those
computers that received the command from the backup server.
Keep in mind that you cannot start or stop the backup process for protection groups for pre -installed Veeam
Agents and their members. Veeam Agent computers included in such protection groups will be skipped and
Veeam Backup & Replication will display a warning message in a backup policy session statistics.
Starting Backup
To start backup on Veeam Agent computers added to the backup policy:
3. In the working area, select the backup policy and click Sta rt on the ribbon or right-click the job and select
Sta rt.
TIP
You can also start a Veeam Agent backup job directly on a protected computer from the Veeam Agent user
interface.
Stopping Backup
To stop backup on Veeam Agent computers added to the backup policy:
520 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. In the working area, select the backup policy and click Stop on the ribbon or right-click the job and select
Stop . In the displayed window, click Y es .
521 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Performing Active Full Backup
You can create an ad-hoc full backup — active full backup, and add it to the backup chain on the backup
repository. The active full backup resets the backup chain. All subsequent incremental backups use the active
full backup as a starting point. The previously used full backup will remain on the backup repository until it is
removed from the backup chain according to the retention policy.
When you start active full backup for a backup policy, Veeam Backup & Replication applies the policy to Veeam
Agent computers and sends a command to perform active full backup on these computers. Veeam Backup &
Replication does not check whether connection to Veeam Agent computers is active at the time when the
command is sent. Keep in mind that the active full backup operation will be performed only on those computers
that received the command from the backup server.
Keep in mind that you cannot start active full backup for protection groups for pre-installed Veeam Agents and
their members. Veeam Agent computers included in such protection groups will be skipped and Veeam Backup
& Replication will display a warning message in a backup policy session statistics.
To perform active full backup on Veeam Agent computers added to the backup policy:
3. In the working area, select the backup policy and click Active Full on the ribbon or right-click the policy
and select Active full.
TIP
You can also create a full backup of an individual computer added to the backup policy. To learn more, see
Performing Active Full Backup for Individual Computer.
522 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Performing Active Full Backup for Individual Computer
To create an active full backup for an individual computer:
4. In the bottom part of Veeam Backup & Replication, find the list of computers that are processed by the
selected backup policy. In the list, right-click the computer and click Active full.
Keep in mind the following you will be able to create an active full backup for another computer in the
same job only after active full backup is created for the selected computer.
523 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Clearing Backup Cache
You can use the Veeam backup console to delete restore points from the backup cache on computers added to
the backup policy. This operation may be required, for example, if the backup cache contains one or more
restore points, and the backup chain in the target location has changed prior to the time when Veeam Agent
starts uploading restore points to the target location.
Keep in mind that the clear cache operation is available only for computers that are protected with Veeam Agent
for Microsoft Windows and are members of any protection group excluding protection group for p re-installed
Veeam Agents.
When you perform the clear cache operation, Veeam Backup & Replication applies the policy to Veeam Agent
computers and sends a command to delete restore points from the backup cache on these computers. Veeam
Backup & Replication does not check whether connection to Veeam Agent computers is active at the time when
the command is sent. Keep in mind that the operation will be performed only on those computers that received
the command from the backup server.
To clear the backup cache on Veeam Agent computers added to the backup policy:
3. In the working area, select the backup policy, press and hold the [Ctrl] k ey, right-click the backup policy
and select Clear cache.
524 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Editing Backup Policy Settings
You can edit settings of a Veeam Agent backup policy at any time. For example, you may want to change the
backup scope, target location or scheduling settings for Veeam Agent backup jobs running on protected
computers. After you change settings of the backup policy, Veeam Backup & Replication applies the specified
settings to Veeam Agent backup jobs configured on protected computers added to the policy.
NOTE
• You cannot change the type of protected computers added to the job and the job mode (that is,
change a Veeam Agent backup job to a backup policy and vice versa).
• [For Veeam Agent backup jobs for Linux computers] You cannot change the ba ckup mode from file-
level to volume-level and vice versa.
• If you change a password for data encryption without changing other backup policy settings, the
process of applying the backup policy to a protected computer completes with a notification
informing that the backup policy was not modified. This happens because data encryption settings
for managed Veeam Agents are saved to the Veeam Backup & Replication database and are not
passed to a Veeam Agent computer.
3. In the working area, select the backup policy and click E d it on the ribbon or right-click the policy and
select E d it.
4. Complete the steps of the E d it Agent Backup Job wizard to change the job settings as required.
525 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Enabling and Disabling Backup Policy
You can temporary disable Veeam Agent backup policies configured in Veeam Backup & Replication. While a
backup policy is in the disabled state, the following operations are not performed in the Veeam Agent
management infrastructure:
• Veeam Backup & Replication does not apply backup policy settings to Veeam Agent computers.
• Veeam Agent running on a protected computer does not create backups on the backup repository.
If a user of a protected computer starts the Veeam Agent backup job manually or if the job starts by
schedule, the job session will fail and report the "The job has been disabled by the Veeam Backup &
Replication administrator" error. To let Veeam Agent for Microsoft Windows store backups to the backup
repository again, you must enable the disabled policy and apply it to protected computers. To learn more,
see Applying Backup Policy to Protected Computers.
3. In the working area, select the Veeam Agent backup policy and click Disable on the ribbon or right-click
the policy and select Disable.
Keep in mind that Veeam Backup & Replication does not immediately disable a backup policy for
protection groups for pre-installed Veeam Agents and their members. Veeam Agents installed on
computers included in these groups connect to Veeam Backup & Replication every 6 hours and get
updated backup policy settings. If a backup policy is targeted at the Veeam backup server and the next
backup policy session is scheduled earlier than the next connection to Veeam Backup & Replication, this
backup policy will get updated backup policy settings at the next session start.
TIP
If necessary, you can synchronize Veeam Agent with Veeam Backup & Replication running a
command from the Veeam Agent computer. To learn more, see Backup Policy Application Methods.
If you disabled a backup policy in the Veeam Backup & Replication console and this backup policy starts a
new backup session targeted at the Veeam backup server before the next connection to Veeam Backup &
Replication, this backup session and all automatic retries of this session will fail.
If you want to disable backup policy immediately, you must synchronize Veeam Agent with Veeam Backup
& Replication from the Veeam Agent computer side manually. To learn more, see Veeam Agent for
Microsoft Windows Configuration, Veeam Agent for Linux Configuration, or Veeam Agent for Mac
Configuration.
526 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
To enable a disabled policy, select it in the list and click Disable on the ribbon once again.
527 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Cloning Backup Policy
You can clone backup policies configured in Veeam Backup & Replication. For example, you may want to
configure a backup policy that will be used as a ‘policy template’, and use this policy to create multiple policies
with similar settings.
3. In the working area, select the backup policy and click Clone on the ribbon or right-click the backup policy
and select Clone.
4. After a backup policy is cloned, you can edit all its settings, including the job name.
528 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Removing Backup Policy
You can permanently remove a Veeam Agent backup policy from Veeam Backup & Replication. When you
remove a backup policy, Veeam Backup & Replication also removes child backup jobs configured on Veeam
Agent computers. Backups created by these jobs remain on the target location.
3. In the working area, select the Veeam Agent backup policy and click Delete on the ribbon or right-click the
policy and select Delete.
NOTE
[For computers with pre-installed Veeam Agents] The child jobs will continue running till the next
synchronization with Veeam Backup & Replication.
529 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Managing Protected Computers
IMP ORTANT
A protection group for pre-installed Veeam Agents offers a limited set of operations to manage protected
computers. To learn more, see Managing Protected Computers With Pre-Installed Veeam Agents.
You can perform the following operations with computers added to the inventory in Veeam Backup &
Replication:
• Uninstalling Veeam Agent and other Veeam Components from a protected computer .
For Veeam Agent computers added to the protection group for pre-installed Veeam Agents, you can perform
the following operations:
530 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Moving Unmanaged Computer to
Protection Group
You can quickly move an unmanaged Veeam Agent computer to a protection group in the Veeam Backup &
Replication inventory. This allows you to start using Veeam Backup & Replication to manage Veeam Agent that
is already set up to create backups in the Veeam backup repository.
Keep in mind, that you can move an unmanaged Veeam Agent computer only to a protection group that
includes individual computers and a protection group for pre-installed Veeam Agents:
• In case of the protection group that includes individual computers, you can move unmanaged computer
using the Veeam Backup & Replication console.
• In case of the protection group for pre-installed Veeam Agents, you can move unmanaged computer only
from the Veeam Agent side. This operation is similar to the initial Veeam Agent configuration. To learn
more, see one of the following sections depending on the Veea m Agent that is installed on the computer
you plan to move:
You can move a computer from the Unmanaged protection group to a new protection group or protection group
that you have already created.
• When you move an unmanaged computer to a new protection group, Veeam Backup & Replication creates
the protection group and adds the computer to this group. In the protection group settings, you can
define discovery and deployment options according to which Veeam Backup & Replication will process the
added computer.
• When you move an unmanaged computer to an already existing protection group, Veeam Backup &
Replication adds this computer to the protection group and starts processing the computer according to
discovery and deployment settings defined in the properties of the protection group. Veeam Backup &
Replication discovers the added computer, checks whether Veeam Agent running on the computer needs
upgrade and upgrades Veeam Agent if needed.
NOTE
• After you move a computer to a protection group, data backup for this computer will be performed
by a backup job configured in Veeam Backup & Replication. Veea m Agent running on the computer
will start a new backup chain on a target location specified in the backup job settings. The original
backup job configured on the Veeam Agent computer will be removed in Veeam Agent, and you will
not be able to continue the backup chain created with this job.
• You cannot map a Veeam Agent backup job configured in Veeam Backup & Replication to a backup
chain that was created on a backup repository by Veeam Agent operating in the standalone mode.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the Unma naged node.
531 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. In the working area, select the necessary computer and click Move to > New protection group on the
ribbon or right click the computer and select Move to > New protection group.
To move an unmanaged computer to a protection group that is already created in the inventory:
2. In the inventory pane, expand the P hy sical Infrastructure node and select the Unma naged node.
3. In the working area, select the necessary computer and click Move to > na me of the protection group on
the ribbon or right click the computer and select Move to > na me of the protection group .
532 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Adding Computer to Backup Job
You can quickly add a specific protected computer to a Veeam Agent backup job that you have configured in
Veeam Backup & Replication. To do this, do the following:
2. In the inventory pane, in the P hy sical I nfrastructure node, select a protection group whose computers you
want to add to a Veeam Agent backup job and do one of the following:
o In the working area, select the computer that you want to add to the job and click Ad d to Backup >
name of the job on the ribbon.
o In the working area, right-click the computer that you want to add to the job and select Ad d to
b a ckup job > name of the job .
NOTE
• You can add a computer to a Veeam Agent backup job configured for computers of the same
platform. For example, you can add a Linux computer only to a Veeam Agent backup job for Linux
computers.
• You can also add a specific protected computer to a new backup job. To learn more, see Working
with Veeam Agent Backup Jobs and Policies.
533 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Performing Quick Backup
You can create an ad-hoc incremental backup for one or more protected computers — quick backup, and add it
to the backup chain on the backup repository. Quick backup can be helpful if you want to produce an additional
restore point for one or more computers in the Veeam Agent backup job and do not want to configure a new job
or modify the existing one.
Quick backup can be performed for computers that meet the following requirements:
• A protected computer is added to a Veeam Agent backup job managed by the backup server.
• A full backup file for the protected computer exists on the backup repository configured in the backup
infrastructure.
2. In the inventory pane, expand the P hy sical Infrastructure node and select a protection group that contains
the protected computer that you want to back up.
3. In the working area, select one or more computers and click Quick Backup on the ribbon or right-click the
computers and select Quick backup.
Veeam Backup & Replication will trigger a Veeam Agent backup job to create a new incremental restore point
for selected computers. Details of a running quick backup task are displayed in the job session window.
NOTE
If a computer for which you want to perform quick backup is added to more than one Veeam Agent backup
job, Veeam Backup & Replication will trigger only the job that created the latest restore point for this
computer.
534 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Viewing Properties
You can view detailed information about protected computers. The detailed information provides the following
data:
• Host name
• IP address
Keep in mind that IP address is not available for members of a protection group for pre -installed Veeam
Agents and a protection group for cloud machines.
• Operating system
• CBT driver version (for computers running a Microsoft Windows Server OS)
3. In the working area, select the computer and click Details on the ribbon or right-click the computer and
select Details.
535 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Rescanning Protected Computer
You can rescan protected computers added to the inventory. The rescan operation may be required, for
example, if you want to refresh information about the protected computer in the Veeam Backup & Replication
database. During the rescan operation, Veeam Backup & Replication communicates to Veeam Installer Service
running on the protected computer, retrieves information about the computer and stores this information to the
configuration database.
Keep in mind that rescan is not available for protection groups for pre-installed Veeam Agents and their
members. Veeam Agents installed on computers included in such protection groups connect to Veeam Backup &
Replication every 6 hours and provide information about the Veeam Agent computer. If necessary, you can
synchronize Veeam Agent with Veeam Backup & Replication running a command from the Veeam Agent
computer. To learn more, see Backup Policy Application Methods.
NOTE
During the rescan of a separate protected computer, Veeam Backup & Replication does not perform
deployment operations specified in the protection group settings. To perform the deployment operations,
rescan the protection group.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the computer and click Rescan on the ribbon or right-click the computer and
select Rescan.
536 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Managing Veeam Agent
You can use the backup console to manage the following Veeam Agents on a specific computer in the inventory:
Keep in mind that Veeam Agents for computers that you plan to add to a protection group for pre -installed
Veeam Agents require a different installation approach. To learn more, see Deploying Veeam Agents Using
Generated Setup Files.
537 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Installing Veeam Agent
You can install Veeam Agent on a specific protected computer in the inventory. This operation may be required,
for example, if you want to test the installation process before allowing Veeam Backup & Replication to deploy
Veeam Agent to all computers included in the protection group.
Keep in mind that Veeam Agents for computers that you plan to add to a protection group for pre -installed
Veeam Agents require a different installation approach. To lea rn more, see Deploying Veeam Agents Using
Generated Setup Files.
• The protected computer must be powered on and able to be connected over the network.
• The required version of Veeam Agent must be available on the distribution server.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the necessary computer and click Install Agent on the ribbon or right-click the
computer and select Ag ent > Install agent.
NOTE
In some cases, installation of Veeam Agent for Microsoft Windows may require computer reboot. This can
happen, for example, if you have an earlier version of Microsoft .NET Framework installed on the computer
and during the installation process the framework is used by third -party software.
You can instruct Veeam Backup & Replication to automatically reboot the Veeam Agent computer. To do
so, select the P erform reboot automatically if required check box in the protection group settings.
538 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Upgrading Veeam Agent
Depending on your infrastructure setup, you can upg rade Veeam Agent in the following ways:
• Protection group for individual computers (Veeam Agent for Microsoft Windows, Veeam Agent for Linux,
Veeam Agent for IBM AIX and Veeam Agent for Oracle Solaris)
• Protection group for computers from CSV file (Veeam Agent for Microsoft Windows, Veeam Agent for
Linux, Veeam Agent for IBM AIX and Veeam Agent for Oracle Solaris)
• Protection group for Microsoft Active Directory objects (Veeam Agent for Microsoft Windows)
• Protection group for cloud machines (Veeam Agent for Microsoft Windows and Veeam Agent for Linux)
• Automatically — You can use this method to upgrade all outdated Veeam Agents on computers in a
protection group. To enable Veeam Agent auto updates, select the Auto-update backup agents and plug-
ins option in the protection group settings. For more information, see Creating Protection Groups.
• Manually — You can upgrade Veeam Agent on an individual computer in a protection group. This method
may be required, for example, if you did not allow Veeam Backup & Replication to automatically upgrade
Veeam Agent on computers included in the protection group and want to test the upgrade process on a
selected computer first.
• The protected computer is powered on and able to be connected over the network.
539 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
During the protected computers discovery process, Veeam Backup & Replication checks the version of
Veeam Agent running on a protected computer and the version of Veeam Agent available on the Veeam
Backup & Replication server. If a newer version of Veeam Ag ent becomes available, and automatic upgrade
of Veeam Agent is disabled for a protection group, Veeam Backup & Replication puts a computer to the
Upgrade required state.
In addition, Veeam Backup & Replication includes computers that require upgrade of Ve eam Agent in the
Out of Date protection group. You can upgrade Veeam Agent on all computers that require upgrade at
once. To learn more, see Upgrading Veeam Agent on Multiple Computers.
2. In the inventory pane, in the P hy sical Infrastructure node, select the Out of Date protection group and
click Up g rade Agents on the ribbon or right-click the Out of Date protection group and select Up g rade.
NOTE
In some cases, upgrade to a new version of Veeam Agent for Microsoft Windows may require computer
reboot.
540 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Upgrading Veeam Agent on Individual Computers
To upgrade Veeam Agent on a protected computer:
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the necessary computer and click Up grade Agent on the ribbon or right-click
the computer and select Ag ent > Up grade agent.
NOTE
In some cases, upgrade to a new version of Veeam Agent for Microsoft Windows may require computer
reboot.
NOTE
Upgrade of Veeam Agent on the protected computer side is the only option available f or Veeam Agent for
Mac.
TIP
During each synchronization session, Veeam Backup & Replication checks the version of Veeam Agents
installed on the protected computers. If the Veeam Agent version does not coincide with the version of
Veeam Backup & Replication, Veeam Agent computer will be moved to the Out of Date protection group.
541 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Before You Begin
Before you upgrade pre-installed Veeam Agent, do the following:
• Check that the latest update for Veeam Backup & Replication is installed on your backup server. To learn
more, see the Upgrading to Veeam Backup & Replication 12.2 section in the Veeam Backup & Replication
Guide.
• Make sure that Veeam Backup & Replication remote components, such as the dis tribution server, are
updated.
• Make sure that a user account that you plan to use for installation on the Veeam Agent computer side has
Local Administrator privileges.
3. In the inventory pane, select the protection group for pre-installed Veeam Agents that you want to
update and click E d it Group on the ribbon or right-click the protection group for pre-installed Veeam
Agents that you want to update and select P roperties.
542 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
4. At the P a ckage step, check that the export path and setup files for OSes that run on computers with
Veeam Agents you want to update are specified correctly.
5. Click Ap p ly to generate setup files. Then click Finish to close the wizard.
Windows Computers
To update pre-installed Veeam Agent on a Microsoft Windows computer, perform the following operations:
1. Upload the Veeam Agent setup files on the computer you want to protect.
2. Uninstall obsolete version of the Veeam Installer Service. To do this, navigate to Control Panel > Programs
> Programs and Features, find the Veeam Installer Service in the list of programs and uninstall it.
543 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. Install updated version of Veeam Agent. Use one of the following files depending on the architecture of
your computer OS:
4. If necessary, immediately synchronize Veeam Agent with Veeam Backup & Replication running the
following command:
Linux Computers
To update pre-installed Veeam Agent on a Linux computer, perform the following operations:
1. Upload Veeam Agent setup files on the computer you want to protect.
2. Navigate to the directory where you have saved setup files and install Veeam Agent. This procedure is
similar to the installation of the Veeam Agent for Linux in the offline mode. To learn more, see the
Installing Veeam Agent for Linux in Offline Mode section in the Veeam Agent for Linux User Guide.
3. If necessary, immediately synchronize Veeam Agent with Veeam Backup & Replication running the
following command:
1. Upload Veeam Agent setup files on the computer you want to protect.
2. Navigate to the directory where you have saved the setup files and install Veeam Agent using the rpm
command with the -U parameter. To learn more, see the Upgrading Product topic in the Veeam Agent for
IBM AIX User Guide.
3. If necessary, immediately synchronize Veeam Agent with Veeam Backup & Replication running the
following command:
1. Upload Veeam Agent setup files on the computer you want to protect.
544 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. Navigate to the directory where you have saved the setup files and install Veeam Agent. This procedure is
similar to the default installation of the Veeam Agent for Oracle Solaris. To learn more, see the Installing
Veeam Agent for Oracle Solaris topic in the Veeam Agent for Oracle Solaris User Guide.
3. If necessary, immediately synchronize Veeam Agent with Veeam Backup & Replication running the
following command:
Mac Computers
To update pre-installed Veeam Agent on Mac computer, perform the following operations:
1. Upload Veeam Agent setup files on the computer you want to protect.
2. Navigate to the directory where you have saved setup files and install Veeam Agent. This procedure is
similar to the default installation of the Veeam Agent for Mac. To learn more, see the Installing Veeam
Agent topic in the Veeam Agent for Mac User Guide.
3. If necessary, immediately synchronize Veeam Agent with Veeam Backup & Replication running the
following command:
545 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Installing Veeam CBT Driver
You can use the Veeam Backup & Replication console to quickly install the Veeam changed block tracking (CBT)
driver on a protected computer. This operation may be required, for example, if you want to evaluate driver
performance on a selected computer rather than deploy driver to all computers in the protection group at once.
If you work with computer included in a protection group for pre-installed Veeam Agents, you can install and
uninstall Veeam CBT driver only from the Veeam Agent computer side. To learn more, see the InstallCBTDriver
and UninstallCBTDriver sections in the Veeam Agent Configurator Reference.
Before you install the Veeam CBT driver, check the following prerequisites:
• The protected computer on which you want to install the driver must run one of the following OSes:
o Microsoft Windows Server OS that is supported by Veeam Agent. For more information, see System
Requirements
• The protected computer on which you want to install the driver must be powered on and able to be
connected over the network.
IMP ORTANT
• Prior to installing the Veeam CBT driver on a computer running Microsoft Windows Server 2008 R2
SP1, make sure that update KB3033929 is installed in the OS.
The update adds the SHA-2 code signing support that is required for verification of the Veeam CBT
driver signature. Without this update installed, the OS running on a protected computer will fail to
boot after you install the Veeam CBT driver. To learn more, see this Microsoft KB article.
• Do not install the Veeam CBT driver on a computer running Microsoft Windows Server 2008 R2 SP1,
2012 or 2012 R2 if one or more volumes on this computer are encrypted with Microsoft BitLocker (or
other encryption tool), or if you plan to use Microsoft BitLocker to encrypt volumes on this
computer. Concurrent operation of Microsoft BitLocker and Veeam CBT driver may result in driver
failures and may prevent the OS from starting.
• Do not install the Veeam CBT driver on a computer if you plan to use devices with hardware
encryption made according to the TCG Opal Security Subsystem Class Specification. Operation of the
driver on such devices may lead to a crash of the operating system. To learn more about the TCG
Opal Security Subsystem Class Specification, see this Trusted Computing Group webpage.
2. In the inventory pane, expand the P hy sical Infrastructure node and select a protection group that contains
the computer on which you want to install the driver.
3. In the working area, select the necessary computer and click Install CBT Driver on the ribbon or right-click
the computer and select Ag ent > Install CBT driver.
546 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
To enable the CBT driver after installation, you need to reboot the computer. To learn more, see Rebooting
Protected Computer.
2. In the inventory pane, expand the P hy sical Infrastructure node and select a protection group that contains
the computer on which you want to uninstall the driver.
3. In the working area, select the necessary computer and click Uninstall CBT Driver on the ribbon or right-
click the computer and select Ag ent > Uninstall CBT driver.
547 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
To complete the driver uninstallation process, you need to reboot the computer. To learn more, see
Rebooting Protected Computer.
548 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Uninstalling Veeam Agent
You can remove Veeam Agent from a specific protected computer, for example, if you want to reinstall Veeam
Agent running on the protected computer.
Keep in mind that you can uninstall Veeam Agent on a computer added to a protection group for pre -installed
Veeam Agents only from the Veeam Agent computer side. To learn more about protection groups for pre -
installed Veeam Agents, see Protection Group Types.
TIP
You can remove Veeam Agent and other Veeam components as one operation. To learn more, see
Uninstalling Veeam Agent and Other Veeam Components.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the necessary computer and click Uninstall Agent on the ribbon or right-click
the computer and select Ag ent > Uninstall agent.
549 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If automatic installation of Veeam Agent is enabled in the protection group settings, after you
remove Veeam Agent from a selected computer, Veeam Backup & Replication will install Veeam
Agent on this computer during the next rescan job session started by schedule.
• Prerequisite components installed and used by Veeam Agent are not removed during the uninstall
process. You can remove the remaining components from the side of the computer from which you
uninstalled Veeam Agent.
• If you uninstall Veeam Agent for Microsoft Windows added to the protection group for pre -installed
Veeam Agents and then re-install on the same computer, Veeam Agent will not connect to Veeam
backup server automatically. To connect Veeam Agent, you must repeat the configuration step of
the Veeam Agent deployment scenario. To learn more, see Deploying Veeam Agents Using
Generated Setup Files.
550 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Veeam Recovery Media
You can use the backup console to create a Veeam Recovery Media for a Veeam Agent computer that you
manage in Veeam Backup & Replication. The process of creating a Veeam Recovery Media in Veeam Backup &
Replication practically does not differ from the same procedure performed on a Veeam Agent computer. To
learn more about the Veeam Recovery Media, see the Veeam Recovery Media section in the Veeam Agent for
Microsoft Windows User Guide.
Keep in mind that you can create Veeam Recovery Media in Veeam Backup & Replication only for computers that
are protected with Veeam Agent for Microsoft Windows.
551 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Before You Begin
You can create a Veeam Recovery Media for a protected computer in Veeam Backup & Replication if the
following conditions are met:
• A full backup file of one of the following backup types was created for the protected computer on the
target location by a Veeam Agent backup job:
o Volume-level backup of the computer OS data (created with the Operating system option selected in
the backup job settings) or computer system volume
o File-level backup of the computer OS data created with the Operating system option selected in the
backup job settings
NOTE
• You can create a Veeam Recovery Media for a protected computer using a copy of a full backup file
that meets all the conditions. To learn more, see the Backup Copy section in the Veeam Backup &
Replication User Guide.
• By default, you cannot create a Veeam Recovery Media for a failover cluster with Cluster Shared
Volumes (CSV). As a workaround, you can create a Veeam Recovery Media directly on the failover
cluster node. To learn more, see this Veeam KB article.
• The removable storage device must be inserted into a corresponding slot on the computer or connected to
the computer.
• The removable storage device must have enough capacity to store the created recovery image. On
average, the size of the created recovery image without manually loaded drivers is 500 MB.
• During the recovery image creation, Veeam Agent for Microsoft Windows formats the removable storage
device. If you have important information on the device, create a copy of this data in some other location.
CD/DVD/BD Scenario
• An empty or re-writable CD/DVD/BD must be inserted into a CD/DVD/BD drive on the computer.
• The CD/DVD/BD must have enough capacity to store the created recovery image. On average, the size of
the created recovery image without manually loaded drivers is 500 MB.
• [For RW CD/DVD/BD] During the recovery image creation, Veeam Agent for Microsoft Windows erases
information on the CD/DVD/BD. If you have important information on the CD/DVD/BD, create a copy of
this data in some other location.
552 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 1. Launch Create Recovery Media Wizard
To launch the Create Recovery Media wizard:
2. In the inventory pane, expand the P hy sical Infrastructure node and select a protection group that contains
the necessary protected computer.
3. In the working area, select the computer and click Recovery Media on the ribbon or right-click the
computer and select Ag ent > Create recovery media.
TIP
You can also launch the Create Recovery Media wizard from the Ba ckups node in the Home view of the
Veeam backup console. To learn more, see Creating Recovery Media from Backup.
553 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 2. Specify Recovery Media Options
At the Recovery Media step of the wizard, in the Ava ilable bootable media types list, specify on which type of
media you want to create a recovery image. You can create the following types of recovery images:
• Recovery image on a removable storage device. You can create a recovery image on a USB drive, SD card
and so on. Veeam Backup & Replication displays all removable storage devices currently attached to the
backup server. Select the necessary one in the list.
• Recovery image on an optical disk. You can create a recovery image on a CD, DVD or BD. Veeam Backup &
Replication displays all CD, DVD and BD drives available on the backup server. Select the necessary one in
the list.
• ISO file with the recovery image. You can create a recovery image in the ISO file format and save the
resulting file locally on the backup server.
NOTE
When you create a recovery image from the Veeam backup console, you cannot specify additional r ecovery
media options in the same way as when you create a recovery image on the Veeam Agent computer. In this
scenario, the recovery image is created with default settings: Veeam Backup & Replication includes
network connection settings and hardware drivers installed on the Veeam Agent computer in the recovery
image.
554 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Path to ISO
The Image Path step of the wizard is available if you have selected to create an ISO file with the recovery image.
In the Sp ecify folder to create recovery media image in field, specify a real path to the folder where you want to
save the created recovery image, and the ISO file name. When you create Veeam Recovery Media using the
Veeam Backup & Replication console, you can save the ISO file on the local drive of the Veeam backup server
only. You cannot save the ISO file in a shared folder. Thus, the recovery image will always be available should
Veeam Agent computer volumes get corrupted or the computer fail to start.
555 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Review Recovery Image Settings
At the Rea dy to Apply step of the wizard, review settings of the recovery image that you plan to create and click
Create.
Veeam Backup & Replication will collect data necessary for recovery image creation and write the resulting
recovery image to the specified target.
556 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 5. Finish Working with Wizard
The process of recovery image creation may take some time. Wait for the process to complete and click Finish to
exit the wizard.
If you want to interrupt the process of recovery image creation, click Ca ncel or close the wizard window.
557 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
What You Do Next
[For ISO file] After the recovery image is created, you can burn the created ISO file to a CD/DVD/BD. To do this,
you can use native Microsoft Windows tools or third-party software.
558 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Rebooting Protected Computer
You can use the Veeam Backup & Replication console to reboot a protected computer. This operation may be
required, for example, if you have installed the CBT driver on a selected computer and need to reboot this
computer to finish the installation process and enable the driver.
Keep in mind that you cannot reboot a protected computer that is added to a protection group for pre -installed
Veeam Agents. To learn more about protection groups for pre-installed Veeam Agents, see Protection Group
Types.
2. In the inventory pane, expand the P hy sical Infrastructure node and select a protection group that contains
the computer that requires reboot. The computer that requires reboot is displayed in the Reboot required
status in the Veeam Backup & Replication console.
3. In the working area, select the necessary computer and click Reb oot on the ribbon or right-click the
computer and select Reb oot.
TIP
You can also reboot a computer with a different status than the Reboot required status. To do this, select
the necessary computer, press and hold the [Ctrl] key, right-click the computer and select Ag ent > Reboot.
559 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Uninstalling Veeam Agent and Other
Veeam Components
You can remove Veeam Agent and the following Veeam components installed on a protected computer as one
operation:
• Veeam Plug-ins
TIP
• To learn about Veeam Plug-ins for enterprise applications, see Veeam Plug-ins for Enterprise
Applications Guide.
• To learn about the Veeam Installer Service, Veeam Deployer Service and Veeam Transport Service,
see Rescan Job.
• To learn about the Veeam CBT driver, see Installing Veeam CBT Driver.
• [For Microsoft Windows and Linux computers] Veeam Installer Service, Veeam Deployer Service and
Veeam Transport Service are not removed from the Veeam Agent computer if the computer is added to
the Veeam backup infrastructure as a managed server. To learn more, see the Virtualization Servers and
Hosts section in the Veeam Backup & Replication User Guide.
• [For Linux computers] Veeam Deployer Service is not removed if Veeam Backup & Replication connects to
the protected computer with single-use credentials. To learn more, see Creating Veeam Agent Backup
Jobs.
• If automatic installation of Veeam Agent is enabled in the protection group settings, after you remove
Veeam Agent from a selected computer, Veeam Backup & Replication will install Veeam Agent on this
computer during the next rescan job session started by schedule. To learn more, see Creating Protection
Groups.
NOTE
[For Microsoft Windows and Linux computers] If automatic installation of Veeam Agent is not
enabled in the protection group settings, Veeam Backup & Replication will not install Veeam Agent
during the next rescan job session started by schedule but will install the Veeam Installer Service or
Veeam Deployer Service and Veeam Transport Service on the computer.
• You can uninstall Veeam Agent, Veeam Plug-ins and Veeam components on a computer added to a
protection group for pre-installed Veeam Agents only from the Veeam Agent computer side. To learn
more about protection groups for pre-installed Veeam Agents, see Protection Group Types.
• If you uninstall Veeam Agent for Microsoft Windows added to the protection group for pre -installed
Veeam Agents and then re-install on the same computer, Veeam Agent will not connect to Veeam backup
server automatically. To connect Veeam Agent, you must repeat the configuration step of the Veeam
Agent deployment scenario. To learn more, see Deploying Veeam Agents Using Generated Setup Files.
560 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Prerequisite components installed and used by Veeam Agent are not removed during the uninstall
process. You can remove the remaining components from the side of the computer from which you
uninstalled Veeam Agent.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the necessary computer and click Uninstall Everything on the ribbon or right-
click the computer and select Uninstall everything.
561 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Removing Computer from Protection
Group
You can remove one or more computers from a protection group, for example, if you do not want to protect
these computers with Veeam Agent any longer but want to back up data of other computers in the protection
group.
When you remove a computer from a protection group, Veeam Backup & Replication removes records about the
computer from the Veeam backup console and configuration database but does not uninstall Veeam Agent from
the computer. You can remove Veeam Agent from the computer in advance, before you remove the computer
from the protection group. To learn more, see Uninstalling Veeam Agent.
Alternatively, you can remove a computer from a protection group, and then uninstall Veeam Agent from this
computer. Keep in mind that in this case you will have to uninstall Veeam Agent directly on the Veeam Agent
computer.
TIP
You can also remove entire protection group from the Veeam Backup & Replication inventory. When you
remove a protection group, you can instruct Veeam Backup & Replication to uninstall Veeam Agents from
all protected computers included in this protection group. To learn more, see Removing Protection Group.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the necessary protection group.
3. In the working area, select the necessary computer and click Remove from Configuration on the ribbon or
right-click the computer and select Remove from configuration.
Backups created for computers that were removed from a protection group remain intact in the backup location.
You can delete this backup data manually later if needed.
562 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
NOTE
You cannot remove a computer from the protection group if this computer is a failover cluster node.
Alternative ways of removing computer from protection group differ depending on the type of the protection
group that contains the computer you want to remove.
• For a protection group that contains individual computers, edit the protection group and remove the
necessary computer at the Computers step of the E d it Protection Group wizard. To learn more, see Editing
Protection Group Settings.
You can also use this option to remove a computer from the Manually Added protection group. This
protection group contains computers that you add directly to a Veeam Agent backup job. To learn more,
see Removing Computer from "Manually Added" Protection Group .
• For a protection group that contains Active Directory objects, edit the protection group and remove the
necessary computer account at the Active Directory step of the E d it Protection Group wizard.
Alternatively, if the protection group contains a container, organizational unit, group or entire domain,
you can exclude the computer at the E x clusions step of the wizard. To learn more, see Exclude Objects
from Protection Group.
• For a protection group that contains computers listed in a CSV file, remove the record about the necessary
computer from the CSV file. During subsequent rescan of the protection group, Veeam Backup &
Replication will remove the computer from the protection group.
563 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
• For a protection group for pre-installed Veeam Agents, you can remove the computer from the Veeam
Agent computer side. The process of removing a computer from a protection group for pre -installed
Veeam Agents differs depending on the Veeam Agent computer OS:
o For Windows-based Veeam Agent computers, see the RemoveOwner section in the Veeam Agent
Configurator Reference.
o For Linux-based Veeam Agent computers, see the Deleting Connection to Veeam Backup Server
section in the Veeam Agent for Linux User Guide.
o For Unix-based Veeam Agent computers running the IBM AIX operating system, see the Deleting
Connection to Veeam Backup Server section in the Veeam Agent for IBM AIX User Guide.
o For Unix-based Veeam Agent computers running the Oracle Solaris operating system, s ee the
Deleting Connection to Veeam Backup Server section in the Veeam Agent for Oracle Solaris User
Guide.
o For macOS-based Veeam Agent computers, see the Deleting Connection to Veeam Backup Server
section in the Veeam Agent for Mac User Guide.
To remove a computer from the Manually Added protection group, you must edit this protection group and
remove the computer at the Computers step of the E d it Protection Group wizard. To learn more, see Editing
Protection Group Settings.
NOTE
You cannot remove a computer from the Manually Added protection group if this computer is added to a
Veeam Agent backup job.
564 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring Data from Veeam Agent
Backups
You can recover data from backups created by Veeam Agent backup jobs configured in Veeam Backup &
Replication. For data restore with the Veeam backup console, you can use Veeam Agent backups created on a
Veeam backup repository or cloud repository. If you specified a local drive or network shared folder as a target
for Veeam Agent backups, you need to restore data from such backups using Vee am Agent UI on a protected
computer.
• Restore application items from Veeam Agent backups with Veeam Explorers
• Export restore points of Veeam Agent backups to standalone full backup files
• For a Microsoft Windows computer, you can create the Veeam Recovery Media with the Veeam backup
console. To learn more, see Creating Veeam Recovery Media.
• For a Linux computer, you can download the Veeam Recovery Media from the Veeam website or create a
custom Veeam Recovery Media. To learn more, see the Veeam Recovery Media section in the Veeam Agent
for Linux User Guide.
The process of data restore with the Veeam Recovery Media in the Veeam Agent management scenario does not
differ from the same process on a computer that runs Veea m Agent operating in the standalone mode.
• For information on data restore with the Veeam Recovery Media on a Microsoft Windows computer, see
the Restoring from Veeam Recovery Media section in the Veeam Agent for Microsoft Windows User Guide.
565 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
• For information on data restore with the Veeam Recovery Media on a Linux computer, see the Restoring
from Veeam Recovery Media section in the Veeam Agent for Linux User Guide.
566 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Veeam Agent Backup to vSphere
VM
In the Veeam Backup & Replication console, you can use Instant Recovery to restore a Veeam Agent computer as
a VMware vSphere VM in your virtualization environment.
A restored VMware vSphere VM will have the same settings as the backed -up Veeam Agent computer. During
the restore process, Veeam Backup & Replication retrieves the settings of the Veeam Agent comp uter from the
backup and applies them to the target VM. These settings include:
• Amount of RAM.
• BIOS UUID.
If you do not want to preserve the backed-up machine UUID for a VMware vSphere VM, you can create a
new UUID during the Instant Recovery configuration process.
• Size of volumes.
• You can use entire machine or volume-level backups of Microsoft Windows and Linux computers. Volume-
level backups of Windows computers must include the computer system drive. Volume -level backups of
Linux computers must include the root file system (/) and all partitions specified in the /etc/fstab file.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot perform this operation with Veeam Agent backups stored in a Veeam Cloud Connect
repository.
• Make sure that the target host has enough resources for a new VM. Otherwise, your VM will reduce the
target host performance.
• If you restore a workload to the production network, make sure that the original workload is powered off.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Backup &
Replication will restore the original disk and the LVM volume group as 2 separate disks. This way, all
data, including the data within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Backup & Replication will
restore 4 disks. The restored disks will consume the storage space equal to the size of the 2 original
disks and the 2 LVM volume groups from these disks.
567 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restore to vSphere VM
The procedure of Instant Recovery for a Veeam Agent computer practically does not differ from the same
procedure for a VM. The main difference from Instant Recovery is that you do not need to select the recovery
mode, because Veeam Agent computers are always restored to a new location. To learn more, see the
Performing Instant Recovery of Workloads to VMware vSphere section in the Veeam Backup & Replication User
Guide.
568 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Veeam Agent Backup to Hyper-V
VM
In the Veeam Backup & Replication console, you can use Instant Recovery to restore a Veeam Agent computer as
a Hyper-V VM in your virtualization environment.
A restored Hyper-V VM will have the same settings as the backed-up Veeam Agent computer. During the restore
process, Veeam Backup & Replication retrieves settings of the Veeam Agent computer from the backup and
applies them to the target VM.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot use backups stored in a Veeam Cloud Connect repository for this operation.
• To restore to a Hyper-V VM from a backup of a Linux computer, you must consider the Hyper-V
limitations. To learn more, see this Microsoft article.
• [For backups of Microsoft Windows computers] You cannot recover an EFI-based Veeam Agent computer
that runs Windows 7, Windows Server 2008 or Windows Server 2008 R2 to a Hyper -V VM. These OSes can
be restored only to a Generation 1 VM that does not support EFI. To learn more, see this Microsoft article.
• Make sure that the target host has enough resources for a new VM. Otherwise, your VM will reduce the
target host performance.
• Veeam Agent computer disks are recovered as dynamically expanding virtual disks.
• By default, Veeam Backup & Replication automatically powers on a VM after restore. If you do not want to
power on a VM after restore, you can change this setting during the Instant Recovery configuration
process.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Backup &
Replication will restore the original disk and the LVM volume group as 2 separate disks. This way, all
data, including the data within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Backup & Replication will
restore 4 disks. The restored disks will consume the storage space equal to the size of the 2 original
disks and the 2 LVM volume groups from these disks.
569 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restore to Hyper-V VM
The procedure of Instant Recovery for a Veeam Agent computer practically does not differ from the same
procedure for a VM. The main difference from Instant Recovery is that you do not need to select the r ecovery
mode, because Veeam Agent computers are always restored to a new location. To learn more, see the
Performing Instant Recovery of Workloads to Hyper-V section in the Veeam Backup & Replication User Guide.
570 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring Veeam Agent Backup to Nutanix
VM
You can use the Veeam Backup & Replication console to restore a Veeam Agent computer as a Nutanix AHV VM
in your virtualization environment.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot perform this operation with Veeam Agent backups stored in a Veeam Cloud Connect
repository.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Agent will restore
the original disk and the LVM volume group as 2 separate disks. This way, all data, including the data
within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks. The
restored disks will consume the storage space equal to the size of the 2 original disks and the 2 LVM
volume groups from these disks.
571 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Restore to Nutanix AHV
The procedure of restore to Nutanix AHV for a Veeam Agent computer practically does not differ from the same
procedure for a VM. To learn more about restore to Nutanix AHV, see the Restoring VMs Using Veeam Backup &
Replication Console section in the Veeam Backup for Nutanix AHV User Guide.
572 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Veeam Agent Backup to
Proxmox VM
You can use the Veeam Backup & Replication console to restore a Veeam Agent computer as a Proxmox VE VM
in your virtualization environment.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot perform this operation with Veeam Agent backups stored in a Veeam Cloud Connect
repository.
• [For backups of Linux computers]If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Agent will restore
the original disk and the LVM volume group as 2 separate disks. This way, all data, including the data
within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks. The
restored disks will consume the storage space equal to the size of the 2 original disks and the 2 LVM
volume groups from these disks.
573 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restore to Proxmox VE
The procedure of restore to Proxmox VE for a Veeam Agent computer practically does not differ from the same
procedure for a VM. To learn more about restore to Proxmox VE, see the Performing VM Restore section in the
Veeam Backup for Proxmox VE User Guide.
574 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring to Microsoft Azure
You can use the Veeam Backup & Replication console to restore computers from Veeam Agent backups to
Microsoft Azure.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot perform this operation with Veeam Agent backups stored in a Veeam Cloud Connect
repository.
• Veeam Agent backups must be created at the entire computer level or volume level.
• If you recover an EFI-based system to Microsoft Azure, Veeam Agent will restore a BIOS-based Generation
1 VM.
• Veeam Backup & Replication offers experimental support for generation 2 VMs within restore to Microsoft
Azure feature. To learn more, see the Generation 2 VM Support section in the Veeam Backup & Replication
User Guide.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Agent will restore
the original disk and the LVM volume group as 2 separate disks. This way, all data, including the data
within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks. The
restored disks will consume the storage space equal to the size of the 2 original disks and the 2 LVM
volume groups from these disks.
575 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restore to Microsoft Azure
The procedure of restore to Microsoft Azure from a Veeam Agent backup practically does not differ from the
same procedure for a VM backup. To learn more about restore to Microsoft Azure, see the Restoring to
Microsoft Azure section in the Veeam Backup & Replication User Guide.
576 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring to Amazon EC2
You can use the Veeam Backup & Replication console to restore computers from Veeam Agent backups to
Amazon EC2.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository
only. You cannot perform this operation with Veeam Agent backups stored in a Veeam Cloud Connect
repository.
• Veeam Agent backups must be created at the entire computer level or volume level.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Agent will restore
the original disk and the LVM volume group as 2 separate disks. This way, all data, including the data
within the LVM volume group, is accurately restored.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks. The
restored disks will consume the storage space equal to the size of the 2 original disks and the 2 LVM
volume groups from these disks.
577 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restore to Amazon EC2
The procedure of restore to Amazon EC2 from a Veeam Agent backup practically does not differ from the same
procedure for a VM backup. To learn more about restore to Amazon EC2, see the Restoring to Amazon EC2
section in the Veeam Backup & Replication User Guide.
578 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring to Google Compute Engine
You can use the Veeam Backup & Replication console to restore computers from Veeam Agent backups to
Google Compute Engine.
• You can use backups of Microsoft Windows and Linux computers stored in a Veeam backup repository. You
cannot perform this operation with Veeam Agent backups created on the Veeam Cloud Connect
repository.
• Veeam Agent backups must be created at the entire computer level or volume level.
• [For backups of Linux computers] If the disk you want to restore contains an LVM volume group, consider
the following:
o Since LVM volume group is a logical entity that spans across the physical disks, Veeam Agent treats
the original disk and the LVM volume group as separate entities. Therefore, Veeam Agent will restore
the original disk and the LVM volume group as 2 separate disks. This way, all data, including the data
within the LVM volume group, is accurately restored.
o Root file system partition and boot partition must not be on LVM logical volumes. For more
information on this limitation, see Google documentation.
o Restoring the original disk and the LVM volume groups as 2 separate disks requires an increased
amount of storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks. The
restored disks will consume the storage space equal to the size of the 2 original disks and the 2 LVM
volume groups from these disks.
579 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restore to Google Compute Engine
The procedure of restore to Google Compute Engine from a Veeam Agent backup practically does not differ
from the same procedure for a VM backup. To learn more about restore to Google Compute Engine, see the
Restoring to Google Compute Engine section in the Veeam Backup & Replication User Guide.
580 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Restoring Volumes
You can use Veeam Backup & Replication to restore a specific computer volume or all volumes from a volume-
level backup created with Veeam Agent for Microsoft Windows.
If data on a computer volume gets corrupted, you can restore this volume from the backup. For volume -level
restore, you can use backups that were created at the volume level. File-level backups cannot be used for
volume restore.
When you perform volume-level restore, Veeam Backup & Replication restores the entire content of the
volume. It retrieves from the backup data blocks pertaining to a specific volume and copies them to the
necessary location. Keep in mind that you cannot browse the volume in the backup and select individual
application items, files and folders for restore. For granular file-level restore, you can use the restore guest files
option.
A volume can be restored to its original location or a new location. If you restore the volume to its original
location, Veeam Backup & Replication overwrites data on the original volume. If you restore the volume to a
new location, and the target disk contains any data, Veeam Backup & Replication overwrites data in the target
location with data retrieved from the backup.
A volume can be restored to a new location that has greater or less space than the size of the volume in the
backup. Depending on the amount of free disk space on target location, you can select either to shrink or to
extend the volume during restore. To learn more, see the Volume Resize section in the Veeam Agent for
Microsoft Windows User Guide.
581 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Before You Begin
Before you begin the volume-level restore process, check the following prerequisites:
• The volume-level backup from which you plan to restore data must be successfully created at least once.
• A computer on which you want to restore a volume must be added to the Veeam Backup & Replication
inventory and run Veeam Agent for Microsoft Windows operating in the managed mode.
• You can restore volumes only from backups created with Veeam Agent for Microsoft Windows.
• You cannot restore a system volume to a system volume of the original Veeam Agent computer or another
computer with the running OS. To perform such restore, you need to boot the OS from the recovery
image. To learn more, see Restoring Data with Veeam Recovery Media. You can also restore a system
volume to a non-system volume that has enough free space.
• You cannot restore a volume to a volume on which the Microsoft Windows swap file is hosted.
582 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 1. Launch Volume Level Restore Wizard
To launch the Volume Level Restore wizard, do either of the following:
• Open the Home tab and click Restore > Ag ent > Disk restore > Volume restore. In this case, you will be
able to select a backup of the necessary Veeam Agent computer a t the Backup step of the wizard.
• Open the Home view. In the inventory pane, click the Ba ckups node. In the working area, expand the
necessary Veeam Agent backup, select the necessary computer in the backup and click Restore Volumes
on the ribbon or right-click the computer and select Volume restore. In this case, you will proceed
immediately to the Restore Point step of the wizard.
583 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Backup
At the Ba ckup step of the wizard, select a backup from which you want to recover data.
To quickly find the necessary backup, use the search field at the bottom of the window: enter a backup name or
a part of it in the search field and click the Sta rt search button on the right or press [E NTER].
In the list of backups, Veeam Backup & Replication displays only volume-level backups created with Veeam
Agent for Microsoft Windows. File-level backups and backups created with Veeam Agent for Linux are not
displayed.
584 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Select Restore Point
At the Restore P oint step of the wizard, select a restore point from which you want to recover data.
By default, Veeam Backup & Replication uses the latest restore point. However, you can select any valid restore
point to recover volumes to a specific point in time.
Veeam Backup & Replication displays restore points for volume-level backups only. For example, if you have run
3 job sessions to create a backup of all computer volumes and then changed the backup scope to file -level
backup, Veeam Backup & Replication will display only 3 restore points in the list.
1. Select a restore point from the Ava ilable restore points section.
2. [For restore from backups created by pre-installed Veeam Agents] Do the following:
a. In the Ag ent Credentials window, select the Veeam Agent computer which volumes you want to
restore and click Set.
b. In the Credentials window, specify credentials for the user account that has access to the protected
computer. Veeam Backup & Replication will not store these credentials in its database.
585 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Map Restored Disks
At the Disk Mapping step of the wizard, select what volumes you want to restore and map volumes from the
backup to volumes on the target computer.
IMP ORTANT
It is strongly recommended that you change disk mapping settings only if you have experience in working
with Microsoft Windows disks and partitions. If you make a mistake, your computer data may get
corrupted.
1. In the Destination host field, specify the target computer where you want to restore volumes. Click
Choose and select the necessary computer. You can restore volumes only to computers that are added to
the Veeam Backup & Replication inventory and run Veeam Agent for Microsoft Windows.
2. In the Disk mapping section, select check boxes next to volumes that you want to restore from the
backup. By default, Veeam Backup & Replication restores volumes to their initial location and maps the
restored volumes automatically. If the initial location is unavailable, a volume is restored to a disk of the
same or larger size. If you want to map the restored volume to another computer disk, at the bottom of
the wizard click Customize disk mapping.
NOTE
If Veeam Backup & Replication cannot map a volume automatically, Veeam Backup & Replication will
prompt you to perform disk mapping manually. To proceed to the Disk Mapping window, click Y es .
o Right-click the target disk on the left and select the necessary disk layout:
▪ Ap p ly Backup Layout — select this option if you want to apply to disk the settings that were
used on your computer at the moment when you performed backup.
▪ Ap p ly Disk Layout — select this option if you want to apply to the current disk settings of
another disk.
586 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
▪ E rase — select this option if you want to discard the current disk settings.
o Right-click unallocated disk space in the disk area on the right and select what volume from the
backup you want to place on this computer disk.
If you want to change disk layout configured by Veeam Backup & Replication, right-click an
automatically mapped volume and select Remove. You will be able to use the released space for
mapping volumes in your own order.
4. [For restore with volume resize] You can resize a volume mapped by Veeam Backup & Replication to a
target computer disk. To resize a volume, right-click it in the Disk Mapping window and select Resize. With
this option selected, you will pass to the Volume Resize window.
587 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
If you map a backup volume that is larger than the amount of available space on the target disk,
Veeam Backup & Replication will prompt you to shrink the restored volume. After you agree and click
OK, Veeam Backup & Replication will prepare to shrink the volume to the size of available disk space.
588 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 5. Resize Restored Volumes
At the Disk Mapping step of the wizard you can set the necessary size for the restored volumes. A volume will
be shrunk or extended to the specified size during the process of da ta restore.
NOTE
By default, Veeam Agent for Microsoft Windows displays volume size in megabytes (MB). This allows you
to specify the desired size for the volume precisely. You can also choose to display volume size in
gigabytes (GB). This may be helpful when you need to resize volumes on larger computer disks and want to
simplify disk size calculations.
When you use GB as a volume size unit, you can specify volume size with integral numbers, for example, 1
GB, 60 GB or 200 GB, but not 0,8 GB, 60,5 GB or 200,7 GB. However, if the maximum volume size is in
fact greater than the displayed value for less than 1 GB, Veeam Agent for Microsoft Windows will
automatically add the exceeding amount of disk space to the extended volume. For example, if the
maximum volume size is 60,2 GB, Veeam Agent for Microsoft Windows will display this size as 60 GB.
When you specify 60 GB as a desired volume size, Veeam Agent for Microsoft Windows will extend the
volume to 60,2 GB.
To resize a volume:
b. [For volume shrink] Right-click unallocated disk space and select what volume from the backup you
want to place on the computer disk. If the selected volume is larger than the amount of unallocated
disk space, Veeam Backup & Replication will prompt you to shrink the restored volume.
2. In the Volume Resize window, select the volume size unit and specify the desired size for the restored
volume.
589 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 6. Specify Secure Restore Settings
At the Secure Restore step of the wizard, you can instruct Veeam Backup & Replication to perform secure
restore. To learn more about secure restore, see the Secure Restore section in the Veeam Backup & Replication
User Guide.
a. If you want to scan the restored volume with antivirus software, select the Sca n the restore point with
a n a ntivirus engine check box. For more information on antivirus scan, see the Antivirus Scan (Secure
Restore) section in the Veeam Backup & Replication.
b. If you want to scan the restored volume with a YARA rule, select the Sca n backup content with the
following YARA rule check box and select a YARA rule from the drop-down list. By default, the YARA
rules are located in the folder by the following path: C:\Program Files\Veeam\Backup and
Replication\Backup\YaraRules.
2. In the Sca n options section, select the Continue scanning all remaining files after the first occurence check
box if you want to continue volume scan after the first malware threat is found. For information on how to
view results of the antivirus scan, see the Viewing Malware Scan Results section in the Veeam Backup &
Replication User Guide.
590 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Specify Restore Reason
At the Rea son step of the wizard, enter a reason for restoring the computer volume.
TIP
If you do not want to display the Restore Reason step of the wizard in future, select the Do not show me
this page again check box.
591 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Complete Restore Process
At the Summary step of the wizard, complete the procedure of volume-level restore.
2. Click Finish to start the recovery process. Veeam Backup & Replication will perform partition re-allocation
operations if necessary, restore the necessary volume data from the backup and overwrite volume data on
the target computer with the restored data.
592 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Files and Folders
You can use the Veeam Backup & Replication console to restore individual files and folders from Veeam Agent
backups.
The procedure of file-level restore from a Veeam Agent backup is similar to the same procedure for a VM
backup. To learn more about file-level restore, see the Restore from Microsoft Windows File Systems and
Restore from Linux, Unix and Other File Systems sections in the Veeam Backup & Replication User Guide.
• [For backups of Microsoft Windows computers] For file-level restore, you can only use Veeam Agent
backups stored in a Veeam backup repository or Veeam Cloud Connect repository. For Veeam Agent
backups created in the cloud repository, you can perform restore tasks in Veeam Backup & Replication
deployed on the tenant backup server. The service provider cannot perform res tore tasks with Veeam
Agent backups.
• [For backups of Linux, Unix and Mac computers] For file-level restore, you can only use Veeam Agent
backups stored in a Veeam backup repository.
• [For backups of Microsoft Windows computers] Before you start file-level restore from a backup of a
failover cluster, make sure that the cluster is added to a protection group in the Veeam Backup &
Replication inventory. The failover cluster may be not present in the inventory, for example, in the
following cases:
o The original protection group that contained the cluster was removed from Veeam Backup &
Replication.
o You want to restore cluster data from a backup created on another backup server and imported in the
Veeam backup console.
In this case, add the failover cluster whose data you want to restore to a protection group.
• [For backups of Linux, Unix and Mac computers] When you perform the file-level restore procedure,
Veeam Backup & Replication provides the following options for mounting disks of the machine f rom the
backup or replica:
o Mounting disks to a helper host — any Linux host from your infrastructure with a supported operating
system. You can also mount disks from the Veeam Agent for Linux backup to the original host.
o Mounting disks to a temporary helper appliance — a helper VM required to mount Linux computer
disks from the backup.
If you have selected to mount disks to a temporary helper appliance, it is recommended that you add
a vCenter Server and not a standalone ESXi host in the Veeam backup console. If Veeam Backup &
Replication is set up to deploy a helper appliance on a standalone ESXi host, after Veeam Backup &
Replication removes the helper appliance, the helper VM will be displayed in vCenter as orphaned .
• [For backups of Mac computers] You cannot restore files or folders from Veeam Agent for Mac backup to
the original machine. You can only save files and folders to a new location over the network by using the
Cop y To option.
593 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Application Items
You can use Veeam Explorers to restore application items from backups created using Veeam Agent for
Microsoft Windows and Veeam Agent for Linux. Veeam Backup & Replication lets you restore items and objects
from the following applications:
• Microsoft Exchange
• Microsoft SharePoint
• Oracle
• Oracle
• PostgreSQL
The procedure of application item restore from a Veeam Agent backup does not differ from the same procedure
for a VM backup. To learn more, see the Application Item Restore section in the Veeam Backup & Replication
User Guide.
594 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Exporting Disks
You can restore computer disks from Veeam Agent backups created using Veeam Agent for Microsoft Windows
and Veeam Agent for Linux and convert them to disks of the VMDK, VHD or VHDX format.
During disks restore, Veeam Backup & Replication creates standard virtual disks that can be used by VMware
vSphere and Microsoft Hyper-V VMs.
• When you restore a disk in the VMDK format, Veeam Backup & Replication creates a pair of files that make
up the VM virtual disk: a descriptor file and file with the virtual disk content.
• When you restore a disk in the VHD/VHDX format, Veeam Backup & Replication creates a file of the VHD
or VHDX format.
You can save converted disks locally on any server or SMB share added to the backup infrastructure or place
disks on a datastore connected to an ESXi host (for VMDK disk format only). VMDK disks can be restored as thin
provision and thick disks:
Veeam Backup & Replication supports batch disk restore. For example, if you choose to restore 2 computer
disks, Veeam Backup & Replication will convert them to 2 virtual disks and store these disks in the specified
location.
IMP ORTANT
• If the backup from which you restore disks contains a Btrfs storage pool, during the disk restore
process Veeam Backup & Replication will create a separate disk and restore the Btrfs pool to this
disk.
• If the disk you want to restore contains an LVM volume group, Veeam Agent will restore the original
disk and the LVM volume group as 2 separate disks. Among other things, this leads to the increase
of the required storage space. For example, you restore a machine with 2 disks, and a separate LVM
volume group is configured on each of these disks. In this case, Veeam Agent will restore 4 disks.
The restored disks will consume storage space equal to the size of 2 original disks and 2 LVM volume
groups from these disks.
To restore disks and convert them to the VMDK, VHD or VHDX format, perform the following steps in the
E x port Disk wizard:
595 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 1. Launch Export Disk Wizard
To launch the E x port Disk wizard, do either of the following:
• Open the Home tab and click Restore > Ag ent > Disk restore > E xport disk. In this case, you will be able to
select a backup of the necessary Veeam Agent computer at the Backup step of the wizard.
• Open the Home view. In the inventory pane, click the Ba ckups node. In the working area, expand the
necessary Veeam Agent backup, select the necessary computer in the backup and click E x port Disks on the
ribbon or right-click a computer in the backup and select E x port content as virtual d isks.
In this case, you will pass immediately to the Restore Point step of the wizard.
596 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Backup
At the Ba ckup step of the wizard, select a backup from which you want to restore disks. In the list of backups,
Veeam Backup & Replication displays all backups that are currently hosted on the Veeam backup repository and
Veeam Cloud Connect repository.
597 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Select Restore Point
At the Restore P oint step of the wizard, select the necessary restore point from which you want to restore disks.
In the list of points, Veeam Backup & Replication displays all restore points that have been created. Make sure
that you select a restore point that relates to the selected backup.
598 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Select Disks
At the Disks step of the wizard, select check boxes next to those disks that you want to export.
599 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 5. Select Destination and Disk Format
At the Ta rget step of the wizard, select the destination for disk export and format in which you want to save the
resulting virtual disk.
1. From the Server list, select a server on which the resulting virtual disks must be saved. If you plan to save
the disks in the VMDK format on a datastore, select an ESXi host to which this datastore is connected.
2. In the P a th to folder field, specify a folder on the server or datastore where the virtual disks must be
placed.
o VMDK — select this option if you want to save the resulting virtual disk in the VMware VMDK format.
o VHD — select this option if you want to save resulting virtual disk in the Microsoft Hyper -V VHD
format.
o VHDX — select this option if you want to save resulting virtual disk in the Microsoft Hyper -V VHDX
format (supported by Microsoft Windows Server 2012 and later).
4. Click Disk type to specify how the resulting disk must be saved:
o [For VMDK disk format] in the thin provisioned, lazy zeroed thick provisioned, or eagerly zeroed thick
provisioned format
o [For VHD and VMDX disk formats] in the dynamic or fixed format
5. [For export of a VMDK disk to an ESXi host] Click the P ick proxy to use link to select backup proxies over
which backup data must be transported to the target datastore.
600 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
NOTE
• If you have selected to store the resulting virtual disk in a datastore, you will be able to save the
virtual disk in the VMDK format only. Other options will be disabled.
• If you have selected to store the resulting virtual disk on the server running Microsoft Windows
Server OS and in the VMDK format, you will be able to save the virtual disk in the lazy zeroed thick
provisioned format only.
601 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Secure Restore Settings
IMP ORTANT
The Secure Restore step of the wizard is available if you export disks from a Veeam Agent backup of a
Microsoft Windows computer.
At the Secure Restore step of the wizard, you can instruct Veeam Backup & Replication to perform secure
restore — scan restored disk data with antivirus software before restoring the disk. To learn more about secure
restore, see the Secure Restore section in the Veeam Backup & Replication User Guide.
a. To use antivirus software as a scan engine, select the Sca n the restore point with an antivirus engine
check box. For more information on antivirus scan, see the Antivirus Scan (Secure Restore) section in
the Veeam Backup & Replication User Guide.
b. To use a YARA rule as a scan engine, select the Sca n the restore point with the following YARA rule
check box and choose a YARA rule from the drop-down list. By default, the YARA rules are located in
the folder by the following path: C:\Program Files\Veeam\Backup and
Replication\Backup\YaraRules.
2. Instruct Veeam Backup & Replication what to perform in case malware is found:
o Select P roceed with recovery if you want to continue the recover process, despite the found malware
threat.
o Select Ab ort disk recovery if you want to stop the recovery process after the first malware threat is
found.
602 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. In the Sca n options section, select the Continue scanning all remaining files after the first occurrence
check box if you want the antivirus software to continue volume scan after the first malware threat is
found. For information on how to view results of the antivirus scan, see the Viewing Malware Scan Results
section in the Veeam Backup & Replication User Guide.
603 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 7. Specify Restore Reason
At the Rea son step of the wizard, enter a reason for restoring the computer volume.
TIP
If you do not want to display the Restore Reason step of the wizard in future, select the Do not show me
this page again check box.
604 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 8. Complete Restore Process
At the Summary step of the wizard, complete the disk restore procedure.
2. Click Finish to start the restore procedure and exit the wizard.
605 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Publishing Disks
You can use the Veeam backup console to publish disks from backups created by Veeam Agent backup jobs and
backup copy jobs.
TIP
You can publish disks using the PowerShell console. To learn more, see the Disk Publishing (Data
Integration API) section in the Veeam PowerShell Reference.
Disk publishing allows you to save time by getting backup content of one or multiple disks instead of all disks
from a backup. This technology gives read-only access to data and helps if you want to analyze data of your
backup. For example, look for specific documents or usage patterns, or perform antivirus scan of backed -up
data.
Disk publishing uses the iSCSI protocol for Microsoft Windows-based Veeam Agent computers and the FUSE
protocol for Linux-based, Unix-based and macOS-based Veeam Agent computers. After the publishing, the
target server can access the backup content using the iSCSI initiator or FUSE protocol, and read the necessary
data from the disk.
To learn more, see the Disk Publishing section in the Veeam Backup & Replication User Guide.
606 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Performing Disk Publish
Before you publish disks, check prerequisites. Then use the P ub lish Disks wizard.
4. Select disks.
• The necessary ports must be opened on the target server. For more information, see Ports.
• The target server must support the file system of the disk that you plan to publish.
• If data deduplication is enabled for some disks in a backup, data deduplication must be enabled on the
target server.
• [For Microsoft Windows-based Veeam Agent computers] The target Microsoft Windows server must
support the same ReFS version or later than the version used on the Veeam Agent computer from which
you plan to publish disks. For more information on which OSes support which ReFS, see the ReFS versions
and compatibility matrix.
• [For Linux-based, Unix-based and macOS-based Veeam Agent computers] The 32-bit version of a Linux
server is not supported as the target server.
• [For Linux-based, Unix-based and macOS-based Veeam Agent computers] You cannot publish disks from
backups stored in the Veeam Cloud Connect repository.
For the full list of limitations, see the Considerations and Limitations section in the Veeam Backup & Replication
User Guide.
607 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch Publish Disks Wizard
To launch the P ub lish Disks wizard, do either of the following:
• On the Home tab, click Restore > Ag ent > Disk Restore > P ublish disk.
• Open the Home view. In the inventory pane, click Ba ckups. In the working area, expand the necessary
Veeam Agent backup, select a computer whose disks you want to publish and click P ub lish Disks on the
ribbon. Alternatively, you can right-click the computer and select P ub lish disks. In this case, you will
proceed to the Restore point step of the wizard.
608 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 2. Select Computer
At the Ma chine step of the wizard, expand a backup and select a Veeam Agent computer whose disks you want
to publish.
609 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Select Restore Point
At the Restore P oint step of the wizard, select a restore point from which you want to publish disks.
610 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 4. Select Disks
At the Disks step of the wizard, select a check box next to the disks that you want to publish. Click Select All if
you want to select all disks from the backup.
611 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 5. Select Target Server
At the Ta rget step of the wizard, select a server that will have access to disk content. You can select the
following servers depending on the OS of the Veeam Agent computer:
• Linux server — for Linux-based, Unix-based and macOS-based Veeam Agent computers.
• A temporary server. In this case, select Specify a different host from the drop-down list. In the Ta rget
Server window, specify the following settings:
a. In the Host name field, specify a server name or IP address of the server.
b. Select the account from the Credentials list. If you have not set up credentials beforehand, click the
Ma nage accounts link or click Ad d on the right to add a new account in the Credentials Manager. To
learn more, see the Credentials Manager section in the Veeam Backup & Replication User Guide.
c. [For Linux-based, Unix-based and macOS-based Veeam Agent computers] Click Ad vanced and
customize connection settings in the Network Settings window . To learn more, see Customizing
Connection Settings.
• [For Microsoft Windows-based and Linux-based Veeam Agent computers] The original server. In this case,
select Original server from the drop-down list.
612 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
If prompted, specify credentials for the target server.
2. In the Da ta transfer options section, specify connection settings for file copy operations.
3. [For Linux server deployed outside NAT] In the P referred TCP connection role section, select the Run
server on this side check box.
613 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To learn more about these settings, see the Specify Credentials and SSH Settings section in the Veeam Backup &
Replication User Guide.
614 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Step 6. Specify Restore Reason
At the Rea son step of the wizard, enter a reason for publishing disks.
TIP
If you do not want to show this page, select the Do not show me this page again check box. If you further
will want to return this page, follow the instructions described in this Veeam KB article.
615 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 7. Finish Working with Wizard
At the Summary step of the wizard, review the configured settings and click Finish.
• [For Linux servers] Go to the /tmp/Veeam.Mount.Disks location to browse disks images. Go to the
/tmp/Veeam.Mount.FS location to browse disks content.
After you started a disks publishing session, you can view the session statistics or stop the session from the
Veeam backup console. To learn more, see Managing Publishing Disks Session.
616 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Managing Publishing Disks Session
After you started a publishing session, you can check details about the session or stop it.
• Open the Home view. In the inventory pane, select Instant Recovery. In the working area, select the
necessary publishing session and click P roperties on the ribbon. Alternatively, right-click the session and
P roperties.
• Open the Home view. In the inventory pane select La st 24 hours. In the working area, double-click the
necessary publishing session. Alternatively, you can select the session and click Sta tistics on the ribbon or
right-click the session and select Sta tistics.
• Open the History view. In the inventory pane select Restore. In the working area, double-click the
necessary publishing session. Alternatively, you can select the session and click Sta tistics on the ribbon or
right-click the session and select Sta tistics.
• At the top of the Restore Session window, Veeam Backup & Replication shows general session statistics. It
includes a name of the Veeam Agent computer whose disk you want to publish, a name of the backup
server which initiated the publishing session, a user name of the account under which the session was
started, session status and duration details.
• The Rea son tab shows the reason for the publishing session.
• The P a rameters tab shows information about the target server, the Veeam Agent computer whose disks
you publish and the restore point selected for publishing.
617 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• The Log tab shows the list of operations performed during the session.
• Open the Home view. In the inventory pane select Instant Recovery. In the working area, double-
click the necessary publishing session and click Ca ncel restore task in the Restore Session window.
Alternatively, you can select the necessary publishing session and click Stop Publishing on the
ribbon or right-click the session and click Stop Publishing.
• Open the Home view. In the inventory pane select La st 24 hours. In the working area, double-click
the necessary publishing session and click Ca ncel restore task in the Restore Session window.
Alternatively, you can select the necessary publishing session and click Stop on the ribbon or right-
click the session and click Stop session.
618 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Open the History view. In the inventory pane select Restore. In the working area, select the
necessary publishing session and double-click it. In the Restore Session window, click Ca ncel restore
ta sk. Alternatively, you can right-click the publishing session and click Stop session.
619 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Exporting Restore Point to Full Backup File
You can restore data from a specific restore point in a Veeam Agent backup and export this data to a standalone
full backup file. The procedure of Veeam Agent backup export does not differ from the same procedure for a
VM. To learn more, see the Exporting Backups section in the Veeam Backup & Replication User Guide.
620 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Managing Veeam Agent Backups
You can perform administration tasks with backups created on a Veea m backup repository by Veeam Agent
backup jobs configured in Veeam Backup & Replication. For such Veeam Agent backups, Veeam Backup &
Replication allows you to perform the following tasks:
• Scan backup.
621 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Using SureBackup
A SureBackup job is a task for recovery verification. You can run the SureBackup job manually or schedule it to
run automatically.
• Full recoverability testing. Veeam Backup & Replication runs machines in an isolated environment directly
from backup and performs tests against live applications.This mode ensures recoverability of your
production workloads in a disaster recovery event. To learn more, see the Full Recoverability Testing
section in the Veeam Backup & Replication User Guide.
• Ba ckup verification and content scan only. Veeam Backup & Replication performs backup integrity check
and its content analysis to detect traces of malware or any other unwanted or sensitive data. These tests
do no require setting up a virtual lab or an application group. To learn more, see the Backup verification
and content scan only section in the Veeam Backup & Replication User Guide.
Getting Started
Before you configure a SureBackup job that will test your backup, you must complete the following steps:
1. Consider limitations listed in section Recovery Verification for Veeam Agent Backups.
2. Prepare a backup that you will test using the SureBackup job:
a. Add a computer to the inventory and deploy Veeam Agent on this computer using the Veeam Backup
& Replication console. To learn more, see Creating Protection Groups.
b. Create a backup job with the E ntire machine or Volume level backup mode selected in the job
settings. To learn more, see Working with Veeam Agent Backup Jobs and Policies.
3. [For full recoverability testing mode] Configure the backup infrastructure to create the SureBackup job:
a. Add a virtual lab. The virtual lab is an isolated virtual environment in which Veeam Backup &
Replication will test your backups. VMware vSphere and Microsoft Hyper-V servers are supported. To
learn more, see the Creating Virtual Lab section in the Veeam Backup & Replication User Guide.
TIP
You can add a virtual lab during creating a SureBackup job at the Virtual Lab step of the New
SureBackup Job wizard.
b. Add an application group. The application group provides a fully functional work for a host or a group
of hosts that is created by Veeam Agent to test your backup. To learn more, see the Creating
Application Groups section in the Veeam Backup & Replication User Guide.
When you configure the application group, you must add the backup you want to test to this group.
622 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
TIP
• You can add an application group during creating a SureBackup job at the Application
Group step of the New SureBackup Job wizard.
• The application group is optional for the SureBackup job. If you do not create an
application group, you can still use a backup job as a source of backups for the
SureBackup job. In this case the SureBackup job will test all Veeam Agent backups
created by this backup job. To learn more, see Creating SureBackup Job.
After all preparations are done, you can create the SureBackup job.
623 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Creating SureBackup Job
To create a new SureBackup job, use the New SureBackup Job wizard.
1. On the Home tab, click the SureBackup Job to launch the SureBackup Job wizard.
2. At the Na me step of the wizard, specify a name, description and backup verification mode for the
SureBackup job.
624 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
3. [For full recoverability testing mode] At the Virtual Lab step of the wizard, select or add a virtual lab that
Veeam Backup & Replication will use to recover your computer as a VM.
4. [For full recoverability testing mode] At the Ap p lication Group step of the wizard, select or add an
application group with backups you want to test.
625 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
You can skip this step and add a backup job as a source of backups at the Linked Jobs step of the
wizard.
5. At the Link ed Jobs step of the wizard, add a backup job to use as a source of backups for the SureBackup
job and specify settings for backup job processing. To learn more, see the Link Backup or Replication Job
and Specify Recovery Verification Options and Tests sections in the Veeam Backup & Replication User
Guide.
626 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
[For full recoverability testing mode] You can skip this step if you selected an application group at
the Application Group step of the wizard.
6. At the Settings step of the wizard, specify additional settings for the SureBackup job. To learn more, see
the Specify Additional Job Settings section in the Veeam Backup & Replication User Guide.
627 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
7. At the Schedule step of the wizard, select the Run the job a utomatically check box and specify time and
days the job must start. By default, the SureBackup job starts daily at 10:00 PM.
8. At the Summary step of the wizard, select the Run the job when I click Finish check box if you want to
start the SureBackup job right after you finish working with the wizard.
9. Click Finish
628 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Moving Backup
You can move backups created with Veeam Agent in the following ways:
NOTE
The move backup feature does not support moving backups between extents of a scale -out backup
repository. To learn how to manage backups within the scale-out backup repository, see the Scale-Out
Backup Repositories section in the Veeam Backup & Replication User Guide.
• If you move backups from an immutable repository, the move operation does not delete the backups from
the original repository. In this case, backups from the original repository are deleted according to the
retention policy. For more information, see Backup Immutability.
• [For Veeam Agent backup policies] You cannot move backups to/from/between object storage
repositories.
• [For Veeam Agent backup jobs] You cannot move a backup to another job if the targe t job already contains
a backup of the same Veeam Agent computer or protection group.
• [For Veeam Agent backup jobs] You cannot move an encrypted backup to a job where encryption is not
enabled and the other way around.
To learn about how moving to another repository and moving to another job work, see the How Moving to
Another Repository Works and How Moving to Another Job Works sections in the Veeam Backup & Replication
User Guide.
For the full list of limitations, see the Requirements and Limitations section in the Veeam Backup & Replication
User Guide.
You cannot move to another job backups created by a backup job managed by Veeam Agent (backup
policy).
3. In the working area, expand the backup whose files you want to move, right-click the backup and select
Move backup or click Move backup on the ribbon.
629 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
4. In the Move Backup to Another Job window, select the target backup job to which you want to move your
backup.
Keep in mind that Veeam Backup & Replication displays only those backup jobs in the list that have the
same backup mode and backed-up computer type as the original backup job. For example, if the original
job is a backup job managed by Veeam backup server for Windows-based computers, Veeam Backup &
Replication will display in the list only backup jobs managed by Veeam backup server for Windows -based
computers.
5. Click OK.
• The backup is moved to the repository specified in the settings of the target backup job.
• In the Veeam Backup & Replication console, all restore points of the backup are displayed in the node of
the target backup job.
NOTE
• When you move a backup to another backup job, Veeam Backup & Replication disables the original
backup job only for the period of the move operation. If you do not want the original backup job to
create new backups after the move, you must edit the backup job settings or disable the backup job.
For more information, see Managing Veeam Agent Backup Jobs.
• If you want to map the target backup job to the moved backup files, you must add the computers
protected by the original backup job to the settings of the target backup job. In this case, the target
backup job will continue the backup chain for the moved backups after the start. For more
information, see Adding Protection Groups and Computers from Inventory.
630 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Moving Backup to Another Repository
To move a backup to another repository, do the following:
3. In the working area, select the necessary backup job or backup policy.
4. Right-click the job or the policy and select Move backup. Alternatively, click Move Backup on the ribbon.
5. In the Move Backup to Another Location window, select the repository to which you want to move
backups.
6. Click OK.
TIP
You can also change the repository in backup job or backup policy settings. After you change the
repository, Veeam Backup & Replication will suggest moving backups from the original repository to a new
repository. You can select to move backups or leave them in the original repository.
To learn how to edit backup job and backup policy settings, see Editing Veeam Agent Backup Job Settings
and Editing Backup Policy Settings.
631 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. In the inventory pane, select the La st 24 Hours node.
3. Right-click the failed move session and select the required action or select the required action on the
ribbon:
During the retry operation, Veeam Backup & Replication does not relaunch the move oper ation for the
whole backup. Veeam Backup & Replication tries to copy or delete those backup files that were not
copied or deleted during the move.
The detached backups will be shown under the Ba ckups > Orphaned node in the inventory pane.
NOTE
The Detached failed operation is not available for Veeam Agent backup policies.
NOTE
The original backup job will be in the disabled state until you finalize the failed move operation.
632 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Copying Backup
You can copy backups created by a backup job managed by Veeam backup server. This functionality allows you
to create several copies of the same backup in different locations, whether onsite or offsite. Backup copies have
the same format as files created by backup jobs and you can recover your data from them when you need it.
When Veeam Backup & Replication performs the copy operation, it disables the job, copies files to the target
location and then enables the job. To learn more, see the Copying Backups section of the Veeam Backup &
Replication User Guide.
NOTE
• You cannot copy backups created by a backup job managed by Veeam Agent (backup policy). To
learn about types of Veeam Agent backup jobs, see Veeam Agent Backup Jobs and Policies.
• The copy backup feature does not support copying backups between extents of a scale -out backup
repository. To learn how to manage backups within the scale-out backup repository, see the Scale-
Out Backup Repositories section in the Veeam Backup & Replication User Guide.
3. In the working area, right-click the backup and select Cop y backup.
4. In the Cop y Backup to Another Location window, choose where you want to copy backups — to a
repository or to a local or shared folder.
633 | V eeam Backup & Replication | V eeam A gent Management Guide | 12.2.0.334
Managing Failed Activities
If the copy operation fails, Veeam Backup & Replication assigns the User action required status to it. In this case,
you need to decide how to finish the operation:
3. Right-click the failed copy session and select the required action or select the required action on the
ribbon:
During the retry operation, Veeam Backup & Replication does not relaunch the copy operation for the
whole backup. Veeam Backup & Replication tries to copy those backup files that were not copied
during the move.
NOTE
The original backup job will be in the disabled state until you finalize the failed copy operation.
634 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Performing Backup Copy for Veeam Agent
Backups
You can configure backup copy jobs that will copy backups created with Veeam Agent to a secondary backup
repository.
Backup copy jobs treat Veeam Agent backups as usual backup files. The backup copy job setup and processing
procedures practically do not differ from the same procedures for a backup copy job that processes VM backups.
To learn more about backup copy jobs, see the Backup Copy section in the Veeam Backup & Replication User
Guide.
• When you copy Veeam Agent backup jobs that process failover clusters, the backup copy job ignores
the Use p er-machine backup files option enabled for the backup repository and creates a single backup
copy file for each failover cluster.
To learn more, see the Backup Chain Formats section in the Veeam Backup & Replication User Guide.
• When you copy Veeam Agent backup jobs that process failover clusters with shared disks, the network
traffic is higher compared to the traffic sent when Veeam Agent backup jobs run. This happens because
Veeam Agent backup copy jobs send data as it is stored in the storage — each node with the cloned data —
unlike Veeam Agent backup jobs that send data of shared disks only with the owner node and then, within
the target storage, clone this data to other nodes.
• Data deduplication is not available when you copy Veeam Agent backup jobs that process failover clusters
with shared disks to an object storage repository.
IMP ORTANT
In this case, you may require additional free space on the target location, because Veeam Backup &
Replication creates in the target location as many copies of the cluster shared disks as there a re
nodes in the cluster.
635 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
• [For the legacy periodic copy mode] You can map a Veeam Agent backup copy job only to a backup
created by backup copy job that processes backups created by Veeam Agent operating in the standalone
mode.
To overcome this limitation, you can delegate the restore task to backup administrators who work with Veeam
Backup & Replication. Backup administrators can use Veeam Backup & Replication options to recover data from
such backups: for example, perform file-level restore or retrieve necessary application items with Veeam
Explorers.
You can also restore data from the copied backup stored in the target repository using Veeam Agent.
636 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Archiving Veeam Agent Backups to Tape
You can configure backup to tape jobs to archive Veeam Agent backups to tape.
Backup to tape jobs treat Veeam Agent backups as usual backup files. The archiving job setup and processing
procedures practically do not differ from the regular ones. To learn more about backup to tape jobs, see the
Backup to Tape section in the Veeam Backup & Replication User Guide.
NOTE
For the After this job option in the backup to tape job schedule settings, you cannot select a backup job
managed by Veeam Agent or a standalone Veeam Agent backup job as the preceding backup job.
637 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Recovery Token
If you want to recover volumes or an entire computer protected with Veeam Agent for Microsoft Windows or
Veeam Agent for Linux from a specific backup, you can use the Create recovery token operation.
You can generate the recovery token on the Veeam Backup & Replication side. Then, on the computer side, w ith
this recovery token get access to the backup and recover data that is stored in the backup. To learn more, see
one of the following sections depending on Veeam Agent you work with:
• You can recover data only from the backup for that the recovery token is generated.
• During recovery, Veeam Backup & Replication does not stop backup operations .
• You cannot create a recovery token for backups stored in Veeam Cloud Connect repository.
• You cannot create a recovery token for a whole backup copy job, but you can create a recovery token for
individual objects included in a backup copy job.
• If you work with scale-out backup repositories (SOBR), you cannot create a recovery token for backups
displayed in Ca pacity and Archive nodes in the inventory pane. To create a recovery token for such
backups, select the backup in the Ba ckups node in the inventory pane.
3. In the working area, right-click the backup and select Create recovery token.
You can create a recovery token for several backups. To do this, press and hold the [Ctrl] key, select
multiple backups, right-click one of the selected backups and select Create recovery token.
You can also create and modify the existing recovery token using the PowerShell console. To learn more, see the
Working with Tokens section in the Veeam PowerShell Reference.
638 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
Alternatively, you can get access to the backup using user credentials. To learn more, see one of the
following sections depending on Veeam Agent you work with:
639 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Creating Veeam Recovery Media from
Backup
You can create the Veeam Recovery Media for a Microsoft Windows computer whose Veeam Agent backup
resides on a Veeam backup repository or Veeam Cloud Connect repository. For this operation, you can use a
backup created by any type of a Veeam Agent backup job: a backup job managed by the backup server or backup
job managed by Veeam Agent (backup policy).
Creating the Veeam Recovery Media for a computer in a backup does not differ from creating the Veeam
Recovery Media for a protected computer in the Veeam Backup & Replication inventory. To learn more, see
Creating Veeam Recovery Media.
3. In the working area, expand the Veeam Agent backup, select the necessar y computer in the backup and
click Recovery Media on the ribbon or right-click the computer and select Create recovery media.
640 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Detaching Backup from Job
If you want a backup job to stop processing backup files, you can use the Detach from job operation.
When you detach backups from a job, the backup job will create an active full backup during the next run. This
active full backup will reset the backup chain. All incremental backup files will use this active full backup file as
a new starting point. A previously used full backup file and its subsequent incremental backup files will remain
in the backup repository and also in the Veeam Backup & Replication console. Veeam Backup & Replication
shows the detached backups in the Ba ckups > Disk ( Orphaned) node of the Home view. Veeam Backup &
Replication manages such backups depending on the short-term retention that was set for the backup job:
• If the detached backups belonged to the job with retention period set in days, the background retention
process retains the backups according to the configured retention and deletes the backups from the
repository after the retention period ends. To learn more, see the Background Retention section in the
Veeam Backup & Replication User Guide.
• If the detached backups belonged to the job with retention period set in restore points, the background
retention process does not delete the backups. If you do not need the backups, you must delete them
manually. To learn more about how to delete backups manually, see Deleting Backup from Disk.
• Before detaching backups from a backup job, you must disable this backup job and all depending
secondary backup jobs.
• You cannot detach backups of individual objects included in a backup job. You can only detach all backups
of a backup job.
641 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. In the working area, click Delete from > Job on the ribbon or right-click the necessary backup and select
Detach from job.
642 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Deleting Backup from Disk
If you want to delete records about backups from the Veeam Backup & Replication console and configuration
database and, additionally, delete backup files from the backup repository, you can use the Delete from disk
operation.
NOTE
• You can use the Veeam Backup & Replication console to remove backups created by Veeam Agent
backup jobs on the Veeam backup repository or Veeam Cloud Connect repository. Backups created
on a local drive of a protected computer or in a network shared folder are not displayed in the
Veeam Backup & Replication console.
• If you delete a backup of a failover cluster node, backup of all nodes of this cluster will be deleted.
You can remove an entire backup related to a Veeam Agent backup job or remove specific child backups —
backups related to individual computers in the backup.
o To remove the entire backup related to the Veeam Agent backup job or policy, select the backup and
click Delete from > Disk on the ribbon or right-click the backup and select Delete from disk.
o To remove a backup of a specific computer in the Veeam Agent backup job or policy, expand the
parent backup, select the necessary computer and click Delete from > Disk on the ribbon or right-click
the computer and select Delete from disk.
643 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Removing Backup from Configuration
If you want to remove records about Veeam Agent backups from the Veeam Backup & Replication console and
configuration database, you can use the Remove from configuration operation. When you remove a Veeam
Agent backup from configuration, the actual backup files remain on the backup repository. You can import the
backup to the Veeam Backup & Replication at any time later and restore data from it.
IMP ORTANT
Removing backups from configuration is designed for experienced users only. Consider using the Detach
from job or Delete from disk operations instead.
Create encrypted configuration backup before removing backups from configuration. To learn more, see
the Creating Encrypted Configuration Backups section in the Veeam Backup & Replication User Guide.
You can remove an entire backup related to a Veeam Agent backup job or remove specific child backups —
backups related to individual computers in the backup.
NOTE
• You can remove backups created by Veeam Agent backup jobs stored in the Veeam backup
repository or Veeam Cloud Connect repository. Backups created on a local drive of a protected
computer or in a network shared folder are not displayed in the Veeam backup console.
• If you remove from configuration a backup of a failover cluster node, backup of all nodes of this
failover cluster will be removed.
o To remove the entire backup related to the Veeam Agent backup job or policy, select the backup,
press and hold the [Ctrl] key, right-click the backup and select Remove from configuration.
644 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
o To remove a backup of a specific computer in the Veeam Agent backup job or policy, expand the
parent backup, select the necessary computer, press and hold the [Ctrl] key, right-click the computer
and select Remove from configuration.
645 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing Backup Properties
You can view summary information about backups created by Veeam Agent backup jobs on the backup
repository. The summary information provides the following data:
• Backup location.
You can view summary information for the following types of Veeam Agent backups:
• Backup of a separate protected computer in the Veeam Agent backup job (child backup)
3. In the working area, select the backup and click P roperties on the ribbon or right-click the backup and
select P roperties.
646 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
To view summary information for a child backup (backup of a specific Veeam Agent computer):
3. In the working area, expand the parent backup, select the necessary child backup and click P rop erties on
the ribbon or right-click the child backup and select P roperties.
647 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Scanning Backup
You can scan restore points of a backup created by Veeam Agent for Microsoft Windows after a malware attack
or to look for some sensitive data in a backup.
You cannot scan backups created by Veeam Agent for Linux, Veeam Agent for IBM AIX, Veeam Agent for Oracle
Solaris or Veeam Agent for Mac.
3. In the working area, expand the Veeam Agent backup, select the necessary computer in the backup and
click Sca n Backup on the ribbon or right-click the computer and select Sca n Backup.
5. If you want to use antivirus software as a scan engine, select the Sca n restore points with an antivirus
eng ine check box. For more information, see the Secure Restore section in the Veeam Backup &
Replication User Guide.
6. If you want to use a YARA rule as a scan engine, select the Sca n restore points with the following YARA
rule check box and specify the YARA file located in the Veeam Backup & Replication product folder:
C:\Program Files\Veeam\Backup and Replication\Backup\YaraRules.
If you do not want to create a malware detection event for a YARA rule, you can add a
SuppressMalwareDetectionNotification tag to the name of the rule. For example:
In this case, the malware detection event will not be created but the scan backup session will be finished
with the Warning status.
7. Configure the scan range. You can specify the following options:
o Scan all restore points, from most recent restore point to the oldest available restore point.
Veeam Backup & Replication selects the order in which to scan restore points depending on the selected
scan mode:
▪ In the Find the last clean restore point mode, Veeam Backup & Replication scans restore points
from the most recent to the oldest.
▪ In the Find the last clean restore point in range mode, Veeam Backup & Replication scans restore
points in the optimal order.
648 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
▪ In the Sca n content of a ll restore points in range mode, Veeam Backup & Replication scans
restore points from the oldest to the most recent.
If you want to continue the scan backup session after the first malware or the first piece of specific
information is found, select the Continue scanning all remaining files after the first occurence check box.
8. Click OK.
To learn more, see the Scan Backup section in the Veeam Backup & Replication User Guide.
649 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Reporting
You can view real-time statistics for rescan jobs, as well as Veeam Agent backup jobs and backup policies
configured in Veeam Backup & Replication. You can also generate reports with statis tics data for performed
rescan job or backup job sessions. You can generate reports manually in the Veeam Backup & Replication
console or set up Veeam Backup & Replication to send reports automatically by email.
650 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing Rescan Job Statistics
You can view statistics about performed rescan job sessions. When you create a protection group or manually
start the discovery process for a protection group or individual protected computer, Veeam Backup &
Replication displays statistics for the currently running rescan job session. In the statistics window, Veeam
Backup & Replication displays session duration details and a list of operations performed during the job.
In addition to overall rescan job statistics, the statistics window provides information on each prote cted
computer processed within the rescan job session. To view the processing progress for a specific computer,
select it in the list on the left.
You can also view statistics for any performed rescan job session. To view rescan job statistics, do one of t he
following:
• Open the Inventory view. In the inventory pane, select the necessary protection group and click Sta tistics
on the ribbon or right-click the protection group and select Sta tistics.
• Open the History view. In the inventory pane, select the Sy stem node. In the working area, select the
necessary rescan job session and click Sta tistics on the ribbon or right-click the rescan job session and
select Sta tistics.
651 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing Rescan Job Report
You can generate reports with details about rescan job sessions performed for a specific protection group. The
report contains data on the latest rescan job session initiated for the job upon schedule. To generate a report:
2. In the inventory pane, select the necessary protection g roup and click Rep ort on the ribbon or right-click
the protection group and select Rep ort.
• Cumulative session statistics: details of the session performance, including the number of protected
computers in the protection group and the number of newly discovered computers.
• Detailed statistics for every protected computer processed within the session: DNS name, IP address and
operating system of the protected computer, list of warnings and errors (if any).
TIP
You can also set up Veeam Backup & Replication to send reports automatically by email. To learn more, see
Enabling Email Reporting.
652 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Viewing Veeam Agent Backup Job
Statistics
You can view statistics about Veeam Agent backup jobs configured in Veeam Backup & Replication. For Veeam
Agent backup jobs managed by the backup server, Veeam Backup & Replication displays statistics in the similar
way as for backup jobs for VM data backup. To learn more, see the Reporting section in the Veeam Backup &
Replication User Guide.
o If the backup job does not back up Microsoft SQL Server transaction logs, in the working area, select
the necessary job and click Sta tistics on the ribbon or right-click the job and select Sta tistics.
o If the backup job backs up Microsoft SQL Server transaction logs, in the working area, select the
necessary job and click Sta tistics > Instance Backup on the ribbon or right-click the job and select
Sta tistics > Instance Backup.
For more information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL Server
Transaction Log Settings.
653 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Viewing Veeam Agent Backup Job Report
You can generate a report with details about Veeam Agent backup job session performance. The report contains
data on the latest backup job session initiated for the job. To generate a report:
o If the backup job does not back up Microsoft SQL Server transaction logs, in the working area, select
the necessary job and click Rep ort on the ribbon or right-click the job and select Rep ort.
o If the backup job backs up Microsoft SQL Server transaction logs, in the working area, select the
necessary job and click Rep ort > Instance Backup on the ribbon or right-click the job and select Report
> Instance Backup.
For more information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL Server
Transaction Log Settings.
• Cumulative session statistics: session duration details, details of the session performance, amount of read,
processed and transferred data, backup size, compression and deduplication ratios.
• Detailed statistics for every protected computer processed within the session: processing duration de tails,
backup data size, amount of read and transferred data, list of warnings and errors (if any).
TIP
• You can also set up Veeam Backup & Replication to send reports automatically by email. To learn
more, see Enabling Email Reporting.
• You can generate a separate report with details about SQL transaction log backup. To learn more,
see Viewing SQL Transaction Log Backup Report.
654 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing Backup Policy Statistics
You can view statistics about Veeam Agent backup jobs configured in Veeam Backup & Replication. For Veeam
Agent backup jobs managed by Veeam Agent, or backup policies, Veeam Backup & Replication displays statistics
in the following way:
• After you create a backup policy, Veeam Backup & Replication applies the backup policy to protected
computers. In the policy statistics window, Veeam Backup & Replication displays information about policy
application process and results. This information remains in the policy sta tistics window until the first
Veeam Agent backup job session is performed on computers included in the backup policy.
• After the Veeam Agent backup job session statistics becomes available in Veeam Backup & Replication,
this statistics appears in the policy statistics window. The job session statistics becomes available in
Veeam Backup & Replication at a different time depending on what target for backup files is selected in
the backup policy settings:
o If a Veeam Agent backup job whose settings are defined by the backup policy creates backup files on
a Veeam backup repository, backup job session statistics is available in Veeam Backup & Replication
on real-time basis.
o If a Veeam Agent backup job creates backup files on a local drive of a Veeam Agent computer, in a
network shared folder, in a Veeam Cloud Connect repository, or in object storage using the direct
connection mode, backup job session results are not passed to Veeam Backup & Replication in real
time. Statistics for such backup sessions becomes available in Veeam Backup & Replication later, after
rescan of a protection group that contains computers added to the backup policy. This process
happens regularly upon the discovery schedule defined in the protection group settings.
• Veeam Backup & Replication regularly applies the backup policy to protected computers. This operation is
performed during automatic rescan of a protection group that contains computers added to the backup
policy. If the application process completes with a warning or a n error, Veeam Backup & Replication
displays information about the application process results in the policy statistics window. Information
about successful application of the backup policy is not displayed in the statistics window between two
backup sessions.
Veeam Backup & Replication displays statistics for backup policies in a different way than for Veeam Agent
backup jobs managed by the backup server. The main differences are the following:
• For backup policies, Veeam Backup & Replication does not display the job progress bar. You can monitor
backup progress only for individual computers in the backup policy.
• Detailed statistics include the number of Veeam Agent computers specified in the backup policy settings,
the number of computers to which settings of the backup policy are applied, and the number of computes
that have no connection to the backup server at the time when the Veeam Agent backup job is performed.
• You can use the E rrors, W arnings and Success buttons at the bottom of the job statistics window to view
details on operations that failed, completed with a warning or completed successfully during a Veeam
Agent job session performance.
TIP
In addition to backup policy statistics, Veeam Backup & Replication displays individual backup sess ion
statistics for each computer in the backup policy. You can view these statistics in the History view of the
Veeam backup console.
655 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. In the inventory pane, click the Job s node.
o If the backup policy does not back up Microsoft SQL Server transaction logs, in the working area,
select the necessary policy and click Sta tistics on the ribbon or right-click the policy and select
Sta tistics.
o If the backup policy backs up Microsoft SQL Server transaction logs, in the working area, select the
necessary policy and click Sta tistics > Instance Backup on the ribbon or right-click the policy and
select Sta tistics > Instance Backup.
For more information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL Server
Transaction Log Settings.
656 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Viewing Backup Policy Report
You can generate a report with details about Veeam Agent backup job sessions performed on protected
computers added to a backup policy. The report contains data on the latest backup job session initiated for the
backup policy. To generate a report:
o If the backup policy does not back up Microsoft SQL Server transaction logs, in the working area,
select the necessary policy and click Rep ort on the ribbon or right-click the policy and select Rep ort.
o If the backup policy backs up Microsoft SQL Server transaction logs, in the working area, select the
necessary policy and click Rep ort > Instance Backup on the ribbon or right-click the policy and select
Rep ort > Instance Backup.
For more information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL Server
Transaction Log Settings.
• Cumulative session statistics: details on the number of protected computers specified in the backup policy
settings, the number of computers to which settings of the backup policy are applied, and the number of
disconnected computes, details of the session performance, amount of read, processed and transferred
data.
• Detailed statistics for every protected computer processed within the session: processing duration details,
backup data size, amount of read and transferred data, list of warnings and errors (if any).
• Detailed statistics for the application process if you edit the backup policy. In this case Veeam Backup &
Replication applies the backup policy to protected computers and includes information about this process
in the next job session report.
TIP
• You can also set up Veeam Backup & Replication to send reports automatically by email. To learn
more, see Enabling Email Reporting.
• You can generate a separate report with details about SQL transaction log backup. To learn m ore,
see Viewing SQL Transaction Log Backup Report.
657 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing SQL Server Transaction Log
Backup Statistics
If you configure a backup job or backup policy to back up Microsoft SQL Server transaction logs, you can view
statistics about the SQL Server transaction log backup job session performed on protected computers. For more
information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL Server Transaction Log
Settings.
For Veeam Agent backup jobs and policies, Veeam Backup & Replication displays statistics in the similar way as
for backup jobs for VM data backup. To learn more, see the Transaction Log Backup Statistics section in the
Veeam Backup & Replication User Guide.
658 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
3. In the working area, select the necessary backup job or backup policy and click Sta tistics > SQL Server log
b a ckup on the ribbon. Alternatively, you can right-click the backup job or backup policy and select
Sta tistics > SQL Server log backup.
659 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Viewing SQL Server Transaction Log
Backup Report
If you configure a backup job or backup policy to back up Microsoft SQL Server transaction logs, you can
generate a report with details about the SQL Server transaction log backup job session performed on protected
computers. For more information about backup of Microsoft SQL Server transaction logs, see Microsoft SQL
Server Transaction Log Settings.
To generate the SQL Server transaction log backup report, do the following:
3. In the working area, select the necessary backup job or backup policy and click Rep ort > SQL Server log
b a ckup on the ribbon. Alternatively, you can right-click the backup job or backup policy and select Rep ort
> SQL Server log backup.
The report contains data on the latest SQL Server transaction log backup job session:
• Cumulative session statistics: number of processed databases, details on session performance, size of
backed-up data, compression ratio, backup job session status.
• Detailed statistics for every computer processed within the session: session performance, amount of read
and transferred data, list of warnings and errors (if any).
• Statistics for processed SQL databases: processing duration details, number of processed databases,
amount of read and transferred data, list of warnings and errors (if any).
660 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
TIP
[For Veeam Agent backup jobs] If you set up Veeam Backup & Replication to send reports automatically by
email, SQL Server transaction log backup reports is sent to the specified email address after each
transaction log backup job session. For more information about email notifications, see Enabling Email
Reporting.
661 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Enabling Email Reporting
You can set up Veeam Backup & Replication to send reports automatically by email. To do this, you must enable
and configure global email notification settings in Veeam Backup & Replication. To learn more, see the
Configuring Global Email Notification Settings section in the Veeam Backup & Replication User Guide.
In addition, you can enable and configure custom notification settings for a specific protection group, Veeam
Agent backup job or backup policy. This may be useful if you want to change subject, notification rules or list of
recipients for some reports.
You can specify custom notification settings for a specific protection group. To learn more, see Notification
Settings.
You can specify custom notification settings for a specific Veeam Agent backup job. To learn more, see the
following sections:
• Notification Settings for Veeam Agent Backup Job (for Microsoft Windows computers)
• Notification Settings for Veeam Agent Backup Job (for Linux computers)
You can specify custom notification settings for a specific backup policy. To learn more, see the following
sections:
662 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Exporting Logs
If you want to submit a support ticket, we recommend that you include log files to ensure that overall and
comprehensive information is provided to Veeam Customer Support. Veeam Agent logs for computers of all
protection group types are stored on the Veeam backup server. If you back up computers with pre -
installed Veeam Agents, you can also collect logs directly from the protected computer.
• Exporting Logs from Veeam Backup & Replication Console — if you want to collect the logs from the
Veeam backup server.
• Exporting Logs from Veeam Agent Computers — if you want to collect the logs from a Veeam Agent
computer with pre-installed Veeam Agent.
663 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Exporting Logs from Veeam Backup &
Replication Console
Veeam Backup & Replication stores log files in different locations. To learn more, see the Managing Logs section
in the Veeam Backup & Replication User Guide.
To export all log files to one location, use the E x port Logs wizard.
TIP
If you do not have access to the Veeam Backup & Replication console and you cannot use the built -in log
export, export logs manually as described in this Veeam KB article.
664 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 1. Launch Export Logs Wizard
To launch the E x port Logs wizard, in the main menu of Veeam Backup & Replication select Help > Support
Information.
665 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 2. Select Physical Infrastructure Scope
At the Scop e step of the wizard, define the scope for Veeam Agent logs export. You can select one of the
following options:
• E x port logs for this job — select this option if you want to export logs for specific backup jobs. Click
Choose and specify the necessary backup job.
In this case, Veeam Backup & Replication exports only the Veeam Metrics Collector Log (VMC.log) file that
collects product usage metrics and infrastructure information for each Veeam Agent installation.
• E x port logs for these objects — select this option if you want to export logs for specific Veeam Agent
computers. Click Choose and specify the necessary Veeam Agent computer. If you export logs for a
computer with pre-installed Veeam Agent, specify credentials for the user account that has access to the
protected computer in the Ag ent Credentials window. Veeam Backup & Replication will not store these
credentials in its database.
In this case, Veeam Backup & Replication exports all Veeam Agent log files available on the Veeam backup
server.
NOTE
• Do not select the E x port all logs for selected components option if you want to export Veeam Agent
logs. With this option selected, Veeam Backup & Replication retrieves logs from backup
infrastructure components where Veeam Agent is not installed.
• When you export logs from the Veeam Backup & Replication console, the exported logs will be
copied to the machine where the console is installed. The log archive will also contain logs from the
console machine.
TIP
666 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
667 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Step 3. Specify Time Interval
At the Da te Range step of the wizard, define the time interval for which logs must be collected. You can select
one of the following options:
668 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 4. Specify Destination Folder
At the Loca tion step of the wizard, specify the destination folder to which the logs will be exported.
In the P a th to folder field, specify a path to an archive with log files that will be created. By default, the archive
is placed to the C:\temp\logs folder on the backup server.
669 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Step 5. Review Results
At the E x p ort step of the wizard, Veeam Backup & Replication will collect specified logs and create a log
archive. Wait for the export process to complete, review the results and click the Op en folder link to browse the
exported log files.
TIP
During the log export process, Veeam Backup & Replication locks the console, so you cannot close the
E x port Logs wizard. If you do not want to wait until the log export process completes, you can run another
session of the Veeam Backup & Replication concurrently and continue work with it.
670 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Exporting Logs from Veeam Agent
Computers
If Veeam Agent computer is connected to a Veeam backup server as a member of a protection group for pre-
installed Veeam Agents, you can export Veeam Agent logs directly from the Veeam Agent computer.
When you export product logs, Veeam Agent collects its log files, exports them to an archive file in the tar.gz
format and saves this archive file to the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Backup\Endpoint\Other\AgentLogs\<computer_name>
For more information on exporting product logs from a Veeam Agent computer, see the following user guides
depending on the Veeam Agent that you use:
671 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Operations Available on Veeam Agent
Computer
If Veeam Agent operates under control of Veeam Backup & Replication, the Veeam backup administrator can
perform all data protection, data restore and administration tasks from the Veeam Backup & Replication
console.
On the Veeam Agent computer side, the list of available operations depends on how the backup job for this
computer is managed: by Veeam backup server or by Veeam Agent. For more information about backup job
types, see Veeam Agent Backup Jobs and Policies.
The list of operations that can be performed in Veeam Agent operating in the managed mode varies depending
on the operating system of the protected computer:
672 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Operations Available on Windows
Computers
The list of operations that you can perform on a Windows-based Veeam Agent computer managed by Veeam
Backup & Replication depends on the backup job type:
• If a Veeam Agent computer is protected by a backup job managed by the backup server, on the Veeam
Agent computer side you can perform restore from Veeam Recovery Media. To learn more, see the
Restoring from Veeam Recovery Media section in the Veeam Agent for Microsoft Windows User Guide.
NOTE
Make sure that Veeam Recovery Media was created beforehand and you can access it. For a Veeam
Agent computer protected by a backup job managed by the backup server, you can create Veeam
Recovery Media from the Veeam Backup & Replication console. To learn more, see Creating Veeam
Recovery Media.
• If a Veeam Agent computer is protected by a backup job managed by Veeam Agent, on the Veeam Agent
computer side you can perform the following operations:
o Perform restore.
o Get support.
1. Double-click the Veeam Agent icon in the system tray, or right-click the Veeam Agent icon in the system
tray and select Control Panel.
If you do not see the Veeam Agent icon in the system tray, run Veeam Agent for Microsoft Windows from
the Microsoft Windows Start menu.
673 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
TIP
You can update the license and product edition from the Veeam Backup & Replication console. For more
information, see the Updating License section in the Veeam Backup & Replication User Guide.
• With the Create Recovery Media wizard. For more information, see the Creating Veeam Recovery Media
section in the Veeam Agent for Microsoft Windows User Guide.
• Using the command line interface. For more information, see the Creating Veeam Recovery Media with
Command Line Interface section in the Veeam Agent for Microsoft Windows User Guide.
• From the Veeam Agent control panel. For more information, see the Creating Incremental Backups section
in the Veeam Agent for Microsoft Windows User Guide.
• Using the command line interface. For more information, see the Creating Backups section in the Veeam
Agent for Microsoft Windows User Guide.
674 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Performing Restore
If you experience a problem with your computer, your data gets lost or corrupted, you can recover your data or
bring the computer back to work. The restore options for Veeam Agent operating in the managed mode does
not differ from the same options for Veeam Agent operating in the standalone mode. You can perform restore in
the following ways:
• You can perform restore from Veeam Recovery Media. For more information, see the Restoring from
Veeam Recovery Media section in the Veeam Agent for Microsoft Windows User Guide.
• You can perform restore using Veeam Agent and Microsoft Windows Tools. For more information, see the
Using Veeam Agent and Microsoft Windows Tools section in the Veeam Agent for Microsoft Windows User
Guide.
• You can perform restore using Microsoft Windows Recovery Environment. For more information, see the
Using Microsoft Windows Recovery Environment section in the Veeam Agent for Microsoft Windows User
Guide.
• You can restore volumes. For more information, see the Restoring Volumes section in the Veeam Agent for
Microsoft Windows User Guide.
• You can restore individual files and folders. For more information, see the Restoring Files and Folders in
the Veeam Agent for Microsoft Windows User Guide.
• You can perform restore from an encrypted backup. For more information, see the Restoring Data from
Encrypted Backups section in the Veeam Agent for Microsoft Windows User Guide.
NOTE
By default, restore from the Veeam Agent computer side is available only for user accounts with Local
Administrator permissions.
If you want to perform restore under accounts that do not have administrative privileges, make sure that
the Allow file level recovery without administrative account check box in the Veeam Agent for Microsoft
Windows settings is selected before you start the restore process. To learn more, see Veeam Agent for
Microsoft Windows Settings.
• You can view statistics of the completed sessions in the Veeam Agent control panel. For more information,
see the Viewing Statistics in Control Panel section in the Veeam Agent for Microsoft Windows User Guide.
• You can get information about the backup state using the Veeam Agent for Microsoft Windows tray agent.
For more information, see the Monitoring Backup State with Tray Agent section in the Veeam Agent for
Microsoft Windows User Guide.
• You can get information about the backup progress using the Veeam Agent for Microsoft Windows taskbar
button. For more information, see the Monitoring Backup Process in Taskbar Button section in the Veeam
Agent for Microsoft Windows User Guide.
675 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Getting Support
If you have any questions or want to share your feedback about Veeam Agent, you can use one of the following
options:
• Search for the information on the necessary subject in the current Veeam Agent for Microsoft Windows
User Guide.
• Visit Veeam R&D Forums and share your opinion or ask a question.
1. Right-click the Veeam Agent for Microsoft Windows icon in the system tray and select Control Panel.
676 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Operations Available on Linux Computers
The list of operations that you can perform on a Linux-based Veeam Agent computer managed by Veeam
Backup & Replication depends on the backup job type. Some operations are a vailable only if the computer is
protected with a backup job managed by Veeam Agent.
If Veeam Agent computer is protected by a backup job managed by either backup server or Veeam Agent, on the
Veeam Agent computer side you can perform the following operations:
• Perform restore.
• Export logs.
If Veeam Agent computer is protected by a backup job managed by Veeam Agent, on the Veeam Agent
computer side you can also perform the following operations:
• Veeam Agent version. To view the version of Veeam Agent, run the following command:
veeamconfig version
NOTE
You can view information about Veeam Agent license only if the computer is protected with a backup
job managed by Veeam Agent.
To view information on the Veeam Agent license, run the following command:
677 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
• Veeam Agent operation mode. To view information on the Veeam Agent operation mode, run the
following command:
TIP
You can also change the operation mode of Veeam Agent. For more information, see Manage
Operation Mode.
This operation is available only if the computer is protected with a backup job managed by Veeam Agent.
You can view the settings of backup jobs managed by Veeam Agent. This process does not differ from the one
for Veeam Agent operating in the standalone mode. For more information, see Viewing Backup Job Settings in
the Veeam Agent for Linux User Guide.
This operation is available only if the computer is protected with a backup job managed by Veeam Agent.
On the Veeam Agent computer side, you can start a backup job managed by Veeam Agent from the Veeam
Agent control panel or using the command line interface. This process does not differ from the one for Veeam
Agent operating in the standalone mode. For more information, see Starting Backup Job from Control Panel and
Starting Backup Job from Command Line Interface in the Veeam Agent for Linux User Guide.
This operation is available only if the computer is protected with a backup job managed by Veeam Agent.
On the Veeam Agent computer side, you can create ad -hoc active full backups. You can start a backup job that
will create an active full backup from the Veeam Agent control panel or using the command line interface. The
procedure of creating an active full backup does not differ from the same procedure for Veeam Agent operating
in the standalone mode. For more information, see Starting Backup Job from Control Panel and Creating Active
Full Backups in the Veeam Agent for Linux User Guide.
678 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Stopping Backup Job
On the Veeam Agent computer side, you can stop any running backup job from the Veeam Agent control panel
or using the command line interface. This process does not differ from the one for Veeam Agent operating in the
standalone mode. For more information, see Stopping Backup Job in the Veeam Agent for Linux User Guide.
Performing Restore
The restore options for Veeam Agent operating in the managed mode are similar to the restore options for
Veeam Agent operating in the standalone mode.
NOTE
When Veeam Agent is managed by Veeam Backup & Replication, you cannot import backups to the Veeam
Agent computer.
• You can perform restore from Veeam Recovery Media. For more information, see the Restoring from
Veeam Recovery Media section in the Veeam Agent for Linux User Guide.
• You can restore volumes. For more information, see the Restoring Volumes with Command Line Interface
section in the Veeam Agent for Linux User Guide.
• You can restore individual files and folders. For more information, see the Restoring Files and Folders with
Recovery Wizard and Restoring Files and Folders with Command Line Interface sections in the Veeam
Agent for Linux User Guide.
• You can perform restore from an encrypted backup. For more information, see the Restoring Data from
Encrypted Backups section in the Veeam Agent for Linux User Guide.
Exporting Logs
This operation may be required if you want to report an issue and need to attach log files to the support case.
The procedure of exporting product logs does not differ from the one for Veeam Agent operating in the
standalone mode. For more information, see the Exporting Product Logs section in the Veeam Agent for Linux
User Guide.
679 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Operations Available on Unix Computers
If a Unix-based Veeam Agent computer is managed by Veeam Backup & Replication, you can protect such
computers only by a backup job managed by Veeam Agent.
On the Veeam Agent computer side, you can perform the following operations:
• Perform restore.
• Export logs.
• Veeam Agent version. To view the version of Veeam Agent, run the following command:
veeamconfig version
• Veeam Agent license. To view information on the Veeam Agent license, run the following command:
• Veeam Agent operation mode. To view information on the Veeam Agent operation mode, run the
following command:
TIP
You can also change the operation mode of Veeam Agent. For more information, see Manage
Operation Mode.
680 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Creating Veeam Recovery Media
You can create a recovery media for the protected Unix computer. The procedure of creating Veeam Recovery
Media for Veeam Agent operating in the managed mode does not differ from the same procedure for Veeam
Agent operating in the standalone mode.
For more information on creating Veeam Recovery Media in Veeam Agent for IBM AIX, see the Creating Custom
Veeam Recovery Media section in the Veeam Agent for IBM AIX User Guide.
For more information on creating Veeam Recovery Media in Veeam Agent for Oracle Solaris, see the Creating
Custom Veeam Recovery Media section in the Veeam Agent for Oracle Solaris User Guide.
For more information on viewing backup job settings in Veeam Agent for IBM AIX, see Viewing Backup Job
Settings in the Veeam Agent for IBM AIX User Guide.
For more information on viewing backup job settings in Veeam Agent for Oracle Solaris, see Viewing Backup Job
Settings in the Veeam Agent for Oracle Solaris User Guide.
For more information on starting a backup job in Veeam Agent for IBM AIX, see Starting Backup Job from
Control Panel and Starting Backup Job in Command Line Interface in the Veeam Agent for IBM AIX User Guide.
For more information on starting a backup job in Veeam Agent for Oracle Solaris, see Starting Backup Job from
Control Panel and Starting Backup Job in Command Line Interface in the Veeam Agent for Oracle Solaris User
Guide.
For more information on creating active full backups in Veeam Agent for IBM AIX, see Starting Backup Job from
Control Panel and Creating Active Full Backups in Command Line Interface in the Veeam Agent for IBM AIX User
Guide.
For more information on creating active full backups in Veeam Agent for Oracle Solaris, see Starting Backup Job
from Control Panel and Creating Active Full Backups in Command Line Interface in the Veeam Agent for Oracle
Solaris User Guide.
681 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Stopping Backup Job
On the Veeam Agent computer side, you can stop any running backup job from the Veeam Agent control panel
or using the command line interface. This process does not differ from the one for Veeam Agent operating in the
standalone mode.
For more information on stopping a backup job in Veeam Agent for IBM AIX, see Stopping Backup Job in the
Veeam Agent for IBM AIX User Guide.
For more information on stopping a backup job in Veeam Agent for Oracle Solaris, see Stopping Backup Job in
the Veeam Agent for Oracle Solaris User Guide.
For more information on viewing session statistics in Veeam Agent for IBM AIX, see the Reporting section in the
Veeam Agent for IBM AIX User Guide.
For more information on viewing session statistics in Veeam Agent for Oracle Solaris, see the Reporting section
in the Veeam Agent for Oracle Solaris User Guide.
Performing Restore
The restore options for Veeam Agent operating in the managed mode do not differ from the same options for
Veeam Agent operating in the standalone mode. You can perform restore in the following ways:
For more information on performing restore from Veeam Recovery Media in Veeam Agent for IBM AIX, see
the Performing Bare Metal Recovery section in the Veeam Agent for IBM AIX User Guide.
For more information on performing restore from Veeam Recovery Media in Veeam Agent for Oracle
Solaris, see the Performing Bare Metal Recovery section in the Veeam Agent for Oracle Solaris User Guide.
For more information on file-level restore in Veeam Agent for Oracle Solaris, see the Restoring Files and
Directories section in the Veeam Agent for Oracle Solaris User Guide.
For more information on restoring from encrypted backups in Veeam Agent for IBM AIX, see the Restoring
Data from Encrypted Backups section in the Veeam Agent for IBM AIX User Guide.
For more information on restoring from encrypted backups in Veeam Agent for Oracle Solaris, see the
Restoring Data from Encrypted Backups section in the Veeam Agent for Oracle Solaris User Guide.
682 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
For more information managing operation mod in Veeam Agent for IBM AIX, see the Managing Veeam Agent
Operation Mode section in the Veeam Agent for IBM AIX User Guide.
For more information managing operation mod in Veeam Agent for Oracle Solaris, see the Managing Veeam
Agent Operation Mode section in the Veeam Agent for Oracle Solaris User Guide.
Exporting Logs
This operation may be required if you want to report an issue and need to attach log files to the support case.
The procedure of exporting product logs does not differ from the one for Veeam Agent operating in the
standalone mode.
For more information on exporting logs in Veeam Agent for IBM AIX, see the Exporting Product Logs section in
the Veeam Agent for IBM AIX User Guide.
For more information on exporting logs in Veeam Agent for Oracle Solaris, see the Exporting Product Logs
section in the Veeam Agent for Oracle Solaris User Guide.
683 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Operations Available on Mac Computers
Mac computers are managed by Veeam Backup & Replication through a protection group for pre -installed
Veeam Agents. You can protect Mac computers only by a backup job managed by Veeam Agent.
On the Veeam Agent computer side, you can perform the following operations:
• Perform restore.
• Export logs.
• Get support.
• Veeam Agent version. To view the version of Veeam Agent, run the following command:
veeamconfig version
• Veeam Agent license. To view information on the Veeam Agent license, run the following command:
• Veeam Agent operation mode. To view information on the Veeam Agent operation mode, run the
following command:
TIP
You can also change the operation mode of Veeam Agent. For more information, see Manage
Operation Mode.
684 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Viewing Backup Job Details
You can view the settings of backup jobs managed by Veeam Agent. This process does not differ from the one
for Veeam Agent operating in the standalone mode. For more information, see Viewing Backup Job Settings in
the Veeam Agent for Mac User Guide.
Performing Restore
The restore options for Veeam Agent operating in the managed mode do not differ from the same options for
Veeam Agent operating in the standalone mode. You can perform restore in the following ways:
• You can restore user profile data. For more information, see the Restoring User Data section in the Veeam
Agent for Mac User Guide.
• You can restore individual files and folders. For more information, see the Restoring Files and Folders
section in the Veeam Agent for Mac User Guide.
• You can perform restore from an encrypted backup. For more information, see the Restoring Data from
Encrypted Backups section in the Veeam Agent for Mac User Guide.
685 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Managing Operation Mode
You can manage the operation mode of Veeam Agent. This process does not differ from the one for Veeam
Agent operating in the standalone mode. For more information, see Managing Veeam Agent Operation Mode in
the Veeam Agent for Mac User Guide.
Exporting Logs
This operation may be required if you want to report an issue and need to attach log files to the support case.
The procedure of exporting product logs does not differ from the one for Veeam Agent operating in the
standalone mode. For more information, see the Exporting Product Logs section in the Veeam Agent for Mac
User Guide.
Getting Support
If you have any questions or want to share your feedback about Veeam Agent, you can use one of the following
options:
• Search for the information on the necessary subject in the current Veeam Agent for Mac User Guide.
• Visit Veeam R&D Forums and share your opinion or ask a question.
2. In the Help menu, select one of available options to get support on the product:
o Open Forums
686 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Appendix
This section provides information on additional procedures available for Veeam Agents operating in the
managed mode.
In this Section
• Deploying Hotfix on Protected Computers
687 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Deploying Hotfix on Protected Computers
A Veeam Agent hotfix is a set of updated Veeam Agent packages that addresses a certain issue in the product.
This scenario describes how to deploy a hotfix on protected computers with one of the following installed
Veeam Agents:
• Veeam Agent for Unix (Veeam Agent for Oracle Solaris and Veeam Agent for IBM AIX)
• To mitigate an existing issue in the product. In this case, a hotfix is provided by Veeam Customer Support.
• [For Veeam Agent for Linux hotfix] To add support of a new Linux distribution version to the product. In
this case, a hotfix is available in the Veeam software repository.
If you have several computers with Veeam Agent installations managed by Veeam Backup & Replication, you can
centrally deploy a hotfix on all managed agents. Keep in mind that this scenario is not available for Veeam
Agent computers added to protection groups for pre-installed Veeam Agents.
Prerequisites
Before you deploy a Veeam Agent hotfix on protected computers:
1. Check that protected computers are powered on and can be connected over the network.
We recommend that you do not stop running jobs and let them complete successfully. Disable any
periodic jobs temporarily to prevent them from starting during the upgrade. If protected computers run
VSS-aware applications and backup of database logs (Microsoft SQL Server transaction logs or Oracle
archived logs) is enabled in the backup job for these computers, disable this backup job too.
3. Check that automatic Veeam Agent deployment options are enabled in the protection group settings:
688 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
c. In the inventory pane, select the protection group that contains computers with an outdated Veeam
Agent installed and click E d it Group on the ribbon or right-click the protection group that you want to
edit and select P roperties.
d. At the Op tions step of the wizard, in the Dep loyment section, make sure that the Install backup agent
a utomatically and Auto-update backup agent check boxes are selected.
689 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Deployment Procedure for Protected Computers
The hotfix deployment procedure differs depending on the OS running on the protected computers:
690 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Deployment Procedure for Windows Computers
To deploy a hotfix on Microsoft Windows computers included in the protection group, perform the following
steps:
2. Save the Veeam Agent for Microsoft Windows setup archive to the following folder on the backup server:
c. In the inventory pane, select the necessary protection group and click Rescan on the ribbon or right-
click the protection group and select Rescan.
691 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Deployment Procedure for Linux Computers
Before You Begin
Hotfixes released by Veeam for Veeam Agent for Linux can contain updated packages for all or selected
components of the Veeam Agent architecture:
• If the hotfix affects all Veeam Agent for Linux packages, follow the general procedure of deploying a
hotfix for Veeam Agent for Linux. The general procedure instructions are further illustrated with Example
1.
• If the hotfix contains only an updated kernel module package, editing of the Veeam Agent for Linux
package index file (Step 3 of the general procedure) is not required. The simplified procedure of hotfi x
deployment is illustrated in Example 2.
1. Obtain the hotfix from Veeam Customer Support. To do this, open a support case.
2. Save Veeam Agent for Linux packages and their manifest files to the following folder on the Veeam
backup server:
C:\ProgramData\Veeam\Agents\val\x86\rpm
C:\ProgramData\Veeam\Agents\val\x64\rpm
C:\ProgramData\Veeam\Agents\val\x64\deb
3. Replace the names of the Veeam Agent for Linux packages in the index file:
a. Open the ValPackageIndex.xml file that is located in the following folder on the Veeam backup
server:
C:\ProgramData\Veeam\Agents\val
b. In the ValPackageIndex.xml file, locate packages that you want to update. Replace their names
with names of Veeam Agent for Linux packages you saved in Step 2. After that, save changes and
close the index file. For more information on deploying a hotfix for Veeam Agent for Linux ve rsion
6.0, see Example 1.
692 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
b. In the inventory pane, expand the P hy sical Infrastructure node.
c. In the inventory pane, select the necessary protection group a nd click Rescan on the ribbon or right-
click the protection group and select Rescan.
During the rescan, Veeam Backup & Replication will use updated packages specified in the index file to
install Veeam Agent for Linux version with the hotfix on protected computers.
• blksnap-6.0.3.1228-1.noarch.rpm
• blksnap-6.0.3.1228-1.noarch.rpm.manifest.xml
• veeam-6.0.3.1228-1.el9.x86_64.rpm
• veeam-6.0.3.1228-1.el9.x86_64.rpm.manifest.xml
• kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm
• kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm.manifest.xml
1. Obtain all updated Veeam Agent for Linux packages from Veeam Customer Support. To do this, open a
support case.
693 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. Save the packages and their manifest files to the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val\x64\rpm
You do not need to delete obsolete Veeam Agent for Linux packages you want to update.
3. Edit the index file located in the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val
b. Locate the packages that you want to update and replace their version and names with version and
names of the packages you saved in step 2.
Usually, the packages that are available as a hotfix have a build version that is different from the
obsolete packages. In this scenario, obsolete packages have the 6.0.3.1221 build version and the
updated packages have the 6.0.3.1228 build version.
In the example below, replaced package version and names are highlighted in green:
...
...
<Version majorVersions="9">
<driver_noarch value="blksnap-6.0.3.1228-1.noarch.rpm"/>
<driver_uefi_cert value="veeamsnap-ueficert-6.0.3.1221-1.noarch.rpm"/>
<driver_bin value="kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm"/>
<veeam value="veeam-6.0.3.1228-1.el9.x86_64.rpm"/>
</Packages>
</Version>
</Distribution>
....
694 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
The hotfix consists of the following Veeam Agent packages:
• kmod-blksnap-patch-6.1.0.1498-1.el9.x86_64.rpm
• kmod-blksnap-patch-6.1.0.1498-1.el9.x86_64.rpm.manifest.xml
1. Obtain all updated Veeam Agent for Linux packages from Veeam Customer Support. To do this, open a
support case.
2. Save the package and its manifest file to the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val\x64\rpm
695 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Deployment Procedure for Unix Computers
You can add Unix-based servers with Veeam Agent for IBM AIX or Veeam Agent for Oracle Solaris installed to
protection groups for individual computers.
To deploy a hotfix on Unix machines included in the protection group, perform the following steps:
2. In the C:\ProgramData\Veeam\Agents\vau folder on the Veeam backup server, replace the original
Veeam Agent for Unix package with the hotfix package.
c. In the inventory pane, select the necessary protection group and click Rescan on the ribbon or right-
click the protection group and select Rescan.
During rescan, Veeam Backup & Replication will update Veeam Agents on the protected machines.
696 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Restoring Files from Backup Without
Administrator Privileges
If you have Veeam Agent for Microsoft Windows installed on your computer and you work on this computer
under an account that does not have Administrator privileges, you can still restore files from the file-level
backup.
This scenario describes how to restore a file from the backup under an account that does not have local
administrator permissions to its original location.
• Your Veeam Agent computer must be a member of a protection group for which file-level restore without
Administrator privileges is allowed. To learn more, see Veeam Agent for Microsoft Windows Settings.
• You must restore from the backup created by a backup job managed by Veeam Agent. To learn more, see
Working with Veeam Agent Backup Jobs and Policies.
• You must restore from the backup stored on Veeam backup repository or Veeam Cloud Connect
repository.
• You must restore from the backup of the same Veeam Agent computer.
• You must open the restore wizard from the Veeam Agent for Microsoft Windows control panel.
1. On the Veeam Agent computer, double-click the Veeam Agent for Microsoft Windows icon in the system
tray, or right-click the icon in the system tray and select Control Panel.
697 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
2. From the main menu in the upper left corner, hover over the name of the necessary job and select Restore
file to open the File Level Restore wizard.
Consider when you work on the Veeam Agent computer under an account that does not have
Administrator privileges, you can open the File Level Restore wizard only from the Veeam Agent for
Microsoft Windows control panel. If you try to open the wizard from the system tray, Veeam Agent will
ask you to enter Administrator credentials.
3. In the File Level Restore wizard, select a restore point from which you want to restore the file.
4. At the Summary step, click Op en. Veeam Agent will display the backup file content in the Veeam Backup
browser.
698 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
5. Locate the file you want to restore, right-click it and select Restore > Overwrite. The file will be restored
to its original location.
Consider that access rights to files and folders are managed by Veeam Agent computer OS. When you
cannot access the folder in the original location, you cannot view the content of this folder in the Veeam
Backup browser as well. If you select file to restore, but do not have enough access rights to restore it,
Veeam Agent will not restore the file and will display an error message in the restore job session.
To get the access rights you need, you can switch to another system user with the Veeam Backup browser.
To learn more, see the Elevating Access Rights section in the Veeam Agent for Microsoft Windows User
Guide.
699 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
Using Filters in Backup Jobs for Windows
Computers
When you create or edit a Veeam Agent backup job for a Microsoft Windows computer in the Veeam Backup &
Replication console, you can include and exclude files and folders from the backup job scope by using include
and exclude masks as described in section Specifying Folders to Back Up. This topic demonstrates several basic
scenarios you may want to implement in your infrastructure.
• This topic covers the file filtering functionality available for a backup job created by Veeam Agent
operating in the managed mode.
The settings of a backup job created by Veeam Agent operating in the managed mode provide additional
file filtering capabilities compared to the settings available for a backup job created by Veeam Agent
operating in the standalone mode. For example, when you create a backup job in the Veeam Backup &
Replication console, you can specify paths and system environment variables in exclude masks. To learn
more about setting up file filters for backup jobs when Veeam Agent operates in the standalone mode, see
the How to Use Filters to Define File-Level Backup Scope section in the Veeam Agent for Windows User
Guide.
• All backup scenarios in this topic are performed in the file-level backup mode.
A file-level backup job may contain entire volumes and individual folders or files from the other volumes
(this is referred to as hybrid backup job ). In this case, entire volumes are processed using volume-level
backup mode while specific folders from other volumes are processed using file-level backup mode. In the
hybrid backup job, filters work in the following way:
o File name and file type masks are applied only to the folders specified in the backup scope and not
the entire volumes.
o Masks that contain paths are applied to the selected folders and entire volumes.
• Depending on the type of the object in the backup scope, during job execution Veeam Agent behaves
differently:
o When you select an entire volume as an object of a file-level backup, Veeam Agent adds backup
exclusions to the FilesNotToSnapshot registry key, triggers creation of the volume shadow copy (VSS
snapshot), reads data from the VSS snapshot and saves the data to a backup repository.
To learn more about the FilesNotToSnapshot registry key, see this Microsoft article.
During backup, Veeam Agent will ignore any filters configured for this volume.
NOTE
By default, Microsoft Windows does not include some files into the VSS snapshot — for
example, temporary files, Microsoft Outlook .ost files and so on. As a result, these files are not
included into Veeam Agent backups too. To learn how you can override this default behavior,
see this Veeam KB article.
o When you select an individual folder as an object of a file-level backup, Veeam Agent reads all data
from the VSS snapshot first, then applies filters defined in the job configuration to save the data.
700 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• When you specify include masks, the backup will contain only the data that matches these masking criteria
within the backup scope. When you specify exclude masks, the backup will contain all data from the
backup scope except the data that matches these masking criteria.
1. At the Ba ckup Mode step of the Backup Job wizard, select the File level backup option.
3. Click Ad vanced; then in the File Filters window, use masks to include or exclude specific files and folders.
NOTE
701 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
• Including or Excluding Files by File Type.
1. In the E x clude masks field, enter the full path to the folder — E:\Data\2023.
2. Click Ad d .
As a result, the backup will contain all data from the backup scope except the E:\Data\2023 folder.
702 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
When you specify a system environment variable in a mask, you must precede such variable with a
backslash.
2. Click Ad d .
As a result, the backup will contain all data from the backup scope except the E:\Data\2023\Drafts folder.
NOTE
If you use a system environment variable in the file filter for the backup, consider the following:
• You can use only system environment variables defined for the Local System account on computers
added to the backup job. You cannot use user environment variables (Veeam Agent works under the
NT AUTHORITY\SYSTEM account, so all exclusions are treated accordingly).
• You cannot use environment variables that contain multiple values or other environment variables.
NOTE
Note that you cannot use a wildcard in the middle of the path. For example, specifying E:\*\2023 will cause
an error during backup. To recursively exclude files from specific subfolders of the selected root folder,
you can use the standard OS mechanism for exclusions.
703 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
In this example, we will exclude all subfolders of the E:\Data folder whose names begin with 2023. To do this:
2. Click Ad d .
As a result, the backup will contain all data from the backup scope except the folders whose names start with
2023 — for example 2023_Jan or 2023_Reports.
704 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Including or Excluding Specific Files
You can select specific files for inclusion or exclusion. In this example, we will include only the Image_05.bmp
file into the backup. To do this:
2. Click Ad d .
As a result, the backup will contain only the Image_05.bmp file from the specified backup scope.
705 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
In this example, we will back up all text files in the .txt format. To do this:
1. In the Include masks field, enter *.txt to select all files with the .txt extension.
2. Click Ad d .
As a result, the backup will contain all the text files in the .txt format from the backup scope.
NOTE
You can combine include and exclude masks as needed. For example, you can include all .pdf files into the
backup scope and exclude the ones that contain the word draft in their name by specifying *.pdf in the
include mask and *draft* in the exclude mask.
706 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Including or Excluding Files Whose Names Contain a Specific
Sequence of Characters
You can include or exclude files whose names contain a specific sequence of characters. In this example, we will
exclude files of any type that have File_ in the name. To do this:
This will select all files that contain this sequence of characters in any position in the file name.
5. Click Ad d .
As a result, the backup will contain all data from the backup scope except the files that contain File_ in the
name — for example, File_01.txt or Draft_File_05.pdf.
707 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
Including or Excluding Files Named According to a Convention
You may have a set of files named according to a convention — for example, File_XX.txt where XX is a two-
digit number. You can use a single-character wildcard to select specific files for inclusion or exclusion. In this
example, we will exclude files named according to the File_XX.txt convention with numbers ranging from
01 to 09:
2. Click Ad d .
As a result, the backup will contain all data from the backup scope except the text files whose names contain a
digit ranging from 1 to 9 in the position of the wildcard character specified in the mask — for example,
File_01.txt, File_07.txt and so on. Keep in mind that this filter will also exclude files whose names
contain any other character in the wildcard position — for example, File_0A.txt.
708 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
Deploying Settings to Veeam Agent
Computers
If you want to automate application of Veeam Agent settings to protected computers, you can use the Veeam
Backup PowerShell module. For more information about the module, see the Veeam PowerShell Reference.
IMP ORTANT
Make sure that you have tested the cmdlets described in this section in a test lab before their execution in
the production environment. Operations performed with these cmdlets can cause data loss, and you will
not be able to undo changes.
Deploying Settings
To deploy settings to managed computers, perform the following steps:
1. Start a Veeam PowerShell session. For more information, see the Starting Veeam PowerShell Sessions in
the Veeam PowerShell Reference.
2. Create a new configuration option for Veeam Agent settings using the New-
VBRDiscoveredComputerConfigurationOption cmdlet. For more information, see the New-
VBRDiscoveredComputerConfigurationOption section in the Veeam PowerShell Reference.
3. Add the created configuration option to a configuration policy and assign the configuration policy to a
protected computer or a protection group using the Add-
VBRDiscoveredComputerConfigurationPolicy cmdlet. For more information, see the Add-
VBRDiscoveredComputerConfigurationPolicy section in the Veeam PowerShell Reference.
4. Rescan the protected computer or the protection group to a pply new settings. For more information, see
Rescanning Protected Computer or Rescanning Protection Group.
Deleting Settings
To delete a configuration policy that contains a configuration option for Veeam Agent settings, use the the
Remove-VBRDiscoveredComputerConfigurationPolicy cmdlet. For more information, see the Remove-
VBRDiscoveredComputerConfigurationPolicy section in the Veeam PowerShell Reference.
709 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
IMP ORTANT
• Before you apply other settings to Veeam Agent computers, make sure to delete the currently
applied configuration policy with the Remove-VBRDiscoveredComputerConfigurationPolicy
cmdlet. Otherwise, the policy settings will be reapplied after the rescan of the protected computer
or protection group.
• The removal of the configuration policy does not update settings on Veeam Agent computers to
which the policy has been applied. If you want to update the settings, you must create a new policy
and assign it to discovered computers using the Add-
VBRDiscoveredComputerConfigurationPolicy cmdlet. For more information, see the Add-
VBRDiscoveredComputerConfigurationPolicy section in the Veeam PowerShell Reference.
710 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
How to Protect Failover Clusters
Veeam Backup & Replication lets you deploy and manage Veeam Agent for Microsoft Windows on failover
clusters in your infrastructure.
This scenario describes how you can use Veeam Agent to protect failover clusters. For example, Windows File
Server Failover Clusters. For the full list of failover cluster types that you can back up with Veeam Agent, see
Failover Cluster Support.
NOTE
If you want to back up a a Microsoft Exchange Database Availability Group without an Administrative
Access Point (IP Less DAG), follow backup job configuration procedure for standalone servers. To learn
more, see Backup of Database Availability Groups.
1. Launch the New P rotection Group wizard. Select the Microsoft Active Directory objects protection group
type.
711 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
2. At the Na me step of the wizard, specify a name and description for the protection group. Click Nex t.
3. At the Active Directory step of the wizard, select failover clusters that you want to add to the protection
group. Click Nex t.
712 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
4. At the E x clusions step of the wizard, make sure that none of the required hosts are excluded. Click Nex t.
5. At the Credentials step of the wizard, specify credentials to connect to each failover cluster. If you want to
use the same credentials for all failover clusters, select the necessary user account from the Ma ster
a ccount list. If some failover clusters require a different user account, specify custom credentials. Click
Nex t.
713 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
6. At the Op tions step of the wizard, specify settings for discovery and Veeam Agent deployment. Click Next.
7. At the Review step of the wizard, review what Veeam Backup & Replication components are already
installed on the distribution server specified for the protection group and what components will be
installed. Click Ap p ly to add the configured protection group to the inventory.
714 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
8. At the Ap p ly step of the wizard, wait for the operation of the protection group creation to complete. Click
Nex t.
9. At the Summary step of the wizard, review information about the created protection group. Click Finish to
close the wizard.
715 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
To create a failover cluster backup job:
1. Select Ba ckup Job > W indows computer to launch the New Agent Backup Job wizard.
2. At the Job Mode step of the wizard, in the Ty p e field select Fa ilover Cluster. Click Nex t.
716 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
3. At the Na me step of the wizard, specify a name and description for the backup job. Click Nex t.
4. At the Comp uters step of the wizard, select a protection group that contains failover clusters. Click Nex t.
717 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
5. At the Ba ckup Mode step of the wizard, select the mode in which you want to create a backup. Click Nex t.
6. [For volume-level backup] At the Ob jects step of the wizard, specify volumes you want to include in the
backup. Click Nex t.
718 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
7. At the Storage step of the wizard, specify settings for the target backup repository. Click Nex t.
719 | V eeam Backup & Replication | Veeam A gent Management Guide | 12.2.0.334
8. [If you selected the Configure secondary destinations for this job check box at the Storage step of the
wizard] At the Secondary Target step of the wizard, link the Veeam Agent backup job to a backup to tape
or backup copy job. Click Nex t.
720 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
9. At the Guest Processing step of the wizard, specify guest OS processing settings. Click Nex t.
10. At the Schedule step of the wizard, specify the schedule according to which you want to perform backup.
Click Ap p ly.
721 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
11. At the Summary step of the wizard, review settings of the configured backup job. Click Finish to close the
wizard.
722 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
How to Move Unix Computers to
Protection Group for Individual Computers
Veeam Backup & Replication allows you to manage Unix-based Veeam Agent computers through a protection
group for individual computers. You can migrate your Unix computers from a protection group for pre-installed
Veeam Agents to a protection group for individual computers without breaking the existing backup chains. For
more information on protection group types, see Protection Group Types.
• The host name of the Veeam Agent computer that you move from a protection group for pre-installed
Veeam Agents to a protection group for individual computers must be resolvable into an IP address by
DNS or locally on Veeam backup server.
• To preserve the backup chain, you must make sure the backup job that used to protect the Unix computer
you moved still has this Unix computer in its protection scope after the move.
If the Unix computer is in the scope of the backup job as an individual machine, the backup job will
continue the backup chain for this computer without any additional adjustments.
If the Unix computer is in the scope of the backup job as a member of a protection group, after you move
the Veeam Agent computer to another protection group, you must add the protection group that contains
the moved machine to the backup job.
• You can move multiple Unix computers from a protection group for pre-installed Veeam Agents to a
protection group for individual computers within a single move operation.
2. In the inventory pane, expand the P hy sical Infrastructure node and select the protection group for pre-
installed Veeam Agents that contains the computer you want to move.
3. In the working area, select a single or multiple computers and click Move to on the ribbon or right click the
selection and choose Move to.
If you want to move the Veeam Agent computer to a new protection group, from the Move to menu select
New p rotection group and proceed to Step 4.
723 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
If you want to move the Veeam Agent computer to an existing protection group, from the Move to menu
select the name of the existing protection group and proceed to Step 5.
In the Move agent into the protection group? dialog window, select Y es . Veeam Backup & Replication will
open the protection group wizard where you can create new or edit existing protection group. For more
information on creating or editing a protection group, see Creating Protection Groups.
4. At the Na me step of the wizard, specify a name and description for the protection group.
724 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
5. At the Comp uters step of the wizard, select the Unix computer you want to move and click Set User.
To specify credentials for the user account that Veeam Backup & Replication will use to connect to the
Unix computer, do the following:
NOTE
If you move multiple computers and you use the same set of credentials for them, you can select
them all and click Set User to specify the credentials. If the computers you move have different
credentials, specify credentials for each computer individually.
TIP
725 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
6. At the Op tions step of the wizard, specify the discovery and deployment options for the Veeam Agent
computer.
7. At the Review step of the wizard, review what Veeam Backup & Replication components are already
installed on the distribution server specified for the protection group and what components will be
installed. Click Ap p ly.
726 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334
8. At the Ap p ly step of the wizard, monitor the installation and configuration of the required components.
9. At the Summary step of the wizard, click Finish to complete the protection group configuration.
727 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
10. In the inventory pane, expand the P hy sical Infrastructure node, select the protection group where you
moved the Unix computer; then select Rescan on the ribbon. Alternatively, right click the protection
group where you moved the Unix computer and select Rescan.
11. In the P hy sical Infrastructure node, select the protection group where you moved the Unix computer; then
select Ad d to Backup > Unix > Ag ent Backup Policy UNIX on the ribbon. Alternatively, right click the
protection group where you moved the Unix computer and select Ad d to Backup Job > Unix > Ag ent
Ba ckup P olicy UNIX.
Veeam Backup & Replication will add the protection group for individual computers that contains the
moved Unix computer to the original Agent Backup Policy UNIX backup job that used to protect the Unix
computer when it was a member of the protection group for pre-installed Veeam Agents. The backup
chain will continue uninterrupted.
728 | V eeam Backup & Replication | Veeam Agent Management Guide | 12.2.0.334
How to Perform Bare Metal Restore for
Clusters with Shared Disks
Veeam Backup & Replication allows you to protect failover clusters in your infrastructure using Veeam Agent for
Microsoft Windows. If cluster nodes fail to start for any reason, you can restore affected nodes.
This scenario describes how to perform bare metal restore for a Windows Server Failover Cluster with a shared
disk after the majority of the voting nodes of the cluster fail to start.
NOTE
The entire computer backup must be created beforehand. To learn more, see Select Backup Mode.
1. Perform bare metal restore for each failed node of the failover cluster. The restore process is the same as
for restore of a computer protected with Veeam Agent for Microsoft Windows operating in the standalone
mode. To learn more, see the Restoring from Veeam Recovery Media section in the Veeam Agent for
Microsoft Windows User Guide.
2. Test the failover cluster configuration. For example, run failover cluster validation tests. To learn more,
see Microsoft Documentation.
o If the validation report contain errors, fix them or re-create the cluster. To learn more, see Microsoft
Documentation.
3. Restore the cluster shared disk from the Veeam Backup & Replication console. To learn more, see
Restoring Volumes.
IMP ORTANT
Do not restore the cluster shared disk from the Veeam Agent computer side. In this case, you will be
able to restore only to a local disk.
729 | V eeam Backup & Replication | V eeam Agent Management Guide | 12.2.0.334