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 :
- Pour en savoir plus sur l'automatisation de l'installation de SAP HANA sur Google Cloud à l'aide de Terraform, consultez le guide de déploiement correspondant à votre scénario.
- 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.

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

In the Google Cloud console, go to the Cloud Storage Buckets page.
Go to Buckets page
Click Create bucket.
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.
Click Create.

Ligne de commande

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 :

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

Accéder à IAM
Sélectionnez votre projet Google Cloud.
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.
Dans la liste des rôles disponibles, sélectionnez Administrateur des objets de l'espace de stockage.
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 :

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

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

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

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.

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. Avertissement : La modification de la valeur de ce paramètre modifie le chemin d'accès de vos fichiers de sauvegarde, ce qui peut entraîner des échecs lors des opérations de récupération de la base de données. Par conséquent, avant de modifier la valeur de ce paramètre, veillez à tester la sauvegarde et la récupération avec la nouvelle valeur de paramètre dans un environnement hors production.
`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. Avertissement : La modification de la valeur de ce paramètre modifie le chemin d'accès de vos fichiers de sauvegarde, ce qui peut entraîner des échecs lors des opérations de récupération de la base de données. Par conséquent, avant de modifier la valeur de ce paramètre, veillez à tester la sauvegarde et la récupération avec la nouvelle valeur de paramètre dans un environnement hors production.
`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. Avertissement : La modification de la valeur de ce paramètre modifie le chemin d'accès de vos fichiers de sauvegarde, ce qui peut entraîner des échecs lors des opérations de récupération de la base de données. Par conséquent, avant de modifier la valeur de ce paramètre, veillez à tester la sauvegarde et la récupération avec la nouvelle valeur de paramètre dans un environnement hors production.
`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. Avertissement: La clé `X-Backup-Type` ne doit pas être écrasée par des métadonnées personnalisées.
`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.