[[Vorlage(Getestet, , bionic)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:sudo: Root-Rechte]
[:iSCSI:]
}}}
[[Inhaltsverzeichnis()]]

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/#Target:]. 

= Installation =
'''tgt''' ist in den Paketquellen vorhanden [1].

{{{#!vorlage Paketinstallation
tgt, main
}}}

= LUN-Files-erzeugen =
Wie man Dateien für die Freigabe erzeugt, ist im Artikel [:iSCSI/#LUN-Files-erzeugen:] beschrieben.

= Freigaben erzeugen =

Freigaben können direkt über das Kommando tgtadm erzeugt werden. Dazu sind Root-Rechte notwendig [2][3]:

{{{#!vorlage Warnung
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:
{{{#!vorlage Befehl
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:
{{{#!vorlage Befehl
sudo tgtadm --lld iscsi --op new --mode target --tid 1 -T iqn.2018-07.de.ubuntuusers.wiki.iscsi:freigabe1
}}}

== LUNs erzeugen ==
{{{#!vorlage Befehl
sudo tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 \
       -b /var/lib/iscsi/ubuntu-1604
}}}

== Targets frei geben ==
{{{#!vorlage Befehl
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:
{{{#!vorlage Befehl
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:
{{{#!vorlage Befehl
sudo tgt-admin --update ALL
}}}

= Links =
 * [http://stgt.sourceforge.net tgt Projektseite] {en}
 * [wikipedia:iSCSI:]
 * [https://www.hiroom2.com/2017/07/11/ubuntu-1604-tgt-en Install tgt for iSCSI target (Ubuntu 16.04)] {en} - Stand 07/2017
 * [archwiki:TGT_iSCSI_Target:TGT iSCSI Target] {en} - ArchWiki

# tag: Netzwerk, System, Server, iSCSI