Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html')
-rw-r--r--oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html36
1 files changed, 21 insertions, 15 deletions
diff --git a/oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html b/oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html
index d0881dafb5..c52bb078ba 100644
--- a/oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html
+++ b/oprofile/org.eclipse.linuxtools.oprofile.doc/Linux_Tools_Project/OProfile/User_Guide/Installation-and-Set-Up.html
@@ -30,8 +30,8 @@
</tr>
</table><hr/>
<h1 id="Installation_and_Set-Up">Installation and Set-Up</h1>
- <p>The easiest way to install the OProfile plug-in for Eclipse is through the
- <b>''Software Updates and Add-ons '</b>' menu. For information on how to use this menu, refer to
+ <p>The easiest way to install the OProfile plug-in for Eclipse is through the ''
+ <b>Software Updates and Add-ons '</b>' menu. For information on how to use this menu, refer to
<a href="http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site">http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site</a>.
</p>
<p>Unlike most Eclipse plug-ins, the OProfile plug-in requires some configuration after installation. Note that this configuration process takes only a few simple steps, and only needs to be done once.</p>
@@ -77,21 +77,27 @@
</p>
<h2 id="Step_2_-_Choose_Which_Installation_Script_To_Run">Step 2 - Choose Which Installation Script To Run</h2>
<p>The
- <i><code>natives/linux/scripts</code></i> subdirectory contains two scripts:
- <i><code>install.sh</code></i> and
- <i><code>install-noconsolehelper.sh</code></i>. Both scripts perform sanity checks to ensure OProfile is installed. The difference is in how root authentication with the plug-in is set up.
+ <i><code>natives/linux/scripts</code></i> subdirectory contains three scripts:
+ <i><code>install.sh</code></i>,
+ <i><code>install-consolehelper.sh</code></i> and
+ <i><code>install-noconsolehelper.sh</code></i>. These scripts perform sanity checks to ensure OProfile is installed. The difference is in how root authentication with the plug-in is set up.
</p>
<ul>
<li>
- <i><code>install.sh</code></i> uses the pluggable authentication modules (PAM) mechanism. This is the default and recommended method for root authentication. When an OProfile task is required, you will be presented with this dialog to enter the root password:
+ <i><code>install.sh</code></i> uses PolicyKit. This is the default and recommended method for root authentication. When an OProfile task is required, you will be presented with a dialog to enter the root password. If PolicyKit is not installed on the system, it is recommended to use
+ <i><code>install-consolehelper.sh</code></i> instead.
+ <br/>
+ </li>
+ <li>
+ <i><code>install-consolehelper.sh</code></i> uses the pluggable authentication modules (PAM) mechanism. When an OProfile task is required, you will be presented with this dialog to enter the root password:
<br/>
<img border="0" src="images/Screenshot-opcontrol_consolehelper.png"/>
</li>
<li>
<i><code>install-noconsolehelper.sh</code></i> can be used when <code>consolehelper</code> is not present on the system, or if required PAM modules are not on the system. It uses the sudo mechanism and a small wrapper script. The install script will describe the text which should be written in the
<i><code>sudoers</code></i> file, then run the command <code>visudo</code> to edit it.
- <br/>'
- <i>Warning:</i>' The
+ <br/>
+ <b>Warning:</b> The
<i><code>sudoers</code></i> file is a sensitive system file and altering it in other ways may lead to system instability. Only users with enough knowledge of running a Linux system should use this method. For these reasons, this method of root authentication is discouraged. However, it may be the only option available to some users and it has been tested to work by developers and users of the plug-in.
</li>
</ul>
@@ -106,9 +112,9 @@
<pre>./install.sh
Eclipse-OProfile plugin install successful.
</pre>
- <p>Either install script should be run as the root user since both scripts perform some actions that require elevated privileges:
- <i><code>install.sh</code></i> places files in
- <i><code>/etc</code></i> subdirectories, while
+ <p>Install scripts should be run as the root user since these scripts perform some actions that require elevated privileges:
+ <i><code>install.sh</code></i> uses PolicyKit,
+ <i><code>install-consolehelper.sh</code></i> uses consolehelper with PAM, and
<i><code>install-noconsolehelper.sh</code></i> runs the command <code>visudo</code>. If you wish to simply run either install script without logging in as root, use:
</p>
<pre> su -c './install.sh'
@@ -118,9 +124,9 @@ Eclipse-OProfile plugin install successful.
</p>
<h2 id="Step_4_-_Restart_Eclipse">Step 4 - Restart Eclipse</h2>
<p>After running the install script, restart Eclipse using <u>File</u> &gt; <u>Restart</u>. </p>
- <p>If you need to uninstall the plug-in, run the
- <i><code>uninstall.sh</code></i> or
- <i><code>uninstall-noconsolehelper.sh</code></i> script before uninstalling it from within Eclipse. These scripts are also located in the
+ <p>If you need to uninstall the plug-in, run the uninstall script that corresponds to the install script used. For example, if you used
+ <i><code>install-consolehelper.sh</code></i>, you would run
+ <i><code>uninstall-consolehelper.sh</code></i> before uninstalling it from within Eclipse. These scripts are also located in the
<i><code>natives/linux/scripts</code></i> subdirectory of the OProfile core plug-in directory (i.e. the same directory where the install scripts are found).
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
@@ -148,4 +154,4 @@ Eclipse-OProfile plugin install successful.
</tr>
</table>
</body>
-</html>
+</html> \ No newline at end of file

Back to the top