Guide d'installation de l'agent Backint de Cloud Storage pour SAP HANA

Important : Pour les nouvelles installations, au lieu d'utiliser l'agent Backint de Cloud Storage pour SAP HANA, nous vous recommandons d'utiliser son successeur, l'agent Google Cloud pour SAP. À partir de la version 3.0, l'agent Google Cloud pour SAP combine la collecte de métriques de l'agent hôte SAP avec d'autres fonctionnalités, telles que la sauvegarde et la récupération basées sur Backint pour SAP HANA.

Si vous utilisez l'agent Backint, nous vous recommandons de passer à la version 3.2 (la plus récente) de l'agent Google Cloud pour SAP dès que possible, et avant l'arrêt de la compatibilité de l'agent Backint. Pour obtenir des instructions de mise à niveau, consultez Passer à l'agent Google Cloud pour SAP à partir d'autres agents Google Cloud.

La compatibilité de Backint ne sera plus assurée à compter de février 2025. Cet agent n'est pas compatible avec les types de machines Compute Engine accessibles à tous depuis février 2024.

Ces instructions vous montrent comment installer et configurer l'agent Cloud Storage Backint pour SAP HANA (agent Backint).

Pour plus d'informations sur les options de configuration de l'agent Backint, consultez la page Présentation de l'agent Backint de Cloud Storage pour SAP HANA.

Prérequis

Avant de pouvoir installer l'agent Backint, vous devez d'abord installer SAP HANA. Pour installer SAP HANA sur Google Cloud, consultez le guide de déploiement de SAP HANA.

Pour en savoir plus sur l'installation de SAP HANA sur solution Bare Metal, consultez le guide de planification de SAP HANA sur solution Bare Metal.

Si la VM hôte n'a pas accès à Internet, vous devez configurer l'accès privé à Google pour que l'agent Backint puisse accéder aux API Google Cloud. Pour configurer l'accès privé à Google, consultez la section Configurer l'accès privé à Google.

Remarque : Si vous devez installer l'agent Backint sur un hôte qui n'est ni une machine virtuelle (VM) Compute Engine ni une machine Bare Metal, créez un incident avec l'assistance SAP dans le composant BC-OP-LNX-GOOGLE afin que SAP et Google Cloud puissent évaluer votre configuration.

Créer un bucket Cloud Storage destiné aux sauvegardes

Avant de pouvoir configurer l'agent Backint, vous devez créer un bucket Cloud Storage pour stocker les sauvegardes.

Pour créer un bucket Cloud Storage, utilisez la console Google Cloud.

Pour en savoir plus sur les options des buckets, consultez la page Stocker des sauvegardes dans des buckets Cloud Storage.

1. Ouvrez le navigateur Cloud Storage dans la console Google Cloud.

   Ouvrir le navigateur Cloud Storage

2. Cliquez sur CRÉER UN BUCKET.

3. Nommez votre bucket, puis cliquez sur Continuer.

4. Suivez les instructions pour sélectionner vos options de bucket.

   Remarque: Les options de chiffrement présentées dans la console Google Cloud lors de la création du bucket s'appliquent généralement aux objets au repos dans le bucket. L'agent Backint fournit des options de chiffrement supplémentaires pour vos sauvegardes indépendantes des options de chiffrement de bucket.

5. Cliquez sur Créer.

6. Pour configurer les autorisations relatives au bucket, cliquez sur l'onglet "Autorisations". Par défaut, en tant que propriétaire, vous disposez d'un accès en lecture-écriture sur le bucket. Vous pouvez également autoriser d'autres comptes principaux à accéder à votre bucket.

Installer l'agent Backint sur l'hôte SAP HANA

L'agent Backint s'installe dans le même système de fichiers partagé que la base de données SAP HANA.

Dans un déploiement SAP HANA soumis à un scaling horizontal, vous devez installer l'agent Backint sur chaque nœud du système. Pour simplifier l'administration, vous pouvez stocker vos fichiers de configuration dans un emplacement partagé accessible à tous les nœuds de votre déploiement, tel que /hana/shared.

1. Connectez-vous à votre hôte SAP HANA par SSH. Si votre hôte est une VM Compute Engine, cliquez sur le bouton SSH de votre instance de VM sur la page Instances de VM ou utilisez votre méthode SSH préférée.

2. Connectez-vous en tant qu'administrateur du système SAP HANA.

   sudo su - SID_LCadm
   

3. Téléchargez et installez l'agent Backint.

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Remarque : Si vous mettez à jour une instance existante de l'agent Backint vers une nouvelle version, suivez les instructions de la section Mettre à jour l'agent Backint vers une version nouvelle version

   Le script install.sh effectue les actions suivantes :

   • Il installe l'agent Backint en tant que fichier JAR dans /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Téléchargement d'une version compatible de l'environnement d'exécution Java
   • Configure le script backint qui appelle l'agent Backint. Ne modifiez pas le script backint, sauf si l'assistance Cloud Customer Care vous le demande.
   • Une fois l'opération terminée, envoie un message qui vous invite à mettre à jour le fichier parameters.txt et à configurer l'authentification. Pour en savoir plus, consultez la section Configurer l'agent Backint et SAP HANA.

4. Si vous vous trouvez dans l'une des situations suivantes, vous devez créer un compte de service pour l'agent Backint :

   • Vous avez besoin de l'agent Backint pour utiliser un ensemble d'autorisations de ressources différent de celui utilisé par votre VM Compute Engine hôte.
   • SAP HANA s'exécute sur la solution Bare Metal.
   • SAP HANA ne s'exécute pas sur Google Cloud.

   Pour créer un compte de service pour l'agent Backint, procédez comme suit :

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

      Accéder à la page "Comptes de service"

   2. Sélectionnez votre projet Google Cloud.

   3. Cliquez sur Créer un compte de service.

   4. Spécifiez un nom pour le compte de service et, éventuellement, une description.

   5. Cliquez sur Create and continue (Créer et continuer).

   6. Cliquez sur Continuer pour créer le compte de service sans autorisations.

   7. Le cas échéant, accordez aux autres utilisateurs l'accès au compte de service.

   8. Cliquez sur OK.

   9. Sur la page Comptes de service de la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous venez de créer.

   10. Sous le nom du compte de service, cliquez sur l'onglet Clés.

   11. Cliquez sur le menu déroulant Ajouter une clé, puis sélectionnez Créer une clé pour créer une clé de compte de service.

   12. Acceptez JSON comme type de clé, puis cliquez sur Create (Créer). Une clé privée est enregistrée sur votre ordinateur.

5. Importez le fichier de clé JSON sur l'hôte SAP HANA.

   • Stockez le fichier .json dans un répertoire auquel l'utilisateur SID_LCadm peut accéder (par exemple, /usr/sap/SID/home).
   • Assurez-vous que l'utilisateur SID_LCadm est autorisé à lire le fichier.

6. Mettez à jour le bucket Cloud Storage pour accorder au compte de service l'autorisation d'utiliser le bucket :

   1. Cliquez sur le nom de votre bucket dans le navigateur Cloud Storage.

      Ouvrir le navigateur Cloud Storage

   2. Cliquez sur l'onglet Autorisations.

   3. Cliquez sur Ajouter des comptes principaux.

   4. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail complète du compte de service. Exemple :

      [e-mail]

   5. Cliquez sur la liste déroulante Sélectionnez un rôle, puis saisissez "Administrateur des objets Storage".

   6. Cliquez sur Enregistrer.

Configurer l'agent Backint et SAP HANA

Pour configurer l'agent Backint, spécifiez des paramètres dans un fichier de configuration en texte brut.

Vous pouvez utiliser la même configuration pour tous les types de sauvegarde (données, journaux et catalogues), ou utiliser une configuration différente pour chaque type de sauvegarde en créant un fichier de configuration distinct pour chacun d'eux.

Spécifiez le chemin d'accès à chaque fichier de configuration de l'agent Backint dans SAP HANA en spécifiant des paramètres dans le fichier global.ini.

1. Configurez l'agent Backint en spécifiant les paramètres dans le fichier parameters.txt. Vous pouvez renommer le fichier selon vos besoins.

   1. Utilisez la méthode de votre choix pour modifier le fichier parameters.txt. Le fichier est installé dans le répertoire suivant.

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      

      Vous pouvez renommer le fichier parameters.txt et utiliser des fichiers de configuration différents pour les sauvegardes de données, de journaux et de catalogues.

      Pour obtenir une description des paramètres de configuration, ainsi que des recommandations de performances, consultez la section Options de configuration pour l'agent Backint.

   2. Indiquez le nom du bucket Cloud Storage à utiliser pour les sauvegardes.

      #BUCKET bucket-name
      

   3. Si vous avez créé un compte de service et une clé privée pour l'agent Backint, spécifiez le chemin d'accès au fichier de clé JSON.

      #SERVICE_ACCOUNT /path/key-file-name.json

   L'exemple suivant montre le contenu d'un fichier parameters.txt valide. Notez que # dans cet exemple fait partie de la syntaxe et ne signifie pas que la ligne est un commentaire.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. Facultatif: configurez l'agent Backint pour contourner ou utiliser un proxy pour les sauvegardes et les récupérations. Par défaut, l'agent Backint contourne les proxys HTTP.

   Avertissement :Le routage des sauvegardes via un proxy a un impact négatif sur les performances et la fiabilité de l'ensemble du trafic du proxy pendant l'envoi ou la récupération des sauvegardes depuis Cloud Storage. Google Cloud recommande vivement que l'agent Backint contourne les proxys HTTP.

   Les requêtes adressées au serveur de métadonnées de l'instance doivent toujours contourner le serveur proxy HTTP. Utilisez les paramètres de proxy http ou https requis par le serveur proxy.

   Pour spécifier les paramètres du serveur proxy pour l'agent Backint, modifiez le fichier /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

   Par exemple, la configuration suivante spécifie un serveur proxy HTTPS :

   http.proxyHost=proxy-host
   http.proxyPort=proxy-port
   http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
   https.proxyHost=proxy-host
   https.proxyPort=proxy-port
   

   Pour en savoir plus sur l'utilisation de l'agent Backint avec un proxy, consultez la section Proxys et agent Backint.

3. Configurez SAP HANA pour utiliser l'agent Backint :

   1. Utilisez SAP HANA Studio ou SAP HANA Cockpit pour définir les paramètres suivants dans la section backup du fichier de configuration global.ini sur les valeurs indiquées dans le tableau. Vous n'avez pas besoin de redémarrer SAP HANA après avoir effectué ces modifications.

      Si vous utilisez un fichier de configuration différent pour chaque type de sauvegarde, spécifiez les différents fichiers de configuration comme indiqué dans le tableau suivant. Sinon, spécifiez le même fichier de configuration pour tous les types.

      Paramètre	Valeur
      catalog_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint	true
      data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint	true

   2. Utilisez SAP HANA Studio pour attribuer la même valeur aux paramètres basepath_catalogbackup et basepath_logbackup de la section persistence du fichier global.ini. Exemple :

      

4. Testez l'installation en créant une sauvegarde dans le bucket Cloud Storage et en effectuant une restauration à partir de la sauvegarde.

5. Pour exploiter la fonction de mise à jour automatique de l'agent Backint, activez les requêtes HTTP distantes depuis la VM SAP HANA vers https://www.googleapis.com/.

6. Vous pouvez également activer Cloud Logging.

   • Si SAP HANA est en cours d'exécution sur une VM Compute Engine, ajoutez le gestionnaire com.google.cloud.logging.LoggingHandler à la propriété com.google.cloud.partners.handlers dans le fichier /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties.
   • Si SAP HANA est exécuté en dehors de Google Cloud, installez Google Cloud CLI et configurez la connexion par défaut de l'application à l'aide de la commande gcloud auth application-default login.

Mettre à jour l'agent Backint vers une nouvelle version

Avant de mettre à jour l'agent Backint vers une nouvelle version dans votre environnement de production, veillez à tester la nouvelle version dans un environnement hors production. Pour en savoir plus sur les fonctionnalités de l'agent Backint, consultez les notes de version associées à cette version.

Pour mettre à jour l'agent Backint vers une nouvelle version :

1. Assurez-vous qu'aucune sauvegarde de données n'est en cours ou planifiée pour la période qui chevauche la mise à jour.

2. Désactivez les sauvegardes automatiques des journaux en définissant le paramètre SAP HANA enable_auto_log_backup sur no. Pour obtenir des instructions, consultez la page Activer et désactiver la sauvegarde automatique des journaux dans la documentation SAP HANA.

3. Activez les requêtes HTTP distantes de l'hôte SAP HANA sur https://www.googleapis.com/.

4. En tant que SID_LCadm sur l'hôte SAP HANA, installez la nouvelle version :

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   Le script update.sh effectue les actions suivantes :

   • Il installe la nouvelle version de l'agent Backint dans /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Met à jour le script backint pour appeler la nouvelle version de l'agent Backint.
   • Met à jour le numéro de version dans VERSION.txt.
   • Stocke le script update.sh en local dans /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Il envoie un message à la fin de l'opération.

   Le processus de mise à jour ne modifie ni ne remplace votre fichier parameters.txt existant. Pour utiliser les nouvelles options introduites dans la nouvelle version, vous devez ajouter les paramètres correspondants à votre fichier parameters.txt existant.

   Le processus de mise à jour laisse l'ancienne version de l'agent Backint dans le répertoire /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs, afin que vous puissiez revenir à l'ancienne version si nécessaire.

5. Activez les sauvegardes automatiques des journaux en définissant le paramètre SAP HANA enable_auto_log_backup sur yes. Pour obtenir des instructions, consultez la page Activer et désactiver la sauvegarde automatique des journaux dans la documentation SAP HANA.

6. Surveillez votre système pour détecter les sauvegardes réussies.

Revenir à une version précédente

Si vous rencontrez des problèmes avec une nouvelle version de l'agent Backint et que l'assistance Google Cloud ou SAP vous recommande de revenir à votre version précédente, vous pouvez le faire en modifiant le fichier de script backint.

Vous n'avez pas besoin de supprimer les paramètres que vous avez éventuellement ajoutés pour la nouvelle version dans le fichier parameters.txt. La version précédente de l'agent Backint ignore les paramètres de la version la plus récente.

Pour revenir à une version précédente, procédez comme suit :

1. En tant que SID_LCadm, ouvrez le script backint pour le modifier. Exemple :

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint

2. Remplacez le nom du fichier JAR de l'agent Backint par le nom du fichier JAR de la version précédente.

   Par exemple, si vous revenez de la version 1.0.6 à la version 1.0.4, vous devez modifier les éléments suivants :

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar

   to:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

3. Ouvrez le fichier VERSION.txt pour le modifier et spécifiez le numéro de version précédent. Vous devez le faire pour que le mécanisme de mise à jour sache quelle version vous exécutez.

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt

4. Testez l'agent Backint en déclenchant une sauvegarde.

Dépannage

Pour résoudre les problèmes liés à l'agent Backint pour SAP HANA, consultez la page Dépannage de l'agent Backint pour SAP HANA.

Obtenir de l'aide pour l'agent Backint

Si vous avez besoin d'aide pour résoudre un problème lié à l'agent Backint pour SAP HANA, rassemblez les informations de diagnostic nécessaires et contactez Cloud Customer Care. Pour en savoir plus, consultez la section Informations de diagnostic de l'agent Backint pour SAP HANA.