Probleme mit dem Profilmanager in macOS Server beheben

Hier erfährst du, wie du Probleme ermittelst und behebst, falls der Profilmanager nicht wie erwartet funktioniert.

Kein Zugriff auf die Verwaltungsseite

Die erste Einrichtung des Profilmanagers erfolgt in der Server-App. Du musst Safari verwenden, um auf die mydevices-Webseite des Profilmanagers sowie die Verwaltungswebseite zuzugreifen.

Nur Server-Administratoren haben Zugriff auf deine Verwaltungsseite. Die URL der Verwaltungsseite hat folgendes Format:

• https://vollständig_qualifizierter_domainname_deines_servers/profilemanager

  • Beispiel: https://www.example.com/profilemanager

Um ein iPhone, iPad, einen iPod touch oder Mac zu registrieren, wechsle zu:

• https://vollständig_qualifizierter_domainname_deines_servers/mydevices

  • Beispiel: https://www.example.com/mydevices

Wenn du mit keinem anderen Webbrowser als Safari auf die Verwaltungsseite zugreifen kannst, versuche es mit Safari. Wenn du mit Safari nicht darauf zugreifen kannst, überprüfe deinen DNS-Server. DNS-Einstellungen sind wichtig, wenn du eine Profilmanager-Bereitstellung verwaltest. Stelle sicher, dass dein Server auf einen zuverlässigen DNS-Server verweist, falls sich der Profilmanager nicht öffnen lässt.

Die Push-Übertragung von Profilen oder Apps auf Client-Systeme schlägt fehl

Wenn Probleme beim Übertragen von Profilen oder Apps auf Client-Systeme auftreten, überprüfe die Systemprotokolldatei in der Konsole. Falls du die Meldung erhältst, dass der Server die APNs Stelle sicher, dass alle erforderlichen Ports offen sind.

Aktiviere für weitere Informationen die APNS-Fehlerprotokollierung mit den folgenden Terminal-Befehlen:

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

Du kannst die Protokolle in der Konsole-App anzeigen, indem du nach den Subsystemen in com.apple.apsd und com.apple.apspd filterst.

Nach der Protokollierung der APNS-Transaktionen kannst du das Fehlerprotokoll mithilfe der folgenden Terminal-Befehle deaktivieren:

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

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

sudo killall apsd

Es treten andere Probleme mit dem Profilmanager auf

Profilmanager-Protokolle können bei der Behebung von Problemen mit dem Profilmanager hilfreich sein. Unter /var/log findest du einen symbolischen Link mit dem Namen „devicemgr“. Diese Datei verweist auf den Ordner /Library/Logs/ProfileManager, in dem sich die folgenden Protokolle befinden:

Dieses Protokoll kann hilfreiche Informationen zum Webserver enthalten:

• /var/log/apache2/service_proxy_error.log

Über den folgenden Terminal-Befehl kannst du weitere Informationen erhalten:

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

Informationen zu Transaktions-“Fehlern“

Manche dieser Protokolle führen unter Umständen „Fehler“ oder erneute Versuche bei Transaktionen auf. Die meisten dieser Einträge erfolgen erwartungsgemäß und deuten nicht auf Probleme hin. Diese protokollierten Ereignisse zeigen Konflikte, die durch gleichzeitige Versuche, Änderungen an der zugrundeliegenden PostgreSQL-Datenbank vorzunehmen, auftreten. Bei dieser Art von Fehlschlägen wird der Prozess bis zum Erfolg wiederholt.

Transaktionskonflikte erkennst du an den folgenden Hinweisen in den Protokolldateien:

• Canceled on conflict out to pivot

• could not serialize access due to concurrent update

• @@@ Retry #X

• @@@ Retry X

Überprüfe die CFPrefs-Datei „apspd“

Navigiere zu /Library/Preferences/ApplePushServiceProvider, wähle com.apple.apspd.plist aus, und wähle dann „Ablage“ > „Informationen“ aus. Wenn die Datei größer als 5 KB ist, entferne sie, und starte den apspd-Prozess mit dem folgenden Terminal-Befehl neu:

sudo killall apspd

Ausführliche Protokollierung verwenden, um weitere Informationen zu erhalten

In manchen Fällen erhältst du weitere Informationen zur Lösung eines Problems durch die Wahl einer höheren Protokollierungsstufe. Um die benötigten Informationen zu erhalten, reproduziere das Problem nach der Erhöhung der Protokollierungsstufe.

Stelle nach Abschluss des Vorgangs wieder die ursprüngliche Protokollierungsstufe ein. Wenn du die höhere Stufe beibehältst, sinkt der verfügbare Speicherplatz auf dem Startvolume.

Ausführliche Protokollierung aktivieren

Mithilfe dieses Terminal-Befehls kannst du die Protokollierungsstufe erhöhen:

sudo debugDeviceMgr 4

Ausführliche Protokollierung deaktivieren

Verwende diesen Terminal-Befehl, um zur ursprünglich gewählten Protokollierungsstufe zurückzukehren:

sudo debugDeviceMgr 1

Weitere Informationen

• Informationen zu vom Profilmanager verwendeten Ports.

• Profilmanager-Benutzerhandbuch aufrufen.

• Hier erfährst du, wie du vorgehst, wenn du den Push-Mitteilungsdienst von Apple nicht nutzen kannst.