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

الإصدار: 2026.11

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

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

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

المقدمة¶

حول digna¶

digna هي منصة شاملة تعتمد على الذكاء الاصطناعي مصممة لتحسين إدارة جودة البيانات عبر بيئات بيانات متنوعة مثل المستودعات (warehouses)، والبحيرات (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، وملف ترخيص جديدًا. يتناول قسم الترقية كلًّا منها.

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

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

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

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

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

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

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

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

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

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

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

إعداد خادم PostgreSQL¶

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

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

تثبيت PostgreSQL¶

اتبع هذه الخطوات لتثبيت PostgreSQL على Windows:

الخطوة 1: تنزيل PostgreSQL¶

1. زر صفحة تنزيلات PostgreSQL
2. اختر Windows
3. قم بتنزيل أحدث مثبت

الخطوة 2: تشغيل المثبت¶

1. انقر نقرًا مزدوجًا على ملف المثبت الذي تم تنزيله
2. اتبع المطالبات في معالج التثبيت

الخطوة 3: اختيار دليل التثبيت¶

حدد الدليل الذي سيتم تثبيت PostgreSQL فيه. الموقع الافتراضي عادةً ما يكون مناسبًا.

الخطوة 4: اختيار المكونات¶

لإعداد قياسي، احتفظ بخيارات المكونات الافتراضية محددة.

الخطوة 5: تعيين كلمة مرور مستخدم PostgreSQL الخارق¶

أدخل وأكد كلمة مرور لمستخدم PostgreSQL الخارق (postgres). احفظ هذه الكلمة بأمان — ستحتاجها لاحقًا.

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

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

الخطوة 7: اختيار اللغة المحلية (Locale)¶

اختر اللغة المحلية لقاعدة البيانات. الافتراضي عادةً ما يكون مناسبًا لمعظم التثبيتات.

الخطوة 8: إكمال التثبيت¶

انقر التالي عبر الخطوات المتبقية، ثم انقر إنهاء.

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

افتح موجه الأوامر وتحقق من تثبيت PostgreSQL:

psql --version

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

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

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

• Internet Information Services (IIS)
• Apache Tomcat

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

إعداد IIS¶

نظرة عامة¶

Internet Information Services (IIS) هو خادم الويب من Microsoft لاستضافة مواقع الويب والتطبيقات على الويب.

تمكين IIS¶

1. افتح لوحة التحكم
2. اضغط Win + R

3. اكتب control واضغط Enter

4. انتقل إلى ميزات Windows

5. انقر البرامج

6. اختر تشغيل ميزات Windows أو إيقافها

7. تمكين Internet Information Services

8. مرر لأسفل وابحث عن Internet Information Services (IIS)
9. ضع علامة في مربع الاختيار لتمكينه

10. انقر على + لتوسيع وتحقق من تحديد المكونات الفرعية التالية:

    • Web Management Tools
    • World Wide Web Services

11. انقر موافق لتطبيق التغييرات

12. التحقق من تثبيت IIS

13. افتح المتصفح
14. انتقل إلى http://localhost
15. يجب أن ترى صفحة ترحيب IIS

مطلوب: مكون URL Rewrite¶

يتطلب IIS مكون URL Rewrite. قم بتنزيله وتثبيته من الصفحة الرسمية لمايكروسوفت.

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

لضمان تقديم ملفات Markdown (.md) بشكل صحيح عبر IIS:

1. افتح IIS Manager (اضغط Win + R، اكتب inetmgr، اضغط Enter)
2. انتقل إلى Your Site > MIME Types
3. انقر Add...
4. اضبط:
5. File name extension: .md
6. MIME type: text/markdown

إعداد Apache Tomcat¶

نظرة عامة¶

Apache Tomcat هو حاوية Java Servlet وخادم ويب مفتوح المصدر.

التثبيت¶

1. تنزيل Apache Tomcat
2. زر تنزيلات Apache Tomcat

3. قم بتنزيل توزيع ZIP لنظام Windows

4. فك ضغط الأرشيف

5. فك ضغط ملف ZIP إلى مجلد على نظامك

6. مثال: C:\Program Files\Apache Tomcat

7. التحقق من تشغيل Tomcat

8. افتح المتصفح
9. انتقل إلى http://localhost:8080
10. يجب أن ترى صفحة الترحيب لـ Apache Tomcat

التثبيت الأولي¶

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

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

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

افتح عميل PostgreSQL الخاص بك (pgAdmin أو psql أو ما شابه) ونفّذ أوامر 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;

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

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

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

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

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

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

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── dashboard/          (web interface)
    └── (dashboard files)

تكوين الواجهة الخلفية¶

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

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

الموقع: digna_installation/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 = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\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. شغّل اختبار الاتصال:

digna repo check

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

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

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

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

سيُنشئ هذا مستخدمًا بصلاحيات إدارية كاملة.

الخطوة 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)، وهناك أيضًا يلزم الملف: فهو يحمل خيارات تسجيل الدخول التي تعرضها اللوحة، وفي عمليات النشر متعددة النسخ، اتصال الواجهة الخلفية.

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

النشر على IIS¶

1. افتح IIS Manager

2. اضغط Win + R، اكتب inetmgr، اضغط Enter

3. إنشاء موقع ويب جديد

4. في اللوحة اليسرى، انقر بزر الماوس الأيمن على Sites

5. اختر Add Website...

6. تكوين الموقع

7. Site Name: أدخل اسمًا (مثال: "dignaDashboard")
8. Physical Path: اضغط Browse وحدد مجلد dashboard

9. Binding: عيّن عنوان IP والمنفذ (المنفذ الافتراضي 80 لـ HTTP و443 لـ HTTPS)

10. بدء الموقع

11. انقر OK لإنشاء الموقع

12. انقر بزر الماوس الأيمن على الموقع الجديد واختر Start

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

14. افتح المتصفح
15. انتقل إلى http://localhost (أو عنوان URL الذي قمت بتكوينه)
16. يجب أن ترى صفحة تسجيل دخول لوحة digna

النشر على Apache Tomcat¶

1. نسخ اللوحة إلى Tomcat
2. انسخ مجلد dashboard إلى مجلد webapps في Tomcat
3. أعد تسميته إذا لزم (مثال: إلى digna)

4. مثال: C:\Program Files\Apache Tomcat\webapps\digna

5. التحقق من النشر

6. حدّث أو أعد تحميل صفحة إدارة Tomcat (http://localhost:8080)

7. يجب أن ترى "digna" (أو الاسم الذي اخترته) مدرجًا ضمن التطبيقات المنشورة

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

9. افتح المتصفح
10. انتقل إلى http://localhost:8080/digna
11. يجب أن ترى صفحة تسجيل دخول لوحة digna

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

لماذا نستخدم خدمة Windows؟¶

تشغيل الواجهة الخلفية لـ digna كخدمة Windows يضمن أنها: - تبدأ تلقائيًا عند إقلاع الخادم - تعمل في الخلفية دون الحاجة لفتح نافذة موجه الأوامر - تعيد التشغيل تلقائيًا إذا تعطّلت - يمكن إدارتها عبر أدوات خدمات Windows

أوامر windows¶

تُدار الخدمة بواسطة الملف التنفيذي digna نفسه، من خلال الأوامر الفرعية digna windows. لا توجد ملفات دُفعات (batch) لتشغيلها.

يقبل كل أمر الخيار --name لاستهداف خدمة مسجلة باسم غير الاسم الافتراضي. القائمة الكاملة للخيارات موجودة في مرجع CLI.

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

1. افتح موجه الأوامر كمسؤول
2. انقر بزر الماوس الأيمن على Command Prompt

3. اختر "Run as Administrator"

4. انتقل إلى دليل تثبيت digna

   cd C:\path\to\digna
   

5. سجّل الخدمة

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

تُسجَّل الخدمة مع التشغيل التلقائي، لذا ستبدأ مع Windows. لكنها لا تبدأ فورًا — راجع القسم التالي.

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

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

لبدء الخدمة¶

digna windows start

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

digna windows stop

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

إذا احتجت إلى نقل تثبيت digna:

1. أوقف الخدمة الحالية وألغِ تسجيلها

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

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

3. انقل مجلد تثبيت digna بالكامل إلى الموقع الجديد

4. سجّل الخدمة مجددًا من الموقع الجديد

   cd C:\new\path\digna
   digna windows install
   

كرّر أي قيم --address أو --port أو --account استخدمتها في المرة الأولى — فالتسجيل السابق قد أُزيل.

1. بدء الخدمة

   digna windows start
   

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

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

   cd C:\path\to\digna
   digna windows stop
   

2. ألغِ تسجيل الخدمة

   digna windows uninstall
   

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

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

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

قبل الترقية¶

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

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

طلب ملف الترخيص للإصدار 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¶

افتح موجه الأوامر (Command Prompt) كمسؤول (Administrator) وأوقف الخدمة باستخدام الملف التنفيذي digna من تثبيتك الحالي:

cd C:\path\to\digna
digna windows stop

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

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

cd C:\path\to\digna\bin
stop_service.bat
uninstall_service.bat

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

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

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

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

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

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

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

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

copy /Y C:\path\to\new\license.toml license.toml

digna license check

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

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

إذا كان digna يعمل كخدمة Windows، فشغّله مجددًا:

cd C:\path\to\digna
digna windows start

إذا رقّيت من إصدار سابق لـ 2026.06 وألغيت تسجيل الخدمة في الخطوة 1، فسجّلها مجددًا أولًا باستخدام الملف التنفيذي digna:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

أعطِ --address و--port القيمتين اللتين كانت الخدمة القديمة تخدم عليهما، ما لم تكن تريد القيمتين الافتراضيتين 127.0.0.1 و8000. أضف --account و--password إذا كانت الخدمة القديمة تعمل تحت حساب نطاق (domain). انظر تشغيل digna كخدمة Windows للاطلاع على القائمة الكاملة للخيارات.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

إذا كنت تستخدم IIS أو Tomcat، أعد تشغيل خادم الويب المعني.

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

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

   digna version
   

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

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

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

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