Script de auxílio de upgrade do LumisXP

O LumisXP possui um script para auxiliar no seu upgrade. É um script compatível tanto com Windows quanto com Linux e ele tem o propósito de auxiliar no processo de atualização do LumisXP.

Vale ressaltar, no entanto, que esse script não executa o processo completo, que envolve, entre outras coisas, o backup do ambiente. Ele só visa auxiliar em alguns passos que podem ser automatizados.

Para que o script seja executado, é necessário ter um arquivo de configuração chamado lumisxpupgrade.config.yml no mesmo diretório a partir do qual o script será chamado. Vale ressaltar que esse diretório deve ser algum diretório fora do diretório de instalação do LumisXP.

O arquivo de configuração

O arquivo de configuração de atualização lumisxpupgrade.config.yml tem as seguintes opções:
targetVersion: <versão para a qual se quer atualizar> lumisxp: directory: <caminho da instalação do LumisXP que será atualizada> appserver: type: <tipo do servidor de aplicação> http: port: <número da porta (HTTP) do servidor de aplicação> bind: <endereço de escuta do servidor de aplicação> stop: command: <comando para parar o servidor de aplicação> webserver: type: <tipo do servidor web> version: <versão do servidor web> getVersionCommand: <comando para obter a versão do servidor web> bigdata: config: directory: <caminho do diretório de configuração do Elasticsearch> lumiswebsite: username: <nome de usuário para efetuar o download da nova versão do LumisXP>

Abaixo segue a descrição de cada opção dessas:

Atualização no Linux

Como exemplo, suponha que:

1. O LumisXP está instalado em /lumis/lumisxp.
2. A atualização será feita para a última versão disponível.
3. O usuário que fará o download da nova versão a partir do site da Lumis é meu_usuario.
4. O servidor de aplicação usado seja o Apache Tomcat e ele será parado manualmente.
5. O servidor web usado é o Nginx.
6. A versão do servidor web é 1.25.3.
7. A atualização será inicializada a partir de um diretório ~/lumisxp-upgrade.
8. Os servidores Elasticsearch estão em outras máquinas e, por isso, os diretórios de configuração devem ser configurados manualmente.

Nesse caso, o arquivo de configuração de atualização lumisxpupgrade.config.yml estaria na pasta ~/lumisxp-upgrade.
cat lumisxpupgrade.config.yml
# Vamos atualizar para a versão mais recente targetVersion: "*" # Diretório do LumisXP lumisxp: directory: /lumis/lumisxp # Servidor de aplicação appserver: type: Tomcat # Servidor web webserver: type: Nginx version: 1.25.3 # Website Lumis lumiswebsite: username: meu_usuario

Para inicializar o processo de atualização, precisa-se:

1. Fazer o backup completo do ambiente.
2. Mudar o diretório atual para ~/lumisxp-upgrade: cd ~/lumisxp-upgrade.
3. Executar o script de atualização: bash <(curl https://www.lumis.com.br/lumisxp/upgrade/upgrade.sh).
4. Seguir as instruções do script.

Atualização no Windows

Como exemplo, suponha que:

1. O LumisXP está instalado em C:\lumis\lumisxp.
2. A atualização será feita para a versão 16.1.0.
3. O usuário que fará o download da nova versão a partir do site da Lumis é meu_usuario.
4. O servidor de aplicação usado seja o Apache Tomcat.
5. O comando a ser utilizado para parar o servidor de aplicação seja net stop tomcat
6. Nenhum servidor web é usado.
7. A atualização será inicializada a partir de um diretório C:\lumis\lumisxp-upgrade.
8. O diretório de configuração do Elasticsearch é C:\lumis\elasticsearch\config.

Nesse caso, o arquivo de configuração de atualização lumisxpupgrade.config.yml estaria na pasta C:\lumis\lumisxp-upgrade.
more lumisxpupgrade.config.yml
# Vamos atualizar para a versão 16.1.0 targetVersion: 16.1.0 # Diretório do LumisXP lumisxp: directory: C:\lumis\lumisxp # Servidor de aplicação appserver: type: Tomcat http: port: 8080 bind: 127.0.0.1 stop: command: net stop tomcat # Servidor web webserver: type: None # Website Lumis lumiswebsite: username: meu_usuario # Configuração do Elasticsearch bigdata: config: directory: C:\lumis\elasticsearch\config

Para inicializar o processo de atualização, precisa-se:

1. Fazer o backup completo do ambiente.
2. Abrir um terminal Powershell.
3. Mudar o diretório atual para C:\lumis\lumisxp-upgrade: cd C:\lumis\lumisxp-upgrade.
4. Executar o script de atualização: Invoke-Expression((New-Object System.Net.WebClient).DownloadString('https://www.lumis.com.br/lumisxp/upgrade/upgrade.ps1')).
5. Seguir as instruções do script.

Atualização de um ambiente com cluster

Caso se queira atualizar um ambiente com cluster, o processo descrito acima deve ser repetido em cada nó do cluster LumisXP.
Porém, o último passo do script (no qual é perguntado Would you like to execute LumisXP upgrade script (<nome do script>)? If it is a cluster install and the script has already been executed in other node, you should answer 'No'.) só deve ser executado em um dos nós do cluster. Nos outros, a resposta a essa pergunta deve ser No.

Observações

• Esse método de atualização só está disponível a partir da versão 16.1.0 do LumisXP.
• Antes de inicializar o(s) servidor(es) de aplicação do LumisXP pela primeira vez após a atualização, deve-se:
  
  • Revisar toda a instalação para eventuais correções e adequações para a nova versão do LumisXP.
  • Revisar todos os arquivos de configuração para eventuais correções e adequações para a nova versão do LumisXP.
  • Revisar todos os arquivos da solução para eventuais correções e adequações para a nova versão do LumisXP.
  • Revisar toda a configuração dos servidores (de aplicação, web, de banco de dados, Elasticsearch etc) para eventuais correções e adequações para a nova versão do LumisXP.
  • Reinicializar os servidores (web, Elasticsearch, de banco de dados etc) que necessitem (por exemplo, por conta de mudanças em suas configurações).