How to download and add Firefox, Chrome or Edge browsers for Synthetic Browser Modules in Windows On-Premise Poller manually

Overview

This guide explains how to manually add and configure browser dependencies (Chrome, Firefox, and Edge) required for synthetic browser modules.

Prerequisites

Ensure the following:

1. The On-Premise Poller is installed and running.
2. You must have administrator privileges on your system.
3. The On-Premise Poller service is stopped before starting the setup.
   

Steps to download and install the On-Premise Pollers

Please follow the steps given below to download and add the downloaded files in the Windows On-Premise Poller manually:

1. Stop the On-Premise Poller service and ensure there are no existing processes running in it. 

2. Check whether you have upgraded or installed the latest version of On-Premise Poller.

3. Download the following seven files.

   firefox_win125.zip, geckodriver.exe, Chrome_win125.zip, chromedriver.exe, microsoftedgeenterprisex64_a897243b6eaf0ccf1093babeb76afc2be1d56058.cab, msedgedriver.exe, winjars_125.zip. 

   
   Use the below URLs in the table based on your data center (e.g., www.site24x7.in > India datacenter).

   
   

   Please refer to the table below for more details:  

   
   

   S.No	File name	Data centers (Download the respective file for your respective DC)
   1	winjars_125.zip	COM	EU	IN	CN	JP	AU	CA
   2	firefox_win125.zip (264MB)	COM	EU	IN	CN	JP	AU	CA
   3	geckodriver.exe (1MB)	COM	EU	IN	CN	JP	AU	CA
   4	Chrome_win125.zip (247MB)	COM	EU	IN	CN	JP	AU	CA
   5	chromedriver.exe (1MB)	COM	EU	IN	CN	JP	AU	CA
   6	microsoftedgeenterprisex64_a897243b6eaf0ccf1093babeb76afc2be1d56058.cab	COM	EU	IN	CN	JP	AU	CA
   7	msedgedriver.exe	COM	EU	IN	CN	JP	AU	CA

4. Validate the authenticity of the file by downloading the checksum file provided for each file.
   
   

   S.No	File name	Data centers (Download the respective file for your respective DC)
   1	firefox_win125.zip.sha256	COM	EU	IN	CN	JP	AU	CA
   2	geckodriver.exe.sha256	COM	EU	IN	CN	JP	AU	CA
   3	chrome_win125.zip.sha256	COM	EU	IN	CN	JP	AU	CA
   4	chromedriver.exe.sha256	COM	EU	IN	CN	JP	AU	CA
   5	winjars_125.zip.sha256	COM	EU	IN	CN	JP	AU	CA
   6	msedgedriver.exe.sha256	COM	EU	IN	CN	JP	AU	CA

After downloading the files and validating them with the respective checksum files, unzip and place the validated files in the correct folders.
 
Learn how to validate the checksum.

Instructions to add browser dependency

1. Unzip the downloaded winjars_125.zip file and copy the extracted win folder.

2. Navigate to [<Site24x7OnPremisePoller>/RealBrowser/125/] and paste the win folder into [<Site24x7OnPremisePoller>/RealBrowser/125/win/] 

Instructions to set up Firefox dependency

1. Unzip the downloaded firefox_win125.zip file and copy the extracted firefox folder.

2. Navigate to the [<Site24x7OnPremisePoller>/RealBrowser/125/]  folder and paste the firefox folder into newly created firefoxv125 folder: [<Site24x7OnPremisePoller>/RealBrowser/125/firefoxv125/] 

Now, the file structure format will be like: 

      [<Site24x7OnPremisePoller>/RealBrowser/125/firefoxv125/firefox/]

3. Copy the downloaded geckodriver.exe file.
4. Navigate to the [<Site24x7OnPremisePoller>/RealBrowser/125/firefoxv125/firefox/] folder and paste the geckodriver.exe into this folder.

The file will be available at:         

  [<Site24x7OnPremisePoller>/RealBrowser/125/firefoxv125/firefox/geckodriver.exe]  

Now, you have successfully completed the setup for Firefox.

Instructions to set up Chrome dependency

1. Unzip the downloaded Chrome_win125.zip file and copy the extracted Chrome folder.

2. Navigate to the [<Site24x7OnPremisePoller>/RealBrowser/125/] folder and paste the copied Chrome folder into newly created chromev125: [<Site24x7OnPremisePoller>/RealBrowser/125/chromev125/]

Now, the file structure format will be like: 

[<Site24x7OnPremisePoller>/RealBrowser/125/chromev125/Chrome/] 

3. Copy the downloaded chromedriver.exe file.

4. Navigate to the [<Site24x7OnPremisePoller>/RealBrowser/chromev125/] folder and paste the chromedriver.exe file into this folder.

The file will be available at:

[<Site24x7OnPremisePoller>/RealBrowser/125/chromev125/chromedriver.exe] 

Now, you have successfully completed the setup for the Chrome browser.

Instructions to set up Edge dependency

Follow the steps below to configure the Edge browser dependencies.

1. Download Microsoft Edge WebDriver

Move the downloaded msedgedriver.exe. file to the following directory:

<Site24x7OnPremisePoller>/RealBrowser/125/edgev125/

2. Extract the CAB File

1. Locate the downloaded microsoftedgeenterprisex64_a897243b6eaf0ccf1093babeb76afc2be1d56058.cab file for Edge browser.
   
2. Double-click the .cab file to open it and search for:
   MicrosoftEdgeEnterpriseX64.msi
3. Extract the .msi file to a folder of your choice.
   

3. Install Microsoft Edge

1. Navigate to the extracted .msi file and double-click on it to start the installation.
   
2. Follow the on-screen instructions to complete the setup.
   

4. Copy Edge Application Files

1. Once the installation is done, navigate to the following path:
   
   

   C:\Program Files (x86)\Microsoft\Edge\Application\125.x.xxxx.x
   
   
   Note: The version number specified in the above path may vary.
2. Copy all files from the above mentioned path and paste them into the following directory:
   
   
   
   <Site24x7OnPremisePoller>\RealBrowser\125\edgev125\Edge\Application
   
   

Now, you have successfully completed the setup for the Edge browser.

Steps to validate the checksum

If you're using Windows 7 or above, use the Certutil or the Get- FileHash utilities to verify the authenticity of the downloaded file by executing the following commands. 

Here we have taken Firefox as an example. Please replace with the appropriate file name for other browsers.

CertUtil -hashfile firefox_win125.zip SHA256

Get-FileHash firefox_win125.zip -Algorithm SHA256 | Format-List

Once the SHA256 value is generated for the file firefox_win125.zip using the above command,  verify to confirm that the value obtained from the respective downloaded sha file say, firefox_win125.zip.sha is the same.

1. On successful execution, you will see that the displayed checksum value will exactly match the checksum file downloaded in step 4.
2. The same validation will be followed for all the browsers and dependencies
   

• Related Articles

• Configure the On-Premise Poller as a monitoring location for synthetic (browser) monitors

  If you need to monitor from an internal network, install an On-Premise Poller and use it as a monitoring location for your synthetic (browser) monitors. Synthetic (browser) monitors include Web Transaction (Browser), Web Transaction (Browser) - ...

• How do I manually check whether the browsers have been downloaded correctly for the Web Transaction (Browser) monitor?

  After you download and add Firefox or Chrome browsers manually for the Web Transaction (Browser) monitor in Windows On-Premise Poller, you can check whether the process has happened correctly by using the following steps. For Windows On-Premise ...

• How to install packages to support Web Transaction (Browser) monitor in Linux On-Premise Poller

  To support Web Transaction (Browser) monitor on an On-Premise Poller, you can execute the following command in the terminal to install packages in CentOS 7.0 to 7.8 or in RHEL 7.x. Note: The Installation is supported only on 64-bit OS. Execute the ...

• How to manually download and enable the Network Module in an On-Premise Poller

  Please follow the steps given below to manually download and enable the Network Module for the On-Premise Poller: Stop the On-Premise Poller service. Ensure that there are no existing processes in the On-Premise Poller . Check if there is a folder ...

• How to manually upgrade an On-Premise Poller

  You can upgrade an On-Premise Poller directly from the Site24x7 web console by navigating to Admin > On-Premise Poller, clicking the hamburger icon beside an On-Premise Poller, and clicking Upgrade. Learn more. The 32-bit On-Premise Poller is no ...