Installing DevPartner Java Edition Release 4.1
Technical support is available from our Technical Support Hotline or via our FrontLine Support Web site. Technical Support Hotline: 1-888-686-3427 Frontline Support Web Site: http://frontline.compuware.com 2001, 2004, 2005, 2006 Compuware Corporation. All rights reserved. Unpublished - rights reserved under the Copyright Laws of the United States. U.S. GOVERNMENT RIGHTS Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Compuware Corporation license agreement and as provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii)(OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable. Compuware Corporation. THIS PRODUCT CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF COMPUWARE CORPORATION. USE, DISCLOSURE, OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF COMPUWARE CORPORATION. ACCESS IS LIMITED TO AUTHORIZED USERS. USE OF THIS PRODUCT IS SUBJECT TO THE TERMS AND CONDITIONS OF THE USER S LICENSE AGREEMENT WITH COMPUWARE CORPORATION. US Patent Nos.: 6,186,677, 6,314,558, and 6,016,466 Compuware, DevPartner, and OptimalJ are trademarks or registered trademarks of Compuware Corporation. UNIX is a registered trademark of The Open Group in the U.S. and other countries. Java is a trademark of Sun Microsystems Inc. Acrobat Reader copyright 1987 2006 Adobe Systems Incorporated. All rights reserved. Adobe, Acrobat, and Acrobat Reader are trademarks of Adobe Systems Incorporated. All other company or product names are trademarks of their respective owners. January 20, 2006 CWM6IX4B
Table of Contents Preface What This Manual Covers............................................ vii Conventions Used In This Manual..................................... viii Customer Support.................................................. viii Chapter 1 System Requirements Hardware Requirements............................................... 1 Supported Environments.............................................. 2 Operating Systems................................................ 2 Java Virtual Machines............................................. 3 Application Servers............................................... 4 Integrated Development Environments............................... 6 Web Browsers.................................................... 7 Languages....................................................... 8 Licensing.......................................................... 8 Chapter 2 Installing DevPartner Java Edition on Windows Installing DevPartner Java Edition on Windows........................... 11 Preparing to Install............................................... 11 Performing the Installation........................................ 12 Configuring Application Servers....................................... 13 Integrating DevPartner Java Edition with IDEs............................ 14 Installing the DevPartner Java Edition License............................ 15 Installing the Java Runtime Environment................................ 15 Uninstalling DevPartner Java Edition on Windows........................ 16 iii
Chapter 3 Installing DevPartner Java Edition on Solaris Installing DevPartner Java Edition on Solaris............................. 17 Preparing to Install............................................... 17 Performing the Installation........................................ 17 Configuring Application Servers....................................... 18 Installing the DevPartner Java Edition License............................ 18 Installing the Java Runtime Environment................................ 19 Uninstalling DevPartner Java Edition on Solaris........................... 20 Chapter 4 Installing DevPartner Java Edition on Linux Installing DevPartner Java Edition on Linux.............................. 21 Preparing to Install............................................... 21 Performing the Installation........................................ 21 Configuring Application Servers....................................... 22 Installing the DevPartner Java Edition License............................ 22 Installing the Java 2 Runtime Environment.............................. 23 Uninstalling DevPartner Java Edition on Linux........................... 24 Chapter 5 Installing DevPartner Java Edition on AIX Installing DevPartner Java Edition on AIX............................... 25 Preparing to Install............................................... 25 Performing the Installation........................................ 25 Configuring Application Servers....................................... 26 Installing the DevPartner Java Edition License............................ 26 Uninstalling DevPartner Java Edition on AIX............................. 26 Chapter 6 Installing DevPartner Java Edition on HP-UX Installing DevPartner Java Edition on HP-UX............................. 29 Preparing to Install............................................... 29 Performing the Installation........................................ 29 Configuring Application Servers....................................... 30 Installing the DevPartner Java Edition License............................ 30 Uninstalling DevPartner Java Edition on HP-UX.......................... 31 iv Installing DevPartner Java Edition
Chapter 7 Configuring Application Servers DevPartner Java Edition Administration Console.......................... 33 Creating a Server Configuration....................................... 34 Apache Tomcat................................................. 35 Apache Tomcat as a Windows Service................................ 35 BEA WebLogic 8.1.x and 9.0....................................... 36 BEA WebLogic 8.1.x and 9.0 as a Windows Service..................... 37 IBM WebSphere 5.1.............................................. 37 IBM WebSphere 6.0.............................................. 38 IBM WebSphere as a Windows Service............................... 38 JBoss.......................................................... 39 JBoss as a Windows Service........................................ 39 Oracle Application Server (OC4J Integrated)........................... 40 Oracle OC4J Standalone.......................................... 40 Sun ONE 7.0 as a Windows Service.................................. 41 Sun Java System Application Server Platform Edition 8.0................. 41 Generic Application Server........................................ 41 Generic Application Server as a Windows Service....................... 43 Index................................................................... 45 Table of Contents v
vi Installing DevPartner Java Edition
Preface What This Manual Covers Conventions Used In This Manual Customer Support What This Manual Covers This manual contains the following chapters: Chapter 1, System Requirements Minimum hardware requirements, and supported application servers, Integrated Development Environments (IDEs), Web browsers, and licensing information. Chapter 2, Installing DevPartner Java Edition on Windows. Chapter 3, Installing DevPartner Java Edition on Solaris. Chapter 4, Installing DevPartner Java Edition on Linux. Chapter 5, Installing DevPartner Java Edition on AIX. Chapter 6, Installing DevPartner Java Edition on HP-UX. Chapter 7, Configuring Application Servers. vii
Conventions Used In This Manual This book uses the following conventions to present information. Screen commands and menu names appear in bold typeface. For example: From the Tools menu, choose Item Browser. Computer commands appear in monospace typeface. For example: At the command line, enter dpjadmin. File and path names appear in bold monospace typeface. For example: In Windows, the default product directory is C:\Program Files\Compuware\DevPartner Java Edition. Variables (for which you must supply values appropriate for your installation) within computer commands and file names appear in italic monospace type. For example: Enter http://servername/cgi-win/itemview.dll in the Destination field. Customer Support Customer Support can assist you with all your technical problems, from installation to troubleshooting. Before contacting Customer Support, please read the relevant sections of the product documentation and the Release Notes (ReadMeDPJ.htm). You can contact Customer Support by: E-Mail World Wide Web Telephone Send as many details as possible to nashua.support@compuware.com Submit issues and access our support knowledge base through FrontLine, http://frontline.compuware.com/. Telephone support is available as a paid* Priority Support Service from 8:00 am to 5:00 pm Eastern time, Monday through Friday. Have your product release number ready. In the U.S. and Canada, call: 1-888-686-3427 For telephone support numbers outside the USA, Canada, and Latin America, see Compuware's FrontLine Web site: http://frontline.compuware.com/. * Customer Support handles installation and setup issues free of charge. viii Installing DevPartner Java Edition
Before contacting Customer Support, please obtain the following information: Product name (or edition), release, or service pack System configuration: operating system, network configuration, amount of RAM, environment variables, and paths Name and version of your compiler and linker and the options you used in compiling and linking Problem details: settings, error messages, stack dumps, and the contents of any diagnostic windows If the problem is repeatable, the details of how to create the problem Preface ix
x Installing DevPartner Java Edition
Chapter 1 System Requirements Hardware Requirements Supported Environments Licensing Hardware Requirements Windows DevPartner Java Edition requires the following minimum configuration for Windows systems: Intel Architecture 32-bit Pentium III 500 MHz or equivalent 512 MB total system memory 100 MB of free disk space 800 x 600 graphics resolution Solaris DevPartner Java Edition requires the following minimum configuration for Solaris systems: Sparc Ultra 5 512 MB total system memory 200 MB of free disk space 800 x 600 graphics resolution Linux DevPartner Java Edition requires the following minimum configuration for Linux systems: Intel Architecture 32-bit Pentium III 500 MHz or equivalent 1
512 MB total system memory 200 MB of free disk space 800 x 600 graphics resolution AIX DevPartner Java Edition requires the following minimum configuration for AIX systems: AIX 5.2 (for RS/6000 Power and P Series) 512 MB total system memory 200 MB of free disk space HP-UX DevPartner Java Edition requires the following minimum configuration for HP-UX systems: HP-UX 11i for PA/RISC 512 MB total system memory 200 MB of free disk space Supported Environments Operating Systems The following supported environments are described below: Operating Systems Java Virtual Machines (page 3) Application Servers (page 4) Integrated Development Environments (page 6) Web Browsers (page 7) Languages (page 8) DevPartner Java Edition supports the following operating systems: Microsoft Windows XP Professional Edition, with SP1 or SP2 Microsoft Windows 2000 SP3 or SP4, Professional, Server, and Advanced Server Editions Microsoft Windows 2003 Server (Standard and Enterprise Editions) Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 (AS, ES, and WS Editions) 2 Installing DevPartner Java Edition
Java Virtual Machines AIX 5.2 and 5.3 If you are running AIX 5.2, you must install X11.base.rte Version 5.2.0.1 or later before installing DevPartner Java Edition. For both versions of AIX (5.2 and 5.3), the SDK should be Version 1.3.1.6 or higher. HP-UX Release 11i v1 or 11i v2 The HP-UX 11i v1 Quality Pack (GOLDQPK11i) patch bundle, December 2003. Patch PHSS_30049 is required. All HP-UX 11 patches required by the JVM should be installed. Consult the vendor for the list of required patches. The SDK should be Version 1.3.1.6 or higher. DevPartner Java Edition requires one of the following Java Virtual Machines (JVMs). Table 1-1. Supported Java Virtual Machines These JVMs... HP 1.3.1, 1.4, and 5.0 (32-bit) IBM 1.3.1 (32-bit) IBM 1.4 (32-bit) Sun 1.3.1 (32-bit) Sun 1.4 (32-bit) Run on These Operating Systems HP-UX 11i and 11i v2 Only with IBM WebSphere on these operating systems: Windows 2000, Windows XP, and Windows 2003 Server Red Hat Enterprise Linux 3.0 and 4.0 With all supported application servers: AIX 5.2 and 5.3 Only with IBM WebSphere: Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 3.0 and 4.0 HP-UX 11i Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 Chapter 1 System Requirements 3
Table 1-1. Supported Java Virtual Machines (Continued) These JVMs... Sun 5.0 (32-bit) [See Note 1 below] JRockit 1.4.2_05 (32-bit) Run on These Operating Systems Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 Windows 2000, Windows XP, and Windows 2003 Server Red Hat Enterprise Linux 3.0 and 4.0 1 Because of an issue in Sun's release of Java 5.0, Memory analysis may not work correctly if class data sharing is enabled. The Win32 release of the Sun J2SE 5.0 enables class data sharing by default and it must be explicitly disabled. To disable class data sharing, pass -Xshare:off as a command line parameter to Java. With DevPartner Java Edition, you can also disable class data sharing by creating a global environment variable named NM_VM_OPTIONS and setting it to -Xshare:off. Application Servers DevPartner Java Edition can profile applications running on the following application servers. Table 1-2. Supported Application Servers These Application Servers... Apache Tomcat 5.0 and 5.5 BEA WebLogic Server 8.1.x BEA WebLogic Server 9.0 [See Note 1] Run on These Operating Systems Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 AIX 5.2 and 5.3 HP-UX 11i and 11i v2 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 3.0 and 4.0 AIX 5.2 and 5.3 HP-UX 11i and 11i v2 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 HP-UX 11i and 11i v2 [See Note 2] 4 Installing DevPartner Java Edition
Table 1-2. Supported Application Servers (Continued) These Application Servers... IBM WebSphere 5.1 Standard and Enterprise Editions IBM WebSphere 6.0 Standard Edition IBM WebSphere Portal 5.1 JBoss 3.2 and 4.0 Oracle OC4J Standalone v9.0.4 Oracle Application Server (called OC4J Integrated in DevPartner Java Edition), v9.0.4 Standard, Enterprise, and Java Editions Sun ONE 7.0 (also called Java System Application Server Platform Edition 7.0) Sun Java System Application Server Platform Edition 8.0 Run on These Operating Systems Windows 2000 and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 3.0 and 4.0 AIX 5.2 and 5.3 HP-UX 11i Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 3.0 and 4.0 AIX 5.2 and 5.3 HP-UX 11i Only with IBM Radical Application Developer 6.0: Windows 2000, Windows XP, and Windows 2003 Server Windows 2000, Windows XP, and Windows 2003 Server Red Hat Enterprise Linux 3.0 and 4.0 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 4.0 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 Red Hat Enterprise Linux 3.0 and 4.0 Windows 2000 and Windows XP Solaris 9 Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 1 You must use Sun JDK with WebLogic 9.0. WebLogic uses JRockit 5.0 by default, but because of a JRockit bug, Memory analysis cannot be performed on applications running under this JVM. On Windows 2000, Weblogic 9.0 requires 2 For HP-UX 11i v2, you must use WebLogic 9.1. Chapter 1 System Requirements 5
Integrated Development Environments DevPartner Java Edition can be used with the following Integrated Development Environments (IDEs). IDE integration is supported only on Windows platforms. Table 1-3. Supported Integrated Development Environments These IDEs... Borland JBuilder X, Enterprise, Enterprise Studio, Foundation, and Developer Editions Borland JBuilder 2005, Enterprise, Enterprise Studio, Foundation, and Developer Editions Compuware OptimalJ 3.3.01 (Architecture, Professional, and Developer Editions) Compuware OptimalJ 4.0 (Architecture, Professional, and Developer Editions) Eclipse 3.0 On These Application Servers BEA WebLogic 8.1.x Apache Tomcat 5.0 BEA WebLogic 8.1.x JBoss 3.2 and 4.0 BEA WebLogic 8.1.x IBM WebSphere Application Server 5.1 JBoss 4.0 BEA WebLogic 8.1.x IBM WebSphere Application Server 6.0 (integrated) BEA WebLogic 8.1.x JBoss 3.2 Eclipse 3.1 BEA WebLogic 8.1.x and 9.0 JBoss 3.2 and 4.0 IBM Rational Application Developer 6.0 IBM WebSphere Application Server - Express 5.1 IBM WebSphere Studio Application Developer 5.1 Apache Tomcat 5.0 IBM WebSphere Application Server 5.1 and 6.0 (integrated) IBM WebSphere Portal 5.1 - Test Environment IBM WebSphere Application Server - Express 5.1 IBM WebSphere Application Server 5.1 (integrated) Oracle JDeveloper 9.0.4 Oracle OC4J Standalone 9.0.4 Oracle Application Server 9.0.4 (called OC4J Integrated in DevPartner Java Edition) 6 Installing DevPartner Java Edition
Table 1-3. Supported Integrated Development Environments (Continued) These IDEs... On These Application Servers Oracle JDeveloper 9.0.5 Oracle OC4J Standalone 9.0.4 Oracle Application Server 9.0.4 (called OC4J Integrated in DevPartner Java Edition) Web Browsers The user interface for DevPartner Java Edition requires one of the following Web browsers: Internet Explorer Version 6 with or without SP1 Mozilla 1.7 Netscape 7.1 Required: If the browser includes a popup blocker, configure it to disable blocking for the DevPartner Java Edition window. If the popup blocker is enabled, DevPartner Java Edition will not operate correctly. The Web-based user interface is only supported on the following operating systems: Windows 2000, Windows XP, and Windows 2003 Server Solaris 9 and 10 Red Hat Enterprise Linux 3.0 and 4.0 DevPartner Java Edition requires one of the following Sun JRE plug-ins for your Web browser: 1.3.1 1.4.0 1.4.1 1.4.2 5.0 Note: When you upgrade DevPartner Java Edition, you should clean out the Java plug-in's cache. If the cache contains applets from a previous release, the browser-based UI may not be displayed correctly. You may also be able to disable the plug-in's option to cache applets. See the documentation for your plug-in for further information. Chapter 1 System Requirements 7
Languages This release of DevPartner Java Edition only has localization support for English (United States en-us). Licensing The following license types are available for DevPartner Java Edition. Table 1-4. License Types License Type User Server Description DevPartner Java Edition has two types of user licenses: Single-seat The DevPartner Java Edition Web server, control service, and browser must be on one machine. Single-seat licensing requires a license file for each installation. This license type is not supported on AIX and HP-UX. Concurrent Any users, up to the maximum specified by the license, can launch DevPartner Java Edition, create or view session files; and create or use configuration files on a single local machine. To access a remote DevPartner Java Edition server, a server license must be installed on that remote machine. A server license enables a user with remote access (through a browser) to the DevPartner Java Edition server machine to create or view session files, and to create or use configuration files on the DevPartner Java Edition server. DevPartner Java Edition has two types of server licenses: Node-locked The license is installed on a specific DevPartner Java Edition server machine, and can be used only with that machine. Concurrent The license is installed on the license server. Any user can connect with any DevPartner Java Edition server, up to the maximum number of connections specified in the license. When a user accesses a DevPartner Java Edition server, a license is checked out until that connection is ended. After the license is freed by ending the server connection, it can be used with any other DevPartner Java Edition server. DevPartner Java Edition is installed with a 14-day evaluation license. To use the program beyond the evaluation period, you must obtain a permanent license. A license file, license.xml, is provided by Compuware License Management for each license that you purchase. 8 Installing DevPartner Java Edition
Your license file(s) will arrive by e-mail around the time that your installation kit arrives, and is delivered to the person you designated when you placed your order. Note: If you purchased DevPartner Java Edition from a reseller, request a license file by calling Compuware Worldwide License Management at 1-800-538-7822. You can also register over the Web at http://www.compuware.com/license. If your license file has not arrived by the time you want to install DevPartner Java Edition, contact Worldwide License Management at 1-800-538-7822. Outside the USA and Canada, contact your local Compuware office or agent. If you already have a licensed Compuware product and want to merge the license files, contact Technical Support at 1-888-686-3427 for assistance. For information about installing and using Compuware licenses, refer to the Distributed License Management License Installation Guide. This document is available on the installation CD as CPWR_License_Install.pdf. Chapter 1 System Requirements 9
10 Installing DevPartner Java Edition
Chapter 2 Installing DevPartner Java Edition on Windows Installing DevPartner Java Edition on Windows Configuring Application Servers Integrating DevPartner Java Edition with IDEs Installing the DevPartner Java Edition License Installing the Java Runtime Environment Uninstalling DevPartner Java Edition on Windows Installing DevPartner Java Edition on Windows Preparing to Install If you have a previous release of DevPartner Java Edition, uninstall the previous release and restart your machine before beginning installation. For more information, see Uninstalling DevPartner Java Edition on Windows on page 16. Configurations and session files created in a previous release cannot be used with this release. After you uninstall, delete the folders and files remaining inside the \DevPartner Java Edition directory. You will need to restart the computer after installing DevPartner Java Edition. 11
Performing the Installation 12 Installing DevPartner Java Edition Use the following procedure to install DevPartner Java Edition on Windows: 1 Insert the DevPartner Java Edition CD to start the installation wizard. The Setup screen appears automatically. From this screen, you can perform the following optional tasks in addition to installing DevPartner Java Edition Java Edition: Display or print the DevPartner Java Edition Installation Guide. Install the Java 2 runtime environment. You must have Java 2 runtime environment V1.31_02 or higher on your system. For details, see Installing the Java Runtime Environment on page 15. Note: The installation file for the Windows edition of DevPartner Java Edition is named DPJW.exe. 2 On the Setup screen, click Install Compuware DevPartner. The Welcome screen appears. 3 Click Next. The License Agreement appears. 4 Read and accept the License Agreement, then click Next. The Customer Information screen appears. 5 Enter your name and company information and click Next. The Destination Folder screen appears. The default path for installing DevPartner Java Edition is displayed in the Destination Folder screen. If you want to install the product in a different location, click Change and browse to the desired location. 6 Click Next. The Post-Install Setup screen appears. This screen provides three options for configuring DevPartner Java Edition as part of the installation process. If you do not need any of the options, or if you prefer to perform the tasks after installation is complete, clear the selections as desired. 7 Click Next. The Ready to Install the Program screen appears. 8 Review your installation settings; use Back to return to a previous screen and change a setting if necessary. When you have confirmed that your selections are correct, click Install. A progress meter on the Installing Compuware DevPartner Java Edition screen shows the progress of the installation. Note: During the installation, certain portions of the process continue without advancing the progress bar on the installation wizard. If you think the install is not responding, check the Windows Task Manager before stopping the installation.
9 When installation is completed, the InstallShield Wizard Completed screen appears. Click Finish. If you selected Integrate DevPartner Java Edition with your IDE option, you must integrate at least one IDE with DevPartner Java Edition. 1 When the DevPartner Java Edition IDE Addin Installation screen appears, select an IDE from the list, then click Continue. 2 In the next screen, enter the path of the IDE installation (root directory) in the field; or browse to find the directory. Click Install. 3 Select another IDE and repeat step 1 2; or click Exit. For more details, see Integrating DevPartner Java Edition with IDEs on page 14. If you selected the Set up application servers for analysis option, set up one or more application servers to be analyzed by DevPartner Java Edition (see the instructions for your application server in Chapter 7, Configuring Application Servers ). If you cleared this option, the installation process skips this step. You can configure an application server at any time after installation is completed. To skip setting up application servers and continue the installation process, click Cancel. If you are prompted to make the changes effective, click Yes. Compuware DevPartner Java Edition opens in your default browser when your system restarts. Configuring Application Servers After completing installation, you can configure application servers for use with DevPartner Java Edition. You must perform this task in order to use the features in the Application Server Testing tab of the Start page. For instructions, see Chapter 7, Configuring Application Servers. Chapter 2 Installing DevPartner Java Edition on Windows 13
Integrating DevPartner Java Edition with IDEs After installing DevPartner Java Edition, you can integrate it with an IDE so you can use DevPartner Java Edition features from within the IDE interface. Use the Java IDE Add-in Manager for this task. 1 Select Start>Programs>Compuware DevPartner Java Edition>Utilities>Java IDE Add-in Manager. The IDE Addin Installation screen appears. 2 From the list, select the appropriate IDE. Table 2-1 lists the supported IDEs. Table 2-1. Entries for IDEs in the IDE Add-in Installation Screen IDE Borland JBuilder X or 2005 Compuware OptimalJ 3.3.01 and 4.0 Eclipse 2.1.3 Eclipse 3.0 IBM Rational Application Developer 6.0 IBM WebSphere Application Developer v5.1 Basic Edition IBM WebSphere Application Server 5.0 and 5.1 - Express Oracle JDeveloper v9.0.4 Oracle JDeveloper v9.0.5 Entry in IDE Installation List Borland JBuilder Compuware OptimalJ Eclipse 2.1.3 Eclipse 3.0 IBM RAD v6.0 IBM WSAD v5.1 IBM WAS Express Oracle9i JDeveloper v9.0.4 Oracle10G JDeveloper v9.0.5 3 Click Continue. 4 Enter the path of the IDE installation (root directory) in the field, or click the browse button to find the directory. 5 Click Install. 6 If you have no other IDEs to configure, click Exit to close the utility. Otherwise, repeat step 2 5 as needed. 14 Installing DevPartner Java Edition
Installing the DevPartner Java Edition License When you install DevPartner Java Edition, an evaluation license is automatically installed. This license is only valid for 14 days. To install a single-seat, concurrent, or server license, refer to the Distributed License Management License Installation Guide: Chapter 3, License Installation and Configuration for Windows. This document is installed as LicInst4.pdf in C:\Program Files\Common Files\Compuware; it is also available on the installation CD as CPWR_License_Install.pdf. After upgrading to a server license, you must stop and restart the NCSP process: 1 In the Windows Control Panel, double-click Administrative Tools. 2 In the Administrative Tools window, double-click Services. 3 In the Services window, right-click Compuware DevPartner Java Edition Control Service and select Stop. 4 Right-click Compuware DevPartner Java Edition Control Service again and select Start. Installing the Java Runtime Environment DevPartner Java Edition requires Java runtime environment V1.3.1_02 or higher to be installed on your machine. To install the Java 2 runtime environment from the DevPartner Java Edition CD: 1 Insert the DevPartner Java Edition CD to start the installation wizard. The Setup screen appears automatically. 2 Click Java 2 Runtime Environment. An Extracting Files screen appears while files are extracted from the setup file. 3 On the Welcome to the InstallShield Wizard for Java 2 Runtime Environment, SE v1.4.0 screen, click Next. 4 Read and accept the License Agreement. Click Next. 5 Accept the default on the Choose Destination Location screen, or browse for a directory into which to install the Java 2 Runtime Environment; then click Next. 6 Select the browser that will have the Java 2 runtime environment as its default runtime. Click Next. Chapter 2 Installing DevPartner Java Edition on Windows 15
7 The Setup Status screen displays the progress of the installation. The installation procedure displays a confirmation message when the installation successfully completes. Uninstalling DevPartner Java Edition on Windows To remove DevPartner Java Edition from your machine: 1 From the Windows Control Panel, open Add/Remove Programs. 2 Select Compuware DevPartner Java Edition. 3 Click Remove. When you are prompted to confirm, click Yes. 4 Restart your computer if prompted. When you uninstall DevPartner Java Edition, session files and configuration information stored in the \var subdirectory of the product directory are not deleted. If you are reinstalling the same release of DevPartner Java Edition, your configurations and session files will be available in the new installation. If you do not need these files, you can delete this folder. Note: Configurations and session files from a previous release cannot be used with this release. 16 Installing DevPartner Java Edition
Chapter 3 Installing DevPartner Java Edition on Solaris Installing DevPartner Java Edition on Solaris Configuring Application Servers Installing the DevPartner Java Edition License Installing the Java Runtime Environment Uninstalling DevPartner Java Edition on Solaris Installing DevPartner Java Edition on Solaris Preparing to Install To install DevPartner Java Edition and to configure an application server using the dpjadmin utility, you must first install a GUI that is based on the X Window System and is compatible with Java Swing. If you have a previous release of DevPartner Java Edition, uninstall the previous release before beginning installation. For more information, see Uninstalling DevPartner Java Edition on Solaris on page 20. Configurations and session files created in a previous release cannot be used with this release. After you uninstall the previous release, delete the folders and files remaining inside the /DPJ directory. Performing the Installation Use the following procedure to install DevPartner Java Edition on Solaris: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/setup, where dir is the directory where the CD is mounted. 2 From the command line, run DPJS.BIN. 17
3 On the Introduction screen, click Next. 4 Read and accept the License Agreement. Click Next. 5 On the Picking a Browser screen, select YES to specify a browser during installation or NO to skip specifying a browser. If you specify a browser, you can use the DevPartner Java Edition user interface locally. Click Next. 6 If you selected YES in the previous step, enter the path or browse to find the path to your browser on the Choose Your Browser screen. Click Next. If you selected NO in the previous step, this screen does not appear. Caution: If you do not specify a browser through the installation wizard, you can create the nmdefaultbrowser script to launch a supported browser when you start DevPartner Java Edition. The script must contain arguments as in the following example (which specifies Netscape as the browser): #!/bin/sh exec /usr/local/netscape/netscape $* 7 On the Ready to Install screen, verify the installation settings and click Install. A progress meter shows the progress of the installation. 8 On the Install Completed Successfully screen, click Done. DevPartner Java Edition has been installed in /opt/compuware/dpj. The DevPartner Java Edition user interface appears. Configuring Application Servers After completing installation, you can configure application servers for use with DevPartner Java Edition. You must perform this task in order to use the features in the Application Server Testing tab of the Start page. For instructions, see Chapter 7, Configuring Application Servers. Installing the DevPartner Java Edition License When you install DevPartner Java Edition, an evaluation license is automatically installed. This license is only valid for 14 days. 18 Installing DevPartner Java Edition
To install a single-seat, concurrent, or server license, refer to Chapter 4, License Installation and Configuration for UNIX, of the Distributed License Management License Installation Guide. This document, CPWR_License_Install.pdf, is available on the DevPartner Java Edition installation CD. Installing the Java Runtime Environment DevPartner Java Edition requires that Java runtime environment V1.3.1_02 or higher be installed on your machine. If you do not have it, you must install it. You can install the Java 2 runtime environment from the DevPartner Java Edition CD. Use the following procedure to install the Java 2 runtime environment on your machine: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/jre, where dir is the directory where the CD is mounted. 2 Copy j2re-1_4_1_03-solaris-sparc.sh to your local system. Caution: Do not run the executable from the CD. If you try to run the executable from the CD, errors occur and a message informs you that the file could not be extracted or installed. 3 To install the Java 2 runtime environment, run the following from the command line: j2re-1_4_1_03-solaris-sparc.sh 4 Read and accept the License Agreement. Click Next. 5 Accept the default on the Choose Destination Location screen, or browse for a directory into which to install the Java 2 Runtime Environment; then click Next. 6 Select the browser that will have the Java 2 runtime environment as its default runtime. Click Next. 7 The Setup Status screen displays the progress of the installation. When the installation successfully completes, the installation procedure displays a confirmation message. Chapter 3 Installing DevPartner Java Edition on Solaris 19
Uninstalling DevPartner Java Edition on Solaris Use the following procedure to remove DevPartner Java Edition from your machine: 1 Set your directory to /opt/compuware/dpj/bin. 2 At the command line, enter./uninstalldpj 3 When you are prompted to confirm, enter YES. 4 The system displays the message Uninstallation Complete when DevPartner Java Edition has been removed from your machine. When you uninstall DevPartner Java Edition, session files and configuration information stored in the var/opt/compuware/dpj subdirectory of the product directory are not deleted. If you are reinstalling the same release of DevPartner Java Edition, your configurations and session files will be available in the new installation. If you do not need these files, you can delete this folder. Note: Configurations and session files from a previous release cannot be used with this release. 20 Installing DevPartner Java Edition
Chapter 4 Installing DevPartner Java Edition on Linux Installing DevPartner Java Edition on Linux Configuring Application Servers Installing the DevPartner Java Edition License Installing the Java 2 Runtime Environment Uninstalling DevPartner Java Edition on Linux Installing DevPartner Java Edition on Linux Preparing to Install To install DevPartner Java Edition and to configure an application server using the dpjadmin utility, you must first install a GUI that is based on the X Window System and is compatible with Java Swing. If you have a previous release of DevPartner Java Edition, uninstall the previous release before beginning installation. For more information, see Uninstalling DevPartner Java Edition on Linux on page 24. Configurations and session files created in a previous release cannot be used with this release. After you uninstall the previous release, delete the folders and files remaining inside the /DPJ directory. Performing the Installation Use the following procedure to install DevPartner Java Edition on Linux: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/setup, where dir is the directory where the CD is mounted. 2 From the command line, run DPJL.BIN. 21
3 On the Introduction screen, click Next. 4 Read and accept the License Agreement. Click Next. 5 On the Picking a Browser screen, select YES to specify a browser during installation or NO to skip specifying a browser. If you specify a browser, you can use the DevPartner Java Edition user interface locally. Click Next. 6 If you selected YES in the previous step, enter the path or browse to find the path to your browser on the Choose Your Browser screen. Click Next. If you selected NO in the previous step, this screen does not appear. Caution: If you do not specify a browser through the installation wizard, you can create the nmdefaultbrowser script to launch a supported browser when you start DevPartner Java Edition. The script must contain arguments as in the following example (which specifies Netscape as the browser): #!/bin/sh exec /usr/local/netscape/netscape $* 7 On the Ready to Install screen, verify the installation settings and click Install. A progress meter shows the progress of the installation. 8 On the Install Completed Successfully screen, click Done. DevPartner Java Edition has been installed in /opt/compuware/dpj. The DevPartner Java Edition user interface appears. Configuring Application Servers After completing installation, you can configure application servers for use with DevPartner Java Edition. You must perform this task in order to use the features in the Application Server Testing tab of the Start page. For instructions, see Chapter 7, Configuring Application Servers. Installing the DevPartner Java Edition License When you install DevPartner Java Edition, an evaluation license is automatically installed. This license is only valid for 14 days. 22 Installing DevPartner Java Edition
To install a single-seat, concurrent, or server license, refer to Chapter 4, License Installation and Configuration for UNIX, of the Distributed License Management License Installation Guide. This document, CPWR_License_Install.pdf, is available on the DevPartner Java Edition installation CD. Installing the Java 2 Runtime Environment DevPartner Java Edition requires that Java runtime environment V1.3.1_02 or higher be installed on your machine. If you do not have it, you must install it. You can install the Java 2 runtime environment from the DevPartner Java Edition CD. Use the following procedure to install the Java 2 runtime environment on your machine: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/jre, where dir is the directory where the CD is mounted. 2 Copy j2re-1_4_1_03-linux-i586.bin to your local system. Caution: Do not run the executable from the CD. If you try to run the executable from the CD, errors occur and a message informs you that the file could not be extracted or installed. 3 To install the Java 2 runtime environment, run the following from the command line: j2re-1_4_1_03-linux-i586.bin 4 Read and accept the License Agreement. Click Next. 5 Accept the default on the Choose Destination Location screen, or browse for a directory into which to install the Java 2 Runtime Environment; then click Next. 6 Select the browser that will have the Java 2 runtime environment as its default runtime. Click Next. 7 The Setup Status screen displays the progress of the installation. When the installation successfully completes, the installation procedure displays a confirmation message. Chapter 4 Installing DevPartner Java Edition on Linux 23
Uninstalling DevPartner Java Edition on Linux Use the following procedure to remove DevPartner Java Edition from your machine: 1 Set your directory to /opt/compuware/dpj/bin. 2 At the command line, enter./uninstalldpj 3 When you are prompted to confirm, enter YES. 4 The system displays the message Uninstallation Complete when DevPartner Java Edition has been removed from your machine. When you uninstall DevPartner Java Edition, session files and configuration information stored in the var/opt/compuware/dpj subdirectory of the product directory are not deleted. If you are reinstalling the same release of DevPartner Java Edition, your configurations and session files will be available in the new installation. If you do not need these files, you can delete this folder after restarting your computer. Note: Configurations and session files from a previous release cannot be used with this release. 24 Installing DevPartner Java Edition
Chapter 5 Installing DevPartner Java Edition on AIX Installing DevPartner Java Edition on AIX Configuring Application Servers Installing the DevPartner Java Edition License Uninstalling DevPartner Java Edition on AIX Installing DevPartner Java Edition on AIX Preparing to Install To install DevPartner Java Edition and to configure an application server using the dpjadmin utility, you must first install a GUI that is based on the X Window System and is compatible with Java Swing. If you have a previous release of DevPartner Java Edition, uninstall the previous release before beginning installation. For details, see Uninstalling DevPartner Java Edition on AIX on page 26. Configurations and session files created in a previous release cannot be used with this release. After you uninstall the previous release, delete the folders and files remaining inside the /DPJ directory. Performing the Installation Use the following procedure to install DevPartner Java Edition on an AIX server: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/setup, where dir is the directory where the CD is mounted. 2 From the command line, run DPJA.BIN. 25
3 On the Introduction screen, click Next. 4 Read and accept the License Agreement. Click Next. 5 On the Ready to Install screen, verify the installation settings and click Install. A progress meter shows the progress of the installation. 6 On the Install Completed Successfully screen, click Done. DevPartner Java Edition has been installed in /opt/compuware/dpj. The DevPartner Java Edition user interface appears. Note: After DevPartner Java Edition has been installed, run the DevPartner Java Edition browser (DPJserver:21578/ui) on one of the other supported platforms. You cannot run the browser on AIX. Configuring Application Servers After completing installation, you can configure application servers for use with DevPartner Java Edition. You must perform this task in order to use the features in the Application Server Testing tab of the Start page. For instructions, see Chapter 7, Configuring Application Servers. Installing the DevPartner Java Edition License When you install DevPartner Java Edition, an evaluation license is automatically installed. This license is only valid for 14 days. To install a concurrent or server license, refer to Chapter 4, License Installation and Configuration for UNIX, of the Distributed License Management License Installation Guide. This document, CPWR_License_Install.pdf, is available on the DevPartner Java Edition installation CD. Note: Single-seat licenses are not supported on AIX. Uninstalling DevPartner Java Edition on AIX 26 Installing DevPartner Java Edition Use the following procedure to remove DevPartner Java Edition from your machine: 1 Set your directory to /opt/compuware/dpj/bin. 2 At the command line, enter./uninstalldpj 3 When you are prompted to confirm, enter YES.
4 The system displays the message Uninstallation Complete when DevPartner Java Edition has been removed from your machine. When you uninstall DevPartner Java Edition, session files and configuration information stored in the var/opt/compuware/dpj subdirectory of the product directory are not deleted. If you are reinstalling the same release of DevPartner Java Edition, your configurations and session files will be available in the new installation. If you do not need these files, you can delete this folder after restarting your computer. Note: Configurations and session files from a previous release cannot be used with this release. Chapter 5 Installing DevPartner Java Edition on AIX 27
28 Installing DevPartner Java Edition
Chapter 6 Installing DevPartner Java Edition on HP-UX Installing DevPartner Java Edition on HP-UX Configuring Application Servers Installing the DevPartner Java Edition License Uninstalling DevPartner Java Edition on HP-UX Installing DevPartner Java Edition on HP-UX Preparing to Install To install DevPartner Java Edition and to configure an application server using the dpjadmin utility, you must first install a GUI that is based on the X Window System and is compatible with Java Swing. If you have a previous release of DevPartner Java Edition, uninstall the previous release before beginning installation. For details, see Uninstalling DevPartner Java Edition on HP-UX on page 31. Configurations and session files created in a previous release cannot be used with this release. After you uninstall the previous release, delete the folders and files remaining inside the /DPJ directory. Performing the Installation Use the following procedure to install DevPartner Java Edition on an HP-UX server: 1 Mount the DevPartner Java Edition CD and change to the subdirectory dir/setup, where dir is the directory where the CD is mounted. 2 From the command line, run DPJH.BIN. 29
3 On the Introduction screen, click Next. 4 Read and accept the License Agreement. Click Next. 5 On the Ready to Install screen, verify the installation settings and click Install. A progress meter shows the progress of the installation. 6 On the Install Completed Successfully screen, click Done. DevPartner Java Edition has been installed in /opt/compuware/dpj. The DevPartner Java Edition user interface appears. Note: After DevPartner Java Edition has been installed, run the DevPartner Java Edition browser on one of the other supported platforms. You cannot run the browser on HP-UX. Configuring Application Servers After completing installation, you can configure application servers for use with DevPartner Java Edition. You must perform this task in order to use the features in the Application Server Testing tab of the Start page. For instructions, see Chapter 7, Configuring Application Servers. Installing the DevPartner Java Edition License When you install DevPartner Java Edition, an evaluation license is automatically installed. This license is only valid for 14 days. To install a concurrent or server license, refer to Chapter 4, License Installation and Configuration for UNIX, of the Distributed License Management License Installation Guide. This document, CPWR_License_Install.pdf, is available on the DevPartner Java Edition installation CD. Note: Single-seat licenses are not supported on HP-UX. Running the Compuware License Manager on HP-UX is also not supported. To use a concurrent license for HP-UX, you must install and run the Compuware License Manager on one of the other supported platforms for DevPartner Java Edition. 30 Installing DevPartner Java Edition
Uninstalling DevPartner Java Edition on HP-UX Use the following procedure to remove DevPartner Java Edition from your machine: 1 Set your directory to /opt/compuware/dpj/bin. 2 At the command line, enter./uninstalldpj 3 When you are prompted to confirm, enter YES. 4 The system displays the message Uninstallation Complete when DevPartner Java Edition has been removed from your machine. When you uninstall DevPartner Java Edition, session files and configuration information stored in the var/opt/compuware/dpj subdirectory of the product directory are not deleted. If you are reinstalling the same release of DevPartner Java Edition, your configurations and session files will be available in the new installation. If you do not need these files, you can delete this folder after restarting your computer. Note: Configurations and session files from a previous release cannot be used with this release. Chapter 6 Installing DevPartner Java Edition on HP-UX 31
32 Installing DevPartner Java Edition
Chapter 7 Configuring Application Servers DevPartner Java Edition Administration Console Creating a Server Configuration DevPartner Java Edition Administration Console To profile applications running through an application server, you must have a DevPartner Java Edition configuration for the server. To determine whether your application server is supported, see Table 1-2 in Chapter 1, System Requirements. If your application server is not listed, you can configure it as a generic application server. Note, however, that support is not guaranteed for a server that is not included in the list. Use the DevPartner Java Edition Administration Console to create server configurations. You can also use this utility to modify configurations (although you cannot change the name of an existing configuration) and delete them. When you open the Administration Console, it automatically detects the application server(s) installed on the same machine as DevPartner Java Edition and creates the configuration(s). (If more than one instance of an application server is installed, a configuration is created only for the most recent instance.) To save these default configurations, click OK. To create additional configurations, use the procedures described in the next topic. 33