Déployables DSE sous Windows et Linux

Exécution certifiée des déployables Windows et Linux générés

Utilisez cette section après la fin de Generate deployables. Elle documente le flux de certification/exécution pour les packages générés win-x64 et linux-x64 natifs. Il s’agit de runners d’intégration générés, et non des SKU d’installation commerciaux Windows/Container de DSE.

Déployable Windows (windows/win-x64)

Copiez le dossier Windows généré sur la machine de certification (ou extrayez l’archive transférée), puis travaillez depuis le répertoire windows\win-x64.

Vérifiez la présence de ces fichiers générés avant la première exécution :

• DataSourceExplorer.Runner.exe
• manager.cmd
• run.cmd
• schema-catalog.json
• source-connections.json
• destination-route.json (si le routage est activé)

Démarrez le Runtime Manager local :

cd /d C:\Path\To\deployables\windows\win-x64
manager.cmd

manager.cmd lance DataSourceExplorer.Runner.exe --manager. Le gestionnaire écoute sur 127.0.0.1 et ouvre normalement le navigateur par défaut. Si le navigateur ne s’ouvre pas, lancez directement l’exécutable et utilisez l’URL de gestion locale affichée dans la console.

1. Vérifiez que Runtime status indique READY et qu’aucune exécution n’est active.
2. Dans Connections, vérifiez que chaque source et destination requise est Configured. Laissez les champs protégés vides pour conserver la valeur enregistrée/intégrée.
3. Pour la première certification, utilisez la planification Manual only et définissez le dossier de sortie sur output.
4. Sélectionnez Run now et attendez le retour de l’état READY.
5. Vérifiez que Last result et Run history indiquent Success, puis contrôlez indépendamment les sorties/données de destination attendues.

Pour une exécution unique sans interface :

run.cmd

Déployable Linux (linux/linux-x64) — flux Ubuntu Hyper-V validé

La procédure suivante suit le guide validé Ubuntu Server 26.04.1 LTS / Microsoft Hyper-V fourni pour la certification. Elle exécute le déployable Linux natif ; Docker n’est pas requis.

Accès navigateur sécurisé recommandé depuis Windows

Au lieu d’exposer le gestionnaire sur le réseau de la VM, créez un transfert de port SSH local depuis Windows PowerShell après avoir lu le port du gestionnaire dans le journal Linux :

ssh -L 18093:127.0.0.1:<manager-port> <linux-user>@<VM-IP>

Ouvrez ensuite http://127.0.0.1:18093/ sous Windows. Gardez la session SSH ouverte pendant l’utilisation du gestionnaire. Le relais socat décrit ci-dessous reste utile sur un réseau de certification isolé/de confiance.

Objectif

Cette procédure crée une machine virtuelle Ubuntu Server légère et exécute le déployable Linux natif généré par DSE. Elle reproduit le flux Windows : copier le package généré, démarrer le DSE Deployable Runtime Manager, ouvrir le gestionnaire depuis l’hôte Windows, exécuter le déployable et vérifier le résultat.

Prérequis

• Hôte Windows avec Hyper-V activé
• Image ISO Ubuntu Server LTS
• Dossier linux généré par DSE contenant linux/linux-x64
• Au moins 4 vCPU, 4 Go de RAM et un disque virtuel de 40 Go
• Accès réseau depuis la VM vers les sources/destinations DSE requises

1. Créer la machine virtuelle Hyper-V

Créez une VM de génération 2 avec les paramètres de base suivants :

2. Préparer Ubuntu

Connectez-vous à Ubuntu et mettez le système à jour. Vérifiez ensuite le processeur, la mémoire, le disque et l’adresse IP.

sudo apt update
sudo apt upgrade -y
hostname -I
nproc
free -h
df -h

Si le VHDX de 40 Go existe mais que le volume racine ne fait qu’environ 18-19 Go, étendez le volume logique LVM pour utiliser l’espace libre.

sudo vgs
sudo lvextend -l +100%FREE -r /dev/ubuntu-vg/ubuntu-lv
df -h

3. Se connecter depuis Windows avec SSH

Utilisez l’adresse IP actuelle de la VM retournée par hostname -I. L’adresse du commutateur par défaut Hyper-V peut changer après un redémarrage.

ssh <linux-user>@<VM-IP>

4. Copier le dossier Linux généré

Exécutez ssh/scp depuis Windows PowerShell, et non depuis le shell Ubuntu. DSE génère un dossier linux, pas un fichier linux.zip. Remplacez le chemin, l’utilisateur et l’IP par les valeurs réelles.

ssh <linux-user>@<VM-IP> "rm -rf /home/<linux-user>/dse-deploy/linux && mkdir -p /home/<linux-user>/dse-deploy"
scp -r "C:\Path\To\GeneratedDeployables\...\linux" <linux-user>@<VM-IP>:/home/<linux-user>/dse-deploy/

5. Préparer le déployable

Installez socat si vous utilisez le relais, ouvrez le dossier linux-x64 copié et appliquez les droits d’exécution Linux. Les scripts DSE actuels sont en UTF-8 sans BOM ; aucune extraction ni suppression de BOM n’est nécessaire.

sudo apt update && sudo apt install -y socat
cd ~/dse-deploy/linux/linux-x64
chmod +x DataSourceExplorer.Runner manager.sh run.sh
ls -l DataSourceExplorer.Runner manager.sh run.sh

6. Vérifier la connectivité source/destination

Avant de démarrer DSE, vérifiez que la VM Ubuntu peut atteindre le port requis. L’exemple utilise MongoDB sur le port 27017.

timeout 5 bash -c '</dev/tcp/<source-host>/<source-port>' \
  && echo 'Port reachable' \
  || echo 'Port NOT reachable'

# MongoDB example
timeout 5 bash -c '</dev/tcp/192.168.50.124/27017' \
  && echo 'MongoDB port reachable' \
  || echo 'MongoDB port NOT reachable'

7. Démarrer le DSE Deployable Runtime Manager

Démarrez le gestionnaire et consultez son journal. Le gestionnaire écoute sur 127.0.0.1 et choisit un port local.

cd ~/dse-deploy/linux/linux-x64
./manager.sh
sleep 2
cat .dse-manager/manager-console.log
curl http://127.0.0.1:<manager-port>/ | head

8. Rendre le gestionnaire accessible au navigateur Windows

Utilisez socat dans Ubuntu pour relayer un port stable de la VM (18093) vers le port local actuel du gestionnaire. Les commandes détectent automatiquement l’IP de la VM et le port du gestionnaire.

cd ~/dse-deploy/linux/linux-x64
VM_IP=$(hostname -I | awk '{print $1}')
MANAGER_PORT=$(grep -oE '127\.0\.0\.1:[0-9]+' .dse-manager/manager-console.log | tail -1 | cut -d: -f2)
nohup socat TCP-LISTEN:18093,bind="$VM_IP",reuseaddr,fork TCP:127.0.0.1:"$MANAGER_PORT" > ~/dse-relay.log 2>&1 &
echo "Open: http://$VM_IP:18093/"
ss -ltnp | grep 18093

9. Exécuter le déployable depuis l’interface

1. Ouvrez dans Edge ou Chrome l’URL affichée par la commande de relais.
2. Vérifiez que Runtime status indique READY et qu’aucune exécution n’est active.
3. Dans Connections, vérifiez que la source et la destination indiquent Configured. Laissez les champs protégés vides pour conserver les valeurs intégrées.
4. Pour le premier test, définissez Scheduler configuration sur Manual only, Output directory sur output, puis enregistrez.
5. Cliquez sur Run now et attendez le retour à READY.
6. Vérifiez que Last result et Run history indiquent Success, puis contrôlez les fichiers de sortie et les données de destination.

10. Arrêt, redémarrage et nettoyage

L’IP de la VM et le port du gestionnaire peuvent changer après redémarrage. Relancez manager.sh, lisez le nouveau port et recréez le relais socat. Pour arrêter le relais :

pkill -f 'socat TCP-LISTEN:18093' || true

Liste de vérification

• Ubuntu démarre depuis le VHDX et SSH fonctionne
• Le système de fichiers racine dispose de suffisamment d’espace libre
• Le port source/destination est accessible depuis Ubuntu
• DataSourceExplorer.Runner, manager.sh et run.sh sont exécutables
• manager-console.log affiche une URL de gestion locale
• Le navigateur Windows ouvre http://<VM-IP>:18093/
• Runtime status revient à READY après Run now
• Run history indique Success et les données de sortie/destination sont présentes

Dépannage

Ressources associées

Utilisez le tutoriel vidéo pour une démonstration visuelle ou revenez au centre de documentation pour d’autres ressources DSE.

Accueil documentation  •  Aide vidéo multilingue  •  Guide d’installation  •  Site DSE