วิธีตั้งค่า Kopano Z-Push สำหรับการซิงค์ข้อมูลมือถือ ActiveSync

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

เลือกการตั้งค่าที่เหมาะสมกับสภาพแวดล้อมของคุณ

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

สำหรับเซิร์ฟเวอร์ Kopano Core ที่มีอยู่แล้ว ระบบแบ็กเอนด์ของ Kopano คือจุดเริ่มต้นที่เหมาะสมที่สุด เลือกใช้ IMAP ร่วมกับ CalDAV/CardDAV เฉพาะเมื่อระบบเหล่านั้นมีข้อมูลที่เกี่ยวข้อง หรือเมื่อคุณต้องการแยกแหล่งข้อมูลออกจากกันโดยตั้งใจ การเปลี่ยนแบ็กเอนด์ไม่ได้หมายความว่าฟีเจอร์จะไม่เปลี่ยนแปลง: พฤติกรรมการซิงโครไนซ์ สมุดที่อยู่ งาน โฟลเดอร์สาธารณะ และความเข้ากันได้อาจแตกต่างกัน

ก่อนทำการติดตั้งหรือเปลี่ยนแปลงการตั้งค่า

• จดบันทึกเวอร์ชันของ Kopano Core, Z-Push, PHP, เว็บเซิร์ฟเวอร์ และระบบปฏิบัติการของคุณ ตรวจสอบความเข้ากันได้ของแพ็กเกจที่คุณวางแผนจะใช้ เวอร์ชัน PHP ที่ Z-Push รองรับเพียงอย่างเดียวไม่ได้รับประกันว่าส่วนขยาย Kopano MAPI จะใช้งานได้กับเวอร์ชันนั้น
• เลือกชื่อโฮสต์สาธารณะที่ไคลเอ็นต์จะใช้ เช่นsync.example.comและเตรียมใบรับรอง TLS ที่เชื่อถือได้สำหรับชื่อนั้น
• ตัดสินใจว่า Z-Push จะทำงานบนโฮสต์ Kopano หรือเว็บเซิร์ฟเวอร์แยกต่างหาก โฮสต์แยกต่างหากสามารถแยกบริการที่เข้าถึงได้จากเว็บได้ แต่ต้องมีการเข้าถึงเครือข่ายไปยัง Kopano ที่ใช้งานได้ และที่อยู่เซิร์ฟเวอร์ MAPI ที่กำหนดค่าอย่างถูกต้อง
• สำรองข้อมูลการตั้งค่าและสถานะของ Z-Push ก่อนทำการอัปเกรด สถานะของ Z-Push จะติดตามการซิงโครไนซ์อุปกรณ์ คู่มือการอัปเกรดของ Kopano ระบุว่าให้เก็บรักษาสถานะสำหรับโปรไฟล์มือถือที่มีอยู่
• เลือกประเภทข้อมูลที่ผู้ใช้แต่ละคนควรซิงโครไนซ์ และตรวจสอบข้อกำหนดนโยบายอุปกรณ์ก่อนลงทะเบียนโทรศัพท์ส่วนตัวหรือโทรศัพท์ของบริษัท

กำหนดค่าฝั่งเซิร์ฟเวอร์

1. ติดตั้งชุดแพ็คเกจ Z-Push ที่เข้ากันได้

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

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

2. เลือกแบ็กเอนด์ Kopano และที่อยู่เซิร์ฟเวอร์

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

// Example only: confirm the setting and file path in your installed package.
define('BACKEND_PROVIDER', 'BackendKopano');

ชื่อไฟล์และค่าคงที่อาจแตกต่างกันไปในแต่ละเวอร์ชันที่เผยแพร่ ควรเก็บข้อมูลลับไว้ให้ห่างจากตัวอย่างการกำหนดค่าสาธารณะ จำกัดสิทธิ์การเข้าถึงไฟล์การกำหนดค่า และตรวจสอบให้แน่ใจว่ารันไทม์ PHP ที่ใช้โดย Apache หรือ PHP-FPM สามารถโหลดส่วนขยาย Kopano MAPI ที่จำเป็นได้ สภาพแวดล้อม PHP บนบรรทัดคำสั่งที่ทำงานได้ดีไม่ได้หมายความว่ารันไทม์ PHP บนเว็บจะมีส่วนขยายเดียวกันเปิดใช้งานอยู่

3. เผยแพร่เอนด์พอยต์ ActiveSync ผ่าน HTTPS

ไคลเอ็นต์จำเป็นต้องมี URL HTTPS ที่เสถียรสำหรับตัวจัดการ ActiveSync ซึ่งโดยทั่วไปจะเป็นชื่อโฮสต์ตามด้วย/Microsoft-Server-ActiveSync. กำหนดค่า Apache, Nginx หรือพร็อกซีแบบย้อนกลับที่เลือกไว้เพื่อกำหนดเส้นทางเส้นทางนั้นไปยังจุดเริ่มต้นของ Z-Push รักษาปลายทางหลักไว้ที่ชื่อโฮสต์เดียวกันและหลีกเลี่ยงการเปลี่ยนเส้นทางที่เปลี่ยนวิธีการร้องขอหรือส่งไคลเอ็นต์มือถือไปยังเส้นทางอื่น คู่มือของ Kopano เตือนอย่างชัดเจนเกี่ยวกับการเปลี่ยนชื่อไดเร็กทอรี Z-Push เพื่อสร้างปลายทางเนื่องจากการเปลี่ยนเส้นทางอาจทำให้การซิงโครไนซ์อุปกรณ์เสียหายได้

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

4. ตั้งค่าสถานะการเขียนและตำแหน่งบันทึกข้อมูล

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

ตั้งค่าบัญชีมือถือ

บนโทรศัพท์ ให้เพิ่มบัญชีทำงานหรือบัญชี Exchange แล้วเลือก Exchange ActiveSync, Microsoft Exchange หรือตัวเลือกที่เทียบเท่าที่โปรแกรมอีเมลนั้นมีให้ ชื่อและหน้าจออาจแตกต่างกันไปตามระบบปฏิบัติการและโปรแกรมอีเมล ป้อนที่อยู่อีเมลและข้อมูลประจำตัวของผู้ใช้ หากการค้นหาอัตโนมัติไม่พบเซิร์ฟเวอร์ ให้ป้อนชื่อโฮสต์ Z-Push และหากมีการร้องขอ ให้ป้อนปลายทาง ActiveSync ใช้รูปแบบชื่อผู้ใช้ที่การตั้งค่าการตรวจสอบสิทธิ์ Kopano ของคุณต้องการ อย่าคิดว่าที่อยู่อีเมลและชื่อผู้ใช้ Kopano จะเหมือนกันเสมอไป

เปิดใช้งาน SSL/TLS ไว้ และยอมรับนโยบายอุปกรณ์เฉพาะหลังจากตรวจสอบแล้วว่าอนุญาตอะไรบ้าง เช่น การกำหนดให้ใส่รหัสผ่าน หรือการใช้การควบคุมอุปกรณ์ที่องค์กรจัดการ เลือกหมวดหมู่ที่จะซิงค์: อีเมล รายชื่อติดต่อ ปฏิทิน และงาน (ถ้ามี) คู่มือการใช้งานอุปกรณ์เคลื่อนที่ Kopano รุ่นเก่า อธิบายขั้นตอนการทำงานทั่วไปของบัญชี Exchange แต่ภาพหน้าจอและป้ายกำกับระบบปฏิบัติการนั้นล้าสมัยแล้ว ให้ทำตามคำแนะนำของโทรศัพท์รุ่นปัจจุบันแทนที่จะคัดลอกเส้นทางเมนูเก่าๆ อย่างตรงตัว

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

ตรวจสอบแต่ละชั้นก่อนลงทะเบียนอุปกรณ์เพิ่มเติม

1. จุดเชื่อมต่อ:เปิดชื่อโฮสต์สาธารณะในเบราว์เซอร์และตรวจสอบว่าใบรับรอง TLS นั้นถูกต้อง หากพบข้อผิดพลาดในเบราว์เซอร์หรือคำเตือนเกี่ยวกับใบรับรอง ควรแก้ไขข้อผิดพลาดเหล่านั้นก่อนเพิ่มบัญชี
2. การกำหนดเส้นทางเว็บ:ตรวจสอบว่าเส้นทาง ActiveSync ไปถึงตัวจัดการ Z-Push โดยไม่มีการวนลูปการเปลี่ยนเส้นทางหรือหน้า 404 ทั่วไปของเว็บเซิร์ฟเวอร์ ปลายทางคือตัวจัดการโปรโตคอล ไม่ใช่เว็บไซต์ปกติ
3. การตรวจสอบสิทธิ์ฝั่งแบ็กเอนด์:ใช้บัญชีทดสอบและยืนยันว่าบันทึกของ Z-Push แสดงการเชื่อมต่อกับแบ็กเอนด์สำเร็จโดยไม่ต้องเปิดเผยรหัสผ่านหรือโทเค็น
4. การซิงค์เบื้องต้น:เพิ่มโทรศัพท์ทดสอบหนึ่งเครื่องและตรวจสอบโฟลเดอร์อีเมล รายชื่อติดต่อ ปฏิทิน และงานที่เลือกไว้ การเข้าสู่ระบบสำเร็จไม่ได้หมายความว่าข้อมูลทุกประเภทจะซิงค์ได้อย่างถูกต้อง
5. การเปลี่ยนแปลงแบบสองทาง:สร้างกิจกรรมในปฏิทินทดสอบบนโทรศัพท์และยืนยันว่าปรากฏใน Kopano จากนั้นทำการเปลี่ยนแปลงทดสอบใน Kopano และยืนยันว่าการเปลี่ยนแปลงนั้นส่งไปถึงโทรศัพท์แล้ว
6. เริ่มใหม่และกู้คืน:เริ่มบริการเว็บใหม่ในช่วงเวลาทดสอบที่วางแผนไว้ ตรวจสอบว่าการซิงค์กลับมาทำงานได้ และยืนยันว่าไดเร็กทอรีสถานะยังคงไม่เปลี่ยนแปลง

แก้ไขปัญหาตามอาการ

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

คุณควรเลือกการกำหนดค่าแบบใด?

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

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