Guia de Atualização

Este guia tem como objetivo orientar o usuário sobre as configurações necessárias nas plataformas suportadas para a atualização da solução. O intuito é garantir que o processo ocorra de forma eficiente, sem complicações.

Para essa atualização, não é necessário realizar nenhum procedimento manual para a criação de tabelas ou campos no banco de dados. O servidor de aplicação será responsável por atualizar a base de dados automaticamente. O único requisito é que o banco já esteja criado, disponível para acesso, e que o usuário encarregado da atualização tenha permissão para realizar alterações no schema.

Embora os processos de atualização sigam um padrão simples, é recomendável que a pessoa responsável tenha alguma experiência em informática, o que facilitará a execução e resolução de eventuais questões técnicas. No entanto, essa experiência não é obrigatória para concluir o processo com sucesso.

Pré-requisitos

O servidor no qual o Fusion será instalado deve ter uma capacidade adequada para a quantidade de arquivos que estarão presentes no sistema.

O tamanho mencionado no Guia de Instalação - Servidor Fusion é apenas o requisito inicial para a implementação. À medida que a plataforma é utilizada, pode ser necessário alocar mais memória no servidor, pois, ao longo do tempo, o ambiente acumulará muitos arquivos e informações, o que pode impactar no desempenho caso o tamanho não seja compatível com a quantidade de informações existentes.

Atenção

Para que o Fusion funcione corretamente, é importante liberar o acesso a determinados protocolos, que são, basicamente, regras que permitem a comunicação entre o sistema e a internet. Esses protocolos são chamados HTTP, HTTPS, WS e WSS.

Isso deve ser feito nas configurações de segurança da sua rede, como no proxy ou firewall, para garantir que o Fusion consiga se conectar e operar sem problemas.

Atualização de Versões Antigas do Fusion Platform

Para atualizar uma versão mais antiga do Fusion Platform para a mais recente, é necessário seguir algumas etapas, já que existem pré-requisitos para garantir uma transição suave, especialmente se o seu ambiente estiver em uma versão muito antiga.

Se este for o caso, você precisará realizar atualizações intermediárias antes de chegar à versão mais atual. Consulte a tabela abaixo para saber o caminho de atualização de acordo com a versão atual do seu ambiente:

Versão do Ambiente	Versão Máxima para Atualização
3.2	3.2.3
3.2.3.X	3.6.4
3.6.4	4.0.12
4.0.12	4.5.0
4.5.0	Última versão disponível

Nota

A útima versão disponível pode ser adquirida no nosso Portal do Cliente em Downloads > Versão.

Por exemplo: Se o seu ambiente estiver na versão 3.2, será necessário atualizar primeiro para a versão 3.2.3.X, depois para a versão 3.6.4, em seguida para a versão 4.0.12 e, finalmente, para a última versão disponível.

Atualizando a Release

A atualização do ambiente do Fusion Platform é fundamental para garantir que a plataforma esteja operando com as melhorias mais recentes, correções de erros e segurança aprimorada. Manter o ambiente atualizado é essencial para evitar problemas de compatibilidade, proteger os dados contra vulnerabilidades e otimizar o desempenho do sistema.

Para que a atualização ocorra de maneira eficiente e sem interrupções, é necessário seguir um conjunto específico de passos. Cada uma dessas etapas foi cuidadosamente elaborada para garantir a integridade dos dados e a continuidade das operações, minimizando riscos durante o processo.

Nota

É essencial que durante o procedimento nenhum usuário esteja utilizando a aplicação.

Abaixo estão os principais passos a serem seguidos para realizar a atualização do ambiente de maneira segura:

Quando Realizar Atualizações do Fusion Platform

A decisão de quando atualizar o Fusion Platform é tão importante quanto o processo de atualização em si. Embora a Neomind libere pacotes com novas funcionalidades, melhorias e correções a cada 15 dias, não é necessário que você atualize o sistema sempre que uma nova versão estiver disponível. Entender o momento ideal para realizar uma atualização pode otimizar o funcionamento da plataforma e evitar interrupções desnecessárias no seu ambiente.

A Neomind disponibiliza novas versões do Fusion Platform regularmente, com o objetivo de melhorar a experiência do usuário, corrigir falhas e implementar novas funcionalidades. No entanto, realizar atualizações frequentes, a cada nova versão, pode não ser prático ou vantajoso. O processo de atualização, embora necessário em alguns casos, pode exigir tempo, planejamento e adequações no ambiente de produção.

Atualizar o Fusion constantemente, a cada 15 dias, pode resultar em retrabalho e exigir ajustes frequentes no seu ambiente. Além disso, nem todas as atualizações trarão um impacto significativo nas suas operações, o que reforça a importância de escolher os momentos adequados para realizar essas atualizações.

Existem dois cenários em que a atualização do Fusion Platform se torna recomendada:

• Novas funcionalidades ou melhorias significativas: Quando uma nova versão traz funcionalidades ou melhorias que podem impactar diretamente os processos do seu negócio, a atualização é altamente recomendada. Esses detalhes podem ser consultados no Release Notes, disponível no Portal do Cliente, na aba Downloads > Versão. O Release Notes apresenta as novas funcionalidades, melhorias e correções, além de informar sobre novas versões homologadas de softwares utilizados pelo Fusion.

• Atualizações de grande impacto (versões maiores): As versões do Fusion seguem um padrão de três níveis: major, minor e patch (ex: 4.0.0). Quanto mais à direita o número da versão, menor é o impacto da atualização. Atualizações de grande impacto ocorrem quando a primeira ou segunda camada do número da versão muda (ex: de 4.0.0 para 5.0.0 ou de 4.0.0 para 4.1.0). Nesses casos, é fundamental programar a atualização o quanto antes. Já as atualizações da última camada (ex: de 4.0.0 para 4.0.1) geralmente incluem pequenas correções, e só serão necessárias se estiverem relacionadas a melhorias que se encaixam na primeira situação.

Parando o serviço do Fusion

O Fusion Platform utiliza o Apache Tomcat como servidor de aplicação para executar suas funcionalidades. O Apache Tomcat é responsável por iniciar ("subir") e encerrar ("derrubar") o ambiente. Portanto, para realizar qualquer tipo de manutenção ou atualização no Fusion, será necessário gerenciar o serviço do Tomcat, controlando quando ele deve ser interrompido ou iniciado.

Quando for preciso parar o Fusion, o processo é simples e envolve a interface de gerenciamento de serviços do Windows. Siga os passos abaixo:

1. Acesse o menu Serviços no Windows, que pode ser encontrado pesquisando "Serviços" na barra de busca.
2. Na lista de serviços, localize o serviço do Apache Tomcat que está rodando o Fusion.
3. Clique sobre o serviço correspondente ao Apache Tomcat e selecione a opção Parar.

Isso interromperá temporariamente o funcionamento do Fusion, permitindo que você realize atualizações ou manutenções no ambiente.

Backup Completo

Antes de realizar qualquer atualização no Fusion Platform, é fundamental garantir que todos os dados e configurações importantes estejam protegidos. O backup serve como uma medida de segurança essencial, pois, caso algo dê errado durante o processo de atualização, você terá a certeza de que os dados críticos e o ambiente original podem ser restaurados, evitando a perda de informações valiosas.

Para garantir que o ambiente do Fusion esteja devidamente protegido, siga os passos abaixo para realizar um backup completo:

1. Backup do banco de dados: Faça um backup completo do banco de dados utilizado pelo Fusion Platform. Isso garantirá que todos os registros e informações armazenadas estejam seguros e possam ser recuperados, caso necessário.
2. Cópia das pastas críticas: Além do banco de dados, é importante fazer uma cópia das pastas essenciais para o funcionamento do Fusion. As principais pastas que devem ser copiadas são:
   • file: Esta pasta contém arquivos armazenados do banco e que são cruciais para a operação do Fusion. Essa pasta fica dentro da pasta storage do Fusion.
   • WebContent: Esta pasta armazena os arquivos da interface e outros recursos que são utilizados no ambiente.

Para localizar o caminho da pasta file (storage), acesse o Fusion e navegue até o módulo Administração > Sistema, onde você encontrará a seção Pasta de arquivos do Fusion.

Para fazer a cópia das pastas, selecione as pastas necessárias, clique com o botão direito e escolha a opção "Copiar".

Em seguida, crie uma nova pasta em um local seguro (por exemplo, "backup") e cole os arquivos copiados dentro dessa pasta.

Com esses backups em mãos, você terá uma camada adicional de proteção, garantindo que, em caso de falha, seja possível restaurar o sistema ao seu estado anterior sem perda de dados.

Configurando o Pacote do Fusion

Após parar o serviço do Fusion e realizar o backup de todas as pastas necessárias, o próximo passo é configurar o novo pacote de atualização. Esse procedimento envolve a substituição do pacote antigo pelo novo, garantindo que o Fusion esteja atualizado para a versão mais recente.

Para realizar essa atualização, siga os passos abaixo:

1. Deletar arquivos existentes: Primeiramente, acesse a pasta WebContent no servidor do Fusion e delete todos os arquivos existentes dentro dela, exceto o arquivo application.yml que, uma vez configurado, não será necessário reconfigurá-lo.
2. Baixar o novo pacote do Fusion: A versão mais recente do pacote de atualização do Fusion pode ser obtida através do Portal do Cliente, acessando a aba Downloads > Versão.

Nota

Se você não encontrar o pacote de atualização no local mencionado, recomendamos abrir um chamado para nossa equipe de suporte, solicitando o pacote correto para seu ambiente.

3. Inserir o pacote na pasta WebContent: Após baixar o novo pacote do Fusion, insira-o dentro da pasta WebContent. É importante que o pacote não seja descompactado e que o nome do arquivo permaneça o mesmo que o do arquivo anterior, que normalmente é fusion.war.

Atenção

Se o seu ambiente possui customizações, não utilize o pacote de atualização padrão, pois ele é destinado apenas para ambientes sem modificações.

Em casos de ambientes customizados, o processo de atualização deve começar pelo ambiente de desenvolvimento. Nele, será feita a atualização e, posteriormente, gerado um pacote compatível com as suas customizações. Somente após esse procedimento, os demais ambientes poderão ser atualizados de forma segura e compatível.

Seguindo essas instruções, o novo pacote estará configurado corretamente e pronto para a próxima etapa de atualização.

Configurando o arquivo application.yml

A configuração do banco de dados do Fusion Platform deve ser realizada por meio do arquivo application.yml. Este arquivo contém as definições necessárias para a comunicação entre a plataforma e o banco de dados.

Atenção

É importante destacar que, uma vez configurado o application.yml, não será necessário reconfigurá-lo.

Caso seja necessária a reconfiguração do arquivo, siga as instruções abaixo:

1. Obtenção do arquivo atualizado: O arquivo application.yml atualizado deve ser extraído do novo pacote compactado do Fusion. O caminho para localizar esse arquivo dentro do pacote é: **\WEB-INF\classes*. Após extraí-lo, coloque o arquivo diretamente na pasta WebContent, junto com o pacote completo do Fusion*.

2. Cópia de Parâmetros Essenciais: Do arquivo application.yml antigo, copie apenas as informações essenciais, como:

   • username: o nome de usuário utilizado para a conexão com o banco de dados.
   • password: a senha correspondente ao usuário.
   • url: o caminho de acesso ao banco de dados.

   

   • diretório de cache do banco: o local onde o cache do banco será armazenado

   

Esses parâmetros devem ser inseridos no novo arquivo application.yml para manter a configuração de conexão intacta.

Nota

Por padrão, o Microsoft SQL Server vem como o banco de dados descomentado no arquivo application.yml. Caso você esteja utilizando um banco de dados diferente, é fundamental ajustar essa configuração. Para isso comente os parâmetros do SQL Server adicionando o # no inicio das linhas relacionadas a este banco e descomente as linhas do banco de dados que você está utilizando removendo o #.

Importante

Se o ambiente está sendo atualizado de uma versão anterior a 4.1.0, será necessário incluir no arquivo application.yml o parâmetro NamingStrategy, fazendo o de-para, conforme tabela disponível no Guia de Conversão 4.1.0

Seguindo esses passos, você terá configurado o arquivo application.yml corretamente, garantindo que o Fusion Platform se conecte ao banco de dados e funcione sem problemas na nova versão.

Configurações para Bancos MySQL

A partir da versão 3.20.2, é necessário realizar algumas configurações adicionais para ambientes que utilizam o banco MySQL. Isso porque, nas versões 8 do MySQL Server, o conjunto de caracteres padrão foi alterado de latin1 para utf8mb4. Como no banco de dados MySQL 5.7 o padrão é latin1, surgiu um problema de compatibilidade que deve ser corrigido conforme descrito abaixo:

Para Ambientes que Utilizam MySQL 5.7

Em cenários em que o banco está na versão 5.7 existem duas possibilidades:

• Adicionar novo parâmetro de conexão: Adicionar o seguinte parâmetro na URL de conexão do banco, presente no arquivo application.yml na pasta WebContent:

connectionCollation=latin1_swedish_ci

A URL de conexão completa ficará assim:

url: jdbc:sqlserver://127.0.0.1:1433;databaseName=fusion;applicationName=fusion;encrypt=false;connectionCollation=latin1_swedish_ci

Para mais informações sobre o parâmetro connectionCollation, consulte a documentação oficial na seguinte URL: Explicação connectionCollation

• Reverter para uma versão anterior do driver: Outra possibilidade é reverter a versão do driver para uma versão anterior. A versão mais recente que pode ser usada é a 8.0.28. Nesse caso, não será necessário nenhuma configuração adicional.

Você pode baixar a biblioteca mencionada na seguinte URL: MySQL Product Archives. Escolha a opção Platform Independent no campo Operating System e baixe o arquivo com a extensão ZIP.

Depois que o arquivo for baixado, abra o arquivo compactado e copie a biblioteca mysql-connector-java-8.0.28.jar para o caminho WebContent/fusion.war/WEB-INF/lib dentro do pacote Fusion. Além disso, delete o arquivo mysql-connector-j-8.0.33.jar do mesmo caminho, para que a nova biblioteca funcione corretamente.

Para Ambientes que Utilizam ou Querem Migrar para o MySQL 8

Para realizar a migração do banco MySQL 5.7 para o MySQL 8, o conjunto de caracteres dos campos já criados não será alterado. Nesse caso, existem dois caminhos que podem ser seguidos:

• Alterar o conjunto de caracteres padrão do Banco de Dados MySQL para latin1: Nesse caminho é preciso seguir dois passos:

1. Alterar o conjunto de caracteres e collation padrão do banco: Existem algumas maneiras diferentes para fazer isso, que vai de acordo com as particularidades da migração, uma forma interessante seria especificar as configurações de character por banco de dados. Neste caso, crie o banco de dados do MySQL e, em seguida, deve ser passado novos parâmetros, utilizando o comando a seguir:

CREATE DATABASE mydb CHARACTER SET latin1 COLLATE latin1_swedish_ci;

Para mais informações sobre essa configuração, consulte a documentação oficial detalhada sobre essa alteração na seguinte URL: Configuring Application Character Set and Collation.

2. Adicionar novo parâmetro de conexão: Adicionar o seguinte parâmetro na URL de conexão do banco, presente no arquivo application.yml na pasta WebContent:

connectionCollation=latin1_swedish_ci

A URL de conexão completa ficará assim:

url: jdbc:sqlserver://127.0.0.1:1433;databaseName=fusion;applicationName=fusion;encrypt=false;connectionCollation=latin1_swedish_ci

Para mais informações sobre o parâmetro connectionCollation, consulte a documentação oficial na seguinte URL: Explicação connectionCollation

• Alterar as tabelas e campos já existentes de latin1 para utf8mb4: Cada banco de dados no MySQL tem um conjunto de caracteres e uma collation padrão. Portanto, todas as tabelas criadas nesse esquema herdarão, por padrão, os caracteres e collation desse esquema. Para alterar isso, será necessário executar no banco de dados o seguinte comando:

ALTER SCHEMA s DEFAULT CHARSET utf8mb4;

Cada tabela também possui um conjunto de caracteres e uma collation padrão, herdados pelas colunas da tabela. Para alterar o conjunto de caracteres padrão de uma tabela, execute o seguinte comando:

ALTER TABLE t DEFAULT CHARSET utf8mb4;

A alteração do conjunto de caracteres/collation padrão de um esquema/tabela não modificará nenhuma coluna ou dado existente. Esses dois fatos implicam que, se você atualizar da versão 5.7 para a 8.0 e, após a atualização, não criar novos esquemas, o MySQL se comportará como antes em relação aos conjuntos de caracteres e collations.

Mais informações sobre a configuração para migração do Fusion do MySQL 5.7 para o MySQL 8.0, consulte a documentação oficial na seguinte URL: MySQL 8.0 Collations: Migrating from older collations

Para Ambientes Fusion Criados Utilizando a Versão do MySQL 8

Se você estiver iniciando um ambiente Fusion do zero, em uma versão superior a 3.20.2 e usando o banco MySQL 8.0, não será necessário nenhuma configuração adicional após a implantação do ambiente.

Configurações para Bancos Oracle

É importante aumentar o número máximo de cursores abertos simultaneamente no banco de dados Oracle antes de iniciar o ambiente, para garantir que o sistema possa lidar com um grande volume de consultas sem falhas. Cada consulta aberta no Oracle utiliza um cursor, e se o limite de cursores for atingido, o sistema pode apresentar erros ao processar novas requisições.

Por isso, recomendamos executar o comando abaixo, que ajusta esse limite para 3000 cursores:

ALTER SYSTEM SET open_cursors = 3000 SCOPE=BOTH;

Isso garante que o banco de dados tenha capacidade suficiente para abrir múltiplos cursores simultaneamente, evitando problemas de desempenho e interrupções no ambiente. O parâmetro SCOPE=BOTH assegura que a alteração seja aplicada imediatamente e mantida após reinicializações futuras.

Por fim, se o banco de dados utilizado for Oracle, é necessário garantir que o profile do usuário do banco tenha o timeout de conexão desabilitado para que o processo de atualização ou conversão ocorra sem interrupções. Caso o timeout esteja habilitado, pode ocorrer a desconexão durante o processo, resultando em falhas ou dados incompletos.

Para mais detalhes sobre como ajustar o timeout de conexão, consulte a documentação oficial da Oracle no link a seguir: Profile Timeout - Oracle Documentation.

Limpeza de Pastas de Cache e Logs

Após concluir as configurações necessárias para atualizar o Fusion Platform, é fundamental realizar a limpeza de algumas pastas que armazenam cache, pacotes antigos e logs de erro. Essas pastas acumulam dados temporários que, se não forem removidos, podem causar conflitos ou até impedir o correto funcionamento do Fusion.

Nota

Durante a atualização, não exclua pastas críticas (ou seus conteúdos) do sistema, como a pasta Storage. A exclusão indevida pode causar a perda definitiva de informações importantes e comprometer o funcionamento do Fusion. A exclusão da pasta Storage só pode ser realizada se a atualização for feita com banco zerado.

As pastas que devem ser limpas são as seguintes:

1. Pasta da Neomind:

   • Pasta work: Essa pasta fica na mesma estrutura de diretório que as pastas storage e WebContent. Ela armazena arquivos temporários gerados durante o funcionamento da aplicação. A limpeza dessa pasta evita que o sistema tente utilizar dados temporários que não são mais válidos na nova versão.

2. Pastas do Apache Tomcat:

   • Pasta work: Assim como a pasta work da Neomind, essa pasta no Tomcat armazena arquivos temporários. Limpar seu conteúdo é importante para garantir que o Tomcat inicie sem conflitos causados por cache antigo.
   • Pasta webapps: Contém o pacote do Fusion que foi implantado no Tomcat. O conteúdo antigo deve ser removido para evitar que versões anteriores da aplicação sejam carregadas.
   • Pasta logs: Guarda os registros de erros e eventos do Tomcat. Embora não interfira diretamente no funcionamento da aplicação, a limpeza dessa pasta ajuda a começar com registros limpos, facilitando o monitoramento de possíveis novos erros na versão atualizada.

A limpeza dessas pastas é um passo crucial antes de iniciar novamente o serviço do Fusion. Caso o Apache Tomcat seja iniciado sem deletar o conteúdo existente nas pastas mencionadas, é possível que o Fusion Platform apresente erros ou não funcione corretamente.

Garantir que essas pastas estejam vazias antes do reinício ajuda a evitar problemas de cache antigo e garante um ambiente mais limpo e estável para o Fusion Platform operar.

Nota

Durante a atualização, não exclua pastas críticas do sistema, como a pasta Storage.
A exclusão indevida pode causar a perda definitiva de informações importantes e comprometer o funcionamento do Fusion.

Atualizando Softwares Necessários

Para garantir o funcionamento adequado do Fusion Platform, é fundamental manter as versões homologadas dos softwares de suporte sempre atualizadas. Abaixo, detalharemos os principais procedimentos para atualizar as versões do Java OpenJDK e Apache Tomcat, essenciais para a operação estável e segura da plataforma.

Além disso, manter esses softwares atualizados previne vulnerabilidades, corrige possíveis falhas e melhora o desempenho geral do ambiente.

O Fusion Platform é homologado para todas as versões 21.X.X do Java OpenJDK e para as versões 10.1.X do Apache Tomcat. Isso significa que o suporte da plataforma está garantido exclusivamente dentro dessas versões. Portanto, manter essas versões atualizadas é essencial para evitar falhas e vulnerabilidades de segurança.

Informações

Para verificar se as versões mais recentes estão disponíveis, acesse os seguintes links:

• Apache Tomcat Foundation;
• Java OpenJDK.

Esses links levam diretamente para as versões mais recentes homologadas pelo Fusion. Caso sua versão seja inferior à indicada, recomendamos a atualização.

Periodicamente, a Neomind também pode homologar novas versões do Java, Apache Tomcat, GhostScript ou LibreOffice. Sempre que isso ocorrer, as versões atualizadas podem ser verificadas clicando aqui. A atualização para versões homologadas é altamente recomendada para garantir compatibilidade e estabilidade no ambiente Fusion.

A seguir, listaremos alguns pontos importantes que devem ser seguidos ao atualizar cada plataforma:

Atualizando Java OpenJDK

Para a atualização do Java OpenJDK, siga o procedimento padrão de instalação para garantir uma configuração adequada da plataforma. O Fusion Platform é homologado para todos os patches da versão 21.X.X do Java. Portanto, sempre que possível, utilize a versão mais atualizada dentro dessa linha.

Mais detalhes sobre o processo de instalação podem ser acessados clicando aqui.

Após a instalação, será necessário atualizar o caminho da Java Virtual Machine no diretório do Apache Tomcat. Acesse a pasta bin do Tomcat e ajuste o caminho para o arquivo bin\server\jvm.dll localizado no diretório do Java instalado. O caminho completo pode ser algo como: C:\Program Files\Eclipse Adoptium\jdk-21.0.5.11-hotspot\bin\server

Atualizando o Apache Tomcat

Assim como o Java, o Apache Tomcat deve ser mantido na versão mais recente da linha 10.1.X. O Fusion Platform é homologado para todos os patches dessa versão, garantindo compatibilidade e desempenho.

Siga o processo de instalação padrão para o Apache Tomcat, conforme descrito aqui, e certifique-se de realizar as configurações adequadas. Mais informações sobre a configuração podem ser acessadas aqui.

Nota

Se o arquivo server.xml do Tomcat possuir o parâmetro URIEncoding="ISO-8859-1, será necessário removê-lo ao atualizar para uma versão superior à 3.15.9 do Fusion para evitar problemas de compatibilidade.

Atenção

Ao iniciar o serviço Tomcat após a atualização, o sistema realizará automaticamente um processo de conversão de dados. A duração do processo depende do volume de informações no banco de dados, e o Fusion só estará acessível após a conclusão desse processo.

O processo de conversão não pode ser interrompido. Caso ocorra uma interrupção, será necessário restaurar o banco de dados e reiniciar o procedimento desde o início.

Com esses passos, você garantirá que o Fusion Platform esteja sempre atualizado e funcionando corretamente, evitando problemas de compatibilidade e falhas no sistema. Se surgirem dúvidas ou problemas durante o processo, entre em contato com nossa equipe de suporte.

Iniciando o Serviço do Fusion

Depois de completar todos os passos descritos neste guia de atualização, você estará pronto para iniciar o serviço do Fusion Platform novamente. Para isso, basta localizar novamente o serviço do Apache Tomcat no menu de serviços do Windows, clicar sobre ele e selecionar a opção Iniciar.

Ao iniciar o serviço, o Apache Tomcat irá carregar o Fusion Platform e a plataforma estará pronta para uso na nova versão. Se houver qualquer erro, o Fusion gerará logs que poderão ser verificados na pasta de logs do Tomcat, ajudando na identificação de possíveis problemas.

Boa prática

Recomendamos criar um agendador de tarefas no servidor para reiniciar o serviço do Fusion pelo menos uma vez por semana. Essa é uma boa prática de manutenção preventiva, que ajuda a liberar possíveis threads ou sessões presas, garantindo maior estabilidade e desempenho do ambiente.

Reconstrução dos Índices

Após iniciar o ambiente do Fusion Platform, é essencial executar a reconstrução dos índices para garantir que as pesquisas na plataforma funcionem corretamente. Esse processo reindexa todo o conteúdo presente no sistema, incluindo Documentos, Tarefas e Processos, permitindo que os resultados apareçam de forma precisa nas buscas realizadas pelos usuários.

Para realizar essa ação acesse o Fusion Platform com um usuário administrador e navegue até o menu Configuração e, em seguida, selecione a opção Atualização de Índice.

Na tela de atualização de índice, você verá diversas opções relacionadas ao conteúdo que pode ser reindexado (conforme a imagem abaixo).

Selecione as opções que deseja reindexar de acordo com a necessidade e, em seguida, clique no botão Indexar.

A duração do processo de reindexação pode variar significativamente conforme o volume de dados armazenados na base de dados do Fusion Platform. Quanto maior a quantidade de informações, mais tempo levará para que o sistema reindexe tudo. Durante esse procedimento, é possível que os usuários percebam lentidão na utilização do sistema, o que pode impactar o desempenho das operações.

Para minimizar o impacto sobre os usuários, recomendamos que a reconstrução dos índices seja feita fora do horário de expediente ou, preferencialmente, durante o final de semana. Isso garante que o processo não afete o uso diário da plataforma.

Atenção

É obrigatório realizar a atualização dos índices nas atualizações de versões do Fusion Platform. Se o seu ambiente está sendo atualizado de uma versão anterior à 3.12, a atualização dos índices é indispensável para garantir o correto funcionamento das pesquisas.