دليل التشغيل

دليل الخدمة

الفصل 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، تبدأ أجهزة التحليل يومها قبل أن يفتح أحد البرنامج، فيجب أن يكون يسمعها.

وعند البدء يجري هذا بالترتيب:

  1. يتأكد أن قاعدة البيانات تعمل. فإن كانت خدمتها متوقفة شغّلها، وانتظر حتى تجيب، مدة أقصاها دقيقتان.
  2. إن لم تُجب، حاول إصلاحها بإعادة تشغيل إعداد قاعدة البيانات، مدة أقصاها ثلاث دقائق.
  3. إن بقيت لا تجيب، توقف وكتب رسالة تسمّي ملفي السجل postgresql.log وpostgresql-startup.log، وأمر الإصلاح الذي يُشغَّل باليد.
  4. يجهّز المختبر: وأثناء ذلك تجيب صفحات البرنامج بأنه يُجهَّز، وتطلب المحاولة بعد ثوانٍ.
  5. يعمل، ومعه المحطة التي تطبع وتصل أجهزة التحليل (انظر الفصل 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 الاستعادة من نسخة).

أبلغ عن خطأ في الترجمة
واتساب أرسل رابط التحميل إلى كمبيوترك