====== Using an APC UPS with the Nut software ======

===== Configuration =====

Configuration files into **/etc/nut/** directory:

  * **nut.conf**
  * **ups.conf**
  * **upsd.conf**
  * **upsd.users**
  * **upsmon.conf**

=== /etc/nut/nut.conf ===

<file>
MODE=standalone
</file>

=== /etc/nut/ups.conf ===

<file>
[apc-bx2200]
    driver = usbhid-ups
    port = auto
    #serial = "9B2611A02967"
    desc = "APC Back-UPS BX2200MI"
    ignorelb
    pollonly
</file>

=== /etc/nut/upsd.conf ===

<file>
LISTEN 127.0.0.1 3493
LISTEN 192.168.0.46 3493
</file>

=== /etc/nut/ ===

<file>
[admin]
    password = MySecret1
    actions = SET
    instcmds = ALL

[monuser]
    password = MySecret2
    upsmon master
</file>

=== /etc/nut/upsmon.conf ===

<file>
MONITOR apc-bx2200@localhost 1 monuser MySecret2 master
</file>

===== Usage =====

List the UPS configured with nut:

<code>
upsc -l
apc-bx2200
</code>

Display the status of the named UPS:

<code>
upsc apc-bx2200
</code>

Display the value of one variable only.

<code>
upsc apc-bx2200 ups.status
upsc apc-bx2200 battery.charge
upsc apc-bx2200 battery.runtime
upsc apc-bx2200 ups.alarm
upsc apc-bx2200 ups.load
</code>

Show the list of supported instant commands on that UPS.

<code>
upscmd -l apc-bx2200
</code>

Inizia un test rapido della batteria (richiede autenticazione):

<code>
upscmd apc-bx2200 test.battery.start.quick
</code>


<code>
upscmd apc-bx2200 beeper.mute
upscmd apc-bx2200 beeper.disable
upscmd apc-bx2200 beeper.enable
</code>

<code>
upsc apc-bx2200 ups.beeper.status
</code>