Veeam Backup Nutanix Ahv 7 User Guide
Veeam Backup Nutanix Ahv 7 User Guide
AHV
Version 7
User Guide
January, 2025
© 2025 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 intellectual
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:
• Create backups of Nutanix AHV VMs and store them in backup repositories.
• Create several instances (copies) of the same backed-up data in different locations.
• Restore VMs from Nutanix AHV backups and snapshots to the original Nutanix AHV environment.
• Restore VMs from VMware ESXi and Microsoft Hyper-V to the Nutanix AHV environment.
• Restore VMs from oVirt KVM and Proxmox VE backups to the Nutanix AHV environment.
• Restore VMs from Microsoft Azure, Amazon Web Services (AWS) and Google Cloud backups to the Nutanix
AHV environment.
• Restore physical machines from backups created by Veeam Ag ents to the Nutanix AHV environment.
• Restore VMs from Nutanix AHV backups to Microsoft Azure, Amazon Web Services (AWS) and Google
Cloud environments.
• Restore VMs from Nutanix AHV backups to VMware vSphere and Microsoft Hyper -V environments.
• Perform Instant Recovery of VMs and physical machines to Nutanix AHV, VMware vSphere and Microsoft
Hyper-V environments.
• Restore application items (such as Microsoft Active Directory, Microsoft Exchange, Microsoft SharePoint,
Oracle Database and Microsoft SQL Server).
• Restore Nutanix AHV VM disks and attach them to VMs running in Nutanix AHV clusters.
• Export disks of backed-up Nutanix AHV VMs to VMDK, VHD and VHDX formats.
• Mount disks of backed-up Nutanix AHV VMs to any server and access data in the read -only mode.
• Prism Central deployment scenario allows you to protect workloads that reside in multiple clusters
registered with a Prism Central.
This scenario provides a centralized web console that allows you to manage backup and restore operations
performed for workloads in all the registered clusters. Therefore, it reduces time required to install,
configure and maintain Veeam Backup for Nutanix AHV,
• Standalone cluster deployment scenario allows you to protect workloads that reside in a specific cluster.
Even if you add multiple clusters to the backup infrastructure, Veeam Backup for Nutanix AHV will treat
each cluster as a dedicated virtual environment. Therefore, backup and restore operations performed for
workloads in each cluster will be managed separately.
You can also combine these scenarios to support your own data protection strategy. However, keep in mind that
you cannot add to the backup infrastructure both a Prism Central and a standalone Nutanix AHV cluster that is
registered with this Prism Central.
• Backup server
• Backup appliance
• Backup repositories
• Workers
Backup Server
The backup server is a Windows-based physical or virtual machine on which Veeam Backup & Replication is
installed. The backup server is the configuration, administration and management core of the backup
infrastructure. It coordinates backup and restore operations, controls job scheduling and manages resource
allocation.
Backup Appliance
The backup appliance is an architecture component that sits logically between the backup server and other
components of the backup infrastructure. While the backup server administers tasks, the backup appliance
performs management operations, processes jobs and delivers backup traffic. The backup appliance is a Linux-
based VM that resides in one of the Prism Central Nutanix AHV clusters and includes the following components:
• Ba ckup Appliance Web Console is an interface that allows you to manage backup and restore operations,
and to configure settings of the Nutanix AHV backup appliance.
• Veeam Updater is a service that is responsible for installing and scheduling updates for the backup
appliance.
Backup Repositories
A backup repository is a storage location where Veeam Backup for Nutanix AHV stores backups of protected
Nutanix AHV VMs.
To communicate with backup repositories, Veeam Backup for Nutanix AHV uses Veeam Data Mover — the service
that is responsible for data processing and transfer. By default, Veeam Data Mover runs on the repositorie s
themselves. If a repository cannot host Veeam Data Mover, it starts on a gateway server — a dedicated
component that “bridges” the backup server and workers. For more information, see the Veeam Backup &
Replication User Guide, section Gateway Server.
Workers
A worker is an auxiliary Linux-based VM instance that is responsible for the interaction between the backup
appliance and other components of the backup infrastructure. Workers process backup workload and distribute
backup traffic when transferring data to and from backup repositories.
The backup appliance comes with a preconfigured embedded worker that can be used in small virtual
environments. In large environments, it is recommended to deploy dedicated workers that are distributed
among the cluster hosts (nodes) and are automatically launched for the duration of a backup or restore process.
For more information on deployment sizing considerations, see Sizing Guidelines.
• Backup server
• Backup appliance
• Backup repositories
• Workers
Backup Server
The backup server is a Windows-based physical or virtual machine on which Veeam Backup & Replication is
installed. The backup server is the configuration, administration and management core of the backup
infrastructure. It coordinates backup and restore operations, controls job scheduling and manages resource
allocation.
Backup Appliance
The backup appliance is an architecture component that sits logically between the backup server and other
components of the backup infrastructure. While the backup server administers tasks, the backup appliance
performs management operations, processes jobs and delivers backup traffic. The backup app liance is a Linux-
based VM that resides in the Nutanix AHV cluster and includes the following components:
• Ba ckup Appliance Web Console is an interface that allows you to manage backup and restore operations,
and to configure settings of the Nutanix AHV backup appliance.
• Veeam Updater is a service that is responsible for installing and scheduling updates for the backup
appliance.
Backup Repositories
A backup repository is a storage location where Veeam Backup for Nutanix AHV stores backups of protected
Nutanix AHV VMs.
Workers
A worker is an auxiliary Linux-based VM instance that is responsible for the interaction between the backup
appliance and other components of the backup infrastructure. Workers process backup workload a nd distribute
backup traffic when transferring data to and from backup repositories.
The backup appliance comes with a preconfigured embedded worker that can be used in small virtual
environments. In large environments, it is recommended to deploy dedicated workers that are distributed
among the cluster hosts (nodes) and are automatically launched for the duration of a backup or restore process.
For more information on deployment sizing considerations, see Sizing Guidelines.
While creating image-level backups, Veeam Backup for Nutanix AHV does not install agent software inside VMs
to retrieve data. Veeam Backup for Nutanix AHV uses native Nutanix AHV capabilities instead. During every
backup session, Veeam Backup for Nutanix AHV creates a Nutanix AHV live snapshot of each VM added to a
backup job. The snapshot is further used to create a VM backup.
1. Connects to the Nutanix AHV server (Prism Central or Nutanix AHV cluster) over Nutanix REST API and
creates a backup snapshot of the processed VM or a protection domain to which the VM belongs.
If no worker is deployed on the host, Veeam Backup for Nutanix AHV launches a worker that is deployed
on any other host connected to the Nutanix AHV server; if no workers are deployed on hosts, the
embedded worker is used instead.
3. Re-creates VM disks from the snapshot created at step 1, adds them to a temporary volume group and
attaches it to the worker.
4. Uses the worker to read data from disks of the volume group, transfers the data to the target repository
and stores it in the native Veeam format.
To reduce the amount of data read from snapshots, Veeam Backup for Nutanix AHV uses the changed
block tracking (CBT) mechanism: during incremental backup sessions, Veeam Backup for Nutanix AHV
compares the new snapshot with the previous one and reads only those data blocks that have changed
since the previous backup session. If CBT cannot be used, Veeam Backup for Nutanix AHV reads all data
from the snapshot. For more information, see Changed Block Tracking.
Veeam Backup for Nutanix AHV compresses and deduplicates data saved to repositories.
To limit the impact of backup tasks on network performance, Veeam Backup for Nutanix AHV applies
network traffic throttling rules that prevent jobs from utilizing the entire bandwidth available in your
environment.
• VBM — backup metadata files store information about the backup job, VMs processed by the backup job,
number and structure of backup files, restore points, and so on. Metadata files facilitate import of
backups, backup mapping and other operations.
Full and incremental backup files act as restore points for backed -up VMs that let you roll back VM data to the
necessary state. To recover a VM to a specific point in time, the chain of backup files created for the VM must
contain a full backup file and a set of incremental backup files dependent on the full backup file.
If some file in the backup chain is missing, you will not be able to roll back to the necessary state. For this
reason, you must not delete individual backup files from the backup repository manually. Instead, you must
specify retention policy settings that will let you maintain the necessary number of backup files in the backup
repository.For more information, see Backup Retention.
• During a full backup session Veeam Backup for Nutanix AHV reads only written data blocks, while
unallocated data blocks are filtered out.
• During an incremental backup session, Veeam Backup for Nutanix AHV reads only those data blocks that
have changed since the previous backup session.
To detect unallocated and changed data blocks, CBT relies on the Nutanix AHV REST API:
1. During the first (full) backup session, Veeam Backup for Nutanix AHV creates a snapshot of a VM using
native Nutanix AHV capabilities. To do that, Veeam Backup for Nutanix AHV sends API requests to access
the content of the snapshot and to detect unallocated data blocks.
2. During subsequent sessions, new snapshots are created. Veeam Backup for Nutanix AHV sends API
requests to access and to compare the content of the snapshot created during the previous backup session
and the snapshot created during the current backup session. This allows Veeam Backup for Nutanix AHV
to detect data blocks that have changed since the previous backup session.
NOTE
For backup chains created by jobs that no longer exist, Veeam Backup for Nutanix AHV applies a separate
retention mechanism as described in the Veeam Backup & Replication User Guide, section Background
Retention.
1. Veeam Backup for Nutanix AHV checks the configuration database to detect backup chains that contain
redundant restore points:
o If retention policy is specified in days, Veeam Backup for Nutanix AHV detects backup chains with
restore points that are older than the specified time limit.
o If retention policy is specified in restore points, Veeam Backup for Nutanix AHV detects backup chains
where the number of allowed restore points is exceeded.
2. If a redundant restore point exists in a backup chain, Veeam Backup for Nutanix AHV transforms the
backup chain in the following way:
a. Rebuilds the full backup to include there data of the incremental backup that follows the full backup.
To do that, Veeam Backup for Nutanix AHV injects into the full backup data blocks from the earliest
incremental backup in the chain. This way, the full backup ‘moves’ forward in the standard backup
chain.
b. Removes the earliest incremental backup from the chain as redundant — this data has already been
injected into the full backup.
1. Veeam Backup for Nutanix AHV checks the configuration database to detect forward incremental backup
chains where a new full backup has been created (which starts a new backup chain fragment).
o If retention policy is specified in days, Veeam Backup for Nutanix AHV checks whether the period to
keep restore points in the new chain fragment has reached the allowed time limit.
o If retention policy is specified in restore points, Veeam Backup for Nutanix AHV checks whether the
number of restore points in the new chain fragment has reached the number of allowed restore
points.
3. If the new backup chain fragment has reached the limit of allowed restore points, Veeam Backup for
Nutanix AHV removes all restore points of the older backup chain fragment.
This backup method helps you save space on the backup storage because Veeam Backup for Nutanix AHV
stores only one full backup file and removes incremental backup files once the retention period is
exceeded.
• Forward incremental
When the forward incremental backup method is used, Veeam Backup for Nutanix AHV creates a backup
chain that consists of multiple full backup files (VBKs) and sets of forward incremental backup files (VIBs)
following each full backup file. Full backups created using the synthetic full or active full method split the
backup chain into shorter series. This lowers the chances of losing the backup chain completely and makes
this backup method the most reliable. For more information, see Forward Incremental Backup.
This backup method requires more storage space than other methods because the backup chains contains
multiple full backup files and sometimes Veeam Backup for Nutanix AHV stores more restore points than
specified in the retention policy settings due to the specifics of the forward incremental retention policy.
1. During the first (full) backup session, Veeam Backup for Nutanix AHV copies the full VM image and creates
a full backup file in the backup repository. The full backup file becomes a starting point in the backup
chain.
2. During subsequent backup sessions, Veeam Backup for Nutanix AHV copies only those data blocks that
have changed since the previous backup session, and stores these data blocks to incremental backup files
in the backup repository. The content of each incremental backup file depends on the content of the full
backup file and the preceding incremental backup files in the backup chain.
1. During the first (full) backup session, Veeam Backup for Nutanix AHV copies the full VM image and creates
a full backup file in the backup repository. The full backup file becomes a starting point in the backup
chain.
3. On a day when the synthetic full or active full backup is scheduled, Veeam Backup for Nutanix AHV creates
a full backup file and adds it to the backup chain. Incremental restore points produced after this full
backup file use it as a new starting point.
To create an active full backup Veeam Backup for Nutanix AHV retrieves VM data from the source cluster where
the VM resides, compresses and deduplicates it and writes it to the VBK file in the backup repository. When
creating an active full backup, Veeam Backup for Nutanix AHV starts a new backup chain for the VM. All further
created incremental backups use the latest active full backup file as a new starting point. The old full backup file
from the old backup chain remains on disk until it is automatically deleted according to the retention policy.
Veeam Backup for Nutanix AHV triggers a backup job to create an active full backup even if a regular backup
session is not scheduled on this day. The active full backup session starts at the same time when the backup job
is scheduled. For example, if you schedule the backup job to run at 12:00 AM Sunday through Friday, and
schedule active full backup to be created on Saturday, Veeam Backup for Nutanix AHV will start a backup job
session that will produce an active full backup at 12:00 AM on Saturday.
If the backup job is not scheduled to run automatically or is disabled, Veeam Backup for Nutanix AHV will not
perform active full backup. If a regular backup session and an active full backup session are scheduled on the
same day, Veeam Backup for Nutanix AHV will produce an active full backup onl y. However, if you run the
backup job again on the same day manually, Veeam Backup for Nutanix AHV will perform incremental backup in
a regular manner.
To create a synthetic full backup, Veeam Backup for Nutanix AHV performs the following operations:
1. Veeam Backup for Nutanix AHV creates a regular incremental backup and adds it to the backup chain.
2. Veeam Backup for Nutanix AHV creates a new synthetic full backup using backup files that are already
available in the backup chain, including the newly created incremental backup file.
3. Veeam Backup for Nutanix AHV deletes the created incremental backup as its data is already incorporated
in the synthetic full backup.
When creating a synthetic full backup, Veeam Backup for Nutanix AHV starts a new backup chain for the VM. All
further created incremental backups use the latest full backup file as a new starting point. The old full backup
file from the old backup chain remains on disk until it is automatically deleted according to the retention policy.
Veeam Backup for Nutanix AHV triggers a backup job to create a synthetic full backup even if a regular backup
session is not scheduled on this day. For example, if you schedule the backup job to run at 12:00 AM Sunday
through Friday, and schedule synthetic full backup to be created on Saturday, Veeam Backup for Nutanix AHV
will start a backup job session that will produce a synthetic full backup at 12:00 AM on Saturday.
If the backup job is not scheduled or is disabled, Veeam Backup for Nutanix AHV will not perform synthetic full
backup automatically. If a regular backup session and a synthetic full backup session are scheduled on the same
day, Veeam Backup for Nutanix AHV will produce a synthetic full back up only. However, if you run the backup
job again on the same day manually, Veeam Backup for Nutanix AHV will perform incremental backup in a
regular manner.
A sequence of Nutanix AHV snapshots created during a set of backup sessions makes up a snapshot chain.
Veeam Backup for Nutanix AHV creates the snapshot chain in the following way:
1. During the first backup session, Veeam Backup for Nutanix AHV creates a snapshot that contains all VM
data and saves it in the Nutanix AHV cluster where the processed VM resides. This snapshot becomes a
starting point in the snapshot chain.
2. During subsequent backup sessions, Veeam Backup for Nutanix AHV creates snapshots that contain only
those data blocks that have changed since the previous backup session.
Each Nutanix AHV snapshot in the snapshot chain contains metadata. Metadata stores information about the
protected instance and the job that created the snapshot. Veea m Backup for Nutanix AHV uses metadata to
identify snapshots created by the Veeam backup service, to detect outdated snapshots, and to load the
configuration of source VMs during recovery operations, and so on.
In Veeam Backup for Nutanix AHV, snapshots act as independent restore points for backed-up instances. If you
remove any snapshot, it will not break the snapshot chain — Nutanix AHV will include data of the deleted
snapshot to a following snapshot. Therefore, you will still be able to roll back instance data to any existing
restore point. Note that while removing a protection domain snapshot, Veeam Backup for Nutanix AHV deletes
data of all VMs and volume groups included in the domain.
The number of snapshots kept in the snapshot chain is defined by retention policy settings. For more
information, see Snapshot Retention.
Related Topics
• Creating Snapshot Jobs
Snapshot Types
In terms of data protection, Veeam Backup for Nutanix AHV allows you to create the following types of
snapshots:
• Ba ckup snapshots
A backup snapshot is a VM snapshot created by a backup job. Backup snapshots are displayed both in the
Nutanix AHV backup appliance web console and in the Veeam Backup & Replication console, and can be
used to perform entire VM restore and disk restore.
Backup snapshots allow Veeam Backup for Nutanix AHV to use the CBT mechanism while creating backups
and to speed up the restore process (in comparison to restore from image-level backups).
A snapshot is a VM snapshot created by a snapshot job or taken manually in the Prism Element or Prism
Central console. Snapshots are displayed both in the Nutanix AHV backup appliance web console and in
the Veeam Backup & Replication console. You can use snapshots to restore VMs to the original Nutanix
AHV environment.
While taking VM snapshots, Nutanix AHV captures data residing on virtual disks attached to the VMs. To
protect data residing on volume groups that are attached to the VMs, volume group ( VG) snapshots or
protection domain (PD) snapshots are created. VG snapshots capture data of volume groups only, whereas
PD snapshots capture data of consistency groups that include VMs and volume groups attached to them.
Snapshots on replica sites allow Veeam Backup for Nutanix AHV to reduce the backup load on the
production environment. However, Veeam Backup for Nutanix AHV can use these snapshots only if the
following requirements are met for each VM included into the backup scope:
o At least one VM snapshot has been replicated to a remote location since the most recent backup was
created.
o The VM disk configuration has not changed since the most recent snapshot was replicated to a remote
location.
If any of those conditions are not met, Veeam Backup for Nutanix AHV performs backup using VM
snapshots created by backup jobs in the main site.
• VG snapshots
A VG snapshot is a volume group snapshot created by a backup job to produce VM backups. Veeam Backup
for Nutanix AHV takes VG snapshots only if the backup scope includes individual virtual machines (not
protection domains) with volume groups attached.
VG snapshots are displayed neither in the Nutanix AHV backup appliance web console nor in the Veeam
Backup & Replication console. VG snapshots allow Veeam Backup for Nutanix AHV to us e the CBT
mechanism while creating backups and to restore VMs with volume groups.
• P D snapshots
A PD snapshot is a protection domain snapshot created by a PD snapshot job or a backup job to protect
data of consistency groups (VMs and volume groups) included into a protection domain. PD snapshots
guarantee the consistency of VM and volume group data. Veeam Backup for Nutanix AHV takes PD
snapshots only if application-aware processing is disabled in job settings and the following requirements
are met for each protection domain included into the backup scope:
o The protection domain does not contain multiple VMs with the same name.
o VMs and their volume groups belong to the same protection domain.
o VMs and their volume groups are included into one consistency group of the protection domain.
o [Applies to backup jobs only] Guest processing is disabled for the job.
PD snapshots are displayed both in the Nutanix AHV b ackup appliance web console and in the Veeam
Backup & Replication console. You can use PD snapshots to restore VMs to the original Nutanix AHV
environment.
NOTE
Recovery points created manually in the Prism Central console cannot be used to protect and recover
Nutanix AHV resources with Veeam Backup for Nutanix AHV.
In terms of data consistency, Veeam Backup for Nutanix AHV allows you to create the following types of
snapshots:
• Crash-consistent snapshots
A crash-consistent snapshot contains the data of virtual disks and volume groups attached to a VM.
• Ap p lication-consistent snapshots
An application-consistent snapshot contains not only the data of virtual disks and volume groups attached
to a VM, but also the data of applications (such as Microsoft Active Directory, Microsof t SQL Server,
Microsoft SharePoint, Microsoft Exchange and Oracle) running in the VM guest OS, which allows you to
restore the applications without data loss and corruption.
By default, Veeam Backup for Nutanix AHV always tries to create an application-consistent snapshot using
Nutanix Guest Tools when processing a VM. However, if the requirements for application-consistent snapshots
are not met, Veeam Backup for Nutanix AHV creates a crash-consistent snapshot instead.
Snapshot Retention
For Nutanix AHV native snapshots, you specify retention policy restore points. Veeam Backup for Nutanix AHV
retains the number of latest restore points defined in job scheduling settings as described in sections Creating
Snapshot Jobs and Creating Protection Domain Snapshots Jobs.
During every successful backup session, Veeam Backup for Nutanix AHV creates a new restore point. If Veeam
Backup for Nutanix AHV detects that the number of restore points in the snapshot chain exceeds the retention
limit, it removes the earliest restore point from the chain.
• Entire VM Restore — restores an entire VM from a backup. You can restore one or more VMs at a time, to
the original location or to a new location.
• Disk Restore — restores persistent disks attached to a VM from a snapshot or an image-level backup. You
can restore persistent disks to the original location or to a new location.
• File-level recovery — recovers individual VM files and folders from a backup. You can download the
necessary files and folders to a local machine, or restore the files and folders of the source VM to the
original location.
You can restore VM data to the most recent state or to any available restore point.
1. [Applies only if you perform restore to the original location where the source VM is still present] Connects
to the Nutanix AHV server over REST API to power off and remove the source VM.
If no worker is deployed on the host, Veeam Backup for Nutanix AHV launches a worker that is deployed
on any other host connected to the Nutanix AHV server; if no workers are deployed on hosts, the
embedded worker is used instead.
3. Connects to the target Nutanix AHV server over REST API and creates a VM in the target location.
4. Creates empty virtual disks in the target location. The number of empty disks equals the number of disks
attached to the source VM.
5. Connects to the backup repository and restores backed-up data to the empty disks.
If multiple disks are attached to the source VM, the Nutanix AHV backup appliance restores these disks
sequentially, one disk at a time.
6. Attaches the created disks with the restored data to the target VM disk nodes using their original bus.
The maximum number of disk nodes available on Nutanix AHV VMs for each bus type is limited. Veeam
Backup for Nutanix AHV can attach to a VM up to 6 SATA, 256 SCSI, 4 IDE and 7 PCI disks. If you restore a
VM that has more disks of any of those bus types, Nutanix AHV will attach the disks to remaining nodes of
other bus types in the default priority: SATA, SCSI, IDE, PCI. You can modify the backup appliance
configuration, to instruct Nutanix AHV to ignore original bus types and to use a specific order of bus types.
7. [Applies only if the VM has volume groups attached] Creates a new volume group with empty disks.
8. [Applies only if the VM has volume groups attached] Connects to the backup repository and restores
backed-up data to the empty disks of the volume group.
9. [Applies only if the VM has volume groups attached and you perform restore to the original location
where the source VM is still present] Removes the volume group that was attached to the source VM.
10. [Applies only if the VM has volume groups attached] Attaches the created volume group with the restored
data to the target VM.
NOTE
Veeam Backup for Nutanix AHV prioritizes restore tasks higher than other tasks. If multiple VMs are added
to the restore session, these VMs are processed in parallel.
1. Connects to the Nutanix AHV server over REST API to to power off the target VM.
If no worker is deployed on the host, Veeam Backup for Nutanix AHV launches a worker that is deployed
on any other host connected to the Nutanix AHV server; if no workers are deployed on hosts, the
embedded worker is used instead.
4. Connects to the backup repository and restores backed -up data to the empty disks.
5. [Applies only if you restore the disks to the original VM and if you choose to replace the existing disks]
Detaches the original disks from the VM and removes them from the Nutanix AHV infrastructure.
6. Attaches the created disks with the restored data to the target VM.
1. [Applies only if you perform restore of a VM with an operation system other than Microsoft Windows]
Deploys a helper appliance in the Nutanix AHV cluster.
The Veeam Backup Browser displays the file system tree of the backed -up VM. In the browser, you select
the necessary files and folders to restore.
4. Restores the selected files and folders to the original location or to a new location.
5. Detaches the disks from the backup server, mount server or helper appliance.
6. [Applies only if you perform restore of a VM with an operation system other than Microsoft Windows]
Removes the helper appliance.
To recover VM files and folders from a backup snapshot, snapshot or PD snapshot, Veeam Backup for Nutanix
AHV performs the following steps:
2. [Applies only if you perform restore from a snapshot or PD snapshot] Creates a temporary VM on the
Nutanix AHV cluster.
3. Creates a volume group using disks of the original VM (for a backup snapshot) or of the temporary VM (for
a snapshot or PD snapshot).
5. [Applies only if you perform restore from a snapshot or PD snapshot] Deletes the temporary VM.
7. Restores the selected files and folders to the original location or to a new location.
To learn how to recover individual VM files and folders, see Performing File-Level Restore.
Restore points in the backup chain can be stored only for the allowed period of time. If a restore point i s
older than the specified time limit, Veeam Backup for Nutanix AHV removes it from the backup chain.
Since for retention policy specified in days, the backup chain must contain at least 3 restore points, Veeam
Backup for Nutanix AHV may retain restore points for a longer period than configured in the retention
policy settings. For more information, see Backup Retention and Snapshot Retention.
The chain can contain only the allowed number of restore points. If the number of allowed restore points
is exceeded, Veeam Backup for Nutanix AHV removes the earliest restore point from the chain. For more
information, see Backup Retention and Snapshot Retention.
Sp ecification Requirement
• Veeam Backup for Nutanix AHV is compatible with Nutanix AOS versions 6.5.x - 6.7.x,
Virtualization
6.10.x, 7.0 and Prism Central version pc.2022.6 (or later).
Platform
• An IP address of the cluster and the iSCSI Data Service must be configured in Nutanix
AHV cluster settings. For more information, see Nutanix documentation.
• UEFI boot must be supported in the Nutanix AHV environment. For more information,
see Nutanix documentation.
• Veeam Backup for Nutanix AHV supports Nutanix Cloud Clusters (NC2) used for
hybrid multi-cloud deployment.
• Veeam Backup & Replication version 12.3.0.310 (or later) with Nutanix AHV Plug -in
Veeam
Software version 12.7.0.172 (or later) must be deployed on the backup server.
• Microsoft .NET Core Runtime 8.0 and Microsoft ASP.NET Core Shared Framework 8.0
must be installed on the backup server.
Nutanix AHV The Nutanix AHV backup appliance performs management operations and handles backup
Backup and restore tasks (if the embedded worker is enabled). If you deploy Veeam Backup for
Appliance Nutanix AHV using the default configuration, the following compute resources will be
allocated to the Nutanix AHV backup appliance:
• CPU: 6 vCPU
• Memory: 6 GB RAM
• Disk Space: 100 GB for product installation, internal database files and logs
With the default configuration, the Nutanix AHV backup appliance can perform management
operations in a cluster with less than 1000 VMs and process less than 100 jobs, and handle
up to 4 concurrent backup and restore tasks. While deploying a new Nutanix AHV backup
appliance or editing settings of an existing one, you can adjust compute resources allocated
to it according to the recommendations described in section Sizing Guidelines.
Workers Dedicated workers process backup workload and distribute backup traffic when transferring
data to and from backup repositories. If you deploy a worker using the default configuration,
the following compute resources will be allocated to the worker VM:
• CPU: 6 vCPU
• Memory: 6 GB RAM
• Disk Space: 100 GB for product installation and logs
With the default configuration, the worker can handle up to 4 concurrent backup and restore
tasks in parallel. While deploying a new worker or ed iting settings of an existing one, you
can change the maximum number of concurrent tasks. To do that, adjust compute resources
allocated to the worker VM according to the recommendations described in section Sizing
Guidelines.
The Nutanix AHV backup appliance and workers are deployed as backup infrastructure components
preconfigured for optimal performance. That is why you must not install any software on VMs running as
the Nutanix AHV backup appliance and workers or make any configuration changes to them unless you are
requested by Veeam Customer Support.
Setup Account The account used to install Veeam Backup & Replication and Nutanix AHV Plug-in must
have the Local Administrator permissions on the backup server.
Veeam Backup & The account used to run Veeam Backup & Replication services must be a LocalSystem
Replication User account or must have the Local Administrator permissions on the backup server.
Account
All user accounts used for guest processing of Windows VMs must have the following permissions:
Microsoft SQL To back up Microsoft SQL Server data, the user whose account you plan to use must
Server be:
• Local Administrator on the target VM.
• System administrator (has the Sysadmin role) on the target Microsoft SQL
Server.
If you need to provide minimal permissions, the account must be assigned the
following roles and permissions:
• SQL Server instance-level role: public and dbcreator.
• Database-level roles and roles for the model system database:
db_backupoperator , db_denydatareader , public;
for the master system database — db_backupoperator , db_datareader , public;
for the msdb system database — db_backupoperator , db_datareader , public,
db_datawriter .
• Securables: view any definition, view server state, connect SQL .
If the account does not have enough rights, Veeam Backup & Replication tries to
truncate logs using the local SYSTEM account for Microsoft SQL Server 2008 and
2008 R2. For other Microsoft SQL Server versions, Veeam Backup & Replication uses
NT AUTHORITY\SYSTEM account.
Microsoft Active To back up Microsoft Active Directory data, the account must be a member of the
Directory built-in Administrators group.
Microsoft To back up Microsoft Exchange data, the account must have the local Administrator
E x change permissions on the machine where Microsoft Exchange is installed.
Ora cle The account specified at the Guest Processing step must be configured in the following
way:
• For a Windows-based VM, the account must be a member of both the Local
Administrator group and the ORA_DBA group (if OS authentication is used). In
addition, if ASM is used, then such an account must be a member of the
ORA_ASMADMIN group (for Oracle 12 and higher).
• For a Linux-based VM, the account must be a Linux user elevated to root. The
account must have the home directory created.
To back up Oracle databases, you can specify the following options at the Oracle tab:
You can use, for example, the SYS Oracle account or any other Oracle account
that has been granted SYSDBA privileges.
• Account specified for guest processing. That is, the Use g uest credentials option
selected.
In this case, the account that was specified at the Guest Processing step must be
a member of the ORA_DBA group for a Windows-based VM and OSASM, OSDBA
and OINSTALL groups for a Linux-based VM.
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 an error with
the permission denial.
Microsoft To back up Microsoft SharePoint server, the account must have the Farm Administrator
Sha rePoint role.
To back up Microsoft SQL databases of the Microsoft SharePoint Server, the account
must have the same privileges as that of Veeam Explorer for Microsoft SQL Server.
P ostgreSQL The account specified at the Guest Processing step must be a Linux user elevated to
root. The account must have the home directory created.
To back up PostgreSQL instances, the account must have the superuser privileges for
the PostgreSQL instance. For more information, see PostgreSQL documentation.
• [For guest OS file indexing] For Windows-based workloads, choose an account that has administrator
privileges. For Linux-based workloads, choose an account of a root user or user elevated to root.
• [If you plan to use guest processing over network for workloads without listed applications] For Windows -
based workloads, choose an account that has administrator privileges. For Linux -based workloads, choose
an account of a root user or user elevated to root.
• When using Active Directory accounts, make sure to provide an account in the DOMAIN\Username format.
• When using local user accounts, make sure to provide an account in the Username or HOST\Username
format.
• To back up a Read-Only Domain controller, a delegated RODC administrator account is sufficient. For more
information, see Microsoft Docs.
IMP ORTANT
Some Linux distributions require manual configuration of firewall rules. For more information, see this
Veeam KB article.
Backup Appliance
The following table describes network ports that must be opened to ensure proper communication of the
Nutanix AHV backup appliance with other backup infrastructure components.
Workstation Nutanix AHV backup TCP/HTTPS 443 Used to access the Nutanix AHV
web appliance backup appliance web console.
browser
Nutanix Nutanix REST API TCP/HTTPS 9440 Used to communicate with Nutanix
AHV backup AHV REST API.
appliance
Workers
The following table describes network ports that must be opened to ensure proper communication of workers
with other backup infrastructure components.
Worker Nutanix REST API TCP/HTTPS 9440 Used to communicate with Nutanix
AHV REST API.
Backup Server
The following table describes network ports that must be opened to ensure proper communication of the
backup server with other backup infrastructure components.
Veeam Backup server TCP/HTTPS 8543 Used to communicate with the Platform
Backup & Service REST API.
Replication
console
and Veeam
ONE server
FLR helper Backup server TCP 2500 Used to connect to the backup server
appliance during file-level restore.
Mount Backup server TCP 9401 Used to connect to the backup server
Service during file-level restore.
NOTE
For the list of ports used by the backup server to communicate with backup repositories, see the Veeam
Backup & Replication User Guide, section Used Ports.
NOTE
For the full list of ports required for Performing File-Level Restore, see the Veeam Backup & Replication
User Guide, section Used Ports.
Nutanix AHV Microsoft TCP 111 Used by the Port Mapper service.
cluster Windows
server with UDP
the mount
server role TCP 1058+ or Used as default mount port. The number
running 1063+ of port depends on where the vPower
UDP NFS Service is located:
vPower NFS
Service • 1058+: If the vPower NFS Service
is located on the backup server.
• 1063+: If the vPower NFS Service
is located on a separate Microsoft
Windows machine.
Backup server VM guest TCP 22 Default SSH port used as a control channel.
OS (Linux)
Backup server TCP 445 Required for deploying Veeam Backup &
135 Replication components.
Log shipping Backup TCP 2500 to Default range of ports used for
server repository 3300 communication with a backup repository
and transfer log backups.
Guest MS SQL VM TCP 445 Required for deploying Veeam Backup &
interaction guest OS 135 Replication components including Veeam
proxy Log Shipper runtime component.
Guest Oracle VM TCP 445 Required for deploying Veeam Backup &
interaction guest OS 135 Replication components including Veeam
proxy (Microsoft Log Shipper runtime component.
Windows)
Backup server Oracle VM TCP 22 Default SSH port used as a control channel.
guest OS
(Linux)
TCP 2500 to Default range of ports used for
3300 communication with a guest OS.
Backup server PostgreSQL TCP 22 Default SSH port used as a control channel.
VM guest
OS
TCP 2500 to Default range of ports used for
3300 communication with a guest OS.
Be aware that a best practice is not the only answer available. It will fit in the majority of cases but can also be
totally wrong under different circumstances. Make sure you understand the implications of the recommended
practices, or request assistance. If in doubt, reach out to Veeam professionals on Veeam R&D Forums.
Backup Appliance
While allocating compute resources to the Nutanix AHV backup appliance, consider the following
recommendations:
Numb er of VMs in Numb er of Jobs Resources for Management Resources for Embedded
Cluster Ta sks W orker
< 1000 < 100 2 vCPU, 2 GB RAM 1 vCPU and 1 GB RAM for each
concurrent task
If you plan to use dedicated workers, it is recommended that you modify the backup appliance settings as
follows:
• Allocate resources to the backup appliance that are sufficient for management tasks.
IMP ORTANT
To modify the backup appliance settings, use the Veeam Backup & Replication console as described in
section Editing Backup Appliance. Allocating resources to the VM running as the backup appliance in the
Nutanix Prism console may cause technical issues.
Workers
While adding a dedicated worker to the backup infrastructure, consider the following:
• [Applies only to the Prism Central deployment] It is recommended that workers are deployed in each
cluster registered with the Prism Central. If no worker is deployed in the cluster, performance of backup
operations will be affected as Veeam Backup for Nutanix AHV will use the embedded worker or a worker
deployed in another cluster.
• It is recommended that the number of configured workers does not exceed the number of hosts in the
Nutanix AHV cluster.
• It is recommended the total number of concurrent tasks configured for all workers deployed in the cluster
does not exceed the number of physical disks added to the cluster. You can change the maximum number
of concurrent tasks (the best practice is to allocate 1 vCPU and 1 GB RAM for each additional task) while
deploying a new worker or editing settings of an existing one.
IMP ORTANT
To modify the worker settings, use the Veeam Backup for Nutanix AHV web console as described in section
Disabling Automatic Worker Updates. Allocating resources to the VM running as a worker in the Nutanix
Prism console may cause technical issues.
By default, Veeam Backup for Nutanix AHV automatically revokes a license instance from a protected VM if no
new restore points have been created during the past 31 days. However, you can manually revoke l icense
instances from protected VMs as described in the Veeam Backup & Replication User Guide, section Revoking
License.
• E valuation license is a free license that can be used for product evaluation. The license is valid for 30 days
from the moment of the product download.
To obtain this license, request a trial key on the Veeam downloads page as described in the Veeam Backup
& Replication User Guide, section Obtaining and Renewing License.
• Sub scription license is a paid license with a limited subscription term. The expiration date of the
Subscription license is set to the end of the subscription term. The Subscription license term is normally 1–
5 years from the license issue date.
To obtain this license, choose the required subscription term on the Veeam Backup & Replication Pricing
page and contact the Veeam Sales Team.
• P erpetual license is a paid license without an expiration date. The Perpetual license typically includes one
year period of basic support and maintenance that can be extended.
After you obtain a license, install it on the backup server as described in the Veeam Backup & Replication User
Guide, section Installing License.
If you have a legacy perpetual per-socket license, you must obtain Veeam Universal License instances and
merge them with the existing perpetual socket license as described in the Veeam Backup & Replication User
Guide, section Merging Licenses.
To access the Nutanix AHV Plug-in functionality, you can either deploy a new backup server as described in the
Veeam Backup & Replication User Guide or use a backup server that already exists in your backup infrastructure
if it meets the Veeam Backup for Nutanix AHV system requirements.
Related Topics
• Installing Nutanix AHV Plug-in Manually
NOTE
If you use a remote Veeam Backup & Replication console, you do not need to install Nutanix AHV Plug-in
on the workstation where the remote Veeam Backup & Replication console is deployed.
1. Log in to the backup server using an account with the local Administrator permissions.
Before proceeding with installation, the installer will check whether you have Microsoft .NET Core
Runtime installed on the backup server. In case the required version is missing, the installer will offer to
install it automatically. To do that, click OK.
4. At the License Agreement step of the Nuta nix AHV Plug-In for Veeam Backup & Replication Setup wizard,
read and accept the Veeam license agreement, licensing policy, the 3rd party components and required
software license agreement. If you reject the agreements, you will not be able to continue installation.
To install Nutanix AHV Plug-in in the unattended mode, use either of the following options:
• If Nutanix AHV Plug-in is a part of Veeam Backup & Replication installation package, follow the
instructions provided in the Veeam Backup & Replication User Guide, section Installing Veeam Backup &
Replication in Unattended Mode.
• If Nutanix AHV Plug-in is delivered as a separate .EXE file, follow the instructions provided in this section.
2. Check compatibility of the Nutanix AHV Plug-in and Veeam Backup & Replication versions. For more
information, see System Requirements.
The following command-line parameters are used to run the setup file:
/silent Yes Sets the user interface level to None, which means no
user interaction is needed during installation.
/accepteula Yes Confirms that you accept the terms of the Veeam license
agreement.
/acceptthirdpartylicenses Yes Confirms that you accept the license agreement for 3rd
party components that Veeam incorporates.
/acceptlicensingpolicy Yes Confirms that you accept the Veeam licensing policy.
/acceptrequiredsoftware Yes Confirms that you accept the license agreements for
each required software that Veeam will install.
Examples
The following command installs Nutanix AHV Plug-in:
Veeam Backup for Nutanix AHV provides the following status codes to report about the installation result:
Cod e Description
For detailed logs of Nutanix AHV Plug-in installation, navigate to the Program
Data\Veeam\Setup\Temp\ folder on the backup server and view the following files:
• VeeamPluginBootstrap.log
• NutanixAHVPlugin.log
• NutanixAHVPluginUI.log
• NutanixAHVPluginProxy.log
• Download Veeam Backup & Replication version 12.3 from the Veeam downloads page.
• Plan a maintenance period. Typically, the upgrade process takes up to one hour. Make sure there are no
jobs currently running or scheduled to run during this period. Wait for the jobs to complete or disable the
jobs manually before you start upgrading Veeam Backup for Nutanix AHV.
• Back up the configuration database of the Nutanix AHV backup appliance. For more information, see the
following sections:
o For Veeam Backup for Nutanix AHV version 4.0 and 4a, see Backup for Nutanix AHV 4.0 User Guide,
section Backing Up Configuration Settings Manually.
o For Veeam Backup for Nutanix AHV version 5.0 and 5.1, see Backup for Nutanix AHV 5 User Guide,
section Performing Configuration Backup Manually.
o For Veeam Backup for Nutanix AHV version 6 and 6.1, see Backup for Nutanix AHV 6 User Guide,
section Performing Configuration Backup Manually.
1. Upgrade your Veeam Backup & Replication server to version 12.3 as described in the Veeam Backup &
Replication User Guide, section Upgrading to Veeam Backup & Replication 12. Then, complete the
Comp onents Update wizard as described in the Veeam Backup & Replication User Guide, section Server
Components Upgrade.
2. [Applies only to the Prism Central deployment] If Nutanix AHV clusters are registered with a Prism
Central, add the Prism Central to the backup infrastructure as described in section Adding Nutanix AHV
Server.
While connecting the Prism Central, Veeam Backup for Nutanix AHV will prompt you to select a backup
appliance that will be upgraded and automatically configured to manage all the jobs that are currently
managed by dedicated backup appliances in the clusters.
3. [Applies only to the standalone cluster deployment] Upgrade the Nutanix AHV backup appliance to
version 7. To do that:
a. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
c. Select the Nutanix AHV backup appliance and click Up g rade Proxy on the ribbon.
• You will be able to see information on snapshots in the Veeam Backup & Replication console. However,
you will not be able to perform any operations with these snapshots.
• You will be able to see information on image-level backups of VMs and perform data recovery operations
using these backups. However, you will not be able to perform entire VM restore to Nutanix AHV.
• You will be able to see information on jobs. However, you will only be able to remove these jobs from the
Veeam Backup & Replication console.
1. Log in to the backup server using an account with the Local Administrator permissions.
2. Open the Sta rt menu and click the Control Panel icon.
4. In the program list, select Nutanix AHV Plug-in for Veeam Backup & Replication. Then, click Uninstall.
1. Configure backup repositories where Veeam Backup for Nutanix AHV will store backups of Nutanix AHV
VMs.
2. Add to the backup infrastructure the Nutanix AHV cluster or Prism Central that administers Nutanix AHV
resources you want to protect.
3. Deploy a Nutanix AHV backup appliance that will process backup and restore operations.
• Direct attached storage: Microsoft Windows and Linux virtual and physical machines. Hardened
repositories based on Linux servers are supported.
• Ded uplicating storage appliances: ExaGrid, Quantum DXi, Dell Data Domain, HPE StoreOnce, Fujitsu
ETERNUS, Infinidat InfiniGuard.
• Cloud object storage: 11:11 Cloud Object Storage, Amazon S3, S3 compatible, Google Cloud, Wasabi Cloud
Storage, Veeam Data Cloud Vault, IBM Cloud and Microsoft Azure Blob .
To combine repositories of different types in one repository, you can configure a scale-out backup repository
and add any of supported repositories to its performance tier.
For Linux server, Microsoft Windows server, SMB share, ExaGrid, Quantum DXi, Fujitsu ETERNUS and Infinidat
InfiniGuard repositories, you can enable the Fast Clone technology that increases the speed of synthetic backup
creation and transformation, reduces disk space requirements and decreases the load on storage devices. With
this technology, Veeam Backup for Nutanix AHV references ex isting data blocks on volumes instead of copying
data blocks between files. Data blocks are copied only when files are modified. To learn how to configure a
repository to enable this functionality, see the Veeam Backup & Replication User Guide, section Fast Clone.
IMP ORTANT
• Veeam Backup for Nutanix AHV does not support storing backups in Veeam Cloud Connect and HPE
Cloud Bank Storage repositories. However, you can use them for storing copies of backups created
with Veeam Backup for Nutanix AHV.
• [For scale-out backup repositories] Due to specifics of backup jobs for Nutanix AHV VMs, Veeam
Backup for Nutanix AHV always creates a separate backup chain for each VM added to a backup job.
Thus, even if you clear the Use per-VM backup files check box in the advanced settings of a scale-
out backup repository, backups of multiple Nutanix AHV VMs are not stored in a single backup file.
• If you register a new cluster with the Prism Central, Veeam Backup for Nutanix AHV will automatically add
it to the backup infrastructure and you will be able to protect resources in this cluster. For more
information, see sections Performing Backup and Performing Restore.
• If you unregister an existing cluster from the Prism Central, you will not be able to protect resources in
this cluster anymore. To protect these resources, you can add the cluster to the backup infrastructure as a
standalone cluster. For more information, see Solution Architecture.
IMP ORTANT
If you unregister the cluster where the backup appliance resides from the Prism Central, you will not be
able to protect resources in all clusters managed by the Prism Central. If you still want to unregister this
cluster, you must first back up the appliance configuration, then remove the appliance from the backup
infrastructure, deploy a new appliance in another cluster registered with the Prism Central — and restore
the backed-up configuration to the new appliance.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
5. In the Virtualization Platforms window,select Nuta nix AHV to launch the New Nutanix AHV Server wizard.
1. In the DNS name or IP address field, enter the FQDN or IP address of the Nutanix AHV standalone cluster
or Prism Central .
2. In the Description field, provide a description for future reference. The field already contains a default
description with information about the user who added the cluster or Prism Central, date and time when it
was added.
For credentials to be displayed in the Credentials list, they must be added to the Credentials Manager as
described in the Veeam Backup & Replication User Guide, section Standard Accounts. If you have not added the
necessary credentials to the Credentials Manager beforehand, you can do this without closing the New Nutanix
AHV Sever wizard. To add an account, do the following:
1. Click Ad d .
2. In the Credentials window, specify a user name and password for the account.
3. Click OK.
The backup server will connect to the Nutanix AHV cluster or Prism Central and check its TLS certificate. If the
certificate is not trusted, the Certificate Security Alert Window will display a warning notifying that secure
communication cannot be guaranteed. To allow the backup server to connect to the Nutanix AHV cluster or
Prism Central using the certificate, click Continue.
1. [Applies only if you connect a Prism Central] Select the cluster whose helper appliance settings you want
to modify and click E d it.
2. Click Choose next to the Storage Container field, and specify a storage container where helper appliance
system files will be stored in the Select Storage Container window.
For a container to be displayed in the list of the available containers, it must be configured in the Nutanix
AHV cluster as described in Prism Element documentation or in the Nutanix AHV Prism Central as
described in Prism Central documentation.
3. Click Choose next to the Network field, and specify a network to which the helper appliance will be
connected.
For a network to be displayed in the list of the available networks, it must be configured in the Nutanix
AHV cluster as described in Prism Element documentation or in the Nutanix AHV Prism Central as
described in Prism Central documentation.
3. If DHCP is enabled for the selected network, the IP address and DNS settings of the helper appliance can
be obtained automatically.
If DHCP is disabled for the selected network, or you want to specify an IP address and configure DNS
settings manually, select the Use the following IP address option and enter the helper appliance IP
address, subnet mask and default gateway. If you select this option, you will be able to perform only one
guest OS file restore or application items restore session at a time.
At the Ba ckup Appliance step of the wizard, select the backup appliance that will be used in the Prism Central
deployment. This backup appliance will be automatically configured to manage all the jobs that are currently
managed by dedicated backup appliances in the clusters.
NOTE
While connecting the Prism Central, Veeam Backup for Nutanix AHV will remove the other backup
appliances and will deploy dedicated workers instead of them. The configuration of existing workers will
be retained.
TIP
You can review details of the cluster or Prism Central registration session in system logs as described in the
Veeam Backup & Replication User Guide, section Viewing History Statistics.
After you complete the wizard, it is required that you configure an Nutanix AHV backup appliance. You can
proceed to the New Nutanix AHV Backup Appliance wizard immediately, or launch the wizard later as described
in section Managing Backup Appliances.
3. In the working area, select the Prism Central or Nutanix AHV cluster and click E d it on the ribbon, or right-
click the Nutanix AHV cluster and select P roperties.
4. Complete the E d it Nutanix AHV Cluster wizard as described in section Adding Nutanix AHV Server.
3. In the working area, select the Nutanix AHV cluster and click Rescan on the ribbon, or right-click the
Nutanix AHV cluster and select Rescan.
TIP
In the Sy stem window, you can track the progress of the rescan session. You can close the window and
check session details later as described in the Veeam Backup & Replication User Guide, section Viewing
History Statistics..
TIP
Alternatively, in the Nutanix AHV backup appliance web console, click Configuration at the top right corner
of the Nutanix AHV backup appliance web console, select Infrastructure and click Rescan.
IMP ORTANT
Before you remove the Prism Central or Nutanix AHV cluster, you must remove the Nutanix AHV backup
appliance that processes protection jobs for the resources managed by the Prism Central or Nutanix AHV
cluster.
To remove the Prism Central or Nutanix AHV cluster from the backup infrastructure:
3. In the working area, select the Prism Central or Nutanix AHV cluster and click Remove on the ribbon, or
right-click the Prism Central or Nutanix AHV cluster and select Remove.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
3. Select the Prism Central and click Op en Console on the ribbon, or right-click the Prism Central and select
Op en Console.
TIP
You can also open the console using the web console. To do that, switch to the Configuration page,
navigate to Infrastructure, select the Prism Central and click Op en Nutanix Console.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
TIP
You can also open the console using the web console. To do that, switch to the Configuration page,
navigate to Infrastructure, select a cluster and click Op en Nutanix Console.
To add a Nutanix AHV backup appliance, you can either deploy a new Nutanix AHV backup appliance or connect
an existing one. Note that you can add only one Nutanix AHV backup appliance for each Prism Central or
standalone cluster.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
1. Click Choose next to the Cluster field, and specify a Nutanix AHV cluster where the Nutanix AHV backup
appliance will be deployed in the Select Cluster window.
For a cluster to be displayed in the list of the available clusters, it must be added to the backup
infrastructure as described in section Adding Nutanix AHV Server.
NOTE
In the Prism Central deployment, Veeam Backup for Nutanix AHV requires one backup appliance deployed
in any cluster registered with the Prism Central.
2. In the Na me field, specify a hostname (with domain name excluded) that will be assigned to the Nutanix
AHV backup appliance.
The maximum length of the hostname is 63 characters. The hyphen-minus character (-) is supported, but
you cannot use it as the first or the last character of the name.
3. [Applies only to the Standalone Cluster deployment] Click Choose next to the Storage Container field, and
specify a storage container where Nutanix AHV backup appliance system files will be stored in the Select
Storage Container window.
For a container to be displayed in the list of the available containers, it must be configured in the Nutanix
AHV cluster as described in Nutanix documentation.
NOTE
In the Prism Central deployment, Veeam Backup for Nutanix AHV automatically selects the SelfService
storage container that cannot be changed.
4. In the P roxy description field, provide a description for future reference. The field already contains a
default description with information about the user who added the proxy, date and time when the proxy
was added.
5. In the Ma x concurrent tasks field, specify the number of tasks that the Nutanix AHV backup appliance will
be able to handle in parallel. If this value is exceeded, the backup a ppliance will not start processing a new
task until one of the currently running tasks finishes.
The default number of concurrent tasks is set to 4. When you change this value, the wizard automatically
adjusts the amount of resources that will be allocated to the VM running as the Nutanix AHV backup
appliance. If you want to specify the amount of resources manually, click Ad vanced. Note that you must
take into account the Nutanix AHV backup appliance system requirements.
NOTE
When performing data protection and disaster recovery operations, Veeam Backup for Nutanix AHV
initiates a new task for each VM that is being processed.
IMP ORTANT
Do not select Active Directory accounts – the Nutanix AHV backup appliance does not support LDAP
integration.
For credentials to be displayed in the Credentials list, they must be added to the Credentials Manager as
described in the Veeam Backup & Replication User Guide, section Standard Accounts. If you have not added the
necessary credentials to the Credentials Manager beforehand, you can do this without closing the New Nutanix
AHV Ba ckup Appliance wizard. To add credentials, do the following:
1. Click Ad d .
2. In the Credentials window, specify a user name and password for the account.
The user name must start with a lowercase Latin letter and must not match Linux system user names (such
as root, daemon). The name can contain only lowercase Latin letters, numeric characters, underscores and
dashes. The maximum length of the name is 32 characters.
3. Click OK.
a. From the Network drop-down list, select a network to which the Nutanix AHV backup appliance
network interface will be connected.
For best performance, choose the network that is used for Nutanix Controller VM (CVM). For a
network to be displayed in the list of the available networks, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
b. In the Description filed, provide a network interface description for future reference.
c. If DHCP is enabled in the selected network, the IP address of the Nutanix AHV backup appliance can
be obtained automatically.
If DHCP is disabled in the selected network, or you want to specify an IP address, select the Use the
following IP address option and enter the worker IP address, subnet mask and default gateway.
To add more network interfaces, repeat the step and specify the network order using the Up and Down
buttons. For more information on multi-network configuration, see section Appendix D. Configuring
Multiple Networks.
2. If DHCP is enabled in any network to which the Nutanix AHV backup appliance will be connected, DNS
settings of the Nutanix AHV backup appliance can be obtained automatically. To configure DNS settings
manually, click Ob tain automatically and do the following in the DNS Server Settings window:
a. Select the Use the following DNS server address check box.
c. Click OK.
Since the backup appliance are Linux-based VMs, they have the same limitations that apply to machines
running the Rocky Linux operating system. That is, DNS settings cannot be configured separately for each
network added to the backup appliance.
If you specified the Nutanix AHV server domain name while adding it to the backup infrastructure, ensure
that the appliance is able to resolve the name to the cluster IP address.
• Select the Allow access to all backup repositories option if you want the Nutanix AHV backup appliance to
have access to all backup repositories added to the backup infrastructure.
• Select the Allow access to the following backup repositories option if you want the Nutanix AHV backup
appliance to have access to specific backup repositories only.
If you select the Allow access to the following backup repositories option, you must also specify backup
repositories to which the Nutanix AHV backup appliance will have access. For a backup repository to be
displayed in the Rep ository list, it must be added to the backup infrastructure as described in the Veeam
Backup & Replication User Guide, section Backup Repository.
TIP
You can review details of the deployment session in system logs as described in the Veeam Backup &
Replication User Guide, section Viewing History Statistics.
• To upgrade a Nutanix AHV backup appliance from version 4.0, 4a, 5.0, 5.1, 6 and 6.1 to 7.
• To connect a Nutanix AHV backup appliance that was previously connected to another backup server.
To add an existing Nutanix AHV backup appliance to the backup infrastructure, do the following:
After you connect the Nutanix AHV backup appliance, the backup server will retrieve information about all jobs
the appliance has ever processed. If the backup server configuration database contains records about Nutanix
AHV VM backups and if the backup files are still available in repositories, they will be imported to the Nutanix
AHV backup appliance automatically and you will be able to use them to restore entire VMs and VM disks.
NOTE
If you connect a Nutanix AHV backup appliance migrated from another cluster to protect VMs migrated
from the same cluster, you will need to reconfigure backup jobs. UUIDs of migrated VMs change, therefore,
you will need to re-add VMs to a backup job that will start new backup chains for them.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
1. Click Choose next to the Cluster field, and specify a Nutanix AHV cluster where the Nutanix AHV backup
appliance is deployed in the Select Cluster window.
For a cluster to be displayed in the list of the available clusters, it must be added to the backup
infrastructure as described in section Adding Nutanix AHV Server.
2. Click Choose next to the Na me field, and specify the VM running as the Nutanix AHV backup appliance in
the Select Virtual Machine window.
NOTE
You cannot change the storage container – it is automatically populated when you select the VM.
3. In the P roxy description field, provide a description for future reference. The field already contains a
default description with information about the user who added the proxy, date and time when the proxy
was added.
4. In the Ma x concurrent tasks field, specify the number of tasks that the Nutanix AHV backup appliance will
be able to handle in parallel. If this value is exceeded, the backup appliance will not start processing a new
task until one of the currently running tasks finishes. If you change the number of concurrent tasks, the
wizard will automatically adjust the amount of resources allocated to the VM running as the Nutanix AHV
backup appliance.
When you change number of concurrent tasks, the wizard automatically adjusts the amount of resources
that will be allocated to the VM running as the Nutanix AHV backup appliance. If you want to specify the
amount of resources manually, click Ad vanced. Note that you must take into account the Nutanix AHV
backup appliance system requirements.
When performing data protection and disaster recovery operations, Veeam Backup for Nutanix AHV
initiates a new task for each VM that is being processed.
NOTE
The following accounts cannot be used to access the Nutanix AHV backup appliance as Portal
Administrators:
For credentials to be displayed in the Credentials list, they must be added to the Credentials Manager as
described in the Veeam Backup & Replication User Guide, section Standard Accounts. If you have not added the
necessary credentials to the Credentials Manager beforehand, you can do this without closing the New Nutanix
AHV Ba ckup Appliance wizard. To add credentials, do the following:
1. Click Ad d .
2. In the Credentials window, specify a user name and password for the account.
The user name must start with a lowercase Latin letter and must not match Linux system user names (such
as root, daemon). The name can contain only lowercase Latin letters, numeric characters, underscores and
dashes. The maximum length of the name is 32 characters.
3. Click OK.
The backup server will connect to the Nutanix AHV backup appliance and check its TLS certificate. If the
certificate is not trusted, the Certificate Security Alert Window will display a warning notifying that secure
communication cannot be guaranteed. To allow the backup server to connect to the Nutanix AHV backup
appliance using the certificate, click Continue.
• Select the Allow access to all backup repositories option if you want the Nutanix AHV backup appliance to
have access to all backup repositories added to the backup infrastructure.
• Select the Allow access to the following backup repositories option if you want the Nutanix AHV backup
appliance to have access to specific backup repositories only.
If you select the Allow access to the following backup repositories option, you must also specify backup
repositories to which the Nutanix AHV backup appliance will have access. For a backup repository to be
displayed in the Rep ository list, it must be added to the backup infrastructure as described in the Veeam
Backup & Replication User Guide, section Backup Repository.
TIP
You can review details of the registration session in system logs as described in the Veeam Backup &
Replication User Guide, section Viewing History Statistics.
3. In the working area, select the Nutanix AHV backup appliance and click E d it Proxy on the ribbon, or right-
click the Nutanix AHV backup appliance and select P roperties.
a. To provide a new description for the Nutanix AHV backup appliance and change the number of tasks
that the embedded worker is able to handle in parallel, follow the instructions provided in section
Connecting Existing Backup Appliance (step 3).
b. To change credentials for the account that is used to access the Nutanix AHV backup appliance web
console, follow the instructions provided in section Connecting Existing Backup Appliance (step 4).
c. To change the network to which the Nutanix AHV backup appliance is connected or to specify a new
IP address for the appliance, follow the instructions provided in section Connecting Existing Backup
Appliance (step 5).
d. To specify backup repositories the Nutanix AHV backup appliance can access, follow the instructions
provided in section Connecting Existing Backup Appliance (step 6).
It is not recommended that you decrease the amount of allocated resources or modify the network settings
while the embedded or a dedicated worker is currently transferring data. In this case, Veeam Backup for
Nutanix AHV will terminate the related sessions and restart the appliance to update the settings
immediately.
3. In the working area, select the Nutanix AHV backup appliance and click Rescan Proxy on the ribbon, or
right-click the Nutanix AHV backup appliance and select Rescan.
TIP
In the Sy stem window, you can track the progress of the rescan session. You can close the window and
check session details later as described in the Veeam Backup & Replication User Guide, section Viewing
History Statistics..
IMP ORTANT
• You will not be able to perform VM backup, entire VM restore and VM disk restore operations unless
you deploy a new Nutanix AHV backup appliance. However, you will still be able to manage Nutanix
AHV VM backups and perform all other restore operation described in section Performing Restore.
• Records about all jobs that have been ever processed by the Nutanix AHV backup appliance will be
deleted from the Veeam Backup & Replication configuration database. Backups created by these
jobs are displayed under the Ba ckups > Disk (Orphaned) node in the Home view of the Veeam
Backup & Replication console.
3. In the working area, select the Nutanix AHV backup appliance and click Remove P roxy on the ribbon, or
right-click the Nutanix AHV backup appliance and select Remove.
4. In the Veeam Backup & Replication window, choose whether you want to permanently remove the VM
running as the Nutanix AHV backup appliance.
If you keep the VM, the configuration settings and records about backup jobs ever processed by the
appliance will be retained in the appliance database. This can be helpful if you want to connect the Nutanix
AHV backup appliance to another backup server.
1. Add the Prism Central or Nutanix AHV cluster where the Nutanix AHV backup appliance resides to the new
backup infrastructure as described in section Adding Nutanix AHV Server.
2. Remove the Nutanix AHV backup appliance from the old backup infrastructure as described section in
Removing Backup Appliance.
If you do not remove the Nutanix AHV backup appliance, it will not function properly since the old backup
server will try to manage the appliance.
IMP ORTANT
While removing the appliance, do NOT select the P ermanently delete the proxy VM from the cluster and all
of its backup jobs (irreversible) check box. Otherwise, the Nutanix AHV backup appliance VM will be
removed from the cluster.
3. Connect the Nutanix AHV backup appliance to the new backup server as described in section Connecting
Existing Backup Appliance.
4. Specify new backup repositories in the jobs configured on the appliance as described in section Editing Job
Settings.
5. Rescan the Nutanix AHV backup appliance to synchronize data with the backup server as described in
section Rescanning Backup Appliance.
6. Import Nutanix AHV backups from new backup repositories as described in section Rescanning Backups.
If the Nutanix AHV backup appliance remains unavailable, open the web console and switch to the Configuration
page. Then, in the Ad ministration section, check whether the backup appliance is able to connect both to the
backup server and to the Nutanix AHV Prism Central or cluster. If you encounter any connection issues, check
your network configuration — the appliance must be able to resolve the backup server and cluster domain
names to their IP addresses.
By default, the worker role is assigned to the backup appliance. However, this is sufficient only for small
deployments. For large deployments, it is recommended to deploy dedicated workers as the embedded worker
may not have enough bandwidth to process backup traffic. Deploying dedicated workers allows you to increase
the maximum number of concurrent backup and restore operations, and to avoid high traffic load on the host
running the backup appliance.
Each dedicated worker is launched on a specific host for the duration of a backup or restore operation. While
configuring the worker, you can manually select the host or instruct Veeam Backup for Nutanix AHV to choose a
host automatically. Manual selection may be helpful if you want to avoid launching workers on specific hosts
(for example, production ones), while automatic selection allows Veeam Backup for Nutanix AHV to optimize
data transfer and to balance the load on the hosts in the Nutanix AHV cluster. In the latter case, Veeam Backup
for Nutanix AHV uses the AHV affinity functionality to distribute workers among all hosts in the cluster instead
of launching multiple workers on one host.
Worker Lifecycle
When you add a dedicated worker to the backup infrastructure, its configuration is save d to the Veeam Backup
for Nutanix AHV configuration database, but no VM is actually deployed in the cluster unless you choose to test
the configuration. In the latter case, a VM (worker VM) is deployed and shut down after the test operation
completes.
As soon as a backup or restore session starts, Veeam Backup for Nutanix AHV tries to launch the worker and test
its configuration. If no worker VM has been previously deployed, Veeam Backup for Nutanix AHV deploys the
VM using the worker configuration saved to the configuration database. Veeam Backup for Nutanix AHV checks
host affinity settings specified for the worker and chooses a host where the worker VM will run. Then, Veeam
Backup for Nutanix AHV powers on the worker VM and installs system updates (if ava ilable). When the backup
or restore session completes, Veeam Backup for Nutanix AHV shuts down the worker VM so that it can be used
for other sessions later.
During the lifecycle, a worker can obtain one of the following statuses:
• Configured — the worker configuration is added to the Veeam Backup for Nutanix AHV configuration
database.
• [Applies only to the embedded worker] Rea dy — the worker is powered on and can be used for data
protection operations.
• [Applies only to the Prism Central deployment] It is recommended that workers are deployed in each
cluster registered with the Prism Central. If no worker is deployed in the cluster, perform ance of backup
operations will be affected as Veeam Backup for Nutanix AHV will use the embedded worker or a worker
deployed in another cluster. Note that you can enable notifications to get informed when nonoptimal
workers process VMs.
• It is recommended that the number of configured workers does not exceed the number of hosts in the
Nutanix AHV cluster.
• Each worker must be provided with sufficient compute resources to handle backup and restore tasks in
parallel. The maximum number of concurrent tasks is configured in worker settings — if this number is
exceeded, the worker will not start a new task until one of the current tasks finishes.
• It is recommended the total number of concurrent tasks configured for all workers deployed in the cluster
does not exceed the number of physical disks added to the cluster. You can change the maximum number
of concurrent tasks (the best practice is to allocate 1 vCPU and 1 GB RAM for each additional task) while
deploying a new worker or editing settings of an existing one.
• If you plan to use dedicated workers, it is recommended that you modify the backup appliance settings as
follows:
o Change the amount of allocated resources to according to the recommendations described in section
Sizing Guidelines.
Alternatively, you can disable the embedded worker. However, in this case, the backup appliance will be
allocated excessive compute resources that will be not used for handling backup traffic.
3. Click Ad d .
The maximum length of the name is 40 characters; the following characters are only supported: a -z, A-Z, 0-9, -.
The maximum length of the description is 1024 characters.
1. [Applies only to the Prism Central deployment] Click the link in the Cluster field, and specify in the Choose
cluster window a cluster where the worker will reside.
For a cluster to be displayed in the list of the available cluster, it must be configured in the Nutanix AHV
Prism Central as described in Nutanix documentation.
2. Check the The worker VM will store its files in the container field to see the storage container that is
automatically selected for worker system file.
3. In the Ma x imum concurrent tasks field, specify the number of tasks that the worker will be able to handle
in parallel. If this value is exceeded, the worker will not start processing a new task until one of the
currently running tasks finishes.
The default number of concurrent tasks is set to 4. When you change this value, the wizard automatically
adjusts the amount of resources that will be allocated to the VM running as the worker. If you want to
specify the amount of resources manually, click the link below the Ma x imum concurrent tasks field.
NOTE
When performing data protection and disaster recovery operations, Veeam Backup for Nutanix AHV
initiates a new task for each VM that is being processed.
4. To specify a host where the worker will be launched, set the Host affinity toggle to On and click the link in
the The worker VM will run on the host field.
If you do not specify host affinity settings, Veeam Backup for Nutanix AHV will automatically define the
host to launch the worker.
a. In the Description filed, provide a network interface description for future reference.
b. From the Network drop-down list, select a network to which the worker network interface will be
connected.
For best performance, choose the network that is used for Nutanix Controller VM (CVM). For a
network to be displayed in the list of the available networks, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
c. If DHCP is enabled in the selected network, the IP address of the worker can be obtained
automatically.
If DHCP is disabled in the selected network, or you want to specify an IP address, select the Use the
following IP address option and enter the worker IP address, subnet mask and default gateway.
To add more network interfaces, repeat the step and specify the network order using the Up and Down
buttons. For more information on multi-network configuration, see section Appendix D. Configuring
Multiple Networks.
2. If DHCP is enabled in the selected network, DNS settings of the worker can be obtained automatically.
If DHCP is disabled in the selected network, or you want to configure DNS settings manually, click the link
in the DNS server addresses field, select the Use the following DNS server address option and enter the IP
addresses of the preferred and alternate DNS servers.
NOTE
Since workers are Linux-based VMs, they have the same limitations that apply to machines running the
Rocky Linux operating system. That is, DNS settings cannot be configured separately for each network
added to the worker.
TIP
If you do not want to test the worker, clear the Test worker configuration when I click Finish check box and
then click Finish.
a. To provide a new name and description for the worker, follow the instructions provided in section
Adding Workers (step 2).
b. To change the cluster where worker resides, to specify a host where the worker is launched, or to
modify the number of tasks that the worker is able to handle in parallel, follow the instructions
provided in section Adding Workers (step 3).
c. To change the network to which the worker is connected or to specify a new IP address for the
worker, follow the instructions provided in section Adding Workers (step 4).
IMP ORTANT
It is not recommended that you change the worker cluster, decrease the amount of allocated resources,
adjust the affinity settings or modify the network settings while the worker is currently transferring data.
In this case, Veeam Backup for Nutanix AHV will terminate the related operations, power off the worker
and update the settings immediately.
If you want to ensure that the worker configuration is correct before it is used for a backup or restore operation,
you can start a worker configuration test manually:
Note that you can select and test multiple workers at once.
As soon as Veeam Backup for Nutanix AHV finishes the worker configuration test, the worker will be powered
off. To see detailed information on a worker test session, click the worker test status in the La st Test column.
If workers do not have access to the internet and no web proxy is used, you can disable automatic updates to
avoid connection failures and eliminate session warnings:
IMP ORTANT
The Internet Explorer browser is not supported. To access Nutanix AHV backup appliance, use Microsoft
Edge (latest version), Mozilla Firefox (latest version) or Google Chrome (latest version).
To access the Nutanix AHV backup appliance from the Veeam Backup & Replication console, do the following:
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
3. In the working area, select the Nutanix AHV backup appliance and click Op en Console on the ribbon, or
right-click the Nutanix AHV backup appliance and select Op en Console.
Alternatively, you can navigate to the IP address or hostname of the Nutanix AHV backup appliance in a
web browser.
NOTE
The web browser may display a warning notifying that the connection is untrusted. To eliminate the
warning, you can replace the TLS certificate that is currently used to secure traffic between the browser
and the backup appliance with a trusted TLS certificate. To learn how to replace certificates, see Appendix
B. Installing Custom Certificate.
If you are an administrator and you log in for the first time, use credentials of the account that you have
specified during the initial backup appliance configuration. In future, you can add other user accounts to
grant access to Veeam Backup for Nutanix AHV. For more information, see Managing Users.
TIP
If you do not remember the password, you can reset it by running the Nutanix AHV backup appliance in
recovery mode. For more information, see this Veeam KB article.
5. [Applies only if MFA is enabled for your user account] Enter a verification code sent to your trusted
device.
6. Select the Rema in logged in check box to save the specified credentials in a persistent browser cook ie so
that you do not have to provide credentials every time you access the backup appliance in a new browser
session.
Logging Out
To log out, at the top right corner of the web console window, click your user name and then click Log out.
1. At the top right corner of the web console window, click your user name.
3. In the Cha nge Password window, enter the currently used password, enter and confirm a new password,
and then click Cha nge.
There are 3 user roles that you can assign to users working with Veeam Backup for Nutanix AHV. Actions a user
can perform depend on the role.
• P ortal Administrator — can perform all configuration actions and can also act as a Portal Operator and
Restore Operator.
• P ortal Operator — can create and manage backup jobs, manage the protected data and perform all restore
operations.
The following table describes the functionality available to users with different roles in the Veeam Backup for
Nutanix AHV web console.
P ortal
Ta b Functionality P ortal Operator Restore Operator
Ad ministrator
Configuration
To add a Veeam Backup for Nutanix AHV user account, do the following:
2. Navigate to Accounts.
3. Click Ad d .
a. At the Account Info step of the wizard, specify a name and description for the user account.
The account name must start with a lowercase Latin letter and must not match Linux system user
names (such as root, daemon). The name can contain only lowercase Latin letters, numeric characters,
underscores and dashes. The maximum length of the name is 32 characters, the maximum length of
the description is 1024 characters.
b. At the General Settings step of the wizard, select a role and specify a password for the user account.
For more information on user roles, see section Managing Users.
c. At the Summary step of the wizard, review summary information and click Finish.
2. Navigate to Accounts.
a. At the Account Info step of the wizard, edit a description of the user account.
b. At the General Settings step of the wizard, select a new role for the user account.
c. At the Summary step of the wizard, review summary information and click Finish.
2. Navigate to Accounts.
4. In the Cha nge Password window, enter and confirm a new password, and then click Cha nge.
Enabling MFA
To enable MFA for a user account, do the following:
2. Navigate to Accounts.
b. To associate the authentication application with the authorization server, scan the displayed QR code
using the camera of the trusted device. Alternatively, you can open the ap plication on your device and
enter a secret key displayed in the MFA Settings window.
d. Click Ap p ly.
2. Navigate to Settings.
When you connect to the Nutanix AHV backup appliance using SSH, enter credentials of the administrator
account that you have specified during the initial backup appliance configuration.
To change the network to which the Nutanix AHV backup appliance is connected or to specify a new IP
address for the appliance, edit the appliance properties and follow the instructions provided in section
Connecting Existing Backup Appliance (step 5).
3. From the Sy nchronization mode list, choose whether you want the time set on the Nutanix AHV backup
appliance to be synchronized with the time of specific NTP servers or with the time of the guest OS
running on the host where the appliance is deployed.
4. Click Ap p ly.
NOTE
As the backup appliance time zone is automatically synchronized with the backup server time zone, it
cannot be changed manually in the Nutanix AHV backup appliance web console.
4. Click the link in the E ma il service field and configure mail server settings.
6. In the From field, enter an email address of the notification sender. This email address will be displayed in
the From field of notifications.
7. In the To field, enter an email address of a recipient. Use a semicolon to separate multiple recipient
addresses.
8. In the Sub ject field, specify a subject for notifications. You can use the following runtime variables:
9. Choose whether you want to receive email notifications in case jobs complete successfully, complete with
warnings or complete with errors.
10. 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, the Nutanix AHV backup appliance will send one notification per
every job retry.
TIP
Veeam Backup for Nutanix AHV allows you to send a test message to check whether you have configured
the settings correctly. To do that, click Send Test E mail. A test message will be sent to the specified email
address.
2. In the Ma il server name or address field, enter a DNS name or an IP address of the SMTP server. All email
notifications (including test messages) will be sent by this SMTP server.
3. In the P ort field, specify a communication port for SMTP traffic. If SSL is enabled , the default SMTP port is
587, otherwise port 25 is used.
5. For an SMTP server with SSL/TLS support, select the Connect using SSL check box to enable SSL data
encryption.
6. If your SMTP server requires authentication, select the This SMTP server requires authentication check box
and specify credentials that will be used to connect to the SMTP server.
7. Click Sa ve.
1. In E ma il Server Settings window, copy the URL from the Red irect URL field.
2. For Veeam Backup for Nutanix AHV to be able to use OAuth 2.0 to access Google Cloud or Microsoft Azure
APIs, register a new client application either in the Google Cloud console or in the Microsoft Azure portal.
3. When registering the application, make sure that the redirect URI specified for the application matches the
URL copied from the Veeam Backup for Nutanix AHV web console.
4. Back to the Veeam Backup for Nutanix AHV Web UI, do the following in E ma il Server Settings window:
a. Use the Ma il service drop-down list to choose whether the server that you want to use to send email
notifications is a Google or Microsoft mail server.
b. In the Ap p lication client ID and Client secret fields, provide the Client ID and Client secret created for
the application as described in Google Cloud documentation or Microsoft Docs.
c. [Applies only if you have selected the Microsoft option] In the Tena nt ID field, provide the ID of an
Azure AD tenant in which the application has been registered.
o Ba ckup storage notifications warn you on backup repositories running low on free disk space.
o Comp ute resources notifications inform you about CPU and RAM consumption on workers breaking
configured thresholds for more than 10 minutes. They can also notify you about perf ormance issues
caused by worker misconfiguration.
4. Click Ap p ly.
You can find backup storage and compute resource notifications in backup job session logs. Update notifications
appear at the top right corner of the Veeam Backup for Nutanix AHV window next to the user name.
It is recommended that you regularly perform configuration backup for every Nutanix AHV backup appliance
present in the backup infrastructure. Periodic configuration backups reduce the risk of data loss and minimize
the administrative overhead costs in case any problems with the backup appliances occur.
You can run configuration backup manually on demand, or instruct Veeam Backup for Nutanix AHV to do it
automatically on a regular basis. Note that the Nutanix AHV backup appliance configuration database is backed
up together with the backup server configuration data base. However, the Nutanix AHV backup appliance
configuration restore operation does not affect the backup server configuration.
1. From the main menu of the Veeam Backup & Replication console, select Configuration Backup.
a. Select the E na ble configuration backup to the following repository check box and choose a repository
where the configuration backup will be stored. Note that you cannot store configuration backups in
scale-out backup repositories and external repositories.
For a backup repository to be displayed in the list of available repositories, it must be added to the
backup infrastructure. For more information, see the Veeam Backup & Rep lication User Guide, section
Adding Backup Repositories.
b. In the Restore points to keep field, specify the number of configuration backups you want to keep.
IMP ORTANT
If you do not specify the password, the Veeam Backup for Nutanix AHV configuration database will not be
backed up.
For passwords to be displayed in the P a ssword list, they must be added to the Password Manager as
described in the Veeam Backup & Replication User Guide, section Password Manager. If you have not
added the necessary password to the Password Manager beforehand, you can do this without closing
the Configuration Backup Settings window. To add a password, click Ad d and specify a password and
a password hint that will help you remember your password if you forget it.
If you use Veeam Backup Enterprise Manager, you can also enable the Loss protection functionality
that can help you decrypt the data in case you have lost or forgotten the password. For more
information, see the Veeam Backup Enterprise Manager Guide, section Managing Encryption Keys.
e. Click Ap p ly.
1. From the main menu of the Veeam Backup & Replication console, select Configuration Backup.
a. Select the E na ble configuration backup to the following repository check box and choose a repository
where the configuration backup will be stored. Note that you cannot store configuration backups in
scale-out backup repositories and external repositories.
For a backup repository to be displayed in the list of available repositories, it must be added to the
backup infrastructure. For more information, see the Veea m Backup & Replication User Guide, section
Adding Backup Repositories.
b. In the Restore points to keep field, specify the number of configuration backups you want to keep.
c. Click Schedule and choose whether configuration backups will be created every day or monthly on
specific days.
IMP ORTANT
If you do not specify the password, the Veeam Backup for Nutanix AHV configuration database will not be
backed up.
For passwords to be displayed in the P a ssword list, they must be added to the Password Manager as
described in the Veeam Backup & Replication User Guide, section Password Manager. If you have not
added the necessary password to the Password Manager beforehand, you can do this without closing
the Configuration Backup Settings window. To add a password, click Ad d and specify a password and
a password hint that will help you remember your password if you forget it.
If you use Veeam Backup Enterprise Manager, you can also enable the Loss protection functionality
that can help you decrypt the data in case you have lost or forgotten the password. For more
information, see the Veeam Backup Enterprise Manager Guide, section Managing Encryption Keys.
f. Click OK.
• The configuration database got corrupted, and you want to recover data from a configuration backup.
• The backup appliance got corrupted, and you want to recover its configuration from a configuration
backup.
• The backup appliance went down, and you want to apply its configuration to a new backup appliance.
• You want to roll back the configuration database to a specific point in time.
• You want to apply the backed-up configuration of a Nutanix AHV backup appliance version 4.0 (or later)
to a newly deployed Nutanix AHV backup appliance.
When you restore the configuration database of a Nutanix AHV backup appliance, consider the following:
• If the Nutanix AHV backup appliance is still present in the backup infrastructure, you cannot restore its
configuration to another Nutanix AHV backup appliance added to same b ackup infrastructure. This
limitation prevents collisions between jobs with the same database ID.
• Network settings of the Nutanix AHV backup appliance remain unchanged. However, you will be able to
change these settings after the configuration restore.
• Configuration settings of dedicated workers will be restored from the configuration backup, and all
existing workers will be removed. If any of the settings (such as cluster, worker network settings, host
affinity or storage container configuration) is invalid in the current virtual environment, a warning
message will be displayed in configuration restore logs. To update worker settings, modify worker
configuration after the configuration restore.
• [Applies only to the standalone cluster deployment] If you restore the configuration database of a Nutanix
AHV backup appliance originally residing in another cluster to protect migrated VMs, you will need to
reconfigure backup jobs. UUIDs of migrated VMs change, therefore, you will need to re -add VMs to a
backup job that will start new backup chains for them.
You will also need to reconfigure backup jobs and workers, if the original applia nce was configured to
manage jobs in a Prism Central deployment and the new appliance is connected to a standalone cluster.
• [Applies only to the Prism Central deployment] If you restore the configuration database of a Nutanix AHV
backup appliance originally residing in another cluster registered with the same Prism Central, Veeam
Backup for Nutanix AHV will update backup jobs and worker configuration automatically.
IMP ORTANT
Before you start the restore process, stop and disable all jobs that are currently running.
1. In the Veeam Backup & Replication console, open the Ba ckup Infrastructure view.
3. In the working area, select the Nutanix AHV backup appliance and click Restore Configuration on the
ribbon, or right-click the Nutanix AHV backup appliance and select Restore Configuration.
1. From the Ba ckup repository list, select the backup server or backup repository where the necessary
configuration backup file is stored.
For a backup repository to be displayed in the Ba ckup repository list, it must be added to the backup
infrastructure as described in the Veeam Backup & Replication User Guide, section Backup Repository.
Note that the repository list does not include scale-out backup repositories and external repositories as
they cannot store configuration backup files.
2. Click Browse and select the necessary file in the Select file window.
If the selected configuration backup file is not stored on the backup server, Veeam Backup for Nutanix AHV will
copy the file to a temporary folder on the server and automatically delete it from the folder as soon as the
restore process completes.
• Backup file — the date and time when the backup file was created.
• Downloaded backup file — the temporary location of the configuration backup file on the backup server.
• Product — the version of Veeam Backup for Nutanix AHV that was installed the initial backup appliance.
• Catalogs — configuration data saved in the file (such as the number of configured jobs, users, logged
session records and so on).
At the Ba ckup Content step of the wizard, review the provided information and click Nex t to confirm that you
want to use the selected file to restore the configuration data.
If you do not remember the password, you can use an alternative way for data encryption. However, this option
is available only if password Loss protection was enabled when you created the backup. For more information,
see the Veeam Backup & Replication User Guide, section Decrypting Data Without Password.
IMP ORTANT
If you do not select the Local users check box, the restore process will start as soon as you click Nex t. In
this case, you will not be able to halt the process or edit the restore settings.
At the Credentials step of the wizard, specify credentials of a Portal Administrator account used to access the
Nutanix AHV backup appliance web console.
NOTE
The following accounts cannot be used to access the Nutanix AHV backup appliance as Portal
Administrators:
For credentials to be displayed in the Credentials list, they must be added to the Credentials Manager as
described in the Veeam Backup & Replication User Guide, section Standard Accounts. If you have not added the
necessary credentials to the Credentials Manager beforehand, you can do this without closing the Configuration
restore wizard. To add credentials, click Ad d and specify a user name and password in the Credentials window.
Note that the name must start with a lowercase Latin letter and must not match Linux system user names (such
as root, daemon). The name can contain only lowercase Latin letters, numeric characters, underscores and
dashes. The maximum length of the name is 32 characters.
If the specified credentials match the credentials stored in the backup configuration database, the user acc ount
will be restored. If you do not remember the password, you can specify a new user name and password. In this
case, Veeam Backup for Nutanix AHV will restore user accounts from the configuration file and create a new one
with credentials that you specify.
The restore process will start as soon as you click Restore. In this case, you will not be able to halt the
process or edit the restore settings.
• Ba ckup Jobs — the number of backup jobs that protect the VM.
• Sna pshot Jobs — the number of snapshot jobs that protect the VM.
• Update the information on Nutanix AHV VMs and jobs that protect them. To do that, click Rescan.
• View what backup jobs protect a VM. To do that, find the VM in the list and click the link in the Ba ckup
Job s column.
• View what snapshot jobs protect a VM. To do that, find the VM in the list and click the link in the Sna pshot
Job s column.
• Add VMs to existing jobs. For more information, see Adding VMs to Job.
NOTE
• If a VM is already added to the exclusion list in the job, the VM will not be protected.
• You cannot add VMs to a protection domain snapshot job. To protect a VM as part of a protection
domain, add the VM to the domain as described in Nutanix documentation and make sure that the
protection domain is included into a protection domain snapshot job.
1. Navigate to Resources.
3. Click Ad d to Job.
4. In the Ad d to Job window, choose the job that will protect the selected VM and click Ap p ly.
TIP
You can also add a VM to a backup or snapshot job using the Veeam Backup & Replication console. To do
that, in the inventory pane of the Inventory view, navigate to the Nutanix AHV cluster where the VM
resides, select the VM and click Ad d to Snapshot or Ad d to Backup on the ribbon.
A snapshot captures point-in-time image of the processed VM. You can use the snapshot to restore the
VM to the original Nutanix AHV environment.
To take VM snapshots, Veeam Backup for Nutanix AHV uses native Nutanix AHV capabilities. VM
snapshots are saved locally in the Nutanix AHV cluster where the source VMs reside. To create a VM
snapshot, configure a snapshot job.
A protection domain (PD) snapshot captures point-in-time image of consistency groups (VMs and volume
groups) that belong to the processed domain. You can use the PD snapshot to restore VMs and volume
groups to the original Nutanix AHV environment.
To take PD snapshots, Veeam Backup for Nutanix AHV uses native Nutanix AHV capabilities. PD snapshots
are saved locally in the Nutanix AHV cluster where the source PD resources reside. To create a PD
snapshot, configure a protection domain snapshot job.
To create backups, Veeam Backup for Nutanix AHV uses workers that retrieve VM data from the Nutanix
AHV cluster and forward it to a backup repository in the native Veeam format. You can use the backup to
restore the VM to the original Nutanix AHV environment or any other supported virtual environment, for
example, VMware or Hyper-V. To create a VM backup, configure a backup job or perform a VeeamZIP
operation.
NOTE
To back up data that resides on Nutanix Files, use the Veeam Backup & Replication file share backup
functionality described in the Veeam Backup & Replication User Guide, section NAS Backup.
• You cannot back up Windows 11 VMs due to AOS 6.6 technical limitations related to Virtual Trusted
Platform Module (vTPM) support. For more information on vTPM VM configuration, see Nutanix
documentation.
• The way Veeam Backup for Nutanix AHV creates image-level backups depends on whether you choose to
protect individual virtual machines, protection domains, clusters, categories or the whole Prism Central
while creating the job:
If the backup job includes individual virtual machines, as well as the whole Prism Central, category or
cluster, Veeam Backup for Nutanix AHV creates a snapshot of each VM and a VG snapshot of each volume
group, and then produces image-level backups using the created snapshots. This approach cannot
guarantee full consistency of VM and volume group data.
If the backup job includes protection domains, Veeam Backup for Nutanix AHV creates a PD snapshot of all
VMs and volume groups added to the same consistency group in each protection domain. This approach
guarantees full data consistency. However, Veeam Backup for Nutanix AHV takes PD snapshots only if
application-aware processing is disabled in job settings and the following requirements are met for each
protection domain included into the backup job:
o The protection domain does not contain multiple VMs with the same name.
o VMs and their volume groups belong to the same protection domain.
o VMs and their volume groups are included into one consistency group of the protection domain.
If any of those requirements are not met, Veeam Backup for Nutanix AHV backs up VMs and their volume
groups as if processing individual virtual machines.
• When processing a VM, Veeam Backup for Nutanix AHV always tries to produce an app lication-consistent
backup using Nutanix Guest Tools. However, if the requirements for application-consistent snapshots that
are used to create application-consistent backups are not met, Veeam Backup for Nutanix AHV creates a
crash-consistent backup instead.
If you want to create an application-consistent backup using the Veeam technology, you can configure
application-aware processing settings for resources included into the backup job. This will also allow you
to periodically back up and truncate transaction logs.
• [Applies only to the Prism Central deployment] If you want to back up VMs using data obtained from
snapshots on replica clusters, ensure that you have scheduled Prism Central protection policies to take
snapshots more frequent than the backup job runs.
• By default, backup encryption is disabled for backed-up data. However, you can enable encryption at the
repository level as described in the Veeam Backup & Replication User Guide, section Access Permissions.
• VM guest OS file indexing is not supported for backups created with Veeam Backup for Nutanix AHV.
• Since Veeam Backup & Replication does not allow you to assign information about locations to Nutanix
AHV clusters and backup appliances, job statistics do not include information on the Nutanix AHV VM data
migration between different geographic regions.
NOTE
The wizard will also include the Guest Processing step, but guest processing settings cannot be configured
in the web console due to technical limitations. You can skip this step, proceed with the wizard — and
configure these settings in the Veeam Backup & Replication console later, after you create the b ackup job.
1. Navigate to Job s .
2. Click Ad d .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
2. In the Choose resources to protect window, choose whether you want to back up all VMs in the cluster,
only specific VMs or protection domains. In the Prism Central deployment, you can also back up VMs and
clusters assigned to a specific category or all VMs managed by a P rism Central.
If you add a protection domain, Veeam Backup for Nutanix AHV will regularly check for new consistency
groups (VMs and volume groups) added to the domain and automatically update the job settings to
include these groups in the backup scope. For a protection domain to be displayed in the list of the
available domains, it must be configured in the Nutanix AHV cluster as described in Nutanix
documentation.
If you add a category, Veeam Backup for Nutanix AHV will regularly check for new VMs and clusters
assigned to the category and automatically update the job settings to include thes e resources in the
backup scope. For a category to be displayed in the list of the available categories, it must be configured
in the Nutanix AHV Prism Central as described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click Choose resources to exclude and specify the resources that you do not want to
back up — the procedure is the same as described for including resources in the backup scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to
the backup scope. However, you can change the order, for example, if you add some mission-critical VMs
to the job and want them to be processed first. To change the processing order, select a resource and use
the Up or Down buttons.
NOTE
• If you include a resource into the backup scope for multiple times (for example, an individual VM and
a PD that contains this VM), Veeam Backup for Nutanix AHV will process this resource only once.
• If you include a protection domain, category, cluster or Prism Central into the backup scop e, VMs in
this object are processed at random. To ensure that the VMs are processed in a specific order, you
must add them as standalone VMs — not as a part of the protection domain, category, cluster or
Prism Central.
[Applies only to the Prism Central deployment] To instruct Veeam Backup for Nutanix AHV to obtain VM data
from a replica cluster, select the Use snapshots from a replica site (if available) check box. If Veeam Backup for
Nutanix AHV fails to obtain data from a replica cluster, backup will be still performed using VM data obtained
from the main cluster.
2. In the Sp ecify disk protection rules window, click Ad d and select a resource that you have added to the
backup scope at step 3a.
4. In the P rotect Selected Disks Only window, choose a bus type of the disks that you want to back up, select
the necessary disks and volume groups, and click Ad d .
Disks and volume groups that you do not select will be excluded from the backup job.
NOTE
If you configure multiple disk protection rules, specific rules will override general ones. For example, if you
add a rule for a protection domain and for a VM included in this domain, Veeam Backup for Nutanix AHV
will process the VM disks according to the rule configured for the VM.
1. From the Ba ckup repository drop-down list, select a backup repository where you want to store backups.
For a backup repository to be displayed in the list of the available repositories, it must be added to the
backup infrastructure, and the Nutanix AHV backup appliance must have access to the repository.
2. In the Retention policy section, choose a retention policy that Veeam Backup for Nutanix AHV will apply to
backups created by the job:
o Select days if you want to keep restore points in a backup chain for the allowed period of time. If a
restore point is older than the specified limit, Veeam Backup for Nutanix AHV removes it from the
chain.
o Select restore points if you want a backup chain to contain only the allowed number of restore points.
If the number of allowed restore points is exceeded, Veeam Backup for Nutanix AHV removes the
earliest restore point from the chain.
For more information on how Veeam Backup for Nutanix AHV tracks and removes redundant restore
points, see Retention Policies.
NOTE
If the UUID of a VM changes (for example, if the VM was migrated to another cluster), Veeam Backup for
Nutanix AHV will be unable to continue the backup chain for this VM. After you re -add the VM to the
backup job, Veeam Backup for Nutanix AHV will start a new backup chain for it. However, you will still be
able to perform restore operations using backups from the old backup chain.
To help you implement a comprehensive backup strategy, Veeam Backup for Nutanix AHV allows you to enable
long-term retention policy for backups and to configure backup job advanced settings (for example, enable
health check, schedule active and synthetic full backups, plan backup maintenance and upload protection
domain custom scripts).
Veeam Backup for Nutanix AHV re-uses full backups created according to the backup job schedule to achieve
the desired retention for GFS policy schedules (weekly, monthly and yearly). Each full backup is marked with a
flag of the related GFS policy schedule type: the (W) flag is used to mark full backups created weekly, (M) —
monthly, and (Y) — yearly. Veeam Backup for Nutanix AHV uses these flags to control the retention period for
the created full backups. Once a flag of a GFS policy schedule is assigned to a full backup, this full back up can
no longer be removed — it is kept for the period defined in the retention settings. When the specified retention
period is over, the flag is unassigned from the full backup. If the full backup does not have any other flags
assigned, it is removed according to the short-term retention policy settings. For more information on the GFS
flag assignment and removal, see the Veeam Backup & Replication User Guide, section Long-Term Retention
Policy (GFS).
To configure a GFS policy schedule, set the Keep certain full backups longer for archival purposes toggle to On,
and specify the following options in the Configure GFS section:
• Keep weekly full backups — Veeam Backup for Nutanix AHV will keep a full backup created within a week
or on a specific day for a specified number of weeks.
• Keep monthly full backups — Veeam Backup for Nutanix AHV will keep a full backup created during a
specific week for a specified number of months.
• Keep yearly full backups — Veeam Backup for Nutanix AHV will keep a full backup created in a specific
month for a number of years.
After you configure the GFS retention policy settings, schedule active full or synthetic full backups. Otherwise,
no new full backups will be automatically produced, and Veeam Backup for Nutanix AHV will be unable to
leverage them for long-term retentions.
If you choose an object storage repository to store backups produced by the backup job, you cannot enable
synthetic full backups. However, if you configure a GFS policy, synthetic backups will be automatically
created according to the specified GFS schedule and marked with an appropriate GFS flag.
1. To configure retention settings for backups of VMs that are no longer processed by the backup job, in the
Ba ckup file maintenance section of the Ad vanced job settings window, set the Delete backups of VMs that
a re no longer included in the backup job toggle to On, and specify the number of days during which
Veeam Backup for Nutanix AHV will keep backups of VMs excluded from the job.
2. From the Compression level drop-down list, select a compression level for the backup: None, Dedupe-
friendly , Optimal, High or Extreme. For more information on data compression, see Compression and
Deduplication.
3. From the Storage optimization drop-down list, select the block size that will be used to process VMs. For
more information on the data block sizes and how they affect performance, see Storage Optimization.
4. To instruct Nutanix AHV to freeze applications running on VMs while snapshots are taken, set the E na ble
Nuta nix Guest Tools quiescense toggle to On and choose how Nutanix AHV will process transaction logs.
Keep in mind that the Never truncate transaction logs (VSS_BT_COPY) option may significantly increase
the amount of storage space consumed by VMs that function as Microsoft Exchange Mail Servers.
NOTE
This setting will be applied only if guest processing is not configured for the backup job.
NOTE
When running custom scripts, Veeam Backup for Nutanix AHV uses native Nutanix AHV capabilities to take
PD snapshots. If Nutanix AHV fails to create a PD snapshot, the backup job will also fail to complete
successfully. For more information on the prerequisites for creating PD snapshots, see Snapshot Types.
On the day scheduled for a health check to run, Veeam Backup for Nutanix AHV starts a new health check
session. For each restore point in the backup chain, Veeam Backup for Nutanix AHV calculates CRC values for
backup metadata and compares them to the CRC values that were previously saved to the restore point. Veeam
Backup for Nutanix AHV also checks whether data blocks that are required to rebuild the restore point are
available.
• If the health check detects corrupted metadata in a full restore point, Veeam Backup for Nutanix AHV
marks the backup chain as corrupted in the configuration database. During the next backup job session,
Veeam Backup for Nutanix AHV copies the full instance image, creates a full restore point in the backup
repository and starts a new backup chain in the backup repository.
• If the health check detects corrupted disk blocks in a restore point, Veeam Backup for Nutanix AHV marks
the restore point that includes the corrupted data blocks and all subsequent incremental restore points as
incomplete in the configuration database. During the next backup job session, Veeam Backup for Nutanix
AHV copies not only those data blocks that have changed since the previous backup session but also data
blocks that have been corrupted, and saves these data blocks to the latest restore point that has been
created during the current session.
To coordinate application activity on VMs included into a protection domain before and after a PD snapshot is
taken, you can run custom scripts. A custom script performs pre-freeze operations, takes the PD snapshot, and
finally performs post-thaw operations.
IMP ORTANT
Veeam does not provide support for cases related to custom scripts.
You can use any programming language to write a script. However, you must specify the used interpreter in the
shebang line, for example: #!/usr/bin/python3. For more information, see Appendix A. Custom Script
Samples.
NOTE
--clusterId [Applies only to Prism Central deployment] ID of a cluster where the protection domain
is configured.
nutanixClusterIp = os.getenv('NUTANIX_CLUSTER_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
To specify parameters required for connecting to the Prism Central where VMs included into the protection
domain are running, use environment variables such as in the following example:
nutanixPrismCentralIp = os.getenv('NUTANIX_PRISM_CENTRAL_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
You can find script logs in the custom_script.log file stored in the
/var/log/nxbackupagent/Backup/<job_name_job_uuid>/<pd_name>/ folder on the backup
appliance. The file also contains a JSON string that includes the script execution status, an error description (if
any) and an identifier of the PD snapshot if it has been created, for example:
TIP
You can track the script execution progress on the Session Logs page in the backup appliance web console.
Alternatively, you can download log files to your local machine.
1. To start the backup job automatically according to a specific backup schedule, in the Ma in job schedule
section, set the Run job automatically toggle to On, and choose one of the following schedule types:
o Da ily at this time — the backup job will create restore points at a specific time on specific days.
o Monthly at this time — the backup job will create restore points once a month on a specific day.
o P eriodically every — the backup job will create restore points repeatedly, with a specific time interval
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the backup job again if it fails on the first try. To do
that, select the Automatic Retry check box, and specify the maximum number of attempts to run the job
and the time interval between retries. When retrying backup jobs, Veeam Backup for Nutanix AHV
processes only those VMs that failed to be backed up during the previous attempt.
2. To schedule active full backups, in the Full backup schedule section, set the Create active full backups
p eriodically toggle to On, and choose whether you want to create active full backups on specific days
every week or on specific days of specific months.
Alternatively, you can create active full backups manually when needed. For more information, see
Creating Active Full Backup.
IMP ORTANT
Do not schedule synthetic and active full backups to run at the same time. Due to technical limitations,
Veeam Backup for Nutanix AHV will be unable to create synthetic full backups according to the specified
schedule.
3. To schedule synthetic full backups, in the Full backup schedule section, set the Create synthetic full
b a ckups periodically toggle to On, and choose whether you want to create synthetic full backups on
specific days every week or on specific days of specific months.
4. To instruct Veeam Backup for Nutanix AHV to periodically perform a health check for backups created by
the backup job, in the Hea lth check schedule section, set the E na ble health check toggle to On, and
specify a schedule for the health check to run.
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
1. In the Veeam Backup & Replication console, open the Home view.
3. On the ribbon, click Ba ckup Job > Virtual Machine > Nutanix AHV, or right-click the working area and
select Ba ckup > Virtual machine > Nutanix AHV .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
1. Click Ad d .
2. In the Ad d Objects window, choose whether you want to back up all VMs in the cluster, only specific VMs
or protection domains. In the Prism Central deployment, you can also back up VMs and clusters assigned
to a specific category or all VMs managed by a Prism Central.
To view the list of available protection domains, click the P Ds icon on the toolbar at the top right corner of
the window. If you add a protection domain, Veeam Backup for Nutanix AHV will regularly check for new
consistency groups (VMs and volume groups) added to the domain and automatically update the job
settings to include these groups in the backup scope. For a protection domain to be displayed in the list of
the available domains, it must be configured in the Nutanix AHV cluster as described in Nutanix
documentation.
To view the list of available categories, click the Ca tegories icon on the toolbar at the top right corner of
the window. If you add a category, Veeam Backup for Nutanix AHV will regularly check for new VMs and
clusters assigned to the category and automatically update the job settings to include these resources in
the backup scope. For a category to be displayed in the list of the available categories, it must be
configured in the Nutanix AHV Prism Central as described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click E x clusions and specify the VMs or protection domains that you do not want to back
up — the procedure is the same as described for including resources in the backup scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to the
backup scope. However, you can change the order, for example, if you add some mission-critical VMs to the job
and want them to be processed first. To change the processing order, select a resource and use the Up or Down
buttons.
NOTE
• If you include a resource into the backup scope for multiple times (for example, an individual VM and
a PD that contains this VM), Veeam Backup for Nutanix AHV will process this resource only once.
• If you include a protection domain, category, cluster or Prism Central into the backup scope, VMs in
this object are processed at random. To ensure that the VMs are processed in a specific order, you
must add them as standalone VMs — not as a part of the protection domain, category, cluster or
Prism Central.
[Applies only to the Prism Central deployment] To instruct Veeam Backup for Nutanix AHV to obtain VM data
from a replica cluster, select the Ba ckup from Prism Central replica (if available) check box. Using replica
clusters help you reduce impact of backup operations on performance of the production environment. If Veeam
Backup for Nutanix AHV fails to obtain data from a replica cluster, backup will be still performed using VM data
obtained from the main cluster.
Related Topics
Snapshot Types
1. Click E x clusions.
3. In the Ad d Objects window, select a resource that you have added to the backup scope at step 3a, and
click OK.
4. Back to the E x clusions window, select the resource and click E d it.
5. In the Select Disks window, select the Selected Disks option, click Ad d and choose a bus type of the disks
that you want to back up. Then, select the necessary disks and volume groups.
Disks and volume groups that you do not select will be excluded from the backup job.
NOTE
If you configure multiple disk protection rules, specific rules will override general ones. For example, if you
add a rule for a protection domain and for a VM included in this domain, Veeam Backup for Nutanix AHV
will process the VM disks according to the rule configured for the VM.
1. From the Ba ckup repository drop-down list, select a backup repository where you want to store backups.
For a backup repository to be displayed in the list of the available repositories, it must be added to the
backup infrastructure, and the Nutanix AHV backup appliance must have access to the repository.
2. In the Retention policy section, choose a retention policy that Veeam Backup for Nutanix AHV will apply to
backups created by the job:
o Select days if you want to keep restore points in a backup chain for the allowed period of time. If a
restore point is older than the specified limit, Veeam Backup for Nutanix AHV removes it from the
chain.
o Select restore points if you want a backup chain to contain only the allowed number of restore points.
If the number of allowed restore points is exceeded, Veeam Backup for Nutanix AHV removes the
earliest restore point from the chain.
For more information on how Veeam Backup for Nutanix AHV tracks and removes redundant restore
points, see Retention Policies.
NOTE
If the UUID of a VM changes (for example, if the VM migrates to another cluster), Veeam Backup for
Nutanix AHV will be unable to continue the backup chain for this VM. After you re -add the VM to the
backup job, Veeam Backup for Nutanix AHV will start a new backup chain for it. However, you will still be
able to perform restore operations using backups from the old backup chain.
Veeam Backup for Nutanix AHV re-uses full backups created according to the backup job schedule to achieve
the desired retention for GFS policy schedules (weekly, monthly and yearly). Each full backup is marked with a
flag of the related GFS policy schedule type: the (W) flag is used to mark full backups created weekly, (M) —
monthly, and (Y) — yearly. Veeam Backup for Nutanix AHV uses these flags to control the retention period for
the created full backups. Once a flag of a GFS policy schedule is assigned to a full backup, this full backup can
no longer be removed — it is kept for the period defined in the retention settings. When the specified retention
period is over, the flag is unassigned from the full backup. If the full backup does not have any other flags
assigned, it is removed according to the short-term retention policy settings. For more information on the GFS
flag assignment and removal, see the Veeam Backup & Replication User Guide, section Long-Term Retention
Policy (GFS).
To configure a GFS policy schedule, select the Keep certain full backups longer for archival purposes check box
and click Configure. Then, specify the following options in the Configure GFS window:
• Keep weekly full backups — Veeam Backup for Nutanix AHV will keep a full backup created within a week
or on a specific day for a specified number of weeks.
• Keep monthly full backups — Veeam Backup for Nutanix AHV will keep a full backup created during a
specific week for a specified number of months.
• Keep yearly full backups — Veeam Backup for Nutanix AHV will keep a full backup created in a specific
month for a number of years.
NOTE
If you choose an object storage repository to store backups produced by the backup job, you cannot enable
synthetic full backups. However, if you configure a GFS policy, synthetic backups will be automatically
created according to the specified GFS schedule and marked with an appropriate GFS flag.
1. Click Ad vanced.
2. To schedule synthetic full backups, on the Ba ckup tab of the Ad vanced settings window, select the Create
sy nthetic full backups periodically check box, click Configure and choose whether you want to create
synthetic full backups on specific days every week or on specific days of specific months.
3. To schedule active full backups, on the Ba ckup tab of the Ad vanced settings window, select the Create
a ctive full backups p eriodically check box, click Configure and choose whether you want to create active
full backups on specific days every week or on specific days of specific months.
Alternatively, you can create active full backups manually when needed. For more information, see
Creating Active Full Backup.
Do not schedule synthetic and active full backups to run at the same time. Due to technical limitations,
Veeam Backup for Nutanix AHV will be unable to create synthetic full backups according to the specified
schedule.
4. To instruct Veeam Backup for Nutanix AHV to periodically perform a health check for backups created by
the backup job, on the Ma intenance tab of the Ad vanced settings window, select the P erform backup files
hea lth check (detects and auto-heals corruption) check box, click Configure and specify a schedule for the
health check to run.
IMP ORTANT
• It is recommended that the backup and health check schedules configured for the job do not overlap
to avoid data access issues.
• If you have selected an off-premise cloud object storage repository as the target location for
backups at step 4, it is recommended that a helper appliance is configured in the repository settings.
Otherwise, additional data transfer costs may occur.
5. To configure retention settings for backups of VMs that are no longer processed by the backup job, on the
Ma intenance tab of the Ad vanced settings window, select the Remove deleted items data after check box,
and specify the number of days during which Veeam Backup for Nutanix AHV will keep backups of VMs
excluded from the job.
6. To decrease the size of the backup, on the Storage tab of the Ad vanced settings window, from the
Compression level drop-down list, select a compression level for the backup: None, Dedupe-friendly ,
Optimal, High or Extreme. For more information on data compression, see Compression and
Deduplication.
7. To optimize job performance and storage usage, on the Storage tab of the Ad vanced settings window,
from the Storage optimization drop-down list, select the block size that will be used to process VMs. For
more information on the data block sizes and how they affect performance, see Storage Optimization.
8. To instruct Nutanix AHV to freeze applications running on VMs while snapshots are taken, set the E na ble
Nuta nix Guest Tools quiescense toggle to On and choose how Nutanix AHV will process transaction logs.
Keep in mind that the Never truncate transaction logs (VSS_BT_COPY) option may significantly increase
the amount of storage space consumed by VMs that function as Microsoft Exchange Mail Servers.
9. [Applies only if you have included protection domains in the backup job] To instruct Veeam Backup for
Nutanix AHV to execute a custom script while running the backup job, on the Scripts tab of the Ad vanced
settings window, select the Run the following script to create a PD snapshot check box, and click Browse
to upload a script file. For more information, see Writing Custom Scripts.
When running custom scripts, Veeam Backup for Nutanix AHV uses native Nutanix AHV capabilities to take
PD snapshots. If Nutanix AHV fails to create a PD snapshot, the backup job will also fail to complete
successfully. For more information on the prerequisites for creating PD snapshots, see Snapshot Types.
When Veeam Backup for Nutanix AHV saves a new backup restore point to a backup repository, it calculates CRC
values for metadata in the backup chain and saves these values to the chain metadata, together with the
instance data. When performing a health check, Veeam Backup for Nutanix AHV verifies the availability of data
blocks, which are required to restore from the recent point only, and uses the s aved values to ensure that the
full restore points being verified are consistent.
On the day scheduled for a health check to run, Veeam Backup for Nutanix AHV starts a new health check
session. For each restore point in the backup chain, Veeam Backup for Nutanix AHV calculates CRC values for
backup metadata and compares them to the CRC values that were previously saved to the restore point. Veeam
Backup for Nutanix AHV also checks whether data blocks that are required to rebuild the restore point are
available.
If Veeam Backup for Nutanix AHV does not detect data inconsistency, the health check session completes
successfully. Otherwise, the session completes with an error. Depending on the detected data inconsistency,
Veeam Backup for Nutanix AHV performs the following operations:
• If the health check detects corrupted metadata in a full restore point, Veeam Backup for Nutanix AHV
marks the backup chain as corrupted in the configuration database. During the next backup job session,
Veeam Backup for Nutanix AHV copies the full instance image, creates a full restore point in the backup
repository and starts a new backup chain in the backup repository.
To coordinate application activity on VMs included into a protection domain before and after a PD snapshot is
taken, you can run custom scripts. A custom script performs pre-freeze operations, takes the PD snapshot, and
finally performs post-thaw operations.
IMP ORTANT
Veeam does not provide support for cases related to custom scripts.
You can use any programming language to write a script. However, you must specify the used interpreter in the
shebang line, for example: #!/usr/bin/python3. For more information, see Appendix A. Custom Script
Samples.
NOTE
--clusterId [Applies only to Prism Central deployment] ID of a cluster where the protection domain
is configured.
To specify parameters required for connecting to the Nutanix AHV cluster where VMs included into the
protection domain are running, use environment variables such as in the following example:
nutanixClusterIp = os.getenv('NUTANIX_CLUSTER_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
nutanixPrismCentralIp = os.getenv('NUTANIX_PRISM_CENTRAL_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
You can find script logs in the custom_script.log file stored in the
/var/log/nxbackupagent/Backup/<job_name_job_uuid>/<pd_name>/ folder on the backup
appliance. The file also contains a JSON string that includes the script execution status, an error description (if
any) and an identifier of the PD snapshot if it has been created, for example:
TIP
You can track the script execution progress on the Session Logs page in the backup appliance web console.
Alternatively, you can download log files to your local machine.
• Enable application-aware processing — to create transactionally consistent backups that will guarantee
proper recovery of VM applications, without data loss.
For VMs running Microsoft SQL Server, Oracle Server or PostgreSQL Server applications, you can also
instruct Veeam Backup & Replication to periodically back up transaction logs. This will allow you to
restore your databases to specific points in time as described in the Veeam Enterprise Manager User Guide,
section Restoring Point-in-Time State.
• Enable guest file system indexing and malware detection — to create a catalog of guest OS files that will
allow you to search for specific items during file-level restore. This will also allow you to receive reports
about malware files and suspicious system activity detected on VMs included into the backup scope.
• Choose guest interaction proxies — to select specific Windows servers that Veeam Backup & Replication
will use when communicating with guest OSes of Windows VMs included into the backup scope.
• Manage VM guest OS credentials — to specify credentials that Veeam Backup & Replication will use to
access guest OSes of all VMs included into the backup scope.
• Veeam Backup for Nutanix AHV will not be able to obtain VM data from replica clusters.
• Veeam Backup for Nutanix AHV will not be able to create PD snapshots of protection domains included
into the backup scope — it will back up VMs and their volume groups as if processing individual virtual
machines.
When creating application-consistent backups, Veeam Backup & Replication takes transactionally consistent VM
snapshots while no write operations occur on VM disks. To do that, Veeam Backup & Replication quiesces
applications on the processed VMs and creates a consistent view of application data:
• Instruct Veeam Backup & Replication not to process and truncate logs. This will allow third -party backup
solutions to perform VM guest-level backup and to maintain consistency of the database state.
• Instruct Veeam Backup & Replication to back up and truncate transaction logs more often. This will allow
you to use application-consistent backups to restore your MS SQL, Oracle and PostgreSQL databases to
specific points in time.
1. Click Ap p lications.
2. In the Ap p lication-Aware Processing Options window, select the necessary resource and click E d it. You can
configure guest processing settings for multiple resources at a time.
If you want to configure processing settings for a specific VM that is included into a protection domain,
cluster, category or Prism Central, you must configure those settings separately. To do that, click Ad d ,
choose the necessary VM and click E d it.
3. To specify how Veeam Backup & Replication will process transaction logs of VSS-aware applications,
select the P rocess transaction logs with this job option on the General tab of the P rocessing Settings
window, switch to the SQL tab and follow the instructions provided in section Microsoft SQL Server
Transaction Log Settings.
If you do not want Veeam Backup & Replication to process and truncate transaction logs of VSS -aware
applications, select the P erform copy only option. However, with this option selected, the backup job will
produce copy-only backups that cannot be used to restore MS SQL databases to specific points in time.
For more information on copy-only backups, see Microsoft Docs.
4. To specify how Veeam Backup & Replication will process transaction logs of Oracle database systems,
switch to the Ora cle tab and follow the instructions provided in section Oracle Archived Redo Log
Settings.
5. To specify how Veeam Backup & Replication will process transaction logs of PostgreSQL database
systems, switch to the P ostgreSQL tab and follow the instructions provided in section PostgreSQL WAL
Files Settings.
TIP
To instruct Veeam Backup & Replication not to perform application-aware processing for the selected
resource at all, select the Disable application processing option.
• Select Truncate logs to truncate transaction logs of MS SQL and MS Exchange applications after successful
backup. The non-persistent runtime components running on the VM guest OS will wait for the backup to
complete successfully and then truncate transaction logs. If the job does not manage to back up the VM,
the logs will remain untouched on the VM guest OS until the next start of the non-persistent runtime
components or persistent components.
It is recommended that you enable this option for 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 on the
VM guest OS may grow large and consume all disk space. In this case, the database administrators must
take care of transaction logs themselves.
• Select Ba ckup logs periodically to back up transaction logs with Veeam Backup & Replication. Veeam
Backup & Replication will periodically copy transaction logs to the backup repository and store them
together with the image-level backup of the Microsoft SQL Server VM. During the backup job session,
transaction logs on the VM guest OS will be truncated. For more information, see the Veeam Backup &
Replication User Guide, section Microsoft SQL Server Log Backup.
IMP ORTANT
If both Microsoft SQL Server and Oracle Server are installed on one VM, and this VM is processed by a job
with log backup enabled for both applications, Veeam Backup & Replication will back up only Oracle
transaction logs. Microsoft SQL Server transaction logs will not be processed.
1. In the Ba ckup logs every <N> minutes field, specify the frequency for transaction log 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
repository.
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
image-level backups and transaction log backups.
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 backups. For more
information, see Veeam Backup & Replication User Guide, section Retention for Transaction Log
Backups.
3. In the Log shipping servers section, click Choose to select what log shipping server you want to use to
transport transaction logs:
o Select Automatic selection if you want Veeam Backup & Replication to choose an optimal log shipping
server automatically. If the optimal shipping server is busy, Veeam Back up & Replication will direct
the data flow to another shipping server so as not to lose data and comply with RPO. The process of
transaction logs shipment does not require a dedicated server — Veeam Backup & Replication can use
any Microsoft Windows server added to the backup infrastructure.
o To define a log shipping server explicitly, select Use the specified servers only and select check boxes
next to servers that you want to use as log shipping servers. The server list includes all Microsoft
Windows servers added to the backup infrastructure.
Ensure you select a server that is not engaged in other resource-consuming tasks. For example, you
may want not to use a server that performs the WAN accelerator role as a log shipping server. For
load balance and high availability purposes, it is recommended that you select at least 2 log shipping
servers.
For more information on log shipping servers and how they are selected, see Veeam Backup &
Replication User Guide, section Log Shipping Servers.
• Veeam Backup & Replication automatically excludes its configuration database from application-
aware processing during backup if the database is hosted without using SQL Server Always On
Availability Group. Transaction logs for the configuration database are not backed up.
• If the Veeam Backup & Replication configuration database is hosted using SQL Server Always On
Availability Group, you should manually exclude this database from application-aware processing
during backup, as described in this Veeam KB article. Otherwise, job processing will fail with the
following error: Failed to freeze guest over network, wait timeout.
To specify how Veeam Backup & Replication will process archived redo logs of the Oracle database, switch to
the Ora cle tab of the P rocessing Settings window and do the following:
1. In the Sp ecify Oracle account with SYSDBA privileges section, specify a user account that Veeam Backup &
Replication will use to connect to the Oracle database. The account must have privileges for the Oracle
database listed in the section Permissions for Guest Processing.
You can select Use guest credentials in the list of user accounts. In this case, Veeam Backup & Replication
will use the account specified at the Guest Processing step of the wizard to access the VM guest OS and
connect to the Oracle database.
NOTE
[For Windows-based machines] Make sure you add the %ORACLE_HOME%\bin variable to the
environmental path variable on the machine with your Oracle database.
2. In the Archived logs section, specify how Veeam Backup & Replication must process archived redo logs on
the Oracle VM:
o Select Do not d elete archived logs if you want Veeam Backup & Replication to preserve archived logs
on the VM guest OS. When the backup job completes, the non-persistent runtime components will
not delete archived logs.
It is recommended that you select this option for databases in the NOARCHIVELOG mode. If the
database is in the ARCHIVELOG mode, archived logs on the VM guest OS may grow large and consume
all disk space. In this case, database administrators 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 Backup &
Replication to delete archived logs that are older than <N> hours or larger than <N> GB. The log size
threshold refers not to the total size of all logs for all databases but to the log size of each database
on the selected Oracle VM.
When the parent backup job (job creating an image-level backup) runs, Veeam Backup & Replication
will wait for the backup to complete successfully and then trigger archived log deletion on the Oracle
VM over Oracle Call Interface (OCI). If the primary job does not manage to back up the Oracle VM, the
logs will remain untouched on the VM guest OS until the next start of the non-persistent runtime
components.
TIP
Veeam Backup & Replication removes redo logs only after the parent backup job session. To remove redo
logs more often, you can schedule the parent job to run more often.
3. To back up Oracle archived logs with Veeam Backup & Replication, select the Ba ckup log every <N>
minutes check box and specify the frequency for archived log backup. By default, archived logs are backed
up every 15 minutes. The maximum log backup interval is 480 minutes.
4. In the Retain log backups section, specify the retention policy for archived logs stored in the backup
repository:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
image-level 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 ensure that retention for
archived logs is not greater than retention for the image-level backups. For more information, see the
Veeam Backup & Replication User Guide, section Retention for Archived Log Backup.
o Select Automatic selection if you want Veeam Backup & Replication to select an optimal log shipping
server automatically. The process of archived logs shipment does not require a dedicated server —
Veeam Backup & Replication can use any Microsoft Windows server added to the backup
infrastructure.
o Select Use the specified servers only to define a log shipping server explicitly. In the Log Shipping
Servers window, select check boxes next to the servers you want to use as log shipping servers. The
server list includes all Microsoft Windows servers added to the backup infrastructure.
Ensure you select a server that is not engaged in other resource-consuming tasks. For example, you
may want not to use a server that performs the WAN accelerator role as a log shipping server. For
load balance and high availability purposes, it is recommended that you select at least 2 log shipping
servers.
To specify how Veeam Backup & Replication will process WAL files of the PostgreSQL database, switc h to the
P ostgreSQL tab of the P rocessing Settings window and do the following:
1. From the Sp ecify PostgreSQL account with superuser privileges drop-down list, select a user account that
Veeam Backup & Replication will use to connect to the PostgreSQL instance. The account must have
privileges described in section Permissions. 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
Backup & Replication will connect to the PostgreSQL instance under the account. In this case, Veeam
Backup & Replication will use the account specified at the Guest Processing step of the wizard to access
the VM guest OS and connect to the PostgreSQL instance.
Note that if you plan to select the Sy stem user without password file (peer) authentication method at the
step 3 of this procedure, you can add a user account in the Credentials Manager without specifying the
password for the account.
2. In the Sp ecified user is section, specify how the user will authenticate against the PostgreSQL instance:
o Select Da tabase user with password if the account you specified at the step 2 is a PostgreSQL
account, and you entered the password for this account in the Credentials Manager.
NOTE
If you want Veeam Backup & Replication to use the user name map authentication, select Da tabase user
with password and leave the password field empty. Consider the following:
• Guest OS credentials specified at the Guest Processing step of the wizard will be used as the
System-Username.
• PostgreSQL account specified at the step 2 will be used as the PG-Username.
For more information about the user name maps, see PostgreSQL documentation.
o Select Da tabase user with password file (.pgpass) if the password for the account you specified at the
step 2 is defined in the .pgpass configuration file on the PostgreSQL VM. The password file must be
located in the user's home directory. For more information about the password file, see PostgreSQL
documentation.
o Select Sy stem user without password file (peer) if you want Veeam Backup & Replication to use the
peer authentication method. In this case, Veeam Backup & Replication will use the account you
specified at the step 2 as the OS account and as the PostgreSQL account to connect to PostgreSQL.
For more information about the peer authentication method, see PostgreSQL documentation.
IMP ORTANT
If you have added a new PostgreSQL account and want to use it with the peer authentication method,
make sure that you have added this account as a Linux user with sufficient permissions.
3. To back up PostgreSQL WAL files with Veeam Backup & Replication, select the Ba ck up log every <N>
minutes check box and specify the frequency for WAL files backup. By default, WAL files are backed up
every 15 minutes. The maximum log backup interval is 480 minutes.
4. In the Retain log backups section, specify the retention policy for WAL files stored in the backup
repository:
o Select Until the corresponding image-level backup is deleted to apply the same retention policy for
both image-level backups and WAL file backups.
5. In the Temp orary location for archive logs (Staging location for archive logs - for version 12) section,
specify a path to the storage location where you want to keep WAL files.
6. In the Log shipping servers section, click Choose to select what log shipping server you want to use to
transport WAL files:
o Select Automatic selection if you want Veeam Backup & Replication to select an optimal log shipping
server automatically. The process of WAL files shipment does not require a dedicated server — Veeam
Backup & Replication can use any Microsoft Windows server added to the backup infrastructure.
Make sure that you select a server that is not used by other resource-consuming tasks. For example,
you may want not to use a server that performs the WAN accelerator role as a log shipping server. For
load balance and high availability purposes, it is recommended that you select at least 2 log shipping
servers.
If you plan to back up VMs running applications that do not support VSS, you can specify what scripts Veeam
Backup & Replication must use to quiesce the VM. The pre-freeze script quiesces the VM file system and
application data to bring the VM to a consistent state before Veeam Backup & Replication triggers a VM
snapshot. After the VM snapshot is created, the post-thaw script brings the VM and applications to their initial
state.
2. In the Script processing mode section, specify the scenario for scripts execution:
o Select Require successful script execution if you want Veeam Backup & Replication 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.
o Select Disable script execution if you do not want to run scripts for the VM.
3. In the W indows scripts section, specify paths to pre-freeze and post-thaw scripts for Microsoft Windows
VMs. For the list of supported script formats, see the Veeam Backup & Replication User Guide, section Pre-
Freeze and Post-Thaw Scripts.
If you have added a protection domain, category, cluster or Prism Central with Microsoft Windows and
Linux VMs to the job, you can select to execute both Microsoft Windows and Linux scripts for the VM
container. When the job starts, Veeam Backup & Replication will automatically determine what OS type is
installed on the VM and use the required scripts to quiesce this VM.
NOTE
If you enable file indexing, Veeam Backup & Replication will scan VM data for suspicious file system activity
and malware file presence every time the backup job completes successfully. For more information, see the
Veeam Backup & Replication User Guide, section How Guest Indexing Data Scan Works.
By default, Veeam Backup & Replication will create a catalog of all files and folders for each processed VM —
except for system files. To change this behavior and configure indexing settings for specific VMs, do the
following:
2. In the Guest File System Indexing Options window, select the necessary VMs and click E d it > W indows
ind exing or Linux indexing.
You can configure indexing settings for one or more VMs at a time.
3. In the Ind exing Settings window, choose whether you want to index files in all guest OS folders, to index
files only in specific folders, or not to index any files at all.
If you select the Ind ex everything except or Ind ex only following folders option, you will be able to modify
the list of folders included into the indexing scope — either manually or by using system environment
variables (for example, %windir%, %ProgramFiles% and %Temp%).
IMP ORTANT
To allow Veeam Backup & Replication to perform guest OS file indexing for Linux VMs, openssh, gzip and
tar utilities must be installed on the processed VMs.
To produce transactionally consistent backups and to perform file system indexing, Veeam Backup & Replication
communicates with the guest OS of each processed VM to deploy non-persistent runtime components that
coordinate guest processing activities such as accessing VM applications and creating a catalog of VM files. Since
these activities may significantly increase the load on the backup server in case of a large backup scope, Veeam
Backup & Replication distributes the load among all Windows servers added to the backup infrastructure
(further referred to as guest interaction proxies).
By default, Veeam Backup & Replication automatically chooses which guest interaction proxy to use for each of
the processed VMs based on network settings and rules listed in the Veeam Backup & Replication User Guide,
section Guest Interaction Proxies. You can also manually limit the list of servers that may be used as proxies — to
do that, click Choose, select the P refer the following guest interaction proxy servers option and then select
check boxes next to the necessary Windows servers.
By default, Veeam Backup & Replication uses single credentials to access guest OSes of all VMs included into
the backup scope. However, since Windows-based VMs and Linux-based VMs require different types of access
credentials, you may need to specify the credentials explicitly for each of the processed VMs. To do that, click
Credentials, select a VM in the Guest OS credentials window, and then click Set User > Standard credentials (for
a Windows-based VM) or Set User > SSH credentials (for a Linux-based VM).
For a user to be displayed in the Credentials list, it must be added to the Credentials Manager as described in the
Veeam Backup & Replication User Guide, section Credentials Manager. If you have not added the necessary user
to the Credentials Manager beforehand, you can do it without closing the New Job wizard. To do that, click
either the Ma nage accounts link or the Ad d button, and specify the user name, password and description in the
Credentials window.
TIP
If the backup scope includes a protection domain, cluster, category or Prism Central, you can specify both
Standard and SSH credentials. This will allow Veeam Backup & Replication to access the processed VMs
regardless of their guest OSes.
To help you implement a comprehensive backup strategy, Veeam Backup for Nutanix AHV allows you to create
schedules of the following types:
• Da ily at this time — the backup job will create restore points at a specific time on specific days.
• Monthly at this time — the backup job will create restore points once a month on a specific day.
• P eriodically every — the backup job will create restore points repeatedly, with a specific time interval
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the backup job again if it fails on the first try. To do
that, select the Retry failed items processing check box, and specify the maximum number of attempts to
run the job and the time interval between retries. When retrying backup jobs, Veeam Backup for Nutanix
AHV processes only those VMs that failed to be backed up during the previous attempt.
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
• You cannot use snapshot jobs to create PD snapshots. If you add a protection domain to a snapshot job,
Veeam Backup for Nutanix AHV will create snapshots of individual VMs included into the protection
domain.
• You cannot create snapshots of instantly recovered VMs since the VM disks have not completed migration
to the Nutanix AHV cluster yet, which may cause the snapshots to become incomplete in case the mount
server is disconnected.
1. Navigate to Job s .
2. Click Ad d .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
If you add a protection domain, Veeam Backup for Nutanix AHV will regularly check for new VMs added to the
domain and automatically update the job settings to include these VMs in the backup scope. For a protection
domain to be displayed in the list of the available domains, it must be configured in the Nutanix AHV cluster as
described in Nutanix documentation.
If you add a category, Veeam Backup for Nutanix AHV will regularly check for new VMs and clusters assigned to
the category and automatically update the job settings to include these resources in the backup scope. For a
category to be displayed in the list of the available categories, it must be configured in the Nutanix AHV Prism
Central as described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click Choose resources to exclude and specify the VMs or protection domains that you
do not want to protect — the procedure is the same as described for including resources in the backup
scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to the
backup scope. However, you can change the order, for example, if you add some mission-critical VMs to the job
and want them to be processed first. To change the processing order, select a resource and use the Up or Down
buttons.
If you include a protection domain, category, cluster or Prism Central into the backup scope, VMs in this
object are processed at random. To ensure that the VMs are processed in a specific order, you must add
them as standalone VMs — not as a part of the protection domain, category, cluster or Prism Central.
If the restore point limit is exceeded, Veeam Backup for Nutanix AHV removes the earliest restore point from
the chain. For more information, see Snapshot Retention.
To help you implement a comprehensive data protection strategy, Veeam Backup for Nutanix AHV allows you to
create schedules of the following types:
• Da ily at this time — the snapshot job will create restore points at a specific time on specific days.
• Monthly at this time — the snapshot job will create restore points once a month on a specific day.
• P eriodically every — the snapshot job will create restore points repeatedly, with a specific time interval
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the snapshot job again if it fails on the first try. To
do that, select the Automatic Retry check box, and specify the maximum number of attempts to run the job
and the time interval between retries. When retrying snapshot jobs, Veeam Backup for Nutanix AHV
processes only those VMs whose snapshots were not taken during the previous attempt..
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
1. In the Veeam Backup & Replication console, open the Home view.
3. On the ribbon, click Ba ckup Job > Virtual Machine > Nutanix AHV, or right-click the working area and
select Ba ckup > Virtual machine > Nutanix AHV .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
To view the list of available protection domains, click the P Ds icon on the toolbar at the top right corner of the
window. If you add a protection domain, Veeam Backup for Nutanix AHV will regularly check for new VMs added
to the domain and automatically update the job settings to include these VMs in the backup s cope. For a
protection domain to be displayed in the list of the available domains, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
To view the list of available protection domains, click the Ca tegories icon on the toolbar at the top right corner
of the window. If you add a category, Veeam Backup for Nutanix AHV will regularly check for new VMs and
clusters assigned to the category and automatically update the job settings to include these resources in the
backup scope. For a category to be displayed in the list of the available categories, it must be configured in the
Nutanix AHV Prism Central as described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click E x clusions and specify the VMs or protection domains that you do not want to
protect — the procedure is the same as described for including resources in the backup scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to the
backup scope. However, you can change the order, for example, if you add some mission-critical VMs to the job
and want them to be processed first. To change the processing order, select a resource and use the Up or Down
buttons.
If you include a protection domain, category, cluster or Prism Central into the backup scope, VMs in this
object are processed at random. To ensure that the VMs are processed in a specific order, you must add
them as standalone VMs — not as a part of the protection domain, category, cluster or Prism Central.
If the restore point limit is exceeded, Veeam Backup for Nutanix AHV removes the e arliest restore point from
the chain. For more information, see Snapshot Retention.
To help you implement a comprehensive data protection strategy, Veeam Backup for Nutanix AHV allows you to
create schedules of the following types:
• Da ily at this time — the snapshot job will create restore points at a specific time on specific days.
• Monthly at this time — the snapshot job will create restore points once a month on a specific day.
• P eriodically every — the snapshot job will create restore points repeatedly, with a specific time interval
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the snapshot job again if it fails on the first try. To
do that, select the Automatic Retry check box, and specify the maximum number of attempts to run the job
and the time interval between retries. When retrying snapshot jobs, Veeam Backup for Nutanix AHV
processes only those VMs whose snapshots were not taken during the previous attempt..
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
• You cannot create snapshots of a protection domain if it contains multiple VMs with the same name.
• You cannot create snapshots of a protection domain if it contains VMs with attached volume groups that
are not included into the protection domain.
• You cannot create snapshots of instantly recovered VMs since the VM disks have not completed migration
to the Nutanix AHV cluster yet, which may cause the snapshots to become incomplete in case the mount
server is disconnected.
• You cannot create snapshots of a protection domain in the Inactive state (for example, after having been
replicated to a remote site).
1. Navigate to Job s .
2. Click Ad d .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
Veeam Backup for Nutanix AHV will regularly check for new consistency groups (VMs and volume groups) added
to the domain and automatically update the job settings to include them in the backup scope. For a protection
domain to be displayed in the list of the available domains, it must be configured in the Nutanix AHV cluster as
described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click Choose resources to exclude and specify protection domains that you do not want
to protect — the procedure is the same as described for including resources in the backup scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to the
backup scope. However, you can change the order, for example, if you add some mission-critical VMs to the job
and want them to be processed first. To change the processing order, select a resource and use the Up or Down
buttons.
NOTE
If you include a cluster or Prism Central into the backup scope, PDs in this cluster are processed at random.
To ensure that the PDs are processed in a specific order, you must add them as standalone PDs — not as a
part of the cluster or Prism Central.
TIP
To instruct Veeam Backup for Nutanix AHV to execute a custom script while running the PD snapshot job,
set the Run the following script to create a P D snapshot toggle to On, and click Browse to upload a script
file. For more information, see Writing Custom Scripts.
IMP ORTANT
Veeam does not provide support for cases related to custom scripts.
You can use any programming language to write a script. However, you must specify the used interpreter in the
shebang line, for example: #!/usr/bin/python3. For more information, see Appendix A. Custom Script
Samples.
NOTE
--clusterId [Applies only to Prism Central deployment] ID of a cluster where the protection domain
is configured.
To specify parameters required for connecting to the Nutanix AHV cluster where VMs included into the
protection domain are running, use environment variables such as in the following example:
nutanixClusterIp = os.getenv('NUTANIX_CLUSTER_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
To specify parameters required for connecting to the Prism Central where VMs included into the protection
domain are running, use environment variables such as in the following example:
nutanixPrismCentralIp = os.getenv('NUTANIX_PRISM_CENTRAL_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
You can find script logs in the custom_script.log file stored in the
/var/log/nxbackupagent/Backup/<job_name_job_uuid>/<pd_name>/ folder on the backup
appliance. The file also contains a JSON string that includes the script execution status, an error description (if
any) and an identifier of the PD snapshot if it has been created, for example:
TIP
You can track the script execution progress on the Session Logs page in the backup appliance web console.
Alternatively, you can download log files to your local machine.
To help you implement a comprehensive data protection strategy, Veeam Backup for Nutanix AHV allows you to
create schedules of the following types:
• Da ily at this time — the PD snapshot job will create restore points at a specific time on specific days.
• Monthly at this time — the PD snapshot job will create restore points once a month on a specific day.
• P eriodically every — the PD snapshot job will create restore points repeatedly, with a specific time inter val
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the job again if it fails on the first try. To do that,
select the Automatic Retry check box, and specify the maximum number of attempts to run the job and the
time interval between retries. When retrying PD snapshot jobs, Veeam Backup for Nutanix AHV processes
only those PDs whose snapshots were not taken during the previous attempt.
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
1. In the Veeam Backup & Replication console, open the Home view.
3. On the ribbon, click Ba ckup Job > Virtual Machine > Nutanix AHV, or right-click the working area and
select Ba ckup > Virtual machine > Nutanix AHV .
The maximum length of the name is 40 characters; the following characters are not supported: \ / " ' [ ] : | < > +
= ; , ? * @ & _. The maximum length of the description is 1024 characters.
Veeam Backup for Nutanix AHV will regularly check for new consistency groups (VMs and volume groups) added
to the domain and automatically update the job settings to include them in the backup scope. For a protection
domain to be displayed in the list of the available domains, it must be configured in the Nutanix AHV cluster as
described in Nutanix documentation.
TIP
As an alternative to specifying resources explicitly, you can exclude a number of resources from the backup
scope. To do that, click E x clusions and specify the protection domains that you do not want to protect —
the procedure is the same as described for including resources in the backup scope.
Consider that if a resource appears both in the list of included and excluded resources, Veeam Backup for
Nutanix AHV will still not process the resource because the list of excluded resources has a higher priority.
While running the job, Veeam Backup for Nutanix AHV processes resources in the order they are added to the
backup scope. However, you can change the order, for example, if you add some mission-critical VMs to the job
and want them to be processed first. To change the processing order, select a resource and use the Up or Down
buttons.
NOTE
If you include a cluster or Prism Central into the backup scope, PDs in this cluster are processed at random.
To ensure that the PDs are processed in a specific order, you must add them as standalone PDs — not as a
part of the cluster or Prism Central.
TIP
To instruct Veeam Backup for Nutanix AHV to execute a custom script while running the PD snapshot job,
click Ad vanced, then, in the Ad vanced settings window, select the Run the following script to create a PD
sna pshot check box and click Browse to upload a script file. For more information, see Writing Custom
Scripts.
IMP ORTANT
Veeam does not provide support for cases related to custom scripts.
You can use any programming language to write a script. However, you must specify the used interpreter in the
shebang line, for example: #!/usr/bin/python3. For more information, see Appendix A. Custom Script
Samples.
--clusterId [Applies only to Prism Central deployment] ID of a cluster where the protection domain
is configured.
To specify parameters required for connecting to the Nutanix AHV cluster where VMs included into the
protection domain are running, use environment variables such as in the following example:
nutanixClusterIp = os.getenv('NUTANIX_CLUSTER_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
To specify parameters required for connecting to the Prism Central where VMs included into the protection
domain are running, use environment variables such as in the following example:
nutanixPrismCentralIp = os.getenv('NUTANIX_PRISM_CENTRAL_ADDRESS')
nutanixLogin = os.getenv('NUTANIX_CLUSTER_LOGIN')
nutanixPass = os.getenv('NUTANIX_CLUSTER_PASSWORD')
You can find script logs in the custom_script.log file stored in the
/var/log/nxbackupagent/Backup/<job_name_job_uuid>/<pd_name>/ folder on the backup
appliance. The file also contains a JSON string that includes the script execution status, an error description (if
any) and an identifier of the PD snapshot if it has been created, for example:
TIP
You can track the script execution progress on the Session Logs page in the backup appliance web console.
Alternatively, you can download log files to your local machine.
To help you implement a comprehensive data protection strategy, Veeam Backup for Nutanix AHV allows you to
create schedules of the following types:
• Da ily at this time — the PD snapshot job will create restore points at a specific time on specific days.
• Monthly at this time — the PD snapshot job will create restore points once a month on a specific day.
• P eriodically every — the PD snapshot job will create restore points repeatedly, with a specific time interval
every day.
TIP
You can instruct Veeam Backup for Nutanix AHV to run the job again if it fails on the first try. To do that,
select the Automatic Retry check box, and specify the maximum number of attempts to run the job and the
time interval between retries. When retrying PD snapshot jobs, Veeam Backup for Nutanix AHV processes
only those PDs whose snapshots were not taken during the previous attempt.
TIP
If you want to start the job immediately, select the Run the job when I click Finish check box and then click
Finish.
While evaluating the data transmission process, Veeam Backup for Nutanix AHV leverages the Veeam Backup &
Replication functionality to analyze performance of all the data flow components:
• Source — the source disk reader component responsible for retrieving data from the source node.
• Network — the network queue writer component responsible for getting processed VM data from the
worker and sending it over the network to the Target (directly or through the Gateway Server).
• Ta rget — the gateway server component responsible for processing VM data, or the target disk writer
component responsible for storing data in the backup repository.
To see the bottleneck statistics for a job or a specific VM processed by the job, do the following:
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, right-click a backup job for which you want to see the bottleneck statistics, and select
Sta tistics.
o To see the aggregated statistics for the whole job, check the Loa d field in the Action column.
o To see the bottleneck statistics for a specific VM, click a VM name and check the Loa d field in the
Action column.
To learn how to analyze the bottleneck statistics, see Veeam Backup & Replication User Guide, section
Performance Bottlenecks.
1. Navigate to Job s .
3. Click Clone.
The name of the cloned job is formed by the following rule: <job_name_clone1> , where job_name is the name of
the original job and clone1 is a suffix added to the original job name. If you clone the same job again, the number
in the name will be incremented, for example, job_name_clone2, job_name_clone3 and so on. To change the
name of a cloned job, edit the job as described in section Editing Job Settings.
NOTE
If the original job is scheduled to run automatically, Veeam Backup for Nutanix AHV disables the cloned
job. To enable the cloned job, select it in the job list and click E na ble.
TIP
You can also clone a job using the Veeam Backup & Replication console. To do that, in the inventory pane
of the Home view, select Job s > Ba ckup, select the job and click Clone on the ribbon.
1. Navigate to Job s .
TIP
You can also start or stop a job using the Veeam Backup & Replication console. To do that, in the inventory
pane of the Home view, select Job s > Ba ckup, select the job and click Sta rt or Stop on the ribbon.
1. Navigate to Job s .
3. Click Retry.
TIP
You can also retry a job using the Veeam Backup & Replication console. To do that, in the inventory pane of
the Home view, select Job s > Ba ckup, select the job and click Retry on the ribbon.
1. Navigate to Job s .
You can select the job for editing even when it is running.
3. Click E d it:
o To update configuration of a backup job, complete the wizard as described in section Creating Backup
Jobs.
o To update configuration of a snapshot job, complete the wizard as described in section Creating
Snapshot Jobs.
o To update configuration of a protection domain snapshot job, complete the wizard as described in
section Creating Protection Domain Snapshot Jobs.
TIP
You can also start the E d it Job wizard using the Veeam Backup & Replication console. To do that, in the
inventory pane of the Home view, select Job s > Ba ckup, select the job and click E d it on the ribbon.
1. Navigate to Job s .
TIP
You can also enable or disable a job using the Veeam Backup & Replication console. To do that, in the
inventory pane of the Home view, select Job s > Ba ckup, select the job and click E nable or Disable on the
ribbon.
1. Navigate to Job s .
3. Click Delete.
TIP
You can also delete a job using the Veeam Backup & Replication console. To do that, in the inventory pane
of the Home view, select Job s > Ba ckup, select the job and click Delete on the ribbon.
3. Click Y es.
NOTE
To create active full backup automatically according to a specific schedule, configure backup job settings
as described in section Creating Backup Jobs (step 3).
TIP
You can also create active full backups using the Veeam Backup & Replication console. To do that, in the
inventory pane of the Home view, select Job s > Ba ckup, select the job and click Active Full on the ribbon.
NOTE
You cannot store VeeamZIP backups in Veeam Cloud Connect and HPE Cloud Bank Storage repositories.
1. In the Veeam Backup & Replication console, open the Inventory view.
3. It the working area, right-click the VM that you want to back up, and select VeeamZIP.
TIP
You cannot specify an SMB share that requires authentication as a local or shared folder. However, you can
add the SMB share to the backup infrastructure and specify it as backup repository.
The created VeeamZIP backup will be displayed under the Ba ckups > Disk (Exported) node in the Home view of
the Veeam Backup & Replication console.
• Rescanning Backups
• Verifying Backups
• Exporting Backups
• Copying Backups
• Deleting Backups
• Deleting Snapshots
• Res tore Points — the date and time of all restore points created for a VM.
• Files — the size of processed VM data, the size and the storage location of backed -up VM data, the ratio of
data deduplication and the ratio of data compression.
1. In the Veeam Backup & Replication console, open the Home view.
NOTE
When you import backups, the jobs that produced those backups are not re-created. To re-create the jobs,
restore the Nutanix AHV backup appliance configuration as described in section Restoring Configuration
Settings.
1. Ensure that the Nutanix AHV backup appliance has access to repositories where the necessary backups are
stored.
3. Navigate to Ba ck up Server.
The Nutanix AHV backup appliance will scan the repositories and import all Nutanix AHV VM backups
created by Veeam Backup for Nutanix AHV. To track the progress of the import operation, click Go to
Sessions.
To see the list of imported backups, switch to the P rotected VMs page.
1. In the Veeam Backup & Replication console, open the Home view.
2. In the inventory pane, select Job s and click SureBackup Job on the ribbon.
3. At the Na me step of the New SureBackup Job wizard, select the Ba ckup verification and content scan only
verification mode, and then complete the wizard as described in the Veeam Backup & Replication User
Guide, section Creating SureBackup Jobs.
If any of the verification checks fail for a restore point, Veeam Backup & Replication will mark both this restore
point and all subsequent points in the backup chain as Infected . To learn how to manage infected restore points,
see Veeam Backup & Replication User Guide, section Managing Malware Status.
TIP
You can scan backups of Windows VMs manually on demand, without creating a SureBackup job. To learn
how to do that, see the Veeam Backup & Replication User Guide, section Scan Backup.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, right-click a VM for which you want to synthesize a full backup file, and select E x port
Ba ckup.
4. Complete the New E xport wizard as described in the Veeam Backup & Replication User Guide, section
Performing Export.
Once the export operation completes, the exported backup will be displayed under the Ba ckups > Disk
( E xported) node in the Home view of the Veeam Backup & Replication console.
1. In the Veeam Backup & Replication console, open the Home view.
2. In the inventory pane, select Job s and click Ba ckup Copy on the ribbon.
3. Create a backup copy job as described in the Veeam Backup & Replication User Guide, section Creating
Backup Copy Jobs.
Note that you can copy backups to Veeam Cloud Connect repositories if a service provider is added to Veeam
Backup & Replication. You can also restore VMs from backup copies stored in those r epositories if you use
Veeam Cloud Connect version 12.
TIP
Alternatively, you can create a copy of a backup without configuring a job as described in the Veeam
Backup & Replication User Guide, section Copying Backups.
a. Connect tape devices as described in the Veeam Backup & Replication User Guide, section Tape
Devices Deployment.
b. Perform initial configuration of the tape infrastructure as described in the Veeam Backup &
Replication User Guide, section Getting Started with Tapes (steps 1–3).
2. Create a backup to tape job as described in the Veeam Backup & Replication User Guide, section Creating
Backup to Tape Jobs.
NOTE
You cannot restore Nutanix AHV VMs directly from tapes. To restore a Nutanix AHV VM, you must first
restore its backups to a repository as described in the Veeam Backup & Replication User Guide, section
Backup Restore from Tape to Repository.
To delete backup files created for a Nutanix AHV VM by a backup or snapshot job, do the following:
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the job that created the backup, right-click the VM name and select Delete
from disk.
NOTE
[Applies only to Veeam Backup & Replication version 12.1 and later] If 4-eyes authorization is enabled in
Veeam Backup & Replication, deleting backup files will require additional approval from another user with
the Veeam Backup Administrator role.
o Select All to remove all VM snapshots including snapshots taken in the Nutanix AHV Prism console.
o Select Created by Job to remove only snapshots created by Veeam Backup for Nutanix AHV jobs.
NOTE
If the VM is protected with PD snapshots, you can choose whether you want to delete or skip them. If you
choose to delete the PD snapshots, Veeam Backup for Nutanix AHV will delete snapshots of the selected
VM and of all other VMs included into the protection domain. If you choose to skip the PD s napshots,
snapshots of the selected VM included in the protection domain will retain.
• Entire VM restore — recover Nutanix AHV VMs to the original location or to a new location.
• VM disk restore — recover a specific VM disk and attach it to the original VM or to another VM.
• Disk publishing — mount specific disks of a backed-up Nutanix AHV VMs to any server added to the backup
infrastructure.
• Application items restore — restore applications, such as Microsoft Active Directory, Microsoft Exchange,
Microsoft SharePoint, and Microsoft SQL Server.
• VM disk export — restore VM disks and convert them to disks of the VMDK, VHD or VHDX format.
• Restore to AWS — restore Nutanix AHV VMs to Amazon Web Services as EC2 instances.
• Restore to Microsoft Azure — restore Nutanix AHV VMs to Microsoft Azure as Azure VMs.
• Restore to Google Cloud — restore Nutanix AHV VMs to Google Cloud as VM instances.
Supported Workloads
To restore machines to a Nutanix AHV cluster, you can use the following backups and snapshots:
• Snapshots of Nutanix AHV PDs created by Veeam Backup for Nutanix AHV
• Snapshots of Nutanix AHV VMs created by Veeam Backup for Nutanix AHV
• Backups of Nutanix AHV VMs created by Veeam Backup for Nutanix AHV (including VMs with volume
groups attached and VMs with no disks attached)
• Backups of Microsoft Hyper-V and VMware vSphere VMs created by Veeam Backup & Replication
• Backups of virtual and physical machines created by Veeam Agent for Microsoft Windows and Veeam
Agent for Linux
• Backups of Microsoft Azure VMs created by Veeam Backup for Microsoft Azure
• Backups of Google Cloud VM instances created by Veeam Backup for Google Cloud
• Backups of oVirt KVM VMs created by Veeam Backup for Oracle Linux Virtualization Manager and Red Hat
Virtualization
VM restore is supported only for snapshots stored in the Nutanix AHV cluster and for backups stored in backup
repositories, object storage repositories, and on the performance, capacity and archive tier of a scale-out backup
repository (except for backups stored in the archive tier that consists of the Amazon S3 Glacier Instant Retrieval
extent; for those backups, you can perform Instant Recovery).
NOTE
You cannot restore VMs from backups stored in external repositories, Veeam Cloud Connect repositories,
HPE Cloud Bank Storage and on tapes.
• When restoring a VM from a snapshot, backup snapshot or PD snapshot, Veeam Backup for Nutanix AHV
stores virtual disks of the recovered VM in the original storage container.
• When restoring a VM from a snapshot or PD snapshot, Veeam Backup for Nutanix AHV retains the original
VM network settings. After the VM is restored, you can change these settings using the Nutanix Prism
console as described in Nutanix documentation.
• To restore a VM from a backup stored in the archive tier of a scale-out backup repository, you must first
retrieve backup data as described in the Veeam Backup & Replication User Guid e, section Retrieving
Backup Files.
• A VM restored from a backup created by a solution other than Veeam Backup for Nutanix AHV may
become unreachable through the network. To resolve the issue, log in to the VM console using Nutanix
AHV Prism Element console and install Nutanix Guest Tools as described in Nutanix documentation.
• When restoring a VM that originally resided on a platform other than Nutanix AHV, Veeam Backup for
Nutanix AHV attaches VM disks with the restored data to the target VM disk nodes using their original b us
types. Veeam Backup for Nutanix AHV can attach to a VM up to 6 SATA, 256 SCSI, 4 IDE and 7 PCI disks. If
the VM has more disks of any of those bus types, Nutanix AHV will attach the disks to remaining nodes of
other bus types in the default priority: SATA, SCSI, IDE, PCI. You can modify the backup appliance
configuration, to instruct Nutanix AHV to ignore source VM original bus types and to use a specific order
of bus types.
• When restoring a VM to a new location, Veeam Backup for Nutanix AHV does not restore the VM affinity
policy configuration. Therefore, you must manually configure the affinity policy as described in Nutanix
documentation.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup or snapshot job, select the VM that you want to restore
and click E ntire VM on the ribbon, or right-click the VM and select Restore entire VM to Nutanix AHV.
TIP
To restore a VM from a snapshot taken in the Nutanix AHV Prism Element console, expand the Nutanix
AHV cluster, select the VM that you want to restore and click E ntire VM on the ribbon, or right-click the
VM and select Restore entire VM to Nutanix AHV.
2. Click P oint.
3. In the Restore Points window, select the necessary restore point and click OK.
To help you choose a restore point, Veeam Backup for Nutanix AHV provides the following information on
each available restore point:
o Job — the name of the backup job that created the restore point and the date when the restore point
was created.
You can use the wizard to restore multiple VMs at a time. To do that, click Ad d , select more VMs to restore and
select a restore point for each of them.
At the Cluster step of the wizard, choose the cluster to which the recovered VM will belong. In the Prism Central
deployment, you can also choose whether you want the recovered VM to be assigned the same categories as the
original VM.
For a cluster to be displayed in the list of the available clusters, it must be added to the backup infrastructure as
described in section Adding Nutanix AHV Server.
NOTE
The Cluster step of the Full VM Restore to Nutanix AHV wizard is only available when you restore the VM
from a backup.
At the Storage Container step of the wizard, choose the storage container where virtual disks of the recovered
VM will be stored.
For a container to be displayed in the list of the available containers, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
NOTE
You cannot choose a storage container when restoring the VM from a snapshot.
At the Na me step of the wizard, you can specify a new name for the recovered VM.
At the Network step of the wizard, choose a network to which the recovered VM will be connected. If you do not
want to connect the VM to any virtual network, select the VM and click Disconnect.
For a network to be displayed in the list of the available networks, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
NOTE
You cannot change network settings when restoring the VM from a snapshot. However, you can choose to
disconnect the original network.
TIP
If you want to start the recovered VM as soon as the restore process completes, select the P ower on target
VM a fter restoring check box.
• When restoring the VM from a backup, Veeam Backup for Nutanix AHV stores all virtual disks of the
recovered VM in one storage container.
• When restoring a VM from a snapshot, backup snapshot or PD snapshot, Veeam Backup for Nutanix AHV
stores virtual disks of the recovered VM in the original storage container.
• When restoring a VM from a snapshot or PD snapshot, Veeam Backup for Nutanix AHV retains the original
VM network settings. After the VM is restored, you can change these settings using the Nutanix Prism
console as described in Nutanix documentation.
• When restoring a VM to a new location, Veeam Backup for Nutanix AHV does not restore the VM affinity
policy configuration. Therefore, you must manually configure the affinity policy as described in Nutanix
documentation.
3. In the Select restore point window, select the necessary restore point and click Ap p ly.
To help you choose a restore point, Veeam Backup for Nutanix AHV provides the following information on
each available restore point:
o Job Name — the name of the backup job that created the restore point.
o Creating Time — the time and date when the restore point was created.
[Applies to the Prism Central deployment] Only backups are supported for restore to another
cluster.
▪ Snapshot — a snapshot created by a snapshot job or manually taken in the Nutanix AHV Prism
Element console.
TIP
While creating a backup, Veeam Backup for Nutanix AHV takes a VM snapshot that is called backup
snapshot. Veeam Backup for Nutanix AHV stores a recent backup snapshot for each backup job. Restore
from the backup snapshot is significantly faster than restore from a backup. However, when you restore
from the backup snapshot, limitations are applied. For more information on snapshots, see Snapshot
Types,
At the Cluster step of the wizard, choose the cluster to which the recovered VM will belong. You can also
choose whether you want the recovered VM to be assigned the same categories as the original VM.
NOTE
The Cluster step of the Full VM Restore wizard is only available when you restore the VM from a backup.
At the Na me step of the wizard, you can specify a new name for the recovered VM.
At the Storage Container step of the wizard, choose the storage container where virtual disks of the recovered
VM will be stored.
NOTE
You cannot choose a storage container when restoring the VM from a snapshot.
For a container to be displayed in the list of the available containers, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
At the Network Settings step of the wizard, choose a network to which the recovered VM will be connected. If
you do not want to connect the VM to any virtual network, click Disconnect.
NOTE
You cannot change network settings when restoring the VM from a PD snapshot or a snapshot created in
the Nutanix AHV Prism console.
For a network to be displayed in the list of the available networks, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
If you want to start the recovered VM as soon as the restore process completes, select the P ower on target VM
a fter restoring check box.
NOTE
NOTE
While creating a backup, Veeam Backup for Nutanix AHV takes a VM snapshot that is called backup
snapshot. Veeam Backup for Nutanix AHV stores a recent backup snapshot for each backup job. Restore
from a backup snapshot is significantly faster than restore from a backup.
3. In the Select restore point window, select the necessary restore point and click Ap p ly.
To help you choose a restore point, Veeam Backup for Nutanix AHV provides the f ollowing information on
each available restore point:
o Job Name — the name of the backup job that created the restore point.
o Creating Time — the time and date when the restore point was created.
[Applies to the Prism Central deployment] Only backups are supported for restore to another
cluster.
By default, Veeam Backup for Nutanix AHV restores all disks attached to the selected VMs. If you want to
exclude specific disks of a VM from restore, do the following. Select a VM, click E x clusions and select the
disks to exclude.
At the Cluster step of the wizard, choose the cluster where the disks will be restored.
NOTE
The Cluster step of the Virtual Disk Restore wizard is only available when you restore the disks from a VM
backup.
By default, Veeam Backup for Nutanix AHV attaches the restored disks to the original VM. To attac h the
disks to another VM, click Browse.
IMP ORTANT
During disk restore, Veeam Backup for Nutanix AHV turns off the target VM to reconfigure its settings and
attach the restored disk. It is recommended that you stop all activities on the target VM till the restore
session completes.
By default, Veeam Backup for Nutanix AHV attaches the restored disk to the target VM as a new disk.
However, if you want the restored disk to replace the existing disk, or if you want to change the disk bus
type and to specify a storage container for the restored disk, configure disk settings.
NOTE
You can select a storage container only if you restore from a backup.
TIP
If you want to start the recovered VM as soon as the restore process completes, select the P ower on VM
a fter restore check box.
Supported Workloads
To recover machines to a Nutanix AHV cluster, you can use the following backups:
• Backups of Nutanix AHV VMs created by Veeam Backup for Nutanix AHV
• Backups of Microsoft Hyper-V and VMware vSphere VMs created by Veeam Backup & Replication
• Backups of virtual and physical machines created by Veeam Agent for Microsoft Windows and Veeam
Agent for Linux
• Backups of Microsoft Azure VMs created by Veeam Backup for Microsoft Azure
• Backups of Google Cloud VMs instances created by Veeam Backup for Google Cloud
• Backups of oVirt KVM VMs created by Veeam Backup for Oracle Linux Virtualization Manager and Red Hat
Virtualization
• From file-level backups created by Kasten 10, Veeam Agent for Linux, Veeam Agent for Microsoft
Windows, Veeam Agent for Unix, Veeam Agent for Mac
NOTE
Instant Recovery to a Nutanix AHV cluster is supported only for backups stored in backup repositories,
object storage repositories, external repositories, Veeam Cloud Connect repositories, HPE Cloud Bank
Storage and a scale-out backup repository (performance, capacity or archive tier). Instant Recovery from
backups stored on tapes is not supported.
• Power off the original machine if it is still present in the target location.
• Deploy a dedicated server to mount workload images directly from backups stored in backup repositories
and allocate minimum 512 MB of additional RAM for each VM disk that you want to recover. Make sure
that the Server for NFS role and the Client for NFS component are not installed on the server, and that the
Veeam vPower NFS Service is running.
• [Applies only to VMs being restored from backups stored in the archive tier of scale -out backup
repositories] Retrieve backup data as described in the Veeam Backup & Replication User Guide, section
Retrieving Backup Files. However, this requirement is not applicable to backups stored in the archive tier
that consists of the Amazon S3 Glacier Instant Retrieval extent.
• [Applies only to Linux VMs] Make sure that the file systems (also referred to as devices or partitions) listed
in the /etc/fstab file are mounted using UUIDs. Instant Recovery of file systems mounted using device
names is not supported as the restored VMs may fail to boot.
• [Applies only to Windows VMs being restored from backups created by solutions other than Veeam
Backup for Nutanix AHV] Make sure to install Nutanix VirtIO drivers and Nutanix Guest Tools on the VMs —
before the backups are created. You will not be able to add or modify the VM drivers during the recovery
operation.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup, select the VM that you want to restore and click Instant
Recovery > Nutanix AHV on the ribbon, or right-click the VM and select Instant Recovery > Nutanix AHV.
2. Click P oint.
3. In the Restore Points window, select the necessary restore point and click OK.
To help you choose a restore point, Veeam Backup for Nutanix AHV provides the following information on
each available restore point:
o Job — the name of the backup job that created the restore point and the date when the restore point
was created.
You can use the wizard to restore multiple VMs at a time. To do that, click Ad d , select more VMs to restore and
select a restore point for each of them.
At the Restore Mode step of the wizard, choose whether you want to restore the selected VM to the original or
to a custom location.
To meet minimum requirements for VMs residing on a Nutanix AHV cluster, Veeam Backup for Nutanix AHV
allocates 64 MB of RAM to the recovered VM if it originally had less amount of memory.
IMP ORTANT
If you recover a VM with original settings, and the original VM still exists in the virtual infrastructure, the
original VM will be removed.
For a cluster to be displayed in the list of the available clusters, it must be added to the backup infrastructure as
described in section Adding Nutanix AHV Server.
IMP ORTANT
If a selected VM has an attached volume group, the disks of the volume group will not be restored.
For a container to be displayed in the list of the available containers, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
For a network to be displayed in the list of the available networks, it must be configured in the Nutanix AHV
cluster as described in Nutanix documentation.
TIP
If you want to start the recovered VM as soon as the restore process completes, select the P ower on target
VM a fter restoring check box.
1. In the Veeam Backup & Replication console, open the Home view.
o To transfer VM disk data to the production storage, select Mig rate to production.
IMP ORTANT
If you stop publishing a VM that was recovered to the same destination where the original VM resided,
both the original and recovered VMs will be removed.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, right-click the VM you want to restore, and select Instant recovery.
4. Complete the Instant Recovery wizard as described in the Veeam Backup & Replication User Guide for
VMware vSphere, section Performing Instant VM Recovery of Workloads to VMware vSphere VMs .
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, right-click the VM you want to restore, and select Instant recovery.
4. Complete the Instant Recovery wizard as described in the Veeam Backup & Replication User Guide for
Microsoft Hyper-V, section Performing Instant VM Recovery of Workloads to Hyper-V VMs.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup job, right-click the VM that contains disks you want to
mount and select P ub lish d isks.
4. Complete the P ub lish Disk wizard as described in the Veeam Backup & Replication User Guide, section
Publishing Disks.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup or snapshot job, right-click the VM that contains files
you want to restore and do the following:
o If you want to restore files of a Microsoft Windows machine, select Restore g uest files > Microsoft
W ind ows and complete the Guest File Restore wizard as described in the Veeam Backup & Replication
User Guide, section Restoring VM Guest OS Files (FAT, NTFS or ReFS).
o If you want to restore files of a Linux, Solaris, BSD, Novell Storage Services, Unix or Ma c machine,
select Restore guest files > Linux and others and complete the Guest File Restore wizard as described
in the Veeam Backup & Replication User Guide, section Restoring VM Guest OS Files (Multi-OS).
TIP
Alternatively, you can use Veeam Backup Enterprise Manager to restore guest OS files and folders as
described in the Veeam Backup Enterprise Manager Guide, section Restoring VM Guest OS Files.
• Oracle databases
NOTE
It is recommended that you use application-consistent backups or snapshots for application item restore.
You can check whether a backup or snapshot is application-consistent in sessions logs of the job that has
produced this backup or snapshot.
To restore application items from a Nutanix AHV VM backup or snapshot, do the following:
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup or snapshot job, select the VM that contains an
application you want to restore.
4. Click Ap p lication Items on the ribbon and the select the application.
5. In the restore wizard, select a restore point that will be used to restore the application, specify a restore
reason and click Browse.
6. In the Veeam Explorer application, perform the steps described in the Veeam Explorers User Guide.
As an alternative to application item restore, you can also perform file-level restore to recover standalone
databases using Veeam Explorers.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup job, right-click the VM that contains disks you want to
export and select E x port content as virtual disks.
4. Complete the E x p ort Disk wizard as described in the Veeam Backup & Replication User Guide, section
Exporting Disks.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup job, right-click the VM that you want to restore and
select Restore to Amazon E C2.
4. Complete the Restore to Amazon EC2 wizard as described in the Veeam Backup & Replication User Guide,
section Restoring to Amazon EC2.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup job, right-click the VM that you want to restore and
select Restore to Microsoft Azure.
4. Complete the Restore to Microsoft Azure wizard as described in the Veeam Backup & Replication User
Guide, section Restoring to Microsoft Azure.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the working area, expand the necessary backup job, right-click the VM that you want to restore and
select Restore to Google CE.
4. Complete the Restore to Google Compute Engine wizard as described in the Veeam Backup & Replication
User Guide, section Restoring to Google Compute Engine.
To view the full list of tasks executed during an operation, click the link in the Sta tus column.
• Sessions in Last 24 Hours — displays the number of sessions started for system operations as well as for
data protection or disaster recovery tasks during the past 24 hours that completed successfully, the
number of sessions that completed with warnings, the number of sessions that completed with errors, and
the number of sessions that are currently running.
To get more information on the sessions, click either View Session Logs or any of the widget rows. In the
latter case, the Session Logs page will show only those sessions that have the same status as that clicked
in the widget.
For more information on the Session Logs page, see Viewing Session Statistics.
• Successful Task Ratio — displays the number of job runs during a specific time period (the past 24 hours by
default).
To specify the time period, click the link next to the Schedule icon. To get more information on the
created snapshots, backups or archived backups, click any of the widg et rows. In the latter case, the
Session Logs page will show only those sessions during which Veeam Backup for Nutanix AHV created the
same items as that clicked in the widget.
For more information on the Session Logs page, see Viewing Session Statistics.
• P rotection Status — displays the number of VMs that are included into snapshot and backup jobs or not
included into any job. To get the list of VMs, click a widget row.
• Ba ckup Repositories — displays repositories to which the Nutanix AHV backup appliance has access. The
widget also shows the amount of storage space that is currently free in each repository. If less than 15% of
storage space is free, a repository is low on space. If less than 5% of storage space is free, a repository is
out of space.
• Top Jobs — shows top successfully completed jobs for execution time (including retries). For each job, the
widget also calculates the growth rate to detect whether it took less or more time for the job to complete
in comparison with the previous job run.
• CP U and RAM Utilization — is designed to help you avoid possible backup bottlenecks and allocate
sufficient resources to the backup appliance.
The CP U widget analyzes the amount of backup appliance CPU resources used for processing jobs during
the past 24 hours. The RAM widget shows memory consumption on the backup appliance during the past
24 hours.
NOTE
If the Nutanix AHV backup appliance is not connected to the internet, you can instruct the Veeam Updater
service to use a web proxy as described in section Configuring Web Proxy.
It is recommended that you timely install available updates to avoid issues while working with the product. For
example, timely installed security updates may help you prevent potential security issues and reduce the risk of
compromising sensitive data.
TIP
To check for major updates for Veeam Backup for Nutanix AHV, launch the Veeam Backup & Replication
console. If a new version of the product is available, the Veeam Backup & Replication console will display
the Comp onents Update window and prompt you to upgrade the Nutanix AHV backup appliance. For more
information, see the Veeam Backup & Replication User Guide, section Server Components Upgrade.
d. In the Host field, enter the IP address or FQDN of the web proxy.
e. In the P ort field, enter the port used on the web proxy for HTTP or HTTPS connections.
f. [Applies only if the web proxy requires authentication] In the Username and P a ssword fields, enter
credentials of the account configured on the web proxy to access the internet.
g. Click Ap p ly.
If new updates are available, Veeam Backup for Nutanix AHV will display them on the Up d ates tab of the Veea m
Ba ckup Updater page. To view detailed information on an update, select the check box next to the update and
click W ha t's new?
IMP ORTANT
You can update Veeam Backup for Nutanix AHV using the Veeam updater service only. Updating of the
backup applaince manually is not supported.
Installing Updates
IMP ORTANT
Before you install a product update, make sure all jobs are stopped and restore tasks are finished.
Otherwise, the update process will interrupt the running activities, which may result in data loss.
a. In the Up dates are available for this system section, select check boxes next to the necessary updates.
IMP ORTANT
Make sure that you select all available DotNet updates for installation. Since different versions of DotNet
components are not always compatible, the backup appliance may become non-operational if only some
components are updated.
b. In the Choose a ction section, select the Install updates now option, select the Reb oot automatically
a fter install if required check box to allow Veeam Backup for Nutanix AHV to reboot the backup proxy
if needed, and then click Install Updates Now.
The updater may require you to read and accept the Veeam license agreement and the 3rd party
components license agreement. If you reject the agreements, you will not be able to continue installation.
Veeam Backup for Nutanix AHV will download and install the updates; the results of the installation process will
be displayed on the History tab. It may take several minutes for the installation process to complete.
NOTE
When installing product updates, Veeam Backup for Nutanix AHV restarts all services running on the
backup proxy, including the Web UI service. That is why Veeam Backup for Nutanix AHV will log you out
when the update process completes.
1. On the Veeam Updater page, in the Up d ates are available for this system section, select check boxes next
to the necessary updates.
a. Select the Schedule updates installation option and configure the necessary schedule.
IMP ORTANT
When selecting a date and time for the update installation, make sure no jobs are scheduled to run on the
selected time. Otherwise, the update process will interrupt the running activities, which may result in data
loss.
b. Select the Reb oot automatically after install if required check box to allow Veeam Backup for Nutanix
AHV to reboot the backup proxy if needed.
Veeam Backup for Nutanix AHV will automatically download and install the updates on the selected date at the
selected time; the results of the installation process will be displayed on the History tab.
To do that, on the Veeam Updater page, in the Choose action section, do the following:
1. Select the Remind me later option and choose when you want to receive the reminder.
If you select the Nex t Week option, Veeam Backup for Nutanix AHV will send the reminder next Monday.
For each date when an update was installed, the Veeam Updater page will display the name of the update and
its status (whether the installation process completed successfully, completed with warnings or failed to
complete).
To download logs for the installed updates, select the necessary date in the Da te section, and click View Full
Log . Veeam Backup for Nutanix AHV will save the logs as a single file to the default download directory on the
local machine.
When you submit a support case, it is recommended that you provide the Veeam Customer Support Team with
the following information:
• Log files
To export logs for Veeam Backup for Nutanix AHV, you must collect logs from both the Veeam Backup &
Replication console and the Nutanix AHV backup appliance web console.
2. Navigate to Up d ates.
The Ab out section displays the currently installed version of Veeam Backup for Nutanix AHV.
4. In the Download Logs window, specify a time interval for which logs must be collected:
o Select the Collect logs for the last option if you want to collect data for a specific number of days in
the past.
o Select the Collect logs for specified time period option if you want to collect data for a specific period
of time in the past.
4. Click Download.
Veeam Backup for Nutanix AHV will collect logs for the specified time interval and save them to the default
download folder on the local machine in a single log.zip archive.
1. From the main menu of the Veeam Backup & Replication console, select Help > Support Information.
2. At the Scop e step of the E x port Logs wizard, select the E x p ort all logs for selected components option.
Then, in the Ma naged servers list, select the backup server and the VM running as the Nutanix AHV backup
appliance.
3. Complete the wizard as described in the Veeam Backup & Replication User Guide, section Exporting Logs.
• doSomeChecks(pdVms)
• freezeVms(self, pdVmsList)
• unFreezeVms(self, pdVms)
NOTE
The sample scripts do not not check whether the provided Nutanix AHV cluster certificate is valid.
• certificate.pem — a file that contains the Nutanix AHV backup appliance certificate in the PEM
format. Note that the PFX format is not supported.
• privatekey.pem — a file that contains a private key used to generate the certificate.
• password — a file that contains a password to decrypt the private key. This file is not required if the
private key is not encrypted.
"BackupApplianceCertificate": {
"UseCustomCert": true,
"CustomCertPemFilePath": "/<path_to_the_file>/certificate.pem",
"CustomPrivateKeyPemFilePath": "/<path_to_the_file>/privatekey.pem",
"CustomPasswordFilePath": "/<path_to_the_file>/password"
}
If the private key is not encrypted, leave the default "" value for the CustomPasswordFilePath
parameter.
IMP ORTANT
If the Nutanix AHV backup appliance cannot find the certificate in the specified folder or any of the
certificate files contain incorrect data, the backup service will fail to start, and you will not be able to
perform data protection and recovery operations. To troubleshoot the problem, check logs in the
/var/log/veeam_backup/appliance_service/appliance_service.log file.
8. Update the Nutanix AHV backup appliance configuration using the Edit Nutanix Proxy wizard.
You can modify the default priority to define the order in which Veeam Backup for Nutanix AHV will process
disks that cannot be attached using their original bus types. You can also instruct Veeam Backup for Nutanix
AHV to ignore the original bus types of VM disks. In the latter case, Veeam Backup for Nutanix AHV wil l attach
disks according to the specified bus type priority — this may be useful if some bus type is not configured in the
Nutanix AHV environment.
NOTE
Veeam Backup for Nutanix AHV takes into account the bus type restore priority only when performing the
following operations:
• Restore of an entire VM that originally resided on a platform other than Nutanix AHV.
• Instant Recovery of any VM (including Nutanix AHV VMs) to Nutanix AHV.
Consider the following example. You want to restore a VMware VM that originally had 30 SATA disks and 2 IDE
disks. Depending on the bus type restore priority, Veeam Backup for Nutanix AHV will attach disks to the
following nodes of the target VM:
3. In the editor, open the appsettings.json file located in the {plug-in location}\Service folder.
To instruct Veeam Backup for Nutanix AHV to ignore the original bus types of VM disks, set the following
parameter to true:
"IgnoreOriginalBus": "true",
To change the bus type priority, update the following parameter value:
Since both the backup appliance and workers deployed by Nutanix AHV are Linux -based VMs, they have the
same limitations that apply to machines running the Rocky Linux operating system. That is, network routing can
only be applied to the networks connected to the network adapters (vNICs) that has been added first while
configuring the backup appliance and workers, which mean that these VMs can reach out to endpoints in other
networks only through those first vNICs.
That is why you must consider the following while configuring multiple networks for the backup appliance and
workers:
• If you want the backup appliance and workers to obtain updates from online Veeam repositories, you must
connect to the first vNIC a network that allows inbound and outbound internet traffic.
• If a backup repository, the backup server, the Nutanix AHV cluster or the Prism Central is not reachable
from the network connected to the first vNIC, you must update the backup appliance and worker s ettings
to add one more vNIC and to connect it to the network to which that component is connected.
NOTE
The backup appliance and workers will be able to obtain updates from online Veeam repositories only if
Network A is configured to allow inbound and outbound internet traffic.
The backup appliance and workers will be able to obtain updates from online Veeam repositories only if
Network A is configured to allow inbound and outbound internet traffic.