Deze handleiding laat zien hoe u HQbird 2027 op een Windows-server installeert met het programma Setup hqbird2027-fbNN-setup-<version>.exe. De handleiding heeft twee delen:

Het bijwerken van een oudere HQbird, de onderhoudsmodus van Setup, verwijderen en probleemoplossing staan in de volledige handleiding: hqbird2027-windows-setup-guide.md.

De schermafbeeldingen tonen Setup 2027.2.33 voor Firebird 5.0 op een schone Windows 10. De varianten van Setup voor Firebird 2.5, 3.0 en 4.0 hebben dezelfde pagina’s. De schermafbeelding van de stille uitvoering is gemaakt met een testbuild.

1. Voordat u begint

Selecteer Setup. Eén Setup installeert één Firebird-versie:

Setup Firebird Standaardpoort
hqbird2027-fb50-setup-<version>.exe 5.0 3050
hqbird2027-fb40-setup-<version>.exe 4.0 3050
hqbird2027-fb30-setup-<version>.exe 3.0 3050
hqbird2027-fb25-setup-<version>.exe 2.5 3050

Vereisten:

  • Windows 10 of 11, of Windows Server 2016 of nieuwer, 64-bits.
  • Een administratoraccount. Setup vraagt om verhoogde rechten.
  • Er is geen internetverbinding nodig. Setup bevat alle bestanden.

Wat Setup installeert:

Onderdeel Windows-service Standaardlocatie
Firebird-server (HQbird-build) FirebirdServerHQBirdInstanceFB5 C:\HQbird\Firebird50, poort 3050
HQbird-agent (back-ups, monitoring, updates) HQbirdFBAgent-fb50 C:\HQbird\fbagent-fb50
HQbird Monitor (webconsole) HQbirdMonitor-fb50 http://localhost:23050/
fbmcp, de MCP-server voor AI-clients (optioneel) fbmcp C:\HQbird\fbmcp

De werkgegevens van de agent en van HQbird Monitor gaan naar C:\HQbirdData. De bovenstaande namen gelden voor Firebird 5.0. Voor Firebird 4.0 bevatten ze fb40 en FB4, enzovoort.

Talen. De wizard heeft 8 talen: Engels, Braziliaans Portugees, Duits, Russisch, Spaans, Pools, Turks en vereenvoudigd Chinees. Wanneer u Setup start, toont het een talenlijst. De taal van Windows is geselecteerd.

2. Interactieve installatie

Start het bestand van Setup en accepteer de verhogingsprompt van Windows. Selecteer de taal en klik op OK.

Setup wijzigt niets op de computer voordat u op Installeren klikt op de pagina Gereed voor installatie. U kunt op elke pagina op Vorige klikken.

Stap 1: Welkom

Welkom

De pagina toont de versie van HQbird en de versie van Firebird. Klik op Volgende.

Stap 2: Licentieovereenkomst

Licentieovereenkomst

Lees de overeenkomst. Selecteer Ik accepteer de overeenkomst en klik op Volgende.

Setup pakt daarna zijn bestanden uit en controleert de computer. Dit duurt enkele seconden.

Stap 3: Resultaten van de servercontrole

Resultaten van de servercontrole

De pagina toont twee lijsten:

  • Gevonden op deze computer: een oudere HQbird, HQbird-agents en Firebird-servers.
  • Geplande acties: wat Setup installeert met de standaardinstellingen.

Schakel het selectievakje fbmcp installeren, de MCP-server voor AI-clients uit als u fbmcp niet wilt. Klik op Volgende.

Als Setup een Firebird van dezelfde versie of een oudere HQbird vindt, is de volgende pagina Installatietype (bijwerken, of een nieuwe instantie). Zie de volledige handleiding hqbird2027-windows-setup-guide.md.

Stap 4: Installatiemappen

Installatiemappen

  • HQbird-map: Firebird en de HQbird-agent komen in submappen van deze map.
  • Gegevensmap: de werkgegevens van de HQbird-agent en HQbird Monitor, en het aanmeldbestand van HQbird Monitor. Databases worden hier niet opgeslagen.

Gebruik twee verschillende mappen.

Stap 5: Firebird-server

Firebird-server

  • Firebird-map: de standaard is Firebird50 in de HQbird-map.
  • Poort: de standaard is 3050. Gebruik een poort die geen ander programma gebruikt.
  • Servicenaam van Firebird: wijzig deze alleen als een andere Firebird dezelfde naam gebruikt.

De laatste regels tonen de map en de servicenamen van de HQbird-agent en HQbird Monitor.

Stap 6: SYSDBA-wachtwoord

SYSDBA-wachtwoord

Voer het wachtwoord van de Firebird-administrator (SYSDBA) twee keer in. Als u de twee velden leeg laat, gebruikt Setup het standaardwachtwoord van Firebird masterkey. Gebruik op een productieserver een sterk wachtwoord.

Stap 7: HQbird Monitor

HQbird Monitor

HQbird Monitor is de webconsole van HQbird.

  • Poort: de standaard is 20000 + de Firebird-poort (23050). Setup opent deze poort in Windows Firewall.
  • Gebruikersnaam: de standaard is admin.
  • Wachtwoord: 7 tot 128 tekens, met letters en cijfers. Voer het twee keer in.

U meldt zich bij HQbird Monitor aan met deze gebruikersnaam en dit wachtwoord.

Stap 8: Servernaam

Servernaam

De servernaam is de agent-id van de nieuwe HQbird-agent. HQCenter toont de server onder deze naam. De standaard is de computernaam in kleine letters. De naam kan 1 tot 128 tekens hebben: letters, cijfers, - of _.

Stap 9: Replicatie en clusterinrichting (optioneel)

Replicatie en clusterinrichting

De twee opties staan standaard uit. U kunt ze later inschakelen in HQbird Monitor.

  • Detectiemodus voor replicatieknooppunten inschakelen: selecteer dit als u binnen 24 uur replicatie op deze instantie gaat configureren.
  • Replication Cluster Manager (RCM) op deze server installeren: RCM is de webconsole die servers koppelt tot een replicatiecluster. Installeer RCM op slechts één server van het cluster.

Stap 10: Proefperiode (optioneel)

Proefperiode

Zonder registratie is de proefperiode 7 dagen. Om deze tot 30 dagen te verlengen:

  1. Voer uw zakelijke e-mailadres in.
  2. Selecteer de taal van de e-mail.
  3. Selecteer Ik ga ermee akkoord dat Setup mijn e-mailadres naar IBSurgeon stuurt.

U ontvangt daarna een e-mail met een code van 6 cijfers. Voer de code in HQbird Monitor in. Om deze stap over te slaan, laat u het adres leeg en klikt u op Volgende.

Stap 11: Automatische updates

Automatische updates

Setup toont deze pagina wanneer de server niet met HQCenter is verbonden. HQbird kan dan bij de updateserver van IBSurgeon controleren op nieuwe versies. Selecteer wat HQbird zelf bijwerkt:

  • Alleen HQbird (aanbevolen): de HQbird-agent, HQbird Monitor en fbmcp werken zichzelf bij. Een nieuwe versie van Firebird wordt gedownload en wacht op de administrator.
  • HQbird en Firebird: Firebird werkt zichzelf ook bij, ’s nachts van 03:30 tot 04:00. De update herstart Firebird.
  • Uit: geen updatecontroles. Werk bij door Setup van een nieuwe versie van HQbird uit te voeren.

U kunt deze instelling later wijzigen in HQbird Monitor. Als u de server later met HQCenter verbindt, regelt HQCenter de updates.

Setup slaat deze pagina over wanneer de map van Setup attach.json bevat.

Stap 12: Licentiebestand (optioneel)

Licentiebestand

Als u een licentiebestand van HQbird hebt (.json of .lic), selecteer het dan. Zonder een licentiebestand werkt HQbird in de proefmodus. U kunt later een licentie installeren met de snelkoppeling in het menu Start HQbird 2027 (Firebird 5.0) onderhoud.

Stap 13: Verbinding maken met HQCenter (optioneel)

Verbinding maken met HQCenter

Als uw bedrijf HQCenter gebruikt, selecteer dan het attach-bestand (attach.json) dat u van HQCenter hebt gedownload. Zo niet, sla deze stap over. Het bestand bevat een geheim toegangstoken: verwijder het na de installatie.

Stap 14: Gereed voor installatie

Gereed voor installatie

De pagina vermeldt de taak, de acties, de mappen, de servicenamen en de modus van automatische updates. Blader door de lijst om alle regels te zien. Lees de lijst. Klik op Vorige om een instelling te wijzigen, of op Installeren om te starten.

Stap 15: Bezig met installeren

Bezig met installeren

Setup installeert Firebird, de HQbird-agent en HQbird Monitor. Dit duurt enkele minuten. Sluit het venster niet.

Stap 16: Installatie voltooid

Installatie voltooid

Het overzicht toont:

  • De versie van Firebird, de map en de poort.
  • De map van de HQbird-agent, de service ervan en de servernaam.
  • De adressen van HQbird Monitor: op deze computer en vanaf een andere computer.
  • De gebruikersnaam van HQbird Monitor.
  • Opmerkingen over fbmcp, replicatie en de optionele stappen.

HQbird Monitor openen opent de webconsole in de browser. Klik op Volgende.

Stap 17: Voltooien

Voltooien

Laat HQbird Monitor openen in de browser geselecteerd om de webconsole te openen, en klik op Voltooien.

Na de installatie

  • HQbird Monitor: open http://localhost:23050/ en meld u aan met de gebruikersnaam en het wachtwoord uit stap 7.
  • Menu Start, groep HQbird 2027: HQbird Monitor (Firebird 5.0, poort 23050), HQbird-documentatie (Firebird 5.0), Verbinding maken met HQCenter (Firebird 5.0) en HQbird 2027 (Firebird 5.0) onderhoud.
  • Services: FirebirdServerHQBirdInstanceFB5, HQbirdFBAgent-fb50 en HQbirdMonitor-fb50 draaien en starten automatisch.
  • Mappen: programma’s in C:\HQbird, werkgegevens in C:\HQbirdData.

3. Installatie via de opdrachtregel (stil)

Een stille uitvoering toont geen venster en stelt geen vragen. Gebruik deze in scripts en voor installatie op afstand.

De opdracht

Open een opdrachtprompt als administrator en voer uit:

Command
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%
Schakelaar Betekenis
/VERYSILENT Geen wizard en geen voortgangsvenster. De uitvoering accepteert de licentieovereenkomst
/SUPPRESSMSGBOXES Geen berichtvensters
/YES Beantwoord de vragen van Setup met ja (bijvoorbeeld: Firebird stoppen)
/LOG=<file> Schrijf het log van Setup. Voeg het altijd toe: de fouten van een stille uitvoering staan alleen in het log

start /wait wacht op Setup en plaatst de afsluitcode in %ERRORLEVEL%. Afsluitcode 0 = geïnstalleerd.

Zonder extra schakelaars gebruikt Setup de standaardwaarden van de wizard: de mappen C:\HQbird en C:\HQbirdData, de Firebird-poort 3050, HQbird Monitor op poort 23050, geen proef-e-mail, geen licentiebestand, alleen automatische updates van HQbird. De wachtwoorden verschillen van de wizard:

  • SYSDBA: Setup genereert een wachtwoord. Geef uw eigen wachtwoord op met /SYSDBAPASSFILE=.
  • HQbird Monitor: de gebruiker admin met een gegenereerd wachtwoord. Het wachtwoord staat in C:\HQbirdData\config\access.properties (alleen administrators). Geef uw eigen gegevens op met /HQMLOGIN= en /HQMPASSFILE=.

Voorbeeld: stille installatie met uw wachtwoorden

Command
cd /d C:\Temp
echo Sysdba-2027-Pass>sysdba.txt
echo Monitor-2027-Pass>hqm.txt
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /SYSDBAPASSFILE=sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=hqm.txt /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%
del sysdba.txt hqm.txt

Stille installatie in een opdrachtprompt

Opmerkingen:

  • Een wachtwoordbestand is een tekstbestand in UTF-8. Setup leest de eerste regel.
  • Zet geen spatie vóór > in de opdracht echo: de spatie wordt een deel van het wachtwoord.
  • Een relatief bestandspad telt vanaf de map van Setup.
  • Schrijf het bestand in PowerShell met Set-Content -Encoding UTF8. De > van PowerShell schrijft UTF-16, en Setup weigert zo’n bestand.

Hetzelfde in PowerShell (uitvoeren als administrator):

Command
Set-Content -Path C:\Temp\sysdba.txt -Value 'Sysdba-2027-Pass' -Encoding UTF8
Set-Content -Path C:\Temp\hqm.txt -Value 'Monitor-2027-Pass' -Encoding UTF8
$p = Start-Process -Wait -PassThru -FilePath C:\Temp\hqbird2027-fb50-setup-<version>.exe `
  -ArgumentList '/VERYSILENT', '/SUPPRESSMSGBOXES', '/YES', `
    '/SYSDBAPASSFILE=C:\Temp\sysdba.txt', '/HQMLOGIN=admin', '/HQMPASSFILE=C:\Temp\hqm.txt', `
    '/LOG=C:\Temp\hqbird-setup.log'
$p.ExitCode   # 0 = installed
Remove-Item C:\Temp\sysdba.txt, C:\Temp\hqm.txt

Schakelaars voor de instellingen van de wizard

Elke instelling van de wizard heeft een schakelaar:

Wizardpagina Schakelaar Standaard
Resultaten van de servercontrole /NOFBMCP: fbmcp niet installeren fbmcp wordt geïnstalleerd
Installatiemappen /HQBIRDROOT=<folder>: HQbird-map C:\HQbird
Installatiemappen /DATAROOT=<folder>: gegevensmap C:\HQbirdData
Firebird-server /FBDIR=<folder>: Firebird-map C:\HQbird\Firebird50
Firebird-server /FBPORT=<port>: Firebird-poort 3050
Firebird-server /FBINSTANCE=<name>: de service is FirebirdServer<name> HQBirdInstanceFB5
SYSDBA-wachtwoord /SYSDBAPASSFILE=<file> gegenereerd
HQbird Monitor /HQMPORT=<port> 20000 + Firebird-poort
HQbird Monitor /HQMLOGIN=<name> /HQMPASSFILE=<file> admin, gegenereerd wachtwoord
Servernaam /AGENTID=<name> computernaam in kleine letters
Replicatie en clusterinrichting /DISCOVERY: detectiemodus 24 uur inschakelen uit
Replicatie en clusterinrichting /RCM: RCM op deze server installeren uit
Proefperiode /EMAIL=<address> /ACCEPTPRIVACY [/MAILLANG=en|ru|pt-BR] geen proef-e-mail
Automatische updates /AUTOUPDATE=all|agent|off: agent = alleen HQbird, all = HQbird en Firebird, off = geen updatecontroles agent
Licentiebestand /LICENSE=<file> geen
Verbinding maken met HQCenter /ATTACH=<attach.json> attach.json in de map van Setup, als het daar staat
Talenlijst /LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN taal van Windows

/SYSDBAPASS=<password> en /HQMPASS=<password> werken ook, maar het wachtwoord is dan zichtbaar in het log van Setup. Gebruik bij voorkeur de wachtwoordbestanden.

/AUTOUPDATE= heeft alleen effect zolang de server niet met HQCenter is verbonden. Met HQCenter regelt HQCenter de updates.

Bij een stille uitvoering stelt /LANG= de taal van sommige berichten in het log in. Gebruik /LANG=en voor een Engels log.

Voorbeeld met andere mappen, een andere poort en een proef-e-mail:

Command
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES ^
  /HQBIRDROOT=D:\HQbird /DATAROOT=D:\HQbirdData /FBPORT=3055 ^
  /SYSDBAPASSFILE=C:\Temp\sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=C:\Temp\hqm.txt ^
  /[email protected] /ACCEPTPRIVACY /MAILLANG=en ^
  /LANG=en /LOG=C:\Temp\hqbird-setup.log

Afsluitcodes

Code Betekenis
0 Geïnstalleerd
1 Geweigerd vóór de installatie: een ongeldige schakelaar of een ongeldig bestand, een nieuwere versie is geïnstalleerd, of geen administratorrechten. De reden staat in het log
4 Setup had een vraag en de opdracht had geen /YES
7 De servercontrole of de installatie is mislukt. De fout staat in het log en in %ProgramData%\fbagent\hqbird2027-setup-result.json
10 Geïnstalleerd, maar de verbinding met HQCenter is mislukt

Het resultaat controleren

Command
sc query FirebirdServerHQBirdInstanceFB5 | findstr "SERVICE_NAME STATE"
sc query HQbirdFBAgent-fb50 | findstr "SERVICE_NAME STATE"
sc query HQbirdMonitor-fb50 | findstr "SERVICE_NAME STATE"

De drie services moeten de status RUNNING hebben. Open daarna http://localhost:23050/ en meld u aan bij HQbird Monitor.

Een script dat stopt wanneer de installatie mislukt:

Command
@echo off
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
if errorlevel 1 (
  echo HQbird setup failed with code %ERRORLEVEL%, see C:\Temp\hqbird-setup.log
  exit /b %ERRORLEVEL%
)
echo HQbird 2027 installed

Stille verwijdering

Command
start /wait "" "C:\HQbird\setup\fb50\unins000.exe" /VERYSILENT

Dit verwijdert de programma’s en de services. Databases, de configuratiebestanden en de beveiligingsdatabase van Firebird blijven. Voeg /REMOVEDATA toe om ook de werkgegevens, de beveiligingsdatabase en de configuratiebestanden te verwijderen. Databasebestanden blijven altijd.

4. Meer informatie

  • Bijwerken, onderhoud, meerdere instanties, HQCenter, alle schakelaars en probleemoplossing: hqbird2027-windows-setup-guide.md.
  • Verwijderen op Windows en Linux: Verwijderen.
  • Linux-installatieprogramma: Linux-installatiehandleiding.