Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://blog.mapptech.com.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Parte A: Configuración global única de WSL

​
1. Habilitar e inicializar WSL 2

# En PowerShell (Admin):
wsl --install
wsl --set-default-version 2
Reinicia si se te solicita. Luego lanza tu distro Linux (p. ej. Ubuntu) desde el menú Inicio y completa la configuración inicial.

​
2. Ocultar globalmente los ADS de Windows

# En WSL, edita /etc/wsl.conf:
[automount]
options = "metadata,streams_interface=none"

# De regreso en PowerShell (Admin):
wsl --shutdown
Reinicia la distro: ya no verás los archivos *:Zone.Identifier.

​
3. Configurar tu entorno de shell

# Añade al final de ~/.bashrc (o ~/.profile):
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export CATALINA_HOME=/opt/tomcat9

# Recarga:
source ~/.bashrc

​
Parte B: Instalación de herramientas y Tomcat en WSL

​
4. Instalar herramientas básicas

sudo apt update
sudo apt install -y openjdk-8-jdk ant unzip curl

​
5. Instalar Tomcat 9.0.85

# Descargar y extraer
cd /tmp
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz
sudo mkdir -p /opt/tomcat9
sudo tar xzf apache-tomcat-9.0.85.tar.gz \
  -C /opt/tomcat9 --strip-components=1

# Crear usuario/grupo tomcat y ajustar permisos
sudo groupadd tomcat
sudo useradd -s /bin/false -g tomcat -d /opt/tomcat9 tomcat
sudo chown -R tomcat:tomcat /opt/tomcat9
sudo chmod -R o+rX /opt/tomcat9
sudo chmod +x /opt/tomcat9/bin/*.sh

​
6. Verificar Tomcat

sudo -u tomcat $CATALINA_HOME/bin/startup.sh
En tu navegador de Windows abre http://localhost:8080: deberías ver la página de bienvenida de Tomcat.

​
Parte C: Flujo de trabajo en VS Code y el proyecto

​
7. Instalar y configurar VS Code Remote-WSL

  1. Instala Visual Studio Code en Windows.
  2. En VS Code → Extensiones (Ctrl+Shift+X) instala Remote – WSL.
  3. Haz clic en el icono verde >< (abajo a la izquierda) → Remote-WSL: New Window.
  4. En esa ventana conectada a WSL, instala:
    • Extension Pack for Java (vscjava.vscode-java-pack)
    • Tomcat for Java (adashen.vscode-tomcat)

​
8. Copiar el proyecto PREDIUM a WSL

  • Desde el Explorador de Windows, copia tu carpeta PREDIUM a
    \\wsl$\Ubuntu\home\santiago\projects\PREDIUM
  • O en WSL: 
    mkdir -p ~/projects
cp -r /mnt/c/Ruta/Al/Proyecto/PREDIUM ~/projects/

​
9. Abrir el proyecto en VS Code

cd ~/projects/PREDIUM
code .
:::note En la primera ejecución verás “Installing VS Code Server for x64…” en tu terminal de WSL. Por favor espera a que termine antes de interactuar con el editor —de lo contrario podrías terminar editando archivos en Windows por error. :::

​
10. Registrar Tomcat en VS Code

  • En la ventana conectada a WSL → vista Tomcat Servers (icono de elefante o Ctrl+Shift+P → Tomcat: Show Servers View).
  • Haz clic en ➕ Add Tomcat Server, selecciona /opt/tomcat9.
  • Aparecerá Local Tomcat 9.0.85 en la lista.

​
11. Compilar y empaquetar el WAR

cd ~/projects/PREDIUM
ant clean dist
Al finalizar tendrás dist/PREDIUM.war.

​
12. Desplegar y ejecutar en VS Code

  • En Explorer, haz clic derecho en dist/PREDIUM.war → Run on Tomcat Server → Local Tomcat 9.0.85.
  • VS Code desplegará y arrancará tu aplicación.

​
13. Verificar y depurar

  • Abre http://localhost:8080/PREDIUM/ en el navegador para ver tu app.
  • Para depurar: en Tomcat Servers haz clic derecho en el servidor → Debug → selecciona el mismo WAR; establece puntos de interrupción en VS Code.

​
14. Conectar PostgreSQL en Windows desde WSL (v16, copiar & pegar)

  1. Configurar PostgreSQL en Windows y abrir el firewall 
    $winIp = (Get-NetIPConfiguration | Where-Object { $_.IPv4DefaultGateway -ne $null } | Select-Object -Expand IPv4Address).IPAddress
$pgRoot = 'C:\Program Files\PostgreSQL\16'
& "$pgRoot\bin\psql.exe" -U postgres -d postgres -c "ALTER SYSTEM SET listen_addresses='*';"
$hba = "$pgRoot\data\pg_hba.conf"
Add-Content $hba ("host all all " + $winIp + "/32 md5")
Restart-Service postgresql-x64-16
New-NetFirewallRule -DisplayName 'Postgres (WSL)' -Direction Inbound -Protocol TCP -LocalPort 5432 -Action Allow -Profile Private
  2. Obtener la IP de Windows dentro de WSL 
    export DB_HOST=$(
  powershell.exe -NoProfile -Command \
    "(Get-NetIPConfiguration | Where-Object { \$_.IPv4DefaultGateway -ne \$null }).IPv4Address.IPAddress"
)
DB_HOST=${DB_HOST//$'\r'/}
echo "DB_HOST → $DB_HOST"
  3. Instalar el cliente y verificar la conexión 
    sudo apt update
sudo apt install -y postgresql-client
psql -h "$DB_HOST" -U postgres -d predium_vup
  4. Configurar tu aplicación Spring/Hibernate
    Reemplaza <TU_IP_WINDOWS> con el valor que obtuviste en el paso 2:     
    <property name="url" value="jdbc:postgresql://<TU_IP_WINDOWS>:5432/predium_vup"/>
Consejos extra
  • Cambiar puerto HTTP: edita /opt/tomcat9/conf/server.xml.
  • Ver logs: panel Output de VS Code → selecciona Tomcat Server.
  • Reiniciar: clic derecho en el servidor → Restart.