USB-Stick mit udev eindeutig benennen

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Zwischenspeichern. Don't touch for the moment, please)
 
K
 
(6 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<div style="margin:0; margin-top:10px; margin-right:10px; border:1px solid #dfdfdf; padding:0 1em 1em 1em; background-color:#efdfdf; align:right;">
+
Diese Anleitung beschreibt wie man mit ''udev'' und ''usbmount'' einen {{wikipedia|USB-Massenspeicher}} anhand der Seriennummer eindeutig identifizieren und im System an einer genau festgelegten Stelle mounten kann. Ein bestimmter USB-Stick wird also nicht mal nach /media/usb0 und ein anders mal nach /media/usb2 eingebunden, sondern immer nach z.B. /mnt/videostick. Eindeutige Mountpoints erleichtern z.B. das Erstellen von Befehlen für das [[Filebrowser-plugin]].
{{In Arbeit|Bitte warten Sie mit Bearbeitungen, bis ich fertig bin und diesen Hinweis entfernt habe --[[Benutzer:HolgerAusB|HolgerAusB]] 17:09, 28. Sep 2007 (CEST)}}
+
</div>
+
 
+
Dieses '''HowTo''' beschreibt wie man mit ''udev'' und ''usbmmount'' einen USB-Speicher-Stick anhand der Seriennummer eindeutig identifizieren und im System an einer genau festgelegten Stelle mounten kann. Ein bestimmter Stick wird also nicht mal nach /media/usb0 und ein anders mal nach /media/usb2 gemountet, sondern immer nach z.B. /mnt/videostick. Eindeutige Mountpoints erleichtern z.B. das Erstellen von Befehlen für das [[Filebrowser-plugin]].
+
  
 
Das ganze sollte auch mit externen USB-Festplatten und anderen USB-Massenspeichern funktionieren.
 
Das ganze sollte auch mit externen USB-Festplatten und anderen USB-Massenspeichern funktionieren.
 +
 +
{{Box Hinweis|Nach dieser Anleitung wird ein ein Originalskript aus dem usbmount-Paket verändert. Sie tun dies ausdrücklich '''auf eigene Gefahr!''' Außerdem bedeutet dies, dass bei einem Update des Originalpaketes die Änderung am Skript u.U. erneut durchgeführt werden muss.}}
  
 
==Voraussetzungen==
 
==Voraussetzungen==
Dieser Artikel bezieht sich auf [[C't-VDR]] 6, bzw. auf Debian Etch mit installiertem udev und usbmount. Bei anderen Systemen sind die Pfadangaben möglicherweise anders.
+
Dieser Artikel basiert auf einer Installation des [[C't-VDR]] 6, bzw. auf Debian Etch mit installiertem udev und usbmount. Bei anderen Systemen sind die Pfadangaben möglicherweise anders.
 
+
{{Box Hinweis|Nach diesem HowTo wird ein ein Originalscript aus dem usbmount-Paket verändert. Sie tun dies ausdrücklich '''auf eigene Gefahr!''' Außerdem bedeutet dies, dass bei einem Update des Originalpaketes die Änderung am Script u.U. erneut durchgeführt werden muss.}}
+
  
 
==Schritt 1 - Ermittlung der Seriennummer ==
 
==Schritt 1 - Ermittlung der Seriennummer ==
Zunächst stellen wir fest, welche Seriennumer oder andere Identifzierungen unser Stick liefert. Dazu müssen wir wissen, welches Device das System beim Einstecken vergibt. Das ermitteln wir über das Syslog
+
Zunächst stellen wir fest, welche Seriennummer oder andere Identifizierungen unser USB-Stick liefert. Dazu müssen wir wissen, welches Device das System beim Einstecken vergibt. Das ermitteln wir über das Syslog:
  
 
  tail -f /var/log/syslog
 
  tail -f /var/log/syslog
  
dann den Stick einstecken. Im Syslog sollten dann etwas auftauchen wie "... kernel:  sdh: sdh1". Je nachdem wie viele SATA- oder USB-Geräte ihr angeschlossen habt unterscheidet sich die Angabe im dritten Buchstaben (sd'''h'''), also ggf. im folgenden anpassen. Mit strg-c verlassen wir die Syslog-Ausgabe.
+
dann den USB-Stick einstecken. Im Syslog sollte dann etwas auftauchen wie "... kernel:  sdh: sdh1". Je nachdem wie viele SATA- oder USB-Geräte ihr angeschlossen habt, unterscheidet sich die Angabe im dritten Buchstaben (sd'''h'''), also gegebenenfalls im folgenden anpassen. Mit Strg-c verlassen wir die Syslog-Ausgabe.
  
Als nächstes ermitteln wir mir udevinfo die eindeutige Seriennummer:
+
Als nächstes ermitteln wir mit udevinfo die eindeutige Seriennummer:
  
 
  udevinfo -a -p /sys/block/sdh
 
  udevinfo -a -p /sys/block/sdh
Zeile 31: Zeile 27:
 
     ATTRS{serial}=="0123456789ABCDEF"
 
     ATTRS{serial}=="0123456789ABCDEF"
 
     ATTRS{product}=="Cn Memory"
 
     ATTRS{product}=="Cn Memory"
 +
 
Die Seriennummer lautet hier also 0123456789ABCDEF. Die "product"-Kennung kann man für alle Fälle auch noch verwenden.
 
Die Seriennummer lautet hier also 0123456789ABCDEF. Die "product"-Kennung kann man für alle Fälle auch noch verwenden.
  
 
==Schritt 2 - Anlegen einer Regel für udev==
 
==Schritt 2 - Anlegen einer Regel für udev==
 +
Unter /etc/udev/rules.d/ befinden sich einige vordefinierte Regeln (.rules), die in alphanumerischer Reihenfolge abgearbeitet werden. Wir müssen dafür sorgen, dass unsere neue Regeldatei vor der originalen Datei z60_usbmount.rules ausgeführt wird. Unsere Regel sollte also mit z59 beginnen. Wir legen daher die neue Datei /etc/udev/rules.d/z59_usb-identifyer.rules an mit folgendem Inhalt an:
  
 +
<pre>KERNEL=="sd*", ATTRS{serial}=="0123456789ABCDEF", ATTRS{product}=="Cn Memory", SYMLINK+="videostick%n", \
 +
ENV{SPECIALMOUNTPOINT}="/mnt/videostick"
 +
</pre>
  
 +
Der Teil mit SYMLINK ist für unseren Zweck zwar nicht erforderlich, kann aber hilfreich werden, wenn wir später mal den USB-Stick manuell mounten wollen. Dann kann man statt /dev/sd[?]1 /dev/videostick1 verwenden. ATTRS{product} wurde als zusätzliches Kriterium eingefügt, nur für den Fall.
  
Wir legen für udev eine neue Regel in /etc/udev/rules.d/ an, die vor den z60.usbmount.rules ausgeführt werden sollte. Einfach eine kleinere Zahl als z60 wählen. Die Rules werden in Alphanumerischer Reihenfolge abgearbeitet. Wir legen also die neue Datei an: /etc/udef/rules.d/z59_usb-identifyer.rules
+
Wichtig hingegen ist ENV{SPECIALMOUNTPOINT}="/mnt/videostick". Hiermit übergeben wir eine neue Umgebungsvariable mit dem Wunschverzeichnis an das usbmount-Skript (nächster Schritt).
Der Inhalt wäre wie folgt:
+
  
[code]KERNEL=="sd*", ATTRS{serial}=="0123456789ABCDEF", ATTRS{product}=="Cn Memory", SYMLINK="videostick%n", ENV{SPECIALMOUNTPOINT}="/mnt/videostick"[/code]Der Teil mit SYMLINK ist für unseren Zweck zwar nicht erforderlich, kann aber hilfreich werden, wenn wir später mal den Stick manuell mounten müssen. Dann kann man statt /dev/sdx1 /dev/videostick1 verwenden. ATTRS{product} habe ich als zusätzliches Kriterium eingefügt, nur für den Fall.
+
Den Mountpoint sollten wir dann noch einmalig anlegen:
  
Wichtig hingegen ist ENV{SPECIALMOUNTPOINT}="/mnt/videostick". Hiermit übergebn wir eine neue Umgebungsvariable mit dem Wunschverzeichnis an das usbmount-Skript (nächster Schritt).
+
<pre>mkdir /mnt/videostick</pre>
  
Den Mountpoint sollten wir dann noch einmalig anlegen:
+
Wenn Sie mehrere USB-Massenspeicher zuordnen wollen, wiederholen Sie die Schritte 1 und 2 für die anderen Geräte und legen Sie für jede Seriennummer eine neue Zeile in unserer udev-Regel z59.. an und vergeben dort je einen eindeutigen SYMLINK und einen SPECIALMOUNTPOINT.
  
[code]mkdir /mnt/videostick[/code]3.)
+
==Schritt 3 - Skript von usbmount anpassen==
Über die vorhandene udef-Regel z60_umount.rules wird dann usbmount aufgerufen.
+
Über die vorhandene udev-Regel z60_umount.rules wird dann usbmount aufgerufen.
  
Da hier am Anfang des Scripts die Variable $MOUNTPOINTS leider geleert wird, können wir diese nicht direkt aus udef übergeben deshelb der Umweg.
+
Da hier am Anfang des Skripts die Variable $MOUNTPOINTS leider geleert wird, können wir diese nicht direkt aus udev übergeben, deshalb der Umweg.
 +
 
 +
Wir ändern also das Skript /usr/share/usbmount/usbmount wie folgt. Nach dem folgenden Originalabsatz...
 +
# Read configuration file.
 +
if test -r /etc/usbmount/usbmount.conf; then
 +
    . /etc/usbmount/usbmount.conf
 +
fi
 +
fügen wir neu ein:
 +
#Add special mountpoint for udev-z59-identified devices
 +
if test "$SPECIALMOUNTPOINT" != ""; then
 +
    MOUNTPOINTS="$SPECIALMOUNTPOINT $MOUNTPOINTS"
 +
fi
 +
 
 +
Erläuterung: In der original usbmount.conf steht
 +
MOUNTPOINTS="/media/usb0 /media/usb1 ... /media/usb7"
 +
Unsere Ergänzung schreibt nun das Wunschziel an den Anfang der Liste. Falls dieses zur Laufzeit aus irgendeinem Grunde nicht verfügbar ist weil zuvor fehlerhaft ge(un)mountet wurde oder der Mountpoint noch nicht mit mkdir angelegt war, wird dann als Rückfallebene wieder auf /media/usb[n] eingebunden.
 +
 
 +
==Schritt 4 - Abschlussarbeiten==
 +
Wir müssen noch den udev-daemon neu starten, damit die neue z59-Regel auch aktiv wird:
 +
 
 +
/etc/init.d/udev restart
 +
 
 +
Damit sollte zumindest das automatische Mounten beim Einstecken des USB-Sticks funktionieren. Starten Sie zum Testen wieder das aus Schritt 1 bekannte
 +
 
 +
tail -f /var/log/syslog
  
Wir ändern das Skript /usr/share/usbmount/usbmount wie folgt. Der erste Absatz ist orginal, danach wird eingefügt:
+
und stecken dann den USB-Stick ein, usbmount sollte dann nach wenigen Sekunden etwa folgendes melden:
 +
usbmount[30261]: executing command: mount -tvfat -o...[gekürzt]... /dev/sdh1 /mnt/videostick
 +
Glückwunsch! Sie haben es geschafft.
  
[code]# Read configuration file.
+
Zum manuellen Mounten ergänzt man geschickter Weise noch die /etc/fstab um den in Schritt 2 angelegten SYMLINK:
if test -r /etc/usbmount/usbmount.conf; then
+
    . /etc/usbmount/usbmount.conf
+
fi
+
  
#Add special mountpoint for udev-z59-identified devices
+
/dev/videostick1 /mnt/videostick vfat rw,async,group
if test "$SPECIALMOUNTPOINT" != ""; then
+
    MOUNTPOINTS="$SPECIALMOUNTPOINT $MOUNTPOINTS"
+
fi[/code]Erläuterung: In der original usbmount.conf steht
+
MOUNTPOINTS="/media/usb0 /media/usb1 ... /media/usb7"
+
Meine Ergänzung schreibt nun das Wunschziel an den Anfang der Liste. Falls das aus irgendeinem Grunde nicht verfügbar ist weil zuvor fehlerhaft ge(un)mountet wurde oder der Mountpoint noch nicht mit mkdir angelegt war, wird dann als Rückfallebene wieder auf /media/usb[n] gemountet.
+
  
4.)
+
==Literatur==
Wir müssen jetzt aber noch den udev-daemon neu starten, damit die neue z59-Regel auch aktiv wird:
+
* Mirko Dölle: ''USB-Automateur. USB-Geräte unter Linux erkennen und in automatische Prozesse einbinden''. In: ''c't''. 16/2007, S. 184-186.
  
[code]/etc/init.d/udev restart[/code]Damit sollte zumindest das automatische Mounten beim Einstecken des Sticks funktionieren. Zum manuellen Mounten ergänzt man geschickter Weise noch die /etc/fstab um den in Schritt 2 angelegten SYMLINK:
+
==Weblinks==
 +
* [http://www.vdr-portal.de/board/thread.php?threadid=69101 Ursprungsartikel von HolgerAusB bei vdr-portal.de] - Bei Problemen mit der Umsetzung bitte dort nachfragen
  
[code]/dev/videostick1 /mnt/videostick vfat rw,async,group[/code]
+
[[Kategorie:C't-VDR]]
 +
[[Kategorie:Debian]]

Aktuelle Version vom 30. Juni 2013, 22:56 Uhr

Diese Anleitung beschreibt wie man mit udev und usbmount einen USB-Massenspeicher anhand der Seriennummer eindeutig identifizieren und im System an einer genau festgelegten Stelle mounten kann. Ein bestimmter USB-Stick wird also nicht mal nach /media/usb0 und ein anders mal nach /media/usb2 eingebunden, sondern immer nach z.B. /mnt/videostick. Eindeutige Mountpoints erleichtern z.B. das Erstellen von Befehlen für das Filebrowser-plugin.

Das ganze sollte auch mit externen USB-Festplatten und anderen USB-Massenspeichern funktionieren.

Hinweis
Hinweis

Nach dieser Anleitung wird ein ein Originalskript aus dem usbmount-Paket verändert. Sie tun dies ausdrücklich auf eigene Gefahr! Außerdem bedeutet dies, dass bei einem Update des Originalpaketes die Änderung am Skript u.U. erneut durchgeführt werden muss.


Inhaltsverzeichnis

[Bearbeiten] Voraussetzungen

Dieser Artikel basiert auf einer Installation des C't-VDR 6, bzw. auf Debian Etch mit installiertem udev und usbmount. Bei anderen Systemen sind die Pfadangaben möglicherweise anders.

[Bearbeiten] Schritt 1 - Ermittlung der Seriennummer

Zunächst stellen wir fest, welche Seriennummer oder andere Identifizierungen unser USB-Stick liefert. Dazu müssen wir wissen, welches Device das System beim Einstecken vergibt. Das ermitteln wir über das Syslog:

tail -f /var/log/syslog

dann den USB-Stick einstecken. Im Syslog sollte dann etwas auftauchen wie "... kernel: sdh: sdh1". Je nachdem wie viele SATA- oder USB-Geräte ihr angeschlossen habt, unterscheidet sich die Angabe im dritten Buchstaben (sdh), also gegebenenfalls im folgenden anpassen. Mit Strg-c verlassen wir die Syslog-Ausgabe.

Als nächstes ermitteln wir mit udevinfo die eindeutige Seriennummer:

udevinfo -a -p /sys/block/sdh

Hier erhalten wir eine in Blöcke unterteilte lange Ausgabe. In einem der Blöcke finden sich die für uns interessanten Angaben:

looking at parent device '/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2.4':
   KERNELS=="5-2.4"
   SUBSYSTEMS=="usb"
   DRIVERS=="usb"
   ATTRS{serial}=="0123456789ABCDEF"
   ATTRS{product}=="Cn Memory"

Die Seriennummer lautet hier also 0123456789ABCDEF. Die "product"-Kennung kann man für alle Fälle auch noch verwenden.

[Bearbeiten] Schritt 2 - Anlegen einer Regel für udev

Unter /etc/udev/rules.d/ befinden sich einige vordefinierte Regeln (.rules), die in alphanumerischer Reihenfolge abgearbeitet werden. Wir müssen dafür sorgen, dass unsere neue Regeldatei vor der originalen Datei z60_usbmount.rules ausgeführt wird. Unsere Regel sollte also mit z59 beginnen. Wir legen daher die neue Datei /etc/udev/rules.d/z59_usb-identifyer.rules an mit folgendem Inhalt an:

KERNEL=="sd*", ATTRS{serial}=="0123456789ABCDEF", ATTRS{product}=="Cn Memory", SYMLINK+="videostick%n", \
ENV{SPECIALMOUNTPOINT}="/mnt/videostick"

Der Teil mit SYMLINK ist für unseren Zweck zwar nicht erforderlich, kann aber hilfreich werden, wenn wir später mal den USB-Stick manuell mounten wollen. Dann kann man statt /dev/sd[?]1 /dev/videostick1 verwenden. ATTRS{product} wurde als zusätzliches Kriterium eingefügt, nur für den Fall.

Wichtig hingegen ist ENV{SPECIALMOUNTPOINT}="/mnt/videostick". Hiermit übergeben wir eine neue Umgebungsvariable mit dem Wunschverzeichnis an das usbmount-Skript (nächster Schritt).

Den Mountpoint sollten wir dann noch einmalig anlegen:

mkdir /mnt/videostick

Wenn Sie mehrere USB-Massenspeicher zuordnen wollen, wiederholen Sie die Schritte 1 und 2 für die anderen Geräte und legen Sie für jede Seriennummer eine neue Zeile in unserer udev-Regel z59.. an und vergeben dort je einen eindeutigen SYMLINK und einen SPECIALMOUNTPOINT.

[Bearbeiten] Schritt 3 - Skript von usbmount anpassen

Über die vorhandene udev-Regel z60_umount.rules wird dann usbmount aufgerufen.

Da hier am Anfang des Skripts die Variable $MOUNTPOINTS leider geleert wird, können wir diese nicht direkt aus udev übergeben, deshalb der Umweg.

Wir ändern also das Skript /usr/share/usbmount/usbmount wie folgt. Nach dem folgenden Originalabsatz...

# Read configuration file.
if test -r /etc/usbmount/usbmount.conf; then
    . /etc/usbmount/usbmount.conf
fi

fügen wir neu ein:

#Add special mountpoint for udev-z59-identified devices
if test "$SPECIALMOUNTPOINT" != ""; then
    MOUNTPOINTS="$SPECIALMOUNTPOINT $MOUNTPOINTS"
fi

Erläuterung: In der original usbmount.conf steht

MOUNTPOINTS="/media/usb0 /media/usb1 ... /media/usb7"

Unsere Ergänzung schreibt nun das Wunschziel an den Anfang der Liste. Falls dieses zur Laufzeit aus irgendeinem Grunde nicht verfügbar ist weil zuvor fehlerhaft ge(un)mountet wurde oder der Mountpoint noch nicht mit mkdir angelegt war, wird dann als Rückfallebene wieder auf /media/usb[n] eingebunden.

[Bearbeiten] Schritt 4 - Abschlussarbeiten

Wir müssen noch den udev-daemon neu starten, damit die neue z59-Regel auch aktiv wird:

/etc/init.d/udev restart

Damit sollte zumindest das automatische Mounten beim Einstecken des USB-Sticks funktionieren. Starten Sie zum Testen wieder das aus Schritt 1 bekannte

tail -f /var/log/syslog

und stecken dann den USB-Stick ein, usbmount sollte dann nach wenigen Sekunden etwa folgendes melden:

usbmount[30261]: executing command: mount -tvfat -o...[gekürzt]... /dev/sdh1 /mnt/videostick

Glückwunsch! Sie haben es geschafft.

Zum manuellen Mounten ergänzt man geschickter Weise noch die /etc/fstab um den in Schritt 2 angelegten SYMLINK:

/dev/videostick1 /mnt/videostick vfat rw,async,group

[Bearbeiten] Literatur

  • Mirko Dölle: USB-Automateur. USB-Geräte unter Linux erkennen und in automatische Prozesse einbinden. In: c't. 16/2007, S. 184-186.

[Bearbeiten] Weblinks