Escolar Documentos
Profissional Documentos
Cultura Documentos
SAP Note
Atenção Este é um documento traduzido automaticamente que não foi revisado para garantir
acuracidade.
Sintoma
Ocorreu um erro no hdblcm da ferramenta de administração do ciclo de vida da plataforma SAP HANA
Esta nota descreve alguns problemas comuns que podem ocorrer e as etapas que você pode efetuar para
solucionar e resolver os mesmos.
Você também pode verificar primeiro a nota SAP, descrevendo problemas conhecidos com hdblcm -
http://service.sap.com/sap/support/notes/2082466 (/sap/support/notes/2082466)
1. Você está usando a IU da Web do gerenciador de ciclo de vida do banco de dados SAP HANA
(hdblcm) a partir do navegador da Web independente
1.1.1.1. Funciona – consulte Resolvendo problemas com a integração do SAP Host Agent
1.1.1.2. Você não recebe nenhuma resposta do servidor - consulte Resolvendo problemas com
acesso ao agente de host SAP
1.1.1.3. Você recebe uma mensagem de página não encontrada (404 Not Found) ou alguma
outra mensagem de erro estranha - consulte Resolvendo problemas com a instalação do hdblcm
1.2. Você recebe uma mensagem de página não encontrada (404 Not Found) ou alguma outra mensagem
de erro estranha – consulte Resolvendo problemas com a instalação do hdblcm
1.3.2. Consulte a seção Como rastrear erros e coletar arquivos de log para obter instruções sobre
como coletar os logs necessários, para que seu problema seja resolvido mais rapidamente
1.4. A página principal é aberta, mas quando você clica em um bloco, ocorre uma caixa de diálogo de erro
– consulte Resolvendo problemas com a instalação do hdblcm
1.5. A página principal é aberta, os blocos podem ser clicados, mas um cenário não funciona como
esperado e mostra um erro - consulte a seguinte nota
SAP: http://service.sap.com/sap/support/notes/2082466 (/sap/support/notes/2082466)
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 1/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
1.6. Outro problema – consulte Como rastrear erros e coletar arquivos de log
2. Você está usando o gerenciador do ciclo de vida do banco de dados SAP HANA (hdblcm) no console
ou no modo GUI nativo
2.2. Se você não encontrar seu problema na nota SAP da etapa 3.1., consulte Como rastrear erros e
coletar arquivos de log
Se você não encontrou uma solução para seu problema nesta nota, abra um novo incidente no componente
HAN-LM-PLT. Leia a seção Como rastrear erros e coletar arquivos de log para ver de onde coletar os arquivos
de log necessários.
Outros termos
solução de problemas de hdblcm, solução de problemas de IU WEB hdblcm, ferramenta de gerenciamento do
ciclo de vida da plataforma SAP HANA, instalação, atualização e configuração do SAP HANA, banco de dados
SAP HANA, banco de dados SAP HANA, agente de host SAP, NewDB, banco de dados in-memory, banco de
dados híbrido
Motivo e pré-requisitos
Você está utilizando a plataforma SAP HANA, incluindo o banco de dados SAP HANA.
Você está usando a ferramenta de administração do ciclo de vida da plataforma SAP HANA hdblcm.
Solução
Resolução de problemas com a integração do SAP Host Agent
Por algum motivo, você não tem acesso ao agente de host SAP, que serve a IU Web do gerenciador
do ciclo de vida do banco de dados SAP HANA (hdblcm). Podem existir vários motivos para isso:
1. Certifique-se de ter digitado o nome do host do HANA corretamente no URL da IU da Web hdblcm
2. Certifique-se de que a porta 1129 está aberta e que não há nenhum software instalado que impeça
o acesso a esta porta
A IU Web do gerenciador do ciclo de vida do banco de dados SAP HANA exige que o agente de
host SAP possa operar. Efetue login no host do HANA via SSH e digite no console:
/usr/sap/hostctrl/exe/saphostexec -status
3.1. Se o agente de host SAP não estiver sendo executado, inicie-o utilizando o comando
/usr/sap/hostctrl/exe/saphostexec -reset e certifique-se de que ele tenha iniciado novamente a
utilização da opção -status
3.2. Se o caminho /usr/sap/hostctrl/exe/saphostexec não existir, isso significa que não está
instalado nenhum agente de host SAP no sistema. Para instalá-lo, use o seguinte comando:
/usr/sap/<SID>/SYS/global/hdb/saphostagent_setup/saphostexec -install
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 2/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
Após a instalação, você precisa configurar o acesso HTTPS. Consulte a seção Configuração de
HTTPS para agente de host SAP
Você também precisa configurar o agente de host SAP para servir a IU na Web do hdblcm. Veja
a seção Resolvendo problemas com a instalação do hdblcm
Se a IU da Web não puder ser aberta via HTTPS, mas abrir via HTTP, isso significa que o agente de
host SAP no host HANA não está configurado para utilizar HTTPS.
Para ativar a comunicação segura com o agente de host SAP por meio de HTTPS, o agente de host
SAP precisa ter um certificado Secure Sockets Layer (SSL) em seu diretório de segurança.
Este certificado também é utilizado pela interface do usuário na Web do gerenciador do ciclo de vida
do banco de dados SAP HANA (hdblcm), uma vez que as páginas da Web são disponibilizadas pelo
agente de host SAP. O gerenciador do ciclo de vida do banco de dados SAP HANA automatiza esse
processo e, durante a instalação, atualização ou renomeação de um sistema, ou durante a adição de
novos hosts, gera um certificado autoassinado.
Para usar o hdblcm para gerar automaticamente um certificado SSL autoassinado, execute o seguinte
comando. Por padrão, o proprietário do certificado é o nome do host do SAP HANA. Se você quiser
modificá-lo, pode usar a opção de chamada --certificate_hostname.
Se você quiser utilizar seus próprios certificados SSL, consulte a Configuração SSL para o agente de
host SAP
(http://help.sap.com/saphelp_nw73ehp1/helpdata/en/6a/ac42c2e742413da050eaecd57f785d/content.htm
frameset=/en/48/c6f9627a004da5e10000000a421937/frameset.htm¤t_toc=/en/21/98c443122744ef
Você tem acesso ao agente de host SAP, mas por algum motivo a IU na Web do gerenciador do ciclo de
vida do banco de dados SAP HANA não pode ser aberta ou você recebe erros quando clica em um bloco.
Siga as etapas abaixo para poder identificar a causa principal do problema.
Por padrão, durante a instalação ou atualização de um sistema SAP HANA com hdblcm, a ferramenta
se instala junto com o sistema. Pode ser que seu sistema SAP HANA tenha sido instalado e/ou
atualizado diretamente com hdbinst ou hdbupd. Como resultado, pode não haver hdblcm no sistema
ou sua versão pode ser mais antiga que a versão do servidor SAP HANA. Verifique se o seguinte
caminho existe: <sapmnt>/<SID>/hdblcm
2.1 Se não existir, isso significa que o hdblcm não está instalado.
Para instalá-lo, você precisa do kit de instalação do servidor SAP HANA, que foi utilizado pela
última vez para instalar ou atualizar o sistema SAP HANA. Certifique-se de que a versão no
manifesto do kit de instalação corresponda à versão do sistema HANA instalado. Execute o
seguinte comando do kit de instalação:
2.2 Se existir, certifique-se de que sua versão corresponde à versão do banco de dados SAP HANA.
Se as versões forem diferentes, siga as instruções na etapa 2.1 para atualizar hdblcm.
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 3/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
Verificar versão hdblcm: cat <sapmnt>/<SID>/hdblcm/instruntime/manifest | grep fullversion
Certifique-se de que você tem a versão correta do agente de host SAP. A versão mínima necessária
do agente de host é 197. Você pode verificar a versão do seu agente de host SAP por meio do
seguinte comando:
/usr/sap/hostctrl/exe/saphostexec -version
Se a versão for inferior a 197, atualize o agente de host SAP com o seguinte comando:
/usr/sap/<SID>/SYS/global/hdb/saphostagent_setup/saphostexec -upgrade
Por padrão, e se não estiver explicitamente desativado, durante a atualização de um sistema SAP
HANA, o agente de host SAP também será atualizado.
Se vários arquivos SAR do componente SAP HANA tiverem sido baixados e extraídos em um único
diretório, pode acontecer que o arquivo SIGNATURE.SMF do arquivo do banco de dados SAP HANA
seja substituído por alguma assinatura de outro componente. Como resultado, o SIGNATURE.SMF
incorreto é copiado para o diretório <sapmnt>/<SID>/hdblcm, de modo que o agente de host SAP não
pode verificar e implementar a ferramenta hdblcm.
Por padrão, durante a instalação ou atualização do sistema SAP HANA, o hdblcm configura o agente
de host SAP para servir sua IU da Web. Por algum motivo, isso pode não ter ocorrido, por exemplo,
devido a uma falha durante o procedimento de instalação/atualização ou se o agente de host SAP
tiver sido reinstalado manualmente posteriormente.
Para atualizar a integração do hdblcm no host do SAP HANA, execute o seguinte comando:
/usr/sap/hostctrl/exe/saphostexec -reset
compatibilidade do navegador
Certifique-se de que você está utilizando um dos seguintes browsers, dependendo do sistema operacional:
Microsoft Windows
Microsoft Edge
Mozilla Firefox - Versão mais recente e Extended Support Release
Google Chrome - Versão mais recente
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 4/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
Para mais informações sobre Web browsers suportados para a interface Web do gerenciador do ciclo de
vida do banco de dados SAP HANA, consulte o suporte de browser para biblioteca sap.m no Guia do
desenvolvedor SAPUI5
(https://sapui5.netweaver.ondemand.com/sdk/#docs/guide/91f079dc6f4d1014b6dd926db0e91070.html).
Esta seção descreve como coletar as informações necessárias pelo suporte da SAP para causa-raiz e
corrigir seu problema.
Em tais situações, seria muito útil para o suporte se você pudesse abrir um console (erro) do seu
navegador e verificar se há erros lá. Se você vir erros no console, anexe-os ao incidente.
Outra informação muito útil para a análise da causa raiz seria analisar as solicitações do servidor que
seu navegador da Web executa e se houver alguma solicitação com falha – anexe-as também à
ocorrência. Normalmente, isso pode ser monitorado por meio das ferramentas de desenvolvedor do
navegador.
2. Se você estiver utilizando a interface do usuário na Web e receber um erro, que não reporta
informações significativas, você pode efetuar o logon no sistema via SSH e verificar os seguintes arquivos
de log para obter informações significativas, o que pode ajudar você a encontrar a causa principal e
resolver o problema:
hostexec/trace = 3
serviço/rastreamento = 3
3. Se você receber um erro durante a execução de um processo, poderá verificar os logs de erros das
diferentes ferramentas de administração do ciclo de vida hdb*, localizadas em /var/tmp. Em geral, a
interface do usuário deve ter indicado o arquivo de log exato, contendo o erro, mas às vezes esses logs
estão localizados nos hosts remotos e não são acessíveis diretamente a partir da interface Web/GUI
nativa.
Ao analisar os logs, recomendamos que você comece com o arquivo de log da etapa/componente,
indicado na IU como falhado. Se você não encontrar aí o motivo da falha, verifique o log hdblcm. Ele
contém a saída de todas as ferramentas de componente orquestradas e aí é fácil identificar onde está o
problema para a falha. Se alguma das ferramentas orquestradas falhou, ela deve ter reportado a
localização de seu próprio arquivo de log em uma linha, começando com "Log file writtern to ...". Preste
atenção que alguns dos arquivos de log estarão localizados nos outros hosts do sistema. O mesmo se
aplica às ferramentas de componente, porque algumas delas também orquestram outras ferramentas.
Então, em geral, a partir do log hdblcm, você deve ser capaz de obter todos os outros arquivos de log.
4. Se você estiver usando o gerenciador do ciclo de vida do banco de dados SAP HANA (hdblcm) no modo
console ou GUI nativo e não encontrar um arquivo de log, ative os rastreamentos e reproduza o problema.
Os rastreamentos podem ser ativados definindo a variável de ambiente HDB_INSTALLER_TRACE_FILE=
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 5/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
<file>.
1. Localize o arquivo SAR original do componente de servidor do SAP HANA, que foi usado para a
instalação ou atualização do sistema. Deve corresponder à revisão do banco de dados SAP HANA
2. Extrair o arquivo .SAR para um local temporário (descompactar o arquivo no diretório de extração,
transferindo a opção -manifest SIGNATURE.SMF para SAPCAR)
arquivo SIGNATURE.SMF
diretório SAP_HANA_DATABASE
/<sapmnt>/<SID>/hdblcm/SIGNATURE.SMF
/<sapmnt>/<SID>/global/hdb/SIGNATURE.SMF
/<sapmnt>/<SID>/global/hdb/install/bin/SIGNATURE.SMF
Para garantir a segurança durante sua operação, o gerenciador do ciclo de vida do banco de dados SAP
HANA (hdblcm) precisa trabalhar com o componente de banco de dados SAP HANA, assinado
oficialmente pela SAP. A assinatura do conteúdo do componente está contida em um file chamado
SIGNATURE.SMF, que é produzido por SAPCAR durante a extração do arquivo.
Se, por algum motivo, você não conseguir obter este arquivo de assinatura ou o componente de banco de
dados SAP HANA que você utiliza não tiver sido assinado com a assinatura oficial da SAP, você ainda
pode executar a instalação ou atualização. O banco de dados em si não será afetado pela assinatura em
falta. Para isso, você precisa usar hdblcm ou hdblcmgui como usuário raiz e passar o parâmetro --
ignore=check_signature_file na linha de comando. Se você efetuar isso, as seguintes funcionalidades das
ferramentas de administração do ciclo de vida do banco de dados (hdblcm, hdbinst, hdbupd, etc.) não
podem ser utilizadas posteriormente até a próxima atualização do banco de dados com assinatura válida.
A maneira mais fácil de se preparar para a atualização é usar o script shell anexado (hdblcm_prepare.sh).
Basta colocá-lo no diretório com os pacotes .SAR baixados, dar-lhe permissões de execução e executá-lo.
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 6/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
2. Copiar os pacotes do SAP HANA para o diretório local
3. Crie um diretório no qual o conteúdo do pacote possa ser descompactado (referido abaixo como
"diretório de extração"). Exemplo: /hana/local/downloads/extraído
5. Agora você pode atualizar o sistema SAP HANA com o gerenciador do ciclo de vida do banco de dados
SAP HANA (hdblcm)
Atividades manuais
3011189 HDBLCM (SAP HANA Platform Lifecycle Management) IU Web congela repentinamente ao clicar
em "Atualizar sistema e componentes" (/sap/support/notes/3011189 )
2949584 "ERRO: nenhum hash encontrado no caminho fornecido" ao tentar atualizar o HANA
(/sap/support/notes/2949584 )
2651885 Como instalar HDBLCM a partir da mídia de instalação quando o HDBLCM residente não existe
(/sap/support/notes/2651885 )
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 7/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
3020536 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.35 (/sap/support/notes/3020536 )
2981066 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.34 (/sap/support/notes/2981066 )
2960279 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.33 (/sap/support/notes/2960279 )
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 8/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
2931276 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.32 (/sap/support/notes/2931276 )
2801533 SAP HANA 2.0 SPS 02 Revisão de manutenção do banco de dados 024.10
(/sap/support/notes/2801533 )
2662546 HDBLCM - Erro na atualização da integração da instância SAP HANA em hosts remotos falhou
(/sap/support/notes/2662546 )
2739130 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.24 (/sap/support/notes/2739130 )
2728466 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.23 (/sap/support/notes/2728466 )
2710917 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.22 (/sap/support/notes/2710917 )
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 9/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
2675483 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.20 (/sap/support/notes/2675483 )
2669322 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.19 (/sap/support/notes/2669322 )
2648119 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.18 (/sap/support/notes/2648119 )
2617392 SAP HANA 1.0 SPS 12 Database Maintenance Revision 122.17 (/sap/support/notes/2617392 )
2478129 O upgrade do banco de dados HANA usando HDBLCM falhou no prompt de senha do sidadm
(/sap/support/notes/2478129 )
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&tok… 10/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
2377894 Instalação ou upgrade do SAP RTL AFL FOR SAP HANA (/sap/support/notes/2377894 )
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&toke… 11/12
22/05/2023, 09:30 2078425 - Nota de solução de problemas para a ferramenta de administra…
Anexos
File Name Fi
S
hdblcm_prepare.sh (/sap/support/sapnotes/public/services/attachment.htm? 11
iv_key=012003146900001114952014&iv_version=0024&iv_guid=303DF2588248AC4091ABC438EDECBD1C)
https://userapps.support.sap.com/sap/support/sfm/notes/print/0002078425?language=P&tok… 12/12