Instalação - dsgoficial/gerenciador_fme GitHub Wiki

Pré-requisitos para instalação

FME Workbench

É necessário ter o FME Workbench instalado na máquina que executará o serviço do Gerenciador do FME. Idealmente deve ser configurada a variável de ambiente fme para o local de instalação.

É necessária uma licença válida do FME Workbench.

Serviço de Autenticação

O Gerenciador do FME utiliza o Serviço de Autenticação para autenticar os usuários do sistema.

Instalação do NodeJS

O serviço do Gerenciador do FME foi testado no NodeJS versão 14.15. Instalar esta versão, ou versão LTS superior. É necessário o NodeJS, e o NPM, normalmente instalados juntos.

Windows

Basta realizar o download do instalador no site do NodeJs.

Linux

Nas distribuições baseadas em Ubuntu, os repositórios das versões 16.04 e 18.04 não possuem a versão adequada para o sap. Sendo assim, é necessário adicionar repositórios adicionais por meio do recurso curl:

sudo apt-get install curl

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -

Em seguida, rodar o comando:

sudo apt-get install nodejs

Nas distribuições baseadas em CentOS, o repositório para versões 7 e 8 não possuem a versão adequada. De forma similar, os comandos necessários são:

sudo yum install curl

curl -sL https://rpm.nodesource.com/setup_10.x | sudo bash -

sudo yum install nodejs

Instalação do PostgreSQL

É necessário que exista um banco de dados PostgreSQL instalado. Não necessariamente precisa ser na mesma máquina que o serviço do Gerenciador do FME, porém deve ser possível ter o acesso via rede. O serviço foi testado nas versões 9.5, 9.6, 10.6 e 11.1 .

Instalação do PM2 de forma global

Se recomenda a utilização do PM2 para executar o serviço. Basta executar o comando npm install pm2 -g.

Instalação do Serviço Gerenciador do FME

Realizar o download do repositório e extrair o conteúdo.

Navegar até a pasta que foi extraída e executar o comando npm run install-all para instalar todas as dependências. É necessário acesso à internet. Dependendo da rede pode ser necessário a configuração de proxy.

Executar o comando npm run build para criação de uma build do cliente web.

Executar o comando npm run config para configurar o serviço. Uma série de perguntas será feita e ao final o banco de dados PostgreSQL que persiste os dados do serviço e o arquivo de configuração config.env serão criados. As seguintes perguntas serão feitas:

Perguntas Descrição
1 - Qual endereço de IP do banco de dados PostgreSQL? Inserir o endereço de IP do servidor de criação de banco de dados
2 - Qual a porta do banco de dados PostgreSQL? Porta padrão 5432
3 - Qual o nome do usuário do PostgreSQL para interação com o Gerenciador do FME? Inserir o nome do usuário com permissão de superusuário
4 - Qual a senha deste usuário? Inserir a senha criada para o usuário
5 - Qual o nome do banco de dados para gerência do Gerenciador do FME? Colocar o nome do banco de dados que será criado
6 - Em qual porta será executado o serviço do Gerenciador do FME? Porta padrão 3014
7 - Deseja criar o banco de dados do Gerenciador do FME? Responder sim em caso de primeira instalação
8 - Entre com o PATH para execução do FME Workbench Caso esteja definida a variável de ambiente inserir fme
9 - Qual a URL do serviço de autenticação? Iniciar com http:// ou https://
10 - Qual o nome do usuário já existente Serviço de Autenticação que será administrador do Gerenciador do FME? Usuário existente no Serviço de Autenticação
11 - Qual a senha do usuário já existente Serviço de Autenticação que será administrador do Gerenciador do FME? Inserir a senha do usuário

Caso a configuração já tenha sido feita (arquivo config.env já existe) retornará um erro. Caso já exista o banco e o usuário selecione que deseja criar um banco também retornará um erro.

O usuário selecionado nas perguntas 10 e 11 é o administrador do Gerenciador do FME.

Iniciando o serviço

Executar o comando npm run start para iniciar o serviço utilizando o PM2. Para monitoramento do serviço a lista básica de comandos pode ser encontrada em PM2 Quick Start, porém de forma resumida os principais comandos são:

  • pm2 list: lista todos os serviços sendo executados pelo PM2
  • pm2 log auth-server: permite ver os logs gerados pelo serviço
  • pm2 stop auth-server: finaliza o serviço
  • pm2 monit: permite o monitoramento dos serviços executados pelo PM2

Após iniciar o serviço basta acessar http://[IP]:[PORTA] no navegador.