Guide d'installation et d'utilisation du connecteur pour LaMa

Ce guide couvre l'installation et la configuration du connecteur Google Cloud pour SAP Landscape Management (connecteur pour LaMa), ainsi que les tâches opérationnelles après l'installation du connecteur.

Pour installer et configurer le connecteur pour LaMa, procédez comme suit :

Configurer l'authentification et l'autorisation sur les API Google Cloud
Téléchargez l'archive d'installation depuis Google Cloud.
Installez le connecteur pour LaMa sur le même hôte que SAP Landscape Management. L'hôte peut être une machine virtuelle (VM) Compute Engine ou une machine virtuelle ou physique qui ne se trouve pas sur Google Cloud.
Configurez la fonctionnalité Cloud Manager pour Google Cloud dans SAP Landscape Management.
Installez la bibliothèque de stockage et les fichiers d'opérations sur chaque VM qui héberge un système SAP à gérer par SAP Landscape Management.

Prérequis

Avant de pouvoir installer le connecteur pour LaMa, vous devez installer et configurer une version compatible de SAP Landscape Management. Pour connaître les versions compatibles, consultez la section Configuration logicielle requise.

Installez SAP Landscape Management conformément aux guides d'installation de SAP Landscape Management et aux principes de conception adaptative de SAP Landscape Management.

Pour en savoir plus, consultez les pages suivantes :

Configurer l'authentification et l'autorisation pour les API Google Cloud

Vous devez configurer des certificats CA et, si vous avez besoin d'un contrôle d'accès plus strict, un compte de service IAM.

Importer un certificat CA pour la communication avec les API Google

Le connecteur pour LaMa nécessite des certificats d'autorité de certification appropriés pour communiquer avec les API Google Cloud. Vérifiez que les certificats suivants sont disponibles dans la vue des autorités de certification de confiance de la vue de stockage Java Keystore SAP NetWeaver :

GTS CA 1C3
WR2

Accédez au dépôt Google Trust Services à l'adresse https://pki.goog/repository/.
Dans la section Télécharger les certificats CA, sous CA subordonnées, téléchargez les certificats CA GTS CA 1C3 et WR2. Notez que le certificat WR2 a remplacé le certificat GTS CA 1C3 en 2024 pour certaines API.
Importez le certificat en suivant les instructions de la documentation SAP NetWeaver : Utiliser le service de stockage de clés Java AS.

Créer un compte de service IAM

À moins que vous n'ayez l'intention d'utiliser le compte de service de l'instance de VM hôte comme compte de service par défaut, vous devez créer un compte de service IAM pour le connecteur pour LaMa.

Pour créer un compte de service pour le connecteur pour LaMa, procédez comme suit :

Dans la console Google Cloud, accédez à la page Comptes de service.

Accéder à la page "Comptes de service"
Sélectionnez votre projet Google Cloud.
Cliquez sur Créer un compte de service.
Spécifiez un nom pour le compte de service et, éventuellement, une description.
Cliquez sur Create and continue (Créer et continuer).
À l'étape Autoriser ce compte de service à accéder au projet, attribuez-lui un rôle contenant toutes les autorisations requises par SAP Landscape Management. Un rôle peut être un rôle prédéfini, tel que Compute Admin, ou un rôle personnalisé que vous créez et qui contient les autorisations répertoriées dans la section Autorisations de ressources IAM requises pour le connecteur pour LaMa.
Cliquez sur OK.
Sur la page Comptes de service de la console Google Cloud, cliquez sur le compte de service que vous venez de créer.
Sous le nom du compte de service, cliquez sur l'onglet Clés.
Cliquez sur le menu Ajouter une clé, puis sélectionnez Créer une clé pour créer une clé de compte de service.
Acceptez JSON comme type de clé, puis cliquez sur Create (Créer). Une clé privée est enregistrée sur votre ordinateur. Stockez le fichier de clé JSON dans un endroit sûr. Ensuite, lorsque vous configurez la fonction SAP Landscape Management pour Cloud Manager, vous copiez et collez le contenu du fichier de clé dans SAP Landscape Management.

Configurer la JVM de sorte qu'elle utilise la version 4 du protocole Internet

Utilisez l'outil Propriétés système Java de l'administrateur SAP NetWeaver ou l'outil de configuration SAP NetWeaver pour spécifier -Djava.net.preferIPv4Stack=true dans les paramètres système JVM.

Lorsque -Djava.net.preferIPv4Stack=true est spécifié, SAP NetWeaver n'utilise que le protocole Internet version 4 (IPv4).

Pour en savoir plus, consultez Configuration requise pour le protocole IPv4 (Internet Protocol version 4).

Télécharger le connecteur pour LaMa

Vous téléchargez le connecteur pour LaMa à partir de Google Cloud dans un fichier tar, gcp-connectorversion.tar, qui contient les fichiers suivants :

Connecteur pour LaMa dans un fichier d'archive Java Enterprise, lvm.cloud.gcp-version.ear.
La bibliothèque de stockage du système d'exploitation Cloud Manager :
- Pour Linux : libsapacosprep_gcp-version.so
- Pour Windows : libsapacosprep_gcp-version.dll
Définitions d'opérations personnalisées pour Google Cloud.
Scripts d'opération correspondant aux définitions d'opération.

Pour télécharger la dernière version du connecteur pour LaMa, contactez Cloud Customer Care. Pour trouver les coordonnées du service client, accédez à la page Présentation de l'assistance dans la console Google Cloud. Pour plus d'informations, consultez la page Obtenir de l'aide concernant SAP sur Google Cloud.

Avec le fichier tar compressé, Google Cloud fournit également un fichier de signature asc, gcp-connectorversion.tar.asc, que vous pouvez utiliser pour confirmer que le fichier gcp-connectorversion.tar a été téléchargé correctement.

Stockez le fichier tar dans un bucket Cloud Storage accessible à la fois au serveur SAP Landscape Management et aux serveurs à gérer, ou importez-le via la fonction d'importation Cloud Shell, comme décrit dans la section Transférez des fichiers vers des instances.

Installer le connecteur pour LaMa sur le serveur SAP Landscape Management

Pour installer le connecteur pour LaMa, vous devez déployer un fichier EAR sur SAP NetWeaver et configurer un gestionnaire Cloud pour Google Cloud dans SAP Landscape Management.

Déployer le connecteur pour LaMa sur SAP NetWeaver

Installez le fichier EAR contenant le connecteur pour LaMa à l'aide de l'une des méthodes de déploiement Java SAP NetWeaver suivantes (un compte utilisateur SAP est requis) :

Configurer la fonctionnalité Cloud Manager dans SAP Landscape Management

Après avoir installé le connecteur pour LaMa, dans l'interface SAP Landscape Management, vous configurez la fonctionnalité Cloud Manager pour Google Cloud.

La procédure générale de configuration de Cloud Manager est décrite par SAP dans la section Configurer des Cloud Manager.

Les étapes suivantes sont spécifiques à la configuration d'un Cloud Manager pour Google Cloud.

Pour configurer un nouveau gestionnaire Cloud pour Google Cloud, procédez comme suit :

Dans SAP Landscape Management, accédez à SAP Landscape Management Infrastructure > Cloud Managers.
Créez un nouveau gestionnaire Cloud en cliquant sur Ajouter.
Dans la liste des types Cloud Manager installés, choisissez Google Cloud Adapter.
Dans la section Propriétés de base :
- Dans le champ "Libellé", saisissez un nom pour Cloud Manager pour Google Cloud.
- Dans l'intervalle Monitoring, acceptez la valeur par défaut de 300 secondes.
- Laissez tous les autres champs vides.
Si vous utilisez un compte de service dédié pour un connecteur pour LaMa, collez le contenu du fichier de clé JSON du compte de service dans le champ Compte de service de la section Propriétés supplémentaires.
Si vous utilisez le compte de service de la VM pour un connecteur pour LaMa, laissez le champ Service Account (Compte de service) vide.
Effectuez une "test configuration" pour valider les paramètres et tester la connexion aux URL de l'API Google Cloud.
Sélectionnez Suivant et Enregistrer dans le nouveau Cloud Manager.

Les entrées des vues Virtualisation et Gestionnaire d'espace de stockage sont créées automatiquement.

Seule la configuration Cloud Manager peut être modifiée. la modification est désactivée dans les autres vues.

Configurer la compatibilité avec les adresses IP en double

Si les réseaux internes de votre environnement SAP géré incluent des adresses IP en double, configurez SAP Landscape Management pour qu'il utilise des noms d'hôte complets pour mapper les systèmes SAP gérés.

Pour utiliser des noms d'hôte complets, dans les paramètres de surveillance de SAP Landscape Management, cochez la case Utiliser les noms d'hôte complets uniquement. Pour en savoir plus, consultez la section Configurer les paramètres de surveillance.

Installer l'agent Google Cloud pour SAP

Pour l'assistance et la surveillance, Google Cloud fournit l'agent pour SAP pour les charges de travail SAP exécutées sur des instances de VM Compute Engine et des serveurs de solution Bare Metal.

Conformément à la demande de SAP, vous devez installer l'agent Google Cloud pour SAP sur toutes les instances de VM Compute Engine et tous les serveurs de solution Bare Metal qui exécutent un système SAP afin de bénéficier de l'assistance de SAP et de permettre à SAP de respecter ses contrats de niveau de service. Pour en savoir plus sur les conditions préalables à l'assistance, consultez la Note SAP 2456406 - SAP on Google Cloud Platform: Support Prerequisites (SAP sur Google Cloud Platform : prérequis pour l'assistance).

La version 3.5 (la plus récente) de l'agent Google Cloud pour SAP est le successeur de l'agent de surveillance de Google Cloud pour SAP NetWeaver version 2, de l'agent de surveillance pour SAP HANA version 2 et de l'agent Backint Cloud Storage pour SAP HANA. Par conséquent, en plus de la collecte de métriques, la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP inclut la fonctionnalité facultative suivante : Sauvegarde et récupération basées sur Backint pour SAP HANA. Vous pouvez activer ces fonctionnalités pour activer des produits et des services, tels que la gestion des charges de travail, pour vos charges de travail SAP.

Installez l'agent Google Cloud pour SAP sur l'hôte conjointement au système SAP. Pour savoir comment installer et configurer l'agent, valider votre installation et vérifier que l'agent s'exécute comme prévu, consultez Installer l'agent sur une instance de VM Compute Engine.

Si vous utilisez les images "pour SAP" suivantes des OS RHEL ou SLES, fournies par Google Cloud, l'agent Google Cloud pour SAP sera empaqueté avec les images d'OS :

RHEL : toutes les images "for SAP"
SLES : SLES 15 SP4 pour SAP et versions ultérieures

Installer la bibliothèque de stockage du système d'exploitation et les définitions des opérations sur les VM gérées.

Le fichier gcp-connectorversion.tar inclut une bibliothèque de stockage du système d'exploitation et des définitions d'opération avec leurs scripts correspondants.

Vous devez installer la bibliothèque de stockage du système d'exploitation et les fichiers des opérations sur chaque instance de VM gérée par SAP Landscape Management.

Pour installer une bibliothèque de stockage du système d'exploitation et des définitions d'opération sur une VM gérée par SAP Landscape Management :

Téléchargez ou copiez le fichier gcp-connectorversion.tar dans la VM cible.
Extrayez les fichiers du fichier gcp-connectorversion.tar dans un répertoire temporaire.

Exécutez le script d'installation :

Sous Linux, saisissez la commande suivante :
```
sudo bash install.sh
```
Sous Windows, avec des droits d'administrateur, saisissez :
```
install.cmd
```

Le script d'installation copie la bibliothèque de stockage du système d'exploitation dans le répertoire de l'agent hôte SAP actif, /usr/sap/hostctrl/exe, et les fichiers d'opérations dans un sous-répertoire, /operations.d. Le script définit la propriété des fichiers sur root:sapsys et définit les droits d'accès appropriés pour chaque type de fichier.

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

Gérez les systèmes SAP sur Google Cloud avec SAP Landscape Management

Une fois que le connecteur pour LaMa est installé et que la fonction Cloud Manager est configurée dans SAP Landscape Management, vous pouvez gérer les systèmes SAP sur Google Cloud à l'aide de SAP Landscape Management. Pour en savoir plus sur l'utilisation de SAP Landscape Management, consultez la documentation sur SAP Landscape Management, édition Enterprise.

Mettre à jour à partir d'une version antérieure

Pour mettre à jour le connecteur pour LaMa à partir d'une version précédente, procédez comme suit.

Dans SAP Landscape Management, sauvegardez toutes les configurations Cloud Manager existantes pour Google Cloud avant de mettre à jour le connecteur pour LaMa. Pour en savoir plus, consultez la page Exporter des données de configuration.
Réinstallez le connecteur pour LaMa. Pour obtenir des instructions, consultez la page Déploiement du connecteur pour LaMa sur SAP NetWeaver.
Remplacez les bibliothèques de stockage d'OS et les fichiers d'opérations existants dans les systèmes gérés en suivant les instructions de la section Installer la bibliothèque de stockage du système d'exploitation et les définitions des opérations.
Après le déploiement, redémarrez SAP Landscape Management.

Dépannage

Par défaut, le système SAP Landscape Management fonctionne sur Google Cloud à l'aide de l'identité d'un compte de service IAM. Si vous rencontrez des erreurs d'autorisation, essayez d'abord d'utiliser les commandes gcloud pour effectuer la même action que celle qui reçoit l'erreur depuis le système d'exploitation invité. Exemple :

Action SAP Landscape Management	Commande `gcloud` équivalente
Démarrer/Arrêter	`gcloud compute instances stop/start`
Cloner	`gcloud compute disks snapshot` `gcloud compute disks create`
Déplacer	`gcloud compute instances attach-disk` `gcloud compute instances detach-disk`

Le résultat de la commande gcloud vous indique s'il vous manque des autorisations pour exécuter une action particulière. Si cela fonctionne, mais que votre erreur persiste, contactez l'assistance comme décrit dans la section suivante.

Assistance

Si vous rencontrez des problèmes avec le fonctionnement de votre système SAP Landscape Management, veuillez envoyer un message d'assistance via le portail d'assistance SAP sous le composant BC-VCM-LVM.

Si vous déterminez que la cause du problème est dans le connecteur pour LaMa, sélectionnez le sous-composant BC-VCM-LVM-GOOGLE. Toutefois, si vous n'êtes pas sûr de la cause du problème, choisissez le composant BC-VCM-LVM, afin que l'assistance SAP puisse l'analyser en premier.

Informations à ajouter

La version de SAP Landscape Management
La version du Connecteur pour LaMa
Version du noyau SAP NetWeaver
La version du système SAP géré, y compris la version de l'agent hôte
Description du comportement attendu