HP ALM Performance Center Software Version: 11.00 Installation Guide Document Release Date: October 2010 Software Release Date: October 2010 Legal Notices Warranty 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. Restricted Rights Legend 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. Copyright Notices © Copyright 1992 - 2010 Hewlett-Packard Development Company, L.P. Trademark Notices Adobe® is a trademark of Adobe Systems Incorporated. Intel® and Pentium® are trademarks or registered trademarks of Intel Corporation in the United States and other countries. JavaTM is a US trademark of Sun Microsystems, Inc. Microsoft®, Windows®, Windows® XP, and Windows Vista® are U.S registered trademarks of Microsoft Corporation. Oracle® is a registered trademark of Oracle Corporation and/or its affiliates. Red HatTM is a registered trademark of Red Hat, Inc. Unix® is a registered trademark of The Open Group. 2 Documentation Updates The title page of this document contains the following identifying information: (cid:129) Software Version number, which indicates the software version. (cid:129) Document Release Date, which changes each time the document is updated. (cid:129) Software Release Date, which indicates the release date of this version of the software. To check for recent updates, or to verify that you are using the most recent edition of a document, go to: 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. 3 Support 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 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 web site to: (cid:129) Search for knowledge documents of interest (cid:129) Submit and track support cases and enhancement requests (cid:129) Download software patches (cid:129) Manage support contracts (cid:129) Look up HP support contacts (cid:129) Review information about available services (cid:129) Enter into discussions with other software customers (cid:129) 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 a support contract. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html To find more information about access levels, go to: http://h20230.www2.hp.com/new_access_levels.jsp 4 Table of Contents Welcome to This Guide.........................................................................9 How This Guide is Organized................................................................9 Documentation Library Guides...........................................................11 Additional Online Resources...............................................................14 PART I: GETTING STARTED Chapter 1: Before You Install..............................................................17 Installation Flow..................................................................................18 PerformanceCenter Components and Data Flow..............................19 System Component Considerations...................................................26 General Pre-installation Considerations.............................................30 Required Services.................................................................................31 Performance Center Prerequisite Software..........................................32 PART II: INSTALLATION AND CONFIGURATION Chapter 2: Installing HPALM PerformanceCenter............................37 Installation Flow..................................................................................38 Deploying the PerformanceCenter Extension...................................41 Installing and Configuring PerformanceCenter Servers and Hosts...42 Initial PerformanceCenter Manual Configuration............................58 Silent Installation of PerformanceCenter..........................................63 Setting Up the Silent Configuration...................................................70 Installing Standalone Components (Windows)..................................71 Installing HPLoadGenerator on UNIX..............................................74 Installing Additional Components.....................................................88 Repairing the PerformanceCenter Installation..................................91 Uninstalling PerformanceCenter Components.................................92 Chapter 3: Post Installation Verification.............................................95 Administrator Workflow.....................................................................95 Performance Tester Workflow.............................................................99 Table of Contents Chapter 4: PerformanceCenter Configuration Options..................109 Configuring Host Security Settings...................................................110 Windows XP Professional Configuration.........................................111 Configuring IIS on PerformanceCenter Machines to Use SSL.........112 Working with PerformanceCenter Agent........................................114 HPLoadGenerator (UNIX) Configuration.......................................116 Establishing Connectivity with Oracle.............................................122 PART III: UPGRADE AND MIGRATION Chapter 5: Upgrading to HPALM PerformanceCenter 11.00.........125 The Upgrade Process: Basic Steps......................................................126 Pre-Upgrade Preparation and Considerations...................................128 Backing Up PerformanceCenter Data..............................................129 Uninstalling Earlier Versions of PerformanceCenter.......................132 Installing and Configuring HPALMPerformanceCenter11.00......135 Verifying Successful Installation.......................................................135 Migrating PerformanceCenter Data.................................................135 Post-Migration Verification...............................................................158 Post Migration Notes.........................................................................161 PART IV: WORKING WITH FIREWALLS Chapter 6: Working with Firewalls...................................................175 About Using Firewalls in PerformanceCenter..................................176 Example: Over Firewall Deployment................................................178 Setting Up the System to Use Firewalls: Basic Steps.........................179 Installing Over-Firewall Components...............................................181 Initial Configuration of the Over-Firewall System...........................181 Specifying MI Listeners in ALM........................................................186 Chapter 7: Running Vusers Over a Firewall......................................189 Running Vusers Over a Firewall: Basic Steps.....................................190 Configuring Hosts to Run Vusers Over a Firewall............................192 Chapter 8: Monitoring Over a Firewall.............................................195 Monitoring Over a Firewall: Basic Steps............................................196 Configuring Monitor Settings...........................................................198 Configuring the Project to Receive Monitor Over Firewall Information...................................................................................204 Editing Monitor Over Firewall Machines During a Test Run...........205 6 Table of Contents Chapter 9: Configuring the PerformanceCenter Agent..................207 About Configuring PerformanceCenter Agents Over the Firewall...........................................................................208 Configuring the Windows PerformanceCenter Agent.....................209 Configuring and Running the UNIX PerformanceCenter Agent....211 Agent Configuration Settings............................................................213 Checking Connectivity.....................................................................216 PART V: TROUBLESHOOTING Chapter 10: Troubleshooting Installation........................................221 Failed to install Performance Center Extension for ALM from the network.................................................................222 PerformanceCenter Server installation cannot be completed: IIS is not installed......................................................223 Installation does not start when selecting it from the DVD menu..............................................................................223 Cannot run installation from a network drive.................................224 During setup, installation of a prerequisite fails...............................225 Cannot log in; Error regarding JavaScript.........................................226 Performance Center Server cannot be added to ALM due to mismatch in Communication Security passphrase...........227 Failed to add PerformanceCenter Server to LabManagement during PerformanceCenter Server configuration................................................................................228 Cannot connect to Performance Center Server or Host...........................................................................................229 Connection to Controller failed when starting a run and the online run screen did not load........................................230 When starting a test run, the host is added, but the Initializing Run page does not load.................................230 The application cannot locate an extension with path \Extensions\PCProject.qcx..........................................................231 Cannot connect to the Hosts using IUSR_METRO user with the MIOrchid#1 password....................................................231 Uninstall of host failed or froze........................................................232 7 Table of Contents 8 Welcome to This Guide Welcome to the HP ALM Performance Center Installation Guide. This guide is supplementary to the HPApplication Lifecycle Management Installation Guide for the purpose of installing HP ALM PerformanceCenter components. This section includes: ➤ How This Guide is Organized onpage9 ➤ Documentation Library Guides onpage11 ➤ Additional Online Resources onpage14 How This Guide is Organized The HP ALM Performance Center Installation Guide describes the system prerequisites and installation process for HPALM PerformanceCenter. It contains the following parts: Part I Getting Started Provides an overview of the installation flow, the system components, and the data flow. In addition provides installation prerequisites and considerations for the PerformanceCenter components, and outlines required services. Part II Installation and Configuration Describes how to install HP ALM PerformanceCenter components and provides initial and optional configuration instructions. 9 Welcome to This Guide Part III Upgrade and Migration Describes how to upgrade from earlier versions of PerformanceCenter to HP ALM PerformanceCenter 11.00, including data and project migration. Part IV Working with Firewalls Describes how to set up the ALM PerformanceCenter components to communicate with ALM PerformanceCenter components that are located over a firewall. Part V Troubleshooting Troubleshoots issues that may arise related to the installation of the PerformanceCenter components. 10