View a markdown version of this page

AWSSupport-CollectSAPHANALogs - AWS Systems Manager Referencia del manual de automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-CollectSAPHANALogs

Descripción

El AWSSupport-CollectSAPHANALogs manual recopila los registros del sistema de SAP HANA en una instancia de Amazon Elastic Compute Cloud (Amazon EC2) que forma parte de un SAP en el momento de la implementación. AWS La instancia de Amazon EC2 debe gestionarla AWS Systems Manager (Systems Manager). El runbook comprueba los paquetes necesarios y los instala si faltan, ejecuta la herramienta de recopilación de registros adecuada para el sistema operativo detectado y, opcionalmente, carga los registros recopilados en un depósito de Amazon Simple Storage Service (Amazon S3).

importante

Este runbook requiere al menos 200 MB de espacio disponible en disco en la partición. /var/log Al ejecutar este runbook, es posible que se instalen paquetes adicionales en la instancia Amazon EC2 de destino. Debe reconocerlo configurando el Acknowledgement parámetro en. Yes El almacenamiento de registros en Amazon S3 conlleva cargos estándar de almacenamiento y solicitud de Amazon S3.

Sistemas operativos compatibles

  • Red Hat Enterprise Linux8.4 y versiones posteriores

  • SUSE Linux Enterprise Server SP5 12

  • SUSE Linux Enterprise Server15 SP3 y versiones posteriores

Paquetes instalados si faltan

SUSE Linux Enterprise Server:

  • supportutils

  • yast2-support

  • supportutils-plugin-suse-public-cloud

  • supportutils-plugin-ha-sap

  • crmsh

  • unzip

  • curl

  • aws-cli(opcional, se instala si InstallAWSCLI está configurado enYes)

Red Hat Enterprise Linux:

  • sos

  • crm_report

  • unzip

  • curl

  • aws-cli(opcional, se instala si InstallAWSCLI está configurado enYes)

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux

Parámetros

  • AutomationAssumeRole

    Tipo: cadena

    Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • InstanceID

    Escriba AWS::EC2::Instance: :Id

    Descripción: (obligatorio) El ID de la instancia de Amazon EC2 que ejecuta la carga de trabajo de SAP desde la que se deben recopilar los registros.

  • Reconocimiento

    Tipo: cadena

    Valores válidos: Yes

    Descripción: (Obligatorio) Reconozco que este runbook puede instalar paquetes adicionales en la instancia Amazon EC2 de destino para la recopilación de registros.

  • S3 LogDestination

    Tipo: AWS::S3::Bucket :Nombre

    Descripción: (opcional) El nombre del depósito de Amazon S3 en el que se cargan los registros. El bucket no debe ser público y debe pertenecer a la misma AWS cuenta. Si no se proporciona, los registros se almacenan en el almacenamiento local de la instancia.

  • S3Prefix

    Tipo: cadena

    Predeterminado: AWSSupport-CollectSAPHANALogs

    Patrón permitido: ^$|^[a-zA-Z0-9][-./a-zA-Z0-9]{0,255}$

    Descripción: (opcional) El prefijo del bucket de Amazon S3 donde se almacenan los registros. Si no se proporciona, el valor predeterminado es. AWSSupport-CollectSAPHANALogs

  • Instalar AWSCLI

    Tipo: cadena

    Valores válidos: Yes | No

    Valor predeterminado: No

    Descripción: (opcional) Si se debe instalar la AWS CLI en la instancia. SiYes, el runbook instala la AWS CLI si aún no está presente.

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • ssm:DescribeInstanceInformation

  • ssm:SendCommand

  • ssm:GetCommandInvocation

  • s3:GetBucketPublicAccessBlock

  • s3:GetBucketAcl

  • s3:GetBucketLocation

  • s3:GetBucketOwnershipControls

  • s3:GetEncryptionConfiguration

  • s3:PutObject

Pasos de documentos

  1. AssertInstanceIsSSMManaged- Verifica que la instancia Amazon EC2 de destino esté gestionada por Systems Manager y tenga un PingStatus de. Online El runbook se cancela si la instancia no está administrada.

  2. GetInstanceInformation- Recupera información sobre la instancia Amazon EC2 especificada, incluido el nombre de la plataforma, que se utiliza para determinar el método de recopilación de registros adecuado.

  3. CollectLogs- Ejecuta un script de shell en la instancia para recopilar los registros. Por SUSE Linux Enterprise Server ejemplo, el script usasupportconfig. Por Red Hat Enterprise Linux ejemplo, usasos report. En el caso de los clústeres de alta disponibilidad, el script también recopila registros de alta disponibilidad adicionales de los últimos 7 días mediante el crm report comando. Si faltan, se instalan los paquetes necesarios.

  4. BranchOnS3BucketProvided- Ramifica la ejecución en función de si se ha incluido un bucket de Amazon S3S3LogDestination. Si no se ha proporcionado ningún bucket, el manual pasa a. GenerateReport De lo contrario, pasa a. CheckS3BucketPublicStatus

  5. CheckS3BucketPublicStatus- Comprueba si el bucket de Amazon S3 especificado S3LogDestination está configurado con cifrado del lado del servidor (SSE) y si permite permisos de acceso de lectura o escritura públicos o anónimos. También verifica que el propietario real del bucket sea el mismo que el propietario esperado del bucket. Si este paso no se realiza correctamente, el runbook seguirá GenerateReport sin cargarse.

  6. UploadLogsToS3- Carga los registros recopilados en el bucket de Amazon S3 especificado. Si InstallAWSCLI está configurado en Yes y la AWS CLI no está instalada, el script instala la AWS CLI antes de cargarla.

  7. GenerateReport- Genera un informe del proceso de recopilación de registros. Si se proporcionó un bucket de Amazon S3, este incluye el nombre y el prefijo del bucket de Amazon S3 donde se cargaron los registros. De lo contrario, indica que los registros se almacenaron localmente en la instancia. También indica por qué fallaron los pasos anteriores.

Salidas

GenerateReport.Summary- Un resumen del resultado de la recopilación de registros.

GenerateReport.LogLocation- La ubicación en la que se almacenaron los registros, ya sea una ruta local de la instancia o un URI de Amazon S3.

GenerateReport.Status- El estado general de la ejecución de la recopilación de registros.

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta AWSSupport-CollectSAPHANALogsSystems Manager en Documentos.

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El ARN de la función de IAM que permite a Systems Manager Automation realizar acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este runbook.

    • InstanceID (obligatorio):

      El ID de la instancia de Amazon EC2 que ejecuta la carga de trabajo de SAP.

    • Reconocimiento (obligatorio):

      Introduzca Yes para confirmar que el runbook puede instalar paquetes adicionales en la instancia Amazon EC2 de destino.

    • S3 LogDestination (opcional):

      El nombre del bucket de Amazon S3 en el que se van a cargar los registros. Si no se proporcionan, los registros se almacenan localmente en la instancia.

    • Prefijo S3 (opcional):

      El prefijo de bucket de Amazon S3 para los registros almacenados. El valor predeterminado es AWSSupport-CollectSAPHANALogs.

    • Instalar AWSCLI (opcional):

      Seleccione esta opción Yes para instalar automáticamente la AWS CLI si no está presente en la instancia. El valor predeterminado es No.

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • AssertInstanceIsSSMManaged

      Verifica que la instancia Amazon EC2 de destino esté gestionada por Systems Manager y tenga un PingStatus de. Online

    • GetInstanceInformation

      Recupera información sobre la instancia de Amazon EC2 especificada, incluido el nombre de la plataforma.

    • CollectLogs

      Ejecuta un script de shell para recopilar registros utilizando supportconfig for SLES o sos report for. RHEL En el caso de los clústeres de alta disponibilidad, también recopila los registros de alta disponibilidad de los últimos 7 días de usocrm report.

    • BranchOnS3BucketProvided

      Salta a GenerateReport si no se ha proporcionado ningún bucket de Amazon S3; de lo contrario, pasa aCheckS3BucketPublicStatus.

    • CheckS3BucketPublicStatus

      Verifica que el bucket de Amazon S3 tenga SSE habilitado, no permita el acceso público y sea propiedad de la misma AWS cuenta.

    • UploadLogsToS3

      Carga los registros recopilados en el bucket de Amazon S3 especificado. Instala la AWS CLI si InstallAWSCLI está Yes y no está ya presente.

    • GenerateReport

      Genera un resumen del resultado de la recopilación de registros, que incluye la ubicación del registro y cualquier error en los pasos.

  7. Una vez finalizada, revise la sección de resultados para ver los resultados detallados de la ejecución.

Referencias

Automatización de Systems Manager