HP SiteScope 10.00 Readme Software version: 10.00 / January 2009 This file provides information about HP SiteScope 10.00. Documentation What's New in 10.00 Bug Fixes in 10.00 Notes and Limitations in 10.00 System Requirements Support Legal Notices Documentation The first page of this release notes document contains the following identifying information: Version number, which indicates the software version. Publish date, which changes each time the document is updated. To check for recent updates or to verify that you are using the most recent edition, visit the following URL: http://h20230.www2.hp.com/selfsolve/manuals This site requires that you register for an HP Passport and sign-in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html Or click the New users - please register link on the HP Passport login page. You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details. Note: To view files in PDF format (*.pdf), Adobe Acrobat Reader must be installed on your system. To download Adobe Acrobat Reader, go to the following URL: www.adobe.com What's New in 10.00 SiteScope Usability Improvements New simplified user interface with improved look and feel and enhanced performance. The Remote Servers, Preferences, and Templates containers were moved from the monitor tree to separate context menus. Alerts and reports were also moved from the monitor tree and are now located in separate tabs (Alerts in the Monitors and Templates context, and Reports in the Monitors context). The read-only view was removed from the properties panel, and only the objects that a user has permissions to view or edit are displayed in the user interface. The Views tab was removed, and views are now defined and managed by creating and using filters configured from the Dashboard. The Categories tab was removed and was replaced by Search/Filter tags. Remote servers can now be created from the New Monitor page. Template deployment changed from copy/paste to a deploy template mechanism, and can be activated from the template or from the group context menu. Template variables can now be created from the New Template Monitor dialog box, New Template Group dialog box, and New Template Remote Server dialog box. Silent template deployment was added to the template deployment, enabling continued SiteScope use while template deployment is handled in the background. Adding a description can be made mandatory when enabling or disabling an alert or monitor. This feature is enabled by selecting Enable/Disable description mandatory in Infrastructure Settings > Monitor Settings. HP Business Availability Center Integration SiteScope can send all the counters for browsable monitors (the ones in error, and the ones with good status) and their values to Business Availability Center, even during error. Previously, SiteScope sent only the list of counters in error and their current values to Business Availability Center. This feature is enabled by selecting Browsable monitors - In error, send status of all counters to BAC in Infrastructure Settings > Monitor Settings. New Integrations SiteScope now integrates directly with HP Diagnostics. SiteScope forwards group, monitor, and measurement data to HP Diagnostics, enabling you to see a more complete view of the application servers that are monitored by Diagnostics. SiteScope enables creating generic data integrations with applications that can receive SiteScope data. SiteScope forwards group, monitor, and measurement data to a receiving application via an http request in the form of an XML file. Classic User Interface The classic user interface that was available in earlier versions of SiteScope is no longer available or supported. Bug Fixes in 10.00 Alert Fixes Scripts are now listed in alphabetical order in the Script dropdown list when defining script alert properties. The contents of the Monitor type match field in the Filter Settings are no longer removed when deploying an alert for a monitor in a template. HP Business Availability Center Integration The SiteScope-BAC integration configuration sanity tool now works when SiteScope is password protected. The _enableAddUpdateConfigurationOnRestart property was added to the master.config file to control whether SiteScope sends HP Business Availability Center configuration and topology updates on every SiteScope restart. This is the default behavior (property's value is set to true). To disable this, set the property's value to false. This may be necessary when a high number of changes is detected, causing a delay in configuration and topology changes to appear in Business Availability Center. When the property is set to false, SiteScope sends topology and configuration changes to Business Availability Center with the anti-ageing mechanism (approximately weekly). You can edit this property in Preferences > Infrastructure Settings > Custom Settings. I18N The response time in the Dashboard Summary column is now displayed correctly in non-English locales (previously, it was missing the decimal point). Monitor Fixes Web Service monitor supports sending security headers as a Simple Object Access Protocol (SOAP) token. Web Service monitor now has a timeout that can be defined in the monitor settings panel. The timeout value is in seconds, and the default value is 5. Microsoft SQL monitor and Microsoft SQL Server 2005 solution template now have an SQL Instance Name field that enables you to select the SQL server instance you want to monitor from the list of SQL instances running on the selected server. This avoids having to manually add counter variables where SiteScope could not get the counters from the SQL server. Remote Server Fixes You can change the host name property of a remote server without causing monitors using that server to lose connection to it. Symbolic links are now supported when executing scripts on remote UNIX servers. This support is enabled by setting the property _scriptMonitorAllowSymbolicLink to true (false by default) in the master.config file. When enabled, the symbolic link appears in the dropdown list of available scripts when configuring a Script monitor to monitor a UNIX remote server. Report Fixes Fixed the issue that after creating a Management report and then changing the value in the Graph of Measurements setting (now named Measurements graph) to None - No Graph, the new value was not saved. Template Fixes Threshold settings can now be deleted from the custom templates when deploying a template. User Permissions You can view and edit objects (monitors, alerts, reports) for groups that are in your allowed groups list only. Objects in groups for which you do not have permissions are no longer displayed. Notes and Limitations in 10.00 Installation and Upgrade For SiteScope to start, Java Runtime Environment (JRE) must be installed on the SiteScope client machine. If you are using JRE 5, you might get Java script validation errors when opening dialog boxes in SiteScope. Using Firefox 3.0 with JRE 5u14, 5u15, or 5u16 causes the applet to freeze any operation until the browser is closed. Workaround: Configure you browser to use JRE 6u10 or later. SiteScope does not start and the following error message is displayed: "Several Java Virtual machines running in the same process caused an error". This is a known Java defect (http://bugs.sun.com/view_bug.do?bug_id=6516270) that might occur when using Internet Explorer 7. Workaround: Either: (1). Use a browser other than Internet Explorer 7. (2). Upgrade to Java 6 update 10 or later. (3). In the Add or Remove Programs dialog box (Start > Control Panel > Add or Remove Programs), remove all Java/Java Runtime Environment installations except for the latest version. SiteScope does not start and an error message is displayed while starting the SiteScope applet (for example: "The Java Runtime Environment cannot be loaded"). Workaround: Perform the steps below. After each step, try to reopen SiteScope. If SiteScope fails again, proceed to the next step. (1). Close all the browser's windows. (2). End all remaining browser processes (if any remained) using Windows Task Manager. (3). Clean the local Java applet cache. Select Start > Control Panel > Java, and in the General tab, click Delete Files and then click OK. (4). Clean the local Java applet cache by deleting the content of the following folder: C:\Documents and Settings\<user_name>\Application Data\Sun\Java\Deployment\cache. The SiteScope menu bar opens but the applet fails to start, and you see a blank screen or an "x" image. Click Start > Control Panel > Java, and in the Java Control Panel, click the Advanced tab. Expand the Default Java for browsers folder (or <APPLET> tag support if you are using Java 5), and make sure that Microsoft Internet Explorer and Mozilla family are selected. Click Apply and then click OK. If in versions of SiteScope earlier than 8.0, a monitor or group name included the ' ; & | < > \ / + = characters, after upgrading to SiteScope 10.00, you must rename the group or monitor with a valid name (without these characters), before you save changes to the object's properties. An Internet Explorer exception error message is thrown inside SiteScope pages, indicating Operation aborted. To resolve this issue, remove or disable the Skype add-ons on your system. For further details, see http://support.microsoft.com/default.aspx/kb/927917. If you type the incorrect license number when installing SiteScope, you must uninstall SiteScope and then reinstall it with the correct license number. The ability to report topology data to HP Business Availability Center was enhanced with several complex topologies (such as WebSphere, WebLogic, and so forth). SiteScope must collect the properties for these topologies on the first start after an upgrade. This may take some time because it means connecting to the monitored servers and getting the additional data. A problem may arise during this first restart if this takes longer than 15 minutes because SiteScope automatically restarts if there are no monitors running within 15 minutes. Workaround: After an upgrade, use the following batch file to start SiteScope for the first time: <SiteScope root directory>/bin/go.bat. Once SiteScope is started, for any monitors that are monitoring environments that are not running, select Disable reporting to BAC under the BAC Logging Options. This saves wasted time waiting for the monitored servers to reply. If you have Oracle database monitors and SiteScope is integrated with HP Business Availability Center, when you first connect to Business Availability Center after upgrading to version 10.00, you must enter values for the Database machine name and SID fields in the HP BAC Integration Settings > Topology Settings area. These are new fields that enable SiteScope to report topology data to Business Availability Center for Oracle databases. If templates and solution templates are missing from the Templates context after installing SiteScope, copy all the templates from the <SiteScope root>\export directory to the <SiteScope root directory>\persistency\import directory. Dashboard The Dashboard column layout cannot be saved during user sessions. The Views tab was removed, and views are now defined and managed by creating and using filters configured from the Dashboard. When upgrading to SiteScope 10.00, views configured in earlier versions of SiteScope are not upgraded to filters. The custom properties mechanism was removed. For filtering functionality, use the tags mechanism. If you used custom properties for text filling, use the Monitor description field instead. Templates To avoid name and ID inconsistencies when copying server monitors to a template, SiteScope now replaces the server name with the $$SERVER_LIST$$ variable. When copying server monitors to a template, it is recommended that you create a remote server in the template after copying the monitor to the template, and replace the $$SERVER_LIST$$ variable with this remote server by selecting the Use already configured template remote under current template check box. You cannot deploy a template if it contains more than one group or subgroup that have the same name. Workaround: Make sure that all group and subgroup names within the template are unique. Threshold Settings If you clear or add a counter (in the counters tree in the Monitor Settings panel) that has a threshold defined in the Threshold Settings panel, the counter might either be replaced in the Threshold Settings with the next selected counter in the counter tree, be replaced by a default counter, or be removed from the Threshold Setting panel. This applies to all browsable monitor counter types in template mode only and to the Windows Resources, Apache, and Health monitors in normal and template mode. Reports If a Monitor Summary report is created using an Internet Explorer browser, and Export to file and Comma-delimited (csv) are selected in the Export Settings, an authentication popup window is displayed after clicking Generate Report. Workaround: In the authentication window, click Cancel and the file opens in Microsoft Excel. Integrations When creating a Diagnostics Integration in Integration Preferences, if you select the option Include additional data, all other Diagnostics and Generic Data integrations are affected and will report additional data in the data SiteScope forwards to these applications.  It is recommended to select this option only if you require this additional data for all your Diagnostics and Generic Data integrations.  For details on the option, refer to the "New/Edit Diagnostics Integration Dialog Box" in the "Integration Preferences User Interface" section in Using SiteScope help. When enabling the integration between SiteScope and HP Business Availability Center, if you enter an incorrect value in the New/Edit Integration Preferences dialog box (Preferences > Integration Preferences > Create new integration > BAC Integration), this results in a "Registration in Process" entry that cannot be deleted. Workaround: Reopen the New/Edit Integration Preferences dialog box and enter the correct integration details, or restart SiteScope. Monitor Tree If there is a large space between group containers in the SiteScope monitor tree, refresh your browser. File Monitor If Telnet is used as the connection method for UNIX remote servers running on an HP-UX or Linux operating system, and either (1) the LANG environment variable is unset, or (2) "set -u" is in effect and the LANG or LC_ALL environment variables are unset, the File monitor will not work regardless of the file it is monitoring. Workaround: Permanently set the LANG and LC_ALL environment variables to the default shell for the SiteScope user. Ping Monitor When SiteScope is installed on Solaris, the Ping monitor might take longer than expected to run, and exceed the timeout for displaying the monitor status in the popup window (the default timeout is 5 seconds). Workaround: In the Ping Monitor Settings panel, increase the value in the Timeout (milliseconds) field. UNIX Remote Servers Due to a bug in Sun Java, SiteScope installed on Solaris 10 is unable to connect to a remote UNIX server via SSH using Internal Java Libraries. Workaround: In the file <SiteScope root directory>\bin\start-monitor, add the following to the argument list of the JRE (just before the -Dflipper.param.file argument): -Djava.nio.channels.spi.SelectorProvider=sun.nio.ch.PollSelectorProvider Technology Integration Monitors When creating a Technology Integration monitor for integrating measurements into HP Business Availability Center (by selecting Measurements as the Sample type in the Field Mapping area of the monitor properties), SiteScope reports only system topology data for the monitor to HP Business Availability Center. This is the standard host topology SiteScope reports to HP Business Availability Center. This cannot be changed by adding a script in the Topology Settings area. If you add a topology script, the script will fail. Global Search and Replace When performing a global search and replace operation in a high load environment on over 1,000 monitors, you may encounter an out of memory error in the Java applet on the client machine performing the global search and replace. Workaround: Increase the heap size of the Java applet on the client machine. Click Start > Control Panel > Java > Java tab. View the Java Applet Runtime Settings and enter the following in the Java Runtime Parameters field: -Xmx128m (default is 64m). Notes The following monitors are end of life and will not work even if configured in previous versions: Monitor Recommended Alternative Monitor Asset monitor N/A Astra Load Test Web Script Active Directory Performance N/A Avalon Event Technology Integration monitors BMC Patrol Event Technology Integration monitors BMC Patrol Metrics Technology Integration monitors CA Unicenter Event Technology Integration monitors Compaq Insight Manager Event Technology Integration monitors Concord Metrics Technology Integration monitors DB2 DB2 8.x Dynamo N/A HP Systems Insight Manager Event Technology Integration monitors IPlanet Application Server SunONE IPlanet Server SunONE IPlanet Web Server SunONE Mercury Application Mapping HP Discovery and Dependency Mapping application NetCool Event Technology Integration monitors NetIQ Metrics Technology Integration monitors Network Network Bandwidth Quick Test Pro Web Script Remedy Ticketing Technology Integration monitors RTSP Real Media Player SAP SAP Performance SAP Portal SAP CCMS (new) SilverStream Server N/A Tivoli DM Metrics Technology Integration monitors Tivoli TEC Event Technology Integration monitors WebLogic 5.x Application Server N/A WhatsUp Event Technology Integration monitors The Oracle 8i solution template has also been deprecated in SiteScope 10.00. System Requirements Below are the minimum system requirements and recommendations for running SiteScope, based on the various supported operating systems. System Requirements for Windows Computer/Processor Pentium III, 800 MHZ or higher Operating System Microsoft Windows 2000 Server/Advanced Server SP4, Microsoft Windows 2003 Standard/Enterprise SP1, SP2, or Microsoft Windows 2003 Server R2 SP1 Memory 1 GB minimum (2 GB+ recommended) Free Hard Disk Space 2 GB or more (10 GB+ recommended) Web Browser Microsoft Internet Explorer 6.0 SP1 or later (including IE 7.0); All versions of Firefox starting with 1.0 and including 3.0 System Requirements for Solaris Computer/Processor Sun 400 MHz UltraSparc II Processor or higher Operating System Sun Solaris 9 or 10 (with latest recommended patch cluster) Memory 1 GB minimum (2 GB+ recommended) Free Hard Disk Space 2 GB or more (10 GB+ recommended) Web Browser All versions of Firefox starting with 1.0 and including 3.0 System Requirements for Red Hat Linux Computer/Processor Pentium III, 800 MHZ or higher Operating System RedHat ES/AS Linux 3 or 4 Memory 1 GB minimum (2 GB+ recommended) Free Hard Disk Space 2 GB or more (10 GB+ recommended) Web Browser All versions of Firefox starting with 1.0 and including 3.0 Note: SiteScope can be installed as a 32-Bit application over 64-Bit environments for the supported operating systems listed above. Certified Configuration The following configuration has been certified in a high load environment for an installation of SiteScope that was integrated with HP Business Availability Center. This configuration replaces the recommended configuration that appears in the SiteScope Deployment Guide. Operating System Microsoft Windows Server 2003, Enterprise Edition Version: 5.2.3790 Service Pack 2 Build 3790 System Model ProLiant BL460c G1 System Type x86-based PC CPU x86 Family 6 Model 15 Stepping 6 GenuineIntel (Intel Xeon 5150) @ 2666 MHz x 4 Total Physical Memory 8,189.68 MB Java Heap Memory 1,300 MB Total Number of Monitors 8,000 Total Number of Remote Servers 750 Monitor Runs per Minute 750 Support You can visit the HP Software Support Web site at: http://www.hp.com/go/hpsoftwaresupport This web site provides contact information and details about the products, services, and support that HP Software offers. HP Software online software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support site to: Search for knowledge documents of interest Submit and track support cases and enhancement requests Download software patches Manage support contracts Look up HP support contacts Review information about available services Enter into discussions with other software customers Research and register for software training Most of the support areas require that you register as an HP Passport user and sign in. Many also require an active support contract. To find more information about support access levels, go to the following URL: http://h20230.www2.hp.com/new_access_levels.jsp To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html Legal Notices © Copyright 2007 - 2009 Mercury Interactive (Israel) Ltd. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. For information about third-party license agreements, see the Third_Party_Agreements directory on the product installation media. Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated. Intel®, Pentium®, and Intel® Xeon™ are trademarks of Intel Corporation in the U.S. and other countries. Java™ is a US trademark of Sun Microsystems, Inc. Microsoft®, Windows®, Windows NT®, and Windows® XP are U.S registered trademarks of Microsoft Corporation. Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California. Unix® is a registered trademark of The Open Group. © Copyright 2009 Mercury Interactive (Israel) Ltd.