Commit | Line | Data |
---|---|---|
6dc1ef9f FC |
1 | <?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 | <html xmlns="http://www.w3.org/1999/xhtml"> | |
3 | <head> | |
4 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> | |
5 | <title>LTTng Plug-in User Guide - Installation</title> | |
6 | <link type="text/css" rel="stylesheet" href="../../../book.css"/> | |
7 | </head> | |
8 | <body> | |
9 | <table class="navigation" style="width: 100%;" border="0" summary="navigation"> | |
10 | <tr> | |
11 | <th style="width: 100%" align="center" colspan="3">Installation</th> | |
12 | </tr> | |
13 | <tr> | |
14 | <td style="width: 20%" align="left"> | |
15 | <a href="User-Guide.html" title="LTTng Plug-in User Guide"> | |
16 | <img alt="Previous" border="0" src="../../../images/prev.gif"/> | |
17 | </a> | |
18 | </td> | |
19 | <td style="width: 60%" align="center"></td> | |
20 | <td style="width: 20%" align="right"> | |
21 | <a href="LTTng.html" title="LTTng"> | |
22 | <img alt="Next" border="0" src="../../../images/next.gif"/> | |
23 | </a> | |
24 | </td> | |
25 | </tr> | |
26 | <tr> | |
27 | <td style="width: 20%" align="left" valign="top">LTTng Plug-in User Guide</td> | |
28 | <td style="width: 60%" align="center"></td> | |
29 | <td style="width: 20%" align="right" valign="top">LTTng</td> | |
30 | </tr> | |
31 | </table><hr/> | |
32 | <h1 id="Installation">Installation</h1> | |
33 | <p>This section describes the installation of the LTTng tracer and the LTTng Eclipse plug-ins as well as their dependencies.</p> | |
34 | <h2 id="LTTng_Tracer">LTTng Tracer</h2> | |
35 | <p>While the Eclipse plug-ins can run on the standard Eclipse platforms (Linux, Mac, Windows), the LTTng tracer and its accompanying tools run on Linux.</p> | |
36 | <p>The tracer and tools have been available for download in Ubuntu since 12.04. They can easily be installed with the following command:</p> | |
37 | <pre> | |
38 | > sudo apt-get install lttng-tools | |
39 | </pre> | |
40 | <p>For other distributions, older Ubuntu distributions, or the latest, bleeding edge LTTng tracer, please refer to the | |
41 | <a href="http://lttng.org/download">LTTng website</a> for installation information. | |
42 | </p> | |
43 | <p> | |
44 | <b>Note</b>: The LTTng tracer (and accompanying tools) is required only if you want to create your own traces (the usual case). If you intend to simply analyze existing traces then it is not necessary to install the tracer. | |
45 | </p> | |
46 | <h2 id="LTTng_Eclipse_Plug-ins">LTTng Eclipse Plug-ins</h2> | |
47 | <p>The easiest way to install the LTTng plug-ins for Eclipse is through the Software Updates and Add-ons menu. For information on how to use this menu, refer to this | |
48 | <a href="http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site">link</a>. | |
49 | </p> | |
50 | <p>The legacy ( | |
51 | <i>Classic</i> :-)) Eclipse LTTng (v0.x) is also available as an optional download. Refer to | |
52 | <a href="http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide">here</a> for installation and verification instructions. | |
53 | </p> | |
54 | <p>The LTTng plug-ins are structured as a stack of features/plug-ins as following:</p> | |
55 | <ul> | |
56 | <li> | |
57 | <b>CTF</b> - A CTF parser that can also be used as a standalone component | |
58 | <ul> | |
59 | <li> | |
60 | <i>Feature</i>: org.eclipse.linuxtools.ctf | |
61 | </li> | |
62 | <li> | |
63 | <i>Plug-ins</i>: org.eclipse.linuxtools.ctf.core, org.eclipse.linuxtools.ctf.parser | |
64 | </li> | |
65 | </ul> | |
66 | </li> | |
67 | </ul> | |
68 | <ul> | |
69 | <li> | |
70 | <b>TMF</b> - | |
71 | <i>Tracing and Monitoring Framework</i> a framework for generic trace processing | |
72 | <ul> | |
73 | <li> | |
74 | <i>Feature</i>: org.eclipse.linuxtools.tmf | |
75 | </li> | |
76 | <li> | |
77 | <i>Plug-ins</i>: org.eclipse.linuxtools.tmf.core, org.eclipse.linuxtools.tmf.ui | |
78 | </li> | |
79 | </ul> | |
80 | </li> | |
81 | </ul> | |
82 | <ul> | |
83 | <li> | |
84 | <b>LTTng</b> - The wrapper for the LTTng tracer control. Can be used for kernel or application tracing. | |
85 | <ul> | |
86 | <li> | |
87 | <i>Feature</i>: org.eclipse.linuxtools.lttng2 | |
88 | </li> | |
89 | <li> | |
90 | <i>Plug-ins</i>: org.eclipse.linuxtools.lttng2.core, org.eclipse.linuxtools.lttng2.ui | |
91 | </li> | |
92 | </ul> | |
93 | </li> | |
94 | </ul> | |
95 | <ul> | |
96 | <li> | |
97 | <b>LTTng Kernel</b> - Analysis components specific to Linux kernel traces | |
98 | <ul> | |
99 | <li> | |
100 | <i>Feature</i>: org.eclipse.linuxtools.lttng2.kernel | |
101 | </li> | |
102 | <li> | |
103 | <i>Plug-ins</i>: org.eclipse.linuxtools.lttng2.kernel.core, org.eclipse.linuxtools.lttng2.kernel.ui | |
104 | </li> | |
105 | </ul> | |
106 | </li> | |
107 | </ul> | |
108 | <h2 id="LTTng_Eclipse_Dependencies">LTTng Eclipse Dependencies</h2> | |
109 | <p>The Eclipse LTTng controls the LTTng tracer through an | |
110 | <i>ssh</i> connection even if the tracer is running locally (the 'degenerate' case). | |
111 | </p> | |
112 | <p>Therefore, the target system (where the tracer runs) needs to run an | |
ff25eb47 BH |
113 | <i>ssh</i> server as well as |
114 | <i>sftp</i> server (for file transfer) to which you have permission to connect. | |
6dc1ef9f FC |
115 | </p> |
116 | <p>On the host side (where Eclipse is running), you also need to have Eclipse RSE (Remote System Explorer) installed to handle the SSH connection and transport. The RSE can be installed the standard way ( | |
117 | <i>Help</i> > | |
118 | <i>Install New Software...</i> > | |
119 | <i>General Purpose Tools</i> > | |
120 | <i>Remote System Explorer End-User Runtime</i>). | |
121 | </p> | |
122 | <h2 id="Installation_Verification">Installation Verification</h2> | |
123 | <p>Here are the quick steps to verify that your installation is functional:</p> | |
124 | <ul> | |
125 | <li>Start Eclipse</li> | |
126 | <li>Open the LTTng perspective</li> | |
127 | <li>Create a Tracing project | |
128 | <ul> | |
129 | <li>Right-click in the Project view and select "New Project"</li> | |
130 | <li>Enter the name of your project (e.g. "MyLTTngProject")</li> | |
131 | <li>The project will be created. It will contain 2 empty folders: "Traces" and "Experiments"</li> | |
132 | </ul> | |
133 | </li> | |
134 | <li>Import a sample trace | |
135 | <ul> | |
136 | <li>Right-click on the newly created project "Traces" folder and select "Import..."</li> | |
137 | <li>Navigate to the sample LTTng trace that you want to visualize</li> | |
138 | <li>Select that trace (check box), select the trace type (e.g. CTF: Kernel Trace), and press "Finish"</li> | |
139 | <li>The newly imported trace should appear under the Traces folder</li> | |
140 | </ul> | |
141 | </li> | |
142 | <li>Visualize the trace | |
143 | <ul> | |
144 | <li>Expand the Traces folder</li> | |
145 | <li>Double-click on the trace</li> | |
146 | <li>The trace should load and the views be populated</li> | |
147 | </ul> | |
148 | </li> | |
149 | </ul> | |
150 | <p>If an error message is displayed, you might want to double-check that the trace type is correctly set (right-click on the trace and "Select Trace Type...").</p> | |
151 | <p>Refer to | |
152 | <a href="LTTng.html#Tracing_Perspective">Tracing Perspective</a> for detailed description of the views and their usage. | |
153 | </p> | |
154 | <p>To download sample LTTng traces, go to | |
155 | <a href="http://lttng.org/download">http://lttng.org/download</a>. At the bottom of the page there is a link to some sample LTTng 2.0 kernel traces. | |
156 | </p><hr/> | |
157 | <table class="navigation" style="width: 100%;" border="0" summary="navigation"> | |
158 | <tr> | |
159 | <td style="width: 20%" align="left"> | |
160 | <a href="User-Guide.html" title="LTTng Plug-in User Guide"> | |
161 | <img alt="Previous" border="0" src="../../../images/prev.gif"/> | |
162 | </a> | |
163 | </td> | |
164 | <td style="width: 60%" align="center"> | |
165 | <a href="User-Guide.html" title="LTTng Plug-in User Guide"> | |
166 | <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/> | |
167 | </a> | |
168 | </td> | |
169 | <td style="width: 20%" align="right"> | |
170 | <a href="LTTng.html" title="LTTng"> | |
171 | <img alt="Next" border="0" src="../../../images/next.gif"/> | |
172 | </a> | |
173 | </td> | |
174 | </tr> | |
175 | <tr> | |
176 | <td style="width: 20%" align="left" valign="top">LTTng Plug-in User Guide</td> | |
177 | <td style="width: 60%" align="center"></td> | |
178 | <td style="width: 20%" align="right" valign="top">LTTng</td> | |
179 | </tr> | |
180 | </table> | |
181 | </body> | |
182 | </html> |