Guía de configuración de WSL + VS Code + Tomcat 9

​

Parte A: Configuración global única de WSL

​

1. Habilitar e inicializar WSL 2

# En PowerShell (Admin):
wsl --install
wsl --set-default-version 2

​

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

​

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

​

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 .

​

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

​

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.