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 debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org