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

الإصدار: 2026.11

آخر تحديث: 7 نوفمبر، 2026

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

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

مقدمة¶

عن digna¶

digna هي منصة شاملة مدعومة بالذكاء الاصطناعي مصممة لتحسين إدارة جودة البيانات عبر بيئات بيانات متعددة مثل المخازن، والـ lakes، و 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 أو Linux؟¶

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

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

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

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

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

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

التحقق من المعمارية الخاصة بك¶

تختلف العديد من المسارات في هذا الدليل بين أجهزة Apple Silicon و Intel. للتحقق من نوع المعالج، افتح Terminal وشغّل:

uname -m

• arm64 — Apple Silicon. يثبت Homebrew في /opt/homebrew.
• x86_64 — Intel. يثبت Homebrew في /usr/local.

الإعداد قبل التثبيت¶

قبل تثبيت digna، تأكد من وجود ثلاثة متطلبات أساسية:

1. Homebrew – مدير الحزم المستخدم لتثبيت المكوّنات أدناه
2. PostgreSQL Server – لتخزين المقاييس المحسوبة وبيانات الأداء
3. خادم الويب – لاستضافة لوحة digna

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

تثبيت Homebrew¶

Homebrew هو مدير الحزم القياسي لنظام macOS ويُستخدم طوال هذا الدليل لتثبيت PostgreSQL و nginx.

الخطوة 1: تحقق مما إذا كان Homebrew مثبتًا بالفعل¶

افتح Terminal (اضغط Cmd + Space، اكتب Terminal، واضغط Enter) وشغّل:

brew --version

إذا تم إرجاع رقم إصدار، انتقل إلى قسم إعداد خادم PostgreSQL.

الخطوة 2: تثبيت Homebrew¶

إذا لم يتم العثور على الأمر، ثبّت Homebrew باتباع التعليمات على موقع Homebrew الرسمي. يقوم المثبّت أيضًا بتثبيت Xcode Command Line Tools إذا لم تكن موجودة بالفعل.

الخطوة 3: أضف Homebrew إلى PATH¶

على Apple Silicon، يعرض المثبّت أمرين لإضافة Homebrew إلى بيئة الصدفة الخاصة بك. نفّذهما كما هو مذكور، ثم تأكد:

brew --prefix

يجب أن يعرض /opt/homebrew على Apple Silicon أو /usr/local على Intel.

إعداد خادم PostgreSQL¶

إذا كان لديك PostgreSQL بالفعل¶

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

خيارات التثبيت¶

يوفر macOS طريقتين بسيطتين لتثبيت PostgreSQL. اختر واحدة فقط:

• Homebrew — تثبيت عبر سطر الأوامر، موصى به لنشر الخادم
• Postgres.app — تثبيت رسومي، مناسب للتقييم المحلي

تثبيت PostgreSQL باستخدام Homebrew¶

الخطوة 1: تثبيت الصيغة الخاصة بـ PostgreSQL¶

brew install postgresql@16

الخطوة 2: أضف PostgreSQL إلى PATH¶

الصيغ ذات الإصدار المحدد تكون keg-only، مما يعني أن Homebrew لا يربط أوتوماتيكيًا أوامره في PATH لديك. أضفها بنفسك:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

الخطوة 3: ابدأ خدمة PostgreSQL¶

brew services start postgresql@16

هذا يشغل PostgreSQL فورًا ويضبطه ليبدأ تلقائيًا عند تسجيل الدخول.

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

psql --version

يجب أن ترى إصدار PostgreSQL إذا نجح التثبيت.

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

psql postgres

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

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

psql postgres -c "SHOW port;"

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

تثبيت PostgreSQL باستخدام Postgres.app¶

إذا فضّلت التثبيت الرسومي:

1. حمّل Postgres.app واسحبه إلى مجلد Applications
2. افتح التطبيق وانقر Initialize لإنشاء خادم جديد
3. اتبع تعليمات التطبيق لإضافة أدوات سطر الأوامر إلى PATH
4. تحقق من التثبيت:

psql --version

يقوم Postgres.app أيضًا بإنشاء superuser باسم حساب macOS الخاص بك.

تكوين خادم الويب¶

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

• nginx — يُثبت عبر Homebrew، موصى به
• Apache httpd — مُضمّن مع macOS

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

يُكوّن كلا القسمين شيئين تعتمد عليهما اللوحة:

• آلية تراجع لتطبيق الصفحة الواحدة (SPA)، حتى لا يعيد تحديث عنوان URL للوحة صفحة 404
• نوع MIME لملفات .md، حتى تُخدم ملفات Markdown بشكل صحيح

إعداد nginx¶

نظرة عامة¶

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

التثبيت¶

brew install nginx

بدء nginx¶

brew services start nginx

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

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

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

يشمل تكوين nginx الخاص بـ Homebrew كل ملف في دليل servers الخاص به. أنشئ ملف تكوين مخصص لـ digna هناك:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

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

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

تطبيق التكوين¶

اختبر التكوين للأخطاء النحوية، ثم أعد تحميل nginx:

nginx -t
brew services restart nginx

إعداد Apache httpd¶

نظرة عامة¶

يتضمن macOS Apache httpd، لذا لا حاجة لتثبيته. هو معطَّل افتراضيًا.

بدء Apache¶

sudo apachectl start

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

1. افتح متصفحك
2. انتقل إلى http://localhost
3. يجب أن ترى الرسالة "It works!"

مطلوب: تمكين mod_rewrite¶

تتطلب اللوحة إعادة كتابة URL. افتح ملف تكوين Apache:

sudo nano /etc/apache2/httpd.conf

ابحث عن السطر التالي وأزل الـ # القيّمة لفتحه:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

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

في نفس الملف، حدد الكتلة <Directory "/Library/WebServer/Documents"> وغير:

AllowOverride None

إلى:

AllowOverride All

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

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

AddType text/markdown .md

تطبيق التكوين¶

تحقق من التكوين للأخطاء النحوية، ثم أعد تشغيل Apache:

sudo apachectl configtest
sudo apachectl restart

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

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

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

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

افتح عميل 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> — اسم الـ 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;

لتنفيذ هذه من الـ Terminal في خطوة واحدة:

psql postgres

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

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

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

لفك الضغط من الـ Terminal:

unzip digna-2026.11-macos.zip -d /opt/digna

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

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

cd /opt/digna
chmod +x digna

إذا قام macOS بحظر التطبيق¶

الملفات التي تُحمّل عبر متصفح أو عميل بريد يتم وسمها بصفة الحجر الصحي (quarantine). إذا أبلغك macOS أن التطبيق "cannot be opened because the developer cannot be verified", نظّف السمة من دليل التثبيت:

xattr -dr com.apple.quarantine /opt/digna

بدلاً من ذلك، افتح System Settings → Privacy & Security، ابحث عن العنصر المحظور قرب أسفل الصفحة، وانقر Open Anyway.

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

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

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

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

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

تكوين الBackend¶

الخطوة 1: إنشاء وتعديل ملف التكوين¶

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

cd /opt/digna
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

قسم [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"

mkdir -p /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. افتح Terminal
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.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

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

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

./digna repo upgrade

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

✅ Repo schema 'dignarepo' is up to date.

الخطوة 5: إنشاء مستخدم مسؤول (Admin)¶

1. افتح نافذة Terminal جديدة
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

تكوين اللوحة¶

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

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

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

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

النشر على nginx¶

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

1. تأكد من المسار
2. افتح $(brew --prefix)/etc/nginx/servers/digna.conf

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

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

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

5. أعد تحميل nginx

   nginx -t
   brew services restart nginx
   

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

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

النشر على Apache httpd¶

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

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

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

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

sudo nano /Library/WebServer/Documents/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 apachectl restart
   

2. الوصول إلى اللوحة

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

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

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

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

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

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

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

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

• install_service.sh — يسجل digna لدى launchd
• uninstall_service.sh — يلغى تسجيل الخدمة
• start_service.sh — يشغّل الخدمة المسجلة
• stop_service.sh — يوقف الخدمة العاملة

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

قد لا تحفظ عملية الاستخراج بت التشغيل. قبل الاستخدام الأول:

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

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

1. افتح Terminal

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

   cd /opt/digna/bin
   

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

   sudo ./install_service.sh
   

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

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

لبدء الخدمة¶

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

   sudo ./start_service.sh
   

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

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

   sudo ./stop_service.sh
   

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

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

sudo launchctl list | grep digna

سطر يبدأ بمعرف عملية يدل على أن الخدمة تعمل. وجود - في العمود الأول يعني أنها مسجلة ولكن متوقفة.

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

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

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 من launchd.

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

يرقّي هذا القسم تثبيتًا من الإصدار 2026.06 إلى الإصدار 2026.11. إذا كان تثبيتك أقدم، فاقرأ أولًا الترقية من إصدار سابق لـ 2026.06.

قبل الترقية¶

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

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

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

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 يعمل كخدمة في الخلفية، فأوقفه أولًا:

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

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

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

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

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

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

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

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

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

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

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، ثم أعد تحميل الصفحة بتحديث كامل (Cmd+Shift+R).

الخطوة 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 إلى دليل التثبيت، ليحل محل الملف القديم:

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: إعادة تشغيل الخدمات¶

إذا كان يعمل كخدمة في الخلفية:

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

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

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

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

brew services restart nginx

sudo apachectl restart

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

1. تأكد من إصدار الملف التنفيذي الجديد:

   ./digna version
   

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

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

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

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