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.
Quando o ownCloud reporta um tempo limite de bloqueio de arquivo, não exclua imediatamente as linhas de bloqueio do banco de dados nem desative o bloqueio. Primeiro, determine se a mensagem se refere a um bloqueio transacional durante uma operação de arquivo ou a um bloqueio WebDAV criado pelo usuário com um tempo de expiração. Para tempos limite de bloqueio transacional recorrentes, mover o cache de bloqueio do banco de dados para o Redis geralmente é a solução prática para servidores com alta carga; instalações com baixo tráfego podem manter o banco de dados como backend, desde que esteja íntegro.
O bloqueio transacional de arquivos protege os arquivos enquanto o ownCloud processa uploads, sincronizações, movimentações e outras alterações. Ele está habilitado por padrão e armazena os bloqueios no banco de dados, a menos que um cache de bloqueio esteja configurado. Um banco de dados lento ou sobrecarregado pode, portanto, fazer com que as operações de arquivo aguardem. As diretrizes do servidor 10.16 do ownCloud recomendam o uso do Redis para bloqueio transacional externo, a fim de reduzir a carga do banco de dados.
O bloqueio manual de arquivos é diferente: um usuário bloqueia um arquivo deliberadamente para impedir que outros usuários o alterem, e o recurso de bloqueios WebDAV aplica um tempo de expiração. No ownCloud Server 10.16, um administrador pode definir o tempo limite padrão e máximo, além de definir grupos de desbloqueio. Ação: utilize a mensagem de log, os arquivos afetados e verifique se o usuário vê um indicador de bloqueio para identificar o mecanismo antes de aplicar uma correção.
Uma mensagem como "Tempo limite de espera de bloqueio excedido" do MySQL pode indicar uma transação de banco de dados aguardando outra transação, em vez de um bloqueio de usuário expirado. Da mesma forma, "Redis desapareceu" aponta para um problema de conectividade com o Redis, e não para um arquivo desatualizado. Ação: inspecione o log do ownCloud e os logs do banco de dados/Redis no mesmo instante; não trate todos os erros de "bloqueio" como o mesmo problema.
| Situação | Escolha prática | Troca |
|---|---|---|
| Servidor doméstico privado com baixo tráfego | Mantenha o bloqueio do banco de dados enquanto investiga a integridade do banco de dados. | Menos serviços para gerenciar, mas a atividade de bloqueio adiciona trabalho ao banco de dados. |
| Servidor único ocupado | Configure o Redis para bloqueio; use o APCu para cache local, se disponível. | Reduz a carga de bloqueio no banco de dados, mas o Redis e sua extensão PHP devem permanecer disponíveis. |
| Vários servidores de aplicativos | Utilize um endpoint Redis compartilhado, acessível por todos os nós da web. | Suporta um cache de bloqueio comum; o acesso à rede Redis, a autenticação e a disponibilidade tornam-se dependências operacionais. |
A documentação do ownCloud afirma que o Memcached não oferece o comportamento de bloqueio persistente necessário para o bloqueio transacional de arquivos, portanto, não memcache.lockingo utilize. O Redis é a opção recomendada para essa função. Ação: se você já utiliza o Memcached para cache distribuído, mantenha essa função separada e configure o Redis especificamente para bloqueios.
Confirme se o Redis está instalado, em execução, acessível pelos web workers PHP e protegido de acordo com o seu projeto de rede. A extensão PHP Redis também deve estar disponível para o ambiente de execução web; verificar apenas o PHP na linha de comando pode não comprovar se o Apache ou o PHP-FPM utilizam a mesma extensão. Para uma instância Redis local, a documentação do ownCloud oferece suporte tanto para TCP quanto para sockets Unix. Em um cluster, todos os nós da aplicação devem apontar para o mesmo serviço de bloqueio Redis, e não para bancos de dados Redis locais separados.
Antes de editar, faça backup config/config.phpe anote quaisquer configurações de cache locais ou distribuídas existentes. Não limpe todo o banco de dados Redis como primeiro passo de rotina: isso pode apagar dados em cache não relacionados ou sessões, dependendo de como o Redis é compartilhado. Ação: identifique o índice do banco de dados Redis e se outros aplicativos usam essa instância do Redis antes da manutenção.
Adicione ou mescle as seguintes entradas em config/config.php. Não crie chaves de array PHP duplicadas; em vez disso, atualize as entradas existentes. Este exemplo usa Redis sobre TCP no mesmo host:
'filelocking.enabled' => true,
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
'host' => '127.0.0.1',
'port' => 6379,
'timeout' => 0,
'password' => 'replace-with-your-redis-secret',
'dbindex' => 0,
],
Utilize o host, a porta, a senha, o índice do banco de dados e o caminho do socket do Redis que correspondam à sua implementação. Restrinja o acesso ao Redis a clientes confiáveis em redes locais ou privadas e não o exponha publicamente. Para um socket Unix, o exemplo do ownCloud utiliza o caminho do socket como ` host/etc/ portredis 0...
Reinicie ou recarregue os serviços PHP/web relevantes somente se necessário para o processo de configuração da sua instalação. Em seguida, verifique a visão geral do administrador e o log do ownCloud em busca de exceções de cache ou bloqueio. Ação: teste uma pequena operação de upload, renomeação e sincronização com uma conta de teste antes de considerar a alteração concluída.
Se um bloqueio criado pelo usuário estiver durando muito tempo, revise as configurações de Bloqueio Manual de Arquivos em Configurações > Administração > Geral . O ownCloud 10.16 documenta estes occexemplos para definir os tempos de vida padrão e máximo de bloqueio WebDAV:
sudo -u www-data ./occ config:app:set files lock_timeout_default --value 1800
sudo -u www-data ./occ config:app:set files lock_timeout_max --value 86400
Esses valores estão em segundos. Os valores padrão no exemplo não são obrigatórios para todas as políticas; escolha uma duração que corresponda ao tempo que os usuários precisam manter um bloqueio. Para um bloqueio realmente abandonado, o proprietário do bloqueio pode desbloqueá-lo na visualização de detalhes do arquivo. Um administrador também pode configurar um grupo de quebra de bloqueio. Ação: prefira o caminho de recuperação baseado em interface do usuário/API ou em grupo, em vez de editar diretamente os registros de bloqueio WebDAV.
Após a alteração, verifique se os uploads e as operações de sincronização foram concluídos, se as edições simultâneas não causam corrupção de arquivos e se os logs não mostram mais timeouts recorrentes do backend de bloqueio. Se o log agora reportar falhas de conexão com o Redis, corrija a disponibilidade do Redis, as credenciais, o carregamento de extensões ou as permissões de socket; alternar entre as versões sem entender a falha pode mascarar a causa original.
Não desative o bloqueio transacional para fazer com que os tempos limite desapareçam. Ele protege as operações de arquivo e removê-lo pode criar problemas de integridade em atividades simultâneas. Não exclua linhas do banco de dados das tabelas de bloqueio nem limpe um banco de dados Redis compartilhado, a menos que a documentação de suporte do ownCloud para a falha específica oriente você a fazê-lo. Ação: se o problema persistir após confirmar o backend configurado e sua integridade, capture os logs do ownCloud e do backend com registro de data e hora e investigue as consultas lentas ao banco de dados ou a disputa de bloqueio com seu administrador.
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.
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.
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.
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.
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.
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.
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.
Escolha HTTP-01 ou DNS-01, configure um proxy reverso ownCloud e verifique se o Certbot renova os certificados HTTPS automaticamente.
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.
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.