Documentazione di Oracle Cloud Infrastructure

Risoluzione dei problemi relativi ai collegamenti dei volumi a prestazioni ultra elevate

In questo argomento vengono descritti i passi per la risoluzione dei problemi che è possibile eseguire, nonché i prerequisiti per la verifica dei volumi configurati per il livello Ultra High Performance in cui il volume non viene collegato o il collegamento del volume non è abilitato per il multipath.

Risoluzione dei problemi relativi ai collegamenti ai volumi

Il plugin Gestione volumi a blocchi è necessario per i volumi configurati per Ultra High Performance, collegati utilizzando il tipo di collegamento iSCSI. Se il volume non riesce a collegarsi all'istanza, è probabile che il problema sia causato da una configurazione errata per il plugin di gestione dei volumi a blocchi. Vedere i suggerimenti di risoluzione dei problemi in questa sezione per questi problemi.

Errore di log del plugin di gestione dei volumi a blocchi: collegamento del volume non autorizzato o errore non trovato

Se le autorizzazioni non sono state configurate correttamente per il plugin Gestione dei volumi a blocchi, il volume non verrà collegato all'istanza.

Dettagli

Il volume non verrà visualizzato come collegato nella console e nel log del plugin Gestione volumi a blocchi verrà visualizzato un messaggio di errore NotAuthorizedOrNotFound.

Il log del plugin di gestione dei volumi a blocchi si trova in:

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

Di seguito è riportata una voce di log degli errori di esempio per questo problema.

2021/08/13 09:14:25.864932 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/08/13 09:14:26.155473 compute_client_command.go:260: Service error:NotAuthorizedOrNotFound.
volume attachment ocid1.volumeattachment.oc1.iad.<volume-attachment_ID> not found.
http status code: 404. Opc request id: <request_ID>

Causa

Il plugin Gestione volumi a blocchi non dispone di autorizzazioni sufficienti per inviare al servizio la notifica dello stato di login iSCSI.

Risoluzione

Per configurare le autorizzazioni per il plugin Gestione volumi a blocchi, effettuare le operazioni riportate di seguito.

  1. Crea gruppo dinamico: creare un gruppo dinamico con le regole di corrispondenza nell'esempio di codice riportato di seguito per includere tutte le istanze nei compartimenti specificati.

    ANY {instance.compartment.id = 'ocid1.tenancy.oc1..<tenancy_ID>', instance.compartment.id = 'ocid1.compartment.oc1..<compartment_OCID>'

  2. Configura criterio per gruppo dinamico: configurare un criterio che conceda le autorizzazioni al gruppo dinamico creato nel passo precedente per abilitare l'accesso dell'agente dell'istanza per chiamare il servizio del volume a blocchi per recuperare la configurazione del collegamento.

    Allow dynamic-group InstantAgent to use instances in tenancy
Allow dynamic-group InstantAgent to use volume-attachments in tenancy

Risorse

Errore del log del plugin di gestione dei volumi a blocchi: l'agente utente non può essere vuoto

L'istanza di computazione deve disporre di un indirizzo IP pubblico o di un gateway di servizi per poter connettersi ai servizi Oracle, altrimenti il volume non riuscirà a collegarsi.

Dettagli

Il volume non verrà visualizzato come collegato nella console e nel log del plugin Gestione volumi a blocchi verrà visualizzato un messaggio di errore user agent can not be blank.

Il log del plugin di gestione dei volumi a blocchi si trova in:

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

Di seguito è riportata una voce di log degli errori di esempio per questo problema.

2021/10/15 22:16:07.881953 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/10/15 22:16:07.882185 compute_client_command.go:260: user agent can not be blank
2021/10/15 22:16:07.882204 iscsi_commands_helper.go:302: user agent can not be blank
2021/10/15 22:16:07.882212 iscsi_commands_helper.go:310: user agent can not be blank

Causa

Il plugin Gestione volumi a blocchi non può inviare la notifica dello stato di login iSCSI al servizio a causa della configurazione di rete.

Risoluzione

Se l'istanza non dispone di un indirizzo IP pubblico, impostare un gateway di servizi sulla rete VCN (Virtual Cloud Network). Il gateway del servizio consente alla tua istanza di accedere in privato ai servizi Oracle senza esporre i dati alla rete Internet pubblica. Di seguito sono riportate note speciali per l'impostazione del gateway del servizio per il plugin Gestione volumi a blocchi.

  • Quando si crea il gateway del servizio, abilitare l'etichetta del servizio denominata Tutti i servizi <region> in Oracle Services Network.
  • Quando si imposta l'instradamento per la subnet che contiene l'istanza, impostare una regola di instradamento con Tipo di destinazione impostato su Gateway di servizio e il Servizio di destinazione impostato su Tutti i servizi <region> in Oracle Services Network.

Per istruzioni dettagliate, vedere Accesso ai servizi Oracle: gateway di servizi.

Risorse

Il collegamento del volume non è abilitato per più percorsi

Quando si collega un volume configurato per il livello Ultra High Performance per ottenere le prestazioni ottimali, il collegamento del volume deve essere abilitato per il multipath. Il servizio per volumi a blocchi tenta di abilitare il collegamento per il multipath quando il volume viene collegato. Se non sono stati soddisfatti tutti i prerequisiti, il collegamento del volume non sarà abilitato per il multipath.

Controllo per determinare se un collegamento del volume è abilitato per più percorsi

Per verificare se un collegamento di volume è abilitato per il multipath nella console dalla pagina Dettagli volume, effettuare le operazioni riportate di seguito.

  1. Aprire il menu di navigazione e selezionare Memorizzazione. In Storage a blocchi, selezionare Volumi a blocchi.

  2. Fare clic sul volume a blocchi per il quale si desidera controllare il collegamento del volume.

  3. Fare clic su Istanze collegate nella sezione Risorse.

  4. Controllare il valore visualizzato nella colonna Multipath.

    • Sì: il volume è configurato per il livello Ultra High Performance e il collegamento del volume è abilitato per il multipath. Nessuna altra azione richiesta.

    • No: il volume non è configurato per il livello Ultra High Performance e non è necessario che sia abilitato per il multipath. Nessuna altra azione richiesta.
    • No con un'icona di avvertenza: il volume è configurato per il livello Ultra High Performance, ma il collegamento del volume non è abilitato per il multipath. Per ottenere prestazioni ottimali, è necessario assicurarsi che il volume sia collegato a una forma di istanza supportata e che siano configurati i prerequisiti necessari.

Se il volume è configurato per il livello Ultra High Performance, ma non è configurato per il multipath come richiesto, la colonna Multipath conterrà No con un triangolo di avvertenza, come mostrato per la prima riga nello screenshot seguente:

Valori della colonna Multipath nella console.

Per ulteriori procedure per verificare se un volume è abilitato per il multipath, incluso l'uso dell'interfaccia CLI o dell'interfaccia API, vedere Verifica della presenza di un collegamento del volume abilitato per più percorsi.

Se il volume non è configurato per il multipath, per risolvere il problema, esaminare le informazioni descritte in questa sezione e risolvere eventuali problemi.

L'istanza deve essere basata su una forma di computazione supportata

È necessario collegare un volume configurato per il livello Ultra High Performance a un'istanza basata su una forma supportata, configurata per almeno 16 memorie centrali.

Forme supportate

Tutte le forme bare metal correnti supportano collegamenti iSCSI abilitati per multipath. Per ulteriori informazioni, vedere Forme Bare Metal per le caratteristiche delle prestazioni dei volumi a blocchi collegati alle istanze Bare Metal.

Le forme VM correnti configurate per almeno 16 memorie centrali supportano collegamenti abilitati per multipath. Per informazioni sulle caratteristiche delle prestazioni dei volumi collegati alle VM, vedere Forme VM per i volumi iSCSI e collegati pseudo-virtualizzati.

Risoluzione

Se il volume non è collegato a un'istanza con una configurazione di forma supportata, è necessario scollegarlo e collegarlo a un'istanza con una configurazione di forma supportata.

Inoltre, puoi modificare l'istanza esistente in modo che abbia la configurazione della forma corretta, ma devi assicurarti di scollegare e ricollegare il volume dopo aver modificato l'istanza.

Avvertenza

Se l'istanza ha meno di 8 OCPU, potrebbe verificarsi un problema in cui, dopo aver modificato l'istanza per supportare i collegamenti abilitati per multipath, il collegamento del volume non è ancora abilitato per multipath, anche dopo aver scollegato e ricollegato il volume. In questo scenario, è necessario ricreare l'istanza da una forma supportata, quindi collegare il volume alla nuova istanza. Per ulteriori informazioni, vedere Collegamento del volume pseudo-virtualizzato non abilitato per il multipath dopo il ridimensionamento dell'istanza.

Risorse

L'immagine di computazione deve supportare collegamenti tra più percorsi

È necessario collegare un volume configurato per il livello Ultra High Performance a un'istanza in cui è in esecuzione un'immagine che supporta i collegamenti multipath. Questo include immagini personalizzate.

Immagini supportate per allegati iSCI

Solo le immagini della piattaforma su cui è in esecuzione Oracle Linux o immagini personalizzate basate su immagini Oracle Linux supportano gli allegati multipath.

Utilizza una delle immagini Oracle Linux della piattaforma più recenti, con una versione Unbreakable Enterprise Kernel (UEK) di UEK6U1 o successiva.

Per le immagini personalizzate, anche la versione UEEK (Unbreakable Enterprise Kernel) deve essere UEK6U1 o successiva. L'UEK UEK6U1 è associato alla release principale del kernel versione 5.4.17-2036, rilasciata a novembre 2020. È inoltre necessario aggiornare la proprietà Storage.Iscsi.MultipathDeviceSupported per l'immagine personalizzata in true e avviare di nuovo l'istanza. Per ulteriori informazioni, vedere Configurazione delle funzionalità di immagine per le immagini personalizzate

Immagini supportate per allegati pseudo-virtualizzati

Per gli allegati abilitati per multipath, l'istanza collegata deve eseguire una delle immagini seguenti o un'immagine personalizzata in base a una di queste immagini:

  • Oracle Linux
  • Ubuntu
  • CentOS
  • Finestre
Nota

I collegamenti abilitati per più percorsi non sono supportati per le istanze di Oracle Autonomous Linux.

Utilizza una delle immagini Oracle Linux della piattaforma più recenti, con una versione Unbreakable Enterprise Kernel (UEK) di UEK6U1 o successiva.

Risorse

Ricollegare il volume

Se la configurazione della forma o l'immagine di un'istanza è stata aggiornata a una che supporta collegamenti multipath, è necessario scollegare il volume dall'istanza e collegarlo di nuovo all'istanza.

Risorse

Genera un file diagnostico per gli allegati iSCSI

Per gli allegati iSCSI, se sono stati eseguiti tutti i passi descritti in questo argomento e si verifica ancora un problema con il collegamento del volume, attenersi alla procedura descritta nel Passo 4: generare un file di diagnostica per l'agente Oracle Cloud per generare un file di diagnostica e contattare il Supporto Oracle. Questo passo non si applica agli allegati pseudo-virtualizzati.

Risorse

Collegamento del volume segnalato in modo errato come abilitato per più percorsi

In alcuni scenari, un collegamento di volume viene visualizzato come abilitato per il multipath nella console, tuttavia il collegamento non è effettivamente abilitato per il multipath e il volume non raggiunge le prestazioni previste per il livello Ultra High Performance. Questo problema può verificarsi quando si utilizzano contemporaneamente sia gli strumenti oci-utils che oci-iscsi-config per configurare un volume.

Utilizzare uno dei seguenti metodi per verificare se il problema si verifica.

Opzione 1: comando multipath di Linux
Utilizzare il comando multipath per confermare se un collegamento di volume è effettivamente abilitato per multipath su un'istanza Linux. Eseguire il login all'istanza ed eseguire il comando multipath con la tag ll come indicato di seguito.
# multipath -ll
Se l'output del comando non restituisce nulla, ciò conferma che l'istanza non dispone di collegamenti abilitati per multipath.
Opzione 2: selezionare node.startup
Controllare i record nodo in /var/lib/iscsi/nodes/{IQN} per node.startup, come indicato di seguito.
#cd /var/lib/iscsi/nodes/{IQN}
#grep -Hrn 'node.startup'
Se una di esse dispone di node.startup=automatic, il collegamento del volume non è abilitato per il multipath. Tutti devono mostrare node.startup=manual.

Risoluzione

Se si determina che l'allegato non è abilitato per il multipath, è possibile risolvere il problema utilizzando il file /etc/fstab. Aggiornare il file /etc/fstab per indicare al servizio systemd di attendere l'esecuzione del servizio multipathd prima di eseguire il MOUNT del file system. A tale scopo, aggiungere x-systemd.requires=multipathd.service per il volume. Ad esempio:
UUID={$AFFECTED_VOLUME_UUID} /test ext4 defaults,_netdev,nofail,x-systemd.requires=multipathd.service 0 2

Riavviare l'istanza dopo aver aggiornato il file /etc/fstab.

Per ulteriori informazioni sul file /etc/fstab, vedere Opzioni fstab tradizionali e Opzioni fstab per volumi a blocchi che utilizzano percorsi dispositivo coerenti.