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.

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)

Befehl zum Installieren der Pakete:

sudo apt-get install tgt

Oder mit apturl installieren, Link: apt://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 dar
yyyy-mm bezeichnet das Datum der Bereitstellung
reverse-domain bezeichnet 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.
NAME ist 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.