Questa pagina è stata tradotta dall'API Cloud Translation.

Terraform: guida al deployment del sistema SAP HANA scale out con failover automatico dell'host

Questa guida mostra come utilizzare Terraform per eseguire il deployment di un sistema di scale out SAP HANA che include la soluzione di ripristino da errori automatici di failover dell'host SAP HANA. Con Terraform, puoi eseguire il deployment di un sistema che soddisfa i requisiti di supporto SAP e che aderisce alle best practice SAP e Compute Engine.

Il sistema SAP HANA risultante include un host master, fino a 15 host worker e fino a 3 host in standby, il tutto all'interno di una singola zona di Compute Engine.

Il sistema include anche il Gestione archiviazione Google Cloud per i nodi in standby SAP HANA (Gestione archiviazione per SAP HANA), che gestisce il trasferimento dei dispositivi di archiviazione al nodo in standby durante un failover. Storage Manager per SAP HANA è installato nel volume SAP HANA /shared.

Per saperne di più da SAP sulla soluzione di failover automatico dell'host, consulta Failover automatico dell'host

Non utilizzare questa guida se non hai bisogno della funzione di failover automatico dell'host. Utilizza invece la guida al deployment Terraform: SAP HANA.

Se devi eseguire il deployment di SAP HANA in un cluster Linux ad alta disponibilità, utilizza una delle seguenti guide:

Questa guida è rivolta agli utenti avanzati di SAP HANA che hanno familiarità con le configurazioni di scale out SAP che includono host in standby per l'alta disponibilità e file system di rete.

Prerequisiti

Prima di creare il sistema di scale out a disponibilità elevata SAP HANA, assicurati che siano soddisfatti i seguenti prerequisiti:

Hai letto la guida alla pianificazione di SAP HANA e la guida alla pianificazione dell'alta disponibilità di SAP HANA.
Tu o la tua organizzazione disponete di un account Google Cloud e avete creato un progetto per il deployment di SAP HANA. Per informazioni sulla creazione di account e progetti Google Cloud, consulta Configurare l'Account Google nella Guida al deployment di SAP HANA.
Se richiedi l'esecuzione del carico di lavoro SAP in conformità con i requisiti di residenza dei dati, controllo dell'accesso, personale di assistenza o normativi, devi creare la cartella Assured Workloads richiesta. Per ulteriori informazioni, consulta la pagina Conformità e controlli di sovranità per SAP su Google Cloud.
Il supporto di installazione SAP HANA è archiviato in un bucket Cloud Storage disponibile nel progetto di deployment e nella regione. Per informazioni su come caricare contenuti multimediali di installazione SAP HANA in un bucket Cloud Storage, consulta Creazione di un bucket Cloud Storage nella guida al deployment di SAP HANA.
Hai una soluzione NFS, come la soluzione gestita Filestore, per condividere i volumi SAP HANA /hana/shared e /hanabackup tra gli host nel sistema SAP HANA con scale out. Devi specificare i punti di montaggio per i server NFS nel file di configurazione Terraform prima di poter eseguire il deployment del sistema. Per eseguire il deployment dei server NFS Filestore, consulta Creazione di istanze.
La comunicazione deve essere consentita tra tutte le VM nella subnet SAP HANA che ospitano un nodo di scale out SAP HANA.
Se OS Login è abilitato nei metadati di progetto, devi disattivarlo temporaneamente fino al completamento del deployment. Ai fini del deployment, questa procedura configura le chiavi SSH nei metadati dell'istanza. Quando l'accesso al sistema operativo è abilitato, le configurazioni delle chiavi SSH basate su metadati vengono disabilitate e questo deployment non riesce. Al termine del deployment, puoi abilitare di nuovo OS Login.

Per ulteriori informazioni, consulta:
- Attivare o disattivare OS Login
- Aggiungere chiavi SSH alle VM che utilizzano chiavi SSH basate su metadati

Creare una rete

Per motivi di sicurezza, crea una nuova rete. Puoi controllare chi ha accesso aggiungendo regole firewall o utilizzando un altro metodo di controllo dell'accesso.

Se il progetto ha una rete VPC predefinita, non utilizzarla. Crea invece la tua rete VPC in modo che le uniche regole firewall in vigore siano quelle create in modo esplicito.

Durante il deployment, le istanze VM in genere richiedono l'accesso a internet per scaricare l'agente di Google Cloud per SAP. Se utilizzi una delle immagini Linux certificate SAP disponibili su Google Cloud, l'istanza VM richiede anche l'accesso a internet per registrare la licenza e accedere ai repository dei fornitori di sistemi operativi. Questo accesso è supportato da una configurazione con un gateway NAT e tag di rete VM, anche se le VM di destinazione non hanno IP esterni.

Per creare una rete VPC per il tuo progetto, completa i seguenti passaggi:

Creare una rete in modalità personalizzata. Per saperne di più, consulta la sezione Creazione di una rete in modalità personalizzata.
Crea una subnet e specifica la regione e l'intervallo IP. Per ulteriori informazioni, consulta Aggiungere subnet.

Configurazione di un gateway NAT

Se devi creare una o più VM senza indirizzi IP pubblici, devi utilizzare Network Address Translation (NAT) per consentire alle VM di accedere a internet. Utilizza Cloud NAT, un servizio gestito distribuito e software-defined di Google Cloud, che consente alle VM di inviare pacchetti in uscita a internet e ricevere tutti i pacchetti di risposta in entrata stabiliti corrispondenti. In alternativa, puoi configurare una VM separata come gateway NAT.

Per creare un'istanza Cloud NAT per il tuo progetto, consulta Utilizzo di Cloud NAT.

Dopo aver configurato Cloud NAT per il tuo progetto, le istanze VM possono accedere in modo sicuro a internet senza un indirizzo IP pubblico.

aggiungi regole firewall

Per impostazione predefinita, una regola firewall implicita blocca le connessioni in entrata dall'esterno della rete Virtual Private Cloud (VPC). Per consentire le connessioni in entrata, configura una regola firewall per la VM. Dopo aver stabilito una connessione in entrata con una VM, il traffico viene consentito in entrambe le direzioni su questa connessione.

Puoi anche creare una regola firewall per consentire l'accesso esterno a porte specifiche o per limitare l'accesso tra le VM sulla stessa rete. Se viene utilizzato il tipo di rete VPC default, vengono applicate anche alcune regole predefinite aggiuntive, ad esempio la regola default-allow-internal, che consente la connettività tra VM sulla stessa rete su tutte le porte.

A seconda del criterio IT applicabile al tuo ambiente, potresti dover isolare o limitare la connettività all'host del database creando regole firewall.

A seconda del tuo scenario, puoi creare regole firewall per consentire l'accesso a:

Le porte SAP predefinite elencate in TCP/IP di tutti i prodotti SAP.
Connessioni dal computer o dall'ambiente di rete aziendale alla tua istanza VM di Compute Engine. Se hai dubbi in merito all'indirizzo IP da utilizzare, rivolgiti all'amministratore di rete della tua azienda.
Comunicazione tra VM nella subnet SAP HANA, inclusa la comunicazione tra i nodi in un sistema SAP HANA con scale out o la comunicazione tra il server di database e i server delle applicazioni in un'architettura a 3 livelli. Puoi abilitare la comunicazione tra le VM creando una regola firewall per consentire il traffico che ha origine all'interno della subnet.

Per creare le regole firewall per il tuo progetto, consulta Creazione di regole firewall.

Creazione di un sistema di scale out SAP HANA con host in standby

Segui queste istruzioni per completare le seguenti azioni:

Crea il sistema SAP HANA richiamando Terraform con un file di configurazione completato.
Verifica il deployment.
Testa gli host in standby simulando un errore dell'host.

Alcuni dei passaggi nelle seguenti istruzioni utilizzano Cloud Shell per inserire i comandi gcloud. Se hai installato la versione più recente di Google Cloud SDK, puoi inserire i comandi gcloud da un terminale locale.

Definire e creare il sistema SAP HANA

Nei passaggi seguenti devi scaricare e completare un file di configurazione Terraform, utilizzare i comandi Terraform standard per inizializzare la directory di lavoro attuale e scaricare il plug-in del provider Terraform e i file dei moduli per Google Cloud e applicare la configurazione, che esegue il deployment di VM, dischi permanenti e istanze SAP HANA.

Verifica che le quote attuali per le risorse di progetto, come dischi permanenti e CPU, siano sufficienti per il sistema SAP HANA che stai per installare. Se le quote sono insufficienti, il deployment non va a buon fine. Per i requisiti delle quote SAP HANA, consulta Considerazioni su prezzi e quote per SAP HANA.

Vai alla pagina delle quote
Apri Cloud Shell.

Vai a Cloud Shell
Scarica il file di configurazione sap_hana_scaleout.tf per il sistema di scale out ad alta disponibilità SAP HANA nella tua directory di lavoro:
```
wget https://storage.googleapis.com/cloudsapdeploy/terraform/latest/terraform/sap_hana_scaleout/terraform/sap_hana_scaleout.tf
```
Nota: assicurati di avere un solo file di configurazione Terraform nella directory di lavoro.
Apri il file sap_hana_scaleout.tf nell'editor di codice di Cloud Shell.

Per aprire l'editor di codice di Cloud Shell, fai clic sull'icona a forma di matita nell'angolo in alto a destra della finestra del terminale Cloud Shell.

Nel file sap_hana_scaleout.tf, aggiorna i seguenti valori di argomento sostituendo i contenuti tra virgolette doppie con i valori dell'installazione. Ad esempio, potresti sostituire "ZONE" con "us-central1-f".

Argomento	Tipo di dati	Descrizione
`source`	String	Specifica la località e la versione del modulo Terraform da utilizzare durante il deployment. Il file di configurazione `sap_hana_scaleout.tf` include due istanze dell'argomento `source`: una attiva e l'altra inclusa come commento. L'argomento `source` attivo per impostazione predefinita specifica `latest` come versione del modulo. La seconda istanza dell'argomento `source`, che per impostazione predefinita è disattivato da un carattere `#` iniziale, specifica un timestamp che identifica la versione di un modulo. Se vuoi che tutti i tuoi deployment utilizzino la stessa versione del modulo, rimuovi il carattere `#` iniziale dall'argomento `source` che specifica il timestamp della versione e aggiungilo all'argomento `source` che specifica `latest`.
`project_id`	String	Specifica l'ID del progetto Google Cloud in cui esegui il deployment di questo sistema. Ad esempio, `my-project-x`.
`zone`	String	Specifica la zona in cui esegui il deployment del sistema SAP. La zona deve trovarsi nella stessa regione selezionata per la subnet. Ad esempio, se il deployment della subnet è stato eseguito nella regione `us-central1`, puoi specificare una zona come `us-central1-a`.
`machine_type`	String	Specifica il tipo di macchina virtuale (VM) Compute Engine su cui hai bisogno di eseguire il tuo sistema SAP. Se hai bisogno di un tipo di VM personalizzata, specifica un tipo di VM predefinito con un numero di vCPU più vicino a quello necessario ma comunque più grande. Al termine del deployment, modifica il numero di vCPU e la quantità di memoria. Ad esempio, `n1-highmem-32`.
`subnetwork`	String	Specifica il nome della subnet creata in un passaggio precedente. Se esegui il deployment in un VPC condiviso, specifica questo valore come `SHARED_VPC_PROJECT_ID/SUBNETWORK`. Ad esempio, `myproject/network1`.
`linux_image`	String	Specifica il nome dell'immagine del sistema operativo Linux su cui vuoi eseguire il deployment del sistema SAP. Ad esempio, `rhel-9-2-sap-ha` o `sles-15-sp5-sap`. Per l'elenco delle immagini del sistema operativo disponibili, consulta la pagina Immagini nella console Google Cloud.
`linux_image_project`	String	Specifica il progetto Google Cloud che contiene l'immagine che hai specificato per l'argomento `linux_image`. Potrebbe essere un tuo progetto o un progetto immagine Google Cloud. Per un'immagine Compute Engine, specifica `rhel-sap-cloud` o `suse-sap-cloud`. Per trovare il progetto immagine per il tuo sistema operativo, consulta Dettagli del sistema operativo.
`instance_name`	String	Specifica un nome per l'istanza VM host. Il nome può contenere lettere minuscole, numeri e trattini. Le istanze VM per gli host worker e in standby utilizzano lo stesso nome con `w` e il numero dell'host aggiunto al nome.
`sap_hana_shared_nfs`	String	Specifica il punto di montaggio NFS per il volume `/hana/shared`. Ad esempio, `10.151.91.122:/hana_shared_nfs`. Nota: il punto di montaggio NFS per il volume `/hana/shared` deve essere vuoto prima di applicare la configurazione Terraform.
`sap_hana_backup_nfs`	String	Specifica il punto di montaggio NFS per il volume `/hanabackup`. Ad esempio, `10.216.41.122:/hana_backup_nfs`.
`sap_hana_deployment_bucket`	String	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica il percorso del bucket Cloud Storage che contiene i file di installazione di SAP HANA. Non includere `gs://` nel percorso; includi solo il nome del bucket e i nomi delle eventuali cartelle. Ad esempio, `my-bucket-name/my-folder`. Il bucket Cloud Storage deve esistere nel progetto Google Cloud specificato per l'argomento `project_id`.
`sap_hana_sid`	String	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica l'ID sistema SAP HANA. L'ID deve essere composto da tre caratteri alfanumerici e deve iniziare con una lettera. Tutte le lettere devono essere in maiuscolo. Ad esempio, `ED1`.
`sap_hana_instance_number`	Integer	Facoltativo. Specifica il numero di istanza, da 0 a 99, del sistema SAP HANA. Il valore predefinito è `0`.
`sap_hana_sidadm_password`	String	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica una password `SIDadm` temporanea per gli script di installazione da utilizzare durante il deployment. La password deve contenere almeno 8 caratteri e includere almeno una lettera maiuscola, una lettera minuscola e un numero. Importante: al termine dell'installazione, assicurati di cambiare la password. Invece di specificare la password come testo normale, ti consigliamo di utilizzare un secret. Per maggiori informazioni, consulta la sezione Gestione delle password.
`sap_hana_sidadm_password_secret`	String	Facoltativo. Se utilizzi Secret Manager per archiviare la password `SIDadm`, specifica il nome del secret corrispondente alla password. In Secret Manager, assicurati che il valore del secret, ovvero la password, contenga almeno 8 caratteri e che includa almeno una lettera maiuscola, una lettera minuscola e un numero. Importante: il secret deve esistere nel progetto Google Cloud specificato per l'argomento `project_id`. Per maggiori informazioni, consulta la sezione Gestione delle password.
`sap_hana_system_password`	String	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica una password temporanea del super user del database per gli script di installazione da utilizzare durante il deployment. La password deve contenere almeno 8 caratteri e includere almeno una lettera maiuscola, una lettera minuscola e un numero. Importante: al termine dell'installazione, assicurati di cambiare la password. Invece di specificare la password come testo normale, ti consigliamo di utilizzare un secret. Per maggiori informazioni, consulta la sezione Gestione delle password.
`sap_hana_system_password_secret`	String	Facoltativo. Se utilizzi Secret Manager per archiviare la password del super user del database, specifica il nome del secret corrispondente a questa password. In Secret Manager, assicurati che il valore del secret, ovvero la password, contenga almeno 8 caratteri e che includa almeno una lettera maiuscola, una lettera minuscola e un numero. Importante: il secret deve esistere nel progetto Google Cloud specificato per l'argomento `project_id`. Per maggiori informazioni, consulta la sezione Gestione delle password.
`sap_hana_double_volume_size`	Booleano	Facoltativo. Per raddoppiare la dimensione del volume HANA, specifica `true`. Questo argomento è utile quando vuoi eseguire il deployment di più istanze SAP HANA o di un'istanza SAP HANA di ripristino di emergenza sulla stessa VM. Per impostazione predefinita, la dimensione del volume viene calcolata automaticamente come la dimensione minima richiesta per la dimensione della VM, pur continuando a soddisfare i requisiti di certificazione e assistenza SAP. Il valore predefinito è `false`.
`sap_hana_sidadm_uid`	Integer	Facoltativo. Specifica un valore per eseguire l'override del valore predefinito dell'`SID_LC`ID utente adm. Il valore predefinito è `900`. Puoi modificarlo in un valore diverso per coerenza all'interno del tuo panorama SAP.
`sap_hana_sapsys_gid`	Integer	Facoltativo. Esegue l'override dell'ID gruppo predefinito per `sapsys`. Il valore predefinito è `79`.
`sap_hana_worker_nodes`	Integer	Specifica il numero di host worker SAP HANA aggiuntivi di cui hai bisogno. Puoi specificare da 1 a 15 host worker. Non utilizzare le virgolette con il valore. Il valore predefinito è 1.
`sap_hana_standby_nodes`	Integer	Specifica il numero di host in standby SAP HANA aggiuntivi di cui hai bisogno. Puoi specificare da 1 a 3 host in standby. Non utilizzare le virgolette con il valore. Il valore predefinito è 1.
`network_tags`	String	Facoltativo. Specifica uno o più tag di rete separati da virgole da associare alle tue istanze VM a scopo di firewall o routing. Se specifichi `public_ip = false` e non specifichi un tag di rete, assicurati di fornire un altro mezzo di accesso a internet.
`nic_type`	String	Facoltativo. Specifica l'interfaccia di rete da utilizzare con l'istanza VM. Puoi specificare il valore `GVNIC` o `VIRTIO_NET`. Per utilizzare un NIC virtuale di Google (gVNIC), devi specificare un'immagine del sistema operativo che supporti gVNIC come valore per l'argomento `linux_image`. Per l'elenco delle immagini del sistema operativo, vedi Dettagli del sistema operativo. Se non specifichi un valore per questo argomento, l'interfaccia di rete viene selezionata automaticamente in base al tipo di macchina specificato per l'argomento `machine_type`. Questo argomento è disponibile nella versione del modulo `sap_hana` `202302060649` o successiva.
`disk_type`	String	Facoltativo. Specifica il tipo predefinito di volume Persistent Disk o Hyperdisk di cui vuoi eseguire il deployment per i volumi di dati e log SAP nel deployment. Per informazioni sul deployment predefinito del disco eseguito dalle configurazioni Terraform fornite da Google Cloud, consulta Deployment di dischi tramite Terraform. Di seguito sono riportati i valori validi per questo argomento: `pd-ssd`, `pd-balanced`, `hyperdisk-extreme`, `hyperdisk-balanced` e `pd-extreme`. Puoi eseguire l'override di questo tipo di disco predefinito, delle dimensioni del disco predefinite e delle IOPS predefinite associate utilizzando alcuni argomenti avanzati. Per maggiori informazioni, vai alla directory di lavoro, quindi esegui il comando `terraform init` e poi visualizza il file `/.terraform/modules/sap_hana_scaleout/variables.tf`. Prima di utilizzare questi argomenti in produzione, assicurati di testarli in un ambiente non di produzione.
`use_single_shared_data_log_disk`	Booleano	Facoltativo. Il valore predefinito è `false` e indica a Terraform di eseguire il deployment di un disco permanente o di un Hyperdisk separato per ciascuno dei seguenti volumi SAP: `/hana/data`, `/hana/log`, `/hana/shared` e `/usr/sap`. Per montare questi volumi SAP sullo stesso disco permanente o Hyperdisk, specifica `true`.
`public_ip`	Booleano	Facoltativo. Determina se un indirizzo IP pubblico viene aggiunto o meno alla tua istanza VM. Il valore predefinito è `true`. Attenzione:non specificare `false`, a meno che tu non abbia un gateway NAT configurato con un tag di rete definito per la VM o che tu non abbia fornito alla VM un'altra route verso internet. Se non esiste una route a internet, l'installazione non va a buon fine.
`service_account`	String	Facoltativo. Specifica l'indirizzo email di un account di servizio gestito dall'utente che deve essere utilizzato dalle VM host e dai programmi eseguiti sulle VM host. Ad esempio, `svc-acct-name@project-id.iam.gserviceaccount.com`. Se specifichi questo argomento senza un valore o lo ometti, lo script di installazione utilizza l'account di servizio predefinito di Compute Engine. Per ulteriori informazioni, consulta la pagina relativa alla gestione di identità e accessi per programmi SAP su Google Cloud.
`sap_deployment_debug`	Booleano	Facoltativo. Solo quando l'assistenza clienti Google Cloud ti chiede di attivare il debug per il deployment, specifica `true`, in modo che il deployment generi log di deployment dettagliati. Il valore predefinito è `false`.
`reservation_name`	String	Facoltativo. Per utilizzare una prenotazione VM di Compute Engine specifica per questo deployment, specifica il nome della prenotazione. Per impostazione predefinita, lo script di installazione seleziona qualsiasi prenotazione di Compute Engine disponibile in base alle seguenti condizioni. Affinché una prenotazione sia utilizzabile, indipendentemente dal fatto che tu specifichi un nome o che lo script di installazione la selezioni automaticamente, la prenotazione deve essere impostata con quanto segue: L'opzione `specificReservationRequired` è impostata su `true` oppure, nella console Google Cloud, è selezionata l'opzione Seleziona prenotazione specifica. Alcuni tipi di macchine di Compute Engine supportano le piattaforme CPU non coperte dalla certificazione SAP del tipo di macchina. Se la prenotazione di destinazione riguarda uno dei seguenti tipi di macchine, deve specificare le piattaforme CPU minime come indicato: `n1-highmem-32`: Intel Broadwell `n1-highmem-64`: Intel Broadwell `n1-highmem-96`: Intel Skylake `m1-megamem-96`: Intel Skylake Le piattaforme CPU minime per tutti gli altri tipi di macchine certificate da SAP per l'utilizzo su Google Cloud sono conformi al requisito minimo di CPU per SAP.
`vm_static_ip`	String	Facoltativo. Specifica un indirizzo IP statico valido per l'istanza VM. Se non ne specifichi uno, viene generato automaticamente un indirizzo IP per l'istanza VM. Questo argomento è disponibile nella `sap_hana_scaleout` versione del modulo `202306120959` o successive.
`worker_static_ips`	Elenco(stringa)	Facoltativo. Specifica un array di indirizzi IP statici validi per le istanze worker nel sistema di scale out. Se non specifichi un valore per questo argomento, viene generato automaticamente un indirizzo IP per ogni istanza VM worker. Ad esempio, `[ "1.0.0.1", "2.3.3.4" ]`. Gli indirizzi IP statici vengono assegnati nell'ordine di creazione dell'istanza. Ad esempio, se scegli di eseguire il deployment di tre istanze worker, ma specifichi solo due indirizzi IP per l'argomento `worker_static_ips`, questi indirizzi IP vengono assegnati alle prime due istanze VM di cui la configurazione Terraform esegue il deployment. Per la terza istanza VM worker, l'indirizzo IP viene generato automaticamente. Questo argomento è disponibile nella `sap_hana_scaleout` versione del modulo `202306120959` o successive.
`standby_static_ips`	Elenco(stringa)	Facoltativo. Specifica un array di indirizzi IP statici validi per le istanze in standby nel sistema a scalabilità orizzontale. Se non specifichi un valore per questo argomento, viene generato automaticamente un indirizzo IP per ogni istanza VM in standby. Ad esempio, `[ "1.0.0.1", "2.3.3.4" ]`. Gli indirizzi IP statici vengono assegnati nell'ordine di creazione dell'istanza. Ad esempio, se scegli di eseguire il deployment di 3 istanze in standby, ma specifichi solo due indirizzi IP per l'argomento `standby_static_ips`, questi indirizzi IP vengono assegnati alle prime due istanze VM di cui la configurazione Terraform esegue il deployment. Per la terza istanza VM in standby, l'indirizzo IP viene generato automaticamente. Questo argomento è disponibile in `sap_hana_scaleout` versione del modulo `202306120959` o successive.

L'esempio seguente mostra un file di configurazione completato che esegue il deployment di un sistema di scale out SAP HANA con tre host worker e un host in standby nella zona us-central1-f. Ogni host è installato su una VM n2-highmem-32 che esegue un sistema operativo Linux fornito da un'immagine pubblica di Compute Engine. I volumi NFS sono forniti da Filestore. Le password temporanee vengono utilizzate solo durante l'elaborazione del deployment e della configurazione.

Per chiarezza, i commenti nel file di configurazione sono omessi nell'esempio.

# ...
module "hana_scaleout" {
source = "https://storage.googleapis.com/cloudsapdeploy/terraform/latest/terraform/sap_hana_scaleout/sap_hana_scaleout_module.zip"
#
# By default, this source file uses the latest release of the terraform module
# for SAP on Google Cloud. To fix your deployments to a specific release
# of the module, comment out the source property above and uncomment the source property below.
#
# source = "https://storage.googleapis.com/cloudsapdeploy/terraform/YYYYMMDDHHMM/terraform/sap_hana_scaleout/sap_hana_scaleout_module.zip"
#
# ...
#
project_id = "example-project-123456"
zone = "us-central1-f"
machine_type = "n2-highmem-32"
subnetwork = "example-sub-network-sap"
linux_image = "sles-15-sp4-sap"
linux_image_project = "suse-sap-cloud"

instance_name = "hana-scaleout-w-failover"
sap_hana_shared_nfs = "10.74.146.58:/hana_shr"
sap_hana_backup_nfs = "10.188.249.170:/hana_bup"
# ...
sap_hana_deployment_bucket = "hana2-sp5-rev53"
sap_hana_sid = "HF0"
sap_hana_instance_number = 00
sap_hana_sidadm_password = "TempPa55word"
sap_hana_system_password = "TempPa55word"
# ...
sap_hana_worker_nodes = 3
sap_hana_standby_nodes = 1
vm_static_ip = "10.0.0.1"
worker_static_ips = ["10.0.0.2", "10.0.0.3", "10.0.0.4"]
standby_static_ips = ["10.0.0.5"]
# ...
}

Inizializza la directory di lavoro attuale e scarica il plug-in del provider Terraform e i file dei moduli per Google Cloud:
```
terraform init
```
Il comando terraform init prepara la directory di lavoro per altri comandi Terraform.

Per forzare l'aggiornamento del plug-in del provider e dei file di configurazione nella directory di lavoro, specifica il flag --upgrade. Se il flag --upgrade viene omesso e non apporti modifiche alla directory di lavoro, Terraform utilizza le copie memorizzate nella cache locale, anche se nell'URL source è specificato latest.
Facoltativamente, crea il piano di esecuzione Terraform:
```
terraform plan
```
Il comando terraform plan mostra le modifiche richieste dalla configurazione corrente. Se salti questo passaggio, il comando terraform apply crea automaticamente un nuovo piano e ti chiede di approvarlo.
Applica il piano di esecuzione:
```
terraform apply
```
Quando ti viene chiesto di approvare le azioni, inserisci yes.

Il comando terraform apply configura l'infrastruttura di Google Cloud. All'avvio della macchina Compute Engine, l'infrastruttura Google Cloud richiama gli script di avvio che configurano il sistema operativo e installano SAP HANA.

Mentre Terraform controlla, i messaggi di stato vengono scritti in Cloud Shell. Dopo aver richiamato gli script, i messaggi di stato vengono scritti in Logging e sono visibili nella console Google Cloud, come descritto in Controllare i log di Logging.

Il tempo per il completamento può variare, ma l'intero processo di solito richiede da 45 minuti a 1 ora.

Verifica del deployment in corso...

Per verificare il deployment, controlla i log di deployment in Cloud Logging, controlla i dischi e i servizi sulle VM degli host principali e worker, visualizza il sistema in SAP HANA Studio e testa il takeover da un host in standby.

Controlla i log

Nella console Google Cloud, apri Cloud Logging per monitorare l'avanzamento dell'installazione e verificare la presenza di errori.

Nota: il completamento di questo passaggio in Cloud Logging potrebbe comportare dei costi. Per ulteriori informazioni, consulta i prezzi di Cloud Logging.

Vai a Cloud Logging
Filtra i log:
Esplora log
1. Nella pagina Esplora log, vai al riquadro Query.
2. Nel menu a discesa Risorsa, seleziona Globale, quindi fai clic su Aggiungi.
  
  Se non vedi l'opzione Globale, inserisci la query seguente nell'editor di query:
```
resource.type="global"
"Deployment"
```
3. Fai clic su Esegui query.
Visualizzatore log legacy
- Nella pagina Visualizzatore log legacy, dal menu del selettore di base, seleziona Globale come risorsa di logging.
Analizza i log filtrati:
- Se viene visualizzato "--- Finished", l'elaborazione del deployment è completa e puoi passare al passaggio successivo.
- Se visualizzi un errore di quota:
  1. Nella pagina Quote di IAM e amministrazione, aumenta le quote che non soddisfano i requisiti SAP HANA elencati nella guida alla pianificazione di SAP HANA.
  2. Apri Cloud Shell.
    
    Vai a Cloud Shell
  3. Vai alla directory di lavoro ed elimina il deployment per pulire le VM e i dischi permanenti dall'installazione non riuscita:
```
terraform destroy
```
    Quando ti viene chiesto di approvare l'azione, inserisci yes.
  4. Esegui di nuovo il deployment.

Connettiti alle VM per controllare i dischi e i servizi SAP HANA

Al termine del deployment, verifica che il deployment dei dischi e dei servizi SAP HANA sia stato eseguito correttamente controllando i dischi e i servizi dell'host master e di un host worker.

Nella pagina delle istanze VM di Compute Engine, connettiti alla VM dell'host master e alla VM di un host worker facendo clic sul pulsante SSH sulla riga di ciascuna delle due istanze VM.

Vai a Istanze VM

Quando ti connetti all'host worker, assicurati di non connetterti a un host in standby. Gli host in standby utilizzano la stessa convenzione di denominazione degli host dei worker, ma hanno il suffisso worker-host con il numero più alto prima del primo takeover. Ad esempio, se hai tre host worker e un host in standby, prima del primo takeover l'host in standby ha il suffisso "w4".
In ogni finestra del terminale, passa all'utente root.
```
sudo su -
```

In ogni finestra del terminale, visualizza il file system del disco.

df -h

Nell'host master, dovresti vedere un output simile al seguente:

hana-scaleout-w-failover:~ # df -h
Filesystem                      Size  Used Avail Use% Mounted on
devtmpfs                        4.0M  8.0K  4.0M   1% /dev
tmpfs                           189G  4.0K  189G   1% /dev/shm
tmpfs                            51G   18M   51G   1% /run
tmpfs                           4.0M     0  4.0M   0% /sys/fs/cgroup
/dev/sdb3                        45G  6.4G   39G  15% /
/dev/sdb2                        20M  3.0M   17M  15% /boot/efi
10.74.146.58:/hana_shr          2.5T   41G  2.3T   2% /hana/shared
/dev/mapper/vg_hana_data-data   422G   12G  411G   3% /hana/data/HF0/mnt00001
/dev/mapper/vg_hana_log-log     128G  7.8G  121G   7% /hana/log/HF0/mnt00001
tmpfs                            26G     0   26G   0% /run/user/174
10.188.249.170:/hana_bup        2.5T     0  2.4T   0% /hanabackup
tmpfs                            26G     0   26G   0% /run/user/900
tmpfs                            26G     0   26G   0% /run/user/1000

Su un host worker, nota che le directory /hana/data e /hana/log hanno montaggi diversi:

hana-scaleout-w-failoverw1:~ # df -h
Filesystem                      Size  Used Avail Use% Mounted on
devtmpfs                        4.0M  8.0K  4.0M   1% /dev
tmpfs                           189G  4.0K  189G   1% /dev/shm
tmpfs                            51G  9.4M   51G   1% /run
tmpfs                           4.0M     0  4.0M   0% /sys/fs/cgroup
/dev/sda3                        45G  6.4G   39G  15% /
/dev/sda2                        20M  3.0M   17M  15% /boot/efi
tmpfs                            26G     0   26G   0% /run/user/0
10.74.146.58:/hana_shr          2.5T   41G  2.3T   2% /hana/shared
10.188.249.170:/hana_bup        2.5T     0  2.4T   0% /hanabackup
/dev/mapper/vg_hana_data-data   422G  593M  422G   1% /hana/data/HF0/mnt00002
/dev/mapper/vg_hana_log-log     128G  3.2G  125G   3% /hana/log/HF0/mnt00002
tmpfs                            26G     0   26G   0% /run/user/1000

Su un host in standby, le directory dei dati e dei log non vengono montate fino a quando l'host in standby prende il controllo di un host in caso di errore:

hana-scaleout-w-failoverw4:~ # df -h
Filesystem                      Size  Used Avail Use% Mounted on
devtmpfs                        4.0M  8.0K  4.0M   1% /dev
tmpfs                           189G  4.0K  189G   1% /dev/shm
tmpfs                            51G  9.4M   51G   1% /run
tmpfs                           4.0M     0  4.0M   0% /sys/fs/cgroup
/dev/sda3                        45G  6.4G   39G  15% /
/dev/sda2                        20M  3.0M   17M  15% /boot/efi
tmpfs                            26G     0   26G   0% /run/user/0
10.74.146.58:/hana_shr          2.5T   41G  2.3T   2% /hana/shared
10.188.249.170:/hana_bup        2.5T     0  2.4T   0% /hanabackup
tmpfs                            26G     0   26G   0% /run/user/1000

In ogni finestra del terminale, passa all'utente del sistema operativo SAP HANA. Sostituisci SID_LC con il valore sap_hana_sid specificato nel file di configurazione. Il valore SID_LC deve essere in minuscolo.
```
su - SID_LCadm
```

In ogni finestra del terminale, assicurati che i servizi SAP HANA, come hdbnameserver, hdbindexserver e altri, siano in esecuzione sull'istanza.

HDB info

Nell'host master, dovresti vedere un output simile a quello del seguente esempio troncato:

hana-scaleout-w-failover:~ # su - hf0adm
hf0adm@hana-scaleout-w-failover:/usr/sap/HF0/HDB00> HDB info
USER          PID     PPID  %CPU        VSZ        RSS COMMAND
hf0adm      25987    25986   0.4      15248       6312 -sh
hf0adm      26049    25987   0.0      10448       4036  \_ /bin/sh /usr/sap/HF0/HDB00/HDB info
hf0adm      26084    26049   0.0      19892       3864      \_ ps fx -U hf0adm -o user:8,pid:8,ppid:8,pcpu:5,vsz:10,rss:10,args
hf0adm      22386    22385   0.0      15248       6248 -sh
hf0adm      19164        1   0.0      13604       3124 sapstart pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failover
hf0adm      19171    19164   0.0     481188      84340  \_ /usr/sap/HF0/HDB00/hana-scaleout-w-failover/trace/hdb.sapHF0_HDB00 -d -nw -f /usr/sap/HF0/HDB00/hana-scaleout-w-failover/daemon.ini pf=/usr/sap/HF0/SYS/profile/HF0_HDB00_hana-scaleout-w-failover
hf0adm      19193    19171   3.4    9616860    3970304      \_ hdbnameserver
hf0adm      19583    19171   0.3    4636456     206500      \_ hdbcompileserver
hf0adm      19586    19171   0.3    4883932     235764      \_ hdbpreprocessor
hf0adm      19624    19171   5.9    9896896    4193620      \_ hdbindexserver -port 30003
hf0adm      19627    19171   1.2    7920208    1605448      \_ hdbxsengine -port 30007
hf0adm      20072    19171   0.5    6825984     531884      \_ hdbwebdispatcher
hf0adm      15053        1   0.0     590628      33208 hdbrsutil  --start --port 30003 --volume 3 --volumesuffix mnt00001/hdb00003.00003 --identifier 1689854702
hf0adm      14420        1   0.0     590560      33308 hdbrsutil  --start --port 30001 --volume 1 --volumesuffix mnt00001/hdb00001 --identifier 1689854671
hf0adm      14155        1   0.1     554820      33320 /usr/sap/HF0/HDB00/exe/sapstartsrv pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failover -D -u hf0adm
hf0adm      14030        1   0.0      57024      11060 /usr/lib/systemd/systemd --user
hf0adm      14031    14030   0.0     243164       4036  \_ (sd-pam)

Su un host worker, dovresti vedere un output simile a quello del seguente esempio troncato:

hana-scaleout-w-failoverw1:~ # su - hf0adm
hf0adm@hana-scaleout-w-failoverw1:/usr/sap/HF0/HDB00> HDB info
USER          PID     PPID  %CPU        VSZ        RSS COMMAND
hf0adm      16442    16441   0.0      15248       6276 -sh
hf0adm      17317    16442   0.0      10448       4032  \_ /bin/sh /usr/sap/HF0/HDB00/HDB info
hf0adm      17352    17317   0.0      19892       3816      \_ ps fx -U hf0adm -o user:8,pid:8,ppid:8,pcpu:5,vsz:10,rss:10,args
hf0adm      11873        1   0.0      13604       3244 sapstart pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failoverw1
hf0adm      11880    11873   0.0     477076      84260  \_ /usr/sap/HF0/HDB00/hana-scaleout-w-failoverw1/trace/hdb.sapHF0_HDB00 -d -nw -f /usr/sap/HF0/HDB00/hana-scaleout-w-failoverw1/daemon.ini pf=/usr/sap/HF0/SYS/profile/HF0_HDB00_hana-scaleout-w-failoverw1
hf0adm      11902    11880   0.8    7738216     784912      \_ hdbnameserver
hf0adm      12140    11880   0.4    4245828     199884      \_ hdbcompileserver
hf0adm      12143    11880   0.4    4758024     235448      \_ hdbpreprocessor
hf0adm      12176    11880   0.6    6046020     534448      \_ hdbwebdispatcher
hf0adm      12210    11880   2.0    8363976    1743196      \_ hdbindexserver -port 30003
hf0adm      10452        1   0.0     525100      33640 hdbrsutil  --start --port 30003 --volume 4 --volumesuffix mnt00002/hdb00004.00003 --identifier 1689855202
hf0adm      10014        1   0.1     554696      31992 /hana/shared/HF0/HDB00/exe/sapstartsrv pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failoverw1 -D -u hf0adm

Su un host in standby, dovresti vedere un output simile a quello del seguente esempio troncato:

hana-scaleout-w-failoverw4:~ # su - hf0adm
hf0adm@hana-scaleout-w-failoverw4:/usr/sap/HF0/HDB00> HDB info
USER          PID     PPID  %CPU        VSZ        RSS COMMAND
hf0adm      15597    15596   0.5      15248       6272 -sh
hf0adm      15659    15597   0.0      10448       4004  \_ /bin/sh /usr/sap/HF0/HDB00/HDB info
hf0adm      15694    15659   0.0      19892       3860      \_ ps fx -U hf0adm -o user:8,pid:8,ppid:8,pcpu:5,vsz:10,rss:10,args
hf0adm      10285        1   0.0      13604       3244 sapstart pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failoverw4
hf0adm      10292    10285   0.0     478076      84540  \_ /usr/sap/HF0/HDB00/hana-scaleout-w-failoverw4/trace/hdb.sapHF0_HDB00 -d -nw -f /usr/sap/HF0/HDB00/hana-scaleout-w-failoverw4/daemon.ini pf=/usr/sap/HF0/SYS/profile/HF0_HDB00_hana-scaleout-w-failoverw4
hf0adm      10314    10292   0.6    7468320     729308      \_ hdbnameserver
hf0adm      10492    10292   0.3    3851320     191636      \_ hdbcompileserver
hf0adm      10495    10292   0.3    4493296     227884      \_ hdbpreprocessor
hf0adm      10528    10292   0.4    5381616     509368      \_ hdbwebdispatcher
hf0adm       9750        1   0.0     620748      32796 /hana/shared/HF0/HDB00/exe/sapstartsrv pf=/hana/shared/HF0/profile/HF0_HDB00_hana-scaleout-w-failoverw4 -D -u hf0adm

Se utilizzi RHEL per SAP 9.0 o versioni successive, assicurati che i pacchetti chkconfig e compat-openssl11 siano installati sulla tua istanza VM.

Per maggiori informazioni su SAP, consulta SAP Note 3108316 - Red Hat Enterprise Linux 9.x: installazione e configurazione .

Connetti SAP HANA Studio

Connettiti all'host SAP HANA master da SAP HANA Studio.

Puoi connetterti da un'istanza di SAP HANA Studio esterna a Google Cloud o da un'istanza su Google Cloud. Potrebbe essere necessario abilitare l'accesso alla rete tra le VM di destinazione e SAP HANA Studio.

Per utilizzare SAP HANA Studio su Google Cloud e abilitare l'accesso al sistema SAP HANA, consulta Installazione di SAP HANA Studio su una VM Windows di Compute Engine.
In SAP HANA Studio, fai clic sulla scheda Paesaggio nel riquadro predefinito di amministrazione del sistema. Dovresti vedere una visualizzazione simile all'esempio seguente.

Esegui la pulizia e riprova a eseguire il deployment

Se uno dei passaggi di verifica del deployment nelle sezioni precedenti indica che l'installazione non è riuscita, devi annullare il deployment e riprovare completando i seguenti passaggi:

Risolvi gli eventuali errori per assicurarti che il deployment non si verifichi di nuovo per lo stesso motivo. Per informazioni su come controllare i log o risolvere gli errori relativi alle quote, consulta Controllare i log.
Apri Cloud Shell o, se hai installato Google Cloud CLI sulla tua workstation locale, apri un terminale.

Apri Cloud Shell
Vai alla directory che contiene il file di configurazione Terraform che hai utilizzato per questo deployment.
Elimina tutte le risorse che fanno parte del tuo deployment eseguendo questo comando:
```
terraform destroy
```
Quando ti viene chiesto di approvare l'azione, inserisci yes.
Riprova a eseguire il deployment come indicato in precedenza in questa guida.

Esecuzione di un test di failover

Dopo aver confermato che il deployment del sistema SAP HANA è andato a buon fine, testa la funzione di failover.

Le seguenti istruzioni attivano un failover passando all'utente del sistema operativo SAP HANA e inserendo il comando HDB stop. Il comando HDB stop avvia un arresto controllato di SAP HANA e scollega i dischi dall'host, consentendo un failover relativamente rapido.

Per eseguire un test di failover:

Connettiti alla VM di un host worker utilizzando SSH. Puoi connetterti dalla pagina Istanze VM di Compute Engine facendo clic sul pulsante SSH per ogni istanza VM oppure puoi utilizzare il metodo SSH che preferisci.

Vai a Istanze VM
Passa all'utente del sistema operativo SAP HANA. Nel comando seguente, sostituisci SID_LC con il valore specificato per l'argomento sap_hana_sid nel file di configurazione di Terraform.
```
su - SID_LCadm
```
Simula un errore arrestando SAP HANA:
```
HDB stop
```
Il comando HDB stop avvia un arresto di SAP HANA, che attiva un failover. Durante il failover, i dischi vengono scollegati dall'host in errore e ricollegati all'host in standby. L'host in errore viene riavviato e diventa un host in standby.
Dopo aver atteso il completamento del takeover, connettiti all'host che ha assunto il controllo dell'host in errore utilizzando SSH.
Passa all'utente root:
```
sudo su -
```

Visualizza le informazioni sul file system del disco:

df -h

Dovresti vedere un output simile al seguente. Tieni presente che le directory /hana/data e /hana/log dell'host con errore sono ora montate sull'host che ha assunto il controllo dell'host.

hana-scaleout-w-failoverw4:~ # df -h
Filesystem                      Size  Used Avail Use% Mounted on
devtmpfs                        4.0M  8.0K  4.0M   1% /dev
tmpfs                           189G  4.0K  189G   1% /dev/shm
tmpfs                            51G  9.4M   51G   1% /run
tmpfs                           4.0M     0  4.0M   0% /sys/fs/cgroup
/dev/sda3                        45G  6.4G   39G  15% /
/dev/sda2                        20M  3.0M   17M  15% /boot/efi
tmpfs                            26G     0   26G   0% /run/user/0
10.74.146.58:/hana_shr          2.5T   41G  2.3T   2% /hana/shared
10.188.249.170:/hana_bup        2.5T     0  2.4T   0% /hanabackup
tmpfs                            26G     0   26G   0% /run/user/1000
/dev/mapper/vg_hana_data-data   422G  593M  422G   1% /hana/data/HF0/mnt00002
/dev/mapper/vg_hana_log-log     128G  3.2G  125G   3% /hana/log/HF0/mnt00002

In SAP HANA Studio, apri la visualizzazione Paesaggio del sistema SAP HANA per confermare che il failover è riuscito:
- Lo stato degli host coinvolti nel failover deve essere INFO.
- La colonna Ruolo server dell'indicizzazione (effettivo) dovrebbe mostrare l'host non riuscito come nuovo host in standby.

Convalida l'installazione dell'agente di Google Cloud per SAP

Dopo aver eseguito il deployment di una VM e installato il sistema SAP, verifica che l'agente Google Cloud per SAP funzioni correttamente.

Verifica che l'agente Google Cloud per SAP sia in esecuzione

Per verificare che l'agente sia in esecuzione, segui questi passaggi:

Stabilisci una connessione SSH con la tua istanza VM host.

Esegui questo comando:

systemctl status google-cloud-sap-agent

Se l'agente funziona correttamente, l'output contiene active (running). Ad esempio:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Se l'agente non è in esecuzione, riavvialo.

Verifica che l'agente host SAP stia ricevendo le metriche

Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente di Google Cloud per SAP e inviate correttamente all'agente host SAP, segui questi passaggi:

Nel sistema SAP, inserisci la transazione ST06.
Nel riquadro Panoramica, verifica la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Provider cloud: Google Cloud Platform
- Accesso a monitoraggio avanzato: TRUE
- Dettagli sul monitoraggio avanzato: ACTIVE

Configura il monitoraggio per SAP HANA

Facoltativamente, puoi monitorare le tue istanze SAP HANA utilizzando l'agente di Google Cloud per SAP. Dalla versione 2.0, puoi configurare l'agente per raccogliere le metriche di monitoraggio SAP HANA e inviarle a Cloud Monitoring. Cloud Monitoring consente di creare dashboard per visualizzare queste metriche, configurare avvisi basati su soglie delle metriche e altro ancora.

Per ulteriori informazioni sulla raccolta delle metriche di monitoraggio SAP HANA tramite l'agente di Google Cloud per SAP, consulta Raccolta delle metriche di monitoraggio SAP HANA.

Abilita riavvio rapido SAP HANA

Google Cloud consiglia vivamente di abilitare il riavvio rapido di SAP HANA per ogni istanza di SAP HANA, in particolare per le istanze più grandi. Il riavvio rapido di SAP HANA riduce i tempi di riavvio nel caso in cui SAP HANA termina, ma il sistema operativo rimane in esecuzione.

Come configurato dagli script di automazione forniti da Google Cloud, le impostazioni del sistema operativo e del kernel supportano già SAP HANA Fast Riavvia. Devi definire il file system tmpfs e configurare SAP HANA.

Per definire il file system tmpfs e configurare SAP HANA, puoi seguire la procedura manuale o utilizzare lo script di automazione fornito da Google Cloud per abilitare SAP HANA Fast Riavvia. Per ulteriori informazioni, consulta:

Passaggi manuali: abilita il riavvio rapido di SAP HANA
Passaggi automatici: abilita il riavvio rapido di SAP HANA

Per le istruzioni autorevoli complete per il riavvio rapido di SAP HANA, consulta la documentazione relativa all'opzione di riavvio rapido di SAP HANA.

Passaggi manuali

Configura il file system `tmpfs`

Una volta eseguito il deployment delle VM host e dei sistemi SAP HANA di base, devi creare e montare le directory per i nodi NUMA nel file system tmpfs.

Visualizza la topologia NUMA della VM

Prima di poter mappare il file system tmpfs richiesto, devi sapere quanti nodi NUMA include la tua VM. Per visualizzare i nodi NUMA disponibili su una VM di Compute Engine, inserisci il seguente comando:

lscpu | grep NUMA

Ad esempio, un tipo di VM m2-ultramem-208 ha quattro nodi NUMA, numerati da 0 a 3, come mostrato nell'esempio seguente:

NUMA node(s):        4
NUMA node0 CPU(s):   0-25,104-129
NUMA node1 CPU(s):   26-51,130-155
NUMA node2 CPU(s):   52-77,156-181
NUMA node3 CPU(s):   78-103,182-207

Crea le directory dei nodi NUMA

Crea una directory per ogni nodo NUMA nella tua VM e imposta le autorizzazioni.

Ad esempio, per quattro nodi NUMA numerati da 0 a 3:

mkdir -pv /hana/tmpfs{0..3}/SID
chown -R SID_LCadm:sapsys /hana/tmpfs*/SID
chmod 777 -R /hana/tmpfs*/SID

Monta le directory del nodo NUMA in `tmpfs`

Monta le directory del file system tmpfs e specifica una preferenza di nodo NUMA per ognuna con mpol=prefer:

SID specifica il SID con lettere maiuscole.

mount tmpfsSID0 -t tmpfs -o mpol=prefer:0 /hana/tmpfs0/SID
mount tmpfsSID1 -t tmpfs -o mpol=prefer:1 /hana/tmpfs1/SID
mount tmpfsSID2 -t tmpfs -o mpol=prefer:2 /hana/tmpfs2/SID
mount tmpfsSID3 -t tmpfs -o mpol=prefer:3 /hana/tmpfs3/SID

Aggiorna `/etc/fstab`

Per assicurarti che i punti di montaggio siano disponibili dopo il riavvio di un sistema operativo, aggiungi voci alla tabella del file system /etc/fstab:

tmpfsSID0 /hana/tmpfs0/SID tmpfs rw,relatime,mpol=prefer:0
tmpfsSID1 /hana/tmpfs1/SID tmpfs rw,relatime,mpol=prefer:1
tmpfsSID1 /hana/tmpfs2/SID tmpfs rw,relatime,mpol=prefer:2
tmpfsSID1 /hana/tmpfs3/SID tmpfs rw,relatime,mpol=prefer:3

(Facoltativo) Imposta i limiti per l'utilizzo della memoria

Il file system tmpfs può crescere e ridursi in modo dinamico.

Per limitare la memoria utilizzata dal file system tmpfs, puoi impostare un limite di dimensione per un volume di nodi NUMA con l'opzione size. Ad esempio:

mount tmpfsSID0 -t tmpfs -o mpol=prefer:0,size=250G /hana/tmpfs0/SID

Puoi anche limitare l'utilizzo complessivo della memoria di tmpfs per tutti i nodi NUMA per una determinata istanza SAP HANA e un determinato nodo del server impostando il parametro persistent_memory_global_allocation_limit nella sezione [memorymanager] del file global.ini.

Configurazione SAP HANA per riavvio rapido

Per configurare SAP HANA per il riavvio rapido, aggiorna il file global.ini e specifica le tabelle da archiviare nella memoria permanente.

Aggiorna la sezione `[persistence]` nel file `global.ini`

Configura la sezione [persistence] nel file SAP HANA global.ini per fare riferimento alle località tmpfs. Separa ogni posizione tmpfs con un punto e virgola:

[persistence]
basepath_datavolumes = /hana/data
basepath_logvolumes = /hana/log
basepath_persistent_memory_volumes = /hana/tmpfs0/SID;/hana/tmpfs1/SID;/hana/tmpfs2/SID;/hana/tmpfs3/SID

L'esempio precedente specifica quattro volumi di memoria per quattro nodi NUMA, che corrispondono al valore m2-ultramem-208. Se utilizzi il m2-ultramem-416, devi configurare otto volumi di memoria (0,.7).

Riavvia SAP HANA dopo aver modificato il file global.ini.

SAP HANA può ora utilizzare la località tmpfs come spazio di memoria permanente.

Specifica le tabelle da archiviare in memoria permanente

Specifica tabelle o partizioni di colonne specifiche da archiviare nella memoria permanente.

Ad esempio, per attivare la memoria permanente per una tabella esistente, esegui la query SQL:

ALTER TABLE exampletable persistent memory ON immediate CASCADE

Per modificare il valore predefinito per le nuove tabelle, aggiungi il parametro table_default nel file indexserver.ini. Ad esempio:

[persistent_memory]
table_default = ON

Per ulteriori informazioni su come controllare colonne e tabelle e sulle viste di monitoraggio che forniscono informazioni dettagliate, consulta SAP HANA Persistent Memory.

Passaggi automatici

Lo script di automazione fornito da Google Cloud per abilitare il riavvio rapido di SAP HANA apporta modifiche alle directory /hana/tmpfs*, al file /etc/fstab e alla configurazione di SAP HANA. Quando esegui lo script, potresti dover eseguire passaggi aggiuntivi, a seconda che si tratti del deployment iniziale del tuo sistema SAP HANA o di dimensioni della macchina a una dimensione NUMA diversa.

Per il deployment iniziale del sistema SAP HANA o il ridimensionamento della macchina per aumentare il numero di nodi NUMA, assicurati che SAP HANA sia in esecuzione durante l'esecuzione dello script di automazione fornito da Google Cloud per abilitare SAP HANA Fast Riavvia.

Quando ridimensiona la macchina per ridurre il numero di nodi NUMA, assicurati che SAP HANA venga arrestato durante l'esecuzione dello script di automazione fornito da Google Cloud per abilitare SAP HANA Fast Riavvia. Dopo l'esecuzione dello script, devi aggiornare manualmente la configurazione SAP HANA per completare la configurazione di SAP HANA Fast Riavvia. Per maggiori informazioni, consulta la pagina sulla configurazione di SAP HANA per il riavvio rapido.

Per abilitare il riavvio rapido di SAP HANA, segui questi passaggi:

Stabilisci una connessione SSH con la VM host.
Passa alla directory principale:
```
sudo su -
```

Scarica lo script sap_lib_hdbfr.sh:

wget https://storage.googleapis.com/cloudsapdeploy/terraform/latest/terraform/lib/sap_lib_hdbfr.sh

Rendi eseguibile il file:
```
chmod +x sap_lib_hdbfr.sh
```
Verifica che lo script non presenti errori:
```
vi sap_lib_hdbfr.sh
./sap_lib_hdbfr.sh -help
```
Se il comando restituisce un errore, contatta l'assistenza clienti Google Cloud. Per saperne di più su come contattare l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.
Esegui lo script dopo aver sostituito l'ID sistema (SID) e la password SAP HANA per l'utente SYSTEM del database SAP HANA. Per fornire la password in modo sicuro, ti consigliamo di utilizzare un secret in Secret Manager.

Esegui lo script utilizzando il nome di un secret in Secret Manager. Questo secret deve esistere nel progetto Google Cloud che contiene l'istanza VM host.
```
sudo ./sap_lib_hdbfr.sh -h 'SID' -s SECRET_NAME 
```
Sostituisci quanto segue:
- SID: specifica il SID con lettere maiuscole. Ad esempio, AHA.
- SECRET_NAME: specifica il nome del secret corrispondente alla password per l'utente SYSTEM del database SAP HANA. Questo secret deve esistere nel progetto Google Cloud che contiene l'istanza VM host.
In alternativa, puoi eseguire lo script utilizzando una password in testo normale. Dopo aver abilitato il riavvio rapido di SAP HANA, assicurati di modificare la password. Non è consigliabile utilizzare una password di testo normale, in quanto la password verrebbe registrata nella cronologia della riga di comando della VM.
```
sudo ./sap_lib_hdbfr.sh -h 'SID' -p 'PASSWORD'
```
Sostituisci quanto segue:
- SID: specifica il SID con lettere maiuscole. Ad esempio, AHA.
- PASSWORD: specifica la password per l'utente SYSTEM del database SAP HANA.

Per un'esecuzione iniziale riuscita, dovresti vedere un output simile al seguente:

INFO - Script is running in standalone mode
ls: cannot access '/hana/tmpfs*': No such file or directory
INFO - Setting up HANA Fast Restart for system 'TST/00'.
INFO - Number of NUMA nodes is 2
INFO - Number of directories /hana/tmpfs* is 0
INFO - HANA version 2.57
INFO - No directories /hana/tmpfs* exist. Assuming initial setup.
INFO - Creating 2 directories /hana/tmpfs* and mounting them
INFO - Adding /hana/tmpfs* entries to /etc/fstab. Copy is in /etc/fstab.20220625_030839
INFO - Updating the HANA configuration.
INFO - Running command: select * from dummy
DUMMY
"X"
1 row selected (overall time 4124 usec; server time 130 usec)

INFO - Running command: ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('persistence', 'basepath_persistent_memory_volumes') = '/hana/tmpfs0/TST;/hana/tmpfs1/TST;'
0 rows affected (overall time 3570 usec; server time 2239 usec)

INFO - Running command: ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('persistent_memory', 'table_unload_action') = 'retain';
0 rows affected (overall time 4308 usec; server time 2441 usec)

INFO - Running command: ALTER SYSTEM ALTER CONFIGURATION ('indexserver.ini', 'SYSTEM') SET ('persistent_memory', 'table_default') = 'ON';
0 rows affected (overall time 3422 usec; server time 2152 usec)

Connessione a SAP HANA

Tieni presente che, poiché queste istruzioni non utilizzano un IP esterno per SAP HANA, puoi connetterti alle istanze SAP HANA solo tramite l'istanza bastion utilizzando SSH o tramite il server Windows utilizzando SAP HANA Studio.

Per connetterti a SAP HANA tramite l'istanza bastion, connettiti al bastion host e quindi alle istanze SAP HANA utilizzando un client SSH di tua scelta.
Per connetterti al database SAP HANA tramite SAP HANA Studio, utilizza un client desktop remoto per connetterti all'istanza Windows Server. Dopo la connessione, installa manualmente SAP HANA Studio e accedi al tuo database SAP HANA.

Esecuzione di attività post-deployment

Prima di utilizzare l'istanza SAP HANA, ti consigliamo di eseguire i seguenti passaggi post-deployment. Per ulteriori informazioni, consulta la guida all'installazione e all'aggiornamento di SAP HANA.

Modificare le password temporanee dell'amministratore di sistema e del super user del database SAP HANA.
Aggiorna il software SAP HANA con le patch più recenti.
Se viene eseguito il deployment del sistema SAP HANA su un'interfaccia di rete VirtIO, ti consigliamo di assicurarti che il valore del parametro TCP /proc/sys/net/ipv4/tcp_limit_output_bytes sia impostato su 1048576. Questa modifica consente di migliorare la velocità effettiva di rete complessiva nell'interfaccia di rete VirtIO senza influire sulla latenza di rete.
Installa eventuali componenti aggiuntivi, come le librerie delle funzioni delle applicazioni (AFL) o l'accesso intelligente ai dati (SDA).
Se stai eseguendo l'upgrade di un sistema SAP HANA esistente, carica i dati dal sistema esistente utilizzando procedure di backup e ripristino standard o la replica del sistema SAP HANA.
Configura ed esegui il backup del tuo nuovo database SAP HANA. Per ulteriori informazioni, consulta la guida alle operazioni di SAP HANA.

Valuta il carico di lavoro SAP HANA

Per automatizzare i controlli di convalida continui per i carichi di lavoro SAP HANA in esecuzione su Google Cloud, puoi utilizzare Workload Manager.

Workload Manager consente di analizzare e valutare automaticamente i carichi di lavoro SAP HANA sulla base delle best practice dei fornitori SAP, Google Cloud e sistemi operativi. Ciò consente di migliorare la qualità, le prestazioni e l'affidabilità dei carichi di lavoro.

Per informazioni sulle best practice supportate da Workload Manager per la valutazione dei carichi di lavoro SAP HANA in esecuzione su Google Cloud, consulta Best practice di Workload Manager per SAP. Per informazioni su come creare ed eseguire una valutazione utilizzando Gestore carichi di lavoro, consulta Creare ed eseguire una valutazione.

Passaggi successivi

Per ulteriori informazioni sull'amministrazione e il monitoraggio delle VM, consulta la Guida operativa di SAP HANA.