From 4fe3e330831abd15ae11be5c06e8b926afad265b Mon Sep 17 00:00:00 2001 From: Wouter Born Date: Sun, 1 May 2022 14:15:59 +0200 Subject: [PATCH] Add some docs on /var/lock permissions (#1801) Signed-off-by: Wouter Born --- administration/serial.md | 1 + 1 file changed, 1 insertion(+) diff --git a/administration/serial.md b/administration/serial.md index 3c5485af8..1e4e6191e 100644 --- a/administration/serial.md +++ b/administration/serial.md @@ -23,6 +23,7 @@ If you can see issues related to opening the serial port with Linux, and you are - Adapt Java command line arguments to include `-Dgnu.io.rxtx.SerialPorts=/dev/ttyAMA0` (where `/dev/ttyAMA0` is the serial port). If you have multiple serial ports to configure, separate them with colon (`:`). Depending on openHAB installation method, you should modify `start.sh`, `start_debug.sh`, `start.bat`, or `start_debug.bat` (standalone/manual installation) or `EXTRA_JAVA_OPTS` in `/etc/default/openhab` (Debian installation) - Depending on Linux distribution, you might need to add the user running openHAB to `dialout` user group.With Debian openHAB installation: `sudo usermod -a -G dialout openhab`. The user will need to logout from all login instances and log back in to see their new group added. If the user added to this group still cannot get permission, rebooting the box to ensure the new group permission is attached to the user is suggested. +- Make sure that the user running openHAB can create lock files in `/var/lock`. To test this e.g. execute `sudo -u openhab touch /var/lock/test`. If you run openHAB on a Debian or Ubuntu based distribution this should already work. However on distributions based on CentOS, Fedora, RedHat or Synology DSM only root can write to `/var/lock` so the permissions need to be updated. - When using more than one USB-Serial converters, it may happen that the `/dev/ttyUSB0` device is named `/dev/ttyUSB1` after a reboot. To prevent this problem, alias names can be assigned to serial devices by adding them to `/etc/udev/rules.d/99-usb-serial.rules`. Example: ```shell