ietd.conf¶

Die Freigaben werden in der Konfigurationsdatei /etc/iet/ietd.conf definiert ^[3]. Alles, was vor der Definition des ersten Target steht, sind globale Einstellungen des iSCSI-Servers. Diese sind optional. Es bestehen folgende Konfigurationsmöglichkeiten:

iSNSServer 192.168.1.16
iSNSAccessControl No

IncomingUser joe secret
OutgoingUser jack 12charsecret

iSNSServer gibt die IP-Adresse des ISNSServers an.

iSNSAccessControl gibt an ob der iSNS-Server auch die Zugriffskontrolle durchführt.

IncommingUser joe secret definiert einen Standardbenutzer und Passwort mit welchem sich der Initiators beim Server anmelden kann, wenn es keine anderen Target-spezifischen Angaben gibt. Hier heißt der Benutzer joe und benutzt das Passwort secret

OutgoingUser definiert den Standardbenutzer welcher bei einer CHAP-Authentifizierung verwendet würde. Hier heißt der Benutzer jack und benutzt das Passwort 12charsecret

Es kann immer nur eine Art der Authentifizierung für ein Target gelten.

Bei der Definition eines Targets reichen im einfachsten Fall zwei Zeilen.

Die erste gibt dem Target den Namen.

Target iqn.yyyy-mm.<reversed domain name>:identifier

wobei

• yyyy-mm gibt das Ablaufdatum der Freigabe an. Das Format ist das Jahr gefolgt von dem Monat z.B 2010-04 für den April des Jahres 2010.

• <reversed domain name> muss durch den Hostname ersetzt werden. in einem privaten Netz kann er fast beliebig gewählt werden. Im Beispiel wird com.example benutzt.

• identifier kann durch einen beliebigen Namen ersetzt werden. Im der Beispielkonfiguration wird storage.lun1 verwendet

Dies sieht dann z.B. so aus

iqn.2010-04.com.example:storage

Die zweite gibt den Pfad zum Speichermedium an und die Art der Freigabe

Lun 0 Path=/dev/sda3,Type=fileio

Bei Path muss der vollständige Pfad zu Freigabe angegeben werden, z.B.:

/dev/sda2
/dev/md0
/dev/vg0/storage-lun1
...

Der Type fileio kann eigentlich immer benutzt werden. Der Type blockio umgeht den Linux Page-Cache und reicht somit die Zugriffe direkt auf das Gerät weiter - dies verspricht mehr Geschwindigkeit bei Blöcken, welche größer als 64k sind.

Danach können weitere optionale Angaben gemacht werden:

        Alias Test       
        IncomingUser joe secret
        OutgoingUser jim 12charpasswd

wobei

• Alias damit kann man einen Alias Namen für das Target definieren, hier heisst dieser Test.

• IncomingUser joe secret definiert ein Benutzer und Passwort, mit welchem sich der Initiator beim Server anmelden kann. Wenn man nach IncomingUser keinen Benutzer angibt, kommen die Globaleneinstellungen zu tragen. Ist dort ebenfalls kein Benutzer definiert, ist keine Authentifizierung notwendig, um auf das Target zuzugreifen.

• OutgoingUser definiert einen Benutzer, welcher bei einer CHAP Authentifizierung verwendet würde. Wenn keine Angaben nach OutgoingUser gemacht werden, kommen die Globaleneinstellungen zu tragen.

initiators.allow¶

Verbindungen auf die Freigabe müssen nun noch erlaubt werden. Hierzu muss in der Datei /etc/iet/initiators.allow^[3] eine Zeile hinzu gefügt werden. Diese beginnt mit dem Namen der Freigabe, gefolgt von der IP-Adresse des Clients, von welchem man darauf zugreifen will.

[...]
iqn.2010-04.com.example:storage 192.168.0.100

wobei

• iqn.2010-04.com.example:storage der Name der Freigabe ist

• 192.168.0.100 die IP-Adresse des Clients ist, welcher darauf zugreifen soll.

Es können auch mehrere IP-Adressen angegeben werden, diese müssen dann durch ein , getrennt werden. Um den Zugriff von allen Clients zu erlauben, kann die IP durch ein ALL ersetzt werden. IPv6 Adressen sind ebenfalls zugelassen. Wenn die Konfigurationsdateien angepasst wurde, muss das das Target neu gestartet werden, um die Änderungen wirksam zu machen. Dies geschieht in einem Terminal-Fenster ^[2] mit:

sudo /etc/init.d/iscsitarget restart 

Authentifizierung normal¶

Um den Benutzer und das Passwort für die Authentifizierung zu setzen, kann man die Datei /etc/iscsi/nodes/iqn.2010-04.com.example:storage/192.168.0.101,3260,1/default editieren. Der Pfad zur Konfigurationsdatei ist je nach benutzter IP-Adresse und Namen des Target anders.

Alternativ kann man die Daten von iscsiadm setzen lassen, dazu gibt man diese beiden Kommandos im Terminal ein ^[2]:

iscsiadm -m node --targetname "iqn.2010-04.com.example:storage" --portal "192.168.0.101:3260" --op=update --name node.session.auth.username --value=BENUTZER 
iscsiadm -m node --targetname "iqn.2010-04.com.example:storage" --portal "192.168.0.101:3260" --op=update --name node.session.auth.password --value=PASSWORT 

Es muss bei beiden Kommandos die IP-Adresse und der Targetname angepasst werden.

BENUTZER muss in den gewünschten Benutzer geändert werden und PASSWORT in das dazu passende Passwort.

Authentifizierung mit CHAP¶

Um die Authentifizierung mit CHAP (Challenge Handshake Authentication Protocol) durchzuführen, muss dieses ebenfalls mitgeteilt werden. Mit iscsiadm kann das Setzen der Konfiguration erledigt werden, dazu Folgendes im Terminal eingegeben ^[2]:

iscsiadm -m node --targetname "iqn.2001-04.com.example:storage" --portal "192.168.0.101:3260" --op=update --name node.session.auth.authmethod --value=CHAP 

Auch hier muss die IP-Adresse und der Targetname angepasst werden.