Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

A partir de 05/07/2021 o nome do Consinco Atualiza será Atualiza.

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Consinco Atualiza
    1. Outras Ações / Ações relacionadas
  4. Tela Consinco Atualiza
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Atualizar a versão do sistema possibilitando o acompanhamento dos status da atualização em tempo real. Atualmente a aplicação irá atualizar apenas a base de dados.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Consinco Atualiza  Atualiza – UPD00001.
O Consinco Atualiza é disponibilizado junto com o pacote de atualização.

Pré-Requisitos e Restrições

  • A ferramenta está disponível à partir da versão 19.05 – 009 do ERP.
  • A ferramenta deve ser executada em um sistema operacional homologado.
  • É necessário ter o .Net Framework v4.7 ou superior instalado.
  • É necessário ter o Oracle Client 32-bit com o arquivo tnsnames.ora configurado.
  • É necessário que o owner CONSINCO tenha privilégio ao dicionário de dados do Oracle (“select any dictionary”).
  • É desejável que o owner CONSINCO tenha privilégio para encerramento de sessões (“alter system kill”).
  • Recomenda-se fortemente a execução da atualização em ambiente de homologação para ensaio e tomada de tempo.
  • Mudanças de versão (ex: 19.07 > 20.01) habitualmente exigem mais tempo para atualização do que mudanças de release (ex: 19.07.001 > 19.07.002).
  • Sempre verifique o espaço disponível para o Oracle antes de iniciar uma atualização de versão, pois habitualmente poderá ter a criação de novos índices que exigirá espaço extra.
  • A atualização do sistema em ambientes Oracle Standard levam mais tempo do que em ambientes Oracle Enterprise devido ao uso de paralelismo na criação de índices.
  • Para usuários não administradores que não tenham permissão de alterar o arquivo Consinco.ini, o Windows pode replicar o arquivo para o diretório Virtual Store (%UserProfile%\AppData\Local\VirtualStore) e gerar confusão no apontamento do banco de dados da aplicação.

Passo a passo

Para utilizar o Consinco Atualiza faça o login informando o usuário e senha de acesso.

O campo ‘Conexão’ informará em qual base de dados será feito o login. As conexões exibidas para seleção são as que estão cadastradas no Consinco Menu.

Ao realizar o login será verificado a versão do Oracle da base de dados. Caso a versão atual do banco de dados não seja mais suportada pelo ERP, não será permitido atualizar o sistema e o Consinco Atualiza exibirá uma mensagem de aviso, conforme imagem abaixo.

Validade do Pacote

Os pacotes de atualização possuem uma data de expiração para garantir que as atualizações ocorram sempre para a release mais recente disponível na ocasião, assegurando que as últimas correções e adequações de produto serão aplicadas. Caso a ferramenta seja iniciada por um pacote de atualização que foi disponibilizado a mais de 15 dias, uma mensagem de alerta será exibida, porém, será possível continuar a atualização. Ao se deparar com esta mensagem, recomenda-se verificar na ocasião se há um pacote de atualização (release) mais recente.

...

Se o pacote de atualização tiver sido liberado a mais de 30 dias, a ferramenta impedirá que a atualização seja iniciada e somente permitirá continuar se for informado uma chave de acesso emergencial fornecida pela Consinco. Neste cenário, recomenda-se verificar se há na ocasião um pacote de atualização mais recente disponível, e se mesmo assim houver a necessidade de atualizar para o pacote obsoleto, a chave de acesso deverá ser solicitada a equipe de suporte da Consinco que avaliará se há viabilidade para que a mesma seja fornecida.

Tela de Avisos

Após fazer o login, será visualizada a tela de avisos, que exibirá (quando houver) notificações sobre procedimentos/informações referentes ao processo de atualização.

...

Se não houver nenhuma informação referente a atualização da base de dados, a tela de avisos não será exibida ao logar no Consinco Atualiza, para exibi-la, clique no botão ‘Avisos da Versão’.

Objetos Inválidos

Se houver objetos inválidos na base, ao fazer o login, será exibido uma mensagem de aviso, conforme imagem abaixo. É importante que não haja objetos inválidos, mas isso não impede que a atualização seja executada. Verifique se são objetos oficiais, e, se necessário, reporte-os ao suporte Consinco.

...

Se não houver objetos inválidos, a tela não será exibida ao logar no Consinco Atualiza, para visualizá-la clique no botão ‘Objetos inválidos’.

Usuários e Processos Logados

Para realizar a atualização, é necessário que nenhum usuário ou processo esteja logado na base de dados. Clique no botão ‘Usuários Logados’ para visualizar se há usuário logado na base. Nesta tela é possível ‘Encerrar a sessão’ e ‘Atualizar a lista’.

Preparando Atualização

Antes de iniciar a atualização certifique-se que todos os processos e serviços foram parados e de que não há nenhum usuário conectado na base de dados, caso contrário a atualização não será iniciada e será exibida uma mensagem de alerta, conforme imagem abaixo.

...

Ao iniciar a atualização, os módulos do ERP serão bloqueados, impedindo o acesso do usuário. Se o usuário tentar acessar algum módulo, receberá uma mensagem informando que o sistema está em atualização.


Executando Atualização

Durante o processo de atualização será exibido o status da execução, informando o andamento total e por tarefas.

...

Tempo Estimado: Quando o processo de atualização envolve a criação de tarefas longas, como por exemplo, criação de índices ou de novas colunas, o Consinco Atualiza exibirá o tempo estimado para tal execução. Conforme imagem abaixo.

...

Sessão Bloqueada: Se durante o processo de atualização acontecer de algum usuário conectar-se na base e bloquear uma sessão, o processo poderá ser interrompido e o Consinco o Atualiza exibirá o status ‘Sessão bloqueada’, conforme imagem abaixo.

...

Se a execução da atualização for interrompida de forma anormal por qualquer motivo, como por exemplo reinício da máquina, ao abrir o Consinco Atualiza novamente o processo continuará de onde parou, sendo necessário apenas iniciar a execução da atualização novamente.

Ao finalizar a atualização, se houver objetos inválidos, será exibida uma mensagem de aviso. Verifique se são objetos oficiais, e, se necessário, reporte-os ao suporte Consinco. É importante que não haja objetos inválidos no banco de dados.

Histórico de Execução

O Consinco Atualiza exibirá o histórico de execução de cada arquivo, informando o tempo da execução e se houve ou não falhas durante a execução do arquivo. Se ocorrem falhas durante a execução da atualização, elas serão exibidas em tela conforme imagem abaixo.

...

Por padrão, as falhas obsoletas não são exibidas, para consultá-las clique na opção ‘Mostrar falhas obsoletas’, conforme imagem abaixo.

Histórico de Atualizações

O histórico ficará gravado na base de dados, para consultá-lo acesse o botão ‘Histórico de Atualização’ e clique na lupa ou dê duplo clique na linha para visualizar o log de erros.

...

Selecione a pasta em seu computador onde serão armazenados os arquivos.
Se deseja exportar apenas os erros críticos, na mensagem ‘Exportar somente erros críticos?’, clique em ‘Sim’.

Execução em modo silencioso

A aplicação pode ser inicializada com passagem de parâmetros conforme descrito abaixo:

...

Bloco de código
firstline1
titlelog_20210208151109.json
linenumberstrue
collapsetrue
{
  "nomeExecutavel": "Consinco Atualiza.exe",
  "id": 0,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },
  "nivel": "Sucesso",
  "dominio": "SP01",
  "nomeMaquina": "RBPN019403893",
  "nomeUsuario": "vitor.gilioli",
  "dataHora": "08/02/2021 15:11:09",
  "mensagem": "Atualização finalizada.\nTempo decorrido de atualização: 00:02:19",
  "stack": "",
  "palavrasChave": [ "consinco", "atualiza", "sucesso", "atualização" ]
}

Exemplo de chamada

"Consinco Atualiza.exe" autoexec salvalog -c orapd devupdate devupdate tipoAmbiente=P

Código de Saída

A aplicação irá lançar um código de saída (exitCode) com o valor 0, caso tenha finalizado a execução com sucesso ou o valor 1 caso tenha apresentado algum erro durante a execução. Para ambas as situações, se for passado o parâmetro salvalog, a aplicação irá gerar sempre o arquivo de log referente ao momento de encerramento da aplicação, seja por sucesso ou erro.

03. TELA

...

Atualiza

Outras Ações / Ações relacionadas

Não há.

04. TELA

...

Atualiza

Principais Campos e Parâmetros

Não há.


05. TABELAS UTILIZADAS

Não há.




HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...