Escrito por: L. A.
💻 Operacionalização
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.
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
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 ú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.
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.
O SolusUpdate, em atualizações dos ambientes de Produção, verifica API’s conectadas ao Banco de Dados:
O Sistema exibirá a seguinte mensagem:
Clicando em “Ver Apis Online”, todas as api’s ativas conectadas serão listadas para conferência:
Para prosseguir, é necessário executar a parada das Api’s listadas, para isto, utilize os seguintes comandos em seu ambiente Docker Swarm:
Para parar a execução do Cluster Swarm, execute:
docker service scale <nome-do-serviço>=0
Caso deseje parar a execução de todas as apis do Cluster Swarm:
docker stack ls //Exibirá a lista das stacks em execução docker stack rm <stack_name> //Removerá a stack da execução
Em caso de ainda não utilizar o Swarm, execute:
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 API’s podem ser iniciadas novamente.
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 à base, voltar o sistema para funcionamento (Ferramentas > Sessões do banco de dados).
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;
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.
