A macOS Server Profile Manager moduljával kapcsolatos problémák elhárítása

Ismerje meg, hogyan fedheti fel és háríthatja el a problémákat, ha a Profile Manager nem működik megfelelően.

Ha nem tudja megnyitni az adminisztrációs oldalt

A Profile Manager alapvető beállításai a Server alkalmazásban találhatók. A Safari segítségével nyissa meg a Profile Manager /mydevices weboldalát és az adminisztrációs weboldalt.

Az adminisztrációs oldalhoz csak a szerver rendszergazdái férhetnek hozzá. Az adminisztrációs oldal URL-formátuma a következő:

https://a_szerver_teljes_tartomanyneve/profilemanager
- Példa: https://www.example.com/profilemanager

Ha iPhone, iPad, iPod touch vagy Mac készüléket szeretne regisztrálni, lépjen ide:

https://a_szerver_teljes_tartomanyneve/mydevices
- Példa: https://www.example.com/mydevices

Ha más böngészőben (nem a Safariban) nem tudja megnyitni az adminisztrációs oldalt, próbálkozzon a Safariban. Ha az oldal a Safariban sem érhető el, ellenőrizze a DNS-szervert. A Profile Manager-környezetek kezelése során rendkívül fontosak a DNS-beállítások. Ha a Profile Manager nem nyílik meg, ellenőrizze, hogy a szerver egy megbízható DNS-szerverre mutat-e.

Ha nem tud profilokat vagy alkalmazásokat leküldeni a kliensekre

Ha problémát tapasztal, amikor profilokat vagy alkalmazásokat próbál leküldeni a kliensrendszerekre, ellenőrizze a rendszernaplófájlt a Konzolban. Ha a naplófájlban látja, hogy a szerver nem tudja elérni az Apple APNS-szervereit Ellenőrizze, hogy az összes szükséges port nyitva van-e.

További információkért kapcsolja be az APNS hibakeresési naplózási funkcióját a következő Terminal-parancsokkal:

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

A Konzol alkalmazásban úgy tudja megtekinteni a naplófájlokat, hogy megszűri a találatokat a com.apple.apsd és a com.apple.apspd alrendszerekre.

Az APNS-tranzakciók naplózása után a következő Terminal-parancsokkal kapcsolhatja ki a hibakeresési naplózást:

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

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

sudo killall apsd

Ha más probléma merül fel a Profile Managerrel

A Profile Manager naplói segítséget nyújtanak a Profile Managerrel kapcsolatos problémák megoldásában. A „devicemgr” nevű szimbolikus hivatkozás a /var/log részben található. Ez a fájl a/Library/Logs/ProfileManager helyre mutat, ahol a következő naplók érhetők el:

AuditLogs	Az ebben a könyvtárban CSV formátumú naplófájlok rögzítik a megfelelő szolgáltatásnaplóktól érkező kérelmeket és válaszokat, például a készülékre küldött összes parancsot vagy egy konkrét felhasználó által kezdeményezett összes műveletet. E fájlokhoz fejléc is tartozik, amely leírást ad az egyes oszlopokban rögzített adatokról.
devicemgrd.log	Ez a fájl az Open Directory- és az Active Directory-felhasználók és -csoportok lekérdezéseinek és szinkronizálásának állapotát adja meg. Emellett tartalmazza a devicemgrd által végrehajtott lekérdezések során felmerülő hibákat is. Megjeleníti a push-értesítések küldésével kapcsolatos bejegyzéseket. Megjeleníti a DEP- és VPP-tranzakciókhoz kapcsolódó bejegyzéseket.
dmAuthService.log	Naplózza a webalapú felhasználóhitelesítési kísérletek állapotát.
dmDeviceService.log	Naplózza a Profile Manager és az általa kezelt eszközök közötti interakciókat.
dmhttpd.log	Naplózza a Profile Manager-szolgáltatások kérelmeinek és válaszainak felső szintű HTTP-adatait.
dmPortalService.log	Naplózza a /mydevices felhasználói portálon beküldött kérelmeket, valamint a hibákat.
dmSCEPService.log	Naplózza az eszközregisztráció során használt SCEP szolgáltatás kérelmeit és hibáit.
dmWebAdminService.log	Naplózza a /profilemanager webadminisztrátor használata során beküldött kérelmeket, valamint a hibákat.
dm_helper.log	Naplózza a macOS hálózati felhasználóira által az MDM-ben végzett felhasználóhitelesítéssel kapcsolatos információkat.
dmrunnerd.log	Megjeleníti a Profile Manager weboldalát (/profilemanager és /mydevices) támogató felügyelt ruby-folyamatok indításának és leállításának állapotát. Ez a napló néha üres.
migration_tool.log	Megjeleníti a Server.app korábbi verziójából való átköltözés állapotát és részleteit.
php-fpm.log	Megjeleníti az egyes php-fpm segítőfolyamatok indításának és leállításának állapotát.
php-fpm.devicemgr.log	A rendszer ebben a fájlban naplózza a PHP-vel kapcsolatos problémákat.
PostgreSQL-	Naplózza a Profile Manager által használt PostgreSQL-adatbázissal kapcsolatos összes olyan lekérdezést, amely hibát eredményezett. Egyben az adatbázissémát módosító parancsokat is rögzíti.
servermgr_devicemgr.log	Naplózza a Profile Manager szolgáltatás elindítását és leállítását.

Ez a napló hasznos információkat nyújt a webszerverről:

/var/log/apache2/service_proxy_error.log

A következő Terminal-parancs segítségével további információkhoz juthat:

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

A tranzakciós „hibákról”

A fenti naplók némelyikében tranzakciós „hibákat” vagy újrapróbálkozásokat fedezhet fel. A legtöbb ilyen bejegyzés a várható működés része, és nem utal problémára. Ezeket a naplóeseményeket a rendszer mögött működő PostgreSQL-adatbázis egyidejű módosítási próbálkozásai közötti ütközések okozzák. Az ilyen típusú hibák esetében a rendszer újrapróbálkozik, amíg nem jár sikerrel.

Ha az alábbiak bármelyikét látja a naplófájlban, akkor tranzakcióütközésről van szó:

Canceled on conflict out to pivot (Megszakítva ütközés miatt)
could not serialize access due to concurrent update (egyidejű módosítás miatt nem sikerült a szerializálás)
@@@ Retry #X (#X újrapróbálása)
@@@ Retry X (X újrapróbálása)

Az apspd CFPrefs fájl ellenőrzése

Lépjen a /Library/Preferences/ApplePushServiceProvider könyvtárba, jelölje ki a com.apple.apspd.plist fájlt, majd válassza ki a File > Get Info (Fájl > Infó megjelenítése) parancsot. Ha a fájl nagyobb 5 KB-nál, távolítsa el, majd indítsa újra az apspd folyamatot a következő Terminal-paranccsal:

sudo killall apspd

Részletes naplózás használata további információk gyűjtéséhez

Néha további információkat kaphat a probléma elhárításához, ha magasabb szintre állítja a naplózást. A szükséges információk begyűjtéséhez a naplózási szint növelése után reprodukálja a problémát.

Ha végzett, állítsa vissza az eredeti naplózási szintet. Ha a magasabb beállításon hagyja a naplózási szintet, kevesebb lesz a rendszerindító meghajtón rendelkezésre álló tárhely.

Részletes naplózás bekapcsolása

A naplózási szint növeléséhez használja a következő Terminal-parancsot:

sudo debugDeviceMgr 4

Ezzel automatikusan újraindul a Profile Manager szolgáltatás.

Részletes naplózás kikapcsolása

Az eredeti naplózási szint visszaállításához használja ezt a Terminal-parancsot:

sudo debugDeviceMgr 1