الفصل 4قاعدة البيانات والخدمات
هذا الفصل لفنيّ الدعم ومسؤول الحاسوب في المختبر. ويبيّن:
- ما يعمل على الخادم بعد التنصيب: قاعدة البيانات، والبرنامج، والمهام المجدولة.
- كيف يبدأ البرنامج، وكيف يُوقَف ويُعاد تشغيله دون أن يُصاب شيء.
- كيف تُفحص صحة قاعدة البيانات، وما يُفعل إن لم تعمل.
4.1 ما يعمل على الخادم
| الاسم في Windows | النوع | ما هو | متى يبدأ |
|---|---|---|---|
ClarusPrimePostgres | خدمة Windows | قاعدة البيانات PostgreSQL | مع تشغيل الحاسوب، تلقائيًا |
Server في مجلد المهام \Clarus\Clarus_prime\ | مهمة مجدولة مخفية | البرنامج نفسه | عند كل تسجيل دخول إلى Windows |
Updater في المجلد نفسه | مهمة مجدولة | مُنصِّب التحديثات | بعد تشغيل الحاسوب بدقيقة، وحين يطلبها البرنامج |
Support في المجلد نفسه | مهمة مجدولة | منفّذ أعمال الدعم عن بُعد | حين يطلبها البرنامج |
وعلى الحاسوب العضو تحل المهمة Member محل Server، ولا قاعدة بيانات عليه. والأسماء كلها في الملحق ج: أسماء الخدمات.
4.2 قاعدة البيانات
يحمل برنامج التثبيت معه PostgreSQL 18، وينشئ له مجموعة بيانات خاصة بالمختبر:
| البند | القيمة |
|---|---|
| المنفذ | 5439، فإن كان مشغولًا أخذ برنامج التثبيت أول منفذ حر بعده |
| من يصل إليها | هذا الحاسوب وحده (العنوان 127.0.0.1)، فلا تصل إليها الشبكة أبدًا |
| اسم قاعدة البيانات | clarus_lis |
| حساب البرنامج فيها | clarus_lis |
| الحساب المسؤول عنها | postgres |
| الدخول | بكلمة سر مشفّرة (SCRAM-SHA-256)، حتى من الحاسوب نفسه |
| الترميز | UTF-8 |
| مجلد البيانات | pgdata داخل مجلد بيانات البرنامج: D:\Clarus\Clarus_prime\data\pgdata أو C:\ProgramData\Clarus\Clarus_prime\data\pgdata |
| السجل | postgresql.log في مجلد السجلات، ويُبدَّل كل 20 MB |
ويضبط برنامج التثبيت ذاكرة قاعدة البيانات على قدر ذاكرة الحاسوب: ثُمن الذاكرة للتخزين المؤقت، بين 128 MB و1 GB.
4.2.1 كلمات السر
يولّد برنامج التثبيت كلمتي سر عشوائيتين: واحدة للحساب المسؤول، وواحدة لحساب البرنامج. ويحفظهما في الملف cluster-superuser.json في مجلد البيانات. ولا يقرأ هذا الملف إلا المسؤولون وحساب النظام (SYSTEM).
ويحفظ البرنامج عنوان اتصاله بقاعدة البيانات، ومعه كلمة سر حسابه، في ملف إعداده clarus-lis.config.json في مجلد البرنامج.
4.2.2 إن كان المختبر مُنصَّبًا بلا صلاحية مسؤول
إذا نُصّب البرنامج لمستخدم واحد بلا صلاحية مسؤول (انظر 2.10 التنصيب بلا صلاحية المسؤول)، فلا تُسجَّل قاعدة البيانات خدمةً. وتحل محلها مهمة عند تسجيل الدخول اسمها ClarusPrime PostgreSQL، تبدأ قاعدة البيانات حين يدخل ذلك المستخدم وحده. فبعد إعادة تشغيل الحاسوب لا يعمل شيء حتى يدخل.
4.3 كيف يبدأ البرنامج
يبدأ البرنامج بلا نافذة عند كل تسجيل دخول إلى Windows، بالمهمة Server. وهذا مقصود: فبعد إعادة تشغيل ليلية لتحديث Windows، تبدأ أجهزة التحليل يومها قبل أن يفتح أحد البرنامج، فيجب أن يكون يسمعها.
وعند البدء يجري هذا بالترتيب:
- يتأكد أن قاعدة البيانات تعمل. فإن كانت خدمتها متوقفة شغّلها، وانتظر حتى تجيب، مدة أقصاها دقيقتان.
- إن لم تُجب، حاول إصلاحها بإعادة تشغيل إعداد قاعدة البيانات، مدة أقصاها ثلاث دقائق.
- إن بقيت لا تجيب، توقف وكتب رسالة تسمّي ملفي السجل
postgresql.logوpostgresql-startup.log، وأمر الإصلاح الذي يُشغَّل باليد. - يجهّز المختبر: وأثناء ذلك تجيب صفحات البرنامج بأنه يُجهَّز، وتطلب المحاولة بعد ثوانٍ.
- يعمل، ومعه المحطة التي تطبع وتصل أجهزة التحليل (انظر الفصل 7: الطابعات).
ولا تبدأ نسختان من البرنامج معًا. فإن دخل مستخدم ثانٍ إلى Windows والبرنامج يعمل، لم يبدأ مرة أخرى. واختصار البرنامج على سطح المكتب يفتح نافذته على النسخة التي تعمل.
4.4 الإيقاف وإعادة التشغيل
الطريق الأسلم دائمًا إعادة تشغيل الحاسوب نفسه، ثم تسجيل الدخول. فبها يُغلق Windows قاعدة البيانات إغلاقًا نظيفًا، ثم يبدأ كل شيء بترتيبه.
وإن احتاج الفني أن يوقف البرنامج وحده دون إعادة التشغيل، فعنده سكربت الإيقاف في مجلد البرنامج:
D:\Clarus\Clarus_prime\packaging\windows\stop-clarus-lis.ps1
وهو يوقف بالترتيب: البرنامج أولًا، ثم خدمة قاعدة البيانات. ويُشغَّل من PowerShell بصلاحية مسؤول. ثم يُعاد تشغيل البرنامج من اختصاره على سطح المكتب، فيشغّل قاعدة البيانات قبله.
4.4.1 قاعدة بيانات تعمل خارج خدمتها
قد تبقى قاعدة البيانات تعمل بعد تحديث، لكن خارج خدمتها المسجّلة، فتظهر الخدمة متوقفة. وفي إصدارات قديمة كانت حالة كهذه ترفض كل اتصال جديد حتى يُعاد تشغيل Windows. أما الآن فإعداد قاعدة البيانات يكشفها بنفسه: يوقف النسخة العاملة خارج الخدمة إيقافًا نظيفًا، ثم يشغّل الخدمة. وإن تعذّر الإيقاف ترك قاعدة البيانات تعمل وكتب تحذيرًا، فيُعاد تشغيل الحاسوب.
4.5 فحص الصحة
4.5.1 من البرنامج
في قائمة الدعم شاشتان:
- الصحة والتشخيص: بطاقة قاعدة البيانات فيها حجمها وسلامتها، وبطاقة جاهزية الخادم فيها عدد اتصالات قاعدة البيانات والجلسات المفتوحة. وتحتها قسم صيانة قاعدة البيانات.
- الخادم والتحديث: نوع قاعدة البيانات وعنوانها ومنفذها، وحالة التحديثات.
4.5.2 صيانة قاعدة البيانات
في قسم صيانة قاعدة البيانات يقيس الفني حجم قاعدة البيانات بالزر قِس الآن، ويرى آخر صيانة، وما يوصي به الخادم. والعمليات المتاحة:
| العملية | ما تفعل |
|---|---|
| فحص سريع | فحص سريع لسلامة البيانات |
| فحص السلامة | فحص كامل للسلامة، أطول من السريع |
| إصلاح المفاتيح الأجنبية | إصلاح الروابط بين الجداول إن وُجد فيها خلل |
| تحسين الإحصاءات | تحديث إحصاءات قاعدة البيانات، فتسرع الاستعلامات |
| تنظيف وضغط | استرداد المساحة التي تركتها السجلات المحذوفة والمعدّلة |
| نقطة تفتيش | كتابة ما في الذاكرة إلى القرص |
ولا تعمل أي منها إلا بطلب الفني، وتُسجَّل كلها في سجل التدقيق باسمه، ولا تحذف أي سجل. وتنظّف قاعدة البيانات نفسها تلقائيًا في الخلفية كعادة PostgreSQL، فلا يلزم تشغيل شيء منها في الأحوال العادية. ويُشغَّل تحسين الإحصاءات بعد ترحيل كبير، مع أن البرنامج يفعله بنفسه بعد كل ترحيل من ريال لاب.
4.5.3 من المتصفح
على الخادم نفسه، يُجيب البرنامج على عنوانين يفحصهما الفني بالمتصفح، ورقم المنفذ هو منفذ البرنامج (انظر الملحق أ: المنافذ):
| العنوان | ما يقول |
|---|---|
http://127.0.0.1:<المنفذ>/api/health | البرنامج يعمل، ورقم إصداره. ولا يمس قاعدة البيانات |
http://127.0.0.1:<المنفذ>/api/ready | البرنامج يصل إلى قاعدة البيانات. فإن لم يصل أجاب بالرمز 503 |
فإن أجاب الأول ولم يجب الثاني، فالبرنامج يعمل وقاعدة البيانات لا تعمل.
4.6 ما يُفعل إن لم تعمل قاعدة البيانات
| ما يظهر | السبب المرجّح | ما يُفعل |
|---|---|---|
| البرنامج لا يفتح بعد إعادة تشغيل الخادم | لم يسجّل أحد الدخول إلى Windows | سجّل الدخول، وانتظر دقيقة، ثم افتح البرنامج |
رسالة عند البدء تسمّي postgresql.log | قاعدة البيانات لم تبدأ | اقرأ آخر أسطر postgresql.log وpostgresql-startup.log في مجلد السجلات (انظر الملحق ب: المسارات)، ثم أعد تشغيل الحاسوب |
خدمة ClarusPrimePostgres متوقفة ولا تبدأ | القرص ممتلئ، أو ملف قاعدة البيانات تالف، أو برنامج حماية يمنعها | افحص المساحة الحرة على القرص أولًا. ثم اقرأ السجل. ولا تحذف شيئًا من pgdata |
/api/health يجيب و/api/ready لا يجيب | البرنامج يعمل وقاعدة البيانات لا | أعد تشغيل الحاسوب. فإن تكرر، شغّل أمر الإصلاح الذي في رسالة البدء، بصلاحية مسؤول |
المنفذ 5439 مشغول ببرنامج آخر | برنامج آخر على الحاسوب فيه PostgreSQL | لا شيء: برنامج التثبيت أخذ منفذًا آخر وسجّله. وانظر المنفذ الفعلي في ملف الإعداد |
| البرنامج بطيء وقاعدة البيانات كبيرة | إحصاءات قديمة أو مساحة لم تُسترد | شغّل تحسين الإحصاءات ثم تنظيف وضغط خارج ساعات العمل |
وإن فسد مجلد قاعدة البيانات نفسه، فالطريق هو الاستعادة من آخر نسخة احتياطية (انظر 8.9 الاستعادة من نسخة).