Configurar BI Gateway

Instale e configure o BI Gateway no Windows para permitir ao ETL X a extração de dados dos sistemas de origem sem a necessidade de abrir o firewall ou instalar o RabbitMQ.

Pré-requisitos

• Instalação Java Open JDK 11 x64. Se não realizado, o instalador fará o download. Caso a instalação e configuração seja feita por linha de comando, a instalação do Java deve ser feita manualmente
• Possuir 4 GB de memória livres
• Possuir 70 MB livres de HD para o BI Gateway e 300 MB para o Open JDK 11
• Permitir tráfego de saída na porta 443 para *.senior.com.br
• Definir o tamanho máximo da senha do tenant, na Política de senhas, com no mínimo o valor 20
• Habilitar a autenticação G7 na Gestão dos Tenants da senior X Platform

JDK

A execução do JDK 11 somente é possível em servidores 64 bits. Por isso, antes de iniciar a instalação do BI Gateway, verifique se o Windows está compatível.

Caso já possua uma instalação do JDK 1.8, ou superior, para atender uma outra aplicação, por exemplo o GlassFish 4, ao realizar a instalação do BI Gateway e do Java Open JDK x64, não haverá qualquer problema de incompatibilidade entre as duas instalações JDK, já que os arquivos .exe utilizados para a instalação do JDK, tanto versão 1.8 quanto a 11, funcionarão corretamente.

Instalação e configuração BI Gateway

1. O instalador do BI Gateway está disponível em dois locais para ser acessado, de acordo com seu sistema de origem:
   1. Gestão Empresarial | ERP: C:\\<Diretório de instalação>\Sapiens\DelphiX\Gateway
   2. Outros sistemas de origem: necessário download do arquivo bi-gateway-remote-installer.exe. O arquivo pode ser salvo em qualquer local do diretório
2. Abra o executável bi-gateway-remote-installer.exe;
3. Em Instalação do BI Gateway Remote, clique em Concordo e prossiga com a instalação;
4. Para a instalação do Open JDK, versão 11, marque o componente Open JDK 11 para que esta versão do Java seja instalada para utilização do BI Gateway. Caso já possua esta versão instalada, mantenha a opção assinalada e informe o local de instalação posteriormente;
5. Assinale a opção Máquina compartilhada se for necessário instalar o BI Gateway mais de uma vez. Por exemplo, quando houver mais de um ambiente de cliente na IBM, produção e homologação. Entretanto, não deve ser utilizado o mesmo diretório para dois Gateways;
6. Clique em Próximo;
7. Informe o diretório de instalação do Open JDK 11 e clique em Próximo;
8. Informe o Local em que o BI Gateway será instalado e clique em Instalar;
9. Caso a versão do Open JDK não esteja correta, uma mensagem informando a situação e que o download será feito é apresentada. Após a versão estiver correta, clique em OK;
10. Quando o processo de instalar estiver completo, clique em Próximo;
11. Informe os dados da plataforma:
    • Os campos Endereço do serviço rest e Endereço do serviço websocket já são preenchidos por padrão pelo instalador;
    • Informe o usuário e senha do administrador da plataforma. Estas informações são utilizadas para utilização do serviço do BI Gateway.
12. Clique em Próximo para finalizar a instalação.

Alguns servidores Windows com versão mais antiga ou sem atualização podem apresentar erros de download durante a instalação do BI Gateway. Se este for o caso, recomece a instalação, marcando a opção Ignorar segurança em downloads. Caso ainda apresente problemas, abra o painel de controle do Windows e em Opções da Internet, inclua *.senior.com.br em sites confiáveis e em guia Avançadas marque as caixas Usar TLS 1.1 e Usar TLS 1.2 caso estejam desmarcadas e, por fim, recomece a instalação.

Instalação e configuração por comando

Quando não for possível realizar a instalação através do instalador do BI Gateway, faça a sua instalação e configuração por linha de comando:

Instalação

1. Clique com o botão direito em Computador e em Propriedades
2. Acesse as configurações avançadas do sistema e clique em Variáveis de Ambiente...
3. Localize a variável JAVA_HOME e verifique se está apontando para o Java Open JDK 11.0.2
4. Faça o download do arquivo bi-gateway-remote-bin.zip e o descompacte em C:\<Diretório de instalação>\SeniorX\bi-gateway-remote-bin
5. Com perfil administrador, abra o DOS e navegue até C:\<Diretório de instalação>\SeniorX\bi-gateway-remote-bin\bin. Caso a variável de ambiente não esteja configurado para Open JDK 11.0.2, execute o comando set "JAVA_HOME=Caminho_Do_Java_Sem_Pasta_bin". Por exemplo, set "JAVA_HOME=C:\Program Files\java\jdk-11.0.2"
6. Ainda no DOS, execute o comando bi-gateway-configure.bat Usuario_Admin_Plataforma_Com_@Tenant Senha_Usurio_Admin_Plataforma. Por exemplo, bi-gateway-configure.bat admin@exemplo.com.br SenhaExemplo
7. Após o sucesso do comando executado anteriormente, é criado o arquivo service.bat na pasta C:\<Diretório de instalação>\SeniorX\bi-gateway-remote-bin\bin. Execute-o incluindo o parâmetro install. Por exemplo, service.bat install
8. Abra o executável bi-gateway-<Nome_Do_Tenant>w.exe e na guia General e clique em Start.

JDK

Se realizada a instalação do BI Gateway por linha de comando, será necessário alterar a variável do ambiente JAVA_HOME para conseguir concluir a instalação do Java Open JDK 11 x64. Porém, caso já esteja sendo utilizada para a JDK 1.8, é preciso:

1. Anotar o valor da variável de ambiente JAVA_HOME;
2. Alterar a variável de ambiente JAVA_HOME para o valor necessário para instalação do BI Gateway;
3. Finalizar a instalação e configuração do BI Gateway;
4. Voltar o valor da variável de ambiente JAVA_HOME para o valor anotado no início.