HP ALM Performance Center Software Version: 11.52 Installation Guide Document Release Date: May 2013 Software Release Date: May 2013 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 - 2013 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. Oracle® is a registered trademark of Oracle and/or its affiliates. Java is a registered trademark of Oracle and/or its affiliates. Microsoft®, Windows®, Windows® XP, and Windows Vista® are U.S registered trademarks of Microsoft Corporation. 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.......................................................................11 How This Guide is Organized..............................................................11 ALM Help.............................................................................................12 ALM Help Guides................................................................................13 Additional Online Resources...............................................................17 HP ALM Extension Guides..................................................................18 PART I: GETTING STARTED Chapter 1: Before You Install..............................................................21 PerformanceCenter Components and Data Flow..............................22 System Component Considerations...................................................30 General Pre-installation Considerations.............................................34 Required Services.................................................................................36 Performance Center Prerequisite Software..........................................37 PART II: INSTALLATION AND CONFIGURATION Chapter 2: Installing HPALM PerformanceCenter............................43 Installation Flow..................................................................................44 Installing HPApplication Lifecycle Management..............................46 Installing and Configuring PerformanceCenter Servers and Hosts...47 Installing the PerformanceCenter Server and Host Patch.................62 Configuring PerformanceCenter in Lab Management......................65 Installing PerformanceCenter Silently...............................................69 Installing Standalone Components (Windows)..................................79 Installing HPLoadGenerator on Linux..............................................82 Installing Additional Components...................................................100 Updating Lab Management Projects to the Latest Patch..................103 Repairing the PerformanceCenter Installation................................103 Uninstalling PerformanceCenter Components...............................104 Table of Contents Chapter 3: Post Installation Verification...........................................107 Administrator Workflow...................................................................107 Performance Tester Workflow...........................................................111 Chapter 4: PerformanceCenter Configuration Options..................119 Configuring Host Security Settings...................................................120 Configuration for Windows XP Professional....................................121 Configuring IIS on PerformanceCenter Machines to Use SSL.........122 Working with PerformanceCenter Agent........................................129 Configuration for HPLoadGenerator (Linux).................................131 Establishing Connectivity with Oracle.............................................133 Enabling Downloading Standalone Applications.............................134 Enabling MS-SQL Windows Authentication.....................................137 PART III: WORKING WITH PREVIOUSLY CREATED PERFORMANCE CENTER PROJECTS Chapter 5: Working with Previously Created Projects.....................141 About Working with Previously Created Projects............................142 The Migration Process: Basic Steps....................................................143 Pre-Migration Preparation and Considerations................................144 Backing Up PerformanceCenter Data..............................................146 Uninstalling Earlier Versions of PerformanceCenter.......................147 Installing and Configuring the Latest Version of PerformanceCenter..................................................................150 Verifying Successful Installation.......................................................150 Migrating PerformanceCenter Data.................................................150 Post-Migration Verification...............................................................177 Post Migration Considerations..........................................................179 PART IV: WORKING WITH FIREWALLS Chapter 6: Working with Firewalls...................................................193 About Using Firewalls in PerformanceCenter..................................194 Example: Over Firewall Deployment................................................196 Setting Up the System to Use Firewalls: Basic Steps.........................197 Installing Over Firewall Components...............................................199 Initial Configuration of the Over Firewall System............................199 Specifying MI Listeners in ALM........................................................204 Chapter 7: Running Vusers Over a Firewall......................................207 Running Vusers Over a Firewall: Basic Steps.....................................208 Configuring Hosts to Run Vusers Over a Firewall............................210 6 Table of Contents Chapter 8: Monitoring Over a Firewall.............................................213 Monitoring Over a Firewall: Basic Steps............................................214 Configuring Monitor Settings...........................................................216 Configuring the Project to Receive Monitor Over Firewall Information...................................................................................222 Editing Monitor Over Firewall Machines During a Test Run...........223 Chapter 9: Configuring the PerformanceCenter Agent..................225 About Configuring PerformanceCenter Agents Over the Firewall..226 Configuring the Windows PerformanceCenter Agent.....................227 Configuring and Running the UNIX PerformanceCenter Agent....229 Agent Configuration Settings............................................................231 Checking Connectivity.....................................................................234 7 Table of Contents PART V: TROUBLESHOOTING Chapter 10: Troubleshooting............................................................239 During PerformanceCenter Server Setup Installation of a Prerequisite Fails.................................................241 PerformanceCenter Server Installation Cannot be Completed: IIS is not Installed................................................242 Fails to Install .NET Framework 3.5 SP1 on Windows 2008 R2........243 Cannot Connect to Performance Center Server or Host..................243 PerformanceCenter Host Installation Hangs at Registering Modules..................................................................244 PerformanceCenter Server Cannot be Added to ALM Due to Mismatch in Communication Security Passphrase.................245 PerformanceCenter Host Cannot be Added to Lab Management, or is Non-Operational, Due to Mismatch in Communication Security Passphrase......................246 Performance Center Server Cannot be Added to Lab Management: HostNotFound Error.....................................................................247 Connection to Controller Failed when Starting a Run and the Online Run Screen Did Not Load....................................247 Working with PerformanceCenter when Windows Firewall is Enabled........................................................248 Cannot Start Remote Management Agent Service Automatically................................................................................251 Uninstall of Host Failed or Has Frozen.............................................251 Patch Installation Fails......................................................................252 Installing a patch requires you to stop the PerformanceCenter Load Testing Service on the host machine.....................................................................253 Cannot Launch ALM: Message That Software Not Installed............254 Cannot Log in to PerformanceCenter via the Client Machine: Error Regarding JavaScript...........................254 When Starting a Test Run, the Host is Added, but the Initializing Run Page Does Not Load............................................255 Cannot Run PerformanceCenter Component Installation from a Network Drive...................................................................256 Installing PerformanceCenter Components Does Not Start when Selecting Them from the DVD Menu........................257 Installing One of the PerformanceCenter Components Cannot Use Default Port: Port Already in Use.............................258 Unable to Use Non-Default Ports in Microsoft SQL.........................261 Errors in the Migration Tool Report.............................................261 8 Table of Contents Cannot Connect to Oracle Database on 64-bit Windows OS...........263 Cannot Migrate a Project Again Because it Cannot be Deleted.......264 Errors in the Migration Log...............................................................265 The Migrated Project is Not Linked to the PC_PROJECT_TEMPLATE Project After the Migration.................265 Migration Tool Logs..........................................................................267 Migration Tables Not Found.............................................................269 Migration Tool Report Data Not Found............................................270 Load Test Fails to Start and Issues no Error Message........................271 Unable to View Topology Monitors Online.....................................271 9 Table of Contents 10