Comments on Installation Guide

Comments on Installation Guide

[Daniel Migault]

Hi,

I went through the documentation, and maybe I would add a few 
indications for the installation. It looks that some of them have been 
removed from previous installation guides.

Regards,
Daniel


I Install systemtap

If you want to install systemtap from rpm :
   yum install systemtap systemtap-client systemtap-grapher 
systemtap-runtime systemtap-sdt-devel systemtap-server systemtap-testsuite

If you want the latest version, then you may built it from the git 
repository :
   I.1. Download the git directory
     If you don't already have a local copy :
     git clone http://sources.redhat.com/git/systemtap.git 
<http://sources.redhat.com/git/systemtap.git> systemtap.git
     If you have already a local copy then you just need to upgrade it :
     git pull

   I.2. Get pre-requisit rpms :
     yum install xmlto latex2html gcc gcc-c++ publican nspr-devel 
nss-devel avahi-devel elfutils-devel libdwarf-devel sqlite-devel 
boost-devel xmltool rpm-libs rpm-devel rpm-build pcp-libs-devel 
perl-ExtUtils-MakeMaker bison perl-PCP-PMDA  gtkmm24-devel 
libglademm24-devel

   I.3. Configure and build :
     cd systemtap.git
     ./configure
     Depending on your installation you may need more rpm. If message 
are not explicit enough you may look at the file config.log and search 
for "failed". Note that fatal error : ac_nonexistent.h should not be 
considered as errors.
      make
      make install


II Configure your kernel :

     yum install kernel-devel-`uname -r`
     debufinfo-install kernel-`uname -r`

     If installation does not succeed than install manually the packages 
by doing : # This indication was in older installation guides, and 
removed on version 1.6
     dpkg --force -ivh XXX

     test with : stap -v -e 'probe vfs.read {printf("read performed\n"); 
exit()}'
     If that does not work, then you may reboot.

Re: Comments on Installation Guide

[Frank Ch. Eigler]

Hi, Daniel -


mglt.biz wrote:

> I went through the documentation, and maybe I would add a few
> indications for the installation. It looks that some of them have
> been removed from previous installation guides.

Such distribution-specific information could go into the wiki, or
perhaps new README.fedora type files.  Note that the main README
already has similar information.

> I Install systemtap
>
> If you want to install systemtap from rpm :
>   yum install systemtap systemtap-client systemtap-grapher
> systemtap-runtime systemtap-sdt-devel systemtap-server
> systemtap-testsuite

The basic requirement is only systemtap and systemtap-runtime.


> If you want the latest version, then you may built it from the git
> repository :
>   I.1. Download the git directory
>     If you don't already have a local copy :
>     git clone [...]

(Already in the README.)

>   I.2. Get pre-requisit rpms :
>     yum install xmlto [...]

"yum-builddep systemtap" should work about as well as that list.


>   I.3. Configure and build :
>     cd systemtap.git
>     ./configure
> [...]

(Already in README.)

> II Configure your kernel :
>
>     yum install kernel-devel-`uname -r`
>     debuginfo-install kernel-`uname -r`
> [...]

These could be added to the README.


Hm, how about posting a proposed patch for the README file
for the couple of items that are missing?


- FChE

Re: Comments on Installation Guide

[Daniel Migault]

[-- Attachment #1: Type: text/plain, Size: 1910 bytes --]

Hi Frank,

Thanks for your feed back. Here is a an update of the README file. I
added items not already in the README. Feel free to remove those you
believe are not useful.

Regards,
Daniel

On Sun, Jun 5, 2011 at 1:18 PM, Frank Ch. Eigler <fche@redhat.com> wrote:
>
> Hi, Daniel -
>
>
> mglt.biz wrote:
>
> > I went through the documentation, and maybe I would add a few
> > indications for the installation. It looks that some of them have
> > been removed from previous installation guides.
>
> Such distribution-specific information could go into the wiki, or
> perhaps new README.fedora type files.  Note that the main README
> already has similar information.
>
> > I Install systemtap
> >
> > If you want to install systemtap from rpm :
> >   yum install systemtap systemtap-client systemtap-grapher
> > systemtap-runtime systemtap-sdt-devel systemtap-server
> > systemtap-testsuite
>
> The basic requirement is only systemtap and systemtap-runtime.
>
>
> > If you want the latest version, then you may built it from the git
> > repository :
> >   I.1. Download the git directory
> >     If you don't already have a local copy :
> >     git clone [...]
>
> (Already in the README.)
>
> >   I.2. Get pre-requisit rpms :
> >     yum install xmlto [...]
>
> "yum-builddep systemtap" should work about as well as that list.
>
>
> >   I.3. Configure and build :
> >     cd systemtap.git
> >     ./configure
> > [...]
>
> (Already in README.)
>
> > II Configure your kernel :
> >
> >     yum install kernel-devel-`uname -r`
> >     debuginfo-install kernel-`uname -r`
> > [...]
>
> These could be added to the README.
>
>
> Hm, how about posting a proposed patch for the README file
> for the couple of items that are missing?
>
>
> - FChE



--
Daniel Migault
Orange Labs / Security Lab
+33 (0) 1 45 29 60 52
+33 (0) 6 70 72 69 58

[-- Attachment #2: README-updated --]
[-- Type: application/octet-stream, Size: 1436 bytes --]

*** README	2011-07-04 10:12:27.000000000 +0200
--- README-mglt	2011-07-04 10:53:44.000000000 +0200
***************
*** 29,34 ****
--- 29,48 ----
  
  - Install the kernel-debuginfo, kernel-devel, gcc and dependent
    packages (or see below if you are building your own kernels from source).
+   On modern Fedora kernel-debuginfo and kernel-devel packages can be installed
+   by typing : 
+   # yum install kernel-devel-`uname -r`
+   # debufinfo-install kernel-`uname -r`
+  
+   If installation does not succeed, then you can install manually the packages
+   by using dpkg --force -ivh <package>.
+ 
+ - Systemtap installation can be proceeded from precompiled binaries (rpm) or 
+   you can build the lastest version from the repository .If you want to install
+   system from binaries, then you may type :
+   #yum install systemtap systemtap-runtime
+ 
+   Following sections details how to build systemtap from the repository.
  
  - If available, install your distribution's copy of elfutils and its
    development headers/libraries.
***************
*** 87,92 ****
--- 101,110 ----
    by "stap -p4 ...") that a system administrator copied under
    /lib/modules/`uname -r`/systemtap.
  
+   To run a simple test.
+   %stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'
+   If that does not work you may reboot your system. 
+ 
    To run the full test suite from the build tree.
    % sudo make installcheck