Solus Update - Manual

Escrito por: L. A. 
 

Solus Update - Manual



Objetivo

O que é?

  • O manual auxilia a obter atualizações e/ou correções do sistema Solus.
Funcionalidade
  • Solus Update é a ferramenta de atualização do sistema, onde é possível obter também as correções e melhorias do sistema. 
Operacionalização
 Pré-requisitos

O que é necessário para realizar a atualização do sistema:

  • A máquina que irá executar o Solus Update deve possuir o SQL*Plus. Ele está presente na instalação default do client do Oracle. Caso o seu procedimento de instalação tenha o deixado de fora, será preciso reinstalar. Necessário que esteja apontado o caminho de instalação do Oracle nas variáveis de ambiente da maquina.  Para testar o funcionamento do SQL*Plus, abra um prompt de comando e digite: sqlplus usuario/senha@host, caso conecte o procedimento está concluído. Qualquer outra mensagem, diferente do exemplo abaixo, o SQL*Plus ou a conexão não está de acordo e precisa ser analisada. A versão do Oracle pode variar do exemplo abaixo, o que importa é a conexão bem-sucedida.


  •  A base deve estar em modo de manutenção, para isso acessar a tela no caminho Ferramentas > Sessões do banco de dados, e clicar no botão indicado na imagem abaixo. O status alterará para Sistema em manutenção. Caso essa alteração não seja realizada antes de iniciar a atualização, é possível coloca-la durante o processo, após o download dos módulos.
  • Todas as sessões conectadas deverão ser encerradas. Para finalizar uma sessão, selecione a mesma e clique em "Finalizar sessão".


Configuração dos diretórios:

  • Deve-se incluir diretórios para onde os módulos, serão baixados (os módulos são baixados por padrão no diretório C:\Solus\SolusUpdate, como veremos mais adiante).

Token:

  • Caso o token expire, será necessário solicitar outro ao suporte.


Variável de ambiente

  • A maquina deve possuir a variável de ambiente do Oracle NLS_LANG configurada. Para configurar, acessar as variáveis de ambiente do windows, clicar em 'Novo' e preencher 'Nome da variável' e Valor da variável'
  • Nome da variável: NLS_LANG 
  • Valor da variável: BRAZILIAN PORTUGUESE_BRAZIL.WE8MSWIN1252

Voltar ao início

 Processo

O acesso é feito pelo menu SolusUpdate > Solus Update

Atualmente existem dois tipos de atualização: Atualização da versão atual e Nova versão.

  • Para as duas opções de atualização é disponibilizada a ultima revision liberada.
  • A opção Atualização da versão atual será utilizada após já ter usada a opção Nova versão, onde a base continuará na mesma para qual foi atualizada, porém obtendo correções dos scripts, módulos e web. A revisão informada na tela, indicará em qual revisão a base se encontra, no caso 40013. Para iniciar o processo, será necessário indicar qual base está sendo atualizada, Produção ou Homologação.


  • A opção Nova versão é utilizada especificamente para realizar alteração de versão do sistema, exemplo: a base está na versão 05/2024 e será atualizada para versão 08/2024, também será necessário selecionar para qual versão e revisão será atualizado, conforme imagem abaixo:


Ao iniciar o processo de atualização, o sistema irá validar se existem sessões ativas e se a base está em modo de manutenção. Estando tudo certo, iniciará o processo de atualização. Primeiramente, serão baixados os módulos e, em seguida, começará a aplicação dos scripts.


Caso existam sessões abertas ao iniciar, será apresentada a mensagem abaixo solicitando a alteração. Clicando em "OK", abrirá a tela Sessões do banco de dados, clicando em "Cancelar", o processo será abortado.


Os usuários conectados no banco de dados deverão ter suas sessões encerradas. Para finalizar uma sessão, selecionar a mesma e clicar em "Finalizar sessão".


O sistema obrigatoriamente deve estar no modo de manutenção, conforme imagem abaixo:


Após todas as sessões finalizadas e com a base em manutenção, clicando em "OK", a tela de atualização será liberada para iniciar. Ao finalizar o processo, a mensagem de atualização concluída será apresentada.


Caso ocorram erros na aplicação dos objetos e scripts no banco de dados, o relatório de objetos e scripts não aplicados será apresentada. Torna-se necessário abrir um chamado ao suporte para validação ou, caso a atualização esteja sendo realizada na base de produção, entrar em contato com o plantão.


Para liberar o acesso a base, voltar o sistema para funcionamento (Ferramentas > Sessões do banco de dados).

Voltar ao início

 Arquivos baixados

Os arquivos da web e módulos do sistema que serão baixados, ficarão salvos nos seguintes diretórios;

  • Arquivos web: C:\Solus\solusupdate\(versao)\(revisao)\web.
  • Módulos: C:\Solus\ solusupdate\(versao)\(revisao)\modulos;

Os arquivos da web que foram baixados, devem ser alterados:

  • Arquivos da web devem ser alterados no servidor da web, seguindo a estrutura de diretórios criados;

Os mesmos devem ser copiados e colocados no servidor web, no diretório correspondente. Quando questionado se deseja substituir, confirme.

Orientamos que os diretórios abaixo Não sejam substituídos após o Solus Update, por conter arquivos específicos:

      comum\img;

      solusweb_5_0\app\assets\images;

      empresa\anexos;

      empresa\documentos;

      prestador\arquivos;

      prestador\arquivos_recebidos;

      usuario\anexos;

      usuario\arquivos;

      usuario\manual;

      integracao\certificados.

  • Os módulos devem ser alterados em todos os computadores que terão acesso ao sistema;

Voltar ao início

 Log’s de execução

Os log’s de execução serão salvos no diretório C:\Solus\solusupdate.

  • Log_Atualização: indica quais módulos, scripts e arquivos da web foram baixados.
  • Tempo_gasto: Indica o tempo de execução de cada etapa do update.
  • Resultado_scripts: Informa todo o conteúdo dos scripts aplicados no banco.

Voltar ao início



Editado por: M. F., 23/09/2024