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 PM2pm2 log auth-server
: permite ver os logs gerados pelo serviçopm2 stop auth-server
: finaliza o serviçopm2 monit
: permite o monitoramento dos serviços executados pelo PM2
Após iniciar o serviço basta acessar http://[IP]:[PORTA]
no navegador.