Manual para Configuração de Ambiente de Desenvolvimento

REQUISITOS PARA INSTALAR AMBIENTE FUSION VERSÃO 3.7 E SUPERIORES

 Importante: Faça o download dos programas e instale conforme a arquitetura do seu SO, 64 ou 32 bits. Para verificar a arquitetura, procure por “Sistema” na pesquisa do Windows, como indicado abaixo:

  • Eclipse IDE Enterprise Edition 2019-03 ou superiores. A partir dessa versão é suportado o JDK 11,12 e releases mais recentes. Recomendamos sempre utilizar o mais atual, disponível no site: https://www.eclipse.org/downloads/.

Atenção: Vale ressaltar que o Eclipse Luna, Neon e Oxygen, já não suportam o JDK 11 e superiores utilizados para as versões 3.7 e mais atuais do Fusion Platform. Quando fizer o Setup do servidor, atente-se à qual versão do Java seu ambiente está apontando.

 

INSTALAÇÃO E CONFIGURAÇÕES DO JAVA 

  • Passo 3: Agora vamos editar a variável “Path”. Tome MUITO cuidado nesse passo, pois se essa variável for apagada várias funcionalidades do Prompt de Comandos do Windows ficarão comprometidas. Clique em “Path” e no botão Editar:

  • Passo 4: Clique em “Novo”, e aponte os caminhos das pastas onde ficam localizados o Java. Após isso, salve e feche essa aba. Seu Java agora está configurado.

  • Passo 5: Caso tenha alguma referência a Maven da máquina, remova da Path. (Caso possua algum caminho com algum nome “maven”).
  • Passo 6: Ainda na variável de sistema Path, insira no fim, o comando: ;%MAVEN_HOME%\bin; .

Após feito isso, faça o download do projeto, para uma instalação do zero. (Ou utilize sua própria pasta do projeto). Projeto padrão: https://drive.google.com/file/d/136aotwbYZUKAGfFh6PHhZfbMZhaDuM6_/view?usp=sharing

INSTALAÇÃO DO ECLIPSE IDE 

  • Passo 1: Faça o download do Eclipse IDE versão EE(Enterprise Edition), 2019-03, ou mais recente no link https://www.eclipse.org/downloads/. Atente-se para a arquitetura do seu Sistema Operacional, 64 ou 32 bits.
  • Passo 2: Instale o Eclipse IDE EE 2019-03 em sua máquina no local de sua preferência. Aconselhamos instalá-lo no diretório C:\ para fácil acesso.

Atenção: Vale ressaltar que o Eclipse Luna, Neon e Oxygen, já não suportam o JDK 11 e superiores utilizados para as versões 3.7 e mais atuais do Fusion Platform. Quando fizer o Setup do servidor, atente-se à qual versão do Java seu ambiente está apontando.

  • Passo 3: Quando executar o Eclipse pela primeira vez, ele irá pedir um workspace padrão, defina-o:

 

PROXY

Caso você tenha um proxy configurado na sua rede, adicione o seguinte endereço para que não seja barrado: *.neomind.com.br

 

CONFIGURANDO E CRIANDO O PROJETO DO FUSION NO ECLIPSE

  • Passo 1: Como iremos utilizar versões 3.7 acima, o .exe do Eclipse estará dentro da pasta do eclipse. Crie uma pasta chamada workspace na pasta de instalação do Eclipse, para ser utilizado como workspace padrão, onde será montado seu projeto (Caso esteja utilizando um projeto do Fusion, coloque-o dentro dessa pasta):

  • Passo 2: No Eclipse, abra a aba Window > Preferences:

  • Passo 3: Na sessão Maven>User Settings, clique em Update Settings. Caso não saiba a localização do settings.xml do maven, utilize o botão “Restore to Default”:

Dica: Esta aba fica organizada por ordem alfabética, facilitando a procura.

  • Passo 4: Para criar seu projeto, vá até o canto superior esquerdo, em Files>New>Maven Project:

Atenção: A ordenação da aba New, pode não estar igual a imagem anterior.

  • Passo 5: Após clicar em Maven Project, irá surgir a seguinte janela:

  • Passo 6: Em “Group ID” coloque “Fusion” e em “Artifact ID” coloque o nome da empresa (ou alguma informação da sua preferência), nesse caso utilizaremos Corporation, como visto na imagem anterior.
  • Passo 7: Após isso, seu “workspace” será montado, e posteriormente deve estar conforme a imagem seguinte:

  • Passo 8: Clique com o botão direito em “Corporation”, após isso em Maven, e Update Project, conforme as imagens abaixo:

 

  • Passo 9: Aguarde enquanto até que esse processo seja concluído, pode levar muito tempo, enquanto o update é feito, não mexa no projeto.
  • Passo 10: Quando o  Update for concluído, abra o arquivo pom.xml. Caso seja um projeto já pronto, altere para qual versão será utilizado conforme visto abaixo. Se for um ambiente zerado, apague o conteúdo do pom.xml e substitua pelo conteúdo do link: https://drive.google.com/open?id=1A29FNBngkZ3oWvcXmdxMxHmLoiozf8t9. Aponte sua versão e o nome do projeto. Feito isso, salve o mesmo:

  • Passo 11: Após salvar, clique com o botão direito no pom.xml, clique em “Debug as” e clique na segunda opção “Maven Build”

Atenção: É possível que apareça outro número na frente, como 6 ou 4, porém é normal.

  • Passo 12: Após clicar no segundo Maven Build, no campo “Goals” coloque o código: clean install –e, de um check em “skip tests”, após isso, clique em debug.

  • Passo 13: Após clicar em debug, o projeto irá compilar. Essa etapa costuma demorar. Quando o processo estiver concluído, a mensagem “BUILD SUCCESS” irá aparecer no console:

  • Passo 14: Após o Build Success, precisaremos configurar o neo-persist.xml com as informações do seu banco de dados que será usado no Fusion. O diretório dessa pasta fica na pasta:

C:\workspace\Nome_Que_Voce_Colocou_Pro_Projeto\target\warDeploy\WEB-INF\classes\META-INF\neo-persist.xml.

Exemplo de configuração:

Atenção: Os dados a serem inseridos são o nome do usuário, senha do banco, IP e porta local, nome do banco e nome da aplicação utilizada.

Configure também o diretório de cache no neo-persist.xml. Exemplo a seguir:

<!– Cache Schema Path –>

<property name=”hibernate.cache.folder_path” value=”C:/nome da pasta ” />

 

CRIAÇÃO DO SERVER VIA TOMCAT

  • Passo 1: Após ter configurado o neo-persist.xml, no canto superior esquerdo do Eclipse clique em File>New>Other e então Server:

  • Passo 2: Após clicar em “Next”, coloque no Server Runtime Environment o Apache Tomcat v9.0. Clique em Next. Clique em Adicione o projeto, e clique em Finish: 

  • Passo 3: Seu server foi criado, agora é preciso realizar as configurações:

  • Passo 4: Abra o server clicando duas vezes sobre ele, coloque o Timeouts > Start (in seconds) para um alto valor em segundos e salve:

  • Passo 5: Clique em “Open launch configuration > Arguments > VM Arguments” e ao final do VM arguments adicionar os parâmetros abaixo:

-Djava.security.auth.login.config=”C:\ambiente_neomind\workspace\Nome_do_Projeto\target

\war\work\com.neomind.fusion\fusion\WEB-INF\classes\jaas.config”

-Xms256M

-Xmx2048M

-Dlog4j.configuration=log4j.properties

Atenção: Xms e Xmx referem-se às memórias mínimas e máxima do servidor, respectivamente. Coloque o tanto ser necessário. Djava.security.auth.login.config = parâmetros de login no Fusion Dlog4j.configuration=log4j.properties = parâmetros de logs avançados no Tomcat.

  • Passo 6: Salve as alterações, clique no Servidor com o botão direito e clique em Publish, isso irá colocar seus parâmetros no Tomcat:

 

  • Passo 7: Após o Publish ser concluído, irá aparecer do lado do server “Stopped, Synchronyzed”. O próximo passo será subir o servidor via debug:

Atenção: Enquanto o Fusion está subindo, irá aparecer ao lado “Starting”.

O  console pode ser acessado para acompanhar o status do servidor enquanto o Fusion sobe, mostrando passos que estão sendo seguidos e erros quando acontecem.

Ao final da inicialização do ambiente, irá aparecer “Debugging”.

Seu Fusion está pronto para ser acessado! Ele será utilizado pela URL que foi configurada automaticamente pelo Tomcat.

Por exemplo: http://localhost:8080/fusion/

Dica: Aconselhamos utilizar o IP do seu servidor quando for conectar-se pela primeira vez, para obter uma conexão bem sucedida e conseguir ativar seu ambiente.