Configura la copia de seguridad y recuperación basadas en Backint para SAP HANA

En esta guía, se muestra cómo configurar el agente de Google Cloud para SAP para realizar una copia de seguridad y recuperación basada en Backint para SAP HANA.

Si deseas obtener información sobre esta función, consulta Copia de seguridad y recuperación basada en Backint para SAP HANA.

Para obtener información sobre cómo realizar operaciones de copia de seguridad y recuperación para SAP HANA mediante Backint, consulta Realiza copias de seguridad y recuperación mediante Backint.

Antes de comenzar

Valida la instalación de la versión 3.4 (más reciente) del agente de Google Cloud para SAP. Para obtener instrucciones, consulta la guía de instalación de tu situación.
Si instalaste el agente en un servidor de la solución Bare Metal, asegúrate de que hayas completado los requisitos previos necesarios y configurado una cuenta de servicio. Si deseas obtener instrucciones, consulta Configura el agente de Google Cloud para SAP en Linux.
Si necesitas habilitar esta función para una instancia del agente de Google Cloud para SAP que se ejecuta en un host que no sea una instancia de máquina virtual (VM) de Compute Engine o un servidor de la solución Bare Metal, debes crear un incidente con la asistencia de SAP en el componente BC-OP-LNX-GOOGLE para que SAP y Google Cloud puedan evaluar la configuración.
Instala SAP HANA:
- Para obtener información sobre cómo automatizar la instalación de SAP HANA en Google Cloud mediante Terraform, consulta la guía de implementación para tu situación.
- Para obtener información sobre la instalación de SAP HANA en la solución Bare Metal, consulta la guía de planificación de SAP HANA en la solución Bare Metal.

Crea un bucket de Cloud Storage

Antes de habilitar la función de Backint del agente de Google Cloud para SAP, asegúrate de que exista un bucket de Cloud Storage para almacenar tus copias de seguridad. Si tienes un bucket de Cloud Storage, puedes omitir esta sección.

Para obtener información sobre cómo almacenar copias de seguridad en buckets de Cloud Storage, consulta Almacena copias de seguridad en depósitos de Cloud Storage.

Para crear un bucket de Cloud Storage sigue estos pasos:

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

Línea de comandos

Reemplaza STORAGE_CLASS con tu clase de almacenamiento de preferencia.
Reemplaza LOCATION por tu ubicación de preferencia (ASIA, EU o US)
Reemplaza BUCKET_NAME por Un nombre de depósito que cumpla con los requisitos de nombre del depósito

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Configura los roles de IAM

A fin de permitir que el agente de Google Cloud para SAP realice operaciones de copia de seguridad y recuperación para SAP HANA, debes asegurarte de que la cuenta de servicio que usan tu VM de Compute Engine o el servidor de la solución Bare Metal incluya el rol de IAM.Administrador de objetos de Storage (storage.objectAdmin).

Para agregar este rol a tu cuenta de servicio, sigue estos pasos:

En la consola de Google Cloud, ve a la página IAM.

Ir a IAM
Selecciona tu proyecto de Google Cloud.
Identifica la cuenta de servicio a la que le quieres agregar un rol.
- Si la cuenta de servicio no se encuentra aún en la lista de principales, no tiene ningún rol asignado. Haz clic en Agregar e ingresa la dirección de correo electrónico de la cuenta de servicio.
- Si la cuenta de servicio ya se encuentra en la lista de principales es porque tiene roles existentes. Haz clic en el botón Editar de la cuenta de servicio que deseas editar.
En la lista de roles disponibles, selecciona Administrador de objetos de almacenamiento.
Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Habilita el acceso a las APIs de Cloud y los servidores de metadatos

El agente de Google Cloud para SAP requiere acceso a los siguientes hosts y direcciones IP de Google Cloud durante las operaciones de copia de seguridad y recuperación:

Para acceder a Cloud Storage, storage.googleapis.com.
Para el servidor de metadatos de la instancia de VM de Compute Engine:
- oauth2.googleapis.com, para autenticación
- 169.254.169.254
- metadata.google.internal

Si el agente de Google Cloud para SAP y tu sistema SAP HANA se ejecutan en una VM de Compute Engine que no tiene acceso a Internet, debes configurar el Acceso privado a Google para que el agente pueda interactuar con Cloud Storage y, si usa una cuenta de servicio dedicada, autenticarse con Google Cloud. Para obtener instrucciones detalladas, consulta la sección sobre cómo configurar el acceso privado a Google.

Habilita la función Backint

Para habilitar la función de Backint del agente de Google Cloud para SAP, completa los siguientes pasos:

Conéctate a tu host de SAP HANA mediante SSH.

Si tu host es una VM de Compute Engine, en la página Instancias de VM en la consola de Google Cloud, puedes hacer clic en el botón SSH para tu instancia de VM o usar tu método SSH preferido.
Cambia al administrador del sistema SAP HANA:
```
sudo su - SID_LCadm
```
Reemplaza SID_LC por el SID. Usa minúsculas para las letras.

Mediante este comando, también se establecen una serie de variables de entorno, incluida $SAPSYSTEMNAME, que se establece con el SID de tu base de datos de SAP HANA.
Habilita la función de Backint para el agente de Google Cloud para SAP:
```
/usr/bin/google_cloud_sap_agent installbackint
```
Como alternativa, incluye la marca sid para instalar los archivos relacionados con Backint en un host con un SID diferente:
```
/usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC
```
Reemplaza DIFFERENT_SID_LC por el SID de la instancia de SAP HANA requerida. Usa minúsculas para las letras.

Una vez que el comando se ejecuta de forma correcta, todos los archivos relacionados con la función de Backint del agente de Google Cloud para SAP se instalan en el directorio /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Esto incluye los archivos necesarios para integrar el agente en SAP HANA. También detecta el agente de Backint de Cloud Storage para SAP HANA en tu host, lo inhabilita y copia sus archivos en un directorio recuperable en tu host. Para obtener más información, consulta Actualiza desde el agente de Backint.
Configura la función de Backint:
Ejecuta el comando
Para configurar la función de Backint del agente, ejecuta el comando configurebackint. Recomendamos este enfoque en lugar de editar el archivo de configuración de Backint.
```
/usr/bin/google_cloud_sap_agent configurebackint \
  -f="PATH_TO_PARAMETERS_FILE" \
  -bucket="BUCKET_NAME"
```
Reemplaza lo siguiente:
- PATH_TO_PARAMETERS_FILE: La ruta de acceso a tu archivo de configuración de Backint de PARAMETERS.json
- BUCKET_NAME: Especifica el nombre del bucket de Cloud Storage en el que quieres almacenar las copias de seguridad de SAP HANA.
  
  De forma opcional, puedes establecer más parámetros mientras ejecutas este comando. Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.
Edita el archivo de configuración
Como alternativa a la ejecución del comando configurebackint del agente, edita el archivo de configuración de Backint de la siguiente manera:
1. Abre el archivo de configuración de Backint:
```
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
```
  Reemplaza SID por el SID del sistema SAP en el que instalaste los archivos relacionados de Backint.
  
  El siguiente es un ejemplo de lo que contiene el archivo de configuración:
```
{
 "bucket": "",
 "log_to_cloud": true
}
```
2. Para permitir que el agente de Google Cloud para SAP realice operaciones de copia de seguridad y recuperación basadas en Backint de tu sistema SAP HANA, edita el archivo de configuración y, luego, especifica los siguientes parámetros:
  - bucket: Especifica el nombre del bucket de Cloud Storage en el que quieres almacenar las copias de seguridad de SAP HANA.
  - service_account_key: Si creaste una cuenta de servicio para el agente de Google Cloud para SAP, especifica la ruta de acceso absoluta al directorio en tu host en el que subiste la clave de la cuenta el servicio codificado en JSON correspondiente.
  Para obtener más información, consulta Consideraciones de cuentas de servicio.
3. De manera opcional, puedes modificar otros parámetros de configuración. Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.
4. Guarda el archivo de configuración.

Personaliza el archivo de configuración de Backint

De manera opcional, después de habilitar la función de Backint del agente de Google Cloud para SAP, puedes realizar las siguientes personalizaciones:

Cambie el nombre del archivo parameters.json.

Para indicar este cambio de nombre, este archivo se denomina PARAMETERS.json en la documentación del agente de Google Cloud para SAP.
Crea un archivo de configuración independiente para cada uno de los siguientes elementos: volumen de datos de SAP HANA, volumen de registro de SAP HANA y catálogo de copias de seguridad de SAP HANA.

Asegúrate de establecer un nombre único para cada archivo de configuración.
Mueve estos archivos de configuración a un directorio diferente. Por ejemplo, en una implementación de escalamiento horizontal, puedes almacenar los archivos de configuración relacionados con Backint de todos tus nodos en un directorio compartido al que puedan acceder los nodos. Esto puede facilitar la administración de estos archivos.

Si realizas alguna de estas personalizaciones, asegúrate de especificar de forma adecuada el nombre del archivo y su ruta de acceso para los parámetros en el archivo global.ini de SAP HANA. Si deseas obtener instrucciones, consulta Configura SAP HANA para la función de Backint.

Configura SAP HANA para la función de Backint

Después de habilitar la función de Backint del agente de Google Cloud para SAP, debes configurar tu sistema SAP HANA para usar esta función:

Usa SAP HANA Studio o SAP HANA Cockpit para editar el archivo de configuración global.ini.

En la sección backup del archivo global.ini, especifica los valores para los siguientes parámetros:

Parámetro	Valor
`data_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json`
`parallel_data_backup_backint_channels`	Para las copias de seguridad de datos de transmisión múltiple, especifica la cantidad de canales según el tipo de bucket de Cloud Storage que usas, el rendimiento requerido y la capacidad de procesamiento del disco.
`log_backup_using_backint`	Si usas un archivo de configuración independiente para el volumen de registro de la copia de seguridad de SAP HANA, especifica el valor `true`.
`log_backup_parameter_file`	Si usas un archivo de configuración independiente para el volumen de registro de la copia de seguridad de SAP HANA, especifica el siguiente valor: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json`. Reemplaza `PARAMETERS_LOG` por el nombre del archivo de configuración que usas para las copias de seguridad del volumen de registro de SAP HANA.
`catalog_backup_using_backint`	Si usas un archivo de configuración independiente para el catálogo de copia de seguridad de SAP HANA, especifica el valor `true`.
`catalog_backup_parameter_file`	Si usas un archivo de configuración independiente para el catálogo de copia de seguridad de SAP HANA, especifica el siguiente valor: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json`. Reemplaza `PARAMETERS_CATALOG` por el nombre del archivo de configuración que usas para las copias de seguridad del catálogo de copia de seguridad de SAP HANA.

El siguiente es un ejemplo de un archivo global.ini que está configurado para usar la función de Backint del agente de Google Cloud para SAP:

[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

En la sección persistence del archivo global.ini, especifica los valores para los siguientes parámetros:
- basepath_logbackup: Especifica el directorio en tu sistema de archivos en el que SAP HANA puede almacenar copias de seguridad de registros cuando no puede conectarse a tu bucket de Cloud Storage. Asegúrate de que este directorio tenga suficiente espacio para almacenar copias de seguridad.
- basepath_catalogbackup: Especifica el directorio en el sistema de archivos en el que SAP HANA puede almacenar copias de seguridad del catálogo de copias de seguridad de SAP HANA cuando no puede conectarse a tu bucket de Cloud Storage. Asegúrate de que este directorio tenga suficiente espacio para almacenar copias de seguridad.

Valida la copia de seguridad y la recuperación

Después de habilitar la función de Backint del agente de Google Cloud para SAP, asegúrate de validarla mediante la creación y el restablecimiento de una copia de seguridad en un sistema de prueba.

Para realizar pruebas, puedes usar la herramienta integrada de autodiagnóstico del agente. Necesitas al menos 18 GB de espacio en disco disponible en tu sistema de archivos para ejecutar esta herramienta integrada. Para usar esta herramienta integrada para validar la copia de seguridad y la recuperación, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

IDENTIFIER: un valor que identifica la ejecución del comando. Este identificador se usa para nombrar la carpeta temporal que se crea en el bucket de Cloud Storage mientras se realiza el diagnóstico.
PATH_TO_PARAMETERS_FILE: La ruta de acceso a tu archivo PARAMETERS.json

Mientras usas esta herramienta, puedes usar los parámetros opcionales diagnose_file_max_size_gb y diagnose_tmp_directory. Para obtener más información sobre estos parámetros, consulta sus descripciones en Parámetros de configuración.

Si instalaste el agente de Backint en tu host, la primera vez que usas el agente de Google Cloud para SAP para realizar una operación de copia de seguridad, el agente de Google Cloud para SAP crea versiones JSON de archivos de configuración de texto. Para obtener más información, consulta Actualiza desde el agente de Backint.

Archivo de configuración de ejemplo

El siguiente es un archivo de configuración PARAMETERS.json completo de la función de Backint del agente de Google Cloud para 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"
}

Parámetros de configuración

En la siguiente tabla, se explican los parámetros de configuración del agente de Google Cloud para SAP que son específicos de la función de Backint.

Si deseas obtener información sobre la asignación entre los parámetros de configuración del agente de Backint y el agente de Google Cloud para SAP, consulta Asignación de parámetros de configuración.

Si deseas obtener información sobre los parámetros de configuración del agente de Google Cloud para SAP, incluidos los parámetros relacionados con la recopilación de métricas, consulta la guía de instalación de tu situación.

Parámetros
`bucket`	`String` Especifica el nombre del bucket de Cloud Storage en el que el agente de Google Cloud para SAP escribe y lee. El agente crea objetos de copia de seguridad con la clase de almacenamiento del bucket y admite todas las clases de almacenamiento. El agente usa la encriptación predeterminada de Compute Engine para encriptar los datos en reposo.
`recovery_bucket`	`String` Opcional. Especifica el nombre del bucket de Cloud Storage que el agente lee durante las operaciones `RESTORE`. Si no especificas este parámetro, el agente usa el bucket especificado para el parámetro `bucket` para todas las operaciones: `BACKUP`, `RESTORE`, `INQUIRE`, `DELETE` y `DIAGNOSE`.
`log_to_cloud`	`Boolean` Opcional. Para redireccionar los registros relacionados con Backint del agente de Google Cloud para SAP, hacia Cloud Logging, especifica `true`. El valor predeterminado es `true`. Para obtener información sobre el archivo de registro relacionado con Backint, consulta Logging.
`log_level`	`String` Opcional. Especifica el nivel de registro para la función de Backint del agente de Google Cloud para SAP y establece el valor requerido. Los niveles de registro disponibles son los siguientes: `DEBUG` `INFO` `WARNING` `ERROR` El valor predeterminado es `INFO`. No cambies el nivel de registro, a menos que te dirija al servicio de atención al cliente de Cloud.
`compress`	`Boolean` Opcional. Especifica si el agente de Google Cloud para SAP habilitará la compresión mientras se escriben copias de seguridad en el bucket de Cloud Storage. El valor predeterminado es `false`. Te recomendamos que no habilites la compresión. Aunque la compresión reduce el costo de almacenamiento de las copias de seguridad en Cloud Storage, requiere más procesamiento de CPU durante las operaciones de copia de seguridad y ralentiza la capacidad de procesamiento efectiva de las copias de seguridad. Sin importar este parámetro, el agente de Google Cloud para SAP admite archivos de copia de seguridad comprimidos y sin comprimir durante una operación de restablecimiento.
`encryption_key`	`String` Opcional. Especifica la ruta de acceso a la clave de encriptación proporcionada por el cliente que configuraste tu bucket de Cloud Storage para encriptar las copias de seguridad. Asegúrate de especificar una ruta de acceso completamente calificada a una clave AES-256 codificada en base64. No puedes especificar el parámetro `encryption_key` con los parámetros `kms_key` ni `parallel_streams`.
`kms_key`	`String` Opcional. Especifica la ruta de acceso a la clave de encriptación administrada por el cliente que configuraste en tu bucket de Cloud Storage para encriptar las copias de seguridad. Especifica la ruta con el formato `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME`, en el que: `KMS_PROJECT_ID`: Es el ID del proyecto de Google Cloud en el que existe la clave de KMS. `LOCATION`: la ubicación de Cloud KMS en la que existe la clave de KMS. `KEY_RING_NAME`: es el nombre del llavero de claves que contiene la clave de KMS. `KMS_KEY_NAME`: el nombre de la clave de KMS. Si tu sistema SAP HANA se ejecuta en una VM de Compute Engine, la clave debe ser accesible para la VM. Si tu sistema SAP HANA se ejecuta en un host que no sea una VM de Compute Engine, se debe poder acceder a la clave de Cloud KMS de la cuenta de servicio que usa el agente de Google Cloud para SAP. Para obtener más información, consulta la sección sobre cuentas de servicio. No puedes especificar el parámetro `kms_key` con los parámetros `encryption_key` ni `parallel_streams`.
`folder_prefix`	`String` Opcional. Especifica para establecer un prefijo para las carpetas en el bucket de Cloud Storage en las que el agente de Google Cloud para SAP escribe y lee. Puedes usar este parámetro para organizar copias de seguridad de diferentes instancias de SAP HANA en el mismo bucket de Cloud Storage. Puedes especificar una sola carpeta, como `folder1`, o una ruta de carpetas de varios niveles, como `folder1/folder2/folder3`. Este prefijo se inserta como una carpeta entre los valores `BUCKET_NAME` y `SID` en la ruta de tus copias de seguridad de SAP HANA en Cloud Storage. Para obtener más información, consulta Personalizaciones compatibles. Advertencia: Si cambias el valor de este parámetro, se cambiará la ruta de acceso de los archivos de copia de seguridad, lo que puede generar fallas durante las operaciones de recuperación de la base de datos. Por lo tanto, antes de cambiar el valor de este parámetro, asegúrate de probar la copia de seguridad y la recuperación con el valor del parámetro nuevo en un entorno que no sea de producción.
`recovery_folder_prefix`	`String` Opcional. Especifica para establecer un prefijo para las carpetas del bucket de Cloud Storage que el agente lee durante las operaciones `RESTORE`. Puedes usar este parámetro para organizar copias de seguridad de diferentes instancias de SAP HANA en el mismo bucket de Cloud Storage. Puedes especificar una sola carpeta, como `folder1`, o una ruta de carpetas de varios niveles, como `folder1/folder2/folder3`. Para obtener más información, consulta Personalizaciones compatibles. Advertencia: Si cambias el valor de este parámetro, se cambiará la ruta de acceso de los archivos de copia de seguridad, lo que puede generar fallas durante las operaciones de recuperación de la base de datos. Por lo tanto, antes de cambiar el valor de este parámetro, asegúrate de probar la copia de seguridad y la recuperación con el valor del parámetro nuevo en un entorno que no sea de producción.
`shorten_folder_path`	`Boolean` Opcional. Especifica para acortar la ruta de acceso del objeto en el bucket de Cloud Storage que el agente lee y escribe durante todas las operaciones de Backint. Para obtener más información, consulta Personalizaciones compatibles. Advertencia: Si cambias el valor de este parámetro, se cambiará la ruta de acceso de los archivos de copia de seguridad, lo que puede generar fallas durante las operaciones de recuperación de la base de datos. Por lo tanto, antes de cambiar el valor de este parámetro, asegúrate de probar la copia de seguridad y la recuperación con el valor del parámetro nuevo en un entorno que no sea de producción.
`retries`	`Int` Especifica la cantidad máxima de veces que el agente de Google Cloud para SAP reintenta un intento de lectura o escritura en Cloud Storage con error. El valor predeterminado es `5`, que también es el valor recomendado.
`parallel_streams`	`Int` Opcional. Especifica este argumento para habilitar la carga paralela de copias de seguridad a tu bucket de Cloud Storage. El valor que especificas para este argumento es la cantidad máxima de transmisiones de carga paralelas que puede usar el agente de Google Cloud para SAP. El valor máximo es 32. Cualquier valor que exceda este límite se limita a 32. El valor predeterminado es `1`, que inhabilita la carga paralela. Si deseas habilitar la carga paralela para los datos de transmisión o si tu bucket de Cloud Storage tiene una política de retención, también debes establecer `xml_multipart_upload` en `true`. No habilites la carga paralela si se aplica alguna de las siguientes opciones: El bucket de destino de Cloud Storage usa una política de retención. Especificaste los parámetros `encryption_key` o `kms_key`. Si se cumple alguna de las condiciones anteriores, el agente sale con un estado de `1`. Para obtener información sobre las cargas paralelas, consulta Cargas paralelas.
`xml_multipart_upload`	`Boolean` Opcional. Especifica si el método de carga multiparte de la API de XML se usa cuando se escriben copias de seguridad en el bucket de Cloud Storage. El valor predeterminado es `false`. Para usar el método de carga multiparte de la API de XML, `parallel_streams` debe tener un valor mayor que `1`. Si configuras `xml_multipart_upload` como `true`, pero no especificas `parallel_streams`, entonces `parallel_streams` recibe automáticamente el valor `16`. Recomendamos usar `xml_multipart_upload` solo para paralelizar las copias de seguridad de registros o catálogos. Para paralelizar las copias de seguridad de datos, recomendamos configurar `parallel_data_backup_backint_channels` en la sección `backup` de tu archivo `global.ini`. Si deseas obtener información sobre cómo crear archivos de parámetros separados para las copias de seguridad de datos y registros, o cómo establecer el valor de `parallel_data_backup_backint_channels`, consulta Configura SAP HANA para la función de Backint. En caso de falla, las cargas multiparte XML se anulan de forma automática y se borran los datos que se suben. También recomendamos configurar las condiciones del ciclo de vida para AbortIncompleteMultipartUpload a fin de garantizar que los datos se borren si falla la operación de carga.
`storage_class`	`String` Opcional. Especifica la clase de almacenamiento que se usa cuando se escriben copias de seguridad en el bucket de Cloud Storage. Las clases de almacenamiento disponibles son las siguientes: `STANDARD` `NEARLINE` `COLDLINE` `ARCHIVE` El valor predeterminado es `STANDARD`.
`metadata`	`Map<String, String>` Opcional. Especifica los campos clave-valor para almacenar como metadatos de los objetos cuando escribas copias de seguridad en el bucket de Cloud Storage. El formato de un archivo de configuración `PARAMETERS.json` de ejemplo es el siguiente: { "bucket": "example-bucket-backup", "metadata": {"key1": "value1", "key2": "value2"}, "log_to_cloud": true } Los metadatos predeterminados escritos son `{"X-Backup-Type": "PIPE"}` o `{"X-Backup-Type": "FILE"}`, según el tipo de archivo. Advertencia: La clave `X-Backup-Type` no debe reemplazarse por metadatos personalizados.
`custom_time`	`String` Opcional. Especifica una fecha y hora que deseas configurar para los metadatos `Custom-Time` de las copias de seguridad que subes a Cloud Storage. Debes especificar la fecha y la hora en el formato especificado en `Custom-Time`. Este parámetro está disponible en la versión 3.4 del agente. El siguiente es un ejemplo de cómo puedes especificar este parámetro en tu archivo `PARAMETERS.json`: { "bucket": "example-bucket-backup", "custom_time": "2024-06-25T13:25:00Z", "log_to_cloud": true }
`rate_limit_mb`	`Int` Opcional. Especifica el límite superior, en MB, para el ancho de banda de la red de salida de Compute Engine durante las operaciones de copia de seguridad o restablecimiento. De forma predeterminada, Google Cloud no limita el ancho de banda de red para el agente de Google Cloud para SAP. Cuando configuras este parámetro, la capacidad de procesamiento puede variar, pero no excederá el límite especificado.
`service_account_key`	`String` Si el agente de Google Cloud para SAP no se ejecuta en una VM de Compute Engine, especifica la ruta completamente calificada a la cuenta de servicio de Google Cloud codificada en JSON. Si el agente de Google Cloud para SAP se ejecuta en una VM de Compute Engine, te recomendamos que no especifiques este parámetro y, en su lugar, uses la autenticación predeterminada de Compute Engine. Especificar este parámetro le indica al agente de Google Cloud para SAP que use la clave de cuenta de servicio cuando se autentica en Cloud Storage.
`diagnose_file_max_size_gb`	`Int` Opcional. Especifica el límite superior para el tamaño del archivo temporal, en GB, que crea y borra la herramienta de autodiagnóstico del agente. El valor predeterminado es 16 GB. Para que la herramienta de autodiagnóstico funcione de forma correcta, debes asegurarte de que el almacenamiento disponible en tu sistema de archivos sea de al menos 2 o 3 GB mayor que el valor de `diagnose_file_max_size_gb`.
`diagnose_tmp_directory`	`String` Opcional. Especifica el directorio que se usa para leer y escribir archivos temporales para la herramienta de autodiagnóstico del agente. El valor predeterminado es `/tmp/backint-diagnose`.
`send_metrics_to_monitoring`	`Boolean` Opcional. Especifica si el agente puede recopilar métricas relacionadas con el estado y la capacidad de procesamiento de los archivos que se suben o descargan durante las operaciones de Backint. El agente envía las métricas recopiladas a Cloud Monitoring. El valor predeterminado es `true`. Para obtener información sobre las métricas relacionadas con Backint, consulta Recopilación de métricas de Backint.
`threads`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica la cantidad de subprocesos de trabajo. El valor predeterminado es la cantidad de procesadores en el host.
`file_read_timeout_ms`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica la cantidad máxima, en milisegundos, que el agente de Google Cloud para SAP espera para abrir el archivo de copia de seguridad. El valor predeterminado es `60000` (60 segundos).
`buffer_size_mb`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica este parámetro para controlar el tamaño de las solicitudes HTTPS a Cloud Storage durante las operaciones de copia de seguridad o restablecimiento. El tamaño del búfer predeterminado es 100 MB, lo que significa que una sola solicitud de transmisión HTTPS desde o hacia Cloud Storage se mantiene abierta hasta que se transfieren 100 MB de datos. El tamaño máximo del búfer es de 250 MB. Debido a que el agente de Google Cloud para SAP vuelve a intentar las solicitudes HTTPS varias veces antes de fallar una operación, los tamaños de búfer menores a 100 MB dan como resultado menos datos que se deben volver a transmitir si una solicitud falla. Los tamaños de buffer más grandes pueden mejorar la capacidad de procesamiento, pero requieren más uso de memoria y más tiempo para reenviar datos en caso de una falla en la solicitud. Si usas el parámetro `parallel_streams`, el uso de memoria requerido debe multiplicarse por ese valor, ya que cada transmisión requiere su propio búfer para procesar las solicitudes HTTPS.
`retry_backoff_initial`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica el valor inicial, en segundos, para el período de reintento que se usa en los reintentos de la red de retirada exponencial. El valor predeterminado es `10`.
`retry_backoff_max`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica el valor máximo, en segundos, para el período de reintento que se usa en los reintentos de la red de retirada exponencial. El valor predeterminado es `300`.
`retry_backoff_multiplier`	`Float` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica el multiplicador para el período de reintentos que se usó en los reintentos de la red de retirada exponencial. El multiplicador debe ser mayor que `1` y el valor predeterminado es `2`.
`log_delay_sec`	`Int` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica el retraso de registro, en segundos, para las actualizaciones de progreso durante las lecturas y escrituras en el bucket de Cloud Storage. El valor predeterminado es `60`.
`client_endpoint`	`String` Este es un parámetro de ajuste avanzado opcional. No modifiques este parámetro, a menos que el equipo del servicio de atención al cliente te lo solicite. Su valor predeterminado rara vez necesita modificarse. Especifica el extremo del cliente de Cloud Storage. El valor predeterminado es `storage.googleapis.com`.

Soluciona problemas

Para solucionar problemas de la versión 3.4 (más reciente) del agente de Google Cloud para SAP, consulta la guía de solución de problemas del agente de Google Cloud para SAP.

Obtener asistencia

Si necesitas ayuda para resolver un problema con el Agente de Google Cloud para SAP, recopila la información de diagnóstico requerida y comunícate con el servicio de atención al cliente de Cloud. Si deseas obtener más información, consulta la información de diagnóstico del agente de Google Cloud para SAP para SAP HANA.