Package: nut-monitor
Version: 2.7.2-1.1
Severity: normal
NUT-Monitor is missing documentation. NUT-Monitor -h provides
insufficient help to figure out how to use favorites. The application
is fussy about the order of operations, so I had to determine this
empirically. I have put both my goal and what I learned from this
discovery process below which could serve as a draft for some proper
documentation.
Goal:
I want a graphical nut monitor that can both view all variables for
the UPS attached to localhost and make an authenticated connection to
it in order to run instant commands such as beeper.disable and
beeper.enable.
Setup:
I already have nut installed and configured in standalone mode with a
ups called 'myups' and upsd running on localhost. It has an 'admin'
username set up with a password in /etc/nut/upsd.users. A 'upsc
myups' responds without authentication, showing all variables.
Configuring NUT-Monitor:
1. Start NUT-Monitor. Note that no favorites are defined and the
Favorites menu is greyed out, but the status of the UPS is displayed,
including the value of all variables.
2. Press the [Disconnect] button. This will enable the Favorites menu.
3. Fill out the hostname (and port, if needed), check "Use
authentication" and enter the username and password.
4. Click "Refresh" and select the appropriate detected Device from the
list. Note that if you enable authentication *after* refreshing, it
will blank out the device choice and you'll need to "Refresh" and
reenter it.
5. Press "Connect" to test this configuration.
6. Connecting is not sufficient to verify if the authentication is
correct, so select from "Device commands:" an action such as
"test.panel.start" and press "Execute" to test.
6a. If the test was unsuccessful, an error message may be shown on the
status bar at the bottom of the application, such as:
Failed to send 'test.panel.start' (ERR ACCESS-DENIED)
6b. Otherwise, for a successful test you will see on the status
bar a message such as:
Sent 'test.panel.start' command to myups
7. Press 'Disconnect' to end the test. If the test failed, correct
your configuration and retest until you get it right.
8. Save your successful configuration as a favorite by selecting
Favorites > Add and giving it a name (e.g. 'myups').
9. Quit the application to test starting with this favorite.
10. Start NUT-Monitor again with the favorite you defined, e.g.
NUT-Monitor -Fmyups &
11. Adjust any autostart script you may have for your desktop or
window manager session to start NUT-Monitor with this option,
e.g. (details for your WM/desktop session may vary):
cp /usr/share/applications/nut-monitor.desktop ~/.config/autostart
sed -i 's/Exec=NUT-Monitor/Exec=NUT-Monitor -Fmyups/'
~/.config/autostart/nut-monitor.desktop
12. Logout and login to your desktop or WM session to verify autostart
works.
Please consider including this documentation in your next upload
and/or send it upstream for inclusion in the package.
Regards,
Ben
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
