หาก ownCloud แสดงข้อความ “การตรวจสอบความสมบูรณ์ล้มเหลว” หลังจากอัปเกรด ให้เปิดคำเตือนของผู้ดูแลระบบก่อน แล้วตรวจสอบรายงานไฟล์ที่ไม่ถูกต้อง อย่าแก้ไขsignature.jsonปิดใช้งานการตรวจสอบ หรือเรียกใช้การอัปเกรดซ้ำโดยไม่ตรวจสอบให้ดี รายงานจะระบุว่าปัญหาเกิดจากไฟล์หลักไม่ตรงกัน ไฟล์หายไปหรือมีไฟล์เกิน หรือปัญหาเกี่ยวกับลายเซ็นแอป ให้กู้คืนเฉพาะโค้ดที่ได้รับผลกระทบจากเวอร์ชันทางการที่ถูกต้อง หรือติดตั้งแอปที่ลงนามแล้วที่เข้ากันได้ จากนั้นสแกนอีกครั้ง วิธีนี้ใช้ได้กับ ownCloud Server (Classic) เท่านั้น Infinite Scale ใช้สถาปัตยกรรมที่แตกต่างกันและไม่ได้ใช้occเวิร์กโฟลว์การตรวจสอบความสมบูรณ์ ของ PHP นี้
ตัวอย่างเช่น หากการอัปเกรดจากเวอร์ชัน 10.x หนึ่งไปยังอีกเวอร์ชันหนึ่งทำให้เกิดข้อผิดพลาดindex.phpและversion.phpถูกระบุว่าINVALID_HASHมีปัญหา สาเหตุที่เป็นไปได้คือไฟล์หลักบางไฟล์ยังคงเป็นของเวอร์ชันอื่นหรือถูกแก้ไข หากมีเพียงแอปที่ติดตั้งด้วยตนเองเท่านั้นที่ถูกระบุว่าข้อมูลลายเซ็นหายไป การแทนที่ไฟล์หลักจะไม่สามารถแก้ไขปัญหาได้ รายละเอียดของข้อผิดพลาดจะเป็นตัวกำหนดว่าควรแก้ไขด้วยวิธีใด
อ่านรายงานก่อนทำการเปลี่ยนแปลงไฟล์
ลงชื่อเข้าใช้ในฐานะผู้ดูแลระบบและเปิดคำเตือนความสมบูรณ์ของโค้ดสีเหลือง จากนั้นเลือกที่ลิงก์เพื่อแสดงรายการไฟล์ที่ไม่ถูกต้อง เอกสารประกอบ ownCloud 10.16 อธิบายรายงานนี้และตัวเลือกการสแกนหน้าผู้ดูแลระบบใหม่ หากไม่สามารถเข้าถึงหน้าเว็บได้ ให้เรียกใช้การตรวจสอบจากไดเร็กทอรีการติดตั้ง ownCloud ในฐานะผู้ใช้เว็บเซิร์ฟเวอร์:
sudo -u www-data ./occ integrity:check-core
sudo -u www-data ./occ integrity:check-app <appid>
แทนที่www-dataด้วยบัญชีที่ใช้โดยเว็บเซิร์ฟเวอร์ของคุณ และแทนที่<appid>ด้วยรหัสแอปที่แสดงในรายงาน บน Docker ให้เรียกใช้occคำสั่งเดียวกันภายในคอนเทนเนอร์ ownCloud โดยใช้วิธีการปรับใช้ตามปกติ คำสั่งเหล่านี้จะตรวจสอบไฟล์หลักและแอปที่ระบุชื่อ คู่มือ ownCloud ระบุว่าไม่มีคำสั่งแบบแมนนวลเพียงคำสั่งเดียวที่จะสแกนทุกแอป
ใช้ประเภทข้อผิดพลาดเพื่อเลือกการดำเนินการถัดไป:
INVALID_HASHไฟล์ ดังกล่าวมีค่าแฮชแตกต่างจากลายเซ็น อาจเป็นการอัปเกรดเวอร์ชันบางส่วนหรือแบบผสม การแก้ไขในเครื่อง หรือการเปลี่ยนแปลงที่ไม่คาดคิด โปรดเปรียบเทียบไฟล์กับเวอร์ชันทางการที่ถูกต้องก่อนทำการแทนที่
FILE_MISSINGไฟล์ที่มีลายเซ็นหายไป กู้คืนจากแพ็กเกจรุ่นที่ตรงกัน ก่อนอื่นตรวจสอบให้แน่ใจว่าการติดตั้ง การบรรจุ หรือสิทธิ์การเข้าถึงไม่ได้ละเว้นไฟล์ดังกล่าว
EXTRA_FILEไฟล์ ดังกล่าวมีอยู่ในไดเร็กทอรีที่มีการลงชื่อ แต่ไม่ได้เป็นส่วนหนึ่งของลายเซ็นนั้น อาจเป็นไฟล์ที่เหลือมาจากเวอร์ชันเก่าหรือไฟล์ที่เพิ่มเข้ามาภายในเครื่อง โปรดระบุเจ้าของและวัตถุประสงค์ของไฟล์ก่อนที่จะลบออก
EXCEPTIONข้อมูลลายเซ็น อาจไม่มีอยู่ ไม่ถูกต้อง อยู่นอกขอบเขต หรือเชื่อมโยงกับใบรับรองที่ถูกเพิกถอน สำหรับแอปพลิเคชัน ให้ตรวจสอบซอร์สโค้ดและสถานะการเผยแพร่ และขอเวอร์ชันที่ลงนามแล้วที่เข้ากันได้จากผู้ดูแลแอป
แอปของบุคคลที่สามที่ติดตั้งด้วยตนเองอาจทำให้เกิดคำเตือนได้หากแอปนั้นไม่ได้ลงนาม ownCloud ระบุว่าแอปที่ไม่ได้ลงนามซึ่งติดตั้งนอก Marketplace อาจยังคงถูกตั้งค่าสถานะเตือนอยู่ อย่างไรก็ตาม นั่นไม่ได้อธิบายถึงแฮชหลักที่ไม่ถูกต้อง ควรแยกผลลัพธ์ของแอปและผลลัพธ์ของโค้ดหลักออกจากกันขณะทำการวินิจฉัย
แก้ไขความไม่ตรงกันหลักจากเวอร์ชันที่ตรงกัน
- ทำการสำรองข้อมูลที่สามารถกู้คืนได้ก่อนที่จะแทนที่ไฟล์เซิร์ฟเวอร์ ให้เก็บรักษาฐานข้อมูล การกำหนดค่า และข้อมูลต่างๆ ตามขั้นตอนการสำรองข้อมูลสำหรับการใช้งานของคุณ หากการอัปเกรดไม่สมบูรณ์หรือบริการไม่เสถียร ให้เปิดใช้งานโหมดบำรุงรักษาและหยุดการรับส่งข้อมูลเว็บก่อนทำการซ่อมแซม อย่าใช้สำเนาไฟล์แทนการสำรองฐานข้อมูล
- ตรวจสอบให้แน่ใจว่า ownCloud เวอร์ชันที่ใช้งานอยู่จริงคือเวอร์ชันใดตรวจสอบภาพรวมการดูแลระบบและข้อมูลเวอร์ชันบนดิสก์ ตรวจสอบให้แน่ใจว่ากระบวนการอัปเกรดเสร็จสมบูรณ์และโหนดคลัสเตอร์หรือคอนเทนเนอร์ทั้งหมดใช้เวอร์ชันเป้าหมายเดียวกัน ตรวจสอบบันทึกการอัปเกรดเพื่อหาการแตกไฟล์ที่ถูกขัดจังหวะ ข้อผิดพลาดด้านสิทธิ์ หรือคำสั่งที่หยุดทำงานก่อนกำหนด
- ดาวน์โหลดไฟล์เก็บถาวรอย่างเป็นทางการสำหรับเวอร์ชันนั้นโดยเฉพาะอย่าใช้ไฟล์เก็บถาวร "ล่าสุด" หากระบบของคุณใช้เวอร์ชันก่อนหน้า แตกไฟล์ไปยังไดเร็กทอรีชั่วคราวแยกต่างหาก และเปรียบเทียบเฉพาะเส้นทางที่ถูกทำเครื่องหมายไว้เท่านั้น หากไฟล์ใดถูกปรับแต่งโดยระบบปฏิบัติการหรือเครื่องมือการติดตั้งของคุณ โปรดทำความเข้าใจการปรับแต่งนั้นก่อนที่จะทำการแทนที่ไฟล์
- โปรด เปลี่ยนไฟล์หลักที่ได้รับผลกระทบอย่างระมัดระวังสำหรับไฟล์หลักที่ได้รับการยืนยันแล้ว ให้คัดลอกเวอร์ชันอย่างเป็นทางการจากไฟล์เก็บถาวรที่ตรงกัน โดยรักษาการกำหนดค่า ข้อมูล และไดเร็กทอรีแอปที่เข้ากันได้ของอินสแตนซ์ไว้ หลีกเลี่ยงการวางทับไฟล์เก็บถาวรเซิร์ฟเวอร์ใหม่บนโครงสร้างเก่าโดยไม่ปฏิบัติตามคำแนะนำในการอัปเกรด ไฟล์ที่เหลือจากเวอร์ชันก่อนหน้าอาจทำให้เกิด
EXTRA_FILEปัญหาได้ กู้คืนความเป็นเจ้าของและสิทธิ์การเข้าถึงตามปกติโดยใช้วิธีการที่ระบุไว้ในเอกสารสำหรับการติดตั้งของคุณ
- เรียกใช้การตรวจสอบที่เกี่ยวข้องอีกครั้งใช้
integrity:check-coreสำหรับผลการค้นพบหลักหรือintegrity:check-app <appid>สำหรับแอปพลิเคชันเดียว คุณยังสามารถใช้การดำเนินการสแกนซ้ำในหน้าผู้ดูแลระบบได้ ห้ามแก้ไขหรือลบด้วยตนเองsignature.jsonเนื่องจากเป็นข้อมูลลายเซ็นที่ผู้ตรวจสอบต้องการ
คำแนะนำเกี่ยวกับการลงนามรหัสของ ownCloud ให้ตัวอย่างเช่น การกู้คืนไฟล์ที่ถูกต้องindex.phpจากversion.phpไฟล์เก็บถาวรของเวอร์ชัน การลบไฟล์ส่วนเกินที่ไม่จำเป็น และการกู้คืนไฟล์ที่หายไป.htaccessจากไฟล์ tarball อย่างเป็นทางการของเซิร์ฟเวอร์ ตัวอย่างเหล่านี้ไม่ใช่รายการทดแทนที่ครอบคลุมทั้งหมด: โปรดดำเนินการตามเส้นทางที่ระบุในรายงานของคุณอย่างถูกต้อง
จัดการคำเตือนของแอปโดยไม่ต้องปิดบังข้อความนั้น
สำหรับแอปที่พบปัญหาหลังจากการอัปเกรดเซิร์ฟเวอร์ ให้ตรวจสอบก่อนว่าแอปนั้นรองรับเวอร์ชัน ownCloud ที่ต้องการหรือไม่ ปิดใช้งานแอปที่ไม่เข้ากันผ่านขั้นตอนการดูแลระบบหรือบรรทัดคำสั่งที่รองรับ จากนั้นติดตั้งเวอร์ชันที่เข้ากันได้จาก Marketplace หรือผู้ดูแลแอป หากแอปที่เคยลงนามไว้ก่อนหน้านี้ไม่ได้รับการลงนามอีกต่อไป หรือใบรับรองถูกแจ้งว่าถูกเพิกถอน ให้ติดต่อผู้ดูแลเพื่อขอใบรับรองทดแทนที่ลงนามอย่างถูกต้อง ห้ามคัดลอกข้อมูลลายเซ็นจากแอปหรือเวอร์ชันอื่น เนื่องจากลายเซ็นนั้นเชื่อมโยงกับเนื้อหาของแอปและขอบเขตของใบรับรอง
หากแอปที่ถูกแจ้งเตือนเป็นแอปที่องค์กรของคุณดูแลเอง ผู้ดูแลแอปที่ได้รับอนุญาตจะต้องสร้างและลงนามในเวอร์ชันที่เผยแพร่โดยใช้กระบวนการที่เหมาะสมและข้อมูลรับรองการลงนามที่เชื่อถือได้ ผู้ดูแลระบบไม่ควรสร้างลายเซ็นทดแทนเพื่อให้โค้ดที่ไม่รู้จักหรือถูกแก้ไขผ่านไปได้ หากคุณไม่สามารถระบุแหล่งที่มาและความสมบูรณ์ของไฟล์ได้ ให้เก็บรายงานไว้และตรวจสอบเป็นปัญหาด้านความปลอดภัยที่อาจเกิดขึ้นแทนที่จะระงับคำเตือน
ตรวจสอบการซ่อมแซม
เรียกใช้การตรวจสอบความสมบูรณ์ที่เกี่ยวข้องอีกครั้งและรีเฟรชภาพรวมผู้ดูแลระบบ ตรวจสอบให้แน่ใจว่าเส้นทางเดิมไม่ปรากฏอีกต่อไป คำเตือนสำหรับส่วนประกอบที่ซ่อมแซมแล้วหายไป และบันทึก ownCloud ไม่แสดงข้อผิดพลาดในการอัปเกรดหรือสิทธิ์ใหม่ ทดสอบการเข้าสู่ระบบ การแสดงรายการไฟล์ การอัปโหลด และแอปที่ได้รับผลกระทบ ในการใช้งานแบบหลายโหนด ให้ตรวจสอบทุกโหนด ผลลัพธ์ที่สะอาดบนเซิร์ฟเวอร์เครื่องหนึ่งไม่ได้พิสูจน์ว่าทุกโหนดใช้โค้ดที่ตรงกัน
หากรายงานยังคงปรากฏอยู่ ให้หยุดการแทนที่ไฟล์และเปรียบเทียบโครงสร้างไฟล์ที่กำลังทำงานอยู่กับแพ็กเกจ รูปภาพการปรับใช้ หรือวอลุ่มที่เชื่อมต่อสำหรับเวอร์ชันนั้น ตรวจสอบหาสำเนาโค้ดชุดที่สอง การเชื่อมต่อแบบ bind mount ที่ค้างอยู่ สคริปต์การปรับใช้ที่กู้คืนไฟล์เก่า หรือแพตช์ในเครื่อง ปรึกษาคำแนะนำเกี่ยวกับการลงนามโค้ดและความสมบูรณ์ของ ownCloud 10.16 ที่ตรงกับ เวอร์ชันคำแนะนำในการอัปเกรด ownCloudและเอกสารการกู้คืนหน้านี้สำหรับ ownCloud Server 10.16 เวอร์ชันก่อนหน้าอาจแตกต่างกัน ดังนั้นโปรดเลือกเอกสารที่ตรงกับเวอร์ชันที่ติดตั้ง