Corriger les erreurs du serveur de licences V-Ray (2026)

Les erreurs du serveur de licences V-Ray peuvent bloquer votre pipeline de rendu. Nous avons rencontré presque toutes les variantes de ces erreurs sur l'infrastructure de notre render farm, des pannes de dongle matériel aux conflits de licences réseau. Ce guide couvre à la fois les licences héritées basées sur dongle et la nouvelle approche de licence Chaos Cloud basée sur un compte, qui équipe V-Ray 6 et 7.

Comprendre l'architecture du serveur de licences V-Ray

Le serveur de licences V-Ray (vrlservice.exe sous Windows, vrlservice sous Linux/macOS) gère la manière dont V-Ray accède à sa licence. Que vous utilisiez un dongle physique WIBU-KEY, un Chaos License Server local ou la licence en ligne basée sur un compte Chaos, le serveur orchestre les contrôles d'autorisation et valide votre licence.

Sur notre render farm, nous gérons les licences sur plusieurs nœuds de rendu : certains utilisent des dongles hérités, d'autres sont connectés à des serveurs de licences partagés, et notre infrastructure plus récente utilise la licence basée sur un compte Chaos. Chaque approche a ses propres modes de défaillance et ses propres étapes de récupération.

L'erreur « No License for This Product » expliquée

Lorsque V-Ray signale « vray no license for this product error » ou des messages similaires, cela signifie généralement l'une de ces trois choses : le serveur de licences n'a pas démarré, le dongle n'est pas reconnu, ou le serveur de licences ne parvient pas à joindre votre source d'authentification.

L'échec de démarrage de vrlservice.exe est la cause principale. Le service tente de démarrer à l'initialisation de V-Ray ; s'il échoue, des erreurs de licence apparaissent immédiatement. Contrairement à certains logiciels qui se replient en douceur, V-Ray s'arrête net : pas de mode d'essai, pas de fonctionnalités réduites.

Licence par dongle : dépannage du système hérité

Si vous utilisez V-Ray 6 ou une version antérieure avec un dongle WIBU-KEY, commencez ici.

Étape 1 : vérifier la connexion du dongle

Inspectez physiquement votre dongle USB. Vérifiez qu'il est bien enfoncé dans un port USB. Branchez-le sur un autre port USB 2.0 : les ports USB 3.0 posent parfois des problèmes de reconnaissance avec les anciens dongles.

Évitez de chaîner plusieurs dongles ou de passer par des hubs non alimentés. Pour vos tests, utilisez une connexion directe au connecteur USB de la carte mère de l'hôte, et non un port du panneau avant.

Étape 2 : mettre à jour les pilotes WIBU-KEY

Le pilote WIBU-KEY permet à votre système de reconnaître le dongle physique. Un pilote obsolète ou corrompu est la cause la plus fréquente des erreurs « dongle not found ».

Commencez par désinstaller complètement le pilote WIBU-KEY. Sous Windows, ouvrez le Gestionnaire de périphériques (Device Manager, devmgmt.msc), repérez WIBU-KEY sous « Universal Serial Bus controllers », faites un clic droit, puis sélectionnez « Uninstall device ». Cochez la case pour supprimer le logiciel du pilote.

Redémarrez complètement votre système. Après le redémarrage, rendez-vous sur wibu.com et téléchargez le dernier pilote WIBU-KEY correspondant à votre version du système d'exploitation. Installez-le à neuf. Redémarrez à nouveau.

Sous Linux et macOS, vous devrez peut-être décharger le module du noyau :

sudo kextunload -b com.wibu.CodeMeter

Téléchargez ensuite et installez le dernier logiciel WIBU-KEY depuis le portail d'assistance de Chaos.

Étape 3 : vérifier la reconnaissance dans le Gestionnaire de périphériques

Dans le Gestionnaire de périphériques, développez « Universal Serial Bus controllers ». Votre WIBU-KEY doit apparaître sous le nom « WIBU-KEY » ou « CodeMeter » (la technologie sous-jacente). Si vous voyez un point d'exclamation jaune ou « Unknown Device », l'installation du pilote a échoué.

Répétez l'étape 2, ou contactez l'assistance de Chaos si l'installation du pilote signale un code d'erreur.

Étape 4 : vérifier le fichier de licence sur le dongle

Si le dongle est reconnu mais que V-Ray signale toujours des licences manquantes, le fichier de licence stocké sur le dongle est peut-être corrompu ou absent.

Certaines structures utilisent encore l'ancien outil « License Medic » (désormais obsolète). Utilisez plutôt le logiciel License Server de Chaos pour lire et valider le contenu du dongle. Sous Windows, vous pouvez aussi vérifier depuis le panneau Settings de V-Ray : render settings > System > License Server > Manual License Server Setup.

Migration de V-Ray 6 vers V-Ray 7 : changements de licence

Si vous migrez de V-Ray 6 vers V-Ray 7, sachez que Chaos a fondamentalement changé le fonctionnement des licences. V-Ray 7 ne prend plus en charge les dongles physiques WIBU-KEY pour les nouvelles installations.

V-Ray 7 requiert l'une des deux options suivantes :

Un Chaos License Server (un serveur de licences logiciel local qui communique avec le cloud Chaos)
La licence en ligne basée sur un compte Chaos (authentification directe auprès de votre compte Chaos)

Si vous mettez à niveau des nœuds de rendu existants qui utilisaient des dongles, deux voies s'offrent à vous :

Voie A : installez un Chaos License Server sur votre réseau. Ce serveur se connecte une seule fois au cloud Chaos, puis met les licences en cache localement. Vos nœuds de rendu se connectent à ce serveur (port 30304 par défaut). Cette approche fonctionne même si les nœuds de rendu perdent temporairement l'accès à Internet.

Voie B : configurez V-Ray 7 avec les identifiants directs de votre compte Chaos. Chaque nœud de rendu s'authentifie de manière indépendante auprès du cloud Chaos. Cela exige que tous les nœuds puissent joindre Internet ou un proxy.

Nous sommes passés à la voie A sur notre render farm, car nous subissons parfois des coupures réseau et le modèle de licences en cache est plus résilient.

Configuration du Chaos License Server (recommandée pour les render farms)

Le Chaos License Server est le remplaçant moderne des dongles physiques comme des anciens logiciels de serveur de licences.

Téléchargez le Chaos License Server depuis le portail de documentation de Chaos. Il s'agit d'un exécutable unique : cslserver.exe sous Windows.

Sur l'hôte de votre serveur de licences, exécutez-le avec des privilèges élevés :

cslserver.exe

Par défaut, il écoute sur le port 30304. Assurez-vous que ce port est ouvert entre votre serveur de licences et tous les nœuds de rendu.

Générez ou importez vos identifiants Chaos dans le License Server. Vous aurez besoin de l'adresse e-mail de votre compte Chaos et d'une clé de licence ou d'un identifiant d'abonnement.

Sur chaque nœud de rendu, configurez V-Ray pour qu'il se connecte à votre License Server. Dans les paramètres de licence Chaos, définissez :

License Server: <your-server-ip>:30304

Redémarrez vrlservice. Testez en lançant V-Ray sur un nœud de rendu.

Conflits de ports et règles de pare-feu

Le port 30304 est le port standard du Chaos License Server. Si vous recevez des erreurs « connection refused » ou des messages « port already in use », quelque chose d'autre occupe ce port.

Vérifiez ce qui écoute sur le port 30304 :

Sous Windows (exécuté en tant qu'administrateur) :

netstat -ano | find ":30304"

Sous Linux/macOS :

lsof -i :30304

Si un autre service occupe le port, arrêtez ce service ou reconfigurez le Chaos License Server pour qu'il utilise un autre port (défini dans le fichier de configuration de cslserver).

Concernant les règles de pare-feu : assurez-vous que vos nœuds de rendu peuvent joindre le serveur de licences sur le port 30304 (TCP). Si votre render farm s'étend sur plusieurs sous-réseaux, vérifiez que les ACL réseau autorisent ce trafic. Nous maintenons une règle de pare-feu interne nommée « SRF_License_Server_Access » qui permet à tous les nœuds de rendu de joindre notre serveur de licences principal.

Si vous utilisez un pare-feu d'entreprise, ajoutez les plages d'adresses IP du cloud Chaos à votre liste d'autorisation. Chaos publie ces plages dans sa documentation.

Licence en ligne : méthode directe par compte Chaos

Vous pouvez aussi utiliser V-Ray 7 avec l'authentification directe par compte Chaos, sans License Server local.

Créez un compte Chaos et achetez un abonnement V-Ray. Pendant l'installation de V-Ray ou dans les paramètres de rendu, sélectionnez « Cloud Authorization » et saisissez vos identifiants Chaos.

V-Ray s'authentifiera auprès du cloud Chaos à chaque démarrage. Chaque nœud de rendu a besoin d'un accès à Internet (ou d'un accès par proxy) aux points de terminaison cloud de Chaos.

Pour une render farm, cette approche est plus simple à déployer : aucune infrastructure de License Server distincte. En revanche, elle tolère moins bien les pannes si votre connexion Internet tombe pendant le rendu.

Licences avec Docker et machines virtuelles

Si vous exécutez V-Ray dans des conteneurs Docker ou sur des machines virtuelles, les licences se comportent légèrement différemment.

Pour les conteneurs Docker, les périphériques USB de l'hôte (dongles) doivent être transmis au conteneur. Dans ce cas, assurez-vous que le conteneur s'exécute avec des privilèges suffisants :

docker run --privileged --device /dev/bus/usb ...

Le pilote WIBU-KEY doit être installé sur le système d'exploitation hôte, et non dans le conteneur.

Pour les machines virtuelles, les dongles physiques peuvent être transmis par redirection USB, mais cela introduit de la latence et de l'instabilité. La plupart des render farms à grande échelle évitent le passthrough USB. Utilisez plutôt le Chaos License Server exécuté sur l'hôte, auquel les machines virtuelles se connectent via le réseau.

Le Chaos License Server (réseau) fonctionne sans accroc sur les machines virtuelles, car il s'agit d'une connexion TCP/IP standard. Aucune redirection matérielle n'est nécessaire.

Licences d'une render farm : comment les services gérés s'en occupent

Sur notre render farm, la licence des nœuds de rendu est incluse dans votre tarif : vous ne gérez pas vous-même les licences. Nous maintenons une infrastructure Chaos License Server redondante avec basculement. Si un serveur devient indisponible, la flotte de rendu bascule automatiquement vers un serveur de secours.

Super Renders Farm est un partenaire officiel de Chaos Group pour V-Ray : la licence des nœuds de rendu est gérée de manière centralisée dans le cadre de cet accord de partenariat, ce qui explique pourquoi les défaillances de dongle, de conflit de ports et de pilote décrites ci-dessus relèvent de notre dépannage, et non d'une configuration à effectuer nœud par nœud de votre côté.

Pour les clients qui exploitent leur propre infrastructure de render farm, le même principe s'applique : déployez votre ou vos License Servers avec redondance. Exécutez un serveur principal et au moins un serveur de secours à chaud. Testez régulièrement le basculement.

Nous surveillons aussi en permanence l'état du serveur de licences. Si le serveur devient injoignable, nous sommes alertés immédiatement. Sur une render farm indépendante, mettez en place une surveillance similaire : n'attendez pas qu'un job de rendu échoue pour découvrir que le serveur de licences est hors service.

Intégration de Chaos Cloud et licence basée sur un compte

Chaos Cloud est la plateforme de rendu cloud native de Chaos. Si vous utilisez Chaos Cloud ou envisagez de le faire, les licences sont gérées entièrement via votre compte Chaos.

Au sein de Chaos Cloud, les licences V-Ray sont facturées à l'usage. Vous êtes facturé à l'heure de rendu ou par job terminé, et non par nœud. Ce modèle supprime la nécessité de gérer les licences nœud par nœud, puisque la plateforme cloud distribue les licences de manière centralisée.

Si vous intégrez Chaos Cloud à une render farm sur site, vous pouvez utiliser les deux : des nœuds sur site avec un Chaos License Server local, et du débordement vers le cloud via Chaos Cloud. Chaque système s'authentifie de manière indépendante.

Dépannage des conflits de ports dans les configurations à forte concurrence

Si vous exploitez de nombreux nœuds de rendu et processus vrlservice, vous risquez de rencontrer un épuisement des ports éphémères. Cela se manifeste par des erreurs « connection refused » sporadiques qui semblent aléatoires.

Le problème : chaque processus vrlservice a besoin d'un port pour écouter. Si vous avez des centaines de nœuds de rendu qui redémarrent tous simultanément (après une coupure de courant, par exemple), la plage de ports éphémères du système d'exploitation peut être épuisée.

Sous Linux, augmentez la plage de ports éphémères :

sysctl -w net.ipv4.ip_local_port_range="1024 65535"

Sous Windows, vous pouvez ajuster les paramètres du registre (consultez l'assistance de Chaos pour les entrées HKEY_LOCAL_MACHINE spécifiques).

Une solution de contournement plus simple : échelonnez les redémarrages des nœuds. Redémarrez les nœuds par lots de 10 à 20 toutes les quelques minutes, plutôt que tous en même temps.

Étapes de vérification après la correction des erreurs de licence

Après avoir appliqué une correction, vérifiez que le serveur de licences de V-Ray fonctionne :

Ouvrez un terminal et exécutez :
```
vrlservice --status
```
(ou vérifiez la présence du processus vrlservice dans le Gestionnaire des tâches / Moniteur d'activité)
Ouvrez V-Ray et consultez Settings > System > License. Il doit afficher « Licensed » et votre type de licence (dongle, serveur ou compte cloud).
Si vous utilisez un License Server, lancez un test rapide depuis un nœud de rendu :
```
vrlcontrol --server <license-server-ip> --status
```
Soumettez un job de rendu de test sur au moins un nœud de rendu.

Ces vérifications confirment que la chaîne de licence est intacte, de la source d'authentification jusqu'à votre moteur de rendu.

FAQ

Q: Je vois « License Server not responding » alors que le serveur est en cours d'exécution. Que se passe-t-il ? A: Vérifiez la connectivité réseau entre le nœud de rendu et le serveur de licences. Vérifiez que l'adresse IP et le port sont corrects. Confirmez que le pare-feu autorise le port 30304 (ou le port que vous avez configuré). Si vous utilisez un VPN, assurez-vous que le sous-réseau du VPN peut joindre le serveur de licences. Exécutez ping <license-server-ip> depuis le nœud de rendu. Si le ping échoue, il s'agit d'un problème réseau, et non d'un problème de licence.

Q: Puis-je utiliser un ancien dongle WIBU-KEY avec V-Ray 7 ? A: Non. V-Ray 7 a supprimé la prise en charge des dongles. Vous devez utiliser soit le Chaos License Server, soit la licence en ligne basée sur un compte Chaos. Si vous possédez des licences WIBU-KEY existantes, contactez Chaos au sujet d'un programme de migration ou de reprise de licences.

Q: Notre render farm n'a pas accès à Internet. Comment licencier V-Ray 7 ? A: Utilisez le Chaos License Server. Le License Server se connecte une fois au cloud Chaos pour valider et mettre en cache vos licences. Ensuite, les nœuds de rendu se connectent uniquement à votre License Server local : aucun accès à Internet n'est requis. Assurez-vous que l'hôte de votre License Server dispose d'un accès à Internet, mais pas les nœuds de rendu. Toutefois, les licences sont actualisées périodiquement (consultez la documentation de Chaos pour connaître l'intervalle d'actualisation), de sorte que de longues périodes hors ligne peuvent entraîner l'expiration des licences.

Q: Ai-je besoin de licences distinctes pour chaque nœud de rendu ? A: Non. Sur une render farm, vous achetez généralement une ou plusieurs licences nominatives que le License Server gère et distribue aux nœuds de rendu. Chaque job de rendu simultané consomme une licence. Les nœuds de rendu inactifs ne consomment pas de licences. Demandez à votre interlocuteur chez Chaos quel niveau de licence convient à votre nombre de nœuds.

Q: Pourquoi vrlservice.exe plante-t-il au démarrage ? A: La cause est généralement liée au pilote (ancien pilote WIBU-KEY) ou aux autorisations (le compte de service ne dispose pas de privilèges suffisants). Sous Windows, vérifiez que le service s'exécute en tant que Local System ou sous un compte utilisateur disposant de tous les droits d'administrateur. Téléchargez à nouveau et installez le dernier logiciel WIBU-KEY ou Chaos License Server. Consultez l'Observateur d'événements (Event Viewer) pour les journaux de plantage du service.

Q: Puis-je exécuter plusieurs Chaos License Servers pour le basculement ? A: Oui, et nous le recommandons. Configurez-en un comme principal et les autres comme secondaires. Les nœuds de rendu peuvent être réglés pour essayer d'abord le serveur principal, puis se rabattre sur les serveurs secondaires si le principal est injoignable. La configuration exacte dépend de la documentation actuelle de Chaos : rapprochez-vous donc de leur équipe d'assistance pour votre version.

Prochaines étapes

Si ces étapes de dépannage ne résolvent pas votre problème, rassemblez les éléments suivants et contactez l'assistance de Chaos :

Les numéros de version de V-Ray et du License Server
Les messages d'erreur et codes d'erreur (issus des journaux et de l'interface)
Votre système d'exploitation et son architecture (Windows 10/11, Ubuntu 20.04, etc.)
La topologie réseau (sur site, cloud, hybride)
Tout changement récent (mises à jour de pilotes, correctifs du système d'exploitation, modifications réseau)

Si vous utilisez les services de SuperRenders Farm, notre équipe d'assistance peut souvent résoudre les problèmes de licence sans passer par Chaos. Nous avons une visibilité approfondie sur notre propre infrastructure de License Server et pouvons diagnostiquer rapidement les problèmes au niveau des nœuds.