Hoewel deze plugin bedoeld is om je ervaring te vereenvoudigen, is het belangrijk om in gedachten te houden dat het een werk in uitvoering is en afhankelijk is van verschillende componenten zoals OpenSimulator, WordPress, PHP en MySQL. Als er meerdere afhankelijkheden zijn, is het logisch dat je onderweg tegen uitdagingen aanloopt.
Om je te helpen eventuele problemen op te lossen, hebben we een uitgebreide checklist samengesteld. Deze checklist leidt je door de noodzakelijke stappen om de meeste problemen te identificeren en op te lossen die je kunt tegenkomen tijdens het instellen en gebruiken van de w4os plugin.
Voordat u w4os installeert:
- Functionaliteit van website garanderen: Zorg ervoor dat je website probleemloos werkt zonder dat w4os is geïnstalleerd.
- Controleer OpenSimulator Grid/Standalone: Controleer of uw OpenSimulator grid of standalone opstelling correct werkt.
Als er problemen optreden met een van beide, raadpleeg dan hun respectievelijke documentatie voor stappen om problemen op te lossen en los deze op voordat u verder gaat met de installatie van w4os.
Als u de hierboven vermelde initiële controles met succes hebt uitgevoerd en nog steeds problemen ondervindt met w4os, ga dan verder met de volgende stappen voor probleemoplossing. Als het probleem aanhoudt, aarzel dan niet om hulp te vragen. We zijn er om je te helpen eventuele problemen op te lossen.
Als je meer hulp nodig hebt of de hulp van de community wilt inroepen, dan raden we je aan om de w4os GitHub repository issues pagina te bezoeken. Daar vind je een schat aan informatie en oplossingen van andere gebruikers die soortgelijke problemen hebben ondervonden. Het delen van je ervaring kan ook bijdragen aan het helpen van anderen in de gemeenschap.
Als u besluit een probleem in te dienen, zorg er dan voor dat u de volgende informatie verstrekt: de versies van w4os, WordPress en PHP die u gebruikt. Geef daarnaast relevante foutmeldingen uit het logboek van je webserver. Aan de hand van deze gegevens kunnen we de context van het probleem beter begrijpen en je beter helpen bij het oplossen ervan.
1. Controleer het foutenlogboek van uw webserver
De eerste stap bij het oplossen van w4os-problemen is het bekijken van het foutenlogboek van uw webserver. Het foutenlogboek van de webserver bevat waardevolle informatie die kan helpen bij het identificeren van problemen met databaseverbindingen of codefouten. Volg deze instructies om het foutenlogboek van uw webserver te openen en te bekijken:
- Zoek het foutlogboek van de webserver op uw server. De specifieke locatie kan variëren afhankelijk van je serverconfiguratie. Gebruikelijke paden zijn /var/log/apache2/error.log voor Apache servers of /var/log/nginx/error.log voor Nginx servers.
- Zoek naar vermeldingen met de markering ERROR. Deze lijnen geven vaak kritieke problemen aan die aandacht vereisen. Let hier goed op, want ze kunnen inzicht geven in problemen met databaseverbindingen of fouten in de code.
- Het is een goede gewoonte om lijnen gemarkeerd als WAARSCHUWING ook te onderzoeken, maar het is minder waarschijnlijk dat ze in deze context relevante informatie geven.
2. Ervoor zorgen dat het netwerk werkt
Voordat u verder gaat met het oplossen van problemen, is het cruciaal om te bevestigen dat uw OpenSimulator netwerk operationeel is. Volg deze stappen om ervoor te zorgen dat het rooster correct is ingesteld:
- Download de stabiele versie van OpenSimulator van de officiële website: http://opensimulator.org/wiki/Download.
- Volg de instructies op de website om je OpenSimulator grid in te stellen. Dit omvat meestal het installeren van OpenSimulator en het configureren van de benodigde .ini bestanden.
- Zodra de installatie is voltooid, start je het raster en maak je je eerste avatar en je eerste regio aan vanaf de console.
- Probeer in te loggen met je nieuw aangemaakte avatar. Controleer of u met succes toegang krijgt tot de virtuele omgeving en kunt communiceren met de functies en objecten van de grid.
Door ervoor te zorgen dat je OpenSimulator grid goed werkt, kun je een solide basis leggen voor het oplossen van problemen met de w4os plugin. Deze stap helpt om te bepalen of eventuele problemen die je tegenkomt specifiek zijn voor de plugin of voortkomen uit de opstelling van het raster zelf.
3. Serververeisten controleren
Voor een goede werking van de w4os-plugin is het belangrijk om te controleren of je server voldoet aan de volgende vereisten:
- Minimaal vereiste php-versie: De minimaal vereiste PHP versie voor de plugin is 7.3. Hoewel het gebruik van PHP versie 8.1 of later wordt aanbevolen om te voldoen aan de algemene PHP best practices, heeft het geen functionele invloed op de plugin zelf.
- Installeer de volgende PHP-modules en schakel ze in. Als ze niet in de PHP core zitten, kun je PECL gebruiken om ze toe te voegen of de juiste pakketten voor jouw systeem installeren (bijvoorbeeld php-xmlrpc en php-imagick op Linux).
- XMLRPC: Vereist door de meeste helpers en ten zeerste aanbevolen voor volledige WordPress-functionaliteit.
- Imagick: vereist door profiel en webactiva server en ten zeerste aanbevolen voor volledige WordPress functionaliteit.
- Opmerking: Hoewel het mogelijk is om w4os te draaien zonder XMLRPC of Imagick, wordt dit sterk afgeraden omdat dit zal resulteren in het verlies van essentiële functionaliteiten, zoals helpers en profielfuncties.
- Houd rekening met speciale URL-instellingen, vooral de URL met het websiteadres. Dit kan worden gevonden in de WordPress Admin > Instellingen > Algemene sectie. Als de URL van je website-adres afwijkt van de standaard URL (bijvoorbeeld“https://yourgrid.org/wordpress/” in plaats van“https://yourgrid.org/”), moet je het adres van de helpers dienovereenkomstig aanpassen (bijvoorbeeld“https://yourgrid.org/wordpress/helpers/”).
- Zorg ervoor dat permalinks zijn ingeschakeld in WordPress. Ga naar WordPress Admin > Instellingen > Permalinks en controleer of de Permalink structuur niet is ingesteld op “Gewoon”. Het opslaan van elke andere keuze zou voldoende moeten zijn, omdat w4os vertrouwt op de URL vertaling die mogelijk wordt gemaakt door de Permalink structuur.
3.1 Opmerking voor Nginx gebruikers
Je moet deze configuratie toevoegen voor de location ~ \.php$ {...} directive, om er zeker van te zijn dat de plugin de verzoeken van de helpers kan verwerken:
location ~* ^/helpers/.*\.php$ {
try_files $uri $uri/ /index.php?$args;
}4. Controleer Admin > OpenSimulator > Instellingen
Om verder te gaan met het oplossen van problemen, bekijkt u de instellingen in de OpenSimulator sectie van uw WordPress admin paneel. Volg deze stappen:
- Ga naar de OpenSimulator instellingenpagina door te navigeren naar /wp-admin/admin.php?page=w4os_settings.
- Controleer het Login URI veld en zorg ervoor dat het correct is geformatteerd, zoals “yourgrid.org:8002” zonder de “http://” prefix.
- Controleer of de Netnaam overeenkomt met de Netnaam die is geconfigureerd in de .ini-bestanden van je raster. Het is belangrijk om deze consistentie te garanderen, zelfs na het opslaan van de instellingen.
- Controleer de databasegegevens en zorg ervoor dat er geen fouten worden weergegeven. Zorg ervoor dat de referenties correct zijn en overeenkomen met je databaseconfiguratie.
- Als de optie “Geef webprofielpagina voor avatars” is ingeschakeld (wat wordt aanbevolen), zorg er dan voor dat er een overeenkomstige “Profiel”-pagina bestaat in WordPress. Deze pagina moet worden gemaakt met de permalink ingesteld als profiel. Hierdoor kunnen avatars een webprofielpagina aan hen koppelen.
Door deze instellingen te bekijken en aan te passen, kunt u ervoor zorgen dat de configuratie van OpenSimulator correct is afgestemd op uw rasteropstelling en dat de benodigde functies, zoals avatarprofielen, correct zijn ingeschakeld.
5. Controleer Admin > OpenSimulator > Helpers
Volg deze stappen voor een juiste configuratie van de Helpers instellingen in de OpenSimulator sectie van je WordPress admin paneel:
- De optie “In-wereld zoeken” in- of uitschakelen:
- indien ingeschakeld,
- Stel de URL van de zoekmachine in op http://yourgrid.org/helpers/query.php en pas deze aan met het adres van je site zoals het wordt weergegeven in de algemene instellingen van WP. Zorg ervoor dat je “http://” gebruikt in plaats van “https://”.
- Stel het Zoekregister in op http://yourgrid.org/helpers/register.php, pas het aan met je Siteadres maar gebruik “http://”.
- Als dit niet is ingeschakeld en je gebruikt een oplossing van een derde partij, zoals w4os zoekmachine, voer dan hun adres in het veld URL zoekmachine in. Als je een externe provider gebruikt, krijg je zoekresultaten van alle roosters die bij dezelfde provider geregistreerd zijn. Deze optie is geschikt als Hypergrid is ingeschakeld op uw netwerk.
- indien ingeschakeld,
- Nadat u de instellingen hebt opgeslagen, opent u de URL van de zoekmachine in een browser. Er zou een lege pagina moeten worden weergegeven.
- Stel de Events Server URL in op“http://2do.pm/events/” of gebruik een andere implementatie van de HYPEevents server.
- Als de optie “Offline helper aanbieden” is ingeschakeld, stelt u de URI van de offline helper in op“http://yourgrid.org/helpers/offline.php”. Zorg ervoor dat de configuratie in zowel Robust.HG.ini als OpenSim.ini overeenkomt. Als je de URI vanuit je browser opent, krijg je een lege pagina te zien.
- Het wordt aanbevolen om de Economy-functie pas in te schakelen als alle andere onderdelen correct functioneren. Als je echter de optie “Economy Helpers bieden” hebt ingeschakeld, volg dan deze stappen:
- Stel de Economy Base URI in op“http://yourgrid.org/helpers/”, pas deze aan met uw werkelijke siteadres en gebruik “http://” in plaats van “https://”.
- Zorg ervoor dat de configuratie in Robust.HG.ini en OpenSim.ini bestanden overeenkomt.
- Het openen van deze URI zou moeten resulteren in een lege pagina, wat aangeeft dat de Economy Helpers functionaliteit correct is ingesteld.
Als je de bovenstaande stappen hebt uitgevoerd en de plugin werkt nog steeds niet, kun je proberen “http://” te gebruiken in plaats van “https://” in het OpenSim.ini bestand. Dit is niet gerelateerd aan de plugin of WordPress, maar eerder een beperking geassocieerd met bepaalde .Net/mono versies die gebruikt worden in OpenSimulator binaries. In sommige gevallen kan de gecompileerde versie niet omgaan met recente root certificaten, zelfs als deze legitiem zijn. Hoewel het mogelijk is om dit op te lossen door OpenSimulator opnieuw te compileren met de juiste root certificaten, kan dit een uitdagend proces zijn. Daarom is het gebruik van “http://” (en “/helpers/”) vaak een eenvoudigere oplossing.
Opmerking over de zoekfunctie
De zoekfunctie bestaat uit drie onderdelen: de simulator, die regelmatig updates naar het register stuurt en deze opslaat zodat de zoekmachine ze kan opvragen om resultaten te leveren.
Het is dus heel belangrijk dat je, nadat w4os correct is ingesteld, de voorbeelden op de w4os instellingenpagina’s en de inhoud van je .ini-bestanden vergelijkt, om er zeker van te zijn dat elke simulator van je netwerk de juiste instellingen heeft voor de zoekopdracht en het zoekregister, en dat je ze allemaal herstart zodat de gegevens worden verzonden.
Het zoekregister houdt rekening met de instelling “Toon plaats in zoekopdracht” in de wereld voor elk perceel (in “Over land” > “Opties”), dus deze moet worden ingesteld voor elk perceel dat moet worden weergegeven in de resultaten.
6. Controleer de rasterinstellingen van de viewer
Naast het opslaan van de aanmeld URI van het raster, bewaart de viewer ook een set URL’s die door het raster worden geleverd wanneer het wordt toegevoegd. Deze URL’s bevatten de services die worden aangeboden door de w4os-plugin. Het is belangrijk om op te merken dat als je wijzigingen aanbrengt in deze URL’s in je rasterinstellingen, de viewer nog steeds de eerder opgeslagen waarden zal gebruiken totdat je ze vernieuwt.
Volg deze stappen om ervoor te zorgen dat de viewer de bijgewerkte URL’s en services van de plugin weergeeft:
- Open het tabblad “OpenSimulator” of “Rasters” in de Voorkeuren van je viewer. De specifieke naam van dit tabblad kan variëren afhankelijk van de viewer die je gebruikt.
- Selecteer je raster in de lijst met rasters die wordt weergegeven.
- Klik op de knop “Vernieuwen” of een vergelijkbare optie in de viewer. Deze actie werkt de opgeslagen URL’s en services bij die zijn gekoppeld aan je raster.
Door de rasterinstellingen in je viewer te vernieuwen, zorg je ervoor dat alle wijzigingen die zijn aangebracht in de URL’s die door de w4os-plugin worden geleverd, worden herkend en gebruikt door de viewer. Deze stap is cruciaal om ervoor te zorgen dat de viewer gesynchroniseerd is met de laatste configuratie van de plugin en de bijbehorende services.
