פתרון בעיות עם Profile Manager ב-macOS Server

למדו כיצד למצוא ולפתור בעיות אם Profile Manager לא פועל כפי שהוא אמור לפעול.

אם אינכם מצליחים לגשת לדף הניהול

ההגדרה הבסיסית של Profile Manager מתבצעת ביישום Server. עליכם להשתמש ב-Safari כדי לגשת לדף האינטרנט ‎/mydevices של Profile Manager ולדף האינטרנט של הניהול.

רק מנהלי שרתים יכולים לגשת לדף הניהול. המבנה של כתובת ה-URL של דף הניהול הוא:

  • https://your_server's_fully_qualified_domain_name/profilemanager

    • דוגמה: https://www.example.com/profilemanager

כדי לרשום iPhone‏, iPad‏, iPod touch או Mac, יש לעבור לכתובת:

  • https://your_server's_fully_qualified_domain_name/mydevices

    • דוגמה: https://www.example.com/mydevices

אם אינכם מצליחים לגשת לדף הניהול באמצעות דפדפן אינטרנט שאינו Safari, נסו להשתמש ב-Safari. אם אינכם מצליחים לגשת אליו באמצעות Safari, בדקו את שרת ה-DNS. הגדרות DNS חשובות כשאתם מנהלים פריסה של Profile Manager. אם Profile Manager לא נפתח, ודאו שהשרת מפנה אל שרת DNS מהימן.

אם אינכם מצליחים להעביר פרופילים או אפליקציות ללקוחות

אם אתם נתקלים בבעיות כשאתם מעבירים פרופילים או אפליקציות למערכות לקוח, בדקו את קובץ יומן המערכת ב'מסוף'. אם הקובץ מדווח שהשרת אינו מצליח להגיע אל שרתי APNS (שירות התראות Push של 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

אם נתקלתם בבעיות אחרות ב-Profile Manager

יומני Profile Manager יכולים לעזור לכם לפתור בעיות ב-Profile Manager. תוכלו למצוא קישור סמלי בשם "devicemgr" בנתיב ‎/var/log. קובץ זה מפנה אל ‎/Library/Logs/ProfileManager, שם תוכלו למצוא את היומנים הבאים:

AuditLogs

  • קבצים בספריה זו מספקים רישום בפורמט CSV של בקשות ותגובות מיומני השירות המתאימים, כגון כל הפקודות שנשלחו למכשיר או כל הפעולות שביצע משתמש מסוים. לכל קובץ יש כותרת שמתארת את הנתונים שנרשמו בכל עמודה.

devicemgrd.log

  • מספק את הסטטוס של שליחת שאילתות וסנכרון של משתמשים וקבוצות של Open Directory ו-Active Directory.

  • מדווח על שגיאות המתרחשות כתוצאה משאילתות שבוצעו על ידי devicemgrd.

  • מציג רשומות הקשורות לשליחת עדכוני דחיפה.

  • מציג רשומות הקשורות לטרנזקציות DEP ו-VPP.

dmAuthService.log

  • רושם את הסטטוס של ניסיונות לאימות משתמשים מבוססי אינטרנט.

dmDeviceService.log

  • רושם אינטראקציות בין Profile Manager לבין המכשירים שהוא מנהל.

dmhttpd.log

  • רושם נתוני HTTP ברמה גבוהה עבור הבקשות והתגובות של שירותי Profile Manager.

dmPortalService.log

  • רושם בקשות ושגיאות מפורטל המשתמשים ‎/mydevices.

dmSCEPService.log

  • רושם בקשות ושגיאות ביומן עבור שירות SCEP (המשמש במהלך רישום מכשירים)

dmWebAdminService.log

  • רושם בקשות ושגיאות במהלך השימוש במנהל האתר ‎/profilemanager.

dm_helper.log

  • רושם מידע הקשור לאימות משתמשים שקשור ל-MDM ממשתמשי רשת של macOS.

dmrunnerd.log

  • מציג את המצב של הפעלה ועצירה של תהליכי Ruby המנוהלים, שתומכים בדף האינטרנט של Profile Manager ‏(‎/profilemanager ו-‎/mydevices). לפעמים היומן הזה ריק.

migration_tool.log

  • מציג את הסטטוס ואת הפרטים של העברה מגרסה קודמת של Server.app.

php-fpm.log

  • מציג את מצב ההפעלה והעצירה של תהליכי עזר נפרדים ב-php-fpm.

php-fpm.devicemgr.log

  • בעיות ב-PHP נרשמות בקובץ זה.

PostgreSQL-

  • רושם את כל השאילתות במסד הנתונים PostgreSQL של Profile Manager שגורמות לשגיאה.

  • קובץ זה מתעד גם פקודות שמשנות את סכימת מסד הנתונים.

servermgr_devicemgr.log

  • רושם את ההפעלה וההפסקה של שירות Profile Manager.

יומן זה יכול לספק מידע מועיל הקשור לשרת האינטרנט:

  • ‎/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 ('ניסיון חוזר מס' X')

  • ‎@@@ Retry X ('ניסיון חוזר X')

בדיקת הקובץ apspd CFPrefs

נווטו אל /Library/Preferences/ApplePushServiceProvider, select com.apple.apspd.plist, ולאחר מכן בחרו 'קובץ' > 'קבלת מידע'. אם הקובץ גדול מ-5KB, הסירו אותו והפעילו מחדש את תהליך apspd באמצעות פקודת ה'מסוף' הבאה:

sudo killall apspd

שימוש ברישום מילולי כדי למצוא מידע נוסף

מידע נוסף על אופן הפתרון של בעיה מסוימת זמין לעתים אם מגדילים את הרמה של יומן הרישום. כדי לקבל את המידע הדרוש, שחזרו את הבעיה לאחר הגדלת רמת הרישום.

כשתסיימו, חזרו לרמת הרישום המקורית. אם תשאירו את רמת הרישום בהגדרה גבוהה יותר, היא תקטין את השטח הזמין בכונן ההפעלה.

הפעלת רישום מילולי

כדי להגדיל את רמת הרישום, השתמשו בפקודה הבאה ב'מסוף':

sudo debugDeviceMgr 4

פקודה זו תפעיל מחדש באופן אוטומטי את שירות Profile Manager.

השבתת הרישום המילולי

כדי להחזיר את רמת הרישום להגדרה המקורית, השתמשו בפקודה הבאה ב'מסוף':

sudo debugDeviceMgr 1

פקודה זו תפעיל מחדש באופן אוטומטי את שירות Profile Manager.

מידע נוסף

Published Date: