uVersion
Français
Télécharger →

Wiki

Dépannage

Solutions aux problèmes courants, côté serveur comme côté utilisateur : service bloqué, code d'activation rejeté, PostgreSQL, TLS, messages du client et de l'éditeur Unreal.

Le service ne démarre pas

Linux : systemctl start échoue 
sudo journalctl -u uversion-server -n 100 --no-pager

Causes fréquentes :

  • PostgreSQL inactif : sudo systemctl status postgresql
  • Mot de passe DB perdu : le postinst regénère la conf avec --reconfigure (sudo dpkg-reconfigure uversion-server)
  • Port 8443 occupé : voir section dédiée plus bas
Windows : erreur 1053 ou 1067

Le service démarre puis s'arrête. Vérifiez l'Event Viewer :

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

Causes fréquentes :

  • Variable d'environnement CONFIG_PATH manquante : normalement définie par l'installateur dans HKLM\SYSTEM\CurrentControlSet\Services\uVersionServer\Environment
  • PostgreSQL inactif : Get-Service postgresql*

Le code d'activation est rejeté

  • Vérifiez que le code n'a pas été utilisé sur une autre machine (chaque code est lié au server-ID de la première install). Demandez un nouveau code depuis votre espace compte.
  • Vérifiez la connectivité vers licence.uversion.io : curl -I https://licence.uversion.io/api/v1/health
  • Si vous voulez réutiliser un code sur une nouvelle machine après désinstallation, contactez le support pour libérer le server-ID précédent.

PostgreSQL inaccessible

Le service uVersion n'arrive pas à se connecter à la base. Testez d'abord la base elle-même, indépendamment d'uVersion.

Sous Linux :

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

Sous Windows :

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

Si PostgreSQL répond mais que le mot de passe du super-utilisateur est perdu, l'installateur uVersion (le postinst sous Linux comme install.ps1 sous Windows) sait remettre PostgreSQL en mode trust automatiquement, réinitialiser le mot de passe, puis restaurer la configuration d'origine. Re-lancez-le.

Sous Linux :

sudo dpkg-reconfigure uversion-server

Sous Windows : la commande d'installation ordinaire suffit, la réinitialisation se déclenche d'elle-même dès que le mot de passe enregistré est absent ou refusé.

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Le paramètre -Reconfigure ne sert qu'à réécrire en plus un config.toml déjà présent, et il exige la forme longue de la commande : la forme courte ci-dessus ne transmet aucun paramètre au script. Voir Installer sur Windows.

Port 8443 déjà utilisé

uVersion écoute par défaut en HTTPS sur 8443.

Il n'y a pas de repli HTTP sur 8080 : les deux modes sont exclusifs Le serveur écoute soit en HTTPS sur tls.https_port (8443 par défaut), soit en HTTP simple sur server.port, jamais les deux. Le HTTP simple n'existe que si TLS a été explicitement désactivé ([tls] disabled = true), et dans ce cas 8443 n'écoute plus du tout. En conséquence : « rien n'écoute sur 8443 » ne veut pas dire « ça est retombé sur 8080 », mais « TLS est désactivé » ou « le serveur n'a pas démarré ». Et un port 8080 occupé sur une installation normale n'a aucun rapport avec uVersion.

Pour savoir qui occupe le port, sous Linux :

sudo ss -tlnp | grep 8443

Sous Windows, en deux temps : le processus propriétaire, puis son nom.

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

Pour changer le port TLS, éditez config.toml :

[tls]
https_port = 9443

Puis redémarrez le service.

Client refuse la connexion TLS

uVersion utilise un certificat auto-signé verrouillé via TOFU côté client (voir Empreinte TLS). Causes les plus fréquentes :

  • Première connexion non confirmée : le client desktop affiche la fenêtre Verify server identity avec l'empreinte SHA-256. Comparez-la avec celle que l'administrateur vous a communiquée, puis cliquez sur Trust this server. Côté CLI, la commande équivalente est uversion trust <url> : elle est interactive, elle affiche l'empreinte que le serveur annonce et attend votre confirmation au clavier. Ajoutez --yes pour sauter cette confirmation, dans un script par exemple.
  • Empreinte changée (avertissement rouge) : le serveur a été réinstallé et a regénéré son certificat. Confirmez avec l'administrateur par un autre canal, puis :
    • Desktop : cliquez sur Trust new fingerprint dans le dialogue rouge
    • CLI : uversion mistrust <url> puis uversion login <url>
  • Le serveur ne sert pas HTTPS : vérifiez qu'il écoute bien sur 8443. Sous Linux : 
    ss -tlnp | grep 8443
    Sous Windows : 
    Get-NetTCPConnection -LocalPort 8443 -State Listen
    Si rien n'écoute, vérifiez que [tls] disabled = false dans config.toml (c'est le défaut). Rappel : quand TLS est désactivé, le serveur passe en HTTP simple et 8443 n'écoute plus du tout, il n'y a pas de double écoute.
  • Empreinte à ré-afficher côté serveur, sous Linux : 
    sudo cat /var/lib/uversion/data/tls/fingerprint
    Sous Windows : 
    Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Côté utilisateur : messages du client et de l'éditeur

Les sections ci-dessus concernent le serveur. Voici les blocages que rencontrent les utilisateurs, avec le message exact tel qu'il s'affiche et ce qu'il faut faire.

Je ne peux pas créer de dépôt

Admin role required

La création d'un dépôt est réservée au super administrateur du serveur. Le rôle project_admin ne suffit pas : il administre les projets qui lui sont confiés, il n'en crée pas. Demandez à votre super administrateur de créer le dépôt puis de vous en nommer administrateur.

Ouvrir un dossier local échoue

Not a uVersion repository

Le dossier choisi ne contient pas de .uversion/config.toml. Vous avez probablement désigné le dossier parent, ou un sous-dossier. Visez la racine du workspace, celle qui contient le dossier .uversion/.

Créer un dépôt à partir d'un dossier existant échoue

This folder is already a uVersion repository - use "Open Local Repository" instead.

Le dossier est déjà un workspace. Vous ne cherchez pas à en créer un nouveau, mais à rouvrir celui-là : utilisez Open Local Repository.

Le client refuse d'ouvrir un workspace

This workspace belongs to '<owner>'. Clone your own copy instead.

Ce dossier a été cloné par un autre compte, dont le nom est inscrit dans .uversion/config.toml. Cela arrive quand on copie un workspace d'un poste à l'autre, ou quand on change de compte dans le client. Le refus est volontaire : opérer sous une autre identité produirait des verrous et des commits attribués à la mauvaise personne. Clonez votre propre copie. Si c'est bien votre dossier mais l'autre compte est aussi le vôtre, basculez dessus dans le sélecteur de comptes.

Le chemin du moteur Unreal est refusé

Invalid Unreal Engine path: '...' is not a recognizable engine install

Le client attend la racine d'une installation d'Unreal, celle qui contient à la fois Engine/Build/BatchFiles et Engine/Binaries. Par exemple C:\Program Files\Epic Games\UE_5.6, et non le sous-dossier Engine, ni le dossier de votre projet, ni un raccourci.

Une action Unreal refuse de démarrer

Unreal Engine path not configured. Please set it first.

La détection automatique n'a rien trouvé. Réglez le chemin via le menu « … » de la barre Unreal, entrée Set Engine Path.... Il n'y a pas d'autre point d'entrée : ni champ de saisie, ni bouton Browse dans la barre elle-même.

Si la barre Unreal est entièrement absente, ce n'est pas le chemin du moteur : le client n'a pas trouvé le .uproject. Il ne le cherche que sur trois niveaux de profondeur sous la racine du workspace, et au-delà il disparaît sans message. Remontez le projet plus près de la racine.

Unreal refuse mon envoi de code

Code files must be submitted from the uVersion desktop client

Le plugin refuse le checkin des fichiers .cpp, .h, .hpp, .c et .cs : le client desktop compile avant d'envoyer et publie les binaires d'éditeur. Envoyez votre code depuis le client.

You have code files checked out (...): submit your code from the uVersion desktop client first

Variante beaucoup plus déroutante, qui frappe même les personnes qui n'écrivent pas de code : un seul fichier de code réservé par vous bloque aussi vos envois de contenu, même si ce fichier ne fait pas partie de l'envoi. Ouvrez l'onglet Pending du client desktop, section Your locks, et faites un Checkin ou un Revert sur les fichiers de code qui y traînent. Voir Plugin Unreal Engine.

Unreal ne voit pas le serveur

L'éditeur affiche une notification demandant de démarrer le client desktop. C'est attendu : un serveur uVersion est auto-signé par défaut, et Unreal ne sait pas valider un certificat auto-signé. Le formulaire de connexion de la fenêtre Revision Control Login ne franchit pas cet obstacle, le remplir ne sert à rien. Lancez le client desktop, connectez-vous avec le compte propriétaire du workspace, et le plugin passera par lui.

La réservation de fichiers échoue

Failed to acquire locks for {n} file(s). Another user may have them checked out.

Quelqu'un d'autre détient ces verrous. L'onglet Pending, section Other Users' Locks, dit qui, et propose un bouton Request Release par ligne. Rappel utile : un verrou n'expire jamais, personne ne le rendra par simple écoulement du temps. Un administrateur peut forcer le déverrouillage, et l'opération est tracée dans l'audit.

Le clone en ligne de commande refuse le dossier

Directory '...' already exists and is not empty

uversion clone exige un dossier de destination vide ou inexistant. Videz-le, supprimez-le, ou visez un autre chemin. À ne pas confondre avec le client desktop, où le dossier que vous choisissez est le parent : il crée dedans un sous-dossier au nom du workspace.

Session expirée

Le client tente d'abord de renouveler le jeton en silence. S'il n'y arrive pas, il revient à la page de connexion avec un bandeau. Ressaisissez simplement votre mot de passe. Si cela se reproduit sans arrêt, c'est en général que le compte a été désactivé côté serveur, ou qu'une déconnexion explicite a révoqué les jetons de tous vos clients.

Reset complet

Voir les pages Ubuntu/Debian désinstaller ou Windows désinstaller pour repartir sur une install propre.