حزم DSE القابلة للنشر على Windows وLinux

التشغيل المعتمد لحزم Windows وLinux القابلة للنشر التي ينشئها DSE

استخدم هذا القسم بعد اكتمال Generate deployables. يوضح مسار الاعتماد/التشغيل للحزمتين الناتجتين win-x64 وlinux-x64 الأصلية. هذه مشغلات تكامل ينشئها DSE وليست حزم التثبيت التجارية Windows/Container الخاصة بالمنتج.

حزمة Windows (windows/win-x64)

انسخ مجلد Windows الناتج إلى جهاز الاعتماد (أو فك الأرشيف المنقول)، ثم اعمل من المجلد windows\win-x64.

تحقق من وجود الملفات التالية قبل أول تشغيل:

• DataSourceExplorer.Runner.exe
• manager.cmd
• run.cmd
• schema-catalog.json
• source-connections.json
• destination-route.json (عند تفعيل التوجيه)

شغّل Runtime Manager المحلي:

cd /d C:\Path\To\deployables\windows\win-x64
manager.cmd

يقوم manager.cmd بتشغيل DataSourceExplorer.Runner.exe --manager. يستمع المدير على 127.0.0.1 فقط ويفتح المتصفح الافتراضي عادةً بصورة تلقائية. إذا لم يفتح المتصفح، شغّل الملف التنفيذي مباشرة واستخدم Local management URL الظاهر في وحدة التحكم.

1. تأكد من أن Runtime status يعرض READY وأنه لا توجد عملية تنفيذ نشطة.
2. في Connections تأكد من أن كل مصدر ووجهة مطلوبة تظهر بالحالة Configured. اترك الحقول المحمية فارغة للاحتفاظ بالقيمة المحفوظة/المضمنة.
3. في أول تشغيل اعتماد استخدم Manual only وحدد مجلد الإخراج output.
4. اختر Run now وانتظر حتى تعود الحالة إلى READY.
5. تأكد من أن Last result وRun history يعرضان Success ثم تحقق بشكل مستقل من ملفات الإخراج/بيانات الوجهة المتوقعة.

لتشغيل واحد بدون واجهة:

run.cmd

حزمة Linux (linux/linux-x64) — مسار Ubuntu Hyper-V الذي تم التحقق منه

يتبع الإجراء التالي دليل Ubuntu Server 26.04.1 LTS / Microsoft Hyper-V الذي تم التحقق منه والمرفق للاعتماد. يتم تشغيل حزمة Linux الأصلية ولا يلزم Docker لهذا المسار.

الوصول الآمن الموصى به من متصفح Windows

بدلاً من إتاحة المدير على شبكة الجهاز الافتراضي، يمكن إنشاء تحويل منفذ SSH محلي من Windows PowerShell بعد قراءة منفذ المدير من سجل Linux:

ssh -L 18093:127.0.0.1:<manager-port> <linux-user>@<VM-IP>

بعد ذلك افتح http://127.0.0.1:18093/ في Windows، وأبق جلسة SSH مفتوحة أثناء استخدام المدير. يظل تمرير socat الموضح أدناه مناسبًا لشبكة اعتماد معزولة/موثوقة.

الهدف

ينشئ هذا الإجراء جهاز Ubuntu Server افتراضيًا خفيفًا ويشغّل حزمة Linux الأصلية التي ينشئها DSE. وهو يحاكي سير العمل في Windows: نسخ الحزمة، تشغيل DSE Deployable Runtime Manager، فتح المدير من جهاز Windows، تشغيل الحزمة، ثم التحقق من النتيجة.

المتطلبات

• جهاز Windows مع تفعيل Hyper-V
• ملف ISO لـ Ubuntu Server LTS
• مجلد linux الذي أنشأه DSE ويحتوي على linux/linux-x64
• 4 vCPU وذاكرة 4 GB وقرص افتراضي 40 GB على الأقل
• اتصال شبكي من الجهاز الافتراضي إلى مصادر ووجهات DSE المطلوبة

1. إنشاء جهاز Hyper-V الافتراضي

أنشئ جهازًا افتراضيًا من الجيل الثاني بهذه الإعدادات الأساسية:

2. تجهيز Ubuntu

سجّل الدخول إلى Ubuntu وحدّث النظام، ثم تحقق من المعالج والذاكرة والقرص وعنوان IP.

sudo apt update
sudo apt upgrade -y
hostname -I
nproc
free -h
df -h

إذا كان VHDX بحجم 40 GB ولكن حجم الجذر نحو 18-19 GB فقط، وسّع وحدة LVM الجذر لاستخدام المساحة الحرة.

sudo vgs
sudo lvextend -l +100%FREE -r /dev/ubuntu-vg/ubuntu-lv
df -h

3. الاتصال من Windows باستخدام SSH

استخدم عنوان IP الحالي الذي يعرضه hostname -I. قد يتغير عنوان Hyper-V Default Switch بعد إعادة التشغيل.

ssh <linux-user>@<VM-IP>

4. نسخ مجلد Linux الذي تم إنشاؤه

شغّل ssh/scp من Windows PowerShell وليس من طرفية Ubuntu. ينشئ DSE مجلد linux وليس ملف linux.zip. استبدل المسار واسم المستخدم وعنوان IP بالقيم الفعلية.

ssh <linux-user>@<VM-IP> "rm -rf /home/<linux-user>/dse-deploy/linux && mkdir -p /home/<linux-user>/dse-deploy"
scp -r "C:\Path\To\GeneratedDeployables\...\linux" <linux-user>@<VM-IP>:/home/<linux-user>/dse-deploy/

5. تجهيز الحزمة

ثبّت socat إذا كنت ستستخدم relay، وانتقل إلى مجلد linux-x64 المنسوخ ثم امنح الملفات صلاحية التنفيذ. سكربتات DSE الحالية هي UTF-8 من دون BOM، لذلك لا يلزم فك ضغط أو إزالة BOM.

sudo apt update && sudo apt install -y socat
cd ~/dse-deploy/linux/linux-x64
chmod +x DataSourceExplorer.Runner manager.sh run.sh
ls -l DataSourceExplorer.Runner manager.sh run.sh

6. التحقق من اتصال المصدر/الوجهة

قبل تشغيل DSE تأكد من أن Ubuntu VM يستطيع الوصول إلى المضيف والمنفذ المطلوبين. يستخدم المثال MongoDB على المنفذ 27017.

timeout 5 bash -c '</dev/tcp/<source-host>/<source-port>' \
  && echo 'Port reachable' \
  || echo 'Port NOT reachable'

# MongoDB example
timeout 5 bash -c '</dev/tcp/192.168.50.124/27017' \
  && echo 'MongoDB port reachable' \
  || echo 'MongoDB port NOT reachable'

7. تشغيل DSE Deployable Runtime Manager

شغّل المدير واقرأ سجل وحدة التحكم. يرتبط المدير بالعنوان 127.0.0.1 ويختار منفذًا محليًا.

cd ~/dse-deploy/linux/linux-x64
./manager.sh
sleep 2
cat .dse-manager/manager-console.log
curl http://127.0.0.1:<manager-port>/ | head

8. إتاحة المدير لمتصفح Windows

استخدم socat في Ubuntu لتمرير منفذ ثابت على الجهاز الافتراضي (18093) إلى منفذ المدير الحالي على loopback. تكتشف الأوامر عنوان IP والمنفذ تلقائيًا.

cd ~/dse-deploy/linux/linux-x64
VM_IP=$(hostname -I | awk '{print $1}')
MANAGER_PORT=$(grep -oE '127\.0\.0\.1:[0-9]+' .dse-manager/manager-console.log | tail -1 | cut -d: -f2)
nohup socat TCP-LISTEN:18093,bind="$VM_IP",reuseaddr,fork TCP:127.0.0.1:"$MANAGER_PORT" > ~/dse-relay.log 2>&1 &
echo "Open: http://$VM_IP:18093/"
ss -ltnp | grep 18093

9. تشغيل الحزمة من واجهة المستخدم

1. افتح في Edge أو Chrome عنوان URL الذي تعرضه أوامر التمرير.
2. تأكد من أن Runtime status يعرض READY ولا توجد عملية نشطة.
3. في Connections تأكد من أن المصدر والوجهة يعرضان Configured. اترك حقول الاتصال المحمية فارغة للاحتفاظ بالقيم المضمنة.
4. للاختبار الأول اضبط Scheduler configuration على Manual only، وOutput directory على output، ثم احفظ الإعدادات.
5. اختر Run now وانتظر حتى تعود الحالة إلى READY.
6. تأكد من أن Last result وRun history يعرضان Success، ثم تحقق من ملفات الإخراج وبيانات الوجهة.

10. الإيقاف وإعادة التشغيل والتنظيف

قد يتغير عنوان IP ومنفذ المدير بعد إعادة تشغيل الجهاز الافتراضي. شغّل manager.sh مرة أخرى، واقرأ المنفذ الجديد، ثم أعد تشغيل socat. لإيقاف التمرير:

pkill -f 'socat TCP-LISTEN:18093' || true

قائمة التحقق

• يبدأ Ubuntu من VHDX ويعمل تسجيل الدخول عبر SSH
• توجد مساحة حرة كافية في نظام الملفات الجذر
• منفذ المصدر/الوجهة متاح من Ubuntu
• ملفات DataSourceExplorer.Runner وmanager.sh وrun.sh قابلة للتنفيذ
• يعرض manager-console.log عنوان إدارة محليًا
• يفتح متصفح Windows العنوان http://<VM-IP>:18093/
• تعود Runtime status إلى READY بعد Run now
• يعرض Run history حالة Success وتوجد النتائج المتوقعة

استكشاف الأخطاء

موارد ذات صلة

استخدم درس الفيديو للحصول على شرح مرئي أو ارجع إلى مركز الوثائق لمزيد من موارد DSE.

الصفحة الرئيسية للوثائق  •  مساعدة الفيديو متعددة اللغات  •  دليل التثبيت  •  موقع DSE