NetApp Storage ONTAP-SAN per cluster IBM Cloud Satellite

Configurare lo storage NetApp ONTAP-SAN per i cluster IBM Cloud Satellite®. È possibile utilizzare i modelli di archiviazione Satellite per creare configurazioni di archiviazione. Quando si assegna una configurazione di memoria ai cluster, i driver di memorizzazione del provider di memoria selezionato vengono installati nel cluster.

Prima di poter creare configurazioni di archiviazione usando il modello NetApp NAS, è necessario distribuire il modello NetApp Trident, che installa l'operatore richiesto.

Prima di poter distribuire i modelli di storage ai cluster della propria sede, assicurarsi di aver configurato Satellite Config selezionando l'opzione Abilita l'accesso dell'amministratore del cluster per Satellite Config nella console o includendo l'opzione --enable-config-admin durante la creazione del cluster.

Non è possibile assegnare il servizio di archiviazione Satellite ai gruppi di risorse. Tuttavia, se si stanno assegnando altre risorse, come la posizione e il cluster, ai gruppi di risorse, è necessario aggiungere il ruolo di lettore di Satellite e di amministratore dei collegamenti per tutte le risorse dell'account.

Prerequisiti per l'archiviazione ONTAP - SAN NetApp

Prima di distribuire i driver NetApp ONTAP-SAN ai cluster Satellite, verificare i seguenti prerequisiti.

  1. Devi configurare il tuo cluster ONTAP di backend come backend Trident.

  2. È necessario disporre di una SVM (Storage Virtual Machine) dedicata per Trident. I volumi e i LUN creati da Trident vengono creati in questa SVM.

  3. È necessario disporre di uno o più aggregati assegnati a SVM. È possibile aggiungere aggregati eseguendo il comando netapp1::> vserver modify -vs <svm_name> -aggr-list <aggregate(s)_to_be_added>.

  4. È necessario disporre di uno o più dataLIFs per SVM.

  5. Devi avere i servizi iSCSI abilitati su SVM.

  6. È necessario impostare una politica di istantanea su SVM.

  7. Crea un'ubicazione Satellite.

  8. Crea un Satellite.

    • Assicurati di selezionare l'opzione Enable cluster admin access for Satellite Config quando crei il cluster. Se non abiliti l'accesso amministratore (admin) per la configurazione Satellite durante la creazione del tuo cluster, devi ricreare il tuo cluster e abilitare l'accesso amministratore prima di poter distribuire l'archiviazione.
    • Il cluster deve soddisfare i requisiti per ONTAP - SAN. Per ulteriori informazioni, consulta la documentazione diNetApp.
    • Gli host devono soddisfare i requisiti host Satellite in aggiunta ai requisiti per ONTAP - SAN.
  9. Aggiungi il tuo Satellite a un gruppo di cluster.

  10. Configura la configurazione Satellite sui tuoi cluster.

Creazione e assegnazione di una configurazione nella console

  1. Esaminare il riferimento del parametro.

  2. Dalla console Ubicazioni, selezionare l'ubicazione in cui si desidera creare una configurazione di memoria.

  3. Selezionare Memoria > Crea configurazione memoria

  4. Inserisci un nome per la tua configurazione.

  5. Selezionare il tipo di archiviazione.

  6. Selezionare Versione e fare clic su Avanti

  7. Se il Tipo di archiviazione selezionato accetta parametri personalizzati, immetterli nella scheda Parametri.

  8. Se il Tipo di archiviazione selezionato richiede segreti, immetterli nella scheda Segreti.

  9. Sulla scheda Classi di archiviazione, esaminare le classi di memoria distribuite dalla configurazione o creare una classe di memoria personalizzata.

  10. Nella scheda Assegna al servizio, selezionare il servizio a cui si desidera assegnare la configurazione.

  11. Fare clic su Completa per assegnare la configurazione di archiviazione.

Creazione di una configurazione nella CLI

  1. Esaminare il riferimento parametro per la versione del template che si desidera utilizzare.

  2. Accedi alla CLI IBM Cloud.

    ibmcloud login
    
  3. Elenca le tue ubicazioni Satellite e prendi nota della colonna Managed from.

    ibmcloud sat location ls
    
  4. Specifica la regione Managed from della tua ubicazione Satellite. Ad esempio, per wdc target us-east. Per ulteriori informazioni, vedi RegioniSatellite.

    ibmcloud target -r us-east
    
  5. Se si utilizza un gruppo di risorse diverso da default, destinarlo.

    ibmcloud target -g RESOURCE_GROUP
    
  6. Copiare uno dei seguenti comandi di esempio per la versione del modello che si desidera utilizzare. Per ulteriori informazioni sul comando, consultare ibmcloud sat storage config create nel riferimento al comando .

    Comando di esempio per creare una versione 24.02 di configurazione.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-san --template-version 24.02 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"
    

    Esempio di comando per creare una configurazione della versione 25.06.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-san --template-version 25.06 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"
    
  7. Personalizzare il comando in base alle impostazioni che si desidera utilizzare.

  8. Esegui il comando per creare una configurazione.

  9. Verificare che la configurazione sia stata creata.

    ibmcloud sat storage config get --config CONFIG
    

Creazione di una configurazione nell'API

  1. Generare una chiave API, quindi richiedere un token di aggiornamento. Per ulteriori informazioni, consultare la sezione " Generazione di un token IAM di IBM Cloud utilizzando una chiave API ".

  2. Esaminare il riferimento parametro per la versione del template che si desidera utilizzare.

  3. Copiare una delle seguenti richieste di esempio e sostituire le variabili che si desidera utilizzare.

    Richiesta di esempio per creare una configurazione della versione 24.02.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-ontap-san\", \"storage-template-version\": \"24.02\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
    

    Esempio di richiesta per la creazione di una configurazione della versione 25.06.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-ontap-san\", \"storage-template-version\": \"25.06\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
    

Creazione di un'attività nell'interfaccia a riga di comando (CLI)

  1. Elencare le configurazioni di archiviazione e prendere nota della configurazione di archiviazione che si desidera assegnare ai cluster.

    ibmcloud sat storage config ls
    
  2. Ottieni l'ID del cluster, del gruppo di cluster o del servizio a cui vuoi assegnare l'archiviazione.

    Per assicurarti che il tuo cluster sia registrato in Satellite Config o per creare gruppi, consulta Configurazione dei cluster da utilizzare con il file di configurazione di Satellite.

    Comando di esempio per elencare i gruppi di cluster.

    ibmcloud sat group ls
    

    Comando di esempio per elencare i cluster.

    ibmcloud oc cluster ls --provider satellite
    

    Comando di esempio per elencare i servizi Satellite.

    ibmcloud sat service ls --location LOCATION
    
  3. Assegna la tua configurazione di archiviazione al cluster, gruppo o servizio che hai richiamato in precedenza. Per ulteriori informazioni, consultare il comando ibmcloud sat storage assignment create .

    Comando di esempio per assegnare una configurazione a un gruppo di cluster.

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME
    

    Comando di esempio per assegnare una configurazione a un cluster.

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME
    

    Comando di esempio per assegnare una configurazione a un cluster di servizio.

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME
    
  4. Verifica che il tuo compito sia stato creato.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
    

Creazione di un'assegnazione di spazio di archiviazione nell'interfaccia di programmazione dell'applicazione (API)

  1. Copiare una delle seguenti richieste di esempio.

    Richiesta di esempio per assegnare una configurazione a un cluster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"
    

    Richiesta di esempio per assegnare la configurazione a un gruppo di cluster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"
    
  2. Sostituire le variabili con i propri dettagli ed eseguire la richiesta.

  3. Verificare che l'assegnazione sia stata creata elencando le assegnazioni.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Aggiornamento delle assegnazioni di memoria nella console

Puoi utilizzare la consoleSatellite per applicare gli ultimi aggiornamenti di patch alle tue assegnazioni.

  1. Dalla pagina Ubicazioni della consoleSatellite, seleziona la tua ubicazione.

  2. Fare clic sulla scheda Archiviazione per visualizzare le configurazioni.

  3. Fai clic sulla configurazione che desideri aggiornare.

  4. Fare clic sull'icona Informazioni (i) per applicare l'ultima revisione o patch.

  5. Facoltativo: abilita gli aggiornamenti patch automatici per l'assegnazione della tua archiviazione. L'abilitazione degli aggiornamenti automatici delle patch garantisce che l'assegnazione abbia sempre le correzioni di sicurezza più recenti.

Se si abilitano gli aggiornamenti patch automatici, è comunque necessario applicare manualmente gli aggiornamenti principali.

Aggiornamento manuale delle assegnazioni nella CLI

Aggiornare un'assegnazione per utilizzare l'ultima revisione del modello di memoria.

  1. Elenca le tue assegnazioni di memoria Satellite, prendi nota dell'assegnazione Satellite che vuoi aggiornare.

    ibmcloud sat storage assignment ls
    
  2. Elencare i modelli di memorizzazione Satellite per vedere le ultime versioni disponibili.

    ibmcloud sat storage template ls
    
  3. Aggiorna l'assegnazione Satellite.

    Comando di esempio per aggiornare un'assegnazione.

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
    

Abilitazione degli aggiornamenti patch automatici per le configurazioni e le assegnazioni nella CLI

Puoi utilizzare la CLI sat storage assignment autopatch enable per abilitare gli aggiornamenti patch automatici per le tue assegnazioni. L'abilitazione degli aggiornamenti automatici delle patch applica automaticamente le ultime revisioni del modello di memoria (patch). È comunque necessario applicare manualmente gli aggiornamenti principali.

  1. Elenca le configurazioni di archiviazione Satellite. Prendere nota dell'ID configurazione.

    ibmcloud sat storage assignment ls
    
  2. Eseguire uno dei seguenti comandi di esempio per abilitare gli aggiornamenti automatici delle patch per la configurazione e le assegnazioni associate. Inserisci l'ID di configurazione che hai recuperato nel passaggio precedente.

    Comando di esempio per abilitare gli aggiornamenti automatici delle correzioni per un'assegnazione.

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])
    

    Comando di esempio per abilitare gli aggiornamenti di patch automatici per tutte le assegnazioni di memoria in una determinata configurazione.

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all
    

    Comando di esempio per disabilitare gli aggiornamenti patch automatici per tutte le assegnazioni in una configurazione specifica.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all
    

    Comando di esempio per disabilitare gli aggiornamenti patch automatici per una singola assegnazione e una specifica configurazione.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID
    

    Comando di esempio per disattivare gli aggiornamenti automatici delle patch per un'assegnazione multipla e una specifica configurazione.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID
    

Aggiornamento di configurazione e assegnazioni nell'API

È possibile utilizzare l'API /v2/storage/satellite/updateAssignment per aggiornare le assegnazioni con nuovi cluster o gruppi di cluster. Impostare updateConfigVersion su true per applicare l'aggiornamento della revisione.

  1. Copiare la seguente richiesta di esempio e sostituire le variabili per i gruppi di cluster e le assegnazioni che si desidera aggiornare.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"
    
  2. Eseguire la richiesta.

  3. Ottenere i dettagli dell'assegnazione per verificare l'aggiornamento.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Abilitazione degli aggiornamenti patch automatici per le assegnazioni nell'API

È possibile utilizzare l'API /v2/storage/satellite/setAssignmentAutoupgrade per abilitare gli aggiornamenti patch automatici per le proprie assegnazioni. L'abilitazione degli aggiornamenti automatici delle patch applica automaticamente le ultime revisioni del modello di memoria (patch). È comunque necessario applicare manualmente gli aggiornamenti principali.

  1. Copiare la seguente richiesta di esempio e sostituire le variabili per i gruppi di cluster e le assegnazioni che si desidera aggiornare.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }
    
  2. Eseguire la richiesta.

  3. Ottieni i dettagli dell'assegnazione per verificare l'aggiornamento.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Riferimento parametro

Riferimento parametro 24.02

Tabella 1. Riferimento dei parametri di 24.02
Nome di visualizzazione opzione CLI Immettere Descrizione Valore predefinito
LIF di gestione managementLIF Config L'indirizzo IP della LIF di gestione. N/D
LIF dati dataLIF Config L'indirizzo IP della LIF di dati. N/D
SVM svm Config Il nome della SVM. N/D
Nome utente username Secret Il nome utente per connettersi al dispositivo di archiviazione. N/D
Password utente password Secret La password per connettersi al dispositivo di archiviazione. N/D
Limita dimensione volume limitVolumeSize Config La dimensione massima del volume (in Gibibyte) che può essere richiesta e la dimensione del volume principale qtree. 50Gi
Limita AggregateUsage limitAggregateUsage Config Il provisioning non riesce se l'utilizzo è maggiore di questa percentuale. 80%

25.06 riferimento ai parametri

Tabella 2. Riferimento del parametro 25.06
Nome di visualizzazione opzione CLI Immettere Descrizione Valore predefinito
LIF di gestione managementLIF Config L'indirizzo IP della LIF di gestione. N/D
LIF dati dataLIF Config L'indirizzo IP della LIF di dati. N/D
SVM svm Config Il nome della SVM. N/D
Nome utente username Secret Il nome utente per connettersi al dispositivo di archiviazione. N/D
Password utente password Secret La password per connettersi al dispositivo di archiviazione. N/D
Limita dimensione volume limitVolumeSize Config La dimensione massima del volume (in Gibibyte) che può essere richiesta e la dimensione del volume principale qtree. 50Gi
Limita AggregateUsage limitAggregateUsage Config Il provisioning non riesce se l'utilizzo è maggiore di questa percentuale. 80%

Riferimento classe di archiviazione per NetApp ONTAP - SAN

Prima di distribuire le app che utilizzano le classi di archiviazione di sat-netapp, esamina le seguenti note.

Per impostazione predefinita, la classe di archiviazione sat-netapp-file-gold non prevede limiti QoS (IOPS illimitati).

Per utilizzare le classi di archiviazione sat-netapp-file-silver e sat-netapp-file-bronze, è necessario creare i corrispondenti gruppi di criteri silver e bronze QoS sul controller di archiviazione e definire i limiti QoS. Per creare un gruppo di politiche sul sistema di archiviazione, accedere alla CLI di sistema ed eseguire il comando netapp1::> qos policy-group create -policy-group <policy_group_name> -vserver <svm_name> [-min-throughput <min_IOPS>] -max-throughput <max_IOPS>.

Le opzioni min - throughput sono supportate solo su sistemi all - flash. Per ulteriori informazioni sulla creazione e la gestione dei gruppi di criteri di QoS, consultare il sito Documentazione sulla gestione dello storage di ONTAP 9.

Per utilizzare una classe di archiviazione crittografata, è necessario abilitare NetApp Volume Encryption (NVE) sul sistema di archiviazione utilizzando il key manager integrato in NetApp ONTAP o un key manager di terze parti supportato (off-box), come il key manager TKLM di IBM. Per abilitare il gestore chiavi integrato, eseguire il comando netapp1::> security key-manager onboard enable. Per ulteriori informazioni sulla configurazione della crittografia, consulta la documentazione ONTAP 9 Security and Data Encryption.

Esamina le classi di storage Satellite per NetApp ONTAP - SAN. È possibile descrivere le classi di memoria nella riga comandi con il comando oc describe sc <storage-class-name>.

netapp - ontap - san version 21.04 riferimento parametro
Nome classe di archiviazione Immettere File system IOPS Crittografia Politica di riacquisizione
sat-netapp-block-gold Valore predefinito ONTAP - SAN ext4 nessun limite QoS. Codifica disabilitata. Elimina
sat-netapp-block-gold-encrypted ONTAP - SAN ext4 nessun limite QoS. Codifica abilitata. Elimina
sat-netapp-block-silver ONTAP - SAN ext4 Limite QoS definito dall'utente. Codifica disabilitata. Elimina
sat-netapp-block-silver-encrypted ONTAP - SAN ext4 Limite QoS definito dall'utente. Codifica abilitata. Elimina
sat-netapp-block-bronze ONTAP - SAN ext4 Limite QoS definito dall'utente. Codifica disabilitata. Elimina
sat-netapp-block-bronze-encrypted ONTAP - SAN ext4 Limite QoS definito dall'utente. Codifica abilitata. Elimina

Come ottenere aiuto e supporto per NetApp ONTAP - SAN

Se riscontri un problema con NetApp Trident, puoi visitare la pagina di supportoNetApp.