# Tutorial: Configurar o monitoramento para SAP HANA
Este tutorial demonstra como configurar o CloudWatch Application Insights para estabelecer o monitoramento para seus bancos de dados SAP HANA. Você pode usar os painéis automáticos do CloudWatch Application Insights para visualizar detalhes do problema, acelerar a solução de problemas e facilitar o tempo médio de resolução (MTTR) para seus bancos de dados SAP HANA.
**Topics**
+ [Ambientes compatíveis](#appinsights-tutorial-sap-hana-supported-environments)
+ [Sistemas operacionais compatíveis](#appinsights-tutorial-sap-hana-supported-os)
+ [Recursos](#appinsights-tutorial-sap-hana-features)
+ [Pré-requisitos](#appinsights-tutorial-sap-hana-prerequisites)
+ [Configurar o monitoramento](#appinsights-tutorial-sap-hana-set-up)
+ [Gerenciar monitoramento](#appinsights-tutorial-sap-hana-manage)
+ [Solução de problemas detectados](#appinsights-tutorial-sap-hana-troubleshooting)
+ [Detecção de anomalias](#appinsights-tutorial-sap-hana-troubleshooting-anomaly-detection)
+ [Solução de problemas do Application Insights](#appinsights-tutorial-sap-hana-troubleshooting-health-dashboard)
## Ambientes compatíveis
O CloudWatch Application Insights oferece suporte à implantação de recursos da AWS para os sistemas e padrões a seguir. Você fornece e instala o software de banco de dados SAP HANA e o software de aplicação SAP compatível.
+ **Banco de dados SAP HANA em uma única instância do Amazon EC2**: SAP HANA em uma arquitetura de aumento na escala vertical em nó único, com até 24 TB de memória.
+ **Banco de dados SAP HANA em várias instâncias do Amazon EC2**: SAP HANA em uma arquitetura de redução da escala em vários nós.
+ **Configuração de alta disponibilidade do banco de dados SAP HANA Cross-AZ**: SAP HANA com alta disponibilidade configurada em duas zonas de disponibilidade usando clustering SUSE/RHEL.
**nota**
O CloudWatch Application Insights oferece suporte apenas a ambientes SID HANA únicos. Se houver vários SID HANA conectados, o monitoramento será configurado apenas para o primeiro SID detectado.
## Sistemas operacionais compatíveis
O CloudWatch Application Insights para SAP HANA é compatível com a arquitetura x86-64 nos seguintes sistemas operacionais:
+ SuSE Linux 12 SP4 para SAP
+ SuSE Linux 12 SP5 para SAP
+ SUSE Linux 15
+ SuSE Linux 15 SP1
+ SuSE Linux 15 SP2
+ SuSE Linux 15 para SAP
+ SuSE Linux 15 SP1 para SAP
+ SuSE Linux 15 SP2 para SAP
+ SuSE Linux 15 SP3 para SAP
+ SuSE Linux 15 SP4 para SAP
+ SuSE Linux 15 SP5 para SAP
+ RedHat Linux 8.6 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 8.5 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 8.4 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 8.3 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 8.2 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 8.1 para SAP com alta disponibilidade e serviços de atualização
+ RedHat Linux 7.9 para SAP com alta disponibilidade e serviços de atualização
## Recursos
O CloudWatch Application Insights para SAP HANA fornece os seguintes recursos:
+ Detecção automática de workload SAP HANA
+ Criação automática de alarmes SAP HANA com base no limite estático
+ Criação automática de alarmes SAP HANA com base na detecção de anomalias
+ Reconhecimento automático de padrões de log SAP HANA
+ Painel de integridade para o SAP HANA
+ Painel de problemas para o SAP HANA
## Pré-requisitos
É necessário cumprir os seguintes pré-requisitos para configurar um banco de dados SAP HANA com o CloudWatch Application Insights:
+ **SAP HANA**: instalar um banco de dados SAP HANA 2.0 SPS05 que esteja em execução e seja acessível em uma instância do Amazon EC2.
+ **Usuário do banco de dados SAP HANA**: um usuário de banco de dados com perfis de monitoramento deve ser criado no banco de dados SYSTEM e em todos os locatários.
**Exemplo**
Os comandos SQL a seguir criam um usuário com funções de monitoramento.
```
su - adm
hdbsql -u SYSTEM -p -d SYSTEMDB
CREATE USER CW_HANADB_EXPORTER_USER PASSWORD NO FORCE_FIRST_PASSWORD_CHANGE;
CREATE ROLE CW_HANADB_EXPORTER_ROLE;
GRANT MONITORING TO CW_HANADB_EXPORTER_ROLE;
GRANT CW_HANADB_EXPORTER_ROLE TO CW_HANADB_EXPORTER_USER;
```
+ **Python 3.8**: instalar a versão Python 3.8 ou versões posteriores em seu sistema operacional. Use a versão mais recente do Python. Se o Python3 não for detectado em seu sistema operacional, a versão Python 3.6 será instalada.
Para obter mais informações, consulte a [installation example](#install).
**nota**
A instalação manual da versão Python 3.8 ou de versões posteriores é obrigatória para os sistemas operacionais SuSE Linux 15 SP4, RedHat Linux 8.6 e versões posteriores.
+ **Pip3**: instalar o programa instalador, pip3, em seu sistema operacional. Se o pip3 não for detectado em seu sistema operacional, ele será instalado.
+ **hdbclient**: o CloudWatch Application Insights usa o driver Python para efetuar a conexão com o banco de dados SAP HANA. Se o cliente não tiver realizado a instalação usando python3, certifique-se de ter o arquivo hdbclient em tar na versão `2.10 or later` em `/hana/shared/SID/hdbclient/`.
+ **Agente do Amazon CloudWatch**: verificar que um agente preexistente do CloudWatch não esteja em execução na sua instância do Amazon EC2. Se você tiver o agente do CloudWatch instalado, certifique-se de remover do seu arquivo de configuração existente a configuração dos recursos que você está usando no CloudWatch Application Insights, para evitar conflito de mesclagem. Para obter mais informações, consulte [Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch](CloudWatch-Agent-Configuration-File-Details.md).
+ **Habilitação do AWS Systems Manager**: instalar o SSM Agent em suas instâncias, que deverão estar habilitadas para o SSM. Para obter informações sobre como instalar o SSM Agent, consulte [Trabalhar com o SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html) no *Guia do usuário do AWS Systems Manager*.
+ **Perfis de instância do Amazon EC2**: você deve anexar os perfis de instância do Amazon EC2 a seguir para configurar seu banco de dados.
+ Você deve anexar o perfil do `AmazonSSMManagedInstanceCore` para habilitar o Systems Manager. Para obter mais informações, consulte [exemplos de políticas baseadas em identidade do AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html).
+ Deve-se anexar o `CloudWatchAgentServerPolicy` para permitir que métricas e logs de instância sejam emitidos por meio do CloudWatch. Para obter mais informações, consulte [Criar perfis e usuários do IAM para uso com o agente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-iam-roles-for-cloudwatch-agent.html).
+ Você deve anexar a seguinte política em linha do IAM à função de instância do Amazon EC2 para leitura da senha armazenada no AWS Secrets Manager. Para obter mais informações sobre políticas em linha, consulte [Políticas em linha](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) no *Guia do usuário do AWS Identity and Access Management*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:ApplicationInsights-*"
}
]
}
```
------
+ **Grupos de recursos da AWS**: você deve criar um grupo de recursos que inclua todos os recursos associados da AWS usados pela pilha de aplicações para integrar suas aplicações ao CloudWatch Application Insights. Isso inclui instâncias do Amazon EC2 e volumes do Amazon EBS que executam seu banco de dados SAP HANA. Se houver vários bancos de dados por conta, recomendamos criar um grupo de recursos que inclua os recursos da AWS para cada sistema de banco de dados SAP HANA.
+ **Permissões do IAM**: para usuários não administradores:
+ é necessário criar uma política do AWS Identity and Access Management (IAM) que permita ao Application Insights criar uma função vinculada ao serviço e anexá-la à sua identidade do usuário. Para obter as etapas para anexar a política, consulte [Política do IAM para o CloudWatch Application Insights](appinsights-iam.md).
+ O usuário deve ter a permissão para criar um segredo no AWS Secrets Manager para armazenar as credenciais do usuário do banco de dados. Para obter mais informações, consulte [Exemplo: permissão para criar segredos](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access_examples.html#auth-and-access_examples_create).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:CreateSecret"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:ApplicationInsights-*"
}
]
}
```
------
+ **Perfil vinculado ao serviço**: o Application Insights usa os perfis vinculadas ao serviço do AWS Identity and Access Management (IAM). Ao criar a primeira aplicação com o Application Insights, é criada uma função vinculada ao serviço no console do Application Insights. Para obter mais informações, consulte [Usar funções vinculadas ao serviço do CloudWatch Application Insights](CHAP_using-service-linked-roles-appinsights.md).
## Configurar seu banco de dados SAP HANA para monitoramento
Use as etapas a seguir para configurar o monitoramento para seu banco de dados SAP HANA
1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. No painel de navegação esquerdo, em **Insights**, escolha **Application Insights**.
1. A página **Application Insights** exibe a lista de aplicações que são monitoradas pelo Application Insights e o status de monitoramento de cada aplicação. No canto superior direito, escolha **Add an application** (Adicionar uma aplicação).
1. Na página **Specify application details** (Especificar os detalhes da aplicação), na lista suspensa em **Resource group** (Grupo de recursos), selecione o grupo de recursos da AWS que contém seus recursos de banco de dados SAP HANA. Se ainda não tiver criado um grupo de recursos para a aplicação, você poderá criar um escolhendo **Create new resource group** (Criar grupo de recursos) na lista suspensa **Resource group** (Grupo de recursos). Para obter mais informações sobre grupos de recursos, consulte o [https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html](https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html)
1. Em **Monitor CloudWatch Events** (Monitorar CloudWatch Events), marque a caixa de seleção para integrar o monitoramento do Application Insights com o CloudWatch Events para obter insights do Amazon EBS, Amazon EC2, AWS CodeDeploy, Amazon ECS, APIs e notificações do AWS Health, Amazon RDS, Amazon S3 e AWS Step Functions.
1. Em **Integrar com o OpsCenter do AWS Systems Manager**, marque a caixa de seleção ao lado de **Gerar OpsItems do OpsCenter do AWS Systems Manager para ações corretivas** para visualizar e receber notificações quando forem detectados problemas nas aplicações selecionadas. Para rastrear as operações realizadas para resolver itens de trabalho operacionais denominados OpsItems, que são relacionados aos recursos da AWS, forneça um ARN do tópico do SNS.
1. É possível, opcionalmente, inserir etiquetas para ajudar a identificar e organizar seus recursos. O CloudWatch Application Insights é compatível com os grupos de recursos baseados em tags e em filas do CloudFormation, exceto os grupos do Application Auto Scaling). Para obter mais informações, consulte [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) (Editor de etiquetas) no *Guia do usuário do AWS Resource Groups*.
1. Escolha **Next** (Próximo) para continuar a configurar o monitoramento.
1. Na página **Revisar componentes detectados**, são listados os componentes monitorados e suas workloads automaticamente detectadas pelo CloudWatch Application Insights.
1. Para adicionar workloads a um componente que contenha uma workload de nó único detectada do SAP HANA, selecione o componente e escolha **Editar componente**.
**nota**
Os componentes que contêm uma workload detectada de vários nós do SAP HANA ou de alta disponibilidade do HANA oferecem suporte a apenas uma workload em um componente.
1. Para adicionar uma nova workload, escolha **Adicionar nova workload**.
1. Quando terminar de editar workloads, escolha **Salvar alterações**.
1. Escolha **Próximo**.
1. Na página **Especificar detalhes do componente**, insira o seu nome e senha de usuário.
1. Revise a configuração de monitoramento de aplicações e escolha **Submit** (Enviar).
1. A página de detalhes da aplicação se abrirá, e nela serápossível visualizar o **Resumo da aplicação**, a lista de **Componentes e workloads monitoradas** e de **Componentes e workloads não monitoradas**. Ao selecionar o botão de opção ao lado de um componente ou workload, também será possível visualizar o **Histórico de configuração**, os **Padrões de log** e quaisquer **Tags** criadas. Quando você envia sua configuração, sua conta implanta todas as métricas e alarmes para o sistema SAP HANA, o que pode levar até duas horas.
## Gerenciar o monitoramento de seu banco de dados SAP HANA
Você pode gerenciar credenciais de usuário, métricas e caminhos de log para o banco de dados SAP HANA executando as seguintes etapas:
1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. No painel de navegação esquerdo, em **Insights**, escolha **Application Insights**.
1. A página **Application Insights** exibe a lista de aplicações que são monitoradas pelo Application Insights e o status de monitoramento de cada aplicação.
1. Em **Componentes monitorados**, selecione o botão ao lado do nome do componente. Em seguida, escolha **Manage monitoring** (Gerenciar o monitoramento).
1. Em **EC2 instance group logs** (Logs de grupos de instâncias do EC2), é possível atualizar o caminho de log existente, o conjunto de padrões de log e o nome do grupo de logs. Além disso, você pode adicionar até outros três **Application logs** (Logs de aplicações).
1. Em **Metrics** (Métricas), você pode escolher as métricas SAP HANA de acordo com suas necessidades. Os nomes das métricas SAP HANA são prefixados com `hanadb`. Você pode adicionar até 40 métricas por componente.
1. Em **HANA configuration** (Configuração do HANA), insira a senha e o nome de usuário para o banco de dados SAP HANA. Este é o nome de usuário e a senha que o agente do Amazon CloudWatch usa para efetuar a conexão com o banco de dados SAP HANA.
1. Em **Custom alarms** (Alarmes personalizados), é possível pode adicionar alarmes extras para serem monitorados pelo CloudWatch Application Insights.
1. Revise a configuração de monitoramento de aplicações e escolha **Submit** (Enviar). Quando você envia sua configuração, sua conta atualiza todas as métricas e alarmes do sistema SAP HANA, o que pode levar até duas horas.
## Visualizar e solucionar problemas detectados pelo CloudWatch Application Insights
As seções a seguir fornecem etapas para ajudar a resolver cenários comuns de solução de problemas que ocorrem quando você configura o monitoramento para SAP HANA no Application Insights.
**Topics**
+ [Banco de dados SAP HANA atinge o limite de alocação de memória](#appinsights-tutorial-sap-hana-troubleshooting-memory)
+ [Evento de disco cheio](#appinsights-tutorial-sap-hana-troubleshooting-disk-full)
+ [O backup SAP HANA parou de ser executado](#appinsights-tutorial-sap-hana-troubleshooting-backup-stopped)
### Banco de dados SAP HANA atinge o limite de alocação de memória
**Descrição**
Sua aplicação SAP que é apoiado por um banco de dados SAP HANA apresenta um funcionamento defeituoso devido à alta pressão de memória, levando à degradação da performance da aplicação.
**Resolução**
É possível identificar a camada da aplicação que está causando o problema conferindo o painel criado dinamicamente que mostra as métricas relacionadas e os trechos do arquivo de log. No exemplo a seguir, o problema pode ocorrer devido a uma grande carga de dados no sistema SAP HANA.
A alocação de memória usada excede o limite de 80% do limite total de alocação de memória.
O grupo de logs mostra o esquema `BNR-DATA` e a tabela `IMDBMASTER_30003` ficou sem memória. Além disso, o grupo de logs mostra a hora exata do problema, o limite de localização global atual, a memória compartilhada, o tamanho do código e o tamanho da alocação de reserva OOM.
### Evento de disco cheio
**Descrição**
Sua aplicação SAP que é apoiada por um banco de dados SAP HANA deixa de responder, o que leva a uma incapacidade de acessar o banco de dados.
**Resolução**
É possível identificar a camada do banco de dados que está causando o problema conferindo o painel criado dinamicamente que mostra as métricas relacionadas e os trechos do arquivo de log. No exemplo a seguir, o problema pode ter sido causado por falha do administrador ao habilitar o backup automático de log, o que fez com que o diretório sap/hana/log fosse preenchido.
O widget do grupo de log no painel de problemas exibe o evento `DISKFULL`.
### O backup SAP HANA parou de ser executado
**Descrição**
Sua aplicação SAP com suporte de um banco de dados SAP HANA parou de funcionar.
**Resolução**
É possível identificar a camada do banco de dados que está causando o problema conferindo o painel criado dinamicamente que mostra as métricas relacionadas e os trechos do arquivo de log.
O widget do grupo de log no painel de problemas exibe o evento `ACCESS DENIED`. Isso inclui informações adicionais, como o bucket do S3, a pasta do bucket do S3 e a região do bucket do S3.
## Detecção de anomalias para o SAP HANA
Para métricas específicas do SAP HANA, como o número de contagens de threads, o CloudWatch aplica algoritmos estatísticos e de machine learning para definir o limite. Esses algoritmos analisam continuamente métricas do banco de dados SAP HANA, determinam linhas de base normais e apontam anomalias com intervenção mínima do usuário. Os algoritmos geram um modelo de detecção de anomalia, o que gera um intervalo de valores esperados que representam o comportamento normal da métrica.
Os algoritmos de detecção de anomalias consideram a sazonalidade e as mudanças de tendência das métricas. As mudanças de sazonalidade podem ser por hora, dia ou semana, conforme mostrado nos exemplos de uso da CPU do SAP HANA.
Depois de criar um modelo, a detecção de anomalias do CloudWatch avaliará continuamente o modelo e fará ajustes para garantir que ele seja o mais preciso possível. Isso inclui treinar novamente o modelo para ajustes caso os valores da métrica evoluam ao longo do tempo ou sofram mudanças repentinas. Também inclui preditores para melhorar os modelos de métricas sazonais, pontiagudas ou esparsas.
## Solução de problemas do Application Insights para o SAP HANA
Esta seção fornece etapas para ajudar você a resolver erros comuns retornados pelo painel do Application Insights.
### Não foi possível adicionar mais de 60 métricas monitoradas
A saída mostra o erro apresentado a seguir.
```
Component cannot have more than 60 monitored metrics
```
**Principal causa**: no momento, o limite de métricas é de 60 métricas monitoradas por componente.
**Resolução**: para permanecer abaixo do limite, remova as métricas que não são necessárias.
### Nenhuma métrica SAP é exibida após o processo de integração
Use as informações apresentadas a seguir para descobrir o motivo pelo qual as métricas SAP não são exibidas no painel após o processo de integração. A primeira etapa é solucionar problemas relacionados às métricas SAP que não estão sendo exibidas usando o Console de gerenciamento da AWS ou os logs do exportador de uma instância do Amazon EC2. Em seguida, faça uma análise da saída do erro para encontrar uma solução.
#### Como solucionar problemas relacionados às métricas SAP que não são exibidas após a integração
É possível usar o Console de gerenciamento da AWS ou os logs do exportador de uma instância do Amazon EC2 para solucionar problemas.
------
#### [ Console de gerenciamento da AWS ]
**Como solucionar problemas relacionados às métricas SAP que não são exibidas após a integração usando o console**
1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. No painel de navegação à esquerda, escolha **Gerenciador de estados**.
1. Em **Associações**, verifique o status do documento `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure`. Se o status for `Failed`, em **ID da execução**, selecione o ID com falha e visualize a saída.
1. Em **Associações**, verifique o status do documento `AWS-ConfigureAWSPackage`. Se o status for `Failed`, em **ID da execução**, selecione o ID com falha e visualize a saída.
------
#### [ Exporter logs from Amazon EC2 instance ]
**Como solucionar problemas relacionados às métricas SAP que não são exibidas após a integração usando os logs do exportador**
1. Conecte-se à instância do Amazon EC2 na qual seu banco de dados SAP HANA está em execução.
1. Encontre a convenção de nomenclatura mais adequada para `WORKLOAD_SHORT_NAME` usando o comando apresentado a seguir. Você usará esse nome abreviado nas duas etapas a seguir.
```
sudo systemctl | grep exporter
```
**nota**
O Application Insights adiciona um sufixo, `WORKLOAD_SHORT_NAME`, ao nome do serviço, dependendo da workload que está em execução. Os nomes abreviados para nó único, múltiplos nós e implantações de alta disponibilidade do SAP HANA são `HANA_SN`, `HANA_MN` e `HANA_HA`.
1. Para verificar se há erros nos logs de serviço do gerenciador do exportador, execute o comando apresentado a seguir, substituindo `WORKLOAD_SHORT_NAME` pelo nome abreviado encontrado na [Step 2](#step-find-short-name).
```
sudo journalctl -e --unit=prometheus-hanadb_exporter_manager_{{WORKLOAD_SHORT_NAME}}.service
```
1. Se os logs de serviço do gerenciador do exportador não mostrarem um erro, verifique se há erros nos logs do serviço do exportador ao executar o comando apresentado a seguir.
```
sudo journalctl -e --unit=prometheus-hanadb_exporter_{{WORKLOAD_SHORT_NAME}}.service
```
------
#### Como resolver as principais causas conhecidas do problema de métricas SAP que não são exibidas após a integração
Os exemplos apresentados a seguir descrevem como resolver as principais causas conhecidas de métricas SAP que não são exibidas após a integração.
+ A saída mostra o erro apresentado a seguir.
```
Reading json config file path: /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.d/default ...
Reading json config file path: /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.d/ssm_AmazonCloudWatch-ApplicationInsights-SSMParameterForTESTCWEC2INSTANCEi0d88867f1f3e36285.tmp ...
2023/11/30 22:25:17 Failed to merge multiple json config files.
2023/11/30 22:25:17 Failed to merge multiple json config files.
2023/11/30 22:25:17 Under path : /metrics/append_dimensions | Error : Different values are specified for append_dimensions
2023/11/30 22:25:17 Under path : /metrics/metrics_collected/disk | Error : Different values are specified for disk
2023/11/30 22:25:17 Under path : /metrics/metrics_collected/mem | Error : Different values are specified for mem
2023/11/30 22:25:17 Configuration validation first phase failed. Agent version: 1.0. Verify the JSON input is only using features supported by this version.
```
**Resolução**: o Application Insights está tentando configurar métricas semelhantes que foram configuradas previamente como parte do arquivo de configuração existente do agente do CloudWatch. Remova os arquivos existentes em `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.d/` ou remova as métricas que estão causando o conflito para o arquivo de configuração existente do agente do CloudWatch.
+ A saída mostra o erro apresentado a seguir.
```
Unable to find a host with system database, for more info rerun using -v
```
**Resolução**: o nome de usuário, a senha ou a porta do banco de dados podem estar incorretos. Verifique se o nome de usuário, a senha e a porta são válidos e, em seguida, execute novamente o processo de integração.
+ A saída mostra o erro apresentado a seguir.
```
This hdbcli installer is not compatible with your Python interpreter
```
**Resolução**: atualize o instalador pip3 e o formato wheel, conforme mostrado no exemplo a seguir, para a versão Python 3.6.
```
python3.6 -m pip install --upgrade pip setuptools wheel
```
+ A saída mostra o erro apresentado a seguir.
```
Unable to install hdbcli using pip3. Please try to install it
```
**Resolução**: certifique-se de ter seguido os pré-requisitos do `hdbclient` ou instale o `hdbclient` manualmente no pip3.
+ A saída mostra o erro apresentado a seguir.
```
Package 'boto3' requires a different Python: 3.6.15 not in '>= 3.7'
```
**Resolução**: a versão Python 3.8 ou versões posteriores são necessárias para usar essa versão do sistema operacional. Verifique os pré-requisitos da versão Python 3.8 e instale-a.
+ A saída mostra um dos erros de instalação apresentados a seguir.
```
Can not execute `setup.py` since setuptools is not available in the build environment
```
ou
```
[SSL: CERTIFICATE_VERIFY_FAILED]
```
**Resolução**: instale o Python usando comandos do SUSE Linux, conforme mostrado no exemplo a seguir. O exemplo apresentado a seguir realiza a instalação da versão mais recente do [Python 3.8](https://www.python.org/downloads/).
```
wget https://www.python.org/ftp/python/3.8./Python-3.8..tgz
tar xf Python-3.*
cd Python-3.*/
sudo zypper install make gcc-c++ gcc automake autoconf libtool
sudo zypper install zlib-devel
sudo zypper install libopenssl-devel libffi-devel
./configure --with-ensurepip=install
sudo make
sudo make install
sudo su
python3.8 -m pip install --upgrade pip setuptools wheel
```