Wiki

Solución de problemas

Soluciones a problemas comunes: servicio bloqueado, código de activación rechazado, PostgreSQL, TLS.

El servicio no arranca

Linux: systemctl start falla

sudo journalctl -u uversion-server -n 100 --no-pager

Causas frecuentes:

PostgreSQL inactivo: sudo systemctl status postgresql
Contraseña de la BD perdida: el postinst regenera la configuración con --reconfigure (sudo dpkg-reconfigure uversion-server)
Puerto 8443 ocupado: consulte la sección dedicada más abajo

Windows: error 1053 o 1067

El servicio arranca y luego se detiene. Compruebe el Visor de eventos:

Get-EventLog -LogName Application -Source uVersionServer -Newest 50

Causas frecuentes:

Falta la variable de entorno CONFIG_PATH: normalmente la define el instalador en HKLM\SYSTEM\CurrentControlSet\Services\uVersionServer\Environment
PostgreSQL inactivo: Get-Service postgresql*

El código de activación es rechazado

Compruebe que el código no se haya usado en otra máquina (cada código está vinculado al server-ID de la primera instalación). Solicite un nuevo código desde su área de cuenta.
Compruebe la conectividad con licence.uversion.io: curl -I https://licence.uversion.io/api/v1/health
Si desea reutilizar un código en una máquina nueva tras desinstalar, contacte con el soporte para liberar el server-ID anterior.

PostgreSQL inaccesible

El servicio uVersion no puede conectarse a la base de datos. Pruebe manualmente:

# Linux
sudo -u postgres psql -c "SELECT 1;"

# Windows
& "C:\Program Files\PostgreSQL\16\bin\psql.exe" -U postgres -h 127.0.0.1 -c "SELECT 1;"

Si PostgreSQL está instalado pero se ha perdido la contraseña del superusuario, el instalador de uVersion (tanto el postinst de Linux como install.ps1 de Windows) puede volver a poner PostgreSQL en modo trust automáticamente, restablecer la contraseña y luego restaurar la configuración original. Vuelva a ejecutar:

# Linux
sudo dpkg-reconfigure uversion-server

# Windows
iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex
# (re-passe par le script avec -Reconfigure)

El puerto 8443 ya está en uso

uVersion escucha por defecto en HTTPS en el 8443 (y mantiene el 8080 abierto como fallback HTTP). Si uno de los dos está ocupado:

# Linux
sudo ss -tlnp | grep -E '8443|8080'

# Windows
Get-NetTCPConnection -LocalPort 8443 | Select-Object OwningProcess, State
Get-Process -Id <PID>

Para cambiar el puerto TLS, edite config.toml:

[tls]
https_port = 9443

Luego reinicie el servicio.

El cliente rechaza la conexión TLS

uVersion usa un certificado autofirmado bloqueado mediante TOFU en el lado del cliente (consulte Huella TLS). Las causas más frecuentes:

Primera conexión sin confirmar: el cliente de escritorio muestra un cuadro de diálogo con la huella. Compárela con lo que le compartió el administrador. En la CLI, ejecute uversion trust <url>.
Huella cambiada (advertencia roja): el servidor se reinstaló y regeneró su certificado. Confirme out-of-band con el administrador y luego:
- Escritorio: haga clic en Trust new fingerprint en el diálogo rojo
- CLI: uversion mistrust <url> luego uversion login <url>
El servidor no sirve HTTPS: compruebe que realmente escucha en el 8443, no en el 8080:
```
# Linux
ss -tlnp | grep 8443
# Windows
Get-NetTCPConnection -LocalPort 8443 -State Listen
```
Si no escucha nada, compruebe que [tls] disabled = false en config.toml (es el valor por defecto).

Volver a mostrar la huella en el lado del servidor:

# Linux
sudo cat /var/lib/uversion/data/tls/fingerprint
# Windows
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Reinicio completo

Consulte las páginas Desinstalar en Ubuntu/Debian o Desinstalar en Windows para empezar con una instalación limpia.