Skip to content
docs.browsium

Troubleshooting

Catalyst rule fails to engage

Section titled “Catalyst rule fails to engage”

You may encounter a scenario in which Catalyst fails to engage on one or more websites based on rules you’ve created.

The following points may guide you to a resolution:

  • Review System Prerequisites

    • Check to see that the target computer meets the performance and storage requirements to run Catalyst.

  • Confirm the Browsium Client Executable Files are Running

    • Check to see that the Browsium Controller (BrowsiumController.exe) is running on the target machine.

  • Ensure the Browsium Client Extensions are Enabled and Running

    • Confirm the Browsium Catalyst Client extensions are seen and loaded by Internet Explorer, Edge (Legacy and/or Chromium), Chrome and Firefox

      • Open each browser and open the Manage Add-Ons/Extensions dialog. Do you see the Browsium Internet Explorer Extension installed? Is it enabled?

      • For example, An Internet Explorer instance that correctly loads the Browsium Client extension will display the following information in the Manage Add-Ons dialog:

{width=“5.130218722659667in” height=“1.0814020122484689in”}

  • Visit the Knowledge Base or Contact Support

Browser window doesn’t get focus automatically

Section titled “Browser window doesn’t get focus automatically”

Some users may experience ‘focus’ issues where a web page or web application loads and the user is unable to interact with the browser window automatically. This issue is related to how Windows provides focus control (the ability to receive input). Users will need to click inside the browser tab window to ensure proper focus.

Catalyst did not automatically become the default browser

Section titled “Catalyst did not automatically become the default browser”

Microsoft made a change in Windows 8 and later, and no longer allows 3^rd^ party software to programmatically take over as the default browser. As Catalyst must be the default browser to manage navigation through all entry points for HTTP and HTTPS, it must be set as the default by end users or via Group Policy. See section 5.5 of this guide for details on how to control browser defaults on Windows 8 and later.

Browsium Controller becomes unresponsive

Section titled “Browsium Controller becomes unresponsive”

Find the Controller process (BrowsiumController.exe) using Task Manager and kill the process. It will automatically restart. If running the Catalyst Configuration Manager, the Controller can be restarted using the Utilities menu.

Error — ‘Reinstall Microsoft Edge’

Section titled “Error — ‘Reinstall Microsoft Edge’”

Edge IE Mode does not work properly with Catalyst (or you experience inconsistent behavior) and receive a message saying to reinstall Edge in administrator mode:

Edge must be installed into Program Files (and not into a user profile) for Edge IE Mode to work properly. In addition, ensure the machine you are using has all needed updates to run Edge IE Mode. Please see this page for more information: https://docs.microsoft.com/en-us/deployedge/edge-ie-mode