แก้ไขปัญหาตัวจัดการโปรไฟล์ใน macOS Server

ดูวิธีค้นหาและแก้ไขปัญหาหากตัวจัดการโปรไฟล์ไม่ทำงานตามที่คาด

ถ้าคุณไม่สามารถเข้าถึงหน้าการดูแลระบบได้

การตั้งค่าพื้นฐานของตัวจัดการโปรไฟล์อยู่ในแอป Server คุณต้องใช้ Safari เพื่อเข้าถึงหน้าเว็บ /mydevices ของตัวจัดการโปรไฟล์และหน้าเว็บการดูแลระบบ

เฉพาะผู้ดูแลเซิร์ฟเวอร์เท่านั้นที่สามารถเข้าถึงหน้าการดูแลของคุณได้ รูปแบบ URL สําหรับหน้าการดูแลระบบของคุณคือ

  • https://ชื่อโดเมนแบบเต็มของเซิร์ฟเวอร์ของคุณ/profilemanager

    • ตัวอย่าง: https://www.example.com/profilemanager

เมื่อต้องการลงทะเบียน iPhone, iPad, iPod touch หรือ Mac ให้ไปที่

  • https://ชื่อโดเมนแบบเต็มของเซิร์ฟเวอร์ของคุณ/mydevices

    • ตัวอย่าง: https://www.example.com/mydevices

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

หากคุณไม่สามารถพุชโปรไฟล์หรือแอปไปยังไคลเอนต์ได้

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

สําหรับข้อมูลเพิ่มเติม ให้เปิดการเก็บบันทึกการแก้ไขจุดบกพร่อง APNS ด้วยคำสั่งเทอร์มินัลเหล่านี้

sudo defaults write /Library/Preferences/com.apple.apsd APSWriteLogs -bool TRUE

sudo defaults write /Library/Preferences/com.apple.apsd APSLogLevel -int 7

sudo killall apsd

คุณสามารถดูบันทึกในแอปคอนโซลโดยการกรองในระบบย่อย com.apple.apsd และ com.apple.apspd

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

sudo defaults write /Library/Preferences/com.apple.apsd APSWriteLogs -bool FALSE

sudo defaults delete /Library/Preferences/com.apple.apsd APSLogLevel

sudo killall apsd

หากคุณได้รับปัญหาอื่นๆ เกี่ยวกับตัวจัดการโปรไฟล์

บันทึกของตัวจัดการโปรไฟล์สามารถช่วยคุณแก้ไขปัญหาเกี่ยวกับตัวจัดการโปรไฟล์ได้ คุณสามารถค้นหาลิงก์สัญลักษณ์ที่ชื่อ "devicemgr" ที่ /var/log ไฟล์นี้ชี้ไปที่ /Library/Logs/ProfileManager ซึ่งคุณสามารถค้นหาบันทึกเหล่านี้:

AuditLogs

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

devicemgrd.log

  • แสดงสถานะของการสอบถามและการซิงค์ผู้ใช้และกลุ่มของ Open Directory และ Active Directory

  • รายงานข้อผิดพลาดที่เกิดขึ้นจากข้อสอบถามที่ดําเนินการโดย devicemgrd

  • แสดงรายการที่เกี่ยวข้องกับการส่งการแจ้งเตือนแบบพุช

  • แสดงรายการที่เกี่ยวข้องกับรายการ DEP และ VPP

dmAuthService.log

  • บันทึกสถานะของการตรวจสอบสิทธิ์ผู้ใช้บนเว็บ

dmDeviceService.log

  • บันทึกการโต้ตอบระหว่างตัวจัดการโปรไฟล์และอุปกรณ์ที่จัดการ

dmhttpd.log

  • บันทึกข้อมูล HTTP ระดับสูงสําหรับคำขอและการตอบกลับของบริการตัวจัดการโปรไฟล์

dmPortalService.log

  • บันทึกคำขอและข้อผิดพลาดจากพอร์ทัลผู้ใช้ /mydevices

dmSCEPService.log

  • บันทึกคำขอและข้อผิดพลาดสําหรับบริการ SCEP (ใช้ในระหว่างการลงทะเบียนอุปกรณ์)

dmWebAdminService.log

  • บันทึกคำขอและข้อผิดพลาดขณะใช้ผู้ดูแลเว็บ /profilemanager

dm_helper.log

  • บันทึกข้อมูลที่เกี่ยวข้องกับการตรวจสอบสิทธิ์ผู้ใช้ที่เกี่ยวข้องกับ MDM จากผู้ใช้เครือข่าย macOS

dmrunnerd.log

  • แสดงสถานะของการเริ่มต้นและหยุดกระบวนการ Ruby ที่มีการจัดการที่รองรับหน้าเว็บตัวจัดการโปรไฟล์ (/profilemanager และ /mydevices) บางครั้งบันทึกนี้ก็ว่างเปล่า

migration_tool.log

  • แสดงสถานะและรายละเอียดของการโยกย้ายจากเวอร์ชัน Server.app ก่อนหน้า

php-fpm.log

  • แสดงสถานะของการเริ่มต้นและหยุดกระบวนการตัวช่วย php-fpm แต่ละกระบวนการ

php-fpm.devicemgr.log

  • ปัญหาเกี่ยวกับ PHP จะถูกบันทึกลงในไฟล์นี้

PostgreSQL-

  • บันทึกข้อสอบถามใดๆ ที่มีฐานข้อมูล PostgreSQL ของตัวจัดการโปรไฟล์ที่ส่งผลให้เกิดข้อผิดพลาด

  • ซึ่งจะบันทึกคำสั่งที่เปลี่ยนแปลง Schema ฐานข้อมูลด้วย

servermgr_devicemgr.log

  • บันทึกการเริ่มต้นและการหยุดบริการตัวจัดการโปรไฟล์

บันทึกนี้สามารถให้ข้อมูลที่เป็นประโยชน์เกี่ยวกับเว็บเซิร์ฟเวอร์ได้

  • /var/log/apache2/service_proxy_error.log

คำสั่งเทอร์มินัลต่อไปนี้สามารถให้ข้อมูลเพิ่มเติมแก่คุณ

sudo log show --info --debug --predicate "(eventMessage contains[cd] 'devicemgr') or (category contains[cd] 'HTTPServer')"

เกี่ยวกับรายการ "ความล้มเหลว"

บันทึกบางรายการเหล่านี้อาจแสดงรายการ "ความล้มเหลว" หรือการลองใหม่ รายการส่วนใหญ่เหล่านี้การทำงานปกติอยู่แล้วและไม่ได้แสดงถึงปัญหา เหตุการณ์ที่บันทึกเหล่านี้ขัดแย้งกันระหว่างความพยายามในการปรับเปลี่ยนฐานข้อมูล PostgreSQL ที่จำเป็นในเวลาเดียวกัน ความล้มเหลวประเภทเหล่านี้จะลองใหม่จนกว่าจะทำสําเร็จ

คุณสามารถระบุความขัดแย้งของรายการเมื่อคุณเห็นหมายเหตุใดๆ เหล่านี้ในไฟล์บันทึกของคุณ

  • Canceled on conflict out to pivot

  • could not serialize access due to concurrent update

  • @@@ Retry #X

  • @@@ Retry X

ตรวจสอบไฟล์ apspd CFPrefs

ไปที่ /Library/Preferences/ApplePushServiceProvider แล้วเลือก com.apple.apspd.plist จากนั้นเลือกไฟล์ > ขอรายละเอียด หากไฟล์มีขนาดเกิน 5KB ให้ลบออก แล้วรีสตาร์ทกระบวนการ apspd ด้วยคำสั่งเทอร์มินัลดังต่อไปนี้

sudo killall apspd

ใช้การบันทึกการใช้งานอย่างละเอียดเพื่อค้นหาข้อมูลเพิ่มเติม

บางครั้งอาจมีข้อมูลเพิ่มเติมเกี่ยวกับวิธีการแก้ไขปัญหาถ้าคุณเพิ่มระดับบันทึก หากต้องการรวบรวมข้อมูลที่คุณต้องการ ให้จำลองปัญหาหลังจากที่คุณเพิ่มระดับการบันทึก

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

เปิดการบันทึกการใช้งานอย่างละเอียด

หากต้องการเพิ่มระดับการบันทึก ให้ใช้คำสั่งเทอร์มินัลนี้

sudo debugDeviceMgr 4

ซึ่งจะรีสตาร์ทบริการตัวจัดการโปรไฟล์โดยอัตโนมัติ

ปิดการบันทึกการใช้งานอย่างละเอียด

เมื่อต้องการแปลงระดับการบันทึกกลับไปเป็นการตั้งค่าเดิม ให้ใช้คำสั่งเทอร์มินัลนี้

sudo debugDeviceMgr 1

ซึ่งจะรีสตาร์ทบริการตัวจัดการโปรไฟล์โดยอัตโนมัติ

ดูเพิ่มเติม

วันที่เผยแพร่: