Configurer la sauvegarde et la récupération basées sur Backint pour SAP HANA

Ce guide vous explique comment configurer l'agent Google Cloud pour SAP afin d'effectuer des sauvegardes et des récupérations basées sur Backint pour SAP HANA.

Pour obtenir des informations conceptuelles sur cette fonctionnalité, qui peuvent vous aider à planifier votre implémentation, consultez la section Sauvegarde et récupération pour SAP HANA à l'aide de Backint.

Pour savoir comment créer des sauvegardes basées sur Backint et récupérer votre SAP HANA à l'aide de celles-ci, consultez Sauvegarder et récupérer SAP HANA à l'aide de Backint.

Avant de commencer

  • Validez votre installation de la version 3.6 (la plus récente) de l'agent Google Cloud pour SAP. Pour obtenir des instructions, consultez le guide d'installation pour votre scénario.
  • Si vous avez installé l'agent sur un serveur de solution Bare Metal, assurez-vous de remplir les conditions préalables requises et de configurer un compte de service. Pour obtenir des instructions, consultez Configurer l'agent Google Cloud pour SAP sous Linux.
  • Si votre base de données SAP HANA s'exécute dans un environnement sur site, veillez à configurer un compte de service et sa clé. Pour savoir comment procéder, consultez Configurer l'agent Google Cloud pour SAP sous Linux.
  • Si vous devez activer cette fonctionnalité pour une instance de l'agent Google Cloud pour SAP qui s'exécute sur un hôte autre qu'une instance Compute Engine ou un serveur de solution Bare Metal, vous devez créer un incident avec l'assistance SAP dans le composant BC-OP-LNX-GOOGLE afin que SAP et Google Cloud puissent évaluer votre configuration.
  • Installez SAP HANA :

Créer un bucket Cloud Storage

Avant d'activer la fonctionnalité Backint de l'agent Google Cloud pour SAP, assurez-vous qu'il existe un bucket Cloud Storage pour stocker vos sauvegardes. Si vous disposez d'un bucket Cloud Storage, vous pouvez ignorer cette section.

Pour en savoir plus sur le stockage de sauvegardes dans des buckets Cloud Storage, consultez Stocker des sauvegardes dans des buckets Cloud Storage.

Pour créer un bucket Cloud Storage :

console Google Cloud

  1. In the Google Cloud console, go to the Cloud Storage Buckets page.

    Go to Buckets page

  2. Click Create bucket.
  3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
    • For Name your bucket, enter a name that meets the bucket naming requirements.
    • For Choose where to store your data, do the following:
      • Select a Location type option.
      • Select a Location option.
    • For Choose a default storage class for your data, select a storage class.
    • For Choose how to control access to objects, select an Access control option.
    • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
  4. Click Create.

Ligne de commande

    Create a Cloud Storage bucket and configure it as follows:
    • Remplacez STORAGE_CLASS par la classe de stockage de votre choix.
    • Remplacez LOCATION par l'emplacement de votre choix (ASIA, EU ou US)
    • Remplacez BUCKET_NAME par Ce nom doit respecter les exigences relatives aux noms de buckets. 
      • gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Définir des rôles IAM

Pour permettre à l'agent Google Cloud pour SAP d'effectuer des opérations de sauvegarde et de récupération pour SAP HANA, vous devez vous assurer que le compte de service utilisé par votre instance Compute Engine ou votre serveur de solution Bare Metal inclut le rôle IAM Administrateur des objets de l'espace de stockage (storage.objectAdmin).

Pour ajouter ce rôle à votre compte de service, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page IAM.

    Accéder à IAM

  2. Sélectionnez votre projet Google Cloud.

  3. Identifiez le compte de service auquel vous souhaitez ajouter le rôle.

    • Si ce compte de service ne figure pas déjà sur la liste des comptes principaux, cela signifie qu'aucun rôle ne lui a encore été attribué. Cliquez sur Ajouter, puis saisissez l'adresse e-mail du compte de service.
    • Si le compte de service figure déjà sur la liste des comptes principaux, il possède des rôles. Cliquez sur le bouton Modifier correspondant au compte de service que vous souhaitez modifier.

  4. Dans la liste des rôles disponibles, sélectionnez Administrateur des objets de l'espace de stockage.

  5. Cliquez sur Ajouter ou sur Enregistrer pour appliquer le ou les rôles sélectionnés au compte de service.

Pour un niveau d'accès précis, vous pouvez définir les autorisations IAM suivantes sur votre rôle personnalisé pour votre compte de service au niveau du projet:

  • storage.objects.list
  • storage.objects.create

Vous devez également définir des stratégies IAM sur votre bucket en accordant à votre principal les autorisations IAM suivantes:

  • storage.objects.get
  • storage.objects.update
  • storage.objects.delete

Ajoutez les autorisations suivantes si vous souhaitez effectuer des importations multiparties:

  • storage.multipartUploads.create
  • storage.multipartUploads.abort

Pour en savoir plus sur la création d'un rôle personnalisé, consultez la page Créer et gérer les rôles personnalisés. Pour en savoir plus sur l'attribution d'un rôle personnalisé à un compte principal pour un accès au niveau du bucket, consultez la section Ajouter un compte principal à une stratégie au niveau du bucket.

Activer l'accès aux API et aux serveurs de métadonnées Cloud

L'agent Google Cloud pour SAP nécessite l'accès aux adresses IP et aux hôtes Google Cloud suivants lors des opérations de sauvegarde et de récupération :

  • Pour accéder à Cloud Storage, storage.googleapis.com.
  • Pour le serveur de métadonnées d'instance Compute Engine :
    • oauth2.googleapis.com, pour l'authentification.
    • 169.254.169.254
    • metadata.google.internal

Si l'agent Google Cloud pour SAP et votre système SAP HANA s'exécutent sur une instance Compute Engine qui n'a pas accès à Internet, vous devez configurer l'accès privé à Google pour que l'agent puisse interagir avec Cloud Storage et, si vous utilisez un compte de service dédié, s'authentifier auprès de Google Cloud. Pour obtenir des instructions, consultez Configurer l'accès privé à Google.

Activer la fonctionnalité Backint

Pour activer la fonctionnalité Backint de l'agent Google Cloud pour SAP, procédez comme suit :

  1. Connectez-vous à votre hôte SAP HANA par SSH.

    Si votre hôte est une instance Compute Engine, cliquez sur le bouton SSH de votre instance sur la page Instances de VM de la console Google Cloud, ou utilisez la méthode SSH de votre choix.

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

    sudo su - SID_LCadm

    Remplacez SID_LC par le SID. Utilisez des minuscules pour toutes les lettres.

    Cette commande définit également plusieurs variables d'environnement, y compris $SAPSYSTEMNAME, qui est définie avec le SID de votre base de données SAP HANA.

  3. Activez la fonctionnalité Backint pour l'agent Google Cloud pour SAP :

    /usr/bin/google_cloud_sap_agent installbackint

    Sinon, pour installer les fichiers associés à Backint sur un hôte avec un autre SID, incluez l'option sid :

    /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

    Remplacez DIFFERENT_SID_LC par le SID de l'instance SAP HANA requise. Utilisez des minuscules pour toutes les lettres.

    Une fois la commande exécutée, tous les fichiers liés à la fonctionnalité Backint de l'agent Google Cloud pour SAP sont installés dans le répertoire /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Cela inclut les fichiers nécessaires à l'intégration de l'agent avec SAP HANA. Il détecte également l'agent Backint de Cloud Storage pour SAP HANA sur votre hôte, le désactive et copie ses fichiers dans un répertoire récupérable sur votre hôte. Pour en savoir plus, consultez Mettre à niveau depuis l'agent Backint.

  4. Configurez la fonctionnalité Backint :

    Exécuter la commande

    • Si votre base de données SAP HANA s'exécute sur une instance Compute Engine ou un serveur de solution Bare Metal, exécutez la commande configurebackint pour configurer la fonctionnalité Backint de l'agent. Nous recommandons cette approche plutôt que de modifier le fichier de configuration Backint de l'agent.

      /usr/bin/google_cloud_sap_agent configurebackint \
 -f="PATH_TO_PARAMETERS_FILE" \
 -bucket="BUCKET_NAME"

    • Si votre base de données SAP HANA s'exécute dans un environnement sur site, configurez la fonctionnalité Backint de l'agent en exécutant la commande suivante:

      /usr/bin/google_cloud_sap_agent configurebackint \
 -f="PATH_TO_PARAMETERS_FILE" \
 -bucket="BUCKET_NAME" \
 -service_account_key="PATH_TO_KEY" \
 -log_to_cloud=false \
 -send_metrics_to_monitoring=false

      Remplacez les éléments suivants :

      • PATH_TO_PARAMETERS_FILE : chemin d'accès à votre fichier de configuration Backint PARAMETERS.json.
      • BUCKET_NAME: nom du bucket Cloud Storage dans lequel vous souhaitez stocker vos sauvegardes SAP HANA.
      • PATH_TO_KEY: chemin d'accès complet à la clé de compte de service Google Cloud encodée au format JSON que vous avez configurée

    Vous pouvez éventuellement définir d'autres paramètres lors de l'exécution de cette commande. Pour plus d'informations sur ces paramètres, consultez Paramètres de configuration.

    Modifier le fichier de configuration

    Au lieu d'exécuter la commande configurebackint de l'agent, vous pouvez modifier le fichier de configuration Backint comme suit :

    1. Ouvrez le fichier de configuration Backint :

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

      Remplacez SID par le SID du système SAP dans lequel vous avez installé les fichiers associés à Backint.

      Voici un exemple de ce que le fichier de configuration contient :

      {
 "bucket": "",
 "log_to_cloud": true
}

    2. Pour autoriser l'agent Google Cloud pour SAP à effectuer des opérations de sauvegarde et de récupération basées sur Backint pour votre système SAP HANA, modifiez le fichier de configuration, puis spécifiez les paramètres suivants:

      • bucket : spécifiez le nom du bucket Cloud Storage dans lequel vous souhaitez stocker vos sauvegardes SAP HANA.
      • service_account_key : si vous avez créé un compte de service pour l'agent Google Cloud pour SAP, spécifiez le chemin absolu du répertoire de votre hôte sur lequel vous avez importé la clé de compte de service encodée au format JSON correspondant.

      Pour en savoir plus, consultez la section Points à prendre en compte sur les comptes de service.

    3. Si votre base de données SAP HANA s'exécute dans un environnement sur site, veillez également à définir les éléments suivants:

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false

    4. Vous pouvez également si vous le souhaitez modifier d'autres paramètres de configuration. Pour plus d'informations sur ces paramètres, consultez la section Paramètres de configuration.

    5. Enregistrez le fichier de configuration.

Personnaliser le fichier de configuration Backint

Après avoir activé la fonctionnalité Backint de l'agent Google Cloud pour SAP, vous pouvez éventuellement effectuer les personnalisations suivantes :

  • Renommez le fichier parameters.json.

    Pour indiquer ce changement de nom, ce fichier est appelé PARAMETERS.json dans la documentation de l'agent Google Cloud pour SAP.

  • Créez un fichier de configuration distinct pour chacun des éléments suivants : volume de données SAP HANA, volume de journaux SAP HANA et catalogue de sauvegarde SAP HANA.

    Veillez à définir un nom unique pour chaque fichier de configuration.

  • Déplacez ces fichiers de configuration vers un autre répertoire. Par exemple, dans un déploiement à évolutivité horizontale, vous pouvez stocker les fichiers de configuration liés à Backint de tous vos nœuds dans un répertoire partagé accessible aux nœuds. Cela peut vous aider à gérer plus facilement ces fichiers.

Si vous effectuez l'une de ces personnalisations, assurez-vous de spécifier le nom de fichier et son chemin d'accès de manière appropriée pour les paramètres de votre fichier global.ini SAP HANA. Pour obtenir des instructions, consultez Configurer SAP HANA pour la fonctionnalité Backint.

Configurer SAP HANA pour la fonctionnalité Backint

Après avoir activé la fonctionnalité Backint de l'agent Google Cloud pour SAP, vous devez configurer votre système SAP HANA pour utiliser cette fonctionnalité :

  1. Utilisez SAP HANA Studio ou SAP HANA Cockpit pour modifier le fichier de configuration global.ini.

  2. Dans la section backup du fichier global.ini, spécifiez des valeurs pour les paramètres suivants :

    Paramètre Valeur
    data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json.
    parallel_data_backup_backint_channels Pour les sauvegardes de données en multistreaming, spécifiez le nombre de canaux en tenant compte du type de bucket Cloud Storage que vous utilisez, des performances requises et du débit du disque.
    log_backup_using_backint Si vous utilisez un fichier de configuration distinct pour le volume de journaux de sauvegarde SAP HANA, spécifiez la valeur true.
    log_backup_parameter_file

    Si vous utilisez un fichier de configuration distinct pour le volume de journaux de sauvegarde SAP HANA, spécifiez la valeur suivante : /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json.

    Remplacez PARAMETERS_LOG par le nom du fichier de configuration que vous utilisez pour les sauvegardes du volume de journaux SAP HANA.
    catalog_backup_using_backint Si vous utilisez un fichier de configuration distinct pour le catalogue de sauvegarde SAP HANA, spécifiez la valeur true.
    catalog_backup_parameter_file

    Si vous utilisez un fichier de configuration distinct pour le catalogue de sauvegarde SAP HANA, spécifiez la valeur suivante : /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json.

    Remplacez PARAMETERS_CATALOG par le nom du fichier de configuration que vous utilisez pour les sauvegardes du catalogue de sauvegarde SAP HANA.

    Voici un exemple de fichier global.ini configuré pour utiliser la fonctionnalité Backint de l'agent SAP pour Google Cloud :

    [backup]
log_backup_using_backint = true
catalog_backup_using_backint = true
parallel_data_backup_backint_channels = 16
catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

  3. Dans la section persistence du fichier global.ini, spécifiez des valeurs pour les paramètres suivants :

    • basepath_logbackup : spécifiez le répertoire de votre système de fichiers dans lequel SAP HANA peut stocker les sauvegardes de journaux lorsqu'il ne peut pas se connecter à votre bucket Cloud Storage. Assurez-vous que ce répertoire dispose d'assez d'espace pour stocker les sauvegardes.
    • basepath_catalogbackup : spécifiez le répertoire de votre système de fichiers dans lequel SAP HANA peut stocker les sauvegardes du catalogue de sauvegarde SAP HANA lorsqu'il ne peut pas se connecter à votre bucket Cloud Storage. Assurez-vous que ce répertoire dispose d'assez d'espace pour stocker les sauvegardes.

    Les paramètres basepath_catalogbackup et basepath_logbackup possèdent la même valeur dans la section "persistence" du fichier global.ini

Valider la sauvegarde et la récupération

Après avoir activé la fonctionnalité Backint de l'agent Google Cloud pour SAP, veillez à la valider en créant et en restaurant une sauvegarde dans un système de test.

Pour les tests, vous pouvez utiliser l'outil d'autodiagnostic intégré de l'agent. Vous devez disposer d'au moins 18 Go d'espace disque disponible sur votre système de fichiers pour exécuter cet outil intégré. Pour utiliser cet outil intégré afin de valider la sauvegarde et la récupération, exécutez la commande suivante :

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

Remplacez les éléments suivants :

  • IDENTIFIER : valeur qui identifie l'exécution de la commande. Cet identifiant permet de nommer le dossier temporaire créé dans le bucket Cloud Storage lors des diagnostics.
  • PATH_TO_PARAMETERS_FILE : chemin d'accès à votre fichier PARAMETERS.json

Lorsque vous utilisez cet outil, vous pouvez utiliser les paramètres facultatifs diagnose_file_max_size_gb et diagnose_tmp_directory. Pour en savoir plus sur ces paramètres, consultez leur description dans la section Paramètres de configuration.

Si vous avez installé l'agent Backint sur votre hôte, la première fois que vous utilisez l'agent Google Cloud pour SAP pour effectuer une opération de sauvegarde, l'agent Google Cloud pour SAP crée des versions JSON des fichiers de configuration texte. Pour en savoir plus, consultez la section Mettre à niveau depuis l'agent Backint.

Exemple de fichier de configuration

Voici un fichier de configuration PARAMETERS.json complet de la fonctionnalité Backint de l'agent Google Cloud pour SAP :

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

Paramètres de configuration

Le tableau suivant explique les paramètres de configuration de l'agent Google Cloud pour SAP qui sont spécifiques à la fonctionnalité Backint.

Pour plus d'informations sur le mappage entre les paramètres de configuration de l'agent Backint et l'agent Google Cloud pour SAP, consultez Mappage des paramètres de configuration.

Pour en savoir plus sur les paramètres de configuration de l'agent Google Cloud pour SAP, y compris les paramètres liés à la collecte de métriques, consultez le guide d'installation pour votre cas d'utilisation.

Paramètres
bucket

String

Indiquez le nom du bucket Cloud Storage depuis lequel l'agent Google Cloud pour SAP écrit et lit. L'agent crée des objets de sauvegarde avec la classe de stockage du bucket et accepte toutes les classes de stockage. L'agent utilise le chiffrement Compute Engine par défaut pour chiffrer les données au repos.
recovery_bucket

String

Facultatif. Spécifiez le nom du bucket Cloud Storage lu par l'agent lors des opérations RESTORE. Si vous ne spécifiez pas ce paramètre, l'agent utilise le bucket spécifié pour le paramètre bucket pour toutes les opérations : BACKUP, RESTORE, INQUIRE, DELETE et DIAGNOSE.

Bien que nous vous recommandions d'utiliser ce paramètre pour simplifier la gestion de la configuration pour les opérations de copie et de rafraîchissement du système, il est incompatible avec l'argument CHECK ACCESS USING BACKINT lors des opérations de restauration SAP HANA.

log_to_cloud

Boolean

Facultatif. Pour rediriger les journaux liés à Backint de l'agent Google Cloud pour SAP vers Cloud Logging, spécifiez true. La valeur par défaut est true.

Si votre base de données SAP HANA s'exécute dans un environnement sur site, vous devez définir la valeur de ce paramètre sur false.

Pour plus d'informations sur le fichier journal associé à Backint, consultez la section Logging.
log_level

String

Facultatif. Indiquez le niveau de journalisation pour la fonctionnalité Backint de l'agent Google Cloud pour SAP, puis définissez la valeur requise. Les niveaux de journalisation disponibles sont les suivants :

  • DEBUG
  • INFO
  • WARNING
  • ERROR

La valeur par défaut est INFO. Ne modifiez pas le niveau de journalisation, sauf si vous êtes dirigé par le service client Cloud Customer Care.
compress

Boolean

Facultatif. Indiquez si l'agent Google Cloud pour SAP doit activer la compression lors de l'écriture de sauvegardes dans le bucket Cloud Storage. La valeur par défaut est false.

Nous vous recommandons de ne pas activer la compression. Même si la compression réduit le coût de stockage des sauvegardes dans Cloud Storage, elle nécessite davantage d'utilisation du processeur lors des opérations de sauvegarde et ralentit le débit de sauvegarde effectif.

Indépendamment de ce paramètre, l'agent Google Cloud pour SAP accepte les fichiers de sauvegarde compressés et non compressés lors d'opérations de restauration.
encryption_key

String

Facultatif. Spécifiez le chemin d'accès à la clé de chiffrement fournie par le client que vous avez configurée pour utiliser votre bucket Cloud Storage afin de chiffrer les sauvegardes. Veillez à spécifier un chemin d'accès complet vers une clé AES-256 encodée en base64.

Vous ne pouvez pas spécifier le paramètre encryption_key avec les paramètres kms_key ou parallel_streams.
kms_key

String

Facultatif. Spécifiez le chemin d'accès à la clé de chiffrement gérée par le client que vous avez configurée pour utiliser le bucket Cloud Storage afin de chiffrer les sauvegardes. Spécifiez le chemin d'accès en utilisant le format projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME, où :

  • KMS_PROJECT_ID : ID du projet Google Cloud dans lequel la clé KMS existe.
  • LOCATION : emplacement Cloud KMS où votre clé KMS existe.
  • KEY_RING_NAME : nom du trousseau de clés contenant la clé KMS
  • KMS_KEY_NAME : nom de la clé KMS

Si votre système SAP HANA s'exécute sur une instance Compute Engine, la clé doit être accessible à cette instance. Si votre système SAP HANA s'exécute sur un hôte autre qu'une instance Compute Engine, la clé Cloud KMS doit être accessible au compte de service utilisé par l'agent Google Cloud pour SAP. Pour en savoir plus, consultez la page Comptes de service.

Vous ne pouvez pas spécifier le paramètre kms_key avec les paramètres encryption_key ou parallel_streams.
folder_prefix

String

Facultatif. Indiquez cette option pour définir un préfixe pour les dossiers du bucket Cloud Storage que l'agent Google Cloud pour SAP écrit et lit. Vous pouvez utiliser ce paramètre pour organiser les sauvegardes de différentes instances SAP HANA dans le même bucket Cloud Storage. Vous pouvez spécifier un seul dossier, comme folder1, ou un chemin d'accès multiniveau de dossiers, comme folder1/folder2/folder3.

Ce préfixe est inséré en tant que dossier entre les valeurs BUCKET_NAME et SID dans le chemin d'accès pour vos sauvegardes SAP HANA dans Cloud Storage. Pour en savoir plus, consultez la section Personnalisations compatibles.

Ce paramètre est disponible à partir de la version 3.1 de l'agent.
recovery_folder_prefix

String

Facultatif. Indiquez cette option pour définir un préfixe pour les dossiers du bucket Cloud Storage lus par l'agent lors des opérations RESTORE. Vous pouvez utiliser ce paramètre pour organiser les sauvegardes de différentes instances SAP HANA dans le même bucket Cloud Storage. Vous pouvez spécifier un seul dossier, comme folder1, ou un chemin d'accès multiniveau de dossiers, comme folder1/folder2/folder3. Pour en savoir plus, consultez la section Personnalisations compatibles.

Ce paramètre est disponible à partir de la version 3.1 de l'agent.

Bien que nous vous recommandions d'utiliser ce paramètre pour simplifier la gestion de la configuration pour les opérations de copie et de rafraîchissement du système, il est incompatible avec l'argument CHECK ACCESS USING BACKINT lors des opérations de restauration SAP HANA.

shorten_folder_path

Boolean

Facultatif. Spécifiez de manière à raccourcir le chemin d'accès à l'objet dans le bucket Cloud Storage que l'agent lit et écrit lors de toutes les opérations Backint. Pour en savoir plus, consultez la section Personnalisations compatibles.

Ce paramètre est disponible à partir de la version 3.3 de l'agent.
retries

Int

Indique le nombre maximal de nouvelles tentatives d'exécution des échecs de lecture ou d'écriture sur Cloud Storage par l'agent de Google Cloud pour SAP. La valeur par défaut est 5, qui est également la valeur recommandée.
parallel_streams

Int

Facultatif. Spécifiez ce paramètre pour activer l'importation parallèle des sauvegardes dans votre bucket Cloud Storage. La valeur que vous spécifiez pour ce paramètre correspond au nombre maximal de flux d'importation parallèle que l'agent Google Cloud pour SAP peut utiliser. La valeur maximale est 32. Toute valeur supérieure à celle-ci est limitée à 32.

La valeur par défaut est 1, ce qui désactive l'importation parallèle.

Si vous souhaitez activer l'importation parallèle des données par flux ou si votre bucket Cloud Storage dispose d'une règle de conservation, vous devez également définir xml_multipart_upload sur true.

N'activez pas l'importation parallèle dans les cas suivants :

  • Le bucket Cloud Storage cible utilise une règle de conservation.
  • Vous avez spécifié les paramètres encryption_key ou kms_key ;

Si l'une des conditions précédentes est remplie, l'agent se ferme avec l'état 1. Pour en savoir plus sur les importations parallèles, consultez la section Importations parallèles.
xml_multipart_upload

Boolean

Facultatif. Indique si la méthode d'importation en plusieurs parties avec l'API XML est utilisée lors de l'écriture de sauvegardes sur le bucket Cloud Storage. La valeur par défaut est false.

Ce paramètre est disponible à partir de la version 3.2 de l'agent.

Pour utiliser la méthode d'importation en plusieurs parties avec l'API XML, parallel_streams doit avoir une valeur supérieure à 1. Si vous définissez xml_multipart_upload sur true, mais ne spécifiez pas parallel_streams, la valeur 16 est automatiquement attribuée à parallel_streams.

Nous vous recommandons de n'utiliser xml_multipart_upload que pour charger en parallèle les sauvegardes de journaux ou de catalogues. Pour charger les sauvegardes de données en parallèle, nous vous recommandons de définir parallel_data_backup_backint_channels dans la section backup de votre fichier global.ini.

Pour savoir comment créer des fichiers de paramètre distincts pour les sauvegardes des journaux et des données, ou comment définir la valeur de parallel_data_backup_backint_channels, consultez Configurer SAP HANA pour la fonctionnalité Backint.

En cas d'échec, les importations XML en plusieurs parties sont automatiquement annulées et les données importées sont supprimées. Nous vous recommandons également de définir des conditions de cycle de vie pour AbortIncompleteMultipartUpload afin de garantir la suppression des données en cas d'échec de l'opération d'importation.
storage_class

String

Facultatif. Indiquez la classe de stockage utilisée lors de l'écriture de sauvegardes sur le bucket Cloud Storage. Les classes de stockage disponibles sont les suivantes :

  • STANDARD
  • NEARLINE
  • COLDLINE
  • ARCHIVE

La valeur par défaut est STANDARD.

Ce paramètre est disponible à partir de la version 3.2 de l'agent.
metadata

Map<String, String>

Facultatif. Spécifiez les champs clé-valeur à stocker en tant que métadonnées pour les objets lors de l'écriture de sauvegardes sur le bucket Cloud Storage.

Ce paramètre est disponible à partir de la version 3.3 de l'agent.

Voici le format d'un exemple de fichier de configuration PARAMETERS.json:

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

Les métadonnées par défaut écrites sont {"X-Backup-Type": "PIPE"} ou {"X-Backup-Type": "FILE"}, selon le type de fichier.

custom_time

String

Facultatif. Spécifiez une date et une heure à définir pour les métadonnées Custom-Time des sauvegardes que vous importez dans Cloud Storage. Vous devez spécifier la date et l'heure au format indiqué dans Custom-Time.

Ce paramètre est disponible à partir de la version 3.4 de l'agent.

Vous pouvez définir ce paramètre avec la valeur UTCNow, qui définit les métadonnées Custom-Time avec la date et l'heure UTC de la création de la sauvegarde.

À partir de la version 3.6 de l'agent, vous pouvez définir une date future pour les métadonnées Custom-Time à l'aide de UTCNow+NUMBERd. Par exemple, pour définir Custom-Time sur 30 jours à compter de la date de création de la sauvegarde, définissez votre configuration comme suit: 

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

L'exemple suivant montre comment spécifier ce paramètre avec une valeur de date et d'heure dans votre fichier PARAMETERS.json:

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}
rate_limit_mb

Int

Facultatif. Spécifiez la limite supérieure, en Mo, de la bande passante réseau sortante de Compute Engine lors d'opérations de sauvegarde ou de restauration. Par défaut, Google Cloud ne limite pas la bande passante réseau pour l'agent Google Cloud pour SAP. Lorsque vous définissez ce paramètre, le débit peut varier, mais ne dépasse pas la limite spécifiée.
service_account_key

String

Si l'agent Google Cloud pour SAP ne s'exécute pas sur une instance Compute Engine, spécifiez le chemin d'accès complet au compte de service Google Cloud encodé au format JSON. Si l'agent Google Cloud pour SAP s'exécute sur une instance Compute Engine, nous vous recommandons de ne pas spécifier ce paramètre et d'utiliser plutôt l'authentification par défaut de Compute Engine.

Lorsque vous spécifiez ce paramètre, l'agent Google Cloud pour SAP utilise la clé de compte de service lors de l'authentification auprès de Cloud Storage.
diagnose_file_max_size_gb

Int

Facultatif. Spécifiez la limite supérieure de la taille du fichier temporaire, en Go, que l'outil d'autodiagnostic de l'agent crée et supprime. La valeur par défaut est de 16 Go.

Ce paramètre est disponible à partir de la version 3.3 de l'agent.

Pour que l'outil d'autodiagnostic fonctionne correctement, vous devez vous assurer que l'espace de stockage disponible dans votre système de fichiers est d'au moins 2 à 3 Go supérieur à la valeur de diagnose_file_max_size_gb.
diagnose_tmp_directory

String

Facultatif. Spécifiez le répertoire utilisé pour lire et écrire des fichiers temporaires pour l'outil d'autodiagnostic de l'agent. La valeur par défaut est /tmp/backint-diagnose.

Ce paramètre est disponible à partir de la version 3.3 de l'agent.
send_metrics_to_monitoring

Boolean

Facultatif. Indique si l'agent peut collecter des métriques liées à l'état et au débit des fichiers importés ou téléchargés lors des opérations Backint. L'agent envoie les métriques collectées à Cloud Monitoring.

Ce paramètre est disponible à partir de la version 3.3 de l'agent.

La valeur par défaut est true. Si votre base de données SAP HANA s'exécute dans un environnement sur site, vous devez définir la valeur de ce paramètre sur false. Pour en savoir plus sur les métriques associées à Backint, consultez la section Collecte des métriques Backint.
threads

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez le nombre de threads de travail. La valeur par défaut est le nombre de processeurs de l'hôte.
file_read_timeout_ms

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez la durée maximale, en millisecondes, pendant laquelle l'agent Google Cloud pour SAP attend l'ouverture du fichier de sauvegarde. La valeur par défaut est 60000 (60 secondes).
buffer_size_mb

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez ce paramètre pour contrôler la taille des requêtes HTTPS envoyées à Cloud Storage lors d'opérations de sauvegarde ou de restauration. La taille par défaut de la mémoire tampon s'élève à 100 Mo, ce qui signifie qu'un seul flux de requêtes HTTPS en provenance et à destination de Cloud Storage reste ouvert jusqu'au transfert de 100 Mo de données. La taille maximale de la mémoire tampon est de 250 Mo.

Comme l'agent Google Cloud pour SAP effectue plusieurs fois de nouvelles tentatives pour les requêtes HTTPS ayant échoué avant de mettre une opération en échec, des tailles de mémoire tampon inférieures à 100 Mo entraînent une diminution des données devant être retransmises si une requête échoue. Des tailles de mémoire tampon plus importantes peuvent améliorer le débit, mais nécessitent davantage d'utilisation de mémoire et davantage de temps pour renvoyer les données en cas d'échec d'une requête.

Si vous utilisez le paramètre parallel_streams, l'utilisation de mémoire requise doit être multipliée par cette valeur, car chaque flux nécessite son propre tampon pour traiter les requêtes HTTPS.
retry_backoff_initial

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez la valeur initiale, en secondes, de la période de nouvelle tentative utilisée dans les nouvelles tentatives avec intervalle exponentiel entre les tentatives du réseau. La valeur par défaut est 10.
retry_backoff_max

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez la valeur maximale, en secondes, de la période de nouvelle tentative utilisée dans les nouvelles tentatives avec intervalle exponentiel entre les tentatives du réseau. La valeur par défaut est 300.
retry_backoff_multiplier

Float

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez le multiplicateur pour la période de nouvelle tentative utilisée dans les nouvelles tentatives avec intervalle exponentiel entre les tentatives du réseau. Le multiplicateur doit être supérieur à 1, et la valeur par défaut est 2.
log_delay_sec

Int

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez le délai de journalisation, en secondes, pour les informations sur la progression lors des lectures et des écritures dans le bucket Cloud Storage. La valeur par défaut est 60.
client_endpoint

String

Il s'agit d'un paramètre de réglage avancé facultatif. Ne modifiez pas ce paramètre, sauf si le service client vous y invite. Sa valeur par défaut doit rarement être modifiée.

Spécifiez le point de terminaison du client Cloud Storage. La valeur par défaut est storage.googleapis.com.

Dépannage

Pour résoudre les problèmes liés à la version 3.6 (la plus récente) de l'agent Google Cloud pour SAP, consultez le guide de dépannage de l'agent Google Cloud pour SAP.

Obtenir de l'aide

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

Étape suivante