Documente Academic
Documente Profesional
Documente Cultură
3
Users Guide
This product is protected by U.S. and international copyright and intellectual property laws. Dell, the Dell logo, NetVault,
PowerEdge, and vRanger are trademarks of Dell Inc. in the United States and/or other jurisdictions. Linux is a registered
trademark of Linus Torvalds in the United States, other countries, or both. UNIX is a registered trademark of The Open Group
in the United States and other countries. PowerCLI, vApp(s), vCenter, vCenter Server, vCloud Director, vSphere, vMotion,
VMware, ESX, and ESXi are registered trademarks or trademarks of VMware, Inc. in the United States and/or other jurisdictions.
Active Directory, Hyper-V, PowerShell, SharePoint, SQL Server, Windows, and Windows Server are registered trademarks of
Microsoft Corporation in the United States and/or other countries. Data Domain and DD Boost are trademarks or registered
trademarks of EMC Corporation in the United States and other countries. All other marks and names mentioned herein may be
trademarks of their respective companies.
Legend
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.
WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.
IMPORTANT NOTE, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
vRanger Users Guide
Updated - January 2016
Software Version - 7.3
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Dell vRanger: at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Key benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Major feature list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Target audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Recommended additional reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
vRanger overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Virtualization overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
vRanger overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Installation overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Before installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Downloading an evaluation copy of vRanger . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Installing vRanger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Adding inventory for protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Adding repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Deploying virtual appliances (VAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Adding physical servers to inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Scheduling a backup job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Scheduling a replication job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Configuring vRanger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Configuring vRanger through the Startup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Opening the Startup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Adding and selecting a license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Adding vCenter and host information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Adding Hyper-V System Center VMM, cluster, and host information . . . . . . . . . . . . .23
Selecting hosts for licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Adding a physical machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Selecting physical machines for licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Deploying and configuring the VA from the Startup Wizard . . . . . . . . . . . . . . . . . .26
Adding a repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Setting up the SMTP server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Adding an email address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Configuring vRanger manually . . . . . . . . . . . . . . . . . . . .
Adding a vCenter . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding a vCloud Director . . . . . . . . . . . . . . . . . . . . .
Adding an ESXi server . . . . . . . . . . . . . . . . . . . . . . .
Adding a Hyper-V System Center VMM, cluster, or host .
Adding a physical server . . . . . . . . . . . . . . . . . . . . .
Adding a repository . . . . . . . . . . . . . . . . . . . . . . . .
Managing repository replication . . . . . . . . . . . . . . . .
....
....
....
....
....
....
....
....
....
....
....
....
....
....
....
....
...
...
...
...
...
...
...
...
....
....
....
....
....
....
....
....
...
...
...
...
...
...
...
...
. .29
. .30
. .30
. .31
. .31
. .33
. .35
. .35
3
...
...
...
...
. . . . . . . . 132
. . . . . . . . 132
. . . . . . . . 138
. . . . . . . . 144
Get-BackupGroupEntity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Get-CatalogSearchData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Get-CatalogStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Get-ConfigOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Get-Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Get-CurrentTemplateVersionID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Get-Datastore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Get-GlobalTransportFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Get-InventoryEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Get-IsInventoryRefreshing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Get-Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Get-JobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Get-MonitorLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Get-Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Get-PhysicalMachineDiskMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Get-Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Get-RepositoryJob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Get-RepositorySavePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Get-RestoreDiskMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Get-SavepointDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Get-SavepointManifest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Get-Savepoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Get-TransportFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Get-VirtualApplianceConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Get-VirtualApplianceDeploymentStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Get-VirtualApplianceReconfigStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Get-VirtualMachinesUnderInventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Get-VmDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Get-VMDKVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Install-VirtualAppliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Mount-LinuxVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
New-BackupFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
New-BackupGroupMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
New-Daily Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
New-EmailAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
New-IntervalSchedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
New-MonthlySchedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
New-ReplicationFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
New-RestoreFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
New-SMTPServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
New-TransportConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
New-VirtualAppliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
New-WeeklySchedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
New-YearlySchedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Remove-AllMount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Dell vRanger 7.3 Users Guide
Contents
Remove-BackupGroupEntity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Remove-BackupGroupMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Remove-Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Remove-DdbStorageUnit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Remove-JobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Remove-LinuxVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Remove-Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Remove-SavePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Remove-VirtualAppliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Remove-VirtualApplianceConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Run-JobsNow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Run-ReplicationFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Run-ResumeReplicationFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Run-TestReplicationFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Set-Cataloging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Set-CBTonVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Set-LinuxVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Set-MountPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Set-Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Stop-vRangerJob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Update-BackupJobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Update-GlobalTransportFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Update-HypervRestoreJobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Update-Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Update-ReplicationJobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Update-RestoreJobTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Update-VirtualAppliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Update-VirtualApplianceConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
About Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
Contacting Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Technical support resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
1
Introduction
Key benefits
Target audience
Deliver high-speed, storage-thrifty backup and restore for VMware, Hyper-V, and physical Windows
servers.
Quickly locate and restore individual files from virtual and physical backups.
Deploy scalable data protection for even the largest virtual infrastructures.
Key benefits
vRanger benefits include:
Provides high-speed, resource-efficient backup, replication, and recovery of VMware and Hyper-V VM
images.
10
Delivers maximum storage savings when paired with the Dell DR Series appliance, EMC Data Domain,
or NetVault SmartDisk.
Supports EMC Data Domain Boost and Dell DR RDA for optimized deduplication and replication.
Optimizes use of critical resources in virtual environments, including hypervisor hosts, networks, and
storage.
VMware Ready Certified for vSphere 6: Ensures reliable, safe, and scalable operation with vSphere
6.
VMware ESXi support: Provides a wide range of backup and recovery and disaster recovery (DR)
capabilities for VMware virtual infrastructures.
Virtual appliance (VA) architecture: Through centralized and wizard-driven deployment and
administration from the vRanger server, delivers scalable and cost-effective distributed data handling
and throughput through VAs.
Disk-to-disk backup and deduplication: Supports Dell DR Series system Rapid Data Access (RDA) for
optimized client-side deduplication and replication.
EMC Data Domain (DD Boost) support: Supports distributed deduplication with EMC Data Domain
appliances using the DD Boost API.
Disk-to-disk backup and deduplication: Offers a Dell NetVault SmartDisk - vRanger Edition add on for
enterprise-class deduplication that reduces backup storage footprints by up to 90 percent.
VMware HotAdd support: Performs LAN-free backups with vRanger installed inside a VM and from the
vRanger VA. Additionally, HotAdd accelerates network backups of ESXi.
Patented Active Block Mapping (ABM): Eliminates inactive and white space blocks from protected
Windows VMs to speed backup, replication, and recovery jobs as well as reduce network and storage
requirements.
Change block tracking (CBT): Eliminates the time required to scan for changed blocks in guest images
on vSphere hypervisor systems to improve the speed of backup and replication jobs.
Instant file-level restore (FLR) for Windows and Linux: Lets you restore a single file from a backup
image in the repository through a one-step process.
11
Patented native, full catalog capability: Provides a native, full catalog of every image in the backup
repository, enabling immediate identification of available recovery positions, with one-click restore.
Wildcard scanning feature locates backup repository files to be restored.
Advanced Encryption Standard (AES)-256: Secures protected images block-by-block on the VMware
host as they are read so they are also secure over the network and in the backup repository.
Full, incremental, and differential backup: Enables a complete backup cycle for protected images that
is optimized for speed and resource efficiency.
Full, incremental, and hybrid replication: Provides the full range of options required to replicate
VMware VMs over LANs and WANs efficiently.
Replication: Offers on- and off-site options for flexible, reliable disaster recovery.
Physical Windows Server support: Supports backup and recovery of Windows physical servers, files,
and folders.
Synthetic recovery: Delivers single-pass restore, reading each required block only one time from
multiple full, incremental, and differential backup images in the repository for the fastest, most
efficient results.
VMware vSphere vMotion and Storage vMotion support: vSphere vMotion support ensures vRanger
automatically protects VMware VMs as they move from one host to another, even when backup jobs are
running. It also ensures vRanger follows VM storage disks when they are relocated to different data
stores; locks VM storage disks when vRanger accesses the disks during a job.
Agent-less job execution, patent-pending: Uses binary injection at run time on VMware ESXi hosts;
eliminates burdens of license tracking and maintenance upgrades.
Advanced savepoint management: Lets you manage and use multiple point-in-time copies of backup
and replica images for precise image, file, and object restores.
Dynamic resource management: Optimizes real-time use of critical resources; ensures efficiency and
that jobs complete faster without exceeding resource capacity.
Job multi-streaming: Lets you run multiple backup, restore, and replication jobs simultaneously for
dramatic improvement in performance times.
Direct-to-target (D2T) architecture: Distributes job execution and movement of data with optimal
efficiency to improve data protection and ensure seamless scalability.
Inline data validation: Tests integrity of captured data on the source block-by- block as it is read;
ensures image recovery from the backup repository and replica-image usability.
Remote management: Lets you manage data protection jobs through a central console over LAN and
WAN connections for control of all systems and sites in an environment.
PowerShell access: Automate scripts for protection jobs, reducing administrative burdens and human
error.
Target audience
This guide is intended for backup administrators and other technical personnel who are responsible for
designing and implementing a backup strategy for the organization. A good understanding of the operating
system (OS) on which vRanger is running is assumed.
12
Dell vRanger Installation/Upgrade Guide: This guide details the system requirements for installing and
operating vRanger, and describes how to install and upgrade the vRanger application and components.
Dell vRanger Integration Guide for EMC Data Domain Boost (DD Boost): This guide describes how to
configure vRanger to work with a Data Domain Boost repository to achieve source-side deduplication of
backup data.
Dell vRanger Integration Guide for Dell DR Series Disk Backup Appliance: This guide describes how to
configure vRanger to work with a Dell DR series appliance to achieve deduplication of backup data.
Dell vRanger Integration Guide for Dell NetVault SmartDisk - vRanger Edition: This guide describes how
to configure vRanger to work with a NetVault SmartDisk - vRanger Edition repository to achieve
deduplication of backup data.
Total Virtual Data Protection - Protecting virtualized applications with Dell vRanger and Dell Recovery
Manager: This guide describes how vRanger can work with Dell Recovery Manager products to protect key
services such as Active Directory, Exchange, and SharePoint.
13
2
vRanger overview
Virtualization overview
vRanger overview
Installation overview
Configuration overview
Virtualization overview
As companies grow, their technology needs change. These changes are often implemented within complex
systems running business-critical applications. Usually there is an increased demand for hardware and software
resources. To manage this demand, many companies establish virtual environments. Doing so can increase your
organizations agility and efficiency while lowering its costs.
Most companies have several specialized physical servers and workstations that are under used. Virtualizing
such an environment increases and balances usage by consolidating the physical machines into a single physical
host that runs multiple virtual machines (VMs).
vRanger overview
vRanger provides backup, recovery, and backup management for virtual and physical environments. Featuring a
new platform technology, vRanger reduces the backup window, provides smarter backup options, and offers
more scalability features while using fewer resources.
vRanger capabilities include:
Protect entire VMware and Hyper-V environments in minutes: Deploy vRangers simple installation
wizard and auto-discovery tool to locate both VMware and Hyper-V assets, and safeguard entire virtual
environments in minutes. Leverage vRangers agentless architecture to reduce time spent managing
virtual backup, restore and recovery operations, and to detect and back up new VMs automatically for
complete protection.
Deliver high-speed, storage-thrifty backup and restore for VMware, Hyper-V, and physical Windows
servers: Employ the fastest I/O path available to back up and restore VMware, Hyper-V, and physical
Windows servers quickly, with minimal disruption to production systems. vRangers patented Active Block
Mapping feature reduces data streams, network utilization and backup storage requirements. Leverage
client-side and target-side deduplication options with the support for the Dell DR disk-based backup
appliance and EMC Data Domain integration to dramatically shrink backup storage costs.
Quickly locate and restore individual files from virtual and physical backups: Locate and restore
specific versions of VMs, files, and folders in minutes. Use vRangers integrated catalog and wildcard
search features to find individual files quickly, whether they are located within VMware, Hyper-V, or
physical Windows Server backups. Manage virtual and physical servers from a single, easy-to-use user
interface (UI), minimizing the effort, complexity and cost of backing up your data.
Replicate key VMs for offsite disaster recovery preparedness: Replicate VMware virtual machines both
on-site and at remote locations for flexible and efficient disaster recovery preparedness. Combine
backup and replication jobs to ensure that you meet your organizations recovery time and recovery
Dell vRanger 7.3 Users Guide
vRanger overview
14
point objectives. Perform fast VM failover and recovery at all your sites, no matter where they are
located.
Deploy scalable data protection for even the largest virtual infrastructures: Leverage parallel job
execution capabilities to complete backup and recovery operations faster, and use resource governing to
ensure optimal production application performance. Deploy the vRanger virtual appliance (VA) to
distribute VMware workloads for better scalability. Use vRangers LAN-free mode to move backup and
restore operations off local-area networks (LANs) for improved virtualized application performance.
Use Advanced Encryption Standard (AES)-256: vRanger uses AES-256 encryption to encrypt backup
archives and replication traffic. In vRanger, AES is a symmetric key algorithm that uses a 256-bit
encryption key. This combination is approved for the encryption of secure government data, and
complies with the Federal Information Processing Standard (FIPS).
vRanger requires credentials for several connection types; namely local machine credentials, vCenter
and host credentials, and credentials for the vRanger database. These credentials are encrypted using
AES-256 encryption before they are written to the vRanger database or Windows registry.
Encryption for vRanger backups is configured at the repository level, meaning that rather than selecting
encryption for each job or task, you configure that job to write to an encrypted repository. For each
backup task, vRanger read the encryption status of the target repository. If encryption is selected, the
data blocks are read and encrypted before they are sent to the repository.
During replication tasks, vRanger sends data over a secure shell (SSH) tunnel encrypted with AES-256
encryption.
Installation overview
The installation of vRanger is a simple process requiring no additional components or configuration. vRanger can
be installed on either a physical or VM meeting the requirements specified in the Dell vRanger
Installation/Upgrade Guide.
Before installing
Installing vRanger
Before installing
vRanger can be installed in various configurations depending on your environment. Some common configuration
options include:
Database installation
Backup architecture:
VA-based HotAdd
Machine-based HotAdd
VA-based LAN
Machine-based LAN
Machine-based SAN
Before installing vRanger, review each of your architectural options, and decide on the best fit for your
environment.
For more information, see the Dell vRanger Installation/Upgrade Guide.
15
Installing vRanger
The installation of vRanger has several options. Unless you have a valid reason not to, Dell recommends that you
accept the defaults wherever possible. Complete the steps in the following procedure to install vRanger.
To install vRanger:
1
Enter the credentials under which the vRanger services should run.
The credentials used need to have local administrator privileges on the vRanger machine.
Configuration overview
vRanger requires some basic configuration before data protection can begin. The bulk of this configuration is
driven by the Startup Wizard which starts the first time the application is opened. For more information, see
Configuring vRanger.
The following sections describe the primary configurations you need to make.
Adding repositories
16
Individual Hyper-V or VMware ESXi hosts not associated with a cluster or vCenter.
To add a vCenter, you need to have credentials with administrator access to the vCenter, along with root-level
credentials for each host managed by the vCenter. To add a Hyper-V cluster, you must have domain
administrator privileges. You can exclude hosts from the vRanger inventory, which also excludes them from
licensing.
Adding repositories
Repositories are where vRanger stores the savepoints created by each backup job. You can create a repository
from a standard File Transfer Protocol (FTP), Network File System (NFS), Common Internet File System (CIFS), or
Secure File Transfer Protocol (SFTP) share. You may also deduplicate vRanger backups by sending them to a Dell
DR RDA, EMC Data Domain (DD Boost), or Dell NetVault SmartDisk repository. To add a repository, you need
the name of the server and share, and an account with access to that share. If you are using Dell RDA or DD
Boost repositories, you can also set up repository replication with another repository of the same type. For
more information on replication, see Managing repository replication.
Click the Add drop-down menu, and then click Backup Job.
Right-click the object you want to back up, and then click Backup <selected object>.
17
For more information about the Backup Wizard or available options, see Backup.
Select a VM to replicate.
Click the Add drop-down menu, and then click Replication Job.
Right-click the VM you want to replicate, and then click Replicate <VMname>.
18
3
Configuring vRanger
Configuration overview
Configuration overview
Before configure vRanger, confirm that you have access to all user names, passwords, and root passwords for
the VMware ESXi hosts that you intend to use.
vRanger requires some basic configurations to ensure that the software functions properly. You complete the
initial configuration through the Startup Wizard, which starts when you first install vRanger. If you would rather
configure settings through the menu commands and icons on the main vRanger screen, you can do so. In either
case, you can revise the settings at any time.
After completing the basic configuration process, you can use either the Startup Wizard or the Configuration
Options dialog box to manage your settings. Although the Configuration Options dialog box offers some
functionality that the Startup Wizard does not, you can use either method to manage host licensing or email
server data. Only the Configuration Options dialog box lets you manage resources on the task level. Given the
role that tasks play in making backup and restore jobs, this resource is vital.
19
Adding a repository
If you just installed the software, the Startup Wizard automatically starts.
If the software was already installed, on the Main toolbar, click Tools > Startup Wizard.
Review the information in the License information for <licenseFile> section to make sure that it
displays the expected allotments.
NOTE: When applying an extended license over an existing or trial license, the highest license
count is used.
Click Save.
Under Currently Installed Licenses, you see the type of license installed. If it is a trial license, it reads,
License Type: Extended Trial and lists the number of days remaining in your extended trial period. Trial
licenses applied display the word Trial next to the Licenses Allowed and Licenses Used counts.
Click Next.
In the Configuration Options dialog box, under the Licensing node, click Product.
20
NOTE: The Remove Trial Extension button is available only when trial extension is present. When
the trial extension is removed, the button is also removed.
4
Under Currently Installed Licenses, confirm that the primary license is applied.
For the Virtual Machine Backup, Physical Machines Backup, and Virtual Machine Replication nodes,
confirm your license allocation.
Adding a vCenter: Complete this task to add a vCenter and all associated hosts.
Entering host credentials: Complete this task to add credentials to hosts that appeared after adding a
vCenter.
Adding hosts: Complete this task to add individual hosts not associated with a vCenter.
Adding a vCenter
Complete the following steps to add a VMware vCenter to your vRanger configuration.
To add a vCenter:
1
In the DNS Name or IP field, enter the FQDN or IP address of the vCenter Server.
In the User Name field, enter the name of an account with privileges on the vCenter Server.
For the required permissions for a vRanger vCenter account, see the Dell vRanger Installation/Upgrade
Guide.
NOTE: The user name for the vCenter credential should be entered in the username@domain
format, rather than domain\username. Sometimes, the domain might not be required. Avoid
special characters in the user name.
If these credentials are changed in the future, you must restart the Dell vRanger Service to
recognize the changes.
In the User Password field, enter the password for the preceding account.
NOTE: Avoid special characters in the password.
In the Port Number field, enter the port to use for communication the default is 443.
Click Connect.
The dialog box closes, and the vCenter appears in the VirtualCenters section and on the VirtualCenter
and Host Information page. The hosts managed by that vCenter appear in the Hosts section.
The hosts displayed show the icon
The large gold key indicates that the host has been issued a vRanger license.
The green dot indicates that the host has been assigned a backup license.
Dell vRanger 7.3 Users Guide
Configuring vRanger
21
The blue dot indicates that the host has been assigned a replication license.
The authentication method for the host is indicated by the icon superimposed on the host icon:
If the host is authenticated with vCenter credentials only, the vCenter icon appears
superimposed over the host icon:
If the host is authenticated with host credentials, a gold key is superimposed over the host
icon:
CAUTION: vCenter credentials are sufficient for operations that use only the vStorage API.
Click Edit.
The Host Connections dialog box appears. If you have selected multiple hosts, the DNS Name or IP
section displays [multiple connections].
In the User Password field, enter the password for the preceding account.
In the Root Password field, enter the root password for the selected hosts.
If your hosts use different root passwords, configure them in like groups based on the root password.
In the Port Number field, enter the port to use for communication the default is 22.
Click Connect.
The icon next to the host changes to
, showing that the vCenter icon has been replaced with a key.
If there is an authentication problem, such as connections through the root account being disabled, the
status icon displays an alarm. If alarm appears, edit the host connection to use a non-root user account.
Make sure that the Add user if user does not exist option is selected.
NOTE: VMware ESXi requires the use of the root account. You cannot use a non-root account
with ESXi.
8
When all connections have been made and verified, click Next.
Adding hosts
If you have hosts that are not managed by a VMware vCenter, you can add them individually.
To add hosts:
1
In the DNS Name or IP field, enter the FQDN or IP address of the Host.
22
You may use the root account if connections through the root are enabled, or a non-root account. If the
account does not yet exist on the host, select Add user if user does not exist.
4
In the User Password field, enter the password for the preceding account.
In the Root Password field, enter the password for the root account.
In the Port Number field, enter the port to use for communication the default is 22.
Click Connect.
The host appears in the Hosts section.
Adding hosts
In the Hyper-V System Center Virtual Machine Managers section, click Add.
In the DNS Name or IP field, enter the FQDN or IP address of the Hyper-V System Center VMM.
In the User Name field, enter the name of an account with domain administrator privileges on the
System Center VMM.
In the User Password field, enter the password for the preceding account.
If this VMM is a new System Center VMM, or if you have removed the vRanger Hyper-V agent, select
Install agent on host.
In the Agent Port Number field, enter the port you want vRanger to use to communicate with the
vRanger agent installed on each Hyper-V host. This port must be open between vRanger and each
Hyper-V server the default is 8081.
In the SCVMM Port Number field, enter the port you want vRanger to use to communicate with
the System Center VMM server the default is 8100. Click Connect.
IMPORTANT: This port is configured during System Center VMM installation. If you chose a
port number different from the default, enter that value here.
Click Next.
23
The Hyper-V System Center VMM appears in the Hyper-V System Center Virtual Machine Managers
section. The hosts managed by that VMM appear in the Hosts section.
In the DNS Name or IP field, enter the FQDN or IP address of the Hyper-V cluster.
In the User Name field, enter the name of an account with domain administrator privileges on the
cluster.
In the User Password field, enter the password for the preceding account.
If this cluster is new, or if you have removed the vRanger Hyper-V agent, select Install agent on host.
In the Port Number field, enter the preferred port you want vRanger to use to communicate with the
Hyper-V cluster on the source server.
This port must be open between vRanger and each Hyper-V server the default is 8081.
Click Connect.
Click Next.
The Hyper-V cluster appears in the Hyper-V Clusters section. The hosts managed by that cluster appear
in the Hosts section.
Adding hosts
If you have hosts that are not part of a cluster, you can add them individually.
To add hosts:
1
In the DNS Name or IP field, enter the FQDN or IP address of the Host.
In the User Password field, enter the password for the preceding account.
If this host is new, or if you have removed the vRanger Hyper-V agent, select Install agent on host.
In the Port Number field, enter the preferred port you want vRanger to use to communicate with the
Hyper-V host on the source server.
This port must be open between vRanger and each Hyper-V server the default is 8081.
Click Connect.
The host appears in the Hosts section.
24
View the CPUs Allowed value to confirm the number of sockets that are licensed for protection.
The number of licenses currently allocated is shown in the CPUs Used column.
The Licensed Hosts section lists the managed hosts, the number of sockets for each host, and the
licensed features for that host.
The CPUs column indicates the license cost of each host.
In the Pro Backup or Replication column, select or clear hosts until you have used all the available
licenses, or until all your hosts are protected.
Click Save.
Click Next.
In the DNS Name or IP field, enter the FQDN or IP address of the server.
In the User Password field, enter the password for the preceding account.
If this server is new, or if you have removed the vRanger agent, select Install agent on machine.
In the Agent Location field, enter the preferred directory on the physical machine to which the
physical client should be installed. The default is C:\Program Files\Dell\vRangerPhysicalClient.
In the Port Number field, enter the preferred port for vRanger to use to communicate with the physical
client on the source server.
This port must be open between vRanger and each physical server the default is 51000.
Click Connect.
The server appears in the My Inventory pane. You may also create a backup group to combine multiple physical
servers into one backup job. For more information, see Adding a custom backup group.
25
In the Currently Installed Licenses section, view the Machines Allowed value to confirm the total
number of physical machines licenses available.
The number of licenses currently allocated is shown in the Machines Used column. The Licensed
Physical Machine section lists the physical machines in the vRanger inventory, and indicates whether
each machine is licensed for backup.
In the Physical Backup column, select or clear machines until you have used all the available licenses, or
until all your machines are protected.
Click OK.
On the Virtual Appliance Information page of the Startup Wizard, start the Virtual Appliance
Deployment Wizard from the Startup Wizard by clicking Deploy Virtual Appliance.
Complete the deployment wizard by following the steps in Deploying the VA by using the Virtual
Appliance Deployment Wizard.
To add a VA configuration, click Add, and then complete the following steps:
a
In the Add Virtual Appliance Configuration dialog box, select a VA from the inventory tree.
c
4
Select Override IP Address, and then enter a new IP address in the IP Address field.
Select Use as default virtual appliance for cluster, to use this VA for all machines that are
a part of the associated cluster.
Click OK.
To configure an existing VA, select a VA from the list, and then click Edit.
In the Modify Virtual Appliance Configuration dialog box, edit any of the following settings:
Replication
Scratch Disk
Password
26
Click Remove.
The Removing VA dialog box appears.
Under Linux FLR Virtual Appliance, if you want to plan for Linux FLR, select the VA you want to use from
the drop-down list.
Click Next.
Adding a repository
vRanger uses repositories to store backup archives. Repositories can be one of the following types:
SFTP
FTP
NFS (version 3)
NetVault SmartDisk (NVSD): The Dell disk-based data-deduplication option which reduces storage costs
with byte-level, variable-block-based software deduplication. For more information on NetVault
SmartDisk, see http://software.dell.com/products/netvault-smartdisk/ or the Dell vRanger Integration
Guide for Dell NetVault SmartDisk.
EMC Data Domain Boost (DDB): Integrating EMC Data Domain Boost (DD Boost) with vRanger is
achieved by adding a Data Domain appliance running DD Boost to vRanger as a repository. Backups
written to that repository are deduplicated according to your configuration. For more information on DD
Boost, see http://www.emc.com/data-protection/data-domain/data-domain-boost.htm or the Dell
vRanger Integration Guide for EMC Data Domain Boost (DD Boost).
Dell Rapid Data Access (RDA): Provided by the Dell DR Series appliances purpose-built, disk backup
appliances that use Dell deduplication technology to improve backup and recovery processes. For more
information on Dell DR Series appliances, see http://software.dell.com/products/dr-series-disk-backupappliances/ or the Dell vRanger Integration Guide for Dell DR Series Disk Backup Appliance.
NOTE: Dell RDA and EMC DD Boost repositories support repository replication. For more information, see
Managing repository replication.
The following procedure shows mounting a CIFS share to the My Repositories pane. The procedures for the other
repository types are described in Supplemental instructions: additional repository types
To add a repository:
1
Select a Security Protocol from the drop-down list: NTLM (Default), or NTLM v2
In the Server field, type the UNC path to the preferred repository directory.
Dell vRanger 7.3 Users Guide
Configuring vRanger
27
Alternatively, enter a partial path, and click Browse to find the target directory.
NOTE: You must enter a valid username and password before using the browse functionality.
CAUTION: If you use the Encrypt all backups to this repository feature, make certain to retain the
password you enter. There is no back-door or administrator-level password. If the password is
unknown, the backups are not usable.
7
If you want these backups password-protected, select Encrypt all backups to this repository, enter a
Password for the encrypted repository, and then confirm the password by re-entering it.
NOTE: Encryption is not supported for NetVault SmartDisk and DD Boost repositories.
Enter a Password for the encrypted repository, and confirm the password by re-entering it.
Click Save.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
11 Click Next.
In the SMTP Server field, enter the DNS name or IP of an SMTP server.
In the Port field, enter the port to use for communication the default is 25.
If your SMTP requires use of authentication or encryption, or both, click Advanced, and complete the
following in the SMTP Server Advanced dialog box:
To use authentication, select the SMTP server requires authentication check box, and enter the
applicable user name and password. If applicable, include the domain followed by a backward
slash before the name.
Click OK.
In the From Address field, enter the email address that vRanger should use.
NOTE: Make sure that you use a valid email account registered to the SMTP server that you added.
28
Click Finish.
Adding a vCenter
Adding a repository
29
Adding a vCenter
Complete the steps in the following procedure to add a VMware vCenter for vRanger backup.
To add a VirtualCenter:
1
In the DNS Name or IP field, enter the FQDN or IP address of the VMware vCenter Server.
In the User Name field, enter the name of an account with privileges on the vCenter Server.
For the required permissions for a vRanger vCenter account, see the topic on configuring vCenter
permissions in the Dell vRanger Installation/Upgrade Guide.
NOTE: The user name for the vCenter credential should be entered in the username@domain
format, rather than domain\username. Sometimes, the domain name might not be required. Avoid
special characters in the user name.
If these credentials are changed in the future, you must restart the Dell vRanger Service to
recognize the changes.
In the User Password field, enter the password for the preceding account.
NOTE: Avoid special characters in the password.
Click Connect.
vRanger attempts to connect to the vCenter using the current configuration. If it is successful, the
vCenter appears in the My Inventory pane.
In the DNS Name or IP field, enter the FQDN or IP address of the vCloud Director server.
In the User Name field, enter the name of an account with administrator privileges on the vCloud
Director server.
In the User Password field, enter the password for the preceding account.
NOTE: Avoid special characters in the password.
Click Connect.
vRanger attempts to connect to the vCloud Director server using the current configuration. If it is
successful, the vCloud Director appears in the My Inventory pane.
You are prompted to add credentials for each VMware vCenter Server attached to the vCloud Director.
30
In the Add vCloud Director Credentials dialog box, identify any vCenter Servers for which credentials
are not configured.
The authentication status is indicated by a connection icon in the left-most column. A red disconnected
icon indicates that a vCenter needs authentication.
Add the user name and password for the vCenter Servers as required, and click Connect to authenticate.
Click Done.
In the DNS Name or IP field, enter the FQDN or IP address of the Host.
In the User Password field, enter the password for the preceding account.
In the Root Password field, enter the password for the root account.
Click Connect.
If the ESXi server is already part of a vCenter added to vRanger, the host is added to the tree structure
under the vCenter.
NOTE: If the connection is unsuccessful, confirm that the configuration settings are correct and
that the ESXi server is visible to the computer where vRanger is installed.
In the DNS Name or IP field, enter the FQDN or IP address of the Host.
In the User Password field, enter the password for the preceding account.
If this host is new, or if you have removed the vRanger Hyper-V agent, select Install agent on host.
In the Port Number field, enter the preferred port you want vRanger to use to communicate with the
Hyper-V host on the source server. This port must be open between vRanger and each Hyper-V server
the default is 8081.
Dell vRanger 7.3 Users Guide
Configuring vRanger
31
Click the Add icon, and then click Hyper-V System Center VMM.
In the DNS Name or IP field, enter the FQDN or IP address of the Hyper-V System Center VMM.
In the User Name field, enter the name of an account with domain administrator privileges on the
System Center VMM.
In the User Password field, enter the password for the preceding account.
If this VMM is new System Center VMM, or if you have removed the vRanger Hyper-V agent, select Install
agent on host.
In the Agent Port Number field, enter the port you want vRanger to use to communicate with the
vRanger agent installed on each Hyper-V host. This port must be open between vRanger and each
Hyper-V server the default is 8081.
In the SCVMM Port Number field, enter the port you want vRanger to use to communicate with
the System Center VMM server the default is 8100. Click Connect.
IMPORTANT: This port is configured during System Center VMM installation. If you chose a
port number different from the default, enter that value here.
Click Next.
The VMM appears in the Hyper-V System Center Virtual Machine Managers section. The hosts managed
by that VMM appear in the Hosts section.
Click the Add icon, and then click Hyper-V Failover Cluster.
In the DNS Name or IP field, enter the FQDN or IP address of the Hyper-V cluster.
In the User Name field, enter the name of an account with domain administrator privileges on the
cluster.
In the User Password field, enter the password for the preceding account.
If this cluster is new, or if you have removed the vRanger Hyper-V agent, select Install agent on host.
In the Port Number field, enter the preferred port you want vRanger to use to communicate with the
Hyper-V cluster on the source server.
This port must be open between vRanger and each Hyper-V server the default is 8081.
32
Adding hosts
If you have hosts that are not part of a cluster, you can add them individually.
To add hosts:
1
In the DNS Name or IP field, enter the FQDN or IP address of the Host.
In the User Password field, enter the password for the preceding account.
If this host is new, or if you have removed the vRanger Hyper-V agent, select Install agent on host.
In the Port Number field, enter the preferred port you want vRanger to use to communicate with the
Hyper-V host on the source server.
This port must be open between vRanger and each Hyper-V server the default is 8081.
Click Connect.
The host appears in the Hosts section.
In the DNS Name or IP field, enter the FQDN or IP address of the server.
In the User Password field, enter the password for the preceding account.
If this server is new, or if you have removed the vRanger agent, select Install agent on machine.
In the Agent Location field, enter the preferred directory on the physical machine to which the
physical client should be installed. The default is C:\Program Files\Dell\vRangerPhysicalClient.
In the Port Number field, enter the preferred port for vRanger to use to communicate with the physical
client on the source server.
This port must be open between vRanger and each physical server the default is 51000.
Click Connect.
The server appears in the My Inventory pane. You may also create a backup group to combine multiple
physical servers into one backup job. For more information, see Adding a custom backup group.
33
On the vRanger server, find the physical client installation file vRangerPhysicalClient.exe.
The file is located in the Service subdirectory of the vRanger installation folder. The default is
C:\Program Files\Dell\vRanger\Service.
From the source servers command line, run the vRangerPhysicalClient.exe command modified by the
following parameters:
USERNAME: Enter the name for an account with administrative Log on as a service rights on the
source server.
DOMAIN: [Optional] If no value is entered, the preceding account is considered a local account. If
you use a network account, enter the domain for the account here.
Command examples
The following examples show the proper syntax for using the installer.
To accept the defaults, you must only provide credentials for the source server:
vRangerPhysicalClient.exe /USERNAME="administrator" /PASSWORD="Password"
To change the install location or port number, add that parameter with the preferred value:
vRangerPhysicalClient.exe /USERNAME="administrator" /PASSWORD="Password"
/INSTALL_DIR="c:\vRangerPhysicalClient"
vRangerPhysicalClient.exe /USERNAME="administrator" /PASSWORD="Password"
/PORT=52000
34
Adding a repository
The following instructions describe how to add a CIFS repository to vRanger. For information about adding other
types of repositories, see Supplemental instructions: additional repository types.
To add a repository:
1
In the My Repositories pane, right-click anywhere, and click Add > Windows Share (CIFS).
NOTE: These instructions describe the process for adding a CIFS repository. The procedures for the
other repository types are described in Supplemental instructions: additional repository types.
In the Add Windows Network Share Repository dialog box, complete the following fields:
User Name and Password: Enter the credentials for accessing the CIFS share.
Server: Enter the path to the preferred directory. Alternatively, you may enter the server IP or
DNS name and click Browse, and browse to the correct path.
CAUTION: Paths for CIFS repositories are case-sensitive. When entering the path for a CIFS directory,
ensure that the path is entered in the correct case.
3
If you want these backups password-protected, select Encrypt all backups to this repository, enter a
Password for the encrypted repository, and then confirm the password by re-entering it.
CAUTION: If you use the Encrypt all backups to this repository feature, make certain to retain the
password you enter. There is no back-door or administrator-level password. If the password is
unknown, the backups are not usable.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
35
Select Enable savepoint replication for a successful backup job task, and click Ok.
In the Repository Replication Configuration pane, find the Repository Name column, and select the
applicable repository.
The repositories listed are the target repositories.
Configure the replication schedule as desired, using the following information as a guide.
a
Start: In the drop-down list, select the time for the replication task to begin.
Recurrence Pattern: Establish how often the changes should be synchronized. There are five
options within this section:
Daily: The daily option can be scheduled to synchronize the repository every weekday or
every x number of days.
36
Interval: The interval option lets you select the number of days, hours, and minutes that
should pass between backup jobs. The interval selected must be greater than or equal to
five minutes.
In the My Repositories pane, right-click the source or replication repository, and select Synchronize.
On the Main toolbar, click Tools > Options. Under the Repositories node, select Replication.
Clear the check box for Enable savepoint replication for a successful backup job task or Schedule
repository synchronization, or both.
Click OK.
Replication is disabled as indicated by a red circle icon containing a white exclamation point.
In the My Repositories pane, right-click the replication repository, and click Remove.
IMPORTANT: Ensure that Delete all savepoints in this repository is not selected.
Click OK.
Select the appropriate repository type either EMC Data Domain Boost or Dell Rapid Data Access
(RDA).
37
Complete the Add Repository dialog box as appropriate for your repository type, and click OK.
Use the information in Adding an EMC Data Domain Boost (DD Boost) repository or Adding a Dell Rapid
Data Access (RDA) repository as required.
When vRanger detects that the repository being added contains savepoint data and displays the
Warning: Existing Repository Found dialog box, click Import to reconfigure the repository as a primary
repository.
Under the General node on the Configuration Options page, click Email Configuration.
If your SMTP requires use of authentication or encryption, or both, click Advanced, and complete the
following in the SMTP Server Advanced dialog box:
a
To use authentication, select the SMTP server requires authentication check box, and enter the
applicable user name and password. If applicable, include the domain followed by a backward
slash before the name.
Click OK.
In the From Address field, enter an email address from which notifications should be sent.
Click OK.
Under the General node in the Configuration Options page, click Email Configuration.
Enter the contact name and email address, and click OK.
38
In the Email Addresses section, select the email address that you want to update, and click Edit.
Click OK.
Under the General node on the Configuration Options page, click Email Configuration.
In the Email Addresses section, select the email address that you want to delete.
Click Remove.
The listing is deleted.
Click OK.
Under the General node in the Configuration Options dialog box, click Language.
From the Available Languages drop-down list, select the language to be used.
If preferred, select based on system locale to make an automatic setting based on the vRanger
machines locale setting.
Click OK.
39
To configure a VA:
1
Click Add.
The Add virtual appliance configuration dialog box appears, showing the vCenter inventory tree.
Enter the root password for the VA, and click OK.
The VA appears in the Deployed Virtual Appliances section.
Under the Licensing node in the Configuration Options dialog box, click Product.
Browse to the location where you stored the license file, select it, and click Open.
The new license information is added to the dialog box.
Click Apply.
The dialog box refreshes with the new license information added.
Click OK.
Under the Licensing node in the Configuration Options dialog box, click Product.
Browse to the location where you stored the license file, select it, and click Open.
The new license information is added to the dialog box.
Click Apply.
40
The dialog box refreshes with the new license information added. Under the Currently Installed
Licenses heading, you see License Type: Extended Trial, and the number of days remaining in your
extended trial period.
In the Configuration Options > Licensing node, click Remove Trial Extension.
Under Currently Installed Licenses, confirm that the primary license is being applied.
In the Virtual Machine Hosts and Physical Machines node, confirm your license allocation.
In the Currently Installed Licenses section, view the CPUs Allowed value to confirm the number of
sockets that are licensed for protection.
The number of licenses currently allocated is shown in the CPUs Used column.
The Licensed Virtual Machine Hosts section lists the managed hosts, the number of CPUs for each host,
and the licensed features for that host. The CPUs column indicates the license cost of each host.
In the Pro Backup or Replication column, or both, select or clear hosts until you have used all the
available licenses, or until all your hosts are protected.
Click OK.
In the Currently Installed Licenses section, view the Machines Allowed value to confirm the total
number of physical machines licenses available.
Dell vRanger 7.3 Users Guide
Configuring vRanger
41
The number of licenses currently allocated is shown in the Machines Used column.
The Licensed Physical Machine section lists the physical machines in the vRanger inventory, and indicates
whether each machine is licensed for backup.
4
In the Physical Backup column, select or clear machines until you have used all the available licenses, or
until all your machines are protected.
Click OK.
The maximum number of backup, restore, and replication tasks running on this
instance of vRanger at any one time.
off a LUN
The maximum number of tasks allowed on any particular logical storage device.
on a host
per repository
The maximum number of tasks allowed on any specific repository at any specific
time.
locally
The number of backup and restore tasks that are physically running on the local
vRanger machine.
per VA
In the Resource Management section, set a maximum for the number of tasks that can be run:
In the Timeout section, populate the Task Timeout (1 - 999 hours) field the default is 24.
In the Minimum space needed on host (GB) field, enter a number the default is 6.
Click OK.
42
Click OK.
NOTE: Cataloging must also be enabled for each backup job for which you want to collect catalog
data.
Path: By default, vRanger does not catalog any files in the following directories. Path filtering is
determined by entries in the PathFilterTokens.txt file, at C:\Program
Files\Dell\vRanger\Configuration.
Program Files
$Txf
Windows
RECYCLER
$Extend
$TxfLog
I386
File: By default, vRanger does not catalog files of the following type. File filtering is determined by
entries in the FilesFilterTokens.txt file, at C:\Program
Files\Dell\vRanger\CatalogManager\Config\Files.
.lnk
$Boot
$Reparse
$MFT
$BadClus
$RmMetadata
$Volume
$Secure
$Repair
$AttrDef
$UpCase
$Tops
$BitMap
$Quota
$TxfLog
$ObjID
NOTE: File filtering applies to un-filtered paths. If a path is filtered, files in that path do not need
to be.
For most situations, the default filtering options are sufficient. If you want to filter out additional paths or files,
simply add the path or file to the appropriate text file.
43
To change the order of the transport options, click an option to select it, and use the up or down arrows
to move the item higher or lower in the order.
Locate the Vizioncore.vRanger.Service.exe.config file, and use a text editor to open it.
There are two keys that limit the number of retries:
<add key="BackupRestoreMaxTries" value="3"/>
<add key="BackupMaxTriesOnVMotion" value="3"/>
If the value is different or blank, for example, value-" ", update the entry, save the file, and
restart the Dell vRanger Service. For more information on restarting the service, see Restarting
the Dell vRanger Service.
44
vRanger supports the NFS3 protocol, which does not provide for authentication. vRanger uses the
NFSNobody account to connect to the repository.
The NFSNobody account must have R,W, X permissions for the target directory.
Your /etc/exports file must contain the export directory and a list of the IPs that can connect to the
repository. You may list each the vRanger machine and any VMware ESXi hosts using direct-totarget or use a wildcard *. The export directory should be shared with read/write asynchronous access.
For an export directory of /backups, this entry would look like:
[root@NFSServer etc]# cat exports
/backups *{rw, async}
In the My Repositories pane, right-click anywhere, and click Add > NFS.
In the Add Network File Share Repository dialog box, complete the following fields:
Export Directory: Specify the Export directory, which is similar in concept to a network share.
You need to create a target subdirectory in the export directory.
Target Directory: Enter a subdirectory of the NFS Export directory. This subdirectory is the
location to which savepoints are written.
CAUTION: If you use the Encrypt all backups to this repository feature, make certain to retain the
password you enter. There is no back-door or administrator-level password. If the password is
unknown, the backups are not usable.
3
If you want these backups password-protected, select Encrypt all backups to this repository, enter a
Password for the encrypted repository, and then confirm the password by re-entering it.
Click OK.
Dell vRanger 7.3 Users Guide
Configuring vRanger
45
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
5
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
In the My Repositories pane, right-click anywhere, and click Add > FTP.
In the Add FTP Repository dialog box, complete the following fields:
Target Directory: Enter the directory on the FTP server to which the repository is written.
User name and Password: Enter the name and password for the account that vRanger uses to
connect to the repository.
Port: Enter the port that vRanger uses to connect to the FTP server the default is 21.
Timeout: This value determines how long to wait before terminating an idle connection the
default is 600 seconds.
CAUTION: If you use the Encrypt all backups to this repository feature, make certain to retain the
password you enter. There is no back-door or administrator-level password. If the password is
unknown, the backups are not usable.
3
If you want these backups password-protected, select Encrypt all backups to this repository, enter a
Password for the encrypted repository, and then confirm the password by re-entering it.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Dell vRanger 7.3 Users Guide
Configuring vRanger
46
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
In the My Repositories pane, right-click anywhere, and click Add > SFTP.
In the Add SFTP Repository dialog box, complete the following fields:
Target Directory: Enter the directory on the SFTP server to which the repository is written.
User name and Password: Enter the name and password for the account that vRanger uses to
connect to the repository.
Port: Enter the port that vRanger uses to connect to the SFTP server the default is 22.
Timeout: This value determines how long to wait before terminating an idle connection.
CAUTION: If you use the Encrypt all backups to this repository feature, make certain to retain the
password you enter. There is no back-door or administrator-level password. If the password is
unknown, the backups are not usable.
3
If you want these backups password-protected, select Encrypt all backups to this repository, enter a
Password for the encrypted repository, and then confirm the password by re-entering it.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
In the My Repositories pane, right-click anywhere, and click Add > NetVault SmartDisk (NVSD).
47
In the Add NVSD Repository dialog box, complete the following fields:
DNS Name or IP: Enter the IP or FQDN for the NetVault SmartDisk server.
User name and Password: Enter the credentials for the account that vRanger should use to
connect to the repository.
NOTE: If you have enabled WebDav authentication on your NetVault SmartDisk server, use
those credentials here. If you have not enabled WebDav authentication, no credentials are
required. For more information, see the Dell NetVault SmartDisk Administrators Guide.
Target Directory: This value is a logical identifier for the repository on the NetVault SmartDisk
Instance, rather than a specific directory on the NetVault SmartDisk server. If you have previously
created one or more repositories on the target NetVault SmartDisk Instance, the existing target
directories are available in a drop-down menu.
To create a repository, enter a name for your repository.
Port: Enter the port that vRanger should use to connect to the NetVault SmartDisk server the
default is 37453.
Timeout: Enter a value that determines how long to wait before terminating an idle connection.
NOTE: Encryption is not supported for NetVault SmartDisk repositories.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
In the My Repositories pane, right-click the NetVault SmartDisk repository, and select Remove.
The Remove Repository dialog box appears, showing the savepoints in the selected repository.
When removing a repository, you have the option of keeping the savepoints on disk or deleting them.
If you chose to delete the savepoints, click OK when the Delete Savepoints dialog box appears.
Dell vRanger 7.3 Users Guide
Configuring vRanger
48
You have a properly configured Data Domain appliance that is accessible to the vRanger machine.
In the My Repositories pane, right-click anywhere, and click Add > EMC Data Domain Boost (DDB).
In the Add EMC Data Domain Boost Repository dialog box, complete the following fields:
DNS Name or IP: Enter the IP or FQDN for the Data Domain device.
User name and Password: Enter the credentials for the account selected as the DD Boost User on
the Data Domain device.
NOTE: For information on creating a DD Boost user name, see your Data Domain
documentation.
Storage Unit: This field specifies the Storage Unit configured on the Data Domain device. Select
one from the drop-down menu, or enter the name for a new Storage Unit and vRanger creates one
for you.
IMPORTANT: The supported characters are alphanumeric characters and ~!@#$^_+`-={}[],.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
49
At least one other Data Domain device with DD Boost enabled is available in your environment to serve as
the replication target. You do not have to add this device to vRanger.
To configure replication:
1
In the My Repositories pane, right-click the Data Domain Boost repository, and select Configure
Replication.
DNS Name or IP: Enter the IP or FQDN for the Data Domain device.
DD Boost User name and Password: Enter the credentials for the account selected as the DD
Boost User on the Data Domain device.
Storage Unit: This field specifies the Storage Unit configured on the Data Domain device. Select
one from the drop-down menu, or enter the name for a new Storage Unit and vRanger creates one
for you.
Click OK.
The connection to the device is tested and the device is added as a repository is added to the My
Repositories pane and the Repository Information dialog box.
After replication is configured for a repository, the Configure Replication option is disabled for that repository.
IMPORTANT: After a repository is configured for replication, you must select a synchronization method
before replication occurs. For information on manual and automatic synchronization options, see
Managing repository replication.
In the My Repositories pane, right-click the EMC Data Domain Boost repository, and select Edit
Replication Configuration.
In the Edit EMC Data Domain Boost Repository dialog box, edit any of the following fields:
Repository Name
User Name
Password
Alternatively, view the Free Space field for up-to-date information about this repository.
50
In the My Repositories pane, right-click the applicable EMC Data Domain Boost repository, and select
Remove.
The Remove Repository dialog box appears, showing the savepoints in the selected repository.
When removing a repository, you have the option of keeping the savepoints on disk or deleting them. To
remove the storage unit associated with the repository, you need to remove the savepoints. If replication
is configured for this repository, you are also given the option to delete the savepoints in the replicated
repository.
To delete the savepoints in a replicated repository, select Delete all savepoints in replication
repository.
Click OK.
When the Delete Savepoints dialog box appears, select Delete DD Boost storage unit, and click OK.
The savepoints are deleted, along with the storage unit associated with the repository.
DR4000 System: This version consists of preinstalled Dell DR System software on a Dell PowerEdge
R510 appliance platform.
DR4100 System: This version consists of preinstalled Dell DR System software on a Dell PowerEdge
R720xd appliance platform.
DR6000 System: This version consists of preinstalled DR6000 system software on a Dell PowerEdge
R720xd appliance platform. This version differs from the DR4100 by including a higher level of base
system hardware.
The Dell DR Series supports Common Internet File System (CIFS), Network File System (NFS), and RDA protocols.
The RDA protocol provides a logical disk interface for the Dell DR Series system, and enables better coordination
and integration between vRanger and the Dell DR Series system and provides for client-side deduplication of
vRanger backups.
NOTE: Dell recommends that you use the RDA protocol when using a Dell DR Series system as a repository.
For more information about the Dell DR Series systems, see the Dell DR Series System Administrator Guide.
51
You have a properly configured the Dell DR Series appliance that is accessible to the vRanger machine.
You created at least one storage container to be used as a Logical Storage Unit. When creating the
storage container, use the options:
9904
9911
9915
9916
9920
NOTE: For information on setting up the preceding configurations, see your Dell DR Series documentation.
In the My Repositories pane, right-click anywhere, and click Add > Dell Rapid Data Access (RDA).
In the Add Dell Rapid Access Repository dialog box, complete the following fields:
DNS Name or IP: Enter the DNS name or IP address of the Dell DR Series system.
RDA Username: Enter a user account that can be used to log in to the device. On the Dell DR
Series system, only one user account exists, and the user ID for that account is backup_user. You
can only change the password for this account; you cannot create an account or delete the
existing account.
RDA Password: Enter the password for the user account. The default is: St0r@ge!
Logical Storage Unit: Enter the name of the storage container. Ensure that the container is
created before you add the device. You cannot add the device if the specified container does not
exist on the device. When creating the storage container, use the options:
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
52
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
At least one other Dell DR Series appliance with RDA is available in your environment to serve as the
replication target. You do not have to add this device to vRanger.
To configure Replication:
1
In the My Repositories pane, right-click the Dell Rapid Data Access (RDA) repository, and select
Configure Replication.
DNS Name or IP: The DNS name or IP address of the Dell DR Series system.
RDA Username: Enter a user account that can be used to log in to the device. On the Dell DR
Series system, only one user account exists, and the user ID for that account is backup_user. You
can only change the password for this account; you cannot create an account or delete the
existing account.
Logical Storage Unit: Enter the name of the storage container. Ensure that the container is
created before you add the device. You cannot add the device if the specified container does not
exist on the device. When creating the storage container, use the options:
Click OK.
The connection to the device is tested and the device is added as a repository is added to the My
Repositories pane and the Repository Information dialog box.
After replication is configured for a repository, the Configure Replication option is disabled for that repository.
IMPORTANT: After a repository is configured for replication, you must select a synchronization method
before replication occurs. For information on manual and automatic synchronization options, see
Managing repository replication.
53
In the My Repositories pane, right-click the Dell Rapid Data Access (RDA) repository, and select Edit
Replication Configuration.
In the Edit Dell Rapid Data Access (RDA) dialog box, edit any of the following fields:
Repository Name
User Name
Password
Alternatively, view the Free Space field for up-to-date information about this repository.
In the My Repositories pane, right-click the Dell Rapid Data Access (RDA) repository, and select Remove.
The Remove Repository dialog box appears, showing the savepoints in the selected repository.
When removing a repository, you have the option of keeping the savepoints on disk or deleting them. To
remove the storage unit associated with the repository, you need to remove the savepoints. If replication
is configured for this repository, you are also given the option to delete the savepoints in the replicated
repository.
To delete the savepoints in a replicated repository, select Delete all savepoints in replication
repository.
Click OK.
When the Delete Savepoints dialog box appears, click OK to delete the savepoints.
In the My Repositories pane, right-click anywhere, and click Add > Windows Share (CIFS).
In the Add Windows Network Share Repository dialog box, complete the following fields:
User Name and Password: Enter the credentials for accessing the CIFS share.
Server: Enter the UNC path to the desired repository directory. Alternatively, you may enter a
partial path and click Browse to find the target directory.
54
NOTE: You must enter a valid username and password before using the browse functionality.
IMPORTANT: Do not select Encrypt all backups to this repository. Using encryption or compression
with deduplicated repositories limits or disables deduplication. Encryption and compression should
not be used with any repository type that provides deduplication.
3
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
Click Next.
In the My Repositories pane, right-click anywhere, and click Add > NFS.
In the Add Network File Share Repository dialog box, complete the following fields:
Export Directory: Specify the export directory, which is similar in concept to a network share.
You must create a target subdirectory in the export directory.
Target Directory: Specify a subdirectory of the NFS export directory. This directory is the
location to which savepoints are written.
IMPORTANT: Do not select Encrypt all backups to this repository. Using encryption or compression
with deduplicated repositories limits or disables deduplication. Encryption and compression should
not be used with any repository type that provides deduplication.
Click OK.
The connection to the repository is tested and the repository is added to the My Repositories pane and
the Repository Information dialog box.
vRanger checks the configured repository location for existing manifest data to identify existing
savepoints.
55
Import as Read-Only: To import all savepoint data into the vRanger database, but only for
restores, click this button. You cannot back up data to this repository.
Import: To import all savepoint data into the vRanger database, click this button. vRanger is able
to use the repository for backups and restores. vRanger requires read and write access to the
directory.
Overwrite: To retain the savepoint data on the disk and not import it into vRanger, click this
button. vRanger ignores the existence of the existing savepoint data and treats the repository as
new.
The VA must be deployed to any ESXi host that you want to configure for replication either as a source or a
destination. For hosts in a cluster, you may deploy just one VA to the cluster; the VA is shared among the
clusters hosts. When deploying a VA to a cluster, you must choose a host in the cluster to which the VA should
be associated.
In addition, replication by way of a VA requires that if a VA is used on one host or cluster in a replication job, a
VA must be used on both the source and destination host or cluster. In other words, VAs, when used for
replication, must be used in pairs.
When configuring the VA, consider the amount of resources CPU and RAM allocated to the VA as the number
of simultaneous tasks the VA can process is directly tied to available resources. In addition, if you want to
perform replication tasks using a VA, carefully consider an appropriate size for the VA scratch disk. For more
information, see The VA scratch disk.
For more information about vRanger VA configuration, see the following topics:
Configuring VA networking
56
vzmap files: Block maps in the form of a vzmap file for the VMs replicated to the destination host.
This file contains block map information, and not actual data blocks. These maps are compared to the
source VM during each replication to identify the data blocks that have changed since the last
replication. The vzmap files make differential replication faster as they remove the need to scan the
destination VM blocks for comparison with the source VM.
vzUndo files: As data is sent to the destination host, by using the VA, blocks in the destination disk are
written to the undo file before they are overwritten by the changed data. If replication fails and an undo
becomes necessary, the original destination disk blocks are read from the undo file and written to the
destination disk to roll back the failed replication. This process is a key function designed to provide
resiliency in the face of a network failure; if there is a network failure during the replication pass, the
destination VM is not corrupted by incomplete data.
After the replication is complete, and all data has been received by the destination VA, the undo file is deleted.
At that point, the storage space used by the undo file is returned to the VA for use. Undo files are not created
during the first replication. During the first replication, the entire VM is sent to the destination host, but there
is no existing data on the destination VMDKs, and therefore no risk of corruption. Data is streamed directly to
the VMDK. You do not need to allocate scratch disk space for this scenario.
While the vzmap files are trivial in size, in the order of a few MB, the undo file can potentially be as large as
the VM itself. While the scratch disk needs to be configured to a size sufficient to handle the data of concurrent
replication tasks, making it too large wastes valuable storage space. Use the following sections to guide you in
determining the proper size for the scratch disk.
57
Calculating
If you do not have information on the amount of changed data for each VM, you can estimate the appropriate
size of the scratch disk based on the VM size and the number of VMs you plan to replicate at one time.
A general rule for sizing the scratch disk is to choose a percentage of the total VM size to represent the practical
limit of changed data for a given replication. Only you can decide what is appropriate for your environment.
The following numbers are examples given to illustrate the concept:
For example, if you have four VMs that you want to replicate to a host or cluster at the same time, the minimum
requirements for the VMs are described in the following table.
Table 2. Minimum requirements
VM
VM size
Change rate
Change size
100 GB
15%
15 GB
100 GB
10%
10 GB
100 GB
20%
20 GB
60 GB
5%
3 GB
For the preceding VMs, you would need approximately 48 GB of disk space for the undo files, plus a buffer of
approximately 10%, for safetys sake. In the example, an appropriate estimate for the scratch disk size for the
preceding VMs would be approximately 55 GB.
Bear in mind that the estimate exercise should be done for every set of VMs you want replicated to that host or
cluster, with the scratch disk being sized to accommodate the largest value obtained.
CAUTION: If the scratch disk runs out of space, replication tasks fail with a FATAL cant_write cant
write vix error.
Reduce the amount of time that passes between replication intervals. More frequent replications contain
smaller amounts of changed data.
Reduce the number of VMs that you replicate simultaneously. Doing so sends less data through the
scratch disk at any one time, which requires less space. Remember that the vzundo files are deleted
after the replication completes.
When provisioning the scratch disk, select the Thin Provisioning option. Thin provisioning helps prevent
wasted storage space by not allocating blocks until they are written by the VM.
58
Selecting a VA host
In the My Inventory view, right-click the host to which the VA should be deployed, and click
Deploy Virtual Appliance.
In the Virtual Appliance Configuration node of the Configuration Options dialog box, click
Deploy Virtual Appliance.
Selecting a VA host
You may deploy a VA to a single host or to a cluster. When performing a backup, restore, or replication task,
vRanger first checks for a VA on the host. If no VA is associated with the host, and if the host is part of a cluster,
vRanger checks for a VA on the cluster.
To select a VA host:
1
Expand the preferred cluster to select a host in the cluster to which the VA should be associated.
59
Click Next.
In the Virtual Appliance Properties section, confirm the VA Name edit as required.
In the Virtual Appliance Option section, configure the resources allocated to the VA.
You may select one of two preconfigured options, or configure a custom setting.
Minimum Required: This setting allocates one CPU and 512 MB of RAM. This entry is sufficient for
two concurrent tasks per VA.
Dell Recommended: This setting allocates two CPUs and 1 GB of RAM. This entry is sufficient for
four concurrent tasks per VA.
Dell Recommended (with RDA repository): This setting allocates four CPUs and 2 GB of RAM.
This entry is sufficient for running tasks going to RDA repositories.
Custom Setting: Select this value to configure the VA with higher resources for five or more
concurrent tasks per VA.
In the VA Datastore field, select the datastore for the VAs primary disk.
In the Network Assignment field, select the network for the VAs primary NIC.
If you want to be able to perform replication tasks on this VA, configure a scratch disk on the VA for
more information, see The VA scratch disk.
Select Use this virtual appliance for replication and configure the scratch disk size and datastore
location. Use the information in Strategies for sizing the scratch disk to guide you.
NOTE: If you are upgrading an existing VA and want to migrate the scratch disk, do not select this
option. For more information, see the topic on upgrading the vRanger VA in the Dell vRanger
Installation/Upgrade Guide.
In the VA Password and Confirm password field, enter a new password for the VA. If you change
the password, this password becomes the default for subsequent VA deployments performed
during this session.
If you want to perform FLR from backups of Linux VMs, configure a VA to use for Linux FLR.
Select Use virtual appliance for Linux File Level Restore.
If you select this option for a different VA in the future, that VA is used for Linux FLR.
60
Use DHCP for IP assignment automatically assigns IP settings to the VA if a DHCP server is
available.
Obtain the DNS server address automatically uses the DNS settings provided by your DHCP
server.
Use the following DNS server address lets you specify DNS settings manually.
Click Next.
If the configuration options are not correct, click Back to change to the information.
[Optional] Select the option to Power on the VA after deployment is complete, and then see Creating a
template.
Creating a template
Optionally, if you need to deploy the vRanger VA to multiple hosts, it may be helpful to create a VM template
from the configured VA.
To create a template:
1
From the VI Client, right-click the configured VA, select Template, and then click Clone to Template.
Enter the template name and select a location, and click Next.
Select the host or cluster on which the template is to be stored, and click Next.
Select the datastore in which the template is to be stored, and click Next.
In the Disk Format dialog box, select Same format as source, and click Next.
61
PowerCLI to deploy multiple VAs from a template, see Deploying Multiple vRanger Virtual Appliances with
PowerCLI on the vRanger Community site.
In the My Inventory view, right-click the VA you want to change, and then click Virtual Appliance
Configuration.
Under Configure Existing Virtual Appliances, select the VA to change, and then click Edit.
In the Virtual Appliance Options section, use the Select an option drop-down list to change the
resources allocated to the VA as needed.
You may select from one of the following options:
Minimum Requirement: This setting allocates one CPU and 512 MB of RAM. This entry is
sufficient for two concurrent tasks per VA.
Dell Recommended: This setting allocates two CPUs and 1 GB of RAM. This entry is sufficient for
four concurrent tasks per VA.
Custom Setting: Select this value to configure the VA with your own preferred settings; for
example, higher resources for more concurrent tasks per VA.
To change the datastore for the VAs primary disk, select the new datastore from the VA Datastore dropdown list.
62
NOTE: If you are using a VMware vCenter version lower than 5.0, the ability to change the
datastore of the VA scratch disk used for replication is not available.
5
If you want to perform replication tasks on this VA, configure a scratch disk on the VA for more
information, see The VA scratch disk.
Select Use this virtual appliance for replication and configure the scratch disk size using the up-anddown arrows and the drop-down list. For more information about sizing a scratch disk, see Strategies for
sizing the scratch disk.
[Optional] Enter a new password for the VA in the VA Password field, and then re-enter it in the Confirm
password field.
If you want to perform FLR from backups of Linux VMs, select Use virtual appliance for Linux File
Level Restore to configure a VA to use for Linux FLR.
If you select this option for a different VA in the future, that VA is used for Linux FLR.
Configuring VA networking
If you have deployed one or more VAs using a static IP configuration, and you need to change that configuration
after deployment, you must do so from within the VA.
To configure VA networking, complete the following tasks:
Logging in to the VA
Configuring DNS
Logging in to the VA
Complete the steps in the following procedure to log in to the VA.
Using the console, log in as root to the VA, using the following default credentials:
Username: root
Password: vzroot1
If you supplied your own password during the VA deployment, use that password.
Change the hostname to the new value, and save the file.
63
Using the VI text editor, edit the configuration file for eth0:
vi /etc/sysconfig/ifconfig.eth0
Configuring DNS
Depending on your environment, you might have to configure the VA with DNS nameserver information. The
steps to change an existing configuration are the same.
To configure DNS:
1
Enter the following text, substituting the appropriate values where indicated:
search <domain1> <domain2> <domain3>
nameserver <IP address>
nameserver <IP address>
In your VI client, find the cluster or clusters that contain the vRanger VAs.
64
Search for or find the vRanger VAs. Right-click each VA, and select manual.
65
4
Using vRanger
My Inventory view
My Jobs view
My Repositories view
My Reports view
66
Main toolbar
View toolbar
Views
Status bar
67
Main toolbar
The Main toolbar appears at the top of the vRanger UI and includes the drop-down menus described in the
following table.
File
Tools
Help
The only submenu available under File is Exit. Click it to close the application.
Catalog Search: Use this form to search and browse for savepoints that contain the
files and folders you are looking for. Restore operations can be started from the items
in the results pane.
Startup Wizard: Select this command to start the Startup Wizard, through which you
can add a VC, host, repository; license a host; set up a mail server; and add email
addresses.
Options: When you select this command, the Configuration Options dialog box
appears. It contains information in these categories: General, Virtual Appliance
Configuration, Licensing, and My Jobs.
License Information: The License File dialog box includes the total number of
licensed CPUs, the total number of days that the license covers, and the number of
days remaining under the current license. From this dialog box, you can import a
license file.
About vRanger Backup & Replication: Click this option to view version number,
copyright information, a link to the website, and licensing terms. Also access the
System Information dialog box, which includes hardware resources, components,
software environment, and internet settings. The dialog box features a window and
submenus that let you view remote computers and system history.
The About vRanger screen includes a System Info button that collects information
about the vRanger machine. You may export this information to a text to aid
interactions with Dell Support.
Status Bar
In every view, several icons display in the Status Bar at the bottom of the vRanger UI. Regardless of the view
displayed, the Status Bar always gives you a glimpse of active job and task count. Using the example from the
following table, the Active Jobs Count (4) corresponds to the first number in the My Jobs: Current Jobs node.
The Active Tasks Count (2) corresponds to the second number at the same node level. That is, these counts
display in this format in My Jobs: Current Jobs (4,2).
Service Support Logging: Right-click this icon to enable log files to help in troubleshooting
Windows vRanger service.
Client Support Logging: Right-click this icon to enable log files to help in troubleshooting the
vRanger UI.
Active Jobs Count: This indicator tells you the total number of active backup, restore, and
replication jobs running in real time.
Active Tasks Count: This indicator tells you the total number of active backup, restore, and
replication tasks running in real time.
New Failed Jobs: Indicates that there are new failed jobs.
When you click the New Failed Jobs icon, this action resets the data in the Status Bar. In place of
the new failed jobs icon, this icon appears and the active job and task counts are reset, populating
with zeroes (0) initially.
68
My Inventory view
The My Inventory view displays the virtual infrastructure, configured jobs, and job details. It consists of the My
Inventory pane on the left and the Working Inventory pane on the right. This view is the one from which most
backup and replication jobs are added.
Inventory toolbar
My Inventory pane
My Inventory pane
The My Inventory pane offers four tabs one to show the infrastructure of VMware VMs, one to show the
inventory of Hyper-V VMs, one for physical servers, and one to show the inventory of VMware vCloud Director
servers.
From this pane, you can navigate and refresh the tree; add or remove connections to VCs or VMware ESXi
servers; and add credentials to virtual servers. You can also add a backup or replication job.
69
Disable: When you click this command, the job that is selected in the Working Inventory pane is
disabled. A pause icon appears next to the listing.
Enable: When a disabled job is selected in the Working Inventory pane, click this command to
enable the job. A run icon appears next to the listing.
Remove: When you click to select a job or savepoint in the Working Inventory pane and then click
this icon, the job is removed.
Run: Click this command to run the job that is selected. This option reloads the window and displays
the job in My Jobs: Current Jobs.
The following icons appear in the My Inventory pane, and are enabled based on which tab you are viewing, and
what you select in the My Inventory and Working Inventory panes.
Add: The action this command triggers depends on the node that you have selected in the My
Inventory pane.
VMware tab: Click to add a VMware vCenter, VMware ESXi host, or backup group.
Hyper-V tab: Click to add a Hyper-V System Center VMM, failover cluster, host, or backup
group.
Properties: When a VC is selected, click Properties to view the credentials used to connect to it.
Remove: This command is available to delete any object that has been added to the view.
NOTE: If you remove an ESXi host, all login and backup information is deleted. If there is a job
scheduled to use this host, the job fails.
Refresh: Click this icon to refresh the My Inventory pane. Initially, only the highest-level node
appears (VC). A Loading Inventory message appears while the pane refreshes.
Inventory: Click one of these icons to display the Hosts and Clusters or Virtual Machines and
Templates view.
NOTE: This option applies only to the VMware tab.
Expand All: This option expands the tree view. After refreshing the pane, click this icon to reload
the tree structure under the VC node.
Collapse All: Click this icon to collapse the tree view so that only the VC node appears in the pane.
Search: Click this icon to display the Search Inventory field and find a specific item in the selected
inventory pane.
70
Add Credential
Credential Properties
Remove VirtualCenter
Backup VirtualCenter
Restore
View History
Refresh Inventory
Add Credential
Credential Properties
Remove Credentials
Backup
Restore
View History
Refresh History
ESX(i) Host not credentialed: Right-click this icon to access these commands:
Add Credentials
Credential Properties
Remove Credentials
Backup
Restore
View History
Refresh Inventory
71
Add Credentials
Credential Properties
Remove Credentials
Backup
Restore
View History
Refresh Inventory
ESX(i) Host Add: Click this icon to add a VMware ESXi host.
ESX(i) Host Disconnected Right click this icon to connect to the host.
ESX(i) Host Error: Right-click this icon to determine the error.
ESX(i) Host Maintenance Mode: Indicates that the host is in maintenance mode, and might not be
available.
Hosts and Clusters
vApp: VMware vSphere vApp(s) can include any applications running on any operating system, and
provide a mechanism for customers to move their applications between internal clouds or external
clouds with still the same service levels.
Change Block Tracking: This icon indicates that a job has Changed Block Tracking (CBT) enabled.
Click the icon to disable.
Virtual Machine Powered Off: Right-click this icon to access a menu of the following commands:
Credential Properties
Remove Credentials
View History
Refresh Inventory
72
Virtual Machine Powered On: Right-click this icon to access a menu of the following commands:
Credential Properties
Remove Credentials
View History
Refresh Inventory
Virtual Machine Suspended (Paused): Right-click this icon to access a menu of the following
commands:
Credential Properties
Remove Credentials
View History
Refresh Inventory
Add Credential
Credential Properties
Remove VirtualCenter
Backup VirtualCenter
Restore
View History
Refresh Inventory
Add Credential
Credential Properties
Remove Credentials
Backup
Restore
Replication
View History
Refresh Inventory
Virtual Machine Folder: Click this icon to display the VMs in this folder.
Virtual Machine Folder Open: Clicking this icon collapses the view and closes the folder.
73
Virtual Machine Powered Off: Right-click this icon to access a menu of the following
commands:
Credential Properties
Remove Credentials
View History
Refresh Inventory
Virtual Machine Powered On: Right-click this icon to access a menu of the following
commands:
Credential Properties
Remove Credentials
View History
Refresh Inventory
Restore Virtual Machine: Clicking this icon starts a restore job for this VM.
Virtual Service: Click this icon to expand the list of services.
Backup Job: Right-click the node to access these commands:
Add Credential
Credential Properties
Remove Credentials
Backup
Restore
Replicate
View History
Refresh Inventory
Add Credential
Credential Properties
Remove Credentials
Backup
Restore
Replicate
View History
Refresh Inventory
Backup Virtual Machine: Right-click the preferred VM, and click this icon to start a backup
job for this VM.
Replicate Virtual Machine: Right-click the preferred VM, and click this icon to start a
replication job for this VM.
Dell vRanger 7.3 Users Guide
Using vRanger
74
Change Block Tracking: This icon indicates that a job has CBT enabled. Left click the icon to
disable.
Connected: This icon shows that the node is connected.
Connecting: This icon indicates that a node is in the process or connecting.
Credentialed: This icon indicates that VM or Host is Credentialed.
Data Center: Selecting this icon expands the data center and displays all objects in it.
Disconnected: This icon indicates that the Node is disconnected.
Error: This icon indicates that an error has occurred, or that more data is required.
Hierarchy: This icon indicates the organization of the inventory displayed.
Inventory Tree Wait: This icon is displayed while vRanger searches for all the components in
the inventory.
Credentialed/Licensed: This icon shows that the VM or host is licensed.
Invalid Licensed Credentials: This icon shows that the credentials are invalid.
Resource: This icon indicates the presence of a resource in the inventory.
Save: Clicking this icon saves any changes made.
Server: This icon indicates a server in the inventory.
Virtual Machine Template: copy and paste this template as needed to reproduce VMs.
vApp: VMware vSphere vApp(s) can include any applications running on any operating
system, and provide a mechanism for customers to move their applications between internal
clouds or external clouds with still the same service levels.
BackupReplication License: Indicates that the VC is licensed for both backup and
replication.
Backup or Replication License: Indicates that the VC is licensed for either backup or
replication.
75
Credential Properties
View History
NOTE: Uninstalling or reinstalling the host agent from a cluster node respectively removes or adds
the agents to all nodes under that cluster.
Hyper-V Host: Right-click this icon to access the following commands:
Credential Properties
View History
Hyper-V Host Warning: This icon indicates that agent present on the host is not compatible with the
version of vRanger in use.
Virtual Machine Powered Off: Right-click this icon to access the following commands:
View History
View History
Credential Properties
View History
Refresh Inventory
Physical Machine Warning: This icon indicates that agent present on the physical machine is not
compatible with the version of vRanger in use.
Physical Machine Disconnected: This icon indicates that vRanger cannot communicate with the
physical machine. Reasons for the lack of communication include but are not limited to: the
machine is powered off, the agent is not installed on the machine, there is a network error, and so
on.
76
My Jobs view
The My Jobs view consists of the My Jobs pane on the left, the Activity pane on the upper right, and the Job
Detail pane on the lower right. Use this view to add, run, schedule, disable, or cancel a backup job. From this
view you must have either the Scheduled Jobs or On Demand Jobs node in the My Jobs pane selected to add
a job.
My Jobs pane
Activity pane
A job can be made up of many tasks. Even if some of its tasks fail, the job itself can complete successfully. In
this view, you can also confirm configuration settings for a job. My Jobs makes monitoring jobs and tasks easy.
Use the Job Detail pane to track job progress. To view task progress, see the Task Detail area. Use the tool to
view job history and check status.
My Jobs pane
The My Jobs pane displays task and job information for each of the following statuses: Current; Recent;
Scheduled; On Demand; and Disabled. For Current and Recent jobs, associated tasks are listed in separate
categories. In these nodes, jobs and tasks are distinguished in this format x, y where x is the number of jobs
and y refers to the number of tasks that make up the job. The numbers in the Current Jobs node corresponds to
the values in the Status Bars Active Jobs Count and Active Tasks Count areas, respectively.
77
Running Tasks
Queued Tasks
Running Tasks: Indicates the number of active tasks associated with current jobs.
Queued Tasks: For all current jobs, this number indicates the number of tasks waiting to run.
Recent Jobs: This node lists the number of recent jobs and tasks, respectively, that have been run.
The format (x, y) is used, indicating x recent jobs and y recent tasks. Selecting this node also
displays the Recent Job Filters section, where you can set up specific search criteria. For more
information, see Filtering job searches.
Scheduled Jobs: When this node is selected, the Activity pane is divided into two tabs: List View
and Calendar View. The items listed on both views are those jobs and tasks that have been
scheduled to run. The Job Template Detail area features configuration options selected for each
job.
On Demand Jobs: These jobs are configured to run at any time; that is, they are not scheduled. The
Job Template Detail area features configuration settings for each job.
Disabled Jobs: Listed here are jobs that have been configured, have been scheduled, and might
have been run, but are currently disabled. From this view, any disabled job can be enabled.
Rows/Page: Enter the number of rows to display on each page in the Recent Jobs pane.
Order By: Indicate whether the list should sort by Start Date, End Date, Job Name, or Job
Status. Also indicate whether to display the list in an Ascending or Descending order.
Save as default search: If you want to save the preceding search criteria as your default, select
the check box.
78
Job Type: Select All Jobs, Backup Jobs, Replication Jobs, Restore Jobs, or Repository
Replication.
Date Range or Days in the past: To specify a range of dates, set a date in Start Time and End
Time. To specify a specific number of days instead, enter a number in the box.
Machine name: To view the tasks for a specific system, enter the name of the machine.
Click Search.
The information displayed in the Recent Jobs pane updates to reflect your selections. You can select any
item in the list and view additional information about the job or task on the Detail and Log tabs in the
Job Detail pane.
Activity pane
The data that appears in the Activity pane depends on the category that you select in the My Jobs pane. You can
expand a job listing to display data on tasks associated with that job. For the Recent Jobs, On Demand Jobs, and
Disabled Jobs, the Activity pane features data organized in these categories:
Source: Indicates the host or cluster in which the source server resides.
Destination: For backup jobs, this category indicates the repository selected in the backup job. For
restore and replication jobs, this category indicates the target host or server.
Status: Lists the status of the backup or restore job or task: Completed, Failed, Aborted, or None.
Duration: Indicates length of time that the job or task took to complete.
Message: Displays more information about a task or job. For example, Host is not licensed or Please
check host credentials.
If you select the Current Jobs node, all the preceding categories display in the Activity pane. In addition, data
for the following categories is included: Throughput and Progress.
In the vRanger UI, you can clearly distinguish the running job (parent) and the running task (child). To view
details for either job or task, click to select the object. Either the Job Detail or Task Detail area appears at the
bottom of the Activity pane.
You can sort the columns in the Activity pane by clicking them. When you click, an arrow displays in the column
heading, indicating the sort order ascending or descending. Click the column heading again to change the sort
order.
If you select any sub-category under the Recent Jobs node and then right-click a job or task in the Activity pane,
a Go To menu appears. The available commands list depends on the activities previously associated with that
job or task. For example:
Go To Repository Savepoint
Go To Scheduled Activity
Go To Disabled Activity
Dell vRanger 7.3 Users Guide
Using vRanger
79
If you select a category under Current Jobs, Scheduled Jobs, or On Demand Jobs and then right-click a job or
task in the Activity pane, the following navigation options display:
Go To Inventory View
Go To Current Jobs
For Scheduled Jobs, the Activity pane features two tabbed areas: List View and Calendar View. List View
displays scheduled jobs by data type: Name, Type, Source, Destination, Enabled, and Next Run. The Calendar
View offers monthly, weekly, daily options for viewing scheduled jobs. Below this area, the Job Template Detail
area features basic configuration information about the job selected in the List View.
Click the node in the My Jobs pane to display Job and Results areas in the Activity pane. After the results
display, you can click to select any entry and additional information about the job appears in the Job Template
Detail area below the results, which you can save.
Type
Task Status
Repository
Job Type
VM Name
Job Status
Historic
On Demand
Scheduled
Disabled
All
Success
Failed
Aborted
Canceled
The values included here depend on the repositories that were added previously.
All
Backup
Restore
Replication
All
Success
Failed
Aborted
Canceled
To Date
The default is (none). When you click the drop-down list, a calendar view appears.
Host or VC
The default is (All). This list is populated with the hosts and VCs that were added previously.
80
My Repositories view
This view displays the configured repositories and available savepoints. This view is the one from which most
restore jobs are configured. It consists of the My Repositories pane on the left and the Working Repository pane
on the right.
Repository toolbar
My Repositories pane
My Repositories pane
This pane displays the configured repositories in a tree structure, grouped by repository type. Repositories can
be added and removed through the pane toolbar.
81
Properties: This icon is the gateway to the connection information and repository credentials used
to connect to the share. You can update credentials at any time.
Remove: Click this icon to open the Repository Removal Confirmation dialog box. Before removing
a repository, confirm that it is not needed to store current jobs.
Repository Name
VM Name
Host Name
Start Time
Grouping
There are two methods for grouping savepoints. You can select an option from the Group By toolbar, or you can
create customized groupings using the GroupBox command.
Repositories & Machines: Groups the savepoints first by repository, and then by VM.
Repositories: Groups the savepoints by repository.
VMs: Groups the savepoints by VM.
Physical Machines: Groups the savepoints by physical machine.
Savepoints: Groups the savepoints first by repository, then by VM, and then by root
savepoint ID.
Hosts: Groups the savepoints by host.
Date Range: This drop-down list lets you select a date range for the jobs listed in the
Working Repository pane. The values include:
All
Last Day
Last 3 Days
Last Week
Last 2 Weeks
Last Month
Last 3 Months
Custom
Define Custom
If you select Define Custom, the Savepoints Date vRanger dialog box appears. Use it to
set a date range for the jobs you want to view.
82
Sorting
The columns in the Working Repository pane can be re-ordered by dragging a heading and clicking the column.
When you click, an arrow is displayed in the column heading, indicating the sort order ascending or
descending. Click the column heading again to change the sort order.
My Reports view
From the My Reports view you can create and manage reports and email them. The My Reports view is made up
of three areas: My Reports on the left, which lists all reports for backups and restores; Working Reports on the
right, which displays the report itself; and the Report Template Detail area on the lower right.
My Reports toolbar
My Reports pane
My Reports toolbar
The toolbar is located under the Main toolbar File, Tools, Help. The options on this menu are only enabled if a
report is showing in the Working Reports pane, and act only on that report.
My Reports pane
This area features several nodes in a tree structure: Backup Job Summary Report, Backup Task Report, Replicate
Job Summary Report, Replicate Task Report, Restore Job Summary Report, and Restore Task Report. Under each
of these nodes, all reports that you create and save are nested by type. At the top of the pane, there is a menu
bar and toolbar. Within the pane itself, backup and restore reports are designated different icons.
Dell vRanger 7.3 Users Guide
Using vRanger
83
Print: Use this icon to print the report displayed in the Working Reports pane.
Print Preview: Use this icon to review the report before printing it.
Page Setup: Use this icon to adjust the report before printing it.
Save: Use this icon to save your report as a PDF or Excel file.
Refresh: Use this icon to refresh the selected report.
Close: Use this icon to close the selected report.
The Reports pane includes nodes for the following types of reports:
Backup Task
Replicate Task
Restore Task
You can also create a report or work with existing reports through the Reports pane toolbar icons. For more
information, see Reports.
When you first open the My Reports view, this icon is the only one that is enabled.
Edit: Click this icon to open the Report Wizard and change the selected reports configuration.
Enabled only when a job is selected in My Jobs.
Remove: Click this icon to delete the selected report. Enabled only when a job is selected in My
Jobs.
Run: Click this icon to run the selected report. Enabled only when a job is selected in My Jobs.
84
5
Backup
Backup overview
Backup overview
vRanger offers two types of backups: virtual and physical. Each type is described in the following sections.
Where information relates to only one type of backup, that restriction is noted in the section title or as a note
in the text.
VMware
Hyper-V
For more information on the different types of virtual backups, see the following sections:
85
When you protect a VMware environment, vRanger records data regarding the setup. This data includes whether
the VM resides on a DRS-enabled cluster, if there are storage policies involved, and the datastore
configuration network-attached storage (NAS), storage-area network (SAN), VMware Virtual Machine File
System (VMFS), or Virtual Volumes (VVols). When you perform a restore or replication, vRanger uses the default
settings from the original configuration but provides the option of changing these settings. For example, you
can restore a backup from a non-VVol datastore to a VVol datastore, or you can restore a backup from a
datastore that is governed by one storage policy to a datastore that is governed by a different policy, or no
policy.
IMPORTANT: vRanger cannot back up physical raw device map (RDM) partitions. You should see the
warning: Incompatible drive detected.
vRanger physical backups are performed using the direct-to-target architecture. Depending on how the source
server is connected to the repository, this process can result in network backups or LAN-free backups. For
backups to be LAN-free, the source server and repository must exist on the same SAN.
IMPORTANT: Physical backups are only supported on Windows machines matching the list of supported
operating systems. For more information, see the Dell vRanger Installation/Upgrade Guide.
86
HotAdd
SAN backups
LAN
HotAdd
vRanger includes support for the VMware HotAdd disk transport functionality, which permits LAN-free backups
from a VM.
vRanger can use HotAdd for two backup methods:
VA-based HotAdd: Mounts the source VMs disk to the vRanger virtual appliance (VA) deployed on the
source host or cluster. This method lets vRanger have direct access to the VM data through the VMware
I/O stack rather than the network.
Machine based HotAdd: If vRanger is installed in a VM, this method mounts the source VMs disk to the
vRanger VM. This method lets vRanger have direct access to the VM data through the VMware I/O stack
rather than the network. With this method, the backup processing activity occurs on the vRanger server.
To use vRanger with HotAdd, the VM either the vRanger VA or the vRanger VM must be able to access the
target VMs datastores. In addition, all hosts to which the vRanger VM or VA could be vMotioned using VMware
vSphere vMotion must be able to see the storage for all VMs that vRanger is configured to back up.
NOTE: When using HotAdd, plan on one concurrent backup per CPU core. To calculate the maximum
number of concurrent backup tasks per proxy server, simply identify the number of CPU cores on that
server that is the maximum number of concurrent backups. For example, a Dual-Socket, Quad-Core
system can perform up to eight concurrent backup jobs.
To disable Automount:
1
Run the automount disable command to disable automatic drive letter assignment.
87
Run the automount scrub command to clean any registry entries pertaining to previously mounted
volumes.
HotAdd limitations
The use of HotAdd for backups is subject to the following limitations:
VMFS Block Size: To use HotAdd, the VMFS containing the source VM and the VMFS containing the
vRanger VM must use the same block size. For example, if you back up a virtual disk on a datastore with
1 MB blocks, the proxy must also be on a datastore with 1 MB blocks. For more information, see the
VMware VDDK 1.2.1 Release Notes at http://www.vmware.com/support/developer/vddk/VDDK-1.2.1Relnotes.html#knownissues.
HotAdd and the vRanger VM: You cannot use HotAdd to back up the vRanger VM. This issue might result
in the vRanger volume being removed from the VM along with the source VMDK. For more information,
see the VMware VDDK 1.2.1 Release Notes at http://www.vmware.com/support/developer/vddk/VDDK1.2.1-Relnotes.html#knownissues.
Mixed mode clusters are not supported for HotAdd. For example, a VM on a VMware ESXi 6.0 host
cannot HotAdd a disk from an ESXi 5.1 host.
For information on HotAdd best practices and limitations, see VMware KB article 1035096.
SAN backups
To perform SAN backups, vRanger must be installed on a physical system attached to your fibre or iSCSI
network. In addition, the volumes containing the servers to protect must also be properly zoned and mapped to
the vRanger proxy server.
Verify that the SAN policy is set to Online All by typing san and hitting Enter.
If it is not, set it to online all by typing san policy=onlineAll.
Run the automount scrub command to clean any registry entries pertaining to previously mounted
volumes.
On your storage device, zone your LUNs so that the vRanger HBA or iSCSI initiator can see and read them.
Only one proxy should see a set of LUNs at one time. For backups only, The proxy server should only have
read-only access to the LUNs. To perform LAN-free restores, ensure that the vRanger server has Read +
Write access to any zoned LUNs to which you want to restore.
LAN
If no LAN-free option is available, backups can be processed over the network. LAN backups are supported in all
configurations and require no additional set-up to work, but are generally the slowest option. Network backups
can be processed one of two ways, depending on the source host configuration.
VA-based LAN: Transfers the source VMs data from the source disk to the vRanger virtual appliance (VA)
over the network. With this method, the backup processing activity occurs on the VA.
Machine-based LAN: If there is no vRanger VA deployed, vRanger transfers the source VMs data from the
source disk to the vRanger server over the network. With this method, the backup processing activity
Dell vRanger 7.3 Users Guide
Backup
88
occurs on the vRanger server. For VMware ESXi servers, data is sent by way of the VMware VDDK
transport.
NOTE: Generally speaking, network backups and restores are slower than LAN-free backups and restores.
If your environment supports LAN-free backups, use that option whenever possible.
The logic used to select a transport differs slightly based on whether vRanger is installed in a VM or on a
physical server. The following sections describe the steps taken to select an automatic transport.
vRanger: installed on a VM
vRanger: installed on a VM
When installed on a VM, vRanger checks the possible transports in the following order, selecting the first option
available to ensure the best performance possible.
1
VA on source host: vRanger first checks the source host for a VA. If available, that VA is used.
Is VA-based HotAdd available?: vRanger checks the local VA for HotAdd support. If the host is not
properly licensed, or the VA cannot access the storage for the source VM, HotAdd is not available.
IMPORTANT: If a VA is configured and HotAdd is not available, a network backup is performed from
the VA. No further transport checks are performed.
VA on source cluster: If the source host does not have a VA, vRanger determines whether the host is a
member of a cluster, If so, vRanger checks for a shared VA on that cluster.
Is VA-based HotAdd available?: vRanger checks the cluster VA for HotAdd support. If the host is not
properly licensed, or the VA cannot access the storage for the source VM, HotAdd is not available.
IMPORTANT: If a VA is configured and HotAdd is not available, a network backup is performed from
the VA. No further transport checks are performed.
Machine-based LAN: If a VA is not available, and HotAdd is not supported on the vRanger VM, a network
backup is performed from the vRanger machine.
VA on source host: vRanger first checks the source host for a VA. If available, that VA is used.
Is HotAdd available?: vRanger checks the local VA for HotAdd support. If the host is not properly
licensed, or the VA cannot access the storage for the source VM, HotAdd is not available.
89
IMPORTANT: If a VA is configured and HotAdd is not available, a network backup is performed from
the VA. No further transport checks are performed.
2
VA on source cluster: If the source host does not have a VA, vRanger determines whether the host is a
member of a cluster, If so, vRanger checks for a shared VA on that cluster.
Is HotAdd available?: vRanger checks the cluster VA for HotAdd support. If the host is not properly
licensed, or the VA cannot access the storage for the source VM, HotAdd is not available.
IMPORTANT: If a VA is configured and HotAdd is not available, a network backup is performed from
the VA. No further transport checks are performed.
Machine-based SAN: If there is no VA configured, vRanger determines whether the vRanger server is
configured for SAN backups.
Machine-based LAN: If a VA is not available, and SAN backups are not supported on the vRanger server, a
network backup is performed from the vRanger machine.
90
Crash consistent: A crash-consistent backup is analogous to pulling the plug on a server and then backing
up the data. The state of the data that is being backed up with respect to the users of the data is
indeterminate. Restoring a crash-consistent image is equivalent to rebooting a server after a hard shutdown.
File-system consistent: File-system consistency is achieved through standard quiescing by using the
VMware Sync Driver, which ensures that no file-system writes are pending when the snapshot is taken.
For normal VMs, file-system consistency is adequate, although it can cause corruption in database
applications.
The level of consistency provided by the Enable Guest Quiescing option depends on the version of VMware
ESXi and the corresponding VMware Tools and the guest operating system. The following table provides
more detail on what is needed to achieve various levels of consistency:
Table 3. Achieving consistency
File-level quiescing
VMware ESXi version
Windows Server
2008/2008 R2
ESXi 5.0
VMware VSS
VMware VSS
VMware VSS
ESXi 5.1
VMware VSS
VMware VSS
VMware VSS
ESXi 5.5
VMware VSS
VMware VSS
VMware VSS
ESXi 6.0
VMware VSS
VMware VSS
VMware VSS
ESXi version
Windows Server
2008/2008 R2
ESXi 5.0
VMware VSS
vzShadow.exe
vzShadow.exe
ESXi 5.1
VMware VSS
vzShadow.exe
vzShadow.exe
ESXi 5.5
VMware VSS
vzShadow.exe
vzShadow.exe
ESXi 6.0
VMware VSS
vzShadow.exe
vzShadow.exe
Application-level quiescing
As shown in the preceding table, application consistency is not always available with the basic quiescing
options. In these situations, you may use the vRanger VSS Tools vzShadow.exe for application-level
consistency.
Crash consistent: A crash-consistent backup is analogous to pulling the plug on a server and then backing
up the data. The state of the data that is being backed up with respect to the users of the data is
indeterminate. Restoring a crash-consistent image is equivalent to rebooting a server after a hard shutdown.
Application consistent: vRanger engages the Microsoft Volume Shadow Copy Services (VSS) to put
supported applications into a consistent state during a backup. This option ensures that all application
Dell vRanger 7.3 Users Guide
Backup
91
writes requests in the machines memory are committed to disk before the snapshot is taken, which
means that the application and data can be reliably recovered from the backup archive.
To achieve either type of application consistency, you must comply with the following requirements:
The guest operating system must have Hyper-V Integration Services installed.
The vRanger agent installed on the Hyper-V host uses the VSS native to the Windows operating system to
support the truncation of any supported application transaction logs. Log truncation automatically frees space
in the logical log for the transaction log to reuse.
IMPORTANT: Backing up a Hyper-V VM using a VSS writer requires a minimum of 300 MB free space on the
volume being backed up. If there is less than 300 MB of available space on the volume, the backup job
fails with an error message.
NOTE: For more information on Hyper-V backups and VSS, see https://msdn.microsoft.com/enus/library/dd405549(v=vs.85).aspx.
Application consistent: vRanger engages the Microsoft VSS to put supported applications into a
consistent state during a backup. This option ensures that all application writes requests in the machines
memory are committed to disk before the snapshot is taken, which means that the application and data
can be reliably recovered from the backup archive.
For physical backups, vRanger also supports through VSS the truncation of any supported application
transaction logs when the VSS snapshot is creating. Log truncation automatically frees space in the logical log
for reuse by the transaction log.
Full backups: Each savepoint is a complete backup set. Deleting a savepoint has no bearing on the
recoverability of any other full savepoint.
92
Incremental backups: Incremental backup jobs backup only the blocks that have changed since the last
backup full or incremental. Restoring an incremental savepoint requires the parent full and every
incremental between the full and the selected incremental.
Differential backups: A differential backup contains the data that has changed since the last full
backup. Each differential backup includes the contents of the previous differential, which in retention
terms means that only the parent full and the most recent differential are required for a restore.
Full backups
A backup job consisting only of full backups is the simplest case for retention policy configuration. Each
savepoint is independent of the other savepoints, and can be retired without affecting any other savepoints. In
other words, a backup set for full backups is equal to one savepoint only one savepoint is required for a
restore.
The following scenario depicts a daily full backup job, with a Savepoint Count of 7:
Incremental backups
Incremental backup jobs back up only the blocks that have changed since the last backup whether it was full
or incremental. Restoring an incremental savepoint requires the parent full and every incremental between the
full and the selected incremental.
The following scenario depicts a daily incremental backup job, with a Savepoint Count of 7 and a Threshold
Count of 6:
Table 4. Incremental backup retention example
Day
Action
10
11
12
13
93
Action
14
An incremental backup is taken. All savepoints from Day 1 to Day 7 are removed.
15
Differential backups
Differential savepoints require the parent full backup and the selected differential savepoint to restore. Each
differential backup includes the contents of the previous differential, which means, in terms of retention, that
only the parent full and the most recent differential are required for a restore.
The following scenario depicts a daily differential backup job, with a Savepoint Count of 7, a Threshold Count of
6, and a Threshold Size of 50%:
Table 5. Differential backup retention example
Day
Action
10
11
12
13
14
A differential backup is taken. The differential savepoint from Day 7 and the full savepoint
from Day 1 are removed.
94
VMware vSphere supports CBT, and most VMs running in this environment can use it. The VMs must be
Hardware Version 7 or later, and have been created and hosted in VMware ESXi 5.0 or later hosts. VMs that
are created in VMware ESX 4 or earlier must be migrated to Hardware Version 7 or later for CBT to be
supported. CBT must be enabled for each VM with which CBT is to be used.
NOTE: VMs that have not yet been powered on cannot have CBT enabled. You must have powered on the
VM for the CBT option to be available.
In the My Inventory view, right-click the VM for which want to change the CBT setting, and then select
one of the following options:
Enable Tracking
Disable Tracking
Expand the Backup Group panel in the Inventory pane. Right-click an empty spot, select Add,
and then click Backup Group.
Enter a name for the Backup Group, and click to select the nodes to include in the group.
Click Add.
Your new backup group is listed in the Backup Groups pane.
You can edit or remove a group by right-clicking it and selecting Edit or Remove.
95
When viewing the My Inventory View, right-click the preferred VM, and select Configure VSS Tools.
When the Configure VSS Tools dialog box appears, enter the name and password for an account with
administrative privileges on the VM, and click Next.
If the selected VM has more than one disk, the available disks are shown in the Disk for VSS snapshot
section.
Creates the C:\Program Files\Dell\vRanger\VSS directory, and populate the directory with the
vzShadow executable and supporting files.
When viewing the My Inventory View, right-click the preferred VM, and select Configure VSS Tools.
When the Configure VSS Tools dialog box appears, enter the name and password for an account with
administrative privileges on the VM, and click Next.
Click Remove.
The files are removed from the VM, but the directories remain.
On the vRanger machine, browse to the Client\VSS\VSSfor2k3 subdirectory in the vRanger installation
location.
96
In this directory, find the appropriate C++ Redistributable package and vzShadow.exe for the bit level of
the source VM the one you want to back up.
For 64-bit (x64) machines, choose:
vcredist_x64.exe (Microsoft C++ Redistributable)
vzshadow_x64.exe
For 32-bit (x86) machines, choose:
vcredist_x86.exe
vzshadow_x86.exe
On the source VM, start the vesicatories file to install the C++ Redistributable.
Depending on your system, move the appropriate file to the machines root directory typically the C:\
directory.
For 64-bit operating system, copy vzshadow_x64.exe.
For 32-bit operating system, copy vzshadow_x86.exe.
When using vRanger with Dell Recovery Manager for Exchange 5.1 or later, use the following text for your batch
file. This text creates an XML file that Recovery Manager for Exchange uses to identify vRanger savepoints with
Exchange databases.
c:\vzshadow_64.exe -bc=x:\backup.xml x:
c:\vzshadow_86.exe -bc=x:\backup.xml x:
where X equals the drive that hosts the Exchange Server; if there are multiple volumes on this VM, list all
volumes, separated by colon and a space (: ), as in:
c:\vzshadow_x86.exe -bc=c:\backup.xml c: d: e:
When VSS is triggered by VMware tools, the pre-freeze script runs vzShadow.exe.
Excluding VMs
Selecting a repository
97
In the My Inventory view, click the appropriate tab, VMware, Hyper-V, Physical, or vCloud, and then
select the preferred node to select the object or backup group.
NOTE: When viewing the vCloud inventory, the only inventory object that can be selected for
backup is a vApp.
With the preferred inventory node selected, click the Add drop-down menu, and then click
Backup Job.
In the Job Name field, enter a name for the backup job.
[Optional] In the Job Description field, enter a description for the backup job.
Click Next.
98
In the My Jobs view, click one of the following nodes to enable the Add drop-down menu:
Scheduled Jobs
On Demand Jobs
Disabled Jobs
NOTE: The node you select has no bearing on the status of the created job. For example, selecting
the Disabled Jobs node does not cause the job to be created in a disabled state.
Click the Add drop-down menu, and then click Backup Job.
On the Inventory Node Selection page, click the VMware, Hyper-V, Physical, or vCloud tab.
In the Job Name field, enter a name for the backup job.
[Optional] In the Job Description field, enter a description for the backup job.
Click Next.
Excluding VMs
If you selected a node that includes multiple servers such as a backup group or host and multiple VMs, the
next page in the Backup Wizard is the Virtual Machine Exclusion page. This page is followed by the Hard Disk
Inclusion page. If you selected a single VM or are backing up physical servers, you see only the Hard Disk
Inclusion page.
This page of the wizard only appears if you created a job for a node that includes multiple VMs, such as a host
or backup group. On this page, you can select individual VMs to exclude from the backup job. For example, if
you want to back up all but two of the VMs on a host, you can configure the backup job for the host node. You
then use this page to select the two VMs you do not want to include in the job.
To exclude VMs:
1
In the Exclude column on the left, select the VMs you want to exclude from the backup job.
Click Next.
On the Virtual Machine Hard Disk Inclusion page, only the VMs included in the backup job appear in the
Current Virtual Machines pane.
99
When you create a backup job for one server, the rule tells vRanger which disks to back up for that server. When
you create a job for multiple servers, however, the rule determines which disks are backed up for every server.
When protecting a VM, the Current Virtual Machines pane lists the servers included in the backup job, based on
your selections in the Excluding VMs procedure. The Include Hard Disks pane represents the maximum number
of disks configured for any server in the job. For example, if you have a backup job with multiple single-disk
servers and one server with six disks, the Include Hard Disks column shows six entries. Selecting Hard Disk 1
through Hard Disk 6 tells vRanger to back up every disk for each server.
If, in the preceding example, the six-disk server receives an extra disk, that disk is not going to be backed up,
because only six disks are included in the rule. To allow for future growth, the Show all disk possibilities option
lets you select all potential disks; selecting this option ensures that any disk added to a server in the future is
included in the backup job.
In the Include Hard Disks pane, select the disks that vRanger should include in the rule it applies to each
server.
When including hard disks for VMs, the selection is not server-specific. It is global for all VM servers in
this backup job. When including hard disks for physical machines, you can clear selected disks for the
backup group. However, you cannot clear Disk 1 for the group.
[Optional] If you want to allow for additional disks in the future, select Show all disk possibilities, and
select additional disks.
Click Next.
Selecting a repository
On the Repository Selection page of the wizard, you can select the repository to which the job should send the
backup data. You can also add a repository from this page. For more information, see Adding a repository.
vRanger supports the following repository options for storing backup archives:
SFTP
FTP
NFS
NetVault SmartDisk (NVSD): The Dell disk-based data-deduplication option which reduces storage costs
with byte-level, variable-block-based software deduplication. For more information on NetVault
SmartDisk, see http://software.dell.com/products/netvault-smartdisk/ or the Dell vRanger Integration
Guide for Dell NetVault SmartDisk.
EMC Data Domain Boost (DDB): Integrating EMC Data Domain Boost (DD Boost) with vRanger is
achieved by adding a Data Domain appliance running DD Boost to vRanger as a repository. Backups
written to that repository are deduplicated according to your configuration. For more information on
EMC Data Domain Boost, see http://www.emc.com/data-protection/data-domain/data-domainboost.htm or the Dell vRanger Integration Guide for EMC Data Domain Boost (DD Boost).
Dell Rapid Data Access (RDA): Provided by the Dell DR Series appliances purpose-built, disk backup
appliances that use Dell deduplication technology to improve backup and recovery processes. For more
information on Dell DR Series appliances, see http://software.dell.com/products/dr-series-disk-backupappliances/ or the Dell vRanger Integration Guide for Dell DR Series Disk Backup Appliance.
NOTE: Dell RDA and EMC DDB repositories support repository replication. Only one repository can be
configured per backup job. For more information on configuring repository replication, see Managing
repository replication.
100
To select a repository:
1
In the Repositories pane, select the repository you want to use for this backup job.
If you want to add a repository, see Adding a repository for more information.
NOTE: When using Dell RDA or EMC DD Boost repositories, you may configure the repository to
replicate savepoints to another like device. For more information, see Managing repository
replication.
Click Next.
The logic used to select a transport differs slightly based on whether vRanger is installed on a VM or on a
physical server. For more information about the order in which vRanger checks for transport availability, see
Transport selection order: VM backup.
Click Next.
101
Select where you want the job to occur from the following options:
On a vRanger VA.
vRanger verifies whether any VAs are configured on the source host. If the host belongs to a cluster, and
no host VA is found, vRanger searches for shared VAs on the cluster as well.
If no VA is detected, click Configure Virtual Appliance to add a VA to vRanger. For more information
about configuring the VA, see Understanding the vRanger virtual appliance (VA).
NOTE: Using the vRanger VA is recommended for scalability and performance.
3
Select which transports the job should attempt from the following options:
LAN
[Optional] If you want your LAN backups to be encrypted, select Use SSL encryption while transferring
files over the LAN connection when available.
CAUTION: This option causes reduced performance.
Click Next.
On the Backup Options page, select your preferences from the options described in the following table.
Option
Description
Inventory type
Backup powered on
machines only.
VMware
Hyper-V
VMware
Hyper-V
Physical
102
Option
Description
Inventory type
Compress backed up
files.
VMware
Hyper-V
Physical
Update notes with latest If this flag is selected, vRanger updates the VM Notes in
backup results.
VMware vCenter with the most recent backup status.
vRanger maintains the existing VM notes in vCenter,
appending the backup status to the end.
VMware
VMware
Physical
Physical
VMware
Hyper-V
Physical
VMware
Hyper-V
Physical
Click Next.
103
Active Block Mapping (ABM): ABM scans the disks on a VM and detects the blocks actively used by the
disk, as opposed to blocks that were deleted by the Windows operating system. With ABM enabled,
vRanger only backs up that part of a virtual disk that has active data on it. ABM also provides the
following settings options:
ABM does not back up deleted data. If a VM backed up using ABM is restored, undelete operations
are not possible.
On the Retention Policy Selection page, use the up and down arrows to select your Savepoint Count
the default is 7.
Click Next.
104
Active Block Mapping (ABM): ABM scans the disks on a VM and detects the blocks actively used by the
disk, as opposed to blocks that were deleted by the Windows operating system. With ABM enabled,
vRanger only backs up the part of a virtual disk that has active data on it. ABM also provides the
following settings options:
CAUTION: ABM does not back up deleted data. If a VM backed up using ABM is restored, undelete
operations are not possible.
Changed Block Tracking (CBT): CBT reduces the time needed for incremental and differential backups
by only backing up the portions of a disk that have changed since the last backup. By determining which
blocks changed within the VMDK file, vRanger only backs up the portions of a disk that have changed
since the last backup. This often results in shorter durations for backup operations, and reduced
resource consumption on network and storage elements.
NOTE: CBT does copy deleted blocks if ABM is not also enabled. CBT is a VMware feature, and
does not apply to physical machine or Hyper-V VM backup.
For more information about selecting the ABM and CBT operations, see Configuring backup options.
On the Retention Policy Selection page, select your Savepoint Count the default is 7.
Threshold Count: This option defines the number of incremental backups to perform before a
full backup is done.
Use the up and down arrows to select a threshold count the default is 6.
Full Backup Days: Select the day or days on which you want vRanger to take a full backup of the
server.
NOTE: To run full backups only on the selected days, the Threshold Count must be set to a
value of 8 or higher. A threshold count of 7 or less causes a full backup to run seven days
from the date the job is scheduled, even if that day is not a selected day.
Click Next.
105
Active Block Mapping (ABM): ABM scans the disks on a VM and detects the blocks actively used by the
disk, as opposed to blocks that were deleted by the Windows operating system. With ABM enabled,
vRanger only backs up the part of a virtual disk that has active data on it. ABM also provides the
following settings options:
CAUTION: ABM does not back up deleted data. If a VM backed up using ABM is restored, undelete
operations are not possible.
Changed Block Tracking (CBT): CBT reduces the time needed for incremental and differential backups
by only backing up the portions of a disk that have changed since the last backup. By determining which
blocks changed within the VMDK file, vRanger only backs up the portions of a disk that have changed
since the last backup. This often results in shorter durations for backup operations, and reduced
resource consumption on network and storage elements.
NOTE: CBT copies deleted blocks if ABM is not also enabled. CBT is a VMware feature, and does
not apply to physical machine or Hyper-V VM backup.
For more information about selecting the ABM and CBT operations, see Configuring backup options.
On the Retention Policy Selection page, select your Savepoint Count the default is 7.
Threshold Count: This option defines the number of incremental backups to perform before a
full backup is done.
Use the up and down arrows to select a threshold count the value is 6.
Full Backup Days: Select the day or days on which you want vRanger to take a full backup of the
server.
NOTE: To run full backups only on the selected days, the Threshold Count must be set to a
value of 8 or higher. A threshold count of 7 or less causes a full backup to run seven days
from the date the job is scheduled, even if that day is not a selected day.
The Threshold Size refers to the percentage of the hard disk of a VM that must be captured in
differential backups before performing a full backup. Using the Threshold Size value might cause
your full backups to be taken on unexpected days.
NOTE: The Threshold Size setting is still applied if one or more Full Backup Days are set. To
prevent the Threshold Size setting from triggering an unwanted full backup, set the
Threshold Size to 100 or higher.
Click Next.
106
On the Recurrence Schedule Selection page, select from the options described in the following table.
This will be an on There is no need to define a schedule. The job runs on demand.
demand job
Start Time
107
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between backup jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
108
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to automatically begin the job immediately after completing the wizard, select Run the Job
after Finish is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you want
to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
109
6
Restore
Full restore
Restoring a file
If you are restoring a VMware VM, be aware of the following regarding the destination that you target for a
restore:
You can change the storage-destination settings. Although vRanger uses the defaults from the original
configuration, you change the host and storage targets. For example, you can restore a backup from a
non-VVol datastore to a VVol datastore. In another example, you can restore a backup from a datastore
that is governed by one storage policy to a datastore that is governed by a different policy, or no policy.
You can select different storage for the target of the primary VM file versus the disks.
If the target uses DRS, you must select the DRS, which governs which datastore in the cluster is used at
restore time; you cannot select a specific datastore.
If your environment uses storage policies, datastores are listed under the applicable policy. Any
datastores not associated with a storage policy are listed separately.
Full restore
Using vRanger, recovery of an entire virtual machine (VM) or resource pool, VMware vSphere vApp(s), and so
on is a simple process. A full restore returns the protected objects to the state as of the point in time at which
the backup was performed. If the savepoint is for a differential backup, the restore process first restores the
matched full backup, and then merges the data from the selected differential archive. For incremental
savepoints, the full backup is restored along with each incremental archive taken between the full and the
selected savepoint.
110
When restoring a parent object, such as a vApp, vRanger restores the VM data and the parent objects
metadata, allowing you to restore the entire object state and settings and the actual VM data.
During the normal restore process, information is pulled from the vRanger database to complete the restore
job. If the vRanger server is lost, and the database cannot be recovered or is otherwise unavailable, you can
reinstall a fresh version of vRanger and import the repository to regain access to your backups.
Restoring a file
Unlike traditional backup solutions that require file-level agents, vRanger can recover a file or files directly
from the image-level backup, without mounting the image. Incremental backups are combined with the parent
full image as needed.
One of the key problems with file-level restore (FLR) is finding the appropriate files. vRanger includes a
cataloging feature that indexes backups of Windows servers, and records the metadata to enable faster
searching. For more information, see Performing an FLR using Catalog Search.
111
Selecting a savepoint
Selecting a destination
Selecting a network
Select the repository in which the savepoints for the server you want to restore are stored.
On the Mode Selection page, enter the Job Name and Job Description.
Click Next.
Selecting a savepoint
The Savepoint Selection page displays all available savepoints, including their respective VMs and repositories.
The savepoint selected on the Mode Selection page appears checked.
To select a savepoint:
1
Click Next.
112
Selecting a destination
The Destination Selection page lets you configure the host, drives, and datastores to which the savepoints are
to be restored.
To select a destination:
1
Confirm that the path that appears in the Virtual Machine Location field is correct.
To change this path, use the browse () button to locate and a select a new location.
Click the Master Datastore browse button to locate and select the datastore to use for all VMs.
The Master Datastore lets you select all datastores simultaneously.
d
2
Click Assign.
Select the primary VM and the disks that you want to restore.
Disks disabled for Restore appear in italics.
To select a different host for each VM, click the drop-down list in the Restore To Host column,
and then select the host to which the VM should be restored.
To select a different datastore for each VM, click the browse button next to the Primary
Datastore column entry.
On the Select Primary Storage page, select the applicable datastore or DRS, if applicable, and
click OK.
This page lists all datastores associated with the selected host. Datastores are first grouped based
on whether they are governed by a storage policy. Datastores are also grouped based on whether
they reside in a DRS cluster. You can expand or collapse groups as needed.
By default, vRanger assigns the same storage selection to the primary VM and its disks, if
applicable.
To select a different datastore for a disk, click the browse button next to the Primary Datastore
column entry for the disk, select the applicable datastore or DRS on the Select Primary Storage
page, and click OK.
On the Destination Select page appears, verify that the applicable datastore is specified in the
Primary Datastore column for the primary VM and the disks.
NOTE: VVol datastores only support thin disks. If your VM resided on a thick disk during the
backup and you select a VVol datastore for the restored VM, vRanger automatically converts
the setup to thin disks.
To select a different host for each VM, click the drop-down list in the Restore To Host column,
and then select the host to which the VM should be restored.
To select a different datastore for each VM, click the button next to the Configuration File
Location column entry.
To rename to VM you are restoring, enter the new name under the Restore As column.
Click Next.
Dell vRanger 7.3 Users Guide
Restore
113
Selecting a network
The Network Selection page lets you configure the virtual network to which each vNIC should be connected
upon restore. You can also configure a Master Network, which uses the selected network for all vNICs.
To select a network:
1
To use the same network for all VMs, select a host from the Master Network drop-down list to
which all VMs should be restored. Click Assign.
To use different networks for individual VMs, select a virtual network from the connected
network adapters included in the Restore To Host drop-down list for each VM to which the vNIC
should be connected.
Click Next.
The logic used to select a transport differs slightly based on whether vRanger is installed on a VM or on a
physical server. For more information about the order in which vRanger checks for transport availability, see
Transport selection order: VM backup.
114
vRanger verifies whether any VAs are configured on the source host. If the host belongs to a cluster, and
no host VA is found, vRanger searches for shared VAs on the cluster as well.
If no VA is detected, click Configure Virtual Appliance to add a VA to vRanger. For more information
about configuring the VA, see Understanding the vRanger virtual appliance (VA).
2
Click Next.
Select where you want the job to occur from the following options:
On a vRanger VA.
vRanger verifies whether any VAs are configured on the source host. If the host belongs to a cluster, and
no host VA is found, vRanger searches for shared VAs on the cluster as well.
If no VA is detected, click Configure Virtual Appliance to add a VA to vRanger. For more information
about configuring the VA, see Understanding the vRanger virtual appliance (VA).
NOTE: Using the vRanger VA is recommended for scalability and performance.
3
Select which transports the job should attempt from the following options:
LAN
[Optional] If you want your LAN backups to be encrypted, select Use SSL encryption when transferring
files over the LAN connection.
CAUTION: This option causes reduced performance.
Click Next.
On the Options Selection page, select from the following restore options:
Force overwrite: This option overwrites any existing disk or config files of the same name as
those files in the destination host.
Force power on: This option turns on the VM after the restore.
Create cluster role for restored virtual machine: This option is for Hyper-V VMs only. It
attempts to add the VM as a cluster resource of the Hyper-V host parent cluster.
Dell vRanger 7.3 Users Guide
Restore
115
NOTE: The cluster option is available only when a Hyper-V cluster has been added to the
vRanger inventory and includes the host that is selected as the restore destination.
2
Click Next.
On the Recurrence Schedule Selection page, select the options as described in the following table.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
116
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
117
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you
want to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
118
Selecting a destination
Mapping storage
Select the repository in which the savepoints for the server you want to restore are stored.
On the Mode Selection page, enter the Job Name and Job Description.
Click Next.
Selecting a destination
The Destination Selection page lets you configure the virtual data center (vDC) to which the VMware vSphere
vApp(s) savepoints are to be restored, and the name of the restored vApp.
To select a destination:
1
To rename the vApp you are restoring, enter the new name in the Restore vApp As field.
In the Restore vApp under vDC drop-down list, select the virtual data center to which the vApp should
be restored.
Click Next.
Mapping storage
The Restore Storage Mapping page lets you configure the storage profile and, as needed, the datastore for each
VM in the vAPP.
In the Storage Profile drop-down list, select the applicable storage profile.
Dell vRanger 7.3 Users Guide
Restore
119
Selecting a storage profile allows VMware vCloud Director to select the appropriate datastore
automatically based on your storage profile settings.
2
To specify a datastore manually, select Any in the Storage Profile drop-down list, and select the
applicable datastore in the Datastore drop-down list.
Click Next.
The logic used to select a transport differs slightly based on whether vRanger is installed on a VM or on a
physical server. For more information about the order in which vRanger checks for transport availability, see
Transport selection order: VM backup.
Click Next.
120
Select where you want the job to occur from the following options:
On a vRanger VA.
vRanger verifies whether any VAs are configured on the source host. If the host belongs to a cluster, and
no host VA is found, vRanger searches for shared VAs on the cluster as well.
If no VA is detected, click Configure Virtual Appliance to add a VA to vRanger. For more information
about configuring the VA, see Understanding the vRanger virtual appliance (VA).
NOTE: Using the vRanger VA is recommended for scalability and performance.
3
Select which transports the job should attempt from the following options:
LAN
[Optional] If you want your LAN backups to be encrypted, select Use SSL encryption when transferring
files over the LAN connection.
CAUTION: This option causes reduced performance.
Click Next.
On the Options Selection page, select from the following restore options:
Force overwrite: This option overwrites any existing disk or config files of the same name as
those files in the destination host.
Force power on: This option turns on the vApp after the restore.
Click Next.
On the Recurrence Schedule Selection page, select the options as described in the following table.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
121
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
122
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you
want to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
123
Selecting a savepoint
Mapping disks
Creating a bootable CD
Creating a bootable CD
Complete the steps in the following procedure to create a bootable CD.
IMPORTANT: The procedures for creating a bootable CD differ widely depending on the operating system
and software used. The following procedures show how to use the native Windows 7 utility to create a
bootable CD. If you have a different image burning application, follow the instructions for that
application.
NOTE: This procedure requires a blank CD/DVD and a writable CD/DVD drive.
If necessary, copy the vzRestore-<version>.iso file to the machine with the writable CD/DVD drive.
Right-click the ISO file, select Open with, and then click Windows Disk Image Burner.
From the disk burner drop-down list, select the drive containing the blank disk.
Click Burn.
Dell vRanger 7.3 Users Guide
Restore
124
If necessary, copy the vzRestore-<version>.img file to the machine with the blank USB drive.
In the Image Writer for Windows UI, browse to the vzRestore-<version>.img file.
In the Device drop-down list, ensure that the correct USB drive is selected.
Click Write.
Click Exit.
Using the boot media created in the previous steps, boot the target server into the vRanger restore
environment.
When the boot is complete, a list of available network devices and their connection status appears.
If a DHCP server is available, the restore environment obtains its IP configuration automatically,
and a prompt appears with the IP information. Record this information to use during the restore
job creation process.
If no DHCP server is detected, each Ethernet device shows as Disconnected. Select the
preferred network device. If only one device is present, it is automatically selected. Press Enter
to select the highlighted network interface. You are then prompted to select either Use DHCP,
which attempts to obtain an IP address again, or Configure Static IP.
[Optional] If the vRestore environment does not contain the correct drivers for your hardware, enter a
Linux command prompt by pressing F1, and add them manually.
IMPORTANT: Do not reboot the target server or the IP configuration is lost.
125
Using the boot media created in the previous steps, boot the target server into the vRanger restore
environment.
When the boot is complete, a list of available network devices and their connection status appears. If no
DHCP server is detected, each Ethernet device shows as Disconnected.
In the Setting Static IP dialog box, enter the IP address, subnet mask, and gateway information, and
then select Submit.
The target server is configured with the selected IP information.
[Optional] If the vRestore environment does not contain the correct drivers for your hardware, enter a
Linux command prompt by pressing F1, and add them manually.
IMPORTANT: Do not reboot the target server or the IP configuration is lost.
Selecting a savepoint
The savepoint is from where the data for the physical machine is restored.
To select a savepoint:
1
Select the repository in which the savepoints for the server you want to restore are stored.
126
On the Mode Selection page, enter the Job Name and Job Description.
Click Next.
The Disk Mapping page appears.
Mapping disks
The Disk Mapping page of the wizard lets you map the protected disks in the savepoint to the existing physical
disks on the target server.
To map disks:
1
On the Disk Mapping page, in the Restore Machine IP Address field, enter the IP for the target server;
for more information, see Booting the target server.
For each disk you want to recover, select the appropriate target disk in the Restore to Disk drop-down
menu; for disks that you do not want to recover, select Skip this Disk.
Click Next.
The Recurrence Schedule Selection page appears.
On the Recurrence Schedule Selection page, select from the options described in the following table.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
127
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
128
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you want
to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
129
NOTE: If the volume was created on Windows Server 2012 or later, the vRanger machine must also use
Windows Server 2012 or later to complete FLR. Older systems may not show data on GPT disks.
When cataloging a full backup, all files in the system are stored in the database.
When cataloging an incremental backup, only the files that were modified since the last backup are
stored in the database.
When cataloging a differential backup, only the files that were modified since the last full backup are
stored in the database.
NOTE: When it comes to reporting the status of a backup task, cataloging is not considered a
critical function. The cataloging portion of the task can fail, and the task is still considered
successful.
On the main vRanger UI, navigate to the My Repositories pane, and then select the repository in which
you want to search.
On the Menu Bar, click the Tools menu, and then click Catalog Search.
Select the repository or VM you want to search, enter the search string, and click Search.
Select the preferred savepoint, and click FLR for File Level Restore, or Restore for the Full Restore.
NOTE: Catalog searching supports the traditional wildcard character (*) in any position. The search
string can be as short or as long as you prefer; however, the shorter the string, the longer the
search takes. SQL Server Express is limited to one CPU and 1 GB of RAM; a short search string for
instance, dot could result in very slow searching, and SQL Server Express could run out of
memory. To minimize performance issues during Catalog Search, make the search string as specific
as possible.
130
Savepoint pane: In this area, all the files or folders connected to a savepoint are nested. When you click
the file or folder that you want to restore, the path is listed above it.
Destination pane: This pane includes a tree structure of all possible destinations for the restored file or
folder you select.
Restore Status pane: This area of the dialog box contains data after the restore process starts. It
includes a column that indicates the percentage of the job that has completed. The dialog box also
features a Stop link that, when clicked, ends the restore process. When a job is stopped or it has
completed, a View in Explorer link appears.
In the Working Repository pane, right-click the savepoint for which you want an FLR and select File
Level Restore.
In the Select the Files/Folders to Restore pane, expand the archive to view the file structure.
In the Destination pane, select the destination to which the selected files should be recovered.
The Destination pane shows the Windows Explorer view for the machine on which vRanger is installed.
CAUTION: vRanger does not check for previous versions of the files you are restoring. Files restored
using FLR overwrite any previous files of the same name in the restore destination.
Click Restore.
In the Restore Status pane, view the status of the restore activity and the value in the Percent Finished
column.
Make sure that the status is Finished and Percent Finished is 100%.
To view the restored file or folder, click the View in Explorer link.
Linux: FLR from Linux servers requires the use of the vRanger VA. For more information, see Performing
an FLR on Linux.
Dell vRanger 7.3 Users Guide
Restore
131
Linux: Not all Linux file systems are supported for FLR. For a list of supported Linux platforms and file
systems, see the Dell vRanger Installation/Upgrade Guide.
Permissions: vRanger requires you to recover the Linux files to an intermediate Windows machine.
When you recover Linux files to a Windows machine, you lose the file permissions.
Source VM Configuration: The source VM properties need to show the operating system (OS) type as
Linux. If this setting is not configured properly, vRanger does not identify the savepoint as a Linux VM.
Selecting a destination
Selecting a network
132
On the toolbar, click Restore from Manifest, and then click one of the following options:
On the Mode Selection page, populate the Job Name and Job Description fields.
Click Next.
The Savepoint Manifest Selection page appears.
Click Browse, and then browse to the location of the savepoint manifest.
Enter the credentials for the account with access to the savepoint manifest.
Click Add.
Click Next.
The Destination Selection page appears.
Selecting a destination
The Destination Selection page lets you configure the host, drives, and datastores to which the savepoints are
restored.
To select a destination:
1
Confirm that the path that appears in the Virtual Machine Location field is correct.
To change this path, use the browse () button to locate and a select a new location.
Click the Master Disk Storage Datastore browse button to locate and select the datastore to use
for all VMs.
The Master Datastore lets you select all datastores simultaneously.
Click Assign.
Dell vRanger 7.3 Users Guide
Restore
133
To select a different host for each VMDK, click the drop-down list in the Restore To Host column
for each VM, and then select the host to which the VM should be restored.
To select a different datastore for each VM, click the button next to the Primary Datastore
column entry.
On the Select Primary Storage page, select the applicable datastore or DRS, if applicable, and
click OK.
This page lists all datastores associated with the selected host. Datastores are first grouped based
on whether they are governed by a storage policy. Datastores are also grouped based on whether
they reside in a DRS cluster. You can expand or collapse groups as needed.
By default, vRanger assigns the same storage selection to the primary VM and its disks, if
applicable.
To select a different datastore for a disk, click the browse button next to the Primary Datastore
column entry for the disk, select the applicable datastore or DRS on the Select Primary Storage
page, and click OK.
On the Destination Select page appears, verify that the applicable datastore is specified in the
Primary Datastore column for the primary VM and the disks.
NOTE: VVol datastores only support thin disks. If your VM resided on a thick disk during the
backup and you select a VVol datastore for the restored VM, vRanger automatically converts
the setup to thin disks.
To rename to VM you are restoring, enter the new name under the Restore As column.
Click Next.
Selecting a network
The Network Selection page lets you configure the virtual network to which each vNIC should be connected
upon restore. You can also configure a Master Network, which uses the selected network for all vNICs.
To select a network:
1
To use the same network for all VMs, select a host from the Master Network drop-down list to
which all VMs should be restored. Click Assign.
To use different networks for individual VMs, select a virtual network from the connected
network adapters included in the Restore To Host drop-down list for each VM to which the vNIC
should be connected.
Click Next.
134
The logic used to select a transport differs slightly based on whether vRanger is installed on a VM or on a
physical server. For more information about the order in which vRanger checks for transport availability, see
Transport selection order: VM backup.
Click Next.
Select where you want the job to occur from the following options:
On a vRanger VA.
Dell vRanger 7.3 Users Guide
Restore
135
vRanger verifies whether any VAs are configured on the source host. If the host belongs to a cluster, and
no host VA is found, vRanger searches for shared VAs on the cluster as well.
If no VA is detected, click Configure Virtual Appliance to add a VA to vRanger. For more information
about configuring the VA, see Understanding the vRanger virtual appliance (VA).
NOTE: Using the vRanger VA is recommended for scalability and performance.
3
Select which transports the job should attempt from the following options:
LAN
[Optional] If you want your LAN backups to be encrypted, select Use SSL encryption when transferring
files over the LAN connection.
CAUTION: This option causes reduced performance.
Click Next.
On the Options Selection page, select from the following restore options:
Force overwrite: This option overwrites any existing disk or config files of the same name as
those files in the destination host.
Force power on: This option turns on the VM after the restore.
Create cluster role for restored virtual machine: This option is for Hyper-V VMs only. It
attempts to add the VM as a cluster resource of the Hyper-V host parent cluster.
NOTE: The cluster option is available only when a Hyper-V cluster has been added to the
vRanger inventory and includes the host that is selected as the restore destination.
Click Next.
On the Recurrence Schedule Selection page, select the options as described in the following table.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
136
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
137
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you want
to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
138
NOTE: The procedures in this section apply to restoring from a physical machine savepoint manifest. For
information on restoring a VM from a savepoint manifest, see Performing a full restore from manifest for
VMs.
To perform a full restore from a manifest for a physical machine, complete the following tasks:
Mapping disks
Creating a bootable CD
Creating a bootable CD
Complete the steps in the following procedure to create a bootable CD.
IMPORTANT: The procedures for creating a bootable CD differ widely depending on the operating system
and software used. The following procedures show how to use the native Windows 7 utility to create a
bootable CD. If you have a different image burning application, follow the instructions for that
application.
NOTE: This procedure requires a blank CD/DVD and a writable CD/DVD drive.
If necessary, copy the vzRestore-<version>.iso file to the machine with the writable CD/DVD drive.
Right-click the ISO file, select Open with, and then click Windows Disk Image Burner.
From the disk burner drop-down list, select the drive containing the blank disk.
Click Burn.
139
If necessary, copy the vzRestore-<version>.img file to the machine with the blank USB drive.
In the Image Writer for Windows UI, browse to the vzRestore-<version>.img file.
In the Device drop-down list, ensure that the correct USB drive is selected.
Click Write.
Click Exit.
Using the boot media created in the previous steps, boot the target server into the vRanger restore
environment.
When the boot is complete, a list of available network devices and their connection status appears.
If a DHCP server is available, the restore environment obtains its IP configuration automatically,
and a prompt appears with the IP information. Record this information to use during the restore
job creation process.
If no DHCP server is detected, each Ethernet device shows as Disconnected. Select the
preferred network device. If only one device is present, it is automatically selected. Press Enter
to select the highlighted network interface. You are then prompted to select either Use DHCP,
which attempts to obtain an IP address again, or Configure Static IP.
[Optional] If the vRestore environment does not contain the correct drivers for your hardware, enter a
Linux command prompt by pressing F1, and add them manually.
IMPORTANT: Do not reboot the target server or the IP configuration are lost.
140
Using the boot media created in the previous steps, boot the target server into the vRanger restore
environment.
When the boot is complete, a list of available network devices and their connection status appears. If no
DHCP server is detected, each Ethernet device shows as Disconnected.
In the Setting Static IP dialog box, enter the IP address, subnet mask, and gateway information, and
then select Submit.
The target server is configured with the selected IP information.
[Optional] If the vRestore environment does not contain the correct drivers for your hardware, enter a
Linux command prompt by pressing F1, and add them manually.
IMPORTANT: Do not reboot the target server or the IP configuration is lost.
On the toolbar, click Restore from Manifest, and then click Restore from Physical Savepoint Manifest
File.
The Restore Wizard starts.
On the Mode Selection page, populate the Job Name and Job Description fields.
Click Next.
The Savepoint Manifest Selection page appears.
141
Click Browse, and then browse to the location of the savepoint manifest.
Enter the credentials for the account with access to the savepoint manifest.
Click Add.
Click Next.
The Destination Selection page appears.
Mapping disks
The Disk Mapping page of the wizard lets you map the protected disks in the savepoint to the existing physical
disks on the target server.
This task is a procedure in Performing a full restore from manifest for a physical machine.
To map disks:
1
On the Disk Mapping page, in the Restore Machine IP Address box, enter the IP for the target server;
for more information, see Booting the target server.
For each disk you want to recover, select the appropriate target disk in the Restore to Disk drop-down
menu; for disks that you do not want to recover, select Skip this Disk.
Click Next.
The Recurrence Schedule Selection page appears.
On the Recurrence Schedule Selection page, select the options as described in the following table.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
142
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
Interval: The interval option lets you select the number of days, hours, and
minutes that should pass between jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of
Recurrence
Click Next.
143
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you
want to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
Click My Repositories.
144
In the File Level Restore from Manifest dialog box, enter the user name, password, and path for the
Manifest file of the backup that contains the files you want to restore.
Click OK.
In the Select the Files/Folders to Restore pane, expand the archive to view the file structure, and then
select the file or files to recover.
In the Destination pane, select the destination to which the selected files should be recovered.
The Destination pane shows the Windows Explorer view for the machine on which vRanger is installed.
CAUTION: vRanger does not check for previous versions of the files you are restoring. Files restored
using FLR overwrites any previous files of the same name in the restore destination.
Click Restore.
In the Restore Status pane, view the status of the restore activity and the value in the Percent Finished
column.
145
7
Replicate VMs
Replication modes
If you are looking for information on replicating Dell RDA and EMC DD Boost repositories, see Managing
repository replication.
A VM is made up of a set of files. Replicating a VM is, in essence, replicating the set of files that make up the
VM, with changes to these files that reflect user-specified settings for the source VM.
Be aware of the following regarding the destination that you target for a replication:
You can change the storage-destination settings. Although vRanger uses the defaults from the original
configuration, you change the host and storage targets. For example, you can replicate from a non-VVol
datastore to a VVol datastore. In another example, you can replicate from a datastore that is governed
by one storage policy to a datastore that is governed by a different policy, or no policy.
You can select different storage for the target of the primary VM file versus the disks.
If the target uses DRS, you must select the DRS, which governs which datastore in the cluster is used at
replication time; you cannot select a specific datastore.
If your environment uses storage policies, datastores are listed under the applicable policy. Any
datastores not associated with a storage policy are listed separately.
Description
.vmx
.vmxf
.nvram
.vmdk
-flat.vmdk
The VM hard disk data file, one per hard disk or snapshot.
146
Description
-delta.vmdk
-ctk.vmdk
The VM hard disk change tracking file when CB is enabled on the disk.
Description
.vzmap
Records data block offset and hash of files on the target VM. A .vzmap file is
created for each of the files replicated at the end of the replication. The .vzmap
file is used by the next replication pass to detect any data changes since the
previous pass. It stays on the target VM as long as the job is still configured to run.
While relatively small, the size of the .vzmap file is directly proportional to the size
of the VMDK it is based on.
During replication, the .vzmap file is stored on the target VA.
vzundo-script
A script created by the replication process to roll back changes on the target VM if
there is a replication failure. This file created on the target VA at the start of the
replication process and removed at the end.
.vzundo
This file is a temporary file that records original data of changed blocks since the
replication started. One for each VMDK replicated. If there is a replication failure
such as a network failure, the vzundo-script can be run to restore files to their
original state. These files are created on the VA by the replication process and
removed when the job is completed.
NOTE: The .vzundo file is as large as the amount of changed data replicated during
a given pass. For example, if a replication pass sends 20 GB of changed data to the
target VA, the .vzundo file is 20 GB.
.vmdk-abbt.vztemp
Active block filter file. One for each hard disk data file when ABT is enabled. It
records active data block offsets for source VM disks. This file is used against the
.vzmap file to figure out data blocks that need to be streamed to the target. It is
created at the start of the replication process and removed when disk replication is
completed.
.vmdk-abfg.vztemp
Change block filter file. One for each hard disk when Changed Block Tracking (CBT)
is enabled. It records changed block offsets for source VM disks. This file is only
generated when CBT and ABT are both enabled. It is later combined with the
.vmdk-abbt.vztemp file into -flat-map.vztemp and removed.
-flat-map.vztemp
Disk data filter file. One for each hard disk when one of two situations are true: CB
is enabled, or both AB and CB are enabled. It contains active and changed data
block offsets that need to be compared to the .vzmap file at the target to figure
out data blocks that need to be streamed to the target. It is created right before
file replication starts and removed when file replication is completed.
.vzcid
147
For instructions on deploying and configuring the VAs, see the Dell vRanger Installation/Upgrade Guide.
At a minimum, deploy one VA on every ESXi server that you plan to use as a replication source or target.
For hosts in a cluster, you can deploy the VA to only one host in the cluster; the VA is shared among the
clusters other hosts.
VAs must be used in pairs. For example, if you are replicating to a target host or cluster that is using a
VA, use a VA on the source host or cluster as well.
Due to VMware limitations on how snapshots are handled during HotAdd operations, hardware changes to
the source VM occurring after a job has been configured are not replicated to the target VM. For more
information, see Replication modes.
Communication between the VAs occurs through an SSH tunnel using AES-256 encryption. For more information,
see the Encryption description in Major feature list.
vRanger replication does not operate with servers that are behind a network address translation (NAT)
firewall. To replicate through a NAT firewall properly, you must have an IP tunnel in place between two
NATed subnets. Contact your ISP provider to see if this option is available to you.
The VM hardware cannot be changed during replication. For this reason, the VM must be at a hardware
version level that is compatible with both the source and target servers. The VMware ESXi version of
the source and target hosts does not matter, as long as the VM hardware is supported on both ESXi
versions. For more information on VM hardware versions and compatibility, see the VMware
documentation at https://www.vmware.com/support/pubs/.
A continuous connection between source and target sites is required when replication is taking place.
Excessive network packet loss could result in replication failure. Replication does work with links having
average packet loss of less than 2%. Replication is not designed to work in replication environments
where packet loss exceeds commercially accepted limits.
Networks having 99% uptime and availability generally provide for good Replication performance.
NOTE: Replication with user snapshots applies only to replication using the VA.
148
Replication modes
vRanger offers Replication with Changed Block Tracking (CBT) or standard Differential replication. Each of these
replication modes has the option of ABM. VM replication in general starts with replicating the source VM to the
target host. Changes are applied to the target VM at user designated intervals to keep the target in sync with
the source. Thus the key difference between the replication modes is how vRanger identifies VM changes to
replicate. For more information, see the following sections:
Differential replication
The VM to which the disks belong must use Hardware Version 7 or later.
For CBT to identify disk sectors in use with the special change ID, the following configurations are also required:
The virtual disk must be on a VMFS volume, backed by a SAN, iSCSI, or local disk.
NOTE: Raw device map (RDM) partitions are not considered VMFS volumes.
The VM must have zero snapshots when CBT is enabled for a clean start.
149
NOTE: CBT must be enabled for each VM that you want to replicate. VMware vSphere supports
CBT, and most VMs running in this environment can use it.
Differential replication
In differential replication, vRanger compares the data blocks on the source VM to a data map to identify blocks
that have changed since the last replication pass. These changed blocks are sent to the target VM and
committed to disk, and the data map is updated to reflect the current state of both VMs.
When using differential replication, consider the following:
During the first replication pass, the entire VM image needs to be sent to the target VM. During
subsequent replication passes, only changed data is sent. To avoid sending the entire VM image over the
network, consider pre-seeding the target VM. For more information, see Pre-seeding replication jobs
After the first replication pass, the source VM is scanned and the blocks are compared to the most recent
data map. This scanning process can take an average of one minute per gigabyte of hard drive space;
however, the actual speed depends on the underlying hardware being used. While only the changed data
is sent to the target VM, the entire hard drive must be scanned. When configuring differential replication
jobs for large VMs, take this scanning time into account. To eliminate the need for scanning, use
replication with CBT if at all possible.
Select the VM you want to get to the disaster recovery (DR) site, and create a Full backup job.
150
Savepoints are named using a VMname_date_time_UUID format. Copy the entire directory, which
contains a .var file and two .metadata files, for the savepoint in question.
5
Using the Restore from Manifest function documented in Performing a full restore from manifest for VMs,
restore the backup to the target VMware ESXi Server at the DR site.
Start vRanger, and expand the host where the source VM is located.
When selecting the target host, select the host on the target side to which the source VM has been
restored.
NOTE: When selecting the target VM name, ensure that you are using the same name as the source
VM. vRanger appends _VzReplicate to the VM name on the target side.
In the Select Target Host dialog box, next to Preseed VM UUID, click the browse button, and select the
pre-seeded VM.
When configuring the primary datastore, ensure that it is the same datastore as the restored VM, and
click Finish.
151
Click My Inventory.
Enter the Job Name and Job Description, and click Next.
If you have pre-seeded the VM on the target host, select the host on the target side to which the
source VM has been restored. For more information, see Pre-seeding replication jobs. When
selecting the target VM name, ensure that you are using the same name as the source VM.
vRanger appends _VzReplicate to the VM name on the target side.
[Optional] In the Select Target Host dialog box, next to Preseed VM UUID, click the browse button, and
select the pre-seeded VM.
IMPORTANT: After a replication job has been saved, you cannot change the target host. If you want
to replicate to a different host, you may either use VMware vSphere vMotion to migrate the VM
to the preferred host, or create a replication job for the preferred target. If you vMotion the VM,
the existing replication job should identify the change in host and adjust automatically.
On the Replication Mode page, under Replication Type, select Differential Replication.
NOTE: Hybrid replication is not supported when replicating to or from VMware ESXi. This feature
is deprecated for vRanger 7.2 and later.
Click Next.
152
Select the Network Mapping you want to use for this job.
Click Next.
In the Target Datastore column, verify that the Primary Datastore has been populated.
If you want the disk to replicate to a different datastore, click the browse button () next to the Target
Datastore selection.
When the Select which Hard Disk(s) to replicate page appears, click Next.
Configure the replication options, using the following table for guidance.
Option
Description
This option prompts vRanger to check the destination location to ensure that
there is enough space available for the replica VM.
Update notes with latest If this flag is selected, vRanger updates the VM Notes in VC with the most
replication results.
recent replication task status.
NOTE: vRanger maintains the existing VM notes in VMware vCenter,
appending the replication status to the end.
153
Option
Description
This option enables the VMware Tools when creating a snapshot. Use this
flag if you are replicating a database server. During this process, vRanger
freezes or pauses writes on supported applications to provide a consistent
image of VSS-enabled databases. For more information, see Physical backup
transport options.
Selecting this option enables ABM, which lets vRanger skip data that
recognized as removed on Windows NTFS including junk data in recycle
bin.
NOTE: With this option enabled, junk data in recycle bin and deleted data
on the VM are not replicated.
The following ABM settings options are also available:
Click Next.
On the Recurrence Schedule Selection page, select from the options described in the following table.
NOTE: To replicate more frequently than once per day, use the Interval recurrence pattern.
This will be an On There is no need to define a schedule. The job runs on demand.
Demand job
Start Time
154
Recurrence
Pattern
In this section, you establish how often the report should be generated. There are
five options within this section:
Daily: The daily option can be scheduled to run the report every weekday or
every x number of days.
NOTE: Configure a value sufficient to let the previous replication pass to continue.
Range of
Recurrence
Click Next.
155
On the Email Notification Selection page, in the Selected column, select the address to which
notifications should be sent.
TIP: To select all email addresses, select the check box in the Selected column header.
Click Next.
On the Summary page, review the data displayed in the tree view.
If you want to begin the job automatically after completing the wizard, select Run the Job after Finish
is clicked.
NOTE: If this option is not selected, the job is saved and begins at the time determined during the
Setting the Recurrence Schedule procedure.
Click Finish.
If you did not opt to begin the job automatically after clicking Finish, and this job is an on-demand job,
do the following:
NOTE: If this job is not an on-demand job, the job begins at the scheduled time.
In the main vRanger UI, in the My Inventory view, select the server or host for the server you
want to restore, and then select the job from the Working Inventory pane.
To check progress or confirm completion, click My Jobs, and then click Recent Jobs.
156
Test Failover: This function disables the replication job, snapshots the replica VM, and powers it on. You
have the option of performing a test failover with or without networking enabled on the replica VM.
There are two methods for performing failure:
Failover: This method simplifies the action of failover to a replica VM. You can perform a final
synchronization or fail over immediately. The vReplicator process gracefully and safely powers down
your production VM, and boots your replica VM with a single click.
icon.
When testing is complete, select the Test Failover task in the Current Jobs node, and click Resume.
157
Make the required changes carefully, using the following information as guidance.
NOTE: Not all text editors include line numbers. If you do not see the following line numbers in
your text editor, this absence is not an indication of a problem.
Change the value for ShowTestFailoverDialog from false to true, ensuring the quotation marks
remain.
Restart the Dell vRanger Service for the configuration change to take effect.
icon.
When the Test Failover dialog box appears, select the preferred option:
Continue with networking on the replica disabled: When performing a test failover with
networking disabled, the replica VM is powered on with the network adapter disconnected. This
option protects the production environment, but eliminates the ability of testing your replica VM
as part of a larger environment.
Continue with networking on the replica enabled: When performing a network enabled test
failover, your replica VM is powered on with the network adaptor connected.
CAUTION: This option has the potential to impact your production environment; exercise caution
when using this option.
3
Click OK.
When testing is complete, select the Test Failover task in the Current Jobs node, and click Resume.
The network card is set to Connect at power on, which prepares the replica VM for failover.
158
Performing a failover
If the production site becomes unavailable, or you need to move the workload to the disaster recovery (DR)
site, you can perform a failover operation from the vRanger UI.
A failover operation consists of the following actions:
[Optional] Performing a final synchronization between sites. This action ensures that no data is lost
during a failover. If you do not want to synchronize changes in the event of a virus, perhaps or cannot
(if a hardware failure occurred), data changed since the last replication pass is lost.
Reverse the replication job, with the DR VM now acting as the source.
NOTE: The first replication pass after failing over sends the entire image, not just the changed
data.
To perform a failover:
1
When the Confirm Synchronization dialog box appears, select one of the following:
icon.
Yes: This option shuts down the production VM and perform a final synchronization to the DR site.
This option ensures that no data is lost, but also transfers any virus or corruption to the replica
VM. View the replication progress in the Running Tasks section of the vRanger UI.
NOTE: If you are using differential replication, this option causes vRanger to perform a
complete scan of the VM disks, as it does for every replication pass, but only changed data
is sent to the replica VM.
No: The production VM is turned off, but no changes are sent to the DR replica.
After the failover completes, the Destination of the original replication job is now the Source, and the
original Source is now the Destination. In other words, the job is now set to replicate from the DR site to
the Production site. This change is not reflected in the vRanger UI. Jobs that have been failed over are
indicated by a failover icon and tool-tip message.
5
If the production site is unavailable, or you do not want to replicate changes, disable the replication job.
Performing failback
When the production server has been returned to proper operation, you usually need to failback the replicated
VM to the production site. A failback is simply a failover back to the production site.
A failback operation involves the following events:
[Optional] Performing a final synchronization between sites. This action ensures that any data changed
on the DR VM is replicated back to the production site. If you do not synchronize changes, data changed
since the last replication pass is lost.
Reverse the replication job return to the jobs original configuration with the DR VM now acting as the
target.
159
If the job is enabled, replication continues, sending changes from the source production VM to the DR
target.
NOTE: The first replication pass after failing back re-scans the entire image to identify changed
blocks. Only changed data is sent.
To perform a failback:
1
When the Confirm Synchronization dialog box appear, select one of the following:
icon.
Yes: This option ensures that any data changed on the DR VM is replicated back to the production
site. If you do not want to synchronize, data changed since the last replication pass is lost. View
the replication progress in the Running Tasks section of the vRanger UI.
No: The DR VM turned off, but no changes are sent to the Production site.
After the failback completes, the direction of replication reverses again, this time returning to the
original configuration. The Failover icon is no longer shown.
160
8
Reports
As you create reports, the documents nest under the node of the relevant report type. When you create a
backup job, you can configure a report to display in the body of an email. The report indicates which jobs were
run, which succeeded, and which failed. You can also schedule a report to run, save it as a PDF, and send it as an
email attachment.
Report information is organized by VM and includes when backups, replicates and restores were run, who ran
them, and the status of each. You can create a report for results from one or multiple VMs. Reports can contain
customized metrics for example, date range (day, month), status (successful, failed, stopped). You can run
reports when you create them or you can schedule them to be generated later.
For information on the layout of the My Reports view, see My Reports view.
Select one of the nodes, and then click the Add icon on the View toolbar.
Dell vRanger 7.3 Users Guide
Reports
161
On the Report Filter page, enter the information as described in the following table.
Option
Description
Date Range
Machine/Source
Repository
Over the last: Enter the number in the first field and select Days or
Months from the drop-down list the default is 30 days.
Source: From this drop-down list, you can select All or any
individual source. All licensed, available sources are listed here.
Duration
In this section, you can enter a number in the Greater than or equal to __
minutes field. The value you enter restricts the report to include only jobs
that occurred within that time limit the default is 0.
Job Status
The check boxes available in this section refer to the status of any job that
you might include in reports. Available values are: Completed, Failed,
Aborted, and Cancelled.
NOTE: Because Jobs cannot fail (Tasks within Jobs can), searching for Job
Status - Failed yields no results. To generate a list of unsuccessful
activities, search for Task Status - Failed.
On the Column Selection page, customize your report by doing the following:
Under Selected Columns, select any column you do not want to include in the report, and then
click Clear Column to move it to the Available Columns field and remove it from the report.
Columns include the following:
Job Name
Source
Repository
Job Status
Machine Type
Start Time
End Time
Duration (minutes)
# Success
# Failed
# Canceled
# Aborted
To move all columns to the Available Columns field and select the columns you want to appear in
the report, click Clear All, select the column you want to include from the Available Columns
field, and then click Add Column.
162
On the Header and Footer Style Selection page, select the Body Style, Header Style, and Footer Style as
described in the following tables, and then click Next.
Body style
Font
Click the browse () button to open the Font dialog box; select your
preferred Font, Font style, Size, and Effects for the body of the report; and
then click OK.
NOTE: The default is Arial, 8, Regular.
To increase readability, select a color in which you want the even rows of
the report to appear by clicking the browse (), selecting a color, and
clicking OK.
To increase readability, select a color in which you want the odd rows of
the report to appear by clicking the browse (), selecting a color, and
clicking OK.
NOTE: For best readability, the color selected for the odd rows should be in
contrast with the color selected for the even rows.
Header style
Logo
Text
[Optional] Enter any text that you want displayed in the header.
Font
Click the browse () button to open the Font dialog box; select your
preferred Font, Font style, Size, and Effects for the report header; and
then click OK.
Show Time and Date in the Select this option if you want the header to include the current date and
report header
time.
Footer style
Logo
Text
[Optional] Enter any text that you want displayed in the footer.
Font
Click the browse () button to open the Font dialog box; select your
preferred Font, Font style, Size, and Effects for the report footer; and then
click OK.
NOTE: The footer refers to the status of any job that you might include in
reports. Available values are: Completed, Failed, Aborted, and Cancelled.
Show Time and Date in the Select this option if you want the footer to include the current date and
report header
time.
6
On the Recurrence Schedule Selection page, select a schedule for generating the report or make the
report available on demand using the options described in the following table, and then click Next.
Option
Description
This will be an On Demand If you select this option, no schedule for the report is set; it occurs on
job
demand. When the page appears, this option is selected by default and all
other options are disabled. Clearing this option enables the other options
and lets you schedule a report based on a specific time frame.
Start Time
163
Option
Description
Recurrence Pattern
In this section, you establish how often the report should be generated.
There are five options within this section:
Daily: The daily option can be scheduled to run the report every
weekday or every x number of days.
Interval: The interval option lets you select the number of days,
hours, and minutes that should pass between report jobs.
NOTE: The interval selected must be greater than or equal to five minutes.
Range of Recurrence
Select the start and end date for running the report.
If you scheduled a time for the report to recur, configure the email settings on the Report Publication
page described in the following table, and then click Next.
164
Option
Description
To
Use the browse button to select one or more email addresses from the
vRanger Address Book to whom you want to send the report.
NOTE: For more information about adding addresses to the Address Book,
see Setting up the SMTP server.
Subject
Enter the text you want to appear in the Subject line of the email that is
sent with the report.
Body
Enter the message you want to appear in the body of the email that is sent
with the report.
Send as
Select the format in which you want the report to appear. Options include
the following:
Excel
On the Report Summary page, verify that the information is correct, and then click Finish.
165
9
Integrating and monitoring vRanger
Monitoring vRanger
166
Single Stand-Alone External Tape Drive or a Single Internal Tape Drive in a Library. For example, Dell
PowerVault LTO standalone and library-based tape devices are ideal for this solution.
Location to store the vRanger repository, accessible by both vRanger and NetVault Backup.
NetVault Backup installed and properly configured with a tape device or library.
Supported devices
Most existing tape libraries and tape formats are supported by NetVault Backup, including stand-alone and
library-based tape devices in SAN or shared-SCSI environments. In addition to the line of approved Dell
PowerVault tape devices, visit our Supported Devices page for a complete list of supported devices.
167
Windows PowerShell PowerShell and vRanger must always be installed on the same server.
A PowerShell script that finds and starts the vRanger on-demand job.
A .bat file designed to start the PowerShell script from NetVault Backup Server.
NOTE: When installing vRanger and NetVault Backup on the same server, do not install the Dell NetVault
Backup Plug-in for VMware.
Server 2-vRanger/PowerShell:
NetVault Backup agent that can run a PRE command script. The agent runs the PowerShell script
contained in a .bat file called by using the PRE command option.
A local repository on the vRanger server, and shared by vRanger and NetVault Backup.
Windows PowerShell.
A PowerShell script that finds and starts the vRanger on-demand job.
To prepare your environment for vRanger Sweep-to-Tape using NetVault Backup as described in Scenario 1,
complete the following tasks:
Click Start > All Programs > Dell > vRanger Backup & Replication > vRanger Console.
This step opens a PowerShell console ready to accept commands. You should expect to see an error
message, which can be remedied by enabling remote scripts.
168
Extract the contents of the zip file to the following folder on your NetVault Backup Server:
C:\Program Files (x86)\Dell\NetVault Backup\scripts
NetVault Backup only runs scripts located in this folder.
Click Start > All Programs > Dell > vRanger Backup & Replication > vRanger Backup & Replication.
Right-click your preferred target, select Add, and then click the type of storage you want to add.
Enter a name for the repository, and then provide the required information and credentials to let
vRanger to create and access the repository on this target.
Click OK.
vRanger immediately attempts to validate the connection.
In the navigation pane on the left, select My Inventory, and then locate the machine or machines you
want to include in the backup.
Right-click the computer name, and select Backup <machine name> on the context menu.
Dell vRanger 7.3 Users Guide
Integrating and monitoring vRanger
169
Under Job Name, give the job a name that ends in -Tape; for example, vRanger-Sweep-to-Tape, and then
click Next.
NOTE: The provided script is designed to automatically start any vRanger job where the job name
ends with -Tape. Use this naming convention to enable Sweep-to-Tape.
On the Virtual Machine Hard Disk Inclusion page, select the disks in the machine to include in the
backup job, and then click Next.
On the repository Selection page, select the target repository created in Creating a sweep-to-tape
vRanger repository, and then click Next.
If the vRanger Transport Selection page appears, select whether to use Automatic transport or to
customize the transport method, and then click Next.
vRanger Transport determines how backup data is sent and where the restore processing activity occurs.
The default transport method is Automatic; however, if the server you are backing up is a VMware VM,
you can customize the method as appropriate on the Transport Selection page.
On the Options Selection page, select your preferred backup options, and then click Next.
On the Retention Policy Selection page, determine how many savepoints to keep, and whether to
capture Full, Incremental, or Differential backups; click Next.
NOTE: Selecting more savepoints provides additional points-in-time to which you can recover the
machine. For more information, see Understanding retention policies and space-saving
technologies.
On the Recurrence Schedule Selection page, select This will be an on demand job, and click Next.
On-demand jobs are scheduled tasks that are not set to start from a recurring schedule. Because a
sweep-to-tape backup job is initiated by script from the NetVault Backup task, you must this job on
demand. Doing so saves the job settings but lets the NetVault Backup integration start the job ondemand.
10 On the Email Notifications Selection page, specify who to notify when the job has finished running by
entering one or more names and email addresses to be notified, and click Next.
11 On the Summary page, review the Summary window to make sure that your configuration is correct, and
then do the following:
Leave the option to Run the job after Finish is clicked cleared.
Click Finish to save the job and close the Backup Wizard.
12 To view or access the job, click My Jobs in the left-pane, and then select On Demand jobs under My
Jobs.
Ensure that NetVault Backup is properly installed, and your tape drive or library is installed and visible to
NetVault Backup.
Start the NetVault Backup WebUI, and click Create Backup Job.
In Job Name, specify a name for the job; for example, vRanger_Sweep_to_Tape.
Assign a descriptive name that lets you easily identify the job when monitoring its progress or restoring
data. The job name can contain alphanumeric and non-alphanumeric characters, but it cannot contain
Dell vRanger 7.3 Users Guide
Integrating and monitoring vRanger
170
In the Selections list, click Create New, select the preferred NetVault Backup machine from the list of
servers, and then double-click it to see a list of identified source devices for this server.
Navigate to the vRanger repository, and select the files and folders to include in the archive.
NOTE: NetVault Backup supports a wide array of sources from which to capture data, including
NAS, CIFS, RAW devices, and local devices.
In the Plugin Options list, select an existing Backup Options Set, or click Create New, and configure the
options that you want to use.
In the Schedule list, select an existing Schedule Set, or click Create New, and configure the schedule
type and schedule method.
NetVault Backup provides scheduling options such as immediate, one-time, and triggered.
In the Target Storage list, click Create New, and then do the following:
a
Select the preferred device in the list to tell NetVault Backup to use this device in the backup.
NOTE: Selecting multiple devices lets NetVault Backup use additional devices as required.
Select the preferred device in the list to tell NetVault Backup to use this device in the backup.
Click Set to save the settings and close the dialog box.
On the Create Target Set page, click Media Options, and configure the settings to set specific policies to
target specific media, label blank media, or specify whether to reuse media with existing data.
10 Next to the Advanced Options list, Create New, and configure the options that you want to use.
You can select options to customize the backup process; for example, how long to maintain the archive,
encryption, and deduplication options; network compression. In this example most of the options remain
with their defaults, except for a Pre Script that runs the vRanger On Demand backup.
11 On the Advanced Options page, click Pre & Post Scripts, and select Pre Script, and then enter the
following in the entry field:
vranger_sweep.bat
This process initiates the vRanger backup and waits for the job to complete. After the job is finished,
NetVault Backup continues and archives the vRanger repository to tape.
12 To submit the job for scheduling, click Save & Submit.
You can monitor the job progress from the Job Status page and view the logs from the View Logs page.
NOTE: A job that uses the Schedule type of Triggered is only scheduled when you run the script.
This job runs the backup script, which in turn communicates with vRanger and starts the
Backup_and_Sweep-Tape job. You can switch back to vRanger to watch the job start and run. After
vRanger has finished, NetVault Backup completes the job by capturing the updated repository to tape.
171
Select the saveset that you want to restore, and click Next.
NOTE: If the backup index of the selected saveset is offline, the Confirm load dialog box is
displayed. Click OK to load the index from the backup media, and then in the Load Index dialog
box, type or select the number of days you want to store the index in the NetVault Database.
On the Create Selection Set page, select the archive, for example, vRanger_Sweep_to_Tape, that you
want to restore, and click Next.
This step restores the entire vRanger repository.
CAUTION: It is important that you restore to a new repository and not to an existing repository.
Failure to do so can possibly result in corruption of data.
On the Create Restore Job page, specify a name for the job.
Assign a descriptive name that lets you easily identify the job when monitoring its progress or restoring
data. The job name can contain alphanumeric and non-alphanumeric characters, but it cannot contain
non-Latin characters. There is no length restriction; however, a maximum of 40 characters is
recommended.
In the Target Client list, location to restore the file set from the list of available machines.
In the Schedule list, use the default, Immediate, to run the job when it is submitted.
In the Source Options list, select the media from which to restore the archive.
Select the vRanger repository that contains the backup of the VM; for example, Repo-001.
vRanger provides options to restore the complete VM, or individual files or folders.
A list of protected VMs display.
Select the VM containing the data to restore, and then click File Level Restore in the top menu to start
the process.
A file structure view of the selected VM appears.
Locate and select the files and folders to restore to the selected machine.
On the right side of the window, select the target location; for example, Desktop.
Click Restore to start the recovery, which extracts the files from the vRanger repository for immediate
access.
After recovery is complete, you have access to the newly restored files.
172
Monitoring vRanger
vRanger can be configured to log events to the Windows Event Viewer on the vRanger machine. These events
can be filtered and monitored using the Microsoft System Center Operations Manager to monitor replication
functions in line with other IT operations. When monitoring is enabled, vRanger creates a vRanger Service node
on the local Event Viewer.
The events currently monitored and logged by vRanger include:
173
Make the required changes carefully, using the following information as guidance.
Change the value false to true, ensuring the quotation marks remain.
174
To configure VA monitoring:
1
VirtualApplianceMonitorSecondaryIntervalInHours
This value determines how often the refresher message occurs for a failed VA check after the
FailureLogMax value has been reached. The default is 6, which indicates that it logs an event
every six hours.
VirtualAppliancesConnectionCheckIntervalInMinutes
This setting determines how often vRanger checks the connection to configured VAs. The default
is 5, which indicates that it checks the connection every five minutes.
175
Find the Dell vRanger Service. Right-click the service, and click restart.
176
10
Using the vRanger Console
Click Start > All Programs > Dell > vRanger Backup & Replication > vRanger Console.
When opening the vRanger Console for the first time, you see an error message stating that the
execution of scripts is disabled on your system. This issue is due to the default PowerShell execution
policy, which must be enabled.
When the prompt re-appears, close and re-open the vRanger Console.
When the vRanger Console restarts, you should see a screen with a blue background and a list of vAPI
cmdlets.
The vRanger vAPI is now configured and ready for use.
177
Inventory management
Add-DdbRepository
Get-VirtualApplianceConfig
Add-PhysicalMachine
Get-VirtualApplianceDeploymentStatus
Add-VirtualAppforLinuxFLR
Get-VirtualApplianceReconfigStatus
Add-VirtualAppforLinuxFLRVA
Get-VirtualMachinesUnderInventory
Add-VirtualCenter
Remove-VirtualAppliance
Get-Datastore
Remove-VirtualApplianceConfiguration
Get-InventoryEntities
Update-HypervRestoreJobTemplate
Get-IsInventoryRefreshing
Update-VirtualAppliance
Update-VirtualApplianceConfiguration
Configuration
Dismount-LinuxVolume
New-TransportConfiguration
Get-MonitorLog
New-VirtualAppliance
Get-VirtualApplianceConfig
Remove-AllMount
Get-VmDisk
Remove-LinuxVolume
Get-VMDKVolume
Set-CBTonVM
Install-VirtualAppliance
Set-LinuxVolume
Mount-LinuxVolume
Set-MountPath
New-EmailAddress
Set-Resources
New-SMTPServer
Job management
Disable-Job
New-IntervalSchedule
Enable-Job
New-MonthlySchedule
Get-AddressBook
New-WeeklySchedule
Get-ConfigOption
New-YearlySchedule
Get-Connection
Remove-JobTemplate
Get-CurrentTemplateVersionID
Remove-VirtualApplianceConfiguration
Get-Job
Set-Cataloging
Get-JobTemplate
Stop-vRangerJob
New-Daily Schedule
178
Repositories
Add-CIFSRepository
Get-RepositoryJob
Add-DdbRepository
Get-RepositorySavePoint
Add-FTPRepository
Get-Savepoints
Add-HypervCluster
Remove-Repository
Add-NVSDRepository
Remove-SavePoint
Add-SFTPRepository
Remove-DdbStorageUnit
Get-PhysicalMachineDiskMap
Backup
Add-BackupGroupEntity
New-BackupGroupMember
Add-BackupJobTemplate
Remove-BackupGroupEntity
Get-BackupGroupEntity
Remove-BackupGroupMember
New-BackupFlag
Update-BackupJobTemplate
Restore
Add-RestoreFromManifestJobTemplate
Get-SavepointManifest
Add-RestoreJobTemplate
New-RestoreFlag
Get-CatalogSearchData
Remove-Catalog
Get-CatalogStatus
Update-RestoreJobTemplate
Get-RestoreDiskMap
Replication
Add-PhysicalMachine
Run-ReplicationFailover
Get-GlobalTransportFailover
Run-ResumeReplicationFailover
Get-MonitorLog
Run-TestReplicationFailover
Get-TransportFailover
Update-GlobalTransportFailover
New-ReplicationFlag
Update-ReplicationJobTemplate
179
Cmdlet help
To get help on any of the vAPI cmdlets, use the Get-Help command. At the prompt, enter Get-Help command,
where command is any of the preceding vAPI cmdlets.
For example, enter Get-Help Add-SFTP Repository and the following is displayed:
Description The Add-SftpRepository cmdlet adds an SFTP repository to vRanger. The
repository can be later used to store backup files from backup jobs.
Syntax Add-SftpRepository [-Server] <string> [[-Port] [<int>]]
[[-TargetDirectory][<string>]] [-User] <string> [-Password] <string> [[-TimeOut]
[<short>]] [-Name] <string> [[-Description] [<string>]] [[-Overwrite]
[<Boolean>]][<CommonParameters>]
NOTE: Windows PowerShell and vAPI commands are not case-sensitive. vAPI cmdlets are shown
capitalized only to make them easier to read.
For more information, you may use the -detailed or -full parameters. For example:
Get-Help Add-SFTPRepository -Detailed or Get-Help Add-SFTP Repository - Full.
180
A
vAPI Cmdlet details
IMPORTANT: For the most up-to-date help contents, see the cmdlet help. To get help on any of the vAPI
cmdlets, use the Get-Help command. At the prompt, enter:
Add-BackupGroupEntity
Description
Syntax
Parameters
Type [-Type]: This optional parameter specifies the type of backup group:
VMware, HyperV, or Physical. If not specified, the default is VMware.
Examples
Related links
Remove-BackupGroupEntity
New-BackupGroupMember
Remove-BackupGroupMember
Get-BackupGroupEntity
181
Add-BackupJobTemplate
Description
Adds a backup job. You also have the option of running the job immediately after the
template is created.
Syntax
182
Parameters
Examples
Related links
Add-RestoreJobTemplate
Add-PhysicalMachine
Update-BackupJobTemplate
Get-Job
Get-JobTemplate
Add-CIFSRepository
Description
Adds a CIFS repository to vRanger. The repository can be later used to store backup files
from backup jobs.
Syntax
183
Parameters
Examples
Related links
Get-PhysicalMachineDiskMap
Add-DdbRepository
Add-HypervCluster
Add-NVSDRepository
Add-SFTPRepository
Add-FTPRepository
Add-DdbReplicationRepository
Description
Adds an EMC Data Domain Boost (DD Boost) replication repository to vRanger.
Syntax
Parameters
184
Examples
Related links
Get-Repository
Add-DdbRepository
Add-DdbRepository
Description
Adds an EMC Data Domain Boost (DDB) repository to vRanger. The repository can be later
used to store backup files from backup jobs.
Syntax
Parameters
Examples
Server <String>: The EMC Data Domain Boost (DD Boost) server FQDN or IP.
Related links
Get-PhysicalMachineDiskMap
Add-CIFSRepository
Add-HypervCluster
Add-NVSDRepository
Add-SFTPRepository
Add-FTPRepository
185
Add-EsxHost
Description
Syntax
Parameters
Examples
Related links
Add-VirtualCenter
Get-InventoryEntities
Add-FTPRepository
Description
Adds an FTP repository to vRanger. The repository can be later used to store backup files
from backup jobs.
Syntax
186
Parameters
Examples
Related links
Get-PhysicalMachineDiskMap
Add-CIFSRepository
Add-HypervCluster
Add-NVSDRepository
Add-SFTPRepository
Add-HypervCluster
Description
Syntax
Parameters
Examples
Related links
Add-BackupJobTemplate
Get-InventoryEntities
Dell vRanger 7.3 Users Guide
vAPI Cmdlet details
187
Add-HypervHost
Description
Syntax
Parameters
Examples
Related links
Add-BackupJobTemplate
Get-InventoryEntities
Add-HypervRestoreJobTemplate
Description
Adds a Hyper-V restore job template. Users also have the option of running the job
immediately after the template is created.
Syntax
188
Parameters
JobSchedule [<Schedule>]: Schedule on which the job runs. If not set, the job
runs on demand.
Flags [<RestoreFlags>]: Restore flags. If not set, the job has no flags.
RunJobNow [<Boolean>]: Whether to run the job now. If not set, the job does
not run immediately after creation of the template.
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
SkipDisks [<List`1>]: Sequence number base 0 of the disks to skip from the
savepoint. Separate multiple numbers with commas.
189
Examples
Related links
Add-BackupJobTemplate
Add-RdaRepository
Update-RestoreJobTemplate
Get-Job
Get-JobTemplate
190
Add-NFSRepository
.
Description
Adds a Network File Share repository to vRanger. The repository can be later used to
store backup files from backup jobs.
Syntax
Parameters
Examples
Related links
Get-PhysicalMachineDiskMap
Add-DdbRepository
Add-NVSDRepository
Add-CIFSRepository
Add-SFTPRepository
Add-FTPRepository
191
Add-NVSDRepository
Description
Adds a Dell NetVault SmartDisk repository to vRanger. The repository can be later used to
store backup files from backup jobs.
Syntax
Parameters
Examples
Related links
Get-PhysicalMachineDiskMap
Add-DdbRepository
Add-HypervCluster
Add-CIFSRepository
Add-SFTPRepository
Add-FTPRepository
Add-PhysicalMachine
Description
Syntax
192
Parameters
Examples
Related links
Add-BackupGroupEntity
Get-InventoryEntities
Add-RdaRepository
Description
Adds an RDA repository to vRanger. The repository can be later used to store backup files
from backup jobs.
Syntax
Parameters
Examples
Related links
Get-Repository
Add-DdbRepository
Add-CIFSRepository
Add-SFTPRepository
Add-FTPRepository
Add-NVSDRepository
193
Add-ReplicationJobTemplate
Description
Adds a replication job template. You also have the option of running the job immediately
after the template is created.
Syntax
Parameters
Type <String>: Replication type. Valid types are Differential and Hybrid.
NotificationList [<String>]: Email notification list for the job. Separate multiple
email addresses with commas.
RunJobNow [<Boolean>]: Whether to run the job immediately after the job
template is created.
IncludedDisk [<String>]: List of disks to include in this job. All VM disks are
replicated if none is specified.
194
Examples
Related links
Add-BackupJobTemplate
Add-RestoreJobTemplate
Update-ReplicationJobTemplate
Get-Job
Get-JobTemplate
Add-RestoreFromManifestJobTemplate
Description
Adds a restore job template from a manifest file. The manifest file can be a vRanger
manifest file or a Legacy vRanger manifest file. You also have the option of running the
job immediately after the template is created.
Syntax
195
Parameters
JobSchedule [<Schedule>]: Schedule on which the job runs. If not set, the job
runs on demand.
Flags [<RestoreFlags>]: Restore flags. If not set, the job has no flags.
RunJobNow [<Boolean>]: Whether to run the job now. If not set, the job does
not run immediately after creation of the template.
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
SkipDisks [<String>]: Sequence number base 0 of the disks to skip from the
savepoint. Disks in savepoint are order by their SCSI controller number and disk
number. Separate multiple numbers with commas.
196
Examples
197
Examples
(continued)
Related links
Add-RestoreJobTemplate
Add-RestoreJobTemplate
Description
Adds a restore job template. You also have the option of running the job immediately
after the template is created.
Syntax
198
Parameters
JobSchedule [<Schedule>]: Schedule on which the job should run. If not set, the
job runs on demand.
Flags [<RestoreFlags>]: Restore flags. If not set, NoFlag. Restore flags: NoFlags,
AllFlags, ForceOverwrite, ForcePowerOn. Separate multiple flags with pipes (|).
NotificationList [<String>]: Email notification list for the job. Separate multiple
email addresses with commas.
RunJobNow [<Boolean>]: Whether to run the job now. If not set, the job does
not run immediately after creation of the template.
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
SkipDisks [<String>]: Sequence number base 0 of the disks to skip from the
savepoint. Disks in savepoint are order by their SCSI controller number and disk
number. Separate multiple numbers with commas.
199
Examples
200
Examples
(continued)
Related links
Add-BackupJobTemplate
Add-PhysicalMachine
Update-RestoreJobTemplate
Get-Job
Get-JobTemplate
201
Add-SFTPRepository
Description
Adds an SFTP repository to vRanger. The repository can be later used to store backup
files from backup jobs.
Syntax
202
Parameters
Examples
Related links
Get-PhysicalMachineDiskMap
Add-DdbRepository
Add-CIFSRepository
Add-HypervCluster
Add-NVSDRepository
Add-FTPRepository
Add-VirtualAppforLinuxFLR
Description
Related links
Add-VirtualAppforLinuxFLRVA
Add-VirtualAppforLinuxFLRVA
Description
Syntax
Parameters
Examples
Related links
None
Dell vRanger 7.3 Users Guide
vAPI Cmdlet details
203
Add-VirtualCenter
Description
Syntax
Parameters
Examples
Related links
Add-DdbRepository
Get-InventoryEntities
Disable-Job
Description
Syntax
Parameters
Examples
JobTemplateIDs <GUID[]>: Job template IDs for which to enable jobs. Disable
multiple jobs by passing in comma-separated job template IDs.
Related links
Enable-Job
Remove-VirtualApplianceConfiguration
Get-JobTemplate
Remove-JobTemplate
Dismount-LinuxVolume
Description
Syntax
Dismount-LinuxVolume [<CommonParameters>]
Dell vRanger 7.3 Users Guide
vAPI Cmdlet details
204
Parameters
Examples
Dismount-LinuxVolume
Related links
Mount-LinuxVolume
Enable-Job
Description
Syntax
Parameters
Examples
Related links
Disable-Job
Remove-VirtualApplianceConfiguration
Get-JobTemplate
Remove-JobTemplate
Get-AddressBook
Description
Syntax
Get-Addressbook [<CommonParameters>]
Parameters
Examples
Get-Addressbook
Related links
New-EmailAddress
Get-BackupGroupEntity
Description
Syntax
Get-BackupGroupEntity [<CommonParameters>]
205
Parameters
Examples
--------------------EXAMPLE 1-------------------Get-BackupGroupEntity
This command gets a list of all backup group entities.
--------------------EXAMPLE 2-------------------Get-BackupGroupEntity | where{$_.Name -eq 'BackupGroupName'}
This command gets a list of backup groups by name.
Related links
None
Get-CatalogSearchData
Description
Returns the list of results for the matched search string, repositories, and VMs.
Syntax
Parameters
Examples
VMList [<Entity[]>]: Filter by entities. If not specified, all entities are searched.
Related links
Remove-Catalog
Get-CatalogStatus
Set-Cataloging
Get-CatalogStatus
Description
Syntax
206
Parameters
Examples
Related links
Get-CatalogSearchData
Remove-Catalog
Set-Cataloging
Get-ConfigOption
Description
Syntax
Parameters
Type <String>: Valid types are Database, Email, Resources, Timeout, General,
LinuxFLR, and Cataloging.
Examples
Related links
Set-Resources
Set-Cataloging
Add-VirtualAppforLinuxFLR
Get-Connection
Description
Syntax
Parameters
Name [<String>]: The name or IP address of the VMware ESXi host, VMware
vCenter, Hyper-V host, or Hyper-V cluster.
207
Examples
Related links
None
Get-CurrentTemplateVersionID
Description
Returns the current template version ID of a job template based on a historic template
version ID. A new template version ID is assigned to the job template when it is modified.
Syntax
Parameters
Examples
Get-CurrentTemplateVersionID 6baedeed-227a-4350-ba3f-470f9e90dc07
This command returns the current template version ID of the job template referenced by
the input template version ID.
Related links
Get-Job
Get-JobTemplate
Get-Datastore
Description
Syntax
Parameters
Examples
Related links
Get-MonitorLog
208
Get-GlobalTransportFailover
Description
Syntax
Get-GlobalTransportFailover [<CommonParameters>]
Parameters
Examples
Get-GlobalTransportFailover
Related links
Update-GlobalTransportFailover
This command gets the default Transport Failover order for replication jobs.
Get-TransportFailover
Get-InventoryEntities
Description
Returns a list of inventory entities based on the input repository type. The command
returns all inventory entities if no type is provided. You can also get inventory entities by
type. There is a performance delay if all types are requested or no type is specified.
Syntax
Parameters
Examples
Block [<Boolean>]: If set to true, the call blocks if inventory is being refreshed
until it is done. Possible timeout might occur on large inventory sets.
Thin [<Boolean>]: If set to true, the call returns thin inventory objects.
Related links
None
209
Get-IsInventoryRefreshing
Description
Returns true or false based on whether the inventory is refreshing at the time the
cmdlet is run.
Syntax
Parameters
Examples
Related links
None
Get-Job
Description
Returns jobs. Without parameters, Get-Job returns all past and current jobs. You can also
get jobs by JobState within a time span or JobTemplateIDs. If JobTemplateIDs are
specified, no other parameters can be used.
Syntax
Parameters
JobTemplateIDs [<String>]: Job template IDs for which to retrieve jobs. Separate
multiple IDs with commas.
210
Examples
--------------------EXAMPLE 1-------------------Get-Job
This command returns jobs in all states.
--------------------EXAMPLE 2-------------------Get-Job -JobState Running
This command returns all running jobs.
--------------------EXAMPLE 3-------------------Get-Job -starttime 2009-03-30 -endtime 2009-03-31 -JobState
Completed
This command returns completed jobs that started during the specified time span.
--------------------EXAMPLE 4-------------------Get-Job -JobTemplateIDs d7ebc5c4-7916-44c4-a0c22412999735f3,d7ebc5c4-7916-44c4-a0c2-2412990005f3
This command returns jobs based on the specified template ID.
Related links
Get-JobTemplate
Get-JobTemplate
Description
Returns a list of all jobs, on demand and scheduled (job templates). Without parameters,
the command returns all job templates. You can also get job templates by Type or
Inventory IDs.
Syntax
Parameters
Type [<String>]: Specifies the type of job template to retrieve: Backup, Restore,
or All.
211
Examples
--------------------EXAMPLE 1-------------------Get-JobTemplate
This command gets a list of all job templates.
--------------------EXAMPLE 2-------------------Get-JobTemplate -type Backup
This command gets a list of all backup jobs.
--------------------EXAMPLE 3-------------------Get-JobTemplate -InventoryIds d7ebc5c4-7916-44c4-a0c22412999735f3,d7ebc5c4-7916-44c4-a0c2-24
12990005f3 -Type Backup
This command returns backup job templates in the specified inventories.
Related links
Get-Job
Get-MonitorLog
Description
Syntax
Parameters
Examples
Related links
None
Get-Network
Description
Syntax
Parameters
Examples
Related links
Get-Datastore
212
Get-PhysicalMachineDiskMap
Description
Syntax
Parameters
Examples
Related links
Get-InventoryEntities
Add-RestoreJobTemplate
Get-Repository
Description
Syntax
Parameters
Examples
Type <String>: Specifies the type of repository to retrieve: CIFS, SFTP, FTP, NFS,
NVSD, DDB, or ALL.
--------------------EXAMPLE 1-------------------Get-Repository
This command gets a list of all vRanger repositories.
--------------------EXAMPLE 2-------------------Get-Repository -id 034538e5-58a7-4d28-89c9-3249b620064a
This command a repository with the specified ID.
--------------------EXAMPLE 3-------------------Get-Repository -type CIFS
This command gets a list of all CIFS repositories.
Related links
Add-CIFSRepository
Add-DdbRepository
Add-FTPRepository
Add-HypervCluster
Add-SFTPRepository
Remove-Repository
213
Get-RepositoryJob
Description
Syntax
Parameters
Examples
Related links
Get-Job
Get-JobTemplate
Get-RepositorySavePoint
Description
Returns a list of savepoints in the repository. All savepoints in the repository are returned
if no time parameter is specified.
Syntax
Parameters
Examples
StartTime [<String>]: Start time of timespan during which the savepoints are
complete.
EndTime [<String>]: End time of timespan during which the savepoints are
completed.
Related links
None
Get-RestoreDiskMap
Description
Creates a Hashtable that represents a matching of file map entries from the savepoint
with the disks from a physical machine a RestoreDiskMap.
Syntax
Parameters
ManifestFile <ManifestFile>: The manifest from the savepoint that contains file
map entries for the disks backed up.
214
Examples
Related links
Add-BackupJobTemplate
Get-InventoryEntities
Get-SavepointDisk
Description
Syntax
Parameters
Examples
Get-SavePointDisk 91d27db5-4562-4456-918d-b0dc587e0e7f
This command returns all disks that have been backed up into the savepoint specified.
Related links
Get-VMDKVolume
Get-SavepointManifest
Description
Syntax
Parameters
Examples
Get-SavePointManifest $id
This command returns the savepoint manifest object.
Related links
Get-RepositorySavePoint
Get-VMDKVolume
Get-Savepoints
Description
Syntax
Parameters
215
Examples
Related links
Get-Job
Get-JobTemplate
Get-TransportFailover
Description
Gets the Transport Failover order for replication jobs by TemplateVersion ID.
Syntax
Parameters
Examples
Related links
Get-GlobalTransportFailover
Update-GlobalTransportFailover
Get-VirtualApplianceConfig
Description
Syntax
Parameters
216
Examples
Related links
New-VirtualAppliance
Update-VirtualAppliance
Remove-VirtualAppliance
Get-VirtualApplianceDeploymentStatus
Description
Syntax
Parameters
Examples
Related links
Update-VirtualAppliance
New-VirtualAppliance
Get-VirtualApplianceReconfigStatus
Description
Syntax
Parameters
Examples
Related links
Update-VirtualAppliance
New-VirtualAppliance
217
Get-VirtualMachinesUnderInventory
Description
Gets the child VM entities of the entity host, cluster, and so on provided.
Syntax
Get-VirtualMachinesUnderInventory [[-InventoryEntityMoRefId]
[<String>]] [<CommonParameters>]
Parameters
Examples
Thin [<Boolean>]: If set to true, the call returns thin inventory objects.
Get-VirtualMachinesUnderInventoryEntity -InventoryEntityMoRefId
host-16641
The managed object reference ID of an inventory entity node such as a VMware ESXi
host or resource folder.
Related links
Add-BackupGroupEntity
Get-BackupGroupEntity
Get-InventoryEntities
Get-VmDisk
Description
Returns a list of VmDisks for the VM list in the same order of the input.
Syntax
Parameters
Examples
Related links
None
This command gets a list of VMDisks objects for the input VM list.
Get-VMDKVolume
Description
Syntax
Parameters
218
Examples
Related links
None
Install-VirtualAppliance
Description
Syntax
219
Parameters
NewPassword [<String>]: New password for the VA; if this word is not
mentioned, Original password (vzroot1) is used.
NetMask [<String>]: Netmask for use with the VAs static IP address. Required if
UseDHCP is false.
StaticIP [<String>]: Static IP Address for the VA. Required if UseStaticIP is true.
Domain [<String>]: Optional Local domain name for DNS resolver on VA. For more
information, see the Linux manual (man) page for resolv.conf.
Search [<String>]: Optional Search list for host name lookup for DNS on VA. For
more information, see the Linux man page for resolv.conf.
220
Examples
Related links
Get-VirtualApplianceConfig
Remove-VirtualAppliance
Update-VirtualAppliance
Mount-LinuxVolume
Description
Syntax
Parameters
Examples
Related links
Dismount-LinuxVolume
New-BackupFlag
Description
Syntax
221
Parameters
Examples
AllFlags [<Boolean>]: Whether to use all available flags for the backup.
--------------------EXAMPLE 1-------------------New-BackupFlag
This command returns a new BackupFlags object with the value of NoFlags.
--------------------EXAMPLE 2-------------------New-BackupFlag -EnableGuestQuiescing 1 -EnableABM 1
This command returns a new BackupFlags object with the values of
EnableGuestQuiescing and EnableABM.
--------------------EXAMPLE 3-------------------New-BackupFlag -AllFlags 1
This command returns a new BackupFlags object with all flags set to on.
Related links
Add-BackupJobTemplate
New-BackupGroupMember
Description
Adds members to a backup group created using Add-BackupGroupEntity cmdlet or UI. You
can add any inventory item as a member.
Syntax
Parameters
222
Examples
Related links
None
New-Daily Schedule
Description
Returns a Schedule object. The schedule provides a template daily schedule that can be
further customized before use.
Syntax
Parameters
Examples
Related links
None
This command returns a daily job schedule that runs weekdays at midnight.
New-EmailAddress
Description
Syntax
Parameters
Examples
Related links
Get-AddressBook
New-IntervalSchedule
Description
Syntax
223
Parameters
Examples
IntervalDays <Int>: Number of days to use for interval schedule the default is 0.
IntervalHours <Int>: Number of hours to use for interval schedule the default is
0.
Related links
New-Daily Schedule
New-WeeklySchedule
New-MonthlySchedule
New-YearlySchedule
New-MonthlySchedule
Description
Returns a Schedule object. The schedule provides a template monthly schedule that can
be further customized before use.
Syntax
Parameters
Examples
Related links
New-Daily Schedule
New-WeeklySchedule
New-YearlySchedule
New-IntervalSchedule
Dell vRanger 7.3 Users Guide
vAPI Cmdlet details
224
New-ReplicationFlag
Description
Helps you create a ReplicationFlags Enum object. Without parameters, the command
returns NoFlags. You can pass in boolean parameters to specify which flags you want on.
Syntax
Parameters
Examples
AllFlags [<Boolean>]: Whether to use all available flags for the replication.
--------------------EXAMPLE 1-------------------NewReplicationFlag
This command returns a new ReplicationFlags object with the value of NoFlags.
--------------------EXAMPLE 2-------------------New-ReplicationFlag -EnableGuestQuiescing 1 -EnableABM 1
This command returns a new ReplicationFlags object with the values of
EnableGuestQuiescing and EnableABM.
--------------------EXAMPLE 3-------------------New-ReplicationFlag -AllFlags 1
This command returns a new ReplicationFlags object with all flags set to on.
Related links
Add-PhysicalMachine
New-RestoreFlag
Description
Helps you create a RestoreFlags Enum object. Without parameters, the command returns
NoFlags. You can pass in boolean parameters to specify which flags you want on.
Syntax
225
Parameters
Examples
AllFlags [<Boolean>]: Whether to use all available flags for the restore.
--------------------EXAMPLE 1-------------------New-RestoreFlag
This command runs RestoreFlags with the value of NoFlags.
--------------------EXAMPLE 2-------------------New-RestoreFlag -ForcePowerOn 1 -UseCompression 0
This command runs RestoreFlags with the values of ForcePowerOn.
--------------------EXAMPLE 3-------------------New-RestoreFlag -AllFlags 1
This command runs RestoreFlags with all flags set to on.
Related links
None
New-SMTPServer
Description
Syntax
Parameters
Examples
Related links
None
226
New-TransportConfiguration
Description
Syntax
Parameters
Examples
RunLocal <Boolean>: Whether to run the job on the local machine vs the VA.
Related links
Add-BackupJobTemplate
Add-RestoreJobTemplate
New-VirtualAppliance
Description
Syntax
Parameters
227
Examples
Related links
Update-VirtualAppliance
Remove-VirtualAppliance
Get-VirtualApplianceConfig
New-WeeklySchedule
Description
Returns a Schedule object. The schedule provides a template weekly schedule that can
be further customized before use.
Syntax
Parameters
Examples
ExecutionDays <String>: Days of the week on which the job runs: Monday,
Tuesday, and so on. Separate multiple days with commas.
Related links
None
New-YearlySchedule
Description
Returns a Schedule object. The schedule provides a template yearly schedule that can be
further customized before use.
Syntax
Parameters
228
Examples
Related links
None
Remove-AllMount
Description
Removes all previously mounted paths. This operation should be performed as a cleanup
step after all needed content is retrieved from the mounted path.
Syntax
Remove-Allmount [<CommonParameters>]
Parameters
Examples
Remove-AllMount
This command removes all mounted paths.
Related links
None
Remove-BackupGroupEntity
Description
Syntax
Parameters
Examples
Related links
None
Remove-BackupGroupMember
Description
Syntax
Parameters
229
Examples
Related links
None
Remove-Catalog
Description
Deletes the catalog data from the database for a list of savepoints.
Syntax
Parameters
Examples
Related links
Get-CatalogSearchData
Get-CatalogStatus
Set-Cataloging
Remove-DdbStorageUnit
Description
Removes the EMC Data Domain Boost (DD Boost) repository from vRanger and deletes
all savepoints in the repository from the disk. The storage unit is also removed from the
DD Boost device.
Syntax
Parameters
Examples
Related links
Remove-Repository
Remove-JobTemplate
Description
Syntax
230
Parameters
Examples
Related links
Add-BackupGroupEntity
Add-RestoreJobTemplate
Get-JobTemplate
Remove-LinuxVolume
Description
Related links
Dismount-LinuxVolume
Remove-Repository
Description
Removes a repository from vRanger. Optionally, all savepoints in the repository can be
deleted from the disk.
Syntax
Parameters
Examples
Related links
Add-CIFSRepository
Add-SFTPRepository
Add-FTPRepository
Add-HypervCluster
Add-NVSDRepository
Get-PhysicalMachineDiskMap
231
Remove-SavePoint
Description
Removes savepoints. If any of the specified savepoints has descendant savepoints, those
savepoints are also removed.
Syntax
Parameters
Examples
Related links
Get-RepositorySavePoint
Remove-Repository
Remove-VirtualAppliance
Description
Syntax
Parameters
Examples
Related links
New-VirtualAppliance
Update-VirtualAppliance
Get-VirtualApplianceConfig
Remove-VirtualApplianceConfiguration
Description
Removes the VA configuration from vRanger with an option to delete the VA from host.
Syntax
Parameters
232
Examples
Related links
New-VirtualAppliance
Update-VirtualAppliance
Get-VirtualApplianceConfig
Run-JobsNow
Description
Runs jobs specified by their template IDs. Use the Get-JobTemplate cmdlet to view the
template IDs of configured job templates.
Syntax
Parameters
Examples
TemplateIds <String>: The job template IDs. Separate multiple IDs with commas.
Run-JobsNow d7ebc5c4-7916-44c4-a0c2-2412999735f3,d7ebc5c4-791644c4-a0c2-2412990005f3
This command runs jobs specified by their templates.
Related links
Add-BackupGroupEntity
Add-RestoreJobTemplate
Get-Job
Get-JobTemplate
Run-ReplicationFailover
Description
Syntax
Parameters
Examples
Related links
Run-TestReplicationFailover
Run-ResumeReplicationFailover
233
Run-ResumeReplicationFailover
Description
Resumes test replication failover based on the test replication task ID.
Syntax
Parameters
Examples
Related links
Run-TestReplicationFailover
Run-ReplicationFailover
Run-TestReplicationFailover
Description
Runs test replication failover based on the replication jobs template version ID.
Syntax
Parameters
Examples
Related links
Run-ResumeReplicationFailover
Run-ReplicationFailover
Set-Cataloging
Description
Syntax
Parameters
Examples
Set-Cataloging -Catalog 1
Related links
Remove-Catalog
Get-CatalogSearchData
Get-CatalogSearchData
234
Set-CBTonVM
Description
Syntax
Parameters
Examples
Related links
None
Set-LinuxVolume
Description
Related links
Mount-LinuxVolume
Set-MountPath
Description
Sets mount path for a volume. After this operation, the specified volume is mounted to
the path specified.
Syntax
Parameters
Examples
Path <String>: The path to which the volume should be mounted to.
Related links
Get-PhysicalMachineDiskMap
Get-RepositorySavePoint
Get-RestoreDiskMap
Get-VMDKVolume
Remove-AllMount
235
Set-Resources
Description
Syntax
Parameters
Examples
Related links
Get-ConfigOption
Stop-vRangerJob
Description
Syntax
Parameters
Examples
Related links
Remove-VirtualApplianceConfiguration
Get-Job
236
Update-BackupJobTemplate
Description
Updates a backup job template. You also have the option of running the job immediately
after the template is updated.
Syntax
Parameters
Examples
Related links
Add-BackupJobTemplate
Get-Job
Get-JobTemplate
237
Update-GlobalTransportFailover
Description
Syntax
Parameters
Examples
Related links
Get-GlobalTransportFailover
This command updates the default Transport Failover order for replication jobs.
Get-TransportFailover
Update-HypervRestoreJobTemplate
Description
Updates a restore job template. You also have the option of running the job immediately
after the template is updated.
Syntax
Update-HypervRestoreJobTemplate [-JobTemplate]
<RestoreJobTemplate> [-JobName] <String> [[-JobDescription]
<String>] [-SavePoint] <Savepoint> [[-JobSchedule] <Schedule>]
[[-Flags] <NoFlags | ForceOverwrite | ForcePowerOn | UseFiber |
PerformNetworkRestoreOnFailure | AddHypervVirtualMachineToCluster
| AllFlags>] [[-NotificationList] <List`1>] [[-RunJobNow]
<Boolean>] [[-VMName] <String>] [[-TargetHost] <String>]
[[-VmLocation] <String>] [[-SkipDisks] <List`1>] [[-DiskLocations]
<List`1>] [[-TargetNetworks] <List`1>] [[-SkipAdapters] <List`1>]
[<CommonParameters>]
238
Parameters
Examples
JobSchedule [<Schedule>]: Schedule on which the job runs. If not set, the job
runs on demand.
Flags [<Nullable`1>]: Restore flags. If not set, the job has no flags.
RunJobNow [<Nullable`1>]: Whether to run the job now. If not set, the job does
not run immediately after creation of the template.
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
SkipDisks [<List`1>]: Sequence number base 0 of the disks to skip from the
savepoint. Separate multiple numbers with commas.
239
Examples
(continued)
Related links
Add-BackupJobTemplate
Add-RdaRepository
Update-RestoreJobTemplate
Get-Job
Get-JobTemplate
Update-Inventory
Description
Syntax
Update-Inventory [<CommonParameters>]
Parameters
Examples
Update-Inventory
This command refreshes the inventory.
Related links
None
240
Update-ReplicationJobTemplate
Description
Updates a replication job template. You also have the option of running the job
immediately after the template is updated.
Syntax
Update-ReplicationJobTemplate [-JobTemplate]
<ReplicationJobTemplate> [[-JobName] <String>] [[-JobDescription]
<String>] [[-TargetHost] <HostEntity>][[-ReplicateName] <String>]
[[-Type] <String>] [[-TargetNetworks] <String>]
[[-PrimaryDatastore] <String>] [[-TargetDatastores] <String>]
[[-JobSchedule] <Schedule>] [[-TransportFailover] <String>]
[[-NotificationList] <String>] [[-Flags] <NoFlags |
ReplicatePoweredOnOnly | CheckDestinationFreeSpace | UseCompression
| UpdateNotes | EnableGuestQuiescing | EnableABM | AllFlags>]
[[-RunJobNow] <Boolean>] [[-IncludedDisk] <String>]
[<CommonParameters>]
Parameters
Examples
Type [<String>]: Replication type. Valid types are Differential and Hybrid.
NotificationList [<String>]: Email notification list for the job. Separate multiple
email addresses with commas.
IncludedDisk [<Int>]: List of disks to include in this job. All VM disks are
replicated if none is specified.
RunJobNow [<Boolean>]: Whether to run the job immediately after the job
template is created.
Related links
Add-PhysicalMachine
Get-Job
Get-JobTemplate
241
Update-RestoreJobTemplate
Description
Updates a restore job template. You also have the option of running the job immediately
after the template is updated.
Syntax
242
Parameters
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
JobSchedule [<Schedule>]: Schedule on which the job runs. If not set, the job
runs on demand.
Flags [<RestoreFlags>]: Restore flags. If not set, NoFlag. Restore flags: NoFlags,
AllFlags, ForceOverwrite, ForcePowerOn. Separate multiple flags with pipes (|).
NotificationList [<String>]: Email notification list for the job. Separate multiple
email addresses with commas.
RunJobNow [<Boolean>]: Whether to run the job now. If not set, the job does
not run immediately after creation of the template.
VMName [<String>]: Name of the restored VM. If not set, the VM name in the
savepoint is used.
SkipDisks [<String>]: Sequence number base 0 of the disks to skip from the
savepoint. Disks in savepoint are order by their SCSI controller number and disk
number. Separate multiple numbers with commas.
243
Examples
Related links
Add-PhysicalMachine
Get-Job
Get-JobTemplate
Update-VirtualAppliance
Description
Related links
New-VirtualAppliance
Remove-VirtualAppliance
Get-VirtualApplianceConfig
Update-VirtualApplianceConfiguration
Description
Syntax
Update-VirtualApplianceConfiguration [-VirtualApplianceEntity]
<VirtualApplianceConfig> [-IPAddressOverride] <String>]
[[-ClusterDefault] <Boolean>][[-CPUAllocation] <Int>]
[[-MemorySizeInMB] <Int>] [[-ScratchDiskDatastore] <Datastore>]
[[-ScratchDiskSizeInKB] <Int>] [-NewPassword]
<String>][[-UseVAForLFLR] <Boolean>] [[-DeleteScratchDisk]
<Boolean>] [[-VAReconfigurationStatus] <Boolean>]
[<CommonParameters>]
244
Parameters
Examples
NewPassword [<String>]: New password for the VA, if this word is not specified,
the password remains unchanged.
Related links
New-VirtualAppliance
Remove-VirtualAppliance
Get-VirtualApplianceConfig
245
About Dell
Dell listens to customers and delivers worldwide innovative technology, business solutions, and services they
trust and value. For more information, visit http://www.software.dell.com.
Contacting Dell
For sales or other inquiries, visit http://software.dell.com/company/contact-us.aspx or call +1-949-754-8000.
246