Solução de problemas de falhas de conexão MySQL no ownCloud 10

Quando o ownCloud 10 reporta a mensagem “Falha ao conectar ao banco de dados”, primeiro identifique se o MySQL está inacessível, rejeitando a conta ou se falta um driver PHP. Verifique o serviço de banco de dados e o host exato, o nome do banco de dados e o nome de usuário salvos no ownCloud config/config.php; em seguida, teste essas credenciais no servidor ownCloud antes de alterar permissões ou recriar qualquer coisa. Este guia é direcionado ao ownCloud Server 10.16 com MySQL ou MariaDB. Os rótulos dos menus e os comandos dos pacotes podem variar de acordo com o sistema operacional e o método de instalação.

Saiba o que o erro está lhe dizendo.

A mensagem “Falha na conexão com o banco de dados” é genérica. O erro mais específico do MySQL ou do PHP no log do ownCloud ou no log do servidor web geralmente indica a causa. Um erro de conexão, como o erro 2002 ou 2003 do MySQL, geralmente indica um serviço parado, um socket ou porta incorretos, um caminho de rede bloqueado ou um servidor que não está escutando onde o ownCloud espera. Uma mensagem de “Acesso negado” normalmente significa que o MySQL recebeu a conexão, mas não aceitou o nome de usuário, a senha ou o host do cliente.

MySQL significa servidor de banco de dados; MariaDB é uma opção de banco de dados compatível com o ownCloud. PDO MySQL é o driver de banco de dados PHP que permite ao ownCloud se comunicar com qualquer um deles. Ação: anote o texto exato do erro e o carimbo de data/hora e compare-os com as verificações abaixo, em vez de tratar toda falha de conexão como uma senha incorreta.

Prepare-se antes de alterar as configurações.

  • Confirme se o ownCloud e o MySQL estão sendo executados na mesma máquina, em máquinas diferentes ou em contêineres separados.
  • Saiba o caminho de instalação do ownCloud, o host do banco de dados, a porta ou o socket, o nome do banco de dados e o nome de usuário dedicado ao banco de dados.
  • Mantenha uma sessão de administrador ou acesso ao console disponível. Faça backup config/config.phpantes de editar e nunca publique a senha do banco de dados em uma solicitação de suporte.
  • Execute os comandos como administrador somente quando necessário. Substitua os nomes e caminhos de exemplo pelos valores da sua instalação.

Não exclua nem recrie o banco de dados como etapa inicial de solução de problemas: os arquivos de usuário e metadados existentes dependem dele. Ação: faça um backup verificado do diretório de dados e do banco de dados do ownCloud antes de fazer qualquer alteração no nível do banco de dados.

Verifique o serviço de banco de dados e o caminho de conexão.

  1. Verifique se o MySQL ou MariaDB está em execução. Em um host Linux com systemd, inspecione o serviço usando o nome instalado no seu sistema:
sudo systemctl status mysql
sudo systemctl status mariadb

Um dos nomes de serviço pode não existir na sua distribuição. Se o serviço estiver parado, verifique o registro de erros e o log de erros do banco de dados para descobrir o motivo antes de reiniciá-lo. Ação: resolva erros de inicialização, como disco cheio ou configuração de banco de dados inválida, antes de solucionar problemas com as credenciais do ownCloud.

  1. Verifique o host e a porta a partir da máquina ownCloud. Teste a conectividade TCP com o host e a porta do banco de dados, geralmente a 3306. Para um banco de dados remoto, confirme a resolução de nomes, as regras do firewall e se o MySQL está escutando em uma interface acessível a partir do servidor ownCloud. Não exponha a porta 3306 amplamente à internet.
  2. Entenda a diferença entre sockets locais. Em sistemas do tipo Unix, um cliente MySQL que se conecta localhostfrequentemente usa um socket Unix local, 127.0.0.1forçando o uso de TCP. Isso é importante quando o banco de dados é local, mas o PHP e o MySQL usam caminhos de socket diferentes. Ação: compare o caminho do socket e a configuração do host com a configuração real do servidor de banco de dados ou teste o TCP deliberadamente para verificar se esse é o caminho pretendido.

Faça um teste de login a partir do servidor ownCloud usando o mesmo nome de usuário, host e nome de banco de dados que o ownCloud utiliza:

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

Digite a senha quando solicitado; não a insira diretamente no comando, pois ela pode ser salva no histórico do shell. Para uma conexão de socket local, teste o host e o modo de socket que correspondem à sua configuração. Um login bem-sucedido comprova que o MySQL aceita esse caminho de conexão e conta, mas não comprova que o PHP possui o driver correto ou que o ownCloud está lendo as mesmas configurações. Ação: se este comando falhar, use o erro do MySQL para escolher a próxima verificação.

Verifique as configurações do ownCloud, o driver PHP e as permissões.

O assistente de instalação do ownCloud grava o tipo de banco de dados, o nome do banco de dados, o nome de usuário, a senha, o host e o prefixo da tabela em um config/config.phparquivo . Revise os valores cuidadosamente, evitando copiar a senha para os logs ou para o chat. O arquivo dbhostpode incluir um host e uma porta; se estiver escrito localhost, verifique se o socket esperado está disponível para o processo PHP.

Se o cliente de linha de comando funcionar, mas o ownCloud continuar falhando, verifique se o ambiente de execução PHP usado pelo servidor web está pdo_mysqlinstalado e habilitado. Um comando de shell como ` php -mphp -v` só reporta o ambiente de execução PHP da CLI, que pode ser diferente do Apache ou do PHP-FPM. Ação: inspecione a configuração PHP ativa do servidor web e reinicie o serviço web/PHP relevante após habilitar a extensão.

Para o erro “Acesso negado”, verifique se o MySQL possui uma conta que corresponda tanto ao nome de usuário quanto ao host do cliente visto pelo banco de dados. O MySQL trata contas como `username` 'oc_user'@'localhost'e ` 'oc_user'@'10.0.0.5'username` como distintas. Se o aplicativo ownCloud estiver em um contêiner, o banco de dados poderá ver um endereço de contêiner ou de bridge em vez de ` username` localhost. Ação: solicite ao administrador do banco de dados que inspecione a conta e as permissões correspondentes; conceda acesso somente do host ou da rede ownCloud que realmente precisa dele.

Confirme se o banco de dados existe e se a conta ownCloud pode usá-lo. Evite conceder privilégios globais ou usar a conta root do MySQL no ownCloud. As permissões necessárias podem variar dependendo se esta é uma instalação inicial ou uma instância existente. Ação: siga as orientações de configuração de banco de dados do ownCloud para a etapa específica e não altere a propriedade ou as permissões em bancos de dados não relacionados.

Aplique a correção e verifique a correção.

Corrija apenas as configurações identificadas pelos testes: inicie o serviço de banco de dados, use o nome do host e a porta acessíveis, corrija uma incompatibilidade de socket, habilite o driver PHP, corrija a senha da conta ou ajuste uma permissão de banco de dados específica do host. Se você editar o arquivo de configuração config/config.php, preserve a sintaxe PHP válida e faça um backup primeiro. Não altere o nome do banco de dados, o prefixo da tabela ou as credenciais por tentativa e erro.

Após a alteração, recarregue o ownCloud e confirme se a página carrega sem o aviso de conexão com o banco de dados. Verifique o log do ownCloud para uma solicitação bem-sucedida e certifique-se de que os usuários consigam navegar pelos arquivos existentes. Se o MySQL reportar "o servidor desapareceu" em vez de uma recusa de conexão, trata-se de um problema diferente envolvendo uma conexão interrompida ou expirada, ou tamanho de pacote; o ownCloud documenta as configurações de tempo limite e tamanho de pacote do MySQL para esse caso. Ação: utilize as orientações de solução de problemas do banco de dados correspondentes e altere os limites do servidor somente quando os logs confirmarem esse diagnóstico.

A documentação atual do servidor ownCloud 10.16 recomenda o assistente de instalação para a configuração padrão do banco de dados e menciona especificamente pdo_mysqlo caminho do socket MySQL como verificações. Os nomes exatos dos pacotes, versões do PHP e nomes dos serviços dependem da hospedagem. Ação: finalize repetindo o teste de conexão a partir do servidor ownCloud e confirmando se o aplicativo consegue ler os dados existentes.

Referências oficiais

Deixar um comentário

Elimine os timeouts de bloqueio de arquivos do ownCloud com o backend correto.

Diferencie a disputa de bloqueio de banco de dados dos bloqueios WebDAV expirados e, em seguida, escolha e configure a correção adequada para o ownCloud 10.

O que verificar quando o site ownCloud abre em uma página em branco

O que verificar quando o site ownCloud abre em uma página em branco

Rastreie uma tela em branco do ownCloud Web até a causa, como cache do navegador, recursos da web ausentes, erros de serviço ou configurações de URL de proxy reverso, com verificações direcionadas.

Limpar o aviso de memória PHP do ownCloud no ambiente de execução correto

Defina o limite de memória PHP da web do ownCloud, reinicie o serviço correspondente e verifique o valor ativo sem confundi-lo com as configurações da CLI ou os limites de upload.

Solução de problemas de falhas de conexão MySQL no ownCloud 10

Descubra se o MySQL, o PHP, as configurações de socket ou as permissões do banco de dados estão bloqueando o ownCloud 10 e, em seguida, verifique se há uma solução segura.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Torne obrigatória a expiração de links públicos no ownCloud Classic, defina um tempo de vida máximo e verifique os compartilhamentos existentes que podem precisar de limpeza separada.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Habilite o TOTP por meio do Keycloak, inscreva usuários com segurança e entenda quando as configurações de MFA em nível de rota do Infinite Scale se aplicam.

Restaure a sincronização do ownCloud associando o cliente ao seu servidor.

Verifique se o problema é uma quebra de compatibilidade entre o OC10 e o 7.x ou um registro CSync corrompido e, em seguida, aplique a correção adequada sem excluir os arquivos sincronizados.

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Escolha HTTP-01 ou DNS-01, configure um proxy reverso ownCloud e verifique se o Certbot renova os certificados HTTPS automaticamente.

Conecte o ownCloud Infinite Scale ao LDAP para login do usuário.

Configure o login LDAP do oCIS, alinhe as pesquisas de usuários e grupos e verifique as configurações de TLS e esquema antes da implementação.

Conecte um bucket S3 ao ownCloud 10 como armazenamento externo.

Conecte um bucket S3 ao ownCloud 10 como armazenamento externo.

Adicione um bucket do Amazon S3 ao ownCloud 10, prepare credenciais e endpoints compatíveis e verifique o acesso sem confundir a montagem com o armazenamento primário.