دليل التثبيت على Linux لـ digna إصدار 2026.06¶

الإصدار: 2026.06

آخر تحديث: 5 سبتمبر 2026

جدول المحتويات¶

1. مقدمة
2. متطلبات النظام
3. التهيئة ما قبل التثبيت
4. إعداد خادم PostgreSQL
5. تهيئة خادم الويب
6. التثبيت الابتدائي
7. تكوين الخلفية (Backend)
8. تكوين الواجهة (Dashboard)
9. تشغيل digna كخدمة systemd
10. الترقية إلى إصدار جديد

مقدمة¶

عن digna¶

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

تتكون digna من مكوّنَين رئيسيين:

• digna: نواة التطبيق، وهي المسؤولة عن معالجة البيانات وتنفيذ فحوص الجودة. تجمع الواجهة الخلفية وواجهة سطر الأوامر في ملف تنفيذي واحد، وتحل محل البرنامجين المنفصلين dignabackend وdignacli في الإصدارات السابقة.
• dignadashboard: واجهة ويب مستضافة على خادم ويب، توفّر وسيلة سهلة التفاعل مع منصة digna وتصوّر مقاييس جودة البيانات.

ما الجديد في إصدار 2026.06¶

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

تبحث عن Windows أو macOS؟¶

يغطي هذا الدليل Linux. للمنصات الأخرى، راجع دليل التثبيت على Windows أو دليل التثبيت على macOS.

أي توزيعة يغطي هذا الدليل؟¶

التعليمات مكتوبة لعائلتين شائعتين من الخوادم. حيث تختلف الأوامر بينهما، يتم عرض كلا الأمرين:

• عائلة Debian — Debian، Ubuntu. مدير الحزم: apt.
• عائلة RHEL — Red Hat Enterprise Linux، Rocky Linux، AlmaLinux، Fedora. مدير الحزم: dnf.

أي توزيعة حديثة تحتوي على systemd ستعمل؛ ما يتغير فقط أسماء الحزم وبعض مسارات التهيئة.

متطلبات النظام¶

قبل أن تبدأ التثبيت، تأكد من أن نظامك يفي بالحد الأدنى من المتطلبات التالية:

خيارات تثبيت قاعدة البيانات¶

إذا كان PostgreSQL مثبتًا بالفعل: يمكنك إضافة قاعدة بيانات جديدة لـ digna إلى خادم PostgreSQL الموجود لديك.

إذا كنت ستثبت PostgreSQL على نفس الجهاز الذي سيشغّل digna:

التحقق من التوزيعة والعمارة¶

تختلف عدة أوامر في هذا الدليل بين عائلتي Debian و RHEL. للتحقق أي منهما تستخدم، شغّل:

cat /etc/os-release
uname -m

• ID=ubuntu أو ID=debian — استخدم أوامر apt.
• ID=rhel, rocky, almalinux أو fedora — استخدم أوامر dnf.
• x86_64 أو aarch64 — هي معمارية حزمة التثبيت التي تحتاجها.

التهيئة ما قبل التثبيت¶

قبل تثبيت digna، تأكد من توافر شرطين أساسيين:

1. خادم PostgreSQL – لتخزين المقاييس المحسوبة وبيانات الأداء
2. خادم الويب – لاستضافة لوحة تحكم digna

إذا لم تكن هذه المكونات معدّة بالفعل، اتبع الأقسام أدناه لتثبيتها وتكوينها.

تحديث فهارس الحزم¶

حدّث قوائم الحزم قبل تثبيت أي شيء:

sudo apt update

sudo dnf check-update

إعداد خادم PostgreSQL¶

إذا كان PostgreSQL مثبتًا بالفعل¶

إذا كان PostgreSQL مثبتًا ويعمل على جهازك المحلي أو كنت تستخدم خادم PostgreSQL مدارًا عن بُعد، يمكنك الانتقال إلى القسم التالي.

تثبيت PostgreSQL¶

الخطوة 1: تثبيت حزمة الخادم¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

الخطوة 2: تهيئة عنقود قاعدة البيانات¶

على عائلة Debian، الحزمة تُنشئ وتبدأ العنقود تلقائيًا — انتقل إلى الخطوة التالية.

على عائلة RHEL، يجب إنشاء العنقود صراحة:

sudo postgresql-setup --initdb

الخطوة 3: بدء وتمكين الخدمة¶

sudo systemctl enable --now postgresql

هذا يبدأ PostgreSQL فورًا ويضبطه ليعمل تلقائيًا عند الإقلاع.

الخطوة 4: التحقق من التثبيت¶

psql --version
sudo systemctl status postgresql

يجب أن ترى إصدار PostgreSQL وخدمة في حالة active (running).

الخطوة 5: الاتصال بالخادم¶

حزمة PostgreSQL على Linux تنشئ حساب نظامي postgres الذي يملك العنقود. اتصل من خلاله:

sudo -u postgres psql

الخطوة 6: تأكيد المنفذ¶

المنفذ الافتراضي لـ PostgreSQL هو 5432. لتأكيد المنفذ الذي يستمع عليه خادمك:

sudo -u postgres psql -c "SHOW port;"

دوّن هذه القيمة — ستحتاجها عند تكوين backend الخاص بـ digna.

الخطوة 7: تمكين مصادقة كلمات المرور لمستخدم digna¶

digna يتصل بـ PostgreSQL عبر TCP كمستخدم digna_user، ويتطلب ذلك مصادقة بكلمة مرور بدلًا من peer authentication. تحقق أن pg_hba.conf يسمح بذلك.

حدد موقع الملف:

sudo -u postgres psql -c "SHOW hba_file;"

افتحه بمحرر وتأكد أن الأسطر الخاصة بالاتصالات TCP المحلية تستخدم scram-sha-256 (أو md5 على الخوادم الأقدم) بدلاً من ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

أعد تحميل PostgreSQL بعد أي تغيير:

sudo systemctl reload postgresql

الخطوة 8: إذا كان PostgreSQL يعمل على جهاز آخر¶

للسماح بالاتصالات من مضيف مختلف، اضبط listen_addresses في postgresql.conf وأضف سطر host مناسبًا لشبكتك في pg_hba.conf:

listen_addresses = '*'

ثم افتح المنفذ في جدار الحماية وأعد تشغيل الخدمة:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

تهيئة خادم الويب¶

تتطلب digna خادم ويب لاستضافة الواجهة. اختر أحد الخيارات التالية:

• nginx — خفيف ومُوصى به
• Apache httpd — بديل واسع الانتشار

تحتاج فقط إلى تثبيت وتكوين أحد هذين الخادمين.

تقوم كلا القسمين بتكوين أمرين تعتمد عليهما الواجهة:

• استرجاع تطبيق الصفحة الواحدة (single-page-application fallback)، حتى لا يعيد تحديث عنوان URL في لوحة التحكم خطأ 404
• نوع MIME للاحقة .md، حتى تُخدَمّ ملفات Markdown بشكل صحيح

إعداد nginx¶

نظرة عامة¶

nginx هو خادم ويب خفيف وعالي الأداء مناسب جيدًا لخدمة لوحة تحكم digna الثابتة.

التثبيت¶

sudo apt install -y nginx

sudo dnf install -y nginx

بدء nginx¶

sudo systemctl enable --now nginx

التحقق من التثبيت¶

1. افتح المتصفح
2. انتقل إلى http://localhost
3. يجب أن ترى صفحة الترحيب الخاصة بـ nginx

فتح جدار الحماية¶

إذا كان الخادم مُتاحًا من أجهزة أخرى، سمح بحركة HTTP:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

تكوين موقع للوحة التحكم¶

nginx يضمن تضمين كل ملف في دليل conf.d على كلتا العائلتين. أنشئ ملف تهيئة مخصص لـ digna هناك:

sudo nano /etc/nginx/conf.d/digna.conf

ألصق التالي، مع استبدال /opt/digna/dashboard بالمسار الفعلي لمجلد dashboard المستخرج لديك:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

تعطيل الموقع الافتراضي¶

يمكن أن يكون بلوك سيرفر واحد فقط هو الـ default_server لمنفذ. على عائلة Debian، احذف الإعداد الافتراضي المعبأ حتى لا يتعارض:

sudo rm /etc/nginx/sites-enabled/default

على عائلة RHEL، علّق أو احذف بلوك server { ... } داخل /etc/nginx/nginx.conf.

تطبيق التهيئة¶

اختبر التهيئة لصياغة صحيحة، ثم أعد تحميل nginx:

sudo nginx -t
sudo systemctl reload nginx

إعداد Apache httpd¶

نظرة عامة¶

Apache httpd متوفر في مستودعات التوزيعة الافتراضية لكل توزيعة مدعومة. اسم الحزمة هو apache2 على عائلة Debian و httpd على عائلة RHEL.

التثبيت¶

sudo apt install -y apache2

sudo dnf install -y httpd

بدء Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

التحقق من التثبيت¶

1. افتح المتصفح
2. انتقل إلى http://localhost
3. يجب أن ترى صفحة Apache الافتراضية لتوزيعتك

مطلوب: تفعيل mod_rewrite¶

تتطلب الواجهة إعادة كتابة عناوين URL.

على عائلة Debian، فعّل الوِحدة وأعد التشغيل:

sudo a2enmod rewrite
sudo systemctl restart apache2

على عائلة RHEL، mod_rewrite محمّل افتراضيًا. تأكد من وجوده:

httpd -M | grep rewrite

مطلوب: السماح بتجاوزات .htaccess¶

افتح ملف التهيئة لجذر المستندات:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

حدِّد بلوك <Directory> الذي يغطي جذر المستندات (/var/www/html على كلتا العائلتين) وغيّر:

AllowOverride None

إلى:

AllowOverride All

مطلوب: نوع MIME لملفات Markdown¶

في نفس الملف، أضف السطر التالي حتى تُخدم ملفات Markdown بشكل صحيح:

AddType text/markdown .md

تطبيق التهيئة¶

تحقق من التهيئة لصياغة صحيحة، ثم أعد تشغيل Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

التثبيت الابتدائي¶

الخطوة 1: إعداد مستودع digna¶

مستودع digna يخزن جميع المقاييس المحسوبة بواسطة digna. يعمل كقاعدة بيانات مركزية للبيانات التحليلية وأداء النظام.

إنشاء مخطط المستودع والمستخدم¶

افتح عميل PostgreSQL الخاص بك (psql، pgAdmin، أو ما شابه) ونفّذ أوامر SQL التالية:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

استبدل العناصر النائبة التالية:

• <digna_repo_schema> — اسم المخطط المطلوب (مثلاً dignarepo)
• <digna_repo_user> — اسم المستخدم المطلوب (مثلاً digna_user)
• <digna_repo_password> — كلمة مرور آمنة لهذا المستخدم

مثال:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

لتنفيذ هذه الأوامر من الشل في خطوة واحدة:

sudo -u postgres psql

ثم ألصق العبارات عند موجه postgres=# واكتب \q للخروج.

الخطوة 2: فك حزمة تثبيت digna¶

1. حدّد ملف ZIP لتثبيت digna المزوَّد لك
2. فكّه في موقع التثبيت الذي تريده — على سبيل المثال /opt/digna
3. بعد الفك، يجب أن ترى العناصر التالية:
4. dashboard/ — واجهة الويب
5. digna — الملف التنفيذي الرئيسي (backend + CLI مدمجان)

لفك الضغط من الشل:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-linux-x86_64.zip -d /opt/digna

جعل الملف التنفيذي قابلاً للتشغيل¶

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

cd /opt/digna
sudo chmod +x digna

إنشاء حساب خدمة¶

يوصى بتشغيل الخلفية كمستخدم غير مميز مخصص للإنتاج:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

الخطوة 3: تثبيت ملف الترخيص¶

1. حدّد ملف license.toml المزود لك
2. انسخه إلى دليل تثبيت digna الجذري (حيث يوجد config.toml والملف التنفيذي digna)

لماذا هذا مهم: يحتوي ملف الترخيص على معلومات العميل، تاريخ انتهاء الترخيص، والتوقيع الرقمي. لا تُعدِّل هذا الملف — أي تغيّر سيبطله.

هيكل الدليل بعد الإعداد:

/opt/digna/
├── config.toml         (ملف التهيئة)
├── license.toml        (ملف الترخيص الخاص بك - انسخه هنا)
├── digna               (الملف التنفيذي الرئيسي)
├── bin/                (سكريبتات إدارة الخدمة)
└── dashboard/          (واجهة الويب)
    └── (ملفات الdashboard)

تكوين الخلفية (Backend)¶

الخطوة 1: إنشاء وتحرير ملف التهيئة¶

ملف config_template.toml مُقدم في دليل تثبيت digna. كل ما عليك هو إعادة تسميته إلى config.toml.

cd /opt/digna
sudo mv config_template.toml config.toml

الموقع: /opt/digna/config.toml

افتح config.toml في محرر نصّي وقم بتكوين كل قسم أدناه.

قسم [app]¶

هذا القسم يضبط إعدادات تطبيق backend الخاص بـ digna:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

قسم [repo]¶

هذا القسم يضبط الاتصال بقاعدة بيانات PostgreSQL:

[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

قسم [base]¶

يحتوي هذا القسم على إعدادات الأمان وملفات تعريف الارتباط:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

قسم [encryption]¶

يحتوي هذا القسم على المفتاح المستخدم لتشفير القيم الحساسة المخزنة في المستودع. وهو إلزامي — يُبلغ config check عن القسم [encryption] بحالة FAILED إذا كان المفتاح مفقودًا.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

قسم [logging]¶

هذا القسم يضبط سلوك التسجيل:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

الخطوة 2: تحقق من التهيئة¶

قبل تهيئة المستودع، تحقق من أن config.toml مكتمل ومبني بشكل صحيح. نفّذ في دليل تثبيت digna:

digna config check

يُتحقق من كل قسم على حدة، بحيث لا يخفي خطأ واحد حالة الأقسام الأخرى:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK

Overall: OK

صحّح كل ما يُبلَّغ عنه بحالة FAILED، وأعد تنفيذ الأمر قبل المتابعة. القائمة الكاملة للخيارات موجودة في مرجع CLI.

الخطوة 3: تهيئة المستودع¶

1. افتح طرفية
2. انتقل إلى دليل تثبيت digna (حيث يوجد config.toml والملف التنفيذي digna)
3. شغّل اختبار الاتصال:

cd /opt/digna
./digna repo check

يجب أن ترى تأكيدًا على نجاح الاتصال (المستودع نفسه لم يُهيأ بعد).

sudo ln -s /opt/digna/digna /usr/local/bin/digna

الخطوة 4: تثبيت مخطط المستودع¶

في نفس الدليل، شغّل:

./digna repo install

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

الخطوة 5: إنشاء مستخدم مشرف¶

1. افتح نافذة طرفية جديدة
2. انتقل إلى دليل تثبيت digna
3. شغّل الأمر التالي لإنشاء مستخدم مشرف:

./digna user add <email> <password> "<display_name>" --admin

مثال:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

يؤدي ذلك إلى إنشاء مستخدم بعنوان البريد الإلكتروني admin@example.com وامتيازات إدارية كاملة.

الخطوة 6: بدء خادم digna¶

في دليل تثبيت digna، ابدأ الخادم بـ:

./digna serve --address <host> --port <port>

المعلمات: - --address — اسم المضيف/عنوان IP للخادم - --port — منفذ الخادم

يجب أن ترى رسائل بدء تُؤكِّد أن الخادم يعمل:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

تكوين الواجهة (Dashboard)¶

الخطوة 1: نشر الواجهة على خادم الويب¶

تقرأ لوحة digna تهيئتها الخاصة من dashboard/dashboard_config.toml. هذا الملف لا يأتي مع التثبيت — بل تنشئه في دليل dashboard/ إلى جانب ملفات لوحة التحكم.

محتوياته موضّحة في الدخول الموحّد (SSO)، وهناك أيضًا يلزم الملف: فهو يحمل خيارات تسجيل الدخول التي تعرضها لوحة التحكم، وفي عمليات النشر متعددة النسخ، اتصال الواجهة الخلفية.

اختر خادم الويب واتبع خطوات النشر المناسبة.

النشر على nginx¶

إذا اتبعت قسم إعداد nginx، فإن بلوك السيرفر يشير بالفعل إلى مجلد dashboard ولا حاجة للنسخ.

1. أكد المسار
2. افتح /etc/nginx/conf.d/digna.conf

3. تحقق أن root يشير إلى مجلد dashboard المستخرج

4. تأكد من أن المجلد قابل للقراءة

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. أعد تحميل nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. اختبر التثبيت

7. افتح المتصفح
8. انتقل إلى http://localhost (أو عنوان الـ URL المكوّن)
9. يجب أن ترى صفحة تسجيل دخول لوحة digna

النشر على Apache httpd¶

1. انسخ الواجهة إلى جذر المستندات

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. أضف قواعد إعادة الكتابة

أنشئ ملف .htaccess داخل المجلد المنشور ليظلّت مسارات الواجهة صالحة بعد تحديث المتصفح:

sudo nano /var/www/html/digna/.htaccess

ألصق التالي:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. أعد تشغيل Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. افتح الواجهة

3. افتح المتصفح
4. انتقل إلى http://localhost/digna
5. يجب أن ترى صفحة تسجيل دخول لوحة digna

الخطوة 2: SELinux (عائلة RHEL فقط)¶

على RHEL، Rocky، AlmaLinux و Fedora، يكون SELinux في الوضع المطبق (enforcing) افتراضيًا وسيمنع خادم الويب من قراءة الملفات خارج المواقع المتوقعة. تحقّق ما إذا كان مفعلًا:

getenforce

إذا كانت النتيجة Enforcing وكنت تخدم الواجهة من /opt/digna/dashboard، صنف المجلد بحيث يتمكن خادم الويب من قراءته:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

تشغيل digna كخدمة systemd¶

لماذا تشغيل digna كخدمة؟¶

تشغيل backend الخاص بـ digna كخدمة systemd يضمن أنه:

• يبدأ تلقائيًا عند إقلاع الجهاز
• يعمل في الخلفية دون نافذة طرفية مفتوحة
• يعاد تشغيله تلقائيًا إذا تعطل
• يمكن إدارته عبر systemctl، مدير الخدمات القياسي على Linux

ملفات إدارة الخدمة¶

جميع الملفات اللازمة موجودة في دليل تثبيت digna تحت: bin/

السكريبتات الشل التالية متاحة:

• install_service.sh — يسجل digna لدى systemd
• uninstall_service.sh — يلغى تسجيل الخدمة
• start_service.sh — يبدء الخدمة المسجلة
• stop_service.sh — يوقف الخدمة الجارية

جعل السكريبتات قابلة للتنفيذ¶

قد لا تحافظ عملية الفك على بت التنفيذ. قبل الاستخدام الأول:

cd /opt/digna/bin
sudo chmod +x *.sh

تثبيت الخدمة¶

1. افتح طرفية

2. انتقل إلى مجلد bin

   cd /opt/digna/bin
   

3. شغّل سكريبت التثبيت

   sudo ./install_service.sh
   

تم الآن تسجيل خادم digna لدى systemd مع تمكين بدء التشغيل التلقائي. الخدمة لا تبدأ فورًا — راجع القسم التالي لبدءها.

بدء وإيقاف الخدمة¶

لبدء الخدمة¶

1. افتح طرفية
2. انتقل إلى /opt/digna/bin
3. شغّل:

   sudo ./start_service.sh
   

لإيقاف الخدمة¶

1. افتح طرفية
2. انتقل إلى /opt/digna/bin
3. شغّل:

   sudo ./stop_service.sh
   

إدارة الخدمة عبر systemctl¶

بعد التسجيل، يمكن أيضًا التحكم بالخدمة باستخدام أوامر systemd القياسية من أي دليل:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

التحقق من الخدمة¶

للتأكد أن الخدمة مسجلة وتعمل:

systemctl is-enabled digna
systemctl is-active digna

enabled يعني أن الخدمة تبدأ عند الإقلاع؛ active يعني أنها تعمل الآن.

عرض سجلات الخدمة¶

يقوم systemd بالتقاط كل ما يطبعه الـ backend على الطرفية. لقراءته:

sudo journalctl -u digna -n 100

لمتابعة السجل مباشرًة أثناء إعادة إنتاج المشكلة:

sudo journalctl -u digna -f

نقل الخدمة إلى دليل جديد¶

ملف الوحدة يخزن المسار المطلق للملف التنفيذي، لذا يتطلب نقل التثبيت إعادة تسجيل الخدمة:

1. إلغاء تثبيت الخدمة الحالية

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. نقل ملفات التطبيق

   sudo mv /old/path/digna /new/path/digna
   

3. إعادة تثبيت الخدمة

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. بدء الخدمة

   sudo ./start_service.sh
   

إلغاء تثبيت الخدمة¶

1. أوقف الخدمة الجارية

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. أزل الخدمة

   sudo ./uninstall_service.sh
   

تم الآن إلغاء تسجيل خادم digna من systemd.

الترقية إلى إصدار جديد¶

قبل الترقية¶

تحقق أولًا من جميع اتصالات قواعد البيانات

ابتداءً من الإصدار 2026.06، يصل digna إلى كل تقنية مصدر عبر ODBC. كانت الإصدارات السابقة تتيح الاختيار بين برنامج تشغيل خاص بكل تقنية وبين ODBC، عبر المفتاح Use ODBC. قرر فريق digna الاعتماد على ODBC وحده، لأن واجهة قياسية واحدة تقدّم أكثر مما تقدّمه مجموعة من برامج التشغيل المصممة خصيصًا:

• المصادقة — المصادقة جزء من ODBC، لذا يمكن للاتصال استخدام كل ما يدعمه برنامج التشغيل الخاص به: كلمات المرور، والرموز المميزة و PAT، وKerberos وActive Directory، والمصادقة متعددة العوامل وتسجيل الدخول الموحّد عبر المتصفح، وهويات السحابة، وشهادات العميل وTLS. تصل الطرق الجديدة مع تحديث برنامج التشغيل، بدلًا من انتظار إصدار من digna.
• برامج تشغيل تتولى صيانتها شركات قواعد البيانات — يتابع برنامج التشغيل الخاص بالشركة المصنّعة إصدارات الخادم الجديدة والإصلاحات الأمنية، ويمكنك تحديثه وفق جدولك الخاص وبمعزل عن digna.
• طريقة واحدة لتهيئة كل شيء — كل تقنية هي قائمة من خصائص المفتاح/القيمة، بالواجهة نفسها، وتشفير القيم الحساسة نفسه، وأسلوب استكشاف الأخطاء نفسه، بدلًا من مجموعة حقول مختلفة لكل مصدر.
• الضبط والاتساع — خيارات برنامج التشغيل مثل المهل الزمنية وإعدادات TLS والوسطاء وأحجام الجلب متاحة لكل مصدر، ويمكن توصيل أي تقنية لديها برنامج تشغيل ODBC متوافق، بما في ذلك تلك التي لا ينشر digna دليلًا خاصًا بها.

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

1. راجع كل اتصال بقاعدة بيانات مُعرَّف في تثبيتك ودوّن الاتصالات التي لا تستخدم ODBC بعد — كل منها يحتاج إلى إعادة تهيئة.
2. ثبّت برنامج تشغيل ODBC المناسب على مضيف digna — تُفتح الاتصالات من الخادم الذي يشغّل الواجهة الخلفية لـ digna، لا من المتصفح. انظر تثبيت برنامج تشغيل ODBC على مضيف digna.
3. جهّز خصائص ODBC لكل اتصال متأثر. أدلة التقنيات تسرد لكل مصدر مجموعة خصائص مجرَّبة.

بعد الترقية، حوّل كل اتصال متأثر إلى ODBC واختبره من لوحة المعلومات — انظر إنشاء اتصال بقاعدة بيانات و اختبار اتصال.

النسخ الاحتياطي لمستودع digna إلزامي

قبل ترقية digna، اعمل نسخة احتياطية من مستودعك (PostgreSQL) لحماية بياناتك من الضياع. النسخة الاحتياطية تضمن إمكانية الاسترداد إذا واجهت الترقية مشكلات غير متوقعة.

لإنشاء نسخة احتياطية من الشل:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

عملية الترقية¶

الخطوة 1: إيقاف خدمة digna¶

إذا كانت digna تعمل كخدمة systemd، أوقفها أولًا:

cd /opt/digna/bin
sudo ./stop_service.sh

إذا كانت تعمل في المقدمة (foreground)، اضغط Ctrl + C في نافذة الطرفية الخاصة بها.

الخطوة 2: انسخ التثبيت الحالي احتياطيًا¶

في دليل تثبيت digna، أعد تسمية مجلدات التثبيت الحالي حتى يمكن نشر الإصدار الجديد بجوارها:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

الخطوة 3: فك ونشر النسخة الجديدة¶

1. فك ملف ZIP للنسخة الجديدة من digna
2. انسخ الملف التنفيذي الجديد digna ومجلد dashboard إلى دليل التثبيت
3. أعد بت التنفيذ وملكية حساب الخدمة:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

الخطوة 4: استعادة ملفات التهيئة الخاصة بك¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

الخطوة 5: إعادة تحميل خادم الويب¶

لوحة التحكم عبارة عن مجموعة من الملفات الثابتة، لذا قد يظل خادم الويب — والمتصفح — يقدّمان الإصدار السابق. أعد تحميل أو أعد تشغيل خادم الويب الذي يستضيف مجلد dashboard، ثم أعد تحميل الصفحة بتحديث كامل (Ctrl+F5).

الخطوة 6: تحقق من التهيئة¶

تأكد من أن ملف config.toml المحدَّث مكتمل قبل أن تمسّ المستودع:

./digna config check

يجب أن يُبلِّغ كل قسم بحالة OK. صحّح كل ما يُبلَّغ عنه بحالة FAILED، وأعد تنفيذ الأمر قبل المتابعة.

الخطوة 7: استبدال ملف الترخيص¶

يُرخَّص كل إصدار على حدة. انسخ ملف license.toml الذي قدّمه فريق digna لهذا الإصدار إلى دليل التثبيت، ليحل محل الملف القديم:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

الخطوة 8: ترقية مخطط المستودع¶

انتقل إلى دليل تثبيت digna وشغّل:

cd /opt/digna
./digna repo upgrade

سيحدِّث هذا مخطط PostgreSQL إلى أحدث إصدار مع المحافظة على جميع البيانات الحالية.

الخطوة 9: إعادة تشغيل الخدمات¶

إذا كانت تعمل كخدمة systemd:

cd /opt/digna/bin
sudo ./start_service.sh

إذا كنت تديرها يدويًا، أعد تشغيل الخادم:

cd /opt/digna
./digna serve --address <address> --port <port>

إذا كنت تستخدم nginx أو Apache، أعد تحميل خادم الويب المعني:

sudo systemctl reload nginx

sudo systemctl restart apache2

على عائلة RHEL، أعد تطبيق تمييز SELinux إذا استُبدل دليل dashboard:

sudo restorecon -Rv /opt/digna/dashboard

الخطوة 10: التحقق من الترقية¶

1. افتح لوحة digna
2. تحقق من تحميل الواجهة بشكل صحيح
3. تحقق من سجلات الخادم لأي أخطاء:
4. حوّل إلى ODBC كل اتصال لم يكن يستخدمه بعد، ثم اختبر جميع الاتصالات — انظر اختبار اتصال

sudo journalctl -u digna -n 100