Instalação do Celta com 2 Firebirds: mudanças entre as edições

Edição atual tal como às 03h37min de 30 de novembro de 2025

Este procedimento é utilizado quando o cliente já possui um software legado rodando em uma versão antiga do Firebird (ex: 2.5) na porta padrão (3050) e precisamos instalar o Firebird do Celta (3.0 ou 4.0) no mesmo servidor, operando em paralelo.

PRÉ-REQUISITO

Antes de iniciar, certifique-se de que o Firebird do "outro software" esteja Parado no Serviços do Windows para evitar conflitos.

1. Preparação e Instalação

Acesse o painel de serviços do Windows (services.msc) e Pare o serviço do Firebird antigo.
Execute o instalador do Firebird utilizado pelo Celta (preferencialmente a versão mais atual homologada).
Durante a instalação, não configure para iniciar automaticamente ainda, ou pare o serviço logo após a instalação terminar.

2. Configuração de Portas (firebird.conf)

Para que os dois bancos rodem juntos, precisamos alterar a porta de escuta do Firebird do Celta (geralmente para 3051).

Navegue até a pasta de instalação (Ex: C:\Program Files (x86)\Firebird\Firebird_3_0).
Localize o arquivo firebird.conf e abra-o com o Bloco de Notas (como Administrador).
Procure pela linha RemoteServicePort.
Remova a cerquilha (#) do início da linha e altere o valor.

Como deve ficar no arquivo:

# ... configurações anteriores ...

#RemoteServiceName = gds_db
#RemoteServicePort = 3050
RemoteServicePort = 3051

# ... restante do arquivo ...

Salve e feche o arquivo.

3. Instanciando o Serviço (CMD)

Agora precisamos registrar o serviço no Windows com um nome único.

Abra o Prompt de Comando (CMD) como Administrador.
Execute os comandos abaixo linha por linha:

cd "C:\Program Files (x86)\Firebird\Firebird_3_0"

instsvc i -a -g -n firebird_3

instsvc sta

ENTENDENDO O COMANDO

i: Install (Instalar).
-a: Auto (Iniciar automaticamente com o Windows).
-g: Guardian (Ativa o "guardião" que reinicia o serviço se ele cair).
-n firebird_3: Nome da Instância. Isso cria o serviço com o nome "Firebird_3" em vez de "DefaultInstance", permitindo coexistir com o antigo.

4. Configuração da Conexão (FDConnectionDefs.ini)

Agora precisamos configurar o Celta para usar a porta 3051.

Vá na pasta de instalação do sistema (Geralmente: C:\Celta Sistemas).
Encontre e abra o arquivo FDConnectionDefs.ini.
Altere o parâmetro Port para a porta configurada.

Exemplo de configuração correta:

[Celta]
Server=127.0.0.1
Database=C:\Celta Sistemas\CELTA.FDB
Protocol=TCPIP
CharacterSet=WIN1252
Port=3051
DriverID=FB

5. Finalização

Volte aos Serviços do Windows.
Inicie novamente o serviço do Firebird antigo (do outro software).
Verifique se ambos os serviços estão com status "Em Execução".

@@ Linha 1: / Linha 1: @@
-== Instalação ==
+{{Cabecalho
-# Pare o serviço do firebird do outro software.
+ | [[Documentação]]
-# Instale a versão que o celta vai usar. (De preferencia para a mais atual)
+ | Instalação do Celta com 2 Versões de Firebird
-# Vá na pasta de instalação da versão do FB do celta que geralmente é: '''"C:\Program Files (x86)\Firebird\Firebird_3_0"''', encontre o arquivo '''firebird.conf''', abra com o bloco de notas
+}}
-# Encontre a linha: '''#RemoteServicePort=3050''' Remova a (#) da frente da linha e altera para porta desejada. '''(exemplo: =3051)''', salve e saia do editor.
-#Para instanciar e iniciar o serviço, abra o prompt como '''administrador''', e digite:<br /> '''cd/(Enter)'''<br />  '''cd C:\Program Files (x86)\Firebird\Firebird_3_0 (Enter)'''<br /> '''instsvc i –a –g –n firebird_3 (Enter)'''<br />''' instsvc sta (Enter)'''
+Este procedimento é utilizado quando o cliente já possui um software legado rodando em uma versão antiga do Firebird (ex: 2.5) na porta padrão (3050) e precisamos instalar o Firebird do Celta (3.0 ou 4.0) no mesmo servidor, operando em paralelo.
-# No '''FDConnectionDefs.ini''' altere o Port para a porta configurada:<br />'''[Celta]<br />Server=127.0.0.1<br />Database=C:\Celta Sistemas\CELTA.FDB<br />Protocol=TCPIP<br />CharacterSet=WIN1252<br />Port=3051<br />DriverID=FB'''
-# Iniciar o serviço do Firebird do outro software novamente .
+{{Nota|warning|PRÉ-REQUISITO|Antes de iniciar, certifique-se de que o Firebird do "outro software" esteja '''Parado''' no Serviços do Windows para evitar conflitos.}}
+== 1. Preparação e Instalação ==
+# Acesse o painel de serviços do Windows (<code>services.msc</code>) e '''Pare''' o serviço do Firebird antigo.
+# Execute o instalador do Firebird utilizado pelo Celta (preferencialmente a versão mais atual homologada).
+# Durante a instalação, '''não''' configure para iniciar automaticamente ainda, ou pare o serviço logo após a instalação terminar.
+== 2. Configuração de Portas (firebird.conf) ==
+Para que os dois bancos rodem juntos, precisamos alterar a porta de escuta do Firebird do Celta (geralmente para '''3051''').
+# Navegue até a pasta de instalação (Ex: <code>C:\Program Files (x86)\Firebird\Firebird_3_0</code>).
+# Localize o arquivo '''firebird.conf''' e abra-o com o Bloco de Notas (como Administrador).
+# Procure pela linha <code>RemoteServicePort</code>.
+# Remova a cerquilha (<code>#</code>) do início da linha e altere o valor.
+'''Como deve ficar no arquivo:'''
+<pre>
+# ... configurações anteriores ...
+#RemoteServiceName = gds_db
+#RemoteServicePort = 3050
+RemoteServicePort = 3051
+# ... restante do arquivo ...
+</pre>
+Salve e feche o arquivo.
+== 3. Instanciando o Serviço (CMD) ==
+Agora precisamos registrar o serviço no Windows com um '''nome único'''.
+# Abra o '''Prompt de Comando (CMD)''' como '''Administrador'''.
+# Execute os comandos abaixo linha por linha:
+<pre>
+cd "C:\Program Files (x86)\Firebird\Firebird_3_0"
+instsvc i -a -g -n firebird_3
+instsvc sta
+</pre>
+{{Nota|info|ENTENDENDO O COMANDO|
+* <code>i</code>: Install (Instalar).
+* <code>-a</code>: Auto (Iniciar automaticamente com o Windows).
+* <code>-g</code>: Guardian (Ativa o "guardião" que reinicia o serviço se ele cair).
+* <code>-n firebird_3</code>: '''Nome da Instância'''. Isso cria o serviço com o nome "Firebird_3" em vez de "DefaultInstance", permitindo coexistir com o antigo.
+}}
+== 4. Configuração da Conexão (FDConnectionDefs.ini) ==
+Agora precisamos configurar o Celta para usar a porta '''3051'''.
+# Vá na pasta de instalação do sistema (Geralmente: <code>C:\Celta Sistemas</code>).
+# Encontre e abra o arquivo '''FDConnectionDefs.ini'''.
+# Altere o parâmetro <code>Port</code> para a porta configurada.
+'''Exemplo de configuração correta:'''
+<pre>
+[Celta]
+Server=127.0.0.1
+Database=C:\Celta Sistemas\CELTA.FDB
+Protocol=TCPIP
+CharacterSet=WIN1252
+Port=3051
+DriverID=FB
+</pre>
+== 5. Finalização ==
+# Volte aos Serviços do Windows.
+# '''Inicie''' novamente o serviço do Firebird antigo (do outro software).
+# Verifique se ambos os serviços estão com status "Em Execução".