# Upgrade de instalação já existente on premises BPMS3 para Zeev (sem mudar servidor) Nesse tutorial apresentamos o passo a passo para você atualizar uma instalação existente do BPMS3 para o Zeev, **sem migração de servidores ou upgrade de hardware.** Os procedimentos devem ser realizados fora do horário comercial. ## Alertas importantes {% hint style="success" %} #### **Será que não é hora de mudar para o CLOUD?** :rocket: Entre em contato e conte com nosso apoio para migrar sua plataforma para o Zeev no Cloud. Todo o processo é simplificado. Você conta com o apoio de especialistas para tornar esse processo o mais simples e transparente possível. {% endhint %} {% hint style="warning" %} Para upgrades, **certifique-se de que seu licenciamento está dentro do prazo de atualizações e permite o upgrade**. Caso você atualize seu ambiente mas sua licença não permita o uso de novas versões, o sistema será bloqueado. O retorno a versão anterior não é possível, a não ser através de métodos de backup e restauração de toda a aplicação e do banco de dados. {% endhint %} {% hint style="danger" %} **Sempre realize os passos abaixo, primeiro, em seu ambiente de homologação.** Esteja atento a possíveis modificações no produto que possam impactar nos seus processos. Testes seus processos em homologação. {% endhint %} {% hint style="info" %} **Como podemos ajudar?** No caso da migração completa de um ambiente de produção já existente do BPMS3 para Zeev, podemos ajudá-lo através de um projeto de migração onde, a quatro mãos, iremos ajudá-lo a compreender todos os impactos da atualização, levantar e mitigar riscos e acompanhar sua equipe técnica no processo de migração. Em em contato com nossa equipe de vendas para maiores informações. {% endhint %} ## Passos pré-migração Esses procedimentos devem ser realizados dias ou semanas antes da data programa de upgrade do sistema ### Confirmar que esse é o tutorial correto Esse tutorial refere-se a atualização do sistema sem migração de infraestrutura. Isso significa que: * [ ] Não será migrado o servidor WEB
* [ ] Não será migrado o servidor de banco de dados
* [ ] Não haverá nenhuma mudança em infraestrutura de redes
* [ ] Não haverá nenhuma mudança na forma de autenticação ao sistema
* [ ] Não haverá nenhuma mudança em integrações
* [ ] Não haverá nenhuma mudança em conexões SMTP de e-mail ### Confirmar requisitos mínimos * [ ] Confirmar que você está utilizando a última versão do BPMS3 disponibilizada em
* [ ] Confirmar que você possui todos os requisitos técnicos instalados no servidor, considerando as mudanças de requisitos {% content-ref url="/pages/-MDViZtO5b0xaNBGoyDH" %} [Mudanças em requisitos técnicos de servidor](/migre-para-zeev/migracao-de-ambientes-on-premises/requisitos-tecnicos.md) {% endcontent-ref %} ### Simular os procedimentos de upgrade Caso seja possível, é altamente recomendável que todos os procedimentos desse tutorial sejam executados previamente em um ambiente de homologação ou de simulação, que seja uma cópia fiel hoje do BPMS3. Caso o BPMS3 esteja instalado hoje em uma máquina virtual, é possível, por exemplo, realizar um clone da máquina e realizar os passos de upgrade com segurança. ### Agendar data de atualização * [ ] Deverá ser pré-agendada uma data de upgrade do sistema. Recomenda-se que essa data não coincida com períodos sazonais de grande uso do sistema ou de processos críticos.
* [ ] Recomenda-se que o procedimento seja executado para iniciar a partir das 18hs.
* [ ] Se a empresa for contar com o expertise da Zeev para acompanhar o procedimento, a data e horários deverão ser pré-acordados conosco.
* [ ] Os seguintes perfis profissionais deverão estar a disposição na data e horário de upgrade:
* [ ] Técnico com conhecimento em Windows Server e IIS e senha de acesso ao servidor de produção do BPMS. * [ ] Técnico com conhecimento em SQL Server e senha de acesso ao servidor de banco de dados do BPMS, com permissão de completa no banco de dados, inclusive parar o banco e realizar backups. * [ ] Usuários de negócio com conhecimentos em processos críticos automatizados no sistema que possam testar e validar o upgrade; ## Passo a passo de upgrade de instalação BPMS3 para o Zeev Na data e horário agendados de atualização: ### Download dos últimos pacotes * [ ] Fazer o download do pacote do Zeev fornecido pela nossa equipe técnica;
* [ ] Fazer o download do pacote do Zeev Quartz fornecido pela nossa equipe técnica;
### Parar aplicação e banco de dados * [ ] No IIS, parar o website do BPMS3;
* [ ] No gerenciador de serviços do Windows (services.msc), parar o Orquestra Quartz Service;
* [ ] No servidor de banco de dados, tornar o banco de dados do BPMS3 "single user", e eliminar todas as conexões; ### Realizar backups * [ ] Realizar o backup de toda a pasta da aplicação onde está instalado o BPMS3; {% hint style="warning" %} Atenção! Os arquivos anexados em processos do sistema são salvos em filesystem, dentro do diretório de instalação do BPMS, em pasta específica. Dependendo do número de arquivos anexados, esse volume pode ser alguns GB até TB. O procedimento de backup, portanto, pode levar de alguns minutos até algumas dezenas de horas. Para fins de upgrade do sistema dentro do mesmo servidor, não é necessário realizar o backup desses arquivos. Eles não serão apagados ou substituídos. Por isso, o backup deve ser criterioso e realizado essencialmente nas pasta do sistema {% endhint %} * [ ] Realizar o backup do banco de dados do BPMS3;
* [ ] Realizar o backup de toda a pasta do Orquestra Quartz Service; ### Realizar upgrade da aplicação * [ ] Descompactar o pacote de atualização do Zeev;
* [ ] Salvar os arquivos da pasta "1. Aplicação" do pacote de atualização por sobre os arquivos da pasta onde o BPMS3 está instalado;
* [ ] Executar, no banco de dados do BPMS3, os scripts SQL da pasta "2\_Scripts\_Atualizacao";
### Atualizar web.config {% hint style="info" %} O arquivo web.config mudou consideravelmente do BPMS3 para o Zeev. Para que o arquivo web.config siga o padrão necessário para o bom funcionamento do Zeev criamos um script Powershell que atualiza o arquivo web.config de forma automática. {% endhint %} * [ ] Renomear o arquivo "web.config" para "web-backup.webconfig" na pasta raiz do sistema (isto criará um backup do arquivo).
* [ ] Executar o script Powershell "upgradeConfig-v4.ps1"
*Nesse momento o script Powershell realizará alterações no arquivo web.config do ambiente para remover tags antigas que não são mais utilizadas pelo sistema, criar tags novas que ainda não existam e alterar tags existentes com os valores que o* sistema precisa para funcionar adequadamente.
### Reestabelecer banco de dados * [ ] Retirar o banco de dados de "single user"\
### Reestabelecer sistema * [ ] Reiniciar a aplicação no IIS
* [ ] No gerenciador de serviços do Windows (services.msc), reiniciar o Orquestra Quartz Service;
* [ ] Após confirmado que a aplicação está rodando recomendamos realizar os procedimentos para [Criptografar o arquivo web.config](/migre-para-zeev/migracao-de-ambientes-on-premises/criptografar-arquivo-web.config.md). {% hint style="info" %} Nesse momento sua aplicação BPMS3 passa a ser Zeev. {% endhint %} ## Motor de alocação de tarefas v.3 Novo motor de alocação de tarefas disponibilizado na versão Zeev 4.103 de 25/04/2025. 1. Acesse o módulo de Configurações gerais avançadas; 2. Clique para editar o parâmetro "ENGINE: Versão do motor" 3. Modifique o valor de "2" para "3" (sem as aspas duplas). ## Serviços agendados (Jobs) Uma vez finalizada essa etapa da instalação do sistema é preciso configurar os serviços agendados necessários ao correto funcionamento do sistema. * [ ] Acesse http\://\/manage/jobs * [ ] Agendar recorrência de cada um dos jobs, com a expressão cron correspondente conforme modelo a seguir * [ ] EventTimer - a cada 30 minutos: \*/30 \* \* \* * [ ] SendEmail - a cada 3 horas: 0 /3 \* \* * [ ] ServiceWorkflow - a cada 3 horas: 0 /3 \* \* \* * [ ] IssueMonitoring - todo dia à 00:00: 0 0 0 \* \* ? * [ ] UserAbsence - todo dia às 03:00: 0 3 \* \* * [ ] EscalationService - a cada 3 horas: 0 /3 \* \* * [ ] TimeoutWarningService - a cada 3 horas: 0 /3 \* \* \* * [ ] ReProcessAssignmentsService - a cada 1 hora: 0 \* \* \* \* ### Testes técnicos Recomenda-se o seguinte rol de testes técnicos logo após os procedimentos de upgrade: * [ ] Logar no sistema com usuário e senha errados. Não deve permitir.
* [ ] Logar no sistema com usuário e senha corretos. Deve permitir.
* [ ] Criar um processo simples com tarefa humana. Simular o processo. Deve receber uma tarefa.
* [ ] Executar um processo simples e anexar um arquivo. Deve permitir anexar.
* [ ] Executar uma atividade posterior e fazer o download do arquivo. Deve fazer o download.
* [ ] Configurar tarefa humana para enviar e-mail de recebimento. Simular o processo. Deve receber o e-mail.
* [ ] Criar processo simples com evento de e-mail. Configurar evento de e-mail. Simular o processo. Deve receber o e-mail.
* [ ] Criar um processo simples com timer que expire dentro de alguns minutos. Executá-lo em produção. Confirmar que a tarefa do timer é automaticamente finalizada depois de alguns minutos. ### Testes de negócio Nesse momento , os analistas de negócio com conhecimento nos processos automatizados da ferramenta devem entrar no sistema e realizar a validação em processo críticos da ferramenta, homologando e concluindo o proces ## **Plano de rollback** ### Passos iniciais de rollback Caso seja necessário, por algum motivo, realizar o rollback. * [ ] No IIS, parar o website do Zeev;
* [ ] No servidor de banco de dados, tornar o banco de dados do Zeev "single user", e eliminar todas as conexões;
* [ ] Realizar o backup de toda a pasta da aplicação onde está instalado o Zeev;
* [ ] Realizar o backup do banco de dados do Zeev;
* [ ] Resgatar o backup do BPMS3 feito durante o upgrade do BPMS3 para Zeev;
* [ ] Salvar os arquivos do backup do BPMS3 por sobre os arquivos da pasta onde o Zeev está instalado;
* [ ] Renomear o arquivo web.config, presente na pasta onde o Orquestra está instalado, para web\_zeev.config * [ ] Renomear o arquivo web-backup.config, presente na pasta onde o Orquestra está instalado, para web.config ### Devo realizar restore do banco de dados? Nesse momento você deverá decidir **se irá ou não realizar o restore do backup** do banco de dados do BPMS3. {% hint style="info" %} Caso você esteja realizando o rollback da instalação *durante* o processo de atualização do BPMS3 para o Zeev, é **altamente recomendável que você realize o restore**. * [ ] Realizar o restore a partir do backup do banco de dados BPMS3 realizado no início do processo de atualização do BPMS3 para o Zeev. {% endhint %} {% hint style="danger" %} Caso você esteja realizando o rollback da instalação *após* a conclusão do processo de atualização, e após a liberação do sistema para uso por usuários, **você NÃO pode realizar o restore**, pois poderá haver perda de dados desde o ponto de backup até a liberação e uso do sistema. {% endhint %} ### Passos finais de rollback * [ ] Retirar o banco de dados de "single user"
* [ ] Re-iniciar a aplicação no IIS. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://kb.stoque.com.br/migre-para-zeev/migracao-de-ambientes-on-premises/upgrade-de-instalacao-on-premises.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.