www/psensor/README.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4 <meta charset="UTF-8">
   5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
   7 <meta name="generator" content="Asciidoctor 1.5.4">
   8 <title>Psensor README</title>
   9 <link rel="stylesheet" href="./../style.css">
  10 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
  11 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
  12 <script src="nav.js"></script>
  13 <script src="https://apis.google.com/js/platform.js" async defer>
  14 </script>
  15 </head>
  16 <body class="article">
  17 <div id="header">
  18 <h1>Psensor README</h1>
  19 <div id="toc" class="toc">
  20 <div id="toctitle">Table of Contents</div>
  21 <ul class="sectlevel1">
  22 <li><a href="#_introduction">Introduction</a></li>
  23 <li><a href="#_installation_using_distribution_packages">Installation Using Distribution Packages</a>
  24 <ul class="sectlevel2">
  25 <li><a href="#_debian">Debian</a></li>
  26 <li><a href="#_ubuntu">Ubuntu</a></li>
  27 </ul>
  28 </li>
  29 <li><a href="#_installation_from_source_archive">Installation From Source Archive</a>
  30 <ul class="sectlevel2">
  31 <li><a href="#_compilation_prerequisites">Compilation Prerequisites</a></li>
  32 <li><a href="#_compilation_and_installation_steps">Compilation and Installation Steps</a></li>
  33 <li><a href="#_ati_amd_gpu_support">ATI/AMD GPU Support</a></li>
  34 </ul>
  35 </li>
  36 <li><a href="#_contact">Contact</a></li>
  37 </ul>
  38 </div>
  39 </div>
  40 <div id="content">
  41 <div class="sect1">
  42 <h2 id="_introduction">Introduction</h2>
  43 <div class="sectionbody">
  44 <div class="paragraph">
  45 <p>Psensor is a graphical hardware monitoring application for Linux.</p>
  46 </div>
  47 <div class="paragraph">
  48 <p>It draws realtime charts and raises alerts about:</p>
  49 </div>
  50 <div class="ulist">
  51 <ul>
  52 <li>
  53 <p>the temperature of the motherboard and CPU sensors (using
  54 lm-sensors).</p>
  55 </li>
  56 <li>
  57 <p>the temperature of the NVidia GPUs (using XNVCtrl).</p>
  58 </li>
  59 <li>
  60 <p>the temperature of ATI GPUs (using ATI ADL SDK).</p>
  61 </li>
  62 <li>
  63 <p>the temperature of the Hard Disk Drives (using hddtemp, libatasmart
  64 or udisks2).</p>
  65 </li>
  66 <li>
  67 <p>the rotation speed of the fans.</p>
  68 </li>
  69 <li>
  70 <p>the temperature of a remote computer.</p>
  71 </li>
  72 <li>
  73 <p>the CPU load.</p>
  74 </li>
  75 </ul>
  76 </div>
  77 <div class="paragraph">
  78 <p>Alerts are using Desktop Notification and a specific GTK+ status icon.</p>
  79 </div>
  80 <div class="paragraph">
  81 <p>For Ubuntu users, Psensor is providing an Application Indicator which turns
  82 red under alert and a menu for quickly check all sensors.</p>
  83 </div>
  84 <div class="paragraph">
  85 <p>It is possible to monitor remotely a computer:</p>
  86 </div>
  87 <div class="ulist">
  88 <ul>
  89 <li>
  90 <p>start psensor-server on the remote computer.</p>
  91 </li>
  92 <li>
  93 <p>start psensor using: psensor --url=http://hostname:3131.</p>
  94 </li>
  95 </ul>
  96 </div>
  97 <div class="paragraph">
  98 <p>psensor-server is a minimal Web server, a Web browser can be used to
  99 monitor the remote computer by opening the URL:
 100 http://hostname:3131.</p>
 101 </div>
 102 <div class="admonitionblock warning">
 103 <table>
 104 <tr>
 105 <td class="icon">
 106 <i class="fa icon-warning" title="Warning"></i>
 107 </td>
 108 <td class="content">
 109 psensor-server does not provide any way to restrict the connection
 110 to the HTTP server, worst, no effort has been made against malicious
 111 HTTP attacks.  You should make the psensor-server port available
 112 only to a network or computer you trust by using the usual network
 113 security tools of the system (for example:
 114 <a href="http://www.netfilter.org/projects/iptables/index.html">iptables</a>).
 115 </td>
 116 </tr>
 117 </table>
 118 </div>
 119 </div>
 120 </div>
 121 <div class="sect1">
 122 <h2 id="_installation_using_distribution_packages">Installation Using Distribution Packages</h2>
 123 <div class="sectionbody">
 124 <div class="sect2">
 125 <h3 id="_debian">Debian</h3>
 126 <div class="paragraph">
 127 <p>For Debian, the binary and source packages are available in the
 128 Wheezy, unstable and testing repositories.</p>
 129 </div>
 130 <div class="paragraph">
 131 <p>Debian package information is available at:
 132 <a href="http://packages.qa.debian.org/p/psensor.html" class="bare">http://packages.qa.debian.org/p/psensor.html</a>.</p>
 133 </div>
 134 <div class="paragraph">
 135 <p>To do the installation:</p>
 136 </div>
 137 <div class="listingblock">
 138 <div class="content">
 139 <pre>sudo apt-get install psensor psensor-server</pre>
 140 </div>
 141 </div>
 142 </div>
 143 <div class="sect2">
 144 <h3 id="_ubuntu">Ubuntu</h3>
 145 <div class="paragraph">
 146 <p>Since Ubuntu Oneiric (11.10), psensor is available in the universe
 147 repository of Ubuntu.</p>
 148 </div>
 149 <div class="paragraph">
 150 <p>To install psensor or psensor-server:</p>
 151 </div>
 152 <div class="listingblock">
 153 <div class="content">
 154 <pre>sudo apt-get install psensor
 155 sudo apt-get install psensor-server</pre>
 156 </div>
 157 </div>
 158 <div class="paragraph">
 159 <p>Or search them in the Ubuntu Software Center.</p>
 160 </div>
 161 <div class="paragraph">
 162 <p>For other Ubuntu releases or user the more recent release, the easiest
 163 way is to use the dedicated PPA.</p>
 164 </div>
 165 <div class="paragraph">
 166 <p>Last stable version:</p>
 167 </div>
 168 <div class="listingblock">
 169 <div class="content">
 170 <pre>sudo apt-get apt-add-repository ppa:/jfi/psensor
 171 sudo apt-get update
 172 sudo apt-get install psensor
 173 sudo apt-get install psensor-server</pre>
 174 </div>
 175 </div>
 176 <div class="paragraph">
 177 <p>Last development version which should not contain major bugs:</p>
 178 </div>
 179 <div class="listingblock">
 180 <div class="content">
 181 <pre>sudo apt-get apt-add-repository ppa:/jfi/psensor-unstable
 182 sudo apt-get update
 183 sudo apt-get install psensor
 184 sudo apt-get install psensor-server</pre>
 185 </div>
 186 </div>
 187 <div class="paragraph">
 188 <p>Daily trunk build which may contain major bugs and partialy
 189 implemented features:</p>
 190 </div>
 191 <div class="listingblock">
 192 <div class="content">
 193 <pre>sudo apt-get apt-add-repository ppa:/jfi/psensor-daily-trunk
 194 sudo apt-get update
 195 sudo apt-get install psensor
 196 sudo apt-get install psensor-server</pre>
 197 </div>
 198 </div>
 199 </div>
 200 </div>
 201 </div>
 202 <div class="sect1">
 203 <h2 id="_installation_from_source_archive">Installation From Source Archive</h2>
 204 <div class="sectionbody">
 205 <div class="paragraph">
 206 <p>psensor and psensor-server can be compiled and installed on any
 207 modern GNU/Linux distribution.</p>
 208 </div>
 209 <div class="sect2">
 210 <h3 id="_compilation_prerequisites">Compilation Prerequisites</h3>
 211 <div class="paragraph">
 212 <p>The compilation of psensor requires:</p>
 213 </div>
 214 <div class="ulist">
 215 <ul>
 216 <li>
 217 <p>make</p>
 218 </li>
 219 <li>
 220 <p>gcc (or llvm)</p>
 221 </li>
 222 <li>
 223 <p>lm-sensors</p>
 224 </li>
 225 <li>
 226 <p>library sensors4</p>
 227 </li>
 228 <li>
 229 <p>library gtk3 &gt;=3.4</p>
 230 </li>
 231 <li>
 232 <p>help2man (optional, required to produce the manpage)</p>
 233 </li>
 234 <li>
 235 <p>asciidoctor (optional, required to produce the html version of the
 236 faq)</p>
 237 </li>
 238 <li>
 239 <p>cppcheck (optional, static source checker)</p>
 240 </li>
 241 <li>
 242 <p>library libnotify (optional)</p>
 243 </li>
 244 <li>
 245 <p>library libappindicator &gt;= 3.0 (optional)</p>
 246 </li>
 247 <li>
 248 <p>library libXNVCtrl (optional)</p>
 249 </li>
 250 <li>
 251 <p>library json-c &gt;= 0.11.99 and curl (optional, required for remote monitoring)</p>
 252 </li>
 253 <li>
 254 <p>library unity (&gt;=v3.4.2, optional)</p>
 255 </li>
 256 <li>
 257 <p>library gtop2 (optional, required for CPU usage)</p>
 258 </li>
 259 <li>
 260 <p>library atasmart (optional, for disk monitoring)</p>
 261 </li>
 262 <li>
 263 <p>library udisk2 (optional, for disk monitoring)</p>
 264 </li>
 265 </ul>
 266 </div>
 267 <div class="paragraph">
 268 <p>The specific requirements for psensor-server:</p>
 269 </div>
 270 <div class="ulist">
 271 <ul>
 272 <li>
 273 <p>library libmicrohttpd</p>
 274 </li>
 275 <li>
 276 <p>library json-c &gt;= 0.11.99</p>
 277 </li>
 278 </ul>
 279 </div>
 280 </div>
 281 <div class="sect2">
 282 <h3 id="_compilation_and_installation_steps">Compilation and Installation Steps</h3>
 283 <div class="olist arabic">
 284 <ol class="arabic">
 285 <li>
 286 <p>download the source archive from: <a href="http://wpitchoune.net/psensor/files" class="bare">http://wpitchoune.net/psensor/files</a></p>
 287 </li>
 288 <li>
 289 <p>Extract files from the source archive</p>
 290 </li>
 291 <li>
 292 <p>Compilation: ./configure;make clean all</p>
 293 </li>
 294 <li>
 295 <p>Installation:  make install (require to have root permission)</p>
 296 </li>
 297 <li>
 298 <p>Start the sensor detection script: sensors-detect and follows the
 299 instructions. Reboot or activate the kernel modules which have
 300 been found.</p>
 301 </li>
 302 <li>
 303 <p>Run: psensor</p>
 304 </li>
 305 </ol>
 306 </div>
 307 </div>
 308 <div class="sect2">
 309 <h3 id="_ati_amd_gpu_support">ATI/AMD GPU Support</h3>
 310 <div class="paragraph">
 311 <p>When the OpenSource ATI driver is used, the monitoring
 312 information is available throw lm-sensors and does not require the
 313 following instructions.</p>
 314 </div>
 315 <div class="paragraph">
 316 <p>When the proprietary ATI driver(Catalyst) is used, the build is
 317 requiring an additional library.</p>
 318 </div>
 319 <div class="paragraph">
 320 <p>Download the
 321 <a href="http://developer.amd.com/sdks/ADLSDK/Pages/default.aspx">ATI ADL SDK</a>
 322 and extracts the files of the archive into a directory [dir].</p>
 323 </div>
 324 <div class="paragraph">
 325 <p>Replace the step 3. of the above section by ./configure
 326 --with-libatiadl=[dir] where [dir] must be the directory where you
 327 have extracted the ATI ADL SDK. Other steps are indentical.</p>
 328 </div>
 329 </div>
 330 </div>
 331 </div>
 332 <div class="sect1">
 333 <h2 id="_contact">Contact</h2>
 334 <div class="sectionbody">
 335 <div class="paragraph">
 336 <p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
 337 </div>
 338 <div class="paragraph">
 339 <p>Home page: <a href="http://wpitchoune.net/psensor" class="bare">http://wpitchoune.net/psensor</a></p>
 340 </div>
 341 </div>
 342 </div>
 343 </div>
 344 <div id="footer">
 345 <div id="footer-text">
 346 Last updated 2017-02-10 00:47:57 CET
 347 </div>
 348 </div>
 349 </body>
 350 </html>