Guía de instalación del agente de Backint de Cloud Storage para SAP HANA

Importante: En el caso de las instalaciones nuevas, en lugar de usar el agente de Backint de Cloud Storage para SAP HANA, te recomendamos que uses su sucesor: el agente de Google Cloud para SAP. A partir de la versión 3.0, el agente de Google Cloud para SAP combina la recopilación de métricas de SAP Host Agent con otras funciones, como la copia de seguridad y recuperación basadas en Backint para SAP HANA.

Si usas el agente de Backint, te recomendamos que cambies a la versión 3.1 (más reciente) del agente de Google Cloud para SAP lo antes posible, antes de que la asistencia para el agente de Backint se descontinúe. Si deseas obtener instrucciones de actualización, consulta Actualiza el agente de Google Cloud para SAP desde otros agentes de Google Cloud.

La asistencia para el agente de Backint finaliza en febrero de 2025. Este agente no es compatible con los tipos de máquinas de Compute Engine que estuvieron disponibles para el público general (DG) después de febrero de 2024.

En estas instrucciones, se muestra cómo instalar y configurar el agente de Backint de Cloud Storage para SAP HANA (agente de Backint).

Si deseas obtener información sobre las opciones de configuración del agente de Backint, consulta la descripción general del agente de Backint de Cloud Storage para SAP HANA.

Requisitos previos

Antes de instalar el agente de Backint, primero debes instalar SAP HANA. Para instalar SAP HANA en Google Cloud, consulta la Guía de implementación de SAP HANA.

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.

Si la VM del host no tiene acceso a Internet, debes configurar el Acceso privado a Google para que el agente de Backint pueda acceder a las API de Google Cloud. Si deseas configurar el Acceso privado a Google, consulta Cómo configurar el Acceso privado a Google.

Nota: Si necesitas instalar el agente de Backint en un host que no sea una máquina virtual (VM) de Compute Engine o una máquina física de la solución Bare Metal, crea un incidente con asistencia de SAP en el componente BC-OP-LNX-GOOGLE para que SAP y Google Cloud puedan evaluar tu configuración.

Crea un bucket de Cloud Storage para copias de seguridad

Antes de que puedas configurar el agente de Backint, debes crear un bucket de Cloud Storage para guardar las copias de seguridad.

Para crear un bucket de Cloud Storage, usa la consola de Google Cloud.

Para obtener información sobre las opciones de bucket, consulta Almacena copias de seguridad en buckets de Cloud Storage.

1. Abre el navegador de Cloud Storage en la consola de Google Cloud.

   Abrir el navegador de Cloud Storage

2. Haz clic en CREAR DEPÓSITO.

3. Asígnale un nombre al bucket y haz clic en Continuar.

4. Sigue las indicaciones para seleccionar las opciones de bucket.

   Nota: Las opciones de encriptación que se presentan en la consola de Google Cloud durante la creación del bucket se aplican, por lo general, a los objetos en reposo en el bucket. El agente de Backint proporciona opciones de encriptación adicionales para las copias de seguridad que son independientes de las opciones de encriptación de depósitos.

5. Haz clic en Crear.

6. Para configurar los permisos del bucket, haz clic en la pestaña de los permisos. De forma predeterminada, como propietario del bucket, tienes acceso de lectura/escritura en el bucket. También puedes permitir que otros principales accedan al bucket.

Instala el agente de Backint en el host de SAP HANA

El agente de Backint se instala en el mismo sistema de archivos compartidos que la base de datos de SAP HANA.

En una implementación de escalamiento horizontal de SAP HANA, instala el agente de Backint en cada nodo del sistema SAP HANA. Para simplificar la administración, puedes almacenar los archivos de configuración en una ubicación compartida que sea accesible para todos los nodos de la implementación, como /hana/shared.

1. Conéctate a tu host de SAP HANA mediante SSH. Si tu host es una VM de Compute Engine, en la página de instancias de VM, puedes hacer clic en el botón SSH de tu instancia de VM o puedes usar el método de SSH que prefieras.

2. Cambia al administrador del sistema SAP HANA.

   sudo su - SID_LCadm
   

3. Descarga e instala el agente de Backint.

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Nota: Si actualizas una instancia existente del agente de Backint a una versión nueva, sigue las instrucciones de Actualiza el agente de Backint a una versión nueva.

   La secuencia de comandos install.sh realiza las siguientes acciones:

   • Instala el agente de Backint como un archivo JAR en /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Descarga una versión compatible de Java Runtime Environment.
   • Configura la secuencia de comandos backint que invoca el agente de Backint. No modifiques la secuencia de comandos backint, a menos que el servicio de Atención al cliente de Cloud te lo indique.
   • Cuando finaliza, emite un mensaje que te indica que debes actualizar el archivo parameters.txt y configurar la autenticación. Consulta Configura el agente de Backint y SAP HANA para obtener más detalles.

4. Si alguno de los siguientes casos se aplica a tu situación, debes crear una cuenta de servicio para el agente de Backint:

   • Necesitas el agente de Backint para usar un conjunto de permisos de recursos diferente del que usa tu VM de Compute Engine host.
   • SAP HANA se ejecuta en la solución Bare Metal.
   • SAP HANA no se ejecuta en Google Cloud.

   Si deseas crear una cuenta de servicio para el agente de Backint, sigue estos pasos:

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

      Ir a la página Cuentas de servicio

   2. Selecciona tu proyecto de Google Cloud.

   3. Haz clic en Crear cuenta de servicio.

   4. Especifica un nombre para la cuenta de servicio y, de forma opcional, una descripción.

   5. Haz clic en Crear y continuar.

   6. Haz clic en Continuar para crear la cuenta de servicio sin permisos.

   7. Según corresponda, otorga otro acceso a los usuarios a la cuenta de servicio.

   8. Haga clic en Listo.

   9. En la página Cuentas de servicio de la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que acabas de crear.

   10. En el nombre de la cuenta de servicio, haz clic en la pestaña Claves.

   11. Haz clic en el menú desplegable Agregar clave y, luego, selecciona Crear clave nueva para crear una clave de cuenta de servicio.

   12. Acepta el archivo JSON como el tipo de clave y haz clic en Crear. Se guarda una clave privada en la computadora.

5. Sube el archivo de claves JSON al host de SAP HANA.

   • Almacena el archivo .json en un directorio al que pueda acceder el usuario SID_LCadm, como /usr/sap/SID/home.
   • Asegúrate de que el usuario SID_LCadm esté autorizado para leer el archivo.

6. Actualiza el bucket de Cloud Storage a fin de otorgar permiso a la cuenta de servicio para usar el bucket:

   1. Haz clic en el nombre del bucket en el navegador de Cloud Storage.

      Abre el navegador de Cloud Storage

   2. Haz clic en la pestaña Permisos.

   3. Haz clic en Agregar principales.

   4. En el campo Nuevas principales, ingresa la dirección de correo electrónico completa de la cuenta de servicio. Por ejemplo:

      [e-mail]

   5. Haz clic en el menú desplegable Seleccionar una función y, luego, selecciona Administrador de objetos de almacenamiento.

   6. Haz clic en Guardar.

Configura el agente de Backint y SAP HANA

Para configurar el agente de Backint, especifica parámetros en un archivo de configuración de texto sin formato.

Puedes usar la misma configuración para todos los tipos de copia de seguridad (datos, registro y catálogo) o puedes usar una configuración diferente para cada tipo si creas un archivo de configuración diferente para cada uno.

Para especificar la ruta a cada archivo de configuración del agente de Backint en SAP HANA, especifica los parámetros en el archivo global.ini.

1. Para configurar el agente de Backint, especifica los parámetros en el archivo parameters.txt. Puedes cambiar el nombre del archivo según corresponda.

   1. Usa tu método preferido para editar el archivo parameters.txt. El archivo está instalado en el siguiente directorio.

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      

      Puedes cambiar el nombre del archivo parameters.txt y usar diferentes archivos de configuración para las copias de seguridad de datos, registros y catálogos.

      Para obtener descripciones de los parámetros de configuración y recomendaciones de rendimiento, consulta Opciones de configuración para el agente de Backint.

   2. Especifica el nombre del bucket de Cloud Storage que se usará para las copias de seguridad.

      #BUCKET bucket-name
      

   3. Si creaste una cuenta de servicio y una clave privada para el agente de Backint, especifica la ruta de acceso al archivo de claves JSON.

      #SERVICE_ACCOUNT /path/key-file-name.json

   En el siguiente ejemplo, se muestra el contenido de un archivo parameters.txt válido. Ten en cuenta que el # de este ejemplo es parte de la sintaxis y no significa que la línea sea un comentario.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. Opcional: Configura el agente de Backint para omitir o usar un proxy para copias de seguridad y recuperaciones. De forma predeterminada, el agente de Backint omite los proxies HTTP.

   Advertencia: El enrutamiento de las copias de seguridad a través de un proxy afecta el rendimiento y la confiabilidad de todo el tráfico del proxy durante el envío o la recuperación de copias de seguridad desde Cloud Storage. Google Cloud recomienda que el agente de Backint omita los proxies HTTP.

   Las consultas al servidor de metadatos de la instancia siempre deben omitir el servidor proxy HTTP. Usa los parámetros de proxy http o https según lo requiera tu servidor proxy.

   Si quieres especificar la configuración del servidor proxy para el agente de Backint, edita el archivo /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

   Por ejemplo, la siguiente configuración especifica un servidor proxy HTTPS:

   http.proxyHost=proxy-host
   http.proxyPort=proxy-port
   http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
   https.proxyHost=proxy-host
   https.proxyPort=proxy-port
   

   Para obtener más información sobre el uso del agente de Backint con un proxy, consulta Proxies y el agente de Backint.

3. Configura SAP HANA para usar el agente de Backint.

   1. Usa SAP HANA Studio o SAP HANA Cockpit para configurar los siguientes parámetros en la sección backup del archivo de configuración global.ini según los valores que se muestran en la tabla. No es necesario reiniciar SAP HANA después de realizar estos cambios.

      Si usas un archivo de configuración diferente para cada tipo de copia de seguridad, especifica los archivos de configuración diferentes como se muestra en la siguiente tabla. De lo contrario, especifica el mismo archivo de configuración para todos los tipos.

      Parámetro	Valor
      catalog_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint	true
      data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint	true

   2. Usa SAP HANA Studio a fin de especificar el mismo valor para basepath_catalogbackup y basepath_logbackup en la sección persistence del archivo global.ini. Por ejemplo:

      

4. Para probar la instalación, crea una copia de seguridad en el bucket de Cloud Storage y restablece desde la copia de seguridad.

5. Para admitir la función de actualización automática del agente de Backint, habilita las solicitudes HTTP remotas de la VM de SAP HANA a https://www.googleapis.com/.

6. De manera opcional, habilita Cloud Logging.

   • Si SAP HANA se ejecuta en una VM de Compute Engine, agrega el controlador com.google.cloud.logging.LoggingHandler a la propiedad com.google.cloud.partners.handlers en el archivo /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties.
   • Si SAP HANA se ejecuta fuera de Google Cloud, instala Google Cloud CLI y configura el acceso predeterminado de la aplicación mediante el comando gcloud auth application-default login.

Actualiza el agente de Backint a una versión nueva

Antes de actualizar el agente de Backint a una versión nueva en el entorno de producción, asegúrate de probar la versión nueva en un entorno que no sea de producción. Para obtener información sobre lo que ofrece una versión del agente de Backint, consulta las notas de la versión de esa versión.

Para actualizar el agente de Backint a una versión nueva, sigue estos pasos:

1. Asegúrate de que no haya copias de seguridad de datos en curso ni programadas para el período que se superpone con la actualización.

2. Para inhabilitar las copias de seguridad automáticas de registros, establece el parámetro enable_auto_log_backup de SAP HANA en no. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.

3. Habilita las solicitudes HTTP remotas del host de SAP HANA a https://www.googleapis.com/.

4. Instala la versión nueva, como SID_LCadm en el host de SAP HANA:

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   La secuencia de comandos update.sh realiza las siguientes acciones:

   • Instala la versión nueva del agente de Backint en /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Actualiza la secuencia de comandos backint para invocar la versión nueva del agente de Backint.
   • Actualiza el número de versión en VERSION.txt.
   • Almacena la secuencia de comandos update.sh de forma local en /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Emite un mensaje cuando está listo.

   El proceso de actualización no modifica ni reemplaza el archivo parameters.txt existente. Para usar las opciones nuevas que se presentaron en la nueva versión, debes agregar los parámetros correspondientes al archivo parameters.txt existente.

   El proceso de actualización deja la versión anterior del agente de Backint en el directorio /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs para que puedas volver a esa versión si es necesario.

5. Para habilitar las copias de seguridad automáticas de registros, establece el parámetro enable_auto_log_backup de SAP HANA en yes. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.

6. Supervisa el sistema para detectar copias de seguridad creadas correctamente.

Vuelve a una versión anterior

Si se presentan problemas con la versión nueva del agente de Backint y la asistencia de Google Cloud o SAP te aconsejan volver a la versión anterior, puedes hacerlo si editas el archivo de secuencia de comandos backint.

Si agregaste parámetros a la versión nueva en el archivo parameters.txt, no es necesario que los quites. La versión anterior del agente de Backint ignora los parámetros de la versión más reciente.

Para volver a una versión anterior, sigue estos pasos:

1. Como SID_LCadm, abre la secuencia de comandos backint para editarla. Por ejemplo:

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint

2. Cambia el nombre del archivo JAR del agente de Backint por el nombre del archivo JAR de la versión anterior.

   Por ejemplo, si vuelves a la versión 1.0.4 desde la versión 1.0.6, deberías cambiar lo siguiente:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar

   por:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

3. Abre el archivo VERSION.txt para editarlo y especifica el número de versión anterior. Debes hacer esto para que el mecanismo de actualización sepa qué versión se encuentra en ejecución.

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt

4. Prueba el agente de Backint mediante la activación de una copia de seguridad.

Soluciona problemas

Si deseas solucionar problemas con el agente de Backint para SAP HANA, consulta Soluciona problemas del agente de Backint para SAP HANA.

Obtén asistencia para el agente de Backint

Si necesitas ayuda para resolver un problema con el agente de Backint de SAP HANA, 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 Información de diagnóstico de los agentes de Backint para SAP HANA.