JProbe Install PDF

JProbe
Installation Guide
9.0
Copyright
2011 Quest Software, Inc.
ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in
this guide is furnished under a software license or nondisclosure agreement. This software
may be used or copied only in accordance with the terms of the applicable agreement. No
part of this guide may be reproduced or transmitted in any form or by any means, electronic
or mechanical, including photocopying and recording for any purpose other than the
purchasers personal use without the written permission of Quest Software, Inc.
The information in this document is provided in connection with Quest products. No
license, express or implied, by estoppel or otherwise, to any intellectual property right is
granted by this document or in connection with the sale of Quest products. EXCEPT AS
SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE
AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY
WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY
WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR
ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL
DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF
PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF
THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations
or warranties with respect to the accuracy or completeness of the contents of this document
and reserves the right to make changes to specifications and product descriptions at any
time without notice. Quest does not make any commitment to update the information
contained in this document.
If you have any questions regarding your potential use of this material, contact:
Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
email: [email protected]
Refer to our Web site (www.quest.com) for regional and international office information.
Trademarks
Quest, Quest Software, the Quest Software logo, JProbe are trademarks and registered
trademarks of Quest Software, Inc in the United States of America and other countries. For a
complete list of Quest Softwares trademarks, please see
http://www.quest.com/legal/trademarks.aspx. Other trademarks and registered trademarks are
property of their respective owners.
Table of Contents
Copyright
Table of Contents
Introduction to This Guide
About JProbe
About This Guide
Text Conventions
About Quest Software, Inc.
Contacting Quest Software
Contacting Quest Support
Quest Communities
Supported Platforms
Microsoft Windows
System Requirements
Supported JVMs
Validated Application Servers
Sun Solaris
10
System Requirements
10
Supported JVMs
11
11
Linux IA-32
12
System Requirements
12
Red Hat Enterprise Linux
12
CentOS 5.x
14
Linux Intel64/ EM64T/ AMD64
15
System Requirements
15
Supported JVMs
15
16
Support for JProbe and JVMs
17
Support for JProbe
17
Support for JVMs
17
Installing JProbe
19
Before You Begin
19
Where to Install JProbe
19
Installing JProbe Using the GUI Installer
20
Installing JProbe in Eclipse
21
Licensing JProbe
JProbe License Options
22
22
Required License Version
22
Node Locked Licensing
22
Concurrent Licensing
22
Requesting Node Locked Licenses
23
Requesting a License During Installation or from Within JProbe
23
Requesting a License via SupportLink
24
Registering Node Locked Licenses
25
Registering a License During Installation or from Within JProbe
25
Registering Licenses from the Command Line
27
Using Concurrent Licenses
28
Setting the License Server During Installation or from Within JProbe
29
Setting the License Server from the Command Line
30
Index
31
1
Introduction to This Guide
This chapter provides information about what is contained in the JProbe Installation Guide. It
also provides information about the JProbe documentation suite and Quest Software.
This chapter contains the following sections:
About JProbe (page 5)
About This Guide (page 5)
See " Documentation Suite"
Text Conventions (page 6)
About Quest Software, Inc. (page 6)
About JProbe
JProbe is an enterprise-class Java profiler that provides intelligent diagnostics on memory
usage, performance, and test coverage. It allows developers to quickly pinpoint and repair the
root cause of application code performance and stability problems that obstruct component
and integration integrity.
JProbe provides three types of analysis:
l
Memory analysisallows a developer to identify and resolve Java memory leaks and
object cycling, to ensure optimal program efficiency and stability.
Performance analysisallows a developer to identify and resolve Java bottlenecks

and deadlocks, to ensure optimal program performance and scalability.
Coverage analysisallows a developer to identify un-executed lines of code during

unit testing, to ensure test coverage and program correctness.
JProbe also offers an Eclipse plugin that provides intelligent code performance analysis and
problem resolution from within the Eclipse Java IDE.
About This Guide

The JProbe Installation Guide provides information about installing and licensing JProbe.
This document is intended for Java developers who want to verify system requirements,
install, and license JProbe.
JProbe 9.0 Installation Guide

Text Conventions
Text Conventions
The following table summarizes how text styles are used in this guide:
Convention
Description
Monospace text represents code, code objects, and commandline input. This includes:
Code
Java language source code and examples of file contents

Classes, objects, methods, properties, constants, and events
Variables
Interface
Files, components,
and documents
HTML documents, tags, and attributes

Monospace-plus-italic text represents variable code or
command-line objects that are replaced by an actual value or
parameter.
Bold text is used for interface options that you select (such as
menu items) as well as keyboard commands.
Italic text is used to highlight the following items:
Pathnames, file names, and programs
The names of other documents referenced in this guide

Now more than ever, organizations need to work smart and improve efficiency. Quest
Software creates and supports smart systems management productshelping our customers
solve everyday IT challenges faster and easier. Visit www.quest.com for more information.
Contacting Quest Software

Email
Mail
Web site
[email protected]
Quest Software, Inc.
World Headquarters
5 Polaris Way
Aliso Viejo, CA 92656
USA
www.quest.com
Refer to our web site for regional and international office information.
Contacting Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who
have purchased a commercial version and have a valid maintenance contract. Quest Support
provides around the clock coverage with SupportLink, our web self-service. Visit
SupportLink at: http://support.quest.com.
From SupportLink, you can do the following:

Quickly find thousands of solutions (Knowledgebase articles/documents).
Download patches and upgrades.
Seek help from a Support engineer.
Log and update your case, and check its status.
View the Global Support Guide for a detailed explanation of support programs, online
services, contact information, and policy and procedures. The guide is available at:
http://support.quest.com/pdfs/Global Support Guide.pdf.
Quest Communities
Get the latest product information, find helpful resources, and join a discussion with the
JProbe Quest team and other community members. Join the JProbe community at:
http://jprobe.inside.quest.com/.
2
Supported Platforms
This chapter section lists all the hardware and software required for installing JProbe, by
operating system. It also contains important notes that are critical to successfully running
JProbe within your development environment.
This chapter section contains the following sections topics:
Microsoft Windows (page 8)
Sun Solaris (page 10)
Linux IA-32 (page 12)
Linux Intel64/ EM64T/ AMD64 (page 15)
Support for JProbe and JVMs (page 17)
Updates to the lists of supported JVMs and application servers are available at:
www.quest.com/jprobe/release_information.aspx.
Microsoft Windows
This section presents the pre-requisites for installing JProbe on MS Windows IA-32 and MS
Windows Intel64/ EM64T/ AMD64 platforms.
System Requirements
The minimum system requirements are:
One of the following OS systems:
Microsoft Windows XP Professional SP2 or later
Microsoft Windows Server 2003 SP2 or later
Microsoft Windows Server 2008 R2 (64 bit)
Microsoft Windows Server 2008
Microsoft Windows Vista
Microsoft Windows 7
Intel Pentium IV @2.4GHz
2GB RAM
500MB free disk space

Microsoft Windows
Supported JVMs
The following development kits contain a supported JVM:
JRockit 5.0
JRockit 6.0
IBM 32-bit SDK, Java 2 Technology Edition, Version 1.4.2, SR1 or later
IBM JVMs are only supported for use with IBM WebSphere Application Server.
IBM JDK 1.4.2 is not fully supported with Memory due to severe problems with the
heap dump provided by the JVM profiling interface (JVMPI). Workaround: Import an
IBM heap dump.
IBM 32-bit SDK, Java 2 Technology Edition, Version 1.5
IBM 32-bit SDK, Version 1.6.0
Sun Java 2 SDK, Standard Edition, 1.4.2
Sun J2SE Development Kit 5.0
Sun Java Platform, Standard Edition 6
Oracle Java SE 7

At time of release, the following application servers are tested and supported:
Apache Geronimo 2.0.1 and 2.1.x
Apache Tomcat 5.5, 6.0 and 7.0
BEA WebLogic Server 8.1, 9.2, and 10.0
Microsoft Windows Server 2008 supports only the BEA WebLogic Server 10.0 MP1 or later.
The JRockit R26.4 JVM which comes by default with the WebLogic 10.0 pre MP1 has some
known issues. The WebLogic 10.0 MP1 requires a JRockit R27.3.1 or later.
BEA WebLogic Server Portal Server 9.2
IBM WebSphere Application Server Community Edition 2.0 and 2.1
IBM WebSphere Portal Server 6.1
IBM WebSphere Application Server 6.0.1+, 6.1, and 7.0
On Windows XP and Windows Vista, IBM WebSphere Portal Server and IBM WebSphere
Application Server are only supported for development use.
JBoss 4.2.x, 5.x and 6.x
10
Sun Solaris
Java Service Wrapper v3.3

Open Source GlassFish v2 UR2, v2.1, and v3
Oracle OC4J 10g 10.1.2 and 10.1.3
Oracle Application Server 10g 10.1.3.x
Oracle WebLogic Server 10.3 and 11g R1 (v10.3.1)
Windows XP and Windows Vista can be used to develop applications, but are not supported
by Oracle as production deployment platforms.
The Oracle WebLogic Server 11gR1 application server is supported only on MS Windows
IA-32 systems, with he following minimum requirements: Windows XP SP2+, Windows
Vista SP1+, Windows 2003 SP2+, or Windows 2008 SP2+.
SpringSource dm Server v1.0.2 and v2.0
This application server requires a JDK version 1.5 or later.
Application servers are not supported on versions of Windows which are not officially
supported by the application server vendor. Listed application servers may not have been
tested on every supported version of Windows.
In some cases, additional versions of the validated platforms are also supported. However,
these are typically older releases which are not formally validated. Other application servers
may be available upon request.
Simple Java-based application servers, such as Jetty and Orion, may be easily integrated with
JProbe using the Java Application configuration type. Instructions for integrating these
application servers and others may be found on the Inside JProbe community at
http://jprobe.inside.quest.com/. From this Web page, search for Creating a JProbe
Configuration for an Unlisted Application Server or for the name of your particular
application server.
Sun Solaris
This section presents the pre-requisites for installing JProbe on Sun Solaris IA-32, Sun Solaris
Intel64/ EM64T/ AMD64, and Sun Solaris SPARC platforms.
System Requirements
Sun Solaris 9 and 10 on Sun UltraSPARC processor (not SPARC Station or Intel)
Sun Solaris 10 on Sun IA-32 or Intel64/ EM64T/ AMD64 system
Sun Solaris 11 on Sun IA-32
11
Sun Solaris
2GB RAM
Supported JVMs
JRockit 5 R26 or later
Vendor supports this version for Solaris 9 and 10 only.
JRockit 6.0
Sun Java 2 SDK, Standard Edition, 1.4.2, plus patches
You can find patches on the Sun Microsystem Web site: java.sun.com.
Sun J2SE Development Kit 5.0

BEA WebLogic Server 9.2 and 10.0
Vendor supports IBM WebSphere Application Server versions 6.1 and 7.0 for Solaris 9
and 10 only.
Oracle OC4J 10g 10.1.2 and 10.1.3
The Oracle WebLogic Server 11gR1 application server is supported only on Sun Solaris
SPARC systems, with he following minimum requirements: Sun Solaris 9 Update 9+ and Sun
Solaris 10 Update 4+.
12
Linux IA-32
Application servers are not supported on versions of Solaris which are not officially
supported by the application server vendor. Listed application servers may not have been
tested on every supported version of Solaris.
application server.
Linux IA-32
This section presents the pre-requisites for installing JProbe on a Linux IA-32 platform.
System Requirements
While Quest Software only supports some versions of Linux, JProbe should work with any
Linux distribution that includes glibc 2.3.4 or later.
Red Hat Enterprise Linux versions 5.x, 6.x
CentOS 5.x
Ubuntu 10.10
SLES 11
SLES 10 (32 bit only)
2GB RAM
500 MB free disk space

The following sections list the supported Java developer kits and application servers for Red
Hat Enterprise Linux versions 5.x.
Supported JVMs
13
Linux IA-32
JRockit 5.0
Sun Java 2 SDK, Standard Edition, 1.4.2 or later
Sun J2SE Development Kit 5.0 plus patches
IBM 32-bit SDK for Linux on Intel Architecture, Java 2 Technology Edition, Version 1.4.2,
SR1 or later
IBM JDK 1.4.2 is not supported with Memory due to severe problems with the heap
dump provided by the JVM profiling interface (JVMPI). Workaround: You can import an
IBM heap dump.
IBM 32-bit SDK for Linux on Intel Architecture, Java 2 Technology Edition, Version 5
IBM 32-bit SDK for Linux on Intel architecture, Java Technology Edition, Version 6
Apache Geronimo 2.0.1 and 2.1
BEA WebLogic Server 8.1, 9.2, and 10.0
Vendor supports BEA WebLogic Server version 9.2 for Red Hat Enterprise Linux only.
Vendor supports this version for Red Hat Enterprise Linux only.
IBM WebSphere Application Server Community Edition 2.0 and 2.1
IBM WebSphere Application Server 7.0 requires at least Red Hat Enterprise Linux
Version 5 Update 1.
Oracle OC4J 10g 10.1.2 and 10.1.3
14
Linux IA-32
The Oracle WebLogic Server 11gR1 application server is supported only on 32-bit Red Hat
Enterprise Linux systems, with he following minimum requirements: Red Hat Enterprise
Linux version 5.3 or 5.4.
Application servers are not supported on versions of Linux which are not officially supported
by the application server vendor. Listed application servers may not have been tested on
every supported version of Linux.
application server.
CentOS 5.x
The following sections list the supported Java developer kits and application servers for
CentOS 5.x.
Supported JVMs
JRockit 5.0
Sun J2SE Development Kit 5.0 plus patches
IBM 32-bit SDK for Linux on Intel Architecture, Java 2 Technology Edition, Version 1.4.2,
SR1 or later
IBM heap dump.
IBM 32-bit SDK for Linux on Intel Architecture, Java 2 Technology Edition, Version 5
IBM 32-bit SDK for Linux on Intel architecture, Java Technology Edition, Version 6
15
Apache Geronimo 2.0.1 and 2.1

application server.

This section presents the pre-requisites for installing JProbe on a Linux Intel64/ EM64T/
AMD64 platform.
System Requirements
Red Hat Enterprise Linux version 5.x
While Quest Software only supports some versions of Linux, JProbe should work with any
Linux distribution that includes glibc 2.3.4 or later.
CentOS 5.x
2GB RAM
Supported JVMs
JRockit 5.0
IBM 64-bit SDK for Linux on Intel, Java 2 Technology Edition, Version 1.4.2, SR1 or later
16
IBM heap dump.
IBM 64-bit SDK for Linux on AMD64/EM64T, Java 2 Technology Edition, Version 5.0
IBM 64-bit SDK for Linux on AMD64/EM64T, Java Technology Edition, Version 6
Sun J2SE Development Kit 5.0 for Linux 64-bit AMD64/EM64T Processors plus patches
You can find patches on the Sun Microsystem web site: java.sun.com. Support for AMD64 /
EM64T 64-bit mode for Linux was introduced in J2SE 5.0 Update 2. Before Update 2, J2SE
5.0 supported AMD Opteron (64) Linux.

BEA WebLogic Server 9.2 and 10.0
Vendor supports BEA WebLogic Server 9.2 version for Red Hat Enterprise Linux only.
IBM WebSphere Application Server 6.1 and 7.0
IBM WebSphere Application Server 7.0 requires at least a Red Hat Enterprise Linux Version
5 Update 1.
JBoss 5.x, 6.x
Oracle WebLogic Server 10.3 and 11g R1
17
application server.

This section describes the Quest Software policies for supporting JProbe and various
versions of JVMs.
Support for JProbe

Quest Software supports the currently shipping version of JProbe plus one major release back.
If you need support for an earlier version, you may be able to arrange a special support
contract. See "Contacting Quest Support" (page 6) for more information.
Support for JVMs

Quest Software supports a selection of JVMs that have passed quality assurance testing with
JProbe. The supported JVMs are listed by operating system.
Functional Restrictions
Some of the supported JVMs may have problems running with one of the JProbe analysis
tools. You can still use these JVMs if you observe the functional restrictions documented in
the footnotes. For example, some significant known issues include:
IBM SDK 1.4.2 stability issue with Memory
BEA JRockit 5 slow response time with Memory
New Versions of Supported JVMs
As newer versions of supported JVMs are released, most will be supported automatically.
Others may require an updated version of the JProbe JVM configuration file, jvminfo.xml.
This file is available on SupportLink. Select Downloads & Updates and specify JProbe as
the product. See "Contacting Quest Support" (page 6) for more information.
Previously Supported JVMs
Effective with the JProbe 8.1 release, Quest Software has retired support for versions 1.2.x
and 1.3.x of the Java 2 JVMs that were supported in earlier versions of JProbe, as they have
completed the vendor's End-of-Life process. Quest Software strongly recommends upgrading
to a vendor-supported JVM version.
JVMs Provided with Supported Application Servers
Quest Software will support the Java SDK shipped with any application server that is
supported for JProbe, with the caveat that certain operating system patches and/or minor JVM
upgrades may need to be applied, as recommended by the vendor and/or Quest Software.

Support for other application servers may be available on request. See "Contacting Quest
Support" (page 6) for more information.
18
3
Installing JProbe
This chapter section provides information about installing JProbe on your Windows or
UNIX system.
Before You Begin (page 19)
Where to Install JProbe (page 19)
Installing JProbe Using the GUI Installer (page 20)
Installing JProbe in Eclipse (page 21)
Before You Begin

Before you begin the installation, review the following steps:
Locate your license number for JProbe. If you downloaded the software from the Quest
Software web site, the license number was mailed to the email address you specified. If you
received a product DVD, the license number is on the product packaging.
Ensure that you can run use cases/test cases on your application without JProbe installed.
JProbe can help you diagnose programming inefficiencies, but it cannot help with issues
related to how your application or application server is set up within your environment.
Review the hardware and software requirements for your operating system. See "Supported
Platforms" (page 8) for more information.
You may need to install a supported Java Virtual Machine.
You are now ready to install JProbe.
JProbe also offers an Eclipse plugin that provides intelligent code performance analysis and
problem resolution from within the Eclipse Java IDE.
Where to Install JProbe

Start by running the installer on the computer where your application resides. Both the
JProbe Analysis Engine and JProbe Console are installed. If you are running only local
sessions, you are done.
If you want to run your application and the JProbe Analysis Engine on one computer and
monitor it from another computer (for example, your workstation), you also need to install
JProbe on the second computer. The second computer does not have to run the same
20
operating system as the first. In fact, many remote sessions are heterogeneous, with the
application under analysis running on a UNIX system while the JProbe Console runs on
Windows. You can choose to use the JProbe Console from either computer, though not
simultaneously.

You can run the GUI version of the installer on Windows or UNIX systems, as long as you
have a graphical display available. After you start the installer, follow the on-screen
instructions. You can add your license when you launch JProbe for the first time.
To install the JProbe from a GUI:
Do one of the following:
If you have a product DVD, insert it into your systems DVD drive. On Windows platforms,
if autorun is enabled for the DVD drive, an HTML page is launched automatically.
Otherwise, open the DVD and browse to your platform.
If you downloaded the product from the Quest Software Web site, navigate to the directory
where you saved the downloaded file.
Double-click the installer for your platform, or run it from the command line:
Linux IA-32: ./jprobe830_LinuxIA32.bin
Linux Intel 64/ EM64T/ AMD64: ./jprobe830_LinuxX86_64.bin
Sun Solaris IA-32: ./jprobe830_SolarisIA32.bin
Sun Solaris SPARC: ./jprobe830_SolarisSparc.bin
Sun Solaris Intel 64/ EM64T/ AMD64: ./jprobe830_SolarisX86_64.bin
Windows IA-32: jprobe830_WinIA32
Windows Intel 64/ EM64T/ AMD64: jprobe830_WinX86_64
Follow the on-screen instructions. You need to agree to the license agreement before you can
install the product.
If you choose to run a Custom installation, you can set up your license during the installation
process. If you do not set up your license now, you are prompted to do so when you launch
JProbe. For information on types of licensing models and how to get licenses, see Licensing
JProbe (page 22).
When the installation is complete, click Done to exit the installer.
If errors were reported, check the installation log located in your installation directory.
Review the JProbe Release Notes for whats new in this release and known issues. It is
located in the <jprobe_home>/docs directory.

To configure your application to work with JProbe, see the JProbe User Guide.

For information about installing the JProbe Plugins for Eclipse and setting up your JProbe
environment within Eclipse, see the JProbe Plugins for Eclipse section in Help.
21
4
Licensing JProbe
Before you can use JProbe, you must provide a valid license file. JProbe is unlocked for
purchase or evaluation, depending on the license file you provide. This chapter section
outlines the various options and the procedure for licensing JProbe.
JProbe License Options (page 22)
Requesting Node Locked Licenses (page 23)
Registering Node Locked Licenses (page 25)
Using Concurrent Licenses (page 28)
JProbe License Options

There are two types of licensing models available: node locked and concurrent. For more
information, review the JProbe licensing options on the Quest web site at:
http://www.quest.com/jprobe/licensing_info.aspx.
Required License Version

This new release of JProbe 9.0 requires a new license key. JProbe 9.0 does not accept license
files generated for previous versions of JProbe. Existing customers can submit a request for a
JProbe 9.0 licenses from the Quest License Key Upgrade page:
http://license.quest.com/upgrade.
Node Locked Licensing

A node locked license allows JProbe to run on a predefined set of computers. The standard
license is for a single developer. The license file contains the licensed host name and
operating system, the type of license (purchase or evaluation), and the JProbe name, version,
and license number. For evaluation (or leased) software, it also contains the evaluation
expiration date. See "Requesting Node Locked Licenses" (page 23) for more information.
Concurrent Licensing
Concurrent licensing offers flexibility in where JProbe is installed and who may use the
product. Instead of having one node locked license per developer, you purchase a number of
licenses that are shared by the entire team via the Quest Software License Server.
Concurrent licensing is not available with evaluation versions of JProbe.
23
When you launch JProbe, the product checks to see if a license is available from the License
Server. If so, you can use the product; if not, you need to try again later. If developers
consistently have trouble obtaining a license, you can increase the number of licenses by
contacting Quest Software. See "Using Concurrent Licenses" (page 28) for more information.

You can obtain a node locked license while installing JProbe, or you can skip this step and
request a license when you launch JProbe. If no license is installed, JProbe checks its root
directory for a valid license on startup and adds it automatically, if found. Alternatively, you
can go to the Quest Software SupportLink web site and request your license.
Requesting a License During Installation or from Within

JProbe
This procedure assumes that you are working from the computer where your application and
JProbe are installed, and that this computer has a graphical display and a connection to the
Internet. When you request a license file, your hostname and number of CPUs is sent to
Quest Software. This information is required for the license file.
If the computer you want to license does not have Internet access, or if you want to request a
license for a different hostname, you can request a license through SupportLink. See
"Requesting a License via SupportLink" (page 24) for more information.
If you want to run remote sessions, specify the second host name when the License Details
web site is displayed. The second host can only run the JProbe Console for the product, not
the JProbe Analysis Engine. After you receive the license file, you register the same license
file on both computers.
To request a node locked license:
On the computer running your application and the JProbe Analysis Engine, do one of
the following:
To request the license while installing JProbe, select the Node Locked / Per Seat Licenses
tab in the Licensing Setup installation screen.
This option is available only if you choose to run a Custom installation.
To request the license after installation, launch JProbe and select the Node Locked / Per Seat
Licenses tab in the Manage JProbe Licenses dialog box.
Click Obtain License.
You are advised that your hostname and number of CPUs will be sent to Quest Software. If
you agree to transfer this information, continue with this procedure. Otherwise, see
Requesting a License via SupportLink (page 24)
Click OK.
24
Your default browser opens. If the Quest Software license page does not display, ensure that
cookies are enabled in your browser and try again.
Follow the instructions on the web site to request your license.
If you are not subscribed, complete the subscription details.
If someone else in your organization has subscribed with this license number, you may not be
able to license JProbe on your computer.
If you want to run remote sessions, be sure to add the host name of the second computer
when prompted.
To find the host name of a computer, enter hostname in a command prompt or xterm session.
After you complete the instructions on the Web site, your JProbe license file is sent to your
email address. Save the license file to your computer.
Now you can register the node locked license. See Registering a License During Installation
or from Within JProbe (page 25).
Requesting a License via SupportLink

You can request a JProbe license file using any computer that has Internet access. Go to the
Get JProbe License page (URL below) and follow the online instructions. If the person who
will be using this copy of JProbe has not subscribed, you need to complete the subscription
details before you can receive a license file.
Alternatively, instead of following this procedure, you can contact Quest to request a license
file. See "Contacting Quest Support" (page 6) for more information.
To request a node locked license:
Go to SupportLink at http://support.quest.com.
Select License Keys.
Follow the instructions on the web site to request your license.
If you are not subscribed, complete the subscription details.
If someone else in your organization has subscribed with this license number, you may not be
able to license JProbe on your computer.
When prompted, enter the host name of the computer running your application.
If you want to run remote sessions, add the host name of the second computer from which
you want to monitor JProbe sessions and review the collected data.
To find the host name of a computer, enter hostname in a command prompt or xterm session.
After you complete the instructions on the Web site, your JProbe license file is mailed to the
subscribed persons email address. Save the license file to your computer.
25
Now you can register the node locked license. See Registering a License During Installation
or from Within JProbe (page 25).

You can register a node locked license while installing JProbe, or you can skip this step and
register a license when you launch JProbe. Alternatively, you can run a command line tool to
register JProbe.
Registering a License During Installation or from

Within JProbe
This procedure walks you through registering a license file on the computer or computers
named in the license file. It assumes that the computer has a graphical display. If not, a
command line utility is also available. See "Registering Licenses from the Command Line"
(page 27) for more information.
To register node locked licenses:
the following:
To register the license while installing JProbe, select the Node Locked tab in the Licensing
Setup installation screen.
To register the license after installation, launch JProbe and select the Node Locked tab in the
Manage JProbe Licenses dialog box.
Click Add License, navigate to and select the saved license file, and click Open.
The license is installed to JPROBE_HOME/config/jprobe.licenses. Some of the details of the
license are displayed in the table.

To view all the license details, select the license and click View.
The License Properties dialog box opens with the details displayed.
26
27
Click OK to close the License Properties dialog box.

To save a back up of your license file in case you ever need to reinstall JProbe, click Save.
To end the license registration process, do one of the following:
From the Licensing Setup installation screen, click Next.
From the Manage JProbe Licenses dialog, click Close.
For a remote setup, go to the other computer that you specified when requesting the license
file and repeat this procedure. If the license file is not accessible from the other computer, use
FTP to put a copy of the license on the second computer.
You can now use JProbe.
Registering Licenses from the Command Line

You use the jplicense utility to register node locked licenses. You can also use this
utility to list, view, replace, and delete licenses. For more information, see the JProbe
Reference Guide.
You can request a JProbe license file using any computer that has Internet access. See
"Requesting a License via SupportLink" (page 24) for more information.
28

To register node locked licenses from the command line:

On the computer running your application and JProbe, open a command prompt.
Navigate to the JPROBE_HOME/bin directory.
To add one or more node locked licenses, use the following syntax:
Windows: jplicense add <license_file> [<license_file>...]
UNIX: ./jplicense add <license_file> [<license_file>...]
where license_file is the fully qualified path to the JProbe license file(s).
To extract a node locked license as a backup in case you need to reinstall JProbe, use the
following syntax:
Windows: jplicense extract <license_number> <license_file>
UNIX: ./jplicense extract <license_number> <license_file>
where license_number is the license to extract and license_file is the fully qualified path to
the file where you want to save the extracted license. To get a list of license numbers, use
jplicense list.
You can now use JProbe.

Concurrent licensing means that multiple people can start simultaneous JProbe analysis
sessions on the same application. Each concurrent license permits a developer to run a JProbe
Analysis Engine and a JProbeConsole. Two people cannot connect JProbe Consoles to the
same instance of a JProbe analysis session; a separate instance of the application is run under
JProbe for each concurrent user. If no license is installed, JProbe queries the local subnet for a
valid license server on startup and adds it automatically, if found.
Concurrent licenses are managed automatically. If you attempt to use JProbe while all
licenses are in use, you are notified. You need to wait for an available license. If this occurs
frequently, you may want to contact Quest Software to increase your number of licenses.
The following procedures assume that you have completed these tasks:
Task
Purchased JProbe for the operating
system that your application runs on
and asked for concurrent licensing.
Downloaded the Quest Software
License Server from the Web page
specified in the confirmation email that
you received, and specified the host
Help on Task
To order, contact [email protected].
To download the License Server, follow
the instructions in the confirmation
email, the License Details Web page,
and the License Server download Web
29
Task
name and OS of the network server
where it will run.
5
6
7
Help on Task
page. You will be emailed your license
file.
To install the License Server, run
licensing <version>-platform. For
example, questlicensing4.2.7Installed and started the License Server lnx.bin.
on the network server you specified.
To start the License Server, follow the
instructions in the License Server
documentation.
To open the home page for the License
Server, see the Readme file. To add a
Added the license file to the License
Server via its Web interface. The license license, follow the on-screen
instructions.
file was mailed to the email address
provided when you downloaded the
You can also launch the Web interface
License Server.
from the JProbe Concurrent Licenses
tab by selecting View License Usage.
Installed JProbe on the computer that
See Installing JProbe (page 19).
runs your application.
Installed JProbe on each of the
See Installing JProbe (page 19).
developers workstations.
Ensured that all computers have access For help with network issues, see your
to the server running the License Server. System Administrator.
Setting the License Server During Installation or from

Within JProbe
This procedure assumes that you are working from the computer running your application
and the JProbe Analysis Engine. If you do not have a graphical display, see Setting the
License Server from the Command Line (page 30)
To set the license server for concurrent licensing:
the following:
To set the license server while installing JProbe, select the Concurrent Licenses tab in the
Licensing Setup installation screen.
To set the license server after installation, launch JProbe and select the Concurrent Licenses
tab in the Manage JProbe Licenses dialog box.
Type the fully qualified host name or IP address of the computer running the License Server
in the License Server Hostname field.
Click Test Server.
A message tells you whether or not the computer is available.

To set the specified host as your license server, click Set Server.
To view your license and the licenses currently in use, click View License Usage.
The License Server home page opens in your default browser.
For details on each screen, click the Help link.
To close the License Server web interface, close your browser.
To end the license registration process, do one of the following:
From the Licensing Setup installation, click Next.
From the Manage JProbe Licenses dialog, click Close.
Repeat on each of the developer workstations.
You can run JProbe if a concurrent license is available.
Setting the License Server from the Command Line

You can test and set the license server from the command line. See "Using Concurrent
Licenses" (page 28) for more information.
To set the license server for concurrent licensing from the command line:
From a command prompt, navigate to the JPROBE_HOME/bin directory.
To test that the license server is available, enter:
Windows: jplicense test <license_server> <port> <application>
UNIX: ./jplicense test <license_server> <port> <application>
where license_server is the name of the server running the Quest Software License Server,
port is the port number that the license server listens on, and application is the licensing
application name. For example: jplicense test serve_lics 8133 licensing
To set the license server, use the following syntax:
Windows: jplicense server <license_server> <port> <application>
UNIX: ./jplicense server <license_server> <port> <application>
where license_server is the host running the Quest Software License Server, port is the port
number that the license server listens on, and application is the licensing application name.
Repeat on each of the developer workstations.
You can run JProbe if a concurrent license is available.
30
Index
6
64-bit Linux
15
A
about JProbe
about Quest Software
6
C
Cent OS 5.x
14
command line
licensing
27
concurrent license
overview
22
using
28
contacting Quest
6
I
install
from GUI
20
in Eclipse
21
location
19
overview
19
prerequisites
19
J
JProbe community
JVM support, policy for
17
L
license
options
22
overview
22
requesting
24
license server, setting

during installation
29
from command line
30
from JProbe
29
Linux
IA-32
12
Intel 64/ AMD64/ EM64T
15
M
Microsoft Windows
8
N
node locked license

overview
22
registering
25
requesting
23
P
plugins for Eclipse, installing
21
policies
17
R
12
remote environment
19
S
setting license server

during installation
29
from command line
30
from JProbe
29
Sun Solaris
support
support policies
10
6
17
supported platforms
SupportLink, requesting a license
24
T
technical support
text conventions

JProbe Install PDF

Uploaded by

Copyright:

Available Formats

JProbe Install PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

JProbe Install PDF

Uploaded by

Copyright:

Available Formats

JProbe

Introduction to This Guide

About This Guide

About Quest Software, Inc.

Contacting Quest Software

Contacting Quest Support

Validated Application Servers

Validated Application Servers

Red Hat Enterprise Linux

Linux Intel64/ EM64T/ AMD64

Validated Application Servers

Support for JProbe and JVMs

Support for JProbe

Support for JVMs

Before You Begin

Where to Install JProbe

Installing JProbe Using the GUI Installer

Installing JProbe in Eclipse

Required License Version

Node Locked Licensing

Requesting Node Locked Licenses

Requesting a License During Installation or from Within JProbe

Requesting a License via SupportLink

Registering Node Locked Licenses

Registering a License During Installation or from Within JProbe

Registering Licenses from the Command Line

Using Concurrent Licenses

Setting the License Server During Installation or from Within JProbe

Setting the License Server from the Command Line

Performance analysisallows a developer to identify and resolve Java bottlenecks

Coverage analysisallows a developer to identify un-executed lines of code during

About This Guide

JProbe 9.0 Installation Guide

Java language source code and examples of file contents

HTML documents, tags, and attributes

About Quest Software, Inc.

Contacting Quest Software

Contacting Quest Support

JProbe 9.0 Installation Guide

Quickly find thousands of solutions (Knowledgebase articles/documents).

Download patches and upgrades.

Seek help from a Support engineer.

Log and update your case, and check its status.

JProbe 9.0 Installation Guide

Validated Application Servers

JProbe 9.0 Installation Guide

Java Service Wrapper v3.3

JProbe 9.0 Installation Guide

Validated Application Servers

JProbe 9.0 Installation Guide

Red Hat Enterprise Linux

JProbe 9.0 Installation Guide

JProbe 9.0 Installation Guide

JProbe 9.0 Installation Guide

Linux Intel64/ EM64T/ AMD64

Apache Geronimo 2.0.1 and 2.1

Linux Intel64/ EM64T/ AMD64

JProbe 9.0 Installation Guide

Linux Intel64/ EM64T/ AMD64