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