Rezolvă problemele legate de Profile Manager în macOS Server

Află cum să găsești și să remediezi problemele dacă Profile Manager nu funcționează conform așteptărilor.

Dacă nu poți să accesezi pagina de administrare

Configurația de bază a Profile Manager se află în aplicația Server. Trebuie să utilizezi Safari pentru a accesa pagina web /mydevices din Profile Manager și pagina web de administrare.

Doar administratorii serverului pot accesa pagina de administrare. Formatul URL pentru pagina de administrare este:

https://numele_domeniului_complet_calificat_al_serverului_tău/profilemanager
- Exemplu: https://www.example.com/profilemanager

Pentru a înscrie un dispozitiv iPhone, iPad, iPod touch sau Mac, accesează:

https://numele_domeniului_complet_calificat_al_serverului_tău/mydevices
- Exemplu: https://www.example.com/mydevices

Dacă nu poți să accesezi pagina de administrare cu un browser web, altul decât Safari, încearcă cu Safari. Dacă nu poți să o accesezi cu Safari, verifică serverul DNS. Configurările DNS sunt importante atunci când gestionezi o implementare Profile Manager. Dacă Profile Manager nu se deschide, asigură-te că serverul direcționează spre un server DNS de încredere.

Dacă nu poți transfera profilurile sau aplicațiile către clienți

Dacă te confrunți cu probleme atunci când transferi profiluri sau aplicații către sistemele clienților, verifică fișierul jurnalului de sistem din Console. Dacă acesta raportează că serverul nu poate accesa serverele APNS ale Apple Asigură-te că toate porturile necesare sunt deschise.

Pentru mai multe informații, activează jurnalizarea erorilor APNS utilizând aceste comenzi Terminal:

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

Poți să vizualizezi jurnalele din aplicația Console filtrând subsistemele com.apple.apsd și com.apple.apspd.

După ce tranzacțiile APNS sunt înregistrate, utilizează aceste comenzi Terminal pentru a dezactiva jurnalizarea erorilor:

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

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

sudo killall apsd

Dacă te confrunți cu alte probleme legate de Profile Manager

Jurnalele Profile Manager te pot ajuta să remediezi problemele legate de Profile Manager. Poți găsi un link simbolic numit „devicemgr” în /var/log. Acest fișier te direcționează spre /Library/Logs/ProfileManager, unde poți găsi aceste jurnale:

AuditLogs	Fișierele din acest director asigură jurnalizarea în format CSV a solicitărilor și a răspunsurilor din jurnalele de servicii corespunzătoare, cum ar fi toate comenzile trimise către un dispozitiv sau toate acțiunile inițiate de un anumit utilizator. Fiecare fișier include un antet care descrie datele înregistrate în fiecare coloană.
devicemgrd.log	Indică starea de interogare și de sincronizare a utilizatorilor și grupurilor Open Directory și Active Directory. Raportează erorile apărute din interogările executate de devicemgrd. Afișează intrările legate de trimiterea notificărilor push. Afișează intrările legate de tranzacțiile DEP și VPP.
dmAuthService.log	Înregistrează starea încercărilor de autentificare online a utilizatorilor.
dmDeviceService.log	Înregistrează interacțiunile dintre Profile Manager și dispozitivele pe care le gestionează.
dmhttpd.log	Înregistrează date HTTP de nivel înalt pentru solicitările și răspunsurile serviciilor Profile Manager.
dmPortalService.log	Înregistrează solicitările și erorile de pe portalul de utilizator /mydevices.
dmSCEPService.log	Înregistrează solicitările și erorile pentru serviciul SCEP (utilizat în timpul înscrierii dispozitivului)
dmWebAdminService.log	Înregistrează solicitările și erorile apărute în timpul utilizării administratorului web /profilemanager.
dm_helper.log	Înregistrează informații legate de autentificarea utilizatorilor MDM de la utilizatorii rețelei macOS.
dmrunnerd.log	Afișează starea de pornire și de oprire a proceselor ruby gestionate care acceptă pagina web Profile Manager (/profilemanager și /mydevices). Acest jurnal este uneori gol.
migration_tool.log	Afișează starea și detaliile migrării de la o versiune Server.app anterioară.
php-fpm.log	Afișează starea de pornire și de oprire a proceselor individuale de asistență php-fpm.
php-fpm.devicemgr.log	În acest fișier sunt înregistrate problemele legate de PHP.
PostgreSQL-	Înregistrează orice interogare în baza de date PostgreSQL a Profile Manager care generează o eroare. Acesta înregistrează, de asemenea, comenzile care modifică schema bazei de date.
servermgr_devicemgr.log	Înregistrează pornirea și oprirea serviciului Profile Manager.

Acest jurnal poate oferi informații utile legate de serverul web:

/var/log/apache2/service_proxy_error.log

Următoarea comandă Terminal poate furniza informații suplimentare:

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

Despre „erorile” de tranzacționare

Unele dintre aceste jurnale pot indica „erorile” sau reîncercările de tranzacționare. Cele mai multe dintre aceste intrări sunt preconizate și nu indică o problemă. Aceste evenimente înregistrate sunt conflicte între încercările de a modifica baza de date PostgreSQL principală în același timp. Aceste tipuri de erori reîncearcă până când reușesc.

Poți identifica conflictele de tranzacții atunci când vezi oricare dintre aceste note în fișierele jurnal:

Anulat din cauza conflictului de pivotare
nu s-a putut serializa accesul din cauza actualizării simultane
@@@ Reîncercați #X
@@@ Reîncercați X

Verifică fișierul apspd CFPrefs

Navighează la /Library/Preferences/ApplePushServiceProvider, selectează com.apple.apspd.plist, apoi alege Fișier > Obțineți informații. Dacă fișierul este mai mare de 5KB, șterge-l și repornește procesul apspd cu următoarea comandă Terminal:

sudo killall apspd

Utilizează jurnalizarea detaliată în jurnal pentru a afla mai multe informații

Mai multe informații despre cum să remediezi o problemă sunt uneori disponibile dacă mărești nivelul de jurnalizare. Pentru a colecta informațiile de care ai nevoie, reprodu problema după ce mărești nivelul de jurnalizare.

După ce ai terminat, revino la nivelul de jurnalizare inițial. Dacă lași nivelul de jurnalizare la o setare mai mare, spațiul disponibil pe unitatea de pornire scade.

Activarea jurnalizării detaliate

Pentru a mări nivelul de jurnalizare, utilizează această comandă Terminal:

sudo debugDeviceMgr 4

Aceasta repornește automat serviciul Profile Manager.

Dezactivarea jurnalizării detaliate

Pentru a reveni la nivelul de jurnalizare inițial, utilizează această comandă Terminal:

sudo debugDeviceMgr 1