1. Préparer l’ordinateur ou le serveur
UBC Data Bridge Agent fonctionne sous Linux et connecte les fichiers locaux, les bases de données et les API internes à vos flux. Choisissez un ordinateur ou un serveur qui peut atteindre les ressources requises et reste allumé pendant les échanges.
Avant l’installation, confirmez avec votre administrateur la distribution Linux, sa version et l’architecture du processeur. Obtenez le paquet Agent et les instructions d’installation adaptés à cet environnement. Les noms des paquets, les étapes d’installation et les commandes du service dépendent du paquet fourni.
Vérifiez l’horloge système, l’accès HTTPS sortant vers Data Bridge et les paramètres du proxy d’entreprise, s’il est utilisé. Attribuez un compte de service dédié avec les autorisations nécessaires.
2. Installer et démarrer le service
Obtenez le paquet et sa somme de contrôle auprès de votre administrateur Data Bridge. Vérifiez l’origine et l’intégrité du fichier. Installez l’Agent avec les droits d’administration Linux en suivant les instructions fournies avec le paquet.
Activez le lancement automatique au démarrage du système. Vérifiez que le service fonctionne sous le compte attribué et peut lire ses paramètres, ses certificats et son journal. Notez le nom réel du service et les emplacements des fichiers pour la maintenance.
3. Connecter l’Agent à Data Bridge
Ouvrez les paramètres Agent dans Data Bridge et créez une clé d’enregistrement. Dans les paramètres de l’Agent installé, saisissez l’adresse HTTPS de Data Bridge et enregistrez-le avec cette clé. Ne placez pas la clé dans des journaux, courriels ou fichiers partagés.
Attendez que Data Bridge affiche la connexion. Si l’Agent n’apparaît pas, vérifiez l’adresse du serveur, l’horloge, le proxy, la confiance des certificats et la connectivité sortante. Consultez le dépannage de l’Agent pour les vérifications générales.
4. Autoriser les ressources nécessaires
Ajoutez uniquement les dossiers, bases de données et adresses API nécessaires à vos flux. Utilisez des chemins de dossiers absolus. Accordez au compte de service le droit d’atteindre le répertoire et de lire ou écrire les fichiers selon les besoins.
Les dossiers réseau doivent être accessibles au service lui-même, pas seulement à votre session personnelle. Un administrateur doit configurer des montages persistants et vérifier l’accès après un redémarrage. Vérifiez les règles SELinux ou AppArmor lorsqu’elles sont activées : l’accès Data Bridge ne remplace pas les autorisations du système d’exploitation.
Définissez séparément les règles de l’Agent : dossiers, noms de fichiers, adresses, ports et opérations autorisés. Un processus qui lit seulement des rapports n’a pas besoin de supprimer ou d’écraser des fichiers. Consultez les ressources et autorisations de l’Agent.
5. Vérifier la connexion et les échanges de données
- Confirmez que Data Bridge affiche l’Agent comme connecté.
- Testez chaque ressource approuvée avec le compte de service.
- Sélectionnez l’accès par l’Agent dans la connexion Data Bridge concernée.
- Lisez un petit fichier ou jeu de données de test et examinez le résultat.
- Si l’écriture est nécessaire, effectuez un test approuvé dans un dossier dédié ou un système de test.
- Redémarrez le service et confirmez le rétablissement de la connexion et de l’accès aux ressources.
6. Maintenir et mettre à jour l’Agent
Planifiez les mises à jour sur une plage de maintenance convenue. Avant de changer le paquet, sauvegardez les paramètres selon les règles de votre organisation, en protégeant les secrets. Après mise à jour, vérifiez l’enregistrement, les ressources et une exécution de test.
Pour analyser une erreur, recueillez son heure, le nom de l’Agent, la version Linux, l’état du service et l’extrait de journal concerné. Ne partagez pas les clés d’enregistrement, mots de passe ou fichiers de secrets. Lorsqu’un Agent n’est plus nécessaire, révoquez son accès dans Data Bridge et retirez les autorisations locales.