Atualizar Sistema

Atualiza todos os módulos e produtos que compõem o sistema, incluindo o Engine. Ele também permite a atualização parcial de produtos, mas essa opção não é recomendada devido à interdependência existente entre os produtos.

A atualização do sistema requer as credenciais de um usuário com permissão aos escopo de autorização “system.update” e “security.externalAccess” na base de dados que será atualizada. Opcionalmente, pode ser utilizado um token de autorização para evitar o uso de credenciais de usuário. Esse token pode ser criado por meio do botão “Criar token de autorização” do processo “Admin > Atualização > Configuração”.

Objetivo

Realizar atualização dos componentes novos e correções de um ou mais produtos para uma base, dentro da política de segurança configurada para um grupo, papel ou usuário.

O procedimento deve ser realizado a partir do processo: “Desenvolvimento > Atualização > Atualizar Sistema”.

Fluxo Operacional

Atualização dos aplicativos da base de destino

Inicialmente, será verificado se a base de destino está com o Engine na mesma versão do Engine da base de origem. Caso os Engines estejam com versões diferentes, será feita uma sugestão para atualização imediata. Caso os Engines estejam com versões diferentes e não se deseje fazer uma atualização neste momento, uma última mensagem alertará para o risco que é seguir sem a atualização. Finalmente, caso o usuário opte por continuar sem a atualização, o processo seguirá normalmente nas etapas de atualização do esquema e dos demais registros do banco de dados.

Caso o usuário confirme que deseja atualizar o Engine da base de destino, o processo de atualização irá atualizar e reiniciar o Engine escolhido como destino da atualização e também os outros Engines. Para isso é necessário que todos os Engines daquela base de dados estejam cadastrados no processo “Admin > Servidores > Engines servidores”.

O usuário pode ainda escolher atualizar apenas o Engine destino da atualização, deixando todos os demais Engines para serem atualizados num segundo momento. Para isso, no início da atualização, na grade “Opções da atualização”, deve ser selecionada a opção “Ignorar outros Engines servidores” e, depois de iniciada a atualização, quando questionado se deseja atualizar o Engine da base de destino o usuário deve confirmar a atualização.

Determinando as licenças que serão atualizadas

As licenças serão exibidas na grade de “Produtos Licenciados” e o usuário deve selecionar as que deseja atualizar.

• Atualização para licença custom - Deve ser configurada na base de destino, no cadastro de bases, para permitir que a seleção do produto custom esteja habilitada.

• Opções complementares - As opções são:

  1. Habilitar contagem de registros.
  2. Remover produtos não licenciados.
  3. Executar testes na origem.

Criação de tabelas e campos

Após selecionar as licenças que devem ser criadas, o usuário pode determinar quais tabelas e campos serão criados no banco de dados através das grades que serão exibidas no momento da configuração.

Alteração e exclusão de campos

O usuário pode determinar também quais campos serão alterados ou excluídos no banco de dados. Em casos de alteração, o novo e o antigo tipo do campo serão informados na grade.

Ignorando tabelas, campos e índices

Tabelas, campos ou índices existentes na base de dados e que não estejam definidos no modelo de dados do sistema serão sugeridos para remoção durante uma atualização. Tabelas e campos podem ter sido criados na base de dados para serem utilizados em processos customizados. Índices podem ter sido criados manualmente pelo administrador para otimizar a execução de alguma consulta ou rotina. Para sinalizar que esses elementos são importantes e não devem ser sugeridos para remoção, o administrador do sistema deve cadastrá-los utilizando as classes “Outras tabelas”, “Outras colunas” e “Outros índices”. Registros dessas classes podem ser manipulados pelos processos de mesmo nome localizados em “Desenvolvimento > Base de dados”. Durante a execução da atualização, as grades que exibem as sugestões de remoção possuem botões que permitem que o administrador indique os itens que devem ser ignorados. Ao utilizar esses botões serão criados registros das classes correspondentes.

Apesar de ignorado pelo processo de atualização, uma coluna registrada na classe “Outras colunas” continuará existindo e ocupando recursos de memória e disco no servidor. Por esse motivo é importante que, num momento oportuno, seja avaliado se essa coluna é mesmo relevante para o uso do sistema. Se a coluna for importante ela deve ser definida no modelo de dados, em um arquivo do tipo “x-model” ou “x-class”, e em seguida removida no processo “Outras colunas”, utilizando o botão de remoção da grade.

Criação de índices

Após selecionar as alterações, criações e\ou exclusões, o usuário poderá criar índices no banco de dados no intuito de otimizar as consultas realizadas na base.

Relatório final da atualização

Ao final do processo um relatório é exibido com as versões das licenças atualizadas, campos criados, excluídos e/ou alterados, índices inseridos e/ou excluídos, permissões geradas e diretórios/arquivos órfãos.