镜像工具 - Windows

您是 Linux 用户吗？

镜像工具对脱机检测引擎更新而言不可或缺。如果您的客户端计算机不具有 Internet 连接而需要进行检测引擎更新，您可以使用镜像工具从 ESET 更新服务器下载更新文件，然后将其存储在本地。

note

镜像工具仅下载检测引擎更新和其他程序模块，不会下载 PCU（程序组件更新）和 ESET LiveGrid® 数据。它还能创建完整脱机存储库。也可以单独升级产品。

先决条件

important

镜像工具不支持 Windows XP 和 Windows Server 2003。

•目标文件夹必须可供共享（Samba/Windows 或 HTTP/FTP 服务），具体取决于您希望如何访问更新。

o适用于 Windows 的 ESET 安全产品 - 可以使用 HTTP 或共享文件夹远程更新它们。

o适用于 Linux/macOS 的 ESET 安全产品 - 只可以使用 HTTP 远程更新它们。如果使用共享文件夹，该文件夹必须和 ESET 安全产品位于同一计算机上。

•您必须具有一个包含用户名和密码的有效脱机许可证文件。生成许可证文件时，请务必选中包括用户名和密码旁边的复选框。此外，必须输入许可证名称。需要一个脱机许可证文件来激活镜像工具以及生成更新镜像。

create_offline_lic_file

•在运行镜像工具之前，需要安装以下程序包：

•Visual C++ Redistributable for Visual Studio 2010

•Visual C++ 2015 Redistributable x86

如何使用镜像工具

1.从 ESET 下载页（独立安装程序部分）下载镜像工具。

2.解压缩下载的压缩文件。

3.打开命令提示，然后导航到内含 MirrorTool.exe 文件的文件夹。

4.运行以下命令，以查看镜像工具及其版本的所有可用参数：

MirrorTool.exe --help

 

mirror_tool_help

 

note

所有过滤器均区分大小写。

参数

说明

--updateServer

当您使用它时，您必须指定更新服务器的完整 URL。

--offlineLicenseFilename

您必须指定指向您的脱机许可证文件的路径（如上所述）。

--mirrorOnlyLevelUpdates

不需要参数。如果已设置，则仅下载级别更新（不会下载微量更新）。在我们的知识库文章中阅读有关更新类型的详细信息。

--mirrorFileFormat

warning

在使用 --mirrorFileFormat 参数前，确保您的环境不包含更低（6.5 及更低版本）和更高（6.6. 及更高版本）ESET 安全产品版本。此参数的错误使用可能导致 ESET 安全产品的错误更新。

可以指定下载哪种类型的更新文件。可能的值（区分大小写）：

•dat - 如果您的环境仅有 ESET 安全产品版本 6.5 及更低版本，则使用此值。

•dll - 如果您的环境仅有 ESET 安全产品版本 6.6 及更高版本，则使用此值。

当创建旧产品（ep4、ep5）的镜像时，忽略此参数。

--compatibilityVersion

此可选参数适用于随 ESET PROTECT 8.1 及更高版本一起分发的镜像工具。

镜像工具将下载与您在参数自变量中以格式 x.x 或 x.x.x.x 指定的 ESET PROTECT 存储库版本兼容的更新文件，例如：--compatibilityVersion 9.1 或 --compatibilityVersion 8.1.13.0。

note

要减少从 ESET 存储库下载的数据量，建议您在随 ESET PROTECT 9 一起分发的镜像工具中使用新参数：--filterFilePath 和 --dryRun：

1.采用 JSON 格式创建过滤器（参见下面的 --filterFilePath）。

2.执行使用 --dryRun 参数运行镜像工具的测试（参见下文），并根据需要调整过滤器。

3.使用 --filterFilePath 参数和定义的下载过滤器，以及 --intermediateRepositoryDirectory 和 --outputRepositoryDirectory 参数运行镜像工具。

4.定期运行镜像工具，以始终使用最新的安装程序。

--filterFilePath

使用此可选参数以根据与镜像工具位于同一文件夹中的 JSON 格式文本文件过滤 ESET 安全产品，例如：--filterFilePath filter.txt。

arrow_down_business 过滤器配置说明：

--dryRun

当使用此可选参数时，镜像工具不会下载任何文件，但它会生成一个 .csv 文件（其中列出将要下载的所有程序包）。

 

可以在不带强制参数 --intermediateRepositoryDirectory 和 --outputRepositoryDirectory 的情况下使用此参数，例如：MirrorTool.exe --repositoryServer AUTOSELECT --dryRun test.csv。

 

note

某些 ESET 安装程序是通用于语言的（语言代码为 multilang），即使在 --filterFilePath 中指定了语言，镜像工具也会将它们列在 .csv 文件中。

 

如果使用 --dryRun 参数以及 --intermediateRepositoryDirectory 和 --outputRepositoryDirectory 参数，镜像工具不会清除 outputRepositoryDirectory。

--listUpdatableProducts

列出 Mirror Tool 可以为其下载模块更新的所有 ESET 产品（除非使用了 --excludedProducts）。

从版本 Mirror Tool 开始提供该参数：1.0.1294.0 (Windows)，1.0.2226.0 (Linux)。

important

镜像工具创建的文件夹结构不同于 Endpoint 镜像创建的文件夹结构。每个文件夹都包含一组产品的更新文件。必须在使用镜像的产品的更新设置中指定正确文件夹的完整路径。

例如，要从镜像更新 ESET PROTECT 9.，请将更新服务器设置为以下网址（根据 HTTP 服务器根位置）：

http://your_server_address/mirror/eset_upd/era6

注意：era6 镜像文件夹对于这些 ESET 远程管理解决方案是通用的：ERA 6, ESMC 7, ESET PROTECT。

arrow_down_business 语言代码表

MirrorTool.exe --mirrorType regular ^

--intermediateUpdateDirectory c:\temp\mirrorTemp ^

--offlineLicenseFilename c:\temp\offline.lf ^

--outputDirectory c:\temp\mirror

以下是内含所选产品、语言和已启用旧文件下载功能（在 filter.txt 文件中定义）的脱机存储库的更高级配置示例（请参阅上述 --filterFilePath 详细信息中的文件内容示例）：

MirrorTool.exe --repositoryServer AUTOSELECT ^

--intermediateRepositoryDirectory c:\temp\repoTemp ^

--outputRepositoryDirectory c:\temp\repository ^

--filterFilePath filter.txt

镜像工具和更新设置

•若要自动下载模块更新，可以创建一个运行镜像工具的计划。若要执行此操作，请打开 Web 控制台并导航至客户端任务 > 操作系统 > 运行命令。选择要运行的命令行（包括指向 MirrorTool.exe 的路径）和合理的触发器（如每小时都执行 CRON 0 0 * * * ?*）。您也可以使用 Windows 任务计划程序或 Linux 中的 Cron。

•若要在客户端计算机上配置更新，请创建新策略并将更新服务器配置为指向您的镜像地址或共享文件夹。

important

如果您使用 HTTPS 镜像服务器，则需要将其证书导入到客户端计算机上受信任的根存储中。请参见 Windows 上的安装受信任的根证书。

note

请参阅本知识库文章以设置镜像工具链（配置镜像工具为从其他镜像工具下载更新）。