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 conceptual sobre esta función, que puede ayudarte a planificar tu implementación, consulta Copia de seguridad y recuperación para SAP HANA con Backint.

Si deseas obtener información para crear copias de seguridad basadas en Backint y recuperar tu SAP HANA con ellas, consulta Crea copias de seguridad de SAP HANA y recupéralas con Backint.

Antes de comenzar

• Valida la instalación de la versión 3.6 (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 tu base de datos de SAP HANA se ejecuta en un entorno local, asegúrate de configurar una cuenta de servicio y su clave. Si deseas obtener información para hacerlo, 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 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 tu 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:

Configura los roles de IAM

Para 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 usa tu instancia de Compute Engine o el servidor de la solución Bare Metal incluya el rol de IAM Administrador de objetos de almacenamiento (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.

Para obtener un nivel de acceso detallado, puedes configurar los siguientes permisos de IAM en tu rol personalizado para tu cuenta de servicio a nivel del proyecto:

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

También debes configurar las políticas de IAM en tu bucket otorgando a tu principal los siguientes permisos de IAM:

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

Agrega los siguientes permisos si quieres realizar cargas multiparte:

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

Para obtener más información sobre cómo crear un rol personalizado, consulta Crea y administra roles personalizados. Para obtener más información sobre cómo otorgarle a un principal un rol personalizado para el acceso a nivel del bucket, consulta Agrega un principal a una política a nivel de bucket.

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 instancias de Compute Engine, haz lo siguiente:
  • 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 instancia 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 se 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 instancia de Compute Engine, en la página Instancias de VM de la consola de Google Cloud, puedes hacer clic en el botón SSH de tu instancia 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, para instalar los archivos relacionados de Backint en un host con un SID diferente, incluye la marca sid:

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

   Después de que se ejecute el comando de forma correcta, todos los archivos relacionados con la función de Backint del agente de Google Cloud para SAP se instalarán 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

   • Si tu base de datos de SAP HANA se ejecuta en una instancia de Compute Engine o en un servidor de la solución Bare Metal, para configurar la función Backint del agente, ejecuta el comando configurebackint. Recomendamos este enfoque en lugar de editar el archivo de configuración de Backint del agente.

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

   • Si tu base de datos de SAP HANA se ejecuta en un entorno local, ejecuta el siguiente comando para configurar la función de Backint del agente:

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

     Reemplaza lo siguiente:

     • PATH_TO_PARAMETERS_FILE: La ruta de acceso a tu archivo de configuración de Backint de PARAMETERS.json
     • BUCKET_NAME: Es el nombre del bucket de Cloud Storage en el que quieres almacenar las copias de seguridad de SAP HANA.
     • PATH_TO_KEY: Es la ruta de acceso completamente calificada a la clave de la cuenta de servicio de Google Cloud codificada en JSON que configuraste.

   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. Si tu base de datos de SAP HANA se ejecuta en un entorno local, asegúrate de configurar lo siguiente:

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

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

   5. Guarda el archivo de configuración.

Personaliza el archivo de configuración de Backint

De forma 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 otro directorio. 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 los nodos puedan acceder. 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 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 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 creando y restableciendo una copia de seguridad en un sistema de prueba.

Para realizar pruebas, puedes usar la herramienta de autodiagnóstico integrada 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 asignar un nombre a la carpeta temporal que se crea en el bucket de Cloud Storage mientras se realizan los diagnósticos.
• 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 quieres 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.

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

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

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

Soluciona problemas

Para solucionar problemas de la versión 3.6 (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.

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

¿Qué sigue?

• Si deseas obtener información para crear copias de seguridad basadas en Backint y recuperar tu base de datos de SAP HANA con ellas, consulta Crea copias de seguridad de SAP HANA y recupéralas con Backint.