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

الإصدار: 2026.06

آخر تحديث: 30 أغسطس 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.06¶

يجلب هذا الإصدار قدرات مراقبة البيانات (data observability) مباشرة إلى التعليمات البرمجية الخاصة بك، مما يمكّن المطورين من مراقبة جودة البيانات عند المصدر. راجع ملاحظات الإصدارة في ملاحظات الإصدار للاطلاع على التفاصيل الكاملة.

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

هذا القسم يضبط إعدادات تطبيق الواجهة الخلفية لـ 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!"

قسم [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. شغّل اختبار الاتصال:

digna repo check

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

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

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

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

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

الخطوة 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، يصل 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) للحماية من فقدان البيانات. النسخة الاحتياطية تضمن إمكانية الاسترجاع إذا واجهت الترقية مشكلات غير متوقعة.

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

الخطوة 1: أوقف الخدمة القديمة وألغِ تسجيلها¶

إذا كانت digna تعمل كخدمة Windows، أوقفها باستخدام ملفات الدُفعات الخاصة بتثبيتك الحالي — فأوامر digna windows تنتمي إلى الإصدار الجديد وليست متاحة بعد:

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

ثم ألغِ تسجيل الخدمة، مرة أخرى باستخدام ملف الدُفعات القديم. يشير التسجيل إلى الملف التنفيذي القديم وسكربتاته، وكلاهما تستبدلهما هذه الترقية، لذا لا يمكن إعادة استخدامه:

uninstall_service.bat

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

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

الخطوة 3: فك واستخراج الإصدار الجديد¶

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

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

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

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

digna license check

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

انتقل إلى دليل تثبيت digna ونفّذ:

digna repo upgrade

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

الخطوة 9: سجّل الخدمة وشغّلها¶

أُزيل التسجيل القديم في الخطوة 1، لذا تُسجَّل الخدمة مجددًا — هذه المرة باستخدام الملف التنفيذي digna، الذي لا يحتوي على ملفات دُفعات:

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

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

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

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

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

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

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