Soluciona problemas del agente de Backint 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.5 (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.

Si se producen errores durante la ejecución de una copia de seguridad o una recuperación, se muestran mensajes de error en SAP HANA Studio o SAP HANA Cockpit, por lo que allí encontrarás información sobre la causa de los errores. Es posible que esta información se muestre en los archivo de registro backup.log y backint.log. Asegúrate de seleccionar el nombre de la base de datos relevante cuando se usan contenedores de bases de datos multiusuario (MDC).

Asegúrate de instalar el agente de Backint como el usuario sidadm.

Archivos de registro

Si se producen errores, revisa los siguientes registros:

backup.log de SAP HANA, que contiene información sobre las operaciones de copia de seguridad y recuperación de SAP HANA.
backint.log de SAP HANA, que contiene las llamadas a la interfaz de la copia de seguridad que usa el agente de Backint y otras herramientas de copia de seguridad externas.
Archivos de registro del agente de Backint, que contienen eventos operativos y de instalación del agente de Backint. Los archivos de registro del agente de Backint se encuentran en /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. Los registros del agente de Backint pueden incluir indicaciones de errores de comunicación con Cloud Storage y problemas relacionados de configuración o permisos.
Los registros de Google Cloud, que pueden contener errores relacionados con la cuenta de servicio que usa el agente de Backint. Para revisar los registros de la consola de Google Cloud, consulta la página Visor de registros en la consola de Google Cloud.

También revisa la información de E/S del disco y la red en el host de SAP HANA para verificar la actividad.

Para obtener más información sobre el registro del agente de Backint, consulta Registra el agente de Backint.

Problemas de conectividad

Si el agente de Backint no se puede conectar al bucket de Cloud Storage, revisa los pasos de configuración. En particular, verifica los siguientes elementos:

Reintenta o restable la copia de seguridad con errores para asegurarte de que el error no fue solo un problema de conectividad momentáneo.
Si usas la cuenta de servicio de la VM host con el agente de Backint, el permiso de acceso para Storage se muestra como Lectura/escritura en los Permisos de acceso a la API de Cloud en la página Detalles de instancia de VM en la consola de Google Cloud. Si no es así, detén la instancia y edita el permiso de acceso.
Si creaste una cuenta de servicio para el agente de Backint, revisa lo siguiente:
- En la pestaña Permisos de la página Detalles del bucket en la consola de Google Cloud, confirma que la cuenta de servicio del agente de Backint esté en la lista y que tenga el rol de Administrador de objetos de almacenamiento.
- Confirma que creaste una clave privada, la almacenaste en el host de SAP HANA y especificaste de forma correcta la ruta de acceso al archivo de claves JSON en el archivo de configuración del agente de Backint, /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
Todos los parámetros se especifican de forma correcta en el archivo de configuración parameters.txt del agente de Backint y en el archivo global.ini de SAP HANA.

Puedes probar el acceso al bucket de Cloud Storage desde el host de SAP HANA con Google Cloud CLI. Con la CLI de gcloud, guarda un archivo de texto en el bucket de Cloud Storage y accede a él:

Si no usas la cuenta de servicio predeterminada, autentícate con Google Cloud como un usuario autorizado para el bucket de Cloud Storage o la cuenta de servicio del agente de Backint:
```
gcloud auth login user-account
```
O:
```
gcloud auth activate-service-account --key-file=/path/key-file-name.json
```
Para obtener más información sobre la autenticación de Cloud Storage de una cuenta de servicio, consulta Autenticación de gcloud CLI.
Confirma que puedes enumerar los objetos almacenados en el bucket:
```
gcloud storage ls gs://bucket/
```
Crea un archivo de prueba:
```
touch test.txt
```
Confirma que puedes escribir el archivo de prueba en el bucket:
```
gcloud storage cp test.txt gs://bucket/test.txt
```
Confirma que puedes leer el archivo de prueba en el bucket:
```
gcloud storage cp gs://bucket/test.txt
```

Capacidad de procesamiento baja

Si la capacidad de procesamiento es más baja de lo esperado, verifica que la compresión esté inhabilitada.

Para inhabilitar la compresión, agrega la marca #DISABLE_COMPRESSION al archivo parameters.txt del agente de Backint.

Errores de transmisión múltiple

Si recibes errores durante la transmisión múltiple, cambia la cantidad de transmisiones a una (1) para comprobar si el error está relacionado con la cantidad de transmisiones.

Para obtener más información sobre el registro de agentes de Backint, consulta Copias de seguridad de datos de transmisión múltiple con el agente de Backint.