This is the mail archive of the systemtap@sourceware.org mailing list for the systemtap project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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. 
--------------------------------------------------------------------


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]