RibaSoft

Instalação do Serviço (Windows) - 30/06/2026

• • Pré-requisitos
  • Instalação padrão (principal)
  • Instalação secundária (multi-instância)
  • Gerenciar o serviço
  • Parâmetros do instsvc

Pré-requisitos:

• O instsvc.exe fica na pasta do Firebird (na raiz da instalação ou em \bin, dependendo da versão). Ele registra, remove e controla o serviço do Firebird no Windows.

  Abra o PowerShell ou o Prompt de Comando como Administrador e entre na pasta da instalação do Firebird que você quer registrar:

  cd "C:\Program Files\Firebird\Firebird_5_0"

  Atenção: rode sempre como Administrador e a partir da pasta da instalação correta. O instsvc registra os binários que estão na pasta atual; se você rodar do lugar errado, o serviço vai apontar para o Firebird errado.

Instalação padrão (principal):

• Para a instalação principal da máquina, basta registrar o serviço com início automático e Guardian (o Guardian reinicia o servidor caso ele caia):

  .\instsvc.exe install -auto -guardian

  Em seguida, inicie o serviço:

  .\instsvc.exe start

  Sem informar -name, o serviço é registrado com o nome padrão (DefaultInstance) na porta padrão 3050.

Instalação secundária (multi-instância):

• Quando já existe outro Firebird rodando na máquina e você precisa de um segundo servidor em paralelo (por exemplo, uma versão diferente), é preciso dar a essa instância um nome de serviço próprio com a opção -name. Rodando de dentro da pasta da segunda instalação:

  .\instsvc.exe install -demand -guardian -name Firebird5

  O que cada parte faz:

  • install — registra o serviço no Windows.
  • -demand — início manual / sob demanda (não sobe junto com o Windows).
  • -guardian — instala com o Guardian (fbguard), que reinicia o servidor se ele cair.
  • -name Firebird5 — nome da instância/serviço, o que permite conviver com a instalação principal.

  Como duas instâncias não podem usar a mesma porta, edite o firebird.conf desta segunda instalação e troque a porta padrão por uma livre (ex.: 3055):

  RemoteServicePort = 3055

  Depois inicie o serviço informando o nome da instância:

  .\instsvc.exe start -name Firebird5

  Para conectar nessa instância secundária, informe o host e a porta:

  localhost/3055:C:\bancos\DB.FDB

  Atenção: não rode o instreg install na instalação secundária. O instreg grava o caminho da instância no Registro do Windows e as duas instalações passariam a "enxergar" a mesma pasta. Para multi-instância, use somente o instsvc com -name.

Gerenciar o serviço:

• Iniciar / parar:

  .\instsvc.exe start -name Firebird5 .\instsvc.exe stop -name Firebird5

• Consultar o status:

  Lista as instâncias do Firebird registradas e o estado de cada serviço:

  .\instsvc.exe query

• Remover o serviço:

  Pare o serviço antes de removê-lo:

  .\instsvc.exe stop -name Firebird5 .\instsvc.exe remove -name Firebird5

  Dica: para a instância padrão, é só omitir o -name em todos os comandos (ex.: .\instsvc.exe stop).

Parâmetros do instsvc:

• install => registra o serviço no Windows start => inicia o serviço stop => para o serviço remove => remove o serviço (pare antes) query => lista as instâncias e o status dos serviços -auto => início automático com o Windows (padrão) -demand => início manual / sob demanda -guardian (-g) => instala com o Guardian, que reinicia o servidor se ele cair -name (-n) => nome da instância/serviço (essencial em multi-instância) -interactive => roda o serviço como interativo (logon do usuário)