Procedure comuni in modalità ONTAP

Questa pagina descrive le procedure comuni richieste per le attività in modalità ONTAP. Poiché molte attività del pool di archiviazione in modalità Flex Unified ONTAP utilizzano gli stessi prerequisiti di Google Cloud CLI e API, devi completare questa configurazione una sola volta prima di procedere con l'attività specifica.

Prima di iniziare

Completa i seguenti passaggi:

  1. Esegui esempi di comandi in un ambiente di tipo Unix: Linux, macOS o sottosistema Windows per Linux (WSL). La funzione shell ontap_execute e altri esempi di bash richiedono bash. Se la tua workstation non fornisce una shell di tipo Unix, utilizza Google Cloud Shell, che include bash e Google Cloud CLI.

  2. Installa Google Cloud CLI versione 559.0.0 o successive ed esegui l'autenticazione:

    gcloud auth login
    gcloud config set project PROJECT_ID
    
  3. Raccogli i seguenti valori per ogni pool che amministri:

    • POOL_NAME: il nome del pool di archiviazione.

    • LOCATION: la località del pool.

    • PROJECT_ID: l'ID progetto, che è facoltativo se lo hai impostato nella configurazione di Google Cloud CLI.

Configurare ontap_execute

Imposta POOL_NAME e LOCATION, quindi definisci una funzione shell per eseguire i comandi ONTAP tramite il proxy ONTAP CLI di Google Cloud CLI. La funzione convalida le variabili a ogni chiamata. PROJECT_ID utilizza il valore predefinito della configurazione di Google Cloud CLI.

Per definire la funzione ontap_execute:

 export POOL_NAME="mypool"
 export LOCATION="us-central1-a"

 ontap_execute() {
   : "${POOL_NAME:?Set POOL_NAME to your ONTAP-mode storage pool name}"
   : "${LOCATION:?Set LOCATION to the pool zone (for example us-central1-a) or region (for example us-central1)}"

   local project="${PROJECT_ID:-$(gcloud config get-value project 2>/dev/null)}"

   if [[ -z "${project}" ]]; then
     echo "Set PROJECT_ID or run: gcloud config set project PROJECT_ID" >&2
     return 1
   fi

   gcloud netapp storage-pools execute "${POOL_NAME}" "$1" \
     --project="${project}" \
     --location="${LOCATION}"
 }

Gli esempi seguenti utilizzano ontap_execute "ONTAP-COMMAND" per eseguire il comando ONTAP specificato sul pool identificato da POOL_NAME e LOCATION. Sostituisci i valori dei segnaposto, ad esempio SVM_NAME, prima di eseguire ogni comando.

Quando una procedura coinvolge più di un pool, modifica POOL_NAME e LOCATION prima di ogni chiamata ontap_execute.

Eseguire i comandi ONTAP CLI utilizzando il proxy

Il proxy ONTAP CLI fornisce l'accesso alla maggior parte dei comandi ONTAP per il pool di archiviazione. Il proxy non è interattivo, quindi i comandi che richiedono una passphrase, una password o un altro input non andranno a buon fine.

Utilizza ontap_execute per i comandi non interattivi di routine, come mostrato nella sezione Procedure.

Utilizzare il proxy API REST per i passaggi interattivi

Quando un comando ONTAP richiede un input interattivo, utilizza l' API proxy di Google per le chiamate API REST ONTAP invece. Questo documento include esempi di Python. Le richieste REST tramite il proxy utilizzano un envelope body intorno al payload dell'API ONTAP.

Cercare i nomi di cluster e SVM

Per cercare i nomi di cluster e SVM in un pool in modalità ONTAP:

 ontap_execute "cluster identity show"
 ontap_execute "vserver show"
 ontap_execute "network interface show -role intercluster"

Prendi nota del nome del cluster da cluster identity show e del nome della SVM di dati da vserver show. Gli IC-LIF per il traffico intercluster si trovano in IPspace Gcnv. La colonna Vserver per gli IC-LIF mostra Gcnv. I nomi degli IC-LIF sono intercluster-1, intercluster-2 e simili, con un nome per nodo.

Procedure

Le seguenti procedure includono comandi non interattivi di routine:

Passaggi successivi