diff options
Diffstat (limited to 'poky/documentation/profile-manual/profile-manual-usage.xml')
-rw-r--r-- | poky/documentation/profile-manual/profile-manual-usage.xml | 180 |
1 files changed, 0 insertions, 180 deletions
diff --git a/poky/documentation/profile-manual/profile-manual-usage.xml b/poky/documentation/profile-manual/profile-manual-usage.xml index a1b565157..5999b2960 100644 --- a/poky/documentation/profile-manual/profile-manual-usage.xml +++ b/poky/documentation/profile-manual/profile-manual-usage.xml @@ -2350,22 +2350,8 @@ <para> For this section, we'll assume you've already performed the basic setup outlined in the General Setup section. - </para> - - <para> LTTng is run on the target system by ssh'ing to it. - However, if you want to see the traces graphically, - install Eclipse as described in section - "<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>" - and follow the directions to manually copy traces to the host and - view them in Eclipse (i.e. using Eclipse without network support). </para> - - <note> - Be sure to download and install/run the 'SR1' or later Juno release - of eclipse e.g.: - <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> - </note> </section> <section id='collecting-and-viewing-traces'> @@ -2564,163 +2550,6 @@ </para> </section> - <section id='manually-copying-a-trace-to-the-host-and-viewing-it-in-eclipse'> - <title>Manually copying a trace to the host and viewing it in Eclipse (i.e. using Eclipse without network support)</title> - - <para> - If you already have an LTTng trace on a remote target and - would like to view it in Eclipse on the host, you can easily - copy it from the target to the host and import it into - Eclipse to view it using the LTTng Eclipse plug-in already - bundled in the Eclipse (Juno SR1 or greater). - </para> - - <para> - Using the trace we created in the previous section, archive - it and copy it to your host system: - <literallayout class='monospaced'> - root@crownbay:~/lttng-traces# tar zcvf auto-20121015-232120.tar.gz auto-20121015-232120 - auto-20121015-232120/ - auto-20121015-232120/kernel/ - auto-20121015-232120/kernel/metadata - auto-20121015-232120/kernel/channel0_1 - auto-20121015-232120/kernel/channel0_0 - - $ scp root@192.168.1.47:lttng-traces/auto-20121015-232120.tar.gz . - root@192.168.1.47's password: - auto-20121015-232120.tar.gz 100% 1566KB 1.5MB/s 00:01 - </literallayout> - Unarchive it on the host: - <literallayout class='monospaced'> - $ gunzip -c auto-20121015-232120.tar.gz | tar xvf - - auto-20121015-232120/ - auto-20121015-232120/kernel/ - auto-20121015-232120/kernel/metadata - auto-20121015-232120/kernel/channel0_1 - auto-20121015-232120/kernel/channel0_0 - </literallayout> - We can now import the trace into Eclipse and view it: - <orderedlist> - <listitem><para>First, start eclipse and open the - 'LTTng Kernel' perspective by selecting the following - menu item: - <literallayout class='monospaced'> - Window | Open Perspective | Other... - </literallayout></para></listitem> - <listitem><para>In the dialog box that opens, select - 'LTTng Kernel' from the list.</para></listitem> - <listitem><para>Back at the main menu, select the - following menu item: - <literallayout class='monospaced'> - File | New | Project... - </literallayout></para></listitem> - <listitem><para>In the dialog box that opens, select - the 'Tracing | Tracing Project' wizard and press - 'Next>'.</para></listitem> - <listitem><para>Give the project a name and press - 'Finish'.</para></listitem> - <listitem><para>In the 'Project Explorer' pane under - the project you created, right click on the - 'Traces' item.</para></listitem> - <listitem><para>Select 'Import..." and in the dialog - that's displayed:</para></listitem> - <listitem><para>Browse the filesystem and find the - select the 'kernel' directory containing the trace - you copied from the target - e.g. auto-20121015-232120/kernel</para></listitem> - <listitem><para>'Checkmark' the directory in the tree - that's displayed for the trace</para></listitem> - <listitem><para>Below that, select 'Common Trace Format: - Kernel Trace' for the 'Trace Type'</para></listitem> - <listitem><para>Press 'Finish' to close the dialog - </para></listitem> - <listitem><para>Back in the 'Project Explorer' pane, - double-click on the 'kernel' item for the - trace you just imported under 'Traces' - </para></listitem> - </orderedlist> - You should now see your trace data displayed graphically - in several different views in Eclipse: - </para> - - <para> - <imagedata fileref="figures/lttngmain0.png" width="6in" depth="6in" align="center" scalefit="1" /> - </para> - - <para> - You can access extensive help information on how to use - the LTTng plug-in to search and analyze captured traces via - the Eclipse help system: - <literallayout class='monospaced'> - Help | Help Contents | LTTng Plug-in User Guide - </literallayout> - </para> - </section> - - <section id='collecting-and-viewing-a-trace-in-eclipse'> - <title>Collecting and viewing a trace in Eclipse</title> - - <note> - This section on collecting traces remotely doesn't currently - work because of Eclipse 'RSE' connectivity problems. Manually - tracing on the target, copying the trace files to the host, - and viewing the trace in Eclipse on the host as outlined in - previous steps does work however - please use the manual - steps outlined above to view traces in Eclipse. - </note> - - <para> - In order to trace a remote target, you also need to add - a 'tracing' group on the target and connect as a user - who's part of that group e.g: - <literallayout class='monospaced'> - # adduser tomz - # groupadd -r tracing - # usermod -a -G tracing tomz - </literallayout> - <orderedlist> - <listitem><para>First, start eclipse and open the - 'LTTng Kernel' perspective by selecting the following - menu item: - <literallayout class='monospaced'> - Window | Open Perspective | Other... - </literallayout></para></listitem> - <listitem><para>In the dialog box that opens, select - 'LTTng Kernel' from the list.</para></listitem> - <listitem><para>Back at the main menu, select the - following menu item: - <literallayout class='monospaced'> - File | New | Project... - </literallayout></para></listitem> - <listitem><para>In the dialog box that opens, select - the 'Tracing | Tracing Project' wizard and - press 'Next>'.</para></listitem> - <listitem><para>Give the project a name and press - 'Finish'. That should result in an entry in the - 'Project' subwindow.</para></listitem> - <listitem><para>In the 'Control' subwindow just below - it, press 'New Connection'.</para></listitem> - <listitem><para>Add a new connection, giving it the - hostname or IP address of the target system. - </para></listitem> - <listitem><para>Provide the username and password - of a qualified user (a member of the 'tracing' group) - or root account on the target system. - </para></listitem> - <listitem><para>Provide appropriate answers to whatever - else is asked for e.g. 'secure storage password' - can be anything you want. - If you get an 'RSE Error' it may be due to proxies. - It may be possible to get around the problem by - changing the following setting: - <literallayout class='monospaced'> - Window | Preferences | Network Connections - </literallayout> - Switch 'Active Provider' to 'Direct' - </para></listitem> - </orderedlist> - </para> - </section> </section> <section id='lltng-documentation'> @@ -2742,15 +2571,6 @@ You can find a "Getting Started" link on this site that takes you to an LTTng Quick Start. </para> - - <para> - Finally, you can access extensive help information on how to use - the LTTng plug-in to search and analyze captured traces via the - Eclipse help system: - <literallayout class='monospaced'> - Help | Help Contents | LTTng Plug-in User Guide - </literallayout> - </para> </section> </section> |