HQbird Yedeklemeleri
Yedekler Firebird
Zamanlanmış gbak ve nbackup, tek bir veritabanı için veya bir klasördeki tüm veritabanları için. gbak için her yedekten sonra test geri yüklemeyi açabilirsiniz. Bir veritabanı yedekten otomatik olarak güncellenir ve süreç ortasında oluşan hiçbir hata onu bilinmeyen bir durumda bırakmaz.
- 6 yedekleme işi türü
- nbackup seviyeleri 0…4
- zip · gz · zstd arşiv kontrolüyle
- S3 ara dosya olmadan
- test geri yükleme
İki araç
gbak veya nbackup
HQbird her iki Firebird yedekleme türünü de destekler ve ikisini de tek bir veritabanı için kullanabilirsiniz. gbak mantıksal bir kopya oluşturur: veritabanından daha küçüktür ve geri yükleme onu kontrol eder. nbackup veritabanı sayfalarını kopyalar: hızlıdır ve artımlı yedekler az yer kaplar.
| gbak (doğrulanmış yedek) | nbackup (artımlı) | |
|---|---|---|
| Neyi kopyalar | Veri ve meta veri. Çöp ve eski kayıt sürümleri kopyaya girmez. | Veritabanı dosyasının sayfaları. Seviye 0 tamdır; 1…N seviyeleri yalnızca değişen sayfaları içerir. |
| Boyut | Genellikle veritabanından çok daha küçüktür; iyi sıkışır. | Seviye 0 veritabanı boyutundadır; artımlı yedekler küçüktür. |
| Geri yükleme | Yeni bir veritabanı oluşturur ve indeksleri yeniden kurar. Büyük veritabanları için bu uzun sürer. | Seviye zincirini birleştirir. Hızlıdır. |
| Kontrol | İşte açıksa her yedekten sonra test geri yükleme. | GUID ile zincir kontrolü. Seviye 0 yoksa — ajan hemen oluşturur. |
| Şunun için kullanın | Güvenilir bir kopya, sürümler ve sunucular arasında taşıma, Yedek-Geri Yükle-Değiştir. | Sunucuya yük bindirmeden gün içinde sık geri yükleme noktaları. |
Bir veritabanının gbak ve nbackup işlemleri aynı dakikada başlamak zorundaysa, gbak 15 dakika sonraya kayar. nbackup veritabanını kullanırken gbak bekler (varsayılan olarak 60 dakikaya kadar) ve başarısız olmaz.
İş türleri
Tekil ve grup işleri
Tekil bir iş tek bir veritabanını kapsar ve kendi ayarlarına sahiptir. Ana şirket veritabanı için bunu kullanın: kendi zamanlaması, kendi klasörü, kendi saklama süresi.
Grup işi veritabanlarını içeren klasörleri kapsar. Grubun tüm veritabanları için tek bir ayar seti. Her döngüde ajan klasörleri maskelere göre yeniden tarar, böylece yeni bir veritabanı ayarlarda değişiklik yapılmadan otomatik olarak yedeğe dahil olur.
| Tek veritabanı | Klasörlerdeki tüm veritabanları | |
|---|---|---|
| Kontrollü gbak | vbackup | grpvbackup |
| Seviyeli nbackup | nbackup | grpnbackup |
| nbackup dökümü | nbackup_dump | grpnbackup_dump |
Grup işinin aldığı ve atladığı şeyler
Ajan klasörleri dolaşır ve her dosyayı dahil etme ve hariç tutma maskelerine göre kontrol eder. İsteğe bağlı olarak minimum boyutu ve dosyanın başlangıcını da kontrol eder. Yedek dosyaları (.fbk, .nbk, .delta, arşivler) asla yedeğe girmez.
Kendi tekil işi olan bir veritabanı, o iş kapalı olsa bile gruptan otomatik olarak hariç tutulur. Bir gbak grubu, tekil gbak işlerinin veritabanlarını almaz. Bir nbackup grubu, nbackup ve döküm işlerinin veritabanlarını almaz.
Sistem veritabanları (security ve examples ile başlayan adlar) her zaman atlanır. Tarama önizlemesi her atlama için nedeni gösterir.
D:\data\ · maske *.fdb
- sales.fdbgrupta
- stock.fdbgrupta
- branch_new.fdb
yeni veritabanı: seviye 0 ile başlargrupta - erp.fdb
kendi tekil işi varatla - security5.fdb
sistem veritabanıatla - bck_sales_20261107.fbk
yedek dosyasıatla - orders.fdb.delta
nbackup delta dosyasıatla
- Klasörden kaldırılan veritabanı“Sahipsiz” hale gelir. Yedekleri bir kurala göre tutulur: N gün veya her zaman. Ya da hemen
_orphanedklasörüne taşınır ve 7 gün sonra silinir. - Yeniden adlandırılan veritabanıYeni ad, seviye 0'dan yeni bir zincir başlatır. Eski yedekler sahipsiz veritabanları için geçerli kurala göre tutulur.
- Tekrarlanan hatalarÜst üste 5 hatadan sonra veritabanı 6 saat duraklatılır ve sonra yeniden denenir.
- Bir veritabanındaki hata grubu durdurmazGrup bir sonraki veritabanıyla devam eder. Bu, “Hatalardan sonra sonraki veritabanlarıyla devam et” ayarıdır; gbak, nbackup, döküm ve sweep grupları için varsayılan olarak açıktır.
- İş satırındaki grup sonucu“N veritabanı bulundu · M başarılı · X hata · toplam süre”. Ayrıntılarda hatalı veritabanlarının tablosu vardır: ad, yol ve hata metninin başlangıcı.
- Zaman bütçesiSüre dolduğunda bir döngü yeni veritabanları başlatmaz. nbackup grupları için bir sonraki döngüde bir sonraki veritabanından devam etmeyi açabilirsiniz.
- ParalellikGrubun kaç veritabanının aynı anda işleneceği. Sunucudaki uzun görevler için ortak bir sınır: varsayılan olarak aynı anda en fazla iki tanesi çalışır.
- Veritabanı başına tek işlemTekil ve grup işleri, gbak ve nbackup birbirlerinin kilitlerini görür.
- Kaynakla aynı klasör ağacı“Kaynak klasör ağacını yinele” onay kutusu:
x/y/EMPLOYEE.FDBveritabanının yedeği<yedek klasörü>/x/y/EMPLOYEE.FDB/konumuna gider. Farklı klasörlerdeki aynı adlı veritabanları birbirine engel olmaz.
vbackup · grpvbackup
gbak: kontrollü yedekleme
Her adımdan önce ajan boş alanı kontrol eder: yedek için, test geri yükleme için, arşiv için. Geri yükleme için yeterli alan yoksa ajan onu no_space nedeniyle atlar ve yedek kalır. gbak geçici bir dosyaya yazar. Dosya .fbk adını yalnızca boyut ve gbak günlüğü doğruysa alır. Böylece klasörde normal adlı eksik bir yedek asla görünmez.
- 1Alan kontrolüyedek için; geri yükleme ve sıkıştırmadan önce tekrar
- 2gbakgeçici bir
.gbaktmpdosyasına; Firebird 5'te — N çekirdekte - 3Kontrolboyut ve günlük; sonra
.fbkadı - 4Test geri yüklemeaçıksa; ayrı bir dosya, üretim veritabanı değil
- 5Sıkıştırmaarşiv açılır ve SHA-256 ile karşılaştırılır
- 6✓ Depolamabaşka bir klasöre kopyala; eski kopyalar silinir
- Açık adlar
bck_sales_20261107_02-00.fbk: veritabanı adının başlangıcı ve saat. Bir klasördeki iki veritabanı aynı adları yazmaz. - Çakışma uyarısıİki iş aynı ad başlangıcıyla bir klasöre dosya yazarsa, ajan ve düzenleyici bir uyarı gösterir.
- Test geri yükleme sonucuok, failed, nedeniyle atlandı veya not_run. Bunu son iş sonucunda ve envanterde görürsünüz. Düzenleyicide her geri yükleme iki komutu gösterir: yedekleme ve geri yükleme.
- Eski test veritabanıYeni bir iş test geri yüklemeyi
-repile başlatır: gbak önceki çalıştırmadan kalan kopyanın üzerine yazar. Ajan önce bu kopyanın istemcilerinin bağlantısını keser. Test veritabanı yolu üretim veritabanıyla veya başka bir işin veritabanıyla aynıysa geri yükleme atlanır. - gbak günlükleri ve komutlarıSon hata satırları konsolda görünür; günlüğü indirebilirsiniz. Günlükler, yedekleriyle birlikte silinir. Aracı, çalıştırılan komutların geçmişini tutar: her iş adımı için en fazla 50, parolalar gizli.
- Kontrolü bozan anahtarlar
-Ygbak çıktısını bir dosyaya yönlendirir, ancak aracı yedeği bu çıktı üzerinden kontrol eder. Bu nedenle-Ykullanılamaz. Akış işi, geri yükleme satırında-SEseçeneğini de kabul etmez. Düzenleyici bu anahtarları işaretler. - Zaman aşımlarıYumuşak: bir uyarı. Sert: gbak durdurulur.
- Adıma göre gbak süresiAracı, her yedekleme ve geri yüklemeye
-ST TDRWanahtarını kendisi ekler ve gbak süresini çıktıdan alır. İş seçeneklerinde kendi-STanahtarınıza gerek yoktur: düzenleyici bunu kabul etmez. - Oturum açmayı aracı ayarlar
-user,-password,-fetch_passwordve-trustedanahtarları seçeneklerde kullanılamaz. Test geri yüklemesi, veritabanı sahibi veritabanı erişim ayarlarında kayıtlıysa sahip olarak çalışır. Geri yükleme satırı, hangi kullanıcı adıyla çalıştığını gösterir. - Anlaşılır mesajlarAlan ve süre, tanıdık birimlerle: “8.1 GiB boş, 11.8 GiB gerekli”, “60 sn sonra zaman aşımına uğradı”.
nbackup · grpnbackup
nbackup: seviyeler ve geri yükleme noktaları
Seviye 0, veritabanının tamamını kopyalar. Seviye 1, son seviye 0'dan sonra değişen sayfaları kopyalar. Seviye 2, son seviye 1'den sonraki değişiklikleri kopyalar. Veritabanını ihtiyaç duyduğunuz ana geri yüklemek için üç dosya yeterlidir.
Örnek zamanlama: haftada bir kez seviye 0, her gece seviye 1, günde dört kez seviye 2. Bu, haftada 36 geri yükleme noktası verir: 1 + 7 + 28. Seviye 0'dan 5, seviye 1'den 7 ve seviye 2'den 24 kopya tutar.
- Boşluksuz zincirSeviye 0 yoksa — aracı hemen oluşturur. Diğer seviyeler için bu, “Eksik alt seviyeleri hemen oluştur” ayarıdır. Bu ayar olmadan, alt seviye eksikken çalıştırma atlanır.
- GUID ile kontrolHer seviye kendi alt seviyesine bağlıdır; yabancı bir dosya zincire girmez.
- Üç zamanlama moduBasit — günlere ve saatlere göre. Gelişmiş — her seviye için cron, seviye 4'e kadar. Plan — seviye, günler ve saat içeren kurallar.
- nbackup dumpSeviye zincirinin dışında, kendi zamanlamasıyla veritabanı dosyasının tam kopyası.
- Veritabanı delta durumundaKesintiye uğramış bir nbackup sonrasında veritabanı kilitli kalırsa, aracı deltayı birleştirmeyi dener.
Plan modu
Plan, bir dizi kuraldır: seviye, günler ve saat. Günler her gün, haftanın günleri veya ayın günleri olabilir. Aynı dakikada iki kural eşleşirse, daha düşük seviye çalışır. Plan, son seviye 0 belirlenen gün sayısından daha eskiyse kendi başına bir seviye 0 oluşturabilir. Artışlar veritabanı boyutunun belirlenen bir payının üzerine çıktığında, daha düşük bir seviyeyi planlanandan önce çalıştırır. Grup işinde, her veritabanı kendi seviye zincirini oluşturur.
Düzenleyici, planı birkaç hafta ilerisi için bir takvimde gösterir: hangi seviye ne zaman çalışır. Tek bir düğme, basit veya gelişmiş bir zamanlamayı plana dönüştürür ve kaydetmeden önce bunu geri alabilirsiniz.
- Döngülere göre saklamaBir döngü, bir seviye 0 ve tüm artışlarıdır. Aracı bir döngünün tamamını tutar veya siler: döngü sayısına, günlere veya toplam boyuta göre. En yeni tam döngü asla silinmez. Düzenleyici, yedeklerin ne kadar yer kaplayacağını önceden gösterir.
- Plan durumuHer seviyenin son kopyası, kullanılan alan ve bir sonraki temizliğin neyi sileceği. Aracı, durumu her plan çalıştırmasından sonra günceller.
Sıkıştırma · S3 · depolama
Yedeklerin saklandığı yer
Bir yedek doğrudan S3'e gidebilir: gbak veya nbackup bir akışa yazar ve akış bucket'a gider. Sunucu diskinde ara dosya oluşmaz, bu nedenle sunucuda yedek için alana ihtiyacınız olmaz.
zip, gz veya zstd sıkıştırması hem yerel hem de akış yedekleri için çalışır. Yerel bir yedek için aracı, tamamlanmış arşivi açar ve boyut ile SHA-256 üzerinden kaynakla karşılaştırır. Ancak bundan sonra kaynak dosya silinir. Kontrol başarısız olursa hiçbir şey silinmez.
- Sayıya göre saklamagbak: kaç dosya tutulacağı. nbackup: her seviyeden kaç kopya tutulacağı.
- Diğer yerlere kopyalarİkinci bir klasöre veya ağ yoluna kopya. S3, FTP veya FTPS'e yükleme — ayrı bir file_sync işiyle.
- Yedeklemeden sonra kendi betiğinizgbak için. Yedeğe, test veritabanına ve gbak günlüklerine giden yolları alır.
- Arşiv şifrelemeBir gbak işi, zip arşivini (AES-256) aracı anahtarlarından bir parolayla, diskte ve S3 akışında şifreleyebilir. 7-Zip arşivi açar. Bir geri yükleme doğru anahtarı kendisi bulur.
- Arşivden geri yüklemeFormat, dosya içeriğinden algılanır; yerel olarak ve S3'ten.
- S3'ten geri yüklemeBir geri yükleme işi yedeği doğrudan bucket'tan okur.
- AntivirüsYedekleme ve geri yükleme klasörlerini gerçek zamanlı taramadan hariç tutun.
- Sıkıştırmayı siz seçersinizYeni bir iş sıkıştırma olmadan oluşturulur. Format listesinde ilk sırada zstd yer alır. Herhangi bir formattaki arşiv için kendi dosya uzantınızı ayarlayabilirsiniz.
- Amazon S3 kılavuzuBucket, anahtarlar ve işin adım adım kurulumu. İngilizce ve Portekizce olarak mevcuttur.
Amazon S3 · uyumlu depolama
S3'e yedekler
Aracı, yedekleri Amazon S3'teki veya uyumlu depolamadaki bir bucket'a gönderir. Bu, gbak ve nbackup işleri için çalışır. Bunun için başka bir programa ihtiyacınız yoktur.
Kurulum üç bölümden oluşur: bir bucket ve erişim anahtarı hazırlayın, aracı ayarlarında bir s3 hedefi oluşturun, yedekleme işinde yüklemeyi açın. Her iş iki moddan birini kullanır.
| Dosya kopyası | S3'e akış | |
|---|---|---|
| Sunucu diskinde dosya | Evet. Yedek diske yazılır, ardından gönderilir. | Hayır. Yedek doğrudan bucket'a gider. |
| Yedek için disk alanı | Gerekli. | Gerekli değil. |
| Nereye | S3, FTP, FTPS | Yalnızca S3 |
| Bucket'taki eski kopyaların silinmesi | Hayır. Bir bucket yaşam döngüsü kuralı kullanın. | Evet, işin saklama kuralına göre. |
| Yükleme hatası | Yerel yedek geçerli kalır. | Yedek yok: bucket'ta hiçbir nesne kalmaz. |
- Nasıl seçilirDosya kopyası: hem yerel bir kopyaya hem de S3'te bir kopyaya ihtiyaç duyduğunuzda. Akış: sunucu diski küçükse veya S3 yedekler için tek yerse.
- S3'ten geri yüklemeBir geri yükleme işi, akışla gönderilmiş bir yedeği doğrudan bucket'tan okur: en yeni nesneyi veya adını verdiğinizi. Aracı, her nesnenin boyutunu ve SHA-256'sını kontrol eder.
- ŞifrelemeBucket şifrelemesi, nesneyi depolama tarafında korur. İşteki arşiv şifrelemesi, dosyayı sunucudan ayrılmadan önce bir parolayla korur.
- BucketGenel erişimi engellenmiş tutun. Tamamlanmamış çok parçalı yüklemeleri bir gün sonra silen bir kural ekleyin.
- Yalnızca yedekler için bir anahtarAyrı bir kullanıcı oluşturun. Ona yalnızca ihtiyaç duyduğu hakları verin: nesneleri yazma, okuma ve silme, bir yüklemeyi iptal etme ve bucket'ın tamamlanmamış yüklemelerini listeleme. Bucket bir KMS anahtarıyla şifrelenmişse, bu anahtar üzerinde de haklara ihtiyacı vardır. Bir Amazon EC2 sunucusunda anahtar olmadan çalışabilirsiniz: aracı sunucunun IAM rolünü kullanır.
- Kontrolİşi Şimdi çalıştır düğmesiyle başlatın, sonuca bakın ve yedeğe güvenmeden önce bir test geri yüklemesi yapın.
Yaygın hatalar
| Hata | Neden | Ne yapmalı |
|---|---|---|
AccessDenied | Bir hak eksik veya haklardaki yol farklı. | Kullanıcı haklarını kontrol edin. |
SignatureDoesNotMatch | Yanlış anahtar veya değerinde boşluklar var. | Anahtarı yeniden kopyalayın. |
PermanentRedirect | Ayarlardaki bölge, bucket bölgesiyle eşleşmiyor. | Bölgeyi düzeltin. |
NoSuchBucket | Yanlış bucket adı. | Adı düzeltin. |
RequestTimeTooSkewed | Sunucu saati yanlış. | Saati NTP ile eşitleyin. |
restore.replace_cycle
Yedekle-Geri Yükle-Değiştir
Döngü, üretim veritabanını yeniden oluşturur. Aracı bir gbak yedeği alır, onu yeni bir dosyaya geri yükler ve yeni dosyayı eskisinin yerine koyar. Yeni veritabanında çöp yoktur, dizinleri yenidir ve genellikle çok daha küçüktür. Üretim veritabanının bağlantısı kesilir ve güvenli bir şekilde yeniden adlandırılır: aracı önce onu shutdown full durumuna alır, tüm bağlantılar kapanır ve ancak bundan sonra dosya yeni bir ad alır.
Varsayılan olarak döngü Cumartesi günü saat 02:00'de çalışır; zamanlamayı değiştirebilirsiniz. Şimdi çalıştır döngüyü hemen başlatır, ancak önce veritabanı dosya adını yazmanızı ister. Veritabanı bir yol ile veya databases.conf içindeki bir takma ad ile belirtilebilir.
İstemciler
Diskteki dosyalar
Kapatmadan değiştirmeye kadar istemciler "veritabanı bulunamadı" veya "veritabanı kapatıldı" alır. Döngüyü, veritabanının bir yedekleme artı bir geri yükleme süresince kullanılamayabileceği bir zamana planlayın. Boru modunda yedekleme ve geri yükleme aynı anda çalışır ve hiçbir yedek dosyası yazılmaz.
Döngü şu durumlarda başlamaz
- işte "Değiştirmeye izin ver" (allow_replace) açık değilse;
- veritabanı kapatma durumundaysa, şifrelenmişse veya bir replikaysa;
- veritabanı bir güvenlik veritabanıysa, kendisinin veya diğer veritabanlarının;
- yanında tamamlanmamış bir döngünün dosyaları varsa;
- yeterli disk alanı yoksa.
Alan önceden hesaplanır: yedek dosyası ve geri yüklenen kopya aynı anda diskte bulunur, her biri yaklaşık veritabanı boyutundadır. Orijinal kopyalanmaz, yeniden adlandırılır, bu yüzden yer kaplamaz. Alan azsa döngü kapatmadan önce durur: veritabanına dokunulmaz ve istemciler çalışmaya devam eder.
Diskte ne kalır
Orijinaller. Kapatma tam modundaki son orijinaller veritabanının yanında tutulur, 1 ile 10 arasında, varsayılan olarak 1. Fazlalar bir sonraki döngünün başında silinir, böylece veritabanının son döngüden önceki durumu her zaman oradadır.
Yedek dosyası değiştirmeden sonra silinir. Geri yükleme başarısız olduysa dosya analiz için .restore-failed.fbk olarak tutulur.
Orijinale geri dönmek için: üretim veritabanını durdurun, dosyaları yeniden adlandırın ve orijinal için gfix -online çalıştırın.
Döngü kesintiye uğradığında
Birisi aracıyı durdurabilir, sunucu yeniden başlayabilir, elektrik kesilebilir. Değiştirmeden önce normal bir servis durdurmasında aracı gbak'ın bitmesine izin verir ve döngüyü geri alır. Bir arıza durumu için aracı her adımdan önce ne yaptığını bir niyet dosyasına yazar. Başlangıçta ve ardından her dakika aracı bu dosyaları okur ve döngüyü bilinen bir duruma getirir.
Veritabanı çevrimiçi duruma döner
Aracı veritabanını çevrimiçi yapar ve kapatma gecikmesini geri yükler.
Geri alma
Ara kopya ve tamamlanmamış yedek silinir, orijinal eski adını alır ve çevrimiçi olur.
Tamamlama
Yeni veritabanı üretimde kalır, orijinal kapatma durumunda tutulur. "Sonra" betiği çalışmadı: önemliyse kendiniz çalıştırın.
Diskteki dosyalar bilinen hiçbir durumla eşleşmiyorsa aracı hiçbir şeyi değiştirmez ve iş sonucu "operatör gerekli" ile başlar. Niyet dosyası tüm döngü dosyalarının adlarını listeler. Doğru veritabanını yoluna koyun, aracı kurtarmayı kendisi tamamlar.
Öncesi ve sonrası için kendi betikleriniz
"Yedeklemeden önce" betiği kapatmadan önce çalışır. Bir hatayla biterse döngü durur ve veritabanına dokunulmaz. "Geri yüklemeden sonra" betiği değiştirmeden sonra çalışır. Örnek: aracı silmeden önce yedek dosyasını bir arşive kopyalayın.
| Değişken | Yedeklemeden önce | Geri yüklemeden sonra |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | iş kimliği | |
FBAGENT_DB_NAME | işteki ad: takma ad veya yol | |
FBAGENT_DB_PATH | veritabanı dosyası: orijinal, çevrimiçi | aynı yol: yeni veritabanı, çevrimiçi |
FBAGENT_ORIG_PATH | boş | orijinalin yolu |
FBAGENT_FBK_PATH | gelecekteki yedek dosyası; boru modunda boş | yedek dosyası, betikten sonra silinir; boru modunda boş |
Envanter · sağlık raporu
Kontrol: hangi veritabanının yedeği yok
Envanter sunucudaki tüm yedek dosyalarını, diğer programlar tarafından yapılanlar dahil gösterir. Aracı bunu her yedeklemeden sonra ve tam olarak her 2 saatte bir günceller. Yanında geri yüklemelerin tablosu vardır: test ve üretim, 14 gün boyunca.
Her yedeğin bir Doğrulandı sütunu vardır: test geri yüklemesi geçti, başarısız oldu veya çalışmadı. Yanında geri yüklenen veritabanının boyutu ve gbak süresi bulunur. Geri yükleme tablosu veritabanı boyutunu ve süreyi gösterir.
Sunucu sağlık raporu, kayıtlı yedeği olmayan bir veritabanını işaretler ve nedenini söyler: iş başarısız oldu, hâlâ çalışıyor, ertelendi veya klasörlerde dosya yok. Bulgunun yanındaki bir düğme hemen yeni bir iş için formu açar.