قد يؤدي فشل عملية إزالة خادم مستندات ONLYOFFICE إلى ترك ملفات الخدمة، والإعدادات، ومجلدات البيانات، ووحدات تخزين Docker، أو حزم التبعية الخاصة بمدير الحزم. ولإزالته بشكل كامل وآمن، يجب تحديد كيفية تثبيته، والسماح لبرنامج ONLYOFFICE بإغلاق الجلسات النشطة، ثم إزالة الحزمة أو الحاوية المطابقة، وبعد ذلك فحص البيانات الدائمة والخدمات المشتركة قبل حذف أي شيء آخر.
ابدأ بنسخ احتياطي إذا كان الخادم لا يزال يحتوي على مستندات أو ملفات ذاكرة تخزين مؤقتة قد تحتاجها أو شهادات أو إعدادات مخصصة. قد يؤدي إلغاء تثبيت خادم المستندات إلى تعطيل Nextcloud أو ownCloud أو أي تطبيق آخر متصل به. كذلك، فإن "إزالة ONLYOFFICE" لا تعني بالضرورة "إزالة PostgreSQL أو Nginx أو RabbitMQ أو Redis أو الخطوط المشتركة": فقد تُستخدم هذه العناصر لتشغيل برامج أخرى.
قبل إلغاء التثبيت، حدد نوع التثبيت
تحقق من قاعدة بيانات الحزم وقم بالتقاط صورة أولاً:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
هذه الأوامر للقراءة فقط؛ لذا فإن ظهور نتيجة فارغة من مدير حزم واحد لا يُثبت عدم وجود البرنامج إذا تم تثبيته بطريقة أخرى. بالنسبة لـ Docker، اعرض قائمة الحاويات والصور:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
إذا كان نظام التشغيل Linux يستخدم Docker Compose، فحدد موقع مشروع Compose وتعريفات وحدات التخزين الخاصة به قبل المتابعة. إذا تم تثبيت ONLYOFFICE Docs باستخدام Helm على Kubernetes، فاستخدم تعليمات إلغاء التثبيت الواردة في المخطط بدلاً من أوامر حزمة Linux.
كيف يمكن إزالة تثبيت DEB أو RPM؟
1. حفظ العمل وفصل المستخدمين بشكل سليم
بالنسبة لتثبيت الحزمة المشمولة بدليل إزالة نظام التشغيل لينكس الخاص بـ ONLYOFFICE، قم بتشغيل برنامج الإعداد الخاص بإيقاف التشغيل قبل إزالة الحزمة:
sudo documentserver-prepare4shutdown.sh
يقوم البرنامج النصي بإغلاق الجلسات النشطة ويساعد في ضمان حفظ المستندات. تشير ONLYOFFICE إلى أن هذه العملية قد تستغرق ما يصل إلى خمس دقائق. يُنصح بجدولة هذه الخطوة خلال فترة الصيانة وإخطار المستخدمين المتصلين أولاً. في حال عدم العثور على الأمر، يُرجى التأكد من الحزمة المثبتة والرجوع إلى صفحة الإزالة الرسمية للإصدار المطابق بدلاً من استبدال البرنامج النصي بآخر غير ذي صلة.
2. قم بحذف الحزمة على نظامي أوبونتو أو ديبيان
بالنسبة لإصدار المجتمع، فإن اسم الحزمة الرسمي هو onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
تختلف أسماء الحزم باختلاف الإصدار. يستخدم دليل إزالة إصدار المطورين الرسمي اسم الحزمة onlyoffice-documentserver-de. تحقق من الاسم الدقيق الذي يظهره الدليل dpkg -l، واتبع تعليمات المورّد المطابقة؛ لا تقم بإزالة حزمة تحمل اسمًا مشابهًا بالتخمين.
يزيل أمر APT purge ملفات الحزمة الثنائية وإعداداتها، لكن ONLYOFFICE يُشير إلى بقاء التبعيات المُثبّتة مع الحزمة. راجع ما يقترحه APT قبل التأكيد. تجنّب التشغيل apt autoremoveالتلقائي: اقرأ قائمة الحزم أولًا، واحتفظ بأي شيء تستخدمه خدمة أخرى.
3. قم بإزالة حزمة RPM على نظام CentOS أو الأنظمة المتوافقة
توفر صفحة إزالة الإصدار المجتمعي هذا الأمر لنظام CentOS:
sudo yum remove onlyoffice-documentserver
في الأنظمة التي تستخدم DNF، استخدم اسم الحزمة الذي أبلغ عنه RPM وراجع المعاملة المقترحة قبل التأكيد:
sudo dnf remove onlyoffice-documentserver
قد تؤدي الاختلافات في الإصدار والمستودع إلى تغيير اسم الحزمة. توضح التعليمات الرسمية لـ ONLYOFFICE yumأمر CentOS تحديدًا؛ تحقق من اسم الحزمة المكافئ لتوزيعتك قبل إزالة إصدار Enterprise أو Developer.
ماذا يجب عليك فعله بالملفات والتبعيات المتبقية؟
إذا أبلغت عملية إزالة الحزم بأن المجلدات ليست فارغة، /etc/onlyofficeفسيعرض برنامج ONLYOFFICE قائمة /var/www/onlyofficeبالمجلدات التي يمكن إزالتها يدويًا. قم أولًا بفحصها ونسخ أي إعدادات أو شهادات أو ملفات ترغب في الاحتفاظ بها. بعد ذلك، فقط في حال إيقاف تشغيل الخادم نهائيًا وعدم احتواء المجلدات على بيانات أي تطبيقات أخرى، قم بإزالة تلك المسارات تحديدًا.
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
لا تستبدل هذا الأمر المستهدف برمز بدل مثل rm -rf /var/*/onlyoffice*. تحقق من حالة الخدمة والحزمة المتبقية:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
قد يُبقي مدير الحزم حزم Nginx وPostgreSQL وRabbitMQ وRedis والخطوط مُثبّتةً لأنها من متطلبات أو شروط التشغيل الأساسية. لا تقم بإزالتها إلا بعد التأكد من عدم استخدامها من قِبل أي تطبيق آخر. في أنظمة Debian أو Ubuntu، افحص التبعيات العكسية قبل التفكير في إزالة أي حزمة؛ أما في الأنظمة القائمة على RPM، فافحص الخدمات والحزم التي تعتمد عليها. إذا تمت إضافة مستودع ONLYOFFICE خصيصًا لهذا الخادم، فيمكنك إزالة مدخل المستودع ومفتاح التوقيع الخاص به بشكل منفصل بعد التحقق من الملفات المُكوّنة. لا تقم بإزالة أي مستودع أو مفتاح مشترك يستخدمه منتج ONLYOFFICE آخر.
راجع أيضًا إعدادات الخادم الوكيل العكسي وجدار الحماية. ابحث في ملفات موقع Nginx عن أسماء مضيفي ONLYOFFICE أو وجهات الخادم الوكيل، ثم عدّل فقط قسم الخادم المخصص لخادم المستندات. احتفظ بالمضيفات الافتراضية غير ذات الصلة. تُدار شهادات TLS بشكل منفصل وقد تحتاجها مواقع أخرى.
كيف يمكن إزالة تثبيت Docker؟
حدد أولاً مشروع أو حاوية Compose المحددة. بالنسبة لتثبيت Compose، انتقل إلى الدليل الذي يحتوي على ملف Compose ذي الصلة وأوقف المشروع:
docker compose down
يؤدي هذا إلى إزالة حاويات المشروع وشبكته، ولكن عادةً ما يتم الاحتفاظ بوحدات التخزين المسماة. وهذا مفيد عند إعادة التثبيت أو الحاجة إلى البيانات المخزنة. إذا كنت تنوي الحذف النهائي، فراجع ملف Compose واعرض قائمة وحدات التخزين قبل إزالة أي شيء.
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
تُوثّق صورة Docker الرسمية لـ ONLYOFFICE المسارات الدائمة، بما في ذلك /var/log/onlyoffice` /var/www/onlyoffice/Data<path>` و`<path>` و` /var/lib/onlyoffice<path>`؛ كما يُمكن تخزين بيانات PostgreSQL بشكل منفصل. يُمكن لإعدادات Compose ربط هذه المسارات بوحدات تخزين مُسماة أو أدلة المضيف. احفظ نسخًا احتياطية من أي شهادات أو بيانات تحتاجها. احذف فقط وحدات التخزين والأدلة المُثبتة التي تأكدتَ من انتمائها حصريًا إلى نشر خادم المستندات هذا.
بعد المراجعة، يمكن لمشروع Compose إزالة وحدات التخزين المسماة المعلنة باستخدام:
docker compose down --volumes
استخدم هذا الأمر فقط عندما تنوي حذف البيانات الدائمة للمشروع. لا تقم بتشغيله docker volume pruneكاختصار؛ فقد يؤدي ذلك إلى حذف وحدات تخزين غير مستخدمة وغير ذات صلة. بالنسبة للحاوية التي تم تشغيلها باستخدام الأمر docker run، أوقف الحاوية المحددة وأزلها، ثم افحص نقاط ربطها بشكل منفصل، وأزل مسارات البيانات أو وحدات التخزين التي اخترت حذفها فقط.
docker stop <container_name>
docker rm <container_name>
أخيرًا، قم بإزالة صورة ONLYOFFICE فقط إذا لم تكن هناك حاوية متبقية بحاجة إليها. استخدم الصورة والوسم المحددين اللذين تم الإبلاغ عنهما بواسطة docker image ls:
docker image rm onlyoffice/documentserver:<tag>
يشرح مستودع Docker الرسمي مسارات بيانات الصورة واستخدام وحدات التخزين. قد تختلف نقاط التحميل الفعلية للحاوية قيد التشغيل عن الإعدادات الافتراضية، لذا اعتمد docker inspectعلى ملف Compose الخاص بك بدلاً من الافتراضات.
كيف يمكنني إلغاء تثبيت حزمة Snap؟
إذا snap listظهرت صورة ONLYOFFICE Docs، فإن مستودع الصور الرسمي يقوم بإزالة المستندات باستخدام:
sudo snap remove onlyoffice-ds
ثم تحقق snap listمرة أخرى. إزالة اللقطات وحذف اللقطات المحفوظة أو بيانات المستخدم عمليتان منفصلتان؛ افحص اللقطات المحفوظة باستخدام snap savedأداة ONLYOFFICE، واحذف فقط لقطة ONLYOFFICE التي تنوي التخلص منها. لا تحذف بيانات اللقطات المشتركة أو اللقطات بشكل عشوائي.
الفحوصات النهائية بعد إلغاء التثبيت
- تأكد من أن الحزمة أو Snap أو الحاوية التي استهدفتها لم تعد مثبتة أو قيد التشغيل.
- تأكد من أن عنوان URL القديم لخادم المستندات لم يعد يستجيب من شبكة موثوقة أو من المضيف نفسه.
- تحقق من أن أي تطبيق متصل قد تم توجيهه إلى خادم مستندات بديل أو تم تعطيل موصله.
- قم بمراجعة إعدادات Nginx وجدار الحماية وDNS وTLS بحثًا عن إدخالات خاصة بـ ONLYOFFICE، وقم بإزالة تلك التي لم تعد مستخدمة فقط.
- تحقق من استخدام القرص وقائمة التبعيات المتبقية لمدير الحزم. احتفظ بقواعد البيانات المشتركة، والخوادم الوكيلة، ووسطاء الرسائل، والخطوط إذا كانت خدمة أخرى تحتاج إليها.
في حال فشل إزالة الحزمة، اقرأ رسالة الخطأ كاملةً وتحقق من حالة الحزمة قبل محاولة فرض خيارات الإزالة. قد يتطلب وجود خلل في برنامج الصيانة أو انقطاع في الترقية إصلاحًا خاصًا بنظام التشغيل وإصدار الحزمة؛ لذا فإن فرض الإزالة دون تشخيص قد يؤدي إلى عدم اتساق حالة مدير الحزم. يُفضّل اتباع إجراء الإزالة القياسي كلما نجح.
المراجع الرسمية