View a markdown version of this page

AWSSupport-CollectSAPHANALogs - AWS Systems Manager Referencia del manual de procedimientos 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 una instancia de SAP en fase de implementación. AWS La instancia de Amazon EC2 debe ser gestionada por AWS Systems Manager (Systems Manager). El manual comprueba si hay paquetes necesarios y los instala si faltan, ejecuta la herramienta de recopilación de registros adecuada para el sistema operativo detectado y, de forma opcional, carga los registros recopilados en un bucket 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 La ejecución de este runbook puede instalar paquetes adicionales en la instancia Amazon EC2 de destino. Debe confirmarlo configurando el Acknowledgement parámetro en. Yes El almacenamiento de registros en Amazon S3 conlleva los 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 12 SP5

  • 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, instalado si InstallAWSCLI está establecido 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

    Tipo: AWS: :EC2: :Instance: :Id

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

  • Reconocimiento

    Tipo: cadena

    Valores válidos: Yes

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

  • S3LogDestination

    Escriba: AWS: :S3: :Bucket: :Name

    Descripción: (opcional) El nombre del bucket 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 proporcionan, 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

  • Instale AWS CLI

    Tipo: cadena

    Valores válidos: Yes | No

    Valor predeterminado: No

    Descripción: (opcional) Si se debe instalar la AWS CLI en la instancia. Si es Yes así, 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 que tenga un de. PingStatus Online El manual de operaciones se cancela si la instancia no se administra.

  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. Los paquetes necesarios se instalan si faltan.

  4. BranchOnS3BucketProvided- Diversifica la ejecución en función de si se ha proporcionado 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 el cifrado del lado del servidor (SSE) y si permite permisos de acceso de lectura o escritura anónimos o públicos. También verifica que el propietario real del bucket sea el mismo que el propietario esperado del bucket. Si este paso no funciona, el runbook continúa GenerateReport sin cargarse.

  6. UploadLogsToS3- Carga los registros recopilados en el bucket de Amazon S3 especificado. Si InstallAWSCLI se establece 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, incluye el nombre del bucket de Amazon S3 y el prefijo en el que 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 una 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-CollectSAPHANALogs el Administrador de Sistemas, en la sección Documentos.

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

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

    • AutomationAssumeRole (Opcional):

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

    • ID de instancia (obligatorio):

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

    • Reconocimiento (obligatorio):

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

    • S3LogDestination (Opcional):

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

    • Prefijo S3 (opcional):

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

    • Instale AWS CLI (opcional):

      Seleccione Yes 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 que tenga un PingStatus de. Online

    • GetInstanceInformation

      Recupera información sobre la instancia 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 el 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 aún no está presente.

    • GenerateReport

      Genera un resumen del resultado de la recopilación de registros, incluida la ubicación del registro y los errores de los pasos.

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

Referencias

Automatización de Systems Manager