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

Edição das 02h52min 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 de arquivos DLL durante a instalação.

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** (para não substituir o serviço do Firebird 2.5).

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 "avisar" ao Sistema Celta que ele deve bater na porta **3051**.

Abra o arquivo de configuração de conexão (geralmente na pasta do sistema ou em C:\ProgramData...).
Adicione ou altere o parâmetro Port e Server.

Exemplo de Configuração: <pre style="background:#f8f9fa; border:1px solid #ddd;

@@ 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 de arquivos DLL durante a instalação.}}
+== 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 style="background:#f8f9fa; border:1px solid #ddd; padding:10px; border-radius:4px;">
+# ... 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** (para não substituir o serviço do Firebird 2.5).
+# Abra o **Prompt de Comando (CMD)** como '''Administrador'''.
+# Execute os comandos abaixo linha por linha:
+<pre style="background:#2c3e50; color:#fff; padding:15px; border-radius:6px;">
+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 "avisar" ao Sistema Celta que ele deve bater na porta **3051**.
+# Abra o arquivo de configuração de conexão (geralmente na pasta do sistema ou em <code>C:\ProgramData...</code>).
+# Adicione ou altere o parâmetro <code>Port</code> e <code>Server</code>.
+'''Exemplo de Configuração:'''
+<pre style="background:#f8f9fa; border:1px solid #ddd;