Résoudre des problèmes liés au Gestionnaire de profils dans macOS Server

Découvrez comment détecter les problèmes et les résoudre si le Gestionnaire de profils ne fonctionne pas comme prévu.

Si vous ne parvenez pas à accéder à la page d’administration

La configuration de base du Gestionnaire de profils s’effectue dans l’app Server. Pour accéder à la page web /mydevices et à la page web d’administration du Gestionnaire de profils, vous devez utiliser Safari.

Seuls les administrateurs du serveur sont autorisés à accéder à votre page d’administration. L’URL de votre page d’administration se présente sous la forme suivante :

  • https://nom_de_domaine_complet_de_votre_serveur/profilemanager
    Exemple : https://www.example.com/profilemanager

Pour inscrire un iPhone, iPad, iPod touch ou Mac, accédez à l’adresse suivante :

  • https://nom_de_domaine_complet_de_votre_serveur/mydevices
    Exemple : https://www.example.com/mydevices

Si vous ne parvenez pas à accéder à la page d’administration à l’aide d’un navigateur web autre que Safari, utilisez Safari avant d’aller plus loin. Si vous ne parvenez pas à y accéder avec Safari, essayez les étapes de dépannage suivantes.

Vérification de votre serveur DNS

Les réglages DNS sont importants lorsque vous gérez un déploiement dans le Gestionnaire de profils. Si le Gestionnaire de profils ne s’ouvre pas, assurez-vous que votre serveur pointe vers un serveur DNS fiable.

Distribution impossible de profils ou d’apps aux clients

Si vous rencontrez des problèmes lors de la distribution de profils ou d’apps aux systèmes clients, vérifiez le fichier d’historique système dans Console. Si le fichier indique que votre serveur ne parvient pas à joindre les serveurs APNS d’Apple, vérifiez la configuration de votre réseau. Assurez-vous que tous les ports requis sont ouverts.

Pour plus d’informations, activez la création d’historiques de débogage APNS à l’aide des commandes suivantes dans 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

Le fichier d’historique est disponible dans /Bibliothèque/Logs/apsd.log. 

Une fois vos opérations APNS consignées, désactivez la consignation des données de débogage en saisissant les commandes suivantes dans Terminal :

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

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

sudo killall apsd

Si vous rencontrez d’autres problèmes avec le Gestionnaire de profils

La consultation des fichiers d’historique du Gestionnaire de profils peut vous aider à résoudre les problèmes affectant celui-ci. Un lien symbolique nommé « devicemgr » est disponible à l’emplacement /var/log. Il redirige vers l’emplacement /Bibliothèque/Logs/ProfileManager, dans lequel les historiques suivants sont disponibles :

devicemgrd.log
  • Indique l’état de consultation et de synchronisation des utilisateurs et groupes Open Directory et Active Directory.
  • Répertorie les erreurs des requêtes exécutées par devicemgrd.
  • Affiche les entrées liées à l’envoi de notifications Push.
  • Affiche les entrées liées aux transactions DEP et VPP.
dm_helper.log
  • Consigne les informations relatives à l’authentification des utilisateurs liés à MDM provenant des utilisateurs du réseau macOS.
dmrunnerd.log
  • Indique l’état de démarrage et d’interruption des processus ruby gérés qui prennent en charge la page web du Gestionnaire de profils (/profilemanager et /mydevices). Cet historique est parfois vierge.
migration_tool.log
  • Indique l’état de la migration effectuée depuis une version antérieure de Server.app, ainsi que les informations y étant associées. 

php.log
  • Répertorie les adresses IP des appareils gérés par le Gestionnaire de profils. Si vos appareils sont soumis à la traduction d’adresse réseau (NAT), les adresses IP indiquées à cet endroit peuvent ne pas correspondre.
  • Affiche l’interaction des commandes MDM envoyées aux appareils et des résultats obtenus.
  • Répertorie toutes les tentatives d’installation de profils et les commandes envoyées aux appareils.

php-fpm.log
  • Indique l’état du démarrage et d’interruption des processus individuels de l’utilitaire php-fpm.

php-fpm.devicemgr.log
  • Consigne les problèmes affectant le langage PHP.
PostgreSQL-<aaaa-mm-jj>.log
  • Consigne toutes les requêtes liées à la base de données PostgreSQL du Gestionnaire de profils et entraînant une erreur.
  • Consigne également les commandes qui modifient le schéma de base de données.
profilemanager.log
  • Consigne toutes les interactions utilisateur effectuées au niveau de la page d’administration du Gestionnaire de profils.
  • Répertorie les messages d’erreur liés à la page web du Gestionnaire de profils (/profilemanager et /mydevices).
  • Consigne également les problèmes de transactions des processus ruby gérés.
servermgr_devicemgr.log
  • Répertorie tous les démarrages et toutes les interruptions du Gestionnaire de profils.

Ces historiques peuvent également contenir des informations utiles :

  • /var/log/apache2/service_proxy_error.log
  • /var/log/system.log

Sous macOS Sierra et version ultérieure, certaines informations sont stockées via la journalisation unifiée. La commande Terminal suivante peut vous fournir des informations supplémentaires utiles :

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

À propos des « échecs » de transaction

Il se peut que certains de ces historiques fassent état de transactions ayant « échoué » ou de nouvelles tentatives. Ceci est normal et ne relève d’aucun problème. Ces événements correspondent simplement à des conflits dus à des tentatives de modification simultanées de la base de données PostgreSQL sous-jacente. De telles opérations sont automatiquement reproduites jusqu’à ce qu’elles réussissent.

Ces conflits sont reconnaissables aux mentions suivantes, apparaissant dans les fichiers d’historique :

  • Canceled on conflict out to pivot
  • could not serialize access due to concurrent update
  • @@@ Retry #X
  • @@@ Retry X

Utilisation de la consignation détaillée pour obtenir des informations supplémentaires

Parfois, des informations supplémentaires sur la marche à suivre pour résoudre un problème sont disponibles si vous augmentez le niveau de journalisation. Pour les consulter, reproduisez le problème rencontré après avoir augmenté le niveau de journalisation.

Une fois le problème résolu, rétablissez le niveau de journalisation initial. Si le niveau de journalisation reste défini sur une valeur supérieure, l’espace disponible sur votre disque de démarrage sera réduit.

Activation de la consignation détaillée

Pour augmenter le niveau de journalisation, utilisez la commande suivante dans Terminal :

sudo debugDeviceMgr 4

Le service Gestionnaire de profils redémarre automatiquement.

Désactivation de la consignation détaillée

Pour rétablir le niveau de journalisation initial, utilisez la commande suivante dans Terminal :

sudo debugDeviceMgr 1

Le service Gestionnaire de profils redémarre automatiquement.

Date de publication: