nut/conf/upsd.users.sample

76 lines
2.3 KiB
Text
Raw Normal View History

2010-03-25 23:20:59 +00:00
# Network UPS Tools: Example upsd.users
#
# This file sets the permissions for upsd - the UPS network daemon.
# Users are defined here, are given passwords, and their privileges are
# controlled here too. Since this file will contain passwords, keep it
# secure, with only enough permissions for upsd to read it.
# --------------------------------------------------------------------------
# Each user gets a section. To start a section, put the username in
# brackets on a line by itself. To set something for that user, specify
# it under that section heading. The username is case-sensitive, so
# admin and AdMiN are two different users.
#
# Possible settings:
#
# password: The user's password. This is case-sensitive.
#
# --------------------------------------------------------------------------
#
2022-06-29 10:37:36 +00:00
# actions: Let the user do certain things with upsd.
#
2010-03-25 23:20:59 +00:00
# Valid actions are:
#
2022-06-29 10:37:36 +00:00
# SET - change the value of certain variables in the UPS
2010-03-25 23:20:59 +00:00
# FSD - set the "forced shutdown" flag in the UPS
2022-06-29 10:37:36 +00:00
#
2010-03-25 23:20:59 +00:00
# --------------------------------------------------------------------------
#
# instcmds: Let the user initiate specific instant commands. Use "ALL"
2022-06-29 10:37:36 +00:00
# to grant all commands automatically. There are many possible
2010-03-25 23:20:59 +00:00
# commands, so use 'upscmd -l' to see what your hardware supports. Here
# are a few examples:
#
2022-06-29 10:37:36 +00:00
# test.panel.start - Start a front panel test
# test.battery.start - Start battery test
# test.battery.stop - Stop battery test
# calibrate.start - Start calibration
# calibrate.stop - Stop calibration
2010-03-25 23:20:59 +00:00
#
# --------------------------------------------------------------------------
#
# Example:
#
# [admin]
# password = mypass
# actions = SET
# instcmds = ALL
#
2011-01-26 09:35:08 +00:00
#
# --- Configuring for a user who can execute tests only
#
# [testuser]
# password = pass
# instcmds = test.battery.start
# instcmds = test.battery.stop
2010-03-25 23:20:59 +00:00
#
# --- Configuring for upsmon
#
# To add a user for your upsmon, use this example:
#
2022-06-29 10:37:36 +00:00
# [upsmon]
# password = pass
# upsmon primary
2010-03-25 23:20:59 +00:00
# or
2022-06-29 10:37:36 +00:00
# upsmon secondary
2010-03-25 23:20:59 +00:00
#
# The matching MONITOR line in your upsmon.conf would look like this:
#
2022-06-29 10:37:36 +00:00
# MONITOR myups@localhost 1 upsmon pass primary (or secondary)
#
# See comments in the upsmon.conf(.sample) file for details about this
# keyword and the difference of NUT secondary and primary systems.