Installer et déployer l'agent
Ce que fait l’agent
L’agent Ubidesk est le composant qui s’installe sur les postes à administrer de façon permanente. Une fois déployé, il :
- reste connecté à l’espace Ubidesk et se reconnecte automatiquement après un redémarrage, une coupure réseau ou un changement de réseau ;
- reste joignable lorsque Windows démarre en mode sans échec avec mise en réseau ;
- répond aux demandes de Wake-on-LAN transmises par la console.
L’agent n’est pas nécessaire pour les sessions assistées : l’utilisateur ponctuel utilise un client temporaire sans installation. Il est en revanche indispensable pour l’accès non surveillé.
Choisir le format d’installation
Quatre paquets sont disponibles, un par plateforme :
| Plateforme | Format | Déploiement de masse |
|---|---|---|
| Windows | MSI | GPO, Intune |
| macOS | PKG | Jamf |
| Debian / Ubuntu | DEB | gestionnaire de paquets |
| RHEL / Fedora / SUSE | RPM | gestionnaire de paquets |
Téléchargez le paquet correspondant depuis votre espace. Chaque paquet embarque le rattachement à votre compte : le même paquet peut servir pour tout le parc.
Installer sur Windows
L’installation interactive se fait en double-cliquant sur le MSI. Pour un déploiement silencieux, exécutez dans une invite élevée :
msiexec /i ubidesk-agent.msi /qnL’agent s’enregistre comme service Windows, démarré automatiquement à chaque démarrage.
Installer sur macOS
Ouvrez le PKG et suivez l’assistant. Pour un déploiement silencieux :
sudo installer -pkg ubidesk-agent.pkg -target /L’agent installe un démon lancé à l’ouverture de session.
Installer sur Linux
Sur Debian ou Ubuntu :
sudo apt install ./ubidesk-agent.debSur RHEL, Fedora ou SUSE :
sudo dnf install ./ubidesk-agent.rpmL’agent s’enregistre comme service systemd et redémarre avec la machine.
Déployer en masse
- GPO (Windows) : attribuez le MSI en installation par ordinateur dans une GPO de votre domaine. L’installation s’applique au démarrage, sans droits locaux.
- Intune : publiez le MSI comme application métier, ciblez un groupe d’appareils et suivez l’état de déploiement dans le centre d’administration.
- Jamf (macOS) : importez le PKG dans Jamf Pro, créez une politique d’installation et affectez-la à un groupe statique ou dynamique.
Prérequis réseau et pare-feu
L’agent n’a besoin que du HTTPS sortant, sur le port 443. Aucun port entrant n’est à ouvrir sur la machine cible et aucun VPN n’est requis. Si votre environnement force le trafic par un proxy, vérifiez qu’il autorise le HTTPS vers l’infrastructure Ubidesk ; tout le reste emprunte le même canal TLS 1.3 que la console.
Vérifier l’installation
- Dans la console, ouvrez la liste des appareils : le poste apparaît quelques secondes après l’installation.
- Redémarrez la machine et confirmez que l’appareil repasse en ligne sans intervention.
- Sur Windows, testez un redémarrage en mode sans échec avec mise en réseau : l’appareil doit rester joignable.
Les machines éteintes ou en veille peuvent être réveillées par Wake-on-LAN si le matériel et le BIOS le permettent. Voir Accès non surveillé : configuration.
Désinstaller
Sur Windows, la désinstallation passe par le panneau des applications ou par la ligne de commande :
msiexec /x ubidesk-agent.msi /qnSur macOS, supprimez le paquet depuis le dossier des applications ou via Jamf. Sur Linux, utilisez le gestionnaire de paquets (apt remove ou dnf remove). Après désinstallation, l’appareil disparaît de la liste des appareils de l’espace à la prochaine synchronisation.