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

الإصدار: 2026.06

آخر تحديث: 5 سبتمبر، 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.06¶

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

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

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

قسم [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. افتح Terminal
2. انتقل إلى دليل تثبيت digna (حيث يوجد config.toml والملف التنفيذي digna)
3. شغّل اختبار الاتصال:

cd /opt/digna
./digna repo check

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

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

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

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

./digna repo install

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

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

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

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

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

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

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

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

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

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

إذا كانت تعمل في الواجهة الأمامية، اضغط Ctrl + C في نافذة الـ Terminal الخاصة بها.

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

1. فكّ أرشيف التثبيت الجديد لـ digna
2. انسخ الملف التنفيذي الجديد digna ومجلد dashboard إلى دليل التثبيت الخاص بك
3. استعد بت تشغيل بت التنفيذ، وإذا لزم الأمر، نظّف سمة الحجر الصحي:

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

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

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

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

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

./digna config check

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

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

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

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

./digna license check

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

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

cd /opt/digna
./digna repo upgrade

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

الخطوة 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
2. تحقق من تحميل الواجهة بشكل صحيح
3. راجع سجلات الخادم لأي أخطاء
4. حوّل إلى ODBC كل اتصال لم يكن يستخدمه بعد، ثم اختبر جميع الاتصالات — انظر اختبار اتصال