Veeam Backup 12 Explorers User Guide
Veeam Backup 12 Explorers User Guide
Version 12
User Guide
June, 2023
© 2023 Veeam Software.
All rights reserved. All trademarks are the property of their respective owners.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or
translated into any language in any form by any means, without written permission from Veeam Software
(Veeam). The information contained in this document represents the current view of Veeam on the issue
discussed as of the date of publication and is subject to change without notice. Veeam shall not be liable for
technical or editorial errors or omissions contained herein. Veeam makes no warranties, express or implied, in
this document. Veeam may have patents, patent applications, trademark, copyright, or other intellectual
property rights covering the subject matter of this document. All other trademarks mentioned herein are the
property of their respective owners. Except as expressly provided in any written license agreement from Veeam,
the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other
intellectual property.
NOTE
Read the End User Software License Agreement before using the accompanying software programs. Using
any part of the software indicates that you accept the terms of the End User Software License Agreement.
Customer Support
Should you have a technical concern, suggestion or question, visit the Veeam Customer Support Portal to open a
case, search our knowledge base, reference documentation, manage your license or obtain the latest product
release.
Company Contacts
For the most up-to-date information about company contacts and office locations, visit the Veeam Contacts
Webpage.
Online Support
If you have any questions about Veeam products, you can use the following resources:
Intended Audience
This user guide is intended for IT administrators, consultants, analysts and other IT professionals using the
product.
Veeam Explorers are distributed as part of Veeam Backup for Microsoft 365 and Veeam Backup & Replication,
and you do not need to install them separately. You also do not need to purchase any additional license to use
Veeam Explorers: the available feature set for each Veeam Explorer depends entirely on the installed edition of
Veeam Backup for Microsoft 365 and Veeam Backup & Replication. For information about how to deploy Veeam
products, see the following sections:
• Deployment section of the Veeam Backup for Microsoft 365 User Guide
The following table lists all Veeam Explorers that come as part of Veeam Backup & Replication and Veeam
Backup for Microsoft 365.
Veeam Explorer Veeam Backup & Replication Veeam Backup for Microsoft
365
This document provides information on how to use Veeam Explorers that come as part of
Veeam Backup & Replication. For information on Veeam Explorers available with Veeam Backup for Microsoft
365 only, see the Veeam Explorers User Guide for Veeam Backup for Microsoft 365.
Component Requirement
Microsoft Active For more information about supported operating systems, see the Supported
Directory Domain Applications subsection of the Veeam Backup & Replication User Guide.
Services
• Veeam Explorer for Microsoft Active Directory does not support Active Directory Lightweight Directory
Services (AD LDS).
• Database files created by the domain controller can be opened for object recovery with Veeam Explorer
for Microsoft Active Directory only if Veeam Explorer for Microsoft Active Directory is installed on a
Windows machine with the same OS version or later than the version of the domain controller OS.
• To open database files, Veeam Explorer for Microsoft Active Directory uses a service dynamic link library
(esent.dll) which is installed with Microsoft Active Directory Domain Services and can be found in the
%SystemRoot% directory. The Esent.dll file on a machine with Veeam Explorer for Microsoft Active
Directory must be of the same version as that of Microsoft Active Directory Domain Services that was used
to create database files.
TCP 636,
3268,
3269
• Domain Admins
General
• When Veeam Explorer for Microsoft Active Directory is installed on a server on which both
Veeam Backup & Replication and Veeam Backup for Microsoft 365 are installed, the notification settings
will be inherited from the Veeam Backup & Replication Global Notification settings.
Restore
• Veeam Explorer for Microsoft Active Directory does not support restore using PowerShell Direct, VIX API
or vSphere Automation API.
• Data can only be restored back to the original domain. Cross-domain restore is not supported.
• Veeam Explorer for Microsoft Active Directory does not support recovery of the contents of the Domain
Controllers container and most of the contents of the System container (in particular, the Password
Settings container), as this may cause system stability issues on the target machine. Moreover, some of
the contents of the System container, as well as the entire Configuration Partition container, the Microsoft
Exchange System Options container, the Integrated DNS container and so on, can be recovered with
Veeam Explorer for Microsoft Active Directory, but they are only visible in the Advanced Features view to
prevent accidental errors during the recovery process. For more information, see the Browsing, Searching
and Viewing Items section.
• Veeam Explorer for Microsoft Active Directory supports restore of both mailbox-enabled objects
(including hard-deleted items and Online Archives), and mail-enabled objects for the following Microsoft
Exchange versions: Microsoft Exchange Server 2019, Microsoft Exchange Server 2016, Microsoft Exchange
Server 2013 and Microsoft Exchange Server 2010 SP1. For other Microsoft Exchange versions, restore of
mailbox-enabled objects is not supported (only mail-enabled objects can be restored).
• To restore passwords, Veeam Explorer for Microsoft Active Directory uses the registry database. To
restore passwords, make sure the System registry hive is available. The default location of the hive is
%systemroot%\System32\Config. When restoring an Active Directory database from the Active Directory
backup using Veeam file-level restore, the registry hive will be located automatically. When restoring
from an imported backup or from VeeamZIP backups, make sure that the system registry hive and the .dit
file are located in the same directory.
• If you plan to restore database items from an Active Directory Domain Services server running Microsoft
Windows ReFS, make sure that the backup server or Veeam Backup & Replication console is installed on a
machine that runs Microsoft Windows Server 2012 or later.
To restore from a server running Microsoft Windows ReFS 3.x, the Veeam Backup & Replication console
must be installed on a machine that runs Microsoft Windows Server 2016 or later, and the ReFS version
must be supported on this machine.
• Restore of Group Policy objects, AD-integrated DNS records and objects from the Configuration Partition
is supported in the Enterprise and Enterprise Plus editions only.
• Veeam Explorer for Microsoft Active Directory does not restore object attributes such as objectSID and
objectGUID from the backup. To restore deleted Active Directory objects, Veeam Explorer for Microsoft
Active Directory uses existing tombstone objects on the target Active Directory server or objects in the AD
Recycle Bin. In this case, the restored object will have its original objectSID and objectGUID. If an object
you want to restore does not exist in the tombstone container or recycle bin in the target domain, Active
Directory will assign new objectSID and objectGUID attributes to the restored object.
• Always use backups that are newer than the tombstone lifetime interval for the Active Directory forest. To
determine a tombstone lifetime interval, you can use ADSIEdit or Dsquery. For more information, see this
Microsoft article.
• When you move an object from one domain to another within a forest (for example, using the
Movetree.exe utility or any other 3rd party tool), no tombstone for this object will remain in the source
Active Directory; such an object cannot be fully recovered to the original domain.
Export
• Veeam uses Lightweight Data Interchange Format to save Active Directory objects and containers to .ldf
files. You can make an .ldf file available to the Active Directory Domain Services server by importing it
with the ldifde utility. For more information, see this Microsoft article.
• Veeam Explorer for Microsoft Active Directory does not support exporting passwords.
• Use the Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
• Go to Start, click Veeam Explorer for Microsoft Active Directory and manually open Active Directory
databases, as described in the Adding Standalone Microsoft Active Directory Databases section.
When starting the application from the Start menu, specify the following:
• The domain name or IP address of the backup server to which you want to connect
o To perform recovery operations, Veeam Explorer for Microsoft Active Directory must be run with
elevated permissions. The user account must be a member of the local Administrators group on the
machine where Veeam Explorers Suite is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft Active Directory is running, select Use
Windows session authentication.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu comprises the following:
• Help.
• Exit. Closes the Veeam Explorer for Microsoft Active Directory window.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft Active Directory wizard
or window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon menu, which contains general program commands organized into logical groups.
• The navigation pane, which allows you to browse through the hierarchy of your backup files.
• The preview pane, which shows you the details about objects you have selected in the navigation area.
Browsing
To view the contents of a backup file, use the navigation pane which shows you the database structure
containing your active directory objects. After you select a container in the navigation pane, you can see its
contents in the preview pane.
Right-click an object and select View attributes to view object attributes. To copy necessary attributes to the
clipboard, select an attribute and press [Ctrl+C] on the keyboard. Multiple selection is also supported.
Veeam Explorer for Microsoft Active Directory does not display some objects and containers in the default view,
such as the entire Microsoft Exchange System Options, System, Integrated DNS, Configuration Partition
containers, as well as the objects stored in the Domain Controllers container. This behavior is intended to
prevent accidental errors during the recovery process that may affect the system stability of the target machine.
You can view and recover some of this data if you open the Home tab and enable Advanced Features, but you
must manually verify all recovery operations to ensure stable operation of the system.
1. In the navigation pane, select an object in which you want to find your data.
2. Enter a search query in the search field at the top of the preview pane. Then press [Enter] or click the
Search button to the right of the search field.
NOTE
To find the exact phrase, use double quotes. For example, "group policy".
3. In the search field, enter an LDAP query. Then press [Enter] or click the Search button to the right of the
search field.
2. On the Advanced tab, select the Enable extended logging check box and click OK.
3. Go back to the application, perform necessary actions and then review the logs to see the details.
IMPORTANT
Make sure the database you are adding to the Veeam Explorer for Microsoft Active Directory scope was not
locked by another process.
1. Select the root Active Directory node in the navigation pane and click Add Database on the ribbon or right-
click the Active Directory node and select Add database.
2. Specify the location of the Active Directory database file and folder that contains associated transaction
log files (Edb.log and Edb.chk).
By default, the Active Directory database file (NTDS.DIT) is located in the %SystemRoot%\NTDS
directory. Make sure that the system registry hive is located in the same place.
2. On the Objects tab, select Restore Objects > Restore objects to or right-click an object and select Restore
objects to.
• Restore to the original container — to restore data to the original container in your production
environment.
• Restore to the following container — to select a different container, as described in Browsing Container.
NOTE
If a container that is being restored was not found in the production environment, it will be restored anew.
• When providing a new password, check that it complies with the password policy in your production
environment.
• If you select Restore password or Set password to options, you may also request a user to change the
password at next log on.
Keep in mind that this setting will not take effect if a user is not allowed to change the password due to
security limitations.
• When restoring multiple accounts, a new password will be set for all the accounts altogether.
• To restore account passwords, Veeam Explorer for Microsoft Active Directory uses registry database. Make
sure that the System registry hive is available.
The default location is %systemroot%\System32\Config.
• When restoring Active Directory database from an Active Directory backup file using Veeam file-level
restore, the registry hive will be located automatically. Otherwise, make sure the system registry hive is
located in the same folder as .DIT file.
• Keep account state from backup — to keep the account state as it is in the backup file.
• Objects to process:
• Restore:
When selecting Selected attributes only, you will be offered to choose the attributes you want to
restore in the next step.
This option is not applicable to restore of Group Policy Objects.
• Multi-valued attributes:
NOTE
• When working with Active Directory 2016, this dialog will also include the Restore expiration time
option, which allows you to restore expiration time for linked attributes.
• Users cannot change recovery settings for disabled attributes. Such attributes will be either restored
or skipped according to the default configuration.
This step is available only if you have chosen the Selected attributes only option at the previous step.
After the restore process is complete, review the results shown in the Restore summary window. You can filter
notifications by their status: Error, Warning or Success.
2. On the Container tab, select Restore Container > Restore container to or right-click a container and select
Restore container to.
• Restore to the original container — to restore data to the original container in your production
environment.
• Restore to the following container — to select a different container, as described in Browsing Container.
NOTE
If a container that is being restored was not found in the production environment, it will be restored anew.
• When providing a new password, check that it complies with the password policy in your production
environment.
• If you select Restore password or Set password to options, you may also request a user to change the
password at next log on.
Keep in mind that this setting will not take effect if a user is not allowed to change the password due to
security limitations.
• When restoring multiple accounts, a new password will be set for all the accounts altogether.
• To restore account passwords, Veeam Explorer for Microsoft Active Directory uses registry database. Make
sure that the System registry hive is available.
The default location is %systemroot%\System32\Config.
• When restoring Active Directory database from an Active Directory backup file using Veeam file-level
restore, the registry hive will be located automatically. Otherwise, make sure the system registry hive is
located in the same folder as .DIT file.
• Keep account state from backup — to keep the account state as it is in the backup file.
• Objects to process:
• Restore:
When selecting Selected attributes only, you will be offered to choose the attributes you want to
restore in the next step.
• Multi-valued attributes:
NOTE
• When working with Active Directory 2016, this dialog will also include the Restore expiration time
option which allows you to restore expiration time for linked attributes. If an attribute being
restored expires during the restore session, the attribute will not be restored.
• Users cannot change recovery settings for disabled attributes. Such attributes will be either restored
or skipped according to the default configuration.
This step is available only if you have chosen the Selected attributes only option at the previous step.
After the restore process is complete, review the results shown in the Restore summary window. You can filter
notifications by their status: Error, Warning or Success.
• Attribute values and security descriptors will be replaced with that of a backup file.
2. On the Container tab, select Restore Container > Restore container to <server_name> or right-click a
container and select Restore container to <server_name>.
After the restore process is complete, review the results shown in the Restore Summary window. You can filter
notifications by their status: Error, Warning or Success.
2. On the Objects tab, select Restore Objects > Restore objects to <server_name> or right-click an object and
select Restore objects to <server_name>.
After the restore process is complete, review the results shown in the Restore Summary window. You can filter
notifications by their status: Error, Warning or Success.
2. On the Objects tab, select Export Objects > Export objects to or right-click an object and select Export
objects to.
2. On the Container tab, select Export Container > Export container to or right-click a container and select
Export container to.
3. In the Export Container window, in the Export to field, specify the destination location.
To save only objects included in the selected container and meet specific filtering criteria, click Show
settings to set the filter.
4. [Optional] Select the Save only objects that suit the following filter check box and enter filtering criteria.
If necessary, select the Use LDAP filter check box to switch to the LDAP filtering mode.
5. Click Export.
All the nested containers (if any) will be preserved during the export.
2. On the Container tab, select Export Container > Export Container to <target_folder> or Export Objects >
Export Object to <target_folder>. Alternatively, you can use the associated context menu command.
NOTE
The <target_folder> destination depends on the location you used during the last export operation.
2. On the Home tab, select Compare with Production to detect changed, moved or deleted objects since the
last Active Directory backup.
3. Click Show Changed Objects Only on the ribbon to view only those items that have been changed since
the last backup.
The following figure shows user accounts the attributes of which have been changed since the last time
they were backed up. Veeam can also combine item states to represent the most accurate state of an
object. For example, if object attributes have been changed and the object was moved to a different
location, the object status in this case will be shown as Moved, Changed.
3. On the Objects tab, select Compare object attributes or right-click an object and select Compare object
attributes.
Component Requirement
Microsoft SQL For more information about supported versions of Microsoft SQL Server, see the
Server Supported Applications subsection of the Veeam Backup & Replication User Guide.
NOTE
AlwaysOn Availability Groups are supported for Microsoft SQL Server 2012 and higher.
• By default, the AUTO_CLOSE option for Microsoft SQL Server databases is set to False.
If AUTO_CLOSE is enabled, your databases may be skipped from processing.
• To restore database items from a Microsoft SQL Server that is running Microsoft Windows ReFS, the
backup server or Veeam Backup & Replication console must be installed on a machine that runs Microsoft
Windows Server 2012 or later.
• To restore data from a server that is running Microsoft Windows ReFS 3.x, the backup server or
Veeam Backup & Replication console must be installed on a machine that runs Microsoft Windows Server
2016.
• Nodes participating in AlwaysOn Availability Groups are supported, but using Availability Group Listeners
as staging servers is not recommended.
• Make sure that the staging Microsoft SQL Server has the same or later version as the original SQL Server.
• A SQL Server included in Microsoft SQL Server Failover Cluster cannot be used as a staging system.
• Configure domain trusts when planning to add databases to the Veeam Explorer for Microsoft SQL Server
scope manually. For more information, see Configuring Staging SQL Server.
• The following Microsoft SQL Server Express Editions can be used as a staging system:
o Microsoft SQL Server 2012 Express Edition — for Microsoft Windows 2008 R2 and Windows 7
o Microsoft SQL Server 2016 Express Edition — for other later versions
Both editions come as part of the Veeam Backup & Replication distribution package.
NOTE
Databases that exceed 10 GB cannot be attached to the Microsoft SQL Server Express Edition due to
Express Edition limitations. For more information, see the Editions and supported features of SQL Server
2022 Microsoft article.
Backup
Backup Source TCP, UDP 135, 137 to Ports used to deploy the runtime
server, guest machine with 139, 445 coordination process on the source
interaction Microsoft SQL machine.
proxy Server
(Enterprise
and TCP 49152 to Dynamic RPC range that is used by the
Enterprise 65535 runtime coordination process which is
Plus editions) (for Microsoft deployed on the source machine for
Windows application-aware processing.1
2008 or
later)
Source Backup TCP 49152 to Dynamic RPC range used by the runtime
machine with server, guest 65535 coordination process that is deployed on
Microsoft SQL interaction (for Microsoft the source machine for application-aware
Server proxy Windows processing.1
(Enterprise 2008 or
and later) For more information, see this Microsoft
Enterprise article.
Plus editions)
Log shipping TCP 2500 to For Microsoft SQL Server transaction logs
server, 3300 shipping
backup
repository Default range of ports used by the Veeam
Data Mover Service for data transfer over
the network.
1
If you use default Microsoft Windows firewall settings, you do not need to configure dynamic RPC ports: during setup,
Veeam Backup & Replication automatically creates a firewall rule for the runtime process. If you use firewall settings other
than default ones or application-aware processing fails with the RPC function call failed error, you need to configure
dynamic RPC ports. For more information, see this Microsoft KB article.
Backup server, Target TCP, UDP 135, 445 Ports used to deploy the runtime
Veeam Backup & Replication machine coordination process on the target
console, mount server with machine.
associated with the backup Microsoft
repository (only for Instant SQL
Recovery or restore from Server, TCP 49152 to Dynamic RPC range used by the
Enterprise Manager) staging 65535 runtime coordination process that is
server (for deployed on the target machine.1
Microsoft
Windows For more information, see this
2008 or Microsoft article.
later)
1
If you use default Microsoft Windows Firewall settings, you do not need to configure dynamic RPC ports: during setup,
Veeam Backup & Replication automatically creates a firewall rule for the runtime process. If you use firewall settings other
than default ones or application-aware processing fails with the RPC function call failed error, you need to configure
dynamic RPC ports. For more information on how to configure RPC dynamic port allocation to work with firewalls, see this
Microsoft KB article.
Veeam Explorer for The account used to run Veeam Explorer for Microsoft SQL Server must be a member
Microsoft SQL of the local Administrators or Users group.
Server launch
The account must be a member of the local Administrators group and must be granted
the sysadmin role on the target Microsoft SQL Server. To learn more about Microsoft
Restore, Publish, SQL Server roles, see this Microsoft article.
Instant Recovery The sysadmin role is required for connections with Microsoft SQL Server Virtual Device
Interface (VDI) that Veeam Explorer for Microsoft SQL Server uses to perform recovery
operations. For more information, see this Microsoft article.
The account used to connect to the staging server must be a member of the sysadmin
role on the Microsoft SQL Server.
If you want to use a local Microsoft SQL Server as a staging server and Veeam Explorer
Staging Microsoft
for Microsoft SQL Server runs under an account that does not belong to the local
SQL Server
Administrators group, you must specify the current account for connection to the
configuration
staging server, or you will get an impersonation error.
For more information on how to configure and use the staging Microsoft SQL Server,
see Configuring Staging SQL Server.
Recovery Model
NOTE
To be able to restore your data as of a point in time or as of a state before undesired transactions, make
sure the recovery model for the database is set to full or bulk-logged.
The following table lists database logging models and applicable Veeam options.
General
• When Veeam Explorer for Microsoft SQL Server is installed on a server on which both
Veeam Backup & Replication and Veeam Backup for Microsoft 365 are installed, the notification settings
will be inherited from the Veeam Backup & Replication Global Notification settings.
Restore
• Veeam Explorer for Microsoft SQL Server does not support restore using PowerShell Direct, VIX API or
vSphere Automation API.
• Table-level recovery is supported only for database tables with no external dependencies. Tables with
external dependencies are tables extended to Microsoft Azure using the Stretch Database functionality
and so on.
• To restore an encrypted database, consider reading this Veeam Knowledge Base article.
• To restore a database from the AlwaysOn availability group node as of the selected transaction state, the
nodes of such a group must be in the same time zone.
• Databases located on VM disks excluded from backup are displayed in Veeam Explorer for Microsoft SQL
Server with a question mark next to each database. It is not possible to restore data of such databases.
Publishing
• During publishing, Veeam Explorer for Microsoft SQL Server mounts VMs disks from the backup file to the
target machine (under the C:\VeeamFLR directory), retrieves required database files and attaches
associated databases directly to your Microsoft SQL Server instance so that you can perform required
operations using Microsoft SQL tools such as Microsoft SQL Server Management Studio.
When publishing to a cluster, all VMs disks become part of the target cluster. Publishing to a cluster
requires a free drive letter on all cluster nodes according to the number of clustered disks in the backup.
• After you unpublish a database, Veeam Explorer for Microsoft SQL Server detaches such a database from
the target Microsoft SQL Server but the restore point will continue to remain on the target machine for
the next 15 minutes.
• If a Veeam Explorer for Microsoft SQL Server session has been terminated in any way other than by
clicking Exit in the main menu (or by clicking the X button in the upper-right corner), then all the
published databases will continue to remain attached to the target Microsoft SQL Server with the
Recovery pending state.
• If published databases have been renamed manually using SQL tools (for example, Microsoft SQL
Management Studio), Veeam Explorer for Microsoft SQL Server will not be able to unpublish such
databases properly. In this case, all the renamed databases will continue to remain attached to the target
Microsoft SQL Server and you will have to remove them manually using the SQL tools.
• Veeam Explorer for Microsoft SQL Server does not back up published databases.
Instant Recovery
• To restore an encrypted database, consider reading this Veeam Knowledge Base article.
• If you perform instant recovery of a database from the AlwaysOn availability group node, Veeam Explorer
for Microsoft SQL Server restores it as a standalone database.
• For desktop versions of Microsoft Windows (7, 8, 8.1, 10), you must perform instant recovery of multiple
databases one by one. The limitation occurs because desktop versions of Microsoft Windows OS do not
allow more than 20 incoming concurrent TCP/IP connections. For details, see Microsoft Windows 10
License Terms.
As a workaround, you can perform instant recovery of multiple databases in parallel using the Restore-
VESQLIRDatabase PowerShell cmdlet.
• Instant recovery to a SQL Server cluster requires free drive letters on all cluster nodes. The number of free
drive letters on each cluster node must be twice the number of clustered disks in the backup.
• The Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
• Go to Start, click Veeam Explorer for Microsoft SQL Server and manually open Microsoft SQL databases, as
described in the Adding Standalone Microsoft SQL Databases section.
If you open Veeam Explorer for Microsoft SQL Server from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
• The domain name or IP address of the backup server to which you want to connect
o To perform recovery operations, Veeam Explorer for Microsoft SQL Server must be run with elevated
permissions. The user account must be a member of the local Administrators group on the machine
where Veeam Explorers Suite is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft SQL Server is running, select Use Windows
session authentication.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu consists of the following:
• Help.
• Exit. Closes the Veeam Explorer for Microsoft SQL Server window.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft SQL Server wizard or
window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon menu, which contains general program commands organized into logical groups.
• The navigation pane, which allows you to browse through the hierarchy of your SQL databases.
• The preview pane, which shows you the details about objects you have selected in the navigation area.
Mounting is performed by the Veeam Mount Service component which is deployed on a backup repository
machine or any other machine you define in the backup repository settings. For more information, see the
Mount Server section of the Veeam Backup & Replication User Guide.
During mounting, Veeam Mount Service retrieves a VM file system from the backup file, attaches it to the hard
drive of the target machine and creates a mount point.
To mount a VM file system on to machines with the Microsoft Windows operating system, Veeam uses the iSCSI
protocol. The original virtual machine or staging Microsoft SQL Server acts as an iSCSI initiator, and a mount
server associated with the backup repository acts as an iSCSI target. The iSCSI mount point is non-persistent and
only exists during the recovery process.
NOTE
When using fine-tune restore or point-in-time state restore, Veeam always uses a staging Microsoft SQL
Server to mount the VM file system.
After the recovery session is ended, the service is stopped and removed from the guest operating system.
All service activities are logged to the Veeam.SQL.Service_<timestamp>.log file stored in the Temp folder
which is located in the system directory.
The Veeam SQL Restore Service component requires the Local System account.
Inbound and outbound traffic management between Veeam Explorer for Microsoft SQL Server and the Veeam
SQL Restore Service component is performed over the RPC protocol. For more information, see Ports.
NOTE
When restoring to the local server instance, the Veeam SQL Restore Service component is not installed on
the Microsoft SQL Server machine.
• When using the fine-tune restore, as described in Data Restore and Data Publishing.
• When adding standalone Microsoft SQL Server databases to Veeam Explorer for Microsoft SQL Server, as
described in Adding Standalone Databases.
A machine used as a staging Microsoft SQL Server for the data export, data restore and data publishing
operations can reside in the same domain as the machine hosting Veeam Explorer for Microsoft SQL Server, as
well as in a trusted domain or untrusted domain.
• A machine used as a staging SQL Server can reside in the same domain as the machine hosting Veeam
Explorer for Microsoft SQL Server or in a trusted domain. You cannot use a staging server that belongs to
an untrusted domain to add a standalone database to Veeam Explorer for Microsoft SQL Server.
• Both Windows authentication and SQL Server authentication methods are supported for the staging SQL
Server. If you want to use Windows authentication, complete the following steps to configure delegation
settings:
c. Select the Trust this computer for delegation to specified services only and Use any authentication
protocol options for the cifs service on a computer with Veeam Explorer for Microsoft SQL Server.
e. Select a domain user account that you want to use when connecting to the staging SQL Server VM and
make sure the Account is sensitive and cannot be delegated check box is not selected.
1. In the Veeam Explorer for Microsoft SQL Server main menu, click General Options.
2. On the Staging Server tab, select the Use this helper SQL Server for advanced recovery functionality check
box and do the following:
a. In the SQL Server name drop-down list, select a server that you want to use as your staging SQL
Server.
You can click Browse to locate a server using the built-in browser, as described in Browsing for
Servers.
b. In the Specify user account to connect to Windows server section, select the following:
Use current account. To connect to the specified server using the current user account under
which Veeam Explorer for Microsoft SQL Server running.
Use the following account. To connect to the specified server under a custom user account.
When using a custom account, in the Username field, specify a user name and in the Password
field, provide the password.
c. In the Specify user account to connect to SQL Server instance section, select the following:
Use the following account. To connect to the specified instance under a custom user account.
When using a custom account, in the Username field, specify a user name and in the Password
field, provide the password.
To use SQL Server authentication, select the Use SQL Server authentication check box.
• On the Local Servers tab, select a local SQL Server that is located on the machine with Veeam Explorer for
Microsoft SQL Server.
• On the Network Servers tab, select a SQL Server over the network.
1. In the Veeam Explorer for Microsoft SQL Server main menu, click General Options.
2. On the Advanced tab, select the Enable extended logging check box and click OK.
Before you add a standalone Microsoft SQL database, you must configure a staging SQL Server. For more
information, see Configuring Staging SQL Server.
2. Specify the location of a primary database file, a secondary database file and associated log files. If
necessary, specify the BLOB store location.
Manually added databases will be displayed in the navigation pane under the Other SQL Server Databases
node.
NOTE
You can only remove databases that have been added to the application scope manually.
• Database files will be copied to the original location and then mounted to the original Microsoft SQL
Server.
• If a database with the same name already exists on a target Microsoft SQL Server, it will be replaced with
the database from a backup file.
To restore the latest available state of a Microsoft SQL Server database, do the following:
2. On the Database tab, select Restore Database > Restore latest state to <original_location>.
Alternatively, you can right-click a database and select Restore database > Restore latest state to
<original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
• Database files will be copied to the original location and then mounted to the original Microsoft SQL
Server.
• If a database with the same name already exists on a target Microsoft SQL Server, it will be replaced with
the database from a backup file.
To restore SQL Server databases as of a point-in-time state, use the Restore wizard.
2. On the Database tab, select Restore Database > Restore point-in-time state to
<server_name>\<instance_name>.
Alternatively, you can right-click a database and select Restore database > Restore point-in-time state to
<server_name>\<instance_name>.
1. In the Specify point in time you want to restore the database to section, select one of the following
options:
o Restore to the point in time of the selected image-level backup. Select this option to load database
files as per date of the current restore point.
o Restore to a specific point in time. Select this option to load database files as per selected point in
time. Use the slider control to choose a point you need.
This option is available in case the following conditions are met:
[For restore from a backup created by a backup job] The backup is created by a job that is set to
back up transaction logs or process transaction logs in the copy only mode.
[For restore from a backup created by a backup copy job] The backup is created by a job that is
set to process transaction logs.
2. [Optional] Select the Perform restore to the specific transaction check box to load database files exactly
as of the moment before undesired transactions. If you select this option, you will be able to specify an
exact transaction at the next step of the wizard.
This option requires a staging Microsoft SQL Server. For more information, see Configuring Staging SQL
Server.
This option is unavailable when restoring multiple databases.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
2. On the Database tab, select Restore Database > Restore to another server.
Alternatively, you can right-click a database and select Restore database > Restore to another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Microsoft SQL Server. For more
information, see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the name of the Microsoft SQL Server machine or SQL Server instance to
which you want to restore your database.
Use the <server IP or FQDN>\<instance name> format. You can select a server or instance from the drop-
down list or use the Browse button, as described in Browsing for Servers.
If the SQL Server instance is assigned a custom port, and Microsoft SQL Browser is not running on the
machine, specify the instance port in the following format: <server IP or FQDN>,<port>.
2. In the Database name filed, specify a name for the restored database.
3. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Microsoft SQL Server is running.
You cannot use this option if Veeam Explorer for Microsoft SQL Server and mount server are located
on separate machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
Make sure the account you are using has been granted the sysadmin role on the target SQL Server
machine.
4. If you selected the Use the following account option and want to use Microsoft SQL Server authentication,
select the Use SQL Server authentication check box. If you do not select the check box, Veeam Explorer
for Microsoft SQL Server will use Windows authentication.
IMPORTANT
Make sure that the administrative share (for example, \\myserver\ADMIN$) on the target machine is
available. Read and Write are minimum required, Full Control is recommended.
• On the Local Servers tab, select a local Microsoft SQL Server that is located on the machine with Veeam
Explorer for Microsoft SQL Server.
• On the Network Servers tab, select a SQL Server over the network.
1. Select the Add the database to the following Availability Group check box and select an availability group
from the drop-down list.
2. In the The database will be replicated to the following nodes list, review information about the primary
and secondary nodes of the availability group.
During the restore process, Veeam Explorer for Microsoft SQL Server will restore the database to the
primary server and then replicate it to secondary nodes.
If you do not plan to use the AlwaysOn capabilities when restoring a database, clear the Add the database to the
following Availability Group check box.
NOTE
Make sure the account you are using has Read and Write permissions.
• Default (RECOVERY)
Rolls back (undo) any uncommitted changes.
• NORECOVERY
Skips the undo phase so that uncommitted or incomplete transactions are held open.
This allows further restore stages to carry on from the restore point. When applying this option, the
database will be in a norecovery state and inaccessible to users.
• STANDBY
The database will be in standby state and therefore available for read operations. You can also provide a
standby file with uncommitted transactions.
NOTE
This step is unavailable if the Add the database to the following group check box is selected at the Specify
AlwaysON Restore Options step.
To restore the latest available state of multiple databases, use the Restore wizard.
2. On the Instance (or Server) tab, select Restore Databases > Restore latest state to <original_location>.
Alternatively, you can right-click an instance or the server and select Restore databases > Restore latest state to
<original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Some databases cannot be restored if there are no transaction logs available for the specified period.
To restore Microsoft SQL Server databases as of the point-in-time state, use the Restore wizard.
2. On the Instance (or Server) tab, select Restore Databases > Restore point-in-time state to
<original_location>.
Alternatively, you can right-click an instance or the server and select Restore databases > Restore point-in-time
state to <original_location>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
2. On the Instance (or Server) tab, select Restore Databases > Restore to another server.
Alternatively, you can right-click an instance or the server and select Restore databases > Restore to another
server.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
1. In the Server name field, specify the name of the Microsoft SQL Server machine or SQL Server instance to
which you want to restore your database.
Use the server_name\instance format. You can select a server or instance from the drop-down list or use
the Browse button, as described in Browsing for Servers.
When you restore multiple databases, Veeam Explorer for Microsoft SQL Server places database files to
their default location specified in the properties of the target SQL Server instance.
2. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Microsoft SQL Server is running.
You cannot use this option if Veeam Explorer for Microsoft SQL Server and mount server are located
on separate machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
Make sure the account you are using has been granted the sysadmin role on the target SQL Server
machine.
3. If you selected the Use the following account option and want to use Microsoft SQL Server authentication,
select the Use SQL Server authentication check box. If you do not select the check box, Veeam Explorer
for Microsoft SQL Server will use Windows authentication.
IMPORTANT
Make sure that the administrative share (for example, \\myserver\C$) on the target machine is available.
Read and Write are minimum required permissions, Full Control is recommended.
• On the Local Servers tab, select a local SQL Server that is located on the machine with Veeam Explorer for
Microsoft SQL Server.
• On the Network Servers tab, select a SQL Server VM over the network.
2. On the Database tab, select Restore Schema > Restore database schema and data.
Alternatively, you can right-click a database in the navigation pane and select Restore schema > Restore
database schema and data.
IMPORTANT
• A staging SQL Server is required to perform a restore of database schema and data. For more
information, see Configuring Staging SQL Server.
• FILESTREAM must be enabled on a staging SQL Server to restore file tables. For more information
on enabling FILESTREAM, see this Microsoft article.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the target SQL Server instance to which you want to restore your
database.
You can specify the instance name in the server_name\instance format. Also, you can select an instance
from the drop-down list or use the Browse button, as described in Browsing for Servers.
2. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Microsoft SQL Server is running.
You cannot use this option if Veeam Explorer for Microsoft SQL Server and mount server are located
on separate machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
Make sure the account you are using has been granted the sysadmin role on the target SQL Server
machine.
3. If you selected the Use the following account option and want to use SQL Server authentication, select
the Use SQL Server authentication check box. If you do not select the check box, Veeam Explorer for
Microsoft SQL Server will use Windows authentication.
4. In the Database name field, specify the target database name. Click Browse to select a database to which
you want to restore the schema.
• On the Local Servers tab, select a local SQL Server that is located on the machine with Veeam Explorer for
Microsoft SQL Server.
• On the Network Servers tab, select a SQL Server instance on another server. Veeam Explorer for Microsoft
SQL Server displays servers from your network where Microsoft SQL Server is installed.
Use the Object and Data check boxes to specify what database objects and data should be restored.
To display only specific objects, click Filter and select the object type.
• To assign a default name to the object that already exists, click Auto. In this case, the _new suffix will be
added.
• In the Filegroups section, select how filegroups should be restored for selected schema objects:
o Use the following filegroup — to select a file group on a target SQL Server instance.
• In the Partitioned tables section, select how partitioned tables should be restored:
o Preserve partition schema if applicable — to restore tables to the original partition schema.
o Use the following partition schema — to select a partition schema on a target SQL Server instance.
o Use the following filegroup — to select a file group on a target SQL Server instance.
After you have launched a publishing operation to a Microsoft SQL Server, you can quickly republish the latest
or point-in-time state of the database to the same server.
2. On the Database tab, select Publish Database > Publish to another server.
Alternatively, you can right-click a database and select Publish database > Publish to another server.
To work with published databases, open a SQL tool you prefer, for example, Microsoft SQL Management Studio
and locate your published databases.
The figure below demonstrates a published database (db1_published) available in the Object Explorer window of
your Microsoft SQL Server Management Studio console. This database is also being referenced by Veeam
Explorer for Microsoft SQL Server under its Published databases node.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify a target SQL server name/SQL server instance/SQL cluster to which you
want to publish the database.
Use the server_name\instance format. You can select a server/instance/cluster from the drop-down list or
use the Browse button on the left, as described in Browsing for Servers.
2. In the Database name filed, specify a new name under which you want to publish your database.
Consider that if you leave the original database name, Veeam Explorer for Microsoft SQL Server will
overwrite the associated database on the target server.
3. In the Specify user account to connect section, select either of the following options:
o User current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Microsoft SQL Server is running.
You cannot use this option if Veeam Explorer for Microsoft SQL Server and mount server are located
on separate machines.
o User the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
Make sure the account you are using has been granted the sysadmin role on the target SQL Server
machine.
4. If you selected the Use the following account option and want to use SQL Server authentication, select
the Use SQL Server authentication check box. If you do not select the check box, Veeam Explorer for
Microsoft SQL Server will use Windows authentication.
NOTE
Make sure that the administrative share for example, \\myserver\ADMIN$) on the target machine is
available; Read and Write are minimum required, Full Control is recommended.
• On the Local Servers tab, select a local SQL server/instance/cluster that is located on a machine with
Veeam Explorer for Microsoft SQL Server.
• On the Network Servers tab, select a SQL server/instance/cluster over the network.
• The latest available state — to publish data as of the latest state in the backup file.
• A point-in-time state — to publish data as of the selected point-in-time state. This option is available only
if backups of Microsoft SQL Server transaction logs exist. For more information, see Required Backup Job
Settings.
When you unpublish a database, both options continue to remain until you close the application so that you can
quickly republish a database if required.
2. On the Database tab, select Publish Database > Publish latest state to <target_server>.
Alternatively, you can right-click a database and select Publish database > Publish latest state to
<target_server>.
NOTE
The name of the publish option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Publish latest
state to <target_server>.
• If you select any other restore point, the option name is displayed as Publish state of
<point_in_time> to <target_server>.
Once this process is completed, the database will be published with the same name as it was during the initial
publishing session.
2. On the Database tab, select Publish Database > Publish point-in-time state to
<server_name>\<instance_name>.
Alternatively, you can right-click a database and select Publish database > Publish point-in-time state to
<server_name>\<instance_name>.
Once the publishing process is completed, the database will be published with the same name as it was during
the initial publishing session.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL Server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
• Upon closing the Veeam Explorer for Microsoft SQL Server console, all published databases will be
detached from the target SQL server automatically. Mount points will be also dismounted from under the
C:\VeeamFLR directory.
• On manual unpublishing, databases will be detached at once but the restore point will remain mounted on
the target machine for the next 15 minutes.
1. In the navigation pane, under the Published databases node, select a published database.
Alternatively, in the navigation pane, right-click a published database and select Unpublish database.
To detach more than one published database simultaneously, right-click the root Published databases node and
select Unpublish databases or select the root Published databases node and click Unpublish Databases on the
Publish tab.
1. In the navigation pane, under the Published databases node, select a published database.
2. On the Publish tab, select Export backup or you can right-click a database and select Export backup.
3. In the Export wizard, click Browse next to the Specify export path field to specify the location where to
export your data.
To compress data, select the Enable compression check box. Compression will be applied according to
configuration of the SQL server to which the database is published.
NOTE
Compression is unavailable if the server to which the database is published runs Microsoft SQL Server
2005 or any Express Edition of Microsoft SQL Server.
If something went wrong with any of the published databases, the question mark appears next to each of such
databases indicating the database unavailability. In the Database Info section, you will also see the notification
message describing the problem.
To refresh a published database state manually, in the navigation pane, under the Published databases node,
right-click a published database and select Refresh status.
Before performing instant recovery, read the Considerations and Limitations section.
When you start an instant recovery session in Veeam Explorer for Microsoft SQL Server, the following happens:
1. Veeam Explorer for Microsoft SQL Server uses backup files to start two iSCSI mount sessions in parallel:
o The first mount is used to publish the database on the target production server and attach it to the
target SQL Server instance.
o The second mount is used to copy database files to the target server in the background.
2. While the published database is online, all changes in database files that occur after publishing are saved
in cache on the mount server.
You can view and change the write cache location in the mount server settings. For more information, see
the Specify Mount Server Settings section of the Veeam Backup & Replication User Guide.
3. After all database files are copied to the target server, Veeam Explorer for Microsoft SQL Server uses the
cache to synchronize changes in database files.
4. After synchronization, you can switch over to the up-to-date copy of the database on the production
server. Depending on the option you choose, switchover starts in one of the following ways:
o Manually
During switchover, Veeam Explorer for Microsoft SQL Server does the following:
b. Uses the cache to synchronize differences between the published database and the copied database
files.
Instant recovery session is resilient to network disruption, backup server or mount server crash. If anything
disrupts the restore process, the restore process stays in the waiting mode and performs 10 automatic retries
every 5 minutes. If the retries fail, you can launch retry after the server or network is up.
2. On the Database tab, select Instant Recovery > Instant recovery of the latest state to <original_location>.
Alternatively, you can right-click a database and select Instant recovery > Instant recovery of the latest state to
<original_location>.
NOTE
The name of the instant recovery option depends on the restore point you select during the application
item restore process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Instant
recovery of the latest state to <original_location>.
• If you select any other restore point, the option name is displayed as Instant recovery of the state of
<point_in_time> to <original_location>.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Database tab, select Instant Recovery > Instant recovery of the point-in-time state to
<original_location>.
Alternatively, you can right-click a database and select Instant recovery > Instant recovery of the point-in-time
state to <original_location>.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
b. If you want to load database files exactly as of the moment before undesired transactions, select the
Perform restore to the specific transaction check box. Note that this option requires a staging server
where Microsoft SQL Server is deployed. For more information, see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Database tab, select Instant Recovery > Instant recovery to another server.
Alternatively, you can right-click a database and select Instant recovery > Instant recovery to another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
b. If you want to load database files exactly as of the moment before undesired transactions, select the
Perform restore to the specific transaction check box. Note that this option requires a staging server
where Microsoft SQL Server is deployed. For more information, see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the target instance to which you want to restore the database. Use the
server\instance or IP_address\instance format. You can select an instance from the drop-down
list or use the Browse button on the right.
b. You can select a SQL Server instance residing on the local machine on the Local Servers tab or click
the Network Servers tab and select an instance on another server. Veeam Explorer for Microsoft SQL
Server display servers from your network where SQL Server is installed.
2. In the Database name field, specify a name for the restored database.
3. In the Specify user account to connect section, specify credentials which will be used to connect to the
target SQL Server instance.
o Select the Use SQL Server authentication check box to use SQL Server authentication. If not selected,
Veeam Explorer for Microsoft SQL Server will use Windows authentication.
o Make sure the account has been granted the sysadmin role privileges on a target SQL server.
To edit the path, click the path row and specify the location you want to use. If specified folders do not exist,
Veeam Explorer for Microsoft SQL Server will create these folders.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
To instantly recover Microsoft SQL Server databases, follow one of these scenarios:
2. On the Instance (or Server) tab, select Instant Recovery > Instant recovery of the latest state to
<original_location>.
Alternatively, you can right-click an instance or the server and select Instant recovery > Instant recovery of the
latest state to <original_location>.
NOTE
The name of the instant recovery option depends on the restore point you select during the application
item restore process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Instant
recovery of the latest state to <original_location>.
• If you select any other restore point, the option name is displayed as Instant recovery of the state of
<point_in_time> to <original_location>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Instance (or Server) tab, select Instant Recovery > Instant recovery of the point-in-time state to
<original_location>.
Alternatively, you can right-click an instance or the server and select Instant recovery > Instant recovery of the
point-in-time state to <original_location>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
Use the slider to choose a required point in time.
If some of the databases do not have transaction log backups for the specified time, they will be displayed
below with their own time point.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Instance (or Server) tab, select Instant Recovery > Instant recovery to another server.
Alternatively, you can right-click an instance or the server and select Instant recovery > Instant recovery to
another server.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
Use the slider to choose a required point in time.
If some of the databases do not have transaction log backups for the specified time, they will be displayed
below with their own time point.
1. In the Server name field, specify the target instance to which you want to restore the database. Use the
server\instance or IP_address\instance format. You can select an instance from the drop-down
list or use the Browse button on the right.
b. You can select a SQL Server instance residing on the local machine on the Local Servers tab or click
the Network Servers tab and select an instance on another server. Veeam Explorer for Microsoft SQL
Server displays servers from your network where SQL Server is installed.
2. In the Specify user account to connect section, specify credentials which will be used to connect to the
target SQL Server instance.
o Select the Use SQL Server authentication check box to use SQL Server authentication. If not selected,
Veeam Explorer for Microsoft SQL Server will use Windows authentication.
o Make sure the account has been granted the sysadmin role privileges on a target SQL server.
To select a switchover type and start an instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Microsoft SQL Server starts publishing the database on the
target server.
In the Instant Recovery session view, you can see the progress of the recovery, edit switchover settings, cancel
instant recovery, and start manual switchover (if you have selected the Manual switchover option in the Instant
Recovery wizard).
Depending on the selected switchover option, switchover starts in one of the following ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
Depending on the option you choose in the Instant Recovery wizard, switchover starts in one of the following
ways:
• Manually
During switchover, Veeam Explorer for Microsoft SQL Server performs the following operations:
2. Uses the cache to synchronize changes between the published database and the copied database files.
Auto Switchover
The Auto switchover option ensures minimal period of downtime.
As soon as database files are copied from the mount server, Veeam Explorer for Microsoft SQL Server checks the
size of the cache that contains changes that have been made to the database since the publishing. Depending on
the cache size, the following happens:
• If the cache size is smaller than 100 MB, Veeam Explorer for Microsoft SQL Server starts the switchover
process.
• If the cache size is larger than 100 MB, Veeam Explorer for Microsoft SQL Server uses the cache to
synchronize changes and checks the cache size once again. If the cache size is smaller than 100 MB, Veeam
Explorer for Microsoft SQL Server starts the switchover process. If the cache size is larger than 100 MB
again, another cycle of synchronization is performed. Synchronization is relaunched until the cache size is
smaller than 100 MB.
Manual Switchover
After database files are copied from the mount server, Veeam Explorer for Microsoft SQL Server checks the size
of the cache that contains changes that have been made to the database since the publishing. The cache size is
checked every minute. If the cache size is larger than 100 MB or it has been 5 minutes since the last
synchronization, Veeam Explorer for Microsoft SQL Server starts to synchronize the changes between the
published database and the copied database files.
After synchronization is finished, you can launch switchover manually. For details, see Starting Switchover
Manually.
If you launch switchover during the synchronization process, switchover starts only after the synchronization is
finished.
After synchronization is finished, Veeam Explorer for Microsoft SQL Server waits for the scheduled date and
time to start switchover.
If the switchover scheduled period starts during the synchronization process, switchover starts only after the
synchronization is finished.
1. In the navigation pane, under the Instant Recovery node, select a published database.
Alternatively, you can right-click the database and select Switchover now.
Depending on the option you choose in the Instant Recovery wizard, switchover starts in one of the following
ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
Also, in the Instant Recovery session view, you can do the following:
• Retry instant recovery (in case instant recovery session fails for any reason).
NOTE
1. In the navigation pane, under the Instant Recovery node, select a published database.
2. On the Instant Recovery tab, select Edit or right-click the database or instance and select Edit.
1. In the navigation pane, under the Instant Recovery node, select the database.
You can do this by canceling instant recovery in either Veeam Explorer for Microsoft SQL Server or the
Veeam Backup & Replication console.
NOTE
• Closing either the Veeam Explorer for Microsoft SQL Server window or the
Veeam Backup & Replication console does not cancel the instant recovery session.
• You do not need to cancel the instant recovery session if switchover is already performed. The
session closes automatically after switchover.
1. In the navigation pane, under the Instant Recovery node, select a published database.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the preview pane, select the session and in the Instant Database Recovery tab click Stop Publishing.
Alternatively, you can right-click the session and click Stop publishing.
2. On the Database tab, select Export Files > Export latest state to Desktop\<db_name>.
Alternatively, right-click a database and select Export files > Export latest state to Desktop\<db_name>.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export latest
state to Desktop\<db_name>.
• If you select any other restore point, the option name is displayed as Export state of <point_in_time>
to Desktop\<db_name>.
2. On the Database tab, select Export Files > Export point-in-time state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export files > Export point-in-time state to
Desktop\<db_name>.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
2. On the Database tab, select Export Files > Export to a different location.
Alternatively, you can right-click a database and select Export files > Export to a different location.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
NOTE
The account you are using must have a sufficient permission level to access the selected directory (Read
and Write as minimum recommended).
2. On the Instance (or Server) tab, select Export Files > Export latest state to Desktop\<server_name>.
Alternatively, you can right-click an instance or the server and select Export files > Export latest state to
Desktop\<server_name>.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export latest
state to Desktop\<server_name>.
• If you select any other restore point, the option name is displayed as Export state of <point_in_time>
to Desktop\<server_name>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
2. On the Instance (or Server) tab, select Export Files > Export point-in-time state to Desktop\<db_name>.
Alternatively, you can right-click an instance or the server and select Export files > Export point-in-time state to
Desktop\<db_name>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per moment when the current restore point of a VM was created by the backup or replication job.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
Use the slider control to choose a point you need.
NOTE
The Perform restore to the specific transaction option is unavailable when exporting multiple databases.
2. On the Instance (or Server) tab, select Export Files > Export to a different location.
Alternatively, you can right-click an instance or the server and select Export files > Export to a different
location.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per moment when the current restore point of a VM was created by the backup or replication job.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
Use the slider control to choose a point you need.
NOTE
The Perform restore to the specific transaction option is unavailable when exporting multiple databases.
IMPORTANT
To export database files as BAK, make sure to configure a staging SQL server, as described in Configuring
Staging SQL Server.
2. On the Database tab, select Export Backup > Export latest state to Desktop\<db_name>.bak.
Alternatively, you can right-click a database and select Export backup > Export latest state to
Desktop\<db_name>.bak.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export latest
state to Desktop\<db_name>.bak.
• If you select any other restore point, the option name is displayed as Export state of <point_in_time>
to Desktop\<db_name>.bak.
2. On the Database tab, select Export Backup > Export point-in-time state to Desktop\<db_name>.bak.
Alternatively, you can right-click a database and select Export backup > Export point-in-time state to
Desktop\<db_name>.
• Select the Restore to the point in time of the selected image-level backup option to load data as per date
of the current restore point.
• Select the Restore to a specific point in time option to load data as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load data exactly as of the moment
before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
2. On the Database tab, select Export Backup > Export to a different location.
Alternatively, you can right-click a database and select Export backup > Export to a different location.
• Select the Restore to the point in time of the selected image-level backup option to load data as per date
of the current restore point.
• Select the Restore to a specific point in time option to load data as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load data exactly as of the moment
before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
You can select Enable compression check box to reduce the output file size.
NOTE
Compression is unavailable if the staging SQL server runs Microsoft SQL Server 2005 or any Express Edition
of Microsoft SQL Server.
2. On the Instance (or Server) tab, select Export Backup > Export latest state to Desktop\<db_name>.
Alternatively, you can right-click an instance or the server and select Export backup > Export latest state to
Desktop\<db_name>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
2. On the Instance (or Server) tab, select Export Backup > Export point-in-time state to Desktop\<db_name>.
Alternatively, you can right-click an instance or the server and select Export backup > Export point-in-time state
to Desktop\<db_name>.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per moment when the current restore point of a VM was created by the backup or replication job.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
Use the slider control to choose a point you need.
NOTE
The Perform restore to the specific transaction option is unavailable when exporting multiple databases.
2. On the Instance (or Server) tab, select Export Backup > Export to a different location.
Alternatively, you can right-click an instance or the server and select Export backup > Export to a different
location.
To quickly find the necessary databases, use the Search field or sort the databases by name. If the databases
belong to multiple instances, you can also sort the databases by instance name.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per moment when the current restore point of a VM was created by the backup or replication job.
• Select the Restore to a specific point in time option to load database files as per specified point in time.
Use the slider control to choose a point you need.
NOTE
The Perform restore to the specific transaction option is unavailable when exporting multiple databases.
You can select Enable compression check box to reduce the file size.
NOTE
Compression is unavailable if the staging SQL server runs Microsoft SQL Server 2005 or any Express Edition
of Microsoft SQL Server.
NOTE
2. On the Database tab, select Export Schema > Export database schema latest state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export schema > Export database schema latest state to
Desktop\<db_name>.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export
database schema latest state to Desktop\<db_name>.
• If you select any other restore point, the option name is displayed as Export database schema state
of <point_in_time> to Desktop\<db_name>.
2. On the Database (or Server/Instance) tab, select Export Schema > Export database schema and data.
Alternatively, you can right-click a database and select Export schema > Export database schema and data.
TIP
To import data tables, use the standard SQL server bcp.exe utility. For more information, see this Microsoft
article.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging SQL server. For more information,
see Configuring Staging SQL Server.
Veeam Explorer for Microsoft SQL Server database operations are listed in the SQL Server Database Operation
Selection section.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
To display only specific objects, click Filter and select an object type you want to be shown in the list.
<date_time> Created[/Modified]
CREATE <table_name> Table <table ID> —
<initiator>
Component Requirement
Oracle on Windows For more information on supported versions of Oracle Database, see the Supported
OS / Oracle on Applications subsection of the Veeam Backup & Replication User Guide.
Linux OS
Backup
Oracle on Windows
Backup server Source TCP, UDP 135, 137 to Ports used to deploy the runtime
machine with 139, 445 coordination process on the source
Oracle machine.
Source Backup server TCP 49152 to Dynamic RPC range used by the runtime
machine with 65535 coordination process that is deployed on
Oracle (for Microsoft the source machine for application-aware
Windows processing.1
2008 or
later)
1
If you use default Microsoft Windows firewall settings, you do not need to configure dynamic RPC ports: during setup,
Veeam Backup & Replication automatically creates a firewall rule for the runtime process. If you use firewall settings other
than default ones or application-aware processing fails with the RPC function call failed error, you need to configure
dynamic RPC ports. For more information on how to configure RPC dynamic port allocation to work with firewalls, see this
Microsoft KB article.
Backup server Source TCP 6162 Default port used by Linux Management
machine with Agent.
Oracle
Backup repository Target TCP 2500 to Default range of ports used for
Linux 3300 managing data transfer during restore
machine to the original (remote) machine or
with another Linux machine with Oracle.
Oracle
Target Linux machine with Backup TCP 2500 to Default range of ports used for
Oracle repository 3300 managing data transfer during restore
to the original (remote) machine or
another Linux machine with Oracle.
Veeam Explorer for The account used to run Veeam Explorer for Oracle must be a member of the local
Oracle launch Administrators or Users group.
Restore / Accessing To restore data, make sure to configure user accounts as follows:
Staging Server
• When restoring to a Windows-based machine, the account must be a member of
the local Administrators group on the target machine. In addition, if ASM is
used, then such an account must be a member of the ORA_ASMADMIN group
(for Oracle 12 and higher).
• When restoring to a Linux-based machine, the account must be a Linux user
with root permissions on the target machine and have membership in the
following groups: OSASM [if ASM is used] (typically asmadmin), OSDBA
(typically dba), Oracle Inventory group (typically oinstall).
Keep in mind that for restore from RMAN backups, the root privileges for the
user account are not required.
Export as database The account under which Veeam Explorer for Oracle runs must be a member of the
files local Administrators group.
If your backups were created without application-aware image processing, you can still explore them, as
described in Exploring non-Application Enabled Backups.
• If the application-aware image processing option is enabled, Veeam Explorer for Oracle obtains
application-specific Oracle database information from the Oracle VM backup metadata located in the
backup server configuration database.
• If the application-aware image processing option is disabled, Veeam Explorer for Oracle requires a staging
Oracle server to mount a selected image-level Oracle VM backup (with databases and redo logs) and
collect required information using the guest scan and Oracle infrastructure analysis.
IMPORTANT
Make sure to have your database in the OPEN state during backup. Otherwise, the following warning
message will appear in the backup job session: Oracle database instance state is not valid for property
collection. Whether the backup job completes or fails depends on the selected backup job settings. For
more information, see the Application-Aware Processing section of the Veeam Backup & Replication User
Guide.
General
• When Veeam Explorer for Oracle is installed on a server on which both Veeam Backup & Replication and
Veeam Backup for Microsoft 365 are installed, the notification settings will be inherited from the
Veeam Backup & Replication Global Notification settings.
• [Restore to Linux server] You can restore data over SSH only, restore using Linux Management Agent is
not supported.
• [Restore to Linux server] Restore with Veeam Explorer for Oracle is not supported if the SQL*Plus
environment on the target Oracle server is configured to use glogin.sql or login.sql profile files. For
details, see the Configuring SQL*Plus section of the SQL*Plus User's Guide.
• [Restore to Linux server] Restore of databases that resided in an encrypted file system on the original
server is not supported. In particular, encrypted LVM volumes are not supported.
• [For refreshable PDB] Data restore, data publishing and instant recovery are not supported for refreshable
PDBs.
• [Restore from VM backups] Mount of Btrfs disks will fail if you want to perform instant recovery, data
restore or data publish to the original server. The issue occurs due to restriction for mounting 2 Btrfs disks
with identical IDs to the same machine.
Note that Btrfs volumes on the backed-up Veeam Agent machine must have identifiers in the UUID format
in the fstab configuration file.
• Mount operations with FUSE are not supported on kernel versions 4.0.0 – 4.1.33. Make sure to upgrade
the kernel to version 4.1.37 or later.
• [For restore to Oracle ASM] You cannot specify paths and file names for restored database files. During
restore, Oracle ASM will automatically create and name the necessary files in the specified disk group
using the OMF (Oracle Managed Files) feature.
• 1-Click restore to the original location from storage snapshots is not supported.
• A point in time restore is not supported for replicas and backups stored in the DR site by backup copy jobs,
nor it is supported for backups stored in a cloud repository. Such repositories cannot be used as a
destination location for archived logs.
• Restore of databases from the current restore point is only supported for backups created by Veeam
backup job, replication job, VeeamZIP and for imported backup and storage snapshots.
• If OS authentication on a target Oracle server is disabled, the restore of databases with enabled ASM will
not be possible.
• If OS authentication on a staging Oracle server is disabled, the restore of databases with enabled ASM as
of the selected transaction state will not be possible.
• Oracle Automatic Storage Management Filter Driver (Oracle ASMFD) is not supported.
Restore from RMAN backups is not possible if OS authentication is disabled on the target Oracle server.
• Restore to original server: You must perform the restore with original name and settings.
o You must perform the restore with original name and settings.
o The Oracle home and Oracle directory structure must remain the same.
o You must copy the original control file to the target server or recovery catalog of the database which
is running in the duplicated cluster. Such a control file must contain information about backups from
which the restore is being performed.
o For Oracle ASM, the file system structure of the restored database must remain the same.
o You can restore Data Guard primary databases as primary databases only to the original location with
the original name and settings.
o You can restore Data Guard standby databases as standby databases only to the original location with
the original name and settings.
A restore with different settings will fail due to Data Guard limitations.
o Make sure that the copy of the original cluster already exists in the duplicated environment.
o You must copy the original control file to the target server or recovery catalog of the database which
is running in the duplicated cluster. Such a control file must contain information about backups from
which the restore is being performed.
o You can restore Data Guard primary databases as primary databases only with the original name and
settings.
o The Oracle home and Oracle directory structure must remain the same.
o You must copy the original control file to the target server or recovery catalog of the database which
is running in the duplicated cluster. Such a control file must contain information about backups from
which the restore is being performed.
o For Oracle ASM, the file system structure of the restored database must remain the same.
• To restore a database with different name and settings, the database must use SPFILE (server parameter
file).
• If the database that you publish is part of the ASM group, make sure that the target Oracle server also has
an ASM group properly configured.
Instant Recovery
• For Oracle Database 12c, instant recovery is supported starting from version 12.2.0.1.0.211019.
• Instant recovery is supported for image-level backups only. You cannot perform instant recovery from
RMAN backups.
• Make sure that both the backed-up Oracle machine and the target server to which you are restoring have
the same OS patch version.
• Instant recovery of the entire Oracle Data Guard is not supported. However, you can restore individual
Data Guard databases.
• During the instant recovery process, Veeam Explorer for Oracle requires 512 MB of RAM for each database.
• If you add a new pluggable database to the container during an instant recovery process, the instant
recovery session fails.
• The Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
If you open Veeam Explorer for Oracle from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
• The domain name or IP address of the backup server to which you want to connect
o To perform recovery operations, Veeam Explorer for Oracle must be run with elevated permissions.
The user account must be a member of the local Administrators group on the machine where Veeam
Explorers Suite is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Oracle is running, select Use Windows session
authentication.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu comprises the following:
• Help.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Oracle wizard or window. You will
then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon menu, which contains general program commands organized into logical groups.
• The navigation pane, which allows you to browse through the hierarchy of your backup files.
• The preview pane, which shows you the details about objects you have selected in the navigation area.
Mounting is performed by the Veeam Mount Service component which is deployed on a backup repository
machine or any other machine you define in the backup repository settings. For more information on configuring
mount server settings, see the Mount Server section of the Veeam Backup & Replication User Guide.
During mounting, Veeam Mount Service retrieves a VM file system from the backup file, attaches it to the hard
drive of a target machine and creates a mount point.
• To mount a VM file system on machines with the Microsoft Windows operating system, Veeam uses the
iSCSI protocol.
The original virtual machine or the staging server acts as an iSCSI initiator and the mount server that is
associated with the backup repository acts as an iSCSI target. The iSCSI mount point is non-persistent and
only exists during the recovery process.
NOTE
When using fine-tune restore, Veeam requires a staging Oracle server to mount the VM file system.
If the current restore point was created with Oracle Automatic Storage Management (ASM), file paths will be
displayed with the ‘+’ prefix.
• If you use the point-in-time state option of databases for restore, export, publishing and instant recovery
operations.
• To explore backups created without application-aware image processing. For more information, see
Exploring Oracle Backups.
• A staging server must be of the same Oracle version as both the source and target Oracle servers.
• If you plan to restore databases with Automatic Storage Management enabled, both staging and target
servers must have ASM enabled.
For Windows-based VM
To configure a staging server for Windows-based machines, do the following:
2. On the Staging Server tab, select the Use this helper Oracle server for advanced recovery functionality
check box and do the following:
a. In the Server name field, specify the name of the Oracle server to which you want to restore data.
Use current account. To connect to the specified server using the current user account under
which Veeam Explorer for Oracle running.
Use the following account. To connect to the specified server under a custom user account.
When using a custom account, in the Username field, specify a user name and in the Password
field, provide the password.
For Linux-based VM
To configure a staging server for Linux-based machines, do the following:
2. On the Oracle tab, select the Use this helper Oracle server for advanced recovery functionality check box
and do the following:
a. In the Server field, specify the name of the Oracle server to which you want to restore data.
c. In the Account field, specify a user account under which to connect to the specified server.
e. If the private key is required to connect to the selected server, do the following:
i. Select the Private key is required for this connection check box.
ii. In the Private key filed, specify a key. To select a key, click Browse and select a key.
4. If you specify data for a non-root account that does not have root permissions on a Linux server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. When registering a Linux-based VM, you have an option to failover to using the su command for
distros where the sudo command is not available.
To enable the failover, select the Use su if sudo is unavailable check box and in the Root password
field, enter the password for the root account.
2. On the Advanced tab, select the Enable extended logging check box and click OK.
NOTE
The heuristic analysis requires a staging Oracle server to be configured in advance. For more information,
see Configuring Staging Oracle Server.
1. In the Veeam Backup & Replication console, select the necessary backup and click Application Items >
Oracle (or Windows) on the ribbon.
2. At the Restore Point step of the Oracle Database Restore wizard, select a restore point to explore.
Veeam Backup & Replication will launch Veeam Explorer for Oracle and display the Heuristic Analysis wizard.
1. In the Server name field, specify a server name to which you want to restore data.
2. In the Specify user account to connect to server section, select one of the following:
o Use current account. To connect to the specified server using the current user account under which
Veeam Explorer for Oracle is running.
o Use the following account. To connect to the specified server under a custom user account.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
3. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
4. In the SSH port field, specify the port number of the selected Oracle server.
5. In the Account filed, specify an account under which to connect to the specified server.
7. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
Consider that the user account must be a member of the dba group.
• Oracle home. To attach a database, apply log files (if required) and make a consistency check of the
database.
o Current restore point analysis. To search for available Oracle databases within the selected restore
point only.
o Extended analysis. To search for available Oracle databases within multiple restore points.
Typically, Veeam Explorer for Oracle scans three restore points; the current restore point that you
select when opening Veeam Explorer for Oracle, and two other restore points that come before and
after the current restore point.
Once analysis is complete, Veeam Explorer for Oracle will load available Oracle databases to the program scope
automatically.
1. In the Veeam Backup & Replication console, open the Home view.
3. Right-click an RMAN backup and select Restore from Oracle RMAN backup.
IMPORTANT
Make sure to install a bash shell on a target Oracle server to perform a restore.
Consider that when restoring Data Guard to another server as described in this section, databases from Data
Guard will be restored as standalone Oracle databases preserving no Data Guard infrastructure. To restore Data
Guard infrastructure altogether, use either a latest state restore, or point-in-time restore. For more information,
see Restoring Latest State and Restoring Point-in-Time State.
2. On the Database tab, select Restore Database > Restore to another server.
Alternatively, you can right-click a database or Data Guard and select Restore database > Restore to another
server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
• The Restore to a specific point in time option is available only if archived log backups exist. For more
information, see Required Backup Job Settings.
• The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the name of the target Oracle server.
2. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Oracle is running.
You cannot use this option if Veeam Explorer for Oracle and mount server are located on separate
machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
• To copy archived logs to the specified server, the user account must be granted sufficient permissions to
access the administrative share.
1. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
2. In the SSH port field, specify the port number of the selected Oracle server.
3. In the Account filed, specify an account under which to connect to the specified server.
5. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
• Select Restore to the original location to restore the database back to the original location.
a. In the Oracle home field, specify the Oracle home directory. To locate the Oracle home directory, click
Browse and select the folder you want to use.
b. In the Global database name field, specify the global database name as DB_NAME.DB_DOMAIN,
where:
DB_NAME is the database name. Oracle limits the length of the database name to 8 characters.
If the database name you specify exceeds this limit, Veeam Explorer for Oracle will
automatically shorten the database name, and hence the global database name, during the
restore process.
The value you specify is also used for the unique database name (DB_UNIQUE_NAME). The
unique database name can contain up to 30 characters.
DB_DOMAIN is the domain name of the database. It does not count towards any character limits
and Veeam Explorer for Oracle does not shorten it during the restore process.
For example, if you specify the global database name as orcl_restored.tech.local, Veeam Explorer for
Oracle will shorten it to orcl_res.tech.local. The database name will be orcl_res, while the unique
database name will be orcl_restored.
c. In the Oracle SID field, specify the database system identifier. The Oracle SID field is automatically
filled with the value entered in the Global database name field, but you can also assign a different
value.
The maximum length of the Oracle SID is 12 characters and it can only contain alphanumeric
characters (a-z, A-Z and 0-9).
NOTE
If the account specified in the previous step is not the Oracle home user, you will be asked to provide a
password to access the target Oracle home. Applicable to Oracle 12c and later versions.
To edit the path, click the path row and provide the location you want to use.
• Data Guard will be restored starting from the primary node. Once the primary node is restored, Veeam
Explorer for Oracle will use it to restore standby nodes.
• Database files will be copied to the original location and then mounted to the original Oracle home.
• Databases from the backed-up ASM group will be restored back to the original ASM group.
• All existing databases on the target Oracle server will be replaced with databases from the backup files.
Consider that restoring a latest or point-in-time state to the original Oracle server from storage snapshots is not
supported. Use the Restore to another server command, as described in Restoring Database and Data Guard.
2. On the Database tab, select Restore Database > Restore latest state to <original_location>.
Alternatively, you can right-click a database or Data Guard and select Restore database > Restore latest state to
<original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
2. On the Database tab, select Restore Database > Restore point-in-time state.
Alternatively, you can right-click a database or Data Guard and select Restore database > Restore point-in-time
state.
IMPORTANT
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain selected database files as per selected time
interval of the current restore point. Use the slider control to choose a time interval you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
• The Restore to a specific point in time option is available only if archived log backups exist. For more
information, see Required Backup Job Settings.
• The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
• Data Guard will be restored starting from the primary node. Once the primary node is restored, Veeam
Explorer for Oracle will use it to restore standby nodes.
• Database files will be copied to the original location and then mounted to the original Oracle home.
• Databases from the backed-up ASM group will be restored back to the original ASM group.
Consider that restoring a latest or point-in-time state to the original Oracle server from storage snapshots is not
supported. Use the Restore to another server command, as described in Restoring Databases to Another Server.
2. On the Server or Oracle Home tab, select Restore Database > Restore latest state to <original_location>.
Alternatively, you can right-click the Oracle server or Oracle home and select Restore databases > Restore latest
state to <original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
2. On the Server or Oracle Home tab, select Restore Database > Restore state of <point_in_time> or right-
click a database and select Restore databases > Restore point-in-time state.
3. At this step of the Restore wizard, select a state as of which you want to restore the databases:
o Select the Restore to the point in time of the selected image-level backup option to load database
files as per date when the current restore point was created.
2. On the Server or Oracle Home tab, select Restore Databases > Restore to another server.
Alternatively, you can right-click the Oracle server or Oracle home and select Restore databases > Restore to
another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
Use the slider to choose a necessary point in time.
1. In the Server name field, specify the name of the target Oracle server.
2. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Oracle is running.
You cannot use this option if Veeam Explorer for Oracle and mount server are located on separate
machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
• To copy archived logs to the specified server, the user account must be granted sufficient permissions to
access the administrative share.
1. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
2. In the SSH port field, specify the port number of the selected Oracle server.
3. In the Account filed, specify an account under which to connect to the specified server.
5. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
o Restore to the original location: Veeam Explorer for Oracle checks if there are suitable Oracle home
directories. If yes, the databases are restored to these home directories. If no, the databases are not
restored, and Veeam Explorer for Oracle issues an error that suitable home directories have not been
found.
o Restore to a different location: Veeam Explorer for Oracle restores all databases to the custom
location. To specify the Oracle home directory, click Browse and select a folder that you want to use.
2. Click Restore.
NOTE
If the account specified in the previous step is not an Oracle home user, you will be asked to provide a
password to access the target Oracle home. Applicable to Oracle 12c and later versions.
• Restore to original server: You must perform the restore with original name and settings.
o You must perform the restore with original name and settings.
o Oracle home and Oracle directory structure must remain the same.
o You must copy the original control file to the target server.
o For Oracle ASM, the file system structure of the restored database must remain the same.
• You can restore Data Guard primary databases as primary databases only to original location.
If you restore primary databases to another server, they will be restored as standalone databases. To
convert the standalone database to Data Guard primary database, you can the configuration manually.
• You can restore Data Guard standby databases as standby databases only to original location.
3. On the Database tab, select Restore Database > Restore or right-click a database and select Restore.
1. In the Server name field, specify the name of the Oracle server to which you want to restore data.
2. In the Specify user account to connect to server section, select either of the following options:
Select this option to connect to the specified server using the current user account under which
Veeam Explorer for Oracle is running.
Select this option to connect to the specified server using a custom user account.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
1. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
2. In the SSH port field, specify the port number of the selected Oracle server.
3. In the Account filed, specify an account under which to connect to the specified server.
5. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
c. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
d. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
e. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
• Select Restore with the original name and settings to restore data using the original name and settings.
• Select Restore with different name and settings to choose custom settings:
b. In the Global database name field, specify the global database name as DB_NAME.DB_DOMAIN,
where:
DB_NAME is the database name. Oracle limits the length of the database name to 8 characters.
If the database name you specify exceeds this limit, Veeam Explorer for Oracle will
automatically shorten the database name, and hence the global database name, during the
restore process.
The value you specify is also used for the unique database name (DB_UNIQUE_NAME). The
unique database name can contain up to 30 characters.
DB_DOMAIN is the domain name of the database. It does not count towards any character limits
and Veeam Explorer for Oracle does not shorten it during the restore process.
For example, if you specify the global database name as orcl_restored.tech.local, Veeam Explorer for
Oracle will shorten it to orcl_res.tech.local. The database name will be orcl_res, while the unique
database name will be orcl_restored.
The Global database name field is available only if you have selected the Recover database to specific
point in time option at the Specify Recovery Type step.
c. In the Oracle SID field, specify the database system identifier. The Oracle SID field is automatically
filled with the value entered in the Global database name field, but you can also assign a different
value.
The maximum length of the Oracle SID is 12 characters and it can only contain alphanumeric
characters (a-z, A-Z and 0-9).
• To use the Restore with different name and settings option, make sure that Controlfile Autobackup
is enabled. For more information, see the Oracle Environment Planning section of the Veeam Plug-in
for Oracle RMAN User Guide.
• An existing Oracle SID (if any) will be replaced with that from the backup when selecting the
Restore with different name and settings option.
At this step of the wizard, specify the password for the Oracle home user.
• Select the Restore to the latest available option to restore data as of the latest available state.
• Select the Restore to the following point in time option to select a state as of which you want to restore
data:
• Select the Generate new DBID check box to generate a new DBID in addition to the new database name.
This check box is available only when using the Restore with different name and settings option at the
Specify Oracle Settings step.
• Select the Suppress RESETLOG command and do not bring the database online check box to skip the
OPEN RESETLOGS operation if it was required by the database. The database in this case remains in the
mount state.
This check box is available only when using the Restore with the original name and settings option at the
Specify Oracle Settings step.
TIP
• When restoring with the Restore with the original name and settings option, only the location for Data
files will be available for editing.
• When restoring with the Restore with different name and settings option, the location for the following
files will be available for editing:
o Control files
o Data files
o Log files
o Temp files
To change the location, click the path row and specify the path.
Channels are used to restore data in multiple threads per session. Using multiple threads allows Veeam Explorer
for Oracle to reduce the amount of time needed to complete restore sessions. For more information about
allocating channels, see the Oracle documentation.
After you have launched a publishing operation to an Oracle server, you can quickly republish the latest or
point-in-time state of the database to the same server.
During publishing, Veeam Explorer for Oracle takes the following actions:
1. Mounts VM disks from the backup file to the target Oracle server.
Mounting is done to the C:\VeeamFLR directory for Windows-based servers and the /tmp directory for
Linux-based servers.
3. Attaches associated databases directly to the target Oracle server so that you can perform required
operations using Oracle tools.
2. On the Database tab, select Publish Database > Publish to another server.
Alternatively, you can right-click a database and select Publish database > Publish to another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Use the slider control to choose a point you need.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the name of the target Oracle server.
2. In the Specify user account to connect section, select either of the following options:
o Use current account. Select this option to connect to the specified server using the account under
which Veeam Explorer for Oracle is running.
You cannot use this option if Veeam Explorer for Oracle and mount server are located on separate
machines.
o Use the following account. Select this option to connect to the specified server using a custom user
account. Then provide a user name and password for the account.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
• To copy archived logs to the specified server, the user account must be granted sufficient permissions to
access the administrative share.
1. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
2. In the SSH port field, specify the port number of the selected Oracle server.
3. In the Account filed, specify an account under which to connect to the specified server.
5. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
• Select Restore to the original location to publish the database to the original location.
a. In the Oracle home field, specify the Oracle home directory. To locate the Oracle home directory, click
Browse and select the folder you want to use.
b. In the Global database name field, specify the global database name as DB_NAME.DB_DOMAIN,
where:
DB_NAME is the database name. Oracle limits the length of the database name to 8 characters.
If the database name you specify exceeds this limit, Veeam Explorer for Oracle will
automatically shorten the database name, and hence the global database name, during the
publishing process.
The value you specify is also used for the unique database name (DB_UNIQUE_NAME) of the
published database. The unique database name can contain up to 30 characters.
DB_DOMAIN is the domain name of the database. It does not count towards any character limits
and Veeam Explorer for Oracle does not shorten it during the publishing process.
For example, if you specify the global database name as orcl_published.tech.local, Veeam Explorer for
Oracle will shorten it to orcl_pub.tech.local. The database name of the published database will be
orcl_pub, while the unique database name of the published database will be orcl_published.
c. In the Oracle SID field, specify the database system identifier. The Oracle SID field is automatically
filled with the value entered in the Global database name field, but you can also assign a different
value.
The maximum length of the Oracle SID is 12 characters and it can only contain alphanumeric
characters (a-z, A-Z and 0-9).
After you complete this step, a new Published databases node appears at the top of the navigation pane in
Veeam Explorer for Oracle. Under this node you can find the databases that have been published during the
current session.
If the account specified in Specify Target Oracle Server is not the Oracle home user, you will be asked to
provide a password to access the target Oracle home. Applicable to Oracle 12c and later versions.
• The latest available state — to publish data as of the latest state in the backup file.
• A point-in-time state — to publish data as of the selected point-in-time state. This option is available only
if backups of Oracle archive logs exist. For more information, see Required Backup Job Settings.
When you unpublish a database, both options continue to remain until you close the application so that you can
quickly republish a database if required.
2. On the Database tab, select Publish Database > Publish latest state to <target_server>.
Alternatively, you can right-click a database and select Publish database > Publish latest state to
<target_server>.
NOTE
The name of the publish option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Publish latest
state to <target_server>.
• If you select any other restore point, the option name is displayed as Publish state of
<point_in_time> to <target_server>.
Once completed, the database will be published with the same name as it was during the initial publishing
session.
2. On the Database tab, select Publish Database > Publish point-in-time state to <server_name>.
Alternatively, you can right-click a database and select Publish database > Publish point-in-time state to
<server_name>.
Once completed, the database will be published with the same name as it was during the initial publishing
session.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
• Upon closing the Veeam Explorer for Oracle console, all published databases will be detached from the
target Oracle server automatically. Mount points will be also dismounted from under the C:\VeeamFLR
directory for Windows-based servers and the /tmp directory for Linux-based servers.
• On manual unpublishing, databases will be detached at once but the restore point will remain mounted on
the target server for the next 15 minutes.
1. In the navigation pane, under the Published databases node, select a published database.
Alternatively, in the navigation pane, right-click a published database and select Unpublish.
To detach more than one published database simultaneously, right-click the root Published databases node and
select Unpublish databases or select the root Published databases node and click Unpublish Databases on the
Publish tab.
1. In the navigation pane, under the Published databases node, select a published database.
2. On the Publish tab, select Export as RMAN backup or right-click a published database and select Export as
RMAN backup.
3. In the Export wizard, in the Export path field, specify the location to which you want to export database
files.
If the folder you are specifying does not exist, it will be created.
4. In the File name format field, specify the format according to which your files will be named after the
export.
For more information, see this Oracle article.
5. In the Tag to label output file with field, specify a new tag name.
6. To compress files using native Oracle compression, select the Enable native compression check box.
7. In the Channels number numeric field, specify the number of channels to be used when retrieving Oracle
databases from the backup.
8. Click Export.
If something went wrong with any of the published databases, the question mark appears next to each of such
databases indicating the database unavailability. In the Database Info section, you will also see the notification
message describing the problem.
To refresh a published database state manually, in the navigation pane, under the Published databases node,
right-click a published database and select Refresh status.
Before performing instant recovery, read the Considerations and Limitations section.
When you start the instant recovery session in Veeam Explorer for Oracle, the following happens:
1. Veeam Explorer for Oracle uses backup files to publish the database on the target production server
directly from backup.
2. While the published database is online, Veeam Explorer for Oracle starts to create a copy of the database
on the target Oracle server.
3. All changes in database files that occur after publishing are saved in cache.
[For Windows-Based Oracle server] The instant recovery write cache is stored on the mount server. You
can view and change the write cache location in the mount server settings. For more information, see the
Specify Mount Server Settings section of the Veeam Backup & Replication User Guide.
[For Linux-Based Oracle server] The instant recovery write cache is stored on the target server.
4. After all database files are copied to the target server, Veeam Explorer for Oracle uses archived redo logs
to synchronize changes in database files.
5. After synchronization, you can switch over to the up-to-date copy of the database on the production
server. Depending on the option you choose, switchover starts in one of the following ways:
o Manually
b. Uses redo logs to synchronize differences between the published database and the copied database
files.
Instant recovery session is resilient to network disruption, backup server or mount server crash. If anything
disrupts the restore process, the restore process stays in the waiting mode and performs 10 automatic retries
every 5 minutes. If the retries fail, you can launch retry after the server or network is up.
1. In the navigation tree of Veeam Explorer for Oracle, select a server or Oracle home.
2. On the Server or the Oracle Home tab, select one of the following options:
o Instant Recovery > Instant Recovery of the latest state to <original server> or right-click the server or
Oracle home and select Instant recovery > Instant recovery of the latest state to <original server>.
o Instant Recovery > Instant Recovery of the point-in-time state to <original server> or right-click a
server or Oracle home and select Instant recovery > Instant recovery of the point-in-time state to
<original server>.
o Instant Recovery > Instant Recovery to another server or right-click a server or Oracle home and
select Instant recovery > Instant recovery to another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
Use the slider to choose a required point in time.
NOTE
If you have selected to perform instant recovery of databases latest state to original server, skip this step
and go to Specify Switchover Settings.
At this step, specify connection settings required to access the target Oracle server. The set of connection
settings depends on the OS type of the target server: Windows or Linux.
1. In the Server name field, specify the name of the target Oracle server.
2. In the Specify user account to connect section, enter credentials to connect to the target Oracle server.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
• To copy archived logs to the specified server, the user account must be granted sufficient permissions to
access the administrative share.
3. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
4. In the SSH port field, specify the port number of the selected Oracle server.
5. In the Account filed, specify an account under which to connect to the specified server.
7. If you have specified a non-root account that does not have root permissions on the target server, click
Advanced to grant sudo rights to this account.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
Consider that the user account must be a member of the dba group.
At this step of the wizard, select a location to which you want to restore databases:
• Restore to the original location — to restore databases back to the original location.
• Restore to a different location — to restore databases to a custom location. To locate an Oracle home
directory for restored databases, click Browse and select a folder you want to use.
NOTE
If the account specified in Specify Target Server is not the Oracle home user, you will be asked to provide a
password to access the target Oracle home. Applicable to Oracle 12c and later versions.
To select a switchover option and start the instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Oracle starts publishing the database on the target server.
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Database tab, select Instant Recovery > Instant Recovery of the latest state to <original_location>,
or you can right-click a database and select Instant Recovery > Instant recovery of the latest state to
<original_location>.
NOTE
The name of the instant recovery option depends on the restore point you select during the application
item restore process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Instant
recovery of the latest state to <original_location>.
• If you select any other restore point, the option name is displayed as Instant recovery of the state of
<point_in_time> to <original_location>.
3. In the Instant Recovery wizard, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
4. Click Recover.
After you click Recover, Veeam Explorer for Oracle starts publishing the database on the target server.
5. Depending on the option you choose in the Instant Recovery wizard, switchover starts in one of the
following ways:
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Database tab, select Instant Recovery > Instant recovery of point-in-time state to <original
server>.
Alternatively, you can right-click a database and select Instant recovery > Instant recovery of point-in-time
state to <original server>.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
This option is available only if archived log backups exist. For more information, see Required Backup Job
Settings.
b. If you want to load database files exactly as of the moment before undesired transactions, select the
Perform restore to the specific transaction check box. Note that this option requires a staging Oracle
server. For more information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
To select a switchover option and start the instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Oracle starts publishing the database on the target server.
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
2. On the Database tab, select Instant Recovery > Instant Recovery to another server.
Alternatively, you can right-click a database and select Instant recovery > Instant recovery to another server.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
Note that this option is available only if archived log backups exist. For more information, see Required
Backup Job Settings.
b. If you want to load database files exactly as of the moment before undesired transactions, select the
Perform restore to the specific transaction check box. Note that this option requires a staging Oracle
server. For more information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Server name field, specify the name of the target Oracle server.
2. In the Specify user account to connect section, enter credentials to connect to the target Oracle server.
• The user account must be a member of the local Administrators group and have sysdba privileges.
• The user account must be granted appropriate permissions to access Oracle databases; Read and Write are
minimum required, Full Control is recommended.
• To copy archived logs to the specified server, the user account must be granted sufficient permissions to
access the administrative share.
3. In the Server drop-down list, specify a target Oracle server. You can select an Oracle server from the list or
enter a DNS name of the target Oracle server.
4. In the SSH port field, specify the port number of the selected Oracle server.
5. In the Account filed, specify an account under which to connect to the specified server.
a. To provide a non-root user with root account privileges, select the Elevate specified account to root
check box.
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If the sudo command is not available or may fail on the target Linux server, you have an option to use
the su command instead. To enable the su command, select the Use su if sudo is unavailable check
box and enter the password for the root account in the Root password field.
a. Select the Private key is required for this connection check box.
Consider that the user account must be a member of the dba group.
• Select Restore to the original location to restore the database back to the original location.
a. In the Oracle home field, specify the Oracle home directory. To locate the Oracle home directory, click
Browse and select the folder you want to use.
b. In the Global database name field, specify the global database name as DB_NAME.DB_DOMAIN,
where:
DB_NAME is the database name. Oracle limits the length of the database name to 8 characters.
If the database name you specify exceeds this limit, Veeam Explorer for Oracle will
automatically shorten the database name, and hence the global database name, during the
publishing process.
The value you specify is also used for the unique database name (DB_UNIQUE_NAME) of the
published database. The unique database name can contain up to 30 characters.
DB_DOMAIN is the domain name of the database. It does not count towards any character limits
and Veeam Explorer for Oracle does not shorten it during the publishing process.
For example, if you specify the global database name as orcl_published.tech.local, Veeam Explorer for
Oracle will shorten it to orcl_pub.tech.local. The database name of the published database will be
orcl_pub, while the unique database name of the published database will be orcl_published.
c. In the Oracle SID field, specify the database system identifier. The Oracle SID field is automatically
filled with the value entered in the Global database name field, but you can also assign a different
value.
The maximum length of the Oracle SID is 12 characters and it can only contain alphanumeric
characters (a-z, A-Z and 0-9).
If the account specified in Specify Target Oracle Server is not the Oracle home user, you will be asked to
provide a password to access the target Oracle home. Applicable to Oracle 12c and later versions.
To edit the path, click the path row and provide the location you want to use. If specified folders do not exist,
Veeam Explorer for Oracle will create these folders.
To select a switchover option and start the instant recovery session, do the following:
1. At the Specify switchover type field, select one of the following switchover options:
o Auto: switchover is performed automatically after all database files are copied and synchronized.
o Manual: switchover is started manually by user at any time after all database files are copied and
synchronized.
o Scheduled: switchover is performed at a specified date and time. Use the drop-down calendar to
specify the date and time.
2. Click Recover.
After you click Recover, Veeam Explorer for Oracle starts publishing the database on the target server.
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
Depending on the option you choose in the Instant Recovery wizard, switchover starts in on of the following
ways:
• Manually
During switchover, Veeam Explorer for Oracle performs the following operations:
2. Uses archived redo logs to synchronize changes between the published database and the copied database
files.
Note that the database will be offline between the steps 1–4.
Auto Switchover
The Auto switchover option ensures minimal period of downtime.
As soon as database files are copied from backup files, Veeam Explorer for Oracle uses archived redo logs to find
differences between the published database and the recovered database. Depending on the size of differences
in archived redo logs, the following happens:
• If the size of differences in archived redo logs is smaller than 10 MB, Veeam Explorer for Oracle starts the
switchover process. In this case, the databases are synchronized during switchover.
• If the size of differences in archived redo logs is larger than 10 MB, Veeam Explorer for Oracle uses redo
logs to synchronize the changes.
After synchronizations, checks the size of differences in archived redo logs once again. If the size is smaller
than 10 MB, Veeam Explorer for Oracle starts the switchover process. If the size is larger than 10 MB
again, another cycle of synchronization is performed. Synchronization is relaunched until the size of
differences in logs is smaller than 10 MB.
Scheduled Switchover
After database files are copied from backup files, Veeam Explorer for Oracle uses archived redo logs to find
differences between the published database and the recovered database. Veeam Explorer for Oracle checks the
size of differences every minute. If the size is larger than 10 MB or it has been 5 minutes since the last
synchronization, Veeam Explorer for Oracle starts to synchronize the changes between the published database
and the copied database files.
After synchronization is finished, Veeam Explorer for Oracle waits for the scheduled date and time to start
switchover.
Manual Switchover
After database files are copied from backup files, Veeam Explorer for Oracle uses archived redo logs to find
differences between the published database and the recovered database. Veeam Explorer for Oracle checks the
size of differences every minute. If the size is larger than 10 MB or it has been 5 minutes since the last
synchronization, Veeam Explorer for Oracle starts to synchronize the changes between the published database
and the copied database files.
After synchronization is finished, you can launch switchover manually. For details, see Starting Switchover
Manually.
If you launch switchover during the synchronization process, switchover starts only after the synchronization is
finished.
1. In the navigation pane, under the Instant Recovery node, select a published database.
Alternatively, you can right-click the database and select Switchover now.
Depending on the option you choose in the Instant Recovery wizard, switchover starts in one of the following
ways:
• Manually
If you have selected the Manual switchover option, you must perform switchover manually as described in
Starting Switchover Manually.
Also, in the Instant Recovery session view, you can do the following:
• Retry instant recovery (in case instant recovery session fails for any reason).
NOTE
1. In the navigation pane, under the Instant Recovery node, select a published database.
2. On the Instant Recovery tab, select Edit or right-click the database or instance and select Edit.
1. In the navigation pane, under the Instant Recovery node, select the database.
You can do this by canceling instant recovery in either Veeam Explorer for Oracle or the
Veeam Backup & Replication console.
NOTE
• Closing either the Veeam Explorer for Oracle window or the Veeam Backup & Replication console
does not cancel the instant recovery session.
• You do not need to cancel the instant recovery session if switchover is already performed. The
session closes automatically after switchover.
1. In the navigation pane, under the Instant Recovery node, select a published database.
1. In the Veeam Backup & Replication console, open the Home view.
3. In the preview pane, select the session and in the Instant Database Recovery tab click Stop Publishing.
Alternatively, you can right-click the session and click Stop publishing.
During the export, Veeam Explorer for Oracle does the following:
• Uses native Oracle RMAN to retrieve Oracle databases from the backup that is being explored.
The retrieved databases are then saved onto a staging server as RMAN backups.
When exporting published databases, then such databases are saved directly to the server onto which
they are published.
2. On the Database tab, select Export as RMAN backup > Export latest state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export as RMAN backup > Export latest state to
Desktop\<db_name>.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export latest
state to Desktop\<db_name>.
• If you select any other restore point, the option name is displayed as Export state of <point_in_time>
to Desktop\<db_name>.
Consider that Veeam Explorer for Oracle exports files in the following format: _%I_%d_%T_%U. For more
information, see this Oracle article. To set a different export format, use Exporting to Custom Location.
2. On the Database tab, select Export as RMAN backup > Export point-in-time state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export as RMAN backup > Export point-in-time state to
Desktop\<db_name>.
Consider that Veeam Explorer for Oracle exports files in the following format: _%I_%d_%T_%U. For more
information, see this Oracle article. To set a different export format, use Exporting to Custom Location.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
2. On the Database tab, select Export as RMAN backup > Export to a different location.
Alternatively, you can right-click a database and select Export as RMAN backup > Export to a different location.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
1. In the Export path field, specify the location to which you want to export database files.
If the folder you are specifying does not exist, it will be created.
2. In the File name format field, specify the format according to which your files will be named after the
export.
For more information, see this Oracle article.
3. In the Tag to label output file with field, specify a new tag name.
4. To compress files using native Oracle compression, select the Enable native compression check box.
5. In the Channels number numeric field, specify the number of channels to be used when retrieving Oracle
databases from the backup.
6. Click Export.
2. On the Database tab, select Export Database Files > Export latest state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export database files > Export latest state to
Desktop\<db_name>.
NOTE
The name of the export option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Export latest
state to Desktop\<db_name>.
• If you select any other restore point, the option name is displayed as Export state of <point_in_time>
to Desktop\<db_name>.
2. On the Database tab, select Export Database Files > Export point-in-time state to Desktop\<db_name>.
Alternatively, you can right-click a database and select Export database files > Export point-in-time state to
Desktop\<db_name>.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
2. On the Database tab, select Export Database Files > Export to a different location.
Alternatively, you can right-click a database and select Export database files > Export to a different location.
• Select the Restore to the point in time of the selected image-level backup option to load database files as
per date of the current restore point.
• Select the Restore to a specific point in time option to load database files as per selected point in time.
• Select the Perform restore to the specific transaction check box to load database files exactly as of the
moment before undesired transactions.
NOTE
The Perform restore to the specific transaction option requires a staging Oracle server. For more
information, see Configuring Staging Oracle Server.
NOTE
This step is available only if you have selected the Perform restore to the specific transaction check box at
the Specify Restore Point step of the wizard.
Component Requirement
PostgreSQL on For more information on supported versions of PostgreSQL, see the Supported
Linux Applications subsection of the Veeam Backup & Replication User Guide.
Backup
Backup server Source Linux TCP 6162 Default port used by Linux Management
machine with Agent.
PostgreSQL
Source Linux Log shipping TCP 2500 to For archive logs shipping
machine with server, 3300
PostgreSQL backup Default range of ports used for managing
repository data transfer over the network.
Backup server, Mount TCP 6170 Port used for connections to the
Veeam Backup & Replication server mount service.
console
Backup repository Target TCP 2500 to Default range of ports used for
Linux 3300 managing data transfer during restore
machine to the original (remote) machine or
with another Linux machine with
PostgreSQL PostgreSQL.
Target Linux machine with Backup TCP 2500 to Default range of ports used for
PostgreSQL repository 3300 managing data transfer during restore
to the original (remote) machine or
another Linux machine with
PostgreSQL.
Veeam Explorer for The account used to run Veeam Explorer for PostgreSQL must be a member of the
PostgreSQL launch local Administrators or Users group.
Restore The account used for PostgreSQL data recovery must be a Linux user with root
privileges on the target machine. Root privileges are required to mount the backed-up
file system to the target server and to communicate with PostgreSQL.
When you create a backup job, make sure to enable the application-aware image processing option. For more
information, see the Specify Guest Processing Settings section of the Veeam Backup & Replication User Guide.
• With Veeam Explorer for PostgreSQL, you can restore and publish entire PostgreSQL instances; restore
and publishing of individual databases is not supported.
• Veeam Explorer for PostgreSQL does not support restore over VIX API or vSphere Automation API.
• High availability cluster configurations and replication setups of PostgreSQL servers are not supported.
• Restore of databases that reside in an encrypted file system on the source machine is not supported. In
particular, encrypted LVM volumes are not supported.
• You can restore a PostgreSQL instance over SSH only, restore using Linux Management Agent is not
supported.
• If you specify another data directory for the restored PostgreSQL instance, services will not be created
automatically (including systemd).
• Mount of Btrfs disks will fail if you perform data restore or data publish to the original server. The issue
occurs due to restriction for mounting 2 Btrfs disks with identical IDs to the same machine.
• Before you restore a PostgreSQL instance to another server, make sure PostgreSQL is installed on the
target machine.
• Veeam Explorer for PostgreSQL does not support configuration sub-files (include files such as
include_if_exist, include_dir and so on). All PostgreSQL configurations, instance ports in
particular, must be specified in a single postgresql.conf file.
• PostgreSQL on the target machine must be of the same major version as PostgreSQL on the original
machine. For example, you can restore a PostgreSQL instance based on PostgreSQL 14.1 to a machine with
PostgreSQL 14.3.
• The account that you use to connect to the target server must have root privileges to mount the backed-
up file system to the target server and to communicate with PostgreSQL.
• To restore or publish a specific point-in-time state of a PostgreSQL instance, backups of PostgreSQL WAL
archive logs must exist. To enable PostgreSQL WAL log archiving, PostgreSQL instances must have the
replica WAL logging level or higher. The minimal logging level does not write information about database
transactions and it allows you to create a crash-consistent backup only.
• [For Debian] When you restore a PostgreSQL instance to a new data directory, Veeam Explorer for
PostgreSQL saves PostgreSQL configuration files to the specified data directory (not to the
/etc/postgresql directory). In this case, you will not be able to discover the recovered PostgreSQL
instance with the pg_lsclusters utility.
• The Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
o Domain name or IP address of the backup server to which you want to connect
o Port number
To use the account under which Veeam Explorer for PostgreSQL is running, select Use Windows
session authentication.
Consider the following:
To perform recovery operations, run Veeam Explorer for PostgreSQL with elevated permissions.
The user account must be a member of the local Administrators group on the machine where
Veeam Explorers are installed.
The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu comprises the following:
• General Options. Allows you to enable extended logging. For more information, see Enabling Extended
Logging.
• Help.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for PostgreSQL wizard or window.
You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon that contains operation commands organized into logical groups represented as tabs. The
ribbon is displayed at the top of the main application window.
• The navigation pane that allows you to browse through the hierarchy of folders with backed-up data.
• The preview pane that allows you to view details about items that are contained in a folder you have
selected in the navigation pane.
Mounting is performed by the Veeam Mount Service component which is deployed on a backup repository
machine or any other machine you define in the backup repository settings. For more information on configuring
mount server settings, see the Mount Server section of the Veeam Backup & Replication User Guide.
During mounting, Veeam Mount Service retrieves a VM file system from the backup file, attaches it to the hard
drive of a target machine and creates a mount point. To mount a VM file system to the target VM,
Veeam Backup & Replication uses FUSE.
2. On the Advanced tab, select the Enable extended logging check box and click OK.
2. On the Instance tab, select Restore Instance > Restore latest state to <original_location>.
Alternatively, you can right-click an instance and select Restore instance > Restore latest state to
<original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
2. On the Instance tab, select Restore Instance > Restore point-in-time state to <server_name>.
Alternatively, you can right-click an instance and select Restore Instance > Restore point-in-time state to
<server_name>.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
The Restore to a specific point in time option is available only if backups of PostgreSQL archive logs exist.
For more information, see Required Backup Job Settings.
5. Specify tablespaces.
2. On the Instance tab, select Restore Instance > Restore to another server.
Alternatively, you can right-click an instance and select Restore Instance > Restore to another server.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
The Restore to a specific point in time option is available only if backups of PostgreSQL archive logs exist.
For more information, see Required Backup Job Settings.
1. In the Server field, enter a DNS name or IP address of the target server.
2. In the SSH port field, specify an SSH port (by default, port 22 is used).
3. In the Account filed, specify a Linux system account name under which to connect to the specified server.
4. If you have specified a non-root account that does not have root privileges on the target server, click
Advanced:
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If you plan to use the account to connect to Linux servers where the sudo command is not available
or may fail, you have an option to use the su command instead. To enable the su command, select
the Use su if sudo is unavailable check box and in the Root password field, enter the password for the
root account.
Veeam Backup & Replication will first try to use the sudo command. If the attempt fails,
Veeam Backup & Replication will use the su command.
b. Select the Private key is required for this connection check box.
c. In the Private key filed, specify a file that contains a private key.
To locate a file, click Browse and select a key.
o Select Restore to the original location to restore the PostgreSQL instance to the original data
directory.
o Select Restore to a different location and specify a path in the Data directory path field to restore the
PostgreSQL instance to another directory. To locate a new directory, click Browse and select a folder
you want to use.
2. In the Instance port field, specify an instance port, which will also serve as an instance identifier. The port
must be free. If the specified port is occupied, the recovered PostgreSQL will be shut down.
To start the PostgreSQL instance manually, do the following:
For example:
At this step of the wizard, select one of the following post-restore actions that the PostgreSQL instance must
take after the instance is restored:
• Select Promote the PostgreSQL server to accept connections once recovery is finished to make the
PostgreSQL instance available for connections.
• Select Pause recovery process and keep the PostgreSQL server in recovery mode to make the PostgreSQL
instance run but not accepting incoming remote TCP connections.
To resume the paused state, use the pg_wal_replay_resume() command:
• Select Shut down the PostgreSQL server once recovery process is completed to make the PostgreSQL
instance stop upon recovery.
In this case, you will need to start the PostgreSQL instance manually:
For example:
2. On the Server tab, select Restore Instances > Restore latest state to <original_location>.
Alternatively, you can right-click the server and select Restore instances > Restore latest state to
<original_location>.
NOTE
The name of the restore option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Restore latest
state to <original_location>.
• If you select any other restore point, the option name is displayed as Restore state of
<point_in_time> to <original_location>.
2. On the Server tab, select Restore Instances > Restore point-in-time state to <server_name>.
Alternatively, you can right-click an instance and select Restore Instances > Restore point-in-time state to
<server_name>.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
The Restore to a specific point in time option is available only if backups of PostgreSQL archive logs exist.
For more information, see Required Backup Job Settings.
2. On the Server tab, select Restore Instances > Restore to another server.
Alternatively, you can right-click an instance and select Restore Instances > Restore to another server.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
The Restore to a specific point in time option is available only if backups of PostgreSQL archive logs exist.
For more information, see Required Backup Job Settings.
1. In the Server field, enter a DNS name or IP address of the target server.
2. In the SSH port field, specify an SSH port (by default, port 22 is used).
3. In the Account filed, specify a Linux system account name under which to connect to the specified server.
4. If you have specified a non-root account that does not have root privileges on the target server, click
Advanced:
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If you plan to use the account to connect to Linux servers where the sudo command is not available
or may fail, you have an option to use the su command instead. To enable the su command, select
the Use su if sudo is unavailable check box and in the Root password field, enter the password for the
root account.
Veeam Backup & Replication will first try to use the sudo command. If the attempt fails,
Veeam Backup & Replication will use the su command.
b. Select the Private key is required for this connection check box.
c. In the Private key filed, specify a file that contains a private key.
To locate a file, click Browse and select a key.
After you have launched a publishing operation to a PostgreSQL server, you can quickly republish the latest or
point-in-time state of the PostgreSQL instance to the same server.
During publishing, Veeam Explorer for PostgreSQL takes the following actions:
1. Mounts VM disks from the backup file to the /tmp directory on the target PostgreSQL machine.
3. Attaches the associated instance directly to the target PostgreSQL server so that you can perform required
operations using PostgreSQL tools.
The publishing session is resilient to network disruption, backup server or mount server crash. All changes in
database files that occur after publishing are saved in the publishing write cache, which is stored on the target
server. If anything disrupts the publishing process (the target or mount server crashes, or the network is down),
you can launch the retry manually after the server or network is up.
2. On the Instance tab, select Publish Instance > Publish to another server.
Alternatively, you can right-click an instance and select Publish Instance > Publish to another server.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
The Restore to a specific point in time option is available only if backups of PostgreSQL archive logs exist.
For more information, see Required Backup Job Settings.
1. In the Server field, enter a DNS name or IP address of the target server.
2. In the SSH port field, specify an SSH port (by default, port 22 is used).
3. In the Account filed, specify a Linux system account name under which to connect to the specified server.
4. If you have specified a non-root account that does not have root privileges on the target server, click
Advanced:
b. To add the user account to the sudoers file, select the Add account to the sudoers file automatically
check box. In the Root password field, enter the password for the root account.
If you do not enable this option, you will have to manually add the user account to the sudoers file.
c. If you plan to use the account to connect to Linux servers where the sudo command is not available
or may fail, you have an option to use the su command instead. To enable the su command, select
the Use su if sudo is unavailable check box and in the Root password field, enter the password for the
root account.
Veeam Backup & Replication will first try to use the sudo command. If the attempt fails,
Veeam Backup & Replication will use the su command.
b. Select the Private key is required for this connection check box.
c. In the Private key filed, specify a file that contains a private key.
To locate a file, click Browse and select a key.
The specified port must be free. If the port is occupied, Veeam Explorer for PostgreSQL will display an error.
• The latest available state — to publish data as of the latest state in the backup file.
• A point-in-time state — to publish data as of the selected point-in-time state. This option is available only
if backups of PostgreSQL archive logs exist. For more information, see Required Backup Job Settings.
When you unpublish an instance, both options continue to remain until you close the application so that you can
quickly republish a database if required.
2. On the Instance tab, select Publish Instance > Publish latest state to <target_server>.
Alternatively, you can right-click an instance and select Publish instance > Publish latest state to
<target_server>.
NOTE
The name of the publish option depends on the restore point you select during the application item restore
process in the Veeam Backup & Replication console.
• If you select the most recent available restore point, the option name is displayed as Publish latest
state to <target_server>.
• If you select any other restore point, the option name is displayed as Publish state of
<point_in_time> to <target_server>.
Once completed, the instance will be published with the same settings as you specified during the initial
publishing session.
To publish a PostgreSQL instance as of the point-in-time state, use the Publish wizard.
2. On the Instance tab, select Publish Instance > Publish point-in-time state to <server_name>.
Alternatively, you can right-click an instance and select Publish Instance > Publish point-in-time state to
<server_name>.
• Select the Restore to the point in time of the selected image-level backup option to load instance files as
per date when the current restore point was created.
• Select the Restore to a specific point in time option to obtain instance files as per selected time interval of
the current restore point. Use the slider control to choose a time interval you need.
• Upon closing the Veeam Explorer for PostgreSQL console, all published instances will be detached from
target servers automatically. Mount points will be also dismounted from under the /tmp directory.
• On manual unpublishing, instances will be detached at once but the restore point will remain mounted on
the target server for the next 15 minutes.
1. In the navigation pane, under the Published instances node, select a published instance.
Alternatively, in the navigation pane, right-click a published database and select Cancel.
To detach more than one published instance simultaneously, right-click the root Published instances node and
select Cancel or select the root Published instances node and click Cancel on the Publish tab.
Component Requirement
• To work with database files, Veeam Explorer for Microsoft Exchange requires a dynamic link library ese.dll
supplied with Microsoft Exchange. The ese.dll file must be of the same version as that of Microsoft
Exchange in which database files were created.
• To restore mailbox items from a server running Microsoft Windows ReFS, the backup server or
Veeam Backup & Replication console must be installed on a machine that runs Microsoft Windows Server
2012 or later.
• To restore mailbox items from a server running Microsoft Windows ReFS 3.x, the backup server or
Veeam Backup & Replication console must be installed on a machine that runs Microsoft Windows Server
2016 or later, and the ReFS version must be supported on this machine.
• To restore data that was backed up by Veeam Backup for Microsoft 365 v1.5 using PowerShell, make sure
to install Windows PowerShell 2.0 or later.
• Restore of mailbox datastore from backups created by Veeam Agent for Microsoft Windows 2.0 or later
requires integration with Veeam Backup & Replication to be set up. For more information, see the Using
with Veeam Backup & Replication section of the Veeam Agent for Microsoft Windows User Guide.
Backup
Backup Source TCP, UDP 135, 137 to Ports used to deploy the runtime
server, guest Windows 139, 445 coordination process on the source
interaction machine with machine.
proxy Microsoft
(Enterprise Exchange
and TCP 6005 to The dynamic RPC range that is used by
Enterprise 65535 the runtime coordination process which is
Plus editions) deployed on the source machine for
application-aware processing (when
working over the network).
Source Backup TCP 6005 to The dynamic RPC range that is used by
Windows server, guest 65535 the runtime coordination process which is
machine with interaction deployed on the source machine for
Microsoft proxy application-aware processing (when
Exchange (Enterprise working over the network).
and
Enterprise Note: Microsoft Exchange (in particular,
Plus editions) Client Access) expands standard Windows
dynamic RPC port range to provide better
scalability. For more information, see this
Microsoft article.
NOTE
Configuring dynamic RPC range is not required when using default Microsoft Windows firewall settings as
Veeam Backup & Replication automatically creates an associated firewall rule for the runtime process
during installation. When using custom firewall settings or if application-aware processing fails with the
RPC function call failed error, make sure to configure dynamic RPC ports manually. For more information,
see this Microsoft article.
Backup server, Target Microsoft TCP 443 Port used for Microsoft Exchange
Veeam Backup & Replication Exchange web services connections.
console 2013/2016/2019
CAS server
Restore to Microsoft 365 and To restore data to Microsoft 365 and on-premises Microsoft Exchange
on-premises Microsoft organizations, you must grant the following roles and permissions to user
Exchange accounts:
The account used to log in to Microsoft 365 must be assigned the following
roles:
• ApplicationImpersonation role. For more information, see this
Microsoft article.
• Global Administrator or Exchange Administrator role.
Also make sure that the required settings are specified for the Azure AD
application used for restore. For more information, see the Configuring
Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
Compare Data with Production The Veeam Backup account must have a valid Exchange Online license and
Environment an active mailbox within the Microsoft 365 organization.
For more information about the Add-RoleGroupMember cmdlet, see this Microsoft article.
For more information about the Add-MailboxPermission cmdlet, see this Microsoft article.
To grant Full Access to the account that does not own a mailbox (in particular, through impersonation), use the
following cmdlet:
For more information about the New-ManagementRoleAssignment cmdlet, see this Microsoft article.
Remove-ManagementRoleAssignment "<role_name>"
When you create a backup job, make sure to enable the application-aware image processing option. For more
information, see the Specify Guest Processing Settings section of the Veeam Backup & Replication User Guide.
NOTE
By default, Exchange transaction logs will be truncated upon successful backup. To keep transaction logs
for further processing by a third-party application, select the Exchange server VM from the list, click Edit
and on the General tab select Perform copy only.
General
When Veeam Explorer for Microsoft Exchange is installed on a server on which both
Veeam Backup & Replication and Veeam Backup for Microsoft 365 are installed, the notification settings will be
inherited from the Veeam Backup & Replication Global Notification settings.
Restore
• Veeam Explorer for Microsoft Exchange does not support restore using PowerShell Direct, VIX API or
vSphere Automation API.
• Sending objects that exceed 3 MB in size may fail. To fix this issue, install this Microsoft update.
• Bulk restore (restore of multiple objects) is not supported for public folder mailboxes. Use the regular
per-object restore instead.
• Mailboxes can be restored only to mailboxes of the same type. For example, a user mailbox to a user
mailbox, an archive mailbox to an archive mailbox.
• To restore In-Place Hold Items or Litigation Hold Items to the original location, consider the following:
o In-Place Hold Items restore is not supported for On-Premises Exchange Server 2013 due to EWS
limitations.
o To restore In-Place Hold Items of Exchange 2016 mailboxes, these mailboxes must have In-Place Hold
enabled and applied at least once with DiscoveryHolds system folder creation. Otherwise, restore will
fail with the following error:
"Failed to restore In-Place Hold Items. Restore of In-Place Hold Items into Exchange 2013 is not
supported".
For information on enabling In-Place Hold and Litigation Hold, see this Microsoft article.
• [For Veeam Explorer for Microsoft Exchange that comes with Veeam Backup & Replication] Restore of an
entire mailbox or selected mailbox items to the original location is available with Veeam Universal License.
When using a legacy socket-based license, the Enterprise or Enterprise Plus editions
of Veeam Backup & Replication is required.
NOTE
To use an internet proxy server to restore backups created by Veeam Backup for Microsoft 365, make sure
to provide appropriate proxy server address and the port number. To do this,go to the Control Panel >
Internet Options Connections tab, click LAN Settings, select the Use a proxy server for your LAN check box
and specify a proxy server you want to use. Credentials for such a proxy (if needed) will be taken from the
Control Panel > Credential Manager > Windows Credentials console.
Consider that this functionality is only available in Veeam Explorer for Microsoft Exchange that comes as
part of the Veeam Backup for Microsoft 365 installation package.
NOTE
For Outlook for Microsoft 365, only the Semi-Annual Enterprise Channel is supported. For more
information, see this Microsoft article.
• To avoid conflicts during export, make sure to exclude PST files from the indexing scope. Oftentimes
conflicts may occur due to a file you are exporting is being indexed at the same time. When exporting to
shared folders, exclude Outlook files or disable Windows search on the destination computer.
• The Explore option to load backups created by Veeam Backup for Microsoft 365. For more information,
see the Data Restore section of the Veeam Backup for Microsoft 365 User Guide.
When loading backups located in object storage, Veeam Explorer for Microsoft Exchange will notify you
about the location of these backups. You can select the Don't show this message again check box to
unsubscribe from such notifications. To disable these notifications, clear the Show pop-up notifications on
startup check box. For more information, see Advanced Settings.
• The Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
• Go to Start, click Veeam Explorer for Microsoft Exchange and manually open Microsoft Exchange
databases. For more information, see Standalone Databases and External Servers.
When you open Veeam Explorer for Microsoft Exchange from the Start menu, all backed-up databases will
be loaded automatically.
If you open Veeam Explorer for Microsoft Exchange from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
o To perform restore operations, Veeam Explorer for Microsoft Exchange must be run with elevated
permissions. The user account must be a member of the local Administrators group on the machine
where Veeam Explorer for Microsoft Exchange is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft Exchange is running, select Use Windows
session authentication.
Main Menu
The main menu comprises the following:
• General Options. Allows you to configure general application settings. For more information, see General
Application Settings.
• Help.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft Exchange wizard or
window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon that contains operation commands organized into logical groups represented as tabs. The
ribbon is displayed at the top of the main application window.
• The navigation pane that allows you to browse through the hierarchy of folders with backed-up data.
Also, it allows you to search for mailboxes using keywords.
• The preview pane that provides search capabilities and allows you to view details about items that are
contained in a folder you have selected in the navigation pane.
After you select an object in the navigation pane, you can see its content in the preview pane.
1. In the navigation pane, select an object in which you want to find data.
2. Enter a search query in the search field at the top of the preview pane.
NOTE
To find the exact phrase, use double quotes. For example, "Microsoft 365".
For example, to find messages with the subject Report, do the following:
1. In the preview pane, select a node and click Advanced Find on the ribbon.
2. In the Define search criteria section, select Category > All fields.
To remove a filter, click the cross mark on the left. To remove all configured filters, click Reset.
The ese.dll file must be of the same version as the Microsoft Exchange application that was used to create a
database. When restoring a VM that was backed up with application-aware image processing, the ese.dll file
will be located automatically.
3. Click the link next to the Microsoft Exchange version and specify the path to the ese.dll file.
This file can be found on the Microsoft Exchange server distribution CD in the
X:\Setup\ServerRoles\Common\ese.dll directory or in the installation directory of the Microsoft Exchange
server.
4. Click OK.
3. Select the Configure SMTP settings check box and do the following:
a. In the Server field, specify a DNS name or IP address of the SMTP server.
b. In the Port field, specify a port number of the specified SMTP server.
The default port number is 25. If you want to use SSL data encryption, specify port 587.
d. If the specified SMTP server requires an authentication for outgoing mail, select the Use
authentication check box and provide valid credentials.
e. Select the Enable SSL security check box to enable SSL data encryption.
5. Click OK.
3. If you want to see the estimated size of the Outlook database file in the status bar, select the Show PST
size estimation in status bar check box.
4. If you want to enable extended logging mode to collect logs that contain additional information on
specific operations, select the Enable extended logging check box.
After enabling extended logging mode, you can go back to the application and perform actions for which
you want to collect additional information. Then you can collect logs.
5. By default, Veeam Explorer for Microsoft Exchange displays notifications when loading backups created
by Veeam Backup for Microsoft 365 from object storage. If you want to disable these notifications, clear
the Show pop-up notifications on startup check box.
6. Click OK.
Veeam Explorer for Microsoft Exchange supports adding databases created with the following Microsoft
Exchange versions:
Veeam Explorer for Microsoft Exchange supports adding databases created with the following Microsoft
Exchange versions:
NOTE
• Before adding databases, make sure that Veeam Explorer for Microsoft Exchange has access to the
ese.dll file. For more information, see Extensible Storage Engine.
• If a database is in Dirty State, you will need to recover it by applying log files. Click Recover and wait
until log files are applied, then re-add the database. Make sure that the Write permission is granted
to the account being used.
• Make sure you have disabled the Veeam Backup Proxy for Microsoft Office 365 service when adding
local databases. You can stop this service by using the services.msc console. If you try to add a
database having this service still in progress, you will receive an error message and will not be able
to access the database due to database lock.
o On the Home tab, click Add Store > Microsoft Exchange mailbox database on the ribbon.
o Right-click the All Stores node and select Add Microsoft Exchange mailbox database.
2. Click Browse to specify the path to the .edb or .adb file and Exchange logs folder.
o On the Home tab, click Add Store > Veeam Backup for Microsoft 365 server on the ribbon.
o Right-click the All Stores node and select Add Veeam Backup for Microsoft 365 server.
2. Specify a server name or IP address and enter credentials to access the specified server.
Select the Use Windows session authentication check box to connect with the user account under which
you are currently logged in.
3. Click Connect.
NOTE
Make sure that both Veeam Explorer for Microsoft Exchange and Veeam Backup & Replication are installed
on the same server and at least one service provider is added to Veeam Backup & Replication. For more
information, see the Connecting to Service Providers section of the Veeam Cloud Connect Guide.
To add Veeam Backup for Microsoft 365 service providers, do the following:
o On the Home tab, click Add Store > Veeam Backup for Microsoft 365 service provider on the ribbon.
o Right-click the All Stores node and select Add Veeam Backup for Microsoft 365 service provider.
2. From the Select service provider and authentication method drop-down list, select a service provider that
you want to add and select an authentication method that can be either Modern authentication or Basic
authentication.
3. [For Modern authentication] Select a region to which a Microsoft 365 organization of the selected service
provider belongs.
4. [For Modern authentication] Copy the device code and use it to sign in to Azure Active Directory.
For Basic authentication, you must enter a user name and password to connect to the service provider
server.
NOTE
You cannot use Basic authentication to load backups if a Microsoft 365 organization has been added
to the service provider infrastructure using Modern authentication.
5. Select a point-in-time state as of which you want to load Microsoft 365 backups.
6. Select the Show items that have been deleted by user check box to see all the items that were removed.
7. Select the Show all versions of items that have been modified by user check box if you want to load
modified versions.
To remove a store from the application scope, right-click a store in the navigation pane and select Remove
store.
Veeam Explorer for Microsoft Exchange allows you to perform granular restore of Microsoft Exchange data. You
can restore data of mailboxes and mailbox folders as well as specific emails, calendar items, contacts, tasks,
notes, journal items, and so on.
When you perform a restore, you can specify a target mailbox, select an authentication method that you want to
use for data restore, specify a target folder to which you want to restore data and configure restore options.
You can also use 1-Click Restore if you do not want to configure a restore session and prefer to use the default
settings during a restore.
1. In the navigation pane, select a mailbox, folder or item that you want to restore.
o On the Mailbox/Folder/Items tab, click Restore Mailbox/Restore Folder/Restore Item > Restore to on
the ribbon.
1. In the Mailbox field, enter a mailbox name to which you want to restore data.
You can specify any name that you want. You can also restore a mailbox to a different organization. For
example, you have backed up a mailbox [email protected]. To restore such a mailbox to
a different organization, you can specify, for example, [email protected] to restore a
mailbox to the xyz.onmicrosoft.com organization.
2. Select Microsoft 365 to restore the specified mailbox to an Exchange Online organization with enabled
multi-factor authentication (MFA) and enabled or disabled security defaults. For more information, see
the Microsoft 365 Organizations section of the Veeam Backup for Microsoft 365 User Guide.
You can also perform a restore of backups created for Exchange Online organizations to on-premises
Microsoft Exchange servers and vice versa. For more information, see Restore to On-Premises Microsoft
Servers.
Modern Authentication
To use modern authentication, do the following:
1. From the Specify authentication method drop-down list, select Modern authentication.
This will allow Veeam Backup for Microsoft 365 to use an Azure AD application for data restore. Such an
application is used to restore the specified mailbox back to Microsoft 365 organizations with enabled
multi-factor authentication (MFA) and enabled or disabled security defaults. For more information, see
the Microsoft 365 Organizations section of the Veeam Backup for Microsoft 365 User Guide.
2. From the Region drop-down list, select a region to which your Exchange Online organization belongs.
3. In the Organization name field, enter a name of your Exchange Online organization.
Make sure that the organization name matches the name specified at the previous step of the wizard.
4. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Exchange populates this field with an identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
1. From the Specify authentication method drop-down list, select Basic authentication.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
At this step of the wizard, specify a CAS server and provide a folder to which you want to restore data. You can
perform a restore to the original folder or specify a custom folder.
2. Select a folder to which you want to restore data. You can perform a restore to the original folder or
specify a custom folder.
When you select to restore to a custom folder, Veeam Explorer for Microsoft Exchange checks if the
specified folder exists, if not, it creates a folder automatically. For example, if you specify a path like
Folder1/Folder2/Folder3, Veeam Explorer for Microsoft Exchange will restore your data to the Folder3.
You can use both the slash ("/") and the backslash ("\") characters when specifying a path.
At this step of the wizard, select a target folder to which you want to restore the specified mailbox. You can
perform a restore to the original folder or specify a custom folder.
When you select to restore to a custom folder, Veeam Explorer for Microsoft Exchange checks if the specified
folder exists, if not, it creates a folder automatically. For example, if you specify a path like
Folder1/Folder2/Folder3, Veeam Backup for Microsoft 365 will restore your data to the Folder3. You can use
both the slash ("/") and the backslash ("\") characters when specifying a path.
• Changed items
Select this check box if you want to restore items that have been changed. When you select this option,
Veeam Explorer for Microsoft Exchange overwrites existing items in your target location.
• Missing Items
Select this check box if you want to restore items that are missing in your target location. For example,
some of the items were removed and you want to restore them from the backup.
Select this check box if you want to mark each restored item as unread.
If you restore a mailbox, to prevent certain folders from being restored, click the Exclude folders link and select
folders to exclude.
NOTE
The Exclude folders link is not available when restoring folders and items.
1. In the navigation pane, select an organization whose mailboxes you want to restore.
Modern Authentication
To use modern authentication, do the following:
1. From the Specify authentication method drop-down list, select Modern authentication.
This will allow Veeam Backup for Microsoft 365 to use an Azure AD application for data restore. Such an
application is used to restore the specified mailbox back to Microsoft 365 organizations with enabled
multi-factor authentication (MFA) and enabled or disabled security defaults.
For more information, see the Microsoft 365 Organizations section of the Veeam Backup for Microsoft 365
User Guide.
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Exchange populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
1. From the Specify authentication method drop-down list, select Basic authentication.
2. In the Username and Password fields, enter credentials to connect to the Exchange organization.
Make sure that the account that you use has both the Exchange Administrator and the Global
Administrator roles.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
To see the full email address in the Email column, click Resolve selected mailboxes.
• Changed items
Select this check box if you want to restore items that have been changed. When you select this option,
Veeam Explorer for Microsoft Exchange overwrites existing items in your target location.
• Missing Items
Select this check box if you want to restore items that are missing in your target location. For example,
some of the items were removed and you want to restore them from the backup.
Select this check box if you want to mark each restored item as unread.
When restoring multiple mailboxes, select the Finish the restore of recent items before restoring the remaining
items check box and set the value in the Restore items for the last <N> days first field to restore multiple
mailboxes in "chunks", when the most recent items in the backup will be processed first.
To prevent certain folders from being restored, click the Exclude folders link and select folders to exclude.
When you perform a restore, you can specify a target mailbox, select an authentication method that you want to
use for data restore, specify a target folder to which you want to restore data and configure restore options.
You can also use 1-Click Restore if you do not want to configure a restore session and prefer to use the default
settings during a restore.
1. In the navigation pane, select a mailbox, folder or item that you want to restore.
o On the Mailbox/Folder/Items tab, click Restore Mailbox/Restore Folder/Restore Item > Restore to on
the ribbon.
1. In the Mailbox field, enter a mailbox name to which you want to restore data.
2. Select On-premises Microsoft Exchange Server to restore the specified mailbox to an on-premises
Microsoft Exchange organization. For more information, see the On-Premises Microsoft Organizations
section of the Veeam Backup for Microsoft 365 User Guide.
You can also perform a restore of backups created for on-premises Microsoft Exchange organizations to
Exchange Online organizations and vice versa. For more information, see Restore to Microsoft 365
Organizations.
2. Select a folder to which you want to restore data. You can perform a restore to the original folder or
specify a custom folder.
When you select to restore to a custom folder, Veeam Explorer for Microsoft Exchange checks if the
specified folder exists, if not, it creates a folder automatically. For example, if you specify a path like
Folder1/Folder2/Folder3, Veeam Explorer for Microsoft Exchange will restore your data to the Folder3.
You can use both the slash ("/") and the backslash ("\") characters when specifying a path.
• Changed items
Select this check box if you want to restore items that have been changed. When you select this option,
Veeam Explorer for Microsoft Exchange overwrites existing items in your target location.
• Missing Items
Select this check box if you want to restore items that are missing in your target location. For example,
some of the items were removed and you want to restore them from the backup.
Select this check box if you want to mark each restored item as unread.
If you restore a mailbox, to prevent certain folders from being restored, click Exclude folders and select folders
to exclude.
NOTE
The Exclude folders link is not available when restoring folders and items.
1. In the navigation pane, select a mailbox store whose mailboxes you want to restore.
To see the full email address in the Email column, click Resolve selected mailboxes.
• Changed items
Select this check box if you want to restore items that have been changed. When you select this option,
Veeam Explorer for Microsoft Exchange overwrites existing items in your target location.
• Missing Items
Select this check box if you want to restore items that are missing in your target location. For example,
some of the items were removed and you want to restore them from the backup.
Select this check box if you want to mark each restored item as unread.
When restoring multiple mailboxes, select the Finish the restore of recent items before restoring the remaining
items check box and set the value in the Restore items for the last <N> days first field to restore multiple
mailboxes in "chunks", when the most recent items in the backup will be processed first.
To prevent certain folders from being restored, click the Exclude folders link and select folders to exclude.
• The original Exchange server, original folder and the original mailbox name are restored.
You can use 1-Click Restore when you do not want to configure a restore session and prefer to restore data with
the default settings.
1. In the navigation pane, select a mailbox, folder or item that you want to restore.
o On the Mailbox/Folder/Items tab, click Restore Mailbox/Restore Folder/Restore Item > Restore to
<mailbox_name> on the ribbon.
Modern Authentication
To use modern authentication, do the following:
1. From the Specify authentication method drop-down list, select Modern authentication.
This will allow Veeam Backup for Microsoft 365 to use an Azure AD application for data restore. Such an
application is used to restore the specified mailbox back to Microsoft 365 organizations with enabled
multi-factor authentication (MFA) and enabled or disabled security defaults. For more information, see
the Microsoft 365 Organizations section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Exchange populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
1. From the Specify authentication method drop-down list, select Basic authentication.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has both the ApplicationImpersonation and the Exchange
Administrator roles. For more information, see this Microsoft article.
1. In the navigation pane, select a mailbox, folder or item that you want to restore.
o On the Mailbox/Folder/Items tab, click Restore Mailbox/Restore Folder/Restore Item > Restore to
<mailbox_name> on the ribbon.
NOTE
Export operations require Microsoft Outlook to be installed on a computer running Veeam Explorer for
Microsoft Exchange.
o In the navigation pane, select a folder, a mailbox, a mailbox store or all stores added to the scope.
a. In the Export location field, specify the name and location for the new PST file.
b. Select the Apply filter check box and enter keywords to export only those items that match specified
criteria. To provide multiple keywords, use the OR logical operator as the delimiter.
Veeam Explorer for Microsoft Exchange will check for the specified keywords in all fields such as
From, To, Subject and Body.
The Apply filter option is only available when exporting folders and mailboxes, not items.
NOTE
Export operations require Microsoft Outlook to be installed on a computer running Veeam Explorer for
Microsoft Exchange.
o Select a folder and on the Folder tab, click Export Folder > Export to
<default_location>\<original_folder_name>.pst on the ribbon.
o Select an item and on the Items tab, click Export Items > Export to
<default_location>\<original_folder_name>.pst on the ribbon.
o Select a mailbox and on the Mailbox tab, click Export Mailbox > Export to
<default_location>\<original_mailbox_name>.pst on the ribbon.
• To export a mailbox store or all stores added to the scope, in the navigation pane, do one of the following:
o Select a store or the All Stores node and on the Home tab, click Export Stores > Export to
<default_location>\<original_store_name>.pst on the ribbon.
• If you want export reports to be delivered, make sure to configure an SMTP server in Veeam Explorer for
Microsoft Exchange or Veeam Backup & Replication notification settings.
For more information, see the SMTP Settings section of this guide and the Configuring Global Email
Notification Settings section of the Veeam Backup & Replication User Guide.
• A server with Veeam Explorer for Microsoft Exchange and Veeam Backup & Replication must be in a
domain.
o The recipient is always the current user account under which Veeam Explorer for Microsoft Exchange
is running when using only Veeam Explorer for Microsoft Exchange notification settings.
o The recipient is always the user account provided in Veeam Backup & Replication notification settings
when using only Veeam Backup & Replication settings.
o If you have configured both Veeam Explorer for Microsoft Exchange and Veeam Backup & Replication
notification settings, the report will be sent to both recipients.
NOTE
If you export Microsoft Exchange data using PowerShell cmdlets and you have a restore session
started for Veeam Backup for Microsoft 365, the report will only be sent to the user account
provided in Veeam Explorer for Microsoft Exchange notification settings.
The following table lists fields that are shown in the report.
Version Shows the Veeam Explorer for Microsoft Exchange build number.
Percent completed Shows the number of items included in the PST file.
Stores Shows a datastore name from which items have been exported.
Mailboxes to search Shows a mailbox name from which items have been exported.
NOTE
The Veeam Backup account you want to use for data compare, must have a valid Exchange Online license
and an active mailbox within the Microsoft 365 organization. For more information about the required
permissions, see Permissions.
1. In the navigation pane, select an object and click Compare with Production on the ribbon.
2. Proceed to either Compare to Microsoft 365 Organizations or Compare to On-Premises Microsoft Servers.
3. After the authorization process is complete, click Show Changed Items Only on the ribbon to view only
those items that have been changed.
To view the details on what exactly has changed since the last backup, right-click an item and select Compare
item properties. The discrepancies will be shown in the Compare Message Properties window. If both objects are
equal, nothing will be displayed.
To show unchanged objects, select Show unchanged properties in the top-right corner. To show system
properties, select Show system properties.
To compare a single item, right-click an item and select Compare item properties.
To compare data with your production Microsoft 365 organizations, do the following:
Modern Authentication
To use modern authentication, do the following:
1. From the Specify authentication method drop-down list, select Modern authentication.
This will allow Veeam Backup for Microsoft 365 to use an Azure AD application for data restore. Such an
application is used to restore the specified mailbox back to Microsoft 365 organizations with enabled
multi-factor authentication (MFA) and enabled or disabled security defaults. For more information, see
the Microsoft 365 Organizations section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Exchange populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
1. From the Specify authentication method drop-down list, select Basic authentication.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has both the ApplicationImpersonation and the Exchange
Administrator roles. For more information, see this Microsoft article.
1. In the navigation pane, select a folder and then in the preview pane, select an item.
o On the Items tab, click Save Items > Save to .msg file on the ribbon.
o On the Items tab, click Save Items > Save to <folder_name> on the ribbon.
A <folder_name> name depends on the latest location that was used when saving items.
TIP
Before sending documents, make sure to configure SMTP settings. The amount of data you can send at a
time depends on your SMTP server configuration. For more information about configuring SMTP settings,
see SMTP Settings.
o On the Items tab, click Send Items > Send to on the ribbon.
Component Requirement
NOTE
• To restore SharePoint content database items from a server running Microsoft Windows ReFS, the
backup server or Veeam Backup & Replication console must be installed on the Microsoft Windows
Server 2012 or later.
• To restore from a server running Microsoft Windows ReFS 3.x, Veeam backup server or a
management console must be installed on the Microsoft Windows Server 2016.
General
Backup server, Staging TCP, UDP 135, 445 Ports used to deploy the
Veeam Backup & Replication server runtime coordination process
console, mount server on the target machine.
associated with the backup
repository
TCP 49152 to Dynamic RPC range used by
65535 the runtime coordination
(for Microsoft process that is deployed on
Windows the target machine.1
2008 or
later) For more information, see this
Microsoft article.
1
If you use default Microsoft Windows firewall settings, you do not need to configure dynamic RPC ports: during setup,
Veeam Backup & Replication automatically creates a firewall rule for the runtime process. If you use firewall settings other
than default ones or application-aware processing fails with the RPC function call failed error, you need to configure
dynamic RPC ports. For more information on how to configure RPC dynamic port allocation to work with firewalls, see this
Microsoft KB article.
NOTE
To restore database items or lists to a server that is running in a DMZ, the SharePoint web application ports
will be used.
iSCSI Traffic
Staging Mount server TCP 3260 to 3270 Ports used by iSCSI initiator to connect to
server associated the iSCSI target.
with the
backup
repository
• The current account can only be used to access a local staging server. To connect to a remote server, use
appropriate authentication credentials to access that server.
• The account requires the sysadmin fixed server role on a staging Microsoft SQL server.
o When using Windows Authentication, you can use both your current account or provide another
account.
When you create a backup job, make sure to enable the application-aware image processing option. For more
information, see the Specify Guest Processing Settings section of the Veeam Backup & Replication User Guide.
The server you plan to use as a staging system must conform to the following requirements:
• A staging system must have the same or later version of Microsoft SQL Server that hosts restored
Microsoft SharePoint databases.
• Microsoft SQL Server that is included in Microsoft SQL Server Failover Cluster cannot be used as a staging
system.
• Nodes participating in AlwaysOn Availability Groups are supported. However, you should not use
Availability Group Listeners as staging servers.
NOTE
You can use Microsoft SQL Server 2012/2016 Express editions which are shipped with the
Veeam Backup & Replication distribution package. Consider that due to Express edition limitations, the
maximum database size that can be attached is 10 GB. For more information, see this Microsoft article.
IMPORTANT
RBS FILESTREAM is the only provider that is supported in the current version.
Make sure the staging Microsoft SQL Server configuration meets the following requirements:
1. FILESTREAM is enabled on a database server. For more information, see the following articles:
o For SQL Server 2017 for Windows, see this Microsoft article.
General
Consider the following:
• When Veeam Explorer for Microsoft SharePoint is installed on a server on which both
Veeam Backup & Replication and Veeam Backup for Microsoft 365 are installed, the notification settings
will be inherited from the Veeam Backup & Replication Global Notification settings.
• Restore using PowerShell Direct, VIX API or vSphere Automation API is not supported.
• Restore of backed-up Microsoft SharePoint data to another Microsoft organization cannot be performed to
a target Microsoft SharePoint organization whose version is earlier than the version of the restored
backups.
• To use an internet proxy server to restore backups created by Veeam Backup for Microsoft 365, make sure
to provide appropriate proxy server address and the port number. To do this, go to the Control Panel >
Internet Options Connections tab, click LAN Settings, select the Use a proxy server for your LAN check box
and specify a proxy server you want to use. Credentials for such a proxy (if needed) will be taken from the
Control Panel > Credential Manager > Windows Credentials console.
Using an internet proxy server is only possible in Veeam Explorer for Microsoft SharePoint that comes as
part of the Veeam Backup for Microsoft 365 distribution package.
• For VMs that run Microsoft SQL Server backed up by Veeam Agent for Microsoft Windows and Microsoft
SharePoint backed up by Veeam Backup & Replication, to perform SharePoint item restore, you must start
Veeam Explorer for Microsoft SharePoint from the Veeam Backup Browser. To do this, start File Level
Recovery for the backup of the required SQL Server VM, and then launch Veeam Explorer for Microsoft
SharePoint from the toolbar in the Veeam Backup Browser.
If you start item-level recovery directly for the backup of the SharePoint VM, mapping of a SharePoint site
to a content database in the Restore wizard will fail, and Veeam Backup & Replication will display the
following error: "Unable to find SQL Server VM hosting the content database for the selected SharePoint
site".
Backup of the same VM by both Veeam Backup & Replication and Veeam Agent for Microsoft Windows
may be required, for example, if Microsoft SQL Server running on the VM operates as part of a failover
cluster.
• If a document/item was in Check Out state when the backup was created, the last version of the item will
not be restored to the target SharePoint and will be available for viewing only. Previous versions (if any)
will be restored.
• If the Declare this item as a record action was originally applied to list item, the relevant status will not be
preserved. Instead, the restored item status will be set in accordance with the target list/library content
approval workflow.
• Restoring Generic List and Pages Library may fail with the "No content type 'XXX' found in web YYY" error.
• The Created By field of restored documents is updated with the account performing restore.
• Make sure to view information about unsupported Microsoft SharePoint lists before restoring them. In
particular, hidden lists are not displayed in Veeam Explorer for Microsoft SharePoint after a site backup.
Thus, such lists cannot be exported. For more information, see Unsupported SharePoint Lists.
• Creates the latest version of the item anew using data from the backup.
• If not, the created version is deleted and item versions are restored sequentially.
• If a list or list items column is used as a lookup column in the dependent list, consider that restoring an
item from the source list causes the relevant items deletion in the dependent list.
• If a lookup column in the dependent list has the enforced relationship behavior set to Cascade Delete,
then restoring an item from the source list may cause item deletion in the dependent list due to Microsoft
implementation. For more information, see this Microsoft article.
To prevent this issue, you should turn off enforced relationship behavior. As a work-around, you can roll-back
the SharePoint database using Veeam Explorer for Microsoft SQL Server (see this section) or roll-back the whole
SharePoint server VM to the desired state using any Veeam Backup & Replication recovery option.
• If a lookup column in the dependent list has the enforced relationship behavior set to Restrict Delete, then
item restore with Veeam Explorer for Microsoft SharePoint will fail.
• If an .ASPX page references an item using ItemID, this reference may fail to restore (as the item will be
created anew with a different ItemID).
• If a list item cannot be deleted (for example, the Welcome page of the site), consider that restore process
will restore all versions of the item sequentially without deletions, adding them to Version History.
• If the retention policy for target list/document library was configured to Declare record automatically,
only the last version of the item will be restored to target list/library. Target retention policy settings will
be applied to restored item (Declare record). However, links (attachments) will not be restored.
• Alternatively (with different retention policy settings), all versions of the original item will be restored to
target list/library; item links (attachments) will be restored only if such item does not exist on target
SharePoint.
• If Declare this item as a record action was originally applied to list item, such item will not be restored.
Restore of Surveys
Consider the following limitations when planning for the restore of surveys, survey questions and responses:
• Survey items can be restored to a new survey, created automatically by Veeam Explorer for Microsoft
SharePoint in the specified destination instead of the previously deleted survey. However, if a new survey
is created by user from scratch (not replacing a deleted one) – items cannot be restored to such a survey.
• A survey can be restored to an existing target survey only if that target survey includes at least one item
(question) same as survey questions stored in the content database.
• If a survey question was not answered completely in the source survey, after restore the response status
in the target survey will be set to Completed, anyway.
• When restoring a single response to a survey, target response item with the same number will be deleted
and restored item will be placed in the target survey after the last numbered response.
For example, if the target survey has responses #1-15 and you try to restore a response that used to be #6
on source – then target response #6 will be deleted and restored response will be assigned #16.
Restore of Sites
Consider the following:
• When restoring site collections, make sure that such collections exist in the target location; Veeam
Explorer for Microsoft SharePoint does not create site collections.
• If you plan to restore SharePoint site pages, consider that Veeam Explorer for Microsoft SharePoint does
not support restore of items which are not stored in the SharePoint content database (in particular, pages,
page references and items based on default templates). Such items cannot be restored (neither by Restore
nor by Save menu option), except for data from Wiki Content (text and images) which is stored in the
database. Thus, site pages containing only text and images can be restored and displayed properly.
• In case you attempt to restore such items, the following error message will be logged: "Item
<item> is skipped: restoration of items based on SharePoint default template is not
supported."
• In case you attempt to save such items, the following error message will be logged: "Unable
to save document <item>. Document content is not available."
• In on-premises Microsoft SharePoint organizations, importing exported Picture Library may result in IDs
changed for some items.
• Importing exported Project Tasks list does not preserve column order.
• Export is unavailable for backups created by Veeam Backup for Microsoft 365. The operation is available
only for backups created by Veeam Backup & Replication.
• Make sure to view information about unsupported Microsoft SharePoint lists before exporting them. In
particular, hidden lists are not displayed in Veeam Explorer for Microsoft SharePoint after a site backup.
Thus, such lists cannot be exported. For more information, see Unsupported SharePoint Lists.
• If source column (field) data type was set to Lookup, but the referenced list/library was deleted, such
columns (fields) will not be restored even if you restore that referenced list. The reason is that if
referenced list is deleted, the reference (link) to that list is no longer valid.
• If source column (field) data type was set to Managed Metadata, such columns (fields) will not be
restored.
Workflow-Related Considerations
You may need to restore the items originally belonging to a list with no content approval required, to another
list. If you try to restore such items to a list that requires content approval, item version and status will be
modified in the following way:
• If a target list is configured to include major versions only, then all versions of restored item will become
major (despite the original versioning); item status will be set to Pending.
• If a target list is configured to include both major and minor versions, then all versions of restored item
will become minor (despite the original versioning); item status will be set in the following way:
o If the last version (original) was major — status will be set to Pending.
• If the retention policy for target list/document library is configured to Declare record automatically, only
the last version of the item will be restored to target list/library. Target retention policy settings will be
applied to restored item (Declare record). Besides, if Require content approval for submitted items was
enabled for the original list, then after restore item status will be set to Pending.
• Alternatively (with different retention policy settings), all versions of the original item will be restored to
target list/library. Besides, if Require content approval for submitted items was enabled for the original
list, then after restore item status in the content approval workflow will be also restored, except for the
states listed. For more information, see Status Restore Limitations.
Due to Veeam Explorer for Microsoft SharePoint that is distributed as a part of Veeam Backup & Replication
does not process hidden lists, such lists are also included in the following table.
1
For more information, see this Microsoft article.
• The Explore option to load backups created by Veeam Backup for Microsoft 365. For more information,
see the Data Restore section of the Veeam Backup for Microsoft 365 User Guide.
When loading backups located in object storage, Veeam Explorer for Microsoft SharePoint will notify you
about the location of these backups. You can select the Don't show this message again check box to
unsubscribe from such notifications. To disable these notifications, clear the Show pop-up notifications on
startup check box. For more information, see Advanced Settings.
• The Restore application item option to load backups created by Veeam Backup & Replication.
For more information, see the Application Items Restore section of the Veeam Backup & Replication User
Guide.
• Go to Start, click Veeam Explorer for Microsoft SharePoint and manually open Microsoft SharePoint
databases. For more information, see Standalone Databases.
When you open Veeam Explorer for Microsoft SharePoint from the Start menu, all backed-up databases
will be loaded automatically.
If you open Veeam Explorer for Microsoft SharePoint from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
o To perform restore operations, Veeam Explorer for Microsoft SharePoint must be run with elevated
permissions. The user account must be a member of the local Administrators group on the machine
where Veeam Explorer for Microsoft SharePoint is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft SharePoint is running, select Use Windows
session authentication.
Main Menu
The main menu comprises the following:
• General Options. Allows you to configure general application settings. For more information, see General
Application Settings.
• Help.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft SharePoint wizard or
window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon that contains operation commands organized into logical groups represented as tabs. The
ribbon is displayed at the top of the main application window.
• The navigation pane that allows you to browse through the hierarchy of folders with backed-up data.
Also, it allows you to search for sites using keywords.
• The preview pane that provides search capabilities and allows you to view details about items that are
contained in a folder you have selected in the navigation pane.
After you select an object in the navigation pane, you can see its content in the preview pane.
To open a document using an associated application, right-click a document in the preview pane and select
Open.
1. In the navigation pane, select an object in which you want to find data.
2. Enter a search query in the search field at the top of the preview pane.
NOTE
To find the exact phrase, use double quotes. For example, "media player".
You can narrow your search results by specifying various search criteria using the criteria:value format.
For example, you can use status:pending approval to find all items that require approval in the list of decisions.
You can also use logical upper-cased operators such as AND, OR and NOT along with wildcard characters such as
* and ?. The search criteria are similar to those used for searching in Microsoft SharePoint. For more information,
see this Microsoft article.
For example, to find an object that starts with the word Media, do the following:
1. In the preview pane, select a node and click Advanced Find on the ribbon.
2. In the Define search criteria section, select Category > Document fields.
NOTE
Configuring the staging SQL server settings is only required to restore SharePoint data from the following
sources:
• If an SQL server belongs to a trusted domain, only the SQL Server authentication method is available.
• If both an SQL server and the machine running Veeam Explorer for Microsoft SharePoint belong to the
same domain, then both Windows and SQL Server authentication methods are possible.
To use Windows authentication, make sure to configure the following delegation settings:
a. In Active Directory Users and Computers, select the necessary staging SQL server.
b. Open the server properties and select the Delegation tab. Select Trust this computer for delegation to
specified services only and Use any authentication protocol options for the cifs service on a computer
with Veeam Explorer for Microsoft SharePoint.
d. Select a user account to connect to the staging SQL server. Also, select its properties on the Account
tab and make sure the Account is sensitive and cannot be delegated check box is cleared.
3. Click Browse to specify an SQL server that you want to use as a staging system. Do one of the following:
o On the Local Servers tab, select a local SQL server that is located on a machine with Veeam Explorer
for Microsoft SharePoint.
o On the Network Server tab, select an SQL server over the network.
NOTE
Configuring custom lists is not required when working with backups created by Veeam Backup for
Microsoft 365.
3. Click the link under the Status column which also comprises the total number of available templates.
4. If you want to automatically update existing templates, select the Automatically update custom list
templates from backups check box.
5. If you want to be notified whether the database contains new templates other than those you already
have, select the Warn me if attached database has new custom list templates check box.
6. Click OK.
3. Click Update.
4. Specify the path to Microsoft SharePoint templates, select the language and click OK. The language set in
the drop-down list depends on the installed language packages on a SharePoint server.
Available only for Microsoft SQL Server databases and requires a staging SQL server. For more information
on configuring a staging server, see Staging SQL Server.
To import existing templates from the Microsoft SharePoint server using the ribbon menu, do the following:
o Select Use global custom list settings to apply global list templates to the select database.
o Select Use the following custom list settings to apply the templates to the selected database only.
When using the latter option, specify the path to the Microsoft SharePoint templates, select the
language and click OK. The language set in the drop-down list depends on the installed language
packages on a SharePoint server.
3. Select the Configure SMTP settings check box and do the following:
a. In the Server field, specify a DNS name or IP address of the SMTP server.
b. In the Port field, specify a port number of the specified SMTP server.
The default port number is 25. If you want to use SSL data encryption, specify port 587.
c. In the From field, specify the sender email address. This address will appear in the From field when
sending SharePoint items.
d. If the specified SMTP server requires an authentication for outgoing mail, select the Use
authentication check box and provide valid credentials.
e. Select the Enable SSL security check box to enable SSL data encryption.
5. Click OK.
3. If you want to enable extended logging mode to collect logs that contain additional information on
specific operations, select the Enable extended logging check box.
After enabling extended logging mode, you can go back to the application and perform actions for which
you want to collect additional information. Then you can collect logs.
4. By default, Veeam Explorer for Microsoft SharePoint displays notifications when loading backups created
by Veeam Backup for Microsoft 365 from object storage. If you want to disable these notifications, clear
the Show pop-up notifications on startup check box.
5. Click OK.
When you add standalone Microsoft SharePoint databases to the application scope, Veeam Explorer for
Microsoft SharePoint attaches such a database to the staging SQL server, creating a temporary Microsoft
SharePoint content database from which you can restore your items.
To manually add new Microsoft SharePoint databases to the application scope, do the following:
o On the Home tab, click Add Database > Microsoft SharePoint database on the ribbon.
2. Specify the location of the Microsoft SharePoint primary content database file (.mdf). The secondary
database and the transaction log file (.ldf) will be added as well. Keep in mind that shared folders and
mapped network drives are not supported as a location for Microsoft SharePoint content database files.
To add remote BLOB stores, click Add next to the Remote BLOB Stores section.
3. Click OK.
o On the Home tab, click Add Database > Veeam Backup for Microsoft 365 database on the ribbon.
o Right-click the Databases node and select Veeam Backup for Microsoft 365 database.
3. Click Open.
NOTE
Make sure you have disabled the Veeam Backup Proxy for Microsoft 365 Service when adding local
databases. You can stop this service by using the services.msc console. If you try to add a database
having this service still in progress, you will receive an error message and will not be able to access the
database due to database lock.
To connect to another Veeam Backup for Microsoft 365 server remotely, do the following:
o On the Home tab, click Add Database > Veeam Backup for Microsoft 365 server on the ribbon.
o Right-click the Databases node and select Veeam Backup for Microsoft 365 server.
2. Specify a server name or IP address and enter credentials to access the specified server.
Select the Use Windows session authentication check box to connect with the user account under which
you are currently logged in.
3. Click Connect.
NOTE
Make sure that both Veeam Explorer for Microsoft SharePoint and Veeam Backup & Replication are
installed on the same server and at least one service provider is added to Veeam Backup & Replication. For
more information, see the Connecting to Service Providers section of the Veeam Cloud Connect Guide.
To add Veeam Backup for Microsoft 365 service providers, do the following:
o On the Home tab, click Add Database > Veeam Backup for Microsoft 365 service provider on the
ribbon.
o Right-click the Databases node and select Veeam Backup for Microsoft 365 service provider.
2. From the Select service provider and authentication method drop-down list, select a service provider that
you want to add and select an authentication method that can be either Modern authentication or Basic
authentication.
3. [For Modern authentication] Select a region to which a Microsoft 365 organization of the selected service
provider belongs.
4. [For Modern authentication] Copy the device code and use it to sign in to Azure Active Directory.
For Basic authentication, you must enter a user name and password to connect to the service provider
server.
NOTE
You cannot use Basic authentication to load backups if a Microsoft 365 organization has been added
to the service provider infrastructure using Modern authentication.
5. Select a point-in-time state as of which you want to load Microsoft 365 backups.
To select a point in time, use the calendar control.
6. Select the Show items that have been deleted by user check box to see all the items that were removed.
7. Select the Show all versions of items that have been modified by user check box if you want to load
modified versions.
To remove a database from the application scope, right-click a database in the navigation pane and select
Remove database.
o On the Site tab, click Restore Site > Restore site to <site_name> on the ribbon.
NOTE
When restoring sites to site collections, make sure that such collections exist in the target location; Veeam
Explorer for Microsoft SharePoint does not create site collections.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
On-Premises Organizations
To authenticate on an on-premises Microsoft SharePoint server, use an account that you are currently logged in
to or provide a user name and password.
• Authentication credentials.
NOTE
When restoring Microsoft SharePoint sites from a Microsoft SQL database, you will proceed directly to the
Specify Restore Options step of the wizard.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
At this step of the wizard, specify a target site alias that you want to use for data restore.
NOTE
When restoring site collections other than site collections with the Group#0 or SITEPAGEPUBLISHING#0
template, make sure that such collections exist in the target location; Veeam Explorer for Microsoft
SharePoint does not create site collections.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items. If this check box is
selected, you can select one of the following options:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
• Restore permissions. Allows you to restore permissions. If not selected, the permissions for the restored
document library or list will be set in the following way:
o If the library (or list) does not exist on target, it will be created inheriting permissions from the parent
object.
o If the library (or list) already exists on target, permissions will be preserved.
• Send a notification by email to the users with permissions to the file. Select this check box if you want to
notify users about items restore. Veeam Explorer for Microsoft SharePoint will notify users with whom
items have been shared. You can select this check box only if the Restore permissions check box is
selected.
NOTE
The Send a notification by email to the users with permissions to the file check box is only available
when restoring data from backups created by Veeam Backup for Microsoft 365 for Microsoft 365
organizations.
To restore Microsoft SharePoint sites to another Microsoft 365 organization, do the following:
o On the Site tab, click Restore Site > Restore site to on the ribbon.
o Right-click a site and select Restore site > Restore site to.
NOTE
When restoring sites to site collections, make sure that such collections exist in the target location; Veeam
Explorer for Microsoft SharePoint does not create site collections.
Modern Authentication
To use modern authentication, do the following:
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Organization name field, enter a name of your target SharePoint Online organization.
4. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with an identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
NOTE
When restoring site collections, make sure that such collections exist in the target location; Veeam
Explorer for Microsoft SharePoint does not create site collections.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
To restore Microsoft SharePoint sites to an on-premises Microsoft SharePoint server, do the following:
o On the Site tab, click Restore Site > Restore site to on the ribbon.
o Right-click a site and select Restore site > Restore site to.
NOTE
When restoring sites to site collections, make sure that such collections exist in the target location; Veeam
Explorer for Microsoft SharePoint does not create site collections.
NOTE
Make sure that you restore to site collection that exists in the target location; Veeam Explorer for
Microsoft SharePoint does not create site collections.
To specify web address of a target site and credentials to connect to SharePoint server, do the following:
1. In the Restore to the following site URL field, specify web address of a target site.
2. In the Specify user account to connect to SharePoint Server section, use an account that you are currently
logged in to or provide a user name and password to connect to the on-premises Microsoft SharePoint
server.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
1. In the navigation pane, select a document library or a list that you want to restore.
o On the Library tab, click Restore Library > Restore library to <library_name> on the ribbon.
o On the List tab, click Restore List > Restore list to <list_name> on the ribbon.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
On-Premises Organizations
To authenticate on an on-premises Microsoft SharePoint server, use an account that you are currently logged in
to or provide a user name and password.
• Authentication credentials.
NOTE
When restoring Microsoft SharePoint document libraries and lists from a Microsoft SQL database, you will
proceed directly to the Specify Restore Options step of the wizard.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
• Restore items to the original list. To restore the document library or list back to the original list.
• Restore items to the following list. To restore the document library or list to the specified list.
If the specified list does not exist, Veeam Explorer for Microsoft SharePoint will create it automatically.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items. If this check box is
selected, you can select one of the following options:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
• Restore permissions. Allows you to restore permissions. If not selected, the permissions for the restored
document library or list will be set in the following way:
o If the library (or list) does not exist on target, it will be created inheriting permissions from the parent
object.
o If the library (or list) already exists on target, permissions will be preserved.
• Send a notification by email to the users with permissions to the file. Select this check box if you want to
notify users about items restore. Veeam Explorer for Microsoft SharePoint will notify users with whom
items have been shared. You can select this check box only if the Restore permissions check box is
selected.
NOTE
The Send a notification by email to the users with permissions to the file check box is only available
when restoring data from backups created by Veeam Backup for Microsoft 365 for Microsoft 365
organizations.
To restore Microsoft SharePoint document libraries and lists to another Microsoft 365 organization, do the
following:
1. In the navigation pane, select a document library or a list that you want to restore.
o On the Library tab, click Restore Library > Restore library to on the ribbon.
o Right-click a library and select Restore library > Restore library to.
o On the List tab, click Restore List > Restore list to on the ribbon.
o Right-click a list and select Restore list > Restore list to.
Modern Authentication
To use modern authentication, do the following:
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Organization name field, enter a name of your target SharePoint Online organization.
4. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with an identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
To specify web address of a target site and a list to restore backed-up data, do the following:
1. In the Restore to the following site URL field, specify web address of a target site.
o Restore items to the original list. To restore the document library or list back to the original list.
o Restore items to the following list. To restore the document library or list to the specified list.
If the specified list does not exist, Veeam Explorer for Microsoft SharePoint will create it
automatically.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
To restore Microsoft SharePoint document libraries and lists to an on-premises Microsoft SharePoint server, do
the following:
1. In the navigation pane, select a document library or a list that you want to restore.
o On the Library tab, click Restore Library > Restore library to on the ribbon.
o Right-click a library and select Restore library > Restore library to.
o On the List tab, click Restore List > Restore list to on the ribbon.
o Right-click a list and select Restore list > Restore list to.
NOTE
Make sure that you restore to site collection that exists in the target location; Veeam Explorer for
Microsoft SharePoint does not create site collections.
To specify web address of a target site and credentials to connect to SharePoint server, do the following:
1. In the Restore to the following site URL field, specify web address of a target site.
2. In the Specify user account to connect to SharePoint Server section, use an account that you are currently
logged in to or provide a user name and password to connect to the on-premises Microsoft SharePoint
server.
• Restore items to the original list. To restore the document library or list back to the original list.
• Restore items to the following list. To restore the document library or list to the specified list.
If the specified list does not exist, Veeam Explorer for Microsoft SharePoint will create it automatically.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
1. In the preview pane, select a document or a list item that you want to restore.
o On the Document tab, click Restore Document > Restore document to <library_name> on the ribbon.
o On the Item tab, click Restore Item > Restore item to <list_name> on the ribbon.
o Right-click a list item and select Restore item > Restore item.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with the identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
On-Premises Organizations
To authenticate on an on-premises Microsoft SharePoint server, use an account that you are currently logged in
to or provide a user name and password.
• Authentication credentials.
NOTE
When restoring Microsoft SharePoint documents and list items from a Microsoft SQL database, you will
proceed directly to the Specify Restore Options step of the wizard.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
• Restore items to the original list. To restore the document or list item back to the original list.
• Restore items to the following list. To restore the document or list item to the specified list.
Make sure to specify a list that exists in the original SharePoint site.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items. If this check box is
selected, you can select one of the following options:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
• Restore permissions. Allows you to restore permissions. If not selected, the permissions for the restored
document library or list will be set in the following way:
o If the library (or list) does not exist on target, it will be created inheriting permissions from the parent
object.
o If the library (or list) already exists on target, permissions will be preserved.
• Send a notification by email to the users with permissions to the file. Select this check box if you want to
notify users about items restore. Veeam Explorer for Microsoft SharePoint will notify users with whom
items have been shared. You can select this check box only if the Restore permissions check box is
selected.
NOTE
The Send a notification by email to the users with permissions to the file check box is only available
when restoring data from backups created by Veeam Backup for Microsoft 365 for Microsoft 365
organizations.
To restore Microsoft SharePoint documents and list items to another Microsoft 365 organization, do the
following:
1. In the preview pane, select a document or a list item that you want to restore.
o On the Document tab, click Restore Document > Restore document to on the ribbon.
o Right-click a document and select Restore document > Restore document to.
o On the Item tab, click Restore Item > Restore item to on the ribbon.
o Right-click a list item and select Restore item > Restore item to.
Modern Authentication
To use modern authentication, do the following:
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Organization name field, enter a name of your target SharePoint Online organization.
4. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft SharePoint populates this field with an identification number of
the application that was used during a backup session. If you want to use another application, make sure
to grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. From the Region drop-down list, select a region to which your target SharePoint Online organization
belongs.
3. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
To specify web address of a target site and a list to restore backed-up data, do the following:
1. In the Restore to the following site URL field, specify web address of a target site.
o Restore items to the original list. To restore the document or list item back to the original list.
o Restore items to the following list. To restore the document or list item to the specified list.
Keep in mind that if you restore documents and the specified list does not exist, Veeam Explorer for
Microsoft SharePoint will create it automatically. If you restore list items, make sure to specify a list
that exists in the original SharePoint site.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
To restore Microsoft SharePoint documents and list items to an on-premises Microsoft SharePoint server, do the
following:
1. In the preview pane, select a document or a list item that you want to restore.
o On the Document tab, click Restore Document > Restore document to on the ribbon.
o Right-click a document and select Restore document > Restore document to.
o On the Item tab, click Restore Item > Restore item to on the ribbon.
o Right-click a list item and select Restore item > Restore item to.
NOTE
Make sure that you restore to site collection that exists in the target location; Veeam Explorer for
Microsoft SharePoint does not create site collections.
To specify web address of a target site and credentials to connect to SharePoint server, do the following:
1. In the Restore to the following site URL field, specify web address of a target site.
2. In the Specify user account to connect to SharePoint Server section, use an account that you are currently
logged in to or provide a user name and password to connect to the on-premises Microsoft SharePoint
server.
• Restore items to the original list. To restore the document or list item back to the original list.
• Restore items to the following list. To restore the document or list item to the specified list.
Keep in mind that if you restore documents and the specified list does not exist, Veeam Explorer for
Microsoft SharePoint will create it automatically. If you restore list items, make sure to specify a list that
exists in the original SharePoint site.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
The exported content will be saved as a set of XML files and can be imported to another SharePoint database
using PowerShell cmdlets. For more information, see Importing Microsoft SharePoint Data.
1. In the navigation pane, select a library or a list that you want to export.
NOTE
You cannot export an empty folder, an empty list and an individual list item.
Add-PsSnapin Microsoft.SharePoint.PowerShell
Import-SPWeb -Identity "http://<web_server_name>/sites/<destination_site>"
-Path "C:\<export_folder>" -NoFileCompression –IncludeUserSecurity
where:
To get extended help on the Import–SPWeb command, use the following command:
o On the Library tab, click Save Library > Save as files or Save Library > Save as ZIP on the ribbon.
o Right-click a library and select Save library > Save as files or Save library > Save as ZIP.
3. In the displayed window, browse to the necessary folder and click Select Folder or Save.
Keep in mind that if you select the Save as ZIP option, Veeam Explorer for Microsoft SharePoint will save a
library to an archive with the archive.zip name.
o On the Document tab, click Save Document > Save as files or Save Document > Save as ZIP on the
ribbon.
o Right-click a document and select Save document > Save as files or Save document > Save as ZIP.
3. In the displayed window, browse to the necessary folder and click Select Folder or Save.
Keep in mind that if you select the Save as ZIP option, Veeam Explorer for Microsoft SharePoint will save a
library to an archive with the archive.zip name.
TIP
Before sending documents, make sure to configure SMTP settings. The amount of data you can send at a
time depends on your SMTP server configuration. For more information about configuring SMTP settings,
see SMTP Settings.
o To send a Microsoft SharePoint library, select the necessary library in the navigation pane.
o To send a library document, select a library that contains the document in the navigation pane and
then select the document in the preview pane.
o Right-click an object that you want to send and select Send library/Send document.
Consider that when Veeam Explorer for Microsoft SharePoint is installed on a server on which both
Veeam Backup & Replication and Veeam Backup for Microsoft 365 are installed, the notification settings will be
inherited from the Veeam Backup & Replication Global Notification settings.
• The Explore option to load backups created by Veeam Backup for Microsoft 365. For more information,
see the Data Restore section of the Veeam Backup for Microsoft 365 User Guide.
When loading backups located in object storage, Veeam Explorer for Microsoft OneDrive for Business will
notify you about the location of these backups. You can select the Don't show this message again check
box to unsubscribe from such notifications. To disable these notifications, clear the Show pop-up
notifications on startup check box. For more information, see Advanced Settings.
• Go to Start, click Veeam Explorer for Microsoft OneDrive for Business and manually open Microsoft
OneDrive databases. For more information, see Standalone Databases.
When you open Veeam Explorer for Microsoft OneDrive for Business from the Start menu, all backed-up
databases will be loaded automatically.
If you open Veeam Explorer for Microsoft OneDrive for Business from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
o To perform restore operations, Veeam Explorer for Microsoft OneDrive for Business must be run with
elevated permissions. The user account must be a member of the local Administrators group on the
machine where Veeam Explorer for Microsoft OneDrive for Business is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft OneDrive for Business is running, select Use
Windows session authentication.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu comprises the following:
• General Options. Allows you to configure general application settings. For more information, see General
Application Settings.
• Help.
• Exit. Closes the Veeam Explorer for Microsoft OneDrive for Business window.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft OneDrive for Business
wizard or window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon that contains operation commands organized into logical groups represented as tabs. The
ribbon is displayed at the top of the main application window.
• The navigation pane that allows you to browse through the hierarchy of folders with backed-up data.
Also, it allows you to search for OneDrives using keywords.
• The preview pane that provides search capabilities and allows you to view details about items that are
contained in a folder you have selected in the navigation pane.
After you select an object in the navigation pane, you can see its content in the preview pane.
To open a document using an associated application, right-click a document in the preview pane and select
Open.
1. In the navigation pane, select an object in which you want to find your data.
2. Enter a search query in the search field at the top of the preview pane.
NOTE
To find the exact phrase, use double quotes. For example, "Attachments".
You can narrow your search results by specifying various search criteria using the criteria:value format. You can
also use logical upper-cased operators such as AND, OR and NOT along with wildcard characters such as * and ?.
For example, to find an object that starts with the word Document, do the following:
1. In the preview pane, select a node and click Advanced Find on the ribbon.
2. In the Define search criteria section, select Category > Document fields.
3. Select the Configure SMTP settings check box and do the following:
a. In the Server field, specify a DNS name or IP address of the SMTP server.
b. In the Port field, specify a port number of the specified SMTP server.
The default port number is 25. If you want to use SSL data encryption, specify port 587.
c. In the From field, specify the sender email address. This address will appear in the From field when
sending OneDrive items. See Sending Microsoft OneDrive Documents.
d. If the specified SMTP server requires an authentication for outgoing mail, select the Use
authentication check box and provide valid credentials.
e. Select the Enable SSL security check box to enable SSL data encryption.
5. Click OK.
3. If you want to enable extended logging mode to collect logs that contain additional information on
specific operations, select the Enable extended logging check box.
After enabling extended logging mode, you can go back to the application and perform actions for which
you want to collect additional information. Then you can collect logs.
4. By default, Veeam Explorer for Microsoft OneDrive for Business displays notifications when loading
backups created by Veeam Backup for Microsoft 365 from object storage. If you want to disable these
notifications, clear the Show pop-up notifications on startup check box.
5. Click OK.
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 database on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 database.
3. Click Open.
NOTE
Make sure you have disabled the Veeam Backup Proxy for Microsoft 365 Service when adding local
databases. You can stop this service by using the services.msc console. If you try to add a database
having this service still in progress, you will receive an error message and will not be able to access the
database due to database lock.
To connect to another Veeam Backup for Microsoft 365 server remotely, do the following:
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 server on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 server.
2. Specify a server name or IP address and enter credentials to access the specified server.
Select the Use Windows session authentication check box to connect with the user account under which
you are currently logged in.
3. Click Connect.
NOTE
Make sure that both Veeam Explorer for Microsoft OneDrive for Business and Veeam Backup & Replication
are installed on the same server and at least one service provider is added to Veeam Backup & Replication.
For more information, see the Connecting to Service Providers section of the Veeam Cloud Connect Guide.
To add Veeam Backup for Microsoft 365 service providers, do the following:
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 service provider on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 service provider.
2. From the Select service provider and authentication method drop-down list, select a service provider that
you want to add and select an authentication method that can be either Modern authentication or Basic
authentication.
3. [For Modern authentication] Select a region to which a Microsoft 365 organization of the selected service
provider belongs.
4. [For Modern authentication] Copy the device code and use it to sign in to Azure Active Directory.
For Basic authentication, you must enter a user name and password to connect to the service provider
server.
NOTE
You cannot use Basic authentication to load backups if a Microsoft 365 organization has been added
to the service provider infrastructure using Modern authentication.
5. Select a point-in-time state as of which you want to load Microsoft 365 backups.
6. Select the Show items that have been deleted by user check box to see all the items that were removed.
7. Select the Show all versions of items that have been modified by user check box if you want to load
modified versions.
To remove an organization from the application scope, right-click an organization in the navigation pane and
select Remove organization.
NOTE
By default, Veeam Explorer for Microsoft OneDrive for Business restores only the latest version of
OneDrive items to their original location. If you want to restore all versions of OneDrive items and specify
another location, you can copy your OneDrive data. For more information, see Data Copy.
o To restore a document, select a folder that contains the document in the navigation pane and then
select the document in the preview pane.
Keep — to preserve existing data and restore items with the RESTORED prefix (RESTORED-
<file_name>.ext).
o Right-click an object that you want to restore and select Restore OneDrive/Restore folder/Restore
document > Overwrite or Restore OneDrive/Restore folder/Restore document > Keep.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft OneDrive for Business populates this field with the identification
number of the application that was used during a backup session. If you want to use another application,
make sure to grant this application required permissions. For more information, see the Azure AD
Application Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For Veeam Explorer for
Microsoft OneDrive for Business, required permissions are the same as for Veeam Explorer for Microsoft
SharePoint. For more information, see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
4. Select OneDrives.
o On the Home tab, click Restore OneDrives on the ribbon and select one of the following options:
Keep — to preserve existing data and restore items with the RESTORED prefix (RESTORED-
<file_name>.ext).
o Right-click an organization with OneDrives and select Restore OneDrives > Overwrite or Restore
OneDrives > Keep.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft OneDrive for Business populates this field with the identification
number of the application that was used during a backup session. If you want to use another application,
make sure to grant this application required permissions. For more information, see the Azure AD
Application Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For Veeam Explorer for
Microsoft OneDrive for Business, required permissions are the same as for Veeam Explorer for Microsoft
SharePoint. For more information, see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
If you want to check whether user accounts whose OneDrives you want to restore exist, click Resolve selected
accounts.
o To copy a document, select a folder that contains the document in the navigation pane and then
select the document in the preview pane.
o Right-click an object that you want to copy and select Copy OneDrive/Copy folder/Copy document.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft OneDrive for Business populates this field with the identification
number of the application that was used during a backup session. If you want to use another application,
make sure to grant this application required permissions. For more information, see the Azure AD
Application Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the SharePoint organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has the SharePoint Administrator role.
• Restore to original user. To copy OneDrive data back to the original user.
• Restore to the following user. To copy OneDrive data to the specified user.
1. Click Browse.
2. In the Browse OneDrive Accounts window, select the necessary account and click Select.
• Changed items. Allows you to restore data that has been modified in your production environment.
• Restore only latest version. Allows you to restore only the latest version of items. If this check box is
selected, you can select one of the following options:
If the Restore only latest version check box is not selected, all versions of items in the production
environment will be replaced with the relevant data from the backup file.
• Send a notification by email to the users with permissions to the file. Select this check box if you want to
notify users about items restore. Veeam Explorer for Microsoft OneDrive for Business will notify users with
whom items have been shared. You can select this check box only if the Restore shared access check box is
selected.
NOTE
The Send a notification by email to the users with permissions to the file check box is only available
when restoring data from backups created by Veeam Backup for Microsoft 365 for Microsoft 365
organizations.
o On the Home tab, click Save OneDrives on the ribbon and select how you want to save data:
Save as files. Select this option if you want to save each file separately to a specified location.
Save as ZIP. Select this option if you want to add saved files to a ZIP archive and save the
resulting archive to a specified location. Veeam Explorer for Microsoft OneDrive for Business will
save files to an archive with the OneDrives_<timestamp>.zip name.
o Right-click an organization with OneDrives and select Save OneDrives > Save as files or Save
OneDrives > Save as ZIP.
o On the OneDrive tab, click Save OneDrive on the ribbon and select how you want to save data:
Save as files. Select this option if you want to save each file separately to a specified location. To
specify a location, in the displayed window, browse to the necessary folder and click Select
Folder.
Save as ZIP. Select this option if you want to add saved files to a ZIP archive and save the
resulting archive to a specified location. To specify a location, in the displayed window, browse
to the necessary folder and click Save. Veeam Explorer for Microsoft OneDrive for Business will
save files to an archive with the <user_name>.zip name in this folder.
o Right-click OneDrive and select Save OneDrive > Save as files or Save OneDrive > Save as ZIP.
o On the Folder tab, click Save Folder > Save folder as files or Save Folder > Save folder as ZIP on the
ribbon.
o Right-click a folder and select Save folder > Save folder as files or Save folder > Save folder as ZIP.
3. In the displayed window, browse to the necessary folder and click Select Folder or Save.
Keep in mind that if you select the Save as ZIP option, Veeam Explorer for Microsoft OneDrive for Business
will save a folder to an archive with the archive.zip name.
o On the Document tab, click Save Document > Save as files or Save Document > Save as ZIP on the
ribbon.
o Right-click a document and select Save document > Save as files or Save document > Save as ZIP.
3. In the displayed window, browse to the necessary folder and click Select Folder or Save.
Keep in mind that if you select the Save as ZIP option, Veeam Explorer for Microsoft OneDrive for Business
will save a document to an archive with the archive.zip name.
TIP
Before sending documents, make sure to configure SMTP settings. The amount of data you can send at a
time depends on your SMTP server configuration. For more information about configuring SMTP settings,
see SMTP Settings.
o To send a document, select a folder that contains the document in the navigation pane and then
select the document in the preview pane.
o Right-click an object that you want to send and select Send OneDrive/Send folder/Send document.
Restore to Microsoft 365 To restore Microsoft Teams data, you must grant the following roles and
permissions to user accounts:
Data Restore
Consider the following when planning to restore Microsoft Teams data:
• Use of modern authentication with legacy protocols allowed is not supported for data restore with Veeam
Explorer for Microsoft Teams.
• You can restore Microsoft Teams data to the original organization only.
• Veeam Explorer for Microsoft Teams does not change roles for team owners during restore. For example,
you create a backup of your organization, and then change role for a team member from Member to
Owner. In this case, if you restore this team member from the backup, Veeam Explorer for Microsoft
Teams will not set their role to Member.
• Restore of OneNote notebooks from backups of Microsoft Teams data for organizations with modern app-
only authentication is not supported.
• When restoring a channel tab, Veeam Explorer for Microsoft Teams does not preserve relation between
the link to a file published on the tab and the file itself. You will need to link the tab to the file manually
after restore. This limitation does not apply to the scenario where you restore an entire team.
• Veeam Explorer for Microsoft Teams does not restore posts to their original location in the team channel.
Instead, Veeam Explorer for Microsoft Teams exports posts to a file of the HTML format, creates a
separate tab in the original channel and attaches the HTML file to this tab.
• If a user never opened the Files tab of a team channel in Microsoft Teams before data backup, files from
this tab are not displayed in Veeam Explorer for Microsoft Teams.
• Before restoring posts, make sure that Website App is unblocked both for your organization and the user
account that you use to restore Microsoft Teams data.
• When restoring a channel, Veeam Explorer for Microsoft Teams cannot rename this channel.
• Before restoring team data for a tenant organization with modern app-only authentication, make sure that
a user account used for authorization has access to the root SharePoint site of this tenant organization.
• The Explore option to load backups created by Veeam Backup for Microsoft 365. For more information,
see the Data Restore section of the Veeam Backup for Microsoft 365 User Guide.
When loading backups located in object storage, Veeam Explorer for Microsoft Teams will notify you
about the location of these backups. You can select the Don't show this message again check box to
unsubscribe from such notifications. To disable these notifications, clear the Show pop-up notifications on
startup check box. For more information, see Advanced Settings.
• Go to Start, click Veeam Explorer for Microsoft Teams and manually open Microsoft Teams databases. For
more information, see Standalone Databases.
When you open Veeam Explorer for Microsoft Teams from the Start menu, all backed-up databases will be
loaded automatically.
If you open Veeam Explorer for Microsoft Teams from the Start menu on a machine that runs the
Veeam Backup & Replication console and Veeam Explorers only, specify the following:
o To perform restore operations, Veeam Explorer for Microsoft Teams must be run with elevated
permissions. The user account must be a member of the local Administrators group on the machine
where Veeam Explorer for Microsoft Teams is installed.
o The account must have the Veeam Backup Administrator or Veeam Restore Operator role on the
target backup server.
To use the account under which Veeam Explorer for Microsoft Teams is running, select Use Windows
session authentication.
To save the connection shortcut to the desktop, click Save shortcut in the bottom-left corner.
Main Menu
The main menu comprises the following:
• General Options. Allows you to configure general application settings. For more information, see General
Application Settings.
• Help.
TIP
You can also open online help by pressing [F1] in any Veeam Explorer for Microsoft Teams wizard or
window. You will then be redirected to the relevant section of the Veeam Explorers User Guide.
• The ribbon that contains operation commands organized into logical groups represented as tabs. The
ribbon is displayed at the top of the main application window.
• The navigation pane that allows you to browse through the hierarchy of folders with backed-up data.
Also, it allows you to search for teams using keywords.
• The preview pane that provides search capabilities and allows you to view details about items that are
contained in a folder you have selected in the navigation pane.
• Other tabs. Contains other tabs of the channel that link to sites, documents, applications, and and other
objects.
To view team properties, in the navigation pane, right-click a necessary team and select View properties.
1. In the navigation pane, browse to the channel whose post or file you want to open and click the necessary
node: Posts or Files.
o Select a node that contains an item you want to find: Posts, Files or Other tabs.
o Select a team or channel whose items you want to find. Then, from the drop-down list next to the
search field, select what type of items you want to find: Files, Posts or Other tabs.
NOTE
To find the exact phrase, use double quotes. For example, "Document".
NOTE
The Advanced Find mechanism is supported for posts and files only. The mechanism is not supported for
tabs.
For example, to find a file whose name starts with "word", do the following:
1. In the preview pane, select a node and click Advanced Find on the ribbon.
2. In the Define search criteria section, select Category > File fields.
3. Select the Configure SMTP settings check box and do the following:
a. In the Server field, specify a DNS name or IP address of the SMTP server.
b. In the Port field, specify a port number of the specified SMTP server.
The default port number is 25. If you want to use SSL data encryption, specify port 587.
c. In the From field, specify the sender email address. This address will appear in the From field when
sending Microsoft Teams posts or files. For more information, see Sending Posts and Files.
d. If the specified SMTP server requires an authentication for outgoing mail, select the Use
authentication check box and provide valid credentials.
e. Select the Enable SSL security check box to enable SSL data encryption.
5. Click OK.
3. If you want to enable extended logging mode to collect logs that contain additional information on
specific operations, select the Enable extended logging check box.
After enabling extended logging mode, you can go back to the application and perform actions for which
you want to collect additional information. Then you can collect logs.
4. By default, Veeam Explorer for Microsoft Teams displays notifications when loading backups created by
Veeam Backup for Microsoft 365 from object storage. If you want to disable these notifications, clear the
Show pop-up notifications on startup check box.
5. Click OK.
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 database on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 database.
3. Click Open.
NOTE
Make sure you have disabled the Veeam Backup Proxy for Microsoft 365 Service when adding local
databases. You can stop this service by using the services.msc console. If you try to add a database
having this service still in progress, you will receive an error message and will not be able to access the
database due to database lock.
To connect to another Veeam Backup for Microsoft 365 server remotely, do the following:
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 server on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 server.
2. Specify a server name or IP address and enter credentials to access the specified server.
Select the Use Windows session authentication check box to connect with the user account under which
you are currently logged in.
3. Click Connect.
NOTE
Make sure that both Veeam Explorer for Microsoft Teams and Veeam Backup & Replication are installed
on the same server and at least one service provider is added to Veeam Backup & Replication. For more
information, see the Connecting to Service Providers section of the Veeam Cloud Connect Guide.
To add Veeam Backup for Microsoft 365 service providers, do the following:
o On the Home tab, click Add Org > Veeam Backup for Microsoft 365 service provider on the ribbon.
o Right-click the Organizations node and select Veeam Backup for Microsoft 365 service provider.
2. From the Select service provider and authentication method drop-down list, select a service provider that
you want to add and select an authentication method that can be either Modern authentication or Basic
authentication.
3. [For Modern authentication] Select a region to which a Microsoft 365 organization of the selected service
provider belongs.
4. [For Modern authentication] Copy the device code and use it to sign in to Azure Active Directory.
For Basic authentication, you must enter a user name and password to connect to the service provider
server.
NOTE
You cannot use Basic authentication to load backups if a Microsoft 365 organization has been added
to the service provider infrastructure using Modern authentication.
5. Select a point-in-time state as of which you want to load Microsoft 365 backups.
6. Select the Show items that have been deleted by user check box to see all the items that were removed.
7. Select the Show all versions of items that have been modified by user check box if you want to load
modified versions.
To remove an organization from the application scope, right-click an organization in the navigation pane and
select Remove organization.
• If you want to restore multiple teams of a Microsoft 365 organization, in the navigation pane, do one of
the following:
o Select an organization whose teams you want to restore and on the Home tab, click Restore Teams on
the ribbon.
o Right-click an organization whose teams you want to restore and select Restore teams.
• If you want to restore a specific team, in the navigation pane, do one of the following:
o Select a team that you want to restore and on the Team tab, click Restore Team on the ribbon.
o Right-click a team that you want to restore and select Restore team.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Teams populates this field with the identification number of the
application that was used during a backup session. If you want to use another application, make sure to
grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the Microsoft 365 organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
At this step of the wizard, select check boxes next to the teams that you want to restore.
1. Select the Changed items check box if you want to restore items that have changed since the time when
the backup was created. When you select this option, Veeam Explorer for Microsoft Teams overwrites
existing items in the original team.
2. Select the Missing items check box if you want to restore items that are missing in the original team. For
example, some of the items were removed and you want to restore them from the backup.
3. Select the Restore team settings check box if you want to replace the current team settings with team
settings from the backup. For information on how to view team settings in the backup, see Viewing Team
Properties.
Keep in mind that you cannot select this check box if both the Changed items and Missing items check
boxes are cleared.
4. If you want to restore information about team members and their roles from the backup, make sure that
the Restore membership and their permissions check box is selected.
o If you launched the Restore wizard to restore a specific team, you will be able to review team
members at the next step of the wizard. Click Next.
o If you launched the Restore wizard to restore multiple teams, you cannot review team members. Click
Restore to start the restore operation.
You cannot proceed to the next step or start the restore operation, if you clear both the Changed items
and Missing items check boxes.
TIP
If you clear the Restore membership and their permissions check box, you can start the restore
operation immediately. To do this, click Restore.
At this step of the wizard, review the list of users whose membership and roles in the team will be restored and
click Restore.
To quickly find the necessary team members, use the search field at the top of the wizard window.
NOTE
Veeam Explorer for Microsoft Teams does not change roles for team owners during restore. For example,
you create a backup of your organization, and then change role for a team member from Member to
Owner. In this case, if you choose to restore this team member from the backup, Veeam Explorer for
Microsoft Teams will not set their role to Member.
In the opposite case, if a team member role was changed from Owner to Member after the backup was
created, and you choose to restore team membership from the backup, Veeam Explorer for Microsoft
Teams will elevate the role to Owner during restore.
• If you want to restore a channel, in the navigation pane, do one of the following:
o Select a channel that you want to restore and on the Channel tab, click Restore Channel on the
ribbon.
o Right-click a channel that you want to restore and select Restore channel.
• If you want to restore all tabs of a channel, in the navigation pane, do one of the following:
o Expand a channel whose tabs you want to restore, select Other tabs and on the Tabs tab, click Restore
Tabs on the ribbon.
o Expand a channel whose tabs you want to restore, right-click Other tabs and select Restore tabs.
a. In the navigation pane, expand a channel whose tabs you want to restore and select Other tabs.
b. In the preview pane, select a necessary tab and click Restore Tabs on the ribbon or right-click a tab
and select Restore tabs.
TIP
To select more than one tab in the preview pane, press and hold the [CTRL] key and select the
necessary tabs.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Teams populates this field with the identification number of the
application that was used during a backup session. If you want to use another application, make sure to
grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the Microsoft 365 organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
1. Select the Changed items check box if you want to restore items that have changed since the time when
the backup was created. When you select this option, Veeam Explorer for Microsoft Teams overwrites
existing items in your target location.
2. Select the Missing items check box if you want to restore items that are missing in the target location. For
example, some of the items were removed and you want to restore them from the backup.
3. Click Restore.
NOTE
During restore of a tab, Veeam Explorer for Microsoft Teams restores the name of the tab and a link to an
object published on the tab. The object itself, for example, a SharePoint site or document, is not restored
from the backup in this scenario. To restore such objects along with tabs, consider restoring an entire team.
For more information, see Restoring Teams.
NOTE
Veeam Backup for Microsoft 365 does not restore posts to their original location in the team channel.
Instead, Veeam Backup for Microsoft 365 creates a new tab in the original channel and restores posts to
this tab. If you want to restore posts to another channel, use the export operation. For more information,
see Data Export.
• Expand a channel whose posts you want to restore, select Posts and on the Posts tab, click Restore Posts
on the ribbon.
• Expand a channel whose posts you want to restore, right-click Posts and select Restore posts.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Teams populates this field with the identification number of the
application that was used during a backup session. If you want to use another application, make sure to
grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the Microsoft 365 organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
When you restore posts, Veeam Backup for Microsoft 365 will create a separate tab in the original team channel
and restore posts to this tab.
• If you want to restore all files of a channel, in the navigation pane, do one of the following:
o Expand a channel whose files you want to restore, select Files and on the Files tab, click Restore File
on the ribbon.
o Right-click a channel whose files you want to restore, right-click Files and select Restore files.
a. In the navigation pane, expand a channel whose files you want to restore and select Files.
b. In the preview pane, select a necessary file and click Restore File on the ribbon or right-click a file and
select Restore file.
To select more than one file in the preview pane, press and hold the [CTRL] key and select the
necessary files.
Modern Authentication
To use modern authentication, do the following:
2. In the Application ID field, enter an identification number of the Azure AD application that you want to use
for data restore.
By default, Veeam Explorer for Microsoft Teams populates this field with the identification number of the
application that was used during a backup session. If you want to use another application, make sure to
grant this application required permissions. For more information, see the Azure AD Application
Permissions section of the Veeam Backup for Microsoft 365 User Guide.
2. In the Username and Password fields, enter credentials to connect to the Microsoft 365 organization.
3. On the Sign in to your account webpage, paste the code that you have copied and sign in to Microsoft
Azure.
Make sure to log in with the user account that has required permissions assigned. For more information,
see Permissions.
Make sure that the required settings are specified for the Azure AD application used for restore. For more
information, see the Configuring Azure AD Application Settings section of the Veeam Backup for Microsoft
365 User Guide.
1. Select the Changed items check box if you want to restore items that have changed since the time when
the backup was created.
2. Select the Missing items check box if you want to restore items that are missing in the target location. For
example, some of the items were removed and you want to restore them from the backup.
3. By default, Veeam Explorer for Microsoft Teams restores all versions of backed-up files from the backup.
If you want to restore only the latest version of a file, select the Restore only the latest version check box.
If you select this option, Veeam Explorer for Microsoft Teams will merge original files in the production
environment with the latest version of the files in the backup.
4. Click Restore.
The export operation can be useful, for example, if you want to restore posts of a team channel to another
channel. To do this, you can export posts to an HTML file, publish this file in Microsoft SharePoint and publish a
link to this file in a custom tab of the necessary channel.
1. In the navigation pane, expand a channel whose posts you want to export and select Posts.
o On the Posts tab, click Export Posts on the ribbon and select how you want to export posts:
Export to Desktop. Select this option if you want to perform the 1-Click Export operation.
Veeam Explorer for Microsoft Teams will immediately export all posts of the channel to the
Desktop folder.
Export to. Select this option if you want to specify what posts to export and where to export
posts.
o Right-click Posts and select Export posts > Export to Desktop or Export posts > Export to.
3. If you selected the Export to option at the step 2, in the Export wizard, do the following:
a. Specify what posts you want to export. You can select from the following options:
Export all posts. If you select this option, Veeam Explorer for Microsoft Teams will export all
posts published in the channel to an HTML file.
Export posts for the specified time period. If you select this option, you can define a time period
when posts that you want to export were created. To do this, specify the start date and end date
of the period in the From and To fields. Veeam Explorer for Microsoft Teams will export posts
whose last modification date belongs to the specified period.
b. In the Save as field, click Browse and browse to a folder where you want to save an HTML file with
exported posts. By default, Veeam Explorer for Microsoft Teams exports posts to a file with the
following name: <Channel_name>_<date_and_time>.html. For example: Team
News_2023_02_10_18_51_38.html.
c. Select the Open file after export check box if you want to open the resulting HTML file right after the
export operation is completed.
1. In the navigation pane, expand a channel whose post you want to export and select Posts.
o Select a necessary post and on the Posts tab, click Export Posts on the ribbon and select how you
want to export the post:
Export to Desktop. Select this option if you want to perform the 1-Click Export operation.
Veeam Explorer for Microsoft Teams will immediately export the post to the Desktop folder.
Export to. Select this option if you want to export the post to a custom location.
TIP
To select more than one post in the preview pane, press and hold the [CTRL] key and select the
necessary posts.
3. If you selected the Export to option at the step 2, in the Export wizard, do the following:
a. In the Save as field, click Browse and browse to a folder where you want to save an HTML file with
exported posts. By default, Veeam Explorer for Microsoft Teams exports posts to a file with the
following name: <Channel_name>_<date_and_time>.html. For example: Team
News_2023_02_10_18_57_05.html.
b. Select the Open file after export check box if you want to open the resulting HTML file right after the
export operation is completed.
1. In the navigation pane, expand a channel whose posts you want to save and select Posts.
o On the Posts tab, click Save Posts on the ribbon and select where you want to save posts:
Save to <folder_name>. Select this option if you want to perform the 1-Click Save operation.
Veeam Explorer for Microsoft Teams will save posts to the latest location that was used when
saving posts. If you have not saved posts yet, Veeam Explorer for Microsoft Teams save posts to
the Desktop folder.
Save to .msg file. Select this option if you want to save posts to a custom location. To specify a
location, in the displayed window, browse to the necessary folder and click Select Folder.
o Right-click Posts and select Save posts > Save to <folder_name> or Save posts > Save to .msg file.
1. In the navigation pane, expand a channel whose post you want to save and select Posts.
o Select a necessary post and on the Posts tab, click Save Posts on the ribbon and select where you
want to save posts:
Save to .msg file. Select this option if you want to save posts to a custom location. To specify a
location, in the displayed window, browse to the necessary folder and click Select Folder.
o Right-click a necessary post and select Save to <folder_name> or Save to .msg file.
TIP
To select more than one post in the preview pane, press and hold the [CTRL] key and select the
necessary posts.
1. In the navigation pane, expand a channel whose files you want to save and select Files.
o On the Files tab, click Save File on the ribbon and select how you want to save files:
Save as files. Select this option if you want to save each file separately to a specified location. To
specify a location, in the displayed window, browse to the necessary folder and click Select
Folder.
Save as ZIP. Select this option if you want to add saved files to a ZIP archive and save the
resulting archive to a specified location. To specify a location, in the displayed window, browse
to the necessary folder and click Save. Veeam Explorer for Microsoft Teams will save files to an
archive with the <channel_name>.zip name.
o Right-click Files and select Save files > Save as files or Save files > Save as ZIP.
1. In the navigation pane, expand a channel whose files you want to save and select Files.
o Select a necessary file and on the Files tab, click Save File on the ribbon and select how you want to
save files:
Save as ZIP. Select this option if you want to add saved files to a ZIP archive and save the
resulting archive to a specified location. To specify a location, in the displayed window, browse
to the necessary folder and click Save. Veeam Explorer for Microsoft Teams will save files to an
archive with the archive.zip name.
o Right-click a necessary file and select Save file > Save as files or Save file > Save as ZIP.
TIP
To select more than one file in the preview pane, press and hold the [CTRL] key and select the
necessary files.
TIP
Before sending documents, make sure to configure SMTP settings. The amount of data you can send at a
time depends on your SMTP server configuration. For more information about configuring SMTP settings,
see SMTP Settings.
1. In the navigation pane, expand a channel whose posts or files you want to send and select Posts or Files.
3. In case the size of the message with files exceeds the size allowed by your SMTP server configuration,
Veeam Explorer for Microsoft Teams will prompt whether you want to send files. In the notification
window, click Yes.
1. In the navigation pane, expand a channel whose post or file you want to send and select Posts or Files.
o Select a necessary post or file and on the Posts/Files tab, click Send Posts/Send File on the ribbon.