Dépannage

Bien que ce plugin vise à simplifier votre expérience, il est important de garder à l’esprit qu’il s’agit d’un travail en cours et qu’il repose sur divers composants tels qu’OpenSimulator, WordPress, PHP et MySQL. Avec des dépendances multiples, il est naturel de rencontrer des difficultés en cours de route.

Pour vous aider à résoudre les problèmes que vous pourriez rencontrer, nous avons établi une liste de contrôle complète. Cette liste de contrôle vous guidera à travers les étapes nécessaires pour identifier et résoudre la plupart des problèmes que vous pourriez rencontrer lors de la configuration et de l’utilisation du plugin w4os.

Avant d’installer w4os :

  • Assurer la fonctionnalité du site web : Assurez-vous que votre site web fonctionne sans problème sans l’installation de w4os.
  • Vérifier OpenSimulator Grid/Standalone : Confirmez que votre grille OpenSimulator ou votre configuration autonome fonctionne correctement.

Si des problèmes surviennent avec l’un ou l’autre, reportez-vous à leur documentation respective pour les étapes de dépannage et résolvez-les avant de procéder à l’installation de w4os.

Si vous avez effectué avec succès les vérifications initiales mentionnées ci-dessus et que vous rencontrez toujours des problèmes avec w4os, veuillez suivre les étapes de dépannage suivantes. Si le problème persiste, n’hésitez pas à demander de l’aide. Nous sommes là pour vous aider à résoudre les difficultés que vous pouvez rencontrer.

Si vous avez besoin d’aide supplémentaire ou si vous souhaitez demander de l’aide à la communauté, nous vous recommandons de visiter la page des problèmes du dépôt GitHub w4os. Vous y trouverez une mine d’informations et de solutions fournies par d’autres utilisateurs qui ont peut-être rencontré des problèmes similaires. Partager son expérience peut également contribuer à aider d’autres personnes au sein de la communauté.

Si vous décidez de soumettre un problème, assurez-vous d’inclure les informations suivantes : les versions de w4os, WordPress et PHP que vous utilisez. En outre, fournissez tous les messages d’erreur pertinents provenant du journal de votre serveur web. Ces détails nous aideront à comprendre le contexte du problème et à vous aider plus efficacement à le résoudre.

1. Vérifiez le journal des erreurs de votre serveur web

La première étape du dépannage des problèmes liés à w4os consiste à consulter le journal des erreurs de votre serveur web. Le journal des erreurs du serveur web contient des informations précieuses qui peuvent aider à identifier les problèmes liés aux connexions à la base de données ou aux erreurs de code. Suivez ces instructions pour accéder au journal des erreurs de votre serveur web et le consulter :

  • Localisez le journal des erreurs du serveur web sur votre serveur. L’emplacement spécifique peut varier en fonction de la configuration de votre serveur. Les chemins d’accès courants sont /var/log/apache2/error.log pour les serveurs Apache ou /var/log/nginx/error.log pour les serveurs Nginx.
  • Recherchez les entrées marquées ERROR. Ces lignes indiquent souvent des problèmes critiques qui requièrent une attention particulière. Prêtez-y attention, car ils peuvent révéler des problèmes de connexion à la base de données ou des erreurs de code.
  • Il est bon d’examiner également les lignes marquées comme AVERTISSEMENT, mais elles sont moins susceptibles de fournir des informations pertinentes dans ce contexte.

2. Vérifiez que la grille est opérationnelle

Avant de poursuivre le dépannage, il est essentiel de confirmer que votre grille OpenSimulator est opérationnelle. Suivez les étapes suivantes pour vous assurer que la grille est correctement configurée :

  1. Téléchargez la version stable d’OpenSimulator depuis le site officiel : http://opensimulator.org/wiki/Download.
  2. Suivez les instructions fournies sur le site web pour configurer votre grille OpenSimulator. Cela implique généralement l’installation d’OpenSimulator et la configuration des fichiers .ini nécessaires.
  3. Une fois l’installation terminée, démarrez la grille et créez votre premier avatar et votre première région à partir de la console.
  4. Tentez de vous connecter au monde en utilisant votre avatar nouvellement créé. Vérifiez que vous pouvez accéder à l’environnement virtuel et interagir avec les fonctionnalités et les objets de la grille.

En vous assurant que votre grille OpenSimulator fonctionne correctement, vous pouvez établir une base solide pour résoudre les problèmes liés au plugin w4os. Cette étape permet d’identifier si les problèmes que vous rencontrez sont spécifiques au plugin ou s’ils proviennent de la configuration de la grille elle-même.

3. Vérifier les exigences du serveur

Pour garantir le bon fonctionnement du plugin w4os, il est important de vérifier que votre serveur répond aux exigences suivantes :

  • Version minimale requise de PHP : La version minimale de PHP requise pour le plugin est la 7.3. Bien qu’il soit recommandé d’utiliser la version 8.1 ou ultérieure de PHP pour respecter les meilleures pratiques générales en matière de PHP, cela n’aura pas d’impact fonctionnel sur le plugin lui-même.
  • Installez et activez les modules PHP suivants. S’ils ne sont pas inclus dans le noyau de PHP, vous pouvez utiliser PECL pour les ajouter ou installer les paquets appropriés pour votre système (par exemple, php-xmlrpc et php-imagick sur Linux).
    • XMLRPC: Requis par la plupart des helpers et fortement recommandé pour une fonctionnalité complète de WordPress.
    • Imagick: requis par les profils et le serveur de ressources web (web assets server), et fortement recommandé pour une fonctionnalité complète de WordPress.
    • Note : Bien qu’il soit possible d’exécuter w4os sans XMLRPC ou Imagick, il est fortement déconseillé de le faire car cela entraînerait la perte de fonctionnalités essentielles, telles que les aides et les caractéristiques de profil.
  • Tenez compte des paramètres spéciaux de l’URL, en particulier de l’URL de l’adresse du site. Cela se trouve dans l’administration de WordPress > Settings > General section. Si l’adresse URL de votre site est différente de l’adresse par défaut (par exemple,« https://yourgrid.org/wordpress/ » au lieu de« https://yourgrid.org/ »), veillez à adapter l’adresse des aides en conséquence (par exemple,« https://yourgrid.org/wordpress/helpers/ »).
  • Assurez-vous que les permaliens sont activés dans WordPress. Allez dans WordPress Admin > Settings > Permalinks et vérifiez que la structure Permalink n’est pas réglée sur « Plain ». Sauvegarder tout autre choix devrait être suffisant, car w4os s’appuie sur la traduction d’URL permise par la structure Permalink.

3.1 Note pour les utilisateurs de Nginx

Vous devez ajouter cette configuration avant la directive location ~ \.php$ {...}, pour vous assurer que le plugin peut traiter les demandes d’aide :

location ~* ^/helpers/.*\.php$ {
  try_files $uri $uri/ /index.php?$args;
}

4. Vérifiez Admin > OpenSimulator > Réglages

Pour continuer le dépannage, vérifiez les paramètres dans la section OpenSimulator de votre panneau d’administration WordPress. Procédez comme suit :

  • Accédez à la page des paramètres d’OpenSimulator en naviguant vers /wp-admin/admin.php?page=w4os_settings.
  • Vérifiez le champ URI de connexion et assurez-vous qu’il est formaté correctement, par exemple « yourgrid.org:8002 » sans inclure le préfixe « http:// ».
  • Vérifiez que le nom de la grille correspond à celui configuré dans les fichiers .ini de votre grille. Il est important d’assurer cette cohérence même après avoir enregistré les paramètres.
  • Vérifiez les informations d’identification de votre base de données et assurez-vous qu’aucune erreur n’est affichée. Assurez-vous que les informations d’identification sont exactes et correspondent à la configuration de votre base de données.
  • Si l’option « Fournir une page de profil web pour les avatars » est activée (ce qui est recommandé), assurez-vous qu’une page « Profil » correspondante existe dans WordPress. Cette page doit être créée avec le permalien défini comme profil. Cela permet aux avatars d’être associés à une page de profil web.

En examinant et en ajustant ces paramètres, vous pouvez vous assurer que la configuration d’OpenSimulator est correctement alignée avec votre grille et que les fonctionnalités nécessaires, telles que les profils d’avatars, sont correctement activées.

5. Vérifiez Admin > OpenSimulator > Helpers

Pour assurer une configuration correcte des paramètres des aides dans la section OpenSimulator de votre panneau d’administration WordPress, suivez ces étapes :

  • Activer ou désactiver l’option « Fournir une recherche dans le monde » :
    • si elle est activée,En utilisant votre propre moteur de recherche, vous limiterez les résultats de la recherche à votre grille uniquement, que l’Hypergrid soit activée ou non.
    • Si cette option n’est pas activée et que vous utilisez une solution tierce comme le moteur de recherche w4os, saisissez son adresse dans le champ URL du moteur de recherche. L’utilisation d’un fournisseur externe fournira des résultats de recherche provenant de toutes les grilles enregistrées auprès du même fournisseur. Cette option convient si l’option Hypergrid est activée sur votre grille.
    Veillez à entrer les mêmes adresses dans le fichier OpenSim.ini pour maintenir la cohérence entre les paramètres du plugin et la configuration d’OpenSimulator.
  • Après avoir enregistré les paramètres, accédez à l’URL du moteur de recherche dans un navigateur. Une page blanche doit s’afficher.
  • Définissez l’URL du serveur d’événements sur« http://2do.pm/events/ » ou utilisez une autre implémentation du serveur HYPEevents.
  • Si l’option « Provide Offline Helper » est activée, définissez l’URI de l’aide hors ligne sur« http://yourgrid.org/helpers/offline.php ». Assurez-vous que la configuration dans Robust.HG.ini et OpenSim.ini correspond. L’accès à l’URI à partir de votre navigateur devrait aboutir à une page blanche.
  • Il est recommandé de ne pas activer la fonction d’économie tant que tous les autres composants ne fonctionnent pas correctement. Toutefois, si vous avez activé l’option « Fournir des aides économiques », procédez comme suit :
    • Définissez l’URI de base de l’économie à« http://yourgrid.org/helpers/ », en l’adaptant à l’adresse réelle de votre site et en utilisant « http:// » au lieu de « https:// ».
    • Assurez-vous que la configuration des fichiers Robust.HG.ini et OpenSim.ini correspond.
    • L’accès à cet URI devrait aboutir à une page blanche, ce qui indique que la fonctionnalité des aides à l’économie est correctement configurée.
    L’activation de la fonction Économie permet l’intégration de systèmes économiques dans votre grille OpenSimulator. Cependant, il est important de s’assurer que tous les autres composants fonctionnent correctement avant d’activer cette option. En suivant les étapes ci-dessus, vous pouvez configurer l’URI de base de l’économie et vérifier sa fonctionnalité dans le plugin w4os.

Si vous avez suivi les étapes ci-dessus et que le plugin ne fonctionne toujours pas, vous pouvez essayer d’utiliser « http:// » au lieu de « https:// » dans le fichier OpenSim.ini. Ceci n’est pas lié au plugin ou à WordPress mais plutôt à une limitation associée à certaines versions de .Net/mono utilisées dans les binaires d’OpenSimulator. Dans certains cas, la version compilée peut ne pas gérer des certificats racine récents, même s’ils sont légitimes. Bien qu’il soit possible de corriger ce problème en recompilant OpenSimulator avec les certificats racine corrects, cela peut être un processus difficile. Par conséquent, l’utilisation de  » http://  » (et  » /helpers/ « ) est souvent une solution plus simple.

Note sur la fonction de recherche

La fonction de recherche repose sur trois éléments : le simulateur, qui envoie des mises à jour régulières au registre qui les stocke pour que le moteur de recherche puisse les consulter et fournir des résultats.

Il est donc très important, une fois que w4os est correctement configuré, de comparer les exemples donnés dans les pages de configuration de w4os et le contenu de vos fichiers .ini, en vous assurant que chaque simulateur de votre grille a les bons paramètres pour la requête de recherche et le registre de recherche, et de redémarrer chacun d’entre eux pour que les données commencent à être envoyées.

Le registre de recherche honore le paramètre « Show Place in Search » (Afficher le lieu dans la recherche) défini in-world pour chaque parcelle (dans « About Land » > « Options »), il doit donc être activé pour chaque parcelle censée apparaître dans les résultats.

6. Vérifiez les paramètres de grille dans le visualiseur (viewer)

Outre le stockage de l’URI de connexion à la grille, le visualiseur (viewer) conserve également un ensemble d’URL fournis par la grille lorsqu’elle est ajoutée. Ces URL comprennent les services offerts par le plugin w4os. Il est important de noter que si vous modifiez ces URL dans les paramètres de votre grille, le visualiseur utilisera toujours les valeurs précédemment stockées jusqu’à ce que vous les actualisiez.

Pour s’assurer que le visualiseur reflète les URL et les services mis à jour par le plugin, suivez les étapes suivantes :

  1. Ouvrez l’onglet « OpenSimulator » ou « Grilles » dans les préférences de votre logiciel de visualisation. Le nom spécifique de cet onglet peut varier en fonction de la visionneuse que vous utilisez.
  2. Sélectionnez votre grille dans la liste des grilles affichées.
  3. Cliquez sur le bouton « Rafraîchir » ou sur une option similaire disponible dans le visualiseur. Cette action met à jour les URL et les services stockés associés à votre grille.

En actualisant les paramètres de la grille dans votre visionneuse, vous vous assurez que toutes les modifications apportées aux URL fournies par le plugin w4os sont reconnues et utilisées par la visionneuse. Cette étape est cruciale pour s’assurer que le visualiseur est synchronisé avec la dernière configuration du plugin et de ses services associés.

AI Chatbot Avatar