วิธีการถอนการติดตั้ง ONLYOFFICE Document Server ออกจากระบบ Linux อย่างสมบูรณ์

การลบ ONLYOFFICE Document Server ที่ล้มเหลวอาจทำให้ไฟล์บริการ การกำหนดค่า ไดเร็กทอรีข้อมูล วอลุ่ม Docker หรือแพ็กเกจที่จำเป็นของตัวจัดการแพ็กเกจหลงเหลืออยู่ วิธีที่ปลอดภัยในการลบออกอย่างสมบูรณ์คือ การระบุวิธีการติดตั้ง ปล่อยให้ ONLYOFFICE ปิดเซสชันที่ใช้งานอยู่ ลบแพ็กเกจหรือคอนเทนเนอร์ที่ตรงกัน จากนั้นตรวจสอบข้อมูลถาวรและบริการที่ใช้ร่วมกันก่อนที่จะลบสิ่งอื่นใด

เริ่มต้นด้วยการสำรองข้อมูลหากเซิร์ฟเวอร์ยังคงมีเอกสาร ไฟล์แคชที่คุณอาจต้องการ ใบรับรอง หรือการกำหนดค่าแบบกำหนดเอง การถอนการติดตั้ง Document Server อาจทำให้ Nextcloud, ownCloud หรือแอปพลิเคชันอื่นที่เชื่อมต่อกับเซิร์ฟเวอร์นั้นหยุดชะงักได้ นอกจากนี้ “ลบ ONLYOFFICE” ไม่ได้หมายความว่า “จะลบ PostgreSQL, Nginx, RabbitMQ, Redis หรือฟอนต์ที่ใช้ร่วมกัน” โดยอัตโนมัติ เพราะสิ่งเหล่านั้นอาจจำเป็นสำหรับซอฟต์แวร์อื่น

ก่อนถอนการติดตั้ง ให้ระบุประเภทการติดตั้ง

ตรวจสอบฐานข้อมูลแพ็กเกจและ Snap ก่อน:

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 และการประกาศ volume ก่อนดำเนินการต่อ หากติดตั้ง ONLYOFFICE Docs ด้วย Helm บน Kubernetes ให้ใช้คำแนะนำในการถอนการติดตั้งของ chart แทนคำสั่งติดตั้งแพ็กเกจ Linux

จะถอนการติดตั้งไฟล์ DEB หรือ RPM ได้อย่างไร?

1. บันทึกงานและตัดการเชื่อมต่อผู้ใช้อย่างถูกต้อง

สำหรับขั้นตอนการติดตั้งแพ็กเกจที่กล่าวถึงในคู่มือการลบแพ็กเกจสำหรับ Linux ของ ONLYOFFICE โปรดเรียกใช้สคริปต์เตรียมการปิดระบบก่อนที่จะลบแพ็กเกจ:

sudo documentserver-prepare4shutdown.sh

สคริปต์นี้จะปิดเซสชันที่ใช้งานอยู่และช่วยให้มั่นใจได้ว่าเอกสารจะถูกบันทึก ONLYOFFICE แจ้งว่าอาจใช้เวลาถึงห้านาที กำหนดเวลาดำเนินการขั้นตอนนี้ในช่วงเวลาการบำรุงรักษาและแจ้งผู้ใช้ที่เชื่อมต่ออยู่ก่อน หากไม่พบคำสั่ง ให้ตรวจสอบแพ็กเกจที่ติดตั้งและดูหน้าการลบอย่างเป็นทางการของรุ่นที่ตรงกันแทนที่จะใช้สคริปต์ที่ไม่เกี่ยวข้อง

2. ลบแพ็กเกจออกจาก Ubuntu หรือ Debian

สำหรับ Community Edition ชื่อแพ็กเกจอย่างเป็นทางการคือonlyoffice-documentserver:

sudo apt purge onlyoffice-documentserver

ชื่อแพ็กเกจจะแตกต่างกันไปตามเวอร์ชัน คู่มือการลบเวอร์ชันนักพัฒนาอย่างเป็นทางการใช้ชื่อแพ็กเกจดังนี้onlyoffice-documentserver-deตรวจสอบชื่อที่แสดงอย่างถูกต้องdpkg -lและปฏิบัติตามคำแนะนำของผู้จำหน่ายที่ตรงกัน อย่าลบแพ็กเกจที่มีชื่อคล้ายกันโดยการเดา

คำสั่ง APT purge จะลบไฟล์ไบนารีและไฟล์กำหนดค่าของแพ็กเกจ แต่ ONLYOFFICE จะระบุว่าไฟล์ที่จำเป็นซึ่งติดตั้งมาพร้อมกับแพ็กเกจยังคงอยู่ โปรดตรวจสอบสิ่งที่ APT แนะนำก่อนที่จะยืนยัน หลีกเลี่ยงการเรียกใช้งานapt autoremoveโดยอัตโนมัติ: โปรดอ่านรายการแพ็กเกจก่อน และเก็บไฟล์ใดๆ ที่ใช้งานโดยบริการอื่นๆ ไว้

3. ลบแพ็กเกจ RPM บน CentOS หรือระบบที่เข้ากันได้

หน้าการลบ Community Edition มีคำสั่งนี้สำหรับ CentOS:

sudo yum remove onlyoffice-documentserver

ในระบบที่ใช้ DNF ให้ใช้ชื่อแพ็กเกจที่รายงานโดย RPM และตรวจสอบธุรกรรมที่เสนออีกครั้งก่อนยืนยัน:

sudo dnf remove onlyoffice-documentserver

ความแตกต่างของรุ่นและที่เก็บซอฟต์แวร์อาจทำให้ชื่อแพ็กเกจเปลี่ยนไป คำแนะนำอย่างเป็นทางการของ ONLYOFFICE ได้ระบุyumคำสั่งสำหรับ CentOS ไว้อย่างชัดเจน โปรดตรวจสอบชื่อแพ็กเกจที่เทียบเท่าสำหรับระบบปฏิบัติการของคุณก่อนที่จะลบเวอร์ชัน Enterprise หรือ Developer

คุณควรจัดการกับไฟล์และส่วนประกอบที่เหลืออยู่อย่างไร?

หากโปรแกรมถอนการติดตั้งรายงานว่าไดเร็กทอรีไม่ว่างเปล่า ONLYOFFICE /etc/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 หรือปลายทางพร็อกซี จากนั้นแก้ไขเฉพาะบล็อกเซิร์ฟเวอร์ที่กำหนดไว้สำหรับ Document Server เท่านั้น เก็บรักษาโฮสต์เสมือนที่ไม่เกี่ยวข้องไว้ ใบรับรอง 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, และ/var/lib/onlyoffice; ข้อมูล PostgreSQL อาจถูกจัดเก็บแยกต่างหากได้เช่นกัน การตั้งค่า Compose สามารถแมปเส้นทางเหล่านี้ไปยังวอลุ่มที่มีชื่อหรือไดเร็กทอรีโฮสต์ได้ สำรองข้อมูลใบรับรองหรือข้อมูลใดๆ ที่คุณต้องการ ลบเฉพาะวอลุ่มและไดเร็กทอรีที่เชื่อมต่อแบบ bind-mounted ที่คุณระบุอย่างชัดเจนแล้วว่าเป็นของ Document Server เวอร์ชันนี้เท่านั้น

หลังจากตรวจสอบแล้ว โปรเจ็กต์ 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 ที่คุณต้องการลบเท่านั้น อย่าลบข้อมูลสแนปช็อตที่แชร์หรือสแนปช็อตโดยไม่เลือกปฏิบัติ

ตรวจสอบขั้นสุดท้ายหลังการถอนการติดตั้ง

• ตรวจสอบให้แน่ใจว่าแพ็กเกจ Snap หรือคอนเทนเนอร์ที่คุณต้องการลบนั้นไม่ได้ติดตั้งหรือกำลังทำงานอยู่แล้ว
• ตรวจสอบว่า URL ของเซิร์ฟเวอร์เอกสารเก่าไม่ตอบสนองจากเครือข่ายที่เชื่อถือได้หรือจากโฮสต์เองอีกต่อไปแล้ว
• ตรวจสอบให้แน่ใจว่าแอปพลิเคชันที่เชื่อมต่ออยู่ทั้งหมดได้ชี้ไปยังเซิร์ฟเวอร์เอกสารทดแทน หรือได้ปิดใช้งานตัวเชื่อมต่อแล้ว
• ตรวจสอบการตั้งค่า Nginx, ไฟร์วอลล์, DNS และ TLS สำหรับรายการที่เกี่ยวข้องกับ ONLYOFFICE โดยเฉพาะ และลบเฉพาะรายการที่ไม่ใช้งานแล้วออกเท่านั้น
• ตรวจสอบการใช้งานพื้นที่ดิสก์และรายการการพึ่งพาที่เหลืออยู่ของตัวจัดการแพ็กเกจ เก็บฐานข้อมูลที่ใช้ร่วมกัน พร็อกซี ตัวกลางรับส่งข้อความ และฟอนต์ไว้หากบริการอื่นต้องการใช้งาน

หากการลบแพ็กเกจล้มเหลว โปรดอ่านข้อผิดพลาดทั้งหมดและตรวจสอบสถานะของแพ็กเกจก่อนที่จะลองใช้ตัวเลือกบังคับ สคริปต์ของผู้ดูแลระบบที่เสียหายหรือการอัปเกรดที่ถูกขัดจังหวะอาจต้องได้รับการซ่อมแซมเฉพาะสำหรับระบบปฏิบัติการและเวอร์ชันแพ็กเกจนั้นๆ การบังคับลบโดยไม่วินิจฉัยอาจทำให้สถานะของตัวจัดการแพ็กเกจไม่สอดคล้องกัน จึงควรใช้วิธีการลบแบบมาตรฐานหากใช้งานได้

เอกสารอ้างอิงอย่างเป็นทางการ

• ONLYOFFICE Docs Community Edition: การลบการติดตั้ง Linux
• ONLYOFFICE Docs Developer Edition: การลบการติดตั้งบนระบบ Linux
• อิมเมจ Docker ของ ONLYOFFICE Document Server และเส้นทางข้อมูลถาวร
• คำแนะนำในการติดตั้งและถอนการติดตั้ง ONLYOFFICE Docs Snap
• เอกสาร ONLYOFFICE เกี่ยวกับ Kubernetes: การถอนการติดตั้ง Helm