Installatiehandleiding voor HQbird op Windows
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:
- Interactieve installatie: de wizard van Setup, pagina voor pagina.
- Installatie via de opdrachtregel: een volledig stille uitvoering, voor scripts.
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

De pagina toont de versie van HQbird en de versie van Firebird. Klik op Volgende.
Stap 2: 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

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

- 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-map: de standaard is
Firebird50in 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

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 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

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)

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)

Zonder registratie is de proefperiode 7 dagen. Om deze tot 30 dagen te verlengen:
- Voer uw zakelijke e-mailadres in.
- Selecteer de taal van de e-mail.
- 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

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)

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)

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

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

Setup installeert Firebird, de HQbird-agent en HQbird Monitor. Dit duurt enkele minuten. Sluit het venster niet.
Stap 16: 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

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-fb50enHQbirdMonitor-fb50draaien en starten automatisch. - Mappen: programma’s in
C:\HQbird, werkgegevens inC:\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:
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
adminmet een gegenereerd wachtwoord. Het wachtwoord staat inC:\HQbirdData\config\access.properties(alleen administrators). Geef uw eigen gegevens op met/HQMLOGIN=en/HQMPASSFILE=.
Voorbeeld: stille installatie met uw wachtwoorden
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
Opmerkingen:
- Een wachtwoordbestand is een tekstbestand in UTF-8. Setup leest de eerste regel.
- Zet geen spatie vóór
>in de opdrachtecho: 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):
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.txtSchakelaars 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:
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.logAfsluitcodes
| 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
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:
@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 installedStille verwijdering
start /wait "" "C:\HQbird\setup\fb50\unins000.exe" /VERYSILENTDit 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.