Ver código fonte para Manual Instalacao ERP/Instalacao Banco Dados

[[Manual_Instalacao_ERP]]

A instalação do Banco de dados é a primeira a ser realizada. Para facilitar, a Touch Comp disponibiliza um instalador que realiza as principais ações necessárias para o funcionamento do Banco de Dados. '''Se você desejar utilizar o instalador do Firebird diretamente, leia todo este documento antes.'''

O Banco principal utilizado pela Touch Comp é o Firebird, versão 3.0. O instalador automaticamente instala os bancos de dados limpos e com as configurações padrões. Verifique cada seção para entender as configurações, como e quando alterá-las.

Observe que alguns clientes utilizam uma versão pro e paga do Firebird, chamada HQBird. Esta versão possui diversas melhorias e ainda rotinas para otimizar o banco de dados, backups e monitoramento de falhas. 
==Windows==
===Caminho Padrão===
O Instalador irá instalar o banco de dados em C:\TouchComp\database. Você pode alterar este caminho durante a instalação para outro local. Altere em último caso, apenas caso o servidor não disponha de espaço no disco padrão, C:.

Se você alterar o caminho do banco de dados após a instalação, deverá também alterar o caminho no Firebird. Verifique a seção Mapeamento de Banco de Dados.

O Firebird é instalado por padrão em C:\Program Files\Firebird. Se você utilizar o HQBird, ele é instalado em C:\HQBird\Firebird30.

===Mapeamento do Banco de Dados===
Os bancos de dados são mapeados no arquivo databases.conf. Este arquivo de configurações define um alias e o caminho do banco de dados. Antes do alias, [touchcomp] deve estar declarado no arquivo. O Alias é padrão e não pode ser alterado. Verifique a grafia do mesmo e se todos os bancos de dados estão mapeados. O alias são as palavras antes do igual:

alias = Caminho do Banco de Dados

*'''[touchcomp]'''
*mentor=C:\touchcomp\database\MENTOR.fdb
*nfe=C:\touchcomp\database\NFE.fdb
*log=C:\touchcomp\database\LOG.FDB
*versao=C:\touchcomp\database\VERSAO.fdb
*endereco=C:\touchcomp\database\ENDERECOS.fdb
*binarydata=C:\touchcomp\database\BINARY_DATA.fdb

'''Lembre-se, se alterar de lugar o banco de dados, deve-se alterar o databases.conf.'''

'''Se você instalar o Firebird diretamente do site, sem utilizar o instalador da Touch Comp, você deverá mapear manualmente o alias e caminho de cada banco de dados.'''

===Porta do Banco de Dados===
A porta de acesso do banco de dados e até outras propriedades de conexão, são realizadas no arquivo firebird.conf. O Firebird por padrão é configurado na porta 3050. A Touch Comp altera esta porta para 3051 ou 3052 de acordo com o cliente. Para saber em qual porta está o firebird, basta verificar este arquivo.

Verifique ou altere a seguinte propriedade:

RemoteServicePort = 3052

O Instalador irá configurar para ouvir na porta 3051. 

'''Se você instalar o Firebird diretamente do site, sem utilizar o instalador da Touch Comp, você deverá mapear manualmente esta porta.'''

'''Reinicie o Firebird se alterar este arquivo.'''

==Compatibilidade Firebird==

Para que o ERP consiga conectar no banco de dados, será necessário adicionar algumas propriedades no arquivo firebird.conf. Caso utilize o instalador estas propriedades são adicionadas automaticamente.


WireCrypt = Disabled

AuthServer = Legacy_Auth, Srp, Win_Sspi

AuthClient = Legacy_Auth, Srp, Win_Sspi

Ainda, ao utilizar o instalador do Firebird, durante a instalação, você deve marcar a opção de retrocompatibilidade e para copiar a dll gds32.dll. Caso contrário, algumas versões do IBExpert não irão funcionar.

==Linux==
A instalação do banco de dados no Linux, também não é tão dificil, apesar do usuário necessitar de um pouco de conhecimento no Linux. Para tal, o principal é seguir a sequencia abaixo.

=== Crie uma pasta e coloque os bancos de dados===
Crie por exemplo, uma pasta em /opt/touchcomp/database. Copie os bancos de dados e coloque-os nesta pasta. Solicite a Touch Comp os bancos limpos para instalação conforme a versão atual.

=== Instale o firebird ===
A instalação do Firebird pode ser realizada pelo próprio gerenciador de pacotes ou ainda baixando os arquivos de instalação do Firebird diretamente do site e realizando a instalação. '

'''Mas atenção!!!!!''', sobre a instalação do Firebird 3 pelo gerenciador de pacotes possui incompatibilidades com o Touch Comp ERP, que impede seu uso. Isso porque essa versão é mais antiga e o Touch Comp ERP utiliza componentes do Firebird mais recentes, compatíveis com as versões 4 e 5 do Firebird. Portanto, se você utiliza versões mais recentes do Ubuntu e outros, obrigatoriamente, será necessário migrar seus bancos de dados para o Firebird 5 e assim usar o Firebird 5. Se você tentar baixar diretamente do site e instalar o Firebird 3, versão mais recente, com as versões mais recentes do Ubuntu (23 LTS e superiores) encontrará problemas de bibliotecas que não estão mais disponíveis no ubuntu, e será necessário diversos 'workarounds' para poder instalar o Firebird. Como o Firebird 3 não receberá mais suporte, o recomendado será ir diretamente para o Firebird 5.

====Instalação do Firebird pelo Gerenciador de Pacotes ====

'''Lembre-se, o Firebird 3 somente funciona sem 'workarounds' em versões mais antigas do Ubuntu. Não migre/atualize seu servidor para versões superiores a 22 LTS. Se necessário realizar o upgrade de sua distribuição, considere também migrar os bancos de dados para o Firebird 5.'''

Para o Firebird 3, Abra o terminal e execute o seguinte comando (Exemplo, firebird versão 3.0):

 sudo apt-get install firebird3.0

Ao instalar, o firebird deve solicitar a senha para utilização. Se informado uma senha diferente da 'masterkey', você [[#seguranca | deverá também informar esta senha nos arquivos de configuração do sistema]], para que o sistema consiga conectar ao banco de dados.

Para o Firebird 4 e 5, na data desta wiki, não havia no gerenciador de pacotes.

====Instalação do Firebird por Download====
Para a instalação por download, se você possui conhecimento em Linux, será simples. Existem diversos manuais na internet. Criamos scripts que facilitam a instalação, disponíveis em:
 http://touchcomp.ddns.me:81/arquivos/firebird/

Você pode abri-los e verificar os comandos que são executados, informações sobre o script também estão disponíveis no arquivo README.md, o script requer permissão de root e pode ser executado com o seguinte comando no terminal: 
 sudo bash script_install_firebird_3_linux.sh
 sudo bash script_install_firebird_5_linux.sh

=== Configure o Firebird ===

Geralmente o Firebird, define estes arquivos na pasta /opt/firebird

Altere o Databases.conf, informando o caminho do banco e dados, e a porta e demais configurações do firebird no Firebird.conf.

 [touchcomp]
 mentor=/home/mainserver/databases/MENTOR.FDB
 versao=/home/mainserver/databases/VERSAO.FDB
 log=/home/mainserver/databases/LOG.FDB
 nfe=/home/mainserver/databases/NFE.FDB
 endereco=/home/mainserver/databases/ENDERECO.FDB
 binarydata=/home/mainserver/databases/BINARY_DATA.FDB

Para alterar a porta:

 RemoteServicePort = 3051

Outras configurações de compatibilidade:

 ServerMode = Super
 WireCrypt = Disabled
 AuthServer = Legacy_Auth, Srp, Win_Sspi
 AuthClient = Legacy_Auth, Srp, Win_Sspi

=== Reiniciar o serviço Firebird ===

 sudo service firebird restart

== Instalação Multiplos Firebird ==
A Instalação de mais de um serviço do Firebird, não é complexa, principalmente no caso do Windows. Este é um resumo do conteúdo em video disponibilizado em https://www.youtube.com/watch?v=rYD0hEQOfz0

=== Firebird===
Baixe os dois Instaladores na página do Firebird. Neste exemplo iremos simular com o Firebird 3 e 4:

* Instale normalmente o primeiro Firebird, como por exemplo o Firebird 3.
* Após a Instalação, pare o serviço do Firebird, no painel de serviços do Windows.
* Instale normalmente o segundo Firebird, neste exemplo, o Firebird 4.

=== Firebird.conf ===
Altere as configurações de pelo menos um Firebird. Neste caso, vamos alterar o Firebird 3. Quando instalamos o Firebird 4, o mesmo substituiu o serviço de inicialização do Firebird 3. Portanto, o Firebird 4 está instalado, configurado e com o serviço ativo, com as configurações padrões. Neste caso, vale lembrar que a porta padrão do Firebird é a 3050. É nesta porta que o Firebird 4 está operacional. Para que ambos os Firebirds funcionem, será necessário alterar as configurações do Firebird 3, para outra porta e outro serviço.

Portanto, altere o firebird.conf, do Firebird 3:

 [touchcomp]
 RemoteServiceName = firebird30
 RemoteServicePort = 3052
 WireCrypt = Disabled
 AuthServer = Legacy_Auth, Srp, Win_Sspi
 AuthClient = Legacy_Auth, Srp, Win_Sspi

Observe principalmente as configurações RemoteServiceName e RemoteServicePort.


===Acesso aos bancos de dados - FIREBIRD ===
É possível adicionar ao Firebird algumas configurações de segurança. Elas somente podem ser habilitadas caso seu ambiente possibilite.
====DatabaseAccess====
Agora, vamos instalar o serviço do Firebird 3
* Abra o PowerShell ou o Prompt do Windows, em modo administrador
* Navegue até a pasta de instalação do Firebird, com o seguinte comando:
 cd 'C:\Program Files\Firebird\Firebird_3_0\'
* Registre o Firebird 3:
 .\instreg.exe install
* Registre o serviço do Firebird:
 .\instsvc.exe install -auto -name firebird3
* Inicie o Serviço do Firebird
 .\instsvc.exe start -name firebird3

Pronto! Ambos os Firebird estão instalados como serviço.

===Acesso aos bancos de dados - FIREBIRD ===
É possível adicionar ao Firebird algumas configurações de segurança. Elas somente podem ser habilitadas caso seu ambiente possibilite. Estas propriedades ficam no arquivo firebird.conf. Nele, além destas existem outras propriedades que podem ser interessantes serem habilitadas ou não. Maiores esclarecimentos também são prestados neste próprio arquivo.
====DatabaseAccess====
Esta propriedade direciona quais locais do servidor o Firebird pode acessar e disponibilizar os bancos de dados. Os valores possíveis são:
 DatabaseAccess = None
 DatabaseAccess = Restrict C:\DataBase
 DatabaseAccess = Restrict C:\DataBase;D:\Mirror
 DatabaseAccess = Restrict /db
 DatabaseAccess = Restrict /db;/mnt/mirrordb
 DatabaseAccess = Full

====RemoteAccess====
Esta propriedade permite ao Firebird atender ou não requisições externas ao servidor. Para o uso do sistema em outros computadores, fora do servidor, ela deve ser habilitada.
 RemoteAccess = true

====RemoteBindAddress====
Esta propriedade diz ao Firebird de onde ele poderá ouvir e tratar requisições. Por padrão é de qualquer IP (Se propriedade estiver comentada).
 RemoteBindAddress = 192.168.0.198
=== Criação de usuarios (Firebird 3 e superiores) ===
Veja o link [[Criacao_Usuarios_Firebird]].

== Melhores Configurações do Firebird ==
Se você possui um alto uso do banco de dados, muitos usuários e muitas conexões, pode ser interessante alterar as configurações do Firebird, pelo arquivo firebird.conf.

O site https://cc.ib-aid.com/democalc.html oferece uma maneira de configurar o Firebird conforme o ambiente em que o mesmo está instalado.

== <span id="seguranca">Segurança de Acesso - Usuários e senha Banco de dados</span> ==
Caso não configurado, no momento da instalação o usuário e senha de acesso utilizados pelo sistema, serão os padrões do Firebird.

Você poderá configurar qualquer usuário e senha, para acesso pela aplicação ao banco de dados. Vale observar, que o sistema utiliza um único usuário em multiplas conexões. O gerenciamento dos usuários do sistema e logs, são realizados pela aplicação e não pelo banco de dados. Isso simplifica e muito a configuração e utilização do sistema.

Para configurar as aplicações, é necessário configurar nos arquivos de propriedades conforme cada software. Nos Touch Comp ERP Desktop, Touch Comp Log Viewer, a configuração é realizada no arquivo local.xml, dentro do diretório da aplicação. Para o Atualizador, a configuração é realizada ao configurá-lo. Por fim, no Touch Comp API, a configuração é realizada no arquivo database_touchcomp_erp.properties.

Apesar de arquivos diferentes, a configuração é a mesma. Informe:
* database.user
* database.pass
* database.seed

As configurações nos arquivos xml:
 <database.user>usuario</database.user>
 <database.pass>senha_criptograda</database.pass>
 <database.seed>seed</database.seed>
 
Em arquivos de propriedades:
 database.user =usuario
 database.pass =senha_criptografada 
 database.seed =seed
 
A senha é informada sempre criptografada. Você deve registrar a senha que deseja utilizar junto a Touch Comp, que irá fornecer a senha criptografada, e caso seja de sua escolha o código de criptografia. Informe a senha criptografada em database.pass e o código de criptografia em database.seed.

Portanto, caso um usuário abra o arquivo, o mesmo não conseguirá decifrá-la.