Guia de instalação e operações do Connector para LaMa

Este guia aborda a instalação e a configuração do Google Cloud Connector para SAP Landscape Management (Connector para LaMa) e as tarefas operacionais após a instalação do Connector.

Para instalar e configurar o Connector para LaMa, execute as seguintes etapas de alto nível:

Configure a autenticação e a autorização para as APIs do Google Cloud.
Faça o download do arquivo de instalação no Google Cloud.
Instale o Connector para o LaMa no mesmo host que o SAP Landscape Management. O host pode ser uma máquina virtual (VM) do Compute Engine ou uma máquina virtual ou física que não está no Google Cloud.
Configure a funcionalidade do Cloud Manager para Google Cloud no SAP Landscape Management.
Instale a biblioteca de armazenamento e os arquivos de operações em cada VM que hospeda um sistema SAP a ser gerenciado pelo SAP Landscape Management.

Pré-requisitos

Antes de instalar o Connector para o LaMa, você precisa instalar e configurar uma versão compatível do SAP Landscape Management. Para conferir as versões compatíveis, consulte Requisitos de software.

Instale o SAP Landscape Management de acordo com os guias de instalação do SAP Landscape Management e os princípios de design adaptável do SAP Landscape Management.

Confira mais informações em:

SAP Landscape Management (em inglês)
Design adaptável (em inglês)

Configurar a autenticação e a autorização para as APIs do Google Cloud

É necessário configurar certificados de CA e, se precisar de mais controle de acesso, uma conta de serviço do IAM.

Fazer upload do certificado de CA para comunicação da API do Google

O Connector para LaMa requer um certificado de CA para se comunicar com as APIs do Google Cloud. Verifique se os seguintes certificados estão disponíveis na visualização de CAs confiáveis da visualização do Armazenamento de chaves em Java do SAP NetWeaver.

Acesse o repositório do Google Trust Services em https://pki.goog/repository/
Na seção Fazer o download dos certificados de CA em CAs subordinadas, faça o download do certificado de CA GTS CA 1C3.
Importe o certificado seguindo as instruções na documentação do SAP NetWeaver: Como usar o armazenamento de chaves em Java AS.

Criar uma conta de serviço do IAM

A menos que você pretenda usar a conta de serviço da instância de hospedagem da VM como a conta de serviço padrão, é necessário criar uma conta de serviço do IAM para o Connector para LaMa.

Para criar uma conta de serviço para o Connector para LaMa:

No Console do Google Cloud, acesse a página Contas de serviço:

Acessar a página "Contas de serviço"
Selecione seu projeto do Google Cloud.
Clique em Criar conta de serviço.
Especifique um nome para a conta de serviço e, opcionalmente, uma descrição.
Clique em Criar e continuar.
Na etapa Conceder a essa conta de serviço acesso ao projeto, conceda à conta de serviço um papel que contenha todas as permissões exigidas pelo SAP Landscape Management. Um papel pode ser predefinido, como Compute Admin, ou é possível personalizá-lo com as permissões listadas em Permissões de recursos do IAM necessárias para o Connector para LaMa
Clique em Concluído.
Na página Contas de serviço no Console do Google Cloud, clique na conta de serviço que você acabou de criar.
No nome da conta de serviço, clique na guia Chaves.
Clique no menu Adicionar chave e selecione Criar nova chave para criar uma chave de conta de serviço.
Aceite JSON como o tipo de chave e clique em Criar. Uma chave privada é salva em seu computador. Armazene o arquivo de chave JSON em um local seguro. Mais tarde, ao configurar a função do Cloud Manager com o SAP Landscape Management, copie e cole o conteúdo do arquivo de chave no SAP Landscape Management.

Configurar a JVM para usar o Internet Protocol versão 4

Use a ferramenta Java System Properties do SAP Netweaver Administrator ou a ferramenta SAP NetWeaver Config (links em inglês) para especificar -Djava.net.preferIPv4Stack=true nos parâmetros do sistema da JVM.

Quando -Djava.net.preferIPv4Stack=true é especificado, o SAP NetWeaver usa apenas o protocolo de Internet versão 4 (IPv4).

Para mais informações, consulte Requisitos do protocolo de Internet versão 4 (IPv4).

Fazer o download do Connector para LaMa

Faça o download do Connector para LaMa do Google Cloud em um arquivo tar, gcp-connectorversion.tar, que contenha os seguintes arquivos:

O Connector para LaMa em um arquivo Java Enterprise Archive, lvm.cloud.gcp-version.ear
A biblioteca de armazenamento do SO do Cloud Manager
- No Linux: libsapacosprep_gcp-version.so
- No Windows: libsapacosprep_gcp-version.dll
As definições de operação personalizadas para o Google Cloud
Os scripts de operação que correspondem às definições da operação

Para fazer o download da versão mais recente do Connector para LaMa, entre em contato com o Cloud Customer Care. Para encontrar os dados de contato do Customer Care, acesse a página Visão geral do suporte no Console do Google Cloud. Para mais informações, consulte Como receber suporte para a SAP no Google Cloud.

Com o arquivo tar compactado, o Google Cloud também fornece um arquivo de assinatura asc, gcp-connectorversion.tar.asc, que pode ser usado para confirmar que o gcp-connectorversion.tar foi salvo corretamente.

Armazene o arquivo tar em um bucket do Cloud Storage que possa ser acessado pelo servidor do SAP Landscape Management e pelos servidores que serão gerenciados. Também é possível fazer upload dele usando a função de upload do Cloud Shell, conforme descrito em Como transferir arquivos para instâncias.

Instalar o Connector para o LaMa no servidor do SAP Landscape Management

Para instalar o Connector para o LaMa, implante um arquivo EAR no SAP NetWeaver e configure um Cloud Manager para o Google Cloud no SAP Landscape Management.

Como implantar o Connector para LaMa no SAP NetWeaver

Instale o arquivo EAR que contém o Connector para LaMa usando qualquer um dos seguintes métodos de implantação do Java para SAP NetWeaver (é necessária uma conta de usuário do SAP):

Como configurar a funcionalidade do Cloud Manager no SAP Landscape Management

Depois de instalar o Connector para o LaMa, acesse a interface do SAP Landscape Management e configure a funcionalidade do Cloud Manager para Google Cloud.

O procedimento geral para configurar o Cloud Manager é documentado pela SAP em Como configurar o Cloud Manager (em inglês).

As etapas a seguir são específicas para configurar um Cloud Manager para o Google Cloud.

Para configurar um novo Cloud Manager para o Google Cloud, execute estas etapas de configuração:

No SAP Landscape Management, acesse SAP Landscape Management Infrastructure > Cloud Managers.
Crie um novo Cloud Manager clicando em Adicionar.
Na lista de tipos de Cloud Manager instalados, escolha "Google Cloud Adapter".
Na seção Propriedades básicas:
- no campo "Rótulo", insira um nome para o Cloud Manager para o Google Cloud;
- no intervalo de monitoramento, aceite o padrão de 300 segundos;
- Não preencha os outros campos.
Se você estiver usando uma conta de serviço dedicada para o Connector para LaMa, cole o conteúdo do arquivo de chave JSON da conta de serviço no campo Conta de serviço na seção Propriedades adicionais.
Se você estiver usando a conta de serviço da VM para o Connector para LaMa, deixe a Conta de serviço em branco.
Execute o "Teste de configuração" para validar as configurações e testar a conexão com os URLs da API Google Cloud.
Escolha Próximo e Salvar no novo Cloud Manager.

As entradas nas visualizações Virtualização e Gerenciador de armazenamento são criadas automaticamente.

Somente a configuração do Cloud Manager pode ser alterada. A edição está desativada nas outras visualizações.

Como configurar a compatibilidade com endereços IP duplicados

Se as redes internas no cenário gerenciado da SAP incluem endereços IP duplicados, configure o SAP Landscape Management para usar nomes de host totalmente qualificados para mapear os sistemas SAP gerenciados.

Para usar nomes de host totalmente qualificados, marque a caixa de seleção Usar apenas nomes do host FQDN nas configurações de monitoramento do SAP Landscape Management. Para mais informações, consulte Como definir as configurações de monitoramento.

Instalar o agente do Google Cloud para SAP

Para suporte e monitoramento, o Google Cloud oferece o agente para SAP para cargas de trabalho SAP em execução nas instâncias de VM do Compute Engine e em servidores da Solução Bare Metal.

Conforme exigido pela SAP, para receber suporte da SAP e permitir que a SAP atenda aos contratos de nível de serviço (SLAs), instale o agente do Google Cloud para SAP em todas as instâncias de VM do Compute Engine e servidores da Solução Bare Metal que executam qualquer sistema SAP. Para mais informações sobre os pré-requisitos de suporte, consulte a Nota SAP 2456406 - SAP no Google Cloud Platform: pré-requisitos de suporte.

A versão 3.2 (mais recente) do agente do Google Cloud para SAP é a sucessora do agente de monitoramento do Google Cloud para SAP NetWeaver versão 2, do agente de monitoramento do SAP HANA versão 2 e do agente do Backint do Cloud Storage para SAP HANA. Portanto, além da coleta de métricas, a versão 3.2 (mais recente) do agente do Google Cloud para SAP inclui o recurso opcional: backup e recuperação baseados em backint para SAP HANA. Esses recursos ativam produtos e serviços como o Gerenciador de cargas de trabalho para as cargas de trabalho SAP.

O agente do Google Cloud para SAP é instalado no host com o sistema SAP. Para instruções sobre como instalar e configurar o agente, valide a instalação e verificar se o agente está sendo executado conforme o esperado, consulte Instalar o agente em uma instância de VM do Compute Engine.

Se você usar as seguintes imagens de SO do RHEL ou do SLES "for SAP" fornecidas pelo Google Cloud, o agente do Google Cloud para SAP será empacotado com as imagens do SO:

RHEL: todas as imagens "for SAP"
SLES: SLES 15 SP4 para SAP e versões posteriores

Instalar a biblioteca de armazenamento do SO e as definições de operação nas VMs gerenciadas

O arquivo gcp-connectorversion.tar inclui uma biblioteca de armazenamento do SO e definições de operação com os scripts correspondentes.

É preciso instalar a biblioteca de armazenamento do SO e os arquivos de operação em cada instância de VM gerenciada pelo SAP Landscape Management.

Para instalar uma biblioteca de armazenamento do SO e definições de operação em uma VM gerenciada pelo SAP Landscape Management:

faça o download ou copie o arquivo gcp-connectorversion.tar para a VM de destino;
extraia os arquivos de gcp-connectorversion.tar em um diretório temporário;

Execute o script de instalação:

No Linux, digite:
```
sudo bash install.sh
```
No Windows, com privilégios de administrador, digite:
```
install.cmd
```

O script de instalação copia a biblioteca de armazenamento do SO no diretório do SAP Host Agent ativo (/usr/sap/hostctrl/exe) e os arquivos de operações em um subdiretório (/operations.d). O script define a propriedade do arquivo como root:sapsys e define os direitos de acesso apropriados para cada tipo de arquivo.

file ./storage/libsapacosprep_gcp-2.2.15.96.so copied to /usr/sap/hostctrl/exe/libsapacosprep_gcp.so
file ./storage/Operations/AcActivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcActivateIP
file ./storage/Operations/AcDeactivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcDeactivateIP
file ./storage/Operations/ActivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/ActivateIP.sh
file ./storage/Operations/DeactivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/DeactivateIP.sh

Gerenciar sistemas SAP no Google Cloud com o SAP Landscape Management

Depois que o Connector para LaMa for instalado e a função do Cloud Manager estiver configurada no SAP Landscape Management, é possível usar o SAP Landscape Management para gerenciar sistemas SAP no Google Cloud. Para informações sobre como usar o SAP Landscape Management, consulte a documentação do SAP Landscape Management, edição empresarial (em inglês).

Como atualizar de uma versão anterior

Para atualizar o Connector para LaMa de uma versão anterior, execute as etapas a seguir.

No SAP Landscape Management, faça backup de todas as configurações atuais do Cloud Manager para Google Cloud antes de atualizar o Connector para o LaMa. Para mais informações, consulte Como exportar dados de configuração (em inglês).
Reinstale o Connector para o LaMa. Para instruções, consulte Como implantar o Connector para LaMa no SAP NetWeaver.
Substitua as bibliotecas de armazenamento e os arquivos de operações do SO existentes nos sistemas gerenciados seguindo as instruções em Como instalar a biblioteca de armazenamento e as definições de operação do SO.
Após a implantação, reinicie o SAP Landscape Management.

Solução de problemas

Por padrão, o sistema SAP Landscape Management opera no Google Cloud usando a identidade de uma conta de serviço do IAM. Se ocorrerem erros de autorização, primeiro use os comandos gcloud para executar a mesma ação que está recebendo o erro de dentro do sistema operacional convidado. Exemplo:

Ação do SAP Landscape Management	Comando da `gcloud` equivalente
Parar/iniciar	`gcloud compute instances stop/start`
Clonar	`gcloud compute disks snapshot` `gcloud compute disks create`
Realocar	`gcloud compute instances attach-disk` `gcloud compute instances detach-disk`

A resposta ao comando da gcloud indica se você não tem autorizações para executar uma ação específica. Se a ação for bem-sucedida, mas o erro persistir, entre em contato com o suporte conforme descrito na seção a seguir.

Suporte

Se precisar de ajuda para resolver problemas durante a operação do sistema SAP Landscape Management, envie uma mensagem ao suporte pelo SAP Support Portal no componente BC-VCM-LVM.

Se você determinar que a causa do problema está no Connector para LaMa, selecione o subcomponente BC-VCM-LVM-GOOGLE. No entanto, se você não tiver certeza da causa de um problema, escolha o componente BC-VCM-LVM para que o suporte da SAP possa analisar o problema primeiro.

Inclua estas informações:

A versão do SAP Landscape Management
A versão do Connector para LaMa
A versão do kernel do SAP NetWeaver
A versão do sistema SAP gerenciado, incluindo a versão do agente do host
Uma descrição do comportamento esperado