Review the error messages in this section to troubleshoot issues during SharePoint Server backup and recovery.
Table 11 SharePoint error messages
Error message Reason Resolution
“NMM... ERROR. Writer SharePoint Services Writer with local dependent writer id {comp Content Index _ SPSearch cannot be found.
CONTINUE PROCESSING.”
SharePoint services start automatically before backup if SharePoint search is configured.
However, some times the SharePoint services do not start automatically and an error occurs.
Ensure that all
ERROR..Writer SharePoint Services Writer with local dependent writer id { comp
445f327e-9abf-48c6-9a9a-32ddcba70bcc-crawl-0 cannot be found. CONTINUE PROCESSING. “
This error might occur during a SharePoint Server 2010 farm backup.
Restart the Search Service SharePoint Foundation Search V4.
“Failed to do registration of snapshot set…..Backup failed.”
This error occurs when SQL backup fails in a SharePoint group although SharePoint backup is successful.
There can be two reasons for this error:
l When a SharePoint client resource is configured by using the Client Backup Configuration wizard, a SQL virtual cluster client resource must be created
automatically.
However, when a SQL virtual cluster client is added by using the Client Backup Configuration wizard, the error “Unable to connect to server.
Unable to authenticate with server 2007farm-wfe:
Authentication error;
why = Server rejected credential” appears,
3. Start the Client Backup
5. Start the Client Backup
Table 11 SharePoint error messages (continued)
Error message Reason Resolution
backup fails. The SharePoint Server backup is successful.
l The SQL client backup might fail if the NetWorker client and NMM are installed on the client machine, but after a NetWorker server upgrade or reinstallation, the NetWorker client and NMM have not been reinstalled.
credential”
appears.
6. Install NMM.
7. Start the Client Backup Configuration wizard.
You are able to create all the
ERROR..Writer SharePoint Services Writer with local dependent writer id { comp
445f327e-9abf-48c6-9a9a-32ddcba70bcc-crawl-0 cannot be found. CONTINUE PROCESSING.”
If a recovery is not performed in the correct sequence, all subsequent backups on the search node fail with this error message.
Ensure to perform recovery in the following sequence:
1. SharePoint Configuration Data 2. SQL Server database 3. SharePoint Writer
Perform either of the following steps:
Cannot retrieve dependent writer for APPLICATIONS:\SharePoint Services Writer
\445f327e-9abf-48c6-9a9a-32ddcba70bcc-crawl-0
"Depends on 'null' on Client '2010FARM-CNADM'".”
If a recovery is not performed in the correct sequence, when the nsrsnap_vss_save.exe -v -? command is run subsequently on the SharePoint node, this error message appears.
Ensure to perform recovery in the following sequence:
1. SharePoint Configuration Data 2. SQL Server database 3. SharePoint Writer
Perform either of the following steps:
Table 11 SharePoint error messages (continued)
Error message Reason Resolution
“VSS_UNKNOWN_ERROR.” SharePoint backup fails
with this error when SharePoint Writers are not in a stable state.
Perform the following steps:
1. Check the state of the
3. Restart of the client machine.
“Operation unit failed with error 'Error encountered in remote agent for unit id :256, ErrorHandler invoked'.Possible cause:
1)Unsupported file system or 2)write-protected disc or 3)No space on disc or 4)Drive not found. NMM .. Error backing up one or more of the file system savesets: NMM .. Operation unit failed with error”
SharePoint backup using Avamar deduplication fails with this error. This error can be caused by any of the following:
l Unsupported file system
l Write-protected disc
l No space on disc
l Drive is not found
Recreate the client account in Avamar.
“2013-07-03 14:23:55 avtar Error <5126>:
Login error 74: Account not found in the Avamar database
2013-07-03 14:23:55 avtar FATAL <8941>:
Failed to initiate connection with server due to earlier errors. Verify server address and login credentials.
2013-07-03 14:23:55 avtar Info <6149>: Error summary: 2 errors: 8941, 5126
2013-07-03 14:23:55 avtar Info <8468>:
Sending wrapup message to parent 2013-07-03 14:23:55 avtar Info <5314>:
Command failed (2 errors, exit code 10008:
cannot establish connection with server (possible network or DNS failure))”
This error is seen in Avamar logs on the NMM client machine. This error can be caused by any of the following:
l Unsupported file system
l Write-protected disc
l No space on disc
l Drive is not found
Recreate the client account in Avamar.
“63333:nsrsnap_vss_save:NMM .. process replica not attempted. Preparation step failed.
This error occurs when the SharePoint Central
Uninstalled NMM and then reinstall
Troubleshooting
Error messages 109
Table 11 SharePoint error messages (continued)
Error message Reason Resolution
37959:nsrsnap_vss_save:The specified path is invalid.
.
63335:nsrsnap_vss_save:NMM backup failed to complete successfully.
Internal error.
SYSTEM COMPONENTS:\: failed “ The NMM logs display this error :
“NSR info NMM .. failed to create the place holder file s. -- 161
NSR info NMM .. process replica not attempted. Preparation step failed.
NSR info NMM .. failed to post process and delete one or more legacy objects.
NSR critical The specified path is invalid.
NSR critical NMM backup failed to complete successfully.”
Administration backup fails in a SharePoint distributed farm setup that has a pure web front-end.
For example, a farm is created, and the NetWorker client and NMM are installed. After a while, the farm has some issues due to which the farm is re-created:
l The farm is disconnected.
l The farm databases in the SQL Server are deleted and a new farm is created.
l The Web applications, site collections, sub-sites, document lists, and a pure web front-end are created. not listed. When the client resource is created manually and a backup is
performed, the backup fails. NMM is unable to detect the SharePoint the correct save sets are listed. Backup and recovery are successful.
"3164:nsrsnap_vss_save:NMM .. An error was detected during the replica creation. Details in nmm.raw on 201064stdaln and in the Windows Application or System Event Log.
Backup fails on a SharePoint stand-lone setup with this error if the SharePoint Product
Table 11 SharePoint error messages (continued)
Error message Reason Resolution
49931:nsrsnap_vss_save:RM .. 027202 ERROR:Windows API GetVolumePathName failed with Windows error: The filename 49931:nsrsnap_vss_save:RM .. 026727 ERROR:An unexpected exception occurred in the RM VSS Any Writer application agent while getting the browse tree.
49931:nsrsnap_vss_save:RM .. 026045 ERROR:An unexpected internal error occurred:
Failed to build browseTree.
49931:nsrsnap_vss_save:RM .. 026045 ERROR:An unexpected internal error occurred:
Failed to build browseTree.
"
The event viewer logs display the following error:
"The mount operation for the gatherer application 49996950-0e3e-4d3a-afa9-a7787d89bba8 has failed because the schema version of the search administration database is less than the minimum backwards compatibility schema version supported for this gatherer application. The database might not have been upgraded."
not run after installing a SharePoint service pack.
Troubleshooting
Error messages 111
Troubleshooting
GLOSSARY
This glossary contains terms related to NMM. Many of these terms are used in this manual.
A
administrator Person normally responsible for installing, configuring, and maintaining NetWorker software.
administrators group Microsoft Windows user group whose members have the rights and privileges of users in other groups, plus the ability to create and manage the users and groups in the domain.
advanced file type device
(AFTD) Disk storage device that uses a volume manager to enable multiple concurrent backup and recovery operations and dynamically extend available disk space.
application specific
module (ASM) Program that is used in a directive to specify how a set of files or directories is to be backed up or recovered. For example, compressasm is a NetWorker directive used to compress files.
archive Back up directories or files to an archive volume to free up disk space. Archived data is not recyclable.
archive request NetWorker resource used to schedule and manage archiving.
archive volume Volume used to store archive data. Archived data cannot be stored on a See backup volume or a See clone volume.
ASR writer VSS Writer that is responsible for identifying the critical data needed to perform an offline restore.
attribute Name or value property of a resource.
authorization Privileges assigned to users.
authorization code Unique code that in combination with an associated enabler code unlocks autochanger See library.
autochanger sharing See library sharing.
auto media management Feature that enables the storage device to automatically label, mount, and overwrite an unlabeled or recyclable volume.
B
backup Operation that saves data to a volume. See conventional backup and See snapshot.
backup components See metadata document.
EMC NetWorker Module for Microsoft for SQL and SharePoint VSS8.2 Service Pack 1 User Guide 113
backup cycle Full or level 0 backup and all the subsequent incremental backups that are dependent on that backup.
backup group See granular recovery.
backup level See level.
backup volume Volume used to store backup data. Backup data cannot be stored on an See archive volume or a See clone volume. See volume.
Boot Configuration Data
(BCD) ASR Writer component that identifies the location of the boot configuration database. This component is required to perform an offline restore.
browse policy NetWorker policy that specifies the period of time during which backup entries are retained in the client file index. Backups listed in the index are browsable and readily accessible for recovery. See retention policy .
C
carousel See library.
client Computer, workstation, or file server whose data can be backed up and recovered.
client file index Database that tracks every database object or file that is backed up. The NetWorker server maintains a single client index file for each client.
client resource NetWorker server resource that identifies the save sets to be backed up on a client. The client resource also specifies information about the backup, such as the schedule, browse policy, and retention policy for the save sets. See also See client and See resource.
clone Reliable copy of backed-up data. Unlike volumes created with a simple copy command, clone volumes can be used in exactly the same way as the original backup volume. Single save sets or entire volumes can be cloned.
clone volume Exact duplicate of a backup volume. One of four types of volumes that NetWorker software can track (backup, archive, backup clone, and archive clone). Save sets of these different types may not be intermixed on one volume.
cluster 1. Two or more independent network servers that operate and appear to clients as if they are a single unit. The cluster configuration enables work to be shifted from one server to another, providing high availability that enables application services to continue despite most hardware or software failures.
2. Group of disk sectors. The operating system assigns a unique number to each cluster and keeps track of files according to which clusters they use.
command line Line on a display screen, also known as a command prompt or shell prompt, where you type software commands.
component 1. Group of related data that must be treated as a single unit for backup and recovery.
2. In Microsoft VSS terminology, a subordinate unit of a See Writer.
components metadata
document See metadata document.
Glossary
consistent State of a data set that is fully and immediately available to an application view.
conventional backup See nonpersistent snapshot.
D
data mover (DM) Client system or application, such as NetWorker, that moves the data during a backup, recovery, or snapshot operation. See proxy client.
data retention policy See retention policy . datawheel See library.
datazone Group of hosts administered by a NetWorker server.
device 1. Storage unit that reads from and writes to backup volumes. A storage unit can be a tape device, optical drive, See autochanger , or file connected to the server or See storage node.
2. When dynamic drive sharing (DDS) is enabled, refers to the access path to the physical drive.
directed recovery Method of recovery that recovers data that originated on one client computer and re-creates it on another client computer.
directive Instruction that directs NetWorker software to take special actions on a given set of files for a specified client during a backup or recovery operation. Directives are ignored in manual (unscheduled) backups.
disk subsystem Integrated collection of storage controllers or HBAs, disks, and any required control software that provides storage services to one or more hosts, such as VMAX arrays.
Distributed File System
(DFS) Microsoft Windows add-on that creates a logical directory of shared directories that span multiple machines across a network.
domain controller Computer that stores directory data and manages user interactions within a domain, including login, authentication, directory searches, and access to shared resources.
dynamic drive sharing
(DDS) Feature that enables the NetWorker software to recognize shared drives.
F
file index See client file index.
full backup See level.
G
granular recovery Type of recovery that provides the ability to recover specific files in seconds from a single backup. This type of recovery dramatically reduces the recovery time and the footprint of the backup on storage resources.
Glossary
EMC NetWorker Module for Microsoft for SQL and SharePoint VSS8.2 Service Pack 1 User Guide 115
group Client or group of client computers that are configured to back up files at a designated time of day.
H
high-availability system System of multiple computers configured as cluster nodes on a network that ensures that the application services continue despite a hardware or software failure. Each cluster node has its own IP address with private resources or disks that are available only to that computer.
host ID Serial number that uniquely identifies a host computer.
I
inactivity timeout Number of minutes to wait before a client is considered to be unavailable for backup.
J
jukebox See library.
L
label Electronic header on a volume used for identification by NetWorker or another data mover application.
legacy method Use of special-case Microsoft APIs to back up and recover operating system components, services, and applications.
level Backup configuration option that specifies how much data is saved during a scheduled or manual backup:
l A full (f) backup backs up all files, regardless of when they last changed.
l Levels one through nine (1-9) backups back up files that have changed since the last lower numbered backup level.
l An incremental (incr) backup backs up only files that have changed since the last backup.
library Hardware device that contains one or more removable media drives, as well as slots for pieces of media, media access ports, and a robotic mechanism for moving pieces of media between these components. Libraries automate media loading and mounting functions during backup and recovery. The term library is synonymous with autochanger, autoloader, carousel, datawheel, jukebox, and near-line storage.
library sharing Shared access of servers and storage nodes to the individual tape drives within a library.
local cluster client NetWorker client that is not bound to a physical machine, but is instead managed by a cluster manager. It is also referred to as a logical or virtual client.
locale settings Settings that specify the input and output formats for date and time, based on local language conventions.
Glossary
M
media Physical storage, such as a magnetic tape, optical disk, or file system, to which backup data is written. See volume.
media database Database that contains indexed entries of storage volume location and the life cycle status of all data and volumes managed by the NetWorker server. Also known as a media index.
metadata document VSS information stored in an XML document that is passed from the See Writer to the See requestor. Metadata includes the Writer name, files, and components to back up, a list of components to exclude from the backup, and the methods to use for recovery. See also See shadow copy set.
mount To make a database available for use or to place a removable tape or disk volume into a drive for reading or writing.
mount point See volume mount point.
N
Network Data Management Protocol (NDMP)
TCP/IP-based protocol that specifies how heterogeneous network components communicate for the purposes of backup and recovery.
NetWorker administrator User who can add to or change the configuration of the NetWorker server, media devices, and libraries. NetWorker administrators must have their usernames included in the NetWorker server Administrator list.
NetWorker client See client.
NetWorker Management
Console (NMC) Software program that is used to manage NetWorker servers and clients. The NetWorker Console server provides reporting and monitoring capabilities for all NetWorker processes.
NetWorker server Computer on a network that runs the NetWorker client software, contains the online indexes, and provides backup and restore services to the clients and storage nodes on the same network.
NetWorker storage node See storage node.
nonclone pool Pool that contains data that has not been cloned.
noncritical volume Volume that contain files that are not part of the system state or an installed service.
nonpersistent snapshot Snapshot backup that is moved to secondary storage on the NetWorker server or storage node and is no longer available for recovery from a supported type of primary storage.
O
offline restore Restore operation performed from the Windows Preinstallation Environment (PE) environment.
Glossary
EMC NetWorker Module for Microsoft for SQL and SharePoint VSS8.2 Service Pack 1 User Guide 117
online indexes Databases located on the NetWorker server that contain all the information pertaining to the client backups (See client file index) and backup volumes (See media database).
online restore Restore operation performed by using the normal recovery UI, and the computer is booted from an installed operating system.
operator Person who monitors the server status, loads backup volumes into storage devices, and executes day-to-day NetWorker tasks.
P
pathname Set of instructions to the operating system for accessing a file:
l An absolute pathname indicates how to find a file by starting from the root directory.
l A relative pathname indicates how to find the file by starting from the current directory.
persistent snapshot Snapshot that is retained on disk. A persistent snapshot may or may not be rolled over to tape.
point-in-time copy (PiT
copy) Fully usable copy of a defined collection of data, such as a consistent file system,
database, or volume that contains an image of the data as it appeared at a single point-in-time. A PiT copy is also called a See shadow copy or a See snapshot.
policy Set of constraints that specify how long the save sets for a client are available for recovery.
Each client has a browse policy and a retention policy. When the retention policy expires, the save sets associated with that policy are marked recyclable.
pool NetWorker feature to sort backup data to selected volumes.
provider Software component defined by Microsoft VSS, that plugs in to the VSS environment. A provider, usually produced by a hardware vendor, enables a storage device to create and manage snapshots.
proxy client Surrogate client that performs the NetWorker save operation for the client that requests the backup. A proxy client is required to perform a See rolloveronly backup.
R
recover To recover files from a backup volume to a client disk.
Registry Microsoft Windows database that centralizes all Windows settings and provides security and control over system, security, and user account settings.
replica See shadow copy .
requestor Interface with the Microsoft VSS infrastructure that initiates the creation and destruction of a See shadow copy . NetWorker software is a requestor.
resource Component that describes the NetWorker server or its clients. Clients, devices, schedules, groups, and policies are all NetWorker resources. Each resource has attributes that define its properties.
Glossary
restore Process of retrieving individual data files from backup storage and copying the files to
restore Process of retrieving individual data files from backup storage and copying the files to