Επίλυση προβλημάτων με τη Διαχείριση προφίλ στο 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.

Αν δεν μπορείτε να προωθήσετε προφίλ ή εφαρμογές σε συσκευές-πελάτες

Αν αντιμετωπίζετε προβλήματα όταν προωθείτε προφίλ ή εφαρμογές σε συστήματα συσκευών-πελατών, ελέγξτε το αρχείο καταγραφής του συστήματος στην Κονσόλα. Αν αναφέρει ότι ο διακομιστής σας δεν μπορεί να επικοινωνήσει με τους διακομιστές της υπηρεσίας APNs Βεβαιωθείτε ότι όλες οι απαιτούμενες θύρες είναι ανοιχτές.

Για περισσότερες πληροφορίες, ενεργοποιήστε την καταγραφή εκσφαλμάτωσης της υπηρεσίας 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.
php-fpm.log	Εμφανίζει την κατάσταση έναρξης και διακοπής των μεμονωμένων διεργασιών βοηθού php-fpm.
php-fpm.devicemgr.log	Τα προβλήματα με το PHP καταγράφονται σε αυτό το αρχείο.
PostgreSQL-	Καταγράφει τυχόν ερωτήματα με τη βάση δεδομένων PostgreSQL της Διαχείρισης προφίλ που οδηγούν σε σφάλμα. Καταγράφει επίσης εντολές που αλλάζουν το σχήμα της βάσης δεδομένων.
servermgr_devicemgr.log	Καταγράφει την έναρξη και τη διακοπή της υπηρεσίας Διαχείρισης προφίλ.

Αυτό το αρχείο καταγραφής μπορεί να παρέχει χρήσιμες πληροφορίες σχετικά με τον διακομιστή ιστού:

/var/log/apache2/service_proxy_error.log

Η ακόλουθη εντολή Τερματικού μπορεί να σας παράσχει πρόσθετες πληροφορίες:

sudo log show --info --debug --predicate "(το eventMessage περιέχει[cd] 'devicemgr') ή (η κατηγορία περιέχει[cd] 'HTTPServer')"

Πληροφορίες για τις «αποτυχίες» συναλλαγών

Ορισμένα από αυτά τα αρχεία καταγραφής ενδέχεται να απαριθμούν «αποτυχίες» συναλλαγών ή επανειλημμένες προσπάθειες συναλλαγών. Οι περισσότερες από αυτές τις καταχωρίσεις είναι αναμενόμενες και δεν υποδεικνύουν πρόβλημα. Αυτά τα καταγεγραμμένα συμβάντα είναι διενέξεις μεταξύ ταυτόχρονων προσπαθειών για την τροποποίηση της υποκείμενης βάσης δεδομένων PostgreSQL. Οι αποτυχίες αυτού του είδους επαναλαμβάνουν την ενέργεια μέχρι να πετύχουν.

Μπορείτε να εντοπίσετε τις διενέξεις συναλλαγών, αν δείτε οποιαδήποτε από αυτές τις σημειώσεις στα αρχεία καταγραφής σας:

Ακυρώθηκε κατά τη διένεξη στον συγκεντρωτικό πίνακα
Δεν ήταν δυνατή η σειριοποίηση της πρόσβασης λόγω ταυτόχρονης ενημέρωσης
@@@ Επανάληψη #X
@@@ Επανάληψη X

Έλεγχος του αρχείου apspd CFPrefs

Μεταβείτε στη διαδρομή /Library/Preferences/ApplePushServiceProvider, επιλέξτε το αρχείο com.apple.apspd.plist και κατόπιν Αρχείο Πληροφορίες. Αν το αρχείο έχει μέγεθος πάνω από 5 KB, αφαιρέστε το και ξεκινήστε ξανά τη διαδικασία apspd με την ακόλουθη εντολή Τερματικού:

sudo killall apspd

Χρήση λεπτομερούς καταγραφής για την εύρεση περισσότερων πληροφοριών

Περισσότερες πληροφορίες σχετικά με τον τρόπο επιδιόρθωσης ενός προβλήματος είναι μερικές φορές διαθέσιμες αν αυξήσετε το επίπεδο καταγραφής. Για να συγκεντρώσετε τις πληροφορίες που χρειάζεστε, αναπαραγάγετε το πρόβλημα αφού αυξήσετε το επίπεδο καταγραφής.

Όταν τελειώσετε, κάντε επαναφορά στο αρχικό επίπεδο καταγραφής. Αν αφήσετε το επίπεδο καταγραφής σε υψηλότερη ρύθμιση, θα μειωθεί ο διαθέσιμος χώρος στη μονάδα δίσκου εκκίνησης.

Ενεργοποίηση λεπτομερούς καταγραφής

Για να αυξήσετε το επίπεδο καταγραφής, χρησιμοποιήστε αυτήν την εντολή Τερματικού:

sudo debugDeviceMgr 4

Αυτή η εντολή επανεκκινεί αυτόματα την υπηρεσία Διαχείρισης προφίλ.

Απενεργοποίηση λεπτομερούς καταγραφής

Για να επαναφέρετε το επίπεδο καταγραφής στην αρχική του ρύθμιση, χρησιμοποιήστε αυτήν την εντολή Τερματικού:

sudo debugDeviceMgr 1