NetWorker NMM SharePoint 备份失败,并显示 “NetWorker canonical client name could not be retrieved.
Summary: SharePoint Farm 的 NetWorker Module for Microsoft 备份失败,并显示错误: 无法检索“SQLServerName”的 NetWorker 规范客户端名称。 这通常是 SQL 别名配置错误的结果。
Symptoms
在以下情况下,SharePoint 场的 NetWorker Module for Microsoft (NMM) 备份失败,并显示此错误。
- SharePoint Server 具有在 SQL 客户端网络实用工具 (CLICONFG) 中定义的 SQL Server 别名
- 同时,将 SQL 别名添加到 DNS,或者 SQL 连接参数包含 DNS 名称。
典型错误:
在 SQL Server 的 NetWorkerPath>/nsr/applogs/nsrnmmsv.raw 中<发生故障并显示类似的错误:
-
nsrnmmsv NetWorker canonical client name could not be retrieved for "SQLServerName"
-
nsrnmmsv NSR critical Failed to start save job on host 'SQLServername'
-
DefaultDomain: Executing script Get-ItemProperty hklm:software\microsoft\mssqlserver\client\connectto | Select SQLServerAliasName DefaultDomain: Alias found DBMSSOCN,sqlservername
Cause
SQL Server 客户端网络实用工具 (CLICONFG)。
这是一个 Windows SQL Server 实用程序,允许用户创建别名作为 SQL Server 的备用名称。
这允许本地客户端应用程序使用别名而不是正确的服务器名称与 SQL Server 建立连接。
此别名是本地应用程序别名,不是域名服务 (DNS) 中的规范名称。
SQL Server 别名。
CLICONFG 中的别名由以下设置定义:
服务器别名 - 这是可由本地客户端应用程序(如 SharePoint)使用的备用名称。
连接参数 - 这定义了要实际连接到的 SQL Server。 这是真实的 SQL Server 名称和 TCP/IP 端口(如果使用标准端口号,则为空)
注 1。 Real SQL Server 名称必须在 DNS 中解析为有效的唯一 IP 地址。
注2. 服务器别名仅由本地客户端应用程序(如 SharePoint)使用。 它不是有效的主机名或服务器名称。 切勿为此“别名”创建 DNS 记录,否则会导致问题。
确定真实的 SQL Server 名称:
1. 登录到 SQL Server 并打开 SQL Server Management Studio; 连接到 SQL,注意左侧树视图上的服务器名称。 或者,
2. 直接登录 SQL Server 并打开 SQL Server Management Studio; 打开新查询并运行此 T-SQL 命令,
SELECT @@SERVERNAME
这应返回 CLICONFG 的别名设置中所需的 SQL Servername。 不应使用其他服务器名称。
3. 在 SharePoint Server 上运行
nsrnmmsv -P
在 == 依赖主机 ==
列表下,应会看到真实的 SQL Server 名称,并且它应与 SSMS 中的名称匹配。
示例 CLICONFIG。
请注意下面的示例,
SQL Server 客户端网络实用工具:
服务器别名是 DBSERV
,它指向真实 SQL Server 名称的连接参数,PRODDB1

Resolution
要确保 NetWorker Modoule for Microsoft (NMM) 可从 SharePoint 正确确定别名 DBSERV 用于连接到实际 SQL Server PRODDB1,
请确保以下各项:
- 服务器别名 DBSERV 不会添加到 DNS 或主机文件中
- 连接参数中的 SQL Server 名称是与 SSMS 中的 SQL Server 名称匹配的实际 SQL Server 名称。