From 34d65fe01022a8dfd9e50db3ed946a4e9d2f8c85 Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Mon, 12 Nov 2018 17:22:58 -0500 Subject: [PATCH] 2.10: update installation instructions Signed-off-by: Philippe Proulx --- 2.10/lttng-docs-2.10.txt | 154 +++++++++++++++++++++++++-------------- 1 file changed, 101 insertions(+), 53 deletions(-) diff --git a/2.10/lttng-docs-2.10.txt b/2.10/lttng-docs-2.10.txt index bbcb247..c11acdb 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, 22 January 2018 +v2.10, 12 November 2018 include::../common/copyright.txt[] @@ -321,37 +321,36 @@ but note that: applications. [role="growable"] -.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 22 January 2018. +.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 12 November 2018. |==== |Distribution |Available in releases |Alternatives |https://www.ubuntu.com/[Ubuntu] -|Ubuntu{nbsp}14.04 _Trusty Tahr_ and Ubuntu{nbsp}16.04 _Xenial Xerus_: -<>. -|link:/docs/v2.9#doc-ubuntu[LTTng{nbsp}2.9 for Ubuntu{nbsp}17.04 _Zesty Zapus_ and Ubuntu{nbsp}17.10 _Artful Aardvark_]. +|<>. -<> for -other Ubuntu releases. +Ubuntu{nbsp}14.04 _Trusty Tahr_, Ubuntu{nbsp}16.04 _Xenial Xerus_, +and Ubuntu{nbsp}18.04 _Bionic Beaver_: +<>. +|<>. |https://getfedora.org/[Fedora] -|<>. -|link:/docs/v2.9#doc-fedora[LTTng{nbsp}2.9 for Fedora{nbsp}26]. - -<> for -other Fedora releases. +|<>. +|<>. |https://www.debian.org/[Debian] -|<>. -|link:/docs/v2.9#doc-debian[LTTng{nbsp}2.9 for Debian "stretch" (stable)]. - -<>. +|<>. +|<>. |https://www.archlinux.org/[Arch Linux] |<>. |<>. |https://alpinelinux.org/[Alpine Linux] -|<>. +|<>. +|<>. + +|https://www.opensuse.org/[openSUSE] +|<>. |<>. |https://www.redhat.com/[RHEL] and https://www.suse.com/[SLES] @@ -359,26 +358,60 @@ other Fedora releases. | |https://buildroot.org/[Buildroot] -|_Not available_ -|link:/docs/v2.9#doc-buildroot[LTTng{nbsp}2.9 for Buildroot{nbsp}2017.02, -Buildroot{nbsp}2017.05, Buildroot{nbsp}2017.08, and Buildroot{nbsp}2017.11]. - -<>. +|<>. +|<>. |http://www.openembedded.org/wiki/Main_Page[OpenEmbedded] and https://www.yoctoproject.org/[Yocto] |_Not available_ -|link:/docs/v2.9#doc-oe-yocto[LTTng{nbsp}2.9 for Yocto Project{nbsp}2.3 _Pyro_ -and Yocto Project{nbsp}2.4 _Rocko_] -(`openembedded-core` layer). - -<>. +|<>. |==== [[ubuntu]] === [[ubuntu-official-repositories]]Ubuntu +LTTng{nbsp}{revision} is available on Ubuntu{nbsp}18.04 _Bionic Beaver_. +For previous supported releases of Ubuntu, +<>. + +To install LTTng{nbsp}{revision} on Ubuntu{nbsp}18.04 _Bionic Beaver_: + +. Install the main LTTng{nbsp}{revision} packages: ++ +-- +[role="term"] +---- +# apt-get install lttng-tools +# apt-get install lttng-modules-dkms +# apt-get install liblttng-ust-dev +---- +-- + +. **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 +---- +-- + + [[ubuntu-ppa]] ==== noch:{LTTng} Stable {revision} PPA @@ -388,6 +421,7 @@ LTTng{nbsp}{revision} packages for: * Ubuntu{nbsp}14.04 _Trusty Tahr_ * Ubuntu{nbsp}16.04 _Xenial Xerus_ +* Ubuntu{nbsp}18.04 _Bionic Beaver_ To install LTTng{nbsp}{revision} from the LTTng Stable{nbsp}{revision} PPA: @@ -439,7 +473,8 @@ To install LTTng{nbsp}{revision} from the LTTng Stable{nbsp}{revision} PPA: [[fedora]] === Fedora -To install LTTng{nbsp}{revision} on Fedora{nbsp}27: +To install LTTng{nbsp}{revision} on Fedora{nbsp}27, Fedora{nbsp}28, +or Fedora{nbsp}29: . Install the LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} packages: @@ -487,8 +522,7 @@ LTTng-UST{nbsp}{revision} from source and pass the [[debian]] === Debian -To install LTTng{nbsp}{revision} on Debian "buster" (testing) -or Debian "sid" (unstable): +To install LTTng{nbsp}{revision} on Debian "buster" (testing): . Install the main LTTng{nbsp}{revision} packages: + @@ -539,8 +573,8 @@ https://github.com/rmarquis/pacaur[pacaur] for the AUR packages: [role="term"] ---- # pacman -Sy lttng-ust -$ pacaur -Sy lttng-tools -$ pacaur -Sy lttng-modules +$ pikaur -Sy lttng-tools +$ pikaur -Sy lttng-modules ---- -- @@ -560,14 +594,8 @@ $ pacaur -Sy lttng-modules === Alpine Linux To install LTTng-tools{nbsp}{revision} and LTTng-UST{nbsp}{revision} on -Alpine Linux{nbsp}3.7 or Alpine Linux{nbsp}"edge": - -. **If you're installing for Alpine Linux{nbsp}"edge"**, make sure your - system is https://wiki.alpinelinux.org/wiki/Edge[configured for - "edge"]. -. **If you're installing for Alpine Linux{nbsp}"edge"**, enable the _testing_ - repository by uncommenting the corresponding line in - path:{/etc/apk/repositories}. +Alpine Linux{nbsp}3.7 or Alpine Linux{nbsp}3.8: + . Add the LTTng packages: + -- @@ -578,19 +606,6 @@ Alpine Linux{nbsp}3.7 or Alpine Linux{nbsp}"edge": ---- -- -To install LTTng-modules{nbsp}{revision} (Linux kernel tracing support) -on Alpine Linux{nbsp}3.7 or Alpine Linux{nbsp}"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}: + -- @@ -607,6 +622,39 @@ sudo depmod -a -- +[[opensuse]] +=== noch:{openSUSE} + +To install LTTng{nbsp}{revision} on openSUSE Leap{nbsp}15.0: + +* Install the main LTTng{nbsp}{revision} packages: ++ +-- +[role="term"] +---- +sudo zypper install lttng-tools +sudo zypper install lttng-modules +sudo zypper install lttng-ust-devel +---- +-- + +[IMPORTANT] +.Java and Python application instrumentation and tracing +==== +If you need to instrument and trace <> on openSUSE, 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 openSUSE, you need to build and install +LTTng-UST{nbsp}{revision} from source and pass the +`--enable-python-agent` option to the `configure` script. +==== + + [[enterprise-distributions]] === RHEL, SUSE, and other enterprise distributions -- 2.34.1