Aller au contenu principal

Déployer avec Jamf Pro, Kandji ou un autre MDM Apple (macOS)

JodaPrint.pkg est un installateur universel (Apple silicon et Intel, macOS 13 ou plus récent). Il installe :

  • l'agent dans /Library/JodaPrint/bin, avec un lien /usr/local/bin/jodaprint-agent ;
  • le LaunchDaemon io.jodaprint.agent ;
  • le LaunchAgent de la barre des menus io.jodaprint.tray ;
  • une autorité de certification locale, approuvée dans le trousseau Système. Elle est créée sur chaque Mac ; aucune clé n'est livrée dans le pkg.

L'installateur lit le code d'activation dans un profil de configuration : le code n'est donc pas stocké dans un script. Déployez dans cet ordre :

1. Profil de configuration avec le code d'activation​

Le pkg lit ces clés dans le domaine de préférences io.jodaprint.agent :

CléTypeExemple
ActivationCodechaîneKJ74-PX9Q
Channelchaîne, facultativestable ou beta
CloudURLchaîne, facultativeuniquement pour un cloud auto-hébergé
  • Jamf Pro : Configuration Profiles → New → Application & Custom Settings → Upload. Domaine de préférences io.jodaprint.agent ; liste de propriétés : 
    <dict>
      <key>ActivationCode</key><string>KJ74-PX9Q</string>
    </dict>
  • Kandji : Library → Add → Custom Profile, puis téléversez le profil d'exemple io.jodaprint.agent.mobileconfig fourni avec les installateurs JodaPrint (remplacez le code et les deux valeurs PayloadUUID par la sortie de uuidgen).
  • Mosyle, Intune pour Mac et autres : un profil de configuration personnalisé avec le même fichier d'exemple.

2. Autoriser les éléments d'arrière-plan (recommandé)​

macOS 13 et versions ultérieures signalent aux utilisateurs les nouveaux éléments d'arrière-plan, et les utilisateurs peuvent les désactiver. Une charge utile Managed Login Items (com.apple.servicemanagement) garde JodaPrint activé et supprime la notification :

Type de règleValeur de la règle
Labelio.jodaprint.agent
Labelio.jodaprint.tray

Dans Jamf Pro, c'est Configuration Profiles → Login Items → Managed Login Items. Dans Kandji, c'est l'élément de bibliothèque Login & Background Items.

3. Le paquet​

  • Jamf Pro :
    1. Settings → Packages → New, téléversez JodaPrint.pkg.
    2. Créez une Policy avec le paquet (Action : Install), déclencheur Recurring Check-in ou Enrollment Complete, fréquence d'exécution Once per computer, avec pour périmètre les Mac ciblés.
  • Kandji : Library → Add → Custom App, type d'installateur Installer package, téléversez JodaPrint.pkg. Choisissez « Install once per device ».
  • Intune pour Mac : Apps → macOS → macOS app (PKG), ou un pkg non géré.

Installez le profil avant le paquet. Si le paquet s'est exécuté en premier, lancez sudo jodaprint-agent activate <code> via une policy ou un script.

Sans profil​

Certains outils se contentent de copier des fichiers et de lancer un installateur. Ils peuvent placer un fichier nommé jodaprint-activation-code (le code sur une ligne) dans le même dossier que JodaPrint.pkg, puis lancer :

sudo installer -pkg JodaPrint.pkg -target /

Pour un seul Mac, la commande en une ligne du tableau de bord écrit le code dans /tmp/jodaprint-activation-code. L'installateur supprime ce fichier dès qu'il a lu le code.

Dépannage​

  • Le journal d'installation est /Library/Logs/JodaPrint-install.log. Il montre chaque étape et si l'activation a réussi, jamais le code.
  • sudo jodaprint-agent status.
  • Journaux de l'agent : /Library/Application Support/JodaPrint/logs.
  • Mises à niveau : déployez le pkg plus récent de la même façon. Le service est arrêté, remplacé puis redémarré. L'activation et les données sont conservées.