InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.28: Planning and skills for IBM Distributed Debugger and OLT >
6.6.28.1: Installing Debugger and OLT code and documentation >
6.6.28.1.1: Installing Debugger and OLT clients (README)

6.6.28.1.1: Installing Debugger and OLT clients (README)

These instructions were added for IBM WebSphere Application Server Version 3.5.3. If using an earlier version, consult the article about installing Debugger and OLT code and documentation and the Prerequisites Web page to find out which operating systems are supported by your current level of IBM WebSphere Application Server and its accompanying Debugger and OLT code.


IBM Distributed Debugger and Object Level Trace
INSTALLATION
===============================================

1 General remarks about installation
2 Installation on Windows (R)
3 Installation on Linux
4 Installation on AIX
5 Installation on Solaris

1 General remarks about installation
------------------------------------
The following remarks regarding installation and prerequisites are
applicable on all platforms for the installation of the IBM
Distributed Debugger and Object Level Trace tools. Additional
prerequisites and platform-specific installation issues are mentioned
in the subsections for each platform.

General prerequisites:

Netscape Navigator, Version 4.5 or later is recommended for displaying
debugger online help. Using an earlier version may give you a browser
exception if you reopen a help window multiple times.

For interpreted debugging, the following additional prerequisites
apply:

* You should install the appropriate level of the JDK, as specified by
the product with which the Distributed Debugger and Object Level Trace
shipped.

* If you install this version of the debugger over WebSphere Application Server
V3.02 on Windows NT, then you must go into the IBMDebug\bin
directory and rename ivbtr30i.302 to ivbtr30i.dll.


2 Installation on Windows (R)
-----------------------------
Prerequisites:

For standalone debugging, the location of Java executable specified in
the PATH environment variable must be from the JDK "bin" directory.
For example, if, on Windows NT, the PATH environment variable points
to the java.exe in the \WINNT\SYSTEM32 directory, the debugger cannot
debug the application. To avoid this problem, insert the full path to
java.exe in the JDK bin directory to the start of the PATH environment
variable.

If you are using remote stored procedure debugging on DB2, you must
add the \IBMDebug\lib\dertrjrt.jar file to your system CLASSPATH.

Installation:

Installing the Distributed Debugger on Windows is automatic and does
not require you to manually issue any commands or move any files. Simply
download oltdbg.zip, unzip it, and double click on the setup icon to start
the installation process.

Any beta version of the IBM Distributed Debugger must be uninstalled
before installing the current version that accompanies this product.

The debugger will not function if installed in a directory whose name
contains DBCS characters.


3 Installation on Linux
-----------------------

(1) The JDK 1.2.2 is required by the Distributed Debugger.
The location of Java executable specified in the PATH environment
variable must be from the JDK "bin" directory. For example, if the PATH
environment variable points to java in the /usr/local/bin directory,
the debugger cannot debug the application. To avoid this problem,
insert the full path to java in the JDK bin directory to the
start of the PATH environment variable.

(2) Some JDK implementations may reference fonts that may not be
installed or accessible. When this situation occurs, a message similar
to the following may appear when the Debugger or any other graphical
java application is run:

Font specified in font.properties not found [--zapf dingbats-
medium-r- normal--*-%d-*-*-p-*-adobe-fo]

These messages do not indicate a fatal condition. Usually these
missing font warnings are soft errors that do not impede running the
application. To correct the "font not found" problem, visit the JDK
supplier’s website. Solutions to this issue may include installing
missing fonts and/or updating the JDK/JRE font.properties file.

Installation:

1. Download oltdbg.tar
2. su to root if you are not logged in as root already.
3. Go to your download directory.
4. From a command prompt, issue the following commands:

.tar -xvf oltdbg.tar
.rpm -Unh DERJPICL-9-0.i386.rpm


4 Installation on AIX
---------------------
Prerequisites:

The IBM JDK 1.2.2 PTF9 is a prerequisite for interpreted debugging on this
platform. If you are using remote stored procedure debugging on DB2,
you must add the /usr/lpp/idebug/lib/dertrjrt.jar file to your system
CLASSPATH.

Installation:

Search for the install image of the distributed debugger. Copy the
install file(s) to the machine on which the debugger is to be
installed. Use installp or 'smitty install_latest'.

To use the IBM Distributed Debugger on AIX, you must add the following
lines to your .profile:

# Start the OLT login profile
if [ -f /usr/idebug/bin/OLT.profile ]; then
.. /usr/idebug/bin/OLT.profile
fi


5 Installation on Solaris
-------------------------
Prerequisite:

If you are using remote stored procedure debugging on DB2, you must
add the /opt/IBMdebug/lib/dertrjrt.jar file to your system CLASSPATH.

Installation:

Download the solaris oltdbg.zip image. Unzip the image. Issue the command "./
dbgsetup"

Go to previous article: Installing Debugger and OLT code and documentation Go to next article: Example: Installing OLT and Debugger clients on Windows NT

 

 
Go to previous article: Installing Debugger and OLT code and documentation Go to next article: Example: Installing OLT and Debugger clients on Windows NT