Desplegables DSE en Windows y Linux

Ejecución certificada de los desplegables generados para Windows y Linux

Use esta sección después de completar Generate deployables. Documenta el flujo de certificación/ejecución de los paquetes generados win-x64 y linux-x64 nativos. Son runners de integración generados, no los SKU comerciales de instalación Windows/Container de DSE.

Desplegable de Windows (windows/win-x64)

Copie la carpeta de Windows generada a la máquina de certificación (o extraiga el archivo transferido) y trabaje desde el directorio windows\win-x64.

Verifique que estos archivos generados estén presentes antes de la primera ejecución:

• DataSourceExplorer.Runner.exe
• manager.cmd
• run.cmd
• schema-catalog.json
• source-connections.json
• destination-route.json (si el enrutamiento está habilitado)

Inicie el Runtime Manager local:

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

manager.cmd inicia DataSourceExplorer.Runner.exe --manager. El administrador escucha en 127.0.0.1 y normalmente abre el navegador predeterminado automáticamente. Si no se abre, ejecute el archivo directamente y use la Local management URL mostrada en la consola.

1. Confirme que Runtime status sea READY y que no exista una ejecución activa.
2. En Connections, confirme que cada origen y destino requerido aparezca como Configured. Deje los campos protegidos en blanco para conservar el valor guardado/integrado.
3. Para la primera certificación, use Manual only y establezca el directorio de salida en output.
4. Seleccione Run now y espere a que el estado vuelva a READY.
5. Confirme que Last result y Run history indiquen Success y verifique de forma independiente los datos de salida/destino esperados.

Para una ejecución única sin interfaz:

run.cmd

Desplegable Linux (linux/linux-x64) — flujo Ubuntu Hyper-V validado

El procedimiento siguiente sigue la guía validada de Ubuntu Server 26.04.1 LTS / Microsoft Hyper-V proporcionada para la certificación. Ejecuta el desplegable Linux nativo; Docker no es necesario.

Acceso seguro recomendado desde el navegador de Windows

En vez de exponer el administrador en la red de la VM, puede crear un túnel de puerto SSH local desde Windows PowerShell después de leer el puerto del administrador en el registro de Linux:

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

Después abra http://127.0.0.1:18093/ en Windows. Mantenga abierta la sesión SSH mientras usa el administrador. El relay socat descrito abajo sigue siendo útil en una red de certificación aislada/de confianza.

Objetivo

Este procedimiento crea una máquina virtual ligera de Ubuntu Server y ejecuta el desplegable nativo de Linux generado por DSE. Reproduce el flujo de Windows: copiar el paquete generado, iniciar DSE Deployable Runtime Manager, abrir el administrador desde el host Windows, ejecutar el desplegable y verificar el resultado.

Requisitos previos

• Host Windows con Hyper-V habilitado
• ISO de Ubuntu Server LTS
• Carpeta linux generada por DSE que contiene linux/linux-x64
• Al menos 4 vCPU, 4 GB de RAM y un disco virtual de 40 GB
• Acceso de red desde la VM a los sistemas de origen/destino de DSE

1. Crear la máquina virtual Hyper-V

Cree una VM de generación 2 con esta configuración base:

2. Preparar Ubuntu

Inicie sesión en Ubuntu y actualice el sistema. Después verifique CPU, memoria, disco y dirección IP.

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

Si el VHDX es de 40 GB pero el volumen raíz tiene solo unos 18-19 GB, amplíe el volumen lógico LVM para usar el espacio libre.

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

3. Conectarse desde Windows mediante SSH

Use la IP actual de la VM mostrada por hostname -I. La dirección del Default Switch de Hyper-V puede cambiar después de reiniciar.

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

4. Copiar la carpeta Linux generada

Ejecute ssh/scp desde Windows PowerShell, no desde el shell de Ubuntu. DSE genera una carpeta linux, no un archivo linux.zip. Sustituya la ruta, el usuario y la IP del ejemplo por los valores reales.

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. Preparar el desplegable

Instale socat si utilizará el relay, entre en la carpeta linux-x64 copiada y aplique permisos de ejecución de Linux. Los scripts DSE actuales usan UTF-8 sin BOM; no se requiere extracción ni eliminación de BOM.

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. Verificar la conectividad de origen/destino

Antes de iniciar DSE, compruebe que la VM Ubuntu puede alcanzar el puerto requerido. El ejemplo usa MongoDB en el puerto 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. Iniciar DSE Deployable Runtime Manager

Inicie el administrador y revise su registro. El administrador se enlaza a 127.0.0.1 y selecciona un puerto 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. Hacer accesible el administrador desde el navegador de Windows

Use socat en Ubuntu para redirigir un puerto estable de la VM (18093) al puerto loopback actual del administrador. Los comandos detectan automáticamente la IP y el puerto.

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. Ejecutar el desplegable desde la interfaz

1. Abra en Edge o Chrome la URL mostrada por el comando de redirección.
2. Confirme que Runtime status muestre READY y que no haya una ejecución activa.
3. En Connections, confirme que origen y destino muestren Configured. Deje vacíos los campos protegidos para conservar los valores integrados.
4. Para la primera prueba, configure Scheduler configuration como Manual only, Output directory como output y guarde la configuración.
5. Seleccione Run now y espere a que el estado vuelva a READY.
6. Confirme que Last result y Run history indiquen Success y verifique los archivos de salida y los datos de destino.

10. Detener, reiniciar y limpiar

La IP de la VM y el puerto del administrador pueden cambiar después de reiniciar. Ejecute manager.sh de nuevo, lea el nuevo puerto y reinicie la redirección socat. Para detenerla:

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

Lista de verificación

• Ubuntu inicia desde el VHDX y SSH funciona
• El sistema de archivos raíz tiene espacio libre suficiente
• El puerto de origen/destino es accesible desde Ubuntu
• DataSourceExplorer.Runner, manager.sh y run.sh tienen permiso de ejecución
• manager-console.log informa una URL de administración local
• El navegador de Windows abre http://<VM-IP>:18093/
• Runtime status vuelve a READY después de Run now
• Run history muestra Success y existen los resultados/datos esperados

Solución de problemas

Recursos relacionados

Use el tutorial en vídeo para una guía visual o vuelva al centro de documentación para consultar otros recursos de DSE.

Inicio de documentación  •  Ayuda de vídeo multilingüe  •  Guía de instalación  •  Sitio DSE