Resolução de problemas

Embora este plugin tenha como objetivo simplificar a sua experiência, é importante ter em conta que se trata de um trabalho em curso e que depende de vários componentes, como o OpenSimulator, o WordPress, o PHP e o MySQL. Com múltiplas dependências envolvidas, é natural encontrar desafios pelo caminho.

Para o ajudar a resolver quaisquer problemas que possa encontrar, elaborámos uma lista de verificação exaustiva. Esta lista de verificação guiá-lo-á através dos passos necessários para identificar e resolver a maioria dos problemas que poderá enfrentar ao configurar e utilizar o plugin w4os.

Antes de instalar o w4os:

• Assegurar a funcionalidade do sítio Web: Certifique-se de que o seu sítio Web está a funcionar corretamente sem o w4os instalado.
• Verificar o OpenSimulator Grid/Standalone: Confirme se a configuração do OpenSimulator grid ou standalone está a funcionar corretamente.

Se surgir algum problema com qualquer um deles, consulte a respectiva documentação para obter os passos de resolução de problemas e resolva-os antes de prosseguir com a instalação do w4os.

Se tiver concluído com êxito as verificações iniciais mencionadas acima e continuar a ter problemas com o w4os, prossiga com os seguintes passos de resolução de problemas. Se o problema persistir, não hesite em pedir ajuda. Estamos aqui para o ajudar a resolver quaisquer dificuldades que possa ter.

Se precisar de mais assistência ou quiser procurar ajuda da comunidade, recomendamos que visite a página de problemas do repositório w4os GitHub. Aí, pode encontrar uma grande quantidade de informações e soluções fornecidas por outros utilizadores que possam ter tido problemas semelhantes. Partilhar a sua experiência também pode contribuir para ajudar os outros na comunidade.

Se decidir enviar um problema, certifique-se de que inclui as seguintes informações: as versões do w4os, do WordPress e do PHP que está a utilizar. Além disso, forneça quaisquer mensagens de erro relevantes do registo do seu servidor Web. Estes pormenores ajudar-nos-ão a compreender o contexto do problema e a ajudá-lo mais eficazmente na sua resolução.

1. Verifique o registo de erros do seu servidor Web

O primeiro passo na resolução de problemas do w4os é analisar o registo de erros do servidor Web. O registo de erros do servidor Web contém informações valiosas que podem ajudar a identificar problemas relacionados com ligações à base de dados ou erros de código. Siga estas instruções para aceder e rever o registo de erros do servidor Web:

• Localize o registo de erros do servidor Web no seu servidor. A localização específica pode variar consoante a configuração do servidor. Os caminhos comuns incluem /var/log/apache2/error.log para servidores Apache ou /var/log/nginx/error.log para servidores Nginx.
• Procurar entradas marcadas como ERRO. Estas linhas indicam frequentemente problemas críticos que requerem atenção. Preste muita atenção a eles, pois podem fornecer informações sobre problemas de ligação à base de dados ou erros de código.
• É uma boa prática examinar também as linhas marcadas como ADVERTÊNCIA, mas é menos provável que forneçam informações relevantes neste contexto.

2. Assegurar que a rede está a funcionar

Antes de prosseguir com a resolução de problemas, é crucial confirmar que a grelha do OpenSimulator está operacional. Siga estes passos para garantir que a grelha está corretamente configurada:

1. Descarregue a versão estável do OpenSimulator a partir do sítio Web oficial: http://opensimulator.org/wiki/Download.
2. Siga as instruções fornecidas no sítio Web para configurar a grelha do OpenSimulator. Normalmente, isto envolve a instalação do OpenSimulator e a configuração dos ficheiros .ini necessários.
3. Quando a configuração estiver concluída, inicia a grelha e cria o teu primeiro avatar e a tua primeira região a partir da consola.
4. Tenta entrar no mundo usando o teu avatar recém-criado. Verifique se consegue aceder com êxito ao ambiente virtual e interagir com as funcionalidades e objectos da grelha.

Ao assegurar que a grelha do OpenSimulator está a funcionar corretamente, pode estabelecer uma base sólida para a resolução de quaisquer problemas relacionados com o plugin w4os. Este passo ajuda a identificar se os problemas que encontra são específicos do plug-in ou se têm origem na própria configuração da grelha.

3. Verificar os requisitos do servidor

Para garantir o bom funcionamento do plugin w4os, é importante verificar se o seu servidor cumpre os seguintes requisitos:

• Versão mínima exigida do php: A versão mínima exigida do PHP para o plugin é 7.3. Embora a utilização da versão 8.1 ou posterior do PHP seja recomendada para aderir às melhores práticas gerais do PHP, não terá um impacto funcional no próprio plug-in.
• Instale e active os seguintes módulos PHP. Se eles não estiverem incluídos no núcleo do PHP, você pode usar o PECL para adicioná-los ou instalar os pacotes apropriados para o seu sistema (por exemplo, php-xmlrpc e php-imagick no Linux).
  • XMLRPC: Exigido pela maioria dos assistentes e altamente recomendado para a funcionalidade completa do WordPress.
  • Imagick: exigido pelo servidor de perfil e activos web e altamente recomendado para a funcionalidade completa do WordPress.
  • Nota: Embora seja possível executar o w4os sem o XMLRPC ou o Imagick, tal é fortemente desaconselhado, uma vez que resultará na perda de funcionalidades essenciais, tais como ajudantes e características de perfil.
• Tenha em conta as definições especiais do URL, especialmente o URL do endereço do sítio. Isto pode ser encontrado na secção Geral do WordPress Admin > Settings >. Se o URL do endereço do site for diferente do predefinido (por exemplo,“https://yourgrid.org/wordpress/” em vez de“https://yourgrid.org/”), certifique-se de que ajusta o endereço dos auxiliares em conformidade (por exemplo,“https://yourgrid.org/wordpress/helpers/”).
• Certifique-se de que os permalinks estão activados no WordPress. Vá para WordPress Admin > Configurações > Permalinks e confirme que a estrutura Permalink não está definida como “Plain”. Guardar qualquer outra opção deve ser suficiente, uma vez que o w4os se baseia na tradução de URLs activada pela estrutura Permalink.

3.1 Nota para os utilizadores do Nginx

É necessário adicionar esta configuração antes da diretiva location ~ \.php$ {...}, para garantir que o plugin pode processar os pedidos dos auxiliares:

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

4. Rever as definições do Admin > OpenSimulator >

Para continuar a resolução de problemas, reveja as definições na secção OpenSimulator do seu painel de administração do WordPress. Siga estes passos:

• Aceda à página de definições do OpenSimulator navegando para /wp-admin/admin.php?page=w4os_settings.
• Verifique o campo URI de início de sessão e certifique-se de que está corretamente formatado, como “yourgrid.org:8002” sem incluir o prefixo “http://”.
• Verifique se o Nome da grade corresponde ao Nome da grade configurado nos arquivos .ini da sua grade. É importante garantir essa consistência mesmo depois de salvar as configurações.
• Reveja as credenciais da base de dados e certifique-se de que não são apresentados erros. Certifique-se de que as credenciais são exactas e correspondem à configuração da sua base de dados.
• Se a opção “Fornecer página de perfil Web para avatares” estiver activada (o que é recomendado), certifique-se de que existe uma página “Perfil” correspondente no WordPress. Esta página deve ser criada com o permalink definido como perfil. Isto permite que os avatares tenham uma página de perfil web associada a eles.

Ao rever e ajustar estas definições, pode garantir que a configuração do OpenSimulator está corretamente alinhada com a sua configuração de grelha e que as funcionalidades necessárias, tais como perfis de avatar, estão devidamente activadas.

5. Verificar Admin > OpenSimulator > Helpers

Para garantir a configuração adequada das definições de Helpers na secção OpenSimulator do seu painel de administração do WordPress, siga estes passos:

• Ativar ou desativar a opção “Fornecer pesquisa no mundo”:
  • se ativado,
    • Defina o URL do motor de busca para http://yourgrid.org/helpers/query.php, ajustando-o com o endereço do seu site tal como aparece nas definições gerais do WP. Certifique-se de que utiliza “http://” em vez de “https://”.
    • Defina o registo de pesquisa para http://yourgrid.org/helpers/register.php, ajustando-o com o endereço do seu site, mas utilizando “http://”.
    Ao utilizar o seu próprio motor de busca, limitará os resultados da pesquisa apenas à sua grelha, quer o Hypergrid esteja ativado ou não.
  • Se não estiver ativado e utilizar uma solução de terceiros como o motor de busca w4os, introduza o respetivo endereço no campo URL do motor de busca. A utilização de um fornecedor externo fornecerá resultados de pesquisa de todas as grelhas registadas com o mesmo fornecedor. Esta opção é adequada se o Hypergrid estiver ativado na sua grelha.
  Certifique-se de que introduz os mesmos endereços no ficheiro OpenSim.ini para manter a consistência entre as definições do plugin e a configuração do OpenSimulator.
• Depois de guardar as definições, aceda ao URL do motor de busca num browser. Deverá aparecer uma página em branco.
• Defina o URL do servidor de eventos para“http://2do.pm/events/” ou utilize qualquer outra implementação do servidor HYPEevents.
• Se a opção “Fornecer auxiliar offline” estiver activada, defina o URI do auxiliar offline para“http://yourgrid.org/helpers/offline.php”. Certifique-se de que a configuração no Robust.HG.ini e no OpenSim.ini corresponde. O acesso ao URI a partir do seu browser deve resultar numa página em branco.
• Recomenda-se que a funcionalidade Economia não seja activada até que todos os outros componentes estejam a funcionar corretamente. No entanto, se tiver ativado a opção “Fornecer ajudantes económicos”, siga estes passos:
  • Defina o URI de base económica para“http://yourgrid.org/helpers/”, ajustando-o com o endereço real do seu sítio e utilizando “http://” em vez de “https://”.
  • Certifique-se de que a configuração nos ficheiros Robust.HG.ini e OpenSim.ini corresponde.
  • O acesso a este URI deve resultar numa página em branco, o que indica que a funcionalidade “Economy Helpers” está corretamente configurada.
  A ativação da funcionalidade Economia permite a integração de sistemas económicos na grelha do OpenSimulator. No entanto, é importante garantir que todos os outros componentes estão a funcionar corretamente antes de ativar esta opção. Seguindo os passos acima, pode configurar o URI da Base Económica e verificar a sua funcionalidade no plugin w4os.

Se tiver completado os passos acima e o plugin ainda não estiver a funcionar, pode tentar utilizar “http://” em vez de “https://” no ficheiro OpenSim.ini. Isto não está relacionado com o plugin ou com o WordPress, mas sim com uma limitação associada a certas versões .Net/mono usadas nos binários do OpenSimulator. Em alguns casos, a versão compilada pode não lidar com certificados raiz recentes, mesmo que sejam legítimos. Embora seja possível corrigir isso recompilando o OpenSimulator com os certificados raiz corretos, esse pode ser um processo desafiador. Portanto, usar “http://” (e “/helpers/”) é frequentemente uma solução mais direta.

Nota sobre a funcionalidade de pesquisa

A funcionalidade de pesquisa assenta em três partes: o simulador, que envia actualizações regulares para o registo, armazenando-as para que o motor de pesquisa as consulte e forneça resultados.

Por isso, é muito importante que, depois de o w4os estar corretamente configurado, compare os exemplos dados nas páginas de definições do w4os e o conteúdo dos seus ficheiros .ini, certificando-se de que cada simulador da sua grelha tem as definições correctas para a consulta de pesquisa e o registo de pesquisa, e reinicie cada um deles para que os dados comecem a ser enviados.

O registo de pesquisa honra a definição “Mostrar local na pesquisa” no mundo para cada parcela (em “Sobre o terreno” > “Opções”), pelo que deve ser definida para cada parcela que se pretende que apareça nos resultados.

6. Verificar as definições de grelha do visualizador

Para além de armazenar o URI de início de sessão da grelha, o visualizador também retém um conjunto de URLs fornecidos pela grelha quando esta é adicionada. Estes URLs incluem os serviços oferecidos pelo plugin w4os. É importante notar que, se fizer quaisquer alterações a estes URLs nas definições da grelha, o visualizador continuará a utilizar os valores previamente armazenados até que os actualize.

Para garantir que o visualizador reflecte os URLs e serviços actualizados fornecidos pelo plug-in, siga estes passos:

1. Abra o separador “OpenSimulator” ou “Grids” nas Preferências do seu visualizador. O nome específico deste separador pode variar consoante o visualizador que estiver a utilizar.
2. Seleccione a sua grelha na lista de grelhas apresentada.
3. Clique no botão “Atualizar” ou numa opção semelhante disponível no visualizador. Esta ação irá atualizar os URLs e serviços armazenados associados à sua grelha.

Ao atualizar as definições da grelha no seu visualizador, garante que quaisquer alterações feitas aos URLs fornecidos pelo plug-in w4os são reconhecidas e utilizadas pelo visualizador. Este passo é crucial para garantir que o visualizador está sincronizado com a configuração mais recente do plug-in e dos serviços associados.