BPT For SAP Installation Guide
BPT For SAP Installation Guide
BPT For SAP Installation Guide
Installation Guide
Document Release Date: May 2008 Software Release Date: May 2008
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. Third-Party Web Sites HP provides links to external third-party Web sites to help you find supplemental information. Site content and availability may change without notice. HP makes no representations or warranties whatsoever as to site content or availability. Copyright Notices 1992 - 2008 Mercury Interactive (Israel) Ltd. Trademark Notices 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.
Documentation Updates
This manuals title page contains the following identifying information: Software version number, which indicates the software version Document release date, which changes each time the document is updated 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
Support
You can visit the HP Software Support Web site at: www.hp.com/go/hpsoftwaresupport HP Software online support provides an efficient way to access interactive technical support tools. 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 a support contract. To find more information about access levels, go to: 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
Table of Contents
Table of Contents
Welcome to This Guide ........................................................................7 How This Guide is Organized................................................................7 Additional Online Resources.................................................................7 Documentation Updates .......................................................................8 Typographical Conventions..................................................................9 Chapter 1: Installing the Enterprise Extension ...................................11 The Installation and Setup Process .....................................................11 Installing the Enterprise Extension .....................................................13 Upgrading a Project to Enterprise Extension 2.50 ..............................26 Uninstalling the Enterprise Extension ................................................27 Chapter 2: Setting Up the Enterprise Extension ................................35 About Setting Up the Enterprise Extension ........................................36 Loading the Enterprise Extension License ..........................................36 Enabling the Enterprise Extension......................................................37 Installing the SAP Application Importer Component ........................39 Configuring the SAP Environment .....................................................40 Customizing the Enterprise Extension ...............................................40
Table of Contents
Chapter 1
Chapter 2
HP Software Support accesses the HP Software Support Web site. This site enables you to browse the Self-solve knowledge base. You can also post to and search user discussion forums, submit support requests, download patches and updated documentation, and more. Choose Help > HP Software Support. The URL for this Web site is www.hp.com/go/hpsoftwaresupport. Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To find more information about access levels, go to: http://h20230.www2.hp.com/new_access_levels.jsp To register for an HP Passport user ID, go to: http://h20229.www2.hp.com/passport-registration.html HP Software Web site accesses the HP Software Web site. This site provides you with the most up-to-date information on HP Software products. This includes new software releases, seminars and trade shows, customer support, and more. Choose Help > HP Software Web site. The URL for this Web site is www.hp.com/go/software.
Documentation Updates
HP Software is continually updating its product documentation with new information. To check for recent updates, or to verify that you are using the most recent edition of a document, go to the HP Software Product Manuals Web site (http://h20230.www2.hp.com/selfsolve/manuals).
Typographical Conventions
This guide uses the following typographical conventions: UI Elements and Function Names This style indicates the names of interface elements on which you perform actions, file names or paths, and other items that require emphasis. For example, Click the Save button. It also indicates method or function names. For example, "The wait_window statement has the following parameters:" This style indicates method, property, or function arguments and book titles. For example, Refer to the HP Users Guide. Angle brackets enclose a part of a file path or URL address that should be replaced with an actual value. For example, <MyProduct installation folder>\bin. This style is used for examples and text that is to be typed literally. For example, Type Hello in the edit box. This style indicates keyboard keys. For example, Press ENTER. Square brackets enclose optional arguments. Curly brackets indicate that one of the enclosed values must be assigned to the current argument. In a line of syntax, an ellipsis indicates that more items of the same format may be included. In a programming example, an ellipsis is used to indicate lines of a program that were intentionally omitted. A vertical bar indicates that one of the options separated by the bar should be selected.
Arguments
<Replace Value>
Example
CTRL+C [] {} ...
10
1
Installing the Enterprise Extension
This chapter describes how to install the Enterprise Extension. This chapter includes:
The Installation and Setup Process on page 11 Installing the Enterprise Extension on page 13 Upgrading a Project to Enterprise Extension 2.50 on page 26 Uninstalling the Enterprise Extension on page 27
11
Ensure that supported versions of the following items are installed on your Quality Center server:
Any required Quality Center patches Ensure that supported versions of the following items are installed on each Quality Center client that will use the Business Process Testing for SAP Applications:
QuickTest Professional, including the Add-in for SAP solutions SAP GUI Client QuickTest Professional Add-in For Business Process Testing
2 Install the QuickTest 9.5 Patch: QTPBPT_00002 for HP QuickTest Professional 9.50 QFE In the QuickTest_Professional_Patch folder on the HP Business Process Testing for SAP Applications CD-ROM, double-click the QTPBPT_00002_Patch.exe. 3 Install the Enterprise Extension on your server computer. For more information, see Installing the Enterprise Extension on page 13. 4 Load the Enterprise Extension licence on your Quality Center server. For more information, see Loading the Enterprise Extension License on page 36. 5 Enable the Enterprise Extension in Quality Center Site Administration for every project that requires the Enterprise Extension. For more information, see Enabling the Enterprise Extension on page 37.
12
6 Install the SAP Application Importer Component on each client computer that will be used to import new application entities to the project. The Quality Center Application Model module is installed automatically when you install the Enterprise Extension. To import application entities from your SAP application to the Application Model module, the SAP Application Importer Component must be installed on each client computer from which you want to import application entities. For more information on installing the SAP Application Importer Component, see Installing the SAP Application Importer Component on page 39. 7 Upgrade any existing projects from Business Process Testing for SAP Applications version 2.0 to version 2.5. For more information, see Upgrading a Project to Enterprise Extension 2.50 on page 26.
./setup_solaris.bin -console
To install on a Linux platform, type:
./setup_linux.bin -console Note: The console mode installation contains the same text and prompts as the UI mode installation. The text and prompts are displayed in text mode.
13
To install:
Make sure that the DISPLAY environment variable is
properly configured on the Quality Center host computer, and that the computer from which you are installing is running an X-server (for example, Exceed). For example, to configure the DISPLAY environment variable for TCShell: 1 Run an X-server (such as eXceed) on your client machine. 2 Login into the Linux/Solaris machine. 3 Run the tcsh command to enter the TCShell. 4 At the command line prompt enter setenv DISPLAY 1.1.1.1:0.0, where 1.1.1.1 is the IP address of the client machine running the X-server. 5 Navigate to the CD root directory.
To install on a Solaris platform, type:
./setup_solaris.bin
To install on a Linux platform, type:
./setup_linux.bin
2 If you are installing over a previous version of the Enterprise Extension, a message is displayed recommending that you backup any custom configurations before continuing. 3 The Welcome screen opens. Click Next.
14
Read the license agreement. To accept the terms of the license agreement, select I accept the terms of the license agreement. Click Next.
15
Accept the proposed folder for the Enterprise Extension installation or browse to an alternate folder. Click Next.
16
17
Select whether to install only the Enterprise Extension or the Enterprise Extension together with other Quality Center extensions:
To install only the Enterprise Extension, select Business Process Testing Enterprise Extension 2.50. To install the Enterprise Extension together with other Quality Center extensions, select Multiple Installations.
Click Next.
18
8 If you chose to install only the Enterprise Extension, proceed to step 9. If you chose Multiple Installations, the Select Which Products to Install screen opens.
Select the extensions that you want to install and click Next. For information on other extensions, see the documentation for the relevant extension.
19
To review or change any settings, click Back. To accept the settings and start the installation, click Next. The installation process starts.
20
10 When the installation process is complete, the Update the Server screen opens.
When you update the Quality Center server, the Enterprise Extension files are copied into the opened archive directories (qcbin.war and sabin.war) in the <Quality Center Installation>\application directory. Then the Quality Center Archive and Deployment Tool runs. This tool enables you to update the running Quality Center Web server. Select an update option:
Update now. Automatically updates the Quality Center archive files and runs the deployment tool. Update later. Enables you to manually update the Quality Center server at a later time. You must update the Quality Center server before you can use the Enterprise Extension.
Click Next.
21
11 If you selected Update now, proceed to step 12. If you selected Update later, click Next and then click Finish to close the installation setup screen. When you are ready to update the application server, run the deploy.bat script (or deploy.sh for Solaris or Linux) from the <Enterprise Extension installation> directory. When running the batch file, specify the Quality Center installation directory and the location of the Quality Center repository, using the format: deploy <Quality Center installation directory> <Quality Center repository directory> For example: deploy "C:\Program Files\Mercury\Quality Center" "C:\Program Files\Mercury\Quality Center\repository" 12 After clicking Update now or manually launching the batch file, the Quality Center Archive and Deployment Tool opens.
22
For the Enterprise Extension to work with Quality Center, you need to create a new archive and redeploy the qcbin.war and sabin.war files on the application server. This enables changes to the archive files to take effect. Click Next to create the new archive files. 13 If your application server is JBoss, proceed to step 14. If your application server is WebSphere or WebLogic, the following screen opens.
You must deploy Quality Center manually on the application server after the setup process completes. The location of the archive files is shown in the screen.
Note: For more information on manually deploying Quality Center on an application server, see the HP Quality Center Installation Guide.
23
14 If your application server is WebSphere or WebLogic, proceed to step 16. If your application server is JBoss, the HP Quality Center Redeployment screen opens.
Yes. Deploys the archive files automatically. No. Indicates that you will deploy the archive files later.
Click Next.
24
15 If the Quality Center service is running, the Archive and Deployment Tool automatically attempts to stop the service. If the tool is unable to stop the service, the Service Not Stopped screen opens.
Retry. Instructs the setup program to try to stop the JBoss service again. Skip JBoss deployment. Instructs the setup program to cancel deployment. You should manually deploy JBoss later.
Click Next. 16 When the deployment is complete, the Completion screen opens. Click Finish to close the Quality Center Archive and Deployment Tool.
Note: If you manually deployed the archive files on your application server, you must restart Quality Center after deployment.
17 Click Finish to close the HP quality process for SAP applications Setup screen.
25
26
To confirm the current projects extension version, click the Project Extensions tab. A check is displayed in the check boxes for the enabled extensions.
4 Click the Upgrade Project button in the Site Projects toolbar. 5 Upgrading a project to a new extension version requires following standard database upgrade procedures for Quality Center projects. For more information, see the HP Quality Center Administrators Guide.
Note: If you installed more than one extension when installing the Enterprise Extension (see step 7 on page 18), all extensions are uninstalled.
27
To uninstall the Enterprise Extension: 1 Make sure that the application server is running. 2 Open the HP Quality Process for SAP Solutions Uninstall wizard for your platform:
Platform Windows To uninstall: Select Start > Settings > Control Panel > Add/Remove Programs, select HP Quality Process for SAP Applications, and click the Change/Remove button.
Locate the Enterprise Extension uninstall directory. By
Note: Console mode uninstallation contains the same text and prompts as the UI mode uninstallation. The text and prompts are displayed in text mode. Solaris or Linux (UI mode)
Make sure that the DISPLAY environment variable is
properly configured on the Quality Center server machine, and that the client machine from which you are uninstalling is running an X-server (for example, eXceed). For example, to configure the DISPLAY environment variable for TCShell: 1 Run an X-server (such as eXceed) on your client machine. 2 Login into the Linux/Solaris machine. 3 Run the tcsh command to enter the TCShell. 4 At the command line prompt enter setenv DISPLAY 1.1.1.1:0.0, where 1.1.1.1 is the IP address of the client machine running the X-server. 5 Locate the Enterprise Extension home directory. By default, the files are stored in [drive]:/opt/Mercury/ QualityProcessforSAPApplications.
Locate the _uninst subdirectory. Enter /.uninstall.
28
3 The HP Quality Process for SAP Solutions Uninstall screen opens. 4 Click Next. The Update the Server screen opens.
Yes. Updates the archive files and runs the deployment tool. No. Indicates that you will manually update the archive files later.
Click Next to continue to uninstall, or Cancel to close the Update the Server screen without uninstalling.
29
5 If you selected Yes in the previous step, the Quality Center Archive and Deployment Tool opens.
To uninstall the Enterprise Extension, you need to create a new archive and redeploy the Quality Center and Site Administration war files (qcbin.war and sabin.war) on the application server. This enables changes to the .war files to take effect. Click Next to create the new archive files.
30
6 If your application server is JBoss, proceed to step 7. If your application server is Websphere or WebLogic, the following screen opens.
You must deploy Quality Center manually on the application server after the setup process is complete. The location of the archive files is shown in the screen. The updated archive files are stored in different formats, although the content is the same. The files are stored openly in the 10sabin.war and 20qcbin.war folders, and as closed archives in sabin.war and qcbin.war. To update the archives and undeploy them manually, run the undeploy.bat script (or undeploy.sh for Solaris or Linux) from the <Enterprise Extension installation> directory. When running the batch file, specify the Quality Center installation directory and the location of the Quality Center repository, using the format: undeploy <Quality Center installation directory> <Quality Center repository directory>
31
Note: For more information on manually deploying Quality Center on an application server, see the HP Quality Center Installation Guide.
Click Next and proceed to step 9. 7 If your application server WebSphere or WebLogic, proceed to step 9. If your application server is JBoss, the HP Quality Center Redeployment screen opens.
Yes. To deploy the archive files automatically. No. To manually deploy the archive files later.
32
8 If the Quality Center service is running, the Archive and Deployment Tool automatically attempts to stop the service. If the tool is unable to stop the service, the Service Not Stopped screen opens.
Retry. To try again to stop the JBoss service. Skip JBoss deployment. To cancel the deployment and manually deploy JBoss later.
Click Next. 9 When the deployment is complete, the Completion screen opens. Click Finish to close the Quality Center Archive and Deployment Tool Setup. The HP Quality Process for SAP Solutions Uninstall screen is displayed. 10 Click Next. The Update completed screen opens.
33
It is recommended that you click Yes to delete the remaining uninstall files in the Enterprise Extension directory. Click Next. 12 Click Finish to close the HP Quality Process for SAP Solutions Uninstall screen. The uninstall process is complete for Windows. For Solaris and Linux proceed to the following steps. 13 For Solaris and Linux, ensure that the [drive]:/opt/Mercury/ QualityProcessforSAPApplications folder has been deleted. If it still exists, enter: a cd /opt/mercury b \rm -R QualityProcessforSAPApplications 14 For Solaris and Linux, run the Quality Center Archive and Deployment Tool to create a new archive and redeploy the Quality Center and Site Administration .war files on the application server. When you are prompted to delete all add-in files, select Yes.
34
2
Setting Up the Enterprise Extension
This chapter describes how to enable your Quality Center projects for the Enterprise Extension, and how to set up your SAP application to enable learning flows automatically. The chapter also explains how to customize the Enterprise Extension.
Note: If you are installing the Enterprise Extension over a current installation, you are not required to re-perform the processes described in this chapter.
About Setting Up the Enterprise Extension on page 36 Loading the Enterprise Extension License on page 36 Enabling the Enterprise Extension on page 37 Installing the SAP Application Importer Component on page 39 Configuring the SAP Environment on page 40 Customizing the Enterprise Extension on page 40
35
36
2 Click the Modify button. The License Edit dialog box opens.
3 Click the Load License button and select the Enterprise Extension license file. Alternatively, copy the content of the license file and click Paste License. 4 Click OK. The license is displayed in the list of licenses.
Notes:
You cannot disable an extension for a project after you enable it. When you enable a project for the Enterprise Extension, the Application Model module is also enabled for the project.
37
To enable the Enterprise Extension extension for a project: 1 In Quality Center Site Administration, click the Site Projects tab. 2 In the Projects list, select a project. In the right pane, click the Project Extensions tab. The Extensions list is displayed, listing extensions installed on the Quality Center server.
3 Shift-click and highlight both the Application Model and BPT Enterprise Extension rows. Click the Enable Selected Extensions button and click Yes to confirm. The BPT Enterprise Extension and Application Model extensions are both enabled and a confirmation message displays. Note that enabling the extensions may take some time.
38
Notes:
To install the SAP Application Importer Component, you must have Microsoft .NET Framework 2.0 installed on the client computer. You can download it from the Microsoft Web site (http://www.microsoft.com). To install the SAP Application Importer Component, you must have operating system administrator permissions.
To install the SAP Application Importer Component: 1 From your Quality Center client computer, log in to a project for which the Enterprise Extension is enabled. The SAP Application Importer Component files are downloaded to your client computer. 2 Locate the APM directory in the Quality Center installation directory (by default C:\Program Files\Common Files\Mercury Interactive\Quality Center). 3 Run the SAPAppImporterSetup.exe file located in this folder and follow the installation instructions on your screen.
39
Defining Permissions for Business Process Testing for SAP Applications Customizing User Group Permissions for the Application Model Module Hiding Data in the Application Model Module for a User Group Customizing Project Entities Customizing Module Access
40
41
42
Delete Application Entity Move Application Entity Add Folder Modify Folder Delete Folder Move Folder Add Link to Asset Delete Link from Asset
43
You can filter by the following fields: Code, Entity ID, Entity Name, Is Active, Modified, and Type. For more details on these fields, see the HP Business Process Testing Enterprise Extension Users Guide.
44
You can also select which fields in the Application Model module the user group can see and which should be hidden. You select these fields in the Application Model Data-Hiding Filter dialog box, in the Visible Fields tab.
You can choose to hide the following fields: Description, Folder, Is Active, Modified, and Type. For more details on these fields, see the HP Business Process Testing Enterprise Extension Users Guide.
45
46