如何为 NuGenesis SDMS 安装和运行 EmpScan.exe 实用程序 - WKB97938

目的

为 NuGenesis SDMS 安装和运行 EmpScan.exe 实用程序。

该工具/实用程序作为 Waters 对 CRI-1719 缺陷的解决方案，可在 NuGenesis SDMS 数据库上安装和运行该工具/实用程序。该工具/实用程序扫描 NuGenesis SDMS 数据库，查找未存档的 Empower 项目，以识别未成功存档的项目。

环境

• NuGenesis 9 SDMS
• NuGenesis 8 SDMS

步骤

前提条件

• SDMS .NET SDK：必须在计算机上安装 SDK Runtime。
• Oracle 客户端：建议将该实用程序安装在已安装了 SDMS Administrator 的计算机上。理想情况下，该实用程序应放置在 PM 文件夹中。

1. 将 EmpScan.exe 文件复制到 SDMS Administrator 程序所在的文件夹中：
   • NuGenesis 9：驱动器:\Program Files (x86)\Waters\NGSDMS\PM
   • NuGenesis 8：驱动器:\Program Files (x86)\NuGenesis 8.0\PM

2. （对于 NuGenesis 8）在运行 EmpScan.exe 之前运行 NG80tkfu.exe - 以管理员身份运行命令提示符，在命令提示符中导航到 NG80tkfu.exe 的位置，然后执行以下语句：NG80tkfu.exe on misctk <Return>
   
   （对于 NuGenesis 9）在运行 EmpScan.exe 之前运行 NGtkfu.exe - 以管理员身份运行命令提示符，在命令提示符中导航到 NGtkfu.exe 的位置，然后执行以下语句：NGtkfu.exe on misctk <Return>

3. 以管理员身份运行 EmpScan.exe。
4. 在该工具中，从列表中选择一个服务器名称，然后输入 ngprojmgr 用户名和密码。
5. 要扫描所有 SDMS 项目，请在 Project（项目）列表中选择 ALL SDMS Projects（所有 SDMS 项目）；如果不扫描所有项目，可选择一个项目查看。
   • 注意：所选视图必须至少有可用的 ID 列，否则该工具将无法使用该视图。如果 Data Name（数据名称）和 Archive (VPR) Product（存档 (VPR) 产品）列可用，则该工具将使用这两列，但这两列不是必需列。
6. 单击 Begin（开始）按钮开始扫描。如果选择 ALL SDMS Projects（所有 SDMS 项目），该工具将查看所选服务器中可供用户帐户使用的所有项目（使用每个项目中的 DefaultView（缺省视图））；否则，该工具会检查项目和视图的访问，以及该视图是否适用于该工具。如果 ID 列不可用，EmpScan 将显示错误消息并且不扫描项目。如果 Data Name（数据名称）和/或 Archive (VPR) Product（存档 (VPR) 产品）列不可用，则 EmpScan 将警告用户缺少列，并询问用户是否继续扫描。
   • 如果不使用 ngprojmgr，则所需的 SDMS 权限为：
     • 打开每个 File Data（文件数据）项目的权限
     • 访问每个项目中的 DefaultView（缺省视图）
     • 访问每个项目中 Restore Location（还原位置）的 Any Location（任意位置）
7. EmpScan.exe 会将其操作记录到屏幕窗口和 \PM 文件夹中的日志文件 status.txt 中。如果错误会导致出现 NuGenesis 错误代码 (NGxxxxx)，则该错误将暂停该实用程序，因此请注意该程序并在出现此类消息时单击 OK（确定），以便可以继续检查数据库记录。

8. 该实用程序可以生成三个日志（Process.log、Status.txt 和 Bad.log）。最初，这些日志都不存在，实用程序将根据需要创建它们。Process.log 和 Status.txt 与 EmpScan.exe 位于同一文件夹中。该实用程序将根据需要创建一个“Bad”子文件夹。SDMS 中任何符合“错误”标准（见下文）的 Empower 项目备份都将归入 \Bad 子文件夹中的 bad.log 中。

附加信息

EmpScan.exe 不是标准 NuGenesis 产品安装的一部分。它是一种支持工具，用于检查 SDMS 存档不完整项目的情况（从 Empower 导出）。如果您需要此实用程序的副本，请联系 Waters 技术支持。

该工具可查找供应商/产品为“Waters Corp.”的文件记录，以及“Empower-2 Projects”或“Empower-3 Projects”，可对记录执行以下检查：

1. 检查存档分组中名为 backup.log 的文件，如果未找到则记录错误。
2. 将 backup.log 文件下载到磁盘上的临时文件夹，并在其中查找文本 Export completed successfully without warnings（导出已成功完成且没有警告）。如果找到该文本，该工具会报告 backup.log shows completed export（backup.log 显示已完成导出）。如果未找到该文本，则该工具会将 SDMS 记录的 NGID 记录为导出不完整，并将 backup.log 下载到 \Bad 子文件夹。backup.log 文件将使用时间戳、项目名称和关联 SDMS 记录的 NGID 重命名。
   
   故障排除
   1. 如果您在 Empower 项目备份日志完整性检查实用程序窗口的日志记录区域中收到一条消息，该消息显示：
      This method is reserved for future use（保留此方法供将来使用）：
      这表明未运行相应的 NG80tkfu/NGtkfu.exe 文件。
      停止扫描，删除所有创建的日志文件，然后从步骤 2 开始重复上述过程。
      单击 Abort（中止）将很快停止该过程。如果正在进行还原工作，则将在此之后停止。
   2. Empower 项目的处理顺序不一定是连续的。显示在状态窗口中的 NGID 可能会向 0001 倒读数，但在达到此值时，可能会继续处理其他记录。