diff options
| -rw-r--r-- | documentation/profile-manual/figures/lttngmain0.png | bin | 120581 -> 0 bytes | |||
| -rw-r--r-- | documentation/profile-manual/profile-manual-usage.xml | 180 |
2 files changed, 0 insertions, 180 deletions
diff --git a/documentation/profile-manual/figures/lttngmain0.png b/documentation/profile-manual/figures/lttngmain0.png deleted file mode 100644 index 5f60113cc3..0000000000 --- a/documentation/profile-manual/figures/lttngmain0.png +++ /dev/null | |||
| Binary files differ | |||
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 | ||
