Dúvida
Como aplicar pacotes (Patchs) pelo portal T-Cloud?
Ambiente
Cloud - Protheus - Portal T-Cloud
Solução
A aplicação de pacotes é essencial para manter o sistema Protheus atualizado, seguro e estável. Os patches corrigem erros identificados, trazem melhorias de desempenho e implementam atualizações legais/fiscais exigidas por lei.
Manter o sistema sem pacotes atualizados pode causar falhas, indisponibilidade ou não conformidade com obrigações legais.
Segue o passo a passo de como realizar a aplicação de pacotes através do T-Cloud:
1. Acesse o portal TCLOUD(https://tcloud.totvs.com.br/plataforma/login), no navegador e faça login:
Recomendamos a utilização do Google Chrome ou Mozilla Firefox atualizados.
2. Nos menus à esquerda, selecione através da aba PaaS → Protheus, o ambiente que deseja efetuar a ação.
3. Em Meu Ambiente, localize a seção AÇÕES, se necessário, utilize o campo de pesquisa de ações à direita. Digite: Pacote e localize a ação APLICAR PACOTE:
4. Selecione o tipo de aplicação de pacote:
Pacote comum (Este pacote será aplicado com os serviços em andamento).
Pacote de LIB - (Este pacote será aplicado com reinício obrigatório de todos os serviços durante a aplicação)
5. Selecione o(s) ambiente(s), (RPO) que deverão receber o pacote.
6. Após selecionar o ambiente, carregará uma lista de pacotes disponíveis para aplicação (pacotes que já foram inseridos no Portal TCLOUD), ou poderá adicionar um novo pacote clicando em "NOVO PATCH".
NOVO PATCH:
Será necessário incluir um TÍTULO, DESCRIÇÃO, o ARQUIVO do pacote que será aplicado e caso contenha alterações no dicionário de dados (como inclusão de campos, tabelas ou índices), incluir também o arquivo SDF (opcional).
6.1. Após definir o Título e Descrição do pacote, clique em Arquivo(Browse) para realizar o upload do arquivo localizado em seu computador.
6.2. Selecione o arquivo com a extensão .ptm (certifique-se que o nome do arquivo não possua caracteres especiais além do underline → "_". Caso possua, será necessário renomear o arquivo).
6.3. Caso contenha arquivos SDF (opcional), esse arquivo deve ser aplicado junto com o patch para garantir o pleno funcionamento das atualizações.
Compactar a pasta onde estão localizados os arquivos sdf e incluí-los utilizando a opção Arquivo SDF(Browse).
6.4. Após os arquivos serem carregados, clique em UPLOAD para que o T-Cloud envie o arquivo ao servidor onde está hospedado o Protheus.
7. O arquivo e pacote será listado, selecione-o na lista de PATCH's.
7.1 Pacote comum - Poderá escolher entre as opções abaixo para aplicações de pacotes comum.
1 - Modo de aplicação:
Somente fontes atualizados
- Atualiza apenas os arquivos que existem dentro do pacote.
- Os demais fontes do ambiente permanecem inalterados.
- É o modo mais utilizado para aplicação de patches corretivos e atualizações pontuais.
- Menor impacto e menor tempo de processamento.
Atualizar todos os fontes
- Realiza uma sincronização completa da pasta de fontes com o conteúdo do pacote.
- Além de atualizar os arquivos existentes no pacote, pode remover ou substituir arquivos que não estejam presentes nele, dependendo da estrutura da atualização.
-
Possui maior impacto e demanda mais tempo de processamento.
2 - Qual ação realizar durante a aplicação do patch?
Nenhuma.
Reiniciar Webservices.
Reiniciar todos os serviços.
8. Para validar o andamento, clique no ícone de Ações localizado no canto superior direito do portal TCLOUD.
Será exibido o painel Últimas ações executadas.
Localize a execução correspondente: Aplicar Patch
Acompanhe a barra de progresso até a conclusão da atividade. Quando concluída, a execução deverá apresentar status finalizado com sucesso.
Observação adicional: Arquivo SDF
Após a inclusão de arquivo SDF, habilite o ACESSO EXCLUSIVO do ambiente para evitar acessos simultâneos durante a atualização.
- Execute o processo UPDDISTR/UPDBATCH para aplicar as alterações do dicionário de dados.
Importante: A não aplicação dos arquivos SDF quando disponibilizados junto ao patch pode ocasionar divergências entre o repositório e o banco de dados, resultando em falhas de execução, erros em rotinas ou comportamentos inesperados no sistema.
5 Comentários