Guida all'installazione e alle operazioni del connettore per LaMa

Questa guida illustra l'installazione e la configurazione del connettore Google Cloud per la gestione del paesaggio SAP (connettore per LaMa), nonché le attività operative dopo l'installazione del connettore.

Per installare e configurare il connettore per LaMa, svolgi i seguenti passaggi di alto livello:

  • Configura l'autenticazione e l'autorizzazione per le API Google Cloud.
  • Scarica l'archivio di installazione da Google Cloud.
  • Installa il connettore per LaMa sullo stesso host di SAP Landscape Management. L'host può essere una macchina virtuale (VM) Compute Engine o una macchina virtuale o fisica non su Google Cloud.
  • Configura la funzionalità Cloud Manager per Google Cloud in SAP Landscape Management.
  • Installa i file delle librerie di archiviazione e delle operazioni su ogni VM che ospita un sistema SAP da gestire con SAP Landscape Management.

Prerequisiti

Prima di poter installare il connettore per LaMa, devi installare e configurare una versione supportata di SAP Landscape Management. Per le versioni supportate, vedi Requisiti software.

Installa SAP Landscape Management in base alle guide di installazione di SAP Landscape Management e ai principi di progettazione adattiva di SAP Landscape Management.

Per ulteriori informazioni, vedi:

Configurare l'autenticazione e l'autorizzazione per le API Google Cloud

Devi configurare i certificati CA e, se hai bisogno di controllo dell'accesso più stringente, un account di servizio IAM.

Carica i certificati CA per la comunicazione con l'API Google

Il connettore per LaMa richiede certificati CA appropriati per comunicare con le API Google Cloud. Assicurati che i seguenti certificati siano disponibili nella visualizzazione CA attendibili della visualizzazione dello spazio di archiviazione dell'archivio chiavi Java di SAP NetWeaver:

  • GTS CA 1C3
  • WR2
  1. Vai al repository di Google Trust Services all'indirizzo https://pki.goog/repository/

  2. Nella sezione Scarica i certificati CA in Autorità di certificazione subordinate, scarica i certificati CA GTS CA 1C3 e WR2. Tieni presente che il certificato WR2 ha sostituito il certificato GTS CA 1C3 nel 2024 per alcune API.

  3. Importa i certificati seguendo le istruzioni riportate nella documentazione di SAP NetWeaver: Utilizzo dell'archivio chiavi Java di AS.

Creare un account di servizio IAM

A meno che tu non intenda utilizzare l'account di servizio dell'istanza VM di hosting come account di servizio predefinito, devi creare un account di servizio IAM per il connettore per LaMa.

Per creare un account di servizio per il connettore per LaMa:

  1. Nella console Google Cloud, vai alla pagina Account di servizio:

    Vai a Service account

  2. Selezionare il tuo progetto Google Cloud.

  3. Fai clic su Crea account di servizio.

  4. Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.

  5. Fai clic su Crea e continua.

  6. Nel passaggio Concedi a questo account di servizio l'accesso al progetto, concedi all'account di servizio un ruolo contenente tutte le autorizzazioni richieste da SAP Landscape Management. Un ruolo può essere un ruolo predefinito, come Compute Admin, o un ruolo personalizzato creato che contiene le autorizzazioni elencate in Autorizzazioni risorse IAM richieste per il connettore per LaMa.

  7. Fai clic su Fine.

  8. Nella pagina Account di servizio della console Google Cloud, fai clic sull'account di servizio appena creato.

  9. Sotto il nome dell'account di servizio, fai clic sulla scheda Chiavi.

  10. Fai clic sul menu Aggiungi chiave e seleziona Crea nuova chiave per creare una chiave dell'account di servizio.

  11. Accetta JSON come tipo di chiave e fai clic su Crea. Una chiave privata viene salvata sul tuo computer. Archivia il file della chiave JSON in un luogo sicuro. In un secondo momento, quando configuri la funzione Cloud Manager SAP Landscape Management, copia e incolla i contenuti del file della chiave in SAP Landscape Management.

Impostare la JVM in modo che utilizzi la versione 4 del protocollo internet

Utilizza lo strumento Java System Properties di SAP Netweaver Administrator o lo strumento SAP NetWeaver Config per specificare -Djava.net.preferIPv4Stack=true nei parametri di sistema JVM.

Quando viene specificato -Djava.net.preferIPv4Stack=true, SAP NetWeaver utilizza solo IPv4 (Internet Protocol versione 4).

Per ulteriori informazioni, consulta il Requisito del protocollo internet versione 4 (IPv4).

Scarica il connettore per LaMa

Scarica il connettore per LaMa da Google Cloud in un tar file, gcp-connectorversion.tar, che contiene i seguenti file:

  • Il connettore per LaMa in un file Java Enterprise Archive, lvm.cloud.gcp-version.ear.
  • La libreria di archiviazione del sistema operativo Cloud Manager:
    • Per Linux: libsapacosprep_gcp-version.so
    • Per Windows: libsapacosprep_gcp-version.dll
  • Definizioni di operazioni personalizzate per Google Cloud.
  • Script di operazioni corrispondenti alle definizioni di operazioni.

Per scaricare la versione più recente di Connector per LaMa, contatta assistenza clienti Google Cloud. Per trovare i dati di contatto dell'assistenza clienti, vai alla pagina Panoramica dell'assistenza nella console Google Cloud. Per ulteriori informazioni, consulta la pagina Assistenza per SAP su Google Cloud.

Con il file tar compresso, Google Cloud fornisce anche un asc file di firma, gcp-connectorversion.tar.asc, che puoi utilizzare per verificare che il file gcp-connectorversion.tar sia stato scaricato correttamente.

Archivia il file tar in un bucket Cloud Storage accessibile sia al server SAP Landscape Management sia ai server da gestire oppure caricalo tramite la funzione di caricamento di Cloud Shell come descritto in Trasferimento di file nelle istanze.

Installa il connettore per LaMa sul server SAP Landscape Management

Per installare il connettore per LaMa, esegui il deployment di un file EAR in SAP NetWeaver e configura un Cloud Manager per Google Cloud in SAP Landscape Management.

Deployment del connettore per LaMa su SAP NetWeaver

Installa il file EAR contenente il connettore per LaMa utilizzando uno dei seguenti metodi di deployment Java di SAP NetWeaver (è obbligatorio un account utente SAP):

Configurazione della funzionalità Cloud Manager in SAP Landscape Management

Dopo aver installato il connettore per LaMa, nell'interfaccia di SAP Landscape Management, configura la funzionalità Cloud Manager per Google Cloud.

La procedura generale per la configurazione di Cloud Manager è documentata da SAP in Configurazione di Cloud Manager.

I passaggi che seguono sono specifici per la configurazione di un Cloud Manager per Google Cloud.

Per configurare un nuovo Cloud Manager per Google Cloud, segui i seguenti passaggi di configurazione:

  1. In SAP Landscape Management, vai a Infrastruttura di SAP Landscape Management > Gestione cloud.
  2. Crea un nuovo gestore cloud facendo clic su Aggiungi.
  3. Dall'elenco dei tipi di Cloud Manager installati, scegli Adattatore Google Cloud.
  4. Nella sezione Proprietà di base:
    • Nel campo Etichetta, inserisci un nome per Cloud Manager per Google Cloud.
    • In Intervallo di monitoraggio, accetta il valore predefinito di 300 secondi.
    • Lascia vuoti tutti gli altri campi.
  5. Se utilizzi un account di servizio dedicato per Connector for LaMa, incolla i contenuti del file della chiave JSON dell'account di servizio nel campo Account di servizio della sezione Proprietà aggiuntive.
  6. Se utilizzi l'account di servizio della VM per Connector for LaMa, lascia vuoto Account di servizio.
  7. Esegui "Testa configurazione" per convalidare le impostazioni e verificare la connessione agli URL dell'API Google Cloud.
  8. Scegli Avanti e Salva nel nuovo Cloud Manager.

Le voci nelle visualizzazioni Virtualizzazione e Gestore archiviazione vengono create automaticamente.

È possibile modificare solo la configurazione di Cloud Manager. La modifica è disattivata nelle altre visualizzazioni.

Configurazione del supporto per gli indirizzi IP duplicati

Se le reti interne all'ambiente SAP gestito includono indirizzi IP duplicati, configura SAP Landscape Management in modo da utilizzare nomi host completi per mappare i sistemi SAP gestiti.

Per utilizzare nomi host completi, nelle impostazioni di monitoraggio di SAP Landscape Management, selezionate la casella di controllo Utilizza solo nomi host FQDN. Per ulteriori informazioni, vedi Configurare le impostazioni di monitoraggio.

Installa l'agente di Google Cloud per SAP

Per l'assistenza e il monitoraggio, Google Cloud fornisce l'agente per SAP per i carichi di lavoro SAP in esecuzione su istanze Compute Engine e server Bare Metal Solution.

Come stabilito da SAP, per ricevere assistenza da SAP e consentire a SAP di rispettare i suoi contratti di livello del servizio (SLA), devi installare l'agente di Google Cloud per SAP su tutte le istanze Compute Engine e i server Bare Metal Solution che eseguono qualsiasi sistema SAP. Per ulteriori informazioni sui prerequisiti per l'assistenza, consulta la Nota SAP 2456406 - SAP on Google Cloud Platform: Support Prerequisites.

La versione 3.6 (ultima) dell'agente di Google Cloud per SAP è il successore dell'agente di monitoraggio di Google Cloud per SAP NetWeaver versione 2, dell'agente di monitoraggio per SAP HANA versione 2 e dell'agente Backint di Cloud Storage per SAP HANA. Pertanto, oltre alla raccolta delle metriche, la versione 3.6 (la più recente) dell'agente di Google Cloud per SAP include la funzionalità facoltativa: Backup e recupero basati su Backint per SAP HANA. Puoi attivare queste funzionalità che consentono di utilizzare prodotti e servizi come Workload Manager per i tuoi workload SAP.

Installa l'agente di Google Cloud per SAP sull'host insieme al sistema SAP. Per istruzioni su come installare e configurare l'agente, convalidare l'installazione e verificare che l'agente funzioni come previsto, consulta Installare l'agente su un'istanza Compute Engine.

Se utilizzi le seguenti immagini del sistema operativo RHEL o SLES "for SAP" fornite da Google Cloud, l'agente di Google Cloud per SAP è pacchettizzato con le immagini del sistema operativo:

  • RHEL: tutte le immagini "per SAP"
  • SLES: SLES 15 SP4 for SAP e versioni successive

Installa la libreria di archiviazione del sistema operativo e le definizioni di operazioni sulle VM gestite

Il file gcp-connectorversion.tar include una libreria di archiviazione del sistema operativo e definizioni di operazioni con gli script corrispondenti.

Devi installare la libreria di archiviazione del sistema operativo e i file di operazioni su ogni istanza VM gestita da SAP Landscape Management.

Per installare una libreria di archiviazione del sistema operativo e le definizioni di operazioni su una VM gestita da SAP Landscape Management:

  1. Scarica o copia il file gcp-connectorversion.tar nella VM di destinazione.
  2. Estrai i file nel file gcp-connectorversion.tar in una directory temporanea.
  3. Esegui lo script di installazione:

    • Su Linux, inserisci:
      sudo bash install.sh
    • Su Windows, con privilegi amministrativi, inserisci:
      install.cmd

    Lo script di installazione copia la libreria di archiviazione del sistema operativo nella directory dell'agente host SAP attivo, /usr/sap/hostctrl/exe e i file di operazioni in una sottodirectory, /operations.d. Lo script imposta la proprietà del file su root:sapsys e imposta i diritti di accesso appropriati per ogni tipo di file.

    file ./storage/libsapacosprep_gcp-2.2.15.96.so copied to /usr/sap/hostctrl/exe/libsapacosprep_gcp.so
    file ./storage/Operations/AcActivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcActivateIP
    file ./storage/Operations/AcDeactivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcDeactivateIP
    file ./storage/Operations/ActivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/ActivateIP.sh
    file ./storage/Operations/DeactivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/DeactivateIP.sh

Gestire i sistemi SAP su Google Cloud con SAP Landscape Management

Dopo aver installato il connettore per LaMa e aver configurato la funzione Cloud Manager in SAP Landscape Management, puoi utilizzare SAP Landscape Management per gestire i sistemi SAP su Google Cloud. Per informazioni su come utilizzare SAP Landscape Management, consulta la documentazione di SAP Landscape Management, Enterprise Edition.

Aggiornamento da una release precedente

Per aggiornare il connettore per LaMa da una versione precedente, segui i seguenti passaggi.

  1. In SAP Landscape Management, esegui il backup di tutte le configurazioni esistenti di Cloud Manager per Google Cloud prima di aggiornare il connettore per LaMa. Per ulteriori informazioni, consulta la sezione Esportare i dati di configurazione.
  2. Reinstalla il connettore per LaMa. Per le istruzioni, vedi Eseguire il deployment del Connector per LaMa su SAP NetWeaver.
  3. Sostituisci le librerie di archiviazione e i file di operazioni del sistema operativo esistenti nei sistemi gestiti seguendo le istruzioni riportate in Installazione della libreria di archiviazione del sistema operativo e delle definizioni di operazioni.
  4. Dopo il deployment, riavvia SAP Landscape Management.

Risoluzione dei problemi

Per impostazione predefinita, il sistema SAP Landscape Management opera su Google Cloud utilizzando l'identità di un account di servizio IAM. Se si verificano errori di autorizzazione, prova prima a utilizzare i comandi gcloud per eseguire la stessa azione che riceve l'errore dal sistema operativo guest. Ad esempio:

Azione di gestione del landscape SAP Comando gcloud equivalente
Interrompi/avvia gcloud compute instances stop/start
Clona gcloud compute disks snapshot
gcloud compute disks create
Trasferire gcloud compute instances attach-disk
gcloud compute instances detach-disk

L'output comando gcloud ti indica se mancano autorizzazioni per eseguire una determinata azione. Se l'operazione va a buon fine, ma l'errore persiste, contatta l'assistenza come descritto nella sezione seguente.

Assistenza

Se riscontri problemi con il funzionamento del tuo sistema di gestione del paesaggio SAP e hai bisogno di aiuto per risolverli, registra un messaggio di assistenza tramite il portale di assistenza SAP nel componente BC-VCM-LVM.

Se stabilisci che la causa principale del problema è nel Connector for LaMa, seleziona il sottocomponente BC-VCM-LVM-GOOGLE. Tuttavia, se hai dubbi sulla causa di un problema, scegli il componente BC-VCM-LVM, in modo che l'assistenza SAP possa analizzare prima il problema.

Informazioni da includere:

  • La versione di SAP Landscape Management
  • La versione del connettore per LaMa
  • La versione del kernel di SAP NetWeaver
  • La versione del sistema SAP gestito, inclusa la versione dell'agente host
  • Una descrizione del comportamento previsto