Versões comparadas

Chave

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

...

Âncora
topo
topo
Escrito por: L. A. 

...

borderColorgrey
borderStylesolid
Image Removed  

Solus Update - Manual

...

borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#AB0047
titleObjetivo

...

Estado
colourBlue
titleCOMERCIAL
Estado
colourYellow
titleCONTROLADORIA
Estado
colourRed
titleASSISTENCIAL
Estado
colourGreen
titlePTU/CONTAS

Âncora
objetivo
objetivo

🎯 Objetivo

O manual auxilia a obter atualizações e/ou correções do sistema Solus.

...


Âncora

...

func

...

func

Funcionalidade

  • Solus Update é a ferramenta de atualização do sistema, onde é possível obter também as correções e melhorias do sistema.

 

...

📝 Sumário

...

▪️ Objetivo

...

...

...


Âncora

...

operacion

...

operacion

💻 Operacionalização

Expandir
titlePré-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 máquina.  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.

...

Image Added

  •  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".

...

Image Added

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.

...

Image Added

...

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'

...

Image Added

  • Nome da variável: NLS_LANG 

  • Valor da variável: BRAZILIAN PORTUGUESE_BRAZIL.WE8MSWIN1252

...

...

Image Added

Expandir
titleProcesso

O acesso é feito pelo menu SolusUpdate > Solus Update

...

image-20241227-191813.pngImage Added

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 última 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.

...

Image Added
  • 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:

...

Image Added

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.

...

Image Added

O SolusUpdate, em atualizações dos ambientes de Produção, verifica API’s conectadas ao Banco de Dados:

image-20241230-121201.pngImage Added

O Sistema exibirá a seguinte mensagem:

image-20241230-125249.pngImage Added

Clicando em “Ver Apis Online”, todas as api’s ativas conectadas serão listadas para conferência:

image-20241230-121519.pngImage Added

Âncora
desativar-apis
desativar-apis
Para prosseguir, é necessário executar a parada das Api’s listadas, para isto, utilize os seguintes comandos em seu ambiente Docker Swarm:

  1. Para parar a execução do Cluster Swarm, execute:

Bloco de código
languagedocker
docker service scale <nome-do-serviço>=0
  1. Caso deseje parar a execução de todas as apis do Cluster Swarm:

Bloco de código
languagedocker
docker stack ls //Exibirá a lista das stacks em execução
docker stack rm <stack_name> //Removerá a stack da execução
  1. Em caso de ainda não utilizar o Swarm, execute:

Bloco de código
docker-compose down //Interrompe a Execução de todas os containers do docker-compose.yml

Após a conclusão completa da atualização, as APIs podem ser iniciadas novamente. Para iniciá-las, execute o seguinte comando:

Bloco de código
docker-compose up --build -d

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.

...

Image Added

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".

...

Image Added

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

...

Image Added

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.

...

Image Removed

Ao finalizar o processo

...

, a mensagem de atualização concluída será apresentada.

...

Image Added

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.

...

Image Added

Para liberar o acesso

...

à base, voltar o sistema para funcionamento (Ferramentas > Sessões do banco de dados).

...

Image Added

Voltar ao início

Expandir
titleArquivos 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;

      Image Removed

...

Image Removed

Image Added

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.

...

Image Added

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

Expandir
title

...

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.

...

Image Added

Voltar ao início

Nota

Documentação elaborada com base na versão vigente do sistema.

Voltar ao início


Editado por:

...

M.

...

F.,

...

23/

...

09/

...

2024