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

Ce guide explique comment configurer l'agent Google Cloud pour SAP afin d'effectuer une sauvegarde et une récupération basées sur Backint pour SAP HANA.

Pour obtenir des informations sur cette fonctionnalité, consultez Sauvegarde et récupération basées sur Backint pour SAP HANA.

Pour obtenir des informations sur l'exécution d'opérations de sauvegarde et de récupération pour SAP HANA à l'aide de Backint, consultez Effectuer une sauvegarde et une récupération à l'aide de Backint.

Avant de commencer

  • Validez votre installation de la version 3.4 (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 vous devez activer cette fonctionnalité pour une instance de l'agent Google Cloud pour SAP exécutée sur un hôte autre qu'une instance de machine virtuelle (VM) Compute Engine ou un serveur de solution Bare Metal, vous devez créer un incident dans l'assistance SAP pour 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 VM 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.

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 de VM Compute Engine :
    • oauth2.googleapis.com, pour l'authentification.
    • 169.254.169.254
    • metadata.google.internal

Si l'agent de Google Cloud pour SAP et votre système SAP HANA s'exécutent sur une VM Compute Engine qui n'a pas accès à Internet, vous devez configurer l'accès privé à Google afin que l'agent puisse interagir avec Cloud Storage et, si vous utilisez un compte de service dédié, s'authentifier avec 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 VM Compute Engine, cliquez sur le bouton SSH de votre instance de VM 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 à SAP HANA. Il détecte également l'agent Backint de Cloud Storage pour SAP HANA sur votre hôte, désactive cet agent 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

    Pour configurer la fonctionnalité Backint de l'agent, exécutez la commande configurebackint. Nous recommandons cette approche plutôt que de modifier le fichier de configuration Backint.

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

    Remplacez les éléments suivants :

    • PATH_TO_PARAMETERS_FILE : chemin d'accès à votre fichier de configuration Backint PARAMETERS.json.
    • BUCKET_NAME : spécifiez le nom du bucket Cloud Storage dans lequel vous souhaitez stocker vos sauvegardes SAP HANA.

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

    4. 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 dans un autre répertoire. Par exemple, dans un déploiement en évolutivité horizontale, vous pouvez stocker les fichiers de configuration associés à Backint de tous vos nœuds dans un répertoire partagé accessible aux nœuds. Cela peut vous aider à gérer ces fichiers plus facilement.

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 des opérations de copie et d'actualisation du système, il n'est pas compatible 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.

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

log_level

String

Facultatif. Spécifiez le niveau de journalisation de la fonctionnalité Backint de l'agent Google Cloud pour SAP et 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'une opération 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 VM Compute Engine, la clé doit être accessible à la VM. Si votre système SAP HANA s'exécute sur un hôte autre qu'une VM Compute Engine, la clé Cloud KMS doit être accessible avec le 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, tel que folder1, ou un chemin d'accès à plusieurs niveaux de dossiers, tel que 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.

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 à plusieurs niveaux, comme folder1/folder2/folder3. Pour en savoir plus, consultez la section Personnalisations compatibles.

Bien que nous vous recommandions d'utiliser ce paramètre pour simplifier la gestion de la configuration des opérations de copie et d'actualisation du système, il n'est pas compatible 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.

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 cet argument pour activer l'importation parallèle des sauvegardes dans votre bucket Cloud Storage. La valeur que vous spécifiez pour cet argument est le 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.

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.

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. 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 écrites par défaut sont {"X-Backup-Type": "PIPE"} ou {"X-Backup-Type": "FILE"}, selon le type de fichier.

custom_time

String

Facultatif. Spécifiez la date et l'heure que vous souhaitez 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 spécifié dans Custom-Time.

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

Voici un exemple de spécification de ce paramètre 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, sans toutefois dépasser la limite spécifiée.

service_account_key

String

Si l'agent Google Cloud pour SAP ne s'exécute pas sur une VM 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 VM Compute Engine, nous vous recommandons de ne pas spécifier ce paramètre et d'utiliser l'authentification Compute Engine par défaut.

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

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 supérieur d'au moins 2 à 3 Go à 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.

send_metrics_to_monitoring

Boolean

Facultatif. Spécifie 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.

La valeur par défaut est true. Pour plus d'informations sur les métriques associées à Backint, consultez la section Collecte de 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 correspond au nombre de processeurs dans 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 des 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 la 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.4 (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.