Tópico Nº: 182 : - Título: Tipos de conexão do programa GFIL com o banco de dados

Este tópico destina-se a passar orientações e informações em relação às opções de instalação e configuração da conexão do sistema para acesso ao banco de dados.
Algumas opções de conexão são relativamente simples de se configurar e praticamente não requerem manutenção e/ou conhecimento mais técnico. As conexões servidor e estação de rede local, são duas dessas conexões onde não há muito o que errar e não se corre muito risco de confundir os arquivos de dados e, acidentalmente, sobrepor um arquivo com outro.
Mas atenção: algumas conexões, como, por exemplo, servidor multi bancos e estações multi bancos, essas são opções para as quais recomendamos utilizar somente se você possuir um TI na sua equipe com profundo conhecimento em arquivos Windows e que faça um acompanhamento, bem como um fortíssimo sistema de cópias de segurança desses arquivos, no mínimo de forma diária, e de maneira muito rigorosa.
A não observância dessas orientações, poderá causar a perda definitiva de todos os dados registrados no sistema.

Importantíssimo o desenvolvedor GFIL não possui nenhuma cópia de seus dados. Se houver problemas com seus arquivos de dados e você não tiver as devidas cópias de segurança, perderá tudo.
Outra questão importante a ser observada é que o backup feito pelo GFIL, tanto o automático, como o manual, em um servidor multi bancos, só conseguirá fazer o backup de um único banco de dados. Portanto, se você for utilizar o GFIL servidor multibancos para administrar vários bancos no mesmo servidor, deverá obrigatoriamente criar um sistema de backup (cópias ou snapShots) dos seus arquivos para eventual necessidade de restauração.

Muito bem, entendido isso, vamos ao que interessa, que é o detalhamento de cada uma das opções de conexão oferecidas pelo GFIL.
Antes de prosseguir, ressaltamos que a configuração da conexão sempre estará disponível na tela de login do sistema. Na parte superior direita tem o botão "Mudar Conexão". Algumas opções de conexão podem ser configuradas já na instalação do sistema, porém outras só podem ser configuradas através desta opção da tela de acesso ao GFIL.

• 1 - Servidor: se você for utilizar o sistema em apenas uma máquina, é essa conexão que vai utilizar.
  Você também precisará ter essa instalação do tipo servidor se for usar, em outras máquinas, as conexões "2 - Estação Local" ou "3 - Estação Web", abaixo detalhadas.
  Na tela de login, aba de configuração da conexão, é necessário apenas informar o campo tipo da conexão;

• 2 - Estação Local: escolha essa opção caso você queira utilizar o sistema em rede local. Para esta conexão funcionar, é necessário que um servidor (conexão tipo "1 - Servidor") esteja instalado em outra máquina.
  Obs.: o servidor será sempre apenas uma máquina, mas as estações de rede (terminais) você pode ter quantos desejar.
  Na tela de configuração da estação local, informe:
  - Tipo da conexão
  - Host: será o IP local da máquina onde o GFIL está instalado como servidor
  - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada
  - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
  Lembre-se que precisa liberar essa porta no firewall de seu servidor;

• 3 - Estação Web: escolha essa opção caso você queira utilizar o sistema em rede via internet. Para esta conexão funcionar, é necessário que um servidor (conexão tipo "1 - Servidor") esteja instalado em outra máquina.
  Na tela de configuração da estação web, informe:
  - Tipo da conexão
  - Host: será o IP (verdadeiro) da internet do servidor onde seu GFIL está instalado como servidor. Esse IP também pode ser substituído pelo endereço amigável do host, caso você tenha um. Pode inclusive ser serviços de DNS (No-IP, DynDns, etc.).
  - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada.
  - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
  Lembre-se que precisa liberar essa porta no firewall de seu servidor;

Atenção: mais uma vez pede-se redobrada atenção nas opções abaixo. Essas opções permitem que você tenha vários bancos de dados numa mesma máquina. Porém, os arquivos de dados terão sempre o mesmo nome (INFOLIVRE.FDB). O manuseio errado desses arquivos, movê-los ou copiá-los para a pasta errada, pode causar a perda de todos os dados daquele arquivo que será sobreposto.
Outro risco é acessar, via estação multi bancos, o path (caminho) errado e fazer lançamentos no banco errado, o que é irreversível.
De novo, a recomendação é que você só utilize as opções 4 a 6 com uma supervisão técnica permanente.

Nas conexões 4, 5, 6 e 7 abaixo detalhadas, deve-se tomar muito cuidado com o campo ID do banco que é informado no momento da conexão, pois será esse banco que será acessado no servidor multi bancos.

Você precisará de um servidor multibancos caso queira utilizar as opções 4, 5, 6 ou 7 (abaixo).
Outra condição é que a opção "Permitir conexões do tipo multi bancos de dados" dos parâmetros gerais esteja habilitada.
Logicamente que para acessar os parâmetros gerais e liberar essa opção lá nesse módulo, você precisará acessar o GFIL de forma normal, ou seja, sem estar configurado multi bancos. Depois é que você criará a estrutura de pastas e subpastas para utilizar a opção multibancos.



• 4 - Multi BD - Servidor: - A instalação do servidor multibancos você fará da mesma forma que na opção 1-Servidor, ou seja, o sistema será instalado com todos os seus arquivos e gerará o banco de dados na pasta C:\SistemaGFIL\Dados\InfoLivre.fdb. Porém, após instalado, você deverá mover o arquivo InfoLivre.fdb da pasta \Dados\ para uma pasta que você deverá criar. Essa deverá ficar sob a pasta \Dados\ e deverá obrigatoriamente ter como nome o CNPJ/CPF de uma das filiais que vai estar cadastrada naquele banco de dados.
  Você poderá ter várias pastas sob a pasta \Dados\ e dentro de cada uma delas deverá sempre estar o arquivo InfoLivre.fdb correspondente ao nome (CNPJ/CPF) daquela pasta.
  
  Exempo a: supondo que o CNPJ da filial 1 de um determinado banco de dados seja 10.971.149/0001-15. Nesse caso, o arquivo de dados ficará assim: C:\SistemaGFIL\Dados\10971149000115\InfoLivre.fdb;
  
  Exemplo b: um banco de dados que tenha uma filial com o CPF 603.455.909-20, o path ficaria assim: C:\SistemaGFIL\Dados\60345590920\InfoLivre.fdb.
  
  Lembrando sempre que o GFIL tem a opção multi empresa, onde você pode ter várias filiais no mesmo banco de dados. Então, no exemplo acima você poderia ter várias empresas/filiais no mesmo banco C:\SistemaGFIL\Dados\10971149000115\InfoLivre.fdb.
  
  Importante: apesar desse tipo de conexão permitir, não é nem um pouco recomendável usar esta conexão para acesso a bancos diferentes rotineiramente. O ideal é que o servidor multibancos seja apenas instalado e não se acesse o programa por ali. Faça apenas conexões via estações web multi bancos. Esta opção de acessar o GFIL no servidor multibancos existe para permitir a manutenção dos bancos de dados por parte do responsável pelo servidor, em especial a restauração de backup, quando se fizer necessário. O acesso direto do GFIL pelo servidor multibancos por todos os operadores da empresa pode e, muito provavelmente acontecerá uma hora ou outra, de se registrar dados no banco errado ou ainda pior, mover arquivos de dados de uma pasta para outra, o que geraria perda de todos os dados do arquivo sobreposto, pois todos os arquivos têm o mesmo nome (InfoLivre.fdb).
  Este tópico destina-se a passar orientações e informações em relação às opções de instalação e configuração da conexão do sistema para acesso ao banco de dados.
  Algumas opções de conexão são relativamente simples de se configurar e praticamente não requerem manutenção e/ou conhecimento mais técnico. As conexões servidor e estação de rede local, são duas dessas conexões onde não há muito o que errar e não se corre muito risco de confundir os arquivos de dados e, acidentalmente, sobrepor um arquivo com outro.
  Mas atenção: algumas conexões, como, por exemplo, servidor multi bancos e estações multi bancos, essas são opções para as quais recomendamos utilizar somente se você possuir um TI na sua equipe com profundo conhecimento em arquivos Windows e que faça um acompanhamento, bem como um fortíssimo sistema de cópias de segurança desses arquivos, no mínimo de forma diária, e de maneira muito rigorosa.
  A não observância dessas orientações, poderá causar a perda definitiva de todos os dados registrados no sistema.
  
  Importantíssimo o desenvolvedor GFIL não possui nenhuma cópia de seus dados. Se houver problemas com seus arquivos de dados e você não tiver as devidas cópias de segurança, perderá tudo.
  Outra questão importante a ser observada é que o backup feito pelo GFIL, tanto o automático, como o manual, em um servidor multi bancos, só conseguirá fazer o backup de um único banco de dados. Portanto, se você for utilizar o GFIL servidor multibancos para administrar vários bancos no mesmo servidor, deverá obrigatoriamente criar um sistema de backup (cópias ou snapShots) dos seus arquivos para eventual necessidade de restauração.
  
  Muito bem, entendido isso, vamos ao que interessa, que é o detalhamento de cada uma das opções de conexão oferecidas pelo GFIL.
  Antes de prosseguir, ressaltamos que a configuração da conexão sempre estará disponível na tela de login do sistema. Na parte superior direita tem o botão "Mudar Conexão". Algumas opções de conexão podem ser configuradas já na instalação do sistema, porém outras só podem ser configuradas através desta opção da tela de acesso ao GFIL.
  

  • 1 - Servidor: se você for utilizar o sistema em apenas uma máquina, é essa conexão que vai utilizar.
    Você também precisará ter essa instalação do tipo servidor se for usar, em outras máquinas, as conexões "2 - Estação Local" ou "3 - Estação Web", abaixo detalhadas.
    Na tela de login, aba de configuração da conexão, é necessário apenas informar o campo tipo da conexão;

  • 2 - Estação Local: escolha essa opção caso você queira utilizar o sistema em rede local. Para esta conexão funcionar, é necessário que um servidor (conexão tipo "1 - Servidor") esteja instalado em outra máquina.
    Obs.: o servidor será sempre apenas uma máquina, mas as estações de rede (terminais) você pode ter quantos desejar.
    Na tela de configuração da estação local, informe:
    - Tipo da conexão
    - Host: será o IP local da máquina onde o GFIL está instalado como servidor
    - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada
    - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
    Lembre-se que precisa liberar essa porta no firewall de seu servidor;

  • 3 - Estação Web: escolha essa opção caso você queira utilizar o sistema em rede via internet. Para esta conexão funcionar, é necessário que um servidor (conexão tipo "1 - Servidor") esteja instalado em outra máquina.
    Na tela de configuração da estação web, informe:
    - Tipo da conexão
    - Host: será o IP (verdadeiro) da internet do servidor onde seu GFIL está instalado como servidor. Esse IP também pode ser substituído pelo endereço amigável do host, caso você tenha um. Pode inclusive ser serviços de DNS (No-IP, DynDns, etc.).
    - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada.
    - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
    Lembre-se que precisa liberar essa porta no firewall de seu servidor;

  Atenção: mais uma vez pede-se redobrada atenção nas opções abaixo. Essas opções permitem que você tenha vários bancos de dados numa mesma máquina. Porém, os arquivos de dados terão sempre o mesmo nome (INFOLIVRE.FDB). O manuseio errado desses arquivos, movê-los ou copiá-los para a pasta errada, pode causar a perda de todos os dados daquele arquivo que será sobreposto.
  Outro risco é acessar, via estação multi bancos, o path (caminho) errado e fazer lançamentos no banco errado, o que é irreversível.
  De novo, a recomendação é que você só utilize as opções 4 a 6 com uma supervisão técnica permanente.
  
  Nas conexões 4, 5, 6 e 7 abaixo detalhadas, deve-se tomar muito cuidado com o campo ID do banco que é informado no momento da conexão, pois será esse banco que será acessado no servidor multi bancos.
  
  Você precisará de um servidor multibancos caso queira utilizar as opções 4, 5, 6 ou 7 (abaixo).
  Outra condição é que a opção "Permitir conexões do tipo multi bancos de dados" dos parâmetros gerais esteja habilitada.
  Logicamente que para acessar os parâmetros gerais e liberar essa opção lá nesse módulo, você precisará acessar o GFIL de forma normal, ou seja, sem estar configurado multi bancos. Depois é que você criará a estrutura de pastas e subpastas para utilizar a opção multibancos.
  
  

  • 4 - Multi BD - Servidor: - A instalação do servidor multibancos você fará da mesma forma que na opção 1-Servidor, ou seja, o sistema será instalado com todos os seus arquivos e gerará o banco de dados na pasta C:\SistemaGFIL\Dados\InfoLivre.fdb. Porém, após instalado, você deverá mover o arquivo InfoLivre.fdb da pasta \Dados\ para uma pasta que você deverá criar. Essa deverá ficar sob a pasta \Dados\ e deverá obrigatoriamente ter como nome o CNPJ/CPF de uma das filiais que vai estar cadastrada naquele banco de dados.
    Você poderá ter várias pastas sob a pasta \Dados\ e dentro de cada uma delas deverá sempre estar o arquivo InfoLivre.fdb correspondente ao nome (CNPJ/CPF) daquela pasta.
    
    Exempo a: supondo que o CNPJ da filial 1 de um determinado banco de dados seja 10.971.149/0001-15. Nesse caso, o arquivo de dados ficará assim: C:\SistemaGFIL\Dados\10971149000115\InfoLivre.fdb;
    
    Exemplo b: um banco de dados que tenha uma filial com o CPF 603.455.909-20, o path ficaria assim: C:\SistemaGFIL\Dados\60345590920\InfoLivre.fdb.
    
    Lembrando sempre que o GFIL tem a opção multi empresa, onde você pode ter várias filiais no mesmo banco de dados. Então, no exemplo acima você poderia ter várias empresas/filiais no mesmo banco C:\SistemaGFIL\Dados\10971149000115\InfoLivre.fdb.
    
    Importante: apesar desse tipo de conexão permitir, não é nem um pouco recomendável usar esta conexão para acesso a bancos diferentes rotineiramente. O ideal é que o servidor multibancos seja apenas instalado e não se acesse o programa por ali. Faça apenas conexões via estações web multi bancos. Esta opção de acessar o GFIL no servidor multibancos existe para permitir a manutenção dos bancos de dados por parte do responsável pelo servidor, em especial a restauração de backup, quando se fizer necessário. O acesso direto do GFIL pelo servidor multibancos por todos os operadores da empresa pode e, muito provavelmente acontecerá uma hora ou outra, de se registrar dados no banco errado ou ainda pior, mover arquivos de dados de uma pasta para outra, o que geraria perda de todos os dados do arquivo sobreposto, pois todos os arquivos têm o mesmo nome (InfoLivre.fdb).
    

  • 5 - Multi BD - Estação Web: escolha essa opção caso você queira utilizar o sistema em rede via internet, mas acessando um caminho especial lá no banco de dados e um banco de dados diferente a cada conexão.
    Observação a ideia é que você acesse sempre o mesmo caminho (ID do Banco), ou seja, o mesmo banco de dados e, caso tenha vários bancos no servidor, acesse cada banco em máquina estação web diferente. Porém, nada impede que você mude essa conexão na mesma máquina a cada acesso. Só precisará reconfigurar a conexão e mudar o campo "ID do Banco"
    Para esta conexão funcionar, é necessário que um servidor (conexão tipo "4 - Multi BD - Servidor") esteja instalado em outra máquina.
    Outra condição é que a opção "Permitir conexões do tipo multi bancos de dados" dos parâmetros gerais esteja habilitada.
    Na tela de configuração da estação web multi BD, informe:
    - Tipo da conexão
    - Host: será o IP (verdadeiro) da internet do servidor onde seu GFIL está instalado como servidor. Esse IP também pode ser substituído pelo endereço amigável do host, caso você tenha um. Pode inclusive ser serviços de DNS (No-IP, DynDns, etc.)
    - ID do Banco de Dados é a pasta de cada banco de dados configurada lá no servidor multi bancos. Nos exemplos acima citados, teríamos as opções 10971149000115 e 60345590920 para informar nesse campo.
    - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada
    - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
    Lembre-se que precisa liberar essa porta no firewall de seu servidor;

  • 6 - Multi BD - Estação Server Linux: antes de mais nada, é preciso deixar bastante claro que o GFIL não foi desenvolvido para uso em Linux. As orientações deste item são tão somente para pessoal técnico especializado em Linux possa configurar um servidor Linux em nuvem. O atendimento GFIL sequer poderá lhe dar qualquer tipo de orientação adicional sobre essa questão, pois não temos pessoal com conhecimento técnico nessa área. A única ajuda que o atendimento GFIL poderá lhe dar, além das orientações aqui contidas, é a indicação de uma revenda GFIL que tenha conhecimento para lhe ajudar nessa configuração.
    O processo no terminal funciona de forma muito parecida com a estação Web acima detalhada. Já no servidor, não será feita a instalalção. Os arquivos do servidor deverão ser copiados/criados manualmente, pois o instalador do GFIL não funciona em Linux.
    Observações
    1) Nessa conexão não será possível utilizar o gerenciador de backup e nem o GFILServer no servidor, já que essas aplicações só rodam em Windows;
    2) O Firebird também deve ser instalado manualmente. Você pode baixar o instalador neste endereço: https://firebirdsql.org/. Atente para baixar a versão compatível com o GFIL. Atenção: instalação da versão Firebird errada, pode até fazer com que a conexão funcione, mas isso, em algum momento, poderá causar corrupção da base de dados.
    Para configurar os arquivos crie uma pasta (ex.: /root/SistemaGFIL/) no servidor. Dentro dela crie a pasta /Dados/. Depois crie as pastas de cada banco de dados e dentro de cada pasta coloque o arquivo de dados INFOLIVRE.FDB, da mesma forma que seria para uma estação web multi bancos, ou seja, seguindo os mesmos exemplos acima, você teria os seguintes paths: /root/SistemaGFIL/Dados/10971149000115/INFOLIVRE.FDB e /root/SistemaGFIL/Dados/60345590920/INFOLIVRE.FDB.
    Obs.: lembre que Linux é case sensitive. Então minúsuculo/maiúsculo no nome das pastas/arquivos faz toda diferença.
    Os dados de configuração você informa ao acessar a estação, da mesma forma que está orientado acima para a estação web multi bancos.
    Outra coisa que você precisará fazer é criar o usuário GFILMaster no banco de dados do Firebird no servidor. Siga estes passos:
    1) Se você não tem uma máquina Windows com o Firebird normal instalado, faça o download do instalador Firebird do GFIL. O link você encontra no tópico 49 deste manual de ajuda;
    2) Nessa mesma máquina, ou pode ser outra, mas que seja SO Windows, crie uma pasta qualquer (C:\Apagavel\, por exemplo);
    3) Dentro de C:\Apagavel\ copie os arquivos gsec.exe e fbclient.dll. Esses arquivos você encontrará na pasta do Firebird (item 1 acima);
    4) Ainda na pasta C:\Apagavel\, baixe este arquivo -> https://www.sistemagfil.com.br/Downloads/Outros/CriaGFILMasterRemotamente.exe;
    5) Agora acesse essa pasta execute o CriaGFILMasterRemotamente.exe. Na tela que abrir, informe o caminho onde está o arquvio de usuários Firebird -> security2.fdb. Obs.: esse arquivo está na pasta onde o Firebird foi instalado lá no servidor. Informe também o host e a porta. Depois clique em "Criar Usuário".
    A pasta C:\Apagavel\ pode ser eliminada e o Firebird instalado na máquina Windows pode ser desinstalado.
    Repetindo: o desenvolvedor GFIL não tem como auxiliar nesse processo. Caso tenha qualquer dificudade, procure uma revenda credenciada, listada no site GFIL.

  • 7 - Multi BD - Estação Local: escolha essa opção caso você queira utilizar o sistema em rede rede, mas acessando um caminho especial lá no banco de dados e um banco de dados diferente a cada conexão.
    Observação a ideia é que você acesse sempre o mesmo caminho (ID do Banco), ou seja, o mesmo banco de dados e, caso tenha vários bancos no servidor, acesse cada banco em máquina estação diferente. Porém, nada impede que você mude essa conexão na mesma máquina a cada acesso. Só precisará reconfigurar a conexão e mudar o campo "ID do Banco"
    Para esta conexão funcionar, é necessário que um servidor (conexão tipo "4 - Multi BD - Servidor") esteja instalado em outra máquina.
    Outra condição é que a opção "Permitir conexões do tipo multi bancos de dados" dos parâmetros gerais esteja habilitada.
    Na tela de configuração da estação web multi BD, informe:
    - Tipo da conexão
    - Host: será o IP do servidor na rede local onde seu GFIL está instalado como servidor.
    - ID do Banco de Dados é a pasta de cada banco de dados configurada lá no servidor multi bancos. Nos exemplos acima citados, teríamos as opções 10971149000115 e 60345590920 para informar nesse campo.
    - Caminho da instalação no servidor: se lá no servidor você não alterou a pasta de instalação padrão, então essa informação será C:\SistemaGFIL\. Caso tenha mudado, informe a pasta alterada
    - Porta: é a porta que o Firebird vai se comunicar com o servidor. Se não houver impedimento no seu servidor, utilize sempre a porta padrão, ou seja, 3050. Mas caso seja necessário, você poderá informar outra porta nesse campo.
    Lembre-se que precisa liberar essa porta no firewall de seu servidor.
    
    Observação: nas conexões tipo multi bancos, abaixo da pasta \Dados só pode haver pastas cujo nome seja de um CPF ou CNPJ válido e, dentro destas pastas, só pode haver um único arquivo, o Infolivre.fdb.
    
    Alterando a porta padrão do Firebird 3050 para uma de minha escolha: esse procedimento é importante caso você queira criar um pouco mais de segurança para seus dados, pois a porta padrão é mundialmente conhecida. É claro que apenas a mudança da porta não vai lhe trazer garantia de segurança, mas é um reforço a mais. Converse com seu TI sobre isso (segurança de conexões via TCP/IP).
    O procedimento é bastante simples. No arquivo Firebird.conf tem a seguinte linha:
    #RemoteServicePort = 3050;
    Mude ela para:
    RemoteServicePort = XXXX
    Onde XXXX é a sua porta customizada.
    Depois de alterado, precisa reiniciar o serviço do Firebird para que a mudança surta efeito.
    Obs.: o Firebird.conf é um arquivo texto que pode ser editado e ele está dentro da pasta onde seu Firebird está instalado. Mas tenha muuuuuuuito cuidado para não alterar outros dados, pois esse arquivo contém informações cruciais para o correto e pleno funcionamento do Firebird e, portanto, funcionamento do GFIL.

  Ajude-nos a melhorar esta ajuda. Envie crí­ticas e sugestões para sugestoes@sistemagfil.com.br.