Terraform: guida al deployment dello scale up di SAP HANA

Questa guida al deployment mostra come eseguire il deployment di un sistema SAP HANA su Google Cloud utilizzando Terraform e un file di configurazione per definire l'installazione. Questa guida ti aiuta a configurare macchine virtuali (VM) e dischi permanenti di Compute Engine, nonché il sistema operativo Linux, in modo da ottenere le migliori prestazioni per il tuo sistema SAP HANA. Il file di configurazione Terraform incorpora le best practice sia di Compute Engine che di SAP.

Utilizza questa guida per eseguire il deployment di un sistema SAP HANA che prevede lo scale up di un singolo host o di uno con scale out di più host che non include host in standby.

Se devi includere il failover automatico dell'host SAP HANA, utilizza la guida al deployment del sistema di scale out di SAP HANA con sistema di scale out automatico dell'host.

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

Prerequisiti

Prima di iniziare, assicurati di soddisfare i seguenti prerequisiti:

Aver letto la guida alla pianificazione di SAP HANA.
Devi disporre di un account e un progetto Google Cloud.
Se hai bisogno che il carico di lavoro SAP venga eseguito in conformità con la residenza dei dati, controllo dell'accesso, il personale di assistenza o i requisiti normativi, devi creare la cartella Assured Workloads richiesta. Per maggiori informazioni, consulta la pagina relativa ai controlli di conformità e sovranità per SAP su Google Cloud.
Il networking di Virtual Private Cloud è configurato con regole firewall o altri metodi per controllare l'accesso alle tue VM.
Hai accesso al supporto di installazione di SAP HANA.
Se OS Login è abilitato nei metadati del progetto e stai eseguendo il deployment di nodi scale out, devi disabilitare temporaneamente l'accesso al sistema operativo 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 di chiavi SSH basate su metadati vengono disabilitate e il deployment non va a buon fine. Al termine del deployment, puoi abilitare di nuovo OS Login.

Per ulteriori informazioni, vedi:
- Attivazione o disattivazione di OS Login
- Aggiunta di chiavi SSH alle VM che utilizzano chiavi SSH basate su metadati

Configurazione dell'Account Google

Per lavorare con Google Cloud è necessario un Account Google.

Registrati per creare un Account Google, se non ne hai ancora uno.
(Facoltativo) Se vuoi che il carico di lavoro SAP venga eseguito in conformità con la residenza dei dati, controllo dell'accesso, il personale di assistenza o i requisiti normativi, devi creare la cartella Assured Workloads richiesta. Per maggiori informazioni, consulta la pagina relativa ai controlli di conformità e sovranità per SAP su Google Cloud.
Accedi alla console Google Cloud e crea un nuovo progetto.
Attiva l'account di fatturazione.
Configura le chiavi SSH in modo da poterle utilizzare per SSH nelle istanze VM di Compute Engine. Utilizza Google Cloud CLI per creare una nuova chiave SSH.
Utilizza gcloud CLI o la console Google Cloud per aggiungere le chiavi SSH ai metadati del progetto. In questo modo puoi accedere a qualsiasi istanza VM di Compute Engine creata all'interno di questo progetto, tranne che alle istanze che disabilitano esplicitamente le chiavi SSH a livello di progetto.

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 richiedono in genere l'accesso a internet per scaricare l'agente di Google Cloud per SAP. Se utilizzi una delle immagini Linux certificate per SAP disponibili in Google Cloud, l'istanza VM richiede anche l'accesso a internet per poter registrare la licenza e accedere ai repository dei fornitori di sistemi operativi. Una configurazione con un gateway NAT e con tag di rete VM supporta questo accesso, anche se le VM di destinazione non hanno IP esterni.

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

Crea una rete in modalità personalizzata. Per ulteriori informazioni, consulta la sezione Creazione di una rete in modalità personalizzata.
Crea una subnet e specifica la regione e l'intervallo IP. Per saperne di più, 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 software-defined distribuito e software-defined di Google Cloud che consente alle VM di inviare pacchetti in uscita a internet e ricevere 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 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.

Aggiunta di 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 tua VM. Dopo aver stabilito una connessione in entrata con una VM, il traffico è consentito in entrambe le direzioni su quella connessione.

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

A seconda del criterio IT applicabile al tuo ambiente, potrebbe essere necessario isolare o limitare in altro modo la connettività all'host del database creando regole firewall.

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

Le porte SAP predefinite elencate nella sezione TCP/IP di tutti i prodotti SAP.
Connessioni dal tuo computer o ambiente di rete aziendale alla tua istanza VM di Compute Engine. Se hai dubbi in merito a quale indirizzo IP utilizzare, rivolgiti all'amministratore di rete della tua azienda.
Comunicazione tra le VM nella subnet SAP HANA, inclusa la comunicazione tra i nodi in un sistema con scale out SAP HANA o la comunicazione tra il server di database e i server delle applicazioni in un'architettura a tre livelli. Puoi abilitare la comunicazione tra le VM creando una regola firewall per consentire il traffico che ha origine dall'interno della subnet.
Connessioni SSH all'istanza VM, incluso SSH-in-browser.
Connessione alla VM tramite uno strumento di terze parti in Linux. Crea una regola per consentire l'accesso allo strumento attraverso il firewall.

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

Creazione di un bucket Cloud Storage per i file di installazione di SAP HANA

Prima di utilizzare Terraform per installare SAP HANA sulla tua VM di Compute Engine, devi caricare i file di installazione che contengono i programmi binari di SAP HANA in un bucket Cloud Storage.

Terraform prevede i file di installazione di SAP HANA nei formati file forniti da SAP. A seconda della versione di SAP HANA, il formato file potrebbe essere ZIP, EXE o RAR.

Per scaricare i file di installazione di SAP HANA, devi creare un bucket Cloud Storage e quindi caricare i file in quel bucket come segue:

Scarica i file di installazione di base per la versione di SAP HANA richiesta:
1. Vai al portale di assistenza SAP.
2. Fai clic su Download software.
3. Nella scheda Installazioni e upgrade, fai clic su In base all'indice alfabetico (A-Z) > H > SAP HANA Platform Edition > SAP HANA Platform Edition 2.0.
4. Fai clic su Installazione.
5. Per il service pack richiesto, seleziona la distribuzione Linux x86_64, quindi fai clic su Scarica il cestino.
  
  Nota: ti consigliamo di scaricare la revisione più recente del pacchetto di servizi più recente.
Se il tuo account SAP Support Portal non consente l'accesso al software e ritieni di avere diritto al software, contatta il SAP Global Support Customer Interaction Center.
Scarica i file necessari per eseguire l'upgrade del database SAP HANA alla versione richiesta. Questi file sono in formato SAR e i nomi iniziano con IMDB_SERVER, IMDB_CLIENT e IMDB_AFL.
1. Vai al Portale di assistenza SAP.
2. Fai clic su Download software.
3. Vai alla scheda Pacchetti e patch di supporto.
4. Fai clic su Per indice alfabetico (A-Z) > H > SAP HANA Platform Edition > SAP HANA Platform Edition 2.0.
5. Fai clic sul componente richiesto. Ad esempio, SAP HANA Database 2.0, SAP HANA Client 2.0 o SAP HANA AFL 2.0.
6. Seleziona il file richiesto e fai clic su Scarica il carrello.
Nota: non è necessario scaricare i programmi binari SAPCAR per decomprimere i file SAR perché il processo di upgrade utilizza il SAPCAR locale disponibile dopo l'installazione di SAP HANA.
Nel tuo progetto Google Cloud, crea un bucket Cloud Storage. Per le istruzioni, consulta la pagina Creare bucket.

Il nome del bucket deve essere univoco in Google Cloud. Durante la creazione del bucket, scegli Standard come classe di archiviazione.
Configura le autorizzazioni del bucket. Per impostazione predefinita, come proprietario del bucket, disponi dell'accesso in lettura e scrittura al bucket. Per concedere l'accesso ad altre entità, consulta Utilizzo delle autorizzazioni IAM.
Carica i programmi binari SAP HANA scaricati nel bucket Cloud Storage o in una cartella nel bucket. Per le istruzioni, consulta la sezione Caricamento di oggetti da un file system.

Assicurati che il bucket o la cartella contengano un solo file di installazione per ogni tipo di file. Ad esempio:

510056441.ZIP
IMDB_SERVER20_059_11-80002031.SAR
IMDB_CLIENT20_005_111-80002082.SAR
IMDB_AFL20_059_11-80002031.SAR

Prendi nota del nome del bucket e della cartella in cui hai caricato i file binari SAP. Dovrai utilizzarli in un secondo momento, quando installerai SAP HANA.

Creazione di una VM con SAP HANA installato

Le seguenti istruzioni utilizzano Terraform per installare SAP HANA su una o più istanze VM con tutti i dischi permanenti richiesti da SAP HANA. Puoi definire i valori per l'installazione in un file di configurazione Terraform.

Le seguenti istruzioni utilizzano Cloud Shell, ma sono generalmente applicabili a Google Cloud CLI.

Conferma che le tue quote attuali per risorse come dischi permanenti e CPU siano sufficienti per il sistema SAP HANA che stai per installare. Se le quote non sono sufficienti, il deployment non riesce. Per i requisiti delle quote di SAP HANA, consulta Prezzi e considerazioni sulle quote per SAP HANA.

Vai a Quote
Apri Cloud Shell o, se hai installato Google Cloud CLI sulla tua workstation locale, apri un terminale.

Apri Cloud Shell
Scarica il file di configurazione sap_hana.tf nella directory di lavoro eseguendo il comando seguente in Cloud Shell o nel terminale:
```
wget https://storage.googleapis.com/cloudsapdeploy/terraform/latest/terraform/sap_hana/terraform/sap_hana.tf
```
Nota: assicurati di avere un solo file di configurazione Terraform nella directory di lavoro.
Apri il file sap_hana.tf nell'editor di codice Cloud Shell o, se utilizzi il terminale, l'editor di testo che preferisci.

Per aprire l'editor di codice 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.tf, aggiorna i seguenti valori degli argomenti sostituendo le parentesi e i relativi contenuti con i valori per l'installazione.

Alcuni dei valori di argomento che hai specificato per il sistema SAP HANA, ad esempio i valori per sap_hana_sid, sap_hana_sidadm_password o sap_hana_system_password, sono soggetti a regole definite da SAP. Per ulteriori informazioni, consulta il riferimento ai parametri nella guida all'installazione e all'aggiornamento del server Sap HANA.

Per specificare le password nel file di configurazione, devi utilizzare i secret o specificare le password in testo normale. Per maggiori informazioni, consulta Gestione delle password.

Se vuoi creare un'istanza VM senza installare SAP HANA, elimina tutte le righe che iniziano con sap_hana_.

Argomento	Tipo di dati	Descrizione
`source`	Stringa	Specifica la località e la versione del modulo Terraform da utilizzare durante il deployment. Il file di configurazione `sap_hana.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 viene disattivata da un carattere `#` iniziale, specifica un timestamp che identifica la versione di un modulo. Se tutti i deployment devono utilizzare 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`	Stringa	Specifica l'ID del progetto Google Cloud in cui stai eseguendo il deployment del sistema. Ad esempio, `my-project-x`.
`instance_name`	Stringa	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 standby utilizzano lo stesso nome con `w` e il numero host aggiunto.
`machine_type`	Stringa	Specifica il tipo di macchina virtuale (VM) Compute Engine su cui devi 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 al numero necessario, pur essendo più grande. Al termine del deployment, modifica il numero di vCPU e la quantità di memoria. Ad esempio, `n1-highmem-32`.
`zone`	Stringa	Specifica la zona in cui esegui il deployment del tuo 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`.
`subnetwork`	Stringa	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`	Stringa	Specifica il nome dell'immagine del sistema operativo Linux in cui vuoi eseguire il deployment del tuo 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`	Stringa	Specifica il progetto Google Cloud contenente l'immagine che hai specificato per l'argomento `linux_image`. Può trattarsi di un tuo progetto personale o di un progetto di immagini Google Cloud. Per un'immagine Compute Engine, specifica `rhel-sap-cloud` o `suse-sap-cloud`. Per trovare il progetto di immagine per il tuo sistema operativo, consulta Dettagli del sistema operativo.
`sap_hana_deployment_bucket`	Stringa	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`	Stringa	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica l'ID di 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_sidadm_uid`	Numero intero	Facoltativo. Specifica un valore per sostituire il valore predefinito dell'`SID_LC`ID utente Adm. Il valore predefinito è `900`. Puoi cambiarlo con un valore diverso per coerenza all'interno del tuo panorama SAP.
`sap_hana_instance_number`	Numero intero	Facoltativo. Specifica il numero di istanza, da 0 a 99, del sistema SAP HANA. Il valore predefinito è `0`.
`sap_hana_sidadm_password`	Stringa	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 Gestione delle password.
`sap_hana_sidadm_password_secret`	Stringa	Facoltativo. Se utilizzi Secret Manager per archiviare la password di `SIDadm`, 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 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 Gestione delle password.
`sap_hana_system_password`	Stringa	Per installare automaticamente SAP HANA sulle VM di cui è stato eseguito il deployment, specifica una password super user del database 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 Gestione delle password.
`sap_hana_system_password_secret`	Stringa	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 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 Gestione delle password.
`sap_hana_scaleout_nodes`	Numero intero	Specifica il numero di host worker necessari nel sistema di scale out. Per eseguire il deployment di un sistema a scalabilità orizzontale, devi avere almeno un host worker. Terraform crea gli host worker oltre all'istanza SAP HANA principale. Ad esempio, se specifichi `3`, nel tuo sistema con scale out viene eseguito il deployment di quattro istanze SAP HANA.
`sap_hana_shared_nfs`	Stringa	Facoltativo. Per un deployment con scale out multi-host che utilizza una soluzione NFS per condividere il volume `/hana/shared` con gli host worker, specifica il punto di montaggio NFS per tale volume. Ad esempio, `10.151.91.122:/hana_shared_nfs`. Per maggiori informazioni, consulta Soluzioni di condivisione di file per deployment con scale out multi-host. Questo argomento è disponibile nel modulo `sap_hana` versione `202302060649` o successive. Nota: il punto di montaggio NFS per il volume `/hana/shared` deve essere vuoto prima di applicare la configurazione Terraform.
`sap_hana_backup_nfs`	Stringa	Facoltativo. Per un deployment con scale out multi-host che utilizza una soluzione NFS per condividere il volume `/hanabackup` con gli host worker, specifica il punto di montaggio NFS per tale volume. Ad esempio, `10.216.41.122:/hana_backup_nfs`. Per maggiori informazioni, consulta Soluzioni di condivisione di file per deployment con scale out multi-host. Questo argomento è disponibile nel modulo `sap_hana` versione `202302060649` o successive.
`sap_hana_shared_nfs_resource`	Mappa/oggetto	Facoltativo. Per eseguire il deployment di un'istanza Filestore che condivide il volume `/hana/shared/` con gli host nel tuo sistema SAP HANA con scale out multi-host, specifica il nome della condivisione file che hai impostato nella definizione della tua risorsa `google_filestore_instance`. Per visualizzare un esempio, consulta la configurazione di esempio in questa guida. Per maggiori informazioni, consulta Soluzioni di condivisione di file per deployment con scale out multi-host. Questo argomento è disponibile nel modulo `sap_hana` versione `202302060649` o successive.
`sap_hana_backup_nfs_resource`	Mappa/oggetto	Facoltativo. Per eseguire il deployment di un'istanza Filestore che condivide il volume `/hanabackup` con gli host nel tuo sistema SAP HANA con scale out multi-host, specifica il nome della condivisione file che hai impostato nella definizione della tua risorsa `google_filestore_instance`. Per visualizzare un esempio, consulta la configurazione di esempio in questa guida. Per maggiori informazioni, consulta Soluzioni di condivisione di file per deployment con scale out multi-host. Questo argomento è disponibile nel modulo `sap_hana` versione `202302060649` o successive.
`sap_hana_backup_size`	Numero intero	Facoltativo. Specifica le dimensioni del volume `/hanabackup` in GB. Se non specifichi questo argomento o non lo imposti su `0`, lo script di installazione esegue il provisioning dell'istanza di Compute Engine con un volume di backup HANA pari al doppio della memoria totale. `sap_hana_backup_size` viene ignorato quando specifichi un valore per `sap_hana_backup_nfs` o `sap_hana_backup_nfs_resource`.
`sap_hana_sapsys_gid`	Numero intero	Facoltativo. Sostituisce l'ID gruppo predefinito per `sapsys`. Il valore predefinito è `79`.
`network_tags`	Stringa	Facoltativo. Specifica uno o più tag di rete separati da virgole da associare alle tue istanze VM per scopi di firewall o di routing. Se specifichi `public_ip = false` e non specifichi un tag di rete, assicurati di fornire un altro mezzo per accedere a internet.
`nic_type`	Stringa	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 supporta gVNIC come valore dell'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 nel modulo `sap_hana` versione `202302060649` o successive.
`disk_type`	Stringa	Facoltativo. Specifica il tipo predefinito di disco permanente o Hyperdisk di cui vuoi eseguire il deployment per tutti i volumi SAP nel tuo deployment. Il valore predefinito è `pd-ssd`. Di seguito sono riportati valori validi per questo argomento: `pd-ssd`, `pd-balanced`, `hyperdisk-extreme`, `hyperdisk-balanced` e `pd-extreme`. Tieni presente che quando specifichi il valore `hyperdisk-extreme` o `hyperdisk-balanced`, la directory `/usr/sap` viene montata su un disco permanente bilanciato separato (`pd-balanced`). Questo perché la directory `/usr/sap` non richiede prestazioni elevate come la directory `/hana/data` o `/hana/log`. Nei deployment con scale up di SAP HANA, viene eseguito il deployment anche di un disco permanente bilanciato separato per la directory `/hana/shared`. Puoi eseguire l'override di questo tipo di disco predefinito, della dimensione predefinita del disco associata e delle IOPS predefinite utilizzando alcuni argomenti avanzati. Per ulteriori informazioni, vai alla tua directory di lavoro, quindi esegui il comando `terraform init`, quindi visualizza il file `/.terraform/modules/sap_hana/variables.tf`. Prima di utilizzare questi argomenti in produzione, assicurati di testarli in un ambiente di test.
`use_single_shared_data_log_disk`	Booleano	Facoltativo. Il valore predefinito è `false`, che indica a Terraform di eseguire il deployment di un disco permanente o di un Hyperdisk separati 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`.
`include_backup_disk`	Booleano	Facoltativo. Questo argomento è applicabile ai deployment con scale up di SAP HANA. Il valore predefinito è `true`, che indica a Terraform di eseguire il deployment di un disco permanente HDD standard per ospitare la directory `/hanabackup`. La dimensione di questo disco è determinata dall'argomento `sap_hana_backup_size`. Se imposti il valore di `include_backup_disk` su `false`, non viene eseguito il deployment di alcun disco per la directory `/hanabackup`.
`backup_disk_type`	Stringa	Facoltativo. Per i deployment con scale up, specifica il tipo di disco permanente o di Hyperdisk di cui vuoi eseguire il deployment per il volume `/hanabackup`. Per impostazione predefinita, viene eseguito il deployment di un disco permanente bilanciato (`pd-balanced`). Di seguito sono riportati i valori validi per questo argomento: `pd-ssd`, `pd-balanced`, `pd-standard`, `hyperdisk-extreme`, `hyperdisk-balanced` e `pd-extreme`. Questo argomento è disponibile in `sap_hana` versione del modulo `202307061058` o successive.
`enable_fast_restart`	Booleano	Facoltativo. Questo argomento determina se l'opzione di riavvio rapido di SAP HANA è abilitata per il deployment. Il valore predefinito è `true`. Google Cloud consiglia vivamente di abilitare l'opzione di riavvio rapido di SAP HANA. Questo argomento è disponibile in `sap_hana` versione del modulo `202309280828` o successive.
`public_ip`	Booleano	Facoltativo. Determina se un indirizzo IP pubblico viene aggiunto o meno all'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 se non hai fornito alla VM un'altra route a internet. Se non è presente alcuna route verso internet, l'installazione non riesce.
`service_account`	Stringa	Facoltativo. Specifica l'indirizzo email di un account di servizio gestito dall'utente che deve essere utilizzato dalle VM host e dai programmi in esecuzione sulle VM host. Ad esempio, `svc-acct-name@project-id.iam.gserviceaccount.com`. Se specifichi questo argomento senza un valore oppure lo ometti, lo script di installazione utilizza l'account di servizio predefinito di Compute Engine. Per maggiori informazioni, consulta Gestione di identità e accessi per programmi SAP su Google Cloud.
`sap_deployment_debug`	Booleano	Facoltativo. Solo quando l'assistenza clienti Google Cloud richiede l'attivazione del debug per il deployment, specifica `true` in modo che il deployment generi log di deployment dettagliati. Il valore predefinito è `false`.
`reservation_name`	Stringa	Facoltativo. Per utilizzare una prenotazione delle 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 venga selezionato automaticamente dallo script di installazione, la prenotazione deve essere impostata con quanto segue: L'opzione `specificReservationRequired` è impostata su `true` oppure, nella console Google Cloud, è selezionata l'opzione Seleziona una prenotazione specifica. Alcuni tipi di macchine Compute Engine supportano le piattaforme CPU non coperte dalla certificazione SAP del tipo di macchina. Se la prenotazione target è per uno dei seguenti tipi di macchina, la prenotazione deve specificare il numero minimo di piattaforme CPU, 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 certificati da SAP per l'utilizzo su Google Cloud sono conformi al requisito minimo di CPU SAP.
`vm_static_ip`	Stringa	Facoltativo. Specifica un indirizzo IP statico valido per l'istanza VM. Se non ne specifichi uno, viene generato automaticamente un indirizzo IP per la tua istanza VM. Questo argomento è disponibile in `sap_hana` 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 a scalabilità orizzontale. 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 in base all'ordine di creazione dell'istanza. Ad esempio, se scegli di eseguire il deployment di 3 istanze worker, ma specifichi solo 2 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 in `sap_hana` versione del modulo `202306120959` o successive.

L'esempio seguente mostra un file di configurazione completato che indica a Terraform di eseguire il deployment di una macchina virtuale n2-highmem-32 con un sistema SAP HANA con scale out che include un'istanza SAP HANA master con tre host worker e istanze Filestore Basic che condividono i volumi /hana/shared e /hanabackup con gli host worker. Gli host eseguono il sistema operativo SLES for SAP 15 SP2.

#
resource "google_filestore_instance" "hana_shared_nfs" {
  name = "fs-basic-shared"
  tier = "PREMIUM"
  project = "example-project-123456"
  location = "us-central1-f"
  file_shares {
    name = "hana_shared_nfs"
    capacity_gb = 2600
  }
  networks {
    network = "example-network"
    modes   = ["MODE_IPV4"]
  }
}

resource "google_filestore_instance" "hana_backup_nfs" {
  name = "fs-basic-backup"
  tier = "PREMIUM"
  project = "example-project-123456"
  location = "us-central1-f"
  file_shares {
    name = "hana_backup_nfs"
    capacity_gb = 2600
  }
  networks {
    network = "example-network"
    modes   = ["MODE_IPV4"]
  }
}

#...
module "sap_hana" {
  source = "https://storage.googleapis.com/cloudsapdeploy/terraform/latest/terraform/sap_hana/sap_hana_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/sap_hana_module.zip"
  # ...
  project_id = "example-project-123456"
  zone = "us-central1-f"
  machine_type = "n2-highmem-32"
  subnetwork = "example-subnet-us-central1"
  linux_image = "sles-15-sp2-sap"
  linux_image_project = "suse-sap-cloud"

  instance_name = "hana-scaleout"
  sap_hana_shared_nfs_resource  = resource.google_filestore_instance.hana_shared_nfs
  sap_hana_backup_nfs_resource  = resource.google_filestore_instance.hana_backup_nfs

  # sap_hana_shared_nfs = "10.151.91.122:/hana_shared_nfs"
  # sap_hana_backup_nfs = "10.216.41.122:/hana_backup_nfs"

  sap_hana_deployment_bucket = "mybucketname"
  sap_hana_sid = "AB2"
  sap_hana_instance_number = 12
  sap_hana_sidadm_password = "TempPa55word"
  sap_hana_system_password = "TempPa55word"
  sap_hana_scaleout_nodes = 3
  sap_hana_sidadm_uid = 11
  vm_static_ip = "10.0.0.1"
  worker_static_ips = ["10.0.0.2", "10.0.0.3", "10.0.0.4"]
  enable_fast_restart = true
  # ...
}

Per inizializzare la tua directory di lavoro attuale e scaricare 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 un 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 latest è specificato nell'URL source.
```
terraform init --upgrade 
```
Facoltativamente, per creare il piano di esecuzione Terraform:
```
terraform plan
```
Il comando terraform plan mostra le modifiche richieste dalla configurazione attuale. Se ignori il comando terraform plan, il comando terraform apply calcola il piano prima di applicarlo.
Per applicare il piano di esecuzione:
```
terraform apply
```
Quando ti viene chiesto di approvare le azioni, inserisci yes.

Il comando terraform apply configura l'infrastruttura Google Cloud, quindi richiama un altro script che configura il sistema operativo e installa SAP HANA.

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

Il tempo di completamento può variare, ma l'intero processo di solito richiede meno di 30 minuti.

Verifica del deployment

Per verificare il deployment, controlla i log di deployment in Cloud Logging e verifica i dischi e i servizi sulle VM degli host principali e worker.

Controlla i log

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

Nota: al completamento di questo passaggio in Cloud Logging, potrebbero esserti addebitati dei costi. Per maggiori 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 e fai clic su Aggiungi.
  
  Se non vedi l'opzione Globale, inserisci la seguente query nell'Editor 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 è completata e puoi andare al passaggio successivo.
- Se viene visualizzato un errore di quota:
  1. Nella pagina Quote di IAM e amministrazione, aumenta le quote che non soddisfano i requisiti di 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 ripulire le VM e i dischi permanenti dall'installazione non riuscita:
```
terraform destroy
```
    Quando ti viene chiesto di approvare l'azione, inserisci yes.
  4. Esegui nuovamente il deployment.

Controlla la configurazione della VM e del sistema SAP HANA

Una volta eseguito il deployment del sistema SAP HANA senza errori, connettiti a ogni VM utilizzando SSH. Nella pagina Istanze VM di Compute Engine, puoi fare clic sul pulsante SSH per ogni istanza VM o utilizzare il tuo metodo SSH preferito.
Passa all'utente root.
```
sudo su -
```

Al prompt dei comandi, inserisci df -h, quindi assicurati che venga visualizzato un output simile al seguente, con i volumi e le dimensioni previsti.

Di seguito è riportato un output di esempio dal nodo master di un sistema di scale out di esempio con tre nodi worker. Tieni presente che non sono previsti volumi per /hana/shared e /hanabackup perché questi volumi sono ospitati su istanze Filestore.

example-vm:~ # df -h
Filesystem                         Size  Used Avail Use% Mounted on
devtmpfs                           126G  8.0K  126G   1% /dev
tmpfs                              189G     0  189G   0% /dev/shm
tmpfs                              126G   18M  126G   1% /run
tmpfs                              126G     0  126G   0% /sys/fs/cgroup
/dev/sda3                           30G  6.5G   24G  22% /
/dev/sda2                           20M  2.9M   18M  15% /boot/efi
10.65.188.162:/hana_shared_nfs     2.5T   41G  2.4T   2% /hana/shared
/dev/mapper/vg_hana_usrsap-usrsap   32G  265M   32G   1% /usr/sap
/dev/mapper/vg_hana_data-data      308G   10G  298G   4% /hana/data
/dev/mapper/vg_hana_log-log        128G  7.8G  121G   7% /hana/log
10.160.217.66:/hana_backup_nfs     2.5T     0  2.4T   0% /hanabackup
tmpfs                               26G     0   26G   0% /run/user/472
tmpfs                               26G     0   26G   0% /run/user/900
tmpfs                               26G     0   26G   0% /run/user/1000

Passa all'utente amministratore SAP:
```
su - SID_LCadm
```
Sostituisci SID_LC con il valore SID specificato nel file di configurazione. Utilizza il minuscolo per tutte le lettere.
Assicurati che i servizi SAP HANA, come hdbnameserver, hdbindexserver e altri, siano in esecuzione nell'istanza:
```
HDB info
```
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 da SAP, consulta la pagina SAP Note 3108316 - Red Hat Enterprise Linux 9.x: Installation and Configuration.

Esegui la pulizia e riprova a eseguire il deployment

Se uno dei passaggi di verifica del deployment nelle sezioni precedenti mostra che l'installazione non è riuscita, devi annullare il deployment e riprovare seguendo questi passaggi:

Risolvi eventuali errori per assicurarti che il deployment non vada a buon fine 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 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.

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

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

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

Per verificare che l'agente sia in esecuzione:

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.

Verificare che l'agente host SAP stia ricevendo le metriche

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

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

Installazione di SAP HANA Studio su una VM Windows di Compute Engine

Puoi connetterti da un'istanza SAP HANA all'esterno di Google Cloud o da un'istanza su Google Cloud. A questo scopo, potresti dover abilitare l'accesso di rete alle VM di destinazione da SAP HANA Studio.

Per installare SAP HANA Studio su una VM Windows in Google Cloud, utilizza la procedura seguente.

Utilizza Cloud Shell per richiamare i comandi seguenti.

Apri Cloud Shell

export NETWORK_NAME="[YOUR_NETWORK_NAME]"
export REGION="[YOUR_REGION]"
export ZONE="[YOUR_ZONE]"
export SUBNET="[YOUR_SUBNETWORK_NAME]"
export SOURCE_IP_RANGE="[YOUR_WORKSTATION_IP]"

gcloud compute instances create saphanastudio --zone=$ZONE \
--machine-type=n1-standard-2  --subnet=$SUBNET --tags=hanastudio \
--image-family=windows-2016  --image-project=windows-cloud \
--boot-disk-size=100 --boot-disk-type=pd-standard \
--boot-disk-device-name=saphanastudio

gcloud compute firewall-rules create ${NETWORK_NAME}-allow-rdp \
--network=$NETWORK_NAME --allow=tcp:3389 --source-ranges=$SOURCE_IP_RANGE \
--target-tags=hanastudio

I comandi precedenti impostano le variabili per la sessione Cloud Shell corrente, crea un server Windows nella subnet creata in precedenza e crea una regola firewall che consente l'accesso dalla workstation locale all'istanza tramite il protocollo RDP (Remote Desktop Protocol).

Installa SAP HANA Studio su questo server.
1. Carica i file di installazione di SAP HANA Studio e lo strumento di estrazione SAPCAR in un bucket Cloud Storage nel tuo progetto Google Cloud.
2. Connettiti alla nuova VM Windows utilizzando RDP o il tuo metodo preferito.
3. In Windows, con le autorizzazioni di amministratore, apri la shell di Google Cloud CLI o un'altra interfaccia a riga di comando.
4. Copia i file di installazione di SAP HANA Studio e lo strumento di estrazione SAPCAR dal bucket di archiviazione alla VM inserendo il comando gsutil cp nell'interfaccia di comando. Ad esempio:
```
gsutil cp gs://[SOURCE_BUCKET]/IMC_STUDIO2_232_0-80000323.SAR C:\[TARGET_DIRECTORY] &
gsutil cp gs://[SOURCE_BUCKET]/SAPCAR_1014-80000938.EXE C:\[TARGET_DIRECTORY]
```
5. Cambia la directory nella directory di destinazione.
```
cd C:\[TARGET_DIRECTORY]
```
6. Esegui il programma SAPCAR per estrarre il file di installazione di SAP HANA Studio.
```
SAPCAR_1014-80000938.EXE -xvf IMC_STUDIO2_232_0-80000323.SAR
```
7. Esegui il programma hdbinst estratto per installare SAP HANA Studio.

Configura il monitoraggio per SAP HANA

Facoltativamente, puoi monitorare le istanze SAP HANA utilizzando l'agente per SAP di Google Cloud. Dalla versione 2.0, puoi configurare l'agente per raccogliere le metriche di monitoraggio di 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 utilizzando l'agente per SAP di Google Cloud, consulta Raccolta delle metriche di monitoraggio di SAP HANA.

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 del bastion utilizzando SSH o tramite il server Windows mediante SAP HANA Studio.

Per connetterti a SAP HANA tramite il bastion, esegui la connessione al bastion host, 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 eseguire la connessione all'istanza di Windows Server. Dopo la connessione, installa SAP HANA Studio manualmente 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.

Modifica le password temporanee dell'amministratore di sistema e del super user del database SAP HANA. Ad esempio:
```
sudo passwd SIDadm
```
Vedi Reimpostare la password utente SYSTEM del database di sistema.
Installa la licenza SAP HANA permanente. In caso contrario, SAP HANA potrebbe entrare in blocco del database alla scadenza della licenza temporanea.

Per maggiori informazioni da SAP sulla gestione delle licenze SAP HANA, consulta Chiavi di licenza per il database SAP HANA.
Aggiorna il software SAP HANA con le patch più recenti.
Se il deployment del tuo sistema SAP HANA è stato eseguito 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 complessiva della rete nell'interfaccia di rete VirtIO senza influire sulla latenza di rete.
Installa eventuali componenti aggiuntivi, ad esempio Application Function Libraries (AFL) o Smart Data Access (SDA).
Configura ed esegui il backup del tuo nuovo database SAP HANA. Per ulteriori informazioni, consulta la guida alle operazioni di SAP HANA.

Valuta il tuo carico di lavoro SAP HANA

Per automatizzare i controlli di convalida continua 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 in base alle best practice dei fornitori di SAP, Google Cloud e di sistemi operativi. Ciò consente di migliorare qualità, prestazioni e 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 sulla creazione e sull'esecuzione di una valutazione utilizzando Gestore carichi di lavoro, consulta Creare ed eseguire una valutazione.

Passaggi successivi

Se devi utilizzare il servizio NetApp Cloud Volumes per Google Cloud anziché i dischi permanenti per le directory SAP HANA, consulta le informazioni sul deployment del servizio Cloud Volumes NetApp nella Guida alla pianificazione di Sap HANA.
Per ulteriori informazioni sull'amministrazione e sul monitoraggio delle VM, consulta la Guida operativa di Sap HANA.