This is the mail archive of the
systemtap@sourceware.org
mailing list for the systemtap project.
SystemTap Installation on Fedora core 5 - revised
- From: Kevin Feliksa <feliksa at us dot ibm dot com>
- To: systemtap at sourceware dot org
- Date: Wed, 12 Jul 2006 19:19:00 -0500
- Subject: SystemTap Installation on Fedora core 5 - revised
Following is revised version of a Fedora core 5 SystemTap install
procedure. It is formalized version of that recommended by Frank Ch.
Eigler - perhaps verbose, but none the less surrounded by some English.
(It doesn't reflect your brevity, Frank, but hopefully your underlying
intent. Thank you!)
Your comments are very much appreciated. Kevin Feliksa
------------------------------------------------------------------------------------
SystemTap Installation on Fedora core 5
SystemTap is tool that enables application developers and system
administrators to construct instrumentation that monitors the performance
of the Linux kernel.
Installation of SystemTap on the Fedora core 5 system requires the
following:
root (superuser) login privileges
kernel-devel or kernel-smp-devel RPM - kernel module build environment
kernel-debuginfo RPM - kernel debugging information
elfutils provided with the Fedora core 5 release
systemtap RPM
gcc and gcc-c++ compilers provided with the Fedora core 5 release.
The following procedure assumes that the Fedora core 5 system is an iso
release (15 March, 2006) with the Office and Productivity and Software
Development options selected during installation.
Installation procedure
Note: You must have a high-speed Internet connection to use parts of this
procedure.
All of the commands in this procedure are entered in a terminal window.
1. Login to the Linux system as a "root" user (superuser).
2. Obtain the release level of the Linux kernel and the processor
type.
a. Open a terminal window and enter the command: uname -r
This command returns the release level of the Linux kernel.
b. Enter the command: uname -p
This command returns the processor type (architecture) of the hardware.
3. Load the kernel-devel or kernel-smp-devel (for symmetrical
multiprocessors) package if it is not installed. The installed ...-devel
package must be for the same Linux kernel release level and processor
type.
a. To determine if the ...devel package is installed, enter whichever
of the following applies:
rpm -q kernel-devel
or
rpm -q kernel-smp-devel
If the package is installed and it is at the same release level as the
Linux kernel, go to step 4. If it is installed and not at the same release
level as the Linux kernel, remove the package with the command: rpm -e
kernel-devel (or rpm -e kernel-smp-devel).
b. Enter the appropriate command to install the kernel-devel or
kernel-smp-devel package:
yum install kernel-devel-RL
or
yum install kernel-smp-devel-RL
where RL is the release level of the Linux kernel.
To complete the installation, enter "y" at the prompt "Is this ok [y/N]?"
and wait for the "Complete!" message to appear.
4. Load the kernel-debuginfo package if it is not installed. The
installed kernel-debuginfo package must be for the same Linux kernel
release level and processor type.
a. To determine if kernel-debuginfo is installed, enter the command:
rpm -q kernel-debuginfo
If the package is installed and it is at the same release level as the
Linux kernel, go to step 5. If the package is installed and it is not at
the same release level as the Linux kernel, remove the package with the
command: rpm -e kernel-debuginfo.
b. Enter the following command to install the kernel-debuginfo
package:
yum --enablerepo=core-debuginfo install kernel-debuginfo-RL
where RL is the release level of the kernel.
To complete the installation, enter "y" at the prompt "Is this ok [y/N]?"
and wait for the "Complete!" message to appear. Note: The kernel-debuginfo
package size is greater than 600 MB.
5. Load the elfutils package if it is not installed.
a. To determine if the elfutils package is installed, enter the
command: rpm -q elfutils
If the package is installed, go to step 6.
b. Enter the following command to install the elfutils package: yum
install elfutils
elfutils-0.119-1.2.1 is the version provided with the Fedora core 5 iso
release dated 15 March, 2006. This version should be installed if using
that release.
To complete the installation, enter "y" at the prompt "Is this ok [y/N]?"
and wait for the "Complete!" message to appear.
6. Load the systemtap package if it is not installed.
a. To determine if the systemtap package is installed, enter the
command: rpm -q systemtap
If the package is installed, go to step 7.
b. Enter the following command to install the systemtap package: yum
install systemtap
systemtap-0.5.4-2.2 is the version provided with the Fedora core 5 iso
release dated 15 March, 2006. This version should be installed if using
that release.
To complete the installation, enter "y" at the prompt "Is this ok [y/N]?"
and wait for the "Complete!" message to appear.
7. Load the gcc and gcc-c++ compiler packages if they are not
installed.
a. To determine if the compiler packages are installed, enter the
commands:
rpm -q gcc
and
rpm -q gcc-c++
gcc-4.1.0-3 and gcc-c++-4.1.0-3 are the versions provided with the Fedora
core 5 iso release dated 15 March, 2006. These version should be installed
if using that release. If both of these package are installed, go to step
8.
b. Install the gcc and/or gcc-c++ package(s) by entering the
command(s):
yum install gcc
and/or
yum install gcc-c++
To complete the installation, enter "y" at the prompt "Is this ok [y/N]?"
and wait for the "Complete!" message to appear.
8. Test the installation to verify that SystemTap is functioning
properly.
a. Enter the command:
stap -e 'probe begin { log ("hello world") }'
This command produces the reply "hello world" if SystemTap is installed
properly.
b. Download and execute test programs from the following resource to
further verify the installation:
http://sources.redhat.com/cgi-bin/cvsweb.cgi/tests/?cvsroot=systemtap
Congratulations! You have installed SystemTap.
--------------------------------------------------------------------