Cet article présente les étapes nécessaires pour résoudre les problèmes liés à l'installation de logiciels, tant pour Chocolatey que pour Homebrew.
Chocolatey
Lorsque l'installation du logiciel échoue sur les appareils Windows, le message d'erreur suivant s'affiche dans le snack.
Les journaux pour Chocolatey dans Atera se trouvent dans le dossier suivant :
For x64
"C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"
For x86
"C:\Program Files (x86)\ATERANetworks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"
Lire les journaux
Outre la lecture locale des journaux de Chocolatey, vous pouvez également les lire directement à partir d'Atera en utilisant CMD ou Powershell.
1. Sur l'agent affecté, allez dans Gérer (Manage) et cliquez sur Interface en ligne de commande (Command Prompt).
2. Une fois que CMD est ouvert, utilisez la commande suivante pour accéder au dossier qui contient les journaux.
For x64
cd "C:\ProgramFiles\ATERANetworks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"
For x86
cd "C:\Program Files (x86)\ATERANetworks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"
3. Tapez la commande display directory pour voir tous les fichiers du dossier.
dir
Une fois que vous avez cliqué sur dir, vous verrez tous les logs dans le dossier choco-logs.
4. Pour lire les logs, copiez le nom du fichier et utilisez la commande type pour afficher les logs dans Atera. Assurez-vous d'avoir le nom du fichier entre guillemets ainsi que l'extension du fichier à la fin.
Command
type "filename.txt"
Example
type "10-17-2022 10_32_24-log.txt"
Les logs seront affichés dans la fenêtre CMD.
Logiciel déjà installé
Une erreur que vous pouvez rencontrer est "*Nom du logiciel* déjà installé". Même si l'application n'est pas installée sur la machine, les fichiers de Chocolatey peuvent empêcher l'installation.
Utilisez les commandes suivantes pour supprimer tous les fichiers qui pourraient empêcher l'installation du logiciel.
rmdir "C:\ProgramData\chocolatey\lib" /q /s
rmdir "C:\ProgramData\chocolatey\lib-bad" /q /s
Après avoir exécuté les deux commandes, essayez d'installer un autre logiciel
ERROR : Somme de contrôle
Dans certains cas, le paquet qui se trouve dans le référentiel Chocolatey n'est pas mis à jour correctement, et il peut renvoyer l'erreur suivante :
ERREUR : La somme de contrôle de 'xxxxxx' ne correspond pas à 'xxxxxx' pour le type de somme de contrôle 'sha256'. Envisagez de passer les sommes de contrôle réelles avec --checksum --checksum64 une fois que vous avez validé que les sommes de contrôle sont appropriées. Une option moins sûre est de passer --ignore-checksums si nécessaire.
Dans de tels cas, lorsque l'installation du logiciel renvoie cette erreur, vous pouvez essayer d'utiliser le paramètre --ignore-checksums, qui ignorera la somme de contrôle et tentera l'installation.
Remarque : pour certains paquets, le paramètre --ignore-checksums peut échouer, tant qu'il n'y a pas de section "Paramètres du paquet" dans la description de l'installation du logiciel.
Méthode d'installation par script
Vous pouvez télécharger le programme d'installation du logiciel (.exe ou .msi) vers Atera sous forme de script et l'exécuter directement à partir d'Atera. De cette façon, vous pouvez installer des applications qui n'ont pas pu être installées par le biais de l'installation de logiciels ou qui ne se trouvent pas dans le référentiel Chocolatey. Veuillez suivre notre article Créer ou télécharger des scripts, pour plus de détails.
Remarque : il existe une limite de 20 Mo par script pour le paquetage Pro, ce qui doit être pris en compte lors de l'utilisation de cette solution de contournement.
Homebrew
L'installation de logiciels pour les appareils Mac utilise Homebrew pour l'installation de logiciels.
Lire les journaux
1. Utilisez la commande Change directory pour accéder au dossier dans lequel se trouvent les journaux de Homebrew.
cd "/library/application support/com.atera.ateraagent/packages/AgentPackageProgramManagement/AgentPackageProgramManagementApp.app/Contents/MonoBundle"
2. Pour lire les logs, utilisez la commande cat
cat "brew-logs.txt"
Les journaux de choco montreront les problèmes avec l'installation elle-même. Comme les problèmes de permission, les problèmes d'accès aux dossiers, etc.
Une erreur commune est sudo : un mot de passe est requis. Certains logiciels Homebrew nécessitent une authentification par mot de passe ou ont d'autres exigences de permission, et ne peuvent donc pas être installés via Atera actuellement. Si c'est le cas, un message apparaîtra pour vous en informer.