NW Module
NW Module
Version 19.1
Installation Guide
302-005-507
REV 01
Copyright © 2009-2019 Dell Inc. or its subsidiaries. All rights reserved.
Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED
IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.
Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.
Published in the USA.
Dell EMC
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com
Figures 5
Tables 7
Preface 9
Chapter 1 Introduction 13
Overview.....................................................................................................14
Requirements..............................................................................................14
Requirement when restoring backups taken with NMM 8.2.x or
earlier............................................................................................. 15
Unsupported Microsoft Windows features..................................... 15
Supported Microsoft .NET Framework versions.............................15
Supported NetWorker server and client versions........................... 15
Hardware requirements..................................................................16
Licensing........................................................................................ 17
Authorization requirements............................................................ 18
Microsoft hotfixes..........................................................................18
Exchange Server-specific configuration requirements................................ 18
NMM Exchange Admin Configuration tool..................................... 18
NMM requirements for MAPI client and collaboration data objects...
19
Exchange backup prerequisites..................................................... 20
NetWorker restricted datazone environments............................... 20
Prerequisites for installing ItemPoint SharePoint GLR................................20
Install the ItemPoint Agent for Content Transfer Service for
SharePoint Server granular level recovery..................................... 21
1 Revision history............................................................................................................ 9
2 Style conventions........................................................................................................10
3 NMM support matrix for NetWorker server versions.................................................. 16
4 Exchange server hardware requirements ...................................................................17
5 Exchange Server GLR MAPI/CDO requirements.........................................................19
6 NMM installer variables.............................................................................................. 37
7 Commands for NMM installation ................................................................................37
8 Notifications and errors...............................................................................................41
9 Hotfixes that are required for NMM for VSS backup and recovery.............................46
10 Hotfixes that are required for NMM for Exchange Server backup and recovery.........46
Note
This document was accurate at publication time. To ensure that you are using the
latest version of this document, go to the Support website https://www.dell.com/
support.
Purpose
This guide contains information about how to install and configure the NetWorker
Module for Microsoft (NMM) Release 19.1 software.
Note
The NetWorker Module for Microsoft Administration Guide supplements the backup and
recovery procedures described in this guide and must be referred to when performing
application-specific tasks. Ensure that you download a copy of the NetWorker Module
for Microsoft Administration Guide from the Support website at support.emc.com
before using this guide.
Audience
This guide is part of the NetWorker Module for Microsoft documentation set and is
intended for use by system administrators during the setup and maintenance of the
product.
Readers should be familiar with the following technologies that are used in backup and
recovery operations:
l NetWorker software
l NetWorker backup management
l Microsoft Volume Shadow Copy Service (VSS) technology
Revision history
The following table presents the revision history of this document.
Related documentation
The NMM documentation set includes the following publications:
l NetWorker Module for Microsoft Release Notes
NOTICE
Note
Typographical conventions
The following type style conventions are used in this document:
Bold Used for interface elements that a user specifically selects or clicks,
for example, names of buttons, fields, tab names, and menu paths.
Also used for the name of a dialog box, page, pane, screen area with
title, table label, and window.
Italic Used for full titles of publications that are referenced in text.
Monospace Used for:
l System code
l System output, such as an error message or script
l Pathnames, file names, file name extensions, prompts, and
syntax
l Commands and options
You can use the following resources to find more information about this product,
obtain support, and provide feedback.
Where to find product documentation
l https://www.dell.com/support
l https://community.emc.com
Where to get support
The Support website https://www.dell.com/support provides access to product
licensing, documentation, advisories, downloads, and how-to and troubleshooting
information. The information can enable you to resolve a product issue before you
contact Support.
To access a product-specific page:
1. Go to https://www.dell.com/support.
2. In the search box, type a product name, and then from the list that appears, select
the product.
Knowledgebase
The Knowledgebase contains applicable solutions that you can search for either by
solution number (for example, KB000xxxxxx) or by keyword.
To search the Knowledgebase:
1. Go to https://www.dell.com/support.
2. On the Support tab, click Knowledge Base.
3. In the search box, type either the solution number or keywords. Optionally, you
can limit the search to specific products by typing a product name in the search
box, and then selecting the product from the list that appears.
Live chat
To participate in a live interactive chat with a support agent:
1. Go to https://www.dell.com/support.
2. On the Support tab, click Contact Support.
3. On the Contact Information page, click the relevant support, and then proceed.
Service requests
To obtain in-depth help from Licensing, submit a service request. To submit a service
request:
1. Go to https://www.dell.com/support.
2. On the Support tab, click Service Requests.
Note
To create a service request, you must have a valid support agreement. For details
about either an account or obtaining a valid support agreement, contact a sales
representative. To get the details of a service request, in the Service Request
Number field, type the service request number, and then click the right arrow.
Online communities
For peer contacts, conversations, and content on product support and solutions, go to
the Community Network https://community.emc.com. Interactively engage with
customers, partners, and certified professionals online.
How to provide feedback
Feedback helps to improve the accuracy, organization, and overall quality of
publications. You can send feedback to DPAD.Doc.Feedback@emc.com.
l Overview............................................................................................................ 14
l Requirements..................................................................................................... 14
l Exchange Server-specific configuration requirements........................................18
l Prerequisites for installing ItemPoint SharePoint GLR....................................... 20
Introduction 13
Introduction
Overview
The NetWorker Module for Microsoft (NMM) software provides backup and recovery
support for Microsoft applications.
You can use NMM to back up and recover:
l Microsoft SQL Server
l Microsoft SharePoint Server
l Microsoft Exchange Server
l Microsoft Hyper-V Server
Review the following information before you install and run NMM:
l NMM includes a Microsoft Volume Shadow Copy Service (VSS) requestor to
perform backup and recovery operations. If you use a VSS solution other than the
one that is configured with NMM to delete shadow copies that NMM created, data
loss can occur. Restoring an application with a different VSS solution might
prevent the application from being restored with NMM.
l Backing up a Microsoft application server with multiple backup products can cause
products to respond unexpectedly. If you use NMM, do not use other products to
back up a Microsoft application server.
Requirements
Review the information in this section before you continue with the NMM installation.
The NetWorker client or storage node, NetWorker Extended Client (if required), and
NMM software must be installed separately.
The NetWorker Installation Guide describes how to install the NetWorker client,
NetWorker storage node, and NetWorker Extended Client. When you update from an
earlier release, install the NetWorker Extended Client only.
Ensure that you install the required components in the following sequence on the
application host:
1. NetWorker storage node (includes the NetWorker client):
Run NetWorker-19.1.exe from the NetWorker package, and then select
Storage Node.
2. NetWorker client:
If the NetWorker storage node is not installed, install the NetWorker client
separately.
Run NetWorker-19.1.exe from the NetWorker package, and then select Client.
3. NetWorker Extended Client (if required):
Run lgtoxtdclnt-19.1.exe from the NetWorker package.
The NetWorker Installation Guide provides more information about the additional
features in the Extended Client package.
4. NMM software.
Run NWVSS.exe to start the NMM Installation wizard.
NMM is an application client and cannot be installed on a NetWorker server.
Note
Note
If the NetWorker Extended client is not installed before the Restore of NMM 8.2.x
and Earlier Backups (VSS workflows) option is selected during the installation, the
NMM installer displays an error.
l Install the NetWorker client software on the host before installing the NMM
software. If the host is a DSN, install the NetWorker Storage node software while
you are installing the NetWorker client.
Supported NetWorker server versions
Table 3 NMM support matrix for NetWorker server versions
Hardware requirements
The minimum hardware requirements for the application host where NMM is installed
are:
l CPU: 2.0 GHz
l Physical memory: 4 GB
l Host architecture: x64 systems only
This requirement applies to all hosts:
n Microsoft Exchange Server
n SharePoint Server
n Active Directory
n Hyper-V
n Microsoft SQL Server
Requirement Description
Memory (RAM) Exchange server often requires additional memory (RAM). Start with
8 GB of RAM. The amount of additional or total memory that is
required depends on current system performance with existing
memory:
l If the memory resources are strained and performance is slow
with normal NMM operations, add significantly more memory to
support Exchange operations.
l If the memory performance is adequate with normal NMM
operations, additional memory might not be required to support
Exchange operations.
Disk staging area Exchange server requires additional disk space for a disk staging area
to hold writes to the Exchange database and log files.
Hyper-V requirements
For best performance, ensure that the Hyper-V environment meets the following
system requirements.
These resources must be available on the Hyper-V proxy node during the backup
window for only NetWorker/NMM purposes.
When planning and allocating resources, do not exceed 70% utilization of the rated
capacity of any hardware element (CPU, RAM, backplane, or NIC).
Hyper-V proxy node in a single proxy environment:
l 1 Gb/s LAN connection to DD, or a minimum 100 MB/s transfer rate
l 1 GHz CPU (single core)
l 512 MB RAM
Hyper-V proxy node in a multi-proxy environment:
l Shared 10 Gb/s LAN connection to DD, or a 400 MB/s transfer rate
l 4 GHz CPU total (or 2 GHz dual core)
l 2 GB RAM
Licensing
Consider the following license considerations for NMM:
l For physical server environments, only one NMM license is required to manage
multiple instances of supported applications on the same server (physical host).
l For virtual server environments, one NMM license is required for each application
type (SQL, Exchange, SharePoint, Hyper-V) per physical host. The license can be
used multiple times and within all the virtual guests on a single physical server for
that application type.
l NMM requires one license per active node in a cluster environment (active-active
requires two licenses).
l Licenses for NME (Exchange) and NMSQL can be used with NMM. Supporting
these licenses ensures that customers can upgrade from NME (which is now end-
of-sale) to NMM and avoid licensing changes.
Licensing 17
Introduction
Authorization requirements
The configuration and operation of NMM backups and recoveries require authorized
access to data for the user backing up and recovering NMM data. The NetWorker
Module for Microsoft Administration Guide provides details about the privileges to
enable.
Microsoft hotfixes
For NMM to function correctly with each supported Microsoft application, ensure that
you install the required Microsoft hotfixes.
Install the required updates and hotfixes from the Microsoft website:
l Install the latest hotfixes for the Microsoft Windows operating system.
l Install the .NET Framework and the following .NET Framework updates:
n KB2604121: http://support.microsoft.com/kb/2604121
n KB2656351: http://support.microsoft.com/kb/2656351
n KB2729449: http://support.microsoft.com/kb/2729449
n KB2736428: http://support.microsoft.com/kb/2736428
n KB2737019: http://support.microsoft.com/kb/2737019
n KB2742595: http://support.microsoft.com/kb/2742595
n KB2600217: http://support.microsoft.com/kb/2600217
n KB2533523: http://support.microsoft.com/kb/2533523
n KB2468871: http://support.microsoft.com/kb/2468871
Note
automatically. When NMM is installed silently, you must manually open the NMM
Exchange Admin Configuration tool.
To use the NMM Exchange Admin Configuration tool, you must be logged in with
domain administrator permissions. You can use a non-administrative user to run the
NMM Exchange Admin Configuration tool only if you select Skip Active Directory
Authentication and configure the user with the tool on each Exchange Server node.
You can use the Exchange NMM Admin Tool to create users, configure existing users,
and assign correct permissions to existing users. NMM uses the user account that is
set in the registry by the NMM Exchange Admin Configuration tool to perform
backup, database, or granular-level recovery.
The following figure shows the NMM Exchange Admin Configuration tool landing
page.
Figure 1 NMM Exchange Admin Configuration tool
Note
NMM also supports GLR of Exchange Servers with ItemPoint for Microsoft Exchange
Server. It is recommended that you use ItemPoint for Microsoft Exchange Server for
GLR instead of the NMM UI. See the "Exchange server GLR using ItemPoint" section
in the NetWorker Module for Microsoft for Exchange VSS User Guide for the required
Outlook version. If you use ItemPoint for Microsoft Exchange Server, MAPI is not
required for GLR.
The following table outlines the MAPI/CDO version requirements with different
versions of Exchange Server.
The Exchange Server 2010 and 2013 software does not include the MAPI client
libraries and CDO. You can download the client library and CDO package from
Microsoft’s website. For information about downloading and installing this software,
search for "Microsoft Exchange MAPI Client and Collaboration Data Objects" on the
Microsoft Download Center website.
The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome
contains information about the most recent version of the MAPI and CDO kit that
NMM supports.
Install the ItemPoint Agent for Content Transfer Service for SharePoint
Server granular level recovery
Procedure
1. Log in to the SharePoint Server using Administrative privileges.
2. Run the Agent for Content Transfer Service installation wizard SetupACTS.exe.
3. On the Logon Information page, type the User Name and Password for the
SharePoint Farm Administrator User who runs the Agent for Content Transfer
Service. The username must be in the format DOMAIN\Username.
4. On the Agent for Content Service Setting page, in the Port Number field,
use the default value or type a different available port number.
Note
The Temporary File Location path is used during the copy process. Ensure that
sufficient space, possibly up to the amount of data being restored in a single
operation, exists for this task.
The ItemPoint for Microsoft SharePoint Server User Guide provides further
information about operating the Agent for Content Transfer Service.
Install the ItemPoint Agent for Content Transfer Service for SharePoint Server granular level recovery 21
Introduction
Note
2. On the Welcome Wizard page, read the license terms and agreements
carefully. Select the I agree to the license terms and agreements option, and
click Next.
The Configuration Checks Option page appears. The System Configuration
Checker verifies that the setup is correctly configured for backup and recovery
operations.
3. On the Configuration Checks Option page, specify whether to run the System
Configuration Checker.
l To continue with the NMM installation process and skip the System
Configuration Checker, do not select Run System Configuration Checker ,
and then click Next.
The Configure Windows Firewall page appears.
l To run the System Configuration Checker before the NMM installation
process, select Run System Configuration Checker, and then click Next.
5. Select the required options on the NMM Installation Options page, and then
click Next.
Figure 2 NMM Installation Options page
l If you are upgrading from a previous NMM release, select Restore of NMM
8.2.x and Earlier Backups (VSS workflows). For example, select this
option if you are upgrading from NMM 8.2.3 or later, and you plan to recover
existing backups of Exchange Server, SharePoint Server, and Hyper-V by
using NMM 19.1 (VSS workflows).
The installation wizard completes the following actions when you select
Restore of NMM 8.2.x and Earlier Backups (VSS workflows):
n Installs the NMM release 8.2 SP4 binaries, which are required to perform
restore operations.
n Installs the EldoS driver.
n Creates a Restore previous NMM release backups shortcut on the
Start menu which you can click, to start to recover the older backups.
Note
If you are using NMM for SQL VDI, do not select Restore of NMM 8.2.x
and Earlier Backups (VSS workflows). You can restore previous versions
of NMM backups without this option.
If you used Avamar for deduplication with NMM 8.2.x and earlier releases,
ensure that you install Avamar from the Avamar client package before you
upgrade to NMM 19.1. NMM 19.1 does not support Avamar node backup and
recovery.
Note
If you are performing Exchange GLR of NMM 8.2.x and earlier backups,
perform a flat-file restore of the database before you use ItemPoint. The
NetWorker Module for Microsoft for Exchange Server VSS User Guide
provides information about performing flat file restore operations.
l Select SQL SSMS Plug-in to perform SQL Server VDI backup and recovery
from the SQL Server Management Studio.
Selecting SQL SSMS Plug-in installs the NetWorker window in the SQL
Server Management Studio GUI.
l If you select SQL SSMS Plug-in, you can aslo select Enable Backup Tab
for Ad-hoc Backup and Enable Script in Backup Window.
l The BBB MountPoint Location field shows the Block Based Backup mount
point location to mount backed-up data from media for granular level
recoveries of Hyper-V and Exchange. The default location is C:\Program
Files\EMC NetWorker\nsr\tmp\BBBMountPoint. To change the
Block Based Backup mount point location, click (...), select the location,
and click OK. In the installation wizard, click Next.
6. If you selected SharePoint Granular Recovery or SQL Granular Recovery,
click Next.
The GLR Options page appears.
The NMM installer selects a default path for the MountPoint Location and
Hyper-V VHD Mount Point Location.
To change the mount point location:
a. Click (...).
b. Select the mount path location.
c. Click OK.
7. Click Install.
The Wizard Progress page appears and the installation begins. The installation
can take several minutes.
For Exchange environments, if you are logged in with Domain Administrator
privileges, the NMM Exchange Admin Configuration tool starts. If you are not
logged in with Domain Administrator privileges, a message displays prompting
you to log in with these privileges.
Use the NMM Exchange Admin Configuration tool to:
l Configure an administrative user.
l Update an administrative password.
l Validate an existing administrative user.
To return to the NMM installation wizard, click OK.
8. On the Complete the Setup page, the output shows the results of the
installation.
To view the setup log file, click the link in the results area of the page. This file
is stored in the NetWorker Module for Microsoft folder in the local
temporary folder directory of the user who is running the NMM installation
wizard.
user=administrator,host=VSS_cluster_node
user=system,host=VSS_cluster_node
b. Click OK.
The NetWorker Module for Microsoft Administration Guide provides more
information about configuring a clustered client resource.
Procedure
1. If the installation files are on a remote host, perform one of the following:
l Use the net use command to mount the remote file system.
l Copy the NMM installation files to Windows 2008 SP2, 2008 R2, 2012, 2012
R2, or 2016 Server Core by using FTP or a general access method.
2. Access the NMM installation files as described in Accessing the installation files
on page 24.
3. Run the NWVSS.exe file in the networker directory to start the NMM
installation.
Note
Note
After you uninstall NMM, you can continue to perform traditional backups by
using the NetWorker software, which is still available on the host.
5. If you uninstalled or changed NMM with one or more of the following options,
check the NWFS log file, nwfs.raw, to determine whether you must restart
the NMM host:
l SharePoint Granular Recovery
l SQL Granular Recovery
l Restore of NMM 8.2.x and Earlier Backups (VSS workflows)
Upgrading NMM
This section describes NMM upgrade procedures.
Note
Perform a full backup after upgrading from a previous NMM release to NMM 19.1.
Note
If you are upgrading NMM for Exchange from version 8.x or earlier, be aware that
non-federated Exchange database availability group (DAG) backups are no longer
supported. All Exchange DAG backups are federated. The NetWorker Module for
Microsoft for Exchange VSS User Guide provides information about federated backups.
Upgrading the client operating system from Windows Server 2012 to a later
version
When upgrading the client operating system from Windows Server 2012 to a later
version, perform the following steps.
Note
It is recommended that you perform a full backup before and after upgrading the
client operating system.
Procedure
1. Uninstall NMM by performing the steps that are described in Uninstalling or
changing installation options on page 29.
2. Upgrade Windows Server.
3. Install NMM by performing the steps that are described in Running
preconfiguration checks and installing the software on page 24.
Upgrading the client operating system from Windows Server 2012 to a later version 31
Configuration Checks and Installation
5. Run the NMM installer and select the Run System Configuration Checker
option on the Configuration Checks Option page. Running preconfiguration
checks and installing the software on page 24 provides details.
6. If a system restart is pending, restart the system after the NMM installation is
complete.
7. To immediately protect all data with NMM, perform a full backup as soon as
possible after the upgrade.
Note
Although this procedure removes the existing NME or NMSQL software, the
configuration information that was created for these products is retained
and is reapplied if you reinstall NME or NMSQL.
3. Run the NMM installer and use the Run System Configuration Checker option
on the Configuration Checks Option page.
The installation detects the storage node and prompts for permission to
dedicate the storage node to the NMM client data.
Silent Installation 35
Silent Installation
Note
The NetWorker Installation Guide describes how to install the NetWorker client
or storage node software.
3. To verify the installation, inspect the installation log files. The locations of the
log files are specified in the NMM installation. The default location is the %temp
% folder, which you can view:
a. Click Start > Run.
b. Type %temp%.
c. Browse to the parent folder of the %temp% folder.
4. (For Exchange only) After a successful silent installation, if the Exchange Admin
Configuration tool does not start automatically, manually run the tool for
successful Exchange Server backup and recovery.
Note
The restore of NMM 8.2.x and earlier backups (VSS workflows), Exchange granular
recovery, SharePoint granular recovery, and SQL granular recovery features cannot
be silently installed. To install these features, use the NMM Installation wizard.
EnableSSMSBackupTab [0|1] 0
EnableSSMSScript [0|1] 0
ConfigFirewall [0|1] 1
Sample commands
The following table provides commands to install the three NMM installer features.
These commands use the NMM installation command and the installer variables.
Task Command
Install the NMM client only NWVSS.exe /s /q /log "C:
\NMM_nw_install_detail.log" InstallLevel=100
3. To install NMM using the silent installation process, follow the steps that are
provided in Install NMM silently on page 36.
Configuration Tasks 39
Configuration Tasks
Note
Type Description
Email notification of a Configure an Owner Notification for the NMM client to send
NetWorker event an email notification about NetWorker events.
Error message details window Displays error and event messages for NetWorker server
activities, including backup or recovery operations.
Event Viewer Alerts users that user intervention is required on the NMM
host.
Log files NMM creates log files for each operation and process.
Separate log files are available for NetWorker and various
features, depending on what features are installed and in use:
l NMM
Type Description
Note
During installation in an Exchange environment, ensure that you provide the correct
Exchange credentials and fulfill the other Exchange installation requirements.
When you flush the nsr folder (remove the metadata), the nsrladb folder contains
the public key for the client that is cached in the NetWorker server’s local hosts
resource. To correct this issue, delete the NSR Peer Information on the backup server
for the client so that the cached public key is updated.
Use this command to delete the peer information:
This appendix describes Microsoft hotfix updates that are required for NMM
applications. No Microsoft hotfix requirements exist for NMM with SQL Server.
l Hotfix updates that are required for VSS backup and recovery..........................46
l Hotfix updates that are required for Exchange Server backup and recovery......46
Table 9 Hotfixes that are required for NMM for VSS backup and recovery
KB975688 Windows Server 2008 R2 A snapshot might become corrupted when VSS
snapshot providers take more than 10 seconds to
create a snapshot on a host that is running Windows
Server 2008 R2.
Table 10 Hotfixes that are required for NMM for Exchange Server backup and recovery