انتقل إلى المحتوى

مجموعات بيانات ZFS

مجموعات بيانات ZFS عناصر في قائمة النسخ الاحتياطية، مثل الحاويات والـ VMs. العنصر هو مجموعة بيانات واحدة مع كل مجموعات البيانات التي تحتها. في كل نسخة احتياطية يلتقط BombVault لقطة ZFS واحدة للشجرة كلها، فتُلتقط كل مجموعة بيانات فيها في اللحظة نفسها. ثم يقرأ ملفات كل مجموعة بيانات من تلك اللقطة، ويخزنها باستخدام restic بالطريقة نفسها التي يخزن بها مجلدًا، ويزيل اللقطة مباشرة بعد ذلك. النسخ الاحتياطية خالية من التكرار، ويمكن تصفح كل واحدة منها، ويمكن استعادة ملفات منفردة.

لا ترسل النسخة الاحتياطية أبدًا بثًا إلى restic ولا تعيد أي مجموعة بيانات إلى حالة سابقة. يدمر BombVault فقط اللقطات التي أنشأها بنفسه. النسخة المتماثلة الاختيارية هي المكان الوحيد الذي يستخدم zfs send: تنسخ مجموعات البيانات إلى خادم ZFS ثانٍ ولا تمس النسخة الاحتياطية.

المتطلبات

  • اتصال SSH بهذا الخادم. تستخدم مجموعات بيانات ZFS المفتاح والمضيف والمستخدم أنفسهم الذين تستخدمهم نسخ VM الاحتياطية. إذا كانت نسخ VM تعمل بالفعل، فهذا يعمل أيضًا. وإلا فاتبع دليل النسخ الاحتياطي للأجهزة الافتراضية. أسماء حقول القالب هي Host SSH: Address وHost SSH: Port وHost SSH: User.
  • الأمر zfs على ذلك المضيف. يتوفر في Unraid 6.12 وما بعده وفي TrueNAS SCALE.
  • Host Data مربوط كـ /mnt مع Access Mode بقيمة Read/Write - Slave. هذه هي القيمة الافتراضية في القالب. لا تظهر لقطة مجموعة البيانات داخل مجلدها .zfs/snapshot إلا بعد أن يبدأ BombVault، لذا يجب أن تصل إلى الحاوية عمليات التركيب التي يجريها المضيف لاحقًا.
  • مجموعات البيانات مركّبة تحت /mnt. في Unraid توجد المجمعات في /mnt/<pool>، فهذا متحقق بالفعل.

يُفعَّل القسم من الإعدادات، عام (مجموعات بيانات ZFS). ثم يفتح اتصال ZFS بهذا الخادم تحت المزيد في صفحة النسخ الاحتياطية بطاقة الاتصال بهذا الخادم. تختبر البطاقة اتصال SSH، وتذكر المستخدم والمضيف اللذين تتصل بهما، وتقول ما الناقص عندما ينقص شيء. وعندما ينقطع الاتصال تقول قائمة النسخ الاحتياطية ذلك مع عرض الاتصال، وتعرض بطاقة تكامل المضيف في نظرة عامة النتيجة نفسها.

العناصر ومجموعات البيانات الفرعية

يُختار إضافة في صفحة النسخ الاحتياطية، ثم مجموعة بيانات ZFS. تأتي القائمة من الخادم. يُختار مجموعة البيانات الأعلى فيما يراد نسخه احتياطيًا، مثلًا cache/appdata، فيغطي العنصر هذه المجموعة وكل مجموعة بيانات تحتها.

  • تنضم مجموعات البيانات الفرعية الجديدة من تلقاء نفسها. مجموعة البيانات التي تُنشأ لاحقًا تحت العنصر تُنسخ في التشغيل التالي، ويذكرها ذلك التشغيل على أنها جديدة. تقرأها نسختها الأولى كاملة مرة واحدة. وبعد ذلك تُقرأ التغييرات فقط.
  • يمكن استبعاد مجموعات فرعية منفردة. يُوقف أي منها في تبويب الإعدادات للعنصر فيُستبعد مع كل ما تحته. المجموعة الفرعية المستبعدة التي لم تعد موجودة على الخادم تُعلَّم بذلك ويمكن إزالتها من القائمة.
  • المجموعات الفرعية التي لا يمكن قراءتها تُتخطى، ولكن ليس بصمت أبدًا. يعرضها التشغيل، ويبين العنصر عدد ما تُخطي منها، وتعد بطاقة غير منسوخ احتياطياً في نظرة عامة كل واحدة منها غير محمية. ومع ذلك ينسخ التشغيل كل ما عداها ولا يفشل بسبب مجموعة فرعية متخطاة. الأسباب موجودة في جدول رموز الأسباب: مجموعة بيانات غير مركّبة، أو لها canmount=off، أو نقطة تركيب legacy أو بلا نقطة تركيب، أو مفتاح تشفير غير محمّل، أو الوصول إلى اللقطات معطّل، أو نقطة تركيب لا يراها BombVault.
  • مجموعة البيانات المتخطاة لا تجر معها مجموعاتها الفرعية. مجموعة بيانات بقيمة canmount=off لا تحوي إلا مجموعات بيانات أخرى تُتخطى (وتظهر بوصف "بنية فقط")، وتُنسخ مجموعاتها الفرعية المركّبة. مجموعة البيانات المشفرة التي لم يُحمّل مفتاحها تُتخطى مع المجموعات الفرعية التي تشاركها المفتاح.
  • المجموعات الفرعية التي هي أقراص VM أو بيانات نظام تبدأ متوقفة في نافذة الإضافة، مع السبب بجانب المفتاح. وإضافة مجمع كامل تطلب تأكيدًا يعرض ما يحتويه.

وحدات التخزين

تحتوي وحدة التخزين (zvol) على قرص افتراضي بدلًا من ملفات، ولا ينسخها عنصر ZFS أبدًا.

  • وحدة التخزين التي تستخدمها VM تُنسخ مع تلك الـ VM.
  • وحدة التخزين التي لا تستخدمها أي VM (iSCSI extent، أو قرص فُصل) لا ينسخها BombVault. تعد نافذة الإضافة وصفحة النسخ الاحتياطية هذه الوحدات وتذكر ذلك. ستنسخها نسخة لاحقة.

وحدات التخزين داخل شجرة العنصر تُتخطى وتُذكر بأسمائها في كل تشغيل.

تخزين Docker

مع مشغّل تخزين ZFS في Docker، تكون كل طبقة صورة مجموعة بيانات بنقطة تركيب legacy. تجمعها نافذة الإضافة في سطر واحد لكل أصل. الشجرة التي تحوي أكثر من 20 مجموعة من هذا النوع لا يمكن أن تصبح عنصرًا: فطالما توجد لقطة لها، لا يستطيع Docker إزالة طبقات الصور. تُضاف بدلًا من ذلك مجموعات البيانات التي تحتها، مثلًا appdata.

العناصر لا تتداخل أبدًا

لا يمكن أن تنتمي مجموعة البيانات إلا إلى عنصر واحد. يرفض BombVault عنصرًا جديدًا يقع داخل عنصر موجود أو يحتوي عنصرًا موجودًا. لدمج عدة عناصر فرعية في عنصر أصل واحد، تُحذف العناصر الفرعية أولًا مع اختيار الاحتفاظ بنسخها الاحتياطية، ثم يُضاف الأصل. تحتفظ كل مجموعة بيانات بسجلها تحت اسمها، لذا تكمل النسخة التالية من حيث توقفت العناصر القديمة ولا تعيد قراءة كل شيء.

إيقاف الحاويات وتشغيل أوامر حول اللقطة

لقطة قاعدة بيانات قيد التشغيل تشبه انقطاعًا مفاجئًا للكهرباء: تتعافى قاعدة البيانات عادة، لكن عليها أن تفعل ذلك. يستطيع كل عنصر أن يفعل أمرين حيال ذلك، وكلاهما يغطي لحظة اللقطة فقط، لا النسخة الاحتياطية كلها.

  • إيقاف هذه الحاويات من أجل اللقطة. يوقف BombVault الحاويات المدرجة، ويلتقط اللقطة، ثم يشغّلها من جديد فورًا. تتوقف حاويات مستوى الاعتماد الواحد بالتوازي، والتابعة أولًا، فتستغرق النافذة كلها عادة بضع ثوانٍ. ويعرض التشغيل مدتها. ثم تقرأ النسخة الاحتياطية اللقطة المجمدة بينما تعمل التطبيقات من جديد. لا تُوقف إلا الحاويات التي كانت تعمل.
  • أمر قبل اللقطة وبعدها. يعمل داخل حاوية تختارها، مثلًا لتفريغ قاعدة بيانات داخل مجموعة البيانات قبل اللقطة مباشرة دون إيقاف أي شيء. إذا فشل الأمر الذي قبل اللقطة، تفشل النسخة الاحتياطية ولا تُلتقط لقطة. أما فشل الأمر الذي بعد اللقطة فيظهر في التشغيل لكنه لا يُفشل النسخة الاحتياطية.

ما الذي يحدث عندما يسوء شيء:

  • إذا تعذر إيقاف حاوية، يشغّل BombVault الحاويات التي أوقفها بالفعل، وتفشل النسخة الاحتياطية مع ذكر اسم الحاوية. ولا يلجأ أبدًا إلى لقطة لتطبيقات قيد التشغيل.
  • ينتظر الإيقاف حتى تنتهي نسخة حاوية جارية (حتى 30 دقيقة في التشغيل اليدوي، وحتى حد زمن النسخة الاحتياطية في التشغيل المجدول)، حتى لا يوقف الاثنان الحاوية نفسها أو يشغلانها في الوقت نفسه أبدًا.
  • قبل أن تتوقف الحاوية الأولى، يسجل BombVault الحاويات التي سيوقفها. إذا أُنهي BombVault داخل النافذة، يعيد تشغيل تلك الحاويات عند بدئه التالي، ويرسل إشعارًا، ويعرض العنصر ملاحظة حمراء لكل حاوية لم يستطع تشغيلها.

يعمل التفريغ التلقائي لقواعد البيانات مع النسخة الاحتياطية الخاصة بالحاوية، لا مع عنصر ZFS. قاعدة البيانات التي لا تُنسخ حاويتها إلا عبر مجموعة بياناتها لا تحصل على تفريغ، لذا يلزم إعطاؤها أمرًا هنا.

يمكن أن تكون الحاوية في هذه القائمة وأن تُنسخ كحاوية في الوقت نفسه. تُخزن بياناتها عندئذ مرتين، في مستودعين، وتوقفها النسخة الاحتياطية الكاملة مرتين. ويشير العنصر إلى ذلك.

الاستعادة

يُفتح العنصر ويُختار استعادة، أو يُختار من صفحة الاستعادة. تسأل نافذة الاستعادة عن النسخة الاحتياطية، ثم عن مجموعة البيانات. القيمة الافتراضية هي مجموعة البيانات العليا في العنصر. تحت ماذا يُستعاد كل شيء أو الملفات والمجلدات المختارة فقط. ويعرض إلى أين ما يلي:

  • الاستعادة داخل مجموعة البيانات. تُكتب ملفات النسخة الاحتياطية في نقطة تركيب مجموعة البيانات. تُستبدل الملفات التي تحمل الاسم نفسه، وتبقى الملفات الأخرى. لا تُعاد مجموعة البيانات أبدًا إلى حالة سابقة ولا تُستبدل. يتحقق BombVault من أن مجموعة البيانات مركّبة ومرئية وقابلة للكتابة، مرة قبل أن يبدأ ومرة أخرى قبل الكتابة مباشرة. حيث تكون مجموعة بيانات فرعية مركّبة بداخلها لا يُكتب شيء: تحتفظ المجموعة الفرعية بملفاتها ومالكها وأذوناتها، وتُستعاد من نسختها الاحتياطية الخاصة.
  • إلى مجلد. يُختار مجلد تحت /mnt. يتحقق BombVault من أن المجلد يقع على مجمع أو مشاركة مركّبة ومن وجود مساحة حرة كافية. يعمل هذا دون اتصال SSH ولمجموعات بيانات لم تعد موجودة.
  • إلى مجموعة بيانات جديدة. يُكتب اسم مجموعة بيانات غير موجودة بعد. تقترح النافذة <dataset>-restored. ينشئها BombVault بخصائص ZFS المحفوظة في النسخة الاحتياطية ويستعيد إليها، راجع الاستعادة كمجموعة بيانات جديدة.

اختيار كل مجموعات بيانات هذه النسخة مجموعةً للبيانات يكتب كل مجموعة بيانات في الشجرة إلى مجلد فرعي خاص بها في المجلد المختار. تُذكر مجموعات البيانات التي تُخطيت في تلك النسخة. وللاستعادة من مستودع BombVault آخر يُستخدم من مجلد نسخ احتياطية قديم في صفحة الاستعادة. وهي تستعيد دائمًا إلى مجلد: كل مجموعات بيانات نسخة واحدة، كل منها إلى مجلد فرعي خاص بها، أو مجموعة بيانات واحدة من الشجرة، كاملة أو ملفات مختارة.

تُعرض قائمة الحاويات المطلوب إيقافها في العنصر أيضًا عند الاستعادة داخل مجموعة البيانات. تبقى تلك الحاويات متوقفة طوال الاستعادة، وتنتظر نسخ الحاويات خلال ذلك.

لقطة الأمان

قبل أن يكتب في مجموعة بيانات، يلتقط BombVault لقطة ZFS لتلك المجموعة وحدها باسم bombvault-prerestore-<time>. الخيار حفظ لقطة ZFS للحالة الراهنة أولًا مفعّل افتراضيًا، وإيقافه يتطلب تأكيدًا ثانيًا. إذا تعذر التقاط اللقطة، لا يُستعاد شيء.

لا يحذف BombVault لقطة الأمان من تلقاء نفسه أبدًا. يعرضها العنصر مع عمرها وحجمها، ولكل منها إجراء حذف، وينبه عندما يزيد عمر أقدمها على 30 يومًا، لأنها تُبقي البيانات المحذوفة والمعدلة في المجمع.

للعودة بعد الاستعادة، تُنسخ ملفات منفردة من .zfs/snapshot/bombvault-prerestore-<time> داخل مجموعة البيانات. لا يعمل zfs rollback <dataset>@bombvault-prerestore-<time> إلا ما دامت هي أحدث لقطة لتلك المجموعة. ويحذف zfs rollback -r كل لقطة أحدث، بما فيها اللقطات التلقائية.

الاستعادة كمجموعة بيانات جديدة

يحفظ BombVault مع كل نسخة احتياطية خصائص ZFS المضبوطة محليًا لكل مجموعة بيانات: compression وrecordsize وquota وreservation وatime وxattr وacltype وcasesensitivity وخصائص المستخدم المخصصة. تُترك القيم الموروثة والقيم للقراءة فقط، لأنها تعود وحدها. النسخ التي سبقت حفظ BombVault لها لا تحتوي على أي منها.

  • إلى مجموعة بيانات جديدة يشغّل zfs create مع كل خاصية محفوظة. لا يمكن ضبط casesensitivity وnormalization وutf8only إلا بهذه الطريقة. أما الحصص والحجوزات فتُضبط بعد الملفات، حتى لا ترفض كتابتها. تُترك نقطة التركيب حتى لا تتعارض النسخة مع الأصل، وكذلك canmount وreadonly وإعدادات التشفير، حتى تتمكن الاستعادة من الكتابة. تأخذ مجموعة البيانات الجديدة الواقعة تحت مجموعة مشفّرة تشفيرها. يجب أن تكون مجموعة البيانات التي فوقها موجودة. إذا فشل شيء بعد الإنشاء، تبقى مجموعة البيانات الجديدة على الخادم، لأن BombVault لا يدمّر مجموعة بيانات أبدًا.
  • الاستعادة داخل مجموعة البيانات تعرض الخصائص المحفوظة بجانب الاستعادة. يضبط ضبط هذه الخصائص أيضًا ما لا تزال مجموعة البيانات الموجودة تقبله، قبل كتابة أي ملف. أما الحصص والحجوزات فتُضبط بعد الملفات، حتى لا ترفض كتابتها. بدون هذا المفتاح تحتفظ مجموعة البيانات بإعداداتها.

ما الذي تحتويه النسخة الاحتياطية

في النسخة الاحتياطية: ملفات ومجلدات كل مجموعة بيانات منسوخة، مع الملكية والأذونات والطوابع الزمنية والسمات الممتدة كما يخزنها restic، وخصائص ZFS المضبوطة محليًا لكل مجموعة بيانات.

ليس في النسخة الاحتياطية:

  • مالك وأذونات المجلد العلوي لكل مجموعة بيانات نفسه (كل ما تحته مشمول). الاستعادة داخل مجموعة البيانات تترك المجلد العلوي الموجود كما هو، والاستعادة إلى مجلد تنشئه بالأذونات 0755،
  • لقطات ZFS الموجودة،
  • المجموعات الفرعية التي تُخطيت أو استُبعدت،
  • وحدات التخزين.

للاستعادة إلى تجمع جديد، يُنشأ التجمع وتُستعاد كل مجموعة بيانات إلى مجموعة بيانات جديدة. لم يُتحقق بعد مما إذا كانت قوائم NFSv4 ACL، كما يستخدمها TrueNAS على مجموعات بيانات SMB، تعود كما هو متوقع، لذا يُنصح بتجربة استعادة على البيانات الفعلية قبل الاعتماد عليها.

مجموعات البيانات المشفرة

لا تُنسخ مجموعة البيانات المشفرة إلا ما دام مفتاحها محمّلًا. وإلا فتُتخطى مع تحذير. حمّل المفتاح بالأمر zfs load-key وتُركَّب مجموعة البيانات. يقرأ BombVault البيانات بعد فك تشفيرها ويخزنها في مستودع restic المشفر. إذا عُطِّل التشفير في BombVault، فذلك المستودع غير مشفر.

النسخة المتماثلة

النسخة المتماثلة هي نسخة من مجموعات بيانات عنصر على خادم ZFS ثانٍ. يبقيها BombVault محدّثة باستخدام zfs send وzfs receive. يرسل التشغيل الأول كل شيء، وبعد ذلك لا تنتقل إلا الكتل التي تغيرت. على الخادم الآخر يمكن تركيب النسخة فورًا.

لا تحل النسخة المتماثلة محل النسخة الاحتياطية أبدًا. تأتي الإصدارات الأقدم والملفات المفردة والفحص من النسخ الاحتياطية كما كان، وتحتفظ النسخة المتماثلة بعدد اللقطات الذي تحدده فقط. تُحتسب النسخة المتماثلة الحديثة نسخة خارج الموقع، لكن العنصر الذي له نسخة متماثلة وليست له نسخة احتياطية يبقى برتقاليًا.

يجعل النسخ المتماثل فقط، بدون نسخ احتياطي في بطاقة النسخة المتماثلة قسم ZFS كله يرسل نسخًا متماثلة ولا يأخذ نسخًا احتياطية. ويحتفظ المجلد الخاص ووجهات خارج الموقع بمفاتيحها، فإيقافه يعيد النسخ الاحتياطي إليها، وتعرض بطاقة كل عنصر ZFS مفتاح القسم كما هو. وينتظر مثل هذا العنصر أول نسخة متماثلة له بدل نسخة احتياطية، ويُعرض فيه نسخ احتياطي الآن باسم النسخ الآن، وتتوقف حاوياته وتعمل أوامره حول اللقطة كما في النسخ الاحتياطي. وتُحتسب نسخه المتماثلة لجدول كل بضعة أيام ولتنبيه التأخر وللتغطية.

يُفعَّل ذلك في بطاقة النسخة المتماثلة ضمن تبويب الإعدادات للعنصر. تسرد البطاقة كل مجموعة بيانات وكل وحدة تخزين مع حالتها، ويبدأ النسخ الآن تشغيلًا. للتشغيل المتماثل قفل خاص به، فلا يعطل النقل الأول الطويل النسخ الاحتياطية أبدًا.

الحقل ما الذي يضبطه
تُنسخ إلى الهدف: خادم ZFS (يوسَم عبر SSH) أو مثيل مقترن. إضافة خادم ZFS تعدّ واحدًا جديدًا.
متى بعد كل نسخة احتياطية، أي بعد تشغيل نسخ العنصر، أو خطة خاصة.
الاحتفاظ على الهدف كم لقطة تبقى على خادم ZFS: قصير أو متوازن أو طويل أو قيم مخصصة. المثيل المقترن يقرر هذا بنفسه.
الاحتفاظ على هذا الخادم كم من أحدث لقطات النسخة المتماثلة تبقى على هذا الخادم أيضًا. القيمة 0 أو 1 تُبقي الأحدث فقط.
النسخ المتماثل فقط، بدون نسخ احتياطي يرسل قسم ZFS كله نسخًا متماثلة ولا يأخذ نسخًا احتياطية.

بطاقة النسخة المتماثلة لعنصر ZFS. بطاقة النسخة المتماثلة لعنصر ZFS.

يقف نسخ الكل الآن بجانب إجراءات النسخ الاحتياطي حين تُختار بلاطة ZFS في صفحة النسخ الاحتياطية، ويرسل النسخة المتماثلة لكل عنصر ZFS واحدًا تلو الآخر. ويشغّل الخادم الدفعة، فتستمر حين تغادر الصفحة، والعنصر الذي لا يمكنه النسخ المتماثل يُسمّى ويُتخطّى.

الدفع إلى خادم ZFS

يمكن لأي جهاز فيه ZFS وSSH أن يستقبل، مثل Unraid ثانٍ أو TrueNAS. لا يلزم أن يعمل BombVault هناك.

  1. تحت الإعدادات، الاقتران يُختار الاتصال عبر SSH في خادم ZFS بدون BombVault، أو إضافة خادم ZFS في بطاقة النسخة المتماثلة للعنصر.
  2. إدخال العنوان والمستخدم والمنفذ. يعرض مربع الحوار المفتاح العام لـ BombVault. يُضاف إلى ~/.ssh/authorized_keys الخاص بالمستخدم على الخادم. في Unraid يوجد ذلك ضمن Users, root, SSH keys. بحسب Display Settings يظهر Users في قائمة الرأس أو ضمن Settings. وعلى TrueNAS يُحرَّر المستخدم تحت Credentials, Users. هذا هو مفتاح النسخ المتماثل. وهو يختلف عن مفتاح رابط SSH الخاص بالأجهزة الافتراضية والمضيف، لذا أضفه حتى لو كان ذلك المفتاح مصرحًا به بالفعل.
  3. اختبار الاتصال. يسرد مربع الحوار بعدها مجمعات الخادم. يُختار واحد ويُحدَّد الجذر، وقيمته الافتراضية <pool>/bombvault-replica.
  4. يُختار الخادم الجديد في بطاقة النسخة المتماثلة الخاصة بالعنصر. يصبح للخادم عندئذ بطاقة خاصة به في صفحة المثيلات، ويقود فتح إلى صفحته.

مع root لا يلزم شيء آخر. يحتاج المستخدم المخصص إلى هذه الأذونات على مجمع الهدف، وهي أيضًا ما يعرضه مربع الحوار:

zfs allow <user> receive,create,mount,rollback,destroy,userprop,readonly,canmount <pool>

على المصدر يحتاج المستخدم من النوع نفسه إلى هذه الأذونات على مجموعة البيانات العليا في العنصر:

zfs allow <user> send,snapshot,hold,release,bookmark,destroy,mount <dataset>

في هذا الاتجاه يحمل BombVault الذي يضم العنصر أيضًا مفتاحًا يستطيع الكتابة على الخادم.

يحفظ BombVault مفتاح المضيف الذي يعرضه الخادم عند أول اتصال، ويرفض لاحقًا أي مفتاح مختلف. إذا أُعيد تثبيت الخادم، يُضغط Forget host key في صفحة الخادم، وسيحفظ الاتصال التالي المفتاح الجديد.

حين يستطيع مضيف هذا الخادم الوصول إلى خادم ZFS بنفسه، يمرّر zfs send مباشرة إلى ssh الخاص به نحو الخادم، بمفتاح النسخ المتماثل ومفتاح المضيف المحفوظ، فلا يمر التدفق عبر BombVault. وإلا فإن التدفق يمر عبر BombVault.

الإرسال إلى مثيل مقترن

يستطيع BombVault مقترن أن يستقبل النسخة المتماثلة بنفسه. لا يحصل أحد على وصول SSH إلى المضيف الآخر، ولا يوضع أي مفتاح في ملف authorized_keys.

  1. في بطاقة النسخة المتماثلة الخاصة بالعنصر يُختار المثيل المقترن هدفًا، أو يُفعَّل دور خادم ZFS في بطاقة ذلك المثيل في صفحة المثيلات وتُختار عناصر ZFS هناك. تعرض البطاقة في انتظار الموافقة إلى أن يرد.
  2. على المثيل المستقبِل تُفتح المثيلات. يظهر الطلب على بطاقة المثيل المرسِل كشارة، وتسرده التفاصيل. يُختار المجمع والجذر على ذلك الخادم وعدد اللقطات التي تبقى، ثم يُضغط سماح أو رفض.
  3. بعد السماح يرسل المصدر وفق جدوله الخاص، كما لأي هدف آخر.

لا يقبل المثيل المستقبِل إلا ما تغطيه الموافقة: مجموعات بيانات العنصر، داخل جذره الخاص. وهو ينفّذ zfs receive بنفسه، ولا يملك المصدر أي وسيلة لحذف شيء هناك أو التراجع عنه. فتنجو النسخة حتى لو استولى أحد على المصدر. يحتفظ المثيل المستقبِل بسياسة الاحتفاظ الخاصة به، ولا يقترح المصدر إلا قاعدة عند إرسال الطلب. ومع ذلك يستطيع مصدر كهذا إرسال لقطات جديدة، ومع الوقت تُخرج هذه اللقطات الأقدم وفق القاعدة مثل أي لقطات أخرى. واللقطة التي يحمل اسمها تاريخًا يسبق ساعة المثيل المستقبِل لا تُحتسب في القاعدة حتى يحين ذلك الوقت.

يُنهي إلغاء الوصول على المثيل المستقبِل الموافقة في أي وقت ويُعلم المصدر، فيعرض أن الموافقة سُحبت ويتوقف. ما يملكه المثيل المستقبِل فعلًا يبقى عنده. الطلب المرفوض يبقى مرفوضًا. وتتطلب مجموعات البيانات الإضافية، أو أي طلب بعد السحب، طلبًا جديدًا.

يجب أن يجيب المثيل المستقبِل عبر HTTPS. لا يرسل المصدر شيئًا إلى عنوان http عادي، لأن الرمز والبيانات كانت ستعبر الشبكة دون تشفير. وتترك كل عملية نقل أيضًا عُشر المجمع المستقبِل فارغًا وتتوقف قبل أن تمسّه، فلا يستطيع مصدر واحد أن يملأ مجمع الخادم المستقبِل.

أين تستقر البيانات

تستقر كل مجموعة بيانات في <root>/<server>/<pool>/<path>. مجلد الخادم هو اسم مثيل المصدر، ويُثبت عند النقل الأول، فلا يتعارض خادمان لهما اسم المجمع نفسه أبدًا. مثلًا يستقر cache/appdata من خادم اسمه tower في backup/bombvault-replica/tower/cache/appdata.

بعد إعادة إعداد BombVault، يرفض الهدف المجلد الذي ملأه BombVault هذا من قبل. وتعرض بطاقة النسخة المتماثلة عندئذ تولَّ المجلد، وتواصل النسخة المتماثلة التالية من النسخ الموجودة فيه. لا يُتولّى المجلد إلا إذا لم يعد أي BombVault آخر ينسخ إليه.

النسخة على الهدف للقراءة فقط. وهي افتراضيًا غير مركّبة، فلا تغطي أي شيء على ذلك الخادم أبدًا. لخادم ZFS المتصل عبر SSH مفتاح تركيب للقراءة فقط على الخادم في صفحته: حين يكون مفعّلًا يركّب BombVault النسخ هناك للقراءة فقط بعد كل تشغيل، فتستطيع قراءة ملفاتها ونسخها على الهدف. النسخ المشفرة تبقى مقفلة إلى أن يُحمَّل مفتاحها، وإيقاف المفتاح لا يفك تركيب شيء. المثيل المقترن الذي يستقبل النسخة المتماثلة يُبقيها غير مركّبة. تنتقل خصائص ZFS معها، ما عدا نقطة التركيب وsharenfs وsharesmb. وتبقى الحجوزات reservation وrefreservation أيضًا، فلا تشغل النسخة إلا المساحة التي تحتاجها بياناتها.

ما الذي يدخل

يدخل كل ما ينسخه العنصر احتياطيًا، ويدخل معه ما تحته من وحدات التخزين التي تتخطاها النسخة الاحتياطية. تبقى خارجًا مجموعة البيانات الفرعية التي عطلتها في العنصر. تأتي كل مجموعات بيانات التشغيل الواحد من لقطة واحدة، كما في النسخة الاحتياطية.

النسخة التي ينسخها BombVault آخر نسخًا متماثلًا إلى هذا الخادم لا تُرسل أبعد من ذلك، لأن ذلك سيُرقّق التاريخ الذي ما زال مصدرها يحتاج إليه. وحين تحتوي شجرة العنصر على نسخة كهذه، يفشل التشغيل لمجموعة البيانات تلك ويذكر السبب، إلى أن تعطّلها في العنصر. والعنصر الذي هو نفسه نسخة كهذه لا يستطيع النسخ المتماثل إطلاقًا. وحذف العنصر أو إيقاف نسخته المتماثلة يترك تلك النسخ ولقطاتها كما هي. وبمجرد أن تتولى نسخة كهذه، كما هو موضّح في استخدام النسخة المتماثلة، تُعدّ مجموعة بيانات عادية.

كم تبقى اللقطات

على الهدف تحتفظ النسخة المتماثلة الجديدة بـ 7 لقطات يومية و3 أسبوعية. ويمكن بدلًا من ذلك اختيار قصير أو متوازن أو طويل، أو تحديد قيم مخصصة. والقيم المخصصة التي كلها أصفار تحتفظ بكل لقطة، وتقول البطاقة ذلك. لا تُزال هناك إلا اللقطات المسماة bombvault-replica-<14 digits>، ولا تُزال أبدًا الأحدث التي يشترك فيها الجانبان.

على المصدر يحتفظ BombVault بآخر لقطة نسخة متماثلة، مع إشارة مرجعية لكل حالة أرسلها. لا تكلّف الإشارات المرجعية مساحة. يبدأ النقل التالي منها.

للاحتفاظ بالمزيد على المصدر أيضًا، يُضبط الاحتفاظ على هذا الخادم في بطاقة النسخة المتماثلة، مثلًا على 7. عندئذ يبقى هذا العدد من أحدث لقطات النسخة المتماثلة على هذا الخادم بعد كل نسخة متماثلة، إلى جانب ما يحتفظ به الهدف. القيمة 0 أو 1 تحتفظ بالأخيرة فقط. تحمل الأخيرة علامة hold، حتى لا تُحذف قاعدة النقل التالي عن طريق الخطأ. أما الأقدم فلا تحملها. تتمسك كل لقطة بالكتل التي تغيرت بعدها، لذا تشغل كل لقطة تحتفظ بها مساحة في المجمع. وإيقاف النسخة المتماثلة أو تحويلها إلى هدف آخر، أو حذف العنصر، يزيلها من هذا الخادم أيضًا. أما لقطات عنصر آخر متداخل تحته فتبقى. وإن تعذّر الوصول إلى المضيف أثناء حذف العنصر، تبقى اللقطات أيضًا وتقول الصفحة ذلك. تُزال حينئذ يدويًا: zfs release -r bombvault-replica <dataset>@<snapshot>، ثم zfs destroy.

يمكن قراءة ملفات اللقطة المحتفَظ بها أو نسخها فورًا، من المجلد .zfs/snapshot داخل مجموعة البيانات أو من استنساخ، دون المساس بمجموعة البيانات أو بالنسخة المتماثلة:

ls /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261006014100
zfs clone cache/appdata@bombvault-replica-20261006014100 cache/appdata-20261006

لا يأخذ الاستنساخ مساحة حتى يتغير فيه شيء. ويُحذف بعد الانتهاء بـ zfs destroy cache/appdata-20261006، لأن اللقطة التي لها استنساخ لا يمكن إزالتها.

للعودة إلى آخر لقطة نسخة متماثلة يكفي هنا zfs rollback cache/appdata@<latest>، ولا يلزم شيء على الهدف. أما إعادة مجموعة البيانات كلها إلى لقطة أقدم فتحذف كل لقطة بعدها، على هذا الخادم وعلى الهدف. تحمل الأخيرة علامة hold، لذا تُرفع عنها أولًا، ثم تُعاد مجموعة البيانات هنا:

zfs release -r bombvault-replica cache/appdata@bombvault-replica-20261008014200
zfs rollback -r cache/appdata@bombvault-replica-20261006014100

يجب أن تُعاد النسخة على الهدف أيضًا، لكن ليس دائمًا إلى اللقطة نفسها، إذ ربما أزالتها سياسة الاحتفاظ الخاصة بالهدف. تُشغَّل النسخة المتماثلة مرة واحدة. وهي تتوقف عند مجموعة البيانات هذه لأن الهدف يحمل لقطات أحدث، وتذكر بطاقة النسخة المتماثلة وسجل التشغيل اللقطة التي يُعاد إليها الهدف: أحدث لقطة لا يزال الجانبان يشتركان فيها. تُعاد النسخة إليها على خادم ZFS، أو على مضيف المثيل المقترن الذي يستقبل النسخة المتماثلة، مثلًا:

zfs rollback -r backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261005014000

يعمل zfs rollback على مجموعة بيانات واحدة، لذا تُكرَّر عمليات الإعادة لكل مجموعة بيانات فرعية تريد استرجاعها أيضًا. بعد ذلك يواصل النسخ الآن من اللقطة المشتركة.

مجموعات البيانات المشفرة في نسخة متماثلة

تُرسل مجموعة البيانات المشفرة خامًا. تبقى مشفرة على الهدف، ولا يرى الهدف المفتاح أبدًا. يُحفظ المفتاح جيدًا: فهو لازم لفتح النسخة بعد الاستعادة، والنسخة المتماثلة بدونه غير قابلة للقراءة.

استخدام النسخة المتماثلة

يُفتح تبويب النسخ الاحتياطية في العنصر ويُنقر صف نسخة ZFS متماثلة بين الأماكن التي تحتفظ بلقطاته. تسرد الورقة اللقطات على الهدف وتعرض الأوامر بالأسماء الحقيقية.

لإلقاء نظرة على حالة قديمة، تُستنسخ لقطة على الهدف. لا يأخذ الاستنساخ مساحة حتى يتغير شيء، وتبقى النسخة المتماثلة دون مساس:

zfs clone backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261006014100 backup/bombvault-replica/clone-appdata

إذا تعطل المصدر، تُحوَّل النسخة على الهدف إلى مجموعة بيانات عادية قابلة للكتابة:

zfs inherit -r readonly backup/bombvault-replica/tower/cache/appdata && zfs list -rH -o name -t filesystem backup/bombvault-replica/tower/cache/appdata | xargs zfs set canmount=on && zfs mount -a

يتوقف BombVault بعد ذلك عن النسخ المتماثل إلى مجموعة البيانات هذه وإلى مجموعاتها الفرعية. يفشل التشغيل التالي مع سبب، ويبقى ما كتبته. والأمر نفسه ينطبق على أي شيء آخر كُتب في النسخة منذ أحدث لقطة لها: لا يعيد BombVault نسخةً إلى الوراء أبدًا. وللنسخ المتماثل إلى هناك من جديد، يُنقل ما تحتاج إليه من النسخة، ثم تُدمَّر النسخة على الهدف. يرسل التشغيل التالي حينئذ كل شيء من جديد.

لإعادة حالة إلى المصدر يُضغط استعادة كمجموعة بيانات جديدة في الورقة. يرسل BombVault اللقطة إلى مجموعة بيانات جديدة بجانب الأصلية، اسمها <dataset>-bombvault-restore- متبوعًا بختم زمني. لا يكتب أبدًا فوق الأصلية. وتعود أيضًا مجموعة البيانات الفرعية التي فُقدت على المصدر، ما دامت النسخة لا تزال تحمل تلك اللقطة. أما المجموعة الفرعية التي لا تحملها فتُترك، ويقول التشغيل ذلك.

مثال: نسخة متماثلة إلى جهاز Unraid ثانٍ

يأخذ الخادم tower نسخًا احتياطية لمجموعة البيانات cache/appdata كعنصر ZFS. جهاز Unraid ثانٍ على 192.168.1.20، بلا BombVault، لديه مجمّع اسمه backup ويجب أن يحمل نسخة تستطيع قراءتها في أي وقت.

  1. افتح النسخ الاحتياطية ثم cache/appdata ثم علامة التبويب الإعدادات. في بطاقة النسخة المتماثلة اختر إضافة خادم ZFS تحت تُنسخ إلى.
  2. أدخل 192.168.1.20 والمستخدم root والمنفذ 22. تعرض النافذة مفتاح النسخة المتماثلة. على الجهاز الثاني الصقه تحت Users, root, SSH keys واضغط Apply. هذا المفتاح يختلف عن مفتاح Host SSH، فأضفه حتى لو كان ذاك موجودًا.
  3. اختبر الاتصال. اختر المجمّع backup وأبقِ الجذر الذي يقترحه، backup/bombvault-replica.
  4. عند العودة إلى البطاقة يكون الخادم الجديد مختارًا تحت تُنسخ إلى. اترك متى على بعد كل نسخة احتياطية، واترك الاحتفاظ على الهدف على لقطاته السبع اليومية والثلاث الأسبوعية، واضبط الاحتفاظ على هذا الخادم على 7.
  5. اضغط النسخ الآن. يرسل التشغيل الأول كل شيء، فتستغرق 300 GB عبر خط 1 Gbit/s أربعين دقيقة على الأقل. تقول البطاقة وقائمة النسخ الاحتياطية جارٍ النسخ المتماثل، ثم نُسخ متماثلًا مع الوقت. التشغيلات اللاحقة ترسل الكتل التي تغيّرت فقط.

تقع مجموعات البيانات الآن في backup/bombvault-replica/tower/cache/appdata على الجهاز الثاني، للقراءة فقط. في اللوحة العامة تحتسب خارج الموقع في قسم ZFS النسخة المتماثلة نسخة خارج المبنى.

للحصول على ملف واحد من الثلاثاء الماضي لديك ثلاث طرق:

  • على هذا الخادم، لأن الاحتفاظ على هذا الخادم يحمل سبع لقطات:

    cp /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261103014100/plex/Preferences.xml /mnt/user/restore/
    
  • على الجهاز الثاني، باستنساخ لقطة على الهدف. تعرض علامة التبويب النسخ الاحتياطية للعنصر الأوامر بأسمائك الحقيقية حين تنقر الصف نسخة ZFS المتماثلة. أزل الاستنساخ بـ zfs destroy حين تنتهي.

  • بتركيب، بتفعيل تركيب للقراءة فقط على الخادم في صفحة خادم ZFS. بعد التشغيل التالي تقف النسخ مركّبة وللقراءة فقط على الجهاز الثاني.

الإصدارات الأقدم مما تحتفظ به النسخة المتماثلة تأتي من النسخ الاحتياطية كما يبيّن المثال التالي.

مثال: ملف واحد من نسخة ZFS الاحتياطية

  1. افتح الاستعادة واختر بلاطة ZFS وانقر cache/appdata.
  2. اختر النسخة، وتحت مجموعة البيانات اختر مجموعة البيانات التي تحمل الملف.
  3. تحت ماذا اختر ملفات فردية وعلّم الملف.
  4. تحت إلى أين اختر إلى مجلد واختر مجلدًا تحت /mnt، مثل user/restore. لا يحتاج هذا إلى رابط SSH ويعمل أيضًا لمجموعة بيانات لم تعد موجودة.
  5. اضغط استعادة. يقع الملف مباشرة في ذلك المجلد، دون المسار الذي فوقه.

اللقطات المتبقية

اسم لقطة النسخة الاحتياطية هو <dataset>@bombvault-<14 digits>، مثلًا cache/appdata@bombvault-20260924021500 (UTC). يزيلها BombVault بعد النسخة الاحتياطية مباشرة. إذا فشل ذلك، مثلًا لأن مجموعة البيانات مشغولة أو لأن BombVault أُوقف، فإن BombVault يزيلها:

  • قبل النسخة الاحتياطية التالية لذلك العنصر،
  • عند بدء BombVault، لكل عنصر، حتى مع إيقاف القسم،
  • عندما تحذف العنصر،
  • عند الضغط على الإزالة الآن في العنصر، الذي يعرض أيضًا عدد المتبقي.

لا تُزال إلا الأسماء التي تطابق تمامًا bombvault- يليها 14 رقمًا. لا تُمس أبدًا لقطات الأمان ولا اللقطات الخاصة بالمستخدم ولا اللقطات التلقائية. لإزالة واحدة يدويًا:

zfs destroy -r cache/appdata@bombvault-20260924021500

تُسمى لقطة النسخة المتماثلة <dataset>@bombvault-replica-<14 digits> وليست لقطة متبقية. تبقى على المصدر حتى يستبدلها تشغيل أحدث للنسخة المتماثلة، أو ما دام الاحتفاظ على هذا الخادم يبقيها، وعلى الهدف ما دام الاحتفاظ يبقيها. لا تمسها أداة التنظيف أبدًا، لأنها لا تطابق إلا bombvault- يليها 14 رقمًا بالضبط.

الحالات الشاذة

المجموعة الفرعية التي أُفرغت بالكاد تغير مجموع شجرة كبيرة، لذا يراقب كشف الحالات الشاذة كل مجموعة بيانات في العنصر على حدة: للحجم وعدد الملفات والبيانات الجديدة ووقت restic سجل خاص بكل منها. ينتمي هذا السجل إلى اسم مجموعة البيانات، لذا يبقى عندما ينسخ عنصر آخر الشجرة لاحقًا.

مجموعة البيانات التي نسخها التشغيل السابق ولم يستطع هذا التشغيل قراءتها تُعد مُفرغة، ما دام تحديد العنصر لم يتغير. يشمل ذلك مفتاحًا غير محمّل، ومجموعة بيانات غير مركّبة، ومجموعة اختفت من الشجرة. المجموعة الفرعية التي تُستبعد يدويًا تغير التحديد، لذا يبدأ سجلها من جديد. وما دامت ملاحظة عن بيانات مفقودة مفتوحة، تحتفظ سياسة الاستبقاء بالنسخ القديمة لتلك المجموعة وحدها وتنظف بقية الشجرة كالمعتاد.

لكل مجموعة بيانات سطر خاص بها في مراقبة العنصر، التي تُفتح من المراقبة في صفحة الحالات الشاذة وتوجد في تبويب تحقق للعنصر. تظهر الملاحظات المفتوحة بجانب كل مجموعة بيانات. يفتح الرابط في الملاحظة نافذة الاستعادة على آخر نسخة سليمة لمجموعة البيانات. أما ما إذا كان التشغيل يكتمل فيُحكم عليه للعنصر كله، لأن التشغيل ينجح أو يفشل ككل.

الفحوص نفسها موصوفة في الحالات الشاذة. يستطيع مساعد متصل عبر خادم MCP أن يعرض نقاط الاستعادة لعنصر ZFS ويبدأ نسخته الاحتياطية ويقرأ الملاحظات، لكن الإقرار بالملاحظة يتم في صفحة الحالات الشاذة.

رموز الأسباب

تذكر صفحة العنصر وسجل التشغيل والإشعارات المشكلة بأحد هذه الرموز. ولمعظمها يظهر الحل بجانبها في الصفحة أيضًا.

الرمز المعنى ما العمل
ssh-missing اتصال SSH غير مُعد في هذه الحاوية. يُعدّ اتصال SSH كما لنسخ VM الاحتياطية.
host-placeholder ما زال Host SSH: Address هو القيمة المثال، ولم يستجب host.docker.internal أيضًا. يُضبط Host SSH: Address على عنوان IP المحلي لهذا الخادم.
host-fallback ما زال Host SSH: Address هو القيمة المثال، وhost.docker.internal يعمل. لا شيء، أو ضبط عنوان IP المحلي.
ssh-unreachable لا يمكن الوصول إلى الخادم عبر SSH. يُتحقق من العنوان والمنفذ ومن أن SSH مفعّل.
ssh-auth رفض الخادم مفتاح BombVault. يُشغَّل مرة واحدة على الخادم الأمر المعروض تحت الاتصال بهذا الخادم.
zfs-not-found لا يوجد الأمر zfs على مضيف SSH. يُوجَّه Host SSH: Address إلى الجهاز الذي يملك المجمعات.
zfs-permission لا يُسمح لمستخدم SSH بتشغيل أمر zfs هذا. يُستخدم root، أو يُنظر TrueNAS SCALE.
uri-mismatch يحدد LIBVIRT_URI مضيفًا أو مستخدمًا غير الذي في حقول SSH. وفّق بينهما، أو أفرغ حقول SSH ليأتي الاثنان من الـ URI.
zfs-error أبلغ zfs عن خطأ آخر. تعرض التفاصيل رسالته.
propagation-missing عمليات التركيب الجديدة على المضيف لا تصل إلى الحاوية. يُضبط Access Mode لـ Host Data على Read/Write - Slave ويُعاد تشغيل BombVault.
invalid-name اسم مجموعة بيانات لا يقبله BombVault. تُعاد تسمية مجموعة البيانات.
name-too-long مجموعة بيانات في الشجرة أطول من أن تصلح اسمًا للقطة. تُعاد تسميتها، أو تُضاف مجموعة بيانات تحتها كعنصر.
invalid-exclude نمط استبعاد أو مجموعة فرعية مستبعدة لا يناسب العنصر. يُصحَّح الإدخال الذي تذكره الرسالة. لاستبعاد مجموعة فرعية كاملة، تُوقف بدلًا من كتابة نمط.
not-found مجموعة البيانات غير موجودة على الخادم. يُزال العنصر، أو يُعاد إنشاء مجموعة البيانات. تبقى نسخها الاحتياطية قابلة للاستعادة.
not-filesystem هذه وحدة تخزين، لا نظام ملفات. يُنظر وحدات التخزين.
overlaps-item تتداخل مجموعة البيانات مع عنصر موجود. يُنظر العناصر لا تتداخل أبداً.
docker-storage تحتوي الشجرة على تخزين صور Docker. يُنظر تخزين Docker.
nothing-readable لا يمكن قراءة أي مجموعة بيانات في العنصر حاليًا. يُنظر في رموز مجموعات البيانات المتخطاة.
snapshot-failed تعذر إنشاء اللقطة. تعرض التفاصيل رسالة zfs.
containers-busy كانت نسخة حاوية ما زالت تعمل حين كان على الحاويات أن تتوقف. يُبدأ من جديد لاحقًا. التشغيلات المجدولة تنتظر من تلقاء نفسها.
consistency-stop-failed تعذر إيقاف حاوية، لذا لم تُلتقط لقطة. يُتحقق من الحاوية، أو تُزال من القائمة.
pre-snapshot-failed فشل الأمر الذي قبل اللقطة. تعرض تفاصيل التشغيل مخرجاته.
container-unknown حاوية مدرجة غير موجودة. تُزال من القائمة.
container-is-self لا يستطيع BombVault إيقاف حاويته الخاصة. تُزال من القائمة.
leftover-snapshots ما زالت على الخادم لقطات لم يستطع BombVault إزالتها. يُضغط الإزالة الآن، ويُنظر اللقطات المتبقية.
zvol وحدة تخزين في الشجرة، تم تخطيها. يُنظر وحدات التخزين.
canmount-off لا تُركّب أبدًا (canmount=off)، تم تخطيها. إذا كانت تحوي بيانات، تُركَّب أو تُنقل البيانات إلى مجموعة فرعية.
legacy-mount نقطة تركيب legacy، تم تخطيها. أعطها نقطة تركيب تحت /mnt.
no-mountpoint بلا نقطة تركيب، تم تخطيها. أعطها نقطة تركيب تحت /mnt.
not-mounted غير مركّبة على الخادم، تم تخطيها. تُركَّب بالأمر zfs mount، أو يُضبط canmount=on.
key-not-loaded مشفرة والمفتاح غير محمّل، تم تخطيها. zfs load-key، ثم ركّبها.
snapdir-disabled الوصول إلى اللقطات معطّل، تم تخطيها. zfs set snapdir=hidden <dataset>. يبقى المجلد .zfs مخفيًا.
not-visible لا يرى BombVault نقطة تركيب مجموعة البيانات. تُنقل نقطة التركيب تحت مسار Host Data، أو تُربط داخل الحاوية على المسار نفسه مع Read/Write - Slave.
shfs-only لا تظهر مجموعة البيانات إلا عبر /mnt/user، الذي يخفي اللقطات. يُربط /mnt، لا /mnt/user، كـ Host Data.
snapshot-not-visible أُنشئت اللقطة لكنها لم تظهر داخل BombVault. يُشغَّل اختبار الوصول إلى اللقطات. راجع أدناه.
snapshot-loop لم تصل اللقطة إلى BombVault لأن Host Data لا يمرر عمليات التركيب الجديدة. يُضبط Access Mode لـ Host Data على Read/Write - Slave ويُعاد تشغيل BombVault.
backup-failed فشل restic لهذه المجموعة. تعرض تفاصيل التشغيل السبب.
not-reached انتهى التشغيل قبل هذه المجموعة. تُشغَّل النسخة الاحتياطية مرة أخرى.
gone لم تعد مجموعة البيانات على الخادم. لا شيء. تبقى نسخها الاحتياطية قابلة للاستعادة.
read-only-mount لا يستطيع BombVault إلا قراءة مجموعة البيانات، لذا لا يمكنه الاستعادة داخلها. يُضبط الربط على Read/Write - Slave، أو تُجرى الاستعادة إلى مجلد.
destination-not-mounted المجلد ليس على مجمع أو مشاركة مركّبة. يُختار مجلد على مجمع أو مشاركة.
not-enough-space لا توجد مساحة حرة كافية في الوجهة. تُحرَّر مساحة أو يُختار مجلد آخر.
safety-snapshot-failed تعذر التقاط لقطة الأمان، لذا لم يُستعد شيء. تعرض التفاصيل رسالة zfs.
safety-name-too-long اسم مجموعة البيانات أطول من أن يصلح للقطة أمان. تُوقف لقطة الأمان، أو تُجرى الاستعادة إلى مجلد.
dataset-exists توجد مجموعة بيانات بهذا الاسم بالفعل. يُختار اسم جديد، أو تُجرى الاستعادة إلى مجموعة البيانات نفسها.
create-failed تعذّر إنشاء مجموعة البيانات الجديدة. تعرض التفاصيل رسالة zfs. يُتحقق من وجود مجموعة البيانات التي فوقها.
new-dataset-not-visible أُنشئت مجموعة البيانات الجديدة، لكن BombVault لا يراها، لذلك لم تُستعد أي بيانات. تبقى مجموعة البيانات على الخادم. تُركَّب تحت مسار Host Data وتُجرى الاستعادة إليها.
set-properties-failed تعذّر ضبط الخصائص المحفوظة، لذلك لم تُستعد أي بيانات. تعرض التفاصيل رسالة zfs.
set-limits-failed استُعيدت الملفات، لكن تعذّر ضبط الحصة أو الحجز المحفوظ. تعرض التفاصيل رسالة zfs. تُضبط الحصة أو الحجز يدويًا باستخدام zfs set.

التحقق مما تراه الحاوية

يلتقط اختبار الوصول إلى اللقطات في تبويب الإعدادات للعنصر لقطة حقيقية لشجرته، ويبحث عنها داخل BombVault لكل مجموعة بيانات، ثم يزيلها من جديد. إنها أسرع طريقة لإثبات المسار كله قبل أول تشغيل مجدول.

للنظر يدويًا، يُشغَّل هذا على الخادم:

docker exec BombVault grep zfs /proc/self/mountinfo

كل سطر هو عملية تركيب واحدة داخل الحاوية. يعرض سطر مجموعة البيانات مسارها داخل الحاوية (تحت /host/user) واسم مجموعة البيانات. وجود حقل master:N في ذلك السطر يعني أن عملية التركيب تستقبل عمليات التركيب التي يجريها المضيف لاحقًا، وهذا ما يحتاجه الوصول إلى اللقطات. إذا كان مفقودًا، يُضبط Access Mode لـ Host Data على Read/Write - Slave ويُعاد تشغيل BombVault.

TrueNAS SCALE

  • عندما يكون LIBVIRT_URI مضبوطًا (كما لنسخ VM الاحتياطية على TrueNAS)، يأخذ BombVault من الـ URI مضيف SSH والمستخدم والمنفذ لأوامر zfs، كلًا منها لم يُضبط وحده. من دون نسخ VM الاحتياطية لا حاجة إلى ضبط أي شيء: host.docker.internal لا يُحَلّ في تطبيق TrueNAS، لذا يصل BombVault إلى المضيف عبر البوابة الافتراضية للتطبيق، بصفة root على المنفذ 22. تُضبط LIBVIRT_HOST وLIBVIRT_SSH_USER وLIBVIRT_SSH_PORT في environment الخاص بالتطبيق عند الحاجة إلى عنوان أو مستخدم آخر.
  • يُضاف مفتاح SSH المضيف من الإعدادات، التكاملات، SSH المضيف إلى root تحت Credentials, Users، وتُفعَّل خدمة SSH تحت System, Services. وتحتاج النسخة المتماثلة إلى هذا الـ TrueNAS أو إلى TrueNAS آخر مفتاحَ النسخ المتماثل أيضًا، وهو مفتاح مختلف.
  • يحتاج مستخدم غير root إلى إذن على مجموعة البيانات العليا في العنصر، يشمل عندئذ كل مجموعة بيانات تحتها:
zfs allow <user> snapshot,destroy,mount <dataset>

تحتاج الاستعادة إلى مجموعة بيانات جديدة أيضًا إلى صلاحية create على مجموعة البيانات التي فوقها، ويحتاج ضبط الخصائص المحفوظة إلى صلاحية على تلك الخصائص.

جلسة SSH بغير root على TrueNAS لا تحتوي /usr/sbin في مسارها. فيستدعي BombVault عندئذ /usr/sbin/zfs مباشرة. - يجب أن يكون Host Data للتطبيق مسار مضيف فوق مجموعات البيانات، مثلًا /mnt/tank، لا ixVolume. مع مسار مضيف، يمرر التطبيق عمليات تركيب المضيف الجديدة إلى BombVault (rslave)، وهذا ما يحتاجه الوصول إلى اللقطات. يُنظر TrueNAS SCALE لإعداد التطبيق كاملًا.