lady:factory:powerstatus

Powerstatus

NUT web interface.

This is a single-file PHP frontend to NUT UPS tools. Although there is a nut-cgi client already provided, I found it some what ugly and I started my simple Web status viewer.

Note that as I developed it for my needs, it has very basic usage/configuration and some limitations that I wouldn't implement, the code is free, so you can extend it by yourself if you want (I would like to know an receive feedback then).

  • As it implements its basic NUT protocol needs, it doesn't depend on other software than PHP and HTTP server (no NUT tools required)

No Roadmap or new features to implement (may be fix some of the limitations which currently I don't need). May be a some interesting feature should be to make it a 'real' management so you set/modify settings or act over the UPS device, but this will require extra security concerns.

  • Only support read operations (status)
  • No support for write operations, change settings or instant commands
  • No authn/authz, so you should secure it by yourself. 1).
  • No support for TLS NUT

Well there are some optional requirements. They're optional as it is fully functional without them, but …uhh will make it some quite nicer:

jQuery Stuff

The script makes use of local jQuery-UI, that is: it tries to use jquery javascript from /js/ directory on your webserver. So you should either deploy jquery on your server or change the links by the jQuery CDN links:

Icons/customization

Although not needed, you can download (or provide yourself) some icons for better display

I usually doesn't provide packaged download, instead I try to keep the development trunk free of bugs, so usable. For big changes I usually use a separated branch to not affect main trunk of development.

Donwload PowerStatus latest release and drop it on a HTTP served directory with PHP execution (either via fastCGI or mod-php)

You must create a power.conf.php file defining configuration constants like:

<?php
define("NUTSERVER","127.0.0.1");
define("NUTPORT",3493);
?>

Basic use:

Point your browser to the URL where you deployed the PHP file. The script will try to connect to the specified NUT server and fetch a list of available UPSs to monitor. By default it will show you the first one, but a drop-down list on top-right of the page allows you to switch to another one.

Obviously this software/stuff is provided as-is under the GPL without any support. But I provide here help on issues or known problems as I can.

In case you would like to contact me for some, well detailed and tested issue, or even better provide a fix/enhancement you can send me an email at srcmaster@l3jane.net


1)
Although as only read operations have been implemented there is not too much risk
  • lady/factory/powerstatus.txt
  • Last modified: 2023/06/26 15:13
  • by Count Zero