Kurulum ve güncellemeler
Sürprizsiz kurulum
Her Firebird sürüm hattı için tek bir kurulum dosyası. Sunucudaki Firebird'ü, eski HQbird'ü ve ajanları bulur, bir plan gösterir ve siz "Evet" diyene kadar hiçbir şeyi değiştirmez. Ardından ajan kendini, konsolu ve Firebird'ü kontroller ve geri alma ile kendi kendine günceller.
- 4 kurulum dosyası: Firebird 2.5 · 3.0 · 4.0 · 5.0
- Planı onaylamadan önce 0 değişiklik
- internet gerekmez her şey tek dosyada
- Windows ve Linux sihirbaz, sessiz mod, .run
- geri alma kurulum veya güncelleme başarısız olursa
setup.exe · .run
Kitte neler var
Kurulum dosyası tek bir dosyadır: Windows için hqbird2027-fb50-setup-<version>.exe veya Linux için hqbird2027-fb50-linux-<version>.run. Sunucunun ihtiyaç duyduğu her şeyi içerir. Hiçbir şey indirilmez.
Her kurulum dosyası bir Firebird sürüm hattını kurar. Veritabanlarınızın çalıştığı hattı seçin. Kurulumu kitteki ajan yapar: sunucuyu kontrol eder, bir plan oluşturur ve uygular.
| Bileşen | Ne yapar | Windows | Linux |
|---|---|---|---|
| Firebird, HQbird derlemesi | Yeni bir sunucu veya yerinde güncelleme. Zaten kurulu bir sunucu için firebird.conf dosyasına tek bir satır eklenir: MonitoringPlugin = fblwmon. Yeni bir sunucu için kurulum dosyası ayrıca bağlantı noktasını ayarlar. databases.conf, güvenlik veritabanı ve SYSDBA parolası değişmez. | FirebirdServer… hizmeti | /opt/firebird |
| fbagent ajanı | Yedeklemeler, izleme, bakım, güncellemeler. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, kullanıcı firebird |
| HQbird Monitor | Bu sunucu için web konsolu. Bağlantı noktası = 20000 + Firebird bağlantı noktası: 3050 için 23050'dir. Bağlantı noktası kurulum sırasında seçilir ve Firebird bağlantı noktasını değiştirseniz bile sonradan değişmez. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Küme bileşenleri | Küme programları sunucuya konur ancak açılmaz: RCM ve eşleştirme penceresi varsayılan olarak kapalıdır. RCM sunucuyu yeni bir kümenin merkezi yapar ve 7443 ve 7444 bağlantı noktalarını açar. Eşleştirme penceresi 24 saat boyunca 7450–7459 bağlantı noktalarını açar: bu pencere aracılığıyla başka bir sunucunun RCM'si bu sunucuyu davet edebilir. Her ikisini de kurulumdan sonra açabilirsiniz. | sihirbaz sayfası "Replication and cluster setup"; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| fbmcp MCP sunucusu | Yapay zeka istemcileri için Firebird'e erişim. Varsayılan olarak yalnızca bu sunucudan. | sihirbazdaki onay kutusu veya /NOFBMCP | --no-fbmcp |
| Firebird hata ayıklama dosyaları | Firebird çökmelerini analiz etmek için semboller. | — | evet, --no-debug kapatır |
- WindowsDesteklenen: Windows 10 ve 11, Windows Server 2016 ve sonrası, 64 bit. Yönetici hakları. Kurulum dosyası IBSurgeon Software tarafından imzalanmıştır: Windows hak isteminde yayıncıyı gösterir.
- Sihirbaz veya sessiz modHer sihirbaz sayfası aynı zamanda bir anahtar olarak da kullanılabilir:
/VERYSILENT /YES /LOG=…. Betikler ve yüz sunucu için uygundur. - 8 dilde sihirbazİngilizce, Portekizce (Brezilya), Almanca, Rusça, İspanyolca, Lehçe, Türkçe, Basitleştirilmiş Çince. Varsayılan, Windows dilidir. Anahtar:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Sunucu adıSihirbaz yeni ajanın adını sorar; HQCenter sunucuyu bu ad altında gösterir. Varsayılan, bilgisayar adıdır. Sessiz mod:
/AGENTID=, Linux'ta--agent-id. Zaten kurulu bir ajan adını korur.
- Linuxx86_64, çekirdek 3.2 veya sonrası, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS ve apt, dnf, yum veya zypper kullanan diğerleri.
- İnternetsiz sunucuKurulum dosyası birkaç işletim sistemi kütüphanesini (libtommath, ICU) depodan alır. Depo yoksa tam komutları yazdırır ve hiçbir şeyi değiştirmez.
Kit iki kez kontrol edilir. Açmadan önce: tüm kitin sha256'sı. Firebird ve ajan kurulmadan önce: her dosyanın imzası. Hasarlı bir indirme, Firebird, ajan veya konsolda herhangi bir değişiklik yapılmadan kurulumu durdurur.
fbagent --install-plan
Önce plan, sonra değişiklikler
Önce kurulum dosyası yalnızca okur: hizmetler, kayıt defteri, Firebird ve HQbird klasörleri. Ardından ne bulduğunu ve ne yapacağını gösterir. Değişiklikler siz "Evet" dedikten sonra başlar.
Sunucuda ne olduğunu seçin ve plana bakın. Metinler kısaltılmış ve çevrilmiştir; sıra ve kararlar Firebird 5.0 kurulum dosyasındakiyle aynıdır.
- 1Sunucu kontrolühaklar, bitlik; Linux'ta ayrıca systemd ve çekirdek
- 2Kit kontrolüaçmadan önce sha256; kurulumdan önce dosya imzaları
- 3Planne bulundu ve ne yapılacak
- 4SorularHQCenter için sunucu adı; Firebird durdurulsun mu? başka sürüm?
- 5KurulumFirebird, ajan, konsol, hizmetler
- 6✓ Sonuçhizmetler, konsol adresi, oturum açma
Bir şeyler ters giderse
Plan aşamasında bir ret (bağlantı noktası kullanımda, klasör boş değil) hiçbir şeyi değiştirmez: kurulum dosyası nedeni belirtir. Sihirbazda, bir değer yanlışken bir sayfadan ayrılamazsınız.
Ajan hizmeti başlamadan önce kurulum sırasında bir hata: hizmetler önceki durumlarına döner. Eski HQbird, durdurulmuşsa yeniden başlar.
| Kod | Anlamı (Linux .run) |
|---|---|
| 0 | Tamamlandı |
| 1 | Reddedildi: sunucu, anahtar veya plan. Hiçbir şey değişmedi |
| 2 | Kurulum başarısız oldu, değişiklikler geri alındı |
| 3 | Geri alma tamamlanmadı: sonuç neyin kontrol edileceğini söyler |
| 4 | Yanıt gerekli: terminal yok ve --yes yok |
| 5 | Kit kontrolden geçemedi: yeniden indirin |
| 6 | İşletim sistemi kütüphanesi yok ve depo yok |
| 7 | Firebird dağıtım paketlerinden |
| Kod | Anlamı (Windows setup.exe) |
|---|---|
| 0 | Kuruldu |
| 1 | Kurulumdan önce reddedildi: yanlış anahtar veya dosya, daha yeni bir sürüm kurulu, yönetici hakları yok |
| 4 | Kurulum dosyasının bir sorusu vardı, ancak /YES anahtarı yok |
| 7 | Sunucu kontrolü veya kurulum başarısız oldu. Neden günlükte ve sonuç dosyasında |
| 10 | Kuruldu, ancak HQCenter bağlantısı başarısız oldu |
-p3050) kullanır; yeni kurulumlar -fb50 alır.FBDataGuard → fbagent
HQbird 2024'ten geçiş
Yükleyici eski HQbird'i ve onun hizmet verdiği Firebird'i bulur. Bu Firebird yerinde güncellenir, FBDataGuard işleri ajana taşınır, eski hizmetler durdurulur. Veritabanları, yapılandırmalar ve parolalar kalır.
- Değişmeyenler
databases.confveyaaliases.conf, güvenlik veritabanı, SYSDBA parolası, veritabanları, yedekler ve eski HQbird dosyaları.firebird.confiçinde yalnızca eksikseMonitoringPlugin = fblwmonsatırı eklenir. - Eski Firebird kopyasıEski Firebird'in program klasörü yanında
<folder>.old_<time>olarak saklanır. - İşlergbak ve nbackup yedekleri, sweep, dizin istatistikleri. İçe aktarma bir kez çalışır ve yeni yapılandırmanın denetiminden geçer; eski yapılandırma saklanır.
- Eski yedeklerAjan, FBDataGuard günlüklerindeki yedekleri kendi kayıtlarına alır. Saklama kuralları ve geri yükleme onları yeniler gibi görür. nbackup seviyelerinin adları aynı kalır.
- İş adlarıİş adı, FBDataGuard'daki veritabanı adıyla biter, örneğin "Verified backup - MANUAL". Grup işleri kaynak klasörlerin ağacını yineler.
- Eski hizmetler: üç seçenekOtomatik (önerilir): FBDataGuard'ın hizmet verdiği her Firebird'ün bir ajanı olduğunda bunları devre dışı bırakır. Tümünü devre dışı bırak:
/DISABLEHQBIRD. Olduğu gibi bırak:/NOHQBIRD. - Geri dönebilirsinizHer hizmetin devre dışı bırakılmadan önceki durumu
fbagent-hqbird-takeover.jsondosyasına kaydedilir. Bu dosyayla eski HQbird yeniden açılabilir. - LisansEski HQbird lisansı devredilmez. Yeni bir lisans alana veya HQCenter'a bağlanana kadar deneme süresi işler.
- Belirsiz yolİçe aktarma, bir FBDataGuard yolundaki değişkeni genişletemezse onu olduğu gibi bırakır ve işi devre dışı bırakır. Yolu düzeltin ve işi etkinleştirin.
İşler içe aktarıldığı halde eski hizmetler hâlâ çalışıyorsa (örneğin sunucuda FBDataGuard altında iki Firebird sunucusu varsa), işler devre dışı olarak gelir. Böylece bir iş iki kez çalışmaz.
Bağlantı noktaları · klasörler · hizmetler
Tek makinede birden çok Firebird sunucusu
Her Firebird için bir ajan. Yeni bir örnek diğerlerinin yanına, kendi bağlantı noktası, kendi ajanı ve kendi konsoluyla kurulur. Kurulu örnekler değişmez.
Firebird sunucuları ekleyin ve yükleyicinin hangi adları ve bağlantı noktalarını seçtiğini görün.
- Sürüme göre bağlantı noktalarıSunucudaki ilk Firebird 3050 alır. Sonraki: 2.5 için 3052, 3.0 için 3053, 4.0 için 3054, 5.0 için 3055. Yükleyici kullanımda olan bir bağlantı noktasını almaz.
- Aynı sürümün ikinci örneğiKlasör ve hizmet adlarında
-2numarası. Windows'ta bu, sihirbazın "Başka bir örnek kur" seçeneğidir; bağlantı noktası, sürümün aralığındaki ilk boş olandır.
- Güncellemeler yalnızca sürüm içinde5.0.x → 5.0.y. 3.0'dan 5.0'a geçmek, ilkinin yanına ikinci bir örnek kurmak demektir; veritabanlarını bir kişi yedekleme ve geri yükleme ile taşır.
- Windows'ta XNET3050 bağlantı noktasında olmayan bir Firebird kendi adını alır:
IpcName = FIREBIRD_<port>. İkinci sunucuya yerel XNET bağlantıları çalışır. - Her ajan için bir konsolHQbird Monitor 20000 + Firebird bağlantı noktasında: 23050, 23055. Sunucudaki tüm örnekler için tek giriş dosyası.
- Bağlantı noktaları sabittirKonsolun ve ajan yerel API'sinin bağlantı noktaları kurulum sırasında yazılır. Firebird bağlantı noktasını sonradan değiştirirseniz aynı kalırlar. Ajan eşit bağlantı noktalarını kabul etmez.
- Küme: her ajan için bir yuvaSunucudaki her ajan 0'dan 9'a kadar kendi yuvasını alır: eşleştirme bağlantı noktası 7450 + yuva, düğüm bağlantı noktaları 7051 + yuva ve 7061 + yuva. Böylece bir sunucunun iki ajanı bir kümeye katılabilir.
--pairing-portanahtarı yuvayı açıkça belirler.
İmajlar · compose · bağlantı noktaları
Docker'da HQbird
Her Firebird sürümü için hazır bir imaj var. Firebird, ajan ve HQbird Monitor konteynerde çalışır. Ajan, sunucu bir kümeye katıldığında küme düğümünü konteynerin kendi içine kurar. RCM'yi yalnızca bu sunucu küme RCM'si olarak atandığında kurar.
| İmaj | Firebird | Firebird bağlantı noktası | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- İlk başlatmaKit içindeki
compose.yamldosyasını kopyalayın, SYSDBA parolasını bir gizli dosyaya koyun,secrets:satırlarındaki#işaretini kaldırın vedocker compose up -dkomutunu çalıştırın.docker compose pshealthygösterdiğinde sunucu hazırdır. - Firebird bağlantı noktası
HQBIRD_FB_PORTdeğişkeni, varsayılan olarak 3050. HQbird Monitor 20000 + bu bağlantı noktasını dinler. - İmaj imzasıİmajlar cosign aracıyla imzalanmıştır. Doğrulama için genel anahtar henüz yayımlanmamıştır.
- Tek ana makinede birkaç örnekFirebird 3050 + N'de, HQbird Monitor 20000 + Firebird bağlantı noktasında, küme düğümü 7051 + N'de. Ana makinede yalnızca bir örnek RCM'ye sahip olabilir.
- Dışarıda ve içeride aynı bağlantı noktası numarası
3051:3050değil,3051:3051yayımlayın. Ajan ve küme, konteyner içinde gördükleri bağlantı noktasını bildirir. - KümeÜye adresi, Docker ana makinesinin adresidir. Düğüm bağlantı noktasını ve RCM için 7443 ve 7444 bağlantı noktalarını yayımlayın.
Docker, bağlantı noktalarını ufw'nin ötesinde yayımlar. "Yalnızca 22 numaralı bağlantı noktası" şeklindeki bir ufw kuralı konteyner bağlantı noktalarını kapatmaz. Bağlantı noktasını tek bir ana makine adresinde yayımlayın veya harici bir güvenlik duvarıyla kapatın.
Bulut ve Docker: ayarlar, birimler, bağlantı noktaları, güncellemelerAjan · konsol · küme · Firebird
Kurulumdan sonraki güncellemeler
HQCenter'a bağlandıktan sonra ajan kendini, HQbird Monitor'ü, küme bileşenlerini, fbmcp'yi ve Firebird'i kendi başına günceller. HQCenter olmayan bir sunucu da kendini günceller: ajan yeni sürümleri IBSurgeon güncelleme sunucusundan alır.
Ajan kendisinin yeni bir sürümünü HQCenter'da bir dakika içinde görür. HQbird Monitor, fbmcp ve Firebird'ün yeni sürümleri: bir saat içinde. Her güncelleme tek bir kalıbı izler: denetle, bir geri alma noktası kaydet, değiştir, çalıştığından emin ol. Çalışmazsa eskisini geri yükle.
HQCenter olmadan güncellemeler
- Kendi kendine güncellenenlerAjan, HQbird Monitor ve MCP sunucusu. Denetim her 6 saatte bir çalışır.
- Firebird bir komut beklerFirebird paketi indirilir ve bekler. Yönetici onu uygular: Güncellemeler sayfasındaki düğmeyle veya
fbagent --firebird-update --applykomutuyla. - Modu siz seçersinizKurulum anahtarı
--auto-update all|agent|off, Windows'ta/AUTOUPDATE=all|agent|off. Varsayılanagent'tır.allFirebird'ü de güncelleme penceresinde kurar.offhiçbir şeyi denetlemez.
- HQbird Monitor'de Güncellemeler sayfasıAjanın sürümleri nereden aldığını, modu ve sunucunun son yanıtını, Firebird, konsol ve MCP sunucusu güncellemelerinin durumunu gösterir. Yönetici modu değiştirir ve Firebird paketini uygular.
- Kaynak denetimiGüncelleme sunucusu sabitlenmiş bir anahtarla denetlenir. Satıcı imzası her zaman gereklidir.
- Küme merkez üzerinden giderBir küme düğümü ve RCM bu şekilde güncellenmez: onları HQCenter veya RCM günceller.
Ajan kendi kendini güncelleme
- Yalnızca ileriAracı kendi sürümünden daha eski bir sürümü, zorunlu olsa bile yüklemez. Kontrol, ilk bayt indirilmeden önce çalışır. Böylece sahte bir sunucu eski ve savunmasız bir derlemeyi geri getiremez. İstisna, aracının kendi yapılandırmasında izin verilen bir eski sürümdür (
allow_downgrade_to). - İmzaSürümler bir Ed25519 anahtarıyla imzalanır; ortak anahtar aracının içine gömülüdür. Yanlış imza her zaman reddedilir. "Yalnızca imzalı" modu sunucudan değil, aracının kendi yapılandırmasından açılır.
- Elle geri almaAracının yanında bir
rollback_to_version_NNNbetiği vardır: önceki aracıyı ve yapılandırmayı geri yükler ve başarısız sürümü engeller. En son iki geri alma noktası saklanır; daha eskileri otomatik olarak silinir. - Linux: yalnızca root kendi kopyasını çalıştırırAracı
firebirdolarak çalışır. Değiştirme işlemi, yalnızca root'un yazabildiği bir klasördeki doğrulanmış bir kopya tarafından yapılır.
Firebird güncellemesi
Firebird yalnızca kendi hattı içinde ve yalnızca daha yeni bir derlemeye güncellenir. Aracı paketi istediği zaman indirip hazırlayabilir, ancak Firebird'ü yalnızca güncelleme penceresinde durdurur.
- 1Hazırlıkindirme, imza, derleme motordan eski değil
- 2Penceregünlük pencere; zorunlu bir sürüm de pencereyi bekler
- 3İşlergbak, nbackup veya bir SQL betiği çalışıyor: deneme ertelenir
- 4Değiştirmeeski motor dosyaları bir kenara alınır, yapılandırmalar kalır
- 5KontrolFirebird başlar ve portundan yanıt verir
- 6✓ veya geri almaeski dosyalar geri gelir, derleme engellenir
| Neyin güncellendiği | Koruma | Başarısız olursa |
|---|---|---|
| fbagent aracısı | İmza, yalnızca daha yeni, 180 sn içinde hazır ve 45 sn çalışma | Geri alma, 30 dakikalık duraklama; ikinci başarısızlık sürümü engeller |
| HQbird Monitor, küme, fbmcp | İmza, yalnızca yüklü olandan daha yeni | Önceki sürüm kalır; en son 2 kopya saklanır |
| Firebird | Pencere, yedeklemeleri bekleme, başlatma sonrası kontrol | Eski motor geri gelir, derleme engel listesine girer |
Engellenen bir sürüm tekrar yüklenmez, ancak sonraki sürüm her zamanki gibi yüklenir. Böylece sunucu "güncelle → geri al → güncelle" döngüsüne girmez.
Klasörler · günlükler · kaldırma
Dosyalar nerede ve nasıl kaldırılır
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, yapılandırmalar, güvenlik DB fbagent-fb50\ aracı ve HQbird Monitor agent_config.json aracı yapılandırması logs\ bak\ update\ günlükler, kopyalar, güncelleme önbelleği C:\HQbirdData\ aracı ve konsol çalışma verileri config\access.properties konsol girişi C:\ProgramData\fbagent\ kurulum sonucu ve günlüğü
Linux
/opt/firebird/ Firebird 5.0 (ikinci hat: /opt/fb50) /opt/hqbird/ conf/access.properties konsol girişi, 0600 fbagent-fb50/ aracı ve HQ Monitor agent_config.json aracı yapılandırması logs/ bak/ update/ günlükler, kopyalar, güncelleme önbelleği /var/lib/hqmonitor/ konsol verileri /var/log/fbagent/install.log kurulum günlüğü, parola yok
- Kaldırma veritabanlarınıza dokunmazVeritabanlarınız ve yedekleriniz (
*.fdb,*.gdb,*.fbk,*.nbk) her zaman kalır. Verilerin kaldırılması yalnızca güvenlik DB'sini ve Firebird paketindeki örnekleri siler. - Windows"Apps": aracıyı, konsolu, bu aracının RCM'sini, güvenlik duvarı kurallarını ve bu yükleyicinin yeni olarak yüklediği Firebird'ü kaldırır. Diğer aracılar bu aracının RCM'sini kullanıyorsa, sihirbaz "Bu örneği yine de kaldırsın mı?" diye sorar; sessiz kaldırma için
/FORCEgerekir. Güncellenmiş bir Firebird kalır. Yapılandırmalar ve güvenlik DB'si yalnızca "verileri kaldır" seçeneğini seçerseniz kaldırılır.
- Linux
--uninstallaracı ve konsol hizmetlerini, bu aracının RCM'sini, sudoers kurallarını ve yükleyicinin firewalld veya ufw içinde açtığı portları kaldırır. Aracı önce kümeden ayrılır. Diğer aracılar onun RCM'sini kullanıyorsa,--forceanahtarına ihtiyacınız olur. Firebird kalır.--remove-dataayrıca yapılandırmayı, günlükleri ve konsol verilerini kaldırır. - Eski HQbirdHQbird 2027'yi kaldırmak eski hizmetleri yeniden açmaz: yönetici buna durum dosyasını kullanarak karar verir.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2