Guia de implantação do SAP MaxDB para Linux

Neste guia de implantação, você aprenderá como implantar e conectar-se a uma máquina virtual (VM, na sigla em inglês) do Compute Engine pronta para a instalação do SAP MaxDB em um sistema operacional Linux.

Nestas instruções, o Cloud Deployment Manager é usado para implantar e configurar a VM, o sistema operacional Linux e os volumes de disco necessários para o SAP MaxDB.

Para ver mais detalhes sobre como planejar sua implantação, consulte o Guia de planejamento do SAP MaxDB.

Pré-requisitos

Se você precisar que a carga de trabalho da SAP seja executada em conformidade com residência de dados, controle de acesso, equipes de suporte ou requisitos regulatórios, crie a pasta do Assured Workloads necessária. Para mais informações, consulte Controles soberanos e de conformidade para a SAP no Google Cloud.

Se você ainda não tem um projeto do Google Cloud com faturamento ativado, crie-o antes de implantar uma VM para a instalação do SAP MaxDB.

Para criar um projeto, siga estas etapas:

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Como configurar o ambiente de comando `gcloud`

Para estas instruções, use o Cloud Shell para inserir comandos gcloud que implantam ou configuram os recursos do Google Cloud. Acesse o Cloud Shell pelo console do Google Cloud no navegador.

Uma VM fornecida pelo Google Cloud executa o Cloud Shell toda vez que ele é iniciado. No primeiro uso, o Google Cloud também cria um diretório $HOME permanente para você, que é restaurado toda vez que você abre o Cloud Shell.

A VM provisionada inclui a Google Cloud CLI mais recente. Portanto, os comandos do gcloud que você usa no Cloud Shell são os mesmos que usaria em uma instância instalada localmente da CLI gcloud.

Se você tiver a CLI gcloud instalada, poderá emitir os comandos do gcloud que são usados nessas instruções a partir da máquina local. No entanto, se houver uma CLI gcloud instalada localmente, sempre verifique se você está usando a versão mais recente da CLI .

Se você usa o Cloud Shell ou a CLI gcloud, pode definir e alterar as propriedades do seu ambiente de comando gcloud e salvá-las como uma configuração. Configurações são conjuntos de pares de chave-valor que influenciam o comportamento dos comandos gcloud.

Algumas ações básicas que podem ser realizadas com uma configuração no Cloud Shell incluem:

Inicializar uma configuração.
```
gcloud init
```
Conferir as configurações atuais do gcloud.
```
gcloud config list
```
Mude para o projeto necessário do Google Cloud. Substitua o PROJECT_ID pelo ID do projeto do Google Cloud.
```
gcloud config set project PROJECT_ID
```
Definir uma região padrão. Substitua REGION por uma região do Google Cloud.
```
gcloud config set compute/region REGION
```
Definir uma zona padrão. Substitua ZONE por uma zona do Google Cloud.
```
gcloud config set compute/zone ZONE
```
Criar uma nova configuração. Substitua NAME pelo nome da configuração.
```
gcloud config configurations create NAME
```

Saiba mais sobre como trabalhar com as configurações em Como gerenciar as configurações da CLI gcloud.

Criar uma rede

Por motivos de segurança, crie uma nova rede. Para controlar quem tem acesso a ela, adicione regras de firewall ou use outro método de controle de acesso.

Caso o projeto tenha uma rede VPC padrão, não a use. Em vez disso, crie sua própria rede VPC para que as únicas regras de firewall aplicadas sejam aquelas criadas explicitamente por você.

Durante a implantação, as instâncias de VM normalmente exigem acesso à Internet para fazer o download do agente do Google Cloud para SAP. Se você estiver usando uma das imagens Linux certificadas pelo SAP disponíveis no Google Cloud, a instância da VM também exigirá acesso à Internet para registrar a licença e acessar repositórios de fornecedor do sistema operacional. Uma configuração com um gateway NAT e tags de rede da VM é compatível com esse acesso, mesmo se as VMs de destino não tiverem IPs externos.

Para configurar a rede:

Console

No Console do Google Cloud, acesse a página Redes VPC.
Acessar redes VPC
Clique em Criar rede VPC.
Digite um Nome para a rede.
O nome precisa seguir a convenção de nomenclatura. As redes VPC usam a convenção de nomenclatura do Compute Engine.
Em Modo de criação da sub-rede, escolha Custom.
Na seção Nova sub-rede, especifique os parâmetros de configuração a seguir para uma sub-rede:
1. Insira um Nome para a sub-rede.
2. Em Região, selecione a região do Compute Engine em que você quer criar a sub-rede.
3. Em Tipo de pilha de IP, selecione IPv4 (pilha única) e insira um intervalo de endereços IP no formato CIDR. , como 10.1.0.0/24.
  Esse é o intervalo principal de IPv4 da sub-rede. Se você planeja adicionar mais de uma sub-rede, atribua intervalos IP CIDR não sobrepostos para cada sub-rede na rede. Observe que cada sub-rede e os respectivos intervalos IP internos são mapeados para uma única região.
4. Clique em Concluído.
Para adicionar mais sub-redes, clique em Adicionar sub-rede e repita as etapas anteriores. É possível adicionar mais sub-redes à rede depois de criá-la.
Clique em Criar.

gcloud

Acesse o Cloud Shell.
Acesse o Cloud Shell
Para criar uma nova rede no modo de sub-redes personalizadas, execute:
```
gcloud compute networks create NETWORK_NAME --subnet-mode custom
```
Substitua NETWORK_NAME pelo nome da nova rede. O nome precisa seguir a convenção de nomenclatura. As redes VPC usam a convenção de nomenclatura do Compute Engine.

Especifique --subnet-mode custom para evitar o uso do modo automático padrão, que cria automaticamente uma sub-rede em cada região do Compute Engine. Para mais informações, consulte Modo de criação da sub-rede.
Crie uma sub-rede e especifique a região e o intervalo de IP:
```
gcloud compute networks subnets create SUBNETWORK_NAME \
    --network NETWORK_NAME --region REGION --range RANGE
```
Substitua:
- SUBNETWORK_NAME: o nome da nova sub-rede.
- NETWORK_NAME: o nome da rede que você criou na etapa anterior;
- REGION: a região em que você quer a sub-rede;
- RANGE: o intervalo de endereços IP, especificado no formato CIDR. Por exemplo, 10.1.0.0/24
  Se você planeja adicionar mais de uma sub-rede, atribua intervalos IP CIDR não sobrepostos para cada sub-rede na rede. Observe que cada sub-rede e os respectivos intervalos IP internos são mapeados para uma única região.
Se quiser, repita o passo anterior e adicione mais sub-redes.

Como configurar um gateway NAT

Se você precisar criar uma ou mais VMs sem endereços IP públicos, será necessário usar a conversão de endereços de rede (NAT) para permitir que as VMs acessem a Internet. Use o Cloud NAT, um serviço gerenciado distribuído e definido pelo software do Google Cloud que permite que as VMs enviem pacotes de saída para a Internet e recebam todos os pacotes de resposta de entrada estabelecidos. Se preferir, é possível configurar uma VM separada como um gateway NAT.

Para criar uma instância do Cloud NAT para seu projeto, consulte Como usar o Cloud NAT.

Depois de configurar o Cloud NAT para o projeto, as instâncias de VM poderão acessar a Internet com segurança sem um endereço IP público.

Como implantar uma VM do Linux para SAP MaxDB com o Deployment Manager

Nas instruções a seguir, o Deployment Manager é usado para implantar uma instância de VM com o Linux e todos os discos permanentes exigidos pelo SAP MaxDB.

Sobre o Deployment Manager

Nestas instruções, você definirá as opções de recursos para a instalação em um modelo de arquivo de configuração do Deployment Manager.

O Deployment Manager trata todos os recursos criados para o sistema SAP como uma única entidade chamada de implantação. Consulte e trabalhe com todas as implantações do seu projeto na página Implantações no console do Google Cloud.

Ao usar o Deployment Manager, esteja ciente dos seguintes comportamentos:

A exclusão de uma implantação exclui todos os recursos associados a ela, incluindo as VMs, os discos permanentes e quaisquer sistemas SAP instalados nas VMs.
Por padrão, o Deployment Manager usa a política de criação de recursos do ACQUIRE. Ao especificar um nome de VM que já esteja em uso por outra VM no projeto, o Deployment Manager não criará uma nova, mas adicionará a atual à nova implantação. Se a VM original foi criada por uma execução anterior do Deployment Manager, ela será associada a duas implantações.

Se você excluir a nova implantação, a VM adquirida será excluída da implantação que a criou. Para evitar que isto aconteça, defina a política de recursos do Deployment Manager como CREATE ou certifique-se de usar nomes de recursos exclusivos na nova implantação.

Para informações sobre as políticas que podem ser usadas ao criar recursos com o Deployment Manager e como especificá-las, consulte a documentação do Deployment Manager.

Procedimento de implantação

Abra o Cloud Shell

Acessar o Cloud Shell
Faça o download do modelo do arquivo de configuração template.yaml no seu diretório ativo. Para isso, digite o seguinte comando no Cloud Shell:
```
wget https://storage.googleapis.com/cloudsapdeploy/deploymentmanager/latest/dm-templates/sap_maxdb/template.yaml
```
Se quiser, renomeie o arquivo template.yaml para identificar a configuração definida por ele.
Abra o arquivo template.yaml no editor de código do Cloud Shell.

Para abrir esse editor de código, clique no ícone de lápis, no canto superior direito da janela de terminal do Cloud Shell.

No arquivo template.yaml, atualize os valores de propriedade a seguir substituindo os colchetes e respectivos conteúdos pelos valores da sua instalação.

Propriedade	Tipo de dados	Descrição
Tipo	String	Especifica o local, o tipo e a versão do modelo do Deployment Manager a ser usado durante a implantação. O arquivo YAML inclui duas especificações `type`, uma delas comentada. A especificação `type` que está ativa por padrão especifica a versão do modelo como `latest`. A especificação `type` comentada especifica uma versão de modelo específica com carimbo de data/hora. Se você precisar que todas as suas implantações usem a mesma versão de modelo, use a especificação `type` que inclui o carimbo de data/hora.
instanceName	String	Nome da instância da VM em que o SAP MaxDB será instalado. O nome precisa ter 13 caracteres ou menos e ser especificado em letras minúsculas, números ou hífens.
instanceType	String	O tipo de máquina virtual do Compute Engine em que o SAP MaxDB será instalado. Especifique um tipo de máquina com duas ou mais vCPUs. Por exemplo, "n1-standard-4". Se você estiver executando o SAP MaxDB com o SAP NetWeaver na mesma VM, selecione um tipo de máquina que inclua CPUs e memória suficientes para dar suporte aos dois sistemas. Consulte o Guia de planejamento do SAP NetWeaver.
zona	String	A zona em que você está implantando o SAP MaxDB. Ela precisa estar na mesma região que você selecionou para a sub-rede.
subnetwork	String	O nome da sub-rede criada em uma etapa anterior. Se estiver implantando em uma VPC compartilhada, especifique esse valor como `[SHAREDVPC_PROJECT]/[SUBNETWORK]`. Por exemplo, `myproject/network1`.
linuxImage	String	O nome da imagem do sistema operacional Linux ou da família de imagens que você está usando com o SAP MaxDB. Para especificar uma família de imagens, adicione o prefixo `family/` ao nome da família. Por exemplo, `family/rhel-7` ou `family/sles-12-sp3-sap`. Para definir uma imagem específica, determine somente o nome da imagem. Para ver a lista de famílias de imagens disponíveis, consulte a página Imagens no Console do Cloud.
linuxImageProject	String	O projeto do Google Cloud que contém a imagem que você usará. Ele pode ser seu próprio projeto ou um projeto de imagem do Google Cloud, como `rhel-sap-cloud` ou `suse-sap-cloud`. Para uma lista de projetos de imagem do Google Cloud, consulte a página Imagens na documentação do Compute Engine.
maxdbSID	String	O código da instância do banco de dados.
maxdbRootSize	Número inteiro	O tamanho em GB de /sapdb, que é o diretório raiz da instância do banco de dados. Os valores mínimo e padrão para maxdbRootSize são 8 GB.
maxdbDataSize	Número inteiro	O tamanho de /sapdb/`[DBSID]`/sapdata, que armazena os arquivos de dados do banco de dados. Os valores mínimo e padrão para maxdbDataSize são 30 GB.
maxdbLogSize	Número inteiro	O tamanho de /sapdb/`[DBSID]`saplog, que contém os registros de transações do banco de dados. Os valores mínimo e padrão para maxdbLogSize são 8 GB.
maxdbBackupSize	Número inteiro	O tamanho do volume /maxdbbackup. Esta propriedade é opcional. Se definida como 0 ou omitida, nenhum disco será criado.
maxdbDataSSD	boolean	Especifica se a unidade de dados usa um disco permanente SSD ("Sim") ou HDD ("Não"). "Sim" é o padrão.
maxdbLogSSD	boolean	Especifica se a unidade de registros usa um disco permanente SSD ("Sim") ou HDD ("Não"). "Sim" é o padrão. É recomendado o uso de SSD.
usrsapSize	Número inteiro	Necessário apenas se você estiver instalando o SAP MaxDB para ser executado com o SAP NetWeaver na mesma instância de VM.
sapmntSize	Número inteiro	Necessário apenas se você estiver instalando o SAP MaxDB para ser executado com o SAP NetWeaver na mesma instância de VM.
swapSize	Número inteiro	Necessário apenas se você estiver instalando o SAP MaxDB para ser executado com o SAP NetWeaver na mesma instância de VM.

Com o arquivo de configuração a seguir, é criada uma VM configurada para execução do servidor de banco de dados do SAP MaxDB e o SAP NetWeaver. O Deployment Manager é direcionado pelo arquivo de configuração a implantar uma VM n1-standard-16 em execução em um sistema operacional SLES 12 SP3. A VM inclui todos os diretórios necessários para executar o SAP MaxDB com o NetWeaver.

resources:
- name: sap_maxdb
  type: https://storage.googleapis.com/cloudsapdeploy/deploymentmanager/latest/dm-templates/sap_maxdb/sap_maxdb.py
  #
  # By default, this configuration file uses the latest release of the deployment
  # scripts for SAP on Google Cloud.  To fix your deployments to a specific release
  # of the scripts, comment out the type property above and uncomment the type property below.
  #
  # type: https://storage.googleapis.com/cloudsapdeploy/deploymentmanager/202103310846/dm-templates/sap_maxdb/sap_maxdb.py
  #
  properties:
    instanceName: xmp-maxdb-lin
    instanceType: n1-standard-16
    zone: us-central1-f
    subnetwork: example-sub-network
    linuxImage: family/sles-12-sp3-sap
    linuxImageProject: suse-sap-cloud
    maxdbSID: MD1
    maxdbRootSize: 10
    maxdbDataSize: 50
    maxdbLogSize: 30
    maxdbBackupSize: 100
    maxdbDataSSD: Yes
    maxdbLogSSD: Yes
    usrsapSize: 15
    sapmntSize: 15
    swapSize: 24

Crie a instância da VM.
```
gcloud deployment-manager deployments create [DEPLOYMENT-NAME] --config [TEMPLATE-NAME].yaml
```
O comando acima invoca o Deployment Manager, que implanta a VM de acordo com as especificações em seu arquivo template.yaml. Isso pode levar alguns minutos. Para verificar o progresso da implantação, siga as etapas na próxima seção.

Como verificar a implantação

Para verificar a implantação, verifique os registros de implantação no Cloud Logging e verifique a configuração da VM.

Verificar os registros

No console do Google Cloud, abra o Cloud Logging para monitorar o progresso da instalação e verificar se há erros.

Observação: podem ser incorridos custos ao concluir esta etapa no Cloud Logging. Para mais informações, consulte os preços do Cloud Logging.

Acesse o Cloud Logging
Filtre os registros:
Explorador de registros
1. Na página Explorador de registros, acesse o painel Consulta.
2. No menu suspenso Recurso, selecione Global e clique em Adicionar.
  
  Se a opção Global não for exibida, insira a seguinte consulta no editor de consultas:
  resource.type="global" "Deployment"
3. Clique em Run query.
Visualizador de registros legado
- Na página Visualizador de registros legado, no menu de seleção básico, selecione Global como o recurso de registros.
Analise os registros filtrados:
- Se "--- Finished" for exibido, o processamento do Deployment Manager estará concluído e será possível prosseguir para a próxima etapa.
- Se você vir um erro de cota:
  1. Na página Cotas do IAM e Admin, aumente as cotas que não atendem aos requisitos do SAP MaxDB listados no Guia de planejamento do SAP MaxDB.
  2. Na página Implantações do Deployment Manager, exclua a implantação para limpar as VMs e discos permanentes da instalação com falha.
  3. Execute a implantação novamente.

Verificar a configuração da VM

Depois que o sistema do SAP MaxDB for implantado, conecte-se à VM usando o SSH. Na página Instâncias de VMs do Compute Engine, clique no botão SSH da instância de VM ou use o método SSH que preferir.
Mude para o usuário raiz.
```
sudo su -
```
No prompt de comando, insira df -h. Verifique se o resultado é semelhante ao seguinte, como o diretório //sapdb/[DBSID]/sapdata.
Se você estiver instalando o SAP MaxDB na mesma VM que o SAP NetWeaver, digite o comando a seguir para confirmar se o diretório de troca foi criado:
```
cat /proc/meminfo | grep Swap
```
Você verá resultados parecidos com os deste exemplo:

Se qualquer uma das etapas de validação mostrar que a instalação falhou, faça o seguinte:

Corrija o erro.
Na página Implantações, exclua a implantação para limpar as VMs e os discos permanentes da instalação com falha.
Execute a implantação novamente.

Como instalar o banco de dados

Agora que o sistema operacional está configurado, instale o banco de dados do SAP MaxDB. O MaxDB normalmente é instalado com o produto SAP a que ele está integrado.

Para instalar o SAP MaxDB na VM, faça o seguinte:

Estabeleça uma conexão SSH com a VM baseada em Linux.
Faça o download do SAP Software Provisioning Manager (SWPM), da mídia de instalação do produto SAP e da mídia de instalação do MaxDB, de acordo com os guias de instalação da SAP.
Instale o produto SAP e o banco de dados do SAP MaxDB de acordo com os guias de instalação da SAP para seu produto. Para receber mais orientações, consulte a documentação do SAP MaxDB (em inglês).

A SAP fornece mais informações sobre instalação na Nota SAP 1020175 - Perguntas frequentes: instalação, upgrade ou aplicação de um patch no SAP MaxDB.

Validar a instalação do agente do Google Cloud para SAP

Depois de implantar uma VM e instalar o sistema SAP, confirme se o agente do Google Cloud para SAP está funcionando corretamente.

Verificar se o agente do Google Cloud para SAP está em execução

Para verificar se o agente está em execução, siga estas etapas:

Estabeleça uma conexão SSH com a instância de VM do host.

Execute este comando:

systemctl status google-cloud-sap-agent

Se o agente estiver funcionando corretamente, a saída conterá active (running). Por exemplo:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Se o agente não estiver em execução, reinicie-o.

Verificar se o SAP Host Agent está recebendo métricas

Para verificar se as métricas de infraestrutura são coletadas pelo agente do Google Cloud para SAP e enviadas corretamente ao agente de host da SAP, siga estas etapas:

No sistema SAP, insira a transação ST06.
No painel de visão geral, verifique a disponibilidade e o conteúdo dos seguintes campos para a configuração completa da infraestrutura de monitoramento da SAP e do Google:
- Provedor de nuvem: Google Cloud Platform
- Acesso ao monitoramento avançado: TRUE
- Detalhes do monitoramento avançado: ACTIVE

Como realizar tarefas de pós-implantação

Antes de usar sua instância do SAP MaxDB, é recomendável que você execute as seguintes etapas de pós-implantação:

Atualize seu software SAP MaxDB com os patches mais recentes, se disponíveis.
Instale quaisquer outros componentes.
Configure e faça o backup do seu novo banco de dados SAP MaxDB.

Para mais informações, consulte Administração do banco de dados do SAP MaxDB (em inglês).

Solução de problemas

Nesta seção, você encontrará informações sobre como corrigir problemas comuns.

Solução de problemas de conexão com a VM

Se estiver com problemas para se conectar à VM por meio do SSH, verifique se você criou uma regra de firewall para abrir a porta 22 na rede do Google Cloud que está usando.

Para outros problemas possíveis, consulte Problemas conhecidos do SSH no navegador.

Guia de implantação do SAP MaxDB para Linux

Pré-requisitos

Como configurar o ambiente de comando gcloud

Criar uma rede

Console

gcloud

Como configurar um gateway NAT

Como implantar uma VM do Linux para SAP MaxDB com o Deployment Manager

Sobre o Deployment Manager

Procedimento de implantação

Como verificar a implantação

Verificar os registros

Explorador de registros

Visualizador de registros legado

Verificar a configuração da VM

Como instalar o banco de dados

Validar a instalação do agente do Google Cloud para SAP

Verificar se o agente do Google Cloud para SAP está em execução

Verificar se o SAP Host Agent está recebendo métricas

Como realizar tarefas de pós-implantação

Solução de problemas

Solução de problemas de conexão com a VM

Como configurar o ambiente de comando `gcloud`