Foglight Foglight Experience Viewer (FxV) Upgrade Field Guide

Transcription

1 Foglight Foglight Experience Viewer (FxV)

2 2009 Quest Software, Inc. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc. If you have any questions regarding your potential use of this material, contact: Quest Software World Headquarters LEGAL Dept 5 Polaris Way Aliso Viejo, CA legal@quest.com Refer to our Web site for regional and international office information. Trademarks Quest, Quest Software, the Quest Software logo, Aelita, Akonix, AppAssure, Benchmark Factory, Big Brother, ChangeAuditor, DataFactory, DeployDirector, ERDisk, Foglight, Funnel Web, GPOAdmin, itoken, I/Watch, Imceda, InLook, IntelliProfile, InTrust, Invirtus, IT Dad, I/Watch, JClass, Jint, JProbe, LeccoTech, LiteSpeed, LiveReorg, MessageStats, NBSpool, NetBase, Npulse, NetPro, PassGo, PerformaSure, Quest Central, SharePlex, Sitraka, SmartAlarm, Spotlight, SQL LiteSpeed, SQL Navigator, SQL Watch, SQLab, Stat, StealthCollect, Tag and Follow, Toad, T.O.A.D., Toad World, vamp, vanalyzer, vautomator, vcontrol, vconverter, vdupe, vessentials, vfoglight, vmigrator, voptimizer Pro, vpackager, vranger, vranger Pro, vreplicator, vspotlight, vtoad, Vintela, Virtual DBA, VizionCore, Vizioncore vautomation Suite, Vizioncore vessentials, Xaffire, and XRT are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries. Other trademarks and registered trademarks used in this guide are property of their respective owners. Disclaimer The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document. License Credits and Third Party Information To view license credit information, click the License Credits link on the Welcome to Foglight online help page. March 2009 Version 5.2.0e

3 Table of Contents Introduction to This Guide...5 About Foglight... 6 About This Guide... 6 Foglight Documentation Suite... 7 Core Documentation Set... 7 Cartridge Documentation Sets... 8 Feedback on the Documentation... 9 Text Conventions... 9 About Quest Software, Inc Contacting Quest Software Contacting Quest Support Upgrading the Foglight Experience Viewer to the Latest Version...11 General Instructions Upgrading from Versions 4.4.x Upgrading from Versions 5.0.0x to Version 5.0.1b Upgrading from Versions 5.0.1x to Version 5.0.2a Upgrading from Version 5.0.2a to Version 5.0.2c Single-Appliance Installations Multiple-Appliance Installations Upgrading from Version 5.0.2b to Version 5.0.2c Upgrading from Version 5.0.2c to Version 5.1.0a Upgrading from Versions 5.1.0x to Version 5.2.0e Upgrading from Version 5.2.0a or 5.2.0b to Version 5.2.0e Upgrading from Version 5.2.0c or 5.2.0d to Version 5.2.0e Index...27

4 4 Foglight Experience Viewer

5 Introduction to This Guide This chapter provides information about what is contained in the FxV Upgrade Field Guide. It also provides information about the Foglight documentation suite and Quest Software. This chapter contains the following sections: About Foglight...6 About This Guide...6 Foglight Documentation Suite...7 Text Conventions...9 About Quest Software, Inc...9

6 6 Foglight Experience Viewer About Foglight Foglight is an application management solution that reduces or eliminates service disruptions to unify IT and the business. Unlike other solutions, it provides a correlated, 360 degree view of your applications from end user to database and from service levels to infrastructure to source the root cause of every incident impacting your business and fix them quickly. Foglight correlates data from multiple perspectives into a single version of the truth to provide deep insight into the service relationships that exist between end users, the business and infrastructure components. Its unique adaptive technology rapidly adjusts to change for improved application performance and service levels, reduced operational cost and risk, and enhanced visibility for all stakeholders. About This Guide This guide is part of the Foglight Experience Viewer documentation set, which includes the following files: Foglight Experience Viewer Quick Installation Guide, for Dell PowerEdge Systems (PDF) Foglight Experience Viewer Installation and Administration Guide (PDF) Foglight Experience Viewer User Guide (PDF) Foglight Experience Viewer (PDF) Foglight Experience Viewer Security and Compliance Field Guide (PDF) Foglight Experience Viewer Release Notes (HTML) Foglight Experience Viewer, Using the Dell Remote Access Controller (PDF) The FxV provides detailed instructions for upgrading the FxV appliance from an older version to the latest version, via the FxV setup menu or via the FxV browser interface. The intended audience for this document are FxV system administrators and all users who need a deeper understanding of the Foglight Experience Viewer appliance. The FxV is organized as follows: Chapter 1, Upgrading the Foglight Experience Viewer to the Latest Version describes how to upgrade an older FxV installation to the latest FxV version.

7 Introduction to This Guide 7 Foglight Documentation Suite Foglight Documentation Suite The Foglight documentation suite is made up of the core documentation set, plus the documentation set for each Foglight cartridge that you deploy. Documentation is provided in a combination of online help, PDF and HTML. Online Help: You can open the online help by selecting the Help tab from Foglight s action panel. PDF: The complete Foglight documentation set is available in PDF from SupportLink. The PDF documentation can also be found in the Documentation folder on the Foglight DVD. The following subset is available from the computer Foglight is installed on: Administration and Configuration Guide, User Guide, Command-Line Reference Guide, Web Component Guide and the Web Component Tutorial. In addition, the cartridges ship with PDF guides. To view the installed PDF guides, in Windows go to Start > Programs > Quest Software > Foglight > Documentation. The default location of the documentation after an installation is <foglight_home>/docs. Adobe Reader is required. HTML: Release Notes are provided in HTML. Core Documentation Set The core documentation set consists of the following files: Release Notes (HTML) Getting Started Guide (PDF)

8 8 Foglight Experience Viewer What s New Guide (PDF) System Requirements and Platform Support Guide (PDF) Installation and Setup Guide set (all in PDF format): Installation and Setup Guide Installing on Windows with an Embedded MySQL Database Installation and Setup Guide Installing on Windows with an External MySQL Database Installation and Setup Guide Installing on Windows with an External Oracle Database Installation and Setup Guide Installing on a UNIX System with an Embedded MySQL Database Installation and Setup Guide Installing on a UNIX System with an External MySQL Database Installation and Setup Guide Installing on a UNIX System with an External Oracle Database Administration and Configuration Guide (PDF and online help) Foglight User Guide (PDF and online help) Command-Line Reference Guide (PDF and online help) Transition Guide (PDF) Web Component Guide (PDF and online help) Web Component Tutorial (PDF and online help) Web Component Reference (online help) Cartridge Documentation Sets When you deploy a cartridge, the documentation set for the cartridge is installed. The online help for the cartridge is integrated automatically with the core Foglight help. When you open the help, the name of the cartridge is displayed in a top level entry within the table of contents. Some cartridges include additional PDF guides, which may be one or more of the following: a Getting Started Guide, an Installation Guide, a User Guide, and a Reference Guide.

9 Introduction to This Guide 9 Text Conventions Feedback on the Documentation We are interested in receiving feedback from you about our documentation. For example, did you notice any errors in the documentation? Were any features undocumented? Do you have any suggestions on how we can improve the documentation? All comments are welcome. Please submit your feedback to the following address: am.docfeedback@quest.com Please do not submit Technical Support related issues to this address. Text Conventions The following table summarizes how text styles are used in this guide: Convention Code Variables Interface Files, components, and documents Description Monospace text represents code, code objects, and commandline input. This includes: Java language source code and examples of file contents Classes, objects, methods, properties, constants, and events HTML documents, tags, and attributes Monospace-plus-italic text represents variable code or command-line objects that are replaced by an actual value or parameter. Bold text is used for interface options that you select (such as menu items) as well as keyboard commands. Italic text is used to highlight the following items: Pathnames, file names, and programs The names of other documents referenced in this guide About Quest Software, Inc. Quest Software, Inc., a leading enterprise systems management vendor, delivers innovative products that help organizations get more performance and productivity from

10 10 Foglight Experience Viewer their applications, databases, Windows infrastructure and virtual environments. Through a deep expertise in IT operations and a continued focus on what works best, Quest helps more than 90,000 customers worldwide meet higher expectations for enterprise IT. Quest provides customers with client management as well as server and desktop virtualization solutions through its subsidiaries, ScriptLogic and Vizioncore. Quest Software can be found in offices around the globe and at Contacting Quest Software Mail Web site info@quest.com Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA USA Refer to our web site for regional and international office information. Contacting Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a commercial version and have a valid maintenance contract. Quest Support provides around the clock coverage with SupportLink, our web self-service. Visit SupportLink at: From SupportLink, you can do the following: Quickly find thousands of solutions (Knowledgebase articles/documents). Download patches and upgrades. Seek help from a Support engineer. Log and update your case, and check its status. View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures. The guide is available at: Support Guide.pdf.

11 1 Upgrading the Foglight Experience Viewer to the Latest Version This chapter describes how to upgrade an older FxV installation to the latest FxV version. Note For information about any new features or enhancements included in the latest FxV version, refer to the FxV Release Notes. This chapter contains the following sections: General Instructions...12 Upgrading from Versions 4.4.x...13 Upgrading from Versions 5.0.0x to Version 5.0.1b...13 Upgrading from Versions 5.0.1x to Version 5.0.2a...14 Upgrading from Version 5.0.2a to Version 5.0.2c...15 Upgrading from Version 5.0.2b to Version 5.0.2c...16 Upgrading from Version 5.0.2c to Version 5.1.0a...17 Upgrading from Versions 5.1.0x to Version 5.2.0e...20 Upgrading from Version 5.2.0a or 5.2.0b to Version 5.2.0e...23 Upgrading from Version 5.2.0c or 5.2.0d to Version 5.2.0e...24

12 12 Foglight Experience Viewer General Instructions Upgrading the FxV appliance from older versions to the latest version may require more than one step. The following table presents the version number requirements for each upgrade. To Upgrade to This Version: 5.2.0e You Must Have This Version Installed: 5.2.0c or 5.2.0d 5.2.0a or 5.2.0b 5.1.0a, 5.1.0b, 5.1.0c, 5.1.0d, or 5.1.0e Upgrade Instructions Upgrading from Version 5.2.0c or 5.2.0d to Version 5.2.0e on page 24 Upgrading from Version 5.2.0a or 5.2.0b to Version 5.2.0e on page 23 Upgrading from Versions 5.1.0x to Version 5.2.0e on page a 5.0.2c Upgrading from Version 5.0.2c to Version 5.1.0a on page c 5.0.2b Upgrading from Version 5.0.2b to Version 5.0.2c on page a 5.0.2a 5.0.1a or 5.0.1b Upgrading from Version 5.0.2a to Version 5.0.2c on page 15 Upgrading from Versions 5.0.1x to Version 5.0.2a on page b Upgrading from Versions 5.0.0x to Version 5.0.1b on page 13 To verify which FxV version is installed on your system: 1 Log in to the FxV browser interface. 2 On the menu bar, click Help > About.

13 Upgrading the Foglight Experience Viewer to the Latest Version 13 Upgrading from Versions 4.4.x You can download upgrade files from SupportLink ( or from an appropriately configured Foglight server. To download the latest upgrader from Foglight: 1 Navigate to Administration > Cartridges > Components for Download. 2 Download the file associated with the EU-FXV-UPGRD cartridge. Upgrading from Versions 4.4.x No upgrade utilities are available for FxV versions 4.4.x. Contact Quest Support for reimaging your appliance with the latest FxV ISO. Important All captured data and settings are lost during this upgrade. Upgrading from Versions 5.0.0x to Version 5.0.1b To upgrade from versions 5.0.0x to version 5.0.1b, you need to obtain the following file: FxV-5.0.0x-5.0.1b-upgrade2.x86_64.run Important All captured data is lost during this upgrade, but configuration settings are retained. To upgrade the FxV appliance from versions 5.0.0x to version 5.0.1b: 1 Copy (via SCP) the hotfix run script to the FxV appliance, using the support account (password: support). Use the /home/support directory. 2 Log in to the FxV appliance using SSH, under the support account (password: support). 3 Enter the following commands: su (enter password: f0gligh7_42) cd /home/support sh FxV-5.0.0x-5.0.1b-upgrade2.x86_64.run exit su setup (password: setup)

14 14 Foglight Experience Viewer 4 Restart the FxV appliance from the setup menu. Note When the appliance has started, you can continue upgrading to the latest FxV version by following the instructions in Upgrading from Versions 5.0.1x to Version 5.0.2a on page 14. Upgrading from Versions 5.0.1x to Version 5.0.2a To upgrade from versions 5.0.1x to version 5.0.2a, you need to obtain the following files: FxV-5.0.1x-5.0.2a-pre-upgrade.run FxV-5.0.1x-5.0.2a-pre-upgrade.run.asc FxV-5.0.1x-5.0.2a-upgrade.x86_64.run FxV-5.0.1x-5.0.2a-upgrade.x86_64.run.asc Important No captured data or configuration settings are lost during this upgrade. To upgrade the FxV appliance from versions 5.0.1x to version 5.0.2a: 1 Apply the FxV-5.0.1x-5.0.2a-pre-upgrade.run file (and its FxV-5.0.1x-5.0.2a-preupgrade.run.asc certificate file) using the FxV browser interface. Follow the procedure in Single-Appliance Installations on page 15 with these file names substituted. This patches a defect in the 5.0.1x version, where very large upgrade files fail to upload properly. 2 Apply the FxV-5.0.1x-5.0.2a-upgrade.x86_64.run file (and its FxV-5.0.1x-5.0.2aupgrade.x86_64.run.asc certificate file) using the FxV browser interface. Follow the procedure in Single-Appliance Installations on page 15 with these file names substituted. This upgrades the FxV appliance to the 5.0.2a version, where it can be upgraded further. Note From here, you can continue upgrading to the latest FxV version by following these instructions, as applicable to your system: For single-appliance installations, follow the instructions in Single-Appliance Installations on page 15. For multiple-appliance installations, follow the instructions in Multiple-Appliance Installations on page 16.

15 Upgrading the Foglight Experience Viewer to the Latest Version 15 Upgrading from Version 5.0.2a to Version 5.0.2c Upgrading from Version 5.0.2a to Version 5.0.2c To upgrade from version 5.0.2a to version 5.0.2c, you need to execute one of the following procedures, as applicable to your system: For single-appliance installations, follow the instructions in Single-Appliance Installations on page 15. For multiple-appliance installations, follow the instructions in Multiple- Appliance Installations on page 16. Note From here, you can continue upgrading to the latest FxV version by following the instructions in Upgrading from Version 5.0.2c to Version 5.1.0a on page 17. Single-Appliance Installations To upgrade from version 5.0.2a to version 5.0.2c (for single-appliance installations), you need to obtain the following files: FxV-5.0.2a-5.0.2c-upgrade.x86_64.run FxV-5.0.2a-5.0.2c-upgrade.x86_64.run.asc Important No captured data or configuration settings are lost during this upgrade. To upgrade the FxV appliance from versions 5.0.2a to version 5.0.2c (for singleappliance installations): 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade FxV. 4 Using the Browse buttons, navigate to and select the following upgrade files on your local machine: FxV-5.0.2a-5.0.2c-upgrade.x86_64.run as the Script File. FxV-5.0.2a-5.0.2c-upgrade.x86_64.run.asc as the Certificate File. 5 Click OK. The upgrade files are uploaded and verified.

16 16 Foglight Experience Viewer 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now), which applies the upgrade immediately. 7 To apply the upgrade, click OK. 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.0.2c. Multiple-Appliance Installations To upgrade from version 5.0.2a to version 5.0.2c (for multiple-appliance installations), you need to obtain the following files: FxV-5.0.2a-upgrader.multiple.remote.patch.run FxV-5.0.2a-upgrader.multiple.remote.patch.run.asc FxV-5.0.2a-5.0.2c-upgrade.x86_64.run FxV-5.0.2a-5.0.2c-upgrade.x86_64.run.asc Important No captured data or configuration settings are lost during this upgrade. To upgrade the FxV appliance from versions 5.0.2a to version 5.0.2c (for multipleappliance installations): 1 Apply the FxV-5.0.2a-upgrader.multiple.remote.patch.run file (and its FxV a-upgrader.multiple.remote.patch.run.asc certificate file) using the FxV browser interface. Follow the procedure in Single-Appliance Installations on page 15 with these file names substituted. This patches a defect in version 5.0.2a, where installations with two or more appliances are not upgraded properly. 2 Finish the upgrade to version 5.0.2c by following the steps in Single-Appliance Installations on page 15. Upgrading from Version 5.0.2b to Version 5.0.2c To upgrade from version 5.0.2b to version 5.0.2c, you need to obtain the following file:

17 Upgrading the Foglight Experience Viewer to the Latest Version 17 Upgrading from Version 5.0.2c to Version 5.1.0a FxV-5.0.2b-5.0.2c-upgrade.x86_64.runx Important No captured data or configuration settings are lost during this upgrade. To upgrade the FxV appliance from version 5.0.2b to version 5.0.2c: 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade FxV. 4 Using the Browse button, navigate to and select the following upgrade file on your local machine: FxV-5.0.2b-5.0.2c-upgrade.x86_64.runx as the Script File. 5 Click OK. The upgrade file is uploaded and verified. 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now) which applies the upgrade immediately. 7 To apply the upgrade, click OK. 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.0.2c. Note From here, you can continue upgrading to the latest FxV version by following the instructions in Upgrading from Version 5.0.2c to Version 5.1.0a on page 17. Upgrading from Version 5.0.2c to Version 5.1.0a To upgrade from version 5.0.2c to version 5.1.0a, you need to obtain the following file: FxV-5.0.2c-5.1.0a-upgrade.x86_64.runx Important No captured data is lost during this upgrade.

18 18 Foglight Experience Viewer The following changes to the system configuration take place as part of the upgrade process: Default Monitor Group is renamed to Default Collector Group. The RSS Feed configuration is lost (RSS Feeds are no longer supported). The Group configuration is lost ( Groups are no longer supported). The Threshold and Alert configurations are lost (metric alerting is no longer supported directly in FxV). All Sensitive Data Groups are converted to the new sensitive data protection scheme and then removed. Request Fields defined as sensitive within one or more Sensitive Data Groups are redefined as Sensitive Hit Details under the new Sensitive Data configuration scheme. Any Resource Groups configured to contain Sensitive Data Groups are modified to remove this capability. Note This may result in Resource Groups that have no allowed resource types defined. Such Resource Groups may be deleted manually. Excluded fields defined in one or more Collector Groups (formerly called Monitor Groups) are converted to the new sensitive data protection scheme and then removed. These excluded fields are redefined as Sensitive Hit Details under the new Sensitive Data configuration scheme. To upgrade the FxV appliance from version 5.0.2c to version 5.1.0a: 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade FxV. 4 Using the Browse button, navigate to and select the following upgrade file on your local machine: FxV-5.0.2c-5.1.0a-upgrade.x86_64.runx as the Script File. 5 Click OK. The upgrade file is uploaded and verified. 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now) which applies the upgrade immediately. 7 To apply the upgrade, click OK. Note Shortly after clicking OK, the browser displays an error screen. This is normal and is due to the fact that you have just rebooted the machine that is running the FxV browser interface.

19 Upgrading the Foglight Experience Viewer to the Latest Version 19 Upgrading from Version 5.0.2c to Version 5.1.0a 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.1.0a. 12 On the menu bar, click Configure > User Groups. The displayed user groups depend on the previous configuration. One or more groups should have administrative privileges defined. If the default user group configuration has not been modified, the administrators group is the only group with administrative privileges. 13 If you have multiple user groups with administrative privileges, you can perform the following steps on any or all of these groups. These steps are optional. a Click the Edit icon beside an administrative user group.

20 20 Foglight Experience Viewer b c Enable users in this user group to configure sensitive data for the system by selecting the Sensitive Data check box, then click OK. Repeat step a to step b for any additional user group to which you want to grant access to sensitive data configuration. Note From here, you can continue upgrading to the latest FxV version by following the instructions in Upgrading from Versions 5.1.0x to Version 5.2.0e on page 20. Upgrading from Versions 5.1.0x to Version 5.2.0e To upgrade from versions 5.1.0x to version 5.2.0e, you need to obtain the following file: FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx Important No captured data is lost during this upgrade.

21 Upgrading the Foglight Experience Viewer to the Latest Version 21 Upgrading from Versions 5.1.0x to Version 5.2.0e To upgrade the FxV appliance from version 5.1.0x to version 5.2.0e: Note This upgrade involves manual steps that have not been required in previous upgrades. 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade Appliance(s). 4 Using the Browse button, navigate to and select the following upgrade file on your local machine: FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx as the Script File. 5 Click OK. The upgrade file is uploaded and verified. 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now) which applies the upgrade immediately. 7 To apply the upgrade, click OK. Note Shortly after clicking OK, the browser displays an error screen (or a blank page). This is normal and is due to the fact that you have just rebooted the machine that is running the FxV browser interface. 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click Help > About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.2.0e. The system software is now updated. 12 If you want to remove and edit Hit Filters that are no longer needed, perform the following manual steps. These steps are optional, but they are strongly recommended. Omitting these steps results in what appears to be duplicate session data. a b c As a user with permissions to edit and delete existing Hit Filters, on the menu bar, click Configure > Hit Analysis. Expand the Hit Filters panel. If it exists, delete the Default Connection Reset Exclusions Hit Filter by clicking the Delete icon.

22 22 Foglight Experience Viewer d e f g If it exists, delete the Default Web Server Timeout Exclusions Hit Filter by clicking the Delete icon. If it exists, delete the Default Browser Type Extraction Hit Filter by clicking the Delete icon. If it exists, edit the Default Session Custom Fields Hit Filter by clicking the Edit icon, then click OK when the Warning dialog box appears. In the Custom Fields section for the Default Session Custom Fields Hit Filter, delete the Session ID, User Agent, and Client IP Custom Fields by clicking the Delete icons in the upper-right corners of the corresponding gray boxes. This Hit Filter should now update only a single Custom Field: Initial Referer. Note The information previously provided by the Custom Fields removed in this step is now available as built-in properties of every session. 13 If your FxV system captures data from Web sites that do not have very large numbers of unique field, header, or cookie names, then perform this manual step. This optional step ensures that when FxV users click the buttons in the browser interface, the lists displayed contain all the captured values. a As a user with Superuser permissions, on the menu bar, click Configure > Superuser Tasks. The Superuser Tasks page appears. b c d Click Server Configuration. The Server Configuration page appears. Set Metadata Sensitivity field to 1, then click OK. Restart the FxV Server via the appliance setup menu (for instructions, see the FxV Installation and Administration Guide). Note This Metadata Sensitivity setting takes effect only upon restarting the Server.

23 Upgrading the Foglight Experience Viewer to the Latest Version 23 Upgrading from Version 5.2.0a or 5.2.0b to Version 5.2.0e Upgrading from Version 5.2.0a or 5.2.0b to Version 5.2.0e To upgrade from version 5.2.0a or 5.2.0b to version 5.2.0e, you need to obtain the following file (note that this upgrade file can be used to upgrade from any 5.1.0x version, as well as 5.2.0a and 5.2.0b, to 5.2.0e version): FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx Important No captured data is lost during this upgrade. To upgrade the FxV appliance from version 5.2.0a or 5.2.0b to version 5.2.0e: 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade Appliance(s). 4 Using the Browse button, navigate to and select the following upgrade file on your local machine: FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx as the Script File. 5 Click OK. The upgrade file is uploaded and verified. 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now) which applies the upgrade immediately. 7 To apply the upgrade, click OK. Note Shortly after clicking OK, the browser displays an error screen (or a blank page). This is normal and is due to the fact that you have just rebooted the machine that is running the FxV browser interface. 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click Help > About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.2.0e. The system software is now updated. 12 If your FxV system captures data from Web sites that do not have very large numbers of unique field, header, or cookie names, then perform this manual step. This optional step ensures that when FxV users click the buttons in the browser interface, the lists displayed contain all the captured values.

24 24 Foglight Experience Viewer a As a user with Superuser permissions, on the menu bar, click Configure > Superuser Tasks. The Superuser Tasks page appears. b c d Click Server Configuration. The Server Configuration page appears. Set Metadata Sensitivity field to 1, then click OK. Restart the FxV Server via the appliance setup menu (for instructions, see the FxV Installation and Administration Guide). Note This Metadata Sensitivity setting takes effect only upon restarting the Server. Upgrading from Version 5.2.0c or 5.2.0d to Version 5.2.0e To upgrade from version 5.2.0c or 5.2.0d to version 5.2.0e, you need to obtain the following file (note that this upgrade file can be used to upgrade from any 5.1.0x version, as well as 5.2.0x version, to 5.2.0e version): FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx Important No captured data is lost during this upgrade. To upgrade the FxV appliance from version 5.2.0c or 5.2.0d to version 5.2.0e: 1 Log in to the FxV browser interface. 2 On the menu bar, click Configure > Superuser Tasks. 3 Click Upgrade Appliance(s). 4 Using the Browse button, navigate to and select the following upgrade file on your local machine: FxV-5.1.0x-5.2.0e-upgrade.x86_64.runx as the Script File. 5 Click OK. The upgrade file is uploaded and verified. 6 Select a specific Upgrade Time to schedule when the upgrade should be applied, or accept its default (Now) which applies the upgrade immediately. 7 To apply the upgrade, click OK. Note Shortly after clicking OK, the browser displays an error screen (or a blank page). This is normal and is due to the fact that you have just rebooted the machine that is running the FxV browser interface.

25 Upgrading the Foglight Experience Viewer to the Latest Version 25 Upgrading from Version 5.2.0c or 5.2.0d to Version 5.2.0e 8 Wait several minutes for the appliance to update and then restart. 9 Log in to the FxV browser interface. 10 On the menu bar, click Help > About. 11 In the dialog box that opens, verify that the FxV version number displayed is 5.2.0e. The system software is now updated.

26 26 Foglight Experience Viewer

27 Index A about Foglight 6 about Quest Software 9 C contacting Quest 10 D documentation 7 cartridge 8 core 7 feedback 9 FxV appliance 6 suite 7 F from version 4.4.x, upgrading x, upgrading to 5.0.1b x, upgrading to 5.0.2a a, upgrading to 5.0.2c 15 multiple-appliance installations 16 single-appliance installations b, upgrading to 5.0.2c c, upgrading to 5.1.0a x, upgrading to 5.2.0e a, upgrading to 5.2.0e b, upgrading to 5.2.0e 23 G 5.2.0c, upgrading to 5.2.0e d, upgrading to 5.2.0e 24 general instructions 12 S suite 7 support 10 T technical support 10 text conventions 9 to version 5.0.1b, upgrading from 5.0.0x a, upgrading from 5.0.1x c, upgrading from 5.0.2a 15 multiple-appliance installations 16 single-appliance installations c, upgrading from 5.0.2b a, upgrading from 5.0.2c e, upgrading from 5.1.0x e, upgrading from 5.2.0a e, upgrading from 5.2.0b e, upgrading from 5.2.0c e, upgrading from 5.2.0d 24

28 28 Foglight Experience Viewer U upgrading from 4.4.x 13 from 5.0.0x to 5.0.1b 13 from 5.0.1x to 5.0.2a 14 from 5.0.2a to 5.0.2c 15 multiple-appliance installations 16 single-appliance installations 15 from 5.0.2b to 5.0.2c 16 from 5.0.2c to 5.1.0a 17 from 5.1.0x to 5.2.0e 20 from 5.2.0a to 5.2.0e 23 from 5.2.0b to 5.2.0e 23 from 5.2.0c to 5.2.0e 24 from 5.2.0d to 5.2.0e 24 general instructions 12