2.1. 安装和配置

要想使用SystemTap，需要安装跟目标内核版本匹配的-devel、-debuginfo和-debuginfo-common-arch包。如果要在不止一个内核上运行SystemTap，需要根据每个内核的版本安装对应的-devel和-debuginfo包。

接下来的几个小节里，我们会详细讲解这一过程。（译注：SystemTap的wiki里面有针对Linux各发行版的安装步骤。本节内容仅适用于RHEL，且不能保证及时更新，建议跳过本节，直接参考官方文档。如果你正好用的是ubuntu，可以参考ubuntu的wiki）

很多用户把-debuginfo记成了-debug。要想使用SystemTap，切记安装对应内核的-debuginfo包，不是-debug包。

安装SystemTap

要想使用SystemTap，安装下面的RPM包：

• systemtap
• systemtap-runtime

以root权限运行下面的命令：

yum install systemtap systemtap-runtime

注意要想用上SystemTap，还得安装依赖的内核调试信息包。在较新的系统上，仅需以root权限运行下面的命令：

stap-prep

如果这个命令没起作用，你需要按照下面的步骤手动安装。

手动安装依赖的内核调试信息包

SystemTap需要内核信息，这样才能注入指令。此外，这些信息还能帮助SystemTap生成合适的检测代码。

这些必要的内核信息分别包括在特定内核版本所对应的-devel，-debuginfo和-debuginfo-common包中。对于“标准版”内核（指按照常规配置编译的内核），所需的-devel和-debuginfo等包命名为：

kernel-debuginfo
kernel-debuginfo-common
kernel-devel

同样的，启用了PAE的内核所需的包分别为kernel-PAE-debuginfo，kernel-PAE-debuginfo-common，和kernel-PAE-devel。（译注：PAE即Physical Address Extension（物理地址拓展），32位Linux可以用它拓展内存访问空间）

要想确定当前系统的内核版本，敲入：

uname -r

举个例子，如果你想在i686环境下的2.6.18-53.el5内核上使用SystenTap，需要下载安装如下的RPM包：

kernel-debuginfo-2.6.18-53.1.13.el5.i686.rpm
kernel-debuginfo-common-2.6.18-53.1.13.el5.i686.rpm
kernel-devel-2.6.18-53.1.13.el5.i686.rpm

你安装的-devel、-debuginfo和-debuginfo-common包的版本一定要匹配目标内核的版本/特性/架构。

安装依赖的内核信息包最简单的方法，就是用yum install和debuginfo-install命令。debuginfo-install命令包含在版本1.1.10以上的yum-utils包里，还需要一个能够下载安装-debuginfo和-debuginfo-common包的yum源。 确保系统包管理的源满足要求，运行下面的命令就能安装特定内核对应的包：

yum install kernelname-devel-version
debuginfo-install kernelname-version

把命令中的kernelname替换成对应的内核名（比如，kernel-PAE），version换成目标内核的版本。举个例子，安装kernel-PAE-2.6.18-53.1.13.el5内核所对应的内核信息包，需要运行：

yum install kernel-PAE-devel-2.6.18-53.1.13.el5
debuginfo-install kernel-PAE-2.6.18-53.1.13.el5

一旦手动下载了所依赖的包之后，以root权限运行下面的命令来安装它们：

rpm --force -ivh package_names

检查安装是否成功

如果你正在用的内核就是你的目标内核，你现在就能检查下安装是否成功。如果不是，重启下系统并载入目标内核。

运行下面命令开始检查：

stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'

这个命令让SystemTap在虚拟文件系统的读事件发生之后，输出read performed接着退出。如果SystemTap安装成功了，应该会输出类似下面的内容：

Pass 1: parsed user script and 45 library script(s) in 340usr/0sys/358real ms.
Pass 2: analyzed script: 1 probe(s), 1 function(s), 0 embed(s), 0 global(s) in 290usr/260sys/568real ms.
Pass 3: translated to C into "/tmp/stapiArgLX/stap_e5886fa50499994e6a87aacdc43cd392_399.c" in 490usr/430sys/938real ms.
Pass 4: compiled C into "stap_e5886fa50499994e6a87aacdc43cd392_399.ko" in 3310usr/430sys/3714real ms.
Pass 5: starting run.
read performed
Pass 5: run completed in 10usr/40sys/73real ms.

从Pass 5开始的最后三行说明SystemTao已经成功地注入并运行了内核探测指令，捕获了要探测的事件（在这个例子里，指虚拟文件系统的读事件），并执行了有效的处理程序（输出“read performed”并正常退出）。