📋 Ce guide couvre tout ce que vous devez savoir pour utiliser Cockpit efficacement. Version 1.0 · mars 2026

1. Aperçu

Cockpit est une application de bureau Windows qui agit comme un centre de contrôle pour la gestion et la surveillance des connecteurs de services sur votre serveur. Elle fournit une interface unifiée pour configurer les paramètres des connecteurs, valider que les composants requis sont correctement installés et rester automatiquement à jour.

Cockpit nécessite privilèges d'administrateur pour s'exécuter — c’est prévu et nécessaire pour qu’il interagisse avec les services Windows et les composants système.

2. Démarrage

2.1 Installation

Cockpit est distribué sous forme d'un installateur Windows standard (.exe). Pour l'installer :

• Téléchargez le fichier d'installation fourni par votre administrateur.

• Double-cliquez sur le programme d'installation et suivez les étapes à l'écran.

Pour les étapes d'installation, vous pouvez ici procéder à l'installation standard.

Si vous aviez déjà une instance du service que vous installez, la fenêtre suivante apparaitra également.

Cette fenêtre indique simplement que pour réalisé l'installation, le service devra être arrêté pour être mis à jour. Vous pouvez sélectionné les éléments sélectionnés par défaut et simplement continuer en cliquant sur suivant.

• Cockpit sera installé dans le dossier Program Files et un raccourci sera créé sur votre bureau.

2.2 Lancement de l'application

Double-cliquez sur le raccourci Cockpit sur votre bureau (ou trouvez-le dans le menu Démarrer). Si Windows vous demande la permission d'exécuter en tant qu'administrateur, cliquez Oui.

L'application s'ouvrira sur la page du connecteur ou le tableau de bord, selon qu'il y a un connecteur installé ou non.

La navigation entre les connecteurs se fait via le panneau en bas de l'application.

3. Composants de l'application

3.1 Tableau de bord

Le tableau de bord est la page affichée lorsqu'aucun connecteur n'est installé sur la machine actuelle.

3.2 Panneau des connecteurs

En bas de l'écran, il y a un panneau où vous pouvez :

• Voir tous les connecteurs installés sur la machine actuelle

• Accéder à la page d'un connecteur spécifique

3.3 Connecteur

Lorsque vous cliquez sur un connecteur, les panneaux sont actualisés avec les informations du connecteur sélectionné.

Le panneau principal affiche les champs de configuration, tels que les adresses d'hôte, les identifiants, les chemins de fichiers, etc.

Il existe différents types de champs :

Mode avancé

Dans le panneau principal, il y a un Mode de configuration avancé bascule. Lorsqu'il est activé, des champs techniques supplémentaires et des actions deviennent visibles. Ils sont destinés à des scénarios de configuration avancée et ne sont pas nécessaires pour une utilisation typique. Désactivez à nouveau le Mode avancé pour les masquer.

Importer la configuration

Les actions remplacent tout le fichier de configuration actuel, y compris les connexions, avec celui fourni.

Ajouter des connexions

L'action ajoute toutes les nouvelles connexions disponibles dans le fichier sélectionné au fichier de configuration actuel. Si l'ID de connexion existe déjà dans la configuration actuelle, il est ignoré.

3.4 Validation

Cockpit peut inspecter le contrôle de santé des connecteurs. Il vérifie que le connecteur est correctement installé et configuré sur la machine.

Par exemple, il vérifie que les composants COM requis sont présents et que leurs versions sont compatibles avec les services associés.

Les résultats sont affichés directement à l'écran. Si une vérification échoue, un message expliquera ce qui manque ou ce qui est incorrect, afin que vous puissiez prendre les mesures appropriées.

4. Mises à jour automatiques

Le Cockpit vérifie les mises à jour automatiquement à chaque démarrage. Si une nouvelle version est disponible, vous serez informé et invité à appliquer la mise à jour.

Le processus de mise à jour est simple :

1. Cockpit détecte une nouvelle version et affiche une notification.

2. Vous confirmez que vous voulez appliquer la mise à jour.

3. La nouvelle version est téléchargée et l'application redémarre automatiquement.

La fonctionnalité de mise à jour automatique n'est pour le moment disponible que pour le cockpit, elle n'est pas encore disponible pour les différents connecteurs installés dessus.

5. Résolution des problèmes

5.1 L'application ne démarre pas

Si Cockpit ne démarre pas ou se ferme immédiatement :

• Assurez-vous de l'exécuter en tant qu'administrateur (clic droit → Exécuter en tant qu'administrateur).

• Vérifiez le journal des événements Windows

• Contactez le support si le problème persiste.

5.2 Les paramètres ne sont pas enregistrés

Si les modifications des paramètres du connecteur ne semblent pas être enregistrées, assurez-vous que Cockpit s'exécute avec des droits d'administrateur. Sans privilèges élevés, il peut ne pas avoir accès en écriture aux fichiers de configuration.

5.3 Une validation du connecteur échoue

Une validation échouée signifie généralement qu'un composant requis est manquant ou obsolète. Le message d'erreur indiquera ce qui ne va pas. Les causes courantes incluent :

• Un composant COM requis n'est pas installé.

• La version installée d'un composant est incompatible avec la version du service.

• Les informations d'identification sont incorrectes.

Contactez le support avec le message d'erreur de validation si vous n'êtes pas sûr de la façon de le résoudre.

5.4 Où se trouvent les journaux du cockpit ?

Cockpit écrit les journaux d'application à l'emplacement suivant sur votre machine :

C:\ProgramData\Cockpit\logs\

Les fichiers journaux sont nommés par date (par ex. log-2026-03-23.log) et les anciens journaux sont archivés automatiquement. Fournissez-les au support lors de la déclaration d'un problème.