KnowNow Event Router Release Notes version 1.7.1 This version of the patch release contains some internal bug fixes. No enhancements or features were added to this release. KNOWN LIMITATIONS: Problem: JavaScript Microserver - The current leader-election algorithm is sensitive to extended delays which are not system-wide. For example, delays caused by multiple browser windows opening simultaneously in recent versions of Windows Internet Explorer (IE5.5 and IE6). Workaround: Initially, load a separate page (sample given below), which will then switch to the application page after a random delay, decreasing the probability of leader re-election during a period of delay in the leader window. The page shown below is very simple and intended only as an example. It waits for a random number of "period of responsiveness," then replaces itself by "index.html," the application page using the Microserver. It is still sensitive to delays but by adjusting the sequence length, the probability of a leader election failure can be decreased. This example has a (nominally) 0.5 second timer with a 2% probability of replacement at each timer tick. The time interval can be tuned, based on the expected number of windows and the acceptable level of leader election failure. Sample Page: _______________________________________________________________________________________ KnowNow Event Router Release Notes version 1.7 REQUIREMENTS: This release is supported on the following platforms: • Sun Solaris 2.8 • Linux (Red Hat 7.2) Beta version • Microsoft Windows 2000 and XP To use this product, you must have the following: • a FlexLM license key (This will be emailed to you when you download the product.) NEW FEATURES: INSTALLATION: - Before you can install the Event Router, Solaris 2.8 users need to apply the following patches in the order listed. First apply the cluster patch and then the /dev/random patch: • apply the recommended cluster patch that can be found at: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access • download the /dev/random patch for Solaris 2.8. Solaris 2.9 already has this patch built-in, so this step is not required. The patch can be found at: http://sunsolve.sun.com/pub-cgi/retrieve.p1?doc=fpatches%2F112438&zone_32=112438 The associated README file for the patch can be found at: http://access1.sun.com/patch.public/patches/all/patch.readme/README.112438.01 NOTE: Make sure you reboot the machine after applying the patch. For more information on installation, refer to the KnowNow Event Router Getting Started Guide. - For version 1.7, you will need to install a NEW license key, even if the old license key is not yet expired. - If you select any other file, other than the knrouter.lic file as your license file, the file is not copied over. You will have to manually copy the knrouter.lic file to the conf directory. - A backup copy is automatically made of your conf directory during upgrade to ensure that you do not lose any of your configuration information. - The installation now checks for a previous install of the KnowNow Router. ROUTER: - Upgraded to SleepyCat 4.0. You must use db_kncopy1.6 to move the existing database to the new location when you install version 1.7 of the KnowNow Router. Once you have run the 1.7 Router for the first time on the new database, you do not need to use db_kncopy1.6 again. - KnowNow Event Explorer Utility is now obsolete. It's been replaced by a new, more functional utility called the KnowNow Topic Modeler. For more information, refer to the KnowNow Topic Modeler guide. ROUTER API: A new argument has been added to the KnRequestAuthorizeFcn function for the Authorization API. The parameter's argument will contain all the user key-value pair data sent in the request (i.e. kn_id, kn_payload, etc.) The new API looks like this: typedef KnError (*KnRequestAuthorizeFcn) (const KnRequest &req, const KnSet &headers, const KnSet ¶meters); MICROSERVERS: JAVASCRIPT MICROSERVER: Simple Event Mapping is added. For more information, refer to the KnowNow Event Router Getting Started Guide. JAVA MICROSERVER: Simple Event Mapping is added. For more information, refer to the KnowNow Event Router Getting Started Guide. INSTALLATION INSTRUCTIONS: Follow the instructions for your platform to install the product. For more information, refer to the KnowNow Event Router Getting Started Guide. WINDOWS: The Router for Windows is distributed as an executable. To install the software, open the knrouter-1.7.x.exe file. The default installation directory is C:\Program Files\KnowNow\Event_Router SOLARIS/LINUX The Router for Solaris is distributed as a package. To install the software, untar the knrouter-1.7.x.tar.z file. The default installation directory is /usr/local/kn. For more information, see the KnowNow Event Router Getting Started Guide at Developer.KnowNow.com. KNOWN LIMITATIONS: When an event is published to a cluster using the forward request feature, the publish fails. Workaround: This feature can be used in a cluster in which all the node names are the same. Do not use this feature in a cluster that has different node names. _____________________________________________________________________________________________________________________ All brand names and product names used in this document are trade names, service marks, trademarks or registered trademarks of their respective owners. Copyright(c) KnowNow, Inc. All rights reserved. Last updated: August 27, 2002