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