From 01b2f702118f65edddee788f1b407580b0074599 Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Tue, 14 Mar 2017 19:07:59 -0400 Subject: [PATCH] 2.8, 2.9: installation: update availability and instructions Signed-off-by: Philippe Proulx --- 2.8/lttng-docs-2.8.txt | 119 +++++++--------------------------- 2.9/lttng-docs-2.9.txt | 141 +++++++++++++++++++++++++++++++++++++---- 2 files changed, 149 insertions(+), 111 deletions(-) diff --git a/2.8/lttng-docs-2.8.txt b/2.8/lttng-docs-2.8.txt index f172904..f69a074 100644 --- a/2.8/lttng-docs-2.8.txt +++ b/2.8/lttng-docs-2.8.txt @@ -1,7 +1,7 @@ The LTTng Documentation ======================= Philippe Proulx -v2.8, 20 February 2017 +v2.8, 14 March 2017 include::../common/copyright.txt[] @@ -381,7 +381,7 @@ but note that: applications. [role="growable"] -.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 2 December 2016. +.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 14 March 2017. |==== |Distribution |Available in releases |Alternatives @@ -395,6 +395,9 @@ LTTng{nbsp}2.9 for Ubuntu{nbsp}14.04 _Trusty Tahr_ and Ubuntu{nbsp}16.04 _Xenial Xerus_: link:/docs/v2.9#doc-ubuntu-ppa[use the LTTng Stable{nbsp}2.9 PPA]. +LTTng{nbsp}2.9 for Ubuntu{nbsp}17.04 _Zesty Zapus_ (not released +yet). + <> for other Ubuntu releases. @@ -404,9 +407,11 @@ other Ubuntu releases. other Fedora releases. |https://www.debian.org/[Debian] -|<>. -|<> for -previous Debian releases. +|_Not available_ +|link:/docs/v2.9#doc-debian[LTTng{nbsp}2.9 for Debian "stretch" (testing) +and Debian "sid" (unstable)]. + +<>. |https://www.opensuse.org/[openSUSE] |_Not available_ @@ -416,12 +421,13 @@ previous Debian releases. |_Not available_ |link:/docs/v2.9#doc-arch-linux[LTTng{nbsp}2.9 from the AUR]. +<>. + |https://alpinelinux.org/[Alpine Linux] -|<>. -|LTTng{nbsp}{revision} for Alpine Linux{nbsp}3.5 (not released yet). +|_Not available_ +|link:/docs/v2.9#doc-alpine-linux[LTTng{nbsp}2.9 for Alpine Linux "edge"]. -<> for -other Alpine Linux releases. +<>. |https://www.redhat.com/[RHEL] and https://www.suse.com/[SLES] |See http://packages.efficios.com/[EfficiOS Enterprise Packages]. @@ -429,13 +435,18 @@ other Alpine Linux releases. |https://buildroot.org/[Buildroot] |<>. -|<> for +|link:/docs/v2.9#doc-buildroot[LTTng{nbsp}2.9 for Buildroot 2017.02]. + +<> for other Buildroot releases. |http://www.openembedded.org/wiki/Main_Page[OpenEmbedded] and https://www.yoctoproject.org/[Yocto] |<> (`openembedded-core` layer). -|<> for +|LTTng{nbsp}2.9 for Yocto Project{nbsp}2.3 _Pyro_ +(`openembedded-core` layer) (not released yet). + +<> for other OpenEmbedded releases. |==== @@ -588,92 +599,6 @@ LTTng-UST{nbsp}{revision} from source and pass the ==== -[[debian]] -=== Debian - -To install LTTng{nbsp}{revision} on Debian "stretch" (testing): - -. Install the main LTTng{nbsp}{revision} packages: -+ --- -[role="term"] ----- -# apt-get install lttng-modules-dkms -# apt-get install liblttng-ust-dev -# apt-get install lttng-tools ----- --- - -. **If you need to instrument and trace <>**, install the LTTng-UST Java agent: -+ --- -[role="term"] ----- -# apt-get install liblttng-ust-agent-java ----- --- - -. **If you need to instrument and trace <>**, install the LTTng-UST Python agent: -+ --- -[role="term"] ----- -# apt-get install python3-lttngust ----- --- - - -[[alpine-linux]] -=== Alpine Linux - -To install LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} on -Alpine Linux "edge": - -. Make sure your system is - https://wiki.alpinelinux.org/wiki/Edge[configured for "edge"]. -. Enable the _testing_ repository by uncommenting the corresponding - line in path:{/etc/apk/repositories}. -. Add the LTTng packages: -+ --- -[role="term"] ----- -# apk add lttng-tools -# apk add lttng-ust-dev ----- --- - -To install LTTng-modules{nbsp}{revision} (Linux kernel tracing support) -on Alpine Linux "edge": - -. Add the vanilla Linux kernel: -+ --- -[role="term"] ----- -# apk add linux-vanilla linux-vanilla-dev ----- --- - -. Reboot with the vanilla Linux kernel. -. Download, build, and install the latest LTTng-modules{nbsp}{revision}: -+ --- -[role="term"] ----- -$ cd $(mktemp -d) && -wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.8.tar.bz2 && -tar -xf lttng-modules-latest-2.8.tar.bz2 && -cd lttng-modules-2.8.* && -make && -sudo make modules_install && -sudo depmod -a ----- --- - - [[enterprise-distributions]] === RHEL, SUSE, and other enterprise distributions diff --git a/2.9/lttng-docs-2.9.txt b/2.9/lttng-docs-2.9.txt index 79110f3..7eaf636 100644 --- a/2.9/lttng-docs-2.9.txt +++ b/2.9/lttng-docs-2.9.txt @@ -1,7 +1,7 @@ The LTTng Documentation ======================= Philippe Proulx -v2.9, 20 February 2017 +v2.9, 14 March 2017 include::../common/copyright.txt[] @@ -340,7 +340,7 @@ but note that: applications. [role="growable"] -.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 2 December 2016. +.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 14 March 2017. |==== |Distribution |Available in releases |Alternatives @@ -349,18 +349,23 @@ but note that: <>. |link:/docs/v2.8#doc-ubuntu[LTTng{nbsp}2.8 for Ubuntu{nbsp}16.10 _Yakkety Yak_]. +LTTng{nbsp}{revision} for Ubuntu{nbsp}17.04 _Zesty Zapus_ (not released +yet). + <> for other Ubuntu releases. |https://getfedora.org/[Fedora] |_Not available_ -|<>. |https://www.debian.org/[Debian] -|_Not available_ -|<>. +|<>. +|<> for +other Debian releases. |https://www.opensuse.org/[openSUSE] |_Not available_ @@ -372,12 +377,8 @@ source>>. | |https://alpinelinux.org/[Alpine Linux] -|_Not available_ -|link:/docs/v2.8#doc-alpine-linux[LTTng{nbsp}2.8 for Alpine Linux{nbsp}"edge"]. - -LTTng{nbsp}2.8 for Alpine Linux{nbsp}3.5 (not released yet). - -<> for +|<>. +|<> for other Alpine Linux releases. |https://www.redhat.com/[RHEL] and https://www.suse.com/[SLES] @@ -385,8 +386,8 @@ other Alpine Linux releases. | |https://buildroot.org/[Buildroot] -|_Not available_ -|link:/docs/v2.8#doc-buildroot[LTTng{nbsp}2.8 for Buildroot{nbsp}2016.11]. +|<>. +|link:/docs/v2.8#doc-buildroot[LTTng{nbsp}2.8 for Buildroot 2016.11]. <> for other Buildroot releases. @@ -397,6 +398,9 @@ https://www.yoctoproject.org/[Yocto] |link:/docs/v2.8#doc-oe-yocto[LTTng{nbsp}2.8 for Yocto Project{nbsp}2.2 _Morty_] (`openembedded-core` layer). +LTTng{nbsp}{revision} for Yocto Project{nbsp}2.3 _Pyro_ +(`openembedded-core` layer) (not released yet). + <> for other OpenEmbedded releases. |==== @@ -462,6 +466,44 @@ To install LTTng{nbsp}{revision} from the LTTng Stable{nbsp}{revision} PPA: -- +[[debian]] +=== Debian + +To install LTTng{nbsp}{revision} on Debian "stretch" (testing) or +Debian "sid" (unstable): + +. Install the main LTTng{nbsp}{revision} packages: ++ +-- +[role="term"] +---- +# apt-get install lttng-modules-dkms +# apt-get install liblttng-ust-dev +# apt-get install lttng-tools +---- +-- + +. **If you need to instrument and trace <>**, install the LTTng-UST Java agent: ++ +-- +[role="term"] +---- +# apt-get install liblttng-ust-agent-java +---- +-- + +. **If you need to instrument and trace <>**, install the LTTng-UST Python agent: ++ +-- +[role="term"] +---- +# apt-get install python3-lttngust +---- +-- + + [[arch-linux]] === Arch Linux @@ -491,6 +533,55 @@ $ yaourt -S python2-lttngust -- +[[alpine-linux]] +=== Alpine Linux + +To install LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} on +Alpine Linux "edge": + +. Make sure your system is + https://wiki.alpinelinux.org/wiki/Edge[configured for "edge"]. +. Enable the _testing_ repository by uncommenting the corresponding + line in path:{/etc/apk/repositories}. +. Add the LTTng packages: ++ +-- +[role="term"] +---- +# apk add lttng-tools +# apk add lttng-ust-dev +---- +-- + +To install LTTng-modules{nbsp}{revision} (Linux kernel tracing support) +on Alpine Linux "edge": + +. Add the vanilla Linux kernel: ++ +-- +[role="term"] +---- +# apk add linux-vanilla linux-vanilla-dev +---- +-- + +. Reboot with the vanilla Linux kernel. +. Download, build, and install the latest LTTng-modules{nbsp}{revision}: ++ +-- +[role="term"] +---- +$ cd $(mktemp -d) && +wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.8.tar.bz2 && +tar -xf lttng-modules-latest-2.8.tar.bz2 && +cd lttng-modules-2.8.* && +make && +sudo make modules_install && +sudo depmod -a +---- +-- + + [[enterprise-distributions]] === RHEL, SUSE, and other enterprise distributions @@ -499,6 +590,28 @@ Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SUSE), please see http://packages.efficios.com/[EfficiOS Enterprise Packages]. +[[buildroot]] +=== Buildroot + +To install LTTng{nbsp}{revision} on Buildroot{nbsp}2017.02: + +. Launch the Buildroot configuration tool: ++ +-- +[role="term"] +---- +$ make menuconfig +---- +-- + +. In **Kernel**, check **Linux kernel**. +. In **Toolchain**, check **Enable WCHAR support**. +. In **Target packages**{nbsp}→ **Debugging, profiling and benchmark**, + check **lttng-modules** and **lttng-tools**. +. In **Target packages**{nbsp}→ **Libraries**{nbsp}→ + **Other**, check **lttng-libust**. + + [[building-from-source]] === Build from source -- 2.34.1