From cdb6897339cfeb5a7b280692b888d8fced808209 Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Tue, 3 Oct 2017 19:25:43 -0400 Subject: [PATCH] 2.9, 2.10: update installation instructions Signed-off-by: Philippe Proulx --- 2.10/lttng-docs-2.10.txt | 138 ++++++++++++++++++++++++++++++++++++--- 2.9/lttng-docs-2.9.txt | 62 +++++------------- 2 files changed, 146 insertions(+), 54 deletions(-) diff --git a/2.10/lttng-docs-2.10.txt b/2.10/lttng-docs-2.10.txt index bda65ce..bee4fce 100644 --- a/2.10/lttng-docs-2.10.txt +++ b/2.10/lttng-docs-2.10.txt @@ -1,7 +1,7 @@ The LTTng Documentation ======================= Philippe Proulx -v2.10, 1 August 2017 +v2.10, 3 October 2017 include::../common/copyright.txt[] @@ -321,7 +321,7 @@ but note that: applications. [role="growable"] -.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 25 July 2017. +.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 3 October 2017. |==== |Distribution |Available in releases |Alternatives @@ -334,21 +334,21 @@ but note that: other Ubuntu releases. |https://getfedora.org/[Fedora] -|_Not available_ +|<>. |link:/docs/v2.9#doc-fedora[LTTng{nbsp}2.9 for Fedora 26]. -<>. +<> for +other Fedora releases. |https://www.debian.org/[Debian] -|_Not available_ -|link:/docs/v2.9#doc-debian[LTTng{nbsp}2.9 for Debian "stretch" -(stable), Debian "buster" (testing), and Debian "sid" (unstable)]. +|<>. +|link:/docs/v2.9#doc-debian[LTTng{nbsp}2.9 for Debian "stretch" (stable)]. <>. |https://www.archlinux.org/[Arch Linux] -|_Not available_ -|link:/docs/v2.9#doc-arch-linux[LTTng{nbsp}2.9 in the latest AUR packages]. +|<>. +|<>. |https://alpinelinux.org/[Alpine Linux] |_Not available_ @@ -437,6 +437,126 @@ To install LTTng{nbsp}{revision} from the LTTng Stable{nbsp}{revision} PPA: -- +[[fedora]] +=== Fedora + +To install LTTng{nbsp}{revision} on Fedora{nbsp}27: + +. Install the LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} + packages: ++ +-- +[role="term"] +---- +# yum install lttng-tools +# yum install lttng-ust +---- +-- + +. 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.10.tar.bz2 && +tar -xf lttng-modules-latest-2.10.tar.bz2 && +cd lttng-modules-2.10.* && +make && +sudo make modules_install && +sudo depmod -a +---- +-- + +[IMPORTANT] +.Java and Python application instrumentation and tracing +==== +If you need to instrument and trace <> on Fedora, you need to build and install +LTTng-UST{nbsp}{revision} <> and pass +the `--enable-java-agent-jul`, `--enable-java-agent-log4j`, or +`--enable-java-agent-all` options to the `configure` script, depending +on which Java logging framework you use. + +If you need to instrument and trace <> on Fedora, you need to build and install +LTTng-UST{nbsp}{revision} from source and pass the +`--enable-python-agent` option to the `configure` script. +==== + + +[[debian]] +=== Debian + +To install LTTng{nbsp}{revision} on Debian "buster" (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 + +LTTng-UST{nbsp}{revision} is available in Arch Linux's _Community_ +repository, while LTTng-tools{nbsp}{revision} and +LTTng-modules{nbsp}{revision} are available in the +https://aur.archlinux.org/[AUR]. + +To install LTTng{nbsp}{revision} on Arch Linux, using +https://github.com/rmarquis/pacaur[pacaur] for the AUR packages: + +. Install the main LTTng{nbsp}{revision} packages: ++ +-- +[role="term"] +---- +# pacman -Sy lttng-ust +$ pacaur -Sy lttng-tools +$ pacaur -Sy lttng-modules +---- +-- + +. **If you need to instrument and trace <>**, install the LTTng-UST Python agent: ++ +-- +[role="term"] +---- +# pacman -Sy python-lttngust +# pacman -Sy python2-lttngust +---- +-- + + [[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 2457b8c..4a4962f 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, 25 July 2017 +v2.9, 3 October 2017 include::../common/copyright.txt[] @@ -340,12 +340,12 @@ but note that: applications. [role="growable"] -.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 25 July 2017. +.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 3 October 2017. |==== |Distribution |Available in releases |Alternatives |https://www.ubuntu.com/[Ubuntu] -|<>. +|<>. Ubuntu{nbsp}14.04 _Trusty Tahr_ and Ubuntu{nbsp}16.04 _Xenial Xerus_: <>. @@ -354,20 +354,21 @@ other Ubuntu releases. |https://getfedora.org/[Fedora] |<>. -|link:/docs/v2.8#doc-fedora[LTTng{nbsp}2.8 for Fedora 25]. +|link:/docs/v2.10#doc-fedora[LTTng{nbsp}2.10 for Fedora 27]. <> for other Fedora releases. |https://www.debian.org/[Debian] -|xref:debian[Debian "stretch" (stable), Debian "buster" (testing), -and Debian "sid" (unstable)]. +|xref:debian[Debian "stretch" (stable)]. |<> for other Debian releases. |https://www.archlinux.org/[Arch Linux] -|<>. -| +|_Not available_ +|link:/docs/v2.10#doc-arch-linux[LTTng{nbsp}2.10 for the current Arch Linux build]. + +<>. |https://alpinelinux.org/[Alpine Linux] |<>. @@ -379,7 +380,8 @@ other Alpine Linux releases. | |https://buildroot.org/[Buildroot] -|<>. +|xref:buildroot[Buildroot{nbsp}2017.02, Buildroot{nbsp}2017.05, and +Buildroot{nbsp}2017.08]. |link:/docs/v2.8#doc-buildroot[LTTng{nbsp}2.8 for Buildroot{nbsp}2016.11]. <> for @@ -399,9 +401,9 @@ other OpenEmbedded releases. [[ubuntu]] === [[ubuntu-official-repositories]]Ubuntu -LTTng{nbsp}{revision} is available on Ubuntu{nbsp}17.04 _Zesty Zapus_. -For previous releases of Ubuntu, <>. +LTTng{nbsp}{revision} is available on Ubuntu{nbsp}17.04 _Zesty Zapus_ +and Ubuntu{nbsp}17.10 _Artful Aardvark_. For previous releases of +Ubuntu, <>. To install LTTng{nbsp}{revision} on Ubuntu{nbsp}17.04 _Zesty Zapus_: @@ -547,8 +549,7 @@ LTTng-UST{nbsp}{revision} from source and pass the [[debian]] === Debian -To install LTTng{nbsp}{revision} on Debian "stretch" (stable), -Debian "buster" (testing), or Debian "sid" (unstable): +To install LTTng{nbsp}{revision} on Debian "stretch" (stable): . Install the main LTTng{nbsp}{revision} packages: + @@ -582,35 +583,6 @@ Debian "buster" (testing), or Debian "sid" (unstable): -- -[[arch-linux]] -=== Arch Linux - -To install LTTng{nbsp}{revision} on Arch Linux using -https://github.com/rmarquis/pacaur[pacaur]: - -. Install the main LTTng{nbsp}{revision} packages: -+ --- -[role="term"] ----- -$ pacaur -Sy lttng-tools -$ pacaur -Sy lttng-ust -$ pacaur -Sy lttng-modules ----- --- - -. **If you need to instrument and trace <>**, install the LTTng-UST Python agent: -+ --- -[role="term"] ----- -$ pacaur -Sy python-lttngust -$ pacaur -Sy python2-lttngust ----- --- - - [[alpine-linux]] === Alpine Linux @@ -671,8 +643,8 @@ see http://packages.efficios.com/[EfficiOS Enterprise Packages]. [[buildroot]] === Buildroot -To install LTTng{nbsp}{revision} on Buildroot{nbsp}2017.02 or -Buildroot{nbsp}2017.05: +To install LTTng{nbsp}{revision} on Buildroot{nbsp}2017.02, +Buildroot{nbsp}2017.05, or Buildroot{nbsp}2017.08: . Launch the Buildroot configuration tool: + -- 2.34.1