tgtd
Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:
Dieser Artikel ist mit keiner aktuell unterstützten Ubuntu-Version getestet! Bitte teste diesen Artikel für eine Ubuntu-Version, welche aktuell unterstützt wird. Dazu sind die Hinweise zum Testen von Artikeln zu beachten.
Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:
Dieser Artikel beschreibt das Erzeugen von iSCSI-Freigaben über den Dienst tgtd und das Verwaltungsprogramm tgtadm aus dem Paket tgt. tgtd läuft im Userspace und hat (im Gegensatz etwa zu Archiv/iscsitarget) keine Abhängigkeiten zu Kernel-Modulen.
Eine Übersicht zu Alternativen findet sich im Artikel iSCSI (Abschnitt „Target“).
Installation¶
tgt ist in den Paketquellen vorhanden [1].
tgt (main, ab 22.04 universe)
Befehl zum Installieren der Pakete:
sudo apt-get install tgt
LUN-Files-erzeugen¶
Wie man Dateien für die Freigabe erzeugt, ist im Artikel iSCSI (Abschnitt „LUN-Files-erzeugen“) beschrieben.
Freigaben erzeugen¶
Freigaben können direkt über das Kommando tgtadm erzeugt werden. Dazu sind Root-Rechte notwendig [2][3]:
Achtung!
Die nachfolgenden Freigaben sind zunächst nicht persistent, d.h. nach einem Dienst- oder Systemneustart sind sie verloren. Persistente Freigaben müssen in /etc/tgt/targets.conf oder unter /etc/tgt/conf.d/ abgelegt werden.
Targets erzeugen¶
offizielle ISCSI-Syntax:
sudo tgtadm --lld iscsi --op new --mode target --tid <TID> -T <iqn.yyyy-mm.reverse-domain:NAME>
<TID>stellt die eindeutige Nummer des Targets daryyyy-mmbezeichnet das Datum der Bereitstellungreverse-domainbezeichnet die umgekehrte Reihenfolge der (Sub)Domain, falls der Service im Internet aufrufbar ist. Für die interne Bereitstellung kann der Name frei gewählt werden.NAMEist der eindeutige Name des Targets
Beispiel:
sudo tgtadm --lld iscsi --op new --mode target --tid 1 -T iqn.2018-07.de.ubuntuusers.wiki.iscsi:freigabe1
LUNs erzeugen¶
sudo tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 \
-b /var/lib/iscsi/ubuntu-1604 Targets frei geben¶
sudo tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
aktuelle Konfiguration speichern¶
Um die angelegten Freigaben zu speichern, kann man die aktuelle Konfiguration in eine Datei schreiben. Dies führt man mit dem Kommando tgt-admin (!) durch.
Beispiel:
sudo tgt-admin --dump | sudo tee /etc/tgt/conf.d/ubuntu-1604.conf
Konfiguration händisch erstellen¶
Man kann auch direkt die entsprechenden Konfigurationsdateien erzeugen. Anschließend muss die Konfiguration neu eingelesen werden:
sudo tgt-admin --update ALL
Links¶
Install tgt for iSCSI target (Ubuntu 16.04) 🇬🇧 - Stand 07/2017
TGT iSCSI Target 🇬🇧 - ArchWiki