Questa pagina è stata tradotta dall'API Cloud Translation.

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. La guida ti aiuta a configurare le macchine virtuali (VM) e i dischi permanenti di Compute Engine, nonché il sistema operativo Linux, per ottenere le migliori prestazioni per il tuo sistema SAP HANA. Il file di configurazione Terraform incorpora le best practice di Compute Engine e SAP.

Utilizza questa guida per eseguire il deployment di un sistema SAP HANA con scale up a host singolo o multi-host che non include host in standby.

Se devi includere il failover automatico dell'host SAP HANA, consulta invece la guida Terraform: SAP HANA scale out del sistema con deployment automatico di failover 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:

Hai letto la guida alla pianificazione di SAP HANA.
Devi disporre di un account e di un progetto Google Cloud.
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 networking Virtual Private Cloud è configurato con regole firewall o altri metodi per controllare l'accesso alle VM.
Hai accesso ai file multimediali di installazione di SAP HANA.
Se l'accesso al sistema operativo è abilitato nei metadati di progetto e stai eseguendo il deployment di nodi a scalabilità orizzontale, 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 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, vedi:
- Attivare o disattivare OS Login
- Aggiungere 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 già uno.
(Facoltativo) 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.
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 di progetto. In questo modo puoi accedere a qualsiasi istanza VM di Compute Engine creata all'interno di questo progetto, ad eccezione delle istanze che disabilitano in modo esplicito 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 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.
Connessioni SSH all'istanza VM, tra cui SSH nel browser.
Connessione alla VM mediante uno strumento di terze parti in Linux. Crea una regola per consentire l'accesso allo strumento tramite il firewall.

Per creare le regole firewall per il tuo progetto, consulta Creazione di 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 Compute Engine, devi caricare i file di installazione che contengono i file binari SAP HANA in un bucket Cloud Storage.

Terraform richiede i file di installazione 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 SAP HANA, devi creare un bucket Cloud Storage, quindi caricare i file nel bucket come segue:

Scarica i file di installazione di base per la versione 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 By Alphabetical Index (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 carrello.
  
  Nota: ti consigliamo di scaricare la revisione più recente del service pack più recente.
Se il tuo account del portale di assistenza SAP non consente l'accesso al software e ritieni di avere diritto al software, contatta il SAP Global Support Customer Interaction Center.
Scarica i file richiesti per eseguire l'upgrade del database SAP HANA alla versione richiesta. Questi file sono in formato SAR e i nomi dei file 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 di assistenza e patch.
4. Fai clic su By Alphabetical Index (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 carrello.
Nota: non è necessario scaricare i file 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 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, in qualità di proprietario del bucket, hai accesso in lettura e scrittura al bucket. Per concedere l'accesso ad altre entità, consulta Utilizzo delle autorizzazioni IAM.
Carica i file binari SAP HANA scaricati nel bucket Cloud Storage o in una cartella nel bucket. Per le istruzioni, consulta Caricamento di oggetti da un file system.

Assicurati che il bucket o la cartella contenga 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 le risorse binarie SAP. Dovrai utilizzarli in un secondo momento durante l'installazione di 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. Devi 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.

Verifica che le quote attuali per risorse 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 di SAP HANA, consulta Considerazioni su prezzi e quote per SAP HANA.

Vai a Quote
Apri Cloud Shell o, se hai installato Google Cloud CLI sulla 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 di Cloud Shell o, se utilizzi il terminale, l'editor di testo che preferisci.

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.tf, aggiorna i seguenti valori di argomento sostituendo le parentesi e i relativi contenuti con i valori per la tua installazione.

Alcuni dei valori di argomento specificati per il sistema SAP HANA, ad esempio i valori per sap_hana_sid, sap_hana_sidadm_password o sap_hana_system_password, sono soggetti alle regole definite da SAP. Per ulteriori informazioni, consulta il riferimento sui 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 la sezione 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`	String	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 è 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`.
`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.
`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`.
`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`.
`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.
`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_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_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_scaleout_nodes`	Integer	Specifica il numero di host worker di cui hai bisogno nel tuo sistema di scale out. Per eseguire il deployment di un sistema a scalabilità orizzontale, hai bisogno di almeno un host worker. Terraform crea gli host worker oltre all'istanza SAP HANA principale. Ad esempio, se specifichi `3`, nel tuo sistema di scale out verrà eseguito il deployment di quattro istanze SAP HANA.
`sap_hana_shared_nfs`	String	Facoltativo. Per un deployment a scalabilità orizzontale multi-host che utilizza una soluzione NFS per condividere il volume `/hana/shared` con gli host worker, specifica il punto di montaggio NFS per quel volume. Ad esempio, `10.151.91.122:/hana_shared_nfs`. Per maggiori informazioni, consulta Soluzioni di condivisione file per deployment di scale out multi-host. Questo argomento è disponibile nella versione del modulo `sap_hana` `202302060649` o successiva. 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	Facoltativo. Per un deployment a scalabilità orizzontale multi-host che utilizza una soluzione NFS per condividere il volume `/hanabackup` con gli host worker, specifica il punto di montaggio NFS per quel volume. Ad esempio, `10.216.41.122:/hana_backup_nfs`. Per maggiori informazioni, consulta Soluzioni di condivisione file per deployment di scale out multi-host. Questo argomento è disponibile nella versione del modulo `sap_hana` `202302060649` o successiva.
`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 file per deployment di scale out multi-host. Questo argomento è disponibile nella versione del modulo `sap_hana` `202302060649` o successiva.
`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 file per deployment di scale out multi-host. Questo argomento è disponibile nella versione del modulo `sap_hana` `202302060649` o successiva.
`sap_hana_backup_size`	Integer	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`	Integer	Facoltativo. Esegue l'override dell'ID gruppo predefinito per `sapsys`. Il valore predefinito è `79`.
`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`. Nei deployment con scale up di SAP HANA, viene eseguito anche il deployment di un disco permanente bilanciato separato per la directory `/hana/shared`. 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/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`.
`include_backup_disk`	Booleano	Facoltativo. Questo argomento è applicabile ai deployment di scale up di SAP HANA. Il valore predefinito è `true` e indica a Terraform di eseguire il deployment di un disco separato per ospitare la directory `/hanabackup`. Il tipo di disco è determinato dall'argomento `backup_disk_type`. La dimensione di questo disco è determinata dall'argomento `sap_hana_backup_size`. Se imposti il valore per `include_backup_disk` su `false`, non verrà eseguito il deployment di alcun disco per la directory `/hanabackup`.
`backup_disk_type`	String	Facoltativo. Per i deployment con scale up, specifica il tipo di Persistent Disk o Hyperdisk di cui vuoi eseguire il deployment per il volume `/hanabackup`. 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`, `pd-standard`, `hyperdisk-extreme`, `hyperdisk-balanced` e `pd-extreme`. Questo argomento è disponibile nella `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 nella `sap_hana` versione del modulo `202309280828` o successive.
`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` 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` 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 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 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 il valore latest.
```
terraform init --upgrade 
```
Facoltativamente, per creare il piano di esecuzione Terraform:
```
terraform plan
```
Il comando terraform plan mostra le modifiche richieste dalla configurazione corrente. Se salti 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 di Google Cloud, quindi richiama un altro script che configura il sistema operativo e installa 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.

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

Verifica del deployment in corso...

Per verificare il deployment, controlla i log di deployment in Cloud Logging e controlla 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 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.

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 oppure utilizzare il metodo SSH che preferisci.
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 esistono volumi per /hana/shared e /hanabackup perché questi volumi sono ospitati su istanze di 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 del 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 sull'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 su SAP, consulta SAP Note 3108316 - Red Hat Enterprise Linux 9.x: installazione e configurazione .

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.

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

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. Per farlo, potresti dover abilitare l'accesso di rete alle VM di destinazione da SAP HANA Studio.

Per installare SAP HANA Studio su una VM Windows su 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 riportati sopra impostano variabili per la sessione Cloud Shell corrente, crea un server Windows nella subnet creata in precedenza e crea una regola firewall che consenta l'accesso dalla tua workstation locale all'istanza tramite il Remote Desktop Protocol (RDP).

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 dell'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 con la tua 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 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.

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 tramite 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 per l'amministratore di sistema e il super user del database SAP HANA. Ad esempio:
```
sudo passwd SIDadm
```
Vedi Reimpostare la password utente SYSTEM del database di sistema.
Installa la tua licenza SAP HANA permanente. In caso contrario, SAP HANA potrebbe essere sottoposto al blocco del database dopo la scadenza della licenza temporanea.

Per ulteriori informazioni da SAP sulla gestione delle tue licenze SAP HANA, consulta Chiavi di licenza per il 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).
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

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