Running the Setup Wizard


The Setup Wizard is a special wizard that asks you a series of questions regarding your preferences for using BrowserHawk. Based on your answers it walks you through the configuration of BrowserHawk’s various preferences and options. The Setup Wizard makes getting up and running with the options best suited for you a breeze!


Note: The Setup Wizard is part of the BrowserHawk Editor. Therefore if you did not choose to install the BrowserHawk Editor as an installation option, you will not be able to run the Setup Wizard.


The Setup Wizard automatically runs the first time you launch the BrowserHawk Editor and import your license key. Likewise you can run it again at any time by choosing Run Setup Wizard from the Special menu.

Questions asked by the Setup Wizard


Check for browser definition updates?

In order to make sure you have the latest browser definitions for use by the BrowserHawk component, the Setup Wizard will connect to the cyScape browser definition server and download the latest definitions and install them for you. If you do not wish to download the latest definitions or you do not currently have access to the Internet from that computer you can cancel the operation and BrowserHawk will use the definitions which shipped with the software.


Tip: With the Professional and Enterprise Editions of BrowserHawk, BrowserHawk by default will be configured to automatically monitor cyScape for updates and download them when available. However we still recommend manually checking for updates when prompted during this initial setup..


Note: In order to download the latest definitions you must have an active Support and Maintenance plan (renewable yearly) for each server that will use the definitions.


Enable performance caching (DashCache)?

The Professional and Enterprise Editions of BrowserHawk feature cyScape’s proprietary DashCache technology. DashCache enables the component to perform faster and require even less CPU usage as a result of caching the results of frequently visiting browser browsers. If you choose Yes to this option, the Setup Wizard will enable this feature for you and load another dialog that you can use to set your caching preferences. To change your DashCache settings in the future choose the Cache tab from the Preferences and Options item under the Special menu.


Note: If you are running the Standard Edition of BrowserHawk the Setup Wizard skips this question since DashCache is not available in that version.


Tip: Users of the native .NET version of BrowserHawk can use the DashCacheStats class to monitor and tune your DashCache settings. Likewise uses of the ActiveX version can use the DashCache properties to do the same.


Configure BrowserHawk Reports for automatic database logging?

BrowserHawk Reports provides an easy and efficient method for logging statistics about your visitor's browser capabilities and settings, their page load times on your site, and JavaScript errors they encounter on your site.  This data can be logged  to a Microsoft Access of SQL Server database (other databases are also supported using BrowserHawk4J).  If you answer Yes to this question, BrowserHawk will and prompt you to configure the Reporting Options and Reports Database settings..


Review browser definitions file?

As the last step the Setup Wizard will ask if you would like it to load the browser definition data file into the BrowserHawk Editor.  This is helpful if you wish to glance over the data to get a sense for what type of information it contains.


Run the Samples

If you kept the default installation option to have the samples installed, the Setup Wizard will suggest that you take a moment to run the samples.  This is helpful for verifying that the BrowserHawk .NET and ActiveX components are working as expected.  The samples are also well documented and serve as an excellent learning aid.