[Nut-upsdev] consolidating the NUT documentation on permissions, hotplug and udev

[Arnaud Quette]

Hey Charles,

2009/1/13 Charles Lepple <clepple at gmail.com>

> Arnaud et al,
>
> I have been meaning to collect some of the documentation updates for
> permission-related errors, and I was wondering if you would mind if we
> moved the scripts/udev/README and scripts/hotplug/README files out of
> scripts/ and into the docs/ directory (probably docs/permissions.txt).
> We could also cover the *BSD /dev/usb* permission issues there, as
> well.
>
> Any thoughts on this?


that would be nice, also including the following:

1) a note on the serial permissions, including the below things from
README.Debian:
8<------------------------------------------------------------------------------------------------------------------
 serial port permissions
    The nut user need to be able to access the serial port both for
    reading and writing.

    There are two possibilities:

    a) You can add the nut user to the dialout group.
       The following command accomplishes this:
         addgroup nut dialout

       This is not done by default for security reason.

    b) Another solution, for system supporting udev, is to create a file
       (for example /etc/udev/rules.d/52_nut-serialups.rules), placed
       after 020_permissions.rules and to add something like:
         KERNEL=="ttyS1", GROUP="nut"

       where 'ttyS1' has to be replaced by the exact name of your serial
port.

8<------------------------------------------------------------------------------------------------------------------
As a side note, the "dialout" group has to be replaced by uucp or whatever
group that has the serial port ownership.

2) a note on Solaris USB permissions. Here is a base (warning: for MGE
only):
8<------------------------------------------------------------------------------------------------------------------
c) Bind MGE units to Solaris USB /Ugen layer using:

# add_drv -i '"usb463,ffff.1"' -m '* 0660 nut root' ugen
# update_drv -a -m '* 0666 root sys' -i '"usb463,0001.1"' ugen
# reboot -- -r
8<------------------------------------------------------------------------------------------------------------------

As a side note, we might consider generating a script for Solaris too...

Arnaud
-- 
Linux / Unix Expert R&D - Eaton - http://www.eaton.com/mgeops
Network UPS Tools (NUT) Project Leader - http://www.networkupstools.org/
Debian Developer - http://people.debian.org/~aquette/
Free Software Developer - http://arnaud.quette.free.fr/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.alioth.debian.org/pipermail/nut-upsdev/attachments/20090113/eac4f8f7/attachment.htm