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:

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

  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.

Línea de comandos

    Create a Cloud Storage bucket and configure it as follows:
    • 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:

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

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud.

  3. 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.
  4. En la lista de roles disponibles, selecciona Administrador de objetos de almacenamiento.

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

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

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

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

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

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

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

    Los parámetros basepath_catalogbackup y basepath_logbackup muestran el mismo valor en la sección de persistencia del archivo global.ini

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.

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.

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.

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.

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.