Разрешаване на проблеми с Profile Manager (Управител на профили) в macOS Server

Научете как да откривате и оправяте неизправности, ако Profile Manager (Управител на профили) не работи по очаквания от вас начин.

Ако нямате достъп до страницата за администриране

Основната настройка на Profile Manager (Управител на профили) е в приложението Server. За да получите достъп до уеб страницата /mydevices и до уеб страницата за администриране на Profile Manager (Управител на профили), трябва да използвате Safari.

Само администраторите на сървъра имат достъп до страницата ви за администриране. Форматът на URL адреса на страницата ви за администриране е:

https://yнапълно_определеното_име_на_домейна_на_нашия_сървър/profilemanager
- Пример: https://www.example.com/profilemanager

За да запишете iPhone, iPad, iPod touch или Mac, отидете на:

https://напълно_определеното_име_на_домейна_на_вашия_сървър/mydevices
- Пример: https://www.example.com/mydevices

Ако нямате достъп до страницата за администриране с уеб браузър, различен от Safari, опитайте със Safari. Ако нямате достъп до нея със Safari, проверете вашия DNS сървър. DNS настройките са важни, когато управлявате разполагане на Profile Manager (Управител на профили). Ако Profile Manager (Управител на профили) не се отваря, уверете се, че сървърът ви сочи към надежден DNS сървър.

Ако не можете да подавате профили или приложения към клиенти

Ако имате затруднения, когато подавате профили или приложения към клиентски системи, проверете системния файл-дневник в Console. Ако той докладва, че сървърът ви не може да достигне APNs Уверете се, че всички необходими портове са отворени.

За повече информация включете функцията за отчитане на грешки на APNS с тези команди на 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

Можете да преглеждате файлове-дневници в приложението Console, като ги подбирате в подсистемите com.apple.apsd и com.apple.apspd.

След като вашите APNS доклади са отчетени, използвайте тези команди на Terminal, за да изключите функцията за отчитане на грешки:

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. Показва записи, свързани с изпращане на подадени от сървъра известия (push notifications). Показва записи, свързани с 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 service (услуга за Управител на профили).

Този файл-дневник може да предостави полезна информация, свързана с уеб сървъра:

/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
@@@ Retry X

Проверете файла APSPD CFPrefs

Навигирайте до /Library/Preferences/ApplePushServiceProvider, изберете com.apple.apspd.plist, след което изберете File (Файл) > Get Info (Получаване на информация). Ако файлът е по-голям от 5KB, премахнете го и рестартирайте apspd процеса със следната команда Terminal:

sudo killall apspd

Използване на изчерпателно отчитане за получаване на повече информация

Понякога е възможно да получите допълнителна информация за това как да оправите дадена неизправност, ако повишите нивото на файла-дневник. За да съберете необходимата ви информация, възпроизведете проблема, след като повишите нивото на файла-дневник.

Когато приключите, възстановете първоначалното ниво на отчетност. Ако оставите нивото на отчетност на по-висока настройка, това намалява наличното пространство на пусковия диск.

Включване на изчерпателната отчетност

За да повишите нивото на отчетност, използвайте тази команда на Terminal:

sudo debugDeviceMgr 4

Това автоматично рестартира услугата Profile Manager Service (услуга Управител на профили).

Изключване на изчерпателната отчетност

За да възстановите нивото на отчетност обратно към първоначалната му настройка, използвайте тази команда на Terminal:

sudo debugDeviceMgr 1