Troubleshooting
•ESET Bridge installation troubleshooting
•Restart the EsetBridge service remotely
•Add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic
ESET Bridge installation troubleshooting
•Windows:
oIf the installation is unsuccessful, review the installation log files in the All-in-one installation package. The logs directory is the same as the directory for the All-in-one installer, for example C:\Users\Administrator\Downloads\x64\logs\
oVerify that ESET Bridge services are running in the services.msc snap-in (look for EsetBridge and EsetBridgeWatchdog).
•Linux:
oVerify that the EsetBridge and EsetBridgeWatchdog services are running by executing the following commands:
sudo service EsetBridge status
sudo service EsetBridgeWatchdog status
|
By default, both services start automatically. The EsetBridgeWatchdog service monitors the EsetBridge service and restarts it when it stops. |
Restart the EsetBridge service remotely
You can restart the EsetBridge service remotely from ESET PROTECT Web Console using the Run Command Client Task:
•Windows: cmd /c "net stop "EsetBridge" & sc start "EsetBridge"
•Linux: sudo service EsetBridge restart
ESET Bridge logs
•Windows:
oC:\ProgramData\ESET\Bridge\CrashDumps
oC:\ProgramData\ESET\Bridge\Logs
oC:\ProgramData\ESET\Bridge\Proxies\Nginx\logs\cache.log
•Linux:
o/var/log/eset/bridge/Bridge.log
o/var/log/eset/bridge/Watchdog.log
o/var/opt/eset/bridge/nginx/logs/cache.log
Use ESET PROTECT On-Prem to collect ESET Bridge logs
1.Open the ESET PROTECT Web Console in your web browser and log in.
2.Click Computers > Click the computer running ESET Bridge and select Details.
3.Click Logs > Log Collector > Run Log Collector to run the Log Collector task.
4.After the task finishes, click the new entry in the log list and click Download Log Collector Log to download the logs, including ESET Bridge logs.
|
If you set a custom proxy logs directory, ESET Log Collector cannot find and collect the proxy logs. |
ESET Bridge log rotation
ESET Bridge has a log rotation feature that rotates logs at a certain time interval so that the log files will not be too large. A log purger functionality also removes the oldest log files to free up space.
1.Open the pkgid file in a text editor:
•Windows: C:\Program Files\ESET\Bridge\pkgid
•Linux: /opt/eset/bridge/etc/pkgid
2.Edit the parameters in the pkgid file:
Parameter |
Description |
Applies to |
|---|---|---|
logger_rotation |
Log file size in MB when the rotation occurs. |
ESET Bridge executable logs |
logger_purgeAge |
Time interval in days when the purge occurs. |
ESET Bridge executable logs |
nginx_logger_rotation_kb |
Log file size in KB when the rotation occurs. |
Nginx executable logs |
nginx_logger_purge_days |
Time interval in days when the purge occurs. |
Nginx executable logs |
|
Ensure to save the configuration file in the UTF-8 encoding. ESET Bridge cannot process files saved in the UTF-8 with BOM encoding. |
3.Restart the ESET Bridge service.
Clear the ESET Bridge cache
Clearing the ESET Bridge cache by running the Clean ESET Bridge Cache Client Task (in ESET PROTECT or in ESET PROTECT On-Prem 11.1 and later) may resolve issues when ESET product upgrades or module updates fail.
Alternatively, you can clear the ESET Bridge cache manually (if you use ESET PROTECT On-Prem 11.0 and earlier):
1.Clear the contents of the ESET Bridge cache directory:
|
The paths below are the default location of the eset_cache directory. If you use a custom cache directory location, navigate to the custom cache directory. |
•Windows: C:\ProgramData\ESET\Bridge\Proxies\Nginx\data\eset_cache
•Linux: /var/opt/eset/bridge/nginx/data/eset_cache
2.Restart the EsetBridge service to recreate the ESET Bridge cache:
•Windows—Click Start > Open the services.msc > Right-click EsetBridge and select Restart.
•Linux—Run the Terminal command: sudo service EsetBridge restart
Add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic
Installing ESET Bridge on Windows 10 or 11 is not supported. If you have installed ESET Bridge on a computer running ESET Endpoint Security, you must add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic:
1.Open the ESET Endpoint Security main program window.
2.Press F5 to access Advanced setup.
3.Click Protections > Network access protection, expand Firewall and click Edit next to Rules.
4.Click Add.
5.Type the rule Name and enable the Enabled toggle.
6.Set the rule parameters:
Action |
Allow |
Application |
%PROGRAMFILES%\\ESET\\Bridge\\Proxies\\Nginx\\nginx.exe |
Direction |
In |
IP protocol |
TCP & UDP |
Local port |
3128 |
7.Click OK > OK.