MirrorTool
or Windows MirrorTool.exe
file. See the complete documentation for more information on the Mirror Tool and a list of available parameters.
MirrorTool.exe
does not run on Windows XP and Windows Server 2003Download the update files using the Mirror Tool to your intermediary machine.
Configure the ESET Mirror Tool to download updates from another ESET Mirror Tool.
The Mirror Tool downloads data to the repository-intermediate
folder. When the download is finished, it moves all the data to the repository-final
folder.
Make sure to have enough space free on your drive, each folder is 100GB in size. As ESET releases new updates and product versions, the total size will continue to grow.
Run the following command in the command line on a computer with internet access. Use MirrorTool.exe
on Windows machines and MirrorTool
on Linux.
MirrorTool.exe --repositoryServer AUTOSELECT ^
--intermediateRepositoryDirectory repository-intermediate ^
--outputRepositoryDirectory repository-final
Follow these steps to reduce the download size of the folder:
You can reduce the download size of the folder by using the following parameters:
--productFilterForRepository
– Later in this document, you can find a list of the product names that can be used with this parameter. Type the product names or a part of the name. Enclose the in " "
if it contains a space. Separate multiple names by a single space, for example: "ESET Management Agent" "Antivirus".
When filtering for a partial name, for example "Agent"
, all products containing the string are filtered.
--languageFilterForRepository
– Select which language packs would be downloaded. Type in or copy/paste the codes separated by a single space, for example: sk_SK fr_FR de_DE
.
See the list of language codes.
The following command only downloads the packages necessary for an ESET PROTECT upgrade. For example, you can use such a repository when installing ESET Management Agent via the following methods:
Example usage of the --productFilterForRepository
parameter:
MirrorTool.exe --repositoryServer AUTOSELECT ^
--intermediateRepositoryDirectory repository-intermediate ^
--outputRepositoryDirectory repository-final^
–-productFilterForRepository "ESET Management Agent" "ESET PROTECT Bootstrapper" "ESET PROTECT Server" "ESET PROTECT WebConsole"
To reduce the download size of the folder, create a text file in JSON format placed in the same folder as Mirror Tool, for example: --filterFilePath filter.txt
In the text file, type in the desired parameters as described in this Online Help article. Later in this document, you can find a list of the product names that can be used with these parameters. See the list of language codes.
Optionally, add the parameter --dryRun
to the text file and run the Mirror Tool. 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.
To create an update mirror, you need the offline license file (license_file.lf
) available on your intermediary machine. Run the following command to download the update files:
MirrorTool.exe --mirrorType regular ^
--intermediateUpdateDirectory mirror-intermediary ^
--offlineLicenseFilename license_file.lf ^
--outputDirectory mirror-final
The Mirror Tool creates two folders, temporary and final with 3GB size. You can use the --excludedProducts
parameters to decrease the download size:
ep6
ep7
ep8
ep9
ep10
era6
(covers all PROTECT, ESMC and ERA packages)Example usage of the --excludedProducts
parameter:
MirrorTool.exe --mirrorType regular ^
--intermediateUpdateDirectory mirror-intermediary ^
--offlineLicenseFilename license_file.lf ^
--outputDirectory mirror-final ^
--excludedProducts ep4 ep5 ep6
Product |
---|
ESET Antivirus for Linux - Business Edition |
ESET Endpoint Antivirus |
ESET Endpoint Antivirus for OS X |
ESET Inspect Agent |
ESET Inspect Server |
ESET Endpoint Security for Android |
ESET Endpoint Security for OS X |
ESET Endpoint Security |
ESET Full Disk Encryption |
ESET File Security |
ESET File Security for Microsoft Windows Server |
ESET Mail Security for Microsoft Exchange Server |
ESET Security for Kerio |
ESET Mail Security for IBM Domino |
ESET Rogue Detection Sensor for Linux |
ESET Rogue Detection Sensor for Windows |
ESET Rogue Detection Sensor |
ESET Mail/File/Gateway Security for Linux |
ESET Security for Microsoft SharePoint Server |
ESET Secure Authentication |
ESET NSX Service Manager |
Safetica Agent |
WinPcap |
Microsoft SQL Express 2016 x64 |
Microsoft SQL Server 2014 Express |
Microsoft SQL Express 2014 x64 |
Microsoft SQL Express 2014 x86 |
Microsoft SQL Express 2008R2 x86 |
Microsoft SQL Express 2008R2 x64 |
ApacheTomcat |
ApacheHttp |
ESET Remote Administrator Bootstrapper |
ESET Remote Administrator 6 WebConsole |
ESET Remote Administrator Virtual Agent Host |
ESET Remote Administrator Server |
ESET Remote Administrator Proxy |
ESET Security Management Center Migration Assistant |
ESET Migration Assistant |
ESET Security Management Center Mobile Device Connector |
ESET Remote Administrator Mobile Device Connector |
ESET Remote Administrator Agent |
ESET Security Management Center Bootstrapper |
ESET Management Agent |
ESET Security Management Center Server |
ESET Security Management Center WebConsole |
ESET PROTECT Server |
ESET PROTECT Mobile Device Connector
|
ESET PROTECT Bootstrapper |
ESET PROTECT WebConsole |
After you download the update and/or repository files (Part 1, for example, Apache), choose a local webserver. Set up the webserver to serve the updates and installers to the machines in the offline environment. See the setup instructions for Apache and Microsoft IIS below.
Alternative: I want to distribute updates using the ESET Endpoint as the update mirror.
Copy the whole folder downloaded by the Mirror tool to C:\inetpub\wwwroot.
Enable Directory Browsing in IIS Manager.
Add MIME type with extension *
as text/plain
.
Install Apache HTTP Proxy (ESET PROTECT)
Locate and open the configuration file of your Apache HTTP Proxy. The default location is C:\Program Files\Apache HTTP Proxy\conf\httpd.conf.
Find the following line in the file httpd.conf.
...
Listen 3128
...
Add the following line:
Listen 8080
Save the changes in the file and restart the Apache HTTP Proxy service.
Find the following line in the file /etc/httpd/conf/httpd.conf
:
...
Listen 3128
...
Add the following line:
Listen 8080
Find the following line:
#DocumentRoot /var/www/html
Replace the line with the following block of code:
DocumentRoot "/var/www/html"
<Directory "/var/www/html">
Options Indexes FollowSymlinks
AllowOverride none
Require all granted
</Directory>
Save the file and restart the httpd
service.
sudo systemctl restart httpd.service
SELinux can block the other devices from accessing the repository machine. Add an exception for the repository/updates files location or disable the SELinux.
To turn off this feature, follow the steps below:
Open /etc/selinux/config
in your editor, find and set the following value:
SELINUX=disabled
Restart the system (machine) to apply the changes.
When using the ESET PROTECT Virtual Appliance, use Webmin to add port 8080 to the rule where 3128 is already listed, and save the configuration.
If you prefer the Linux Console, use the following command to do the same:
iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
ip6tables -A INPUT -p tcp --dport 8080 -j ACCEPT
service iptables save
service ip6tables save
Copy the files from the intermediary machine to the offline server where the Apache is running.
Copy the whole structure to /var/www/html
(or the folder you specified in the DocumentRoot
setting).
Set the file permissions so the user running the httpd
service can read them.
In this case, we do not use a repository. You need to have ESET Management Agents installed on client machines.
Download an ESET Endpoint installer (ESET download site).
Save the installer to a location accessible to other computers in your offline network. We recommend creating a logical folder structure based on product names and versions.
Log in to your Web Console (ESET PROTECT).
Create a new Software Install task with the direct link. Deploy or upgrade ESET endpoint products using ESET PROTECT.
See the examples below to set paths of Repository and Update servers with ESET Endpoint version 7.x (and later) products. Do the following in the ESET PROTECT:
Navigate to More → Server Settings → Advanced Settings → Repository.
Type your address in the Server field.
Navigate to the Updates section.
Type your offline server's address in the Update server field. Type the whole address with the folder structure, according to the product you are setting up.
Click Save.
You need to apply the new settings to all machines (their Agents) which are using the offline server for updates and repository. Select a suitable policy or create a new one and assign it to those machines.
Navigate to Policies.
Select the appropriate policy.
In the policy Settings section, navigate to → Advanced Settings → Repository.
Type your address in the Server field.
Navigate to Updates section.
Type your offline server's address in the Update server field. Make sure to enter the whole address with the folder structure, according to the product you are setting up.
Activate ESET Endpoint products in the offline environment.
You need to apply the new settings to all machines (their ESET security products) which are using the offline server for updates. Select a suitable policy or create a new one and assign it to those machines.
Navigate to Policies.
Select the appropriate policy.
In the policy Settings section, navigate to → UPDATE → Profiles → Updates → Modules Updates.
Deselect the Choose automatically option.
Type your offline server's address in the Custom server field. Make sure to enter the whole address with the folder structure, according to the product you are setting up. The example image below shows the ESET Endpoint 8.x folder address.
If necessary, create policies for any ESET product similar to the examples shown above.