Mirror Tool - Windows

Are you a Linux user?

The Mirror Tool is necessary for offline detection engine updates. If your client computers do not have an Internet connection and need detection engine updates, you can use the Mirror Tool to download update files from ESET update servers and store them locally.


note

The Mirror Tool downloads detection engine updates and other program modules only, it does not download PCUs (Program Component Updates) and ESET LiveGrid® data. It can also create a  full offline repository. Alternatively, you can upgrade products individually.

Prerequisites


important

The Mirror Tool does not support Windows XP and Windows Server 2003.

The target folder must be available for sharing, Samba/Windows or HTTP/FTP service, depending on how you want to have the updates accessible.

You must have a valid Offline license file that includes the Username and Password. When generating a license file, be sure to select the check box next to Include Username and Password. Also, you must enter a license Name. An offline license file is needed for the activation of the Mirror Tool and generation of the update mirror.

create_offline_lic_file

Before running the Mirror Tool, you need to have the following packages installed:

Visual C++ Redistributable for Visual Studio 2010

Visual C++ 2015 Redistributable x86

How to use the Mirror Tool

1.Download the Mirror Tool from the ESET download page (Standalone installers section).

2.Unzip the downloaded archive.

3.Open the Command Prompt and navigate to the folder with the MirrorTool.exe file.

4.Run the command below to view all available parameters for the Mirror Tool:

MirrorTool.exe --help

 

mirror_tool_help

 


note

All filters are case sensitive.

Parameter

Description

--updateServer

When you use it, you must specify the full URL of the update server.

--offlineLicenseFilename

You must specify a path to your offline license file (as mentioned above).

 

You can specify a string that the Mirror Tool uses as a download filter. The Mirror Tool downloads only files which contain the string in their common name. You can select more products by adding more arguments, for example: --productFilterForRepository Antivirus Security

The Mirror Tool downloads all selected languages for each selected product.

--mirrorOnlyLevelUpdates

No argument needed. If set, only level updates will be downloaded (nano updates will not be downloaded). Read more about update types in our Knowledgebase article.

--mirrorFileFormat


warning

Before using the --mirrorFileFormat parameter, ensure that you environment does not contain both older (6.5 and older) and newer (6.6. and later) ESET security product versions. The incorrect usage of this parameter may result in incorrect updates of your ESET security products.

You can specify which type of update files will be downloaded. Possible values (case sensitive):

dat - Use this value if you have environment only with ESET security product versions 6.5 and older.

dll - Use this value if you have environment only with ESET security product versions 6.6 and later.

The parameter is ignored when creating a mirror for legacy products (ep4, ep5).

--compatibilityVersion

This optional parameter applies to the Mirror Tool distributed with ESET PROTECT 8.1 and later.

The Mirror Tool will download update files compatible with ESET PROTECT repository version you specify in the parameter argument in format x.x or x.x.x.x, for example: --compatibilityVersion 9.0 or --compatibilityVersion 8.1.13.0.


note

To reduce the amount of data dowloaded from the ESET repository, we recommend that you use the new parameters in Mirror Tool distributed with ESET PROTECT 9: --filterFilePath and --dryRun:

1.Create a filter in a JSON format (see --filterFilePath below).

2.Perform a test Mirror Tool run with the --dryRun parameter (see below) and adjust the filter as necessary.

3.Run the Mirror Tool with the --filterFilePath parameter and the defined download filter, together with --intermediateRepositoryDirectory and --outputRepositoryDirectory parameters.

4.Run the Mirror Tool regularly to always use the latest installers.

--filterFilePath

Use this optional parameter to filter ESET security products based on a text file in JSON format placed in the same folder as Mirror Tool, for example: --filterFilePath filter.txt).

arrow_down_business Filter configuration description:

--dryRun

When you use this optional parameter, Mirror Tool will not download any files, but it will generate a .csv file listing all packages that will be downloaded.

 

You can use this parameter without mandatory parameters --intermediateRepositoryDirectory and --outputRepositoryDirectory, for example: MirrorTool.exe --repositoryServer AUTOSELECT --dryRun test.csv.

 


note

Some ESET installers are language-generic (with the multilang language code) and the Mirror Tool will list them in the .csv file even if you specify languages in --filterFilePath.

 

If you use the --dryRun parameter and also --intermediateRepositoryDirectory and --outputRepositoryDirectory parameters, the Mirror Tool does not clear the outputRepositoryDirectory.


important

The Mirror Tool creates a structure of folders different from what Endpoint mirror does. Each folder holds update files for a group of products. You have to specify the full path to the correct folder in the update settings of the product using the mirror.

For example, to update the ESET PROTECT 9 from the mirror set the Update server to (according to your HTTP server root location):

http://your_server_address/mirror/eset_upd/era6

Note: The era6 mirror folder is common for these ESET remote management solutions: ERA 6, ESMC 7, ESET PROTECT.

arrow_down_business Language codes table

To create a mirror, run the Mirror Tool with at least the minimum required parameters. Here is an example:

MirrorTool.exe --mirrorType regular ^

--intermediateUpdateDirectory c:\temp\mirrorTemp ^

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

--outputDirectory c:\temp\mirror

Here is an example of more advanced configuration for an offline repository with selected products, languages and enabled download of legacy files:

MirrorTool.exe --repositoryServer AUTOSELECT ^

--intermediateRepositoryDirectory c:\temp\repoTemp ^

--outputRepositoryDirectory c:\temp\repository ^

--languageFilterForRepository sk_SK fr_FR de_DE ^

--productFilterForRepository Antivirus Security ^

--downloadLegacyForRepository

Mirror Tool and Update settings

To automate downloads for modules updates, you can create a schedule to run the Mirror Tool. To do so, open your Web Console and click Client Tasks > Operating System > Run Command. Select Command line to run (including a path to the MirrorTool.exe) and a reasonable trigger (such as CRON for every hour 0 0 * * * ? *). Alternatively, you can use the Windows Task Scheduler or Cron in Linux.

To configure updates on a client computer(s), create a new policy and configure Update server to point to your mirror address or shared folder.


important

If you are using an HTTPS mirror server, you need to import its certificate to the trusted root store on the client machine. See Installing the trusted root certificate in Windows.


note

Read this Knowledgebase article to set up Mirror Tool chaining (configure Mirror Tool to download updates from another Mirror Tool).