Guida all'installazione e alle operazioni del connettore per LaMa

Questa guida illustra l'installazione e la configurazione Connettore Google Cloud per SAP Landscape Management (Connector for LaMa), nonché attività operative dopo il connettore è già installato.

Per installare e configurare Connector per LaMa, devi eseguire seguenti passaggi generali:

  • Configura l'autenticazione e l'autorizzazione nelle 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 di una macchina virtuale o fisica non su Google Cloud.
  • Configura la funzionalità Cloud Manager per Google Cloud in SAP Landscape Management.
  • Installa la libreria di archiviazione e i file delle operazioni su ogni VM che ospita un Sistema SAP da gestire con SAP Landscape Management.

Prerequisiti

Prima di poter installare Connector 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 un controllo dell'accesso più rigido, un account di servizio IAM.

Carica i certificati CA per la comunicazione delle API di Google

Il connettore per LaMa richiede certificati CA appropriati per comunicare con le API Google Cloud. Assicurati che i seguenti certificati siano disponibile nella visualizzazione delle CA attendibili di SAP NetWeaver Java KeyStore Storage visualizza:

  • 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.

Crea 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 predefinito, ad esempio Compute Admin o un ruolo personalizzato creato da te che contiene elencate in Autorizzazioni IAM richieste per le risorse per Connector for 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.

Imposta la JVM per l'utilizzo di Internet Protocol versione 4

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 maggiori informazioni, vedi Requisito del protocollo Internet versione 4 (IPv4).

Scarica il connettore per LaMa

Scarichi 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 delle operazioni che corrispondono alle definizioni delle operazioni.

Per scaricare la versione più recente di Connector per LaMa, contatta il team di assistenza clienti di 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 il bucket Cloud Storage a cui è possibile accedere il server SAP Landscape Management e i server da gestire o caricare tramite la funzione di caricamento di Cloud Shell, come descritto Trasferimento di file alle istanze.

Installa il connettore per LaMa sul server SAP Landscape Management

Per installare Connector for LaMa, esegui il deployment di un file EAR in SAP NetWeaver e configurare 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, in SAP Landscape Management di Cloud Manager, configurerai la funzionalità Cloud Manager in 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 Google Cloud Adattatore.
  4. Nella sezione Proprietà di base:
    • Nel campo Etichetta, inserisci il nome di Cloud Manager per in 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 il campo Service Account (Account di servizio).
  7. Esegui "configurazione di test" per convalidare le impostazioni e testare connessione agli URL dell'API Google Cloud.
  8. Scegli Avanti e Salva in un 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.

Configurare il supporto per gli indirizzi IP duplicati

Se le reti interne all'interno del tuo panorama SAP gestito includono elementi Indirizzi IP, 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, Seleziona la casella di controllo Use FQDN Hostnames Only (Utilizza solo nomi host FQDN). Per ulteriori informazioni, consulta Configurazione delle impostazioni di Monitoring.

Installa l'agente 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 VM Compute Engine e server Bare Metal Solution.

Come richiesto da SAP, per ottenere supporto da SAP e consentire a SAP di soddisfare accordi sul livello del servizio (SLA), devi installare l'agente di Google Cloud per SAP su tutte le istanze VM di Compute Engine e i server Bare Metal Solution che eseguono qualsiasi sistema SAP. Per ulteriori informazioni sui prerequisiti dell'assistenza, vedi SAP Note 2456406 - SAP su Google Cloud Platform: prerequisiti di assistenza di Google.

La versione 3.6 (più recente) dell'agente Google Cloud per SAP è la successore dell'agente di monitoraggio di Google Cloud per SAP NetWeaver versione 2, l'agente Monitoring per SAP HANA versione 2 e l'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 abilitano prodotti e servizi quali come Gestore dei carichi di lavoro per i tuoi carichi di lavoro 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 VM 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: tutto "per SAP" immagini
  • 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 i relativi script.

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 delle operazioni su una VM: gestito da SAP Landscape Management:

  1. Scarica o copia l'gcp-connectorversion.tar alla 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 alla directory dell'agente host SAP attivo, /usr/sap/hostctrl/exe e i file delle operazioni in una sottodirectory, /operations.d. Lo script imposta la proprietà dei 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 l'installazione di Connector for LaMa e 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 SAP Landscape Management, versione enterprise documentazione.

Aggiornamento da una release precedente

Per aggiornare il connettore per LaMa da una versione precedente, esegui la 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 funziona su Google Cloud mediante 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 panorama SAP Comando gcloud equivalente
Arresta/avvia gcloud compute instances stop/start
Clona gcloud compute disks snapshot
gcloud compute disks create
Trasferisci gcloud compute instances attach-disk
gcloud compute instances detach-disk

L'output del 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 paesaggistica SAP di cui hai bisogno di aiuto per risolvere registrare un messaggio di assistenza tramite SAP Support Portal nel componente BC-VCM-LVM.

Se ritieni che la causa principale del problema sia Connettore per LaMa, selezionare il sottocomponente BC-VCM-LVM-GOOGLE; ma Se non sei sicuro della causa di un problema, scegli il componente BC-VCM-LVM, in modo che il supporto 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 SAP NetWeaver
  • La versione del sistema SAP gestito, inclusa la versione di l'agente host
  • Una descrizione del comportamento previsto