Base de Conhecimento

Cloud - Linha Winthor - [MIGRADOR] Documento técnico de apoio - Migrador Oracle

Preparação Banco de Dados

time.png Tempo aproximado para leitura: 00:00:50 min

Dúvida

Como realizar a Preparação Banco de Dados Winthor?

Ambiente
Cloud - Linha Winthor - Todas as versões

Solução
Para realizar a Preparação Banco de Dados Winthor, siga os passos a seguir:

 

Informações sobre o Procedimento

Tipo
Risco
Complexidade
Requer RDM
Nome da RDM
Documentação Não Impacta  (estrela vermelha)Baixa Não N/A

 

Histórico do Documento

Nome
Criação/Modificação
Data
Versão
Revisor
Aprovador
Alteração
Retenção
Wagner Augusto Vilela
Criação

v1 Vanesca Freitas Dias Rafael Cardoso de Araujo

O documento deverá ser revisado caso necessite alguma alteração no processo

Até ser substituído, Inativado ou Excluído

 

Versão

Plataforma/Versão SO
SGDB/Versão
Nome/Versão do Produto
Ambiente
Oracle Linux / Red Hat / CentOS Oracle 10.2.0.5 ou superior Winthor N/A

 

Objetivo

Descrever o procedimento para apoio na geração do backup e do arquivo .csv no banco de origem para migração para a Cloud TOTVS.

 

Procedimento

Backup do Banco

Para fazer a migração para a Cloud TOTVS usando o migrador deve ser gerado o backup e um arquivo .csv com algumas informações da estrutura do banco de dados de origem. 

Backup - Datapump
mceclip0.png
nohup \
expdp 'userid="USUARIO_BD/SENHA_USUARIO_BD@IP_SERVIDOR_BD:PORTA_BD/SERVICE_BD"' \
SCHEMAS=NOME_SCHEMA \
DIRECTORY=NOME_OBJETO_DIRETORIO \
DUMPFILE=EXPDP_CCODE_WINTHOR_%U.dmp \
LOGFILE=EXPDP_CCODE_WINTHOR.log \
FILESIZE=10G \
CLUSTER=NO \
EXCLUDE=STATISTICS \
PARALLEL=NUMERO_CORES \
FLASHBACK_TIME=SYSTIMESTAMP \
&

Legenda dos parâmetros do expdp do bloco acima:

nohup: o uso do "nohup" com o "&" no final vai manter o processo em execução em segundo plano mesmo que a sessão que iniciou seja desconectada no sistema operacional. O nohup devera ser utilizado somente no Linux.
expdp: é o comando do Datapump que faz o backup do banco e deve ser executado no servidor onde a instância está sendo executada. O "USUARIO_BD" deve ser um usuário do banco de dados que tenha privilégio para se conectar no banco de dados e executar o expdp. O "IP_SERVIDOR_BD" é o IP do servidor onde o banco está sendo executado. A "PORTA_BD" é a porta em que está configurada o listener do banco, a porta padrão do Oracle é a 1521. O "SERVICE_BD" é o serviço do banco de dados que está sendo usado para receber as conexões.
SCHEMAS: nesse parâmetro deve ser informado o schema usado pelo Winthor.
DIRECTORY: nesse parâmetro deve ser informado o objeto diretório do banco de dados onde será armazenado os arquivos de backup e log gerados no expdp.
DUMPFILE: nesse parâmetro deverá ser informado o nome dos arquivos de dump gerados no expdp, sempre seguindo o padrão "EXPDP_CCODE_WINTHOR_%U.dmp", onde o CCODE é o código cloud do cliente, que é um identificador único de 6 dígitos.
LOGFILE: nesse parâmetro deverá ser informado o nome do arquivo de log gerado no expdp, sempre seguindo o padrão "EXPDP_CCODE_WINTHOR.log", onde o CCODE é o código cloud do cliente, que é um identificador único de 6 digitos.
FILESIZE: esse parâmetro define o tamanho dos arquivos de dump gerado nos backups e por padrão deve ser mantido o valor de "10G".
CLUSTER: esse parâmetro deve ser mantido com o valor "NO". Ele garante que caso o banco esteja sendo executado em um RAC, o expdp seja executado sempre em uma única instância.
EXCLUDE: esse parâmetro sempre deverá conter o valor "STATISTICS", pois será feito feita uma coleta de estatísticas no banco de destino no final da migração.
PARALLEL: nesse parâmetro deve ser informado o número do paralelismo a ser usado durante a execução do expdp. Em servidores dedicados para a instância que está sendo feito o backup, caso a aplicação esteja parada para a migração deve-se ser usado o número de cores do servidor como valor do parâmetro. Caso esteja sendo executado um backup para a homologação, com a aplicação online, deve-se usar de 20% a 40% da quantidade de cores do servidor, dependendo do workload do ambiente, para não gerar impactos relacionados a performance. Na edição Standard do Oracle não é possível usar executar o datapump usando paralelismo.
FLASHBACK_TIME: nesse parâmetro sempre deve ser informado o valor "SYSTIMESTAMP". Ele vai garantir a consistência dos dados durante o momento execução do expdp. Ao usar esse parâmetro os registros ficaram retidos na área de UNDO do Oracle durante o expdp e caso não haja área de UNDO suficiente durante o processo, será retornada a mensagem "snapshot segment too old" e ocorrerá a falha no processo. Quando se estiver executando o expdp em um banco com a aplicação online o ideal é acompanhar a área de UNDO durante o processo. Em versão anteriores a 12.1, o parâmetro "FLASHBACK_TIME=SYSTIMESTAMP" deve ser substituído pelo parâmetro "CONSISTENT=Y", que tem exatamente a mesma função em versões anteriores a 12.1 do Oracle.

Geração do arquivo .csv

Junto com os arquivos de backup e o arquivo de log gerados no step anterior, deverá ser gerado um arquivo .csv com algumas informações da estrutura do banco que serão interpretadas pela orquestração no momento do import do backup no ambiente de destino, na Cloud TOTVS.

Para gerar esse arquivo .csv basta copiar o script "migrador_oracle_totvs_winthor.sql" abaixo para o servidor onde está sendo executado o banco que será migrado, conectar no banco com um usuário que tenha privilégio de leitura nos objetos v$instance, dba_segments e dba_users, que são views e tabelas do dicionário do Oracle, e executar o script.

migrador_oracle_totvs_winthor.sql- Anexo

 

Para executar o script basta se conectar no banco via sqlplus e passar o o caractere "@" mais o diretório onde está o script e o nome do script, como no exemplo abaixo:

 

Geração .csv
mceclip1.png
sqlplus / as sysdba
SQL> @/home/oracle/migrador_oracle_totvs_winthor.sql
Durante a execução do script será solicitado informar o nome do schema usado pelo Winthor, o mesmo que foi informando no expdp:
mceclip0.png

Após a execução do script, será gerado um arquivo .csv chamado "migrador_totvs_winthor.csv" no mesmo diretório onde o sqlplus foi executado para se conectar ao banco e executar o script.

Esse arquivo "migrador_totvs_winthor.csv" obrigatoriamente deve ser enviado junto com os arquivos de backup e log do datapump.

 

Envio dos arquivos

Para enviar os arquivos gerados nos steps anteriores, deve ser gerado um arquivo chamado BACKUP.zip em que todos os arquivos obrigatoriamente devem estar na raiz.

No linux esse arquivo pode ser gerado usando o comando zip, como mostra o exemplo abaixo:

mceclip2.png

No Windows, basta criar a pasta, clicar com o botão direito do mouse e mandar comprimir com o formato .zip.

Para envio do arquivo BACKUP.zip, basta acessar basta seguir o passo a passo do documento T-Cloud - Migrador

 

Referências

https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-export-utility.html

https://www.oracle.com/dz/a/tech/docs/oracle-database-utilities-data-pump-bp-2019.pdf

https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-overview.html

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _