Risoluzione dei problemi

Sebbene questo plugin miri a semplificare la vostra esperienza, è importante tenere presente che si tratta di un lavoro in corso e che si basa su vari componenti come OpenSimulator, WordPress, PHP e MySQL. Con le molteplici dipendenze coinvolte, è naturale incontrare delle difficoltà lungo il percorso.

Per aiutarvi a risolvere i problemi che potreste riscontrare, abbiamo messo a punto una lista di controllo completa. Questa lista di controllo vi guiderà attraverso i passi necessari per identificare e risolvere la maggior parte dei problemi che potreste incontrare durante la configurazione e l’uso del plugin w4os.

Prima di installare w4os:

• Garantire la funzionalità del sito web: Assicuratevi che il vostro sito web sia attivo e funzionante senza l’installazione di w4os.
• Verificare OpenSimulator Grid/Standalone: Confermare che la configurazione di OpenSimulator grid o standalone funziona correttamente.

Se si verificano problemi con uno di essi, consultare la rispettiva documentazione per la risoluzione dei problemi e risolverli prima di procedere con l’installazione di w4os.

Se i controlli iniziali di cui sopra sono stati completati con successo e si riscontrano ancora problemi con w4os, procedere con i seguenti passaggi di risoluzione dei problemi. Se il problema persiste, non esitate a chiedere assistenza. Siamo a vostra disposizione per aiutarvi a risolvere qualsiasi difficoltà possiate incontrare.

Se avete bisogno di ulteriore assistenza o volete chiedere aiuto alla comunità, vi consigliamo di visitare la pagina dei problemi del repository GitHub di w4os. Qui è possibile trovare numerose informazioni e soluzioni fornite da altri utenti che hanno riscontrato problemi simili. Condividere la propria esperienza può anche contribuire ad aiutare gli altri nella comunità.

Se decidete di inviare un problema, assicuratevi di includere le seguenti informazioni: le versioni di w4os, WordPress e PHP che state utilizzando. Inoltre, fornire tutti i messaggi di errore pertinenti dal log del server web. Questi dettagli ci aiuteranno a comprendere il contesto del problema e ad assistervi in modo più efficace nella sua risoluzione.

1. Controllare il registro degli errori del server Web

Il primo passo per risolvere i problemi di w4os è esaminare il registro degli errori del server web. Il registro degli errori del server web contiene informazioni preziose che possono aiutare a identificare i problemi relativi alle connessioni al database o agli errori di codice. Seguite queste istruzioni per accedere al registro degli errori del server web e rivederlo:

• Individuare il registro degli errori del server Web sul server. La posizione specifica può variare a seconda della configurazione del server. I percorsi comuni includono /var/log/apache2/error.log per i server Apache o /var/log/nginx/error.log per i server Nginx.
• Cercare le voci contrassegnate come ERRORE. Queste linee indicano spesso questioni critiche che richiedono attenzione. Prestate molta attenzione a questi dati, perché possono fornire indicazioni su problemi di connessione al database o errori di codice.
• È buona norma esaminare anche le linee contrassegnate come ATTENZIONE, ma è meno probabile che forniscano informazioni rilevanti in questo contesto.

2. Assicurarsi che la rete sia attiva e funzionante

Prima di procedere con la risoluzione di ulteriori problemi, è fondamentale confermare che la griglia di OpenSimulator sia operativa. Seguire questi passaggi per assicurarsi che la griglia sia impostata correttamente:

1. Scaricate la versione stabile di OpenSimulator dal sito ufficiale: http://opensimulator.org/wiki/Download.
2. Seguire le istruzioni fornite sul sito web per configurare la griglia di OpenSimulator. In genere si tratta di installare OpenSimulator e di configurare i file .ini necessari.
3. Una volta completata la configurazione, avviate la griglia e create il vostro primo avatar e la vostra prima regione dalla console.
4. Tentate di accedere al mondo utilizzando l’avatar appena creato. Verificate che sia possibile accedere all’ambiente virtuale e interagire con le funzioni e gli oggetti della griglia.

Assicurandosi che la griglia di OpenSimulator funzioni correttamente, è possibile stabilire una solida base per la risoluzione di eventuali problemi legati al plugin w4os. Questa fase aiuta a identificare se i problemi riscontrati sono specifici del plugin o derivano dalla configurazione della griglia stessa.

3. Verifica dei requisiti del server

Per garantire il buon funzionamento del plugin w4os, è importante verificare che il server soddisfi i seguenti requisiti:

• Versione minima richiesta di PHP: La versione PHP minima richiesta per il plugin è la 7.3. Sebbene l’uso di PHP versione 8.1 o successiva sia consigliato per aderire alle best practice generali di PHP, non avrà un impatto funzionale sul plugin stesso.
• Installare e abilitare i seguenti moduli PHP. Se non sono inclusi nel nucleo di PHP, si può usare PECL per aggiungerli o installare i pacchetti appropriati per il proprio sistema (ad esempio, php-xmlrpc e php-imagick su Linux).
  • XMLRPC: Richiesto dalla maggior parte degli helper e altamente raccomandato per la piena funzionalità di WordPress.
  • Imagick: richiesto dal profilo e dal server delle risorse web e altamente raccomandato per la piena funzionalità di WordPress.
  • Nota: Sebbene sia possibile eseguire w4os senza XMLRPC o Imagick, ciò è fortemente sconsigliato in quanto comporta la perdita di funzionalità essenziali, come gli helper e le caratteristiche del profilo.
• Tenete conto delle impostazioni speciali degli URL, in particolare dell’URL dell’indirizzo del sito. Si trova nell’amministrazione di WordPress > Impostazioni > Sezione Generale. Se l’URL dell’indirizzo del sito è diverso da quello predefinito (ad esempio,“https://yourgrid.org/wordpress/” invece di“https://yourgrid.org/”), assicurarsi di modificare di conseguenza l’indirizzo degli helper (ad esempio,“https://yourgrid.org/wordpress/helpers/”).
• Assicurarsi che i permalink siano abilitati in WordPress. Andare in Amministrazione WordPress > Impostazioni > Permalink e verificare che la struttura dei Permalink non sia impostata su “Semplice”. Il salvataggio di qualsiasi altra scelta dovrebbe essere sufficiente, poiché w4os si affida alla traduzione degli URL abilitata dalla struttura Permalink.

3.1 Nota per gli utenti di Nginx

È necessario aggiungere questa configurazione prima della direttiva location ~ \.php$ {...}, per assicurarsi che il plugin possa elaborare le richieste degli helper:

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

4. Rivedere le impostazioni di Admin > OpenSimulator >

Per continuare la risoluzione dei problemi, rivedete le impostazioni nella sezione OpenSimulator del pannello di amministrazione di WordPress. Procedere come segue:

• Accedere alla pagina delle impostazioni di OpenSimulator navigando su /wp-admin/admin.php?page=w4os_settings.
• Controllare il campo URI di accesso e assicurarsi che sia formattato correttamente, ad esempio “yourgrid.org:8002” senza includere il prefisso “http://”.
• Verificare che il nome della griglia corrisponda al nome della griglia configurato nei file .ini della griglia. È importante garantire questa coerenza anche dopo aver salvato le impostazioni.
• Esaminare le credenziali del database e assicurarsi che non siano visualizzati errori. Assicurarsi che le credenziali siano accurate e corrispondano alla configurazione del database.
• Se l’opzione “Fornisci una pagina di profilo web per gli avatar” è attivata (opzione consigliata), assicurarsi che in WordPress esista una pagina “Profilo” corrispondente. Questa pagina deve essere creata con il permalink impostato come profilo. Questo permette agli avatar di avere una pagina di profilo web associata ad essi.

Esaminando e regolando queste impostazioni, è possibile assicurarsi che la configurazione di OpenSimulator sia correttamente allineata alla configurazione della griglia e che le funzioni necessarie, come i profili degli avatar, siano correttamente abilitate.

5. Verificare Admin > OpenSimulator > Helpers

Per garantire la corretta configurazione delle impostazioni degli Helpers nella sezione OpenSimulator del pannello di amministrazione di WordPress, seguite questi passaggi:

• Attivare o disattivare l’opzione “Fornisci ricerca nel mondo”:
  • se abilitato,
    • Impostate l’URL del motore di ricerca su http://yourgrid.org/helpers/query.php, adattandolo all’indirizzo del vostro sito come appare nelle impostazioni generali di WP. Assicurarsi di utilizzare “http://” invece di “https://”.
    • Impostate il registro di ricerca su http://yourgrid.org/helpers/register.php, adattandolo all’indirizzo del vostro sito ma utilizzando “http://”.
    Utilizzando il vostro motore di ricerca, limiterete i risultati della ricerca solo alla vostra griglia, indipendentemente dal fatto che Hypergrid sia abilitato o meno.
  • Se non è abilitato e si utilizza una soluzione di terze parti come il motore di ricerca w4os, inserire il suo indirizzo nel campo URL del motore di ricerca. L’uso di un provider esterno fornirà risultati di ricerca da tutte le griglie registrate con lo stesso provider. Questa opzione è adatta se Hypergrid è abilitato sulla vostra griglia.
  Assicurarsi di inserire gli stessi indirizzi nel file OpenSim.ini per mantenere la coerenza tra le impostazioni del plugin e la configurazione di OpenSimulator.
• Dopo aver salvato le impostazioni, accedere all’URL del motore di ricerca in un browser. Dovrebbe essere visualizzata una pagina vuota.
• Impostare l’URL del server eventi su“http://2do.pm/events/” o utilizzare qualsiasi altra implementazione del server HYPEevents.
• Se l’opzione “Fornisci helper offline” è attivata, impostare l’URI dell’helper offline su“http://yourgrid.org/helpers/offline.php”. Assicurarsi che la configurazione in Robust.HG.ini e OpenSim.ini corrisponda. Accedendo all’URI dal browser si dovrebbe ottenere una pagina vuota.
• Si consiglia di non attivare la funzione Economia finché tutti gli altri componenti non funzionano correttamente. Tuttavia, se è stata attivata l’opzione “Fornisci aiutanti economici”, seguire questi passaggi:
  • Impostare l’URI di base dell’economia su“http://yourgrid.org/helpers/”, adattandolo all’indirizzo effettivo del sito e utilizzando “http://” invece di “https://”.
  • Assicurarsi che la configurazione nei file Robust.HG.ini e OpenSim.ini corrisponda.
  • Accedendo a questo URI si dovrebbe ottenere una pagina vuota, a indicare che la funzionalità Economy Helpers è impostata correttamente.
  L’attivazione della funzione Economia consente di integrare i sistemi economici nella griglia di OpenSimulator. Tuttavia, è importante assicurarsi che tutti gli altri componenti funzionino correttamente prima di attivare questa opzione. Seguendo i passaggi sopra descritti, è possibile configurare l’URI Economy Base e verificarne la funzionalità all’interno del plugin w4os.

Se avete completato i passaggi precedenti e il plugin non funziona ancora, potete provare a usare “http://” invece di “https://” nel file OpenSim.ini. Questo problema non riguarda il plugin o WordPress, ma piuttosto una limitazione associata ad alcune versioni di .Net/mono utilizzate nei binari di OpenSimulator. In alcuni casi, la versione compilata potrebbe non gestire i certificati root recenti, anche se legittimi. È possibile risolvere il problema ricompilando OpenSimulator con i certificati root corretti, ma può essere un processo difficile. Pertanto, l’uso di “http://” (e “/helpers/”) è spesso una soluzione più semplice.

Nota sulla funzione di ricerca

La funzione di ricerca si basa su tre parti: il simulatore, che invia aggiornamenti regolari al registro e li memorizza affinché il motore di ricerca li interroghi per fornire risultati.

È quindi molto importante che, dopo aver configurato correttamente w4os, si confrontino gli esempi forniti nelle pagine delle impostazioni di w4os e il contenuto dei propri file .ini, assicurandosi che ogni simulatore della propria griglia abbia le giuste impostazioni per la query di ricerca e il registro di ricerca, e riavviando ciascuno di essi affinché i dati inizino a essere inviati.

Il registro di ricerca tiene conto dell’impostazione in-world “Mostra luogo nella ricerca” per ogni parcella (in “Informazioni sul terreno” > “Opzioni”), quindi deve essere impostata per ogni parcella che dovrebbe apparire nei risultati.

6. Controllare le impostazioni della griglia del visualizzatore

Oltre a memorizzare l’URI di accesso alla griglia, il visualizzatore conserva anche una serie di URL forniti dalla griglia al momento dell’aggiunta. Questi URL includono i servizi offerti dal plugin w4os. È importante notare che se si apportano modifiche a questi URL nelle impostazioni della griglia, il visualizzatore continuerà a utilizzare i valori precedentemente memorizzati finché non li si aggiorna.

Per assicurarsi che il visualizzatore rifletta gli URL e i servizi aggiornati forniti dal plugin, procedere come segue:

1. Aprire la scheda “OpenSimulator” o “Griglie” nelle Preferenze del visualizzatore. Il nome specifico di questa scheda può variare a seconda del visualizzatore in uso.
2. Selezionare la griglia dall’elenco delle griglie visualizzate.
3. Fare clic sul pulsante “Aggiorna” o su un’opzione simile disponibile nel visualizzatore. Questa azione aggiorna gli URL e i servizi memorizzati associati alla griglia.

Aggiornando le impostazioni della griglia nel visualizzatore, ci si assicura che qualsiasi modifica apportata agli URL forniti dal plugin w4os venga riconosciuta e utilizzata dal visualizzatore. Questo passaggio è fondamentale per garantire che il visualizzatore sia sincronizzato con l’ultima configurazione del plugin e dei servizi associati.