SystemTap Installation on Fedora core 5

[Kevin Feliksa <feliksa at us dot ibm dot com>]

Hi,

In an effort to provide release documentation, following is a preliminary 
procedure for installing SystemTap on a Fedora core 5 system using the 
SystemTap package included with the release.  Please comment on this 
procedure so that it might become "recommended." 

Thanks,

Kevin Feliksa
feliksa@us.ibm.com

-------------------------------------------------------------------------------------------------------

SystemTap Install 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 a 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 
C/C++ compilers provided with the Fedora core 5 release. 
Installation procedure
Note: You must have a high-speed Internet connection to use portions of 
this procedure. 
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 kernel. 
b.      In the terminal window, enter the command: uname -p 
This command returns the processor type (architecture) of the machine. 
3.      Load the kernel-devel or kernel-smp-devel (for symmetrical 
multiprocessors) package if not already installed. The installed ...-devel 
package must be for the same kernel release level and processor type 
determined in Step 2. 
a.      In the terminal window, 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 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-devel or 
rpm -e kernel-smp-devel whichever applies. Continue with step 3b. 
b.      Open the Package Manager of the Linux desktop (Add/Remove Software
) and wait for it to finish retrieving software information. 
c.      Click the Search button on the left and type kernel-devel or 
kernel-smp-devel, whichever applies, in the entry field at the top. Press 
Enter. After the Package Manager completes the search, a list of available 
packages is displayed in the result window. 
d.      If the ...-devel package with the kernel release level and 
processor type (determined in Step 2) is available, click (check) the 
select box associated with it. Click the Apply button and follow the 
instructions to install the package. 

If the package you need is not listed, use an Internet search engine to 
find the appropriate ...-devel package with the kernel release number and 
processor type, and install it. Following is an example of a Internet 
search and install for one kind of machine: 
>From step 2a above, the release level is: 2.6.15-1.2054 
>From step 2b above, the processor type is: i686 
Open an Internet browser and go to: www.google.com 
In the search field, enter (something like): Fedora kernel-debug 
2.6.15-1.2054 i686 
Scan the results list for a download site and file you need for your 
machine. At the download site, select the correct file to download, select 
Open with | Install software, then click OK. 
4.      Load the kernel-debuginfo package if not already installed. The 
installed kernel-debuginfo package must be for the same kernel release 
level and processor type determined in Step 2. 
a.      In a terminal window, 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.      Open the Package Manager of the Linux desktop (System|Add/Remove 
Software) and wait for it to finish retrieving software information. 
c.      Click the Search button on the left and type kernel-debuginfo in 
the entry field at the top. Press Enter. After the Package Manager 
completes the search, a list of available packages are displayed in the 
result window. 
d.      Click (check) the select box of the required kernel-debuginfo 
package. Click the Apply button and follow the instructions to install the 
package. The kernel-debuginfo package is very large and takes several 
minutes to download with a high speed Internet connection. 

If the package you need is not listed, use an Internet search engine to 
find the appropriate kernel-debuginfo package. Download and install the 
package as described in step 3d above. 
5.      Load the elfutils package if not already installed. 
a.      In the terminal window, enter the command: 
rpm -q elfutils 

If the package is installed, go to step 6. If it is not installed, 
continue with step 5b. 
b.      Open the Package Manager of the Linux desktop and wait for it to 
finish retrieving software information. 
c.      Click the Search button on the left and type elfutils in the entry 
field. Press Enter. When the Package Manager completes the search, the 
elfutils provided with the distro is displayed in the results window. Note
: The release level of elfutils in the distro is not the same as the 
release level as the Linux kernel. 
d.      Click (check) the select box for elfutils. 
e.      Click Apply and follow the instructions to install elfutils. 
6.      Load the systemtap package if not already installed. 
a.      At the prompt in the terminal window, enter the command: 
rpm -q systemtap 

If the package is installed, go to step 7. If it is not installed, 
continue with step 6b. 
b.      Open the Package Manager of the Linux desktop and wait for it to 
finish retrieving software information. 
c.      Click the Search button on the left and type systemtap in the 
entry field. Press Enter. After the Package Manager completes the search, 
the systemtap provided with the distro will be listed. Note: The release 
level of systemtap need not be the same as the release level as the Linux 
kernel. 
d.      Click (check) the select box for systemtap. 
e.      Click Apply and follow the instructions to install systemtap. 
7.      Load the gcc and gcc-c++ packages if not already installed. 
a.      At the prompt in the terminal window, enter the command: 
rpm -q gcc 
and
rpm -q gcc-c++ 

If both of these package are installed, go to step 8. If either is not 
installed, continue with step 7b. 
b.      Open the Package Manager of the Linux desktop and wait for it to 
finish retrieving software information. 
c.      Click the Search button on the left and type gcc in the entry 
field. Press Enter. After the Package Manager completes the search, the 
gcc packages provided with the distro are listed. 
d.      Click (check) the select box next to the gcc and/or gcc-c++ 
entries, as needed. 
e.      Click the Apply button and follow the instructions to install the 
compilers. 
8.      Download and execute test programs to verify the functionality of 
the systemtap installation. For additional information, refer to: 
http://sources.redhat.com/cgi-bin/cvsweb.cgi/tests/?cvsroot=systemtap
Congratulations! You have installed SystemTap.
------------------------------------------------------------------------------------