IBM Cloud Docs
Montare il volume iSCSI su Ubuntu OS

Montare il volume iSCSI su Ubuntu OS

Questa esercitazione spiega come montare un volume IBM Cloud® Block Storage for Classic su un server con un sistema operativo Ubuntu. Creerai due connessioni da un'interfaccia di rete del tuo host a due indirizzi IP di destinazione dell'array di archiviazione.

Se si utilizza un altro sistema operativo Linux®, consultare la documentazione della distribuzione specifica e assicurarsi che il multipath supporti ALUA per la priorità dei percorsi.

Prima di iniziare

Se più host montano lo stesso volume Block Storage for Classic senza essere gestiti in modo cooperativo, i tuoi dati sono a rischio di danneggiamento. Il danneggiamento del volume può verificarsi se vengono apportate modifiche al volume da più host contemporaneamente. È necessario un file system del disco condiviso, che riconosce il cluster, per evitare la perdita di dati come Microsoft Cluster Shared Volumes (CSV), Red Hat Global File System (GFS2), VMware® VMFS e altri. Per ulteriori informazioni, consultare la documentazione del sistema operativo dell'host.

Consigliamo di eseguire il traffico di archiviazione su una VLAN che ignora il firewall. L'esecuzione del traffico di archiviazione tramite i firewall software aumenta la latenza e ha un impatto negativo sulle prestazioni dell'archiviazione. Per ulteriori informazioni sull'instradamento del traffico di archiviazione all'interfaccia VLAN, vedi le FAQ.

Prima di iniziare la configurazione di iSCSI,, assicuratevi che le interfacce di rete siano impostate e configurate correttamente per il corretto funzionamento del pacchetto open-iscsi, soprattutto durante l'avvio. Nelle versioni più recenti di Ubuntu, lo strumento principale per impostare le informazioni sugli indirizzi di rete è Netplan. Utilizza un file di configurazione YAML per definire le impostazioni di rete, sostituendo i vecchi metodi come /etc/network/interfaces. Netplan può essere configurato con la riga di comando o attraverso il sito NetworkManager negli ambienti desktop.

Per ulteriori informazioni sul funzionamento del servizio iSCSI sul sistema operativo Ubuntu, consultare la Documentazione dell 'iniziatore(o client)iSCSI.

Assicurarsi inoltre che l'host che deve accedere al volume Block Storage for Classic sia autorizzato. Per ulteriori informazioni, vedere Autorizzazione dell'host nella console Autorizzazione dell'host dalla CLI Autorizzazione dell'host con Terraform.

Installa i programmi di utilità iSCSI e a più percorsi

Assicurarsi che il sistema sia aggiornato e che includa i pacchetti open-iscsi e multipath-tools. Utilizzare i seguenti comandi per installare i package.

  • Installare open-iscsi.

    sudo apt install open-iscsi

    Quando il package è installato, vengono creati i seguenti due file.

    • /etc/iscsi/iscsid.conf
    • /etc/iscsi/initiatorname.iscsi

  • Installare multipath-tools.

    sudo apt install multipath-tools

    Se si desidera avviare il sistema dal volume, è necessario installare anche il pacchetto multipath-tools-boot.

Impostare il percorso multiplo

  1. Dopo aver installato il programma di utilità multipath, creare un file di configurazione vuoto denominato /etc/multipath.conf.

  2. Modificare i valori predefiniti di /etc/multipath.conf.

    defaults {
user_friendly_names no
max_fds max
flush_on_last_del yes
queue_without_daemon no
dev_loss_tmo infinity
fast_io_fail_tmo 5
}
# All data in the following section must be specific to your system.
blacklist {
wwid "SAdaptec*"
devnode "^hd[a-z]"
devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
devnode "^cciss.*"
}
devices {
device {
vendor "NETAPP"
product "LUN"
path_grouping_policy group_by_prio
features "3 queue_if_no_path pg_init_retries 50"
prio "alua"
path_checker tur
failback immediate
path_selector "round-robin 0"
hardware_handler "1 alua"
rr_weight uniform
rr_min_io 128
}

    La sezione dei valori predefiniti iniziali del file di configurazione configura il sistema in modo che i nomi delle periferiche a più percorsi siano nel formato /dev/mapper/mpathn, dove mpathn è il numero WWID della periferica. Per ulteriori informazioni, consultare i manuali Ubuntu- multipath.conf.

  3. Salvare il file di configurazione e uscire dall'editor, se necessario.

  4. Avviare il servizio a più percorsi.

    service multipath-tools start

    Se è necessario modificare il file di configurazione a più percorsi dopo aver avviato il daemon a più percorsi, è necessario riavviare il servizio multipathd per rendere effettive le modifiche.

    Per ulteriori informazioni sull'utilizzo della funzione Device Mapper Multipath su Ubuntu 20, consulta Device Mapper Multipathing - Introduzione.

Aggiornare il file /etc/iscsi/initiatorname.iscsi

Aggiornare il file /etc/iscsi/initiatorname.iscsi con l'IQN dalla console IBM Cloud®. Immetti il valore con lettere minuscole.

InitiatorName=<value-from-the-Portal>

Configura credenziali

Modificare le seguenti impostazioni in /etc/iscsi/iscsid.conf utilizzando il nome utente e la password della console IBM Cloud®. Usa le maiuscole per i nomi CHAP.

node.session.auth.authmethod = CHAP
node.session.auth.username = <Username-value-from-Portal>
node.session.auth.password = <Password-value-from-Portal>
discovery.sendtargets.auth.authmethod = CHAP
discovery.sendtargets.auth.username = <Username-value-from-Portal>
discovery.sendtargets.auth.password = <Password-value-from-Portal>

Lasciare le altre impostazioni CHAP commentate. L'archiviazione IBM Cloud® utilizza solo l'autenticazione unidirezionale. Non abilitare Mutual CHAP.

Riavviare il servizio iscsi affinché le modifiche abbiano effetto.

systemctl restart iscsid.service

Per maggiori informazioni, vedere i manuali Ubuntu- iscsid e manuali di Ubuntu- systemctl.

Rileva il dispositivo di archiviazione e accedi

L'utility iscsiadm è uno strumento a riga di comando utilizzato per la scoperta e l'accesso a target iSCSI, oltre che per l'accesso e la gestione del database open-iscsi. Per ulteriori informazioni, consultare i manuali dell' Ubuntu: iscsiadm. In questa fase, scoprire il dispositivo utilizzando l'indirizzo IP di destinazione ottenuto dalla console dell' IBM Cloud®.

  1. Eseguire il rilevamento sull'array iSCSI.

    iscsiadm -m discovery -t sendtargets -p <ip-value-from-IBM-Cloud-console>

    Se vengono visualizzate le informazioni IP e i dettagli di accesso, il rilevamento ha esito positivo.

  2. Configurare il login automatico.

    sudo iscsiadm -m node --op=update -n node.conn[0].startup -v automatic
sudo iscsiadm -m node --op=update -n node.startup -v automatic

  3. Abilitare i servizi necessari.

    systemctl enable open-iscsi
systemctl enable iscsid

  4. Riavviare il servizio iscsid.

    systemctl restart iscsid.service

  5. Accedi all'array iSCSI.

    sudo iscsiadm -m node --loginall=automatic

Verifica della configurazione

  1. Convalidare che sia stata stabilita la sessione iSCSI.

    iscsiadm -m session -o show

  2. Convalidare che esistono più percorsi.

    multipath -ll

    Questo comando riporta i percorsi. Se la configurazione è corretta, ogni volume ha un singolo gruppo, con un numero di percorsi pari al numero di sessioni iSCSI. È possibile collegare un volume con un solo percorso, ma è importante che le connessioni siano stabilite su entrambi i percorsi per evitare interruzioni del servizio.

    $ sudo multipath -ll
mpathb (360014051f65c6cb11b74541b703ce1d4) dm-1 LIO-ORG,TCMU device
size=1.0G features='0' hwhandler='0' wp=rw
|-+- policy='service-time 0' prio=1 status=active
| `- 7:0:0:2 sdh 8:112 active ready running
`-+- policy='service-time 0' prio=1 status=enabled
  `- 8:0:0:2 sdg 8:96  active ready running
mpatha (36001405b816e24fcab64fb88332a3fc9) dm-0 LIO-ORG,TCMU device
size=1.0G features='0' hwhandler='0' wp=rw
|-+- policy='service-time 0' prio=1 status=active
| `- 7:0:0:1 sdj 8:144 active ready running
`-+- policy='service-time 0' prio=1 status=enabled
  `- 8:0:0:1 sdi 8:128 active ready running

    Se MPIO non è configurato correttamente, il tuo dispositivo di archiviazione potrebbe disconnettersi e presentarsi come offline quando si verifica un'interruzione di rete oppure quando i team di IBM Cloud® eseguono la manutenzione. MPIO fornisce un ulteriore livello di connettività durante questi eventi e mantiene una sessione stabilita con il volume con operazioni di lettura/scrittura attive.

    Nell'esempio,36001405b816e24fcab64fb88332a3fc9 è il WWID persistente mentre il volume esiste. Si consiglia che l'applicazione utilizzi il WWID. È anche possibile assegnare nomi più facili da leggere usando le parole chiave "user_friendly_names" o "alias" in multipath.conf.

  3. Controllare dmesg per assicurarsi che i nuovi dischi siano rilevati.

    dmesg

Creazione di una partizione e di un file system (facoltativo)

Una volta montato e accessibile il volume sull'host, è possibile creare un filesystem. Segui questa procedura per creare un file system sul volume appena montato.

  1. Creare una partizione.

    $ sudo fdisk /dev/mapper/mpatha

Welcome to fdisk (util-linux 2.34).
Changes will remain in memory only, until you decide to write them.
Be careful before using the write command.

Device does not contain a recognized partition table.
Created a new DOS disklabel with disk identifier 0x92c0322a.

Command (m for help): p
Disk /dev/mapper/mpatha: 1 GiB, 1073741824 bytes, 2097152 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 65536 bytes
Disklabel type: dos
Disk identifier: 0x92c0322a

Command (m for help): n
Partition type
   p   primary (0 primary, 0 extended, 4 free)
   e   extended (container for logical partitions)
Select (default p): p
Partition number (1-4, default 1):
First sector (2048-2097151, default 2048):
Last sector, +/-sectors or +/-size{K,M,G,T,P} (2048-2097151, default 2097151):

Created a new partition 1 of type 'Linux' and of size 1023 MiB.

Command (m for help): w
The partition table has been altered.

  2. Creare il filesystem.

    $ sudo mkfs.ext4 /dev/mapper/mpatha-part1
mke2fs 1.45.5 (07-Jan-2020)
Creating filesystem with 261888 4k blocks and 65536 inodes
Filesystem UUID: cdb70b1e-c47c-47fd-9c4a-03db6f038988
Superblock backups stored on blocks:
        32768, 98304, 163840, 229376

Allocating group tables: done
Writing inode tables: done
Creating journal (4096 blocks): done
Writing superblocks and filesystem accounting information: done

  3. Montare l'unità a blocchi.

    sudo mount /dev/mapper/mpatha-part1 /mnt

  4. Accedere ai dati per verificare che la nuova partizione e il nuovo sistema di file siano pronti per l'uso.

    ls /mnt

Smontaggio dei volumi Block Storage for Classic

Quando il volume non ti serve più, smontalo prima di eliminarlo.

  1. Smonta il file system.

    umount /dev/mapper/XXXp1 /PerfDisk

    Per ulteriori informazioni, consultare i manuali dell' Ubuntu: umount.

  2. Se non disponi di altri volumi in quel portale di destinazione, puoi scollegarti dalla destinazione.

    iscsiadm -m node -t <TARGET NAME> -p <PORTAL IP:PORT> --logout

  3. Se non disponi di altri volumi in quel portale di destinazione, elimina il record del portale di destinazione per impedire tentativi di login futuri.

    iscsiadm -m node -o delete -t <TARGET IQN> -p <PORTAL IP:PORT>

    Per ulteriori informazioni, consultare i manuali dell' Ubuntu: iscsiadm.