projects / lttv.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Added comments
[lttv.git] / ltt / branches / poly / QUICKSTART
diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART
index 94db2faa225794f314a11ada282599f9cbf246f8..61bf32648c3961f5b312a14e46400caa381a8981 100644 (file)
--- a/ltt/branches/poly/QUICKSTART
+++ b/ltt/branches/poly/QUICKSTART
@@ -13,9 +13,15 @@ What you will typically want is to read sections 1 and 3 : install LTTng from
 binary packages and use it. If there are no packages ready for your system, you
 will have to install from sources (section 2) instead.
 
 binary packages and use it. If there are no packages ready for your system, you
 will have to install from sources (section 2) instead.
 
-These operations are made for installing the LTTng 0.5.18 tracer on a
-linux 2.6.15 kernel. You will also find instructions for installation of
-LTTV 0.8.x : the Linux Trace Toolkit Viewer.
+These operations are made for installing the LTTng 0.5.X tracer on a
+linux 2.6.X kernel. You will also find instructions for installation of
+LTTV 0.8.x : the Linux Trace Toolkit Viewer. 
+
+To see the list of compatibilities between LTTng, ltt-control, LTTV, genevent
+and lttng-modules, please refer to :
+http://ltt.polymtl.ca > LTTng+LTTV versions compatibility
+
+
 
 The following lttng patch is necessary to have the tracing hooks in the kernel.
 The following ltt-control module controls the tracing.
 
 The following lttng patch is necessary to have the tracing hooks in the kernel.
 The following ltt-control module controls the tracing.
@@ -30,6 +36,8 @@ sources, the dependencies are listed.
 LTTng : 
 supported architectures : 
 Intel Pentium (UP/SMP) with TSC
 LTTng : 
 supported architectures : 
 Intel Pentium (UP/SMP) with TSC
+ARM
+C2 Microsystems (variant of MIPS)
 
 LTTV :
 supported architectures :
 
 LTTV :
 supported architectures :
@@ -40,7 +48,7 @@ PowerPC
 
 
 Author : Mathieu Desnoyers, September 2005
 
 
 Author : Mathieu Desnoyers, September 2005
-Last update : January 10, 2006
+Last update : May 13, 2006
 
 
 ***********************************************************
 
 
 ***********************************************************
@@ -49,7 +57,9 @@ Last update : January 10, 2006
 
 ** NOTE : RPM and debian packages are only made once a version has been
    thoroughly tested. If they do not exist at the moment, please install from
 
 ** NOTE : RPM and debian packages are only made once a version has been
    thoroughly tested. If they do not exist at the moment, please install from
-        sources (see section 2 below).
+        sources (see section 2 below). To see the list of compatibilities between
+        LTTng, ltt-control, LTTV, genevent and lttng-modules, please refer to
+        http://ltt.polymtl.ca > LTTng+LTTV versions compatibility
 
 
 * Install from RPM packages on Fedora Core 4 :
 
 
 * Install from RPM packages on Fedora Core 4 :
@@ -157,7 +167,7 @@ o  module-init-tools      0.9.10                  # depmod -V
 You might also want to have libncurses5 to have the text mode kernel
 configuration menu, but there are alternatives.
 
 You might also want to have libncurses5 to have the text mode kernel
 configuration menu, but there are alternatives.
 
-Prerequisites for LTTV 0.6.x installation are :
+Prerequisites for LTTV 0.x.x installation are :
 
 gcc 3.2 or better
 gtk 2.4 or better development libraries
 
 gcc 3.2 or better
 gtk 2.4 or better development libraries
@@ -185,28 +195,26 @@ su -
 mkdir /usr/src/lttng
 cd /usr/src/lttng
 (see http://ltt.polymtl.ca/lttng for package listing)
 mkdir /usr/src/lttng
 cd /usr/src/lttng
 (see http://ltt.polymtl.ca/lttng for package listing)
-wget http://ltt.polymtl.ca/lttng/lttng-modules-0.5.tar.bz2
-wget http://ltt.polymtl.ca/lttng/patch-2.6.15-lttng-0.5.18.tar.bz2
-bzip2 -cd lttng-modules-0.5.tar.bz2 | tar xvof -
-bzip2 -cd patch-2.6.15-lttng-0.5.18.tar.bz2 | tar xvof -
+wget http://ltt.polymtl.ca/lttng/patch-2.6.16-lttng-0.x.xx.tar.bz2
+bzip2 -cd patch-2.6.16-lttng-0.x.xx.tar.bz2 | tar xvof -
 
 
 * Getting LTTng kernel sources
 
 su -
 cd /usr/src
 
 
 * Getting LTTng kernel sources
 
 su -
 cd /usr/src
-wget http://kernel.org/pub/linux/kernel/v2.6/testing/linux-2.6.15.tar.bz2
-bzip2 -cd linux-2.6.15.tar.bz2 | tar xvof -
-cd linux-2.6.15
-cat /usr/src/lttng/patch-2.6.15-lttng-0.5.18* | patch -p1
+wget http://kernel.org/pub/linux/kernel/v2.6/testing/linux-2.6.16.tar.bz2
+bzip2 -cd linux-2.6.16.tar.bz2 | tar xvof -
+cd linux-2.6.16
+cat /usr/src/lttng/patch-2.6.16-lttng-0.x.xx* | patch -p1
 cd ..
 cd ..
-mv linux-2.6.15 linux-2.6.15-lttng-0.5.18
+mv linux-2.6.16 linux-2.6.16-lttng-0.x.xx
 
 
 * Installing a LTTng kernel
 
 su -
 
 
 * Installing a LTTng kernel
 
 su -
-cd /usr/src/linux-2.6.15-lttng-0.5.18
+cd /usr/src/linux-2.6.16-lttng-0.x.xx
 make menuconfig (or make xconfig or make config)
     Select the < Help > button if you are not familiar with kernel
     configuration.
 make menuconfig (or make xconfig or make config)
     Select the < Help > button if you are not familiar with kernel
     configuration.
@@ -221,7 +229,8 @@ make menuconfig (or make xconfig or make config)
         is compiled built-in or as a module.
     activate :
        [*] Align Linux Trace Toolkit Traces
         is compiled built-in or as a module.
     activate :
        [*] Align Linux Trace Toolkit Traces
-    do NOT activate (not ready yet) :
+       [*] Allow tracing from userspace
+    your choice (see < Help >) :
        [ ] Activate Linux Trace Toolkit Heartbeat Timer
                You may or may not activate instrumentation per facility. They are all
                selected for logging by default. It can be used as a compile time filter to
        [ ] Activate Linux Trace Toolkit Heartbeat Timer
                You may or may not activate instrumentation per facility. They are all
                selected for logging by default. It can be used as a compile time filter to
@@ -237,15 +246,7 @@ make install
 
 reboot
 
 
 reboot
 
-  Select the Linux 2.6.15-lttng-0.5.18 kernel in your boot loader.
-
-
-* Install the ltt-modules
-
-su -
-cd /usr/src/lttng/lttng-modules-0.5
-KERNELDIR=/usr/src/linux-2.6.15-lttng-0.5.18 make
-KERNELDIR=/usr/src/linux-2.6.15-lttng-0.5.18 make modules_install
+  Select the Linux 2.6.16-lttng-0.x.xx kernel in your boot loader.
 
 
 * Editing the system wide configuration
 
 
 * Editing the system wide configuration
@@ -280,13 +281,29 @@ echo ltt-control >> /etc/modules
 echo ltt-statedump >> /etc/modules
 
 
 echo ltt-statedump >> /etc/modules
 
 
-* Getting and installing the LTTV package
+* Getting and installing the ltt-control package (on the traced machine)
+(note : the ltt-control package contains lttd and lttctl. Although it has the
+same name as the ltt-control kernel module, they are *not* the same thing.)
+su -
+cd /usr/src
+wget http://ltt.polymtl.ca/lttng/ltt-control-0.x-xxxx2006.tar.gz
+gzip -cd ltt-control-0.x-xxxx2006.tar.gz | tar xvof -
+cd ltt-control-0.x-xxxx2006
+(refer to README to see the development libraries that must be installed on you
+system)
+./configure
+make
+make install
+
+
+* Getting and installing the LTTV package (on the visualisation machine, same or
+  different from the visualisation machine)
 
 su -
 cd /usr/src
 
 su -
 cd /usr/src
-wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.8.13-07022006.tar.gz
-gzip -cd LinuxTraceToolkitViewer-0.8.13-07022006.tar.gz | tar xvof -
-cd LinuxTraceToolkitViewer-0.8.13-07022006
+wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.x.xx-xxxx2006.tar.gz
+gzip -cd LinuxTraceToolkitViewer-0.x.xx-xxxx2006.tar.gz | tar xvof -
+cd LinuxTraceToolkitViewer-0.x.xx-xxxx2006
 (refer to README to see the development libraries that must be installed on you
 system)
 ./configure
 (refer to README to see the development libraries that must be installed on you
 system)
 ./configure
@@ -349,9 +366,9 @@ see lttv -m textDump --help for detailed command line options of textDump.
 
 su -
 cd /usr/src
 
 su -
 cd /usr/src
-wget http://ltt.polymtl.ca/packages/genevent-0.6.tar.gz
-gzip -cd genevent-0.8.tar.gz | tar xvof -
-cd genevent-0.8
+wget http://ltt.polymtl.ca/packages/genevent-0.xx.tar.gz
+gzip -cd genevent-0.xx.tar.gz | tar xvof -
+cd genevent-0.xx
 make
 make install
 
 make
 make install
 
@@ -365,14 +382,14 @@ cp process.xml yourfacility.xml
 cd /tmp
 /usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/facilities/yourfacility.xml
 cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \
 cd /tmp
 /usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/facilities/yourfacility.xml
 cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \
-         /usr/src/linux-2.6.15-lttng-0.5.18/include/linux/ltt
+         /usr/src/linux-2.6.16-lttng-0.x.xx8/include/linux/ltt
 cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \
 cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \
-         /usr/src/linux-2.6.15-lttng-0.5.18/ltt
+         /usr/src/linux-2.6.16-lttng-0.x.xx/ltt
   * edit the kernel file you want to instrument
     - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
       of the file.
     - Add a call to the tracing functions. See their names and parameters in
   * edit the kernel file you want to instrument
     - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
       of the file.
     - Add a call to the tracing functions. See their names and parameters in
-      /usr/src/linux-2.6.15-lttng-0.5.18/include/linux/ltt/ltt-facility-yourfacility.h
+      /usr/src/linux-2.6.16-lttng-0.x.xx/include/linux/ltt/ltt-facility-yourfacility.h
     
 
 
     
 
 
LTTng 2.x Viewer (LTTV)
This page took 0.025346 seconds and 4 git commands to generate.