Guia de Instalação - Servidor Fusion

Bem-vindo ao Guia de Instalação do Servidor Fusion!

Este manual foi desenvolvido para orientar você em todas as etapas necessárias para configurar e instalar o Servidor Fusion, garantindo que ele funcione de forma eficiente e segura. Seja você um administrador de TI experiente ou um iniciante no uso da plataforma, encontrará instruções claras e detalhadas que o ajudarão a concluir a instalação com sucesso.

Ao longo deste guia, abordaremos os requisitos técnicos, as configurações essenciais e as boas práticas para a implantação do servidor. Além disso, incluiremos dicas úteis para evitar problemas comuns e exemplos práticos para adaptar a instalação às suas necessidades específicas.

Nosso objetivo é fornecer um material completo e de fácil consulta para tornar o processo o mais simples e direto possível. Caso precise de suporte adicional, nossa equipe está à disposição para ajudar. Qualquer dúvida relacionada a este manual pode ser esclarecida mediante a abertura de um chamado em nosso Portal do Cliente.

Prepare-se para iniciar sua configuração e aproveitar ao máximo os benefícios que o Fusion pode oferecer!

Atenção

Para qualquer instalação de aplicações, sejam elas referentes aos pré-requisitos do servidor, da estação de trabalho ou da solução Fusion, certifique-se de ler e revisar cuidadosamente as notas.

Requisitos Mínimos para Instalação

Para que o Fusion seja instalado corretamente, é necessário atender a algumas configurações mínimas de hardware e software, tanto no servidor quanto nas estações de trabalho dos usuários.

Servidor

Os requisitos mínimos descritos neste guia garantem que o Fusion funcione adequadamente durante a implantação inicial, evitando problemas como lentidão ou quedas no ambiente. No entanto, o servidor onde o Fusion será instalado deve ser dimensionado para a quantidade de arquivos e dados que serão armazenados ao longo do tempo.

O tamanho mencionado aqui é apenas o requisito inicial. Com o uso contínuo da plataforma, pode ser necessário aumentar os recursos do servidor, já que o acúmulo de arquivos e informações pode impactar no desempenho se os recursos não forem suficientes.

Recomendamos a contratação do serviço de sizing para garantir o dimensionamento adequado, considerando suas demandas específicas. Esse serviço analisa fatores como número de usuários, volume de dados e funcionalidades avançadas, e ajuda a garantir que o servidor tenha capacidade para suportar o crescimento e as necessidades do ambiente.

Além disso, é altamente recomendado que os ambientes de Produção e Homologação sejam configurados em servidores separados, assim como seus respectivos bancos de dados. Os requisitos listados abaixo se aplicam a um único ambiente. Caso deseje instalar ambos os ambientes no mesmo servidor, será necessário dobrar os recursos indicados. Contudo, a melhor prática é manter cada ambiente em servidores distintos.

Outra recomendação importante é que o banco de dados esteja em um servidor separado do servidor do Fusion, sempre que possível, para melhorar o desempenho.

Atenção

Certifique-se de realizar a instalação compatível com a versão do seu sistema operacional, pois algumas aplicações oferecem opções diferentes de download para sistemas de 32 ou 64 bits.

Componentes	Requisitos
Disco	Pelo menos 8 GB de espaço livre em disco para a instalação.
Memória RAM	8 GB (se o banco de dados estiver no mesmo servidor, recomenda-se 16 GB).
Processamento	Processador Quad Core (preferencialmente com 2 núcleos).
Sistema Operacional	Windows Server 2012 ou superior.
Banco de Dados	SQL Server 2022 ou superior Oracle 19c, 21c e 23ai MySQL 8.0.x (qualquer versão dentro da série 8.0)
Softwares	Java OpenJDK-21 (ou superior dentro da versão 21 (21.X.X)) Apache Tomcat 10.1 (ou superior dentro da versão 10.1 (10.1.X)) Microsoft Office 2013 ou superior LibreOffice 7.3.7.2 (para Conversor de Documentos Padrão ou Distribuído) GhostScript 10.05.1 (para Conversor de Documentos Padrão ou Distribuído) Edrawings 2019 (para Conversor de Documentos Distribuído)

Atenção

Demais bancos de dados, como PostgreSQL ou MariaDB, não são recomendados, pois podem apresentar problemas de desempenho com o tempo.

Banco de Dados

Os bancos de dados homologados são Microsoft SQL Server, Oracle e MySQL, no entanto, possuímos alguns requisitos necessários para que o banco do Fusion funcione sem erros.

• A collation do banco de dados deve ser Case Insensitive.
• Para utilização do Fusion em português, é recomendado utilizar uma collation Accent Sensitive.

Informações

Se desejar utilizar o Fusion em outro idioma, consulte a documentação do banco de dados para verificar a collation adequada.

Atenção

No banco de dados do Fusion, não devem ser criadas views nem tabelas manualmente. Alterações na estrutura podem impactar o funcionamento da plataforma e comprometer futuras atualizações. Caso seja necessário armazenar informações adicionais, recomendamos avaliar outras alternativas ou entrar em contato com o suporte para orientações.

Estação de Trabalho

Para garantir que o Fusion funcione corretamente nas estações de trabalho dos usuários, é importante atender aos requisitos mínimos de hardware e software listados abaixo. Esses requisitos são projetados para oferecer desempenho adequado e estabilidade no uso do sistema.

Componentes	Requisitos
Disco	150 MB de espaço livre em disco
Memória RAM	2 GB
Processamento	Dual-Core ou superior
Sistema Operacional	Windows 10 ou superior
Softwares	Microsoft Office 2013 ou superior LibreOffice 7.3.7.2
Resoluções	1024 x 768 ou superior
Browsers	Google Chrome 110.0 ou superior Microsoft Edge 110.0 ou superior Safari 15.4 ou superior

Certifique-se de que as estações de trabalho atendem aos requisitos acima para garantir o melhor desempenho possível ao usar o Fusion. A compatibilidade de softwares e resoluções de tela também são essenciais para evitar problemas na utilização do sistema.

Fusion Mobile

Para garantir que o Fusion seja executado corretamente nos dispositivos móveis, é necessário que os usuários atendam aos requisitos mínimos do sistema operacional, conforme indicado abaixo. O suporte para versões mais recentes do Fusion Mobile permite uma experiência otimizada e funcionalidades completas.

Sistema	Requisitos
Fusion	4.0.0 ou superior
Android	7.0 à 16.0 (ou superior dentro da versão 16 (16.X.X))
IOS	11.0 à 26.0 (ou superior dentro da versão 26 (26.X.X))
Fusion Mobile	versão 1.16.0

Atenção

Recomendamos o uso de aparelhos e marcas mais comuns no mercado.

Caso você possua um modelo muito específico e ele apresente problemas, mesmo nas versões de sistema operacional homologadas pelo Fusion, entre em contato com nosso suporte para que possamos viabilizar o envio do seu aparelho para nossa análise, permitindo uma avaliação mais detalhada baseada nas particularidades do seu dispositivo.

Instalando o Fusion

Este guia é destinado a profissionais de TI e técnicos de sistemas com experiência em informática, que estarão responsáveis pela instalação do Fusion Platform. Embora alguns processos de instalação sejam padrões, a experiência prévia será essencial para garantir a correta configuração e operação da solução.

Nosso objetivo aqui é descrever, de maneira objetiva e por etapas, todos os procedimentos necessários para a instalação do Fusion Platform. Este guia abrange desde os passos iniciais até a configuração final da plataforma nas diversas versões suportadas.

Para realizar a instalação e atualização da solução, não será necessário realizar procedimentos complexos, como a criação de tabelas ou campos no banco de dados. O servidor de aplicação será responsável por atualizar automaticamente a base de dados durante a primeira implementação da aplicação. O único requisito essencial é que o banco de dados já esteja criado, disponível para acesso e que o usuário tenha permissões adequadas para alterar o esquema.

Estrutura de Pastas Padrão

Para garantir o correto funcionamento e organização dos arquivos relacionados ao Fusion, é altamente recomendado criar a seguinte estrutura de pastas no diretório. Essa organização facilitará o gerenciamento dos arquivos e contribuirá para a eficiência do sistema:

• Pasta 1: C:\neomind
• Pasta 2: C:\neomind\fusion
• Pasta 3: C:\neomind\fusion\storage
• Pasta 4: C:\neomind\fusion\WebContent
• Pasta 5: C:\neomind\fusion\work

1. Pasta neomind: Esta será a pasta principal onde todos os arquivos relacionados ao Fusion Platform serão armazenados. Ela serve como o diretório raiz para a estrutura do Fusion e da Neomind. Dentro dessa pasta, organizaremos os arquivos essenciais para o funcionamento do sistema.
2. Pasta fusion: Dentro da pasta neomind, crie uma subpasta chamada fusion, que será o local centralizado para todos os arquivos e downloads relacionados ao Fusion. Exemplo: pacotes de instalação, arquivos de configuração, etc. Essa pasta terá as seguintes subpastas:
   • Pasta storage: Essa pasta será usada para armazenar informações do banco de dados do Fusion É crucial para o funcionamento da plataforma e nunca pode ser deletada. Caso seja removida, você perderá dados importantes, como informações de processos modelados ou documentos publicados.
   • Pasta WebContent: A subpasta WebContent será utilizada para armazenar o pacote do Fusion (os arquivos necessários para rodar a aplicação) e o arquivo de configuração do banco de dados. Isso facilita a organização e acesso rápido aos arquivos necessários para configurar e manter a aplicação.
   • Pasta work: A pasta work será destinada ao armazenamento de arquivos temporários gerados durante a execução do Fusion. Esses arquivos são usados para processos temporários e podem ser deletados sempre que necessário, sem impacto no funcionamento do sistema. Por exemplo, arquivos de logs ou arquivos temporários gerados durante o processamento de dados.

Todos os arquivos provenientes de downloads, em relação ao Fusion, devem ser armazenados na pasta C:\neomind\fusion, para garantir a organização e o bom funcionamento do sistema.

Atenção

É essencial que a instalação e a configuração dos requisitos sejam realizadas por um usuário administrador do servidor, a fim de garantir que todas as instalações e ajustes sejam aplicados corretamente.

Instalando o Pacote do Fusion

O Fusion é disponibilizado como um arquivo no formato .war. Esse tipo de arquivo funciona de forma semelhante a um .zip, ou seja, é um arquivo compactado que contém toda a estrutura necessária para a aplicação. No entanto, ao contrário de arquivos comuns que podem ser extraídos completamente, o .war é projetado para ser implantado diretamente em um servidor de aplicação, como o Apache Tomcat.

⚠️ Importante: O pacote fusion.war não deve ser extraído completamente. O servidor de aplicação precisa desse formato para gerenciar corretamente a execução do Fusion. Apenas um único arquivo dentro dele, o application.yml, deve ser extraído para permitir a configuração do banco de dados.

O arquivo fusion.war pode ser obtido no Portal da Neomind acessando o menu Downloads > Versões.

Uma vez baixado, recomendamos que o arquivo seja armazenado na pasta WebContent, conforme orientado na seção sobre a estrutura de pastas.

Para configurar o banco de dados, é necessário extrair apenas o arquivo application.yml de dentro do pacote .war.

Para isso, abra o arquivo fusion.war, utilizando um software de extração como WinRAR ou 7-Zip, navegue até o caminho WEB-INF/classes/application.yml, selecione o arquivo application.yml e clique em "Extrair Para". Note que apenas o arquivo application.yml deve ser extraído.

O arquivo deve ser extraído para a mesma pasta onde está o fusion.war, ou seja, dentro da pasta WebContent.

Após selecionar o local correto, pressione "OK" para concluir a extração.

Após essa etapa, o usuário poderá prosseguir com a configuração dos outros componentes necessários para o funcionamento do Fusion.

Configurando o application.yml

O arquivo application.yml contém configurações essenciais para o funcionamento do Fusion, como a conexão com o banco de dados e o caminho das pastas de armazenamento. Seguir corretamente esses passos garante que a aplicação funcione sem erros.

Configuração do Banco de Dados

Para que o Fusion possa armazenar e acessar dados corretamente, é necessário configurar a conexão com o banco de dados dentro do arquivo application.yml.

Para configurar o banco de dados, abra o arquivo application.yml utilizando um editor de código com permissões de administrador, localize a seção referente ao banco de dados que você utilizará e configure os parâmetros corretamente.

• url: Informe o endereço IP e a porta utilizada para conectar ao banco, por padrão o valor é 127.0.0.1:1433 que significa que o banco está rodando no servidor local em porta 1433 e em databaseName informe o nome do seu banco de dados.
• username: Defina um usuário com permissões administrativas no banco.
• password: Insira a senha do usuário do banco de dados.

📌 Exemplo da configuração de banco de dados no application.yml.

Nota

O usuário configurado no application.yml precisa ter permissões totais dentro da base de dados. Isso é necessário para que o Fusion crie suas tabelas e rotinas automaticamente.

💡 Se estiver utilizando um banco de dados diferente do Microsoft SQL Server, remova o comentário da configuração correspondente e comente a configuração padrão.

📌 Caso utilize o banco MySQL, a configuração deve seguir o exemplo abaixo:

📌 Caso utilize o banco Oracle, a configuração deve seguir o exemplo abaixo:

Atenção

Para o correto funcionamento do servidor OLAP em banco de dados Oracle, nas configurações do application.yml é obrigatório configurar o username e schema com o mesmo valor.

Configuração das Pastas de Armazenamento

Além da configuração do banco de dados, é necessário definir onde os arquivos do Fusion serão armazenados no servidor.

Para isso, no arquivo application.yml, localize a configuração referente ao armazenamento e defina o caminho da pasta onde os arquivos do Fusion serão salvos.

Dentro do arquivo application.yml há uma configuração que representa a pasta onde todas as pastas de armazenamento do Fusion serão criadas.

Se você seguiu a estrutura de pastas recomendada neste guia, basta copiar e colar o seguinte caminho:

C:\\neomind\\fusion\\storage

Caso tenha alterado o diretório, ajuste esse caminho conforme necessário.

Atenção

Sempre use duas barras invertidas (\) como separador de pastas.

📌 Exemplo da Configuração no Arquivo:

Após concluir as configurações do application.yml, salve o arquivo e feche o editor.

Agora, seu Fusion está pronto para ser conectado ao banco de dados e armazenar os arquivos corretamente! 🚀

Personalização do nome exibido no autenticador

Caso seu ambiente use a função de autenticação em dois fatores, é possível personalizar o nome que aparece no aplicativo autenticador.

Por padrão, o nome exibido será Fusion Platform, mas você pode alterar esse nome para algo mais representativo da sua organização ou do ambiente em questão.

Para isso, adicione a propriedade appName dentro da chave authentication.twoFactor no arquivo application.yml, conforme o exemplo abaixo:

authentication:
    twoFactor:
        appName: Nome desejado

Com isso, o nome exibido no aplicativo autenticador será o valor informado em appName.

Instalando o Java OpenJDK

Para funcionar o Fusion requer o Java OpenJDK 21 (ou versões superiores dentro da linha 21.0.X) para funcionar corretamente. O OpenJDK é um ambiente de execução essencial para aplicações Java, garantindo a compatibilidade e o desempenho esperado da plataforma.

Para instalar a versão homologada para uso com o Fusion, siga os passos abaixo.

Atenção

Somos homologados para todos os patches da versão 21 do Java. Portanto, recomendamos sempre a instalação da versão mais atualizada do Java 21.X.X para garantir melhor desempenho, segurança e compatibilidade.

Baixando o OpenJDK 21

O OpenJDK pode ser baixado diretamente pelo site oficial do Adoptium, acessando o link: Baixar OpenJDK 21.

No momento do download, escolha a versão compatível com o sistema operacional do servidor.

Nota

Para Windows, é altamente recomendado baixar a versão com extensão .msi, pois esse formato já inclui um instalador gráfico que facilita a configuração e evita erros manuais. Caso seja baixado um arquivo .zip, será necessário configurar o ambiente Java manualmente, o que pode ser mais complexo.

Instalando o OpenJDK

Após o download, execute o arquivo .msi para iniciar a instalação. Siga as instruções exibidas na tela para concluir a instalação. O assistente de instalação já aplicará as configurações padrão recomendadas. Após a conclusão, o OpenJDK estará pronto para uso no servidor.

Com isso, o ambiente Java estará devidamente configurado, permitindo a instalação e execução do Fusion sem complicações.

Instalando o Apache Tomcat

O Fusion utiliza o Apache Tomcat como servidor de aplicação para processar suas requisições. Para garantir compatibilidade e estabilidade, o Fusion é homologado para todas as versões 10.1.X do Tomcat.

Recomendamos sempre utilizar a versão mais recente dentro da versão 10.1 para garantir segurança e melhor desempenho.

Baixando o Apache Tomcat

Para baixar a versão mais atualizada do Tomcat 10.1, acesse o site oficial: Baixar Apache Tomcat 10.1.

Dentro da página de downloads, selecione a opção "Windows Service Installer", pois essa versão inclui um instalador gráfico que facilita a configuração e evita a necessidade de ajustes manuais.

Instalando o Apache Tomcat

Após baixar o instalador, execute o arquivo e siga as instruções do assistente de instalação.

Durante a instalação, será exibida uma tela para configurar a Java Virtual Machine (JVM). Nesse momento, altere o caminho para a pasta onde o OpenJDK foi instalado, conforme as instruções deste guia.

Configurando o Servidor Tomcat

Após instalar o Apache Tomcat, é necessário realizar ajustes no arquivo de configuração para garantir o funcionamento adequado do Fusion.

Essas configurações envolvem ajustes de portas, permissões e referências aos diretórios onde os arquivos do Fusion estão armazenados.

Configurando o Arquivo server.xml

O arquivo server.xml contém as principais configurações do Tomcat e deve ser ajustado conforme os passos a seguir.

Acesse o diretório de instalação do Tomcat e navegue até a pasta conf. Abra o arquivo server.xml utilizando um editor de código, como Notepad++, em modo administrador. Isso é necessário para que as alterações sejam salvas corretamente.

Dentro do arquivo server.xml, localize a configuração do Connector. Esse trecho define como o Tomcat receberá as requisições HTTP. Adicione o seguinte parâmetro dentro da tag Connector:

maxPostSize="-1"
discardFacades="false"

• O parâmetro maxPostSize="-1" define que não haverá limite para o tamanho das requisições POST, evitando erros ao enviar arquivos grandes para o Fusion.

• O parâmetro discardFacades="false" é necessário para evitar falhas de conexão com o FusionBox.

📌 Exemplo da configuração dentro do Connector:

Nota

Caso já exista outra aplicação utilizando a porta 8080, será necessário alterá-la para uma porta livre. Para isso, no parâmetro port, coloque uma porta que esteja livre, pois é nela que o servidor do Fusion irá subir.

Atenção

Para garantir o correto funcionamento de funcionalidades que envolvem envio de dados extensos no cabeçalho HTTP, é necessário incluir o seguinte parâmetro no(s) Connector(es) do Tomcat:

maxHttpHeaderSize="10000000".

Esse ajuste aumenta o limite padrão do Tomcat, prevenindo erros durante operações que exigem o envio de um grande volume de informações no cabeçalho da requisição. Caso o Tomcat possua mais de um Connector, o parâmetro deve ser incluído em todos.

Nota

Para otimizar o desempenho do seu servidor Fusion, você pode ativar a compressão HTTP ou configurar o uso do NGINX como proxy reverso.

A compressão HTTP reduz o tamanho dos dados transmitidos entre o servidor e os clientes, melhorando o tempo de resposta e o consumo de banda. Para utilizar a compressão HTTP, adicione no atributo Connector do arquivo server.xml do Tomcat o seguinte trecho de código:

compression="on"
compressionMinSize="2048"
noCompressionUserAgents="godzilla"
compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,text/x-component"

📌 Após a alteração, o atributo Connector deve ficar assim:

A compressão HTTP ajudará a reduzir o tempo de carregamento das páginas e otimizará o uso da rede no seu ambiente Fusion.

O Tomcat precisa estar configurado para localizar corretamente os arquivos do Fusion. Para isso, dentro da tag Host, será necessário adicionar uma configuração de Context.

Adicione o seguinte trecho dentro da tag Host:

<Context crossContext="true" debug="0" 
         docBase="C:/neomind/fusion/WebContent/fusion.war" 
         path="/fusion" 
         reloadable="false" 
         workDir="C:/neomind/fusion/work" 
         previleged="true"/>

📌 Exemplo da configuração dentro do Connector:

📌 Explicação dos Parâmetros:

• docBase="C:/neomind/fusion/WebContent/fusion.war: Indica o caminho onde o pacote fusion.war está localizado. Se você seguiu a estrutura de pastas recomendada neste guia, basta copiar e colar essa linha. Caso tenha alterado o diretório, ajuste esse caminho conforme necessário.
• path="/fusion": Define a URL de acesso ao sistema. Por exemplo:
  • Se configurado como /fusion, o acesso será feito em *http://localhost:8080/*fusion.
  • Caso alterado para /fusion_cliente, o acesso será *http://localhost:8080/*fusion_cliente.
• workDir="C:/neomind/fusion/work": Indica o diretório onde o Tomcat armazenará arquivos temporários do sistema. Se você seguiu a estrutura de pastas recomendada, esse caminho já está correto.

Após realizar todas as alterações, salve o arquivo server.xml e feche o editor de texto.

Configurando o Tomcatw

Acesse a pasta bin dentro do diretório do Tomcat e execute o arquivo Tomcatw.

No painel de configurações, selecione a aba Java e adicione os seguintes parâmetros no campo Java options:

📌 Parâmetros Obrigatórios:

• Definição do arquivo de configuração externo

-Dfusion.configuration=C:\neomind\fusion\WebContent\application.yml

Permite que o Fusion carregue configurações do arquivo application.yml de forma externa ao war. Caso não for adicionado o parâmetro, será utilizado o arquivo de dentro do projeto.

• Definição do Encoding Padrão UTF-8

-Dfile.encoding=UTF-8

Garante que a aplicação utilize UTF-8 como padrão para evitar problemas de acentuação e caracteres especiais.

• Parâmetro para desabilitar o cache de banco de dados

-Dfusion.ignore.db.cache=true

Esse parâmetro é essencial para evitar problemas relacionados ao travamento do sistema ao criar ou editar campos em formulários. Ele desativa temporariamente o uso do cache de banco de dados interno do Fusion, evitando comportamentos inconsistentes em situações específicas.

• Permissões de acesso a APIs internas do Java (Reflection)

--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.math=ALL-UNNAMED
--add-opens=java.base/java.util=ALL-UNNAMED
--add-opens=java.base/java.util.concurrent=ALL-UNNAMED
--add-opens=java.base/java.net=ALL-UNNAMED
--add-opens=java.base/java.text=ALL-UNNAMED
--add-opens=java.sql/java.sql=ALL-UNNAMED

Esses parâmetros permitem que o Fusion acesse partes internas do Java necessárias para o funcionamento de bibliotecas como o FSTConfiguration. Sem eles, o sistema pode falhar ao tentar realizar operações que dependem desses acessos.

Atenção

O FusionBox depende de acessos internos do Java e de operações de reflection para funcionar corretamente. A partir do Java 9, esses acessos são restritos por padrão por questões de segurança e modularidade. Se os parâmetros acima não forem configurados, o Java irá bloquear esses acessos, impedindo que o FusionBox seja iniciado.

🔐 Parâmetro de Segurança (Opcional):

• Força a utilização de HTTPS (Se houver certificado SSL configurado)

-Dfusion.strictTransportSecurityType=true

Redireciona automaticamente todas as conexões HTTP para HTTPS, aumentando a segurança da aplicação.

• Mantém o padrão sem redirecionamento para HTTPS

-Dfusion.strictTransportSecurityType=false

Mantém a configuração padrão sem forçar HTTPS.

🎛 Parâmetros Opcionais para Customizações:

• Carregar arquivo de customizações externas

-Dfusion.custom=file:\C:\neomind\fusion\WebContent\customflags.properties

Permite definir arquivos de customização de forma externa ao war do projeto. Se não for configurado, será usado o arquivo padrão interno.

• Definir arquivo externo de logs

-Dlog4j.configurationFile=file:\C:\neomind\fusion\WEB-INF\classes\log4j2.xml

Permite que o arquivo de log seja gerenciado de forma externa ao war do projeto. Se não for adicionado, o Fusion usará o arquivo padrão dentro do war.

• Habilitar pesquisa com herança de processos

-Dfusion.enable.hierarchy.search=true

Permite que as consultas simples de processos utilizem herança para encontrar processos relacionados.

📄 Parâmetro para Conversão de Documentos: (Necessário se usar o Microsoft Office para conversão)

• Definir pasta auxiliar para conversão de documentos

-Djava.io.tmpdir=C:\neomind\fusion\converter

Define uma pasta auxiliar para conversão de documentos, evitando problemas com nomes de pastas que contenham espaços.

Atenção

Antes de adicionar esse parâmetro, crie a pasta converter no seguinte caminho: C:\neomind\fusion\converter, seguindo as pastas orientadas no início desse guia.

🕒 Parâmetros para Melhorar o Desempenho dos Temporizadores (Opcional – Recomendado para ambientes com grande volume de processos)

Esses parâmetros permitem que os temporizadores sejam executados em paralelo, reduzindo atrasos quando há muitos eventos agendados ao mesmo tempo. São opcionais, mas podem melhorar o desempenho dependendo da capacidade do servidor.

• Número de execuções simultâneas de temporizadores

-Dfusion.scheduler.number-background-threads=6

Define quantos temporizadores podem ser executados ao mesmo tempo, permitindo que várias ações agendadas sejam processadas simultaneamente.

• Valor padrão do Fusion: 2

• Valor permitido: 1 a 20

• Quanto maior o valor, mais eventos podem ser executados em paralelo — desde que o servidor suporte.

• Priorizar temporizadores

-Dfusion.scheduler.prioritize-deadlines=true

Quando ativado, o Fusion prioriza a execução dos temporizadores antes de outros jobs internos do sistema (como tarefas do agendador).

• Padrão: false
• Recomendado apenas quando há muitos temporizadores acumulados ou atrasos perceptíveis.

Atenção

Esses parâmetros são opcionais e devem ser ajustados conforme o desempenho do servidor. Usar um número muito alto de threads em servidores com pouca CPU pode causar lentidão geral. Antes de aplicar em produção, recomendamos testar em homologação.

Se o Tomcat estiver configurado como serviço no Windows, adicione os seguintes parâmetros no campo Java 9 Options para evitar problemas de compatibilidade:

--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.math=ALL-UNNAMED
--add-opens=java.base/java.util=ALL-UNNAMED
--add-opens=java.base/java.util.concurrent=ALL-UNNAMED
--add-opens=java.base/java.net=ALL-UNNAMED
--add-opens=java.base/java.text=ALL-UNNAMED
--add-opens=java.sql/java.sql=ALL-UNNAMED
--add-opens=java.base/java.io=ALL-UNNAMED
--add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
--add-opens=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED

Essas opções garantem compatibilidade com versões mais recentes do Java e evitam erros ao iniciar o serviço do Tomcat.

Ajuste de Memória

Para garantir o desempenho adequado do Fusion, ajuste a alocação de memória na aba Java:

• Initial memory pool: 512 MB
• Maximum memory pool: 4096 MB

Dessa forma, o Apache Tomcat iniciará sua execução com 512MB da memória do servidor e seu limite máximo de memória utilizado será de 4096MB.

Atenção

Esta é a configuração mínima recomendada. Se valores menores forem usados, a aplicação pode apresentar lentidão ou quedas.

Ajustes de Inicialização

Para garantir que o Tomcat inicie corretamente ao ligar o servidor, faça os seguintes ajustes:

Na aba Log on, selecione a opção Local System Account.

Na aba General, altere o campo Startup type para Automatic.

Isso garante que o Tomcat seja iniciado automaticamente quando o servidor for ligado.

Limpeza da Pasta webapps

Navegue até a pasta de instalação do Tomcat, acesse a pasta webapps e remova todo o conteúdo.

Remover essa pasta evita conflitos entre versões antigas ou outras aplicações e a nova instalação do Fusion.

Com essas configurações, o Tomcat estará pronto para rodar o Fusion de forma otimizada e segura! 🚀

Iniciando o Servidor

Agora que o Apache Tomcat está configurado, é hora de iniciar o servidor para que o Fusion Platform fique disponível.

Para isso, abra o menu Iniciar do Windows e pesquise por Serviços. Na lista de serviços, localize Apache Tomcat. Selecione-o e clique na opção Iniciar, conforme mostrado abaixo:

Isso fará com que o Tomcat inicialize e o Fusion Platform fique disponível para acesso.

Acessando o Fusion Platform

Após iniciar o serviço, abra o navegador de sua preferência e acesse o seguinte endereço:

http://<servidor>:porta/fusion

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.

Se tudo foi configurado corretamente, você verá a tela de login do Fusion Platform! 🚀

🔑 Credenciais iniciais:

• Usuário: adm
• Senha: adm

Ao acessar o Fusion Platform pela primeira vez, será necessário redefinir a senha do usuário Administrador. A nova senha deve seguir os requisitos de segurança estabelecidos pela plataforma.

Caso tenha dúvidas ou encontre problemas, revise as etapas anteriores para garantir que todas as configurações foram aplicadas corretamente. Se todas as configurações estiverem corretas e mesmo assim o Fusion Platform não iniciar, recomendamos que você abra um chamado em nosso Portal do Cliente, informando as ações realizadas e os erros encontrados. Nossa equipe estará disponível para auxiliá-lo na resolução do problema.

Instalação de Componentes para Conversor de Documentos

Os visualizadores de documentos do Fusion (Visualizador Universal e Visualizador PDF) convertem todos os formatos compatíveis, incluindo PDF, documentos editados no Word e Excel, entre outros. A conversão é realizada inicialmente para um formato interno e depois para um formato externo, sendo visível diretamente na tela através de uma página do Fusion. Para isso, é necessário instalar os seguintes elementos:

• Instalação do LibreOffice como conversor para aplicativos do pacote Office como Word, Excel, PowerPoint, etc. Deve ser instalado tanto na configuração de conversão padrão quanto na distribuída.
• Instalação do GhostScript como conversor de PDF e imagens. Assim como o LibreOffice, deve ser instalado em ambas as configurações..
• Instalação do eDrawings como conversor de arquivos AutoCad. Este componente é opcional e só deve ser instalado na configuração de conversores distribuídos.

Nota

Caso tenha interesse, também é possível realizar a conversão de arquivos .doc e .docx com a instalação do Microsoft Office.

Configuração da Conversão de Documentos

O Fusion oferece duas opções de configuração para a conversão de documentos: Padrão e Distribuída.

• Conversão Distribuída: Permite que o Fusion utilize servidores externos dedicados para processar a conversão de documentos, melhorando a performance ao aliviar recursos do ambiente principal do Fusion. Dessa forma, o ambiente Fusion não será responsável pela conversão dos documentos, e sim um conversor externo ao ambiente, poupando recursos alocados especificamente para o Fusion e melhorando a performance. Para mais detalhes sobre como configurar esta opção, consulte o Guia de Configuração - Conversor de Documentos Distribuído.
• Conversão Padrão: Realiza a conversão utilizando recursos do ambiente do Fusion para realizar a conversão de documentos. Nesta configuração, não é possível utilizar o eDrawings, ou seja, a conversão de arquivos AutoCAD não será suportada.

Instalar o LibreOffice

Para baixar o LibreOffice, acesse: Baixar o LibreOffice.

Após a finalização do download, realize a instalação padrão, seguindo os passos indicados nas telas.

Instalar GhostScript

Para instalar o GhostScript acesse: Baixar o GhostScript.

Após o download, realize a instalação padrão seguindo as instruções da tela.

Instalar e Configurar o Microsoft Office

Caso opte por utilizar o Microsoft Office e possua uma licença válida, siga a instalação padrão e realize as configurações abaixo.

Atenção

O uso do Microsoft Office como conversor de documentos exige a configuração de um parâmetro adicional no Tomcat. Para mais informações leia com atenção as orientações da seção Configurando o Tomcatw deste guia.

Atenção

Ao habilitar a conversão de arquivos com o Microsoft Office, apenas arquivos .doc e .docx serão convertidos por ele. Todas as outras extensões continuarão sendo processadas pelo LibreOffice.

Nota

Caso durante a configuração final do Microsoft Office, ocorra qualquer problema que pode estar relacionado a permissão ou usuário que instalou, indicamos que seja realizada a reinstalação do pacote Office.

Para que o Fusion utilize o Microsoft Office como conversor de arquivos, é necessário configurar o serviço do Microsoft Word com um usuário específico. Para isso, deve-se realizar a configuração DCOM abaixo:

No menu Executar do Windows, digite dcomcnfg e pressione Enter. Na pasta "DCOM Config", localize o "Documento do Microsoft Word 97 -2003".

Clique com o botão direito do mouse e selecione Propriedades. Depois, acesse a aba Identidade e selecione Este usuário. Insira o usuário e senha que serão utilizados pelo dcom e pelo serviço do Fusion.

Atenção

O usuário configurado deve ser administrador local e ter realizado um login interativo no sistema para criar o perfil que o Word precisa para converter documentos.

No Microsoft Word, habilite a opção “Atualizar campos antes de imprimir”, acessando Arquivo > Opções:

Na aba Exibir, selecione a opção indicada:

Finalize clicando em “Ok”.

No Fusion, habilite a opção “Utilizar Microsoft Office” nas configurações do sistema.

Configurando a Conversão de Documentos dentro do Fusion

Após a instalação dos componentes, configure o Fusion para utilizar os conversores conforme a necessidade do ambiente.

Efetue o login no Fusion e acesse Administração > Sistema.

Essas são as configurações pertinentes ao conversor de documentos:

• Distribuído: Selecione Sim para permitir que a conversão seja realizada por servidores externos.
• Utilizar Microsoft Office: Selecione Sim para utilizar o Microsoft Office como software padrão para abertura de arquivos em formato .doc e .docx. Caso contrário, o sistema utilizará o LibreOffice para abertura desses arquivos.
• Threads para conversão: Informe quantas conversões serão realizadas em paralelo.
• Pasta para cache: Informe o caminho da pasta onde os documentos convertidos serão armazenados.
• Linha de comando do conversor de PDF p/ Imagem: Informe o caminho do GhostScript, apontando ao executável. Se o GhostScript foi instalado no caminho padrão, ele provavelmente estará localizado em:

C:\Program Files\gs\gs10.00.0\bin\gswin64c

• Caminho do LibreOffice: Informe o caminho do LibreOffice, apontando ao executável. Caso o LibreOffice tenha sido instalado no caminho padrão, você pode encontrá-lo em:

C:\Program Files\LibreOffice\program\soffice.exe

• Adapter de Customização: Insira a customização que desejar.
• Qualidade em DPI da visualização de arquivos: Essa opção permite que o usuário defina a resolução a qual os arquivos devem ser exibidos. Além de poder escolher a resolução de 100 a 150 DPIs, também é possível selecionar a opção Automática
• Habilitar OCR em Documentos: Selecione Sim para habilitar a pesquisa por imagem dentro de documentos, possibilitando pesquisas por termos nos arquivos inseridos. Selecionando Não nenhuma pesquisa poderá ser realizada.
• OCR Distribuído: Selecione Sim para desvincular o OCR do Conversor de Arquivos, tornando-o independente. Com esta opção, será possível distribuí-lo, deixando-o fora do Fusion. Selecionando Não o OCR será vinculado a plataforma. Caso selecione Sim, será necessário realizar a configuração no servidor para garantir que o OCR funcione de forma distribuída. Para mais informações, consulte o nosso manual oficial: OCR Distribuído

Atenção

O percentual de acerto da busca pelo OCR dependerá da qualidade do documento. A recomendação ideal é que seja utilizada uma resolução nos documentos de 300dpi ao qual garante um acerto de 95%, ou seja, como a qualidade do documento é boa, o Fusion reconhecerá mais as palavras e retornará na pesquisa.

Caso o documento esteja com qualidade aproximada a 200dpi, o percentual de acerto é de 82%. Quando a qualidade está em 150dpi o percentual baixará para 49% de acerto. Isso indica que quanto mais próximo de 300dpi for a qualidade do documento, maior será o percentual de acerto da pesquisa.

Com essas configurações, o Fusion estará pronto para realizar a conversão de documentos de forma eficiente.

Customizações

O Fusion Platform permite a aplicação de customizações para atender a necessidades específicas da sua empresa. No entanto, para garantir que essas personalizações funcionem corretamente, é necessário realizar algumas configurações adicionais. A seguir, detalhamos os passos essenciais para configurar corretamente os arquivos e parâmetros do sistema.

Configuração do customflags.properties

O arquivo customflags.properties é fundamental para ativar as customizações dentro do Fusion Platform. Para configurá-lo corretamente, siga os passos abaixo:

Abra o arquivo .war do Fusion e acesse o caminho WEB-INF\classes\META-INF. Localize o arquivo customflags.properties e extraia-o para a pasta WebContent criada no início desse guia.

Edite o arquivo utilizando um editor de código e insira o nome da sua empresa, conforme definido no desenvolvimento da sua customização, seguido do parâmetro true.

Após adicionar a informação, salve e feche o arquivo.

Atenção

O arquivo customflags.properties deve permanecer fora do .war, da mesma forma que o application.yml. Alterações no arquivo .war não são recomendadas, pois podem comprometer a integridade do sistema.

Configurando o Tomcatw

Além da configuração do customflags.properties, é necessário ajustar os parâmetros do servidor Tomcat para garantir o funcionamento adequado das customizações.

Durante a configuração do servidor, acesse o bloco Java Options e verifique os parâmetros adicionados. Alguns são obrigatórios, enquanto outros são opcionais.

Se a sua instalação do Fusion Platform possui customizações, é obrigatório incluir o seguinte parâmetro:

-Dfusion.custom=file:\C:\neomind\fusion\WebContent\customflags.properties

Esse parâmetro permite que o Tomcat localize e carregue corretamente as configurações personalizadas.

Seguindo os passos descritos, suas customizações no Fusion Platform estarão devidamente configuradas e prontas para uso. Certifique-se de que os arquivos estejam no local correto e que o Tomcat esteja configurado corretamente para evitar problemas na aplicação das customizações.

Finalizações

Com todas as configurações realizadas, é necessário ativar a licença do Fusion Platform para garantir seu funcionamento correto. Além disso, há serviços adicionais que podem ser instalados para ampliar as funcionalidades da plataforma. A seguir, detalhamos os passos para ativação da licença e a instalação de serviços complementares.

Ativando a Licença

Após concluir as configurações, o Fusion precisa ser ativado. A chave de ativação pode ser solicitada diretamente à nossa equipe de suporte por meio da abertura de um chamado no Portal do Cliente.

Para ativar a licença, siga o caminho: Administração > Controle de Licenças.

Em seguida, clique em "Ativar agora" para abrir a tela de ativação.

Insira o CNPJ e a chave de ativação fornecida pela equipe de suporte. Após essa etapa, o ambiente estará devidamente ativado e pronto para uso.

Instalação de Serviços Adicionais

Além da configuração principal, é possível instalar serviços adicionais que ampliam as funcionalidades do Fusion Platform. Os principais serviços opcionais são:

• OLAP: O OLAP permite a criação de análises dentro do módulo Analytics, sendo responsável pelo armazenamento e processamento dos dados dos esquemas configurados no Fusion. Para mais informações sobre a instalação do OLAP, consulte o Guia de Instalação - Servidor OLAP.
• Fusion Developer: o Fusion Developer possibilita a criação e edição de scripts, permitindo a adição de Classes Java em atividades do tipo Script no BPM Studio, além de ser possível editá-los num editor próprio. Para mais informações sobre a instalação do Fusion Developer, acesse o Guia de Instalação - Servidor Fusion Developer.

Com a ativação da licença e a instalação dos serviços adicionais, o Fusion Platform estará totalmente operacional, pronto para atender às necessidades do seu ambiente. Certifique-se de seguir corretamente as instruções de ativação e, caso precise de suporte, entre em contato com nossa equipe por meio do Portal do Cliente.