|
|
Introduction
This document provides important information on how to upgrade from older versions of BrowserHawk to BrowserHawk
11.02.
It also covers some important considerations to keep in mind while planning for your upgrade.
BrowserHawk 11 offers several major new features and capabilities. In addition it provides dozens of enhancements and important updates. For more details see What's New in BrowserHawk 11.x.
Quick Index:
Backward compatibility
BrowserHawk
11.02
is fully backward compatible with all BrowserHawk code written for BrowserHawk 5.0 and later. This means that you can simply install the BrowserHawk software and should not have any need to update your BrowserHawk code.
Obtaining your license key
Before installing BrowserHawk
11.02
please read the following to make sure you have a valid license key that will work with this version prior to installation.
Obtaining & Installing BrowserHawk
11.02
Use one of the following links to download version 11.02.
Please see the above section to make sure you have a proper license key for this version prior to installation.
Important notes if upgrading from BH 10.x or earlier
This section outlines some important considerations regarding upgrading to BrowserHawk
11.02
and offers some useful tips on areas you may want to focus on.
- All developers: If you have customized your browser defintions using the BrowserHawk Editor, please be sure to backup your maindefs.bdf, maindefs.bdd, and maindefs.mrg files before upgrading, as your customizations may be overwritten during the upgrade process.
- All developers: BrowserHawk 11 provides many new features, enhancements, and important updates. See What's New in BrowserHawk 11 for more information.
- All developers: Be sure to check out the new Rules Enforcement Technology and the video tutorials!
- All developers: Note that the BrowserHawk BDF Service has been removed and replaced by the new "cyScape Update Service". This service is responsible for downloading updates to the browser definition files. Among other important enhancements such as support for Vista and Windows Server 2008, this service now supports SMTP Authenticiation for sending email notifications about downloaded updates. To set these configuration options go to Start->All Programs->cyScape->Download BDF Updates, then choose the Notification tab.
- All developers: There are several new samples included which demonstrate Page Load Time (PLT) and Rules Enforcement Technology (RET). Classic ASP and .NET developers can access these samples from Start->All Programs->cyScape->Samples. JSP and CFMX developers can find these samples in the samples directory within the BH4J zip file.
- All developers: The Enterprise Edition of BrowserHawk now supports the ability to expand BrowserHawk by executing your own custom JavaScript snippets as part of the BrowserHawk testing. See the new SetJSEval method for details.
- Classic ASP and ASP.NET developers: If you are using the BrowserHawk Reports Web Service (BRWS) prior to version 11.0, this version of BH includes an update to the BRWS DLL (ISAPI extension). The first time a request is made to the BRWS in 11.02, it will automatically upgrade your database schema to add new columns to the BHSTATS table, and add a new BrowserErrors table used by BrowserHawk's new JavaScript Error Monitoring function.
- Classic ASP and ASP.NET developers: BrowserHawk is now optimized for use on 64 bit operating systems. If you are running on a 64 bit OS please download and install the x64 bit version of BrowserHawk. [Learn more]
- BrowserHawk4J developers: BH4J now uses Java version 1.4 as a base platform (previously 1.2). Therefore you must run Java 1.4 or higher to use BH4J 11.0 and later.
- BrowserHawk4J developers: If you are using the BRWS4J you will find SQL scripts to adding the new BrowserErrors table and other modifications to the schemas within the BH4J zip distribution.
Performing the upgrade to
11.02
This section outlines the general procedure for upgrading your software.
- BrowserHawk ActiveX/.NET
If you have BrowserHawk 7.x or higher installed, you can simply run the automated BrowserHawk installation program. There is no need to remove your older BrowserHawk software first, as the installation of
11.02
will take care of this for you.
TIP: To minimize the chances of needing to reboot after the installation, stop the IIS Admin Service prior to running the installation program. Be sure to restart these services once the installation is complete.
ASP.NET developers: If you manually copied the BrowserHawk.dll into one of your bin directories, as would be the case if you used simple (manual) deployment, you must replace all those copies with the new DLL found in the BrowserHawk\dotnet folder after installation of 11.02. Otherwise you will continue to use the older version. If you did not manually copy the BrowserHawk.dll and used the automated installation previously, there is no need to manually copy over this file (the reference copy of BrowserHawk.dll and version in the GAC will be automatically updated). In any event, you most likely will need to recompile your web application under BH 11.02 and deploy it; otherwise you may receive a run-time error since the older version of BrowserHawk your site was compiled with is no longer present.
- BrowserHawk4J (Java)
Generally it is recommended that you remove all BH4J files and follow the detailed installation instructions found in the readme.txt file within the BrowserHawk zip file.
If you replace your browserhawk.properties file, first take note of any customizations you made to your old file. In particular, be sure that the new file points to your BH4J license key.
If you are running BrowserHawk 10.01 and want to just replace the main files that have changed, here is a list of the file changes between 10.01 and 11.0 (if you are running BH 10.0 or earlier please do a complete reinstall following the instructions in the README file):
- bhawk4j.jar
- maindefs.bdd
- readme.txt
- optional: copy of the updated Javadocs from the docs folder
- optional: brws4j/brws4j.txt
- optional: brws4j/brws4j.zip
- optional: updated brws4j SQL scripts
- optional: numerous new samples for PLT and RET in samples folder
See the installation instructions in the readme.txt file to determine which directories these files should be placed in.
If you are running BrowserHawk 11.0 you can upgrade to 11.02 simply by replacing all copies of your existing bhawk.jar file with the newer bhawk4j.jar file found in the BH4J 11.02 download.
After replacing the JAR you likely will need to restart your web services and/or JVM before the updated JAR is recognized.
Attention ColdFusion MX developers: You must stop and restart the ColdFusion MX Application Server Service before CFMX will recognize the new files.
Additional reading
See these links for more information about BrowserHawk 11:
|
|
|