summaryrefslogtreecommitdiffstats
path: root/documentation/profile-manual/profile-manual-usage.xml
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2019-04-12 14:17:50 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2019-05-07 10:23:41 +0100
commit7625e3cffe18bb9e74fe76653d0f10fff60488ac (patch)
tree07b4f7678ddf23678020114153853cc81eed3629 /documentation/profile-manual/profile-manual-usage.xml
parentf2c6d6c84b70d587010b157dd11251a2a3655d57 (diff)
downloadpoky-7625e3cffe18bb9e74fe76653d0f10fff60488ac.tar.gz
profile-manual: Removed all references to Eclipse
One figure was removed and files modified. (From yocto-docs rev: f5d7024c3c38bc7737894a5ad4b750d4d633f173) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/profile-manual/profile-manual-usage.xml')
-rw-r--r--documentation/profile-manual/profile-manual-usage.xml180
1 files changed, 0 insertions, 180 deletions
diff --git a/documentation/profile-manual/profile-manual-usage.xml b/documentation/profile-manual/profile-manual-usage.xml
index a1b565157d..5999b29603 100644
--- a/documentation/profile-manual/profile-manual-usage.xml
+++ b/documentation/profile-manual/profile-manual-usage.xml
@@ -2350,22 +2350,8 @@
2350 <para> 2350 <para>
2351 For this section, we'll assume you've already performed the 2351 For this section, we'll assume you've already performed the
2352 basic setup outlined in the General Setup section. 2352 basic setup outlined in the General Setup section.
2353 </para>
2354
2355 <para>
2356 LTTng is run on the target system by ssh'ing to it. 2353 LTTng is run on the target system by ssh'ing to it.
2357 However, if you want to see the traces graphically,
2358 install Eclipse as described in section
2359 "<link linkend='manually-copying-a-trace-to-the-host-and-viewing-it-in-eclipse'>Manually copying a trace to the host and viewing it in Eclipse (i.e. using Eclipse without network support)</link>"
2360 and follow the directions to manually copy traces to the host and
2361 view them in Eclipse (i.e. using Eclipse without network support).
2362 </para> 2354 </para>
2363
2364 <note>
2365 Be sure to download and install/run the 'SR1' or later Juno release
2366 of eclipse e.g.:
2367 <ulink url='http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/juno/SR1/eclipse-cpp-juno-SR1-linux-gtk-x86_64.tar.gz'>http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/juno/SR1/eclipse-cpp-juno-SR1-linux-gtk-x86_64.tar.gz</ulink>
2368 </note>
2369 </section> 2355 </section>
2370 2356
2371 <section id='collecting-and-viewing-traces'> 2357 <section id='collecting-and-viewing-traces'>
@@ -2564,163 +2550,6 @@
2564 </para> 2550 </para>
2565 </section> 2551 </section>
2566 2552
2567 <section id='manually-copying-a-trace-to-the-host-and-viewing-it-in-eclipse'>
2568 <title>Manually copying a trace to the host and viewing it in Eclipse (i.e. using Eclipse without network support)</title>
2569
2570 <para>
2571 If you already have an LTTng trace on a remote target and
2572 would like to view it in Eclipse on the host, you can easily
2573 copy it from the target to the host and import it into
2574 Eclipse to view it using the LTTng Eclipse plug-in already
2575 bundled in the Eclipse (Juno SR1 or greater).
2576 </para>
2577
2578 <para>
2579 Using the trace we created in the previous section, archive
2580 it and copy it to your host system:
2581 <literallayout class='monospaced'>
2582 root@crownbay:~/lttng-traces# tar zcvf auto-20121015-232120.tar.gz auto-20121015-232120
2583 auto-20121015-232120/
2584 auto-20121015-232120/kernel/
2585 auto-20121015-232120/kernel/metadata
2586 auto-20121015-232120/kernel/channel0_1
2587 auto-20121015-232120/kernel/channel0_0
2588
2589 $ scp root@192.168.1.47:lttng-traces/auto-20121015-232120.tar.gz .
2590 root@192.168.1.47's password:
2591 auto-20121015-232120.tar.gz 100% 1566KB 1.5MB/s 00:01
2592 </literallayout>
2593 Unarchive it on the host:
2594 <literallayout class='monospaced'>
2595 $ gunzip -c auto-20121015-232120.tar.gz | tar xvf -
2596 auto-20121015-232120/
2597 auto-20121015-232120/kernel/
2598 auto-20121015-232120/kernel/metadata
2599 auto-20121015-232120/kernel/channel0_1
2600 auto-20121015-232120/kernel/channel0_0
2601 </literallayout>
2602 We can now import the trace into Eclipse and view it:
2603 <orderedlist>
2604 <listitem><para>First, start eclipse and open the
2605 'LTTng Kernel' perspective by selecting the following
2606 menu item:
2607 <literallayout class='monospaced'>
2608 Window | Open Perspective | Other...
2609 </literallayout></para></listitem>
2610 <listitem><para>In the dialog box that opens, select
2611 'LTTng Kernel' from the list.</para></listitem>
2612 <listitem><para>Back at the main menu, select the
2613 following menu item:
2614 <literallayout class='monospaced'>
2615 File | New | Project...
2616 </literallayout></para></listitem>
2617 <listitem><para>In the dialog box that opens, select
2618 the 'Tracing | Tracing Project' wizard and press
2619 'Next>'.</para></listitem>
2620 <listitem><para>Give the project a name and press
2621 'Finish'.</para></listitem>
2622 <listitem><para>In the 'Project Explorer' pane under
2623 the project you created, right click on the
2624 'Traces' item.</para></listitem>
2625 <listitem><para>Select 'Import..." and in the dialog
2626 that's displayed:</para></listitem>
2627 <listitem><para>Browse the filesystem and find the
2628 select the 'kernel' directory containing the trace
2629 you copied from the target
2630 e.g. auto-20121015-232120/kernel</para></listitem>
2631 <listitem><para>'Checkmark' the directory in the tree
2632 that's displayed for the trace</para></listitem>
2633 <listitem><para>Below that, select 'Common Trace Format:
2634 Kernel Trace' for the 'Trace Type'</para></listitem>
2635 <listitem><para>Press 'Finish' to close the dialog
2636 </para></listitem>
2637 <listitem><para>Back in the 'Project Explorer' pane,
2638 double-click on the 'kernel' item for the
2639 trace you just imported under 'Traces'
2640 </para></listitem>
2641 </orderedlist>
2642 You should now see your trace data displayed graphically
2643 in several different views in Eclipse:
2644 </para>
2645
2646 <para>
2647 <imagedata fileref="figures/lttngmain0.png" width="6in" depth="6in" align="center" scalefit="1" />
2648 </para>
2649
2650 <para>
2651 You can access extensive help information on how to use
2652 the LTTng plug-in to search and analyze captured traces via
2653 the Eclipse help system:
2654 <literallayout class='monospaced'>
2655 Help | Help Contents | LTTng Plug-in User Guide
2656 </literallayout>
2657 </para>
2658 </section>
2659
2660 <section id='collecting-and-viewing-a-trace-in-eclipse'>
2661 <title>Collecting and viewing a trace in Eclipse</title>
2662
2663 <note>
2664 This section on collecting traces remotely doesn't currently
2665 work because of Eclipse 'RSE' connectivity problems. Manually
2666 tracing on the target, copying the trace files to the host,
2667 and viewing the trace in Eclipse on the host as outlined in
2668 previous steps does work however - please use the manual
2669 steps outlined above to view traces in Eclipse.
2670 </note>
2671
2672 <para>
2673 In order to trace a remote target, you also need to add
2674 a 'tracing' group on the target and connect as a user
2675 who's part of that group e.g:
2676 <literallayout class='monospaced'>
2677 # adduser tomz
2678 # groupadd -r tracing
2679 # usermod -a -G tracing tomz
2680 </literallayout>
2681 <orderedlist>
2682 <listitem><para>First, start eclipse and open the
2683 'LTTng Kernel' perspective by selecting the following
2684 menu item:
2685 <literallayout class='monospaced'>
2686 Window | Open Perspective | Other...
2687 </literallayout></para></listitem>
2688 <listitem><para>In the dialog box that opens, select
2689 'LTTng Kernel' from the list.</para></listitem>
2690 <listitem><para>Back at the main menu, select the
2691 following menu item:
2692 <literallayout class='monospaced'>
2693 File | New | Project...
2694 </literallayout></para></listitem>
2695 <listitem><para>In the dialog box that opens, select
2696 the 'Tracing | Tracing Project' wizard and
2697 press 'Next>'.</para></listitem>
2698 <listitem><para>Give the project a name and press
2699 'Finish'. That should result in an entry in the
2700 'Project' subwindow.</para></listitem>
2701 <listitem><para>In the 'Control' subwindow just below
2702 it, press 'New Connection'.</para></listitem>
2703 <listitem><para>Add a new connection, giving it the
2704 hostname or IP address of the target system.
2705 </para></listitem>
2706 <listitem><para>Provide the username and password
2707 of a qualified user (a member of the 'tracing' group)
2708 or root account on the target system.
2709 </para></listitem>
2710 <listitem><para>Provide appropriate answers to whatever
2711 else is asked for e.g. 'secure storage password'
2712 can be anything you want.
2713 If you get an 'RSE Error' it may be due to proxies.
2714 It may be possible to get around the problem by
2715 changing the following setting:
2716 <literallayout class='monospaced'>
2717 Window | Preferences | Network Connections
2718 </literallayout>
2719 Switch 'Active Provider' to 'Direct'
2720 </para></listitem>
2721 </orderedlist>
2722 </para>
2723 </section>
2724 </section> 2553 </section>
2725 2554
2726 <section id='lltng-documentation'> 2555 <section id='lltng-documentation'>
@@ -2742,15 +2571,6 @@
2742 You can find a "Getting Started" link on this site that takes 2571 You can find a "Getting Started" link on this site that takes
2743 you to an LTTng Quick Start. 2572 you to an LTTng Quick Start.
2744 </para> 2573 </para>
2745
2746 <para>
2747 Finally, you can access extensive help information on how to use
2748 the LTTng plug-in to search and analyze captured traces via the
2749 Eclipse help system:
2750 <literallayout class='monospaced'>
2751 Help | Help Contents | LTTng Plug-in User Guide
2752 </literallayout>
2753 </para>
2754 </section> 2574 </section>
2755</section> 2575</section>
2756 2576