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

الإصدار: 2026.11

آخر تحديث: 7 نوفمبر 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.11¶

يضيف هذا الإصدار digna Data Reconciliation، وdigna Agentic مع digna MCP Server، وdigna Engine الذي يستطيع إجراء تنميط البيانات (profiling) داخل digna والتحقق من التكامل المرجعي بين تقنيات قواعد بيانات مختلفة. راجع ملاحظات الإصدار للتفاصيل الكاملة.

بالنسبة إلى التثبيت، يجلب الإصدار آلية جديدة لترحيل المستودع، وقسمًا اختياريًا [duckdb] في config.toml من أجل digna Engine، وملف ترخيص جديدًا. يتناول قسم الترقية كلًّا منها.

تبحث عن 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.11-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]¶

يضبط هذا القسم مشاركة الموارد عبر المصادر (CORS) بين لوحة التحكم والواجهة الخلفية (backend):

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

قسم [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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

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_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

قسم [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

قسم [logging]¶

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

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

قسم [duckdb] (اختياري)¶

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

هذا القسم اختياري. من دونه تُطبَّق القيم الافتراضية أدناه.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

الخطوة 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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

صحّح كل ما يُبلَّغ عنه بحالة FAILED، وأعد تنفيذ الأمر قبل المتابعة. يسرد WARNING تحت Unknown keys المفاتيح الموجودة في config.toml التي لا يقرؤها digna؛ ليس لها أي تأثير، لذا احذفها أو صحّح تهجئتها. القائمة الكاملة للخيارات موجودة في مرجع CLI.

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

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

cd /opt/digna
./digna repo check

على مخطط جديد، يتصل الأمر ثم يُبلغ بأنه لا يوجد مستودع مثبّت بعد:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

في هذه المرحلة هذه هي النتيجة المتوقعة: فهي تؤكد أن digna يصل إلى PostgreSQL وإلى المخطط. أما خطأ الاتصال أو المصادقة فيشير بدلًا من ذلك إلى القسم [repo] أو إلى إعداد PostgreSQL.

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

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

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

./digna repo upgrade

يُثبّت هذا الأمر الجداول اللازمة في مخطط المستودع وينتهي بالرسالة:

✅ Repo schema 'dignarepo' is up to date.

الخطوة 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 للخادم (الافتراضي 127.0.0.1) - --port — منفذ الخادم (الافتراضي 8000)

عندما يعمل الخادم، يطبع العنوان الذي يستمع عليه:

Server running on http://127.0.0.1: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 إلى الإصدار 2026.11. إذا كان تثبيتك أقدم، فاقرأ أولًا الترقية من إصدار سابق لـ 2026.06.

قبل الترقية¶

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

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

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

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

طلب ملف الترخيص للإصدار 2026.11

يحتاج الإصدار 2026.11 إلى ملف license.toml جديد. اطلبه من فريق digna قبل أن تبدأ، واجعله جاهزًا لـ الخطوة 7.

الترقية من إصدار سابق لـ 2026.06¶

جلب الإصدار 2026.06 ثلاثة تغييرات لا تزال سارية عندما ترقّي تثبيتًا أقدم مباشرةً إلى 2026.11:

• ODBC فقط. يصل digna إلى كل تقنية مصدر عبر ODBC. كل اتصال بقاعدة بيانات لا يستخدم ODBC بعد يجب تحويله إلى ODBC بعد الترقية؛ لا يوجد تحويل تلقائي. ثبّت برامج تشغيل ODBC على مضيف digna مسبقًا، انظر تثبيت برنامج تشغيل ODBC على مضيف digna، وجهّز خصائص كل اتصال من أدلة التقنيات. لم يعد موصل Databricks Legacy موجودًا؛ انقل تلك الاتصالات إلى موصل Databricks.
• ملف تنفيذي واحد. يحل الملف التنفيذي الواحد digna، الذي يجمع الواجهة الخلفية وواجهة سطر الأوامر (CLI)، محل dignabackend وdignacli.
• config.toml. القسم [encryption] إلزامي، ولم يعد DIGNA_APP_HOST و DIGNA_APP_PORT يُقرآن: يأخذ الخادم عنوانه ومنفذه من digna serve. قارن ملفك بقسم تكوين الخلفية (Backend).

تشير الخطوات أدناه إلى المواضع التي يحتاج فيها التثبيت الأقدم إلى إجراء مختلف. ترقية المستودع في الخطوة 8 تنقل مستودع أي إصدار سابق مباشرةً إلى 2026.11.

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

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

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

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

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

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

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

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

احتفظ بـ digna_old حتى تتحقق من الترقية، وبـ dashboard_old حتى تستعيد منه ملفات التهيئة الخاصة بك (انظر الخطوة 4). بعد ذلك يمكنك حذفهما.

الخطوة 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

لا يحتاج الإصدار 2026.11 إلى أي تغيير في config.toml: الملف الذي يعمل مع الإصدار 2026.06 يظل يعمل. هناك تغييران اختياريان:

• أضف قسم [duckdb] إذا كانت اتصالات قواعد البيانات ستستخدم digna Engine ولم تكن قيمه الافتراضية مناسبة لمضيفك.
• احذف القسم [app] إذا كان وكيل عكسي يقدّم لوحة التحكم والواجهة الخلفية تحت أصل واحد.

[[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'

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

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

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

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

./digna config check

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

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

ينتقل ملف الترخيص عادةً من إصدار إلى الإصدار الذي يليه. الإصدار 2026.11 استثناء: فهو يضيف وحدتين مرخّصتين، digna Data Reconciliation وdigna Agentic، والترخيص الصادر قبل 2026.11 لا يتضمنهما. انسخ ملف license.toml الذي قدّمه فريق digna للإصدار 2026.11 إلى دليل التثبيت، ليحل محل الملف القديم:

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

./digna license check

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

في دليل تثبيت digna، شغّل:

cd /opt/digna
./digna repo upgrade

يدير الإصدار 2026.11 مخطط المستودع بعمليات ترحيل ذات أرقام إصدارات (versioned migrations). أول ترقية من إصدار سابق تنقل المخطط إلى آخر نسخة من الآلية السابقة، وتسجّل ذلك نقطةَ بداية له، ثم تطبّق عمليات ترحيل الإصدار 2026.11. وتنتهي بالرسالة:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

تُحفظ جميع البيانات الحالية. لمعرفة حالة المستودع في أي وقت، شغّل ./digna repo check: فهو يسرد آخر عملية ترحيل مطبّقة وأي عمليات ترحيل معلّقة.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

الخطوة 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 version
   

   يجب أن يكون السطر الأول Release: 2026.11.

2. افتح لوحة digna وتحقق من تحميل الواجهة بشكل صحيح.

3. تحقق من سجلات الخادم بحثًا عن أخطاء:

   sudo journalctl -u digna -n 100
   

4. اختبر اتصالات قواعد البيانات — انظر اختبار اتصال. بعد الترقية من إصدار سابق لـ 2026.06، حوّل أولًا إلى ODBC كل اتصال لم يكن يستخدمه بعد.

للبدء مع الوحدات الجديدة، انظر digna Data Reconciliation، وربط وكيل ذكاء اصطناعي من أجل digna MCP Server، وموقع التنميط من أجل digna Engine.