วิธีการตั้งค่าปลั๊กอิน Kopano WebApp File Previewer และ MDM

คุณสามารถเปิดใช้งานตัวแสดงตัวอย่างไฟล์ของ Kopano WebApp ได้โดยไม่ต้องติดตั้งแพ็กเกจ “FileViewer” แยกต่างหากในการตั้งค่าตามเอกสาร แต่ MDM เป็นปลั๊กอินแยกต่างหากที่ต้องติดตั้งและเชื่อมต่อกับ Z-Push ความแตกต่างนี้มีความสำคัญ: คู่มือผู้ดูแลระบบ WebApp อธิบายถึงตัวแสดงตัวอย่างผ่านทางENABLE_FILE_PREVIEWERในขณะที่คู่มือ MDM อธิบายถึงแพ็กเกจเฉพาะ ไฟล์การกำหนดค่า และส่วนประกอบที่จำเป็น การติดตั้งส่วนเสริม “Files” ที่ไม่ถูกต้องจะไม่สามารถเปิดใช้งานตัวแสดงตัวอย่างได้

คู่มือนี้จัดทำขึ้นสำหรับผู้ดูแลระบบที่ใช้งาน Kopano WebApp อยู่แล้ว คู่มือ WebApp และ MDM ที่เผยแพร่โดย Kopano เป็นเอกสารรุ่นเก่า ดังนั้นโปรดตรวจสอบให้แน่ใจว่าชื่อแพ็กเกจและการตั้งค่าตรงกับเวอร์ชัน WebApp, PHP, Z-Push และระบบปฏิบัติการที่คุณใช้งานอยู่ก่อนที่จะทำการเปลี่ยนแปลง ขั้นตอนด้านล่างนี้จะอธิบายเส้นทางที่ระบุไว้ในเอกสารและวิธีการตรวจสอบอย่างปลอดภัย

คุณหมายถึงการแสดงตัวอย่างไฟล์ หรือปลั๊กอิน Kopano Files ครับ/คะ?

ใช้การตั้งค่าตัวแสดงตัวอย่างไฟล์ในตัวเมื่อผู้ใช้ต้องการดูตัวอย่างไฟล์แนบที่รองรับใน WebApp ตัวเลือกผู้ดูแลระบบที่ระบุไว้ในเอกสารคือENABLE_FILE_PREVIEWER; ซึ่งควบคุมว่าผู้ใช้จะได้รับตัวเลือกการแสดงตัวอย่างหรือไม่ คู่มือ WebApp ไม่ได้อธิบายสิ่งนี้ว่าเป็นแพ็กเกจ FileViewer แยกต่างหากที่คุณติดตั้งด้วยตัวจัดการแพ็กเกจ

Kopano Files แตกต่างออกไป มันเพิ่มพื้นที่สำหรับจัดการไฟล์และเรียกดูบัญชีเก็บข้อมูลภายนอก เช่น WebDAV หรือแบ็กเอนด์อื่นๆ ที่กำหนดค่าไว้ อาจต้องใช้แพ็กเกจแยกต่างหากและการกำหนดค่าแบ็กเอนด์ หากเป้าหมายของคุณคือการแสดงตัวอย่างไฟล์แนบ ให้เริ่มต้นด้วยการตั้งค่าตัวแสดงตัวอย่าง ไม่ใช่ Kopano Files หากเป้าหมายคือการเชื่อมต่อพื้นที่เก็บข้อมูลที่ใช้ร่วมกันกับ WebApp ให้ทำตามคู่มือ Files แยกต่างหากที่ลิงก์ไว้ตอนท้าย

MDM ทำอะไร และมีประโยชน์เมื่อใด?

ปลั๊กอินการจัดการอุปกรณ์เคลื่อนที่ของ Kopano แสดงข้อมูลและการดำเนินการสำหรับอุปกรณ์เคลื่อนที่ที่ซิงโครไนซ์กับ Kopano ผ่าน Z-Push ขึ้นอยู่กับการใช้งาน ผู้ใช้สามารถดูรายละเอียดอุปกรณ์และใช้การดำเนินการต่างๆ เช่น การซิงโครไนซ์ใหม่ การลบ การรีเฟรช หรือการล้างข้อมูล ปลั๊กอินนี้มีประโยชน์เมื่อผู้ใช้หรือผู้ดูแลระบบต้องการควบคุมอุปกรณ์เหล่านั้นในเว็บแอปพลิเคชัน ไม่ใช่สิ่งที่จะมาทดแทน Z-Push และไม่ได้สร้างการซิงโครไนซ์อุปกรณ์เคลื่อนที่ด้วยตัวเอง

คู่มือ Kopano MDM ระบุว่าต้องใช้ Z-Push เวอร์ชัน 2.0 หรือสูงกว่า และ PHP SOAP เป็นส่วนประกอบที่จำเป็น หาก Z-Push ทำงานบนโฮสต์ที่แตกต่างจาก WebApp การกำหนดค่า MDM ต้องชี้ไปยังเซิร์ฟเวอร์ Z-Push นั้น ก่อนติดตั้งอะไรก็ตาม โปรดตรวจสอบปลายทางของ Z-Push, รันไทม์ PHP ที่ติดตั้ง และความเข้ากันได้ของแพ็กเกจสำหรับสภาพแวดล้อมของคุณ

จะเปิดใช้งานโปรแกรมแสดงตัวอย่างไฟล์ได้อย่างไร?

ขั้นแรก ให้ค้นหา WebApp config.phpที่ใช้งานอยู่ในการติดตั้งของคุณ โดยทั่วไปแล้ว ในการติดตั้งแบบแพ็กเกจ ไฟล์นี้จะอยู่ใน `/etc/webapp/config/` /etc/kopano/webapp/แต่สำหรับการติดตั้งแบบคอนเทนเนอร์และการติดตั้งแบบกำหนดเอง อาจมีการติดตั้งไฟล์การกำหนดค่าไว้ที่อื่น สำรองไฟล์ต้นฉบับก่อนทำการแก้ไข และหลีกเลี่ยงการสร้างคำจำกัดความที่สองหากมีการตั้งค่าดังกล่าวอยู่แล้ว

ในการตั้งค่าที่ใช้งานอยู่ ให้ค้นหาENABLE_FILE_PREVIEWER. เอกสารคู่มือผู้ดูแลระบบ Kopano WebApp trueระบุว่าจะแสดงตัวเลือกให้ผู้ใช้สามารถเปิดใช้งานตัวแสดงตัวอย่างไฟล์ในการตั้งค่าของพวกเขา และfalseจะซ่อนตัวเลือกนั้นและปิดใช้งานการแสดงตัวอย่างสำหรับผู้ใช้ทั้งหมด ตัวอย่างเช่น:

define("ENABLE_FILE_PREVIEWER", true);

หากบรรทัดนั้นมีอยู่แล้ว ให้แก้ไขค่าของบรรทัดนั้นแทนที่จะสร้างบรรทัดซ้ำdefine()คงโครงสร้างไวยากรณ์ PHP รอบข้างไว้เหมือนเดิม หากไม่มีบรรทัดดังกล่าว ให้ใช้เทมเพลตหรือคำแนะนำการกำหนดค่าที่ตรงกับแพ็กเกจ WebApp ที่ติดตั้งไว้แทนที่จะคัดลอกการกำหนดค่าตัวอย่างทั้งหมดลงในไฟล์จริง

หลังจากบันทึกแล้ว ให้ตรวจสอบข้อผิดพลาดทางไวยากรณ์ PHP โดยใช้ตัวแปล PHP ที่ให้บริการ WebApp ตัวอย่างเช่น หากไฟล์การกำหนดค่าอยู่ที่พาธแพ็กเกจมาตรฐาน:

php -l /etc/kopano/webapp/config.php

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

วิธีการติดตั้งปลั๊กอิน MDM ทำอย่างไร?

ใช้แพ็คเกจ MDM ที่สร้างขึ้นสำหรับ Kopano WebApp เวอร์ชันและการแจกจ่ายเดียวกันกับเซิร์ฟเวอร์ คู่มือ Kopano MDM ระบุแพ็คเกจตระกูล Debian ที่ชื่อว่าkopano-webapp-plugins-mdmและแพ็คเกจ RPM สำหรับการแจกจ่ายแบบ RPM โดยแสดงรูปแบบการติดตั้ง Debian ไว้ด้านล่าง โปรดแทนที่ตัวยึดตำแหน่งด้วยเวอร์ชันแพ็คเกจจริงที่ได้จากแหล่งแพ็คเกจที่เชื่อถือได้และเข้ากันได้ของคุณ:

sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb

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

ตรวจสอบให้แน่ใจว่าได้เปิดใช้งานส่วนขยาย PHP SOAP ในสภาพแวดล้อม PHP ที่เว็บแอปพลิเคชันใช้งานอยู่ การตรวจสอบอย่างรวดเร็วทำได้ดังนี้:

php -m | grep -i '^soap$'

หากไม่มีผลลัพธ์ใดๆ ให้ติดตั้งและเปิดใช้งานส่วนขยาย SOAP ที่ตรงกับเวอร์ชัน PHP และรันไทม์ของเว็บเซิร์ฟเวอร์ที่ WebApp ใช้งาน การตรวจสอบ PHP ผ่าน CLI อาจแตกต่างจาก PHP-FPM หรือโมดูล PHP ของ Apache ดังนั้นให้เปรียบเทียบการกำหนดค่าเว็บเซิร์ฟเวอร์หากคำสั่งแสดงว่ามี SOAP แต่ MDM ยังคงรายงานว่าไม่มีฟังก์ชัน SOAP

คุณควรตั้งค่าการเชื่อมต่อเซิร์ฟเวอร์ MDM อย่างไร?

คู่มือ MDM ที่เผยแพร่จะจัดเก็บการตั้งค่าไว้ใน/etc/kopano/webapp/config-mdm.phpไฟล์ . สำรองไฟล์ไว้ก่อน จากนั้นตรวจสอบตัวเลือกที่ระบุไว้ในเอกสาร:

• PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMควบคุมว่าจะเปิดใช้งานปลั๊กอินโดยอัตโนมัติสำหรับผู้ใช้หรือไม่ โดยในคู่มือระบุค่าเริ่มต้นเป็นfalse.
• PLUGIN_MDM_SERVERระบุเซิร์ฟเวอร์ Z-Push โดยค่าเริ่มต้นที่ระบุไว้คือlocalhost.
• PLUGIN_MDM_SERVER_SSLควรตั้งค่าเป็นtrueเมื่อการเชื่อมต่อใช้ SSL/TLS โดยค่าเริ่มต้นที่ระบุไว้ในเอกสารfalseคือ

หาก WebApp และ Z-Push อยู่บนโฮสต์ที่แยกจากกัน ให้แทนที่การตั้งค่าเซิร์ฟเวอร์เริ่มต้นด้วยตำแหน่ง Z-Push จริงที่จำเป็นสำหรับการใช้งานของคุณ ใช้โปรโตคอลและชื่อโฮสต์ที่ถูกต้อง และเปิดใช้งานตัวเลือก SSL เมื่อปลายทางนั้นใช้ HTTPS อย่าเปิดเผยปลายทางสู่สาธารณะเพียงเพื่อให้ปลั๊กอินตอบสนอง ให้สามารถเข้าถึงได้ผ่านเส้นทางเครือข่ายที่ตั้งใจไว้และใบรับรองที่ถูกต้อง รักษาไวยากรณ์ PHP ที่ใช้โดยไฟล์ที่ติดตั้งไว้

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

จะเปิดใช้งาน MDM ในบัญชีผู้ใช้ได้อย่างไร?

หลังจากติดตั้งและกำหนดค่าแพ็กเกจแล้ว ให้ลงชื่อเข้าใช้ WebApp และเปิดการตั้งค่า จากนั้นไปที่แท็บปลั๊กอิน เลือก MDM และใช้การเปลี่ยนแปลง คู่มือ MDM ระบุว่าภาพรวมของอุปกรณ์จะปรากฏในแท็บ MDM แยกต่างหากในการตั้งค่า และรวมถึงข้อมูลอุปกรณ์ การซิงโครไนซ์ครั้งล่าสุด และรหัสอุปกรณ์ หากไม่พบปลั๊กอิน ให้ตรวจสอบก่อนว่าไฟล์แพ็กเกจได้รับการติดตั้งในไดเร็กทอรีปลั๊กอิน WebApp ที่ใช้งานอยู่ และการตั้งค่าปลั๊กอินโดยรวมไม่ได้ซ่อนหรือปิดใช้งานปลั๊กอินนั้น

ทดสอบด้วยบัญชีที่มีอุปกรณ์ที่ซิงค์ผ่าน Z-Push อยู่แล้ว หากรายการอุปกรณ์ว่างเปล่า ให้ตรวจสอบว่าบัญชีนั้นมีอุปกรณ์ Z-Push หรือไม่ ตรวจสอบว่าการตั้งค่าเซิร์ฟเวอร์ MDM ชี้ไปยังบริการ Z-Push ที่ถูกต้องหรือไม่ และตรวจสอบว่า PHP SOAP พร้อมใช้งานสำหรับกระบวนการ WebApp หรือไม่ ตรวจสอบบันทึกของ WebApp และ Z-Push เกี่ยวกับคำขอทดสอบก่อนที่จะเปลี่ยนแปลงการตั้งค่าเซิร์ฟเวอร์ที่ไม่เกี่ยวข้อง

สิ่งที่คุณควรรู้ก่อนใช้ Wipe หรือ Remove คืออะไร?

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

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

คุณจะตรวจสอบคุณสมบัติทั้งสองได้อย่างไร?

สำหรับการแสดงตัวอย่างไฟล์ ให้ตรวจสอบว่าผู้ใช้สามารถมองเห็นและเปิดใช้งานการตั้งค่าได้ จากนั้นเปิดไฟล์แนบที่รองรับโดยไม่ต้องดาวน์โหลดก่อน สำหรับ MDM ให้ตรวจสอบว่าผู้ใช้ทดสอบสามารถมองเห็นข้อมูลอุปกรณ์ที่คาดหวังได้ และรายละเอียดการซิงค์ครั้งล่าสุดตรงกับอุปกรณ์ที่ทราบว่ากำลังซิงค์ผ่าน Z-Push ทดสอบการดำเนินการที่มีความเสี่ยงต่ำ เช่น การรีเฟรชหรือการซิงค์ใหม่ก่อน ปิดใช้งานหรือจำกัดการล้างข้อมูลตามนโยบายขององค์กรของคุณจนกว่าคุณจะตรวจสอบผลกระทบของการดำเนินการดังกล่าวแล้ว

หากไม่พบตัวควบคุมการแสดงตัวอย่าง ให้ตรวจสอบการกำหนดค่า WebApp ที่ใช้งานอยู่และการตั้งค่าผู้ใช้อีกครั้ง หากไม่พบ MDM หรือไม่แสดงอุปกรณ์ใด ๆ ให้ตรวจสอบความเข้ากันได้ของแพ็กเกจ PHP SOAP เส้นทางการกำหนดค่า MDM โฮสต์ Z-Push และข้อจำกัดปลั๊กอินทั่วโลก คู่มือที่เผยแพร่โดย Kopano อธิบายชื่อการตั้งค่าและรูปแบบแพ็กเกจ แต่ไม่ได้ระบุความเข้ากันได้สำหรับทุกการแจกจ่ายและเวอร์ชัน PHP ในปัจจุบัน โปรดใช้เอกสารแพ็กเกจสำหรับการสร้างเซิร์ฟเวอร์ที่แน่นอนเป็นข้อมูลอ้างอิงสุดท้าย

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

• คู่มือผู้ดูแลระบบ Kopano WebApp: การตั้งค่าปลั๊กอินและตัวแสดงตัวอย่างไฟล์
• คู่มือการใช้งาน Kopano MDM: การติดตั้งและส่วนประกอบที่จำเป็น
• คู่มือการใช้งาน Kopano MDM: ไฟล์การกำหนดค่าและตัวเลือกต่างๆ
• คู่มือการใช้งาน Kopano MDM: การเปิดใช้งานปลั๊กอินและการดำเนินการกับอุปกรณ์
• คู่มือไฟล์ Kopano WebApp: การติดตั้งปลั๊กอินไฟล์แยกต่างหาก