يوفّر خادم تحديثات ARN Smart إصدارات Eagle3D الجديدة للتثبيتات ذات الترخيص النشط. تثبّتها من اللوحة بزر واحد. ينشئ Eagle3D نسخة احتياطية من قاعدة البيانات ومن كل ملف يغيّره قبل أن يكتب أي شيء.
مكان العثور عليه: الإعدادات → تحديث (للمسؤولين). عند توفر إصدار جديد، يعرض الشريط الجانبي أيضًا يتوفر تحديث: v… مع رابط إلى هذه الشاشة.
قبل أن تبدأ
- تأكد من أن الترخيص نشط. راجع تفعيل ترخيص Eagle3D.
- يجب أن يكون امتداد PHP
zipمثبتًا، وأن يكون المجلدapp/storageقابلًا للكتابة. تعرض الإعدادات → تحديث تحذيرًا إذا كانzipمفقودًا. - انسخ بياناتك احتياطيًا. افتح الإعدادات → النسخة الاحتياطية، وانقر على إنشاء نسخة احتياطية الآن ونزّل الملف. واحتفظ أيضًا بنسخة من ملف
.envومجلدuploads؛ فهما ليسا جزءًا من النسخة الاحتياطية لقاعدة البيانات. راجع النسخ الاحتياطي لبياناتك واستعادتها. - اختر وقتًا هادئًا. يكون النظام في وضع الصيانة لبضع ثوانٍ أثناء التحديث.
تثبيت تحديث
- افتح الإعدادات → تحديث. يعرض الإصدار المثبت إصدارك الحالي.
- انقر على التحقق من التحديثات. إذا وُجد إصدار جديد، يعرض Eagle3D يتوفر إصدار جديد وحجم الحزمة وملاحظات الإصدار. ويُميَّز التحديث الإلزامي بعبارة "هذا التحديث مُعلَّم كإلزامي."
- اقرأ ملاحظات الإصدار، ثم انقر على تثبيت التحديث وأكّد.
- ينزّل Eagle3D الحزمة ويتحقق منها ويكتب الملفات ("جارٍ تنزيل الحزمة والتحقق منها وكتابة الملفات...")، ثم يطبّق خطوات قاعدة البيانات ("تمت كتابة الملفات. جارٍ تطبيق خطوات قاعدة البيانات...").
- عندما تظهر الرسالة "اكتمل التحديث. الإصدار المثبت: …"، يكون التحديث قد انتهى.
يتحقق Eagle3D أيضًا من التحديثات في الخلفية، مرة كل 12 ساعة على الأكثر، أثناء استخدام أحد المسؤولين للوحة.
ما يفعله المُحدِّث نيابةً عنك
- يتحقق من الحزمة مقابل مجموع التحقق SHA-256 ومعلومات التحديث الموقّعة من خادم ARN Smart، ويتوقف إذا لم تتطابق.
- ينشئ نسخة احتياطية من قاعدة البيانات ومن كل ملف سيتغيّر قبل التثبيت. إذا فشلت كتابة ملف، تُعاد الملفات المكتوبة بالفعل من تلك النسخة الاحتياطية. وإذا أوقف الخادم التحديث أثناء الكتابة (مثلًا عند بلوغ حد زمني)، تُعاد الملفات القديمة عند انتهاء قفل التحديث، خلال 10 دقائق كحد أقصى.
- عند كتابة جميع الملفات، يُكمل أول طلب يعمل بالإصدار الجديد خطوات قاعدة البيانات، حتى لو لم يتلقَّ المتصفح الرد (مثلًا بعد انتهاء مهلة الوكيل). تعرض الصفحة حينها "No reply from the server; checking the result of the update..." وتتابع التحديث بدلًا من الإبلاغ عن فشله.
- لا يمسّ أبدًا ملف إعداداتك (
.env) أو بياناتك أو نسخك الاحتياطية. - بعد التحديث، تعرض بطاقة آخر تحديث الإصدار القديم والجديد والتاريخ وعدد الملفات والنسخ الاحتياطية التي أُخذت. ويُبلغ Eagle3D خادم ARN Smart بالإصدار الجديد ("Reported to the ARN server").
إذا لم تكتمل إحدى خطوات التحديث
إذا ظهرت في الإعدادات ← تحديث الرسالة "An update step (database) is not finished yet. Press the button to complete it."، فانقر على إكمال التحديث. يطبّق ذلك خطوات قاعدة البيانات المتبقية مع الإصدار الجديد.
يمكن للتثبيتات التي تعمل بإصدار 1.0.x أقدم أن تُحدَّث مباشرةً إلى 2.0.0.
إذا فشل التحديث
| الرسالة | ما يجب فعله |
|---|---|
| An active license is required for updates. | فعّل الترخيص أو جدّده أولًا. |
| The PHP "zip" extension is missing on this server; updates cannot be installed. | فعّل الامتداد zip في لوحة الاستضافة. |
| Could not reach the ARN update server. | تحقّق من أن خادمك يستطيع فتح اتصالات HTTPS صادرة، ثم حاول مرة أخرى. |
| Another update is in progress. Try again in a few minutes. | انتظر بضع دقائق؛ ينتهي القفل تلقائيًا. |
| The package SHA-256 does not match; the file is corrupt or modified. Aborted. | لم يتغيّر شيء. حاول لاحقًا؛ وإذا تكرر الأمر فتواصل مع الدعم. |
| A file could not be written; changes were rolled back | تحقّق من أذونات الملفات في مجلد التطبيق. |
| A file could not be written and these files could not be rolled back: … | يبقى الموقع في وضع الصيانة، ويحاول Eagle3D إعادة الملفات مجددًا عند انتهاء قفل التحديث. إذا لم يُفتح الموقع مرة أخرى، فاستعد الملفات المذكورة من النسخة الاحتياطية في app/storage/updates التي تذكرها الرسالة، أو تواصل مع الدعم. |
التحديث باستخدام حزمة تحديث
إذا زوّدك دعم ARN Smart بحزمة تحديث لـ Eagle3D (ملف ZIP) بدلًا من ذلك:
- أنشئ نسخة احتياطية كما هو موضّح أعلاه.
- استخرج الحزمة في مجلد التطبيق ودعها تستبدل الملفات الموجودة. لا تحتوي الحزمة على
.envأو.htaccessأوweb.configأو مجلدinstallأوapp/storage، لذا تبقى إعداداتك وبياناتك ونسخك الاحتياطية في مكانها. - سجّل الدخول بصفتك مسؤولًا وافتح الإعدادات ← تحديث.
- إذا أظهرت الشاشة أن إحدى خطوات التحديث لم تكتمل، فانقر على إكمال التحديث.
- تحقّق من الإصدار المثبّت ومن الإصدار في تذييل اللوحة.
استخدم أداة التحديث المدمجة كلما أمكن؛ فهي تتحقق من الحزمة ويمكنها التراجع تلقائيًا.
ملفات اللغة والتحديثات
تستبدل التحديثات ملفات اللغة الاثني عشر المرفقة مع Eagle3D (ar، de، el، en، es، fa، fr، he، it، nl، ru، tr). أما ملف اللغة الذي أضفته باسم جديد فلا يُمسّ؛ لا تمنح ملفك أحد هذه الرموز، وإلا فسيستبدله التحديث. راجع الملف التجاري والدولة والعملة واللغة.