Wiki
Solución de problemas
Soluciones a problemas comunes, tanto del lado del servidor como del lado del usuario: servicio bloqueado, código de activación rechazado, PostgreSQL, TLS, mensajes del cliente y del editor de Unreal.
El servicio no arranca
Linux: systemctl start falla
sudo journalctl -u uversion-server -n 100 --no-pagerCausas 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 50Causas frecuentes:
- Falta la variable de entorno
CONFIG_PATH: normalmente la define el instalador enHKLM\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 primero la base de datos en sí, independientemente de uVersion.
En Linux:
sudo -u postgres psql -c "SELECT 1;"En Windows:
& "C:\Program Files\PostgreSQL\16\bin\psql.exe" -U postgres -h 127.0.0.1 -c "SELECT 1;"Si PostgreSQL responde pero se ha perdido la contraseña del superusuario,
el instalador de uVersion (el postinst en Linux como install.ps1 en
Windows) puede volver a poner PostgreSQL en modo trust automáticamente, restablecer la
contraseña y luego restaurar la configuración original. Vuelva a ejecutarlo.
En Linux:
sudo dpkg-reconfigure uversion-serverEn Windows: el comando de instalación ordinario basta, el restablecimiento se activa por sí solo en cuanto la contraseña guardada falta o es rechazada.
iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex
El parámetro -Reconfigure solo sirve para reescribir además un
config.toml ya presente, y exige la forma larga del comando: la
forma corta de arriba no pasa ningún parámetro al script. Consulte
Instalar en Windows.
El puerto 8443 ya está en uso
uVersion escucha por defecto en HTTPS en el 8443.
tls.https_port (8443 por defecto),
o bien en HTTP simple en server.port, nunca ambos. El HTTP simple solo existe si
TLS se ha deshabilitado explícitamente ([tls] disabled = true), y en ese caso
el 8443 ya no escucha en absoluto. En consecuencia: «nada escucha en el 8443» no significa «se ha
replegado al 8080», sino «TLS está deshabilitado» o «el servidor no arrancó». Y un puerto 8080 ocupado en una
instalación normal no tiene nada que ver con uVersion.
Para saber qué ocupa el puerto, en Linux:
sudo ss -tlnp | grep 8443En Windows, en dos pasos: el proceso propietario, luego su nombre.
Get-NetTCPConnection -LocalPort 8443 | Select-Object OwningProcess, State
Get-Process -Id <PID>Para cambiar el puerto TLS, edite config.toml:
[tls]
https_port = 9443Luego 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
la ventana Verify server identity con la huella SHA-256. Compárela con
la que le comunicó el administrador y luego haga clic en
Trust this server. En la CLI, el comando equivalente es
uversion trust <url>: es interactivo, muestra la huella que anuncia el servidor y espera su confirmación por teclado. Añada--yespara omitir esta confirmación, por ejemplo en un script. - Huella cambiada (advertencia roja): el servidor se reinstaló
y regeneró su certificado. Confirme con el administrador por otro canal y luego:
- Escritorio: haga clic en Trust new fingerprint en el diálogo rojo
- CLI:
uversion mistrust <url>luegouversion login <url>
- El servidor no sirve HTTPS: compruebe que realmente escucha
en el 8443.
En Linux:
En Windows:ss -tlnp | grep 8443
Si no escucha nada, compruebe queGet-NetTCPConnection -LocalPort 8443 -State Listen[tls] disabled = falseenconfig.toml(es el valor por defecto). Recordatorio: cuando TLS está deshabilitado, el servidor pasa a HTTP simple y el 8443 ya no escucha en absoluto, no hay doble escucha. - Volver a mostrar la huella en el lado del servidor, en Linux:
En Windows:sudo cat /var/lib/uversion/data/tls/fingerprintGet-Content "C:\ProgramData\uVersion\data\tls\fingerprint"
Lado del usuario: mensajes del cliente y del editor
Las secciones anteriores tratan del servidor. Estos son los bloqueos con los que se topan los usuarios, con el mensaje exacto tal como aparece y qué hacer.
No puedo crear un repositorio
Admin role requiredLa creación de un repositorio está reservada al superadministrador del servidor. El rol
project_admin no basta: administra los proyectos que se le confían, no los crea.
Pida a su superadministrador que cree el repositorio y luego lo nombre administrador de él.
Abrir una carpeta local falla
Not a uVersion repositoryLa carpeta elegida no contiene un .uversion/config.toml. Probablemente ha señalado la carpeta
principal o una subcarpeta. Apunte a la raíz del workspace, la que contiene la carpeta .uversion/.
Crear un repositorio a partir de una carpeta existente falla
This folder is already a uVersion repository - use "Open Local Repository" instead.La carpeta ya es un workspace. No busca crear uno nuevo, sino volver a abrir ese: use Open Local Repository.
El cliente se niega a abrir un workspace
This workspace belongs to '<owner>'. Clone your own copy instead.Esta carpeta fue clonada por otra cuenta, cuyo nombre está inscrito en .uversion/config.toml. Esto
ocurre al copiar un workspace de un equipo a otro, o al cambiar de cuenta en el cliente. El rechazo es
deliberado: operar bajo otra identidad produciría bloqueos y commits atribuidos a la persona equivocada.
Clone su propia copia. Si de verdad es su carpeta pero la otra cuenta también es suya, cambie a ella en
el selector de cuentas.
La ruta del motor Unreal es rechazada
Invalid Unreal Engine path: '...' is not a recognizable engine installEl cliente espera la raíz de una instalación de Unreal, la que contiene a la vez
Engine/Build/BatchFiles y Engine/Binaries. Por ejemplo
C:\Program Files\Epic Games\UE_5.6, y no la subcarpeta Engine, ni la carpeta de
su proyecto, ni un acceso directo.
Una acción de Unreal se niega a iniciarse
Unreal Engine path not configured. Please set it first.La detección automática no encontró nada. Configure la ruta mediante el menú " … " de la barra
Unreal, entrada Set Engine Path.... No hay otro punto de entrada: ni campo de
entrada, ni botón Browse en la propia barra.
Si la barra Unreal está totalmente ausente, no es la ruta del motor: el cliente no
encontró el .uproject. Solo lo busca hasta tres niveles de profundidad bajo la raíz del workspace,
y más allá desaparece sin mensaje. Acerque el proyecto a la raíz.
Unreal rechaza mi envío de código
Code files must be submitted from the uVersion desktop clientEl plugin rechaza el checkin de los archivos .cpp, .h, .hpp, .c
y .cs: el cliente de escritorio compila antes de enviar y publica los binarios del editor. Envíe su código
desde el cliente.
You have code files checked out (...): submit your code from the uVersion desktop client firstUna variante mucho más desconcertante, que afecta incluso a quienes no escriben código: un solo archivo de código reservado por usted también bloquea sus envíos de contenido, aunque ese archivo no forme parte del envío. Abra la pestaña Pending del cliente de escritorio, sección Your locks, y haga un Checkin o un Revert sobre los archivos de código que queden ahí. Consulte Plugin de Unreal Engine.
Unreal no ve el servidor
El editor muestra una notificación pidiendo iniciar el cliente de escritorio. Es lo esperado: un servidor uVersion está autofirmado por defecto, y Unreal no sabe validar un certificado autofirmado. El formulario de conexión de la ventana Revision Control Login no supera este obstáculo, rellenarlo no sirve de nada. Inicie el cliente de escritorio, conéctese con la cuenta propietaria del workspace, y el plugin pasará por él.
La reserva de archivos falla
Failed to acquire locks for {n} file(s). Another user may have them checked out.Otra persona posee esos bloqueos. La pestaña Pending, sección Other Users' Locks, dice quién, y ofrece un botón Request Release por fila. Recordatorio útil: un bloqueo no caduca nunca, nadie lo liberará por el simple paso del tiempo. Un administrador puede forzar el desbloqueo, y la operación queda registrada en la auditoría.
El clon por línea de comandos rechaza la carpeta
Directory '...' already exists and is not emptyuversion clone exige una carpeta de destino vacía o inexistente. Vacíela, elimínela, o apunte a
otra ruta. No confundir con el cliente de escritorio, donde la carpeta que elige es la
principal: crea dentro de ella una subcarpeta con el nombre del workspace.
Sesión caducada
El cliente intenta primero renovar el token en silencio. Si no lo consigue, vuelve a la página de conexión con un banner. Basta con volver a introducir su contraseña. Si esto se repite sin cesar, suele deberse a que la cuenta se ha desactivado en el lado del servidor, o a que una desconexión explícita ha revocado los tokens de todos sus clientes.
Reinicio completo
Consulte las páginas Desinstalar en Ubuntu/Debian o Desinstalar en Windows para empezar con una instalación limpia.